gp-dimm-city 1.6.1 → 1.6.2-alpha.2

package/CHANGELOG.md

@@ -7,6 +7,78 @@ cut a version that has no `## [X.Y.Z]` heading below.
 
 ## [Unreleased]
 
+## [1.6.2] - 2026-10-12
+
+### Changed
+
+- **`@gear` is the one item marker; the kinds are words on it.** `@gear augment`,
+  `@gear treasure`, `@gear vehicle` and `@gear drug` give the cybernetic, magic
+  item, vehicle and drug cards, each with the look and the small kind word it
+  had. A bare `@gear` is general gear. The entries still share one card
+  family and one check (an entry with no name, or with two, is reported), and a
+  word that is not a kind is reported and read as general gear. A run still
+  needs an `@end-gear` only after its last entry, and `@section catalog` takes
+  `@gear <kind>` entries as it took the old markers. Entry cards now carry
+  `data-gear="<kind>"`.
+- **`@field specs` is the one SPECS box.** A `**SPECS:**` paragraph inside an
+  entry, an `@npc-stat` or a skill was already that field; it is now the only
+  way to get the box, since `@callout gear` drew the same one.
+- **The card footer is tagged by the plugin alone.** The `blockquote:last-of-type`
+  fallback beside `.dc-card-footer` is gone from `section.css`; the plugin
+  always tags the footer.
+- **A specialty's last learning path clips its card shadows.** The poster
+  shadow hangs 6px below a skill card; when the last card of a specialty ended
+  in the last 6px of a page, that overhang alone opened an empty page before
+  the next chapter. `.dc-specialty > .dc-learning-path:last-child` now clips
+  its block overflow (`overflow-y: clip; overflow-clip-margin: 8px`), so a book
+  no longer needs its own rule for it.
+- **A field may split between lines, as the callout it replaced did.** `.dc-field`
+  no longer has `break-inside: avoid` and sets `orphans: 2; widows: 2`, so the
+  label chip stays with the first two lines of its text and no single line is
+  left alone at either end. A short field still stays whole. The 30 SPECS boxes
+  that were pushed whole to the next page no longer cost a book pages.
+- **Skill card text never leaves one line alone at a page edge.** Paragraphs,
+  list items and ability text inside `.dc-skill-card` set `orphans: 3; widows: 2`.
+  Chromium keeps the orphans and drops the widows when a paragraph is too short
+  to satisfy both, so the body's 2 + 2 let a three-line paragraph split 2 + 1;
+  with 3 it moves whole. Cards still split by default.
+- **The last panel of a page or chapter clips its shadow overhang.**
+  `.dc-section-panel:last-child` clips its block overflow
+  (`overflow-y: clip; overflow-clip-margin: calc(var(--dc-section-edge) + 3px)`),
+  the same fix as a specialty's last learning path. A panel that ends in the
+  last pixels of a page, such as a `@section reference .dc-snug` pulled back
+  to fit, no longer opens a page holding only its bottom rule.
+- Comments in the plugin, stylesheets, catalog, snippets and docs that described
+  removed code, files or behaviour are gone or rewritten. No declaration or
+  behaviour changed with them.
+
+### Removed
+
+- The `data-break-inside="avoid"` attribute on skill cards, outcome ladders and
+  card sub-lists. Nothing read it since the pagination polyfill was removed;
+  break control is the CSS `break-inside` rules.
+- `@augment`, `@treasure`, `@vehicle`, `@drug` (and their `@end-` forms):
+  write `@gear <kind>`. They are tombstoned in `components.yaml`.
+- `@callout gear` and `> [!GEAR]`, with `.dc-gear-callout`: write `@field specs`.
+  `components.yaml` has a tombstone for each.
+
+### Moving from 1.6.1
+
+| Before | Now |
+|---|---|
+| `@augment` … `@end-augment` | `@gear augment` … `@end-gear` |
+| `@treasure` … `@end-treasure` | `@gear treasure` … `@end-gear` |
+| `@vehicle` … `@end-vehicle` | `@gear vehicle` … `@end-gear` |
+| `@drug` … `@end-drug` | `@gear drug` … `@end-gear` |
+| `@callout gear label="SPECS"` … `@end-callout` | `@field specs` … `@end-field` |
+| `> [!GEAR]` | `@field specs` |
+
+Any other `@callout gear label="…"` becomes `@field specs label="…"` for a
+one-paragraph box, or `@callout note` (or `warning`) for a longer note. The old
+spellings are not recognised any more: a marker line prints as text, and
+`@callout gear` reports an unknown variant. A book that sets its own rule on
+`.dc-gear-callout` should move it to `.dc-field-specs`.
+
 ## [1.6.1] - 2026-10-12
 
 ### Changed

package/README.md

@@ -61,11 +61,11 @@ package renders and prints; `docs/macros.md` is the full inventory and
 | 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 cybernetic or mod | `@gear augment` |
