# Changelog

All notable changes to the Triage Design System are recorded here. The format
follows Keep a Changelog; versions use SemVer.

## 0.12.1 — 2026-10-06

### Fixed
- Labels stay whole again. `.badge` wraps at spaces and breaks a word only when
  it genuinely cannot fit (`overflow-wrap:break-word`, `min-width:0`);
  `.status-chip` is a nowrap unit and the phone row wraps between chips as two
  equal columns (replacing the fixed `1fr 1fr` grid that overflowed at 200%
  text). Buttons wrap at spaces — a label containing one unbreakable token can
  opt into `.btn.wrap` (`overflow-wrap:anywhere`) rather than force the page
  wide at 200% text. The component catalog's Class and Source cells stay whole.
  The 0.10.0/0.12.0 `overflow-wrap:anywhere` treatment was too broad for labels.
- The home hero rendered the black-square mark on the black ink panel, so only
  the accent stripe and the T were visible. New `brand/mark-ink.svg` (paper
  square, accent chip, ink T) generated by `tools/build_brand.py`; the hero and
  the brand page use and document the inverted variant.
- `/foundations/brand` no longer returns 500: the CMYK table's colour unpacking
  shadowed the page-body list `b`, and pure black divided by zero.

### Added
- `.btn.wrap`, the documented opt-in for buttons whose label holds a single
  unbreakable token.
- `tests/browser/fixtures/badges.html`: the generated catalog is loaded at 1440
  and 390 and every badge must occupy a single line box, so the
  `overflow-wrap` regression class is now gated.

## 0.12.0 — 2026-10-06

Predictable adoption: a scoped integration path that cannot restyle host content,
an optional global reset, a rewritten interaction standard and a migration guide,
and package verification for the new artifacts.

### Added
- **Scoped bundle — `core/scoped.css` (generated).** `tools/build_core.py` now
  composes a second stylesheet from the same `src/core/**` sources: `@font-face`
  and `@keyframes` are lifted out to stay global (they cannot be scoped) and the
  remaining rules are wrapped in
  `@layer triage.components { @scope (.triage) { … } }`. Host content outside
  `.triage` is never restyled; the scope root carries the body essentials
  (background, text colour, font family/size, line-height, smoothing). Pair the
  scoped bundle with `core/reset.css` for parity with the global bundle: the
  reset owns the root rem base (`html{font-size:var(--base-size)}`) so the
  comfortable/compact density applies, and `body{margin:0}`. Loaded without the
  reset the host owns root sizing and typography — see the scoped contract in
  Notes. The file is byte-deterministic and covered by `--check` / `build.py check`.
- **Optional reset — `core/reset.css` (generated from `src/core/reset.css`).** A
  minimal, global, opt-in `@layer triage.reset` (box-sizing; body
  margin/background/text/font; link colour) for consumers who want base
  typography without the full global stylesheet. It ships no component styles.
  Both generated files declare `@layer triage.reset, triage.components;` so reset
  never overrides a component and the order is robust whichever loads first.
- **Host fixture — `tests/browser/fixtures/host.html`.** Proves the scoped claim:
  host `.card`/`.row`/`table`/`h1`/`a` computed styles equal a no-Triage control
  page (including the `:focus-visible` ring); `.triage` components match the
  global `core/base.css` bundle both with `reset.css` (comfortable **and** compact
  density) and without it at the host's default 16px root; and the reset-less
  case asserts the documented host-root consequences (no compact root scaling,
  host body margin). `reset.css` applies base typography without adding component
  chrome to host nodes.
- **`INTERACTION.md`.** The interaction standard rewritten in current Triage
  vocabulary (armed two-step delete, `.px-sw`, three feedback kinds, row actions,
  save bars, empty states, copy, labels/a11y), cross-checked against `core/`.
  The app-era record stays verbatim at `site/docs-from-app/ui-conventions.md`.
- **`MIGRATION.md`.** A 0.6 → 0.12 upgrade guide: the 16px base and compact
  opt-in, spacing roles + layout dimensions, `--fs-table`, the scoped/reset path,
  and the generated-vs-canonical repo split, with a checklist.
