@ponchia/ui 0.10.0 → 0.11.0

package/dist/css/sources.css

@@ -1 +1 @@
-@layer bronto{.ui-citation,.ui-source-card,.ui-provenance{--src-tone: var(--text-dim)}.ui-src{--src-tone: var(--text-dim);align-items: center;background: var(--panel-soft);border: 1px solid color-mix(in srgb,var(--src-tone) 45%,var(--line));border-radius: var(--radius-pill);color: var(--text-soft);display: inline-flex;font-size: var(--text-2xs);gap: 0.35rem;padding: 0.08rem 0.55rem;vertical-align: baseline}.ui-src::before{background: var(--src-tone);border-radius: 50%;block-size: 0.45rem;content: '';flex: none;inline-size: 0.45rem;print-color-adjust: exact}.ui-src--verified{--src-tone: var(--success)}.ui-src--reviewed{--src-tone: var(--accent)}.ui-src--generated{--src-tone: var(--info)}.ui-src--unverified{--src-tone: var(--text-dim)}.ui-src--stale{--src-tone: var(--warning)}.ui-src--conflict{--src-tone: var(--danger)}.ui-citation{color: var(--accent-text);font-family: var(--mono);font-size: 0.72em;font-weight: 600;text-decoration: none;vertical-align: super}.ui-citation:hover{text-decoration: underline}.ui-citation--chip{align-items: center;background: var(--panel-soft);border: 1px solid var(--line);border-radius: var(--radius-pill);color: var(--text-soft);display: inline-flex;font-size: var(--text-2xs);gap: 0.35rem;padding: 0.08rem 0.55rem;vertical-align: baseline}.ui-citation--chip::before{background: var(--src-tone);border-radius: 50%;block-size: 0.45rem;content: '';inline-size: 0.45rem;print-color-adjust: exact}.ui-source-list{display: grid;gap: var(--space-sm);list-style: none;margin: 0;min-inline-size: 0;padding: 0}.ui-source-list__item{margin: 0;min-inline-size: 0}.ui-source-card{background: var(--panel-soft);border: 1px solid var(--line);border-inline-start: 2px solid var(--src-tone);border-radius: var(--radius-md);display: grid;gap: 0.3rem;min-inline-size: 0;padding: 0.75rem 0.9rem;print-color-adjust: exact}.ui-source-card:target,.ui-source-card.is-source-active{box-shadow: 0 0 0 3px color-mix(in srgb,var(--src-tone) 22%,transparent);outline: 2px solid var(--src-tone);outline-offset: 2px}.ui-source-card > *{min-inline-size: 0}.ui-source-card__title{color: var(--text);font-size: var(--text-sm);font-weight: 600;margin: 0;overflow-wrap: break-word}.ui-source-card__origin{color: var(--text-soft);font-family: var(--mono);font-size: var(--text-2xs);letter-spacing: var(--tracking-wide);overflow-wrap: anywhere}.ui-source-card__time{color: var(--text-dim);font-family: var(--mono);font-size: var(--text-2xs);overflow-wrap: anywhere}.ui-source-card__excerpt{color: var(--text-soft);margin: 0;overflow-wrap: anywhere}.ui-source-card__actions{display: flex;flex-wrap: wrap;gap: 0.5rem;margin-block-start: 0.2rem}.ui-provenance{align-items: center;color: var(--text-dim);display: inline-flex;flex-wrap: wrap;font-family: var(--mono);font-size: var(--text-2xs);gap: 0.3rem 0.75rem;letter-spacing: var(--tracking-wide)}.ui-provenance__item{align-items: center;display: inline-flex;gap: 0.35rem}.ui-provenance__item::before{background: var(--src-tone);border-radius: 50%;block-size: 0.45rem;content: '';inline-size: 0.45rem;print-color-adjust: exact}@media (forced-colors: active){.ui-citation--chip::before,.ui-provenance__item::before,.ui-src::before{background: CanvasText}.ui-source-card{border-inline-start-color: CanvasText}}@media print{.ui-prose .ui-citation[href]::after,.ui-citation[href]::after{content: none}.ui-source-card,.ui-source-list__item{break-inside: avoid}}}
+@layer bronto{.ui-citation,.ui-source-card,.ui-provenance{--src-tone: var(--text-dim)}.ui-src{--src-tone: var(--text-dim);align-items: center;background: var(--panel-soft);border: 1px solid color-mix(in srgb,var(--src-tone) 45%,var(--line));border-radius: var(--radius-pill);color: var(--text-soft);display: inline-flex;font-size: var(--text-2xs);gap: 0.35rem;padding: 0.08rem 0.55rem;vertical-align: baseline}.ui-src::before{background: var(--src-tone);border-radius: 50%;block-size: 0.45rem;content: '';flex: none;inline-size: 0.45rem;print-color-adjust: exact}.ui-src--verified{--src-tone: var(--success)}.ui-src--reviewed{--src-tone: var(--accent)}.ui-src--generated{--src-tone: var(--info)}.ui-src--unverified{--src-tone: var(--text-dim)}.ui-src--stale{--src-tone: var(--warning)}.ui-src--conflict{--src-tone: var(--danger)}.ui-citation{color: var(--accent-text);font-family: var(--mono);font-size: max(0.72em,var(--text-2xs));font-weight: 600;text-decoration: none;vertical-align: super}.ui-citation:hover{text-decoration: underline}.ui-citation--chip{align-items: center;background: var(--panel-soft);border: 1px solid var(--line);border-radius: var(--radius-pill);color: var(--text-soft);display: inline-flex;font-size: var(--text-2xs);gap: 0.35rem;padding: 0.08rem 0.55rem;vertical-align: baseline}.ui-citation--chip::before{background: var(--src-tone);border-radius: 50%;block-size: 0.45rem;content: '';inline-size: 0.45rem;print-color-adjust: exact}.ui-source-list{display: grid;gap: var(--space-sm);list-style: none;margin: 0;min-inline-size: 0;padding: 0}.ui-source-list__item{margin: 0;min-inline-size: 0}.ui-source-card{background: var(--panel-soft);border: 1px solid var(--line);border-inline-start: 2px solid var(--src-tone);border-radius: var(--radius-md);display: grid;gap: 0.3rem;min-inline-size: 0;padding: 0.75rem 0.9rem;print-color-adjust: exact}.ui-source-card:target,.ui-source-card.is-source-active{box-shadow: 0 0 0 3px color-mix(in srgb,var(--src-tone) 22%,transparent);outline: 2px solid var(--src-tone);outline-offset: 2px}.ui-source-card > *{min-inline-size: 0}.ui-source-card__title{color: var(--text);font-size: var(--text-sm);font-weight: 600;margin: 0;overflow-wrap: break-word}.ui-source-card__origin{color: var(--text-soft);font-family: var(--mono);font-size: var(--text-2xs);letter-spacing: var(--tracking-wide);overflow-wrap: anywhere}.ui-source-card__time{color: var(--text-dim);font-family: var(--mono);font-size: var(--text-2xs);overflow-wrap: anywhere}.ui-source-card__excerpt{color: var(--text-soft);margin: 0;overflow-wrap: anywhere}.ui-source-card__actions{display: flex;flex-wrap: wrap;gap: 0.5rem;margin-block-start: 0.2rem}.ui-provenance{align-items: center;color: var(--text-dim);display: inline-flex;flex-wrap: wrap;font-family: var(--mono);font-size: var(--text-2xs);gap: 0.3rem 0.75rem;letter-spacing: var(--tracking-wide)}.ui-provenance__item{align-items: center;display: inline-flex;gap: 0.35rem}.ui-provenance__item::before{background: var(--src-tone);border-radius: 50%;block-size: 0.45rem;content: '';inline-size: 0.45rem;print-color-adjust: exact}@media (forced-colors: active){.ui-citation--chip::before,.ui-provenance__item::before,.ui-src::before{background: CanvasText}.ui-source-card{border-inline-start-color: CanvasText}}@media print{.ui-prose .ui-citation[href]::after,.ui-citation[href]::after{content: none}.ui-source-card,.ui-source-list__item{break-inside: avoid}}}