+| A magic item or relic | `@gear treasure` |
+| A vehicle | `@gear vehicle` |
+| A drug, elixir or consumable | `@gear drug` |
+| A labelled line in an entry: SPECS, Traits, Effects… | `**SPECS:**` (or `@field specs`; `specs` is the one SPECS box) |
 | 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` |
@@ -89,12 +89,12 @@ Also in the box:
   `@specialty-card`, `@continue` (a skill card that spans a page break),
   `@card`, `@procedure`, `@lede`, `@toc`, GFM alerts
   (`> [!NOTE]`, `[!WARNING]`, `[!DM]`, `[!VIBE]`, `[!ORIGIN]`, `[!VISIT]`,
-  `[!GEAR]`, `[!FLAVOR]`, `[!PULLQUOTE]`), and the automatic `ROLL THE DIE!`
+  `[!FLAVOR]`, `[!PULLQUOTE]`), and the automatic `ROLL THE DIE!`
   chip. `docs/components-and-palette-reference.md` maps each to the classes it
   emits.
-- **Sixteen stylesheets** under `styles/`, listed in `package.json` in
+- **Seventeen stylesheets** under `styles/`, listed in `package.json` in
   cascade order: fonts and the layer statement, the palette and identity
-  tokens, the element baseline, eight component sheets, page templates,
+  tokens, the element baseline, nine component sheets, page templates,
   paged-media rules, and `dc-native.css` — the engine-specific page chrome
   (brick-wall background, folios, chapter chips) that must stay last.
 - **Fonts**: Titillium Web, Tomorrow and Lixdu, embedded into the PDF at
@@ -174,6 +174,25 @@ of every page). Public API for semver purposes: the macro vocabulary, the
 classes and tokens marked `live` in `components.yaml`, the page templates, and
 the layer names. `CHANGELOG.md` lists what each release changes.
 
+### Moving from 1.6.1 or earlier
+
+1.6.2 folds the item markers into `@gear` and gives the SPECS box one spelling.
+The old spellings are no longer recognised (a marker line prints as text, and
+`@callout gear` reports an unknown variant), so rebuild after you migrate:
+
+| Before | Now |
+|---|---|
+| `@augment` … `@end-augment` | `@gear augment` … `@end-gear` |
+| `@treasure` … `@end-treasure` | `@gear treasure` … `@end-gear` |
+| `@vehicle` … `@end-vehicle` | `@gear vehicle` … `@end-gear` |
+| `@drug` … `@end-drug` | `@gear drug` … `@end-gear` |
+| `@callout gear label="SPECS"` … `@end-callout` | `@field specs` … `@end-field` |
+| `> [!GEAR]` | `@field specs` |
+
+Any other `@callout gear label="…"` becomes `@field specs label="…"` for a
+one-paragraph box, or `@callout note` for a longer note. A `**SPECS:**`
+paragraph inside an entry needs no change.
+
 ## Licences
 
 Code, stylesheets, catalog and docs: [MIT](LICENSE). Fonts carry their own

package/components.yaml

@@ -41,7 +41,7 @@
 #   or `.dc-*` class an entry. test/integrity.test.js ("component catalog")
 #   fails when:
 #     - a marker in plugin.js `markers`, or a variant word on `section`,
-#       `page` or `chapter`, has no entry listing it under `markers`;
+#       `page`, `chapter` or `gear`, has no entry listing it under `markers`;
 #     - an entry's `snippet` file does not exist, a snippet file belongs to no
 #       entry, or a declared marker or word has an entry with no snippet;
 #     - a live entry lists a `markers` spelling plugin.js does not declare, or
@@ -60,7 +60,7 @@ components:
     status: live
     origin: plugin
     snippet: alert
-    recipe: "> [!NOTE] | > [!WARNING] | > [!DM] | > [!VIBE] | > [!ORIGIN] | > [!VISIT] | > [!GEAR]  (GFM-style blockquote; the label is added automatically)"
+    recipe: "> [!NOTE] | > [!WARNING] | > [!DM] | > [!VIBE] | > [!ORIGIN] | > [!VISIT]  (GFM-style blockquote; the label is added automatically)"
     emits:
       - div.dc-alert.dc-note > span.dc-alert-label
       - div.dc-alert.dc-note.warning > span.dc-alert-label
@@ -68,7 +68,6 @@ components:
       - div.dc-alert.dc-vibe-callout > span.dc-alert-label
       - div.dc-alert.dc-origin-callout > span.dc-alert-label
       - div.dc-alert.dc-visit-callout > span.dc-alert-label
-      - div.dc-alert.dc-gear-callout > span.dc-alert-label
     css: [styles/components/callouts.css, styles/dc-native.css]
     tokens:
       - --dc-alert-bg
@@ -90,7 +89,7 @@ components:
     origin: plugin
     markers: ["@callout"]
     snippet: [callout, callout-example]
-    recipe: "@callout [note|warning|dm|vibe|origin|visit|gear|example] label=\"…\" … @end-callout"
+    recipe: "@callout [note|warning|dm|vibe|origin|visit|example] label=\"…\" … @end-callout"
     emits:
       - div.dc-alert.dc-note > span.dc-alert-label
       - div.dc-alert.dc-note.warning
@@ -98,7 +97,6 @@ components:
       - div.dc-alert.dc-vibe-callout
       - div.dc-alert.dc-origin-callout
       - div.dc-alert.dc-visit-callout
-      - div.dc-alert.dc-gear-callout
       - div.dc-alert.dc-example-callout
     css: styles/components/callouts.css
     breaks: "as alert"
@@ -211,37 +209,37 @@ components:
     css: styles/components/section.css
     notes: "Citizen-file choices: each is a `choose` section (see section-choose) of @card blocks whose own class colors every card's left rule (`.section.dc-flaws > .dc-card`)."
 
-  # ── Entry cards: one rule set (.dc-entry), each marker a token setter ───
+  # ── Entry cards: one rule set (.dc-entry), each kind a token setter ─────
   - name: gear
     status: live
     origin: plugin
     markers: ["@gear"]
     snippet: gear
-    recipe: "@gear ### Name … @end-gear"
+    recipe: "@gear [augment|treasure|vehicle|drug] #### Name … @end-gear  (a @gear after a @gear closes the first)"
     emits: div.dc-card.dc-entry.dc-gear
     css: styles/components/entries.css
     tokens: [--dc-entry-accent, --dc-entry-ink, --dc-entry-surface, --dc-entry-rail, --dc-entry-rule, --dc-entry-kind]
     breaks: "break-inside: avoid (via .dc-card)"
-    notes: "General gear. A .dc-card of the entry family with an orange rail; the name (### or ####), the italic tagline paragraph and the bold price paragraph are picked out by shape. A `**SPECS:**` paragraph is a field line; the older `@callout gear label=\"SPECS\"` still works. Not a section, so there is no `@section` word for it. A run of entries goes in a `@section catalog`; each kind is told apart by its rail colour and the small kind word over its name."
+    notes: "The item entry, and the one marker for every kind of item: bare `@gear` is general gear, and a bare word picks a kind (`augment`, `treasure`, `vehicle`, `drug`, the four entries below). A .dc-card of the entry family with an orange rail; the name (### or ####), the italic tagline paragraph and the bold price paragraph are picked out by shape. A `**SPECS:**` paragraph is a `@field specs`. Reports an entry with no name or with a second one, and a word that is not a kind (read as general gear). Not a section, so there is no `@section` word for it. A run of entries goes in a `@section catalog`; each kind is told apart by its rail colour and the small kind word over its name."
 
   - name: augment
     status: live
     origin: plugin
