@ponchia/ui 0.9.0 → 0.11.0

package/CHANGELOG.md

@@ -5,6 +5,109 @@
 |> `^0` / `*` wildcard does **not** protect you. See README → Versioning, and
 |> the deprecation policy in CONTRIBUTING.md.
 
+## 0.11.0 — 2026-09-09
+
+### Changed
+
+- **BREAKING: complete the supporting typography.** Figure captions, legend
+  text, generated-content labels and command groups use sentence-case sans.
+  Technical log bodies and identifiers retain mono. Caption text is 14px at
+  the default root size; inline citations no longer shrink below 12px.
+- Figure keys and decision/action rows respond to their own available width.
+  Two-up comparisons wrap intrinsically, including outside a report. Named
+  containment on figure, decision-grid and actions wrappers is disabled for
+  print to preserve document flow.
+
+### Fixed
+
+- Narrow evidence panels no longer squeeze a chart into 40px or decision text
+  into 21px on a wide page. Long action status and legend labels wrap.
+- Long mobile navigation labels wrap while keeping every destination reachable.
+- The figure specimen's authored annotation stays inside its viewBox.
+- Generated-content disclosure summaries retain the coarse-pointer target floor.
+
+### Added
+
+- Optional `discussion.css` with thread lists, quoted passages, messages and
+  composers. State and posting remain host-owned; includes a local interactive
+  specimen and a narrow-panel example.
+
+- A working service specimen with deterministic loading, empty, error and stale
+  states, environment/search filtering, retry and native-dialog sample creation.
+  Unavailable observations never retain an operational health claim. Product
+  state stays in the specimen; no framework state machine or data dependency.
+- Narrow-parent regression checks, including a comparison outside a report,
+  annotation bounds, long action status, citation text and recovery journeys.
+- A complete-screen migration recipe for explicit consumer typography overrides.
+
+See [the migration guide](docs/migrations/0.10-to-0.11.md).
+
+## 0.10.0 — 2026-09-08
+
+### Changed
+
+- **BREAKING: readable tool and report defaults.** The root respects the
+  browser's default text size. Everyday headings, labels, navigation, tables,
+  and controls use sans typography and sentence case. Explicit `ui-display`,
+  glyphs, and readouts retain the dot identity. Small text steps are 12/13/14px
+  at a 16px root; corner tokens use a restrained 2/4/6/8px scale.
+- Service panels remove redundant framing, overview metrics stay compact, and
+  mobile navigation wraps. Inspectors adapt property rows to their own width.
+  Reports use 1.125rem prose, a 68ch measure, and 11pt print text.
+- ADR-0005 and composition recipes replace the shipped-duplicate admission
+  rule with demonstrated task improvement. The default CSS budget is now
+  100,000/18,000 bytes raw/gzip, restoring deliberate maintenance headroom.
+- The example CI matrix derives from the shared registry. The complete browser
+  suite runs in three required shards, with unchanged cross-engine coverage.
+  Local Playwright uses an owned server on 8124 (`BRONTO_UI_TEST_PORT` override)
+  and refuses to reuse a live specimen server.
+
+### Removed
+
+- **BREAKING:** the five framework adapter subpaths and optional framework
+  peers, deprecated in 0.7. Initialize vanilla behaviors in the host lifecycle.
+- **BREAKING:** the controlled modal initializer, detail type, data attribute,
+  event, and `ui.modal({ open: true })` option. Use native dialog plus
+  `initDialog`; native modal and drawer styling remain.
+- Unused adapter parity machinery and Solid/Qwik/Vue packed examples. React
+  and SvelteKit examples verify vanilla behavior mounting and cleanup.
+
+### Added
+
+- `ui-timestrip` in the opt-in state leaf: the host supplies normalized event
+  positions and Bronto paints the rail, now marker, and severity marks. Old
+  events can remain visible at the window edge through `data-outside`.
+- `ui-severity-tone` exposes the existing severity mapping without painting a
+  background, including for SVG consumers. `severity(level, { part: 'tone' })`
+  returns the corresponding class and level.
+- `ui-chip--dense` and `ui.chip({ dense: true })` for static pane-header labels,
+  with pointer target floors when used on controls.
+- A collapsed `details.ui-report__toc` recipe that keeps the decision first.
+
+### Fixed
+
+- Single-column stacks and prose shrink inside narrow parents; the showcase's
+  nested legend grid fits its available width. Range inputs no longer add
+  browser margins outside their containing width.
+- The workbench specimen stacks panes when narrow, provides native file-row
+  selection, and separates badge tone from row metadata styling.
+- The service and report examples use favorable tones for decreasing latency.
+  Report annotations leave room for their stroke outside the drawing bounds.
+- Development URI, YAML, and color parsers receive compatible security updates.
+
+### Internal
+
+- Releases publish to npm by trusted publishing (OIDC) instead of a stored
+  access token. The token that authenticated previous releases expired
+  silently and surfaced only as a misleading `E404` after every gate and the
+  publish approval had passed; there is now no credential to expire. The
+  publisher identity is the repository, the workflow filename `release.yml`,
+  and the `npm-publish` environment — see
+  [ADR-0006](docs/adr/0006-trusted-publishing.md). The only packaged change is
+  that ADR joining the published documentation set.
+
+See [the migration guide](docs/migrations/0.9-to-0.10.md).
+
 ## 0.9.0 — 2026-08-11
 
 Two additions and one correction, all from the same source: migrating a
