@ponchia/ui 0.8.1 → 0.10.0

package/CHANGELOG.md

@@ -5,6 +5,152 @@
 |> `^0` / `*` wildcard does **not** protect you. See README → Versioning, and
 |> the deprecation policy in CONTRIBUTING.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
+downstream workbench onto 0.8.1 and watching where adoption stalled.
+
+### Added
+
+- **`.ui-row` — the dense selectable row, in the default bundle.** Every
+  workbench grows a list of these: a search result, a file in an explorer, an
+  outline entry, a backlink, a commit. Bronto already had the shape and it was
+  imprisoned — `.ui-menu__item` was exactly it, minus the persistence — so a
+  consumer building an explorer either claimed to be a menu or wrote the row
+  again. The one that migrated had **63 families of it, about 1,200 lines**,
+  each re-deciding the selected state, the hover, the ellipsis and the coarse
+  floor.
+
+  `__title` is the part that truncates and `__meta` is the part that does not;
+  that asymmetry is the contract. Selection reads `aria-selected` /
+  `aria-current` — the attributes a host already sets for assistive tech — so
+  the visual state cannot disagree with the announced one. `--stacked` for a
+  row with a snippet, `--ruled` for a list that reads as one object.
+
+  Selection: use **`aria-current`** for a row that is merely the current one —
+  that is the common case and valid anywhere. `aria-selected` is only legal on a
+  role that accepts it (`option` in a `listbox`, or `row`/`tab`/`gridcell`/
+  `treeitem`); on a bare `<button>` it is invalid ARIA and axe rates it
+  *critical*. This release's own demo shipped that mistake, three a11y specs
+  went red, and a new unit gate now catches the same class of error in
+  milliseconds rather than twenty minutes of browser matrix.
+
+  `min-inline-size: 0` is on the row itself and is not optional: a row is
+  usually a flex or grid item, whose automatic minimum is its min-content width,
+  and `__title` is `white-space: nowrap` — so without it a long title stops the
+  row shrinking and pushes its container past the viewport instead of
+  truncating. The demo proved that at 320/360/390px before release.
+
+  It is in **core**, unusually for a new surface, because `.ui-menu__item` now
+  composes it and a core component cannot depend on an opt-in leaf. It also
+  earns the roadmap's stronger argument for a core addition on two counts:
+  universal application chrome, and it *reduces duplicated core markup*. A unit
+  proof asserts the menu item does not restate what the row says, so the two
+  cannot drift back apart.
+
+### Changed
+
+- **`.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 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.
+
+  **Migration:** add `ui-menu--dropdown` to an existing `ui-menu` inside a
+  `ui-menu-host`. Without it the surface renders in flow.
+
+### Fixed
+
+- **`data-density` claimed more than it does, and the guard could not tell.**
+  `docs/theming.md` said the preset applies "on any element". Measured: it
+  re-points the `--space-*` scale, so it reaches the ~40 components whose
+  padding is expressed in that scale and **none** of the rest — `ui-alert` and
+  `ui-menu__item` among them. The remaining paddings are tuned pairs like
+  `0.5rem 0.55rem` that a seven-step scale cannot express, so tokenising them
+  would change how they look at the default density; exactly one declaration in
+  the whole catalog mapped cleanly and was converted.
+
+  The docs now say which components respond and why the others cannot, and a
+  test pins the responding set. The previous guard checked that the preset
+  changed the token *family*, which is true and useless — it would have passed
+  with every component hardcoded. That is the third contract in three releases
+  whose gate validated the mechanism instead of the effect, after the 43.5px tap
+  floor and the shipped-docs list.
+
+### Notes
+
+- Bundle budget raised to 95,600 B / 16,400 B for `.ui-row` (+1,234 B raw /
+  +83 B gzip). The gzip cost is small because the new rules compress against the
+  menu rules they replaced.
+
 ## 0.8.1 — 2026-08-11
 
 A packaging fix, plus dependency hygiene. **No published CSS, token, class, or
@@ -69,7 +215,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
@@ -101,7 +247,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
@@ -1016,7 +1162,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,27 +6,84 @@
       "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": [
         {
           "old": "hero / project-* / post-card / essay-* / page-* / home-* / signal-panel / worklog-summary",
           "new": "the ui-* content layer",
-          "note": "Long-form content: .ui-prose / .ui-quote. Cards: .ui-card. Layout: .ui-grid / .ui-stack. Site chrome: the ui-site* shell. No 1:1 mapping — re-compose with the content primitives."
+          "note": "Long-form content: .ui-prose / .ui-quote. Cards: .ui-card. Layout: .ui-grid / .ui-stack. Site chrome: the ui-site* shell. No 1:1 mapping \u2014 re-compose with the content primitives."
         },
         {
           "old": "callout",
@@ -41,7 +98,7 @@
         {
           "old": "tag-list / tag",
           "new": "ui-tags / ui-tag",
-          "note": "Compact variant .tag-list--compact → .ui-tags--compact; verify accent-on-accent contrast (see CHANGELOG 0.3.0 a11y fix)."
+          "note": "Compact variant .tag-list--compact \u2192 .ui-tags--compact; verify accent-on-accent contrast (see CHANGELOG 0.3.0 a11y fix)."
         }
       ],
       "codemod": "See docs/migrations/0.2-to-0.3.md for a ready-to-run ripgrep+sed recipe covering the 'safe' rules."
@@ -54,7 +111,7 @@
       "manual": [
         {
           "old": "--orange / --orange-soft",
-          "new": "(removed — re-declare in a consumer :root override if referenced)",
+          "new": "(removed \u2014 re-declare in a consumer :root override if referenced)",
           "note": "Orphan token pair: defined in the token mirrors but referenced by no shipped component and documented nowhere, and untiered under the new colour model. Removed under the CONTRIBUTING 'provably-unreferenced surface' exception. If you used it: :root { --orange: #a85f32; --orange-soft: rgb(168 95 50 / 0.13); }"
         }
       ],
@@ -63,22 +120,31 @@
     {
       "from": "0.4",
       "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).",
+      "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`\u2192`accent` to match the annotation/connector tone vocabulary (`.ui-annotation--evidence` stays \u2014 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": [
         {
           "old": "ui.mark({ tone: 'evidence' }) / ui.bracketNote({ tone: 'evidence' })",
           "new": "tone: 'accent'",
-          "note": "The rationed-accent tone option on the mark/bracket-note recipes is now 'accent' (was 'evidence'), matching ui.connector/ui.annotation. Do NOT rewrite ui.annotation({ variant: 'evidence' }) or the 'evidence' subject marker — those are a marker shape, not a tone, and are unchanged."
+          "note": "The rationed-accent tone option on the mark/bracket-note recipes is now 'accent' (was 'evidence'), matching ui.connector/ui.annotation. Do NOT rewrite ui.annotation({ variant: 'evidence' }) or the 'evidence' subject marker \u2014 those are a marker shape, not a tone, and are unchanged."
         },
         {
           "old": "ui-chart__legend",
           "new": "ui-legend",
-          "note": "Also import '@ponchia/ui/css/legend.css' beside report.css, and wrap each entry's content as <li class=\"ui-legend__item\"> … <span class=\"ui-legend__label\">…</span>. The swatch's --chart-color/--chart-pattern inline contract is unchanged; the categorical --chart-N colour is also available via .ui-legend__swatch--N. See docs/legends.md."
+          "note": "Also import '@ponchia/ui/css/legend.css' beside report.css, and wrap each entry's content as <li class=\"ui-legend__item\"> \u2026 <span class=\"ui-legend__label\">\u2026</span>. The swatch's --chart-color/--chart-pattern inline contract is unchanged; the categorical --chart-N colour is also available via .ui-legend__swatch--N. See docs/legends.md."
         },
         {
           "old": "connectorEndArrow (annotations)",
@@ -91,16 +157,16 @@
     {
       "from": "0.5",
       "to": "0.6",
-      "summary": "Charting realignment. The local static bar-chart renderer (.ui-chart*) is removed — a chart needs scales + data binding, out of scope for the analytical layer. bronto is now a themeable target for Vega-Lite (@ponchia/ui/vega), the same tokens-as-data path as Mermaid/D2. The --chart-* data-viz palette, tokens/charts.json, and the .ui-legend layer are unchanged.",
+      "summary": "Charting realignment. The local static bar-chart renderer (.ui-chart*) is removed \u2014 a chart needs scales + data binding, out of scope for the analytical layer. bronto is now a themeable target for Vega-Lite (@ponchia/ui/vega), the same tokens-as-data path as Mermaid/D2. The --chart-* data-viz palette, tokens/charts.json, and the .ui-legend layer are unchanged.",
       "safe": [],
       "manual": [
         {
           "old": "ui-chart / ui-chart__plot / ui-chart__bar / ui-chart__label / ui-chart__track / ui-chart__fill / ui-chart__fallback / ui-chart__caption",
           "new": "a Vega-Lite chart themed with @ponchia/ui/vega, or a token-themed inline <svg>",
-          "note": "No 1:1 class mapping — the renderer is removed. For a real chart: import '@ponchia/ui/vega', pass brontoVegaConfig(theme) to vega-embed, and place the result in a <figure class=\"ui-report__figure\"> with a <figcaption class=\"ui-report__caption\"> and a <ul class=\"ui-legend\"> key (see docs/vega.md). For a frozen/print chart: hand-author an inline <svg> using the --chart-N palette tokens for fills. The --chart-value inline knob is gone; --chart-color/--chart-pattern remain on .ui-legend__swatch."
+          "note": "No 1:1 class mapping \u2014 the renderer is removed. For a real chart: import '@ponchia/ui/vega', pass brontoVegaConfig(theme) to vega-embed, and place the result in a <figure class=\"ui-report__figure\"> with a <figcaption class=\"ui-report__caption\"> and a <ul class=\"ui-legend\"> key (see docs/vega.md). For a frozen/print chart: hand-author an inline <svg> using the --chart-N palette tokens for fills. The --chart-value inline knob is gone; --chart-color/--chart-pattern remain on .ui-legend__swatch."
         }
       ],
-      "codemod": "No codemod — the .ui-chart* renderer has no replacement class. rg -l 'ui-chart\\\\b|ui-chart__' to find call sites, then rebuild each as a Vega-Lite chart (@ponchia/ui/vega) or a token-themed inline <svg>. See docs/vega.md."
+      "codemod": "No codemod \u2014 the .ui-chart* renderer has no replacement class. rg -l 'ui-chart\\\\b|ui-chart__' to find call sites, then rebuild each as a Vega-Lite chart (@ponchia/ui/vega) or a token-themed inline <svg>. See docs/vega.md."
     },
     {
       "from": "0.6",
@@ -115,6 +181,30 @@
         }
       ],
       "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."
     }
   ]
 }

