gp-dimm-city 1.6.3 → 1.7.0-alpha.2

package/CHANGELOG.md

@@ -7,6 +7,241 @@ cut a version that has no `## [X.Y.Z]` heading below.
 
 ## [Unreleased]
 
+## [1.7.0] - 2026-10-15
+
+A redesign pass by component family. A reader should know what kind of box they
+are looking at from its silhouette, fill value and colour before reading a word,
+and every variant is told apart in grayscale as well as in colour (value, edge
+and label, never hue alone). Magenta is display punch only (chevrons, spray
+titles, pull quotes, `ROLL THE DIE!`, the VAR chip, the default panel accent);
+the other roles are HUD blue for player rules and look-ups, cyan on ink for the
+Dream Master only, hazard yellow with ink for danger and choices, blood and rust
+for harm and cost, violet for the world, fungi green for the organic. The
+constitution is revised to match: §II adds the colour roles and the grayscale
+rule, §V and §VI set a 10pt type floor, §VII describes the
+new components, and §IX narrows the Pass 6/7/8 bans to specialty cards and
+reading surfaces.
+
+A second pass, from review of 1.7.0-alpha.1, set a 10pt type floor for all
+text, took every word off the brick wall, tied shape to meaning and added a
+little grit.
+
+### Added
+
+- **`@page specialty-catalog`**: the specialty catalog is a designed two-page
+  spread. It opens on a left page; the title, the lede and four cards fill the
+  left page and six the right, in aligned rows of equal height. Each card is a
+  poster: portrait on top in an ink mat cut to its specialty's silhouette,
+  name, tagline, pitch and an index chip. Snippet *Specialty Catalog Page*.
+- **`@definition lucid` and `@definition surreal`**: the two roll states drawn
+  as opposites. Lucid is a light, machined, upright sheet in a blue frame;
+  Surreal is an inverted violet-black sheet with a skewed torn edge,
+  off-register inks and a leaning headword.
+- **No text on the wall.** On wall pages free-standing text gets a substrate
+  with no markup: a `#` title is an accent banner, `##` a pasted paper slip
+  (accent rail, dashed foot, tape), `###` a plain slip, `####` and below a
+  label slip, and loose paragraphs, lists and quotes share one paper sheet per
+  run. A bare `@section` is a paper sheet; flavor lines and the spec tweak sit
+  on paper strips; the Citizen File running head is an amber tab. Tokens
+  `--dc-page-slip-*`, `--dc-page-sheet-pad`, `--dc-page-title-ink`,
+  `--dc-flavor-bg`.
+- **Grit**, vector and opaque, on edges and labels only: chipped corners,
+  tape strips, misregistered second-ink rules (`--dc-band-reg` on the tech
+  specialties), worn stamp rings, torn feet, a staple on the procedure plate.
+- **`--dc-accent-ink`**: the text-safe ink of the component you are in. Every
+  alert, section kind, block, card, faction, entry, table and specialty sets
+  it; chapter accents flow through.
+
+### Changed
+
+- **Type floor: 10pt for all text**, chips, tabs, tier pills, AP chips,
+  badges, stamps, folio and chapter chips, stickers and labels included. New
+  token `--fs-floor` (10pt); `--fs-h6` is the floor (was 9pt). Chrome that
+  grew was refitted so nothing wraps or clips; a five-step sticker chain may
+  now wrap to two rows.
+- **ROLL THE DIE! takes the colour of its component** (deep magenta in a
+  magenta panel, blood in a blood box, the specialty's ink on a skill card).
+  `--dc-roll-the-die-color` is replaced by `--dc-accent-ink`.
+- **Fiction is a cavity.** `@fiction-excerpt` is an aged page sunk into a
+  ragged hole in the wall: a dark torn rim, a hard shadow down the top and
+  left, a lit lip at the bottom and right, deeper on a chapter opener. New
+  tokens `--dc-fiction-depth`, `-depth-bg`, `-cavity`, `-lip`, `-rim`,
+  `-hole`; `--dc-fiction-lift` and `-lift-bg` are removed.
+- **Shape carries meaning.** Player rules and look-ups are machined chamfers;
+  Dream-Master-only boxes are file folders (the `dm` section's tab carries the
+  words, replacing its chip); danger and enforcement are sign plates; lore and
+  cabal long asymmetric slashes; fiction, backstory, cult and flaws torn;
+  choices ticket notches; gear tags; magic facets; organic boxes wobble. The
+  seven alerts, every section kind, block, choice card, faction, entry, table
+  and all ten specialties are re-cut to match, and every clipped edge is
+  padded clear of its cut by 2pt or more.
+- **Folio and chapter chips** are fixed-height boxes with their type centred,
+  on recto and verso. The chapter chip is a stamped coupon with a perforated
+  edge, replacing the dashed outline.
+
+- **Alerts: seven registers, seven silhouettes.** Each has its own fill value,
+  edge and label, and bodies are upright (only vibe and origin stay italic).
+  - note: the calm HUD-blue panel with a blue rail, as before.
+  - warning: a light cream hazard sign: a yellow and black stripe rail, an ink
+    frame and a yellow caution-tape label. It signals consequence.
+  - dm: an ink slab with a cyan rail and a cyan chip. It signals the Dream Master
+    only.
+  - vibe: a barely violet flat sheet in one dashed violet edge, italic, with no
+    rail: the world's voice, not a slab.
+  - origin: warm paper, a rust rail, a dog-eared corner and a crimson rubber-stamp
+    label: second-person backstory.
+  - visit: a fungi-green signpost with a map-pin label: a place.
+  - example: a dashed cyan rail with a taped-on label.
+  New tokens `--dc-alert-frame`, `-label-bg` and `-label-pad` carry the frame
+  and label chrome. The hazard rail, the dog-ear fold, the spray stencil line and
+  the NPC card foot are drawn in vector (dashed borders and clip-path), because
+  gradients are dropped or rasterised in PDF/X. The DM and visit bodies are
+  semibold (reversed type).
+- **Section kinds read from their bar and sheet.** Panel keeps the solid accent
+  bar on cream (magenta by default, the only kind a chapter re-themes); reference
+  a pale HUD band; lore a deep violet bar over a lilac sheet; dm an ink bar with a
+  cyan rule, a cyan rail and a Dream Master chip (cyan on ink is now the Dream
+  Master's alone), with a strip of its own when it has no heading. `choose` is a
+  printed form, not a panel: a paper sheet a hair lighter than cream, a dashed ink
+  edge, no bar or cut corners, an ink title over a double rule, heavy ink tick
+  boxes, dotted write-in rules and a yellow *Your choice* stamp. The title bar is
+  one rule reading new tokens (`--dc-section-bar-mix` / `-bar-tone` / `-bar-fg` /
+  `-bar-rule` / `-bar-rule-sub`, and `--dc-section-flag`); each kind sets them
+  instead of repainting the bar, and so does the catalog. A block's band reads
+  `--dc-block-title-rule` and `--dc-block-tag`.
+- **Blocks: three registers.** `@block panel` stays HUD blue; `slate` is an ink
+  body under a blood band with a stamped *Binding* tag (not magenta, not the
+  Dream Master's cyan); `shard` is light zine paper with a torn foot and a taupe
+  label strip, no accent hue.
+- **Choice cards say which choice they are.** A Flaw is blood with a cracked edge,
+  an Ideal HUD blue with a steady tablet shape, a Dream violet with a rising edge,
+  each with a one-word chip and a kind-tinted quote. The kind sets
+  `--dc-choice-accent`, `-surface`, `-tint` and `-kind`, and a card inside them
+  reads them (the choice chrome is scoped to `@flaws`/`@ideals`/`@dreams`, so a
+  gear entry or a faction keeps the plain card).
+  The card name is the first `####`; the docs and snippets say `####` throughout.
+- **Factions have their own silhouettes.** Megacorp a hard blue rectangle with a
+  cyan-edged band, cabal violet with long corner cuts, cult blood and torn, enforcer
+  an octagon with a hazard-stripe band and a yellow name label. The bands are
+  vector (solid inset shadows; the enforcer's tape is a skewed dashed border), not
+  gradients. New tokens `--dc-faction-surface`, `-band` (a box-shadow list),
+  `-band-height`, `-pad-bottom`, `-badge-shape`, `-title`, `-title-bg` and
+  `-title-pad`.
+- **A creature's stat line is a chip.** The first line of an `@npc-stat`'s primary
+  stat paragraph is set 12pt bold, cream on the block's colour (`::first-line`, no
+  markup); the rest falls under it as a small-caps tag.
+- **Entry cards differ by silhouette, surface and badge.** Gear is a hang tag
+  (a paper card in a heavy ink frame, an eyelet, a rust rail), an augment a spec
+  chip (a stepped notch, a cyan rule), treasure a gem (an octagon cut, a facet), a
+  vehicle an industrial plate (a dotted seam of rivets, a yellow badge), a drug a
+  prescription label (the one rounded shape, an *Rx · Drug* pill). Every mark is a
+  solid fill, border or clip, so it prints as vector in PDF/X (no gradients). New
+  tokens `--dc-entry-radius`, `-ornament`, `-orn-inset`, `-orn-bg`, `-orn-border`,
+  `-orn-clip`, `-orn-z`, `-frame` and `-badge-bg`, `-badge-fg`, `-badge-shape`,
+  `-badge-radius`. Chips and tags never hyphenate. Field labels share one chip: effects are a solid teal frame
+  with a +, side effects a dashed blood frame with a – (`--dc-field-edge-width`,
+  `-edge-style`).
+- **Catalog entries are kept whole.** An entry never splits across a column or a
+  page (the catalog itself still splits between entries), and its title bar is a
+  ledger band with an INVENTORY chip instead of an accent bar.
+- **Procedure is off the wall.** `@procedure` is an instruction plate: a cream
+  sheet with an ink frame and a hard shadow, a solid HUD-blue number strip, step
+  text in ink and dashed dividers (`--dc-steps-accent`, `--dc-steps-surface`).
+- **At-a-glance has a hierarchy.** The tile is a reversed label band over a large
+  value, with an ink frame and a hard shadow (`--dc-at-a-glance-accent`, `-value`).
+  The outcome ladder's chip column is `max(130px, 26%)` (`--dc-outcome-key-col`)
+  so long band names wrap cleanly.
+- **Definition is a dictionary page,** not a tinted note: cream, a heavy rule over
+  it, the term set first as a blue headword; the shape is `none` by default.
+- **The lede is the opening statement.** Upright semibold ink type at 13pt on a
+  light panel (lighter than the wall) with a heavy accent rail and an ink foot rule
+  (`--dc-intro-color`, `-size`, `-weight`, `-style`, `-rail`, `-rule`). Flavor is a
+  rail and no box, in ink-dark. Contents and credits ledes keep body size.
+- **NPC flavor lines** are a ruled line, not a box.
+- **Chrome.** `.dc-tag` is an inline chip with a hard edge and an ink hairline
+  (`--dc-tag-bg`, `-fg`, `-border`); `.dc-tape` is masking tape with torn ends and
+  ink edges (`--dc-tape-shape`); `.dc-spray` is a stencil tag with a stepped edge
+  and a dashed stencil line (`--dc-spray-stencil`) against the chevron's deep
+  banner; the spec tweak fits one line; the NPC sidebar is a contact card with a
+  blue ID band and a dashed strip foot.
+- **Specialties are told apart.** The title bands (path banner and specialty-intro
+  title) are each specialty's own signal colour with its own register: an LED rim
+  and a rule of LED dots on the tech specialties, a facet plane on the magic ones, a
+  hazard-tape rule on Streetwarden, a torn bottom edge on Proxy and Gutterdruid, all
+  drawn as solid fills, dotted/dashed borders and clip-paths (no gradient, so they
+  survive PDF/X). New tokens `--dc-band-rule`, `-rule-h`, `-tick`, `-tick-style`,
+  `-tick-w`, `-rule-skew`, `-rule-bleed`, `-facet`, `-facet-width`,
+  `-facet-clip` and `-rim`, and `--dc-path-code-*`, `--dc-path-chip-*`,
+  `--dc-path-note-rail`. A path with no subtitle is the band alone.
+- **The tier pill is the specialty's own.** `--dc-tier-bg`, `-fg` and `-edge`,
+  set per specialty, replace the bronze, gold and silver by position (the
+  `--tier-*` tokens are gone).
+- **AP chips differ in grayscale.** Free is an unlit LED, a grey lens with a hollow
+  lamp and an ink edge (it was the same blood red as increased), reduced is pale
+  blue with a drawn down triangle, increased blood with a drawn up triangle (CSS
+  shapes, not font glyphs), VAR deep magenta (cream on the bright one was 4.06:1),
+  special amber with cream type.
+- **Technosorcerer and Generalist leave violet.** Violet is the world's colour
+  (lore, vibe, cabal, treasure), so the Technosorcerer is now electric indigo
+  (`--signal-indigo`) and the Generalist cool slate (`--crystal-slate`), with new
+  mid and dark tones. Proxy's band is a shade lighter so ink on it holds 4.5:1.
+- **New neutrals.** `--paper-form` (the `choose` sheet) and `--paper-zine` (the
+  fiction excerpt and shard sheets).
+
+### Fixed
+
+- The learning-path title band lines up with the path frame's top-right cut
+  for every specialty: it spans the frame and is cut from the same point list,
+  where it stopped 12px short.
+- The design guide's heading specimens sit on paper, not on brick.
+- Footer chips no longer touch content: body pages have a 1in bottom margin
+  and the folio and chapter chips sit 0.125in below the text. The chapter
+  chip takes the chapter's colour (named pages `dc-chip-<hue>`) and lost a
+  stray notch.
+- The `dm` section's folder tab stays with its box when the section splits
+  across a page; it had left cyan type on grey paper.
+- The page-level wall-text rules skip components (`[class*="dc-"]`), so a
+  `@procedure`, `@lede` or `@toc` placed straight on a page keeps its look.
+- Reversed type is semibold: slate and Surreal bodies, skill-tab names. Cream
+  on the default magenta bar is 4.7:1 (`--dc-section-bar-mix` 90%); outcome
+  band names are at least 4.5:1.
+- Flaw, Ideal and Dream cards differ in grayscale (edge style, fill value,
+  silhouette depth); `reference`, `lore`, `panel` and `dm` title bars differ
+  in treatment, not only colour.
+- A wrapped learning-path sticker chain never ends a line on its arrow.
+- Heading slips keep with what follows, prose sheets take orphans and widows
+  of 3, and `###`/`####` slips hang offset (`--dc-page-slip-gap`,
+  `-slip-offset`, `--dc-heading-gap`).
+- `--dc-accent-ink` is documented and tested as a per-component context
+  token, the one exception to the token convention.
+- Tests guard the 10pt floor, the context-token allow-list, page-level
+  components and the Lucid/Surreal variants.
+
+- **Contrast and type.** The special AP chip (ink on amber, 3.5:1), the tier pills
+  (accent fails 4.5:1 for 9px type on Augmerc and Proxy), the learning-path
+  subtitle (ink-smoke on `--paper-stain`, 3.4:1), the Augmerc title band (cream on
+  bright magenta, 3.6:1) now pass 4.5:1, and the NPC flavor line is a ruled line on the paper instead of italic on a grey box. The DM alert
+  body is upright instead of 9pt italic.
+- **A chapter no longer repaints the alerts.** The Dream Mastery chapter's override
+  turned every alert grey-brown and rust in Part 2; the alert identity now survives
+  re-theming. Its DM panel heading was ink on ink (an empty-looking bar) and is
+  readable.
+- **Names stay on one line where they can.** An NPC name in a two-column run,
+  a catalog entry name and TECHNOSORCERER on its specialty card no longer wrap
+  mid-name or orphan a letter.
+- **Empty strips are gone.** A learning path with no subtitle or stickers is the
+  band alone, not a band over an empty well.
+- **The design guide's choice-card snippets work.** They wrote `### Name`, which
+  core does not turn into the card heading (only the first `####` is); they now
+  write `####`. The Part 2 Fodder description sat between the quote and the stat
+  lines and was set as a stat line; it is now inside the quote.
+- **README example.** The author-override example set `--dc-alert-accent`, a token
+  that does not exist; it now sets `--dc-section-accent` on `.dc-section-panel`.
+
+### Removed
+
+- **The highlight skill-card variant** (`#### Name | Tier | highlight`, `@skill {.dc-highlight}`) is gone, and the guide no longer describes a capstone skill: the game has none. A third `|` part in a skill heading is ignored.
+
 ## [1.6.3] - 2026-10-12
 
 Content and markers by default, overrides when wanted: the defaults now do more,

package/README.md

@@ -76,8 +76,11 @@ package renders and prints; `docs/macros.md` is the full inventory and
 
 The named components are also words on `@section` (`@npc-stat` is
 `@section npc`, `@fiction-excerpt` is `@section fiction`); either spelling
-renders the same. `reference`, `lore`, `dm` and `choose` are words only: panels
-that say what kind of text they hold. Write the content and the marker that says
+renders the same. `reference`, `lore`, `dm` and `choose` are words only: boxes
+that say what kind of text they hold, each by its own bar, sheet and silhouette
+(`choose` is a form, not a panel). Every variant, in every family, is told apart
+in colour and in grayscale, so a chapter re-tunes a panel's accent but never
+repaints an alert, a faction or a choice card. Write the content and the marker that says
 what it is: the defaults set how it looks and where it breaks (sections split
 across pages, a catalog too, and a creature and a callout stay whole). A page
 or chapter word draws no box of its own: it re-tunes the sections inside it. To
@@ -209,7 +212,7 @@ the package on every update. Reset the component's public tokens on a context
 selector instead:
 
 ```css
-.chapter-05 .dc-alert { --dc-alert-accent: var(--hud-blue); }
+.chapter-05 .dc-section-panel { --dc-section-accent: var(--hud-blue); }
 ```
 
 The tokens each component exposes are listed under `tokens:` in