gp-dimm-city 1.1.1 → 1.1.2

package/CHANGELOG.md

@@ -7,6 +7,100 @@ 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:**

package/components.yaml

@@ -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
@@ -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,22 @@ 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
@@ -631,15 +647,6 @@ components:
     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
@@ -655,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
@@ -675,16 +682,21 @@ components:
       - --dc-chapter-opener-pad-right
     notes: "There is no @chapter-opener macro."
 
-  # ── Author classes currently unused by the books ──────────────────────────────
+  # ── Retired: no CSS, no emission, no use (tombstone comments only) ─────
+  - name: printer-page
+    status: retired
+    origin: author
+    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"
+    notes: "Removed 2026-10-08 with its `@page clean` (page-rules.css, and the design guide's mirror): no book used it."
 
-  # ── Retired: no CSS, no emission, no use (tombstone comments only) ─────
   - name: cover-page
     status: retired
     origin: author
@@ -813,6 +825,13 @@ 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
@@ -821,11 +840,4 @@ components:
     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.1",
+  "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.15-alpha.1",
+    "gutterpress": "0.11.15",
     "markdown-it": "^14.1.0"
   },
   "peerDependencies": {

package/styles/components/callouts.css

@@ -100,7 +100,7 @@
   line-height: var(--lh-normal);
   padding: var(--space-lg) var(--space-xl);
   margin-top: var(--dc-alert-margin-top);
-  break-inside: avoid;
+  break-inside: var(--dc-alert-break-inside);
   /* Alerts are full-width callouts that interrupt the reading flow; they
      should NEVER overlap a preceding right-floated image (observed 2026-05-25
      with the portrait in the citizen-file intro). Block elements don't wrap

package/styles/components/cards.css

@@ -7,8 +7,6 @@
      --dc-card-surface         → card body background (default --paper-cream)
      --dc-card-tab-bg          → tab background (default --ink-dark)
      --dc-card-tab-title-color → tab title text color (default --paper-cream)
-     --dc-card-tier-color      → tier-badge fill (default --hud-magenta)
-     --dc-card-tier-border     → tier-badge border (default --hud-magenta)
      --dc-card-body-mark       → decorative ::before mark color (default --crimson)
    Specialty themes override these via .dc-specialty.<name> .dc-skill-card { }.
    Adding a new specialty: copy a sibling block (.dc-specialty.augmerc .dc-skill-card)
@@ -258,7 +256,7 @@
   right: calc(-2pt - 2px);
   bottom: calc(-3pt - 2px);
   left: calc(2pt - 2px);
-  background: color-mix(in srgb, #000 28%, var(--wall-tone));
+  background: var(--shadow-ink);
   clip-path: var(--dc-skill-body-shape);
   z-index: -4;
 }
@@ -284,15 +282,6 @@
   z-index: -2;
 }
 
-/* Two-column body variant for short skill cards. Applied via
-   `@skill {.dc-two-col}` in markdown. The .dc-card-inner content flows in
-   2 columns so a 4in single-column skill becomes ~2in tall, doubling
-   horizontal packing density. Suitable for skills with shorter mechanics
-   text (no large tables, no outcomes ladder). */
-.dc-skill-card.dc-two-col .dc-card-inner {
-  /* column-count/gap/fill owned by page-templates.css */
-}
-
 /* `.section.dc-rules-definition` (this file's columns block + the chrome/
    tokens/doc block in components/*.css) and `.two-column-list` (both here
    and its two tombstone bodies in components/*.css) were here and are
@@ -325,7 +314,71 @@
 .dc-skill-card.dc-two-col .dc-card-inner ul > li,
 .dc-skill-card.dc-two-col .dc-card-inner p {
   break-inside: avoid;
-  page-break-inside: avoid;
+}
+
+/* ── SKILL-CARD TWO-COLUMN FORM, BY ANCESTOR ───────────────────────────────── */
+/* `.dc-cards-two-col` on ANY ancestor of skill cards (a `@specialty` marker,
+   a `@chapter`/`@page`, a `@section`) makes every skill card inside it
+   two-column: `@specialty .augmerc .dc-cards-two-col`. It is the book-wide
+   counterpart of the per-card `.dc-two-col` above, and the two differ on
+   purpose. Here only running text (paragraphs and lists) flows in the two
+   columns, a paragraph MAY break between them so the columns balance, and a
+   list item stays whole. Everything else spans the card: the flavor line,
+   ability rows (AP pill + text: in a column they ran taller than the whole
+   card and could not balance), tables, outcome ladders, alerts, sub-heads
+   and rules. Per-card `.dc-two-col` instead keeps every paragraph whole and
+   spans only tables.
+   A card with its own `.dc-two-col` keeps the per-card form entirely: every
+   rule below excludes it, so its own, stricter form wins over the inherited
+   one. A card marked `.dc-allow-split` stays single-column: a balanced
+   multicol that fragments across pages leaves the first fragment's right
+   column empty.
+   Column authority for both forms is this file (COLUMNS_ALLOWLIST in
+   test/integrity.test.js): this is component-internal layout of the card
+   body, not a page or section template. */
+.dc-cards-two-col .dc-skill-card:not(.dc-two-col, .dc-allow-split) > .dc-card-body > .dc-card-inner {
+  column-count: 2;
+  column-gap: 16px;
+}
+
+/* The second selector: a text block left alone between two spanning pieces
+   (or at either end) cannot balance and would leave a column empty. */
+.dc-cards-two-col .dc-skill-card:not(.dc-two-col, .dc-allow-split) .dc-card-inner > :not(ul, ol, p:not(.dc-flavor)),
+.dc-cards-two-col .dc-skill-card:not(.dc-two-col, .dc-allow-split) .dc-card-inner > :is(:first-child, :not(ul, ol, p:not(.dc-flavor)) + *):is(:last-child, :has(+ :not(ul, ol, p))) {
+  column-span: all;
+}
+
+.dc-cards-two-col .dc-skill-card:not(.dc-two-col, .dc-allow-split) .dc-card-inner li {
+  break-inside: avoid;
+}
+
+/* An ability row under text that runs in the two columns sat flush on its
+   last line: the column row drops that text's bottom margin at the
+   spanning row. The row is moved down, not given a margin: a 0.08in margin
+   cost two pages in the Field Guide and split a card across a page turn, and
+   0.04in cost one page (measured). */
+.dc-cards-two-col .dc-skill-card:not(.dc-two-col, .dc-allow-split) .dc-card-inner > :is(p:not(.dc-flavor), ul, ol) + :is(p:not(.dc-flavor), ul, ol) + .dc-ability {
+  position: relative;
+  top: 0.06in;
+}
+
+/* A split card (`.dc-allow-split`) never opens with just its tab and a line
+   or two at a page foot: its first two blocks (the flavor line and a
+   possibly one-line ability) stay with the first two lines of what follows,
+   or the card moves to the next page. */
+.dc-specialty .dc-skill-card.dc-allow-split .dc-card-inner > :nth-child(-n+2) {
+  break-after: avoid;
+}
+
+/* In a split card a lead-in stays with what it introduces: an ability row
+   with its first lines, a bold-only pseudo-heading with the paragraph under
+   it, a paragraph with the list or table it opens. CSS cannot see text
+   nodes, so `strong:only-child` also takes a paragraph whose only markup is
+   one bold run. A last child is left out: its break-after would pass up to
+   the card and glue the next path banner to it. */
+.dc-specialty .dc-skill-card.dc-allow-split .dc-card-inner > :is(.dc-ability, p:has(> strong:only-child)):not(:last-child),
+.dc-specialty .dc-skill-card.dc-allow-split .dc-card-inner > p:has(+ :is(ul, ol, table)) {
+  break-after: avoid;
 }
 
 /* Horizontal skill placement — not currently attempted. `.dc-specialty
@@ -373,7 +426,7 @@
 
 .dc-skill-card.dc-highlight .dc-highlight-body > .dc-card-inner::after {
   background:
-    linear-gradient(to bottom, color-mix(in srgb, rgb(180 40 40) 10%, var(--dc-card-surface)) 0%, var(--dc-card-surface) 45%),
+    linear-gradient(to bottom, color-mix(in srgb, var(--tint-brick-red) 10%, var(--dc-card-surface)) 0%, var(--dc-card-surface) 45%),
     var(--dc-card-surface);
 }
 
@@ -436,7 +489,6 @@
     vertical-align: middle;
     background-color: var(--paper-aged);
     padding: 0.5em;
-    box-shadow: var(--shadow-tint);
     border: 2px dashed var(--dc-roll-the-die-border);
 }
 

package/styles/components/data.css

@@ -140,7 +140,6 @@
   bottom: 0;
   height: 3px;
   background: var(--hud-magenta);
-  opacity: 1;
   width: auto;
 }
 
@@ -300,7 +299,6 @@
   font-weight: 700;
   letter-spacing: 0.03em;
   color: var(--dc-outcome-key-color);
-  opacity: 1;
   display: block;
   line-height: 1;
   white-space: nowrap;
@@ -781,13 +779,6 @@
   max-width: 7.25in;
 }
 
-/* Universal card layout fixes — apply to any book using dc-skill-card. */
-
-:is(.dc-skill-card, .dc-skill-card .dc-card-body) {
-  height: auto;
-  min-height: 0;
-}
-
 /* `.two-column-list` (this tombstone + the base one below + both real
    rules in page-templates.css) is DELETED (2026-09-02) — 0 uses, 0
    emissions; see page-templates.css's note at its old location. */