gp-dimm-city 1.5.0 → 1.6.0

package/CHANGELOG.md

@@ -7,6 +7,107 @@ cut a version that has no `## [X.Y.Z]` heading below.
 
 ## [Unreleased]
 
+## [1.6.0] - 2026-10-12
+
+### Added
+
+- **The d20 ladder is recognised by its bands.** A two-column pipe table whose
+  first column holds exactly the five standard bands (`20`, `11-19`, `6-10`,
+  `2-5`, `1`, in either order) is drawn as the coloured outcome ladder, in a
+  skill card or anywhere else, whatever its headers say (`Roll | Result`,
+  `Result | Effect`, empty). A band is read however it is typed (`11-19`,
+  `11 – 19`, `**20**`) and shown as `11–19`. Any other set of bands (six bands,
+  a split at 10) stays a plain table. Before, only a `Roll | Outcome` header
+  triggered it, and only inside a skill card.
+- **`@roll-table`**, a neutral random-table component for tables with equal
+  bands (`1-4`, `5-8`, …): a caption with a die chip (`die=d20`, any `dN`) and
+  a `label`, a mono range column, equal-weight rows and no tier colours. The
+  table inside stays a plain pipe table and is never read as a ladder.
+- **Four kinds of text, as words on `@section`:** `reference` (a look-up:
+  HUD blue, a pale title band, tight rows), `lore` (the world: brass on aged
+  paper, a long shard corner, italic sub-heads), `dm` (behind the screen: an ink
+  bar with a Dream Master chip on a cold body) and `choose` (a choice the
+  player writes on the Citizen File: a lighter form sheet, dotted write-in
+  rules, tick boxes, a "Your choice" chip, in the chapter's accent). Each is a
+  panel plus one class that sets the panel's tokens, with no marker of its own.
+  New tokens `--dc-section-tab`, `--dc-section-tab-bg` and `--dc-section-tab-fg`
+  draw the chip. `@flaws`, `@ideals` and `@dreams` are now `choose` sections
+  with their own class.
+- **`@callout example`**, the one spelling for a worked example: a dashed cyan
+  edge, a taped-on label, upright text. It replaces `@block shard label="Example"`
+  and `**Example:**` paragraphs.
+- **`@faction megacorp | cabal | cult | enforcer`**, an organization's profile:
+  a card whose rail and kind badge take the kind's colour (`--dc-faction-accent`,
+  `--dc-faction-badge-fg`). `label="…"` names a badge of your own.
+- **`@npc-stat compact`** for a small creature, a companion or a drone: no
+  panel, a framed box, the two stat lines as chips side by side.
+- **The stat strip.** A table with an `HP` column and a `Damage` column is set
+  as a strip of labels and big numbers (a cell holding only a number is set large) wherever it sits, with no marker
+  (`--dc-stat-strip-accent`, `--dc-stat-strip-value`). A creature inside a
+  skill's ability text needs this: a section marker there would end the skill.
+- **A chapter-start page with no fiction excerpt still opens like a chapter.**
+  The `# Title` is a band in the chapter's accent and the paragraph under it is
+  the lede (an `@lede` keeps its own look). A page with a fiction excerpt is
+  unchanged.
+- **`@definition` reads as a glossary** when it holds a run of `#### Term`
+  entries: a small mono-caps term, a dashed rule between entries, and the block
+  may split between them. A `---` inside is the same dashed rule.
+- `| highlight` on a skill heading is documented as the capstone look (the
+  card that pays off a path); it is not a new word.
+
+- **Entry cards: `@augment`, `@treasure`, `@vehicle`, `@drug`.** Cybernetics and
+  mods, magic items and relics, vehicles, and drugs and consumables each get
+  their own marker, snippet and catalog entry. They share one card style family
+  (`.dc-entry`) and each kind is a token setter on it (rail colour, name colour,
+  surface, and a small kind word over the name), so the CSS stays small. Existing
+  entry markdown (`#### Name`, a blockquote tagline, a `**SPECS:**` paragraph,
+  prose) works unchanged inside them. An entry with no name, or with two names
+  run together, is reported as a problem.
+- **`@field`, and bold labels that mean it.** A labelled field with variants
+  `specs`, `traits`, `equipment`, `effects`, `side-effects` and `requires`; the
+  default label is the variant's name and `label="…"` replaces it. Inside an
+  entry card, an `@npc-stat` and a `@skill`, a paragraph that opens with a label
+  the books already write (`**SPECS:**`, `**Traits:**`, `**Equipment:**`,
+  `**Effects:**`, `**Side Effects:**`, `**Requires:**`, `**Wirephreak Gear:**`,
+  `**Cybersurgeon Instrument(s):**`, `**TECHNOENHANCEMENT:**`) becomes the same
+  field, so books need no content change. The labels are one table in
+  `plugin.js`.
+- **`@section catalog`.** A panel for a run of entries that rules them instead of
+  boxing them: each entry takes a rule in its own accent colour over it, so the
+  hand-typed `---` between entries is not needed (one left in draws nothing).
+  Write `@columns 2` under the intro as before.
+- New tokens `--dc-entry-accent`, `--dc-entry-ink`, `--dc-entry-surface`,
+  `--dc-entry-rail`, `--dc-entry-rule`, `--dc-entry-kind` and
+  `--dc-field-accent`, `--dc-field-surface`, `--dc-field-fg`,
+  `--dc-field-label-fg`.
+
+### Changed
+
+- **Skill cards split across pages by default.** A whole card is a third to half
+  a page, so keeping each one atomic left most specialty pages holding one card
+  and a third of the sheet empty. A card now splits at sensible places: it never
+  opens with only its tab, an ability row is never cut, a lead-in stays with what
+  it introduces, and the last block stays with the one above. `.dc-avoid-split`
+  (written on the `@skill` line, as on a section) keeps one whole.
+  `.dc-allow-split` is retired: it is the default.
+- A table of five bands now shows its roll as `11–19` (an en dash) however the
+  author typed it, and its tier and name come from the band.
+- `@gear` is now an entry card (`dc-card dc-entry dc-gear`) and takes a `####`
+  name as well as `###`; its rules moved from `section.css` to the new
+  `styles/components/entries.css`. `@callout gear label="SPECS"` still works.
+
+### Removed
+
+- `@glossary` and `.dc-terms`: write `@definition` (a run of `#### Term` entries,
+  or `**Term** — gloss` paragraphs).
+- `@sidebar-box` and the `--dc-sidebar-box-*` tokens: write `@definition` (a
+  `####` heading, `---` and body make the same box).
+- `@section aside`: write `@callout`.
+- `@sidebar` and `--dc-sidebar-surface` / `--dc-sidebar-border`: write
+  `@callout note .dc-sidebar`. `.dc-sidebar` remains as a float placement only.
+- `@block codex` (`.dc-codex`): write `@section reference` for a look-up panel, or `@block panel` for a small box inside a section (a section cannot nest).
+- `.dc-allow-split` on `@skill` (see above).
+
 ## [1.5.0] - 2026-10-12
 
 Needs **Gutterpress 0.11.17 or later**: that core resolves the variant