- **Consumer docs.** README gains a scoped quickstart and a component-dependency
  matrix (which families need `core/components.js` / `core/i18n.js`); `/system`
  documents the two paths, the layer order and a scoped quickstart; the docs nav
  links the interaction standard and migration guide.

### Packaging
- `package.json` exports `./scoped.css` and `./reset.css`; the files list ships
  the two new docs. `tools/package.py` includes and verifies `core/scoped.css`,
  `core/reset.css`, `INTERACTION.md` and `MIGRATION.md`.
- Version 0.12.0 across `VERSION`, `package.json`, `spec/rules.json`,
  `spec/states.json` and `rename-map.json`.

### Notes
- No public class or token was renamed or removed; `core/base.css` remains the
  default path and its behaviour is unchanged.
- **Scoped contract.** `core/scoped.css` is meant to pair with
  `core/reset.css`: the reset sets the `--base-size` rem base, so the 16px
  comfortable base and `data-density="compact"` density behave exactly as in the
  global bundle, and it zeroes the body margin. Loaded **without** the reset, the
  scoped bundle styles only the `.triage` subtree and leaves root sizing and
  typography to the host: at default density a 16px host root matches the global
  bundle, but `data-density="compact"` has no root effect — the `.triage`
  body/components stay at the host root (16px) instead of shrinking to the global
  compact 15px (~6.7% larger) — and the host body margin is kept. Use the
  reset-less path only when the host deliberately owns root sizing/typography.

## 0.11.0 — 2026-10-06

Reference-screen honesty plus a deterministic UI baseline. The example screens
state their status truthfully, the phone list leads with the message list, the
docs specimens stop doubling up borders, and a page-hierarchy contract is
documented — all guarded by a new computed-style baseline gate.

### Added
- **Deterministic UI baseline (CI gate).** `tests/browser/fixtures/baseline.html`
  measures a fixed selector list on `examples/{dashboard,list,form,viewer}.html`
  and the generated overlays docs page at 1440/390 in
  {light-comfortable, dark-comfortable, light-compact}: computed styles
  (font-size, color, background-color, display, gap, padding) plus one fixed-size
  geometry box, with a documented ±2px box tolerance and **no screenshots**.
  `tests/browser/run.py` compares the numbers against the committed
  `metrics/ui-baseline.json` and fails by element name on drift;
  `--update-baseline` regenerates it (run it twice to confirm determinism).
- **Page hierarchy contract** on `/foundations/typography`: page title →
  section heading → card heading → body → meta, with the element, token and job
  for each level, a live specimen and a do/don't list.
- **Phone proposal collapse.** The list page's proposal card is now a
  `.proposal-wrap` `<details>` (a page pattern, token-only) that collapses to a
  compact summary line at ≤767px so the message list leads; desktop is unchanged.

### Fixed
- **Dashboard aggregate honesty.** The status strip's summary said "All systems
  normal" while the Search index row was warn and the LLM row was err. It now
  reads "2 systems need attention" with an err dot and `data-alert="1"` (the
  count is derived from the non-ok rows), and the topbar no longer claims
  "healthy". A browser assertion fails if the summary claims all-normal while a
  row is non-ok, or if `data-alert` disagrees with the rows. Mirrored in the
  dashboard pattern docs.
- **Redundant specimen borders.** Single bordered specimens (a lone `.card`,
  `.msg`, or the `.proposal` pair) no longer sit inside a bordered `.p-demo`
  shell — `demo()` gains a `plain` tone that drops the shell frame (site CSS
  only; core borders are untouched).
- **Viewer page title** no longer downsizes the record subject with an inline
  `font-size`; it renders at the page-title level and wraps. The typography
  specimen no longer emits a second `h1` on the docs page.

## 0.10.0 — 2026-10-06

Spacing grows up: a curated preferred scale, semantic spacing roles components
consume by intent, a separate layout-dimension group, and the carried WP3
acceptance item — the example screens now reflow at 200% text without
page-level horizontal scrolling.