@@ -53,7 +156,7 @@ downstream workbench onto 0.8.1 and watching where adoption stalled.
 - **`.ui-menu` no longer welds placement into the surface.** It used to declare
   `position: absolute` plus a trigger-relative offset, so a menu opened at a
   pointer — a canvas context menu, a long-press — could not use it at all, and
-  consumers re-declared the panel, border, radius and shadow to get a surface.
+  consumers redeclared the panel, border, radius and shadow to get a surface.
   The dropdown placement is now `--dropdown` (unchanged behaviour, opted into)
   and `--at-pointer` takes a menu out of flow for a host that computes its own
   position.
@@ -149,7 +252,7 @@ consumer had to write because the framework did not provide it, or got wrong.
   neutral. From 0.8 the ten `SKIN_CANVAS_TOKENS` (`--bg`, `--bg-elevated`,
   `--panel`, `--panel-strong`, `--panel-soft`, `--line`, `--line-strong`,
   `--text`, `--text-soft`, `--text-dim`) are re-pointed per skin per theme.
-  - **If you want the old look**, re-declare those ten tokens after the skin
+  - **If you want the old look**, redeclare those ten tokens after the skin
     import; they are ordinary custom properties on `:root[data-bronto-skin=…]`
     and un-layered app CSS wins.
   - **If you already hand-wrote a canvas** for a skin — the case this change
@@ -181,7 +284,7 @@ consumer had to write because the framework did not provide it, or got wrong.
   text in it and `--icon` decides whether the words are painted; they stay in
   the accessible name and in text-based test selectors either way. One markup
   shape serves both the labelled and icon-only forms, and no `aria-label` can
-  drift out of sync with the visible wording. The slot also ellipsises rather
+  drift out of sync with the visible wording. The slot also ellipsis rather
   than wrapping, so a labelled button in a tight bar shrinks instead of pushing
   its neighbours out. `ui.button()` is unchanged; `cls.buttonLabel` is new.
 - **`.ui-button--dense`** — a size tier for bars whose *height* is the
