gp-dimm-city 1.0.0

package/components.yaml

@@ -0,0 +1,832 @@
+# Dimm City component catalog — the machine-readable ground truth for the
+# component library that gp-dimm-city ships.
+#
+# WHAT THIS IS
+#   One entry per component: what an author writes, what lands in the HTML,
+#   which custom properties are public, how it fragments, and which stylesheet
+#   owns it. The Dimm City Design Guide (a book in the dc-op-manual repo)
+#   explains and demonstrates the components; this file is the catalog of
+#   record. It is the file package.json declares as `gutterpress.components` —
+#   Gutterpress only checks that the file exists, so the schema below is this
+#   package's own. Paths are relative to the package root.
+#
+# FIELDS
+#   name (kebab, unique) · status · origin (plugin | author | core — who puts
+#   the class in the DOM) · recipe · emits (DOM strings, one or a list) · css
+#   (package-relative paths; required for live/unused, and at least one must
+#   style one of the entry's classes) · tokens (must be declared under
+#   styles/) · breaks (documentation; omitted where the component has no
+#   fragmentation rule of its own — variants inherit their parent's) · usage
+#   (literal strings that mark a use of a component with no marker or class:
+#   `ROLL THE DIE!`, `| highlight`, `variant=panel`, …) · unstyled (emitted
+#   classes acknowledged to have no CSS) · notes.
+#
+#   Status meanings (measured against the Dimm City books that consume this
+#   package — the Field Guide, the Design Guide, SysOps):
+#     live           at least one class styled; used at least once in a book;
+#                    plugin-origin entries must actually be emitted/parsed
+#     unused         styled or emitted, but used by no book
+#     retired        no class styled, none emitted, none used (a retired marker
+#                    may still be parsed as a no-op stripper)
+#     unimplemented  no class styled, none emitted — documented or authored,
+#                    never built.
+#
+# THE RULE
+#   Give every component an honest status, and every new macro or `.dc-*`
+#   class an entry. Nothing checks this file automatically beyond its `css:`
+#   paths existing (test/package.test.js), so keep it accurate by hand.
+#
+# Order: plugin macros, plugin-emitted internals, author classes, unused,
+# retired, unimplemented.
+
+components:
+  # ── Plugin macros and alerts ───────────────────────────────────────────
+  - name: alert
+    status: live
+    origin: plugin
+    recipe: "> [!NOTE] | > [!WARNING] | > [!DM] | > [!VIBE] | > [!ORIGIN] | > [!VISIT] | > [!GEAR]  (GFM-style blockquote; the label is added automatically)"
+    emits:
+      - div.dc-alert.dc-note > span.dc-alert-label
+      - div.dc-alert.dc-note.warning > span.dc-alert-label
+      - div.dc-alert.dc-dm-note > span.dc-alert-label
+      - div.dc-alert.dc-vibe-callout > span.dc-alert-label
+      - div.dc-alert.dc-origin-callout > span.dc-alert-label
+      - div.dc-alert.dc-visit-callout > span.dc-alert-label
+      - div.dc-alert.dc-gear-callout > span.dc-alert-label
+    css: [styles/components/callouts.css, styles/dc-native.css]
+    tokens:
+      - --dc-alert-bg
+      - --dc-alert-border
+      - --dc-alert-fg
+      - --dc-alert-label-color
+      - --dc-alert-border-width
+      - --dc-alert-label-size
+      - --dc-alert-body-size
+      - --dc-alert-label-weight
+      - --dc-alert-label-spacing
+      - --dc-alert-label-margin
+      - --dc-alert-margin-top
+    breaks: "break-inside: avoid, relaxed to auto inside .gp-columns-2/-3 (dc-native.css)"
+    notes: "`warning` is an unprefixed modifier on .dc-note. The blockquote form is single-block; use @callout for multi-paragraph bodies."
+
+  - name: callout
+    status: live
+    origin: plugin
+    recipe: "@callout variant=note|warning|dm|vibe|origin|visit|gear label=\"…\" … @end-callout"
+    emits:
+      - div.dc-alert.dc-note > span.dc-alert-label
+      - div.dc-alert.dc-note.warning
+      - div.dc-alert.dc-dm-note
+      - div.dc-alert.dc-vibe-callout
+      - div.dc-alert.dc-origin-callout
+      - div.dc-alert.dc-visit-callout
+      - div.dc-alert.dc-gear-callout
+    css: styles/components/callouts.css
+    breaks: "as alert"
+    notes: "Same DOM and tokens as alert; the macro form allows multiple paragraphs and a custom label."
+
+  - name: dm-note
+    status: live
+    origin: plugin
+    recipe: "@dm-note label=\"…\" … @end-dm-note"
+    emits: div.dc-alert.dc-dm-note > span.dc-alert-label
+    css: [styles/components/callouts.css, styles/dc-native.css]
+    breaks: "as alert; first child glued to the box start (dc-native.css)"
+    notes: "Sugar for @callout variant=dm. Used by the design guide only."
+
+  - name: flavor
+    status: live
+    origin: plugin
+    recipe: "> [!FLAVOR]"
+    emits: [div.dc-flavor, "p.dc-flavor (the > blockquote inside a @skill card)"]
+    css: styles/components/chrome.css
+    tokens: [--dc-flavor-accent, --dc-flavor-accent-width, --dc-flavor-color]
+    breaks: none
+
+  - name: pullquote
+    status: live
+    origin: plugin
+    recipe: "> [!PULLQUOTE]"
+    emits: div.dc-pullquote.dc-flush
+    css: styles/components/data.css
+    tokens: [--dc-pullquote-accent, --dc-pullquote-accent-soft, --dc-pullquote-bg]
+    breaks: "break-inside: avoid"
+
+  - name: sidebar
+    status: live
+    origin: plugin
+    recipe: "@sidebar [.inset] … @end-sidebar  (also authored as raw <div class=\"dc-sidebar\"> around an NPC human-callout)"
+    emits: div.dc-sidebar
+    css: [styles/components/images.css, styles/page-templates.css]
+    tokens:
+      - --dc-sidebar-surface
+      - --dc-sidebar-border
+      - --dc-sidebar-accent
+      - --dc-sidebar-inset-column
+      - --dc-sidebar-inset-gutter
+      - --dc-sidebar-callout-accent
+      - --dc-sidebar-callout-bg
+    breaks: "break-inside: avoid"
+    notes: "`.inset` is an unprefixed modifier read by .page.page-sidebar > .dc-sidebar.inset (page-templates.css). Design guide only."
+
+  - name: sidebar-box
+    status: live
+    origin: plugin
+    recipe: "@sidebar-box … @end-sidebar-box"
+    emits: div.dc-prose-panel.dc-sidebar-box
+    css: styles/components/data.css
+    tokens: [--dc-sidebar-box-surface, --dc-sidebar-box-border, --dc-sidebar-box-accent, --dc-sidebar-box-rail]
+    breaks: "break-inside: avoid (via .dc-prose-panel)"
+    notes: "Design guide only."
+
+  - name: definition
+    status: live
+    origin: plugin
+    recipe: "@definition … @end-definition"
+    emits: div.dc-prose-panel.dc-definition-block
+    css: styles/components/data.css
+    tokens: [--dc-definition-block-surface, --dc-definition-block-accent, --dc-definition-block-accent-width]
+    breaks: "break-inside: avoid (via .dc-prose-panel)"
+    notes: "04-components.md marks the macro as superseded by markdown definition lists; both books still use it."
+
+  - name: procedure
+    status: live
+    origin: plugin
+    recipe: "@procedure … 1. step … @end-procedure"
+    emits: ol.dc-steps > li > span.dc-step-no
+    css: styles/components/data.css
+    breaks: "break-inside: avoid"
+
+  - name: block
+    status: live
+    origin: plugin
+    recipe: "@block .dc-panel|.dc-slate|.dc-shard|.dc-codex label=\"Title\" … @end-block"
+    emits: div.dc-block > div.dc-block-title
+    css: styles/components/section.css
+    tokens: [--dc-block-bg, --dc-block-fg, --dc-block-accent, --dc-block-title-bg, --dc-block-title-fg]
+    breaks: "break-inside: avoid"
+    notes: "The variant class is author-supplied (see block-variants; also accepted as variant=panel). Design guide only."
+
+  - name: block-variants
+    status: live
+    origin: author
+    recipe: "@block .dc-panel | .dc-slate | .dc-shard | .dc-codex"
+    emits: div.dc-block.dc-panel|.dc-slate|.dc-shard|.dc-codex
+    css: styles/components/section.css
+    usage: [variant=panel, variant=slate, variant=shard, variant=codex]
+    notes: "Four clip-path/surface treatments on .dc-block; the class is passed through from the marker, or built by the plugin from variant=x (a concatenation the check's plugin scan cannot see — hence origin: author and the usage literals)."
+
+  - name: card
+    status: live
+    origin: plugin
+    recipe: "@card [.dc-flaws|.dc-ideals|.dc-dreams] / #### Heading / > pull quote / body / > footer … @end-card"
+    emits:
+      - div.dc-card > div.dc-card-heading + div.dc-card-pull + div.dc-card-body
+      - div.dc-card-body > blockquote.dc-card-footer (the last body blockquote, dc#44)
+    css: styles/components/section.css
+    breaks: "break-inside: avoid"
+
+  - name: card-variants
+    status: live
+    origin: author
+    recipe: "@card .dc-flaws | .dc-ideals | .dc-dreams"
+    emits: div.dc-card.dc-flaws|.dc-ideals|.dc-dreams
+    css: styles/components/section.css
+    notes: "Citizen-file card accents; the class is passed through from the marker."
+
+  - name: gear
+    status: live
+    origin: plugin
+    recipe: "@gear … @end-gear"
+    emits: div.dc-card.dc-gear
+    css: styles/components/section.css
+    unstyled: [dc-gear]
+    breaks: "break-inside: avoid (via .dc-card)"
+    notes: "Renders as a plain .dc-card: nothing has ever styled .dc-gear (the only rules are inside the GEAR ENTRY tombstone comment in data.css). Reviving the treatment is a design decision — see that comment. Design guide only."
+
+  - name: lede
+    status: live
+    origin: plugin
+    recipe: "@lede … @end-lede"
+    emits: div.dc-intro
+    css: [styles/components/chrome.css, styles/components/section.css, styles/page-templates.css]
+    tokens: [--dc-intro-bg, --dc-intro-accent]
+    breaks: "break-after: avoid inside .dc-card-grid"
+    notes: "The same .dc-intro is emitted for a learning path's subtitle and authored raw on the contents page."
+
+  - name: tape
+    status: live
+    origin: plugin
+    recipe: "@tape label=\"…\"  (also authored as raw <div class=\"dc-tape dc-flush\">…</div>)"
+    emits: div.dc-tape
+    css: styles/components/chrome.css
+    tokens: [--dc-tape-bg, --dc-tape-border, --dc-tape-color]
+    breaks: "break-inside: avoid"
+
+  - name: toc
+    status: live
+    origin: plugin
+    recipe: "@toc … @end-toc  (also authored as raw <div class=\"dc-toc\">)"
+    emits: div.dc-toc
+    css: [styles/components/data.css, styles/page-templates.css]
+    breaks: "list items break-inside: avoid"
+
+  - name: glossary
+    status: live
+    origin: plugin
+    recipe: "@glossary … @end-glossary  (the macro is used by neither book; the raw <div class=\"dc-terms\"> wrapper is)"
+    emits: div.dc-terms
+    css: styles/components/images.css
+    breaks: "break-inside: avoid"
+    notes: "CSS styles the children as .dc-terms .dc-item (see glossary-item); the docs and gallery author .dc-terms-item instead (see glossary-item-authored)."
+
+  - name: outcome
+    status: live
+    origin: plugin
+    recipe: "@outcome [flush] / 20 | Crit | text … @end-outcome, or a | Roll | Outcome | table inside a skill card"
+    emits:
+      - div.dc-outcomes[.dc-flush] > div.dc-outcomes-label
+      - div.dc-outcome-row.crit|hit|mixed|miss|fail > span.dc-outcome-key.tier-* > span.dc-outcome-name + span.dc-outcome-roll
+      - span.dc-outcome-text
+    css: styles/components/data.css
+    tokens:
+      - --dc-outcomes-surface
+      - --dc-outcomes-border
+      - --dc-outcomes-inner-border
+      - --dc-outcomes-divider
+      - --dc-outcomes-label-bg
+      - --dc-outcomes-label-color
+      - --dc-outcome-key-color
+      - --dc-outcome-name-color
+      - --dc-outcome-name-opacity
+    usage: ["| Roll | Outcome"]
+    breaks: "break-inside: avoid; the skill-table form adds data-break-inside=avoid only when the parent card allows splitting"
+
+  - name: specialty
+    status: live
+    origin: plugin
+    recipe: "@specialty .augmerc|.proxy|.streetwarden|.gutterdruid|.cybersurgeon|.wirephreak|.technosorcerer|.etherlock|.dualist|.generalist … @end-specialty"
+    emits: div.dc-specialty.<name>
+    css:
+      - styles/components/specialty-identity.css
+      - styles/components/specialty.css
+      - styles/components/cards.css
+      - styles/components/data.css
+      - styles/components/section.css
+      - styles/page-templates.css
+    tokens:
+      - --spec-accent
+      - --spec-mid
+      - --spec-dark
+      - --dc-skill-tab-shape
+      - --dc-skill-body-shape
+      - --dc-path-title-shape
+      - --dc-path-shell-clip
+      - --dc-specialty-card-shell-shape
+      - --dc-specialty-intro-title-shape
+      - --dc-specialty-intro-clip
+    breaks: "none on the wrapper; children carry their own"
+    notes: "Parent-selector model: every card, path and intro inside inherits shape and colour from .dc-specialty.<name>. Auto-closes any open path or skill."
+
+  - name: specialty-intro
+    status: live
+    origin: plugin
+    recipe: "@specialty-intro … @end-specialty-intro"
+    emits: div.dc-specialty-intro
+    css: [styles/components/specialty.css, styles/components/specialty-identity.css]
+    tokens: [--dc-specialty-intro-bg, --dc-specialty-intro-title-bg, --dc-specialty-intro-title-color]
+    breaks: "break-inside: avoid; first h2 break-after: avoid"
+
+  - name: specialty-art
+    status: live
+    origin: plugin
+    recipe: "@specialty-art … @end-specialty-art"
+    emits: div.dc-specialty-art
+    css: [styles/components/chrome.css, styles/page-rules.css]
+    breaks: "break-before: page; page: full"
+
+  - name: specialty-card
+    status: live
+    origin: plugin
+    recipe: "@specialty-card … @end-specialty-card  (data-position=odd|even alternates per card)"
+    emits: div.dc-specialty-card
+    css:
+      - styles/components/specialty.css
+      - styles/components/specialty-identity.css
+      - styles/components/section.css
+      - styles/page-templates.css
+    tokens:
+      - --dc-specialty-card-bg
+      - --dc-specialty-card-border
+      - --dc-specialty-card-accent
+      - --dc-specialty-card-fg
+      - --dc-specialty-card-media-height
+      - --dc-specialty-card-media-width
+      - --dc-specialty-card-title-align
+      - --dc-specialty-card-band-height
+      - --dc-specialty-card-shadow
+      - --dc-specialty-card-title-color
+    breaks: "break-inside: avoid"
+
+  - name: learning-path
+    status: live
+    origin: plugin
+    recipe: "@learning-path / ### Title / > subtitle / - Skill A / - Skill B … @end-learning-path"
+    emits:
+      - div.dc-learning-path.dc-path-block > div.dc-path-shell > h2.dc-spray > span.dc-path-sticker
+      - div.dc-path-shell > div.dc-intro
+      - div.dc-stickers > span.dc-sticker > span.dc-sticker-ref
+      - span.dc-arrow (between stickers)
+    css: [styles/components/data.css, styles/components/chrome.css, styles/components/specialty-identity.css]
+    tokens:
+      - --dc-path-title-bg
+      - --dc-path-title-color
+      - --dc-path-accent
+      - --dc-path-shell-padding-top
+      - --dc-path-shell-padding-bottom
+      - --dc-arrow-color
+    breaks: "break-before/after: auto on the block; the h2 stays with what follows"
+
+  - name: skill
+    status: live
+    origin: plugin
+    recipe: "@skill [id=…] [{.dc-allow-split}] [{.dc-two-col}] / #### Name | Tier / > flavor / 1. **N AP** *Ability:* text / ##### Sub-header … @end-skill (alias @end-skills)"
+    emits:
+      - div.dc-skill-card[name][data-break-inside=avoid] > div.dc-card-tab > span.dc-tab-title + span.dc-tab-tier
+      - div.dc-card-body > div.dc-card-inner > p.dc-flavor + div.dc-sub-header
+      - div.dc-ability > span.dc-ap + p.dc-ability-text
+    css: [styles/components/cards.css, styles/components/data.css, styles/components/specialty-identity.css, styles/dc-native.css]
+    tokens:
+      - --dc-card-accent
+      - --dc-card-surface
+      - --dc-card-tab-bg
+      - --dc-card-tab-title-color
+      - --dc-card-body-mark
+      - --dc-card-gap
+      - --dc-card-tab-shadow
+    breaks: "data-break-inside=avoid by default; {.dc-allow-split} opts into splitting (see allow-split); tab break-after: avoid; last two abilities glued"
+    notes: "A ##### Outcomes sub-header is swallowed (the outcomes block carries its own label)."
+
+  - name: skill-highlight
+    status: live
+    origin: plugin
+    recipe: "#### Name | Tier | highlight  (inside @skill)"
+    emits: [div.dc-card-tab.dc-highlight, div.dc-card-body.dc-highlight-body]
+    css: styles/components/cards.css
+    usage: ["| highlight"]
+    breaks: "as skill"
+    notes: "Also reachable as @skill {.dc-highlight}, which puts the class on the card root instead of the tab."
+
+  - name: skill-card-continuation
+    status: live
+    origin: plugin
+    recipe: "@continue  (inside an open @skill card; closes it and opens a '{name} ▸' continuation card)"
+    emits: div.dc-skill-card.dc-skill-card-cont > div.dc-card-tab.dc-card-tab-cont
+    css: styles/components/cards.css
+    breaks: "as skill; honours the parent card's .dc-allow-split"
+    notes: "A bare @continue outside a skill is core's section continuation; the usage count includes both."
+
+  - name: ap-chip
+    status: live
+    origin: plugin
+    recipe: "1. **N AP** *Ability:* text  (inside @skill; 0 AP → .free, ranges/X → .variable; also authored as raw <span class=\"dc-ap\">)"
+    emits: span.dc-ap[.free|.variable]
+    css: [styles/components/cards.css, styles/components/specialty-identity.css]
+    tokens: [--dc-ap-bg, --dc-ap-fg, --dc-ap-border]
+    usage: [" AP**"]
+    breaks: none
+    notes: "Modifier drift outside the check's dc- scope: the plugin emits `variable` but the CSS styles `.dc-ap.var`; `.standard/.reduced/.increased/.special` (specialty-identity.css) are never emitted, only authored raw in the gallery."
+
+  - name: distance-tags
+    status: unused
+    origin: plugin
+    recipe: "| Distance | AP | table inside a skill card"
+    emits: div.dc-sub-header + div.dc-distance-tags > span.dc-dist-tag > span.dc-dist-ap + span.dc-dist-name
+    css: styles/components/data.css
+    tokens: [--dc-dist-tag-surface, --dc-dist-tag-border, --dc-dist-ap-color, --dc-dist-name-color]
+    usage: ["| Distance | AP |"]
+    breaks: none
+    notes: "Emission path exists and is styled; no skill in either book writes a
+      Distance/AP table. The usage literal carries the AP column deliberately: the
+      plugin only transforms a Distance table that sits inside a skill card, and
+      field-guide chapter-05's Schraphose damage table is a four-column Distance
+      table in body prose. A bare '| Distance |' literal counted that as a use."
+
+  - name: roll-the-die
+    status: live
+    origin: plugin
+    recipe: "ROLL THE DIE!  (automatic on the canonical text in markdown prose; code spans and raw HTML are left alone)"
+    emits: span.dc-roll-the-die
+    css: styles/components/cards.css
+    tokens: [--dc-roll-the-die-color, --dc-roll-the-die-border]
+    usage: ["ROLL THE DIE!"]
+    breaks: none
+
+  - name: img-wrapper
+    status: live
+    origin: plugin
+    recipe: "![alt](src)  (automatic on any image-only paragraph)"
+    emits: p.dc-img-wrapper
+    css: [styles/components/data.css, styles/dc-native.css]
+    usage: ["!["]
+    breaks: "break-inside: avoid"
+
+  - name: flush
+    status: live
+    origin: plugin
+    recipe: "@outcome flush, > [!PULLQUOTE], or .dc-flush on raw .dc-tape / .dc-stat / .dc-stickers"
+    emits: .dc-flush (edge-to-edge modifier)
+    css: [styles/components/chrome.css, styles/components/data.css]
+    breaks: none
+
+  # ── Author classes on core markers, attrs and raw HTML ────────────────
+  - name: column-panel
+    status: live
+    origin: author
+    recipe: "@section .gp-columns-2 .dc-column-panel"
+    emits: div.section.dc-column-panel
+    css: styles/components/section.css
+    breaks: "first heading glued to its first paragraph"
+
+  - name: tabbed
+    status: live
+    origin: author
+    recipe: "@section .dc-tabbed"
+    emits: div.section.dc-tabbed
+    css: styles/components/section.css
+    tokens: [--dc-section-tab-indent, --dc-section-tab-overlap]
+    breaks: "first heading break-after: avoid"
+
+  - name: card-grid
+    status: live
+    origin: author
+    recipe: "@section .dc-card-grid"
+    emits: div.section.dc-card-grid
+    css: [styles/components/section.css, styles/page-templates.css]
+    breaks: "break-inside: auto on the grid; each specialty card avoid"
+
+  - name: citizen-walkthrough
+    status: live
+    origin: author
+    recipe: "@section .dc-citizen-walkthrough [.gp-columns-2]"
+    emits: div.section.dc-citizen-walkthrough
+    css: [styles/components/section.css, styles/dc-native.css]
+    notes: "KNOWN DRIFT (2026-09-01 audit, T2): 04-components.md tells authors to override --section-accent / --section-bg at the chapter id; no CSS declares either name. The chassis reads --dc-section-accent / --dc-section-bg (see section). Unprefixed names are outside the check's token scan, so this stays a note until the chapter is corrected."
+
+  - name: citizen-file-page
+    status: live
+    origin: author
+    recipe: "@page .dc-citizen-file-page"
+    emits: div.page.dc-citizen-file-page
+    css: styles/page-rules.css
+    breaks: "page: citizen-file"
+
+  - name: fiction-excerpt
+    status: live
+    origin: author
+    recipe: "@section .dc-fiction-excerpt"
+    emits: div.section.dc-fiction-excerpt
+    css: [styles/components/section.css]
+    tokens:
+      - --dc-fiction-bg
+      - --dc-fiction-line-height
+      - --dc-fiction-art-float
+      - --dc-fiction-art-width
+      - --dc-fiction-art-outline
+      - --dc-fiction-art-shadow
+    breaks: "orphans/widows 3 on paragraphs"
+
+  - name: npc-stat
+    status: live
+    origin: author
+    recipe: "@section .dc-npc-stat"
+    emits: div.section.dc-npc-stat
+    css: [styles/components/section.css]
+    tokens:
+      - --dc-npc-stat-primary
+      - --dc-npc-stat-secondary
+      - --dc-npc-stat-label-color
+      - --dc-npc-stat-rule
+      - --dc-npc-stat-rule-width
+
+  - name: chapter-start
+    status: live
+    origin: author
+    recipe: "@page .page-chapter-start .dc-chapter-start"
+    emits: div.page.dc-chapter-start
+    css: [styles/page-rules.css, styles/page-templates.css]
+    breaks: "page: chapter-start"
+
+  - name: credits
+    status: live
+    origin: author
+    recipe: "@page .page-credits .dc-credits"
+    emits: div.page.dc-credits
+    css: [styles/page-templates.css, styles/dc-native.css]
+    notes: "Styled in page-templates.css and dc-native.css — carried in from the books in 1.0.0."
+
+  - name: colophon-grid
+    status: live
+    origin: author
+    recipe: "raw <div class=\"dc-colophon-grid\"> on the credits page"
+    emits: div.dc-colophon-grid
+    css: styles/page-templates.css
+
+  - name: chevron
+    status: live
+    origin: author
+    recipe: "# Title {.dc-chevron}  (the chapter-opener h1 gets the same treatment structurally)"
+    emits: h1.dc-chevron
+    css: [styles/components/chrome.css, styles/dc-native.css, styles/page-templates.css]
+    tokens: [--dc-chevron-bg, --dc-chevron-color, --dc-chevron-font-size]
+
+  - name: spray
+    status: live
+    origin: author
+    recipe: "## Title {.dc-spray}  (also emitted by @learning-path for its title)"
+    emits: h2.dc-spray
+    css: [styles/components/chrome.css, styles/components/data.css]
+    tokens: [--dc-spray-bg, --dc-spray-color]
+    breaks: "as a path-shell title: break-before avoid on the element after it"
+
+  - name: spec-tweak
+    status: live
+    origin: author
+    recipe: "### Title {.dc-spec-tweak [.dc-no-top]}"
+    emits: h3.dc-spec-tweak[.dc-no-top]
+    css: styles/components/chrome.css
+
+  - name: classtag
+    status: live
+    origin: author
+    recipe: "raw <span class=\"dc-classtag <specialty>\">"
+    emits: span.dc-classtag.<specialty>
+    css: styles/components/chrome.css
+    tokens: [--dc-classtag-color]
+
+  - name: tag
+    status: live
+    origin: author
+    recipe: "raw <span class=\"dc-tag\">"
+    emits: span.dc-tag
+    css: styles/components/chrome.css
+
+  - name: human-callout
+    status: live
+    origin: author
+    recipe: "raw <div class=\"dc-sidebar\"><div class=\"dc-human-callout\">…  (NPC sidebar)"
+    emits: div.dc-human-callout
+    css: styles/components/images.css
+    breaks: "break-inside: avoid"
+
+  - name: at-a-glance-cards
+    status: live
+    origin: author
+    recipe: "raw <div class=\"dc-at-a-glance-cards\"> > <div class=\"dc-at-a-glance-card\">"
+    emits: div.dc-at-a-glance-cards > div.dc-at-a-glance-card
+    css: styles/components/data.css
+
+  - name: stat-block
+    status: live
+    origin: author
+    recipe: "raw <div class=\"dc-stat [dc-flush]\"> with .dc-stat-head, .dc-stat-grid cells and .dc-stat-line"
+    emits:
+      - div.dc-stat > div.dc-stat-head > span.dc-stat-name + span.dc-stat-class
+      - div.dc-stat-grid > div.dc-stat-cell > span.dc-stat-cell-key + span.dc-stat-cell-val
+      - div.dc-stat-line
+    css: styles/components/data.css
+    breaks: "break-inside: avoid"
+
+  - name: allow-split
+    status: live
+    origin: author
+    recipe: "@skill {.dc-allow-split} or @section .dc-allow-split"
+    emits: .dc-allow-split (on the skill card or section it is written on)
+    css: styles/components/section.css
+    breaks: "break-inside: auto — opts a section or skill card out of the default avoid"
+    notes: "The plugin reads this class (to drop data-break-inside=avoid) but never adds it."
+
+  - name: two-col
+    status: live
+    origin: author
+    recipe: "@skill {.dc-two-col}"
+    emits: div.dc-skill-card.dc-two-col
+    css: styles/components/cards.css
+    breaks: "list items and paragraphs break-inside: avoid within the columns"
+
+  # ── Core-owned structure whose public tokens this library declares ─────
+  - name: section
+    status: live
+    origin: core
+    recipe: "@section  (bare; core markers.js emits the wrapper)"
+    emits: div.section
+    css: styles/components/section.css
+    tokens: [--dc-section-bg, --dc-section-accent]
+    breaks: "break-inside: avoid (core MARKER_CSS)"
+    notes: "The panel chrome is opt-out; .dc-plain is the escape."
+
+  - name: chapter-opener
+    status: live
+    origin: core
+    recipe: "@chapter C.01 / @page intro / @section / # Title  (markup-driven; core injects .chapter-opener)"
+    emits: div.page[data-page=intro][data-chapter-label] > div.section > h1
+    css: [styles/components/chrome.css, styles/dc-palette.css]
+    tokens:
+      - --dc-chapter-opener-bg
+      - --dc-chapter-opener-accent
+      - --dc-chapter-opener-shadow
+      - --dc-chapter-opener-clip-tail
+      - --dc-chapter-opener-pad-top
+      - --dc-chapter-opener-pad-side
+      - --dc-chapter-opener-pad-right
+    notes: "There is no @chapter-opener macro."
+
+  # ── Author classes currently unused by the books ──────────────────────────────
+  - name: plain
+    status: unused
+    origin: author
+    recipe: "@section .dc-plain"
+    emits: div.section.dc-plain
+    css: styles/components/section.css
+    notes: "The section-chrome escape hatch (dc#39)."
+
+  - name: full-page
+    status: unused
+    origin: author
+    recipe: "@page .dc-full-page"
+    emits: div.page.dc-full-page
+    css: [styles/page-templates.css, styles/page-rules.css, styles/dc-native.css]
+    breaks: "break-before: page; page: full"
+    notes: "Documented in 05-page-templates.md; every occurrence in the guide is inside a fenced example."
+
+  - name: suppress-footer
+    status: unused
+    origin: author
+    recipe: "@page .dc-suppress-footer"
+    emits: div.page.dc-suppress-footer
+    css: styles/page-rules.css
+    breaks: "page: clean"
+
+  - name: cover-page
+    status: unused
+    origin: author
+    recipe: "raw <div class=\"dc-cover-page dc-cover-layout\"> composite"
+    emits:
+      - div.dc-cover-page.dc-cover-layout > div.dc-cover-bg + div.dc-cover-num + h1.dc-cover-bigword + p.dc-cover-strap
+      - div.dc-cover-body + div.dc-cover-meta-row
+    css: styles/components/data.css
+    tokens: [--dc-cover-meta-border]
+    notes: "Documented in 05-page-templates.md inside a fenced example only."
+
+  - name: toc-rows
+    status: unused
+    origin: author
+    recipe: "raw <div class=\"dc-toc-row\"> > .dc-toc-no + .dc-toc-title + .dc-toc-page inside .dc-toc"
+    emits: div.dc-toc-row > span.dc-toc-no + span.dc-toc-title + span.dc-toc-page
+    css: styles/components/data.css
+    notes: "Both books' contents pages use a plain list inside .dc-toc."
+
+  - name: img-float
+    status: unused
+    origin: author
+    recipe: "![alt](src){.dc-img-float-left|.dc-img-float-right}"
+    emits: img.dc-img-float-left|.dc-img-float-right
+    css: styles/components/images.css
+    notes: "Documented in 06-layout.md and 07-markdown-reference.md; no live use."
+
+  - name: portrait
+    status: unused
+    origin: author
+    recipe: "raw <div class=\"dc-portrait\"><img></div>"
+    emits: div.dc-portrait > img
+    css: styles/components/chrome.css
+    tokens: [--dc-portrait-border, --dc-portrait-surface]
+
+  - name: dashed-rule
+    status: unused
+    origin: author
+    recipe: "raw <hr class=\"dc-dashed-rule\">"
+    emits: hr.dc-dashed-rule
+    css: styles/components/chrome.css
+
+  - name: margin-sm
+    status: unused
+    origin: author
+    recipe: ".dc-margin-sm modifier (e.g. on .dc-tape)"
+    emits: .dc-margin-sm
+    css: styles/components/chrome.css
+
+  - name: path-subtitle
+    status: unused
+    origin: author
+    recipe: "raw <div class=\"dc-path-subtitle\">"
+    emits: div.dc-path-subtitle
+    css: styles/components/chrome.css
+    notes: "@learning-path emits .dc-intro for its subtitle, not this."
+
+  - name: outcome-table
+    status: unused
+    origin: author
+    recipe: "(none — no macro or markdown path emits it)"
+    emits: .dc-outcome-table
+    css: styles/components/cards.css
+    notes: "A column-span rule inside .dc-two-col; the plugin emits .dc-outcomes."
+
+  - name: roll-badges
+    status: unused
+    origin: author
+    recipe: "(none — no current authoring path)"
+    emits: [span.dc-roll-lucid, span.dc-roll-surreal]
+    css: styles/components/data.css
+    tokens: [--dc-roll-lucid-color, --dc-roll-surreal-color]
+
+  - name: sidebar-box-divider
+    status: unused
+    origin: author
+    recipe: "raw <hr class=\"dc-sidebar-box-divider\"> inside a sidebar-box"
+    emits: hr.dc-sidebar-box-divider
+    css: styles/components/data.css
+
+  - name: glossary-item
+    status: unused
+    origin: author
+    recipe: "raw <div class=\"dc-item\"> inside .dc-terms"
+    emits: div.dc-item
+    css: styles/components/images.css
+    breaks: "break-inside: avoid"
+    notes: "The class the CSS styles; the docs and gallery author .dc-terms-item instead (see glossary-item-authored)."
+
+  - name: callout-generic
+    status: unused
+    origin: author
+    recipe: "(none — no macro or markdown path emits it)"
+    emits: .dc-callout
+    css: styles/dc-native.css
+    notes: "One stale first-child glue rule in the engine sheet; the alert family emits .dc-alert. Adjacency rules for it were removed 2026-06-21 (chrome.css)."
+
+  # ── Retired: no CSS, no emission, no use (tombstone comments only) ─────
+  - name: roll-table
+    status: retired
+    origin: plugin
+    recipe: "@roll-table … @end-roll-table / @options-table … @end-options-table"
+    emits: []
+    notes: "Removed in plugin 17.3.0; the markers are still parsed and stripped as no-ops. Use @outcome or a plain table."
+
+  - name: rules-definition
+    status: retired
+    origin: author
+    recipe: "@section .dc-rules-definition"
+    emits: div.section.dc-rules-definition
+    notes: "Deleted 2026-09-02 (section.css, cards.css tombstones): 0 uses, 0 emissions."
+
+  - name: stamp
+    status: retired
+    origin: author
+    recipe: "raw .dc-stamp / .dc-classified"
+    emits: [.dc-stamp, .dc-classified]
+    notes: "Removed 2026-05-24 (chrome.css tombstone). Revive as @section .dc-stamp, not raw HTML."
+
+  - name: chapter-opener-no
+    status: retired
+    origin: plugin
+    recipe: "@chapter-opener"
+    emits: .dc-chapter-opener-no
+    notes: "The @chapter-opener macro and its badge class were retired when the composite became markup-driven (chrome.css tombstone)."
+
+  - name: art-placement
+    status: retired
+    origin: author
+    recipe: "@page .dc-art-top / .dc-art-bottom"
+    emits: [.dc-art-top, .dc-art-bottom]
+    notes: "Deleted 2026-09-02 (page-templates.css, images.css tombstones)."
+
+  - name: class-entry
+    status: retired
+    origin: plugin
+    recipe: "@class-entry … @end-class-entry"
+    emits: div.section.dc-class-entry > .dc-content-col + .dc-tag-row
+    notes: "Retired 2026-05-24 (images.css tombstone); the marker is no longer recognised and passes through as text."
+
+  - name: gear-entry
+    status: retired
+    origin: author
+    recipe: "raw .dc-gear-entry markup / @section .dc-gear-list"
+    emits: [.dc-gear-entry, div.section.dc-gear-list]
+    notes: "Removed 2026-08-21 (data.css GEAR ENTRY tombstone); neither could ever match what @gear emits."
+
+  # ── Unimplemented: documented or authored, never built ────────────────
+  - name: skill-card-continuation-marker
+    status: unimplemented
+    origin: plugin
+    recipe: "(described in 04-components.md, 09-component-gallery.md and docs/components-and-palette-reference.md as automatic ▸ / ◂ markers on split skill cards)"
+    emits: [.dc-card-cont-marker, .dc-card-fwd-marker]
+    notes: "Nothing ever emitted these; they needed a runtime script hook gutterpress does not have (cards.css comment, removed 2026-07-25). The docs describing them are stale."
+
+  - name: glossary-item-authored
+    status: unimplemented
+    origin: author
+    recipe: "raw <div class=\"dc-terms-item\"> inside .dc-terms  (as the docs and gallery write it)"
+    emits: div.dc-terms-item
+    notes: "No CSS has ever styled .dc-terms-item — images.css styles .dc-terms .dc-item. The gallery specimen renders unstyled. Resolve by renaming one side; a separate decision."
+
+# Classes a book uses that are not components.