@ponchia/ui 0.6.6 → 0.6.7

package/docs/package-contract.md

@@ -27,6 +27,8 @@ semantic versioning contract for the surfaces listed here.
 | --- | --- | --- | --- | --- |
 | `.` | style: `./dist/bronto.css`<br>default: `./dist/bronto.css` | CSS root bundle | Stable | CSS-only package root. Supported as a CSS side-effect import in CSS-aware bundlers; not a Node/runtime JS entrypoint. |
 | `./dist/bronto.css` | `./dist/bronto.css` | Flattened CSS bundle | Stable path | The prebuilt default stylesheet. Generated from css/core.css and byte-checked by check:dist. |
+| `./tailwind` | `./tailwind.css` | Tailwind CSS bridge | Stable additive | CSS-only Tailwind v4 theme/variant bridge. It maps Bronto tokens into Tailwind namespaces; it does not import component CSS. |
+| `./tailwind.css` | `./tailwind.css` | Tailwind CSS bridge | Stable additive | CSS-only Tailwind v4 theme/variant bridge. It maps Bronto tokens into Tailwind namespaces; it does not import component CSS. |
 | `./css` | `./css/core.css` | CSS source fan-out | Stable path | Bundler entrypoint for css/core.css. It preserves source @import boundaries and layer behavior. |
 | `./css/core.css` | `./css/core.css` | CSS source fan-out | Stable path | Source fan-out file for consumers that want the authored leaf graph through a bundler. |
 | `./css/tokens.css` | `./dist/css/tokens.css` | Bundled layered CSS leaf | Stable additive | Generated layered direct-import leaf. Also included in dist/bronto.css. |
@@ -47,6 +49,7 @@ semantic versioning contract for the surfaces listed here.
 | `./css/skins.css` | `./dist/css/skins.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
 | `./css/dataviz.css` | `./dist/css/dataviz.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
 | `./css/report.css` | `./dist/css/report.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
+| `./css/figure.css` | `./dist/css/figure.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
 | `./css/annotations.css` | `./dist/css/annotations.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
 | `./css/legend.css` | `./dist/css/legend.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
 | `./css/marks.css` | `./dist/css/marks.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
@@ -55,6 +58,9 @@ semantic versioning contract for the surfaces listed here.
 | `./css/crosshair.css` | `./dist/css/crosshair.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
 | `./css/selection.css` | `./dist/css/selection.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
 | `./css/sources.css` | `./dist/css/sources.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
+| `./css/interval.css` | `./dist/css/interval.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
+| `./css/clamp.css` | `./dist/css/clamp.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
+| `./css/highlights.css` | `./dist/css/highlights.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
 | `./css/diff.css` | `./dist/css/diff.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
 | `./css/code.css` | `./dist/css/code.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
 | `./css/spark.css` | `./dist/css/spark.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
@@ -69,6 +75,7 @@ semantic versioning contract for the surfaces listed here.
 | `./css/workbench.css` | `./dist/css/workbench.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
 | `./css/command.css` | `./dist/css/command.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
 | `./css/analytical.css` | `./dist/css/analytical.css` | Opt-in CSS roll-up | Stable additive | Generated layered roll-up of the analytical leaves. Not included in the default bundle. |
+| `./css/report-kit.css` | `./dist/css/report-kit.css` | Opt-in CSS roll-up | Stable additive | Generated layered roll-up for complete static reports. Not included in the default bundle. |
 | `./css/unlayered/tokens.css` | `./css/tokens.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
 | `./css/unlayered/fonts.css` | `./css/fonts.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
 | `./css/unlayered/base.css` | `./css/base.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
@@ -87,6 +94,7 @@ semantic versioning contract for the surfaces listed here.
 | `./css/unlayered/skins.css` | `./css/skins.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
 | `./css/unlayered/dataviz.css` | `./css/dataviz.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
 | `./css/unlayered/report.css` | `./css/report.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
+| `./css/unlayered/figure.css` | `./css/figure.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
 | `./css/unlayered/annotations.css` | `./css/annotations.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
 | `./css/unlayered/legend.css` | `./css/legend.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
 | `./css/unlayered/marks.css` | `./css/marks.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