### Added
- **Preferred spacing scale.** `spacing` declares the canonical set
  `2/4/8/12/16/24/32/48` (new `--space-32`). The fine/odd steps the shipped
  sheets still use (1, 3, 5, 6, 7 … 480) remain emitted for compatibility but
  are reworded in `tokens.json` as **legacy/observed** — prefer the preferred
  scale for new work.
- **Semantic spacing roles** (`page: 24`, `card: 16`, `field: 8`,
  `control: 12`), emitted as `--space-page` / `--space-card` / `--space-field` /
  `--space-control`. The canonical primitives consume them: `.content` page
  padding, `.card` padding, the label/field gap and form-field padding, and
  `.btn` / `.iconbtn` inline padding.
- **Layout dimension group.** `misc.layout` (`sidebar: 236`, `content-max: 1160`,
  `dock: 352`) emits `--layout-sidebar` / `--layout-content-max` / `--layout-dock`
  from `tools/build_tokens.py`. `.side` width, `.main` offset, `.content`
  max-width and the dock width fallback consume them, so a fixed chrome/column
  width can no longer be mistaken for a spacing gap.

### Fixed
- **200% text reflow (WCAG 1.4.4).** All four example screens (dashboard, list,
  form, viewer) stay a single column with no page-level horizontal overflow at
  320px and 390px with the root at 32px. Fixes at the source:
  `.badge` / `.status-chip` wrap instead of `white-space:nowrap`, `.btn` and the
  bottom-nav links can shrink/wrap (`min-height` + `overflow-wrap`), and
  `.proposal` / `.action-row` `.action-main` / `.kv` gain `overflow-wrap:anywhere`
  for long paths and addresses. The browser layout matrix asserts this per screen
  (`tests/browser/fixtures/layout.html`); the docs scorecard's *1.4.4 Resize
  Text* row is back to **pass**.
- A new `tests/browser/fixtures/roles.html` fixture and token-pipeline mutation
  tests prove the role/layout tokens drive the generated CSS.

### Breaking (visual)
- **Deliberate role snaps.** Several defaults move by a hair so the primitives
  read a preferred-scale role: `.content` page padding 26→24px (−2px inline and
  top); `.card` padding 16/18→16px (−2px horizontal); `.btn` inline padding
  13→12px (−2px width); the `<label>` bottom margin (label→field gap) 4→8px
  (+4px). Icon buttons keep their 34px square; only their (previously implicit)
  inline padding is now named `--space-control`. `.btn` uses `min-height` (auto
  height) so a wrapping label grows the button instead of overflowing.
  No class or token names were renamed; the legacy `--space-*` tokens remain.

## 0.9.0 — 2026-10-06

Comfortable typography by default. The design base moves from 15px to 16px, the
`--fs-*` scale is raised to readable sizes, and the long-standing 9.6–9.9px
micro-label tier is retired. Compact density becomes an opt-in, token-sourced mode.

### Breaking (visual)
- **The type scale renders larger.** `typography.base-size` is 16px and every
  `--fs-*` step is authored at its intended px: display 38, h1/page-title 24,
  metric-primary 30, metric 22, stat 22, chat-empty-title 20, h2 18.5, sec-h 17.5,
  h3 17, h4 14.5, body 16, prose 15, bubble/nav-item 14, sub 13.5, label 13,
  log-row/pre-log 12.5, copy/kbd/nav-label/badge/p-tag 12. Nothing meaningful
  computes below 12px. Layouts tuned to the old 15px root (and 9.6px labels) will
  look larger. **Migration:** keep the comfortable default and let the raised
  tokens carry the new sizes; if the old compact density is preferred, opt into
  `<html data-density="compact">`.
- **`_rem()` is base-driven.** `tools/build_tokens.py` divides the `--fs-*` scale
  by the `typography.base-size` token instead of a fixed 15, so the authored px
  and the relative root (`--base-size:1rem`) share one source of truth; changing
  the base rescales the whole scale.
- **New `--fs-table` role (14px).** `.tbl th`/`.tbl td` now consume it (headers
  were `--fs-copy`, cells `--fs-sub`), so table content is ~14px while `--fs-sub`
  stays description text.
