gp-dimm-city 1.1.0 → 1.1.2

package/CHANGELOG.md

@@ -7,6 +7,247 @@ cut a version that has no `## [X.Y.Z]` heading below.
 
 ## [Unreleased]
 
+## [1.1.2] - 2026-10-08
+
+**Notes for books upgrading from 1.1.1:**
+
+- Build on gutterpress 0.11.15 or later and drop `@page .dc-printer-page`
+  and your own `print.signature`: the `dtrpg` preset now does both.
+- Field Guide classes that moved into the package: `.fg-snug` becomes
+  `.dc-snug`, and the book-wide two-column skill cards become
+  `.dc-cards-two-col` on the specialty markers.
+- Section panels, padding and splitting are tokens now. A book that
+  restyled `.section` chrome by overriding properties should set the
+  tokens instead (see the palette reference's Section table).
+
+### Added
+
+- **`.dc-cards-two-col`**: on any ancestor (`@specialty`, `@chapter`,
+  `@page`, `@section`), every skill card inside gets a two-column body.
+  This is the Field Guide's book-wide form as an opt-in. A card's own
+  `.dc-two-col`, or `.dc-allow-split`, keeps its own form.
+- **`.dc-snug`**: tighter paragraph and list-item spacing on a section or
+  page, for one that would otherwise overflow by a line or two (from the
+  Field Guide's `.fg-snug`).
+- **Split skill cards keep their lead-ins with what follows.**
+  `.dc-specialty .dc-skill-card.dc-allow-split` keeps its tab, first
+  blocks and lead-in paragraphs with the next block (from the Field
+  Guide's own sheet).
+- **Section tokens.** A section's panel, shadow and padding now come from
+  tokens (`--dc-section-surface`, `--dc-section-shadow`,
+  `--dc-section-pad-*`), as does whether a box may split
+  (`--dc-section-break-inside`, `--dc-alert-break-inside`). Variants and
+  page templates set tokens instead of cancelling properties.
+- **`test/integrity.test.js`**, which checks that:
+  - every class the books use is styled;
+  - every token that is read, or that the palette reference documents,
+    is declared;
+  - each stylesheet keeps its stated contract.
+
+### Changed
+
+- **Tested against gutterpress 0.11.15** (stable; was 0.11.15-alpha.1).
+- **CSS quick wins from an architecture review.**
+  - New tokens: `--shadow-ink` (the opaque wall-shadow colour, written
+    out five times before) and four exact-value `--tint-*` mix sources
+    for the literal `rgb()` colours inside `color-mix()`.
+  - `--dc-section-tab-overlap` and `--dc-section-tab-indent` are now
+    public `:root` tokens.
+  - The TOC/credits masthead `h1` is now one rule instead of two.
+  - Dead declarations are gone: the `--shadow-poster` layer a specialty
+    card's own `clip-path` clipped away, `page-break-inside`, an empty
+    rule, a no-op height reset, three `opacity: 1`, and the
+    `break-before: always` Chromium ignores on learning paths.
+  - `dc-native.css` loses its tombstones and is renumbered §1–8.
+  - Pixel-identical in both books, except the even specialty cards,
+    whose left border is now `1.5pt` like the rest (was `1.5px`).
+
+- **Section styling is opt-in per variant, not cancelled by a central list.**
+  - `.dc-plain`, `.dc-tabbed`, `.dc-column-panel` and `.dc-card-grid` set
+    the section tokens.
+  - The header bar's negative margins are derived from the padding.
+  - The shared page templates (intro, credits, chapter opener) own their
+    styling in `page-templates.css`; the chapter opener moves there from
+    `section.css`.
+  - Pixel-identical in both books.
+- **The credits colophon shows its 4px front-matter rail again.** A rule in
+  `dc-native.css` had overridden it. This is the one visible change, on
+  each book's credits page.
+- **Box splitting is decided in one place.**
+  - Multi-column runs and `.dc-allow-split` set the break-inside tokens.
+  - This replaces an avoid → auto → avoid override chain.
+
+### Removed
+
+- **`.dc-printer-page` and its `@page printer-blank`** (deprecated in
+  1.1.1). gutterpress 0.11.15's `dtrpg` preset pads the interior to the
+  4-page signature and reserves the blank last page itself, so a book
+  needs neither the marker nor its own `print.signature`. The Field
+  Guide, built on 0.11.15 without either, keeps its 232 pages
+  pixel-identical and still ends on four blank pages.
+- `--shadow-tint`, and `.dc-roll-the-die`'s `box-shadow: var(--shadow-tint)`:
+  a bare colour is not a valid shadow, so it never rendered.
+- `.dc-suppress-footer` and its `@page clean` (and the design guide's
+  mirror of it): no book used footer suppression.
+- The design guide's dual specialist and generalist skill-tree specimens
+  (Variant Gallery; The Specialty System's "One source" section, now
+  "eight shapes"). Those two specialties take their skills from the other
+  eight and have no trees of their own, so the specimens printed a
+  generic `PATH1` sticker for something that cannot exist.
+
+### Fixed
+
+- The catalog's glossary entries: a glossary item is a plain paragraph
+  inside `@glossary`, and no doc or gallery page writes `.dc-terms-item`
+  any more, so `glossary-item-authored` is retired.
+
+## [1.1.1] - 2026-10-08
+
+**Notes for books upgrading from 1.1.0:**
+
+- A learning-path banner is now an `h3` (was `h2`), and a skill's title an
+  `h4` (was a `span`). A book stylesheet that targets `h2.dc-spray` or
+  `span.dc-tab-title` needs the new tag.
+- Unused components were removed; check `docs/cleanup-backlog.md` and the
+  Removed list below before relying on any of them.
+- Tested against gutterpress 0.11.15-alpha.1, whose `dtrpg` preset now
+  does the DriveThruRPG blank last page and K-only black text.
+
+### Added
+
+- **Heading look classes `.dc-h3`–`.dc-h6`.** A heading keeps its outline
+  level and takes another level's look (`## Useful Items {.dc-h3}`), so a
+  book can stop skipping levels to get a smaller label: gutterpress flags
+  every skip. The section header bar and the in-section accent rule follow
+  the class, not the tag. On a paragraph, the class sets a line in
+  heading type outside the outline. The Field Guide's 13 skipped levels
+  are fixed this way and render pixel-identical. Documented in the
+  design guide's Typography chapter (Level and look).
+
+### Changed
+
+- **Tested against gutterpress 0.11.15-alpha.1** (devDependency, was
+  0.11.13), the release that upstreams this package's two DriveThruRPG
+  workarounds: `preset: dtrpg` now pads to a 4-page signature and always
+  ends on a blank reserved page (`print.reserveLastPage`,
+  dimm-city/gutterpress#332), and prints near-black text on the black plate
+  only in PDF/X builds (`pdfx.blackText: k-only`, dimm-city/gutterpress#331).
+  Verified on the Field Guide with the alpha: its 228 content pages render
+  pixel-identical to 0.11.13, and without any workaround the book ends on
+  4 pure-white pages (232). The design guide's Publishing chapter documents
+  both settings.
+- **Specialty chapters nest in the outline.** A learning path's title was
+  emitted as an `h2`, the same level as the specialty name, and a skill's
+  title as a plain `span`, so the app's contents panel and the PDF
+  bookmarks listed every skill tree beside its specialty and no skills at
+  all. The plugin now emits the heading levels the markdown is written
+  at: specialty (`##`) > learning path (`h3.dc-spray`) > skill
+  (`h4.dc-tab-title`). The CSS follows, and both books render
+  pixel-identical. A stylesheet that targeted `h2.dc-spray` or
+  `span.dc-tab-title` needs the new tag. A real space
+  (`span.dc-path-sep`, carrying the 10px gap the sticker's margin used to
+  give) separates a banner's tree code from its title, so the outline
+  reads "PRX1 Refuse Finality", not "PRX1Refuse Finality".
+
+### Fixed
+
+- **DriveThruRPG PDF/X builds keep live text.** The brick wall was an RGBA
+  tile blended with `background-blend-mode: multiply`, so every walled page
+  carried transparency, which PDF/X-1a cannot represent: Ghostscript
+  flattened each one to a raster image — no live text or embedded fonts
+  (a one-page book failed validation outright), and black text left
+  four-colour, because `pdfx.blackText: k-only` only reaches vector text.
+  The wall is now `images/brick-wall.png`, the same tile multiplied into
+  `--bg` and flattened to an opaque image, painted with no blend mode:
+  it renders the same (design guide wall pages differ by 0.15/255 on
+  average), and with gutterpress 0.11.15-alpha.1 a DriveThruRPG build's
+  body text now prints on the black plate only (separations: C = M = Y = 0
+  under every glyph). A book that retints `--bg` no longer tints the
+  brick; see the note in `dc-native.css` for baking a tile.
+- **Nothing in the package paints transparent.** The 25 other uses of
+  transparency — semi-transparent shadows, tinted fills, `opacity` on
+  stickers, rules, the tape dashes and the pull-quote mark — each flattened
+  their page in PDF/X-1a just as the wall did. Each is now pre-composited
+  with `color-mix()` onto the surface it sits on, so it prints the same
+  colour, opaque. Shadows on the wall mix against the new `--wall-tone`
+  (`#c1beb8`, the tile's measured mean). Measured on both books: layout and
+  page counts unchanged, and no page changes more than 0.7% of its pixels.
+  The AP chip loses its soft 6px blurred shadow, which has no opaque form,
+  and keeps its hard one. Every change, with where to look, is in
+  `docs/print-transparency-inventory.md`. A new convention test fails on
+  any transparency in the stylesheets, with no exemptions (the one
+  translucent holdout, the unused cover-page composite, was removed).
+
+- **No stray ink line across the folio row.** A skill card, learning-path
+  banner or specialty intro that opened a page printed the top 2–4px of its
+  outline at the foot of the PREVIOUS page: a full-width black (or accent)
+  line between the folio and chapter chips. The outlines reached above
+  their component's box (`top: -4px`, `translateY(-2px)`), and Chromium
+  fragments that part onto the page before. Each outline now sits inside
+  its own box: the card starts 4px higher and pads its tab 4px down
+  (`padding-top: 4px; margin-top: -4px`), the banner 2px likewise, and
+  the intro pads its content 2px. Mid-page nothing moves; a component that
+  opens a page sits 2–4px lower. Measured: the line is gone from all 17 Field Guide pages and
+  the 1 design guide page that had it; page counts are unchanged (232, 132) and
+  no text changes page. (It became visible with 1.1.0's DriveThruRPG
+  margins, which moved the page breaks; the cause dates from 1.0.0.)
+
+- **Accent rails print as vectors in PDF/X.** The 3–5px coloured rail down
+  the left of sections, ledes, path banners, the Panel and Shard blocks,
+  and the front-matter and intro panels was a hard-stop
+  `linear-gradient`. The PDF/X conversion turned each gradient into a
+  45 ppi bitmap, so the rail's edge printed soft, and
+  `gutterpress preflight` flagged the pages as low-resolution. Each rail
+  is now an inset `box-shadow` over a flat fill: it looks the same and
+  prints as a vector.
+- **Design guide: preflight checks the right page size.** Its manifest
+  declared 612 × 792 pt (the bare Letter trim), so `gutterpress preflight`
+  failed every build on page size. It now declares the sheet the CSS
+  prints: 621 × 810 pt, the trim plus DriveThruRPG's bleed.
+
+- **`.gp-columns-flow` works.** Core declares it in its own layer, which
+  this package's `column-fill: balance` on every `.gp-columns-2/-3`
+  outranked, so a run marked to flow stayed balanced. The balance rule now
+  skips runs marked `.gp-columns-flow`.
+
+- **Catalog statuses.** `plain`, `img-float`, `full-page` and
+  `printer-page` were marked `unused` although a book uses each: the
+  design guide renders the first two, SysOps uses `full-page`, and the
+  Field Guide still ends on `@page .dc-printer-page` until it builds on a
+  stable gutterpress 0.11.15. They are `live` now.
+### Removed
+
+- `images/brick-bg-01.png`, the RGBA wall tile, is no longer published
+  (it now lives in the repository's `source-art/`). Neither Dimm City book
+  referenced it; a book that did should use `images/brick-wall.png`.
+- **Dead styling, from an orphan audit of the package, the design guide and
+  the Field Guide.** Each item was used by no book (Field Guide, Design
+  Guide, SysOps), and both books render pixel-identical without it:
+  - components: the cover-page composite (`.dc-cover-*`, with
+    `--dc-cover-meta-border`), the contents-page rows (`.dc-toc-row/-no/
+    -title/-page`), `.dc-portrait` (with `--dc-portrait-*`), the roll badges
+    `.dc-roll-lucid/-surreal` (with their colour tokens), `.dc-path-subtitle`,
+    the glossary item `.dc-terms .dc-item` (with `--card-border-color`),
+    `.dc-dashed-rule`, `.dc-tape.dc-margin-sm`, `.dc-sidebar-box-divider`,
+    `.dc-outcome-table` and `.dc-callout`. Their catalog entries are now
+    `retired`.
+  - rules for markup the plugin no longer produces: `.dc-sticker.active`,
+    the `ol`/`li` rules under `.dc-ability` (abilities are no longer
+    lists), and `h5` and `ol > li` inside a two-column skill card (both
+    are converted before they get there).
+  - stale comments naming deleted files or classes (`dc-tokens-print.css`,
+    `components.css`, `tokens.css`, the `.pmd-*` utilities, `.dc-accent-X`,
+    old design-guide chapter names, undeclared tokens).
+  Styling the audit found unused but still reachable is listed in
+  `docs/cleanup-backlog.md` for review.
+
+### Deprecated
+
+- **`@page .dc-printer-page`.** gutterpress 0.11.15+ reserves the blank
+  last page in core. The class still works — a book that keeps it gets one
+  printer page plus padding, still ending blank — and goes in the next
+  major.
+
 ## [1.1.0] - 2026-10-07
 
 **Layout note for books upgrading from 1.0.x:** the page margins now follow

package/components.yaml

@@ -147,7 +147,7 @@ components:
     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."
+    notes: "The design guide (06-panels-and-cards) points a plain term list at a markdown definition list instead; both books still use the macro."
 
   - name: procedure
     status: live
@@ -234,11 +234,11 @@ components:
   - 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)"
+    recipe: "@glossary … @end-glossary  (items are plain `**term** — gloss` paragraphs)"
     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)."
+    notes: "Used by the design guide (06-panels-and-cards). Items take no class of their own; the old item classes are retired (glossary-item, glossary-item-authored)."
 
   - name: outcome
     status: live
@@ -333,7 +333,7 @@ components:
     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-learning-path.dc-path-block > div.dc-path-shell > h3.dc-spray > span.dc-path-sticker + span.dc-path-sep
       - div.dc-path-shell > div.dc-intro
       - div.dc-stickers > span.dc-sticker > span.dc-sticker-ref
       - span.dc-arrow (between stickers)
@@ -345,14 +345,14 @@ components:
       - --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"
+    breaks: "break-before/after: auto on the block; the h3 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-skill-card[name][data-break-inside=avoid] > div.dc-card-tab > h4.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]
@@ -471,7 +471,7 @@ components:
     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."
+    notes: "Themed through the section chassis tokens --dc-section-accent / --dc-section-bg (see section), which the design guide documents."
 
   - name: citizen-file-page
     status: live
@@ -544,7 +544,7 @@ components:
     status: live
     origin: author
     recipe: "## Title {.dc-spray}  (also emitted by @learning-path for its title)"
-    emits: h2.dc-spray
+    emits: ["h2.dc-spray (authored)", "h3.dc-spray (a @learning-path title)"]
     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"
@@ -602,8 +602,8 @@ components:
     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"
+    css: [styles/components/section.css, styles/components/cards.css]
+    breaks: "break-inside: auto — opts a section or skill card out of the default avoid. A split specialty card also keeps its first two blocks, and any lead-in (ability row, bold-only line, paragraph before a list or table), with what follows (break-after: avoid)"
     notes: "The plugin reads this class (to drop data-break-inside=avoid) but never adds it."
 
   - name: two-col
@@ -614,6 +614,47 @@ components:
     css: styles/components/cards.css
     breaks: "list items and paragraphs break-inside: avoid within the columns"
 
+  - name: cards-two-col
+    status: live
+    origin: author
+    recipe: "@specialty .augmerc .dc-cards-two-col  (or on @chapter / @page / @section)"
+    emits: .dc-cards-two-col (on the ancestor it is written on; styles the .dc-skill-card inside it)
+    css: styles/components/cards.css
+    breaks: "list items break-inside: avoid; a paragraph may break between columns. Flavor line, ability rows, tables, sub-heads and rules span both columns. A card with .dc-allow-split stays single-column; a card with its own .dc-two-col keeps the per-card form"
+
+  - name: snug
+    status: live
+    origin: author
+    recipe: "@section .dc-snug  /  @page .dc-snug"
+    emits: .dc-snug (on the section or page it is written on)
+    css: styles/page-templates.css
+    notes: "Paragraph and list-item margin-bottom drops to 0.04in so a section or page that overflows by a line or two fits. Type size and leading are untouched."
+
+  - name: plain
+    status: live
+    origin: author
+    recipe: "@section .dc-plain"
+    emits: div.section.dc-plain
+    css: styles/components/section.css
+    notes: "The section-chrome escape hatch (dc#39). The design guide renders it (11-variants)."
+
+  - name: full-page
+    status: live
+    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: "Used by SysOps (chapter-00); the design guide documents it in a fenced example (08-page-templates)."
+
+  - name: img-float
+    status: live
+    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 and rendered in the design guide (04-layout, 11-variants); no Field Guide use."
+
   # ── Core-owned structure whose public tokens this library declares ─────
   - name: section
     status: live
@@ -621,9 +662,9 @@ components:
     recipe: "@section  (bare; core markers.js emits the wrapper)"
     emits: div.section
     css: styles/components/section.css
-    tokens: [--dc-section-bg, --dc-section-accent]
+    tokens: [--dc-section-bg, --dc-section-accent, --dc-section-surface, --dc-section-shadow, --dc-section-pad-top, --dc-section-pad-right, --dc-section-pad-bottom, --dc-section-pad-left]
     breaks: "break-inside: avoid (core MARKER_CSS)"
-    notes: "The panel chrome is opt-out; .dc-plain is the escape."
+    notes: "Panel chrome is token-driven: variants and templates set --dc-section-surface/-shadow/-pad-* on their own rule; .dc-plain turns both layers off."
 
   - name: chapter-opener
     status: live
@@ -641,139 +682,100 @@ components:
       - --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
+  # ── Retired: no CSS, no emission, no use (tombstone comments only) ─────
+  - name: printer-page
+    status: retired
     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."
+    recipe: "@page .dc-printer-page  (the last marker of a book's last chapter)"
+    emits: div.page.dc-printer-page
+    notes: "Removed in 1.1.2 with its @page printer-blank: gutterpress 0.11.15's dtrpg preset pads to the 4-page signature and reserves the blank last page itself (print.reserveLastPage)."
 
   - name: suppress-footer
-    status: unused
+    status: retired
     origin: author
     recipe: "@page .dc-suppress-footer"
     emits: div.page.dc-suppress-footer
-    css: styles/page-rules.css
-    breaks: "page: clean"
-
-  - name: printer-page
-    status: live
-    origin: author
-    recipe: "@page .dc-printer-page  (the last marker of a book's last chapter)"
-    emits: div.page.dc-printer-page
-    css: [styles/page-rules.css, styles/dc-native.css]
-    breaks: "page: printer-blank; break-before: page"
-    notes: "A completely blank final page — no wall, no footer — for DriveThruRPG's reserved printer page. With `print: signature: 4` in the manifest, gutterpress pads to the next multiple of 4, so the book always ends blank. Used by the Field Guide."
+    notes: "Removed 2026-10-08 with its `@page clean` (page-rules.css, and the design guide's mirror): no book used it."
 
   - name: cover-page
-    status: unused
+    status: retired
     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."
+    notes: "Removed 2026-10-08 (data.css): no book used it, and its translucent gradients were the PDF/X transparency test's only exemption."
 
   - name: toc-rows
-    status: unused
+    status: retired
     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."
+    notes: "Removed 2026-10-08 (data.css): both books' contents pages use a plain list inside .dc-toc."
 
   - name: portrait
-    status: unused
+    status: retired
     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]
+    notes: "Removed 2026-10-08 (chrome.css) with its --dc-portrait-* tokens: never used."
 
   - name: dashed-rule
-    status: unused
+    status: retired
     origin: author
     recipe: "raw <hr class=\"dc-dashed-rule\">"
     emits: hr.dc-dashed-rule
-    css: styles/components/chrome.css
+    notes: "Removed 2026-10-08: plain `hr` keeps the dashed rule (chrome.css)."
 
   - name: margin-sm
-    status: unused
+    status: retired
     origin: author
     recipe: ".dc-margin-sm modifier (e.g. on .dc-tape)"
     emits: .dc-margin-sm
-    css: styles/components/chrome.css
+    notes: "Removed 2026-10-08 (chrome.css): never used."
 
   - name: path-subtitle
-    status: unused
+    status: retired
     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."
+    notes: "Removed 2026-10-08 (chrome.css): @learning-path emits .dc-intro for its subtitle."
 
   - name: outcome-table
-    status: unused
+    status: retired
     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."
+    notes: "Removed 2026-10-08 (cards.css): nothing emitted it; the plugin emits .dc-outcomes."
 
   - name: roll-badges
-    status: unused
+    status: retired
     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]
+    notes: "Removed 2026-10-08 (data.css) with --dc-roll-lucid-color/--dc-roll-surreal-color: no authoring path."
 
   - name: sidebar-box-divider
-    status: unused
+    status: retired
     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
+    notes: "Removed 2026-10-08: a plain `hr` inside a sidebar box is the divider (data.css)."
 
   - name: glossary-item
-    status: unused
+    status: retired
     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)."
+    notes: "Removed 2026-10-08 (images.css, with --card-border-color): never used; see glossary-item-authored for the open naming question."
 
   - name: callout-generic
-    status: unused
+    status: retired
     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)."
+    notes: "Removed 2026-10-08 (dc-native.css): nothing emits .dc-callout; the alert family is .dc-alert."
 
-  # ── Retired: no CSS, no emission, no use (tombstone comments only) ─────
   - name: roll-table
     status: retired
     origin: plugin
@@ -823,19 +825,19 @@ components:
     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."
 
+  - name: glossary-item-authored
+    status: retired
+    origin: author
+    recipe: "raw <div class=\"dc-terms-item\"> inside .dc-terms"
+    emits: div.dc-terms-item
+    notes: "Never styled, and no doc or gallery page writes it any more (2026-10-08): a glossary item is a plain paragraph inside @glossary."
+
   # ── 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)"
+    recipe: "(described in 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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gp-dimm-city",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Dimm City design system for Gutterpress: the markdown-it macros (@skill, @specialty, @learning-path, @callout, …), print stylesheets, design tokens, fonts and page templates the Dimm City TTRPG books are set in.",
   "type": "module",
   "main": "plugin.js",
@@ -68,7 +68,7 @@
     "pack:check": "npm pack --dry-run"
   },
   "devDependencies": {
-    "gutterpress": "0.11.13",
+    "gutterpress": "0.11.15",
     "markdown-it": "^14.1.0"
   },
   "peerDependencies": {

package/plugin.js

@@ -1565,10 +1565,9 @@ export default function dimmCityPlugin(md, options = {}) {
       }
 
       // Removed 2026-05-17: @two-column / @three-column / @no-break.
-      // Use @section .gp-columns-2 / @section .gp-columns-3 / @section .pmd-no-break
-      // instead — markers.js emits identical layout semantics, with the
-      // added `.section` class that picks up `break-inside: avoid` from MARKER_CSS.
-      // See docs/migrations/2026-05-removing-container-syntax.md for the rationale.
+      // Use @section .gp-columns-2 / @section .gp-columns-3 instead — markers.js
+      // emits identical layout semantics, with the added `.section` class that
+      // picks up `break-inside: avoid` from MARKER_CSS.
 
       // --- @gear / @end-gear ---
       // Shorthand for @card .dc-gear — emits a bare `.dc-card.dc-gear`.
@@ -1753,12 +1752,17 @@ export default function dimmCityPlugin(md, options = {}) {
 
       // Inside @learning-path section
       if (inLearningPath && !inSkillMode) {
-        // H3 = Learning path title (banner)
+        // H3 = Learning path title (banner). Emitted as an h3, the level it
+        // was written at: the outline (the app's contents panel, PDF
+        // bookmarks) nests specialty (##) > learning path (###) > skill (####).
+        // .dc-path-sep is a real space between the sticker and the title, so
+        // the heading's text reads "PRX1 Refuse Finality" (outline, bookmarks,
+        // copy, search, screen readers); chrome.css gives it the printed gap.
         if (tok.type === 'heading_open' && tok.tag === 'h3') {
           const inlineTok = tokens[i + 1];
           const titleText = inlineTok && inlineTok.content ? inlineTok.content : '';
           currentLearningPathName = titleText;
-          newTokens.push(makeToken('html_block', '<h2 class="dc-spray"><span class="dc-path-sticker">' + esc(currentLearningPathRef) + '</span>' + esc(titleText) + '</h2>\n'));
+          newTokens.push(makeToken('html_block', '<h3 class="dc-spray"><span class="dc-path-sticker">' + esc(currentLearningPathRef) + '</span><span class="dc-path-sep"> </span>' + esc(titleText) + '</h3>\n'));
           learningPathHasTitle = true;
           i += 2; // Skip heading_open, inline, heading_close
           continue;
@@ -1896,7 +1900,7 @@ export default function dimmCityPlugin(md, options = {}) {
 
       // Mark image-only paragraphs so layout rules can target them without
       // relying on p:has(img). The base CSS rule
-      // (p.dc-img-wrapper { padding:0; margin:0 }) lives in components.css.
+      // (p.dc-img-wrapper { padding:0; margin:0 }) lives in components/data.css.
       // Per-page rules can further refine position via .page.my-class p.dc-img-wrapper.
       if (tok.type === 'paragraph_open') {
         const inlineTok = tokens[i + 1];
@@ -1967,7 +1971,10 @@ export default function dimmCityPlugin(md, options = {}) {
           const tabBaseClass = 'dc-card-tab' + (parsed.highlight ? ' dc-highlight' : '');
           cardHtml += '  <div class="' + tabBaseClass + '">\n';
           const autoTier = currentLearningPathRef ? currentLearningPathRef + '.' + currentSkillIndex : '';
-          cardHtml += '    <span class="dc-tab-title">' + esc(parsed.name) + '</span>\n';
+          // The skill's name is its `####` heading, kept a heading so the
+          // outline lists it under its learning path. (A continuation card's
+          // repeated title stays a span: it is not a new entry.)
+          cardHtml += '    <h4 class="dc-tab-title">' + esc(parsed.name) + '</h4>\n';
           cardHtml += '    <span class="dc-tab-tier">' + esc(parsed.tier || autoTier) + '</span>\n';
           cardHtml += '  </div>\n';