@@ -95,6 +103,9 @@ semantic versioning contract for the surfaces listed here.
 | `./css/unlayered/crosshair.css` | `./css/crosshair.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
 | `./css/unlayered/selection.css` | `./css/selection.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
 | `./css/unlayered/sources.css` | `./css/sources.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
+| `./css/unlayered/interval.css` | `./css/interval.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
+| `./css/unlayered/clamp.css` | `./css/clamp.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
+| `./css/unlayered/highlights.css` | `./css/highlights.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
 | `./css/unlayered/diff.css` | `./css/diff.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
 | `./css/unlayered/code.css` | `./css/code.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
 | `./css/unlayered/spark.css` | `./css/spark.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
@@ -113,8 +124,11 @@ semantic versioning contract for the surfaces listed here.
 | `./tokens.json` | `./tokens/index.json` | Machine-readable data | Stable additive | JSON package data for non-JS/tooling consumers. Shape is public unless the paired doc marks a field internal. |
 | `./tokens.dtcg.json` | `./tokens/tokens.dtcg.json` | Machine-readable data | Stable additive | JSON package data for non-JS/tooling consumers. Shape is public unless the paired doc marks a field internal. |
 | `./tokens/resolved.json` | `./tokens/resolved.json` | Machine-readable data | Stable additive | JSON package data for non-JS/tooling consumers. Shape is public unless the paired doc marks a field internal. |
+| `./tokens/figma.variables.json` | `./tokens/figma.variables.json` | Machine-readable data | Stable additive | JSON package data for non-JS/tooling consumers. Shape is public unless the paired doc marks a field internal. |
 | `./shiki/nothing.json` | `./shiki/nothing.json` | Machine-readable data | Stable additive | JSON package data for non-JS/tooling consumers. Shape is public unless the paired doc marks a field internal. |
 | `./llms.txt` | `./llms.txt` | Agent entrypoint | Stable path | Plain-text orientation file shipped for offline agents and tooling. |
+| `./MIGRATIONS.json` | `./MIGRATIONS.json` | Machine-readable data | Stable additive | JSON package data for non-JS/tooling consumers. Shape is public unless the paired doc marks a field internal. |
+| `./schemas/report-claims.v1.schema.json` | `./schemas/report-claims.v1.schema.json` | Machine-readable data | Stable additive | JSON package data for non-JS/tooling consumers. Shape is public unless the paired doc marks a field internal. |
 | `./docs/architecture.md` | `./docs/architecture.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/reference.md` | `./docs/reference.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/theming.md` | `./docs/theming.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
@@ -129,6 +143,7 @@ semantic versioning contract for the surfaces listed here.
 | `./docs/mermaid.md` | `./docs/mermaid.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/d2.md` | `./docs/d2.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/vega.md` | `./docs/vega.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
+| `./docs/figure.md` | `./docs/figure.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/annotations.md` | `./docs/annotations.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/legends.md` | `./docs/legends.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/marks.md` | `./docs/marks.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
@@ -137,6 +152,9 @@ semantic versioning contract for the surfaces listed here.
 | `./docs/crosshair.md` | `./docs/crosshair.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/selection.md` | `./docs/selection.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/sources.md` | `./docs/sources.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
+| `./docs/interval.md` | `./docs/interval.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
+| `./docs/clamp.md` | `./docs/clamp.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
+| `./docs/highlights.md` | `./docs/highlights.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/diff.md` | `./docs/diff.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/code.md` | `./docs/code.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/spark.md` | `./docs/spark.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
@@ -150,6 +168,11 @@ semantic versioning contract for the surfaces listed here.
 | `./docs/generated.md` | `./docs/generated.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/workbench.md` | `./docs/workbench.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/command.md` | `./docs/command.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
+| `./docs/interop/tailwind.md` | `./docs/interop/tailwind.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
+| `./docs/migrations/0.2-to-0.3.md` | `./docs/migrations/0.2-to-0.3.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
+| `./docs/migrations/0.3-to-0.4.md` | `./docs/migrations/0.3-to-0.4.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
+| `./docs/migrations/0.4-to-0.5.md` | `./docs/migrations/0.4-to-0.5.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
+| `./docs/migrations/0.5-to-0.6.md` | `./docs/migrations/0.5-to-0.6.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/adr/0001-color-system.md` | `./docs/adr/0001-color-system.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/adr/0002-scope-and-2026-baseline.md` | `./docs/adr/0002-scope-and-2026-baseline.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/adr/0003-theme-model.md` | `./docs/adr/0003-theme-model.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
@@ -162,6 +185,8 @@ semantic versioning contract for the surfaces listed here.
 | `./react` | types: `./react/index.d.ts`<br>default: `./react/index.js` | Framework binding JS | Stable thin adapter | Optional peer wrapper over vanilla behaviors. It owns lifecycle hookup, not markup or component state. |
 | `./solid` | types: `./solid/index.d.ts`<br>default: `./solid/index.js` | Framework binding JS | Stable thin adapter | Optional peer wrapper over vanilla behaviors. It owns lifecycle hookup, not markup or component state. |
 | `./qwik` | types: `./qwik/index.d.ts`<br>default: `./qwik/index.js` | Framework binding JS | Stable thin adapter | Optional peer wrapper over vanilla behaviors. It owns lifecycle hookup, not markup or component state. |
+| `./svelte` | types: `./svelte/index.d.ts`<br>default: `./svelte/index.js` | Framework binding JS | Stable thin adapter | Optional peer wrapper over vanilla behaviors. It owns lifecycle hookup, not markup or component state. |
+| `./vue` | types: `./vue/index.d.ts`<br>default: `./vue/index.js` | Framework binding JS | Stable thin adapter | Optional peer wrapper over vanilla behaviors. It owns lifecycle hookup, not markup or component state. |
 | `./skins` | types: `./tokens/skins.d.ts`<br>default: `./tokens/skins.js` | Renderer/theme helper JS | Stable additive | ESM theme data/helpers for opt-in skins, chart palettes, and external renderers. |
 | `./charts` | types: `./tokens/charts.d.ts`<br>default: `./tokens/charts.js` | Renderer/theme helper JS | Stable additive | ESM theme data/helpers for opt-in skins, chart palettes, and external renderers. |
 | `./charts.json` | `./tokens/charts.json` | Machine-readable data | Stable additive | JSON package data for non-JS/tooling consumers. Shape is public unless the paired doc marks a field internal. |