- **Headings wrap long tokens** (`overflow-wrap:anywhere`) so an unbroken word in
  a title cannot overflow the page.

### Added
- **Compact density.** `html[data-density="compact"]` renders body ~15px and
  controls/table ~13px while every label stays ≥12px. The values live on the
  affected typography tokens as `$extensions.com.triage.compact`
  (`base-size:0.9375rem`, labels `0.8rem`); `tools/build_tokens.py` emits the
  `:root[data-density="compact"]` block — nothing is hand-written in `src/core/`.
  Comfortable is the default (no attribute). Migration for products that consumed
  the old 15px density: add `data-density="compact"` on `<html>`.
- Density toggle on the docs site, persisted in `localStorage`, alongside the
  theme toggle.
- Browser coverage for both densities and a width/long-text matrix, plus
  token-pipeline mutation tests for the base-driven scale and the compact
  extension.

### Docs
- The typography foundation documents both densities and the 16px base;
  `README.md` and `AGENTS.md` cover the density attribute and the base-driven
  `_rem` / `com.triage.compact` contract. The audit's F3 micro-text finding is
  marked resolved.

## 0.8.0 — 2026-10-06

Honest token pipeline: every supported foundation token now drives its generated
output, the fixed 15px root is replaced by a relative rem model, breakpoints are
token-driven at build time, and every emitted token has a documented consumer or
an explicit metadata-only reason.

### Build pipeline
- **Font stacks come from tokens.** `tools/build_tokens.py` derives
  `--font-sans`/`--font-mono`/`--mono` from
  `typography.family-text`/`family-mono`; families that are not bare CSS
  identifiers (spaces, leading digits, punctuation) are quoted and escaped.
  Missing, empty or non-numeric values are a hard error, not a silent fallback.
- **`--base-size` and a relative root.** `tokens/tokens.css` now emits
  `--base-size:0.9375rem` (the 15px design base against the browser's 16px
  default). `src/core/additions.css` sets `html{font-size:var(--base-size)}` and
  the body size consumes `--fs-body`, so a user text-size preference scales the
  whole rem scale. The `--fs-*` design scale still divides by 15; the two
  conversions are documented in the generator.
- **Token-driven breakpoints.** `src/core/**` media queries use `{bp-sm}`,
  `{bp-phone}`, `{bp-phone-up}`, `{bp-md}`, `{bp-lg}` and `{bp-xl}`
  placeholders; `tools/build_core.py` substitutes the px value from
  `tokens/tokens.json` `misc.breakpoint` at compose time and fails loudly on an
  unknown or unresolved placeholder. `phone-up: 768` is the derived min-width
  mirror of `phone: 767`, and both tools enforce `phone-up = phone + 1` so the
  pair cannot drift into a dead band. Generated `core/*.css` is byte-identical
  to 0.7.0 apart from the banner and the relative-root lines.

### Added
- **`tools/token_map.py`** enforces the token-consumption contract: it scans the
  documented consumer set (`src/core/**`, `core/*.js`, `examples/**`, `site/**`,
  `tests/browser/**`) with comments stripped, resolves primitives consumed
  through a semantic alias, resolves `{bp-*}` placeholders and the generated
  foundation tokens, writes `spec/token-consumers.json`, and fails when a token
  is neither consumed nor listed with a reason in `spec/token-metadata.json` (or
  when a metadata-only entry has since gained a consumer). It is wired into
  `tools/verify.py` and `make check`.
- **Mutation tests** (`lint/tests/test_token_pipeline.py`) prove that changing
  `family-text`, `family-mono`, `base-size` or a breakpoint value changes the
  generated output, and that an unknown `{bp-...}` fails the composer.
- **Browser evidence** (`tests/browser/fixtures/tokens.html`): the 15px body at
  the default root, `--base-size` resolving and driving the `html` rule, a 20px
  user root scaling body text to 20px, and the sans/mono stacks.

### Changed
- `site/layout.py` reads `VERSION` at import instead of hardcoding the release
  string.

## 0.7.0 — 2026-10-06

Hardening release: reproducibly generated core stylesheets, four runtime
accessibility/interaction fixes with a headless-browser regression suite, and
restored quickstart documentation.