-    markers: ["@augment"]
+    markers: ["@gear augment"]
     snippet: augment
-    recipe: "@augment #### Name … @end-augment  (an @augment after an @augment closes the first)"
+    recipe: "@gear augment #### Name … @end-gear"
     emits: div.dc-card.dc-entry.dc-augment
     css: styles/components/entries.css
     tokens: [--dc-entry-accent, --dc-entry-ink, --dc-entry-surface, --dc-entry-rail, --dc-entry-rule, --dc-entry-kind]
     breaks: "break-inside: avoid (via .dc-card)"
-    notes: "A cybernetic or mod: cyan rail, cream surface. Same entry rules as @gear. Reports an entry with no name or with a second one."
+    notes: "A cybernetic or mod: cyan rail, cream surface. Same entry rules as @gear."
 
   - name: treasure
     status: live
     origin: plugin
-    markers: ["@treasure"]
+    markers: ["@gear treasure"]
     snippet: treasure
-    recipe: "@treasure #### Name … @end-treasure"
+    recipe: "@gear treasure #### Name … @end-gear"
     emits: div.dc-card.dc-entry.dc-treasure
     css: styles/components/entries.css
     tokens: [--dc-entry-accent, --dc-entry-ink, --dc-entry-surface, --dc-entry-rail, --dc-entry-rule, --dc-entry-kind]
@@ -251,9 +249,9 @@ components:
   - name: vehicle
     status: live
     origin: plugin
-    markers: ["@vehicle"]
+    markers: ["@gear vehicle"]
     snippet: vehicle
-    recipe: "@vehicle #### Name … @end-vehicle"
+    recipe: "@gear vehicle #### Name … @end-gear"
     emits: div.dc-card.dc-entry.dc-vehicle
     css: styles/components/entries.css
     tokens: [--dc-entry-accent, --dc-entry-ink, --dc-entry-surface, --dc-entry-rail, --dc-entry-rule, --dc-entry-kind]
@@ -263,9 +261,9 @@ components:
   - name: drug
     status: live
     origin: plugin
-    markers: ["@drug"]
+    markers: ["@gear drug"]
     snippet: drug