@@ -183,16 +208,20 @@ always includes `package.json`, `README.md`, `LICENSE`, and
 | --- | --- | --- |
 | `css` | Source CSS directory | Public source leaves. Mostly hand-authored; generated exceptions are called out in the provenance table. |
 | `dist` | Generated CSS directory | Prebuilt layered bundle and leaves. Never hand-edit. |
+| `tailwind.css` | Tailwind CSS bridge | CSS-only Tailwind v4 theme/variant bridge; hand-authored and not part of the default Bronto bundle. |
 | `fonts` | Vendored assets | Doto woff2 files plus OFL license. |
 | `tokens` | Mixed source/generated data | Token source plus generated JSON, declarations, and renderer theme data. |
 | `classes` | Mixed source/generated data | Class recipe source plus generated JSON/declarations/custom-data. |
 | `behaviors` | Authored public JS directory | ESM source shipped as-is; adjacent declarations/maps are generated. |
 | `glyphs` | Authored public JS directory | Glyph registry/renderers shipped as JS; declarations are generated. |
+| `schemas` | Machine-readable schemas | Declarative JSON schemas for package-adjacent report/tooling contracts. |
 | `annotations` | Authored public JS directory | ESM source shipped as-is; adjacent declarations/maps are generated. |
 | `connectors` | Authored public JS directory | ESM source shipped as-is; adjacent declarations/maps are generated. |
 | `react` | Authored public JS directory | ESM source shipped as-is; adjacent declarations/maps are generated. |
 | `solid` | Authored public JS directory | ESM source shipped as-is; adjacent declarations/maps are generated. |
 | `qwik` | Authored public JS directory | ESM source shipped as-is; adjacent declarations/maps are generated. |
+| `svelte` | Authored public JS directory | ESM source shipped as-is; adjacent declarations/maps are generated. |
+| `vue` | Authored public JS directory | ESM source shipped as-is; adjacent declarations/maps are generated. |
 | `shiki` | Theme data | Shiki theme JSON on the governed palette. |
 | `llms.txt` | Agent entrypoint | Shipped plain-text orientation for offline LLM/agent consumers. |
 | `CHANGELOG.md` | Release record | Shipped historical release notes. |
@@ -211,6 +240,7 @@ always includes `package.json`, `README.md`, `LICENSE`, and
 | `docs/mermaid.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/d2.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/vega.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
+| `docs/figure.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/annotations.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/legends.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/marks.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
@@ -219,6 +249,9 @@ always includes `package.json`, `README.md`, `LICENSE`, and
 | `docs/crosshair.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/selection.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/sources.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
+| `docs/interval.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
+| `docs/clamp.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
+| `docs/highlights.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/diff.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/code.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/spark.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
@@ -232,6 +265,11 @@ always includes `package.json`, `README.md`, `LICENSE`, and
 | `docs/generated.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/workbench.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/command.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
+| `docs/interop/tailwind.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
+| `docs/migrations/0.2-to-0.3.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
+| `docs/migrations/0.3-to-0.4.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
+| `docs/migrations/0.4-to-0.5.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
+| `docs/migrations/0.5-to-0.6.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/adr/0001-color-system.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/adr/0002-scope-and-2026-baseline.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/adr/0003-theme-model.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
@@ -245,9 +283,9 @@ result. The listed gates are part of `npm run check`.
 | Surface | Source of truth | Generated outputs | Generator | Gate | Note |
 | --- | --- | --- | --- | --- | --- |
 | Package manifest | `package.json` | docs/package-contract.md | `npm run package-contract:build` | check:fresh | The complete export/file matrix in this document is generated from the manifest. |
-| Token model | `tokens/index.js` | css/tokens.css; tokens/index.json; tokens/tokens.dtcg.json; tokens/resolved.json; tokens/index.d.ts | `npm run tokens:css:build; tokens:build; dtcg:build; resolved:build; dts:build` | check:fresh; check:contrast | Token names/roles are public. Resolved values are visual tuning before 1.0. |
+| Token model | `tokens/index.js` | css/tokens.css; tokens/index.json; tokens/tokens.dtcg.json; tokens/resolved.json; tokens/figma.variables.json; tokens/index.d.ts | `npm run tokens:css:build; tokens:build; dtcg:build; resolved:build; figma:variables:build; dts:build` | check:fresh; check:contrast | Token names/roles are public. Resolved and Figma handoff values are visual tuning before 1.0. |
 | Class registry | `classes/index.js plus css/*.css selectors` | classes/classes.json; classes/index.d.ts; classes/vscode.css-custom-data.json; docs/reference.md | `npm run classes:json:build; dts:build; vscode:build; reference:build` | check:fresh; check:classes; check:contract | The typed registry, JSON vocabulary, and generated reference stay aligned with real selectors. |
