gp-dimm-city 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -7,6 +7,153 @@ cut a version that has no `## [X.Y.Z]` heading below.
 
 ## [Unreleased]
 
+## [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
@@ -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"
@@ -614,6 +614,40 @@ components:
     css: styles/components/cards.css
     breaks: "list items and paragraphs break-inside: avoid within the columns"
 
+  - 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: 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: "DEPRECATED in 1.1.1: gutterpress 0.11.15+ reserves the blank last page itself (dtrpg preset, `print.reserveLastPage`). A completely blank final page — no wall, no footer — kept so books that still use it build unchanged. The Field Guide still ends with it (chapter-05) until it builds on a stable gutterpress 0.11.15; drop it then."
+
+  - 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
@@ -642,23 +676,6 @@ components:
     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
@@ -667,113 +684,86 @@ components:
     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."
-
+  # ── Retired: no CSS, no emission, no use (tombstone comments only) ─────
   - 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
@@ -827,7 +817,7 @@ components:
   - 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."
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gp-dimm-city",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "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-alpha.1",
     "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';
 

package/styles/components/callouts.css

@@ -8,7 +8,6 @@
    ── ARCHITECTURAL CONTRACT ────────────────────────────────────────────────
    OWNS:
    - Every .dc-* component class (base + thin variants)
-   - Every .pmd-* utility class
    - Specialty parent-scoped overrides:
        .dc-specialty.<name> .dc-skill-card { … }
        .dc-specialty.<name> .dc-path-shell { … }
@@ -80,7 +79,7 @@
      (`.dc-ap.free`, `.dc-sidebar.inset`, `.dc-specialty.<name> .dc-X`) —
      never by re-declaring the token on the base component selector itself.
 
-   AGENT RULE: "Is this a .dc-* or .pmd-* component style, or a
+   AGENT RULE: "Is this a .dc-* component style, or a
    .dc-specialty.<name> scope block for a component?" — if NO, use another file.
    ──────────────────────────────────────────────────────────────────────── */
 

package/styles/components/cards.css

@@ -50,6 +50,13 @@
      Augmerc BODYCOVER/BLITZ seam). Same class of fix as .fg-art-portrait's
      margin-bottom in the book's own sheet (unlayered). */
   margin-bottom: calc(var(--dc-card-gap) + 6px);
+  /* The tab's outline reaches 4px above the tab (.dc-card-tab::after). Above
+     the CARD it printed at the foot of the previous page whenever the card
+     opened a page — a full-width ink-and-accent line across the folio row.
+     The card starts 4px higher and pads the tab 4px down, so the outline
+     stays inside the card's box and nothing moves. */
+  padding-top: 4px;
+  margin-top: -4px;
   max-width: 100%;
   /* 4-way ink outline (2px on each side) + HARD offset poster shadow. The
      hard shadow (2pt 3pt 0, no blur) pins the card to the brick wall as a
@@ -71,9 +78,7 @@
    script-injection hook (no manifest `scripts` key, no plugin `scripts`
    export, and assemble.ts's <head> template is fixed), so the file was dead
    and has been deleted. Split-card continuation markers are therefore an
-   UNIMPLEMENTED feature; docs that describe them (04-components.md,
-   09-component-gallery.md, docs/components-and-palette-reference.md) are
-   stale. Wiring this up requires a script hook in print-md itself. */
+   UNIMPLEMENTED feature (components.yaml: skill-card-continuation-marker). Wiring this up requires a script hook in print-md itself. */
 
 /* ── Card tab ─────────────────────────────────────────────────────────── */
 .dc-card-tab {
@@ -163,6 +168,11 @@
   letter-spacing: 0.05em;
   line-height: 1.2;
   word-break: break-word;
+  /* The title is the skill's h4 (plugin.js): clear what the h4 look adds
+     (dc-core.css) so the tab sets exactly as the span it used to be. */
+  margin: 0;
+  font-weight: inherit;
+  text-wrap: wrap;
 }
 
 .dc-tab-tier {
@@ -248,7 +258,7 @@
   right: calc(-2pt - 2px);
   bottom: calc(-3pt - 2px);
   left: calc(2pt - 2px);
-  background: rgba(0, 0, 0, 0.28);
+  background: color-mix(in srgb, #000 28%, var(--wall-tone));
   clip-path: var(--dc-skill-body-shape);
   z-index: -4;
 }
@@ -301,11 +311,9 @@
   column-fill: balance;
 }
 