package/README.md

@@ -3,7 +3,7 @@
 [![npm](https://img.shields.io/npm/v/@ponchia/ui?logo=npm)](https://www.npmjs.com/package/@ponchia/ui)
 [![npm provenance](https://img.shields.io/badge/npm-provenance-blue?logo=npm)](https://www.npmjs.com/package/@ponchia/ui#provenance)
 [![runtime deps](https://img.shields.io/badge/runtime%20deps-0-brightgreen)](https://github.com/Ponchia/bronto-ui/blob/main/package.json)
-[![default CSS](https://img.shields.io/badge/default%20CSS-~92kB%20%2F%20~16kB%20gzip-informational)](https://github.com/Ponchia/bronto-ui/blob/main/scripts/check-dist.mjs)
+[![default CSS](https://img.shields.io/badge/default%20CSS-~93kB%20%2F%20~16kB%20gzip-informational)](https://github.com/Ponchia/bronto-ui/blob/main/scripts/check-dist.mjs)
 [![CI](https://github.com/Ponchia/bronto-ui/actions/workflows/ci.yml/badge.svg)](https://github.com/Ponchia/bronto-ui/actions/workflows/ci.yml)
 [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/Ponchia/bronto-ui/badge)](https://scorecard.dev/viewer/?uri=github.com/Ponchia/bronto-ui)
 [![license: MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/Ponchia/bronto-ui/blob/main/LICENSE)
@@ -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,12 +93,12 @@ 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.8.1/dist/bronto.css">
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.10.0/dist/bronto.css">
 ```
 
 ## Quick start
 
-**1. Load the CSS.** One flattened, minified default CSS bundle — the standard component set, one request (~92 kB raw / ~16 kB gzip) — that is `dist/bronto.css`, not the whole package tarball:
+**1. Load the CSS.** One flattened, minified default CSS bundle — the standard component set, one request (~93 kB raw / ~16 kB gzip) — that is `dist/bronto.css`, not the whole package tarball:
 
 ```css
 @import '@ponchia/ui';            /* via a bundler */
@@ -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();