@@ -1096,7 +1199,7 @@ and D2. The data-viz **palette** (`--chart-*`, `tokens/charts.json`) and the
   (build five real reports across the whole stack, review from every POV). The
   Vega CDN recipe now pins the `/build/*.min.js` UMD bundles and `renderer:'svg'`
   (a bare `cdn.jsdelivr.net/npm/vega@6` tag has no `window.vega`, so the previous
-  recipe rendered nothing); the file://-portable path (inline the config — an
+  recipe rendered nothing); the `file://`-portable path (inline the config — an
   imported/fetched config is CORS-blocked from disk) is now explicit. New
   `docs/reporting.md` recipes: "Theming a live report" (the theme-toggle/re-embed
   foot-guns — clear the host, container-width-while-hidden, Mermaid source vs

package/MIGRATIONS.json

@@ -6,21 +6,78 @@
       "to": "0.3",
       "summary": "Entire non-ui-* legacy vocabulary removed; everything is now under the .ui-* contract and the check-classes drift gate.",
       "safe": [
-        { "old": "skip-link", "new": "ui-skiplink" },
-        { "old": "site-nav", "new": "ui-sitenav" },
-        { "old": "site-menu", "new": "ui-sitemenu" },
-        { "old": "theme-toggle", "new": "ui-themetoggle", "prefix": true },
-        { "old": "app-shell", "new": "ui-app-shell", "prefix": true },
-        { "old": "app-rail", "new": "ui-app-rail", "prefix": true },
-        { "old": "app-topbar", "new": "ui-app-topbar", "prefix": true },
-        { "old": "app-toolbar", "new": "ui-app-toolbar", "prefix": true },
-        { "old": "app-nav", "new": "ui-app-nav", "prefix": true },
-        { "old": "app-panel", "new": "ui-app-panel", "prefix": true },
-        { "old": "app-content", "new": "ui-app-content", "prefix": true },
-        { "old": "app-main", "new": "ui-app-main", "prefix": true },
-        { "old": "app-metrics", "new": "ui-app-metrics", "prefix": true },
-        { "old": "app-metric", "new": "ui-app-metric", "prefix": true },
-        { "old": "app-empty-state", "new": "ui-app-empty-state", "prefix": true }
+        {
+          "old": "skip-link",
+          "new": "ui-skiplink"
+        },
+        {
+          "old": "site-nav",
+          "new": "ui-sitenav"
+        },
+        {
+          "old": "site-menu",
+          "new": "ui-sitemenu"
+        },
+        {
+          "old": "theme-toggle",
+          "new": "ui-themetoggle",
+          "prefix": true
+        },
+        {
+          "old": "app-shell",
+          "new": "ui-app-shell",
+          "prefix": true
+        },
+        {
+          "old": "app-rail",
+          "new": "ui-app-rail",
+          "prefix": true
+        },
+        {
+          "old": "app-topbar",
+          "new": "ui-app-topbar",
+          "prefix": true
+        },
+        {
+          "old": "app-toolbar",
+          "new": "ui-app-toolbar",
+          "prefix": true
+        },
+        {
+          "old": "app-nav",
+          "new": "ui-app-nav",
+          "prefix": true
+        },
+        {
+          "old": "app-panel",
+          "new": "ui-app-panel",
+          "prefix": true
+        },
+        {
+          "old": "app-content",
+          "new": "ui-app-content",
+          "prefix": true
+        },
+        {
+          "old": "app-main",
+          "new": "ui-app-main",
+          "prefix": true
+        },
+        {
+          "old": "app-metrics",
+          "new": "ui-app-metrics",
+          "prefix": true
+        },
+        {
+          "old": "app-metric",
+          "new": "ui-app-metric",
+          "prefix": true
+        },
+        {
+          "old": "app-empty-state",
+          "new": "ui-app-empty-state",
+          "prefix": true
+        }
       ],
       "manual": [
         {
@@ -65,9 +122,18 @@
       "to": "0.5",
       "summary": "Adds the analytical-primitives suite (annotations, legend, marks, connectors, spotlight, crosshair, selection + the analytical.css roll-up); all additive/opt-in. Three breaking changes: the chart data key moved out of the report kit into the standalone Legends layer (`.ui-chart__legend`/`.ui-chart__swatch` removed); annotation arrowheads now render via the shared connectors geometry kernel (a small visual path change, no API change); and the marks/bracket-note rationed-accent tone was renamed `evidence`→`accent` to match the annotation/connector tone vocabulary (`.ui-annotation--evidence` stays — it's a marker variant, not a tone).",
       "safe": [
-        { "old": "ui-chart__swatch", "new": "ui-legend__swatch" },
-        { "old": "ui-mark--evidence", "new": "ui-mark--accent" },
-        { "old": "ui-bracket-note--evidence", "new": "ui-bracket-note--accent" }
+        {
+          "old": "ui-chart__swatch",
+          "new": "ui-legend__swatch"
+        },
+        {
+          "old": "ui-mark--evidence",
+          "new": "ui-mark--accent"
+        },
+        {
+          "old": "ui-bracket-note--evidence",
+          "new": "ui-bracket-note--accent"
+        }
       ],
       "manual": [
         {
@@ -115,6 +181,49 @@
         }
       ],
       "codemod": "No source codemod. Update the DTCG reader at its JSON access boundary, then run npx --no-install bronto-ui-check against consumer source. See docs/migrations/0.6-to-0.7.md."
+    },
+    {
+      "from": "0.9",
+      "to": "0.10",
+      "summary": "Readable tool/report defaults; retire framework adapters and controlled modal.",
+      "safe": [],
+      "manual": [
+        {
+          "old": "@ponchia/ui/react / @ponchia/ui/solid / @ponchia/ui/qwik / @ponchia/ui/svelte / @ponchia/ui/vue",
+          "new": "@ponchia/ui/classes + @ponchia/ui/behaviors",
+          "note": "Initialize vanilla behaviors in the host mount lifecycle and return cleanup; wrappers and peers are removed."
+        },
+        {
+          "old": "initModal / data-bronto-modal / ui.modal({ open: true }) / bronto:modal:close",
+          "new": "native dialog + initDialog",
+          "note": "Use showModal/close and native cancel/close events; .is-open no longer opens a modal."
+        },
+        {
+          "old": "global dot headings and compact text defaults",
+          "new": "sans headings; explicit ui-display; productive tools and editorial reports",
+          "note": "Review real screens and preserve intentional display titles. Reports use a reading measure and separate print typography."
+        }
+      ],
+      "codemod": "See docs/migrations/0.9-to-0.10.md. Changes require consumer lifecycle and visual review; no blanket replacement is safe."
+    },
+    {
+      "from": "0.10",
+      "to": "0.11",
+      "summary": "Readable supporting typography and container-aware evidence layouts.",
+      "safe": [],
+      "manual": [
+        {
+          "old": "viewport-based figure/report layouts",
+          "new": "container-aware figure, decision-grid and actions layouts; intrinsic two-up comparisons",
+          "note": "Keep the documented wrappers, verify narrow parents on wide screens and review print. New inline-size containment can change intrinsic sizing."
+        },
+        {
+          "old": "uppercase mono explanatory labels and unconstrained superscript citations",
+          "new": "sentence-case sans supporting text and a citation size floor",
+          "note": "Review explicit consumer overrides by role, preserving intentional display and technical identifiers."
+        }
+      ],
+      "codemod": "No automatic rewrite: review complete consumer tasks and docs/migrations/0.10-to-0.11.md."
     }
   ]
 }