-    recipe: "@drug #### Name … @end-drug"
+    recipe: "@gear drug #### Name … @end-gear"
     emits: div.dc-card.dc-entry.dc-drug
     css: styles/components/entries.css
     tokens: [--dc-entry-accent, --dc-entry-ink, --dc-entry-surface, --dc-entry-rail, --dc-entry-rule, --dc-entry-kind]
@@ -298,7 +296,7 @@ components:
       - "**Wirephreak Gear:**"
       - "**Cybersurgeon Instrument(s):**"
       - "**TECHNOENHANCEMENT:**"
-    notes: "A labelled field: a rail, a surface and a label chip, then the text beside it. The variant is a bare word and its default label is the variant's name; `label=\"…\"` replaces it, as with @callout. Inside an entry card (@gear, @augment, @treasure, @vehicle, @drug), @npc-stat (or @section npc) and @skill, a paragraph that opens with one of these bold labels (colon inside the bold, any case) is rewritten to exactly the markup the marker writes, keeping the author's own words as the label, so books need no change. The labels are the FIELD_LABELS table in plugin.js: SPECS, Traits, Equipment, Effects, Side Effects, Requires, and the profession labels Wirephreak Gear, Cybersurgeon Instrument / Instruments / Instrument(s) and TECHNOENHANCEMENT (all means requires). Elsewhere the paragraph stays a paragraph. A new label is one line in that table; a new field type is a variant name there plus one token-setting rule in entries.css."
+    notes: "A labelled field: a rail, a surface and a label chip, then the text beside it. The variant is a bare word and its default label is the variant's name; `label=\"…\"` replaces it, as with @callout. Inside an entry card (@gear, of any kind), @npc-stat (or @section npc) and @skill, a paragraph that opens with one of these bold labels (colon inside the bold, any case) is rewritten to exactly the markup the marker writes, keeping the author's own words as the label, so books need no change. `specs` is the one SPECS box (dark, with a yellow rail); the retired `@callout gear` and `[!GEAR]` made the same box. The labels are the FIELD_LABELS table in plugin.js: SPECS, Traits, Equipment, Effects, Side Effects, Requires, and the profession labels Wirephreak Gear, Cybersurgeon Instrument / Instruments / Instrument(s) and TECHNOENHANCEMENT (all means requires). Elsewhere the paragraph stays a paragraph. A new label is one line in that table; a new field type is a variant name there plus one token-setting rule in entries.css."
 
   - name: lede
     status: live
@@ -833,12 +831,12 @@ components:
     origin: plugin
     markers: ["@section catalog"]
     snippet: section-catalog
-    recipe: "@section catalog ## Title … @columns 2 @augment … @end-columns @end-section"
+    recipe: "@section catalog ## Title … @columns 2 @gear augment … @end-columns @end-section"
     emits: div.section.dc-section-panel.dc-catalog
     css: styles/components/entries.css
     tokens: [--dc-entry-surface, --dc-entry-rail, --dc-entry-rule]
     breaks: "a panel; its entries may split across a column or page (ruled, not boxed, so there is no frame to cut), the name keeps with what follows it"
-    notes: "A panel for a run of entries (@augment, @treasure, @vehicle, @drug, @gear). Its entries are ruled instead of boxed (and may split across columns, as the plain text they replace did): no card, no rail, a rule in the entry's own accent over each, so no `---` is needed between entries (a `---` left in draws nothing). Columns are core's: write `@columns 2` under the intro."
+    notes: "A panel for a run of entries (@gear, of any kind). Its entries are ruled instead of boxed (and may split across columns, as the plain text they replace did): no card, no rail, a rule in the entry's own accent over each, so no `---` is needed between entries (a `---` left in draws nothing). Columns are core's: write `@columns 2` under the intro."
 
   - name: section-flat
     status: live
@@ -851,7 +849,7 @@ components:
     tokens: [--dc-section-bg, --dc-section-accent, --dc-section-drop, --dc-section-gap, --dc-section-grow, --dc-section-pad-top, --dc-section-pad-right, --dc-section-pad-bottom, --dc-section-pad-left]
     notes: "The rail on a plain host: no corner, no pseudo layers, no title bar. The intro and credits pages set its accent and drop shadow from their own rules (--dc-section-accent, --dc-section-drop). The credits colophon is a flat section."
 
-  # ── Retired: no CSS, no emission, no use (tombstone comments only) ─────
+  # ── Retired: no CSS, no emission, no use (tombstones only) ────────────
   - name: section-reference
     status: live
     origin: plugin