-/* Inside 2-col body, force outcome tables and full-width elements to span
-   both columns so the visual chrome doesn't break across the gap. */
-.dc-skill-card.dc-two-col .dc-card-inner .dc-outcome-table,
-.dc-skill-card.dc-two-col .dc-card-inner table,
-.dc-skill-card.dc-two-col .dc-card-inner h5 {
+/* Inside 2-col body, a table spans both columns so its chrome doesn't break
+   across the gap. */
+.dc-skill-card.dc-two-col .dc-card-inner table {
   column-span: all;
 }
 
@@ -314,7 +322,6 @@
    together in a single column even when the column boundary lands in
    the middle of one. Paragraphs immediately following list items also
    stay glued so their text doesn't strand from its anchor item. */
-.dc-skill-card.dc-two-col .dc-card-inner ol > li,
 .dc-skill-card.dc-two-col .dc-card-inner ul > li,
 .dc-skill-card.dc-two-col .dc-card-inner p {
   break-inside: avoid;
@@ -334,8 +341,7 @@
   right: 16px;
   width: 28px;
   height: 2px;
-  background: var(--dc-card-body-mark);
-  opacity: 0.15;
+  background: color-mix(in srgb, var(--dc-card-body-mark) 15%, var(--dc-card-surface));
   transform: rotate(-3deg);
   z-index: 2;
 }
@@ -367,13 +373,13 @@
 
 .dc-skill-card.dc-highlight .dc-highlight-body > .dc-card-inner::after {
   background:
-    linear-gradient(to bottom, rgba(180, 40, 40, 0.10) 0%, rgba(180, 40, 40, 0) 45%),
+    linear-gradient(to bottom, color-mix(in srgb, rgb(180 40 40) 10%, var(--dc-card-surface)) 0%, var(--dc-card-surface) 45%),
     var(--dc-card-surface);
 }
 
 /* ── Continuation card variants ───────────────────────────────────────── */
 .dc-skill-card-cont {
-  margin-top: 0;
+  margin-top: -4px; /* the card's own offset: see .dc-skill-card */
 }
 
 .dc-card-tab-cont {
@@ -452,9 +458,9 @@
      CSS rectangle. */
   background:
     linear-gradient(180deg,
-      color-mix(in srgb, var(--dc-ap-bg) 90%, #fff 10%) 0%, /* PDF/X-1a: pre-composite to ~90% bg + 10% white; e.g. on --crimson (#e1261c) → #e64030; on Ingram submission replace with static opaque value in dc-tokens-print.css */
+      color-mix(in srgb, var(--dc-ap-bg) 90%, #fff 10%) 0%, /* PDF/X-1a: pre-composite to ~90% bg + 10% white; e.g. on --crimson (#e1261c) → #e64030 */
       var(--dc-ap-bg) 50%,
-      color-mix(in srgb, var(--dc-ap-bg) 94%, #000 6%) 100%); /* PDF/X-1a: pre-composite to ~94% bg + 6% black; e.g. on --crimson (#e1261c) → #d42419; on Ingram submission replace with static opaque value in dc-tokens-print.css */
+      color-mix(in srgb, var(--dc-ap-bg) 94%, #000 6%) 100%); /* PDF/X-1a: pre-composite to ~94% bg + 6% black; e.g. on --crimson (#e1261c) → #d42419 */
   color: var(--dc-ap-fg);
   /* 1pt ink-dark hairline gives registration grip — without it, adjacent
      red-family AP chips (free/var/increased) merge under CMYK dot gain
@@ -465,10 +471,9 @@
      is the #2 amateur tell after flat fills. The layered version gives depth
      that reads as "card lifted off page". */
   box-shadow:
-    inset 0 1px 0 rgba(255, 255, 255, 0.15),
-    2px 2px 0 rgba(0, 0, 0, 0.10),
-    3px 3px 6px rgba(0, 0, 0, 0.08);
-  text-shadow: 0 1px 0 rgba(0, 0, 0, 0.20);
+    inset 0 1px 0 color-mix(in srgb, #fff 15%, var(--dc-ap-bg)),
+    2px 2px 0 color-mix(in srgb, #000 10%, var(--dc-card-surface));
+  text-shadow: 0 1px 0 color-mix(in srgb, #000 20%, var(--dc-ap-bg));
   letter-spacing: 1px;
   flex-shrink: 0;
   align-self: flex-start;