Skip to content

Commit adf013c

Browse files
committed
feat(v7-q09): per-brick palette help icons with inputs/outputs/norm popups
Adds a ? help icon next to every tile in the Node Library palette (both bricks and adapters). Each popup explains: what the brick is, why you'd reach for it, expected inputs (shape + params), expected outputs (shape), and where normalization is needed (pre/post-norm + which adapter to drop). Schema: - HelpTopic interface gains optional inputs / outputs / normalization fields. - HelpModal renders three new Sections when those fields are present. Coverage: - HELP_TOPICS extended with 25 brick_<kind> entries: attention, gated_attention, mla, mla_absorb, mistral4_mla, dsv4_attention, bailing_mla, gqa_sliding, cca_attention, gemma4_drafter, nemotron_h_mtp, bailing_linear, gdn, kda, mamba3, mlstm, moe, bailing_moe, nsa, lightning_indexer, csa_hca, engram, mlp, abs_pos_embed, per_layer_embed. - And 6 adapter_<kind> entries: merge_heads, split_heads, transpose_bnsd, linear_bridge, rmsnorm, residual. UI wiring: - Palette.tsx renders <HelpIcon topic="brick_<kind>"> on each tile. - The ? icon wrapper stops drag/mouse/pointer-down propagation so opening the popup doesn't kick off a brick drag. Tests (5/5 PASS, vbgui/tests/PaletteHelpIcons.test.tsx): - every brick tile has a help-icon-brick_<kind> testid - every adapter tile has a help-icon-adapter_<kind> testid - HELP_TOPICS schema is complete for both arrays + brick entries carry inputs/outputs/normalization fields - clicking brick_attention ? opens modal with (B, S, H) + RMSNorm guidance - clicking adapter_rmsnorm ? opens its modal Regression: vbgui vitest 451 -> 474 (+23) PASS. Closes V7-Q09 (cppmega-mlx-g9ky).
1 parent b61aa9a commit adf013c

3 files changed

Lines changed: 889 additions & 117 deletions

File tree

0 commit comments

Comments
 (0)