@ponchia/ui 0.6.10 → 0.6.12

package/CHANGELOG.md

@@ -5,6 +5,114 @@
 |> `^0` / `*` wildcard does **not** protect you. See README → Versioning, and
 |> the deprecation policy in CONTRIBUTING.md.
 
+## 0.6.12 — 2026-07-10
+
+A stabilization patch. It changes no public class, token name, behavior name,
+or package path.
+
+### Changed
+
+- **Small-text readability.** The `--text-2xs` value increases from `0.68rem`
+  to `0.72rem`. This raises the floor for form labels, table headings,
+  provenance metadata, report captions, and other dense secondary text without
+  changing the type scale's public names or the default CSS payload size.
+- **1.0 stabilization mode.** Public catalog growth is frozen while real
+  consumers move onto one current minor. The stability guide now distinguishes
+  downstream-proven surfaces from package-only proof and unproven 1.0
+  candidates. New public surface needs explicit maintainer approval to reopen
+  the catalog.
+
+### Fixed
+
+- **Controlled-modal ownership.** `initModal()` now reconciles one stack per
+  document instead of letting each modal own `inert` independently. Sibling
+  portal modals no longer inert the active top modal, nested stacks restore the
+  previous modal correctly, late-added background nodes join the trap, and a
+  popover opened from the top modal remains interactive when its panel is
+  portaled elsewhere. Cleanup still preserves author-owned `inert` state.
+- **Maintainer documentation.** The architecture map now identifies
+  `css/generated.css` as authored trust-surface CSS, and the roadmap reflects
+  the current release and WOFF2 font payload.
+
+### Verified
+
+- Focused unit coverage exercises sibling and nested modal stacks, portaled
+  popovers, late background nodes, focus restoration, and cleanup ownership.
+  The non-pixel browser suite carries the same sibling-stack, portal, and
+  late-node scenario.
+
+## 0.6.11 — 2026-07-04
+
+A correctness, accessibility, and performance release drawn from a multi-pass
+review of the behavior layer and docs. No default-bundle contract change, no
+public class/token/subpath renames, and the CSS payload is unchanged — this is a
+non-breaking patch. Every change landed through PR CI, including the aggregate
+`check` gate and cross-engine (Chromium/Firefox/WebKit) end-to-end coverage.
+
+### Added
+
+- **Localization hooks for behavior-authored text.** New opt-in attributes let
+  hosts localize the strings behaviors set on enhanced elements —
+  `data-bronto-carousel-roledescription` and
+  `data-bronto-carousel-slide-roledescription` for carousel/slide
+  `aria-roledescription`, plus localized error-summary title, toast dismiss
+  label, combobox, command, and table hooks. Absent an override, the existing
+  English defaults are preserved, and any author-provided value now wins over the
+  behavior's default.
+- **Root type resolution for `import '@ponchia/ui'`.** The package root now
+  advertises a types condition (`index.d.ts`) so TypeScript consumers importing
+  the CSS entry resolve types without reaching for a subpath.
+- **Concepts guide.** `docs/concepts.md` is a new canonical mental-model page
+  that consolidates the load-bearing concepts (CSS-first, the cooperative
+  `@layer bronto` override model, the tiered color model, primitive ownership,
+  identity-vs-inventory bundling, token projections, and the package-path
+  contract) that were previously scattered across many pages.
+
+### Fixed
+
+- **Focus management.** `focusInto()` now skips hidden, `inert`, disabled, and
+  non-rendered candidates instead of parking focus on them; the tablist roving
+  set excludes hidden/disabled tabs so keyboard focus can always enter it; and a
+  closed controlled (non-`<dialog>`) modal is hidden while closed, so its
+  controls are no longer reachable by Tab.
+- **Screen-reader announcements.** The assertive toast stack no longer
+  re-announces earlier toasts when a new one arrives; the command palette's empty
+  state is a polite live region; the combobox listbox now mirrors the input's
+  accessible name (via `aria-labelledby`/`title`); and toast/command/combobox
+  ARIA added at init is fully restored on cleanup.
+- **Internationalization.** Combobox, command, and table filtering/sorting are
+  locale-aware, and a Unicode minus in `data-sort-value` (e.g. `−3,5`) now parses
+  correctly instead of sorting as `-35`.
+- **Connector resilience and scoping.** A malformed enum on one connector no
+  longer aborts its siblings, and a scoped connector can no longer resolve an
+  endpoint to a same-id element outside its root.
+- **Attribute parsing.** Splitter ARIA-range values are parsed strictly and
+  rewritten to a canonical numeric form; splitter/glyph enum values and the
+  dismissible target selector are trimmed, so trailing whitespace no longer
+  changes behavior.
+- **Theme following the OS.** When no explicit theme is set, an OS
+  `prefers-color-scheme` change now updates the theme toggle's `aria-pressed`,
+  and the render-blocking no-flash snippets in the integration and framework
+  guides validate the stored value is `light` or `dark` before applying it.
+
+### Performance
+
+- **Behavior hot paths.** Connector redraw caches its records and endpoint map
+  per init and batches scroll/resize/observer redraws through one animation
+  frame; source backrefs build one island-scoped id map instead of rescanning
+  per citation; the crosshair caches layout reads across `pointermove`; the table
+  text sort decorates rows once instead of parsing inside the comparator; and a
+  genuine user scroll during a carousel's programmatic-scroll suppression is now
+  replayed instead of dropped. Observable behavior is unchanged.
+
+### Verified
+
+- PR CI passed for every change, including the aggregate `check` gate,
+  cross-engine e2e, CodeQL, and the packed examples matrix. The default bundle
+  and its size are unchanged; this release adds optional localization hooks, root
+  type resolution, and documentation, and fixes accessibility, correctness, and
+  performance defects without moving the public contract.
+
 ## 0.6.10 — 2026-06-23
 
 ### Added