### Build pipeline
- **Core stylesheets are generated from canonical sources.** `core/base.css` and
  `core/patterns.css` are composed by `tools/build_core.py` from
  `src/core/{base,additions,components,patterns}.css`; `python3 build.py core`
  regenerates them and `--check` byte-compares. Output is byte-identical to the
  previous files apart from the provenance banner.
- `python3 build.py check` and `tools/verify.py` fail on core drift, and CI
  regenerates the core stylesheets and fails on `git diff core/`.
- The historical pack pipeline (`tools/assemble_from_pack.py`,
  `tools/tokenize_core.py`) is demoted to provenance maintenance: it refuses to
  run without `--force`, and a forced sync stages under `dist/pack-sync/` instead
  of overwriting `core/` or `tokens/`. Removed the unreferenced
  `patches/triage-0.6-components.css` duplicate.

### Fixed
- **Log text contrast**: `.logpanel .logrow` used `--border-strong` (1.93:1 on
  the dark code surface, below 4.5:1); it now uses `--code-fg`.
- **Armed-delete contrast**: `.arm-del.armed` / `.icon-del.armed` used
  `--status-danger` (2.28:1 in dark under white text); they now use
  `--status-danger-solid`, which clears 4.5:1 in both themes.
- **Command palette**: clicking an item executed the highlighted item instead of
  the clicked one. A click now runs the clicked item (both `data-href` and
  `data-cmd-action` paths); Enter still runs the highlighted item.
- **Date picker**: all 42 day buttons were tab stops, day buttons had
  number-only accessible names, and Escape on a day left the popup open. Now
  exactly one day cell is tabbable (roving tabindex), each day carries a
  full-date `aria-label` via Intl, arrows move ±1/±7 days, Home/End jump to the
  week edges, PageUp/PageDown change month, disabled days are skipped, and
  Escape/selection close the popup and return focus to the input.

### Added
- `tests/browser/` — a stdlib-only headless-Chrome regression suite covering the
  interactions above and WCAG contrast in both themes, wired into
  `make browser-test` and CI.
- `spec/states.json` top-level lifecycle policy defining the evidence each
  status (stable/beta/experimental/deprecated) requires.
- Restored `README.md` quickstart and `AGENTS.md` repository contract.

## 0.6.1 — 2026-10-06

- **Fixed:** `.bubble.ai` used `min-width:180px`, so assistant bubbles overflowed
  any container narrower than ~240px (visible in the home-page montage and any
  compact chat panel). Now `min-inline-size:min(180px,calc(100% - var(--space-40)))`
  — logical, token-based, and it accounts for the avatar + gap.
- Home page rework: ink hero with live stats, component montage, five entry
  cards, changelog-driven "what's new", adopt-in-four-lines.

## 0.6.0 — 2026-10-06

Every gap from the brand-kit and component research, implemented.

### Components (22 new)
Tabs · breadcrumbs · radio · slider · combobox + multi-select · date picker ·
accordion · avatars + avatar groups · image frames · upload/dropzone ·
notification centre · command palette (⌘K) · full-page states (404/500/403/
offline/maintenance) · numbered pagination + page size · sortable table headers ·
timeline · diff · side/bottom sheet dialogs.
All are token-only, logical-property, focus-visible and documented; the state
matrix grew from 18 to **35 components**, each with lifecycle status
(stable/beta/experimental/deprecated).

### Behaviour
`core/components.js` (dependency-free, data-attribute driven, degrades without
JS) and `core/i18n.js` (locale + messages + plurals + Intl formats + auto `dir`).
New `/foundations/localisation` page with a live locale switcher.

### Brand collateral
`brand/` now ships `mark-mono.svg`, horizontal/stacked lockups, an Open Graph
card (`og.svg`, 1200×630), a table-based `email.html`, `email-signature.html`,
`slide.svg` and `release-notes.md` — generated deterministically by
`tools/build_brand.py`. Brand page adds strategy one-pager, variations,
imagery direction, print/CMYK table and application links.

