@ponchia/ui 0.6.0 → 0.6.4

package/CHANGELOG.md

@@ -1,9 +1,87 @@
 # Changelog
 
-> **Versioning:** pre-1.0, breaking changes ship in the _minor_. Pin to the
-> minor — `~0.4.0` (equivalently `^0.4.0`) resolves to `>=0.4.0 <0.5.0`; a bare
-> `^0` / `*` wildcard does **not** protect you. See README → Versioning, and
-> the deprecation policy in CONTRIBUTING.md.
+|> **Versioning:** pre-1.0, breaking changes ship in the _minor_. Pin to the
+|> minor — `~0.4.0` (equivalently `^0.4.0`) resolves to `>=0.4.0 <0.5.0`; a bare
+|> `^0` / `*` wildcard does **not** protect you. See README → Versioning, and
+|> the deprecation policy in CONTRIBUTING.md.
+
+## 0.6.4 — 2026-06-08
+
+Patch release for the dot-matrix expansion and static report hardening shipped
+in #116. No breaking changes, no `MIGRATIONS.json` entry.
+
+### Added
+
+- **Dot-matrix/glyph expansion** — adds the generated glyph metadata surface,
+  docs, and contract tests for the expanded dot/readout vocabulary.
+- **Report authoring guidance** — documents the static report grammar around
+  captions, alert bodies, table wrapping, and local/CDN asset handling.
+
+### Fixed
+
+- **Static report print/layout behavior** — hardens report print margins and
+  table wrapping so standalone HTML reports and PDF exports degrade more
+  predictably across long tokens and normal prose.
+
+## 0.6.3 — 2026-06-08
+
+Patch release to publish the WebKit release fix after the `v0.6.1` and `v0.6.2`
+tag runs failed before npm publish. No public API change, no class contract
+change, no `MIGRATIONS.json` entry.
+
+The 0.6.2 test-only diagnosis was incomplete: WebKit does not reliably honor
+the unprefixed `user-select: none` on the generated line-number affordances.
+The actual fix is CSS-side. `css/diff.css` and `css/code.css` now include the
+legacy `-webkit-user-select: none` declaration alongside the standard property,
+and the built `dist/css/diff.css` / `dist/css/code.css` leaves were regenerated.
+
+### Fixed
+
+- **Diff/code line numbers in WebKit** — `.ui-diff__ln`,
+  `.ui-diff__code::before`, and `.ui-code--numbered .ui-code__line::before`
+  now opt out of selection in WebKit as well as chromium/firefox.
+
+### Internal
+
+- **`test/e2e/diff.spec.mjs`** — reads the CSSOM `-webkit-user-select` value
+  before the standard property so the assertion verifies the prefixed WebKit
+  path directly.
+
+## 0.6.2 — 2026-06-07
+
+Release attempt: test-only WebKit e2e patch for the `0.6.1` publish blocker. The
+tag was cut but the release still did not publish. The diagnosis here was
+superseded by `0.6.3`, which fixes the CSS rule itself.
+
+### Internal
+
+- **`test/e2e/diff.spec.mjs`** — read `getComputedStyle(el).userSelect ||
+  getComputedStyle(el).webkitUserSelect` for the line-number
+  `user-select: none` assertion, so the test passes on WebKit (where
+  `userSelect` is `undefined` even when the standard CSS rule is
+  applied) as well as chromium + firefox.
+
+## 0.6.1 — 2026-06-07
+
+Dev-only patch: refreshes the SHA-pinned GitHub Actions used by CI
+([`actions/checkout`](https://github.com/actions/checkout) 6.0.2 → 6.0.3 —
+SHA-256 repository init fix, expanded SHA regex; and
+[`github/codeql-action`](https://github.com/github/codeql-action) 4.36.0 →
+4.36.2 — CLI version caching, exponential-backoff SARIF polling, CodeQL
+bundle 2.25.6) plus a small DevDeps bump ([react](https://github.com/facebook/react)
+/[react-dom](https://github.com/facebook/react) 19.2.6 → 19.2.7 — Server
+Components `FormData` fix; [stylelint](https://github.com/stylelint/stylelint)
+17.12.0 → 17.13.0). No public API, no published CSS/JS, no `MIGRATIONS.json`
+entry. All bumps were authored by Dependabot and landed through #109 + #110.
+
+### Internal
+
+- Bump the **actions** Dependabot group: `actions/checkout` 6.0.2 → 6.0.3 and
+  `github/codeql-action` 4.36.0 → 4.36.2 (CI only, SHA-pinned in
+  `.github/workflows/*.yml`).
+- Bump the **dev** Dependabot group: `react`/`react-dom` 19.2.6 → 19.2.7 and
+  `stylelint` 17.12.0 → 17.13.0 (devDependencies only — the package itself
+  ships zero runtime deps).
 
 ## 0.6.0 — 2026-06-03
 

package/README.md

@@ -41,7 +41,7 @@ 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`.
 
-It ships a complete, accessible **standard component set** — but that's not where it competes. Its differentiator is an opt-in **analytical & communication layer** for interfaces that make complex work legible: annotations, legends, connectors, marks, a guided-focus spotlight, lifecycle/system-state and source-provenance vocabularies, and a static/PDF report grammar. Each owns only its visual grammar and pure geometry — no chart engine, no state, no hit-testing. See **[docs/frontier-primitives.md](https://github.com/Ponchia/bronto-ui/blob/main/docs/frontier-primitives.md)** for the thesis.
+It ships a complete, accessible **standard component set**, but that's not where it competes — its differentiator is the opt-in **analytical & communication layer** sketched above. The line that holds it together: each primitive owns only its visual grammar and pure geometry — no chart engine, no state, no hit-testing. See **[docs/frontier-primitives.md](https://github.com/Ponchia/bronto-ui/blob/main/docs/frontier-primitives.md)** for the thesis.
 
 ## Install
 

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":"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"}

package/annotations/index.js

@@ -211,25 +211,19 @@ import {
   angleBetween,
   // Shared scalar/geometry kernel — single source of truth (was copy-pasted,
   // and the local clamp had silently diverged from the connectors one).
-  PRECISION,
+  roundNumber,
   finite,
   dimension,
   fmt,
   point,
   clamp,
+  rectPath,
 } from '../connectors/index.js';
 
-function roundedNumber(value) {
-  const rounded = Math.round((Object.is(value, -0) ? 0 : value) * PRECISION) / PRECISION;
-  return Object.is(rounded, -0) ? 0 : rounded;
-}
-
+// A circle subject is just a filled dot at (x, y) — delegate to the kernel's
+// dotMark so the arc geometry/precision can't diverge. (code-quality audit Q5.)
 function circlePathAt(x, y, radius) {
-  const r = dimension('radius', radius);
-  if (r === 0) return '';
-  return `M${point(x, y - r)}A${fmt(r)},${fmt(r)} 0 1 1 ${point(x, y + r)}A${fmt(r)},${fmt(
-    r,
-  )} 0 1 1 ${point(x, y - r)}Z`;
+  return dotMark({ x, y }, radius);
 }
 
 function samePoint(a, b) {
@@ -400,8 +394,8 @@ export function notePlacement({
     const rect = noteRect(anchorX, anchorY, w, h, placement);
     if (rect.left >= minX && rect.top >= minY && rect.right <= maxX && rect.bottom <= maxY) {
       return {
-        dx: roundedNumber(placement.dx),
-        dy: roundedNumber(placement.dy),
+        dx: roundNumber(placement.dx),
+        dy: roundNumber(placement.dy),
         align: placement.align,
         valign: placement.valign,
         transform: noteTransform({ ...placement, width: w, height: h }),
@@ -413,8 +407,8 @@ export function notePlacement({
   const rect = noteRect(anchorX, anchorY, w, h, fallback);
   const left = clamp(rect.left, minX, maxX - w);
   const top = clamp(rect.top, minY, maxY - h);
-  const dx = roundedNumber(left - anchorX);
-  const dy = roundedNumber(top - anchorY);
+  const dx = roundNumber(left - anchorX);
+  const dy = roundNumber(top - anchorY);
   return {
     dx,
     dy,
@@ -445,7 +439,7 @@ export function rectSubjectPath({ width, height, x, y, padding = 0 } = {}) {
   const top = finite('y', y, -h / 2) - p;
   const right = left + w + p * 2;
   const bottom = top + h + p * 2;
-  return `M${point(left, top)}H${fmt(right)}V${fmt(bottom)}H${fmt(left)}Z`;
+  return rectPath(left, top, right, bottom);
 }
 
 /**
@@ -586,7 +580,7 @@ export function evidenceMarkerPath({ x = 0, y = 0, width = 36, height = 36, padd
   const top = cy - h / 2 - p;
   const right = left + w + p * 2;
   const bottom = top + h + p * 2;
-  return `M${point(left, top)}H${fmt(right)}V${fmt(bottom)}H${fmt(left)}Z`;
+  return rectPath(left, top, right, bottom);
 }
 
 /**
@@ -658,6 +652,22 @@ export function connectorCurve(opts = {}) {
   return curvePath(start, end, { curvature: 0.35 });
 }
 
+// subject.type → its path builder. A flat dispatch table (replaces an 11-arm
+// if/else) keyed by the SubjectType union; an unknown type throws below. (Q10.)
+const SUBJECT_BUILDERS = {
+  circle: circleSubjectPath,
+  rect: rectSubjectPath,
+  threshold: thresholdPath,
+  bracket: bracketSubjectPath,
+  band: bandSubjectPath,
+  slope: slopeSubjectPath,
+  compare: comparisonBracePath,
+  cluster: outlierClusterPath,
+  axis: axisThresholdPath,
+  timeline: timelineEventPath,
+  evidence: evidenceMarkerPath,
+};
+
 /**
  * @param {AnnotationPartsOptions} [opts]
  * @returns {AnnotationParts}
@@ -678,18 +688,11 @@ export function annotationParts(opts = {}) {
   const note = noteTransform({ dx, dy });
   let subject = '';
 
-  if (opts.subject?.type === 'circle') subject = circleSubjectPath(opts.subject);
-  else if (opts.subject?.type === 'rect') subject = rectSubjectPath(opts.subject);
-  else if (opts.subject?.type === 'threshold') subject = thresholdPath(opts.subject);
-  else if (opts.subject?.type === 'bracket') subject = bracketSubjectPath(opts.subject);
-  else if (opts.subject?.type === 'band') subject = bandSubjectPath(opts.subject);
-  else if (opts.subject?.type === 'slope') subject = slopeSubjectPath(opts.subject);
-  else if (opts.subject?.type === 'compare') subject = comparisonBracePath(opts.subject);
-  else if (opts.subject?.type === 'cluster') subject = outlierClusterPath(opts.subject);
-  else if (opts.subject?.type === 'axis') subject = axisThresholdPath(opts.subject);
-  else if (opts.subject?.type === 'timeline') subject = timelineEventPath(opts.subject);
-  else if (opts.subject?.type === 'evidence') subject = evidenceMarkerPath(opts.subject);
-  else if (opts.subject != null) throw new TypeError('unsupported subject.type');
+  if (opts.subject != null) {
+    const build = SUBJECT_BUILDERS[opts.subject.type];
+    if (!build) throw new TypeError('unsupported subject.type');
+    subject = build(opts.subject);
+  }
 
   return { transform, subject, connector, note };
 }
@@ -736,7 +739,7 @@ export function declutterLabels(items, opts = {}) {
   }
 
   const out = new Array(nodes.length);
-  for (const n of nodes) out[n.index] = roundedNumber(n.pos);
+  for (const n of nodes) out[n.index] = roundNumber(n.pos);
   return out;
 }
 
@@ -782,9 +785,9 @@ export function directLabels(items, opts = {}) {
       ? ''
       : connectorPath({ from: a.anchor, to: labelPoint, shape });
     return {
-      x: roundedNumber(labelPoint.x),
-      y: roundedNumber(labelPoint.y),
-      anchor: { x: roundedNumber(a.anchor.x), y: roundedNumber(a.anchor.y) },
+      x: roundNumber(labelPoint.x),
+      y: roundNumber(labelPoint.y),
+      anchor: { x: roundNumber(a.anchor.x), y: roundNumber(a.anchor.y) },
       key: a.key,
       d,
     };

package/behaviors/carousel.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Image carousel / gallery, built on CSS scroll-snap so touch + trackpad
+ * swipe (and momentum) are the browser's, not hand-rolled. This wires the
+ * parts scroll-snap can't do alone: prev/next buttons, keyboard nav, a
+ * thumbnail strip, the position counter, and ARIA — keeping a JS index in
+ * sync with the scroll position both ways.
+ *
+ * Markup: `[data-bronto-carousel]` containing a `.ui-carousel__viewport`
+ * of `.ui-carousel__slide` children; optionally
+ * `[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.
+ *
+ * A full-screen **lightbox** is the same markup inside a native
+ * `<dialog class="ui-lightbox">` opened by {@link initDialog}: the
+ * `<dialog>` provides the top layer, focus-trap, Escape and focus-return,
+ * so this behavior never touches focus management.
+ *
+ * Emits `bronto:change` ({ detail: { index } }) on every index change
+ * (button, key, thumbnail, or swipe). SSR-safe, idempotent per carousel;
+ * returns a cleanup function.
+ *
+ * @param {import('./internal.js').DelegateOpts} [opts]
+ * @returns {import('./internal.js').Cleanup}
+ */
+export function initCarousel({ root }?: import("./internal.js").DelegateOpts): import("./internal.js").Cleanup;
+//# sourceMappingURL=carousel.d.ts.map

package/behaviors/carousel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"carousel.d.ts","sourceRoot":"","sources":["carousel.js"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wCAHW,OAAO,eAAe,EAAE,YAAY,GAClC,OAAO,eAAe,EAAE,OAAO,CAuK3C"}

package/behaviors/carousel.js

@@ -29,6 +29,9 @@ import {
  * Emits `bronto:change` ({ detail: { index } }) on every index change
  * (button, key, thumbnail, or swipe). SSR-safe, idempotent per carousel;
  * returns a cleanup function.
+ *
+ * @param {import('./internal.js').DelegateOpts} [opts]
+ * @returns {import('./internal.js').Cleanup}
  */
 export function initCarousel({ root } = {}) {
   if (!hasDom()) return noop;

package/behaviors/combobox.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Editable combobox with a filtered listbox popup, implementing the
+ * WAI-ARIA APG combobox pattern (the widget the framework most lacked
+ * and consumers most often build badly). Dependency-free, no
+ * positioning library — the list is CSS-anchored under the input.
+ *
+ * The input MUST have an accessible name — a `<label>`, `aria-label`, or
+ * `aria-labelledby` (a placeholder does not count). A nameless `role="combobox"`
+ * is a silent screen-reader failure, so the behavior warns at dev time when it
+ * finds one, and mirrors the input's name onto the listbox.
+ *
+ * Markup: `[data-bronto-combobox]` wrapping an `<input role="combobox">`
+ * (`.ui-combobox__input`) and a `<ul role="listbox">`
+ * (`.ui-combobox__list`) of `<li role="option">` (`.ui-combobox__option`,
+ * optional `data-value`). An optional `.ui-combobox__empty` (hidden at rest)
+ * shows when nothing matches. The behavior owns ids, `aria-expanded`,
+ * `aria-controls`, `aria-activedescendant`, roving active option,
+ * type-to-filter, full keyboard (Down/Up/Home/End/Enter/Escape/Tab),
+ * pointer select, and outside-click close. On select the **visible input shows
+ * the option's text label**, while the emitted `bronto:change` CustomEvent
+ * carries the option's `data-value` code: `{ detail: { value, label } }` (value
+ * falls back to the label when there is no `data-value`). SSR-safe, idempotent
+ * per instance; returns a cleanup function.
+ *
+ * Single-select APG deviations (intentional, for a filtering text combobox):
+ * ArrowDown on a CLOSED list opens + filters rather than pre-activating the
+ * first option, and Tab closes the list without committing the merely-highlighted
+ * option (only Enter/click commits). Both are safe for single-select.
+ *
+ * Options are read from the DOM at init; if you replace the listbox contents
+ * (e.g. async/remote results), either re-run initCombobox, or add
+ * `data-bronto-combobox-live` to the `[data-bronto-combobox]` host so a
+ * MutationObserver re-reads the options in place (opt-in — off by default so
+ * the common static case stays observer-free).
+ *
+ * @param {import('./internal.js').DelegateOpts} [opts]
+ * @returns {import('./internal.js').Cleanup}
+ */
+export function initCombobox({ root }?: import("./internal.js").DelegateOpts): import("./internal.js").Cleanup;
+//# sourceMappingURL=combobox.d.ts.map

package/behaviors/combobox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["combobox.js"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wCAHW,OAAO,eAAe,EAAE,YAAY,GAClC,OAAO,eAAe,EAAE,OAAO,CAqO3C"}

package/behaviors/combobox.js

@@ -23,17 +23,29 @@ import {
  * Markup: `[data-bronto-combobox]` wrapping an `<input role="combobox">`
  * (`.ui-combobox__input`) and a `<ul role="listbox">`
  * (`.ui-combobox__list`) of `<li role="option">` (`.ui-combobox__option`,
- * optional `data-value`). An optional `.ui-combobox__empty` shows when
- * nothing matches. The behavior owns ids, `aria-expanded`,
+ * optional `data-value`). An optional `.ui-combobox__empty` (hidden at rest)
+ * shows when nothing matches. The behavior owns ids, `aria-expanded`,
  * `aria-controls`, `aria-activedescendant`, roving active option,
  * type-to-filter, full keyboard (Down/Up/Home/End/Enter/Escape/Tab),
- * pointer select, and outside-click close; it emits a `bronto:change`
- * CustomEvent ({ detail: { value } }) on selection. SSR-safe,
- * idempotent per instance; returns a cleanup function.
+ * pointer select, and outside-click close. On select the **visible input shows
+ * the option's text label**, while the emitted `bronto:change` CustomEvent
+ * carries the option's `data-value` code: `{ detail: { value, label } }` (value
+ * falls back to the label when there is no `data-value`). SSR-safe, idempotent
+ * per instance; returns a cleanup function.
+ *
+ * Single-select APG deviations (intentional, for a filtering text combobox):
+ * ArrowDown on a CLOSED list opens + filters rather than pre-activating the
+ * first option, and Tab closes the list without committing the merely-highlighted
+ * option (only Enter/click commits). Both are safe for single-select.
  *
  * Options are read from the DOM at init; if you replace the listbox contents
- * (e.g. async/remote results) without re-initialising, filtering and keyboard
- * nav act on the stale nodes — re-run initCombobox after mutating the options.
+ * (e.g. async/remote results), either re-run initCombobox, or add
+ * `data-bronto-combobox-live` to the `[data-bronto-combobox]` host so a
+ * MutationObserver re-reads the options in place (opt-in — off by default so
+ * the common static case stays observer-free).
+ *
+ * @param {import('./internal.js').DelegateOpts} [opts]
+ * @returns {import('./internal.js').Cleanup}
  */
 export function initCombobox({ root } = {}) {
   if (!hasDom()) return noop;
@@ -47,21 +59,28 @@ export function initCombobox({ root } = {}) {
     const list = box.querySelector('[role="listbox"], .ui-combobox__list');
     if (!input || !list) continue;
     const empty = box.querySelector('.ui-combobox__empty');
-    const options = [...list.querySelectorAll('[role="option"], .ui-combobox__option')];
-
     const listId = list.id || (list.id = `bronto-cb-list-${nextFieldUid()}`);
-    options.forEach((o, i) => {
-      if (!o.id) o.id = `${listId}-opt-${i}`;
-      o.setAttribute('role', 'option');
-    });
+    // Re-readable so the opt-in MutationObserver (`data-bronto-combobox-live`)
+    // can pick up async/replaced option nodes without a full re-init. `visible`,
+    // `filter`, `move`, etc. close over this binding, so reassigning it is enough.
+    let options = [];
+    const syncOptions = () => {
+      options = [...list.querySelectorAll('[role="option"], .ui-combobox__option')];
+      options.forEach((o, i) => {
+        if (!o.id) o.id = `${listId}-opt-${i}`;
+        o.setAttribute('role', 'option');
+      });
+    };
+    syncOptions();
     list.setAttribute('role', 'listbox');
     // Give the listbox its own accessible name (a bare role=listbox is unnamed
-    // to a screen reader) by mirroring the input's name. (a11y review C30.)
+    // to a screen reader) by mirroring the input's REAL name. (a11y review C30.)
+    // The placeholder is deliberately NOT in this chain: the input warning below
+    // already rejects a placeholder as an inadequate name, so papering the
+    // listbox over with it would contradict that — if there's no real name the
+    // listbox stays unnamed and the warning is the signal. (component audit C28.)
     if (!list.hasAttribute('aria-label') && !list.hasAttribute('aria-labelledby')) {
-      const name =
-        input.getAttribute('aria-label') ||
-        input.labels?.[0]?.textContent?.trim() ||
-        input.getAttribute('placeholder');
+      const name = input.getAttribute('aria-label') || input.labels?.[0]?.textContent?.trim();
       if (name) list.setAttribute('aria-label', name);
     }
     // A `role="combobox"` with no accessible name is a silent AT failure. A
@@ -84,6 +103,15 @@ export function initCombobox({ root } = {}) {
     input.setAttribute('aria-expanded', 'false');
     input.setAttribute('autocomplete', 'off');
     list.hidden = true;
+    // Hide the empty-state at rest: it must only appear once a filter yields no
+    // matches, never on an idle combobox. Without this an author who omits
+    // `hidden` on `.ui-combobox__empty` ships a box that reads "No matches"
+    // before the user has typed anything. (component audit C10.) Make it a
+    // status live region so its appearance is announced. (component audit C38.)
+    if (empty) {
+      empty.hidden = true;
+      if (!empty.hasAttribute('role')) empty.setAttribute('role', 'status');
+    }
 
     let active = -1;
     const visible = () => options.filter((o) => !o.hidden);
@@ -130,13 +158,19 @@ export function initCombobox({ root } = {}) {
     };
 
     const select = (opt) => {
-      input.value = opt.dataset.value ?? opt.textContent.trim();
+      // Show the human LABEL in the input; emit the `data-value` CODE in the
+      // event. The natural pattern is code in `data-value`, label in the text —
+      // putting the code in the visible input silently shows the user a raw code.
+      // (component audit C10.)
+      const label = opt.textContent.trim();
+      const value = opt.dataset.value ?? label;
+      input.value = label;
       options.forEach((o) => o.setAttribute('aria-selected', String(o === opt)));
       close();
       input.focus();
       box.dispatchEvent(
         new CustomEvent('bronto:change', {
-          detail: { value: input.value },
+          detail: { value, label },
           bubbles: true,
         }),
       );
@@ -169,6 +203,15 @@ export function initCombobox({ root } = {}) {
       return true;
     };
 
+    // Live re-sync after the option nodes change under us. The active option may
+    // be gone, so drop it; re-filter against the current input only while open.
+    const relist = () => {
+      syncOptions();
+      active = -1;
+      setActive(null);
+      if (!list.hidden) filter();
+    };
+
     const onInput = () => filter();
     const onKey = (e) => {
       switch (e.key) {
@@ -212,7 +255,15 @@ export function initCombobox({ root } = {}) {
       input.addEventListener('keydown', onKey);
       list.addEventListener('click', onOptionClick);
       document.addEventListener('click', onDocClick);
+      // Opt-in: keep options in sync with a list mutated after init (async /
+      // remote results). Off by default so the common static case stays free.
+      const observer =
+        box.hasAttribute('data-bronto-combobox-live') && typeof MutationObserver === 'function'
+          ? new MutationObserver(relist)
+          : null;
+      observer?.observe(list, { childList: true, subtree: true });
       return () => {
+        observer?.disconnect();
         input.removeEventListener('input', onInput);
         input.removeEventListener('keydown', onKey);
         list.removeEventListener('click', onOptionClick);

package/behaviors/command.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @typedef {object} CommandSelectDetail
+ * @property {string} value The chosen command's value.
+ * @property {string} label The chosen command's visible label.
+ */
+/**
+ * Command palette — filter + keyboard-navigate a DOM-authored command list.
+ * The CSS shell (`.ui-command`) is opt-in; this wires the listbox behavior the
+ * shell needs. Bronto filters and navigates; the HOST owns the action registry,
+ * permission checks, routing, async effects, and command execution (it listens
+ * for `bronto:command:select`). There is no global Cmd/Ctrl+K — open the palette
+ * yourself (e.g. a `<dialog>` via `initDialog`).
+ *
+ * Markup: `[data-bronto-command]` wrapping an `<input>` (`.ui-command__input`)
+ * and a list (`.ui-command__list`) of `.ui-command__item` rows (optional
+ * `data-value`), interleaved with `.ui-command__group` labels and an optional
+ * `.ui-command__empty`. The behavior owns ids, `role=combobox/listbox/option`,
+ * `aria-activedescendant`, a roving active item, substring filtering (hiding
+ * empty groups), full keyboard (Down/Up/Home/End/Enter/Escape), and pointer
+ * select. It emits `bronto:command:select` ({ detail: { value, label } }) on
+ * choose and `bronto:command:close` on Escape. SSR-safe, idempotent per
+ * instance; returns a cleanup function.
+ *
+ * Items are read from the DOM at init; re-run initCommand after replacing the
+ * command list so filtering/navigation see the current nodes.
+ *
+ * @param {import('./internal.js').DelegateOpts} [opts]
+ * @returns {import('./internal.js').Cleanup}
+ */
+export function initCommand({ root }?: import("./internal.js").DelegateOpts): import("./internal.js").Cleanup;
+export type CommandSelectDetail = {
+    /**
+     * The chosen command's value.
+     */
+    value: string;
+    /**
+     * The chosen command's visible label.
+     */
+    label: string;
+};
+//# sourceMappingURL=command.d.ts.map

package/behaviors/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["command.js"],"names":[],"mappings":"AAWA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,uCAHW,OAAO,eAAe,EAAE,YAAY,GAClC,OAAO,eAAe,EAAE,OAAO,CA+J3C;;;;;WAzLa,MAAM;;;;WACN,MAAM"}

package/behaviors/command.js

@@ -9,6 +9,12 @@ import {
   wrapIndex,
 } from './internal.js';
 
+/**
+ * @typedef {object} CommandSelectDetail
+ * @property {string} value The chosen command's value.
+ * @property {string} label The chosen command's visible label.
+ */
+
 /**
  * Command palette — filter + keyboard-navigate a DOM-authored command list.
  * The CSS shell (`.ui-command`) is opt-in; this wires the listbox behavior the
@@ -29,6 +35,9 @@ import {
  *
  * Items are read from the DOM at init; re-run initCommand after replacing the
  * command list so filtering/navigation see the current nodes.
+ *
+ * @param {import('./internal.js').DelegateOpts} [opts]
+ * @returns {import('./internal.js').Cleanup}
  */
 export function initCommand({ root } = {}) {
   if (!hasDom()) return noop;

package/behaviors/connectors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Draw + keep leader lines in sync. Each `[data-bronto-connector]` is an
+ * `.ui-connector` SVG overlaying a positioned container; `data-from`/`data-to`
+ * are the ids of the elements to connect. Optional `data-shape`
+ * (`straight`|`elbow`|`curve`), `data-from-side`/`data-to-side`
+ * (`top`|`right`|`bottom`|`left`|`center`), and `data-end` (`arrow`|`dot`|`none`).
+ *
+ * Bronto computes the geometry (the pure `@ponchia/ui/connectors` helpers) and
+ * sets the path; it owns no layout. Redraws on resize/scroll via a
+ * ResizeObserver + listeners. SSR-safe, idempotent per host; returns a cleanup
+ * that disconnects everything. Re-run after adding/removing connectors.
+ *
+ * @param {import('./internal.js').DelegateOpts} [opts]
+ * @returns {import('./internal.js').Cleanup}
+ */
+export function initConnectors({ root }?: import("./internal.js").DelegateOpts): import("./internal.js").Cleanup;
+//# sourceMappingURL=connectors.d.ts.map

package/behaviors/connectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.d.ts","sourceRoot":"","sources":["connectors.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;GAcG;AACH,0CAHW,OAAO,eAAe,EAAE,YAAY,GAClC,OAAO,eAAe,EAAE,OAAO,CA+E3C"}

package/behaviors/connectors.js

@@ -14,6 +14,9 @@ const SVGNS = 'http://www.w3.org/2000/svg';
  * sets the path; it owns no layout. Redraws on resize/scroll via a
  * ResizeObserver + listeners. SSR-safe, idempotent per host; returns a cleanup
  * that disconnects everything. Re-run after adding/removing connectors.
+ *
+ * @param {import('./internal.js').DelegateOpts} [opts]
+ * @returns {import('./internal.js').Cleanup}
  */
 export function initConnectors({ root } = {}) {
   if (!hasDom()) return noop;

package/behaviors/crosshair.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @typedef {object} CrosshairMoveDetail
+ * @property {number} x Pointer x within the plot, in pixels.
+ * @property {number} y Pointer y within the plot, in pixels.
+ * @property {number} fx Pointer x as a 0..1 fraction of the plot width.
+ * @property {number} fy Pointer y as a 0..1 fraction of the plot height.
+ */
+/**
+ * Track the pointer over a plot and drive a crosshair. Each
+ * `[data-bronto-crosshair]` is the plot; it contains a `.ui-crosshair` overlay.
+ * On pointer move the behavior sets `--crosshair-x/y` (pixels within the plot)
+ * on the overlay, marks it `.is-active`, and dispatches
+ * `bronto:crosshair:move` with `{ x, y, fx, fy }` (px + 0..1 fractions);
+ * `bronto:crosshair:leave` on exit.
+ *
+ * Bronto reports WHERE the pointer is — it does not find the nearest datum or
+ * map pixels to data values (that needs the host's scales). SSR-safe,
+ * idempotent per plot; returns a cleanup function.
+ *
+ * @param {import('./internal.js').DelegateOpts} [opts]
+ * @returns {import('./internal.js').Cleanup}
+ */
+export function initCrosshair({ root }?: import("./internal.js").DelegateOpts): import("./internal.js").Cleanup;
+export type CrosshairMoveDetail = {
+    /**
+     * Pointer x within the plot, in pixels.
+     */
+    x: number;
+    /**
+     * Pointer y within the plot, in pixels.
+     */
+    y: number;
+    /**
+     * Pointer x as a 0..1 fraction of the plot width.
+     */
+    fx: number;
+    /**
+     * Pointer y as a 0..1 fraction of the plot height.
+     */
+    fy: number;
+};
+//# sourceMappingURL=crosshair.d.ts.map

package/behaviors/crosshair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crosshair.d.ts","sourceRoot":"","sources":["crosshair.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;GAcG;AACH,yCAHW,OAAO,eAAe,EAAE,YAAY,GAClC,OAAO,eAAe,EAAE,OAAO,CAmD3C;;;;;OAtEa,MAAM;;;;OACN,MAAM;;;;QACN,MAAM;;;;QACN,MAAM"}