@@ -1171,6 +1169,56 @@ 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: gear-callout
+    status: retired
+    origin: plugin
+    markers: ["@callout gear"]
+    replaced_by: "@field specs"
+    recipe: "@callout gear label=\"SPECS\" … @end-callout"
+    emits: .dc-gear-callout
+    notes: "Retired 1.6.2. It made the same dark SPECS box as @field specs, so @field specs owns it. A `**SPECS:**` paragraph in an entry is that field. Any other `@callout gear label=\"…\"`: a one-paragraph box becomes `@field specs label=\"…\"`, a longer note becomes `@callout note` (or `warning`)."
+
+  - name: alert-gear
+    status: retired
+    origin: plugin
+    markers: ["> [!GEAR]"]
+    replaced_by: "@field specs"
+    recipe: "> [!GEAR]"
+    emits: .dc-gear-callout
+    notes: "Retired 1.6.2 with @callout gear, which it shared a look with; it is no longer recognised and passes through as a plain blockquote."
+
+  - name: augment-marker
+    status: retired
+    origin: plugin
+    markers: ["@augment"]
+    replaced_by: "@gear augment"
+    recipe: "@augment … @end-augment"
+    notes: "Retired 1.6.2: @gear is the one item marker and the kind is a word on it. The marker is no longer recognised and passes through as text."
+
+  - name: treasure-marker
+    status: retired
+    origin: plugin
+    markers: ["@treasure"]
+    replaced_by: "@gear treasure"
+    recipe: "@treasure … @end-treasure"
+    notes: "Retired 1.6.2; see augment-marker."
+
+  - name: vehicle-marker
+    status: retired
+    origin: plugin
+    markers: ["@vehicle"]
+    replaced_by: "@gear vehicle"
+    recipe: "@vehicle … @end-vehicle"
+    notes: "Retired 1.6.2; see augment-marker."
+
+  - name: drug-marker
+    status: retired
+    origin: plugin
+    markers: ["@drug"]
+    replaced_by: "@gear drug"
+    recipe: "@drug … @end-drug"
+    notes: "Retired 1.6.2; see augment-marker."
+
   - name: glossary-item-authored
     status: retired
     origin: author

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gp-dimm-city",
-  "version": "1.6.1",
+  "version": "1.6.2-alpha.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",

package/plugin.js

@@ -15,11 +15,11 @@
  *   @specialty-intro     → div.dc-specialty-intro
  *   @specialty-art       → div.dc-specialty-art (full-bleed art panel)
  *   @specialty-card      → div.dc-specialty-card[data-position=odd|even]
- *   @gear                → div.dc-card.dc-entry.dc-gear
- *   @augment             → div.dc-card.dc-entry.dc-augment   (cybernetics, mods)
- *   @treasure            → div.dc-card.dc-entry.dc-treasure  (magic items, relics)
- *   @vehicle             → div.dc-card.dc-entry.dc-vehicle
- *   @drug                → div.dc-card.dc-entry.dc-drug      (drugs, elixirs, consumables)
+ *   @gear [augment|treasure|vehicle|drug]
+ *                        → div.dc-card.dc-entry.dc-gear (general gear), or
+ *                          div.dc-card.dc-entry.dc-<kind>: augment (cybernetics, mods),
+ *                          treasure (magic items, relics), vehicle, drug (drugs,
+ *                          elixirs, consumables)
  *   @toc                 → div.dc-toc
  *   @lede                → div.dc-intro
  *   @block [panel|slate|shard] label="Title"
@@ -44,7 +44,7 @@
  *                          zero-padded step list (the wrapper renders nothing)
  *   @callout [variant]   → div.dc-alert.<variant class> > span.dc-alert-label.
  *                          Variants (bare word): note, warning, dm, vibe, origin,
- *                          visit, gear, example; none is a note. The label is `label="…"`,
+ *                          visit, example; none is a note. The label is `label="…"`,
  *                          or the variant's name. `@dm-note` is `@callout dm`
  *                          (an alias). `variant=` is gone: validate reports it.
  *   Core's nesting rule is the only one: a declared marker that is already
@@ -68,8 +68,8 @@
  *
  * GFM ALERT SYNTAX:
  *   `> [!NOTE]` / `[!WARNING]` / `[!DM]` / `[!VIBE]` / `[!ORIGIN]` / `[!VISIT]`
- *   / `[!GEAR]` / `[!FLAVOR]` / `[!PULLQUOTE]` blockquotes are transformed
- *   into `<div class="dc-alert dc-<type>">` (moved from print-md core 2026-05-17).
+ *   / `[!FLAVOR]` / `[!PULLQUOTE]` blockquotes are transformed
+ *   into `<div class="dc-alert dc-<type>">`.
  *
  * SPECIALTY VARIANTS:
  *   Skill card and learning-path variants are controlled by the .specialty.<name>
@@ -195,21 +195,9 @@ function specialtyCodeFromClass(className) {
   return 'PATH';
 }
 
