docs: drop the prescriptive Color and Icon suggestion sections
These sections (in Keywords-Quick-Reference.md) implied a recommended
palette and icon set, which is outside the wiki's job - users picking
their own colors and icons is the point. The remaining Best Practices
section still encourages thoughtful icon/color choices without
prescribing specific values.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
docs: address grammar-vs-wiki audit findings
Fixes broken examples and adds documentation for features that exist in
the langium grammar but were absent or misrepresented in the wiki.
Broken examples now corrected:
- Action params (Fields.md, Document.md): the wiki claimed
'action Heal(hidden: ...)' / 'action LevelUp(disabled: ...)' /
'action LevelUp(when: ...)' worked as conditional shorthands. They
do not - the grammar's ActionParam rule only accepts visibility,
icon, color, and label. Replaced with the two valid forms: static
visibility prefix and visibility: method block returning a
Visibility.X value.
- Status syntax (Keywords-and-Journals, Keywords-Quick-Reference): the
wiki used 'status X when: ... img: ...' (no parens, wrong key 'img:'
vs grammar's 'svg:', and 'death' as a trailing modifier). Per the
StatusProperty rule, params live in (...) parens, the icon param is
'svg:', and 'death' is a *prefix* on the declaration.
- Tracker style (Fields, Recipes): grammar accepts 'segmented'
(singular). Wiki used 'segments' (plural), which would not parse.
- Paperdoll size: (Fields): grammar takes a PX literal, not named
sizes. Wiki claimed small/medium/large.
New documentation for previously undocumented features:
- 'wounds resource' - the inverse-color sibling of 'health resource',
for damage-pool style tracking.
- Document-level parameters - actor and item declarations accept
icon:, svg:, background:, description:, creatable:, default:.
- chat (template: "...") - custom Handlebars template override for
chat cards.
- parent<type> supported types - mirrored the 14-type list from
self<type> with examples beyond just parent<attribute>.
- attribute style: and roll: parameters - both appear in grammar but
only roll: was glimpsed in the tutorial.
- choices<string> multi-select field - distinct from singular
choice<string>; supports max: and initial:.
- damage(roll:, type:) function - now has a Logic-Reference entry
alongside roll().
- Visibility prefix shorthand subsection - the nine prefix keywords
(gmOnly, secret, hidden, etc.) and what each enables.
- 'item.X' iteration alias inside where: clauses - the rule that lets
filters reference each item under test.
- 'pips' deprecation note pointing users to tracker(style: segmented).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>