package/README.md

@@ -19,11 +19,17 @@ app shells, navigation, forms, tables, feedback, overlays, prose, motion, and
 the token system that lets apps feel related without sharing a component runtime.
 
 The look is deliberately restrained: a mostly neutral canvas, one core accent
-for emphasis, dot-matrix display type, and hairline borders. Status colors,
+for emphasis, selective dot-matrix display type, and restrained borders. Status colors,
 display-expression tokens, and data-viz colors are separate governed tiers, not
 extra brand accents. Opt-in skins re-point the root accent; Mermaid, D2, and
 Vega bridges use resolved renderer theme data instead of live CSS variables.
 
+Everyday tools use readable sans typography and sentence-case labels. Reports
+use a separate reading measure and print treatment. Use `ui-display` when a
+large title should carry the dot-matrix signature; ordinary headings stay quiet.
+[Composition recipes](docs/compositions.md) show a service overview, a narrow
+inspector, and a decision report with their imports and acceptance checks.
+
 ## Start here
 
 - **Building an app or service shell?** Use the quick start below, then the
@@ -63,6 +69,12 @@ specificity fight. Print and reduced-motion rules still use `!important`
 deliberately where the framework must neutralize animation or layout at a media
 boundary.
 
+One production consumer is **[Sense6](https://sense6.net/en/)**, a privacy-first
+browser perception lab. Its static multilingual discovery pages and interactive
+colour, reaction-time, hearing, and visual-detail experiments use Bronto's
+shared shell, accessible controls, responsive layout, themes, and print rules
+while keeping the experiment-specific visual identity in the application.
+
 It ships a complete, accessible **standard component set** because that is the
 identity layer every service consumes. Its sharper edge is the opt-in **tooling,
 analytical, and communication layer** sketched above. The line that holds it
@@ -81,7 +93,7 @@ Or drop it in with no build step, straight from a CDN (replace the version only
 when deliberately upgrading across a breaking pre-1.0 minor):
 
 ```html
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.9.0/dist/bronto.css">
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.11.0/dist/bronto.css">
 ```
 
 ## Quick start
@@ -191,10 +203,9 @@ Not an afterthought — a gate. Every contractual token pairing has a declared W
 The CSS is the framework, so it works with React, Svelte/SvelteKit, Astro, Vue,
 Solid, Qwik or plain HTML — there's no component runtime to adopt. The optional
 `classes` and framework-neutral `behaviors` entrypoints pull in **no** UI
-framework and are SSR-safe. The React, Solid, Qwik, Svelte, and Vue lifecycle
-adapter subpaths remain compatible in 0.7 but are deprecated for removal no
-earlier than 0.8; initialize vanilla behaviors in the framework's ordinary
-mount/cleanup lifecycle instead.
+framework and are SSR-safe. Framework consumers initialize vanilla behaviors in their normal mount/cleanup
+lifecycle. The unadopted framework adapters were removed in 0.10; see the
+[migration guide](docs/migrations/0.9-to-0.10.md).
 
 Per-framework getting-started guides + runnable example apps live in the repo:
 
@@ -203,10 +214,7 @@ Per-framework getting-started guides + runnable example apps live in the repo:
 | Vanilla / Vite / plain HTML | [vanilla.md](https://github.com/Ponchia/bronto-ui/blob/main/docs/getting-started/vanilla.md) | [`examples/vanilla-vite`](https://github.com/Ponchia/bronto-ui/tree/main/examples/vanilla-vite) |
 | Astro | [astro.md](https://github.com/Ponchia/bronto-ui/blob/main/docs/getting-started/astro.md) | [`examples/astro`](https://github.com/Ponchia/bronto-ui/tree/main/examples/astro) |
 | SvelteKit | [sveltekit.md](https://github.com/Ponchia/bronto-ui/blob/main/docs/getting-started/sveltekit.md) | [`examples/sveltekit`](https://github.com/Ponchia/bronto-ui/tree/main/examples/sveltekit) |
-| Vue | [vue.md](https://github.com/Ponchia/bronto-ui/blob/main/docs/getting-started/vue.md) | [`examples/vue-vite`](https://github.com/Ponchia/bronto-ui/tree/main/examples/vue-vite) |
 | React | [react-solid.md](https://github.com/Ponchia/bronto-ui/blob/main/docs/getting-started/react-solid.md) | [`examples/react-vite`](https://github.com/Ponchia/bronto-ui/tree/main/examples/react-vite) |
-| Solid | [react-solid.md](https://github.com/Ponchia/bronto-ui/blob/main/docs/getting-started/react-solid.md) | [`examples/solid-vite`](https://github.com/Ponchia/bronto-ui/tree/main/examples/solid-vite) |
-| Qwik | [react-solid.md](https://github.com/Ponchia/bronto-ui/blob/main/docs/getting-started/react-solid.md) | [`examples/qwik-vite`](https://github.com/Ponchia/bronto-ui/tree/main/examples/qwik-vite) |
 | Tailwind v4 bridge / cascade-layer interop | [tailwind.md](https://github.com/Ponchia/bronto-ui/blob/main/docs/interop/tailwind.md) | [`examples/tailwind-vite`](https://github.com/Ponchia/bronto-ui/tree/main/examples/tailwind-vite) |
 
 ## Extras

package/behaviors/index.d.ts

@@ -2,7 +2,6 @@ export { dismissible } from "./dismissible.js";
 export { initDisabledGuard } from "./inert.js";
 export { initTabs } from "./tabs.js";
 export { initDialog } from "./dialog.js";
-export { initModal } from "./modal.js";
 export { toast } from "./toast.js";
 export { initDisclosure } from "./disclosure.js";
 export { initMenu } from "./menu.js";
@@ -25,7 +24,6 @@ export type ThemeStorageOpts = import("./theme.js").ThemeStorageOpts;
 export type ApplyThemeOpts = import("./theme.js").ApplyThemeOpts;
 export type ThemeChangeDetail = import("./theme.js").ThemeChangeDetail;
 export type ToastOpts = import("./toast.js").ToastOpts;
-export type ModalCloseDetail = import("./modal.js").ModalCloseDetail;
 export type LegendToggleDetail = import("./legend.js").LegendToggleDetail;
 export type CrosshairMoveDetail = import("./crosshair.js").CrosshairMoveDetail;
 export type CommandSelectDetail = import("./command.js").CommandSelectDetail;

package/behaviors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;sBAmBa,OAAO,eAAe,EAAE,OAAO;2BAC/B,OAAO,eAAe,EAAE,YAAY;+BACpC,OAAO,YAAY,EAAE,gBAAgB;6BACrC,OAAO,YAAY,EAAE,cAAc;gCACnC,OAAO,YAAY,EAAE,iBAAiB;wBACtC,OAAO,YAAY,EAAE,SAAS;+BAC9B,OAAO,YAAY,EAAE,gBAAgB;iCACrC,OAAO,aAAa,EAAE,kBAAkB;kCACxC,OAAO,gBAAgB,EAAE,mBAAmB;kCAC5C,OAAO,cAAc,EAAE,mBAAmB;gCAC1C,OAAO,cAAc,EAAE,iBAAiB;mCACxC,OAAO,eAAe,EAAE,oBAAoB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;sBAmBa,OAAO,eAAe,EAAE,OAAO;2BAC/B,OAAO,eAAe,EAAE,YAAY;+BACpC,OAAO,YAAY,EAAE,gBAAgB;6BACrC,OAAO,YAAY,EAAE,cAAc;gCACnC,OAAO,YAAY,EAAE,iBAAiB;wBACtC,OAAO,YAAY,EAAE,SAAS;iCAC9B,OAAO,aAAa,EAAE,kBAAkB;kCACxC,OAAO,gBAAgB,EAAE,mBAAmB;kCAC5C,OAAO,cAAc,EAAE,mBAAmB;gCAC1C,OAAO,cAAc,EAAE,iBAAiB;mCACxC,OAAO,eAAe,EAAE,oBAAoB"}

package/behaviors/index.js

@@ -23,7 +23,6 @@
  * @typedef {import('./theme.js').ApplyThemeOpts} ApplyThemeOpts
  * @typedef {import('./theme.js').ThemeChangeDetail} ThemeChangeDetail
  * @typedef {import('./toast.js').ToastOpts} ToastOpts
- * @typedef {import('./modal.js').ModalCloseDetail} ModalCloseDetail
  * @typedef {import('./legend.js').LegendToggleDetail} LegendToggleDetail
  * @typedef {import('./crosshair.js').CrosshairMoveDetail} CrosshairMoveDetail
  * @typedef {import('./command.js').CommandSelectDetail} CommandSelectDetail
@@ -35,7 +34,6 @@ export { dismissible } from './dismissible.js';
 export { initDisabledGuard } from './inert.js';
 export { initTabs } from './tabs.js';
 export { initDialog } from './dialog.js';
-export { initModal } from './modal.js';
 export { toast } from './toast.js';
 export { initDisclosure } from './disclosure.js';
 export { initMenu } from './menu.js';

package/behaviors/popover.js

@@ -90,9 +90,9 @@ export function initPopover({ root } = {}) {
       return;
     }
 
-    // A panel portaled out of a controlled modal starts in the trapped
-    // background. Wait for initModal to admit that specific panel instead of
-    // guessing how many microtasks its MutationObserver reconciliation needs.
+    // A host may temporarily keep a portaled panel inert. Wait until it
+    // admits this panel rather than guessing how many microtasks the host
+    // needs to reconcile its interaction state.
     const Observer = view?.MutationObserver;
     if (!Observer) {
       queueMicrotask(() => {
@@ -234,7 +234,7 @@ export function initPopover({ root } = {}) {
     // the browser's close-request then finds the dialog as the new topmost
     // element and dismisses it too. preventDefault() stops that native
     // close-request and stopPropagation() keeps it off other delegated keydown
-    // listeners (e.g. initModal's), so only the popover closes — the documented
+    // listeners owned by the host, so only the popover closes — the documented
     // "popover + dialog open together" contract.
     e.preventDefault();
     e.stopPropagation();

package/classes/classes.json

@@ -1,8 +1,8 @@
 {
   "$comment": "@ponchia/ui class vocabulary as language-neutral data — validate emitted markup without executing the ESM cls map or parsing the .d.ts. Generated from classes/index.js — do not edit by hand; run `npm run classes:json:build`. Drift-checked in CI. `groups[].base` is null for a parts-only namespace (no standalone base class — do NOT emit it). A modifier whose name contains `__` (e.g. `ui-spark__bar--pos`) attaches to THAT part, not the base host. `states` is the author-applied `is-*` hooks (runtime/behavior-managed hooks are excluded); `behaviorAttributes` are the `data-bronto-*` wiring hooks the optional behaviors delegate on; `requiredAria` is the role/aria a generator must emit per component. `states` + `customProperties` are documented in docs/reference.md and ship outside `cls` by design.",
   "counts": {
-    "classes": 677,
-    "groups": 184
+    "classes": 695,
+    "groups": 187
   },
   "groups": {
     "ui-accordion": {
@@ -295,7 +295,8 @@
     "ui-chip": {
       "base": "ui-chip",
       "modifiers": [
-        "ui-chip--accent"
+        "ui-chip--accent",
+        "ui-chip--dense"
       ],
       "parts": []
     },
@@ -464,6 +465,23 @@
         "ui-diff__row"
       ]
     },
+    "ui-discussion": {
+      "base": "ui-discussion",
+      "modifiers": [],
+      "parts": [
+        "ui-discussion__actions",
+        "ui-discussion__composer",
+        "ui-discussion__header",
+        "ui-discussion__hint",
+        "ui-discussion__item",
+        "ui-discussion__list",
+        "ui-discussion__message",
+        "ui-discussion__messages",
+        "ui-discussion__meta",
+        "ui-discussion__quote",
+        "ui-discussion__state"
+      ]
+    },
     "ui-display": {
       "base": "ui-display",
       "modifiers": [],
@@ -1167,6 +1185,11 @@
         "ui-severity-row__title"
       ]
     },
+    "ui-severity-tone": {
+      "base": "ui-severity-tone",
+      "modifiers": [],
+      "parts": []
+    },
     "ui-shortcut": {
       "base": "ui-shortcut",
       "modifiers": [],
@@ -1457,6 +1480,15 @@
         "ui-timeline__time"
       ]
     },
+    "ui-timestrip": {
+      "base": "ui-timestrip",
+      "modifiers": [],
+      "parts": [
+        "ui-timestrip__axis",
+        "ui-timestrip__event",
+        "ui-timestrip__now"
+      ]
+    },
     "ui-toast": {
       "base": "ui-toast",
       "modifiers": [
@@ -1697,6 +1729,7 @@
     "ui-check",
     "ui-chip",
     "ui-chip--accent",
+    "ui-chip--dense",
     "ui-citation",
     "ui-citation--chip",
     "ui-claim",
@@ -1783,6 +1816,18 @@
     "ui-diff__row--add",
     "ui-diff__row--context",
     "ui-diff__row--remove",
+    "ui-discussion",
+    "ui-discussion__actions",
+    "ui-discussion__composer",
+    "ui-discussion__header",
+    "ui-discussion__hint",
+    "ui-discussion__item",
+    "ui-discussion__list",
+    "ui-discussion__message",
+    "ui-discussion__messages",
+    "ui-discussion__meta",
+    "ui-discussion__quote",
+    "ui-discussion__state",
     "ui-display",
     "ui-divider",
     "ui-dot",
@@ -2086,6 +2131,7 @@
     "ui-severity-row",
     "ui-severity-row__meta",
     "ui-severity-row__title",
+    "ui-severity-tone",
     "ui-shortcut",
     "ui-shortcut__sep",
     "ui-sidebar",
@@ -2194,6 +2240,10 @@
     "ui-timeline",
     "ui-timeline__item",
     "ui-timeline__time",
+    "ui-timestrip",
+    "ui-timestrip__axis",
+    "ui-timestrip__event",
+    "ui-timestrip__now",
     "ui-toast",
     "ui-toast--accent",
     "ui-toast--danger",
@@ -2824,12 +2874,6 @@
       "behavior": "initDialog",
       "note": "opt into backdrop light-dismiss (click the backdrop to close)"
     },
-    {
-      "name": "data-bronto-modal",
-      "on": "a controlled (non-<dialog>) .ui-modal overlay",
-      "behavior": "initModal",
-      "note": "inert focus-trap, focus-return, and Escape close signal for a consumer-owned .is-open modal; needs an accessible name"
-    },
     {
       "name": "data-bronto-menu",
       "on": "a native <details> dropdown",

package/classes/index.d.ts

@@ -51,6 +51,7 @@ export declare const cls: {
   readonly badgeDot: 'ui-badge--dot';
   readonly chip: 'ui-chip';
   readonly chipAccent: 'ui-chip--accent';
+  readonly chipDense: 'ui-chip--dense';
   readonly link: 'ui-link';
   readonly linkArrow: 'ui-link--arrow';
   readonly linkCta: 'ui-link--cta';
@@ -381,6 +382,18 @@ export declare const cls: {
   readonly legendTrack: 'ui-legend__track';
   readonly legendTicks: 'ui-legend__ticks';
   readonly legendTick: 'ui-legend__tick';
+  readonly discussion: 'ui-discussion';
+  readonly discussionHeader: 'ui-discussion__header';
+  readonly discussionActions: 'ui-discussion__actions';
+  readonly discussionQuote: 'ui-discussion__quote';
+  readonly discussionMessages: 'ui-discussion__messages';
+  readonly discussionList: 'ui-discussion__list';
+  readonly discussionMessage: 'ui-discussion__message';
+  readonly discussionMeta: 'ui-discussion__meta';
+  readonly discussionHint: 'ui-discussion__hint';
+  readonly discussionState: 'ui-discussion__state';
+  readonly discussionItem: 'ui-discussion__item';
+  readonly discussionComposer: 'ui-discussion__composer';
   readonly annotation: 'ui-annotation';
   readonly annotationSubject: 'ui-annotation__subject';
   readonly annotationConnector: 'ui-annotation__connector';
@@ -579,6 +592,11 @@ export declare const cls: {
   readonly severityRow: 'ui-severity-row';
   readonly severityRowTitle: 'ui-severity-row__title';
   readonly severityRowMeta: 'ui-severity-row__meta';
+  readonly severityTone: 'ui-severity-tone';
+  readonly timestrip: 'ui-timestrip';
+  readonly timestripAxis: 'ui-timestrip__axis';
+  readonly timestripNow: 'ui-timestrip__now';
+  readonly timestripEvent: 'ui-timestrip__event';
   readonly generated: 'ui-generated';
   readonly generatedLabel: 'ui-generated__label';
   readonly originLabel: 'ui-origin-label';
@@ -742,6 +760,7 @@ export interface ClaimOpts {
 }
 export interface ChipOpts {
   accent?: boolean;
+  dense?: boolean;
 }
 export interface LinkOpts {
   arrow?: boolean;
@@ -794,8 +813,6 @@ export interface DotbarOpts {
 }
 export interface ModalOpts {
   drawer?: boolean;
-  /** Controlled non-dialog usage — adds only the is-open state; pair with initModal for focus management. */
-  open?: boolean;
 }
 export interface TabOpts {
   active?: boolean;
@@ -1014,7 +1031,7 @@ export type SeverityLevel = (typeof SEVERITY_LEVELS)[number];
  *  `'unknown'`, which paints the neutral tone. */
 export declare function severity(
   level: SeverityLevel | (string & {}) | null | undefined,
-  opts?: { part?: 'chip' | 'dot' | 'row' },
+  opts?: { part?: 'chip' | 'dot' | 'row' | 'tone' },
 ): { class: string; 'data-level': string };
 
 /** Min/max for the value-bearing fills; defaults to 0–100. */