-/**
- * Skill card variants are now controlled by the .specialty.<name> parent
- * container (CSS parent-selector model). The variant= attribute on @skill,
- * @continue, and @learning-path has been removed. No SKILL_VARIANTS map.
- */
-
 function buildStickerChain(items) {
   let html = '<div class="dc-stickers">';
   items.forEach((name, i) => {
-    // The first sticker used to get .active treatment, rendering it in
-    // --blood while siblings rendered in --ink-dark. User feedback:
-    // "there's no reason for the first skill in the learning path list
-    // to be marked as active or a different color than the other skills.
-    // For example, under biting distance, punishing counter is red, and
-    // the rest are black. It should also be black." Removed.
     const cls = 'dc-sticker';
     html += '<span class="' + cls + '"><span class="dc-sticker-ref">' + esc(String(i + 1)) + '</span>' + esc(name.trim()) + '</span>';
     if (i < items.length - 1) {
@@ -323,8 +311,8 @@ function renderInlineChildren(inlineTok, md) {
 }
 
 // The blockquote opening at tokens[i], as rendered text (the last paragraph in
-// it, the way every component that turns a quote into a line has always read
-// it), and the index of its close.
+// it, which is how every component that turns a quote into a line reads it),
+// and the index of its close.
 function quoteHtml(tokens, i, md) {
   let html = '';
   let end = i + 1;
@@ -432,16 +420,8 @@ function outcomeRowsHtml(rows, md, head = []) {
 }
 
 // A table of the five standard bands: tier and name come from the band.
-function buildLadderBlock({ head, rows }, md, needsAvoid = true) {
-  // data-break-inside="avoid" is added when the parent card can be split (is
-  // not avoid-split) — the polyfill needs this to keep the
-  // outcomes table together when the card itself isn't protected. When the card
-  // already has data-break-inside="avoid" (non-splittable cards), adding a
-  // nested avoid creates a conflicting inner break that the polyfill resolves
-  // by splitting the card at the outcomes boundary, leaving a headless
-  // card-body on one page and the outcomes-only continuation on the next.
-  const avoidAttr = needsAvoid ? ' data-break-inside="avoid"' : '';
-  return '<div class="dc-outcomes"' + avoidAttr + '>\n' + outcomeRowsHtml(rows, md, head) + '</div>\n';
+function buildLadderBlock({ head, rows }, md) {
+  return '<div class="dc-outcomes">\n' + outcomeRowsHtml(rows, md, head) + '</div>\n';
 }
 
 // Parse ability from list item - handles rendered HTML: "<strong>0 AP</strong> <em>Name:</em> Description"
@@ -606,10 +586,8 @@ function buildProcedureList(items) {
 }
 
 /**
- * GFM-style blockquote alert types — Dimm City branded.
- *
- * Moved from print-md core (src/lib/markdown/alerts.ts) on 2026-05-17 because
- * the classes and labels are DC-specific. Core no longer leaks DC identifiers.
+ * GFM-style blockquote alert types — Dimm City branded: the classes and labels
+ * are DC-specific, so core does not know them.
  */
 const DC_ALERT_TYPES = {
   NOTE:      { classes: "dc-alert dc-note",                 label: "Note" },
@@ -618,7 +596,6 @@ const DC_ALERT_TYPES = {
   VIBE:      { classes: "dc-alert dc-vibe-callout",         label: "Vibe" },
   ORIGIN:    { classes: "dc-alert dc-origin-callout",       label: "Origin" },
   VISIT:     { classes: "dc-alert dc-visit-callout",        label: "Visit" },
-  GEAR:      { classes: "dc-alert dc-gear-callout",         label: "Gear" },
   FLAVOR:    { classes: "dc-flavor" },
   PULLQUOTE: { classes: "dc-pullquote dc-flush" },
 };
@@ -875,12 +852,6 @@ function dcSkillCards(state) {
     const [open, close] = [run[0], run[run.length - 1]];
     open.hidden = close.hidden = true;
     const path = enclosing.findLast((c) => c.meta.kind === 'learning-path');
-    // A card splits across pages by default (a whole card is 30-50% of a page,
-    // so keeping it whole left a page of one card each); `.dc-avoid-split`
-    // keeps one whole and carries data-break-inside="avoid". An outcomes table or
-    // sub-list inside a splittable card needs its own avoid, because the card
-    // has none.
-    const canSplit = !(open.attrGet('class') || '').split(/\s+/).includes('dc-avoid-split');
     const content = run.slice(1, -1);
     const out = [];
     const emit = (html) => out.push(makeToken('html_block', html));
@@ -893,7 +864,6 @@ function dcSkillCards(state) {
     const cardOpen = (cont) => {
       const attrs = open.attrs.map(([k, v]) => [k, k === 'class' && cont ? v.replace('dc-skill-card', 'dc-skill-card dc-skill-card-cont') : v]);
       attrs.push(['name', slugify(title.name)]);
-      if (!canSplit) attrs.push(['data-break-inside', 'avoid']);
       return '<div' + md.renderer.renderAttrs({ attrs }) + '>\n';
     };
     const endCard = () => {
@@ -1015,17 +985,13 @@ function dcSkillCards(state) {
         continue;
       }
 
-      // Keep short sub-lists whole (e.g. an "Arm:" bullet stranded from "Leg:").
-      if (tok.type === 'bullet_list_open' && canSplit) tok.attrSet('data-break-inside', 'avoid');
-
       if (tok.type === 'table_open') {
         // A table of the five standard bands is the ladder; any other table
-        // passes through untouched, thead and all (rebuilding them from tbody
-        // rows once left 64 of 86 tables headerless).
+        // passes through untouched, thead and all.
         const tableTokens = collectTableTokens(content, i);
         const ladder = tok.meta?.rollTable ? null : ladderRows(readTable(tableTokens));
         if (ladder) {
-          emit(buildLadderBlock(ladder, md, canSplit));
+          emit(buildLadderBlock(ladder, md));
           i = skipToTableClose(content, i);
           continue;
         }
@@ -1130,7 +1096,7 @@ function dcLadderTables(state) {
     const tableTokens = collectTableTokens(tokens, i);
     const ladder = ladderRows(readTable(tableTokens));
     if (!ladder) continue;
-    tokens.splice(i, tableTokens.length, makeToken('html_block', buildLadderBlock(ladder, state.md, false)));
+    tokens.splice(i, tableTokens.length, makeToken('html_block', buildLadderBlock(ladder, state.md)));
   }
 }
 
@@ -1184,7 +1150,7 @@ function validateRollTable({ blocks }) {
 /**
  * `@procedure`: every numbered list inside becomes the zero-padded step list
  * (`ol.dc-steps`). The declared wrapper renders nothing itself: the list is
- * the element, as it has always been.
+ * the element.
  */
 function dcProcedures(state) {
   forEachComponent(state.tokens, 'procedure', (run) => {
@@ -1206,11 +1172,11 @@ function dcProcedures(state) {
 
 // ── Declared component: @callout (and its alias @dm-note) ──────────────────
 //
-// `@callout note|warning|dm|vibe|origin|visit|gear|example` is a declared wrapper:
+// `@callout note|warning|dm|vibe|origin|visit|example` is a declared wrapper:
 // core adds `dc-alert`, the variant's class and any author classes. What core
 // cannot know is each variant's default label, so a rule adds it when the
 // author wrote no `label="…"`. A missing or unrecognised variant is a plain
-// note, as it always was.
+// note.
 const CALLOUTS = {
   note: { class: 'dc-note', label: 'Note' },
   warning: { class: 'dc-note warning', label: 'Warning' },
@@ -1218,7 +1184,6 @@ const CALLOUTS = {
   vibe: { class: 'dc-vibe-callout', label: 'Vibe' },
   origin: { class: 'dc-origin-callout', label: 'Origin' },
   visit: { class: 'dc-visit-callout', label: 'Visit' },
-  gear: { class: 'dc-gear-callout', label: 'Gear' },
   example: { class: 'dc-example-callout', label: 'Example' },
 };
 
@@ -1286,13 +1251,23 @@ function validateSkill({ blocks }) {
     }));
 }
 
+const GEAR_KINDS = ['augment', 'treasure', 'vehicle', 'drug'];
+
+// A bare `@gear` (or an unrecognised word, which core reports) is general gear:
+// core added only the shared card, so the general-gear class goes right after it.
+function dcGear(state) {
+  forEachComponent(state.tokens, 'gear', ([open]) => {
+    if (GEAR_KINDS.includes(open.meta.variant)) return;
+    open.attrSet('class', open.attrGet('class').replace('dc-entry', 'dc-entry dc-gear'));
+  });
+}
+
 /**
- * Entry cards (`@gear`, `@augment`, `@treasure`, `@vehicle`, `@drug`): one
- * entry is one name. The name is the entry's first heading (`####`, or `###`
- * as `@gear` has always taken). An entry without one has no title bar, and
- * one with a second heading is usually two entries run together: a declared
- * marker that opens again closes the one before it, so each entry starts with
- * its own marker line.
+ * Entry cards (`@gear` and its kinds `augment`, `treasure`, `vehicle`, `drug`):
+ * one entry is one name. The name is the entry's first heading (`####`, or
+ * `###`). An entry without one has no title bar, and one with a second heading
+ * is usually two entries run together: a declared marker that opens again
+ * closes the one before it, so each entry starts with its own marker line.
  */
 function validateEntry({ name, blocks }) {
   const headings = blocks.filter((b) => b.type === 'heading' && b.level <= 4);
@@ -1342,7 +1317,7 @@ const FIELD_DEFAULT_LABEL = Object.fromEntries(
 const FIELD_BY_LABEL = new Map(Object.entries(FIELD_LABELS).map(([label, v]) => [label.toLowerCase(), v]));
 
 // The cards whose paragraphs may be field lines.
-const FIELD_HOSTS = new Set(['gear', 'augment', 'treasure', 'vehicle', 'drug', 'skill']);
+const FIELD_HOSTS = new Set(['gear', 'skill']);
 
 const fieldLabelHtml = (label) => '<span class="dc-field-label">' + esc(label) + '</span>\n';
 
@@ -1452,9 +1427,7 @@ function validateProcedure({ blocks }) {
 export default function dimmCityPlugin(md, options = {}) {
   registerSkillContinueBridge(md);
 
-  // GFM-style `> [!NOTE]` alerts (moved from core 2026-05-17).
-  // Must run before markdown-it-attrs so attrs don't interfere with `[!TYPE]`
-  // detection inside blockquotes. We register on the core ruler since the
+  // GFM-style `> [!NOTE]` alerts. Registered on the core ruler since the
   // transform operates on already-parsed token streams.
   md.core.ruler.push('dc_alerts', dcAlertsTransform);
 
@@ -1477,6 +1450,7 @@ export default function dimmCityPlugin(md, options = {}) {
   // one inside a skill is already rewritten when the skill's rule looks at it.
   md.core.ruler.push('dc_callouts', dcCallouts);
   md.core.ruler.push('dc_factions', dcFactions);
+  md.core.ruler.push('dc_gear', dcGear);
   md.core.ruler.push('dc_fields', dcFields);
   md.core.ruler.push('dc_cards', dcCards);
   md.core.ruler.push('dc_outcomes', dcOutcomes);
@@ -1530,8 +1504,8 @@ export const markers = {
   'learning-path': wrapper('dc-learning-path dc-path-block'),
   skill: wrapper('dc-skill-card', { validate: validateSkill }),
 
-  // Content components. `@card` closes silently at the end of a document, as it
-  // always has. `@outcome` and `@procedure` carry no `autoCloseAt`, so one left
+  // Content components. `@card` closes silently at the end of a document.
+  // `@outcome` and `@procedure` carry no `autoCloseAt`, so one left
   // open at the end gets core's `declared_marker_eof_close` warning: what
   // follows an open one is read as its rows or its steps. `@procedure` has no
   // class (its rule hides the wrapper: the step list is the element).
@@ -1562,14 +1536,13 @@ export const markers = {
   'specialty-intro': wrapper('dc-specialty-intro'),
   'specialty-art': wrapper('dc-specialty-art'),
   'specialty-card': wrapper('dc-specialty-card'),
-  // Entry cards: one card style family (`.dc-entry`), each marker a token setter
-  // on it (styles/components/entries.css). `@gear` is general gear; the others
-  // are what the books list in catalogs. Each starts with the entry's name.
-  gear: wrapper('dc-card dc-entry dc-gear', { validate: validateEntry }),
-  augment: wrapper('dc-card dc-entry dc-augment', { validate: validateEntry }),
-  treasure: wrapper('dc-card dc-entry dc-treasure', { validate: validateEntry }),
-  vehicle: wrapper('dc-card dc-entry dc-vehicle', { validate: validateEntry }),
-  drug: wrapper('dc-card dc-entry dc-drug', { validate: validateEntry }),
+  // Entry cards: one card family (`.dc-entry`); `@gear` is general gear and its
+  // bare word picks a kind, a token setter on that family
+  // (styles/components/entries.css). Each starts with the entry's name.
+  gear: wrapper('dc-card dc-entry', {
+    variants: Object.fromEntries(GEAR_KINDS.map((kind) => [kind, `dc-${kind}`])),
+    validate: validateEntry,
+  }),
   // An organization's profile: a card with a kind badge. The kind is the bare
   // word (`@faction cult`) and the badge reads it unless `label="…"` names its own.
   faction: wrapper('dc-card dc-faction', {
@@ -1619,9 +1592,7 @@ export const markers = {
   // own. `@page chapter-start` is `<div class="page dc-page-chapter-start">`;
   // `@chapter rules` is `<div class="chapter dc-chapter-rules">` (any other word
   // after `@chapter` stays its label). Core also ships `@page blank` and
-  // `@page full-bleed`. The old raw spellings (`@page .page-chapter-start .dc-chapter-start`,
-  // `.page-toc`, `.page-credits .dc-credits`, `.page-intro`,
-  // `.dc-citizen-file-page`) are no longer styled.
+  // `@page full-bleed`.
   page: {
     variants: {
       'chapter-start': 'dc-page-chapter-start',
@@ -1642,9 +1613,10 @@ export const markers = {
 
   // Section-styled components. `section: true` makes each one a real core
   // @section: `@npc-stat` is exactly `@section npc` (same element, same
-  // classes). No variants of their own: none is styled per specialty (that
-  // lives on `.dc-specialty.<name>`, from `@specialty`), and modifiers such as
-  // `.dc-snug`, `.dc-avoid-split` and `.gp-columns-2` stay author classes.
+  // classes). None is styled per specialty (that lives on
+  // `.dc-specialty.<name>`, from `@specialty`); the only variant is
+  // `@npc-stat compact`, and modifiers such as `.dc-snug`, `.dc-avoid-split`
+  // and `.gp-columns-2` stay author classes.
   'card-grid': { section: true, class: 'dc-card-grid' },
   'citizen-walkthrough': { section: true, class: 'dc-section-panel dc-citizen-walkthrough' },
   'fiction-excerpt': { section: true, class: 'dc-fiction-excerpt' },