-| Authored CSS graph | `css/core.css plus css/*.css leaves` | dist/bronto.css; dist/css/*.css (40 layered outputs) | `npm run dist:build` | check:dist; check:exports | Default bundle and direct layered leaf imports are generated from authored CSS and size-gated. |
+| Authored CSS graph | `css/core.css plus css/*.css leaves` | dist/bronto.css; dist/css/*.css (46 layered outputs) | `npm run dist:build` | check:dist; check:exports | Default bundle and direct layered leaf imports are generated from authored CSS and size-gated. |
 | JSDoc-authored public JS | `behaviors/; annotations/; connectors/; react/; solid/; qwik/` | adjacent *.d.ts and *.d.ts.map files | `npm run dts:emit` | check:dts-emit; check:types; check:attw; check:publint | Declarations are emitted from the shipped JS, not separately maintained. |
 | Glyph registry | `glyphs/glyphs.js` | glyphs/glyphs.d.ts | `npm run glyphs:build` | check:glyphs; npm test | Glyph names and render options are public. The registry stays sorted and type-covered. |
 | Display colorways | `tokens/skins.js` | css/skins.css; tokens/skins.d.ts | `npm run skins:build` | check:skins; check:contrast | Skins are opt-in root-level choices and never part of dist/bronto.css. |

package/docs/reference.md

@@ -9,7 +9,7 @@ rendering of every class is the kitchen-sink demo:
 **<https://ponchia.github.io/bronto-ui/>**. Theming knobs and the token
 contract: [docs/theming.md](theming.md).
 
-- 593 classes across 171 component groups
+- 634 classes across 177 component groups
 - Import the typed registry: `import { cls, ui, cx } from '@ponchia/ui/classes'`
 - Validate markup as data (no JS/TS): `@ponchia/ui/classes.json` — the same
   vocabulary as language-neutral JSON (`groups`, `classes`, `states`,
@@ -348,6 +348,17 @@ each one matches a real selector in the stylesheet.
 | `cls.claimUnknown` | `ui-claim--unknown` | modifier |
 | `cls.claimUnsupported` | `ui-claim--unsupported` | modifier |
 
+### `.ui-clamp`
+
+| Registry key | Class | Kind |
+| --- | --- | --- |
+| `cls.clamp` | `ui-clamp` | base |
+| `cls.clampBody` | `ui-clamp__body` | part |
+| `cls.clampControl` | `ui-clamp__control` | part |
+| `cls.clampLess` | `ui-clamp__less` | part |
+| `cls.clampMore` | `ui-clamp__more` | part |
+| `cls.clampToggle` | `ui-clamp__toggle` | part |
+
 ### `.ui-cluster`
 
 | Registry key | Class | Kind |
@@ -616,6 +627,20 @@ each one matches a real selector in the stylesheet.
 | --- | --- | --- |
 | `cls.field` | `ui-field` | base |
 
+### `.ui-figure`
+
+| Registry key | Class | Kind |
+| --- | --- | --- |
+| `cls.figure` | `ui-figure` | base |
+| `cls.figureBody` | `ui-figure__body` | part |
+| `cls.figureBodyKeyRight` | `ui-figure__body--key-right` | modifier |
+| `cls.figureCaption` | `ui-figure__caption` | part |
+| `cls.figureData` | `ui-figure__data` | part |
+| `cls.figureKey` | `ui-figure__key` | part |
+| `cls.figureMedia` | `ui-figure__media` | part |
+| `cls.figureOverlay` | `ui-figure__overlay` | part |
+| `cls.figureStage` | `ui-figure__stage` | part |
+
 ### `.ui-file`
 
 | Registry key | Class | Kind |
@@ -649,6 +674,12 @@ each one matches a real selector in the stylesheet.
 | --- | --- | --- |
 | `cls.halftone` | `ui-halftone` | base |
 
+### `.ui-highlights`
+
+| Registry key | Class | Kind |
+| --- | --- | --- |
+| `cls.highlights` | `ui-highlights` | base |
+
 ### `.ui-hint`
 
 | Registry key | Class | Kind |
@@ -691,6 +722,36 @@ each one matches a real selector in the stylesheet.
 | `cls.inspectorBody` | `ui-inspector__body` | part |
 | `cls.inspectorHead` | `ui-inspector__head` | part |
 
+### `.ui-interval`
+
+| Registry key | Class | Kind |
+| --- | --- | --- |
+| `cls.interval` | `ui-interval` | base |
+| `cls.intervalBounds` | `ui-interval__bounds` | part |
+| `cls.intervalLabel` | `ui-interval__label` | part |
+| `cls.intervalPoint` | `ui-interval__point` | part |
+| `cls.intervalRange` | `ui-interval__range` | part |
+| `cls.intervalTrack` | `ui-interval__track` | part |
+
+### `.ui-job`
+
+| Registry key | Class | Kind |
+| --- | --- | --- |
+| `cls.job` | `ui-job` | base |
+| `cls.jobActions` | `ui-job__actions` | part |
+| `cls.jobBar` | `ui-job__bar` | part |
+| `cls.jobBody` | `ui-job__body` | part |
+| `cls.jobHead` | `ui-job__head` | part |
+| `cls.jobMeta` | `ui-job__meta` | part |
+| `cls.jobProgress` | `ui-job__progress` | part |
+| `cls.jobTitle` | `ui-job__title` | part |
+| `cls.jobBlocked` | `ui-job--blocked` | modifier |
+| `cls.jobCompact` | `ui-job--compact` | modifier |
+| `cls.jobComplete` | `ui-job--complete` | modifier |
+| `cls.jobFailed` | `ui-job--failed` | modifier |
+| `cls.jobQueued` | `ui-job--queued` | modifier |
+| `cls.jobRunning` | `ui-job--running` | modifier |
+
 ### `.ui-kbd`
 
 | Registry key | Class | Kind |
@@ -1189,6 +1250,16 @@ each one matches a real selector in the stylesheet.
 | --- | --- | --- |
 | `cls.spinner` | `ui-spinner` | base |
 
+### `.ui-splitter`
+
+| Registry key | Class | Kind |
+| --- | --- | --- |
+| `cls.splitter` | `ui-splitter` | base |
+| `cls.splitterHandle` | `ui-splitter__handle` | part |
+| `cls.splitterPane` | `ui-splitter__pane` | part |
+| `cls.splitterHorizontal` | `ui-splitter--horizontal` | modifier |
+| `cls.splitterVertical` | `ui-splitter--vertical` | modifier |
+
 ### `.ui-spotlight`
 
 | Registry key | Class | Kind |
@@ -1517,9 +1588,11 @@ works in any framework without a binding layer:
   vocabulary onto a tone is application logic, not a framework class.
 - **Modal** — native `<dialog>` gets backdrop + top-layer + focus-trap
   free. For a controlled/portal modal, add `is-open`
-  (`ui.modal({ open: true })`) for the same skin/layout; the
-  backdrop, top-layer stacking AND focus-trap are then yours (`.is-open`
-  is a bare grid — it does not float or stack on its own).
+  (`ui.modal({ open: true })`) for the same skin/layout, mark the overlay
+  `data-bronto-modal`, and run `initModal()` for the inert focus trap,
+  focus-return, and Escape close signal. You still own the `is-open` state,
+  backdrop, and top-layer stacking (`.is-open` is a bare grid — it does not
+  float or stack on its own).
 - **Current page** — mark the active link with `aria-current="page"`; it is
   the programmatic cue the navs honour (`ui-sitenav`, `ui-app-nav`). The
   `.is-active` class is the visual-only equivalent on `ui-app-nav`/`ui-tab`;
@@ -1694,7 +1767,7 @@ Exact mirror of the `:root` blocks in `css/tokens.css`
 | `--text-dim` | `#a0a0a0` |
 | `--accent` | `#ff3b41` |
 | `--accent-ramp-end` | `#000000` |
-| `--accent-strong` | `color-mix(in srgb, var(--accent) 84%, #fff)` |
+| `--accent-strong` | `color-mix(in srgb, var(--accent) 80%, #fff)` |
 | `--accent-text` | `var(--accent-strong)` |
 | `--on-accent` | `var(--button-text)` |
 | `--accent-soft` | `color-mix(in srgb, var(--accent) 14%, transparent)` |

package/docs/reporting.md

@@ -1,12 +1,19 @@
 # Static reports
 
 `@ponchia/ui` can dress static, LLM-authored HTML reports without a component
-runtime. Load the normal bundle, then opt in to the report layer, chart palette,
-and annotation layer only when the report needs them.
+runtime. Load the normal bundle, then either opt in to the complete report kit
+or import only the leaves a narrow report actually uses.
 
 In a bundled app, package specifiers are fine because Vite or another bundler
 rewrites them:
 
+```css
+@import '@ponchia/ui';
+@import '@ponchia/ui/css/report-kit.css';
+```
+
+For tighter payload control, import leaves one by one:
+
 ```css
 @import '@ponchia/ui';
 @import '@ponchia/ui/css/report.css';
@@ -16,9 +23,11 @@ rewrites them:
 ```
 
 **`dist/bronto.css` is the standard component set only — it does NOT contain
-the report, chart, annotation, or legend layers.** Those are opt-in leaves
-under `dist/css/`; a report links the default bundle *and* each leaf it uses.
-Forgetting them is the most common way an LLM-emitted report renders unstyled.
+the report, chart, annotation, source, trust, or code/diff layers.**
+`report-kit.css` is the one-file opt-in path for complete static reports; the
+individual leaves remain available under `dist/css/` when a report uses only a
+small subset. Forgetting the opt-in CSS is the most common way an LLM-emitted
+report renders unstyled.
 
 For standalone browser HTML, use real stylesheet URLs. Package specifiers like
 `@ponchia/ui/css/report.css` do not resolve in a saved `.html` file — and note
@@ -27,6 +36,14 @@ the path is `dist/css/`, the built leaf, not the source `css/`:
 ```html
 <!-- installed locally -->
 <link rel="stylesheet" href="./node_modules/@ponchia/ui/dist/bronto.css" />
+<link rel="stylesheet" href="./node_modules/@ponchia/ui/dist/css/report-kit.css" />
+```
+
+Or, if you are intentionally keeping a report minimal, link only the leaves it
+uses:
+
+```html
+<link rel="stylesheet" href="./node_modules/@ponchia/ui/dist/bronto.css" />
 <link rel="stylesheet" href="./node_modules/@ponchia/ui/dist/css/report.css" />
 <link rel="stylesheet" href="./node_modules/@ponchia/ui/dist/css/dataviz.css" />
 <link rel="stylesheet" href="./node_modules/@ponchia/ui/dist/css/annotations.css" />
@@ -37,11 +54,18 @@ No install? Link the same files from a CDN. Pin the version — pre-1.0, breakin
 changes ship in the minor (see [stability.md](./stability.md)):
 
 ```html
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.6/dist/bronto.css" />
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.6/dist/css/report.css" />
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.6/dist/css/dataviz.css" />
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.6/dist/css/annotations.css" />
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.6/dist/css/legend.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.7/dist/bronto.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.7/dist/css/report-kit.css" />
+```
+
+Leaf-by-leaf CDN imports use the same `dist/css/` paths:
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.7/dist/bronto.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.7/dist/css/report.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.7/dist/css/dataviz.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.7/dist/css/annotations.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.7/dist/css/legend.css" />
 ```
 
 The CDN serves the package's own `fonts/` next to the CSS, so font URLs resolve
@@ -60,15 +84,20 @@ sanitize that content before rendering it and do not initialize
 evidence). The _content_ inside those sections is where the rest of the
 analytical layer earns its place. Each one is an opt-in import that stays out of
 the default bundle — add the leaves a given report actually needs.
-`@ponchia/ui/css/analytical.css` is a convenience roll-up of the **seven
-figure-layer leaves only** (annotations, legends, marks, connectors, spotlight,
-crosshair, selection) — sources, generated, state, and the prose/evidence
-leaves below are NOT in it and must be linked individually. Reach for:
+`@ponchia/ui/css/analytical.css` is a convenience roll-up of the **nine
+figure/evidence-layer leaves only** (figure, annotations, legends, marks,
+connectors, spotlight, crosshair, selection, highlights) — sources, generated,
+state, interval, clamp, and the prose/evidence leaves below are NOT in it and
+must be linked individually. Reach for:
 
 | Layer | Import | Reach for it when… |
 | --- | --- | --- |
+| **Figure stage** (`.ui-figure*`) | `css/figure.css` | A chart, diagram, screenshot, or annotated SVG needs a stable media box, overlay slot, right-side key, and fallback-data slot. It composes with `ui-report__figure`; it does not render charts or own scales. See [figure.md](./figure.md). |
 | **Marks** (`.ui-mark`, `.ui-bracket-note`) | `css/marks.css` | You want to emphasise a phrase _in prose_ — a highlight on the finding, an underline on a risk, or a bracket around an evidence/caveat passage. The inline counterpart to annotations. See [marks.md](./marks.md). |
 | **Sources / provenance** (`.ui-citation`, `.ui-source-card`, `.ui-source-list`, `.ui-provenance`) | `css/sources.css` | The report makes claims a reader will question — "where did this come from?". A CSS-only trust layer whose cross-cutting state modifier (`.ui-src--verified`, plus reviewed / generated / unverified / stale / conflict) sets a rationed tone, always paired with a written label, never colour alone. See [sources.md](./sources.md). |
+| **Interval** (`.ui-interval*`) | `css/interval.css` | Evidence is a low/high estimate, confidence window, target band, or uncertain reading. The host normalises `--lo`, `--hi`, and optional `--v`; Bronto only paints the range and point. See [interval.md](./interval.md). |
+| **Clamp** (`.ui-clamp*`) | `css/clamp.css` | A source excerpt, claim basis, or caveat should scan as a bounded text block but remain reachable through explicit "Show more" / "Show less" labels and print expansion. See [clamp.md](./clamp.md). |
+| **Highlights** (`.ui-highlights`) | `css/highlights.css` | The host registers CSS Custom Highlight API ranges for cited evidence, search hits, or the current match without wrapping DOM text nodes. See [highlights.md](./highlights.md). |
 | **Annotations** (`.ui-annotation*`) | `css/annotations.css` | A figure needs an explicit callout — a peak, a limit, a watched region — or a small decorative margin mark. SVG only. See [annotations.md](./annotations.md) and the [off-chart + scaling notes](./annotations.md#using-annotations-off-chart) before you size one. |
 | **Legends / data keys** (`.ui-legend*`) | `css/legend.css` | A chart figure needs a colour key. WCAG 1.4.1 by construction. See [legends.md](./legends.md). |
 | **Mermaid theme** (`@ponchia/ui/mermaid`) | _(JS/JSON, no CSS)_ | The report embeds a [Mermaid](https://mermaid.js.org) diagram (flowchart, sequence, pie…) and you want it on-brand instead of generic. A resolved `base` theme projected from the same tokens as `charts.json`; annotate the rendered SVG with the annotation layer. See [mermaid.md](./mermaid.md). |
@@ -200,7 +229,8 @@ fetching, and claim wording.
   audit reports. Add `ui-report__action-title`, `__action-owner`,
   `__action-due`, `__action-priority`, `__action-criteria`, and
   `__action-source` when the action is a real workflow item. The status text
-  must be written out; do not rely on tone alone.
+  must be written out; do not rely on tone alone. The status occupies the side
+  rail on wide screens; the other action fields stay in the main text column.
 
 Decision brief pattern:
 
@@ -348,11 +378,11 @@ Evidence ledger pattern:
   deltas — they are not free-standing utilities.) Keep raw Markdown tables
   inside `ui-prose`; use `.ui-table` for curated evidence tables. If a
   `ui-report__evidence` block contains only a `ui-table-wrap`, the report layer
-  removes the inner frame so evidence tables do not look double-boxed.
-  Report tables preserve words by default so identifiers and headings do not
-  split into unreadable fragments in PDF. Add `ui-table--break-anywhere` only
-  for machine-token tables where avoiding horizontal overflow matters more than
-  preserving words.
+  removes the inner frame so evidence tables do not look double-boxed. Report
+  tables preserve words by default so identifiers and headings do not split into
+  unreadable fragments in PDF. Add `ui-table--break-anywhere` only for
+  machine-token tables where fixed, shrink-to-fit columns and forced wrapping
+  matter more than preserving words.
 - Every `<figure>` should include a `figcaption` using `ui-report__caption`.
 - Do not use raw color values. Theme with `--accent`; use status tones for
   status; use chart tokens only in chart figures.
@@ -473,12 +503,14 @@ from one of two routes:
   painting marks from the `--chart-N` palette so the figure prints exactly and
   carries no runtime.
 
-Whichever route, the figure frame is the same: wrap it in `ui-report__figure`,
-caption it with `ui-report__caption`, give it the standalone, portable
-`.ui-legend` data key (`@ponchia/ui/css/legend.css` — see
-[legends.md](./legends.md)), and pair every colour with a direct label, a
-pattern, **and** a fallback `ui-table` so the figure survives mono print and
-colour-vision deficiency.
+Whichever route, the figure frame is the same: wrap it in
+`ui-report__figure ui-figure`, caption it with
+`ui-report__caption ui-figure__caption`, put the rendered chart in
+`ui-figure__stage`, give it the standalone, portable `.ui-legend` data key
+(`@ponchia/ui/css/legend.css` — see [legends.md](./legends.md)), and pair every
+colour with a direct label, a pattern, **and** a fallback `ui-table` in
+`ui-figure__data` so the figure survives mono print and colour-vision
+deficiency.
 
 A Vega-Lite figure. The live mount is **`ui-screen-only`** and the fallback
 `ui-table` carries the data into print — a live chart bakes the on-screen theme
@@ -486,14 +518,16 @@ into its SVG/canvas at render time, so printing it would emit a dark-baked chart
 on white paper. Print the table; keep the chart for screen:
 
 ```html
-<figure class="ui-report__figure" role="group" aria-labelledby="chart-title">
-  <figcaption id="chart-title" class="ui-report__caption">
+<figure class="ui-report__figure ui-figure" role="group" aria-labelledby="chart-title">
+  <figcaption id="chart-title" class="ui-report__caption ui-figure__caption">
     Fig 1 - Weekly focus split
   </figcaption>
-  <div id="focus-chart" class="ui-screen-only" style="min-block-size: 240px">
-    <noscript>Chart needs JavaScript — the data is in the table below.</noscript>
+  <div class="ui-figure__stage ui-screen-only" style="--figure-min-block: 240px">
+    <div id="focus-chart" class="ui-figure__media">
+      <noscript>Chart needs JavaScript — the data is in the table below.</noscript>
+    </div>
   </div>
-  <div class="ui-table-wrap">
+  <div class="ui-figure__data ui-table-wrap">
     <table class="ui-table ui-table--dense">
       <caption>Chart source data</caption>
       <thead>
@@ -543,35 +577,42 @@ A frozen, token-themed inline `<svg>` for the same data — no runtime, prints
 exactly, with a `.ui-legend` key and the fallback table:
 
 ```html
-<figure class="ui-report__figure ui-print-exact" role="group" aria-labelledby="chart-title">
-  <figcaption id="chart-title" class="ui-report__caption">
+<figure class="ui-report__figure ui-figure ui-print-exact" role="group" aria-labelledby="chart-title">
+  <figcaption id="chart-title" class="ui-report__caption ui-figure__caption">
     Fig 1 - Weekly focus split
   </figcaption>
-  <ul class="ui-legend" aria-label="Series">
-    <li class="ui-legend__item">
-      <span
-        class="ui-legend__swatch"
-        style="--chart-color: var(--chart-1); --chart-pattern: var(--chart-pattern-1)"
-        aria-hidden="true"
-      ></span>
-      <span class="ui-legend__label">Research</span>
-    </li>
-    <li class="ui-legend__item">
-      <span
-        class="ui-legend__swatch"
-        style="--chart-color: var(--chart-2); --chart-pattern: var(--chart-pattern-2)"
-        aria-hidden="true"
-      ></span>
-      <span class="ui-legend__label">Delivery</span>
-    </li>
-  </ul>
-  <svg viewBox="0 0 360 160" role="img" aria-labelledby="focus-svg-title">
-    <title id="focus-svg-title">Weekly focus split</title>
-    <line x1="36" y1="132" x2="324" y2="132" stroke="var(--line)" />
-    <rect x="72" y="42" width="96" height="90" fill="var(--chart-1)" />
-    <rect x="200" y="77" width="96" height="55" fill="var(--chart-2)" />
-  </svg>
-  <div class="ui-table-wrap">
+  <div class="ui-figure__body ui-figure__body--key-right">
+    <div class="ui-figure__stage">
+      <svg class="ui-figure__media" viewBox="0 0 360 160" role="img" aria-labelledby="focus-svg-title focus-svg-desc">
+        <title id="focus-svg-title">Weekly focus split</title>
+        <desc id="focus-svg-desc">Research is 18 hours and delivery is 11 hours.</desc>
+        <line x1="36" y1="132" x2="324" y2="132" stroke="var(--line)" />
+        <rect x="72" y="42" width="96" height="90" fill="var(--chart-1)" />
+        <rect x="200" y="77" width="96" height="55" fill="var(--chart-2)" />
+      </svg>
+    </div>
+    <div class="ui-figure__key">
+      <ul class="ui-legend" aria-label="Series">
+        <li class="ui-legend__item">
+          <span
+            class="ui-legend__swatch"
+            style="--chart-color: var(--chart-1); --chart-pattern: var(--chart-pattern-1)"
+            aria-hidden="true"
+          ></span>
+          <span class="ui-legend__label">Research</span>
+        </li>
+        <li class="ui-legend__item">
+          <span
+            class="ui-legend__swatch"
+            style="--chart-color: var(--chart-2); --chart-pattern: var(--chart-pattern-2)"
+            aria-hidden="true"
+          ></span>
+          <span class="ui-legend__label">Delivery</span>
+        </li>
+      </ul>
+    </div>
+  </div>
+  <div class="ui-figure__data ui-table-wrap">
     <table class="ui-table ui-table--dense">
       <caption>Chart source data</caption>
       <thead>
@@ -820,8 +861,14 @@ important reports. The HTML stays the readable artifact; the sidecar lets a
 checker prove that claim IDs, source IDs, trust states, retrieval dates and
 high-risk decisions still line up after editing.
 
+The declarative contract ships as
+`@ponchia/ui/schemas/report-claims.v1.schema.json` for validators in any
+language. It is a schema only — `@ponchia/ui` does not ship a report generator
+or validation runtime.
+
 ```json
 {
+  "$schema": "https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.7/schemas/report-claims.v1.schema.json",
   "schemaVersion": "bronto-report-claims.v1",
   "report": { "title": "Decision readiness", "type": "decision" },
   "claims": [
@@ -843,6 +890,14 @@ high-risk decisions still line up after editing.
       "retrievedAt": "2026-06-08T10:00:00Z",
       "supports": ["claim-primary"]
     }
+  ],
+  "relations": [
+    {
+      "claimId": "claim-primary",
+      "sourceId": "source-primary",
+      "kind": "supports",
+      "note": "The metrics export supports the operational-risk conclusion."
+    }
   ]
 }
 ```

package/docs/sidenote.md

@@ -23,7 +23,13 @@ tradition — the channel for evidence, caveats, and provenance asides that belo
    (or a section) so the count starts at 1 there.
 2. **The margin gutter.** At the same breakpoint, give that container
    `padding-inline-end: calc(var(--sidenote-width) + var(--sidenote-gap))` so the
-   floated note has room. `--sidenote-width` defaults to `12rem`.
+   floated note has room. The two knobs are **root-scoped** (defaults `12rem` /
+   `2rem`) precisely so this calc resolves on any container — and overriding
+   either one on the container re-sizes the notes and the gutter together.
+   **This is load-bearing, not cosmetic:** without the gutter the floated note
+   spills past the page edge — a horizontal-overflow defect any visual QA pass
+   will flag. In a constrained shell that cannot spare a gutter, use the
+   in-flow `ui-sidenote` (which collapses inline) rather than `ui-marginnote`.
 
 ```html
 <article style="counter-reset: ui-sidenote">

package/docs/sources.md

@@ -44,7 +44,7 @@ host and add a tone. It draws a small pill with a leading trust dot:
 
 ```html
 <span class="ui-src ui-src--verified">Verified</span>
-<span class="ui-src ui-src--generated">AI-generated</span>
+<span class="ui-src ui-src--generated">Machine-generated</span>
 <span class="ui-src ui-src--stale">Stale · 14d</span>
 ```