### Tooling
- `tools/export_tokens.py` → Style Dictionary, Tokens Studio and Figma
  Variables projections (113 variables, Light/Dark), CI-checked.
- Linter rules **TDS014** (`<img>` without alt) and **TDS015** (accessible name,
  positive tabindex) — 15 rules, 45 tests.
- Component lifecycle statuses validated by the verifier and shown in the
  catalog.

## 0.5.0 — 2026-10-06

Brand, philosophy and chrome documentation + real brand assets.

- **Philosophy page** (`/foundations/philosophy`): paper-and-ink narrative, the
  eight principles, how each is enforced, and the deliberate non-goals.
- **Logo & mark**: the Triage mark (ink square + accent chip + white T), clear
  space, minimum size, colourways, do/don't, live at 24/48/96.
- **Favicon section**: SVG-first wire-up, ICO/PNG fallbacks, apple-touch icon
  and manifest — with real assets under `brand/` generated by
  `tools/build_brand.py` (deterministic, stdlib-only, CI-verified).
- **Colour architecture & suggestions**: two-tier token model, dark-mode
  mechanics, contrast gates, plus the open recommendations (sequential ramps,
  alias adoption, strict 1.4.11 mode).
- **Typography architecture & suggestions**: root/rem model, role families,
  tracking rules and the modular-scale/micro-floor suggestions.
- **Headers & footers** (`/components/chrome`): brand header, app topbar, page
  header, section headers, content footer, phone tab bar + the shared
  sticky/z-index/safe-area rules.
- Tarball now ships `brand/`; docs favicon/manifest wired to the new assets.

## 0.4.0 — 2026-10-06

Transferable icon system.

- **174 glyphs** vendored from **Lucide** (`lucide-static 1.52.0`, ISC licence),
  curated into 10 categories with tags, normalized to the Triage drawing spec
  (24×24, currentColor, stroke 1.7, round caps/joins).
- **Four consumption paths:** `icons/svg/*.svg` (individual), `icons/sprite.svg`
  (`<use>`), `icons/icons.json` (registry with path bodies), and
  `core/icons.js` (`triageIcon(name, size[, label])`).
- **Aliases:** all 21 original mail-triage names (`dashboard`, `check-circle`,
  `trash`, `plugins`, …) resolve to canonical Lucide names — back-compat without
  duplicate glyphs.
- **Enforcement:** `build.py icons` builds the sprite/registry; `build.py check`
  fails on drift, missing aliases, non-24 viewBoxes or duplicate path data.
- **CSS:** `.icon` + `.icon-14|-16|-21|-24|-30` bound to the icon-size tokens.
- Docs: `/foundations/icons` rebuilt with a searchable 174-glyph registry,
  consumption snippets, alias table, provenance and upgrade path; tarball now
  ships `icons/`.

## 0.3.6 — 2026-10-06

