gp-dimm-city 1.1.3 → 1.1.5

package/CHANGELOG.md

@@ -7,6 +7,45 @@ cut a version that has no `## [X.Y.Z]` heading below.
 
 ## [Unreleased]
 
+## [1.1.5] - 2026-10-09
+
+### Changed
+
+- **The chapter-opener chevron rules move from `chrome.css` into the
+  chapter-opener template in `page-templates.css`.** No component sheet
+  selects `.chapter`/`.page` any more, and the integrity test enforces
+  that with no exceptions. Pixel-identical in both books.
+- `docs/cleanup-backlog.md` gains a "Still considering" section:
+  - the Field Guide's sidebar areas, with the inset-rail rules;
+  - the specialty-card redesign;
+  - the configurable chapter prefix;
+  - the offset tokens.
+- `docs/css-roadmap.md` records the warnings that are known and accepted:
+  - the design guide's 8 heading jumps inside component examples, which
+    need an `h4`;
+  - the `clip-path` and `page-containment` lint false positives, reported
+    as dimm-city/gutterpress#339.
+
+## [1.1.4] - 2026-10-09
+
+### Changed
+
+- **The columns contract is refined.** Page and section column layouts
+  stay in `page-templates.css`. A component may lay out its own insides in
+  columns in its own sheet, on a selector rooted in its `.dc-*` class (the
+  two-column skill cards, the card grid). The integrity test enforces that
+  rule in place of an exception list. No CSS moved.
+- The integrity test's remaining exceptions are genuine hooks: the outcome
+  tiers, the chapter classes gutterpress adds itself, and the design
+  guide's page labels.
+- `docs/css-roadmap.md` records what the CSS review left to do, and in
+  which order.
+
+### Removed
+
+- Two unused design-guide classes: `dg-face-sample` and the
+  `dc-banner-demo` section class.
+
 ## [1.1.3] - 2026-10-09
 
 ### Removed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gp-dimm-city",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "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",

package/styles/components/callouts.css

@@ -18,7 +18,7 @@
    - Component-scoped public custom properties (--dc-alert-bg, etc.)
 
    MUST NOT CONTAIN:
