phaneron/Kelsidavis-WoWee
1
0
Fork 0
mirror of https://github.com/Kelsidavis/WoWee.git synced 2026-05-22 23:03:50 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

feat(pipeline): WLNK chat hyperlink template catalog (146th open format)
Some checks failed
Build / Build (arm64) (push) Has been cancelled
Details
Build / Build (x86-64) (push) Has been cancelled
Details
Build / Build (macOS arm64) (push) Has been cancelled
Details
Build / Build (windows-arm64) (push) Has been cancelled
Details
Build / Build (windows-x86-64) (push) Has been cancelled
Details
Security / CodeQL (C/C++) (push) Has been cancelled
Details
Security / Semgrep (push) Has been cancelled
Details
Security / Sanitizer Build (ASan/UBSan) (push) Has been cancelled
Details

Browse source 
Novel replacement for the implicit chat-link format templates
vanilla WoW carried in client-side LUA — each link kind (item /
quest / spell / achievement / talent / trade-skill) had a hard-
coded sprintf template baked into ChatFrame_OnHyperlinkClick
with no formal data-driven extension point. Each WLNK entry
binds one hyperlink kind to its sprintf-style chat-link
template (with %%d/%%s placeholders for link parameters),
tooltip-popup template, quality color (RGBA), icon source
rule, and server-lookup requirement flag.

Three presets covering the link-kind spectrum:
  --gen-lnk-std      4 standard hyperlink kinds (Item with
                     classic 4-rune-slot template / Quest
                     yellow / Spell white / Achievement with 9
                     placeholders for criteria-progress data)
  --gen-lnk-talent   2 less-common kinds (Talent green for
                     passive enhancements / Trade-skill recipe
                     orange with server lookup for ingredients)
  --gen-lnk-quality  3 Item-kind variants distinguished by
                     quality color (Common gray 0x9D9D9D / Epic
                     purple 0xA335EE / Legendary orange
                     0xFF8000) — chat composer picks variant by
                     item quality at link time

Validator catches: id+name+linkTemplate required, linkKind
0..5, no duplicate linkIds. CRITICAL: linkTemplate MUST contain
at least one %%d/%%s placeholder — composer would emit a static
string regardless of input (every link rendering identically
regardless of which item/spell/quest was clicked). Walks the
template character-by-character counting valid format
specifiers (%%d, %%s, %%u, %%i, %%x, %%X, with %%%% literal
double-percent excluded). Warns on > 12 placeholders (unusual,
verify intentional), colorRGBA=0 (fully transparent — link text
invisible), and requireServerLookup=true with empty
tooltipTemplate (server data has nowhere to render).

Format count 145 -> 146. CLI flag count 1508 -> 1515.
This commit is contained in:
Kelsi 2026-05-10 06:16:37 -07:00
parent 4fb444ad27
commit 4b5b7ccd3e
10 changed files with 737 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

1
tools/editor/cli_format_table.cpp
View file

@ -148,6 +148,7 @@ constexpr FormatMagicEntry kFormats[] = {
{{'W','C','M','D'}, ".wcmd", "chat", "--info-wcmd", "Chat slash command catalog"},
{{'W','C','A','M'}, ".wcam", "camera", "--info-wcam", "Camera preset catalog"},
{{'W','C','F','R'}, ".wcfr", "stats", "--info-wcfr", "Combat formula catalog"},
{{'W','L','N','K'}, ".wlnk", "chat", "--info-wlnk", "Chat hyperlink template catalog"},
{{'W','F','A','C'}, ".wfac", "factions", nullptr, "Faction catalog"},
{{'W','L','C','K'}, ".wlck", "locks", nullptr, "Lock catalog"},
{{'W','S','K','L'}, ".wskl", "skills", nullptr, "Skill catalog"},