package/docs/compositions.md

@@ -22,6 +22,11 @@ states; do not present missing observations as success.
 
 The complete specimen is [service.html](https://ponchia.github.io/bronto-ui/demo/service.html). On a phone,
 navigation wraps and the compact metrics leave room for the work queue.
+The specimen owns deterministic loading, empty, error and stale scenarios,
+search/environment filtering and a local sample-job dialog. Unknown observations
+hide operational health claims; stale ones stay visibly qualified. Use Sync to
+recover. These behaviors are sample host logic, not package state management.
+
 Check the main action, every navigation destination, and a long account name
 at 360px and with a coarse pointer. A data table may scroll in its own region.
 
@@ -69,8 +74,8 @@ Use the core stylesheet plus `report-kit.css` for a standalone HTML report.
 Use real asset URLs in HTML; package specifiers resolve only in build tools.
 
 ```html
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.10.0/dist/bronto.css" />
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.10.0/dist/css/report-kit.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.11.0/dist/bronto.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.11.0/dist/css/report-kit.css" />
 <article class="ui-report">
   <header class="ui-report__cover ui-report__cover--compact">
     <h1 class="ui-report__title">Keep the current configuration</h1>
@@ -108,3 +113,19 @@ look technical.
 Use one dominant action per local task. Separate navigation, action, severity,
 and evidence status semantically even when they share a color family. Test
 light and dark together, and keep keyboard focus and reduced motion visible.
+
+## Embedded evidence
+
+Constrain the figure, decision grid or action list inside a wide page. Each
+uses its own available width. A two-up comparison wraps intrinsically even
+outside `ui-report`. Keep value columns readable and source links reachable;
+page overflow is an incomplete test. The container regression suite checks
+280/320/480px parents and a wide layout.
+
+Review long action status, legend names and citation markers. Keep chart
+annotations in their `viewBox` or supply an equivalent narrow fallback. Print
+uses document flow instead of size containment.
+
+For an existing application, review explicit typography overrides with the
+[0.11 migration recipe](migrations/0.10-to-0.11.md). A dependency pin does not
+remove consumer CSS that overrides the shared layer.

package/docs/discussion.md

@@ -0,0 +1,64 @@
+# Discussions
+
+Use the opt-in discussion leaf for readable thread lists, messages, quotations,
+and composers in a host application:
+
+```css
+@import '@ponchia/ui';
+@import '@ponchia/ui/css/discussion.css';
+```
+
+BrontoUI supplies the visual structure. The host owns storage, identity,
+thread resolution, text anchoring, unread state, and posting behavior. This leaf
+adds no JavaScript or editor dependency.
+
+## Thread structure
+
+```html
+<section class="ui-discussion" aria-labelledby="thread-title">
+  <header class="ui-discussion__header">
+    <div>
+      <h2 id="thread-title">Discussion</h2>
+      <p>Release notes</p>
+    </div>
+  </header>
+  <p class="ui-discussion__state">Open · passage attached</p>
+  <blockquote class="ui-discussion__quote">The selected passage.</blockquote>
+  <ol class="ui-discussion__messages">
+    <li class="ui-discussion__message">
+      <p class="ui-discussion__meta"><strong>Reviewer</strong> · today</p>
+      <p>Can we clarify this sentence?</p>
+    </li>
+  </ol>
+  <form class="ui-discussion__composer">
+    <label for="reply">Reply</label>
+    <textarea id="reply" name="reply" rows="4"></textarea>
+    <div class="ui-discussion__actions">
+      <button class="ui-button" type="submit">Post reply</button>
+    </div>
+  </form>
+</section>
+```
+
+Wire the form to the host's posting mechanism. Keep the draft when posting
+fails, disable duplicate submissions while a request is pending, and announce
+success only after confirmation. Use native buttons for actions and real links
+for navigation. A modal host must supply focus management and focus return.
+
+## Reading and recovery
+
+The styles use sentence case and sans-serif prose, wrap long text, and allow
+action rows to wrap in narrow panels. Keep secondary actions visually quiet
+with `ui-button--ghost`; posting is normally the primary action. The quote
+should remain visible when its anchor disappears, with a clear status and a
+host-owned way to choose a new target. Anchor status and thread resolution
+answer different questions and should be labelled separately.
+
+`ui-discussion__list` and `ui-discussion__item` style a host-owned thread index.
+Keep the list bounded and offer more results explicitly. If a canvas uses pins,
+provide the same discussions in a keyboard-accessible list. Pins, positions,
+and annotation geometry are outside this CSS leaf.
+
+The [discussion specimen](https://ponchia.github.io/bronto-ui/demo/discussion.html) includes a narrow-container
+example and a local reply/resolve demonstration. Its state lasts only until
+the page reloads.

package/docs/figure.md

@@ -61,7 +61,7 @@ when the same stage appears in a dashboard, doc page, or generated artifact.
 | --- | --- | --- |
 | `--figure-max-inline` | `.ui-figure__stage` | Maximum stage width, default `42rem`. |
 | `--figure-min-block` | `.ui-figure__stage` | Reserved stage height for late-rendered media. |
-| `--figure-key-width` | `.ui-figure__body--key-right` | Right key column width before mobile collapse. |
+| `--figure-key-width` | `.ui-figure__body--key-right` | Right key column width before the figure container stacks. |
 
 ## Boundary
 
@@ -76,3 +76,12 @@ when the same stage appears in a dashboard, doc page, or generated artifact.
 
 - [Usage](usage.md#static-reports) shows report figure composition.
 - [Reference](reference.md) lists the generated figure and report classes.
+
+## Narrow containers
+
+The figure establishes the named `bronto-figure` inline-size container. Its
+right-hand key stacks below 44rem of figure width, even in a wide browser.
+Print disables size containment and uses document flow. Keep annotation text
+and strokes within the authored `viewBox`; container layout does not reposition
+chart geometry. Verify a 280px parent with long legend names and a fallback
+table, not just a narrow viewport.

package/docs/migrations/0.10-to-0.11.md

@@ -0,0 +1,61 @@
+# Upgrade from 0.10 to 0.11
+
+0.11 completes the readable composition direction. The structured visual
+changes are in [`MIGRATIONS.json`](../../MIGRATIONS.json). JavaScript exports,
+classes, and tokens remain available. If you are coming from 0.9, apply the
+[0.10 migration](0.9-to-0.10.md) first, including the retired adapters/modal.
+
+## Review reusable layouts
+
+Figures use their own inline-size container to stack a right-hand key below
+44rem. Decision grids and action lists stack their rows below 32rem of their
+own width, including inside an otherwise wide report. Keep the documented
+`ui-report__decision-grid` and `ui-report__actions` wrappers. Two-up comparisons
+need no wrapper: they keep at most two columns, with a 16rem reading floor.
+
+Test a 280px and 320px parent inside a 1440px browser. Check that charts have
+useful drawing width, text columns remain readable, long labels wrap and all
+sources are reachable. Zero page overflow alone does not prove those things.
+Keep authored SVG labels and annotations inside the drawing's `viewBox`, or
+provide a narrow fallback with the same information. Bronto does not own chart
+geometry. Named size containment is disabled in print; review your PDF too.
+
+## Review typography overrides by role
+
+Figure captions, legends, generated labels and command groups use sans and
+sentence case. Technical log bodies and identifiers keep mono. Inline citation
+markers have a 12px floor at a default 16px root. Do not globally replace `Doto`:
+keep intentional hero/display and readout roles.
+
+1. Find explicit `font-family: var(--display)` and `var(--dot-font)` declarations
+   in your loaded consumer styles, plus old root-size and control-height rules.
+2. Classify each use: display identity, numeric readout, heading, instruction,
+   control label or metadata. Check grouped selectors individually.
+3. Remove overrides that recreate old generic styles. Use `var(--sans)` for
+   local explanatory headings and labels; keep intentional display roles.
+4. Inspect complete tasks, not just the homepage. Include setup, result,
+   filtering, error/retry, source details and an empty state where applicable.
+5. Compare long names and translated text at narrow, laptop, and desktop widths,
+   in both themes, with keyboard and touch input.
+
+Consumer CSS outside a layer takes precedence over the package's `bronto` layer.
+Updating the package alone cannot change those explicit overrides. A prepared
+patch from an older application revision must be reintegrated and checked
+against current source before it can count as migration evidence.
+
+## Verify the package and consumer together
+
+Install the packed candidate into an isolated consumer checkout before changing
+production pins. Record the exact package version, consumer revision and screens
+checked. Update the dependency and registry lock file together after publication;
+do not commit a task-local tarball path into a production lock file.
+
+Use the [composition guide](../compositions.md) for the service's local state
+scenarios, container boundaries and report reading/print checks. Existing package
+checks remain necessary; real consumer tasks provide additional evidence.
+
+## Optional discussion UI
+
+Import `@ponchia/ui/css/discussion.css` for thread lists, quotations, messages,
+and composers. The new `ui-discussion` vocabulary is additive. It carries no
+posting behavior, storage, or editor dependency; see [Discussions](../discussion.md).

package/docs/package-contract.md

@@ -222,6 +222,10 @@ semantic versioning contract for the surfaces listed here.
 | `./docs/adr/0005-productive-tools-and-editorial-reports.md` | `./docs/adr/0005-productive-tools-and-editorial-reports.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/migrations/0.9-to-0.10.md` | `./docs/migrations/0.9-to-0.10.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 | `./docs/adr/0006-trusted-publishing.md` | `./docs/adr/0006-trusted-publishing.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
+| `./docs/migrations/0.10-to-0.11.md` | `./docs/migrations/0.10-to-0.11.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
+| `./css/discussion.css` | `./dist/css/discussion.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
+| `./css/unlayered/discussion.css` | `./css/discussion.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
+| `./docs/discussion.md` | `./docs/discussion.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
 
 ## Shipped Files Allowlist
 
@@ -264,6 +268,7 @@ always includes `package.json`, `README.md`, `LICENSE`, and
 | `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/discussion.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. |
 | `docs/connectors.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
@@ -304,6 +309,7 @@ always includes `package.json`, `README.md`, `LICENSE`, and
 | `docs/adr/0005-productive-tools-and-editorial-reports.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/migrations/0.9-to-0.10.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 | `docs/adr/0006-trusted-publishing.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
+| `docs/migrations/0.10-to-0.11.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
 
 ## Artifact Provenance
 
@@ -316,7 +322,7 @@ result. The listed gates are part of `npm run check`.
 | Package manifest | `package.json` | docs/package-contract.md | `npm run package-contract:build` | check:fresh; check:exports; check:pack; check:consumer-surface; check:consumer-types; check:publint; check:attw | The complete export/file matrix in this document is generated from the manifest; packed tarball imports, concrete file resolution, and package-level type resolution are smoke-tested in clean consumers. |
 | 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 (47 layered outputs) | `npm run dist:build` | check:dist; check:exports; check:component-matrix | Default bundle and direct layered leaf imports are generated from authored CSS, size-gated, and coverage-owned as foundation or component leaves. |
+| Authored CSS graph | `css/core.css plus css/*.css leaves` | dist/bronto.css; dist/css/*.css (48 layered outputs) | `npm run dist:build` | check:dist; check:exports; check:component-matrix | Default bundle and direct layered leaf imports are generated from authored CSS, size-gated, and coverage-owned as foundation or component leaves. |
 | JSDoc-authored public JS | `behaviors/; annotations/; connectors/; react/; solid/; qwik/; svelte/; vue/` | adjacent *.d.ts and *.d.ts.map files | `npm run dts:emit` | check:dts-emit; check:types; check:consumer-surface; check:consumer-types; check:behavior-matrix; check:attw; check:publint | Declarations are emitted from the shipped JS, package subpath imports are compiled from a packed clean consumer, and public behavior exports are docs/unit/browser owned. |
 | Glyph registry | `glyphs/glyphs.js` | glyphs/glyphs.d.ts | `npm run glyphs:build` | check:glyphs; check:unit | 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).
 
-- 683 classes across 186 component groups
+- 695 classes across 187 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`,
@@ -487,6 +487,23 @@ each one matches a real selector in the stylesheet.
 | `cls.diffRowRemove` | `ui-diff__row--remove` | modifier |
 | `cls.diffSplit` | `ui-diff--split` | modifier |
 
+### `.ui-discussion`
+
+| Registry key | Class | Kind |
+| --- | --- | --- |
+| `cls.discussion` | `ui-discussion` | base |
+| `cls.discussionActions` | `ui-discussion__actions` | part |
+| `cls.discussionComposer` | `ui-discussion__composer` | part |
+| `cls.discussionHeader` | `ui-discussion__header` | part |
+| `cls.discussionHint` | `ui-discussion__hint` | part |
+| `cls.discussionItem` | `ui-discussion__item` | part |
+| `cls.discussionList` | `ui-discussion__list` | part |
+| `cls.discussionMessage` | `ui-discussion__message` | part |
+| `cls.discussionMessages` | `ui-discussion__messages` | part |
+| `cls.discussionMeta` | `ui-discussion__meta` | part |
+| `cls.discussionQuote` | `ui-discussion__quote` | part |
+| `cls.discussionState` | `ui-discussion__state` | part |
+
 ### `.ui-display`
 
 | Registry key | Class | Kind |

package/docs/reporting.md

@@ -60,18 +60,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.10.0/dist/bronto.css" />
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.10.0/dist/css/report-kit.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.11.0/dist/bronto.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.11.0/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.10.0/dist/bronto.css" />
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.10.0/dist/css/report.css" />
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.10.0/dist/css/dataviz.css" />
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.10.0/dist/css/annotations.css" />
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.10.0/dist/css/legend.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.11.0/dist/bronto.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.11.0/dist/css/report.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.11.0/dist/css/dataviz.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.11.0/dist/css/annotations.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.11.0/dist/css/legend.css" />
 ```
 
 The CDN serves the package's own `fonts/` next to the CSS, so font URLs resolve
@@ -885,7 +885,7 @@ or validation runtime.
 
 ```json
 {
-  "$schema": "https://cdn.jsdelivr.net/npm/@ponchia/ui@0.10.0/schemas/report-claims.v1.schema.json",
+  "$schema": "https://cdn.jsdelivr.net/npm/@ponchia/ui@0.11.0/schemas/report-claims.v1.schema.json",
   "schemaVersion": "bronto-report-claims.v1",
   "report": { "title": "Decision readiness", "type": "decision" },
   "claims": [

package/docs/stability.md

@@ -1,7 +1,7 @@
 # Public API stability
 
 `@ponchia/ui` is pre-1.0. Breaking changes ship in the minor (`0.x.0`), and
-patches are non-breaking. In practical terms: **PATCH releases (`0.10.x`) are
+patches are non-breaking. In practical terms: **PATCH releases (`0.11.x`) are
 non-breaking bug-fixes and additive changes — safe to upgrade without review;
 MINOR releases (`0.x.0`) may include breaking changes and consumers should
 review the CHANGELOG before upgrading.** Pin `~0.x` (tilde) to accept only
@@ -100,6 +100,7 @@ current public-surface matrix and the release policy above still applies.
 | Report kit roll-up (`css/report-kit.css`) | Stable additive | A convenience `@import` of the complete static-report vocabulary. The set of leaves it bundles may grow additively; each leaf also stays individually exported. Opt-in, not in the default bundle. |
 | Figure stage (`css/figure.css`, `.ui-figure*`) | Stable additive | Figure class names, overlay/key/fallback-data slots, and report composition hooks are public. Opt-in, not in the default bundle. Bronto owns the figure frame, not chart rendering, scales, or data mapping. |
 | Annotations (`@ponchia/ui/annotations`, `css/annotations.css`, `.ui-annotation*`) | Stable additive | SVG annotation class names, recipe option names, and helper function names are public. Helper internals and exact path-control heuristics may tune before 1.0. Opt-in, not in the default bundle. Rich placement, renderer, editing, and chart/diagram adapter APIs belong to the sibling `@ponchia/annotations` package; `@ponchia/ui` does not depend on it at runtime or through public declarations. |
+| Discussions (`css/discussion.css`, `.ui-discussion*`) | Stable additive | Thread-list, message, quotation and composer class names are public. Opt-in, not in the default bundle. The host owns posting, persistence, identity, resolution, text anchors and focus management. |
 | Legends (`css/legend.css`, `.ui-legend*`, `@ponchia/ui/behaviors` `initLegend`) | Stable additive | Legend class names, recipe option names, and the `bronto:legend:toggle` event contract (`aria-pressed="true"` ⇒ shown) are public. Opt-in, not in the default bundle; swatch colours are gated to the `--chart-*` palette. |
 | Marks (`css/marks.css`, `.ui-mark*`, `.ui-bracket-note*`) | Stable additive | Text-mark and bracket-note class names and recipe option names are public. Opt-in, not in the default bundle. Uses semantic tones only. |
 | Connectors (`@ponchia/ui/connectors`, `css/connectors.css`, `.ui-connector*`, `initConnectors`) | Stable additive | Connector class names, the `data-bronto-connector` attribute contract, geometry helper function names, and recipe options are public. Helper internals/heuristics may tune before 1.0. Opt-in, not in the default bundle. |

package/llms.txt

@@ -45,7 +45,7 @@ the path changes from source `css/` to built `dist/css/`:
 <!-- installed locally -->
 <link rel="stylesheet" href="./node_modules/@ponchia/ui/dist/css/<leaf>.css" />
 <!-- or from a CDN; pin the version (pre-1.0, breaking changes ship in the minor) -->
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.10.0/dist/css/<leaf>.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.11.0/dist/css/<leaf>.css" />
 ```
 
 The flattened default bundle is `dist/bronto.css` (bundler shorthand

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@ponchia/ui",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "type": "module",
-  "description": "CSS-first identity and UI layer for services, tools, sites, and reports — works in HTML, every framework, and PDF, no component runtime. Shared app shell, forms, tables, workflow chrome, plus opt-in analytical/report primitives. Monochrome with one rationed accent. Zero runtime dependencies.",
+  "description": "CSS-first identity and UI layer for services, tools, sites, and reports \u2014 works in HTML, every framework, and PDF, no component runtime. Shared app shell, forms, tables, workflow chrome, plus opt-in analytical/report primitives. Monochrome with one rationed accent. Zero runtime dependencies.",
   "keywords": [
     "css",
     "ui",
@@ -78,6 +78,7 @@
     "docs/vega.md",
     "docs/figure.md",
     "docs/annotations.md",
+    "docs/discussion.md",
     "docs/legends.md",
     "docs/marks.md",
     "docs/connectors.md",
@@ -117,7 +118,8 @@
     "docs/compositions.md",
     "docs/adr/0005-productive-tools-and-editorial-reports.md",
     "docs/migrations/0.9-to-0.10.md",
-    "docs/adr/0006-trusted-publishing.md"
+    "docs/adr/0006-trusted-publishing.md",
+    "docs/migrations/0.10-to-0.11.md"
   ],
   "style": "./dist/bronto.css",
   "scripts": {
@@ -526,7 +528,11 @@
     "./docs/compositions.md": "./docs/compositions.md",
     "./docs/adr/0005-productive-tools-and-editorial-reports.md": "./docs/adr/0005-productive-tools-and-editorial-reports.md",
     "./docs/migrations/0.9-to-0.10.md": "./docs/migrations/0.9-to-0.10.md",
-    "./docs/adr/0006-trusted-publishing.md": "./docs/adr/0006-trusted-publishing.md"
+    "./docs/adr/0006-trusted-publishing.md": "./docs/adr/0006-trusted-publishing.md",
+    "./docs/migrations/0.10-to-0.11.md": "./docs/migrations/0.10-to-0.11.md",
+    "./css/discussion.css": "./dist/css/discussion.css",
+    "./css/unlayered/discussion.css": "./css/discussion.css",
+    "./docs/discussion.md": "./docs/discussion.md"
   },
   "overrides": {
     "adm-zip": "0.6.0",