package/README.md

@@ -48,16 +48,28 @@ package renders and prints; `docs/macros.md` is the full inventory and
 | Rules or reference text under a heading | `@section panel` |
 | The same, kept on one page | `@section panel .dc-avoid-split` |
 | Unboxed text that carries the accent rail | `@section flat` |
-| A short note set off from the text | `@section aside` (or `@sidebar-box`) |
-| A term and its definition | `@definition` |
+| A table or list to look up (prices, conditions, a menu of options) | `@section reference` |
+| World or setting text | `@section lore` |
+| Advice for the Dream Master, behind the screen | `@section dm` (a short one: `@callout dm`) |
+| A choice the player writes on the Citizen File | `@section choose` |
+| A term and its definition, or a glossary of terms | `@definition` |
 | A boxed note, warning, DM note, vibe, origin or visit | `@callout …` (`@dm-note`) |
-| A box in one of four registers: panel, slate, shard, codex | `@block …` |
-| A box floated beside the text | `@sidebar` |
-| Fiction, lore, a chapter-opener story | `@fiction-excerpt` |
-| A creature or NPC | `@npc-stat` |
-| Gear, a vehicle, a drug, an augment | `@gear` (and `@callout gear label="SPECS"` for the specs) |
-| A roll-result ladder | `@outcome` |
-| Flaw, ideal or dream choices | `@flaws`, `@ideals`, `@dreams` (each a run of `@card`) |
+| A worked example | `@callout example` |
+| A box in one of three registers: panel, slate, shard | `@block …` |
+| A callout floated beside the text | `@callout note .dc-sidebar` |
+| Fiction, a chapter-opener story | `@fiction-excerpt` |
+| A creature or NPC | `@npc-stat` (small ones: `@npc-stat compact`) |
+| An organization: megacorp, cabal, cult, enforcers | `@faction megacorp`, `cabal`, `cult`, `enforcer` |
+| General gear | `@gear` |
+| A cybernetic or mod | `@augment` |
+| A magic item or relic | `@treasure` |
+| A vehicle | `@vehicle` |
+| A drug, elixir or consumable | `@drug` |
+| A labelled line in an entry: SPECS, Traits, Effects… | `**SPECS:**` (or `@field specs`) |
+| A titled run of entries, two columns | `@section catalog` with `@columns 2` |
+| A roll-result ladder | a pipe table of the five bands (20, 11-19, 6-10, 2-5, 1), or `@outcome` |
+| A random table with equal bands (1-4, 5-8, …) | `@roll-table` |
+| Flaw, ideal or dream choices | `@flaws`, `@ideals`, `@dreams` (each a `choose` section holding a run of `@card`) |
 | The Citizen File field list | `@citizen-walkthrough` |
 | The specialty catalog | `@card-grid` |
 | A specialty, its learning paths and skill cards | `@specialty`, `@learning-path`, `@skill` |
@@ -67,14 +79,15 @@ 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. Sections split across pages by default. A page or chapter
+renders the same. `reference`, `lore`, `dm` and `choose` are words only: panels
+that say what kind of text they hold. Sections split across pages by default. A page or chapter
 word draws no box of its own: it re-tunes the sections inside it.
 
 Also in the box:
 
 - **More macros**, from `plugin.js`: `@specialty-intro` / `@specialty-art` /
   `@specialty-card`, `@continue` (a skill card that spans a page break),
-  `@card`, `@procedure`, `@lede`, `@toc`, `@glossary`, GFM alerts
+  `@card`, `@procedure`, `@lede`, `@toc`, GFM alerts
   (`> [!NOTE]`, `[!WARNING]`, `[!DM]`, `[!VIBE]`, `[!ORIGIN]`, `[!VISIT]`,
   `[!GEAR]`, `[!FLAVOR]`, `[!PULLQUOTE]`), and the automatic `ROLL THE DIE!`
   chip. `docs/components-and-palette-reference.md` maps each to the classes it