-   - columns:N rules of any kind (→ page-templates.css)
+   - page/section columns:N layouts (→ page-templates.css)
    - @page declarations or named-page assignments (→ page-rules.css)
    - div.chapter scaffolding (→ the consuming book's own sheet)
    - :root token definitions (→ dc-component-defaults.css)

package/styles/components/chrome.css

@@ -26,13 +26,10 @@
    miscommunicates the semantic (CONTENTS shouldn't read as a warning).
    Rubric: D9 (brand identity per chapter — chroma anchor must match
    the banner's semantic role). */
-/* Chevron banner. Applies to elements explicitly marked `.dc-chevron`
-   AND to the h1 that's the first child of a chapter-opener intro section
-   — so authors don't have to write `{.dc-chevron}` on every chapter h1.
-   The structural-selector branch is the same selector used by the
-   chapter-opener composite rules above. */
-.dc-chevron,
-.chapter[data-chapter-label] > .page[data-page="intro"] > .section > h1:first-of-type {
+/* Chevron banner on elements marked `.dc-chevron`. The chapter opener's first
+   h1 gets the same treatment without the class; that rule lives with the
+   opener template in page-templates.css. */
+.dc-chevron {
   font-family: var(--font-display);
   font-size: var(--dc-chevron-font-size);
   letter-spacing: 0.06em;
@@ -83,14 +80,6 @@ h1.dc-chevron {
   line-height: 1.2;
 }
 
-/* Chapter-opener heading runs at a smaller size than other h1.dc-chevron
-   instances so the section body weight stays the focal anchor below the
-   composite badge + banner. User-approved 2026-05-25. */
-.chapter[data-chapter-label] > .page[data-page="intro"] > .section > h1:first-of-type {
-  font-size: 1.1rem;
-  line-height: 1.2;
-}
-
 /* Front-matter chevron font-size overrides moved to the book's own sheet (unlayered) per A1
    layer-ownership (page-context rules belong in the guide-specific override
    file, not the portable component library). Three-judge gate iteration 3. */
@@ -412,9 +401,8 @@ hr {
   background: repeating-linear-gradient(90deg, color-mix(in srgb, var(--crimson) 85%, var(--dc-tape-bg)) 0 6px, var(--dc-tape-bg) 6px 10px);
 }
 
-/* Chapter-opener badge + H1 banner — see the chapter-opener composite
-   block further down (.page[data-page="intro"][data-chapter-label]).
-   The legacy .dc-chapter-opener-no rules previously here were removed
+/* Chapter-opener badge + H1 banner — see "PAGE TEMPLATE: CHAPTER OPENER"
+   in page-templates.css. The legacy .dc-chapter-opener-no rules previously here were removed
    when the legacy @chapter-opener macro was retired. */
 
 /* ── Specialty art full-page plate ─────────────────────────────────────────── */

package/styles/components/section.css

@@ -743,8 +743,8 @@ h3 + .section {
      [repeat for 6+ specialties]
      @end-section
 
-   The column-flow rules (columns:2) live in page-templates.css
-   per the architectural contract. Here we own only the chrome-reset (the
+   The page/section column rules live in page-templates.css; the grid's own
+   columns:2 is a component-internal layout and lives below. Here we also own the chrome-reset (the
    .dc-card-grid section has no card background/shadow — it's a pure layout
    wrapper) plus the per-card density tweaks so all 8 specialty cards fit
    comfortably on one page. */

package/styles/page-templates.css

@@ -4,9 +4,10 @@
 
    ── ARCHITECTURAL CONTRACT ────────────────────────────────────────────────
    OWNS:
-   - ALL THEME columns:N rules — this is the ONLY file that may set columns on
-     a theme selector. Components are always single-flow. It may NOT set
-     columns on core's `.gp-columns-*` (only their `--gp-column-gap`).
+   - ALL page and section columns:N layouts — this is the ONLY file that may
+     set columns on a page template or section run. A component may column its
+     OWN internals in its own sheet (cards.css, section.css .dc-card-grid). It
+     may NOT set columns on core's `.gp-columns-*` (only their `--gp-column-gap`).
    - .page.* content layout rules (columns, flex, grid on page content divs)
    - .page base geometry, .column-break
    - .dc-full-page full-bleed geometry (its named-page assignment,
@@ -26,8 +27,9 @@
    - @media screen rules (print-only project)
 
    COLUMN OWNERSHIP RULE (narrowed, dc#41): if a THEME rule sets columns:N on a PAGE TEMPLATE (.page.*) in this
-   project, it belongs here and ONLY here. Any columns:N found in another file
-   is a bug. Core's `.gp-columns-2` / `.gp-columns-3` are the generic column
+   project, it belongs here and ONLY here. A columns:N on a page/section
+   selector found in another file is a bug (a component's own-internals layout
+   in its sheet is not). Core's `.gp-columns-2` / `.gp-columns-3` are the generic column
    vocabulary and are NOT this file's to redefine — this file may only set
    their `--gp-column-gap`. See the column-runs block below.
 
@@ -684,9 +686,28 @@
    attribute. Negative margins cancel the section padding so it reaches the
    section's outer edges; its --clip-banner tail then tapers in by --clip-tail. */
 .chapter[data-chapter-label] > .page[data-page="intro"] > .section > h1:first-of-type {
+  /* The .dc-chevron look (components/chrome.css), applied without the class
+     so authors need not write `{.dc-chevron}` on every chapter h1. */
+  font-family: var(--font-display);
+  letter-spacing: 0.06em;
+  color: var(--dc-chevron-color);
+  text-transform: uppercase;
+  background: var(--dc-chevron-bg);
+  padding: 10px 28px 10px 14px;
+  display: block;
+  box-sizing: border-box;
+  clip-path: var(--clip-banner);
+  word-break: break-word;
+
+  /* Smaller than other h1.dc-chevron so the section body stays the focal
+     anchor below the banner. User-approved 2026-05-25. */
+  font-size: 1.1rem;
+  line-height: 1.2;
+
   margin-top:   calc(var(--dc-chapter-opener-pad-top)   * -1);
   margin-left:  calc(var(--dc-chapter-opener-pad-side)  * -1);
   margin-right: calc(var(--dc-chapter-opener-pad-right) * -1);
+  margin-bottom: 0;
   --dc-chevron-bg: var(--dc-chapter-opener-accent);
 }