- **Paper is now the default banner surface** for `.msg` / `.note`: slightly
  light grey (#f7f7f7) in light mode, dark grey (#1e1e1e) in dark mode still —
  black border and coloured left chip unchanged.
- `.ink` variant keeps the solid black surface (`--surface-banner-ink`);
  `.paper` remains as an explicit alias of the default.
- New/renamed tokens: `banner-paper` (default) and `banner-ink`;
  aliases `--surface-banner` (paper) and `--surface-banner-ink`.
- Highlight chips are now dark-chip/light-grey only on ink and solid banners;
  the default paper and tint banners use the normal light chip.

## 0.3.5 — 2026-10-06

Banner readability fixes (design review).

- Highlight chips (`.mono` / `code`) inside ink and solid banners now render as
  dark chips with **light-grey text** (`--ink-soft` #c9c9c9) instead of
  inheriting white on a light chip. Paper/tint banners keep the normal chip.
- New `--surface-banner` token: banners stay solid black in light mode but
  become **dark grey #1e1e1e in dark mode** (was solid black).
- TDS011 pair added for highlight-on-chip (8.99:1 light / 6.83:1 dark).

## 0.3.4 — 2026-10-06

- Banner/toast edge chip widened: `--bw-edge` 3px → 8px (design review:
  the chip should read as a chip, not a hairline). Shared by `.msg`/`.note`
  and `.toast2`.

## 0.3.3 — 2026-10-06

Banner redesign (design review): solid surface, black border, status edge chip.

- `.msg` / `.note` default is now the **ink** treatment — solid black surface,
  black border, and the status colour as a 3px left chip
  (`--bw-edge`, logical `border-inline-start`) identical to `.toast2`.
- `.msg.paper` / `.note.paper`: solid white surface, black border, same chip.
- `.msg.tint.*` (soft border, matching text) and `.msg.solid.*` (full-colour
  fill) remain as alternates; `.note.tint` keeps the blue callout.
- New `--bw-edge:3px` token; toast rail and banners share it.
- Contrast: white on ink 21:1, black on paper 21:1; TDS011 green.

## 0.3.2 — 2026-10-06

Solid banner variant for comparison (requested from design review).

- New primitives + aliases: acc-solid #0052f0 / ok-solid #008348 / warn-solid
  #b45309 / err-solid #e00b1c → --interactive-solid / --status-{success,warning,
  danger}-solid; all full-saturation surfaces with white text (6.06 / 4.84 /
  5.02 / 4.96:1 — TDS011-checked in both themes).
- `.note.solid` and `.msg.solid.ok|warn|err` modifiers; tint remains the default.
- Docs: side-by-side tint vs solid comparison on /foundations/color; swatch
  group added.

## 0.3.1 — 2026-10-06

Palette refresh from design review: more saturation, less pastel, lighter
banner borders, status-coloured banner text.

- Status text saturated: accent #0057d9, success #04713f, warning #9a4f07,
  danger #c81e2c (dark: #5aa9ff / #45d68f / #f0ae4f / #ff8a80).
- Tints raised to vivid 100-level: #dbeafe / #dcfce7 / #fef3c7 / #fee2e2
  (dark: #0d2447 / #06301b / #3a2a08 / #3d1114).
- New soft border primitives + aliases: acc-line/ok-line/warn-line/err-line →
  --interactive-border / --status-{success,warning,danger}-border; `.note` and
  `.msg` use them, so banner borders are light mid-tones instead of full-strength
  status colours.
- Banner text now matches its status colour (`.msg.ok/.warn/.err` and `.note`)
  instead of inheriting black.
- All pairs re-verified by TDS011 in both themes (text on tint now the rendered
  combination: accent 5.11:1, success 5.56:1, warning 5.40:1, danger 4.67:1).

## 0.3.0 — 2026-10-06

Everything below comes from an adversarial critique (four independent reviewers)
and fixes it at the source.

### Fixed — P0
- Release tarball now contains `core/*.js`, `core/vendor/`, `fonts/` (26 files,
  verified by `tools/package.py` on every build).
- Linter no longer crashes on modern CSS (`rgb(0 0 0 / 1)`, `hsl()`) or JS hex
  strings; named and modern colour syntaxes are now flagged (TDS002).
- `html{font-size:15px}` — rem tokens now resolve at the documented 15px base.
- Semantic-token overrides (`--surface-page:red`) are caught by TDS009;
  `outline:none` with any background is no longer accepted as a focus
  replacement (TDS004); `50%` radii require an explicit `triage-allow`.
- Forced-colors keeps a Highlight focus outline on inputs/selects/textareas and
  dock grip; progress/skeleton/tooltip covered.
- Reduced motion: smooth scrolling cancelled and the spinner slowdown wins over
  the global `.01ms !important` rule.
- Destructive dialogs: `[data-dlg-static]` / `[data-danger]` block backdrop
  close; the example autofocuses Cancel.
- State matrix verified selector-by-selector (`tools/verify.py`); missing states
  added: disabled switch, selected table row, component-scoped focus-visible.

### Fixed — P1
- **Core consumes type/spacing/weight/line-height/opacity tokens**: 150 `--fs-*`,
  277 `--space-*`, 51 `--fw-*`, 14 `--lh-*` references; raw positive px in rhythm
  props is gone (calc/env/negative offsets remain by nature).
- Dark theme complete: shadows carry dark values, `--ink` removed as dead,
  TDS011 checks **both themes** (light first definitions + dark-block overrides).
- Switch track/knob and neutral dot use `--control-border` (3.23:1).
- `control-border` alias added; TDS012 catches local vars built from primitives.
- RTL: direction-critical transforms fixed (drawer, tooltip, switch knob, flow
  handles, dock transition); target-size floor (24px) and scroll-padding added.
- Print: chrome/controls hidden, sticky headers unstick, ink surfaces print
  paper-safe black-on-white, internal links print their href.
- Honest guard: `guardApply` supports `data-busy-label` / `data-no-busy` and
  restores on `pageshow`; docs claims corrected (`.kb-open`, counts, versions).

### Changed — P2
- Data-viz palette re-derived from Okabe–Ito, contrast-adjusted and checked for
  deuteranopia/protanopia separation (min distance 14/100 under Machado).
- Legacy `.toast` and `--z-toast-legacy` removed; duplicate `.copy` merged;
  popover backdrop removed (light dismiss must not dim like a modal); stepper
  connector rails unified.
- Examples: `MT`→`TR`, neutral copy, invalid duplicate class attribute fixed,
  undefined `.act-sum` removed.
- **The docs site is now inside the dogfood scope**: `triage-lint . --strict`
  scans 24 files (core, tokens, examples, site) at 100/100.

### Token counts (0.3.0)
- 36 colour primitives · 34 aliases · 36 typography · 48 spacing · 11 durations
- 6 shadows (light+dark) · 8 data-viz series (light+dark) · 304 emitted vars
- 13 lint rules · 39 unit tests · 18-component state matrix

## 0.2.0 — 2026-10-06

### Added
- **Complete token emission**: tokens.css now publishes every group as custom
  properties — colour primitives + 35 semantic aliases, typography (sizes,
  weights, line-heights), spacing (47 steps incl. fine/observed), motion
  durations + easings, z-index ladder, shadows, icon sizes, border widths,
  opacity, and an 8-colour data-viz series.
- **Dark theme**: every colour primitive (and data-viz series) carries a
  `$extensions.com.triage.dark` value; tokens.css emits
  `prefers-color-scheme: dark` and `[data-theme=dark]` overrides. Core flips
  through aliases — no second stylesheet.
- **RTL**: core migrated from 78 physical direction properties to logical
  properties; enforced by TDS013.
- **Forced colours + print**: `@media (forced-colors: active)` border/system
  colour fallbacks (box-shadow is forced to none), and a print block that
  hides chrome.
- **Components**: native `<dialog>` (`.dlg` + shell.js `data-dlg-open/close`),
  CSS tooltip (`.tip`), native popover styling, `.spinner`, and the form error
  contract (`.field-err`, `[aria-invalid]`).
- **Enforcement**: lint rules TDS011 (token contrast), TDS012 (prefer semantic
  aliases), TDS013 (logical properties); `spec/states.json` component state
  matrix checked by `tools/verify.py`.
- **New primitives**: placeholder (#767676), border-control (#8f8f8f),
  fg-soft, on-ink, acc-ink, ink-hover, log colours, translucent bar/scrim,
  elevation shadows, size/opacity tokens.

### Changed
- `--acc` #0070f3 → #0068e0 (4.5:1 on --bg), `--warn` #b25e09 → #a85708
  (4.5:1 on tints); `.nav-label` now uses `--text-secondary`; placeholders use
  `--placeholder`.
- Core stylesheets consume semantic aliases only (TDS012); `.triagerc.json` no
  longer exempts core/tokens — the repo dogfoods its own gate at 100/100.
- Form controls use `--border-control` (3:1 non-text boundary).
- Flow-segment focus outline uses the solid accent, not the translucent ring.

### Fixed
- Dead non-zero radius declarations removed (policy remains zero;
  `allowRadius` documents the spinner's 50% circle).
- `.arm-del/.icon-del` armed styles restored to core.

## 0.1.0 — 2026-10-06

### Added
- Initial generic extraction: full rename sweep, tokens pipeline (colour),
  P1–P3 merged, examples rewired, `--check` guard, docs & enforcement site.