package/README.md

@@ -3,26 +3,37 @@
 [![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)
-[![dist](https://img.shields.io/badge/dist-~88kB%20%2F%20~15kB%20gzip-informational)](https://github.com/Ponchia/bronto-ui/blob/main/scripts/check-dist.mjs)
+[![default CSS](https://img.shields.io/badge/default%20CSS-~89kB%20%2F%20~15kB%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)
 
-**A CSS-first identity and UI layer for services, tools, sites, and reports.** It
-works in plain HTML, every modern framework, and print/PDF, with no component
-runtime to adopt and zero runtime dependencies.
-
-The look is a deliberate stance: a neutral monochrome canvas with one rationed
-accent (colour signals, it never decorates), dot-matrix display type, and
-hairline borders — all re-skinnable from a single `--accent` knob (opt-in
-amber-CRT, phosphor-green, and e-ink colorways).
-
-The default bundle is the shared service identity: app shells, navigation,
-forms, tables, feedback, overlays, workflow surfaces, prose, motion and the
-token system that lets each app feel related without sharing a component
-runtime. On top of that it ships opt-in tooling/report layers — workbench panes,
-commands, system state, provenance, figure stages, annotations, legends,
-evidence highlights, intervals, data-viz tokens and a static/PDF report grammar.
+**A CSS-first identity layer for services, tools, and reports that need
+provenance.** It works in plain HTML, modern frameworks, and print/PDF, with no
+component runtime to adopt and zero runtime dependencies.
+
+The sharpest lane is report and tooling UI: static/PDF reports, evidence,
+provenance, system state, dense workbenches, and explanatory figures. The
+default CSS bundle stays the shared service identity, not the whole package:
+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,
+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.
+
+## Start here
+
+- **Building an app or service shell?** Use the quick start below, then the
+  framework guide for your stack.
+- **Building a report, audit, or provenance view?** Start with
+  [docs/reporting.md](docs/reporting.md) and
+  [docs/frontier-primitives.md](docs/frontier-primitives.md).
+- **Maintaining or integrating the package?** Read
+  [docs/architecture.md](docs/architecture.md),
+  [docs/stability.md](docs/stability.md), and `llms.txt`.
 
 ### [Live demo →](https://ponchia.github.io/bronto-ui/)  ·  [Service shell →](https://ponchia.github.io/bronto-ui/demo/service.html)  ·  [Static report →](https://ponchia.github.io/bronto-ui/demo/report-standalone.html)  ·  [Theme playground →](https://ponchia.github.io/bronto-ui/demo/theme-playground.html)
 
@@ -46,9 +57,11 @@ that genuinely need JS (theme persistence, dialogs, toasts, disclosure).
 
 The guiding principle is that **colour is rationed and structure carries
 meaning** — layout, type weight, and the hairline do the work before a hue does,
-and the accent is a spotlight, not a paint bucket. Because everything lives in a
-single `@layer bronto`, your own un-layered CSS overrides the framework with no
-specificity fight and no `!important`.
+and the accent is a spotlight, not a paint bucket. Because framework rules live
+in `@layer bronto`, ordinary un-layered consumer CSS overrides them without a
+specificity fight. Print and reduced-motion rules still use `!important`
+deliberately where the framework must neutralize animation or layout at a media
+boundary.
 
 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,
@@ -67,12 +80,12 @@ npm i @ponchia/ui
 Or drop it in with no build step, straight from a CDN:
 
 ```html
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.10/dist/bronto.css">
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.12/dist/bronto.css">
 ```
 
 ## Quick start
 
-**1. Load the CSS.** One flattened, minified bundle — the whole standard component set, one request (~88 kB raw / ~15 kB gzip):
+**1. Load the CSS.** One flattened, minified default CSS bundle — the standard component set, one request (~89 kB raw / ~15 kB gzip) — that is `dist/bronto.css`, not the whole package tarball:
 
 ```css
 @import '@ponchia/ui';            /* via a bundler */
@@ -85,7 +98,7 @@ Or drop it in with no build step, straight from a CDN:
 
 > Prefer source leaves through a bundler? Use `@import '@ponchia/ui/css'` (a thin `@import` fan-out) instead. Both resolve the Doto `@font-face` with relative URLs, so there's no `/fonts` path assumption.
 
-> The bundle is the standard component set. The opt-in analytical & report layers — `report.css`, `dataviz.css`, `figure.css`, `annotations.css`, `legend.css`, `interval.css`, `clamp.css`, `highlights.css`, and the rest — are **not** in `bronto.css`; link each one you need from `dist/css/`. For LLM-authored static reports see [docs/reporting.md](docs/reporting.md).
+> The size above is only `dist/bronto.css`. The opt-in analytical and report layers — `report.css`, `dataviz.css`, `figure.css`, `annotations.css`, `legend.css`, `interval.css`, `clamp.css`, `highlights.css`, and the rest — are **not** in the default CSS bundle; link each one you need from `dist/css/`. For LLM-authored static reports see [docs/reporting.md](docs/reporting.md).
 
 **2. Write markup with `ui-*` classes** (primary is the default button; modifiers are opt-in):
 
@@ -151,7 +164,7 @@ Full generated catalog of every class: **[docs/reference.md](https://github.com/
 
 ## Theming: one knob
 
-Everything accent-colored derives from a single `--accent` variable via `color-mix()`. Re-brand the entire app — both light and dark — with root-level, per-theme overrides:
+Core DOM accent surfaces derive from a single `--accent` variable via `color-mix()`. Re-brand the entire app — both light and dark — with root-level, per-theme overrides:
 
 ```css
 :root   { --accent: #2f6df6; }   /* whole app blue   */
@@ -162,11 +175,11 @@ derived family (`--accent-text`, `--accent-soft`, focus/dot/ramp tokens) is a
 root-level skin contract. Use the full per-theme recipe in
 [`docs/theming.md`](docs/theming.md) for production rebrands.
 
-Buttons, focus rings, dot motifs, accent borders and soft fills all follow automatically. Light/dark is `data-theme="light"` / `"dark"` on `<html>` (defaults to `prefers-color-scheme`); `data-density` and `data-contrast` give density and contrast presets. A full re-skin (radius, display face, dot density, surfaces) is a handful more token overrides — the default monochrome look is **one skin, not the architecture**.
+Buttons, focus rings, dot motifs, accent borders and soft fills follow the root accent automatically. Light/dark is `data-theme="light"` / `"dark"` on `<html>` (defaults to `prefers-color-scheme`); `data-density` and `data-contrast` give density and contrast presets. A full re-skin (radius, display face, dot density, surfaces) is a handful more token overrides, while status colours and data-viz colours remain their own governed tiers — the default monochrome look is **one skin, not the architecture**.
 
 **One system, many skins.** That the knob is real isn't a claim — it ships: drop in `@ponchia/ui/css/skins.css` and set `data-bronto-skin="amber-crt | phosphor-green | e-ink"` on `<html>` for a complete, contrast-gated recolour (the derived accent family, focus ring, dot-matrix and glyphs all follow). Colour is governed in **tiers** — neutral canvas · one accent · locked status · display expression · opt-in data-viz — so it always earns its place; the full constitution is **[ADR-0001](https://github.com/Ponchia/bronto-ui/blob/main/docs/adr/0001-color-system.md)**.
 
-> When you change `--accent`, contrast becomes yours: verify your hue in the **[theme playground](https://ponchia.github.io/bronto-ui/demo/theme-playground.html)** (it shows the derived family and computed WCAG ratios). Full contract: **[docs/theming.md](https://github.com/Ponchia/bronto-ui/blob/main/docs/theming.md)**.
+> When you change `--accent`, contrast becomes yours: verify your hue in the **[theme playground](https://ponchia.github.io/bronto-ui/demo/theme-playground.html)** (it shows the derived family and computed WCAG ratios). Mermaid, D2, and Vega helpers emit resolved theme data for those renderers; they do not live-reskin from a later CSS `--accent` override. Full contract: **[docs/theming.md](https://github.com/Ponchia/bronto-ui/blob/main/docs/theming.md)**.
 
 ## Accessibility
 

package/annotations/index.d.ts

@@ -12,52 +12,52 @@ export function noteTransform({ dx, dy, x, y, align, valign, width, height, }?:
  * @param {NotePlacementOptions} options
  * @returns {NotePlacement}
  */
-export function notePlacement({ x, y, width, height, bounds, padding, gap, preferred, inset, }?: NotePlacementOptions): NotePlacement;
+export function notePlacement(options: NotePlacementOptions): NotePlacement;
 /**
  * @param {CircleSubjectOptions} options
  * @returns {string}
  */
-export function circleSubjectPath({ radius }?: CircleSubjectOptions): string;
+export function circleSubjectPath(options: CircleSubjectOptions): string;
 /**
  * @param {RectSubjectOptions} options
  * @returns {string}
  */
-export function rectSubjectPath({ width, height, x, y, padding }?: RectSubjectOptions): string;
+export function rectSubjectPath(options: RectSubjectOptions): string;
 /**
  * @param {ThresholdOptions} options
  * @returns {string}
  */
-export function thresholdPath({ x1, y1, x2, y2 }?: ThresholdOptions): string;
+export function thresholdPath(options: ThresholdOptions): string;
 /**
  * @param {AxisThresholdOptions} options
  * @returns {string}
  */
-export function axisThresholdPath({ orientation, value, start, end }?: AxisThresholdOptions): string;
+export function axisThresholdPath(options: AxisThresholdOptions): string;
 /**
  * @param {BracketSubjectOptions} options
  * @returns {string}
  */
-export function bracketSubjectPath({ x1, y1, x2, y2, depth }?: BracketSubjectOptions): string;
+export function bracketSubjectPath(options: BracketSubjectOptions): string;
 /**
  * @param {BandSubjectOptions} options
  * @returns {string}
  */
-export function bandSubjectPath({ x, y, width, height, padding }?: BandSubjectOptions): string;
+export function bandSubjectPath(options: BandSubjectOptions): string;
 /**
  * @param {SlopeSubjectOptions} options
  * @returns {string}
  */
-export function slopeSubjectPath({ x1, y1, x2, y2 }?: SlopeSubjectOptions): string;
+export function slopeSubjectPath(options: SlopeSubjectOptions): string;
 /**
  * @param {ComparisonBraceOptions} options
  * @returns {string}
  */
-export function comparisonBracePath({ x1, y1, x2, y2, depth }?: ComparisonBraceOptions): string;
+export function comparisonBracePath(options: ComparisonBraceOptions): string;
 /**
  * @param {OutlierClusterOptions} options
  * @returns {string}
  */
-export function outlierClusterPath({ points, radius }?: OutlierClusterOptions): string;
+export function outlierClusterPath(options: OutlierClusterOptions): string;
 /**
  * @param {TimelineEventOptions} [options]
  * @returns {string}
@@ -72,27 +72,27 @@ export function evidenceMarkerPath({ x, y, width, height, padding }?: EvidenceMa
  * @param {ConnectorEndDotOptions} options
  * @returns {string}
  */
-export function connectorEndDot({ x, y, radius }?: ConnectorEndDotOptions): string;
+export function connectorEndDot(options: ConnectorEndDotOptions): string;
 /**
  * @param {ConnectorEndArrowOptions} options
  * @returns {string}
  */
-export function connectorEndArrow({ x1, y1, x2, y2, size, spread }?: ConnectorEndArrowOptions): string;
+export function connectorEndArrow(options: ConnectorEndArrowOptions): string;
 /**
  * @param {ConnectorOptions} opts
  * @returns {string}
  */
-export function connectorLine(opts?: ConnectorOptions): string;
+export function connectorLine(opts: ConnectorOptions): string;
 /**
  * @param {ConnectorOptions} opts
  * @returns {string}
  */
-export function connectorElbow(opts?: ConnectorOptions): string;
+export function connectorElbow(opts: ConnectorOptions): string;
 /**
  * @param {ConnectorOptions} opts
  * @returns {string}
  */
-export function connectorCurve(opts?: ConnectorOptions): string;
+export function connectorCurve(opts: ConnectorOptions): string;
 /**
  * @param {AnnotationPartsOptions} [opts]
  * @returns {AnnotationParts}

package/annotations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":"AA6SA;;;GAGG;AACH,+CAHW,OAAO,CAAC,eAAe,CAAC,GACtB,MAAM,CAIlB;AAED;;;GAGG;AACH,gFAHW,oBAAoB,GAClB,MAAM,CA0BlB;AAsCD;;;GAGG;AACH,uCAHW,oBAAoB,GAClB,aAAa,CA2DzB;AAED;;;GAGG;AACH,2CAHW,oBAAoB,GAClB,MAAM,CAKlB;AAED;;;GAGG;AACH,yCAHW,kBAAkB,GAChB,MAAM,CAalB;AAED;;;GAGG;AACH,uCAHW,gBAAgB,GACd,MAAM,CAOlB;AAED;;;GAGG;AACH,2CAHW,oBAAoB,GAClB,MAAM,CAUlB;AAED;;;GAGG;AACH,4CAHW,qBAAqB,GACnB,MAAM,CAYlB;AAED;;;GAGG;AACH,yCAHW,kBAAkB,GAChB,MAAM,CAKlB;AAED;;;GAGG;AACH,0CAHW,mBAAmB,GACjB,MAAM,CAKlB;AAED;;;GAGG;AACH,6CAHW,sBAAsB,GACpB,MAAM,CAsClB;AAED;;;GAGG;AACH,4CAHW,qBAAqB,GACnB,MAAM,CAWlB;AAED;;;GAGG;AACH,wDAHW,oBAAoB,GAClB,MAAM,CAUlB;AAED;;;GAGG;AACH,sEAHW,qBAAqB,GACnB,MAAM,CAclB;AAED;;;GAGG;AACH,yCAHW,sBAAsB,GACpB,MAAM,CAKlB;AAED;;;GAGG;AACH,2CAHW,wBAAwB,GACtB,MAAM,CASlB;AAED;;;GAGG;AACH,oCAHW,gBAAgB,GACd,MAAM,CAYlB;AAED;;;GAGG;AACH,qCAHW,gBAAgB,GACd,MAAM,CAgBlB;AAED;;;GAGG;AACH,qCAHW,gBAAgB,GACd,MAAM,CAYlB;AAkBD;;;GAGG;AACH,uCAHW,sBAAsB,GACpB,eAAe,CA4B3B;AAED;;;;;;;;;;;;;;GAcG;AACH,uCAJW,kBAAkB,EAAE,SACpB,sBAAsB,GACpB,MAAM,EAAE,CA+BpB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,oCAJW,eAAe,EAAE,SACjB,mBAAmB,GACjB,WAAW,EAAE,CAgCzB;8BApzBY;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE;+BACxB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;sCAC1B,SAAS,GAAG,OAAO,GAAG,OAAO;8BAC7B,OAAO,GAAG,QAAQ,GAAG,KAAK;+BAC1B,KAAK,GAAG,QAAQ,GAAG,QAAQ;8BAC3B,YAAY,GAAG,UAAU;gCACzB,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO;;UAG/B,QAAQ;YACR,MAAM;;;;UAIN,MAAM;WACN,MAAM;YACN,MAAM;;;;;+BAKP,aAAa,GAAG,WAAW;+BAE3B,gBAAgB,GAAG;IAAE,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE;;YAG9D,MAAM;;;WAGN,MAAM;YACN,MAAM;;;;;;;;QAQN,MAAM;QACN,MAAM;;;;;;SAMN,MAAM;;;QAGN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;;;;;;WAMN,MAAM;YACN,MAAM;;;;QAIN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;;;QAGN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;;;;YAIN,eAAe,EAAE;;;;;;;;;;;;;;qCAclB,eAAe,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;;;;QAKpC,MAAM;QACN,MAAM;;;;;;;;;;;;;;;;;;;;;WAkBN,MAAM;YACN,MAAM;;;;;WAKN,MAAM;YACN,MAAM;YACN,gBAAgB;;;;;;;;;;;;QAShB,MAAM;QACN,MAAM;WACN,eAAe;YACf,gBAAgB;eAChB,MAAM;;qCAEP,CACN,aAAa,GACb,WAAW,GACX,CAAC;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GAAG,gBAAgB,CAAC,GAC1C,CAAC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG,qBAAqB,CAAC,GAC7C,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,kBAAkB,CAAC,GACvC,CAAC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,mBAAmB,CAAC,GACzC,CAAC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG,sBAAsB,CAAC,GAC9C,CAAC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG,qBAAqB,CAAC,GAC7C,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CAAC,GACzC,CAAC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG,oBAAoB,CAAC,GAC7C,CAAC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG,qBAAqB,CAAC,CACjD;;;;;;;;;;eAWU,MAAM;aACN,MAAM;eACN,MAAM;UACN,MAAM;;;;;;SAGN,MAAM;;;;UACN,MAAM;;;;;;;;;;;;;;;;;;;;YAQN,eAAe;;;;UACf,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAYN,MAAM;OACN,MAAM;;;;YACN,eAAe;;;;;;;;OAEf,MAAM"}

package/annotations/index.js

@@ -377,17 +377,18 @@ function noteRect(x, y, width, height, placement) {
  * @param {NotePlacementOptions} options
  * @returns {NotePlacement}
  */
-export function notePlacement({
-  x = 0,
-  y = 0,
-  width,
-  height,
-  bounds,
-  padding = 8,
-  gap = 32,
-  preferred = 'right',
-  inset = 0,
-} = {}) {
+export function notePlacement(options) {
+  const {
+    x = 0,
+    y = 0,
+    width,
+    height,
+    bounds,
+    padding = 8,
+    gap = 32,
+    preferred = 'right',
+    inset = 0,
+  } = options ?? {};
   const anchorX = finite('x', x);
   const anchorY = finite('y', y);
   const w = dimension('width', width);
@@ -439,7 +440,8 @@ export function notePlacement({
  * @param {CircleSubjectOptions} options
  * @returns {string}
  */
-export function circleSubjectPath({ radius } = {}) {
+export function circleSubjectPath(options) {
+  const { radius } = options ?? {};
   return circlePathAt(0, 0, radius);
 }
 
@@ -447,7 +449,8 @@ export function circleSubjectPath({ radius } = {}) {
  * @param {RectSubjectOptions} options
  * @returns {string}
  */
-export function rectSubjectPath({ width, height, x, y, padding = 0 } = {}) {
+export function rectSubjectPath(options) {
+  const { width, height, x, y, padding = 0 } = options ?? {};
   const w = dimension('width', width);
   const h = dimension('height', height);
   const p = dimension('padding', padding);
@@ -463,7 +466,8 @@ export function rectSubjectPath({ width, height, x, y, padding = 0 } = {}) {
  * @param {ThresholdOptions} options
  * @returns {string}
  */
-export function thresholdPath({ x1 = 0, y1 = 0, x2, y2 } = {}) {
+export function thresholdPath(options) {
+  const { x1 = 0, y1 = 0, x2, y2 } = options ?? {};
   const start = { x: finite('x1', x1), y: finite('y1', y1) };
   const end = { x: finite('x2', x2), y: finite('y2', y2) };
   return linePath(start, end);
@@ -473,7 +477,8 @@ export function thresholdPath({ x1 = 0, y1 = 0, x2, y2 } = {}) {
  * @param {AxisThresholdOptions} options
  * @returns {string}
  */
-export function axisThresholdPath({ orientation = 'horizontal', value = 0, start = 0, end } = {}) {
+export function axisThresholdPath(options) {
+  const { orientation = 'horizontal', value = 0, start = 0, end } = options ?? {};
   const v = finite('value', value);
   const s = finite('start', start);
   const e = finite('end', end);
@@ -486,7 +491,8 @@ export function axisThresholdPath({ orientation = 'horizontal', value = 0, start
  * @param {BracketSubjectOptions} options
  * @returns {string}
  */
-export function bracketSubjectPath({ x1, y1, x2, y2, depth = 12 } = {}) {
+export function bracketSubjectPath(options) {
+  const { x1, y1, x2, y2, depth = 12 } = options ?? {};
   const start = { x: finite('x1', x1), y: finite('y1', y1) };
   const end = { x: finite('x2', x2), y: finite('y2', y2) };
   const d = finite('depth', depth);
@@ -501,7 +507,8 @@ export function bracketSubjectPath({ x1, y1, x2, y2, depth = 12 } = {}) {
  * @param {BandSubjectOptions} options
  * @returns {string}
  */
-export function bandSubjectPath({ x = 0, y = 0, width, height, padding = 0 } = {}) {
+export function bandSubjectPath(options) {
+  const { x = 0, y = 0, width, height, padding = 0 } = options ?? {};
   return rectSubjectPath({ x, y, width, height, padding });
 }
 
@@ -509,7 +516,8 @@ export function bandSubjectPath({ x = 0, y = 0, width, height, padding = 0 } = {
  * @param {SlopeSubjectOptions} options
  * @returns {string}
  */
-export function slopeSubjectPath({ x1, y1, x2, y2 } = {}) {
+export function slopeSubjectPath(options) {
+  const { x1, y1, x2, y2 } = options ?? {};
   return thresholdPath({ x1, y1, x2, y2 });
 }
 
@@ -517,7 +525,8 @@ export function slopeSubjectPath({ x1, y1, x2, y2 } = {}) {
  * @param {ComparisonBraceOptions} options
  * @returns {string}
  */
-export function comparisonBracePath({ x1, y1, x2, y2, depth = 14 } = {}) {
+export function comparisonBracePath(options) {
+  const { x1, y1, x2, y2, depth = 14 } = options ?? {};
   const start = { x: finite('x1', x1), y: finite('y1', y1) };
   const end = { x: finite('x2', x2), y: finite('y2', y2) };
   const d = finite('depth', depth);
@@ -558,7 +567,8 @@ export function comparisonBracePath({ x1, y1, x2, y2, depth = 14 } = {}) {
  * @param {OutlierClusterOptions} options
  * @returns {string}
  */
-export function outlierClusterPath({ points, radius = 6 } = {}) {
+export function outlierClusterPath(options) {
+  const { points, radius = 6 } = options ?? {};
   if (!Array.isArray(points)) throw new TypeError('points must be an array');
   return points
     .map((p, i) =>
@@ -604,7 +614,8 @@ export function evidenceMarkerPath({ x = 0, y = 0, width = 36, height = 36, padd
  * @param {ConnectorEndDotOptions} options
  * @returns {string}
  */
-export function connectorEndDot({ x, y, radius = 3 } = {}) {
+export function connectorEndDot(options) {
+  const { x, y, radius = 3 } = options ?? {};
   return dotMark({ x: finite('x', x), y: finite('y', y) }, radius);
 }
 
@@ -612,7 +623,8 @@ export function connectorEndDot({ x, y, radius = 3 } = {}) {
  * @param {ConnectorEndArrowOptions} options
  * @returns {string}
  */
-export function connectorEndArrow({ x1 = 0, y1 = 0, x2, y2, size = 8, spread = 0.32 } = {}) {
+export function connectorEndArrow(options) {
+  const { x1 = 0, y1 = 0, x2, y2, size = 8, spread = 0.32 } = options ?? {};
   const start = { x: finite('x1', x1), y: finite('y1', y1) };
   const end = { x: finite('x2', x2), y: finite('y2', y2) };
   const s = dimension('size', size);
@@ -624,10 +636,11 @@ export function connectorEndArrow({ x1 = 0, y1 = 0, x2, y2, size = 8, spread = 0
  * @param {ConnectorOptions} opts
  * @returns {string}
  */
-export function connectorLine(opts = {}) {
-  const { dx, dy } = validateOffset(opts);
+export function connectorLine(opts) {
+  const options = opts ?? {};
+  const { dx, dy } = validateOffset(options);
   if (dx === 0 && dy === 0) return '';
-  const start = connectorStart(dx, dy, opts.subject);
+  const start = connectorStart(dx, dy, options.subject);
   if (!start) return '';
   const end = { x: dx, y: dy };
   // Guard a trim that rounds onto the note anchor (straightPath has no guard).
@@ -639,10 +652,11 @@ export function connectorLine(opts = {}) {
  * @param {ConnectorOptions} opts
  * @returns {string}
  */
-export function connectorElbow(opts = {}) {
-  const { dx, dy } = validateOffset(opts);
+export function connectorElbow(opts) {
+  const options = opts ?? {};
+  const { dx, dy } = validateOffset(options);
   if (dx === 0 && dy === 0) return '';
-  const start = connectorStart(dx, dy, opts.subject);
+  const start = connectorStart(dx, dy, options.subject);
   if (!start) return '';
   const end = { x: dx, y: dy };
   if (samePoint(start, end)) return '';
@@ -651,17 +665,18 @@ export function connectorElbow(opts = {}) {
   // annotation leader and a node connector draw the same elbow. (The former
   // inline form turned by min(|dx|,|dy|), i.e. a 45° chamfer that read as a
   // diagonal stub, not an elbow — which the `stroke-linejoin` bevel assumes.)
-  return elbowPath(start, end, { mid: opts.mid });
+  return elbowPath(start, end, { mid: options.mid });
 }
 
 /**
  * @param {ConnectorOptions} opts
  * @returns {string}
  */
-export function connectorCurve(opts = {}) {
-  const { dx, dy } = validateOffset(opts);
+export function connectorCurve(opts) {
+  const options = opts ?? {};
+  const { dx, dy } = validateOffset(options);
   if (dx === 0 && dy === 0) return '';
-  const start = connectorStart(dx, dy, opts.subject);
+  const start = connectorStart(dx, dy, options.subject);
   if (!start) return '';
   const end = { x: dx, y: dy };
   if (samePoint(start, end)) return '';
@@ -706,8 +721,11 @@ export function annotationParts(opts = {}) {
   let subject = '';
 
   if (opts.subject != null) {
-    const build = SUBJECT_BUILDERS[opts.subject.type];
-    if (!build) throw new TypeError('unsupported subject.type');
+    const subjectType = opts.subject.type;
+    if (!Object.hasOwn(SUBJECT_BUILDERS, subjectType)) {
+      throw new TypeError('unsupported subject.type');
+    }
+    const build = SUBJECT_BUILDERS[subjectType];
     subject = build(opts.subject);
   }
 

package/behaviors/carousel.d.ts

@@ -10,7 +10,9 @@
  * `[data-bronto-carousel-prev]` / `[data-bronto-carousel-next]` controls,
  * a `.ui-carousel__thumbs` list of `.ui-carousel__thumb` buttons, and a
  * `.ui-carousel__status` counter slot. Add `data-bronto-carousel-loop` to
- * wrap at the ends, `data-bronto-carousel-label` to name the region.
+ * wrap at the ends, `data-bronto-carousel-label` to name the region, and
+ * `data-bronto-carousel-roledescription` to localize the default
+ * `aria-roledescription` when the viewport does not already carry one.
  *
  * A full-screen **lightbox** is the same markup inside a native
  * `<dialog class="ui-lightbox">` opened by {@link initDialog}: the
@@ -21,8 +23,10 @@
  * (button, key, thumbnail, or swipe). SSR-safe, idempotent per carousel;
  * returns a cleanup function.
  *
- * @param {import('./internal.js').DelegateOpts} [opts]
+ * @param {import('./internal.js').DelegateOpts & { roleDescription?: string }} [opts]
  * @returns {import('./internal.js').Cleanup}
  */
-export function initCarousel({ root }?: import("./internal.js").DelegateOpts): import("./internal.js").Cleanup;
+export function initCarousel({ root, roleDescription }?: import("./internal.js").DelegateOpts & {
+    roleDescription?: string;
+}): import("./internal.js").Cleanup;
 //# sourceMappingURL=carousel.d.ts.map

package/behaviors/carousel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"carousel.d.ts","sourceRoot":"","sources":["carousel.js"],"names":[],"mappings":"AA6HA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wCAHW,OAAO,eAAe,EAAE,YAAY,GAClC,OAAO,eAAe,EAAE,OAAO,CAsJ3C"}
+{"version":3,"file":"carousel.d.ts","sourceRoot":"","sources":["carousel.js"],"names":[],"mappings":"AAoNA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,yDAHW,OAAO,eAAe,EAAE,YAAY,GAAG;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACjE,OAAO,eAAe,EAAE,OAAO,CA+L3C"}