phaneron/Kelsidavis-WoWee
1
0
Fork 0
mirror of https://github.com/Kelsidavis/WoWee.git synced 2026-05-26 08:13: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

10
tools/editor/cli_help.cpp
View file

@ -2797,6 +2797,16 @@ void printUsage(const char* argv0) {
std::printf(" Export binary .wcfr to a human-editable JSON sidecar (defaults to <base>.wcfr.json; emits both outputStatKind and inputStatKind as int + name string)\n");
std::printf(" --import-wcfr-json <json-path> [out-base]\n");
std::printf(" Import a .wcfr.json sidecar back into binary .wcfr (outputStatKind int OR \"ap\"/\"sp\"/\"crit\"/\"dodge\"/\"parry\"/\"hit\"/\"spellcrit\"/\"haste\"; inputStatKind int OR \"str\"/\"agi\"/\"sta\"/\"int\"/\"spi\"; conversionRatio fp_x100 preserved)\n");
std::printf(" --gen-lnk-std <wlnk-base> [name]\n");
std::printf(" Emit .wlnk 4 standard hyperlink kinds (Item with 4-rune-slot template / Quest yellow / Spell white / Achievement with 9 placeholders)\n");
std::printf(" --gen-lnk-talent <wlnk-base> [name]\n");
std::printf(" Emit .wlnk 2 less-common link kinds (Talent green for passive enhancements / Trade-skill recipe orange with server lookup)\n");
std::printf(" --gen-lnk-quality <wlnk-base> [name]\n");
std::printf(" Emit .wlnk 3 Item-kind variants distinguished by quality color (Common gray 0x9D9D9D / Epic purple 0xA335EE / Legendary orange 0xFF8000)\n");
std::printf(" --info-wlnk <wlnk-base> [--json]\n");
std::printf(" Print WLNK entries (id / kind / requireServerLookup / colorRGBA hex / iconRule / name)\n");
std::printf(" --validate-wlnk <wlnk-base> [--json]\n");
std::printf(" Static checks: 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 would render identically). Warns on > 12 placeholders (unusual; verify intentional), colorRGBA=0 (fully transparent — link text invisible), and requireServerLookup=true with empty tooltipTemplate (server data would not be displayed anywhere)\n");
std::printf(" --catalog-pluck <wXXX-file> <id> [--json]\n");
std::printf(" Extract one entry by id from any registered catalog format. Auto-detects magic, dispatches to the per-format --info-* handler internally, then prints just the matching entry. Primary-key field is auto-detected (first *Id field, or first numeric)\n");
std::printf(" --catalog-find <directory> <id> [--magic <WXXX>] [--json]\n");