@aceshooting/lyra-ui 19.0.1 → 20.0.1

package/llms/components/lr-graph-query-builder.md

@@ -7,9 +7,12 @@
 - **Family** `components/data/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.1.0` — see the maturity and deprecation policy in `llms/shared.md`
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
-- **Deprecations** none
+- **Deprecated event** `lr-before-query-delete` since `19.0.1`; use event `addEventListener('lr-query-delete-request', ...)`; removal not before `21.0.0` — Renamed to the library's dominant *-request veto-event convention; both names fire from the same gesture with an identical detail during the compatibility window, and either may veto.
+- **Deprecated event** `lr-before-query-load` since `19.0.1`; use event `addEventListener('lr-query-load-request', ...)`; removal not before `21.0.0` — Renamed to the library's dominant *-request veto-event convention; both names fire from the same gesture with an identical detail during the compatibility window, and either may veto.
+- **Deprecated event** `lr-before-query-run` since `19.0.1`; use event `addEventListener('lr-query-run-request', ...)`; removal not before `21.0.0` — Renamed to the library's dominant *-request veto-event convention; both names fire from the same gesture with an identical detail during the compatibility window, and either may veto.
+- **Deprecated event** `lr-before-query-save` since `19.0.1`; use event `addEventListener('lr-query-save-request', ...)`; removal not before `21.0.0` — Renamed to the library's dominant *-request veto-event convention; both names fire from the same gesture with an identical detail during the compatibility window, and either may veto.
 - **Optional peers** none
-- **Themeable via** 27 parts, 16 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 28 parts, 16 custom properties — see this component's own `@csspart`/`@cssprop` list below
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
 
 ---
@@ -72,21 +75,28 @@ visible label element, so slotted/property/localized label text is also the anno
 effective native validity, including custom errors and own/fieldset validation barring.
 `lr-invalid` is a cancelable bubbling/composed alias; vetoing it suppresses the native invalid
 default. Run, save, load, and delete share one two-phase contract: cancelable
-`lr-before-query-run`, `lr-before-query-save`, `lr-before-query-load`, and
-`lr-before-query-delete` requests precede any local effect; non-cancelable `lr-query-run`,
+`lr-query-run-request`, `lr-query-save-request`, `lr-query-load-request`, and
+`lr-query-delete-request` requests precede any local effect; non-cancelable `lr-query-run`,
 `lr-query-save`, `lr-query-load`, and `lr-query-delete` notifications follow only when accepted.
-The matching before/accepted pair reuses one frozen payload: `{ query }` for run,
+The matching request/accepted pair reuses one frozen payload: `{ query }` for run,
 `{ name, query }` for save, `{ queryId, query }` for load, and `{ queryId }` for delete.
 Run validates before its request. Save veto preserves the draft name. Load requests frozen
 `{ queryId, query }` before changing `value`, so veto preserves the current query; its accepted event
 fires after the new value is applied. Delete remains controlled, so the host removes the accepted
-id from `savedQueries`. The full set is `lr-input`, `lr-validity-change`, `lr-invalid`, and those
-eight phased action events.
-
-Migration note: veto save in `lr-before-query-save`, not `lr-query-save`; the existing
-`lr-query-*` action events are accepted, non-cancelable notifications. **Slots:** `actions`,
+id from `savedQueries`. Each request also fires a **deprecated** `lr-before-query-run` /
+`lr-before-query-save` / `lr-before-query-load` / `lr-before-query-delete` alias immediately after
+its canonical `-request` counterpart, from the same gesture with the same frozen detail; either
+event may veto. The aliases are slated for removal in 21.0.0 — migrate listeners to the
+`lr-query-*-request` names. The full set is `lr-input`, `lr-validity-change`, `lr-invalid`, and
+those twelve phased action events (four requests, four deprecated aliases, four accepted
+notifications).
+
+Migration note: veto save in `lr-query-save-request` (or its deprecated `lr-before-query-save`
+alias), not `lr-query-save`; the existing `lr-query-*` action events are accepted, non-cancelable
+notifications. **Slots:** `actions`,
 `label`, `hint`, `error`. **CSS
-parts:** `base`, `label`, `hint`, `error` (the three form-control chrome parts every
+parts:** `base`, `form-control-label` (`label` remains as a compatibility alias on the same node),
+`hint`, `error` (the three form-control chrome parts every
 form-associated control in this library exposes — see `lr-select`), `path-fields`, `start-input`,
 `end-input`, `relationship-picker`, `relationship-chips`, `node-type-picker`, `node-type-chips`,
 `direction`, `filter-group`, `min-hops`, `max-hops`, `footer`, `run-button`, `save-button`,

package/llms/components/lr-grounding-summary.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 16 parts, 0 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 17 parts, 0 custom properties — see this component's own `@csspart`/`@cssprop` list below
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
 
 ---
@@ -53,6 +53,11 @@ rendering, or events. Usable display fields are captured once while emitted sele
 objects retain their original identity. Malformed rows and later duplicate ids are omitted; the
 first valid occurrence wins.
 
+At most 500 citations render as `evidence-item` rows; a `citations` array past that length still
+reports its true count in `evidence-count` but renders a localized `limit` notice after the list
+rather than mounting an unbounded number of rows. The full citation set is still forwarded to the
+composed `lr-claim-evidence` for claim-to-citation lookup, which applies its own render cap.
+
 **Events:** `lr-citation-select` (`detail: CitationSelectEventDetail` from
 `@aceshooting/lyra-ui/ai` = `{ citation: Citation }`) — emitted when an evidence badge is activated.
 The inner `lr-citation-badge`'s generic activation is stopped at this composition boundary; this
@@ -69,7 +74,8 @@ row), `warnings` (omitted when there are none), `warnings-heading`, `warnings-co
 its semantics survive list-style resets),
 `evidence-item` (one `<li>` containing a badge + always-visible label/span text),
 `evidence-label` (omitted when `Citation.label` is unset), `evidence-span` (the formatted
-`Citation.span` range, omitted when unset), `claims` (the claim/evidence region), `empty`
+`Citation.span` range, omitted when unset), `limit` (localized notice shown when `citations` exceeds
+the 500-citation render ceiling), `claims` (the claim/evidence region), `empty`
 (shown when `assessment` is `null`).
 
 **Themeable custom properties:** shared tokens only.

package/llms/components/lr-heatmap.md

@@ -348,8 +348,11 @@ color?: string; label?: string; partOfRamp?: boolean }`: a discrete legend key r
   "no data" color next to an N-step ramp) to exclude just that stop from the comparison; defaults to
   `true`. A caption-only stop (no `color`) is already excluded regardless of this flag.
 
-**Getters/methods:** `exportData('png')` returns a PNG data URL for the most recently completed
-canvas paint. It includes the painted axes, cells, focus/selection/annotation overlays, and frozen
+**Getters/methods:** `exportData('csv'|'png')` returns a spreadsheet-safe CSV snapshot of the
+underlying matrix/calendar values or a PNG data URL for the most recently completed canvas paint.
+The CSV form reads `data` directly (not any bounded render cache) and omits no-data cells — one
+`row,column,value` row per real matrix cell, or `date,value` per real calendar day. The PNG form
+includes the painted axes, cells, focus/selection/annotation overlays, and frozen
 label bands while `stickyLabels` is enabled; the DOM legend, tooltip, and accessible-cell buttons
 are deliberately excluded. It returns `''` before a completed paint, while rendering is deferred or
 zero-sized, after disconnect, or when the browser cannot encode the snapshot. `refreshTheme()` —

package/llms/components/lr-histogram.md

@@ -48,10 +48,12 @@ maxSamples?)` appends finite raw samples and optionally retains only the newest
 `appendData()` remains a working compatibility adapter (no longer deprecated); prefer
 `appendSamples()` for new code.
 
-**Events:** `lr-zoom`, `lr-datum-activate`, `lr-point-click`, `lr-before-datum-visibility-change`
-(cancelable), `lr-datum-visibility-change`, `lr-before-legend-visibility-change` (cancelable), and
+**Events:** `lr-zoom`, `lr-datum-activate`, `lr-point-click`, `lr-datum-visibility-change-request`
+(cancelable), `lr-datum-visibility-change`, `lr-legend-visibility-change-request` (cancelable), and
 `lr-legend-visibility-change` — inherited; `lr-point-click`'s `index` is the bucket index and
 `label` the generated bucket range string (`"lo–hi"`, both bounds at one decimal place).
+`lr-before-datum-visibility-change`/`lr-before-legend-visibility-change` are deprecated aliases of
+the two `*-request` events above (removal not before 21.0.0).
 The inherited datum-visibility events apply only to radial controllers; the histogram keeps its
 bar controller and dataset legend even with `legend-mode="datum"`.
 

package/llms/components/lr-json-schema-viewer.md

@@ -54,11 +54,13 @@ caps visual nesting indentation while preserving complete JSON Pointer paths;
 only.
 
 Rendering is capped independently at 500 schema nodes and 500 validation issues; `limit` and
-`issue-limit` show their respective truncation as ordinary, non-live status text. Newly reaching or
-changing either ceiling after the initial baseline appends the localized message to the shared
-polite light-DOM announcement sink; initial and reconnect renders stay silent. Issues are indexed by
-path once before recursive rendering instead of rescanning the full input for every node. Cycles stop
-at the repeated node rather than recursing. **Slots:** none. **Optional peer deps:** none.
+`issue-limit` show their respective truncation as ordinary, non-live status text. When `selectedPath`
+resolves beyond the 500-node ceiling, that node and its resolvable ancestor chain reserve positions
+inside the cap ahead of ordinary traversal order, so the controlled selection remains visible. Newly
+reaching or changing either ceiling after the initial baseline appends the localized message to the
+shared polite light-DOM announcement sink; initial and reconnect renders stay silent. Issues are
+indexed by path once before recursive rendering instead of rescanning the full input for every node.
+Cycles stop at the repeated node rather than recursing. **Slots:** none. **Optional peer deps:** none.
 
 ```ts
 import '@aceshooting/lyra-ui/components/lr-json-schema-viewer.js';

package/llms/components/lr-line-chart.md

@@ -41,11 +41,14 @@ of every entry in these lists.**
 `refreshTheme()`.
 
 **Events:** `lr-zoom` (`detail: { zoomed: boolean }`), `lr-datum-activate`, `lr-point-click` (`detail: { datasetIndex,
-index, label, value }`), `lr-before-legend-visibility-change` (cancelable), and
+index, label, value }`), `lr-legend-visibility-change-request` (cancelable), and
 `lr-legend-visibility-change` (commit; both legend events carry `datasetIndex`, `visible`, and the
-complete `hiddenDatasets` snapshot).
-Radial category legends additionally emit `lr-before-datum-visibility-change` (cancelable) and
+complete `hiddenDatasets` snapshot). `lr-before-legend-visibility-change` is a **deprecated** alias
+of `lr-legend-visibility-change-request` (removal not before 21.0.0).
+Radial category legends additionally emit `lr-datum-visibility-change-request` (cancelable) and
 `lr-datum-visibility-change`, carrying `index`, `visible` and the frozen `hiddenDatums` snapshot.
+`lr-before-datum-visibility-change` is a **deprecated** alias of `lr-datum-visibility-change-request`
+(removal not before 21.0.0).
 
 **Slots:** default JSON configuration script, `data-table`, `center`.
 

package/llms/components/lr-locale-picker.md

@@ -38,7 +38,10 @@ wrapper can override size-tier fallbacks; a value set directly on the element st
 readonly LyraLocaleEntry[]`, `LyraLocaleEntry { tag: string; label?: string; country?: string }`.
   `undefined` (the default) auto-discovers the registry; every supplied array (either form),
   including an authoritative `[]`, overrides it entirely — a curated subset, custom order,
-  custom labels, or a locale offered before its strings are registered. Explicit catalogs are
+  custom labels, or a locale offered before its strings are registered. An entry's `label` overrides
+  the derived `localeNativeName(tag)` endonym only when it is non-blank; an explicitly blank (or
+  whitespace-only) `label` is treated the same as an omitted one and still falls back to
+  `localeNativeName(tag)`. Explicit catalogs are
   capped, cloned and frozen at assignment; mutate a new array/entry and reassign it to update the
   list. `country` (ISO 3166-1 alpha-2 or alpha-3) overrides a row's derived flag — e.g.
   showing Lebanon's flag for an `'ar'` row instead of the library's default Saudi Arabia mapping;

package/llms/components/lr-map.md

@@ -420,10 +420,12 @@ large collection is invisible until someone walks the data by hand. Both `chorop
 reduced figure in the feature — a log, a bucket, an index — and keep the exact value in your own
 payload beside the map.
 
-- `label: string = ''` — purpose-specific accessible name for MapLibre's actual focusable canvas.
+- `label?: string` — purpose-specific accessible name for MapLibre's actual focusable canvas.
   A nonempty host `aria-label` remains on the host and is not duplicated onto the canvas; the canvas
-  uses `label` or the localized map name. An explicitly empty host `aria-label` is preserved as an
-  empty canvas name. The non-semantic `[part="base"]` wrapper is not named instead.
+  uses `label` or the localized map name. Omitting `label` localizes the default `map` message; an
+  explicit empty string suppresses that default and renders an empty canvas name. An explicitly
+  empty host `aria-label` is separately preserved as an empty canvas name. The non-semantic
+  `[part="base"]` wrapper is not named instead.
 
 **Authoring types:** `LyraMapLegendEntry`, `LyraMapLegendPattern`, `LyraMapLegendProjection`, `LyraMapChoroplethLayer`,
 `LyraMapGeoJsonDataLayer`, `LyraMapDataLayerKind`, `LyraMapClusterOptions`, `LyraMapHeatmapOptions`,

package/llms/components/lr-memory-panel.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 18 parts, 3 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 19 parts, 3 custom properties — see this component's own `@csspart`/`@cssprop` list below
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
 
 ---
@@ -45,6 +45,9 @@ duplicates are omitted first-wins before empty state, focus/disclosure state, co
 rendering, or actions. Rows whose `text` is missing, nonstring, blank, or whitespace-only are also
 omitted without hiding later valid memories.
 
+At most 500 items per section render as `item` rows; a section's list past that length renders a
+localized `limit` notice after that section's list rather than mounting an unbounded number of rows.
+
 **Events:**
 
 - `lr-add` (`detail: LyraMemoryAddDetail` = `{ memory: LyraMemoryItem }`) — a pending "promote to
@@ -66,7 +69,8 @@ somewhere to land after a confirmation resolves), `item-row`, `item-text`, `conf
 `data-tone`; omitted when `confidence` is unset), `expand-toggle` / `item-body` (both omitted when
 `provenance` is unset; `item-body` is `hidden` while collapsed), `item-actions`, `add-button`,
 `remove-button`, `forget-all-button`, `forget-all-confirm` (the `lr-confirm-bar` that replaces
-`forget-all-button` while the bulk confirmation is pending).
+`forget-all-button` while the bulk confirmation is pending), `limit` (localized notice shown when a
+section's items exceed the 500-item render ceiling).
 
 **Keyboard/focus contract:** activating an action from the keyboard replaces that control with an
 `lr-confirm-bar`, and focus moves into the bar (landing on Deny, the safe action) rather than

package/llms/components/lr-mention-popover.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 6 parts, 7 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 6 parts, 8 custom properties — see this component's own `@csspart`/`@cssprop` list below
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
 
 ---
@@ -113,13 +113,16 @@ renders `open="false"` on first paint)
 `--lr-color-brand-quiet` token, so a consumer can retheme just this highlighted/active row without
 repainting every other component that reuses the same shared token.
 `--lr-mention-popover-option-disabled-opacity` (default `0.5`) — opacity of a row whose `items`
-entry sets `disabled`. Plus shared tokens —
+entry sets `disabled`. `--lr-mention-popover-option-active-color` (default `var(--lr-color-brand)`)
+— text color of the `aria-selected="true"` (keyboard-highlighted) suggestion row, independent of
+`--lr-mention-popover-option-active-bg`: the same component-scoped indirection over
+`--lr-color-brand`, applied to the row's own sibling text-color rule. Plus shared tokens —
 `--lr-space-xs`/`-s`/`-m` (popup padding,
 row padding/gap), `--lr-radius`
 (row corners — the popup's own corner is the overlay family's, below),
 `--lr-transition-fast` (open/close
-transition), `--lr-color-brand` (selected-row
-text), `--lr-color-text-quiet`/`--lr-color-text` (description text, full-contrast on the active
+transition),
+`--lr-color-text-quiet`/`--lr-color-text` (description text, full-contrast on the active
 row), and `--lr-popover-viewport-clamp` (default `92vw`) — the shared narrow-viewport ceiling the
 popup's max-inline-size is `min()`ed against, alongside its own `24rem` cap and the positioner's
 available space. See `lr-tour` for the shared-clamp note.

package/llms/components/lr-message-actions.md

@@ -48,7 +48,9 @@ opens). `feedbackPending: boolean` (read-only, nonreflecting) — true only whil
 feedback control awaits settlement; it has no `feedback-pending` attribute or change event.
 `revealOnInteraction: boolean = false` (reflected, attribute `reveal-on-interaction`) — hides
 the bar until the closest `lr-chat-message` ancestor is hovered, or the toolbar contains focus.
-`label: string = ''` — accessible name override for the toolbar. `accessibleLabel: string | null =
+`label?: string` — accessible name override for the toolbar. Omitting it localizes the default
+`messageActionsLabel` message; an explicit empty string suppresses that default and renders no
+label. `accessibleLabel: string | null =
 null` (attribute `aria-label`) — overrides the toolbar's computed accessible name, winning over
 `label` and the localized default; attribute-reflects from a host-level `aria-label`.
 

package/llms/components/lr-message-parts.md

@@ -34,8 +34,14 @@ are still derived from the full sequence first, in the same linear prepass, so a
 stays stable even once an earlier citation rolls out of the rendered window. Opt in for a message
 that can grow an unusually large number of interleaved parts (e.g. a long agentic run with many
 tool-call/tool-result pairs), where unbounded live DOM can visibly stall the main thread.
-`renderPart?: MessagePartRenderer` (attribute: false), where returning `undefined` delegates that
-part to the built-in renderer; `accessibleLabel: string | null = null` (attribute `aria-label`).
+`renderPart?: MessagePartRenderer` (attribute: false) — returning `undefined` for a part delegates
+it to the built-in renderer, keeping every built-in affordance intact; any other return fully
+replaces that part's built-in rendering, including every interactive affordance the built-in
+renderer would otherwise wire up for it (the `error` part's retry button's `lr-part-retry`, a
+`citation` part's activation `lr-citation-select`, and the composed `<lr-tool-call-chip>`/
+`<lr-tool-result-view>`/`<lr-attachment-chip>`/`<lr-widget-renderer>` children's own events) — a
+host overriding an interactive part type must reimplement whatever of that interaction it still
+wants; `accessibleLabel: string | null = null` (attribute `aria-label`).
 
 Unsupported direct or `content-mode` attribute values normalize and reflect as `markdown`.
 

package/llms/components/lr-mind-map.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 8 parts, 2 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 9 parts, 2 custom properties — see this component's own `@csspart`/`@cssprop` list below
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
 
 ---
@@ -32,6 +32,14 @@ LyraTopic[] }`; a single root sits at the center, multiple roots hang off an imp
   ring); expansion state afterward is component-managed per topic id and survives `topics`
   reassignment
 
+Above 500 currently-visible nodes (per the current expand/collapse state), the SVG and the
+parallel sr-only tree both render a deterministic, connectivity-preserving, subtree-size-weighted
+sample instead of every node: a kept node's parent, if any, is always kept too (no floating nodes
+with a dangling connector or a gap in the `role="tree"` walk), and a larger branch keeps
+proportionally more of its own nodes than a small one, sampled evenly across a wide/flat branch's
+own child list rather than dropping its tail outright. A surviving node keeps the position the
+full layout gave it. A localized "showing N of M" notice appears in `[part="limit"]`.
+
 **Events:** `lr-topic-select` (`detail: { topicId }`, a _leaf_ topic was activated),
 `lr-topic-toggle` (`detail: { topicId, expanded }`, a parent topic was activated, or auto-expanded by
 keyboard descent).
@@ -39,7 +47,8 @@ keyboard descent).
 **Slots:** none.
 
 **CSS parts:** `base`, `svg` (the single-tab-stop focus target), `node`, `node-label`, `link`
-(parent-child connector), `focus-ring` (keyboard focus ring), `live-region` (visually hidden
+(parent-child connector), `focus-ring` (keyboard focus ring), `limit` (the "showing N of M"
+render-cap notice, present only above 500 currently-visible nodes), `live-region` (visually hidden
 announcement region), `empty` (shown when `topics` is empty).
 
 **Themeable custom properties:** `--lr-mind-map-ring-gap` (default `6rem`, radius step per depth

package/llms/components/lr-option.md

@@ -153,7 +153,22 @@ An async `source` row can carry the same two fields (`start`, `end`) alongside i
   none. A blank return falls back to the raw value. Not consulted while an async `source` fetch has
   never yet resolved for this element — see "Unknown committed values" below; `loadingText` covers
   that window instead, since the value is not yet known to be unmatched at all
-- `appearance: 'filled' | 'outlined' | 'filled-outlined' = 'outlined'` (reflected)
+- `loading: boolean = false` (reflected) — mirrors `lr-select`'s own `loading`: whether a
+  committed value's real label may still be pending because its `<lr-option>` catalog hasn't
+  arrived yet (e.g. mounted asynchronously with no `source` involved). While `true`, a committed
+  value that currently matches no option/row renders the localized `loadingText` placeholder in the
+  trigger label or the relevant `multiple` tag instead of the raw value, with no
+  `notInCatalog`/`[part='unknown-value']` badge, and the open listbox shows the same loading row a
+  `source` fetch in flight shows. Independent of `source`'s own async lifecycle — either condition
+  alone suppresses the unknown-value presentation. Never mutates `value`/`selectedOptions` itself,
+  and does not itself disable the trigger
+- `appearance: 'accent' | 'filled' | 'outlined' | 'filled-outlined' | 'plain' = 'outlined'`
+  (reflected) — the library's shared field-surface vocabulary, matching `lr-select`'s trigger.
+  `outlined` (the default) is a bordered surface; `filled` swaps the border for a raised fill;
+  `filled-outlined` keeps both; `plain` drops both; `accent` paints the loud brand fill with
+  on-brand text (the placeholder, expand icon, adornments and `multiple` tags all ride that
+  on-brand color rather than the quiet-text tokens). An unsupported value, including a raw
+  attribute/property write outside this type, clamps to the `'outlined'` default
 - `placement: 'top' | 'bottom' = 'bottom'` (reflected; flip/shift can still keep the listbox in view)
 - `positioningStrategy: PlaceStrategy = 'fixed'` (attribute `positioning-strategy`, reflected) —
   the CSS positioning scheme the listbox is laid out with, spelled the same as on `lr-select`,
@@ -493,6 +508,11 @@ standard size supplies an aligned default), plus shared tokens. `--lr-combobox-g
 `--lr-space-xs`, the gap inside `[part='combobox']`) and `--lr-combobox-radius` (default
 `--lr-radius`, its corner radius) are both retunable without a `::part(combobox)` rule but, unlike
 the properties above, do not vary by `size` — the same `--lr-button-gap`/`-radius` pattern.
+`--lr-combobox-tag-bg` (default `var(--lr-color-brand-quiet)`), `--lr-combobox-tag-color` (default
+`var(--lr-color-text)`) and `--lr-combobox-tag-radius` (default `var(--lr-radius)`) retint a
+selected tag's background, text color and corner radius without a `::part(tag)` rule; `-tag-bg` is
+scoped independently of `--lr-combobox-option-active-bg`/`-option-badge-bg` below, which already
+scope the same shared `--lr-color-brand-quiet` token for their own purposes.
 
 The trigger row's own surface became public in 16.0.0, having been a private pair until then:
 `--lr-combobox-fill` (default `var(--lr-color-surface)`) and `--lr-combobox-border-color` (default
@@ -503,7 +523,10 @@ here wins over every treatment. `--lr-combobox-open-border-color` (default
 border before. Read the name as the state the listbox opens in rather than as a synonym for `open`:
 it is bound to `:focus-within`, so it also paints on a focused row whose listbox is closed — after
 an Escape dismissal, say. It is named for symmetry with `lr-select`'s
-`--lr-select-open-border-color`, which really is gated on `open`.
+`--lr-select-open-border-color`, which really is gated on `open`. `--lr-combobox-text-color`
+(default `inherit`) recolors the trigger's own text the same way; `appearance="accent"` defaults it
+instead to `var(--lr-color-on-brand)`, keeping placeholder, adornments and tag text readable on the
+loud brand fill.
 
 The shared field halo `--lr-form-control-focus-shadow` (default `none`) paints a `box-shadow`
 while this control is focused — one name for every field-shaped control in the library, so a

package/llms/components/lr-otp-input.md

@@ -45,7 +45,9 @@ Public `--lr-otp-input-*` theme inputs stay undeclared on the host, so an ancest
 can override appearance fallbacks; a value set directly on the element still wins.
 
 **Properties:** `label`, `hint`, `errorText` (`error-text`);
-`appearance: 'outlined' | 'filled' | 'filled-outlined' | 'contained' = 'outlined'` (reflected);
+`appearance: 'outlined' | 'filled' | 'filled-outlined' | 'contained' = 'outlined'` (reflected) —
+does not implement the shared vocabulary's `accent`/`plain` tiers; an unsupported value, including
+a raw attribute/property write outside this type, clamps to the `'outlined'` default;
 `autofocus: boolean = false`; `autosubmit: boolean = false` (reflected);
 `size: LyraSize = 'm'` (reflected after an explicit property/attribute write, accepting
 `2xs`/`xs`/`s`/`m`/`l`/`xl` and the shared aliases). While unset, its generic font/radius/height

package/llms/components/lr-phone-input.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 14 parts, 17 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 15 parts, 17 custom properties — see this component's own `@csspart`/`@cssprop` list below
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
 
 ---
@@ -187,9 +187,13 @@ the reset default, or prior interaction state.
 `form.reset()` restores the original declarative `value` and the default country.
 
 **Slots:** `label`, `hint`, `error`, `country-prefix` (optional visual before the country selector,
-such as a consumer-owned `<lr-flag>`; no flag package is imported automatically).
+such as a consumer-owned `<lr-flag>`; no flag package is imported automatically), `start` (alias
+for `country-prefix`, matching the leading-adornment slot name every other forms/ single-line
+field uses — both feed the same wrapper), `end` (optional trailing adornment after the telephone
+input, matching the trailing-adornment slot name every other forms/ single-line field uses).
 
-**CSS parts:** `form-control`, `form-control-label`, `input-wrapper`, `country-prefix`, `country`
+**CSS parts:** `form-control`, `form-control-label`, `input-wrapper`, `country-prefix` (also
+receives the `start` alias slot's content), `end`, `country`
 (the selector region: invisible native select layered over the visual trigger), `country-select`,
 `country-trigger` (visible, `aria-hidden` closed-state box), `flag` (the `<lr-flag>`, only with
 `flags`), `country-code` (selected alpha-2 code, `data-placeholder` when no country exists),
@@ -268,8 +272,8 @@ import "@aceshooting/lyra-ui/components/media/flag/flag-peer.js";
 - The component never imports `@aceshooting/lyra-flags` itself, with `flags` or without. `flags`
   lazily registers only the `<lr-flag>` element; the artwork resolver comes from the consumer's own
   `flag-peer.js` import (plus the installed peer package), so forgetting either shows a flagless
-  trigger rather than erroring. `country-prefix` remains available for a fully consumer-owned
-  adornment instead.
+  trigger rather than erroring. `country-prefix` (or its `start` alias) remains available for a
+  fully consumer-owned adornment instead.
 - The visible trigger (`country-trigger` and everything inside it) is `aria-hidden` by design; the
   layered native select is the accessible control. Don't move interactive content into those parts
   via `::part` styling tricks, and don't expect the flag inside the open popup list — a native

package/llms/components/lr-pie-chart.md

@@ -41,11 +41,14 @@ of every entry in these lists.**
 `refreshTheme()`.
 
 **Events:** `lr-zoom` (`detail: { zoomed: boolean }`), `lr-datum-activate`, `lr-point-click` (`detail: { datasetIndex,
-index, label, value }`), `lr-before-legend-visibility-change` (cancelable), and
+index, label, value }`), `lr-legend-visibility-change-request` (cancelable), and
 `lr-legend-visibility-change` (commit; both legend events carry `datasetIndex`, `visible`, and the
-complete `hiddenDatasets` snapshot).
-Radial category legends additionally emit `lr-before-datum-visibility-change` (cancelable) and
+complete `hiddenDatasets` snapshot). `lr-before-legend-visibility-change` is a **deprecated** alias
+of `lr-legend-visibility-change-request` (removal not before 21.0.0).
+Radial category legends additionally emit `lr-datum-visibility-change-request` (cancelable) and
 `lr-datum-visibility-change`, carrying `index`, `visible` and the frozen `hiddenDatums` snapshot.
+`lr-before-datum-visibility-change` is a **deprecated** alias of `lr-datum-visibility-change-request`
+(removal not before 21.0.0).
 
 **Slots:** default JSON configuration script, `data-table`, `center`.
 

package/llms/components/lr-polar-area-chart.md

@@ -41,11 +41,14 @@ of every entry in these lists.**
 `refreshTheme()`.
 
 **Events:** `lr-zoom` (`detail: { zoomed: boolean }`), `lr-datum-activate`, `lr-point-click` (`detail: { datasetIndex,
-index, label, value }`), `lr-before-legend-visibility-change` (cancelable), and
+index, label, value }`), `lr-legend-visibility-change-request` (cancelable), and
 `lr-legend-visibility-change` (commit; both legend events carry `datasetIndex`, `visible`, and the
-complete `hiddenDatasets` snapshot).
-Radial category legends additionally emit `lr-before-datum-visibility-change` (cancelable) and
+complete `hiddenDatasets` snapshot). `lr-before-legend-visibility-change` is a **deprecated** alias
+of `lr-legend-visibility-change-request` (removal not before 21.0.0).
+Radial category legends additionally emit `lr-datum-visibility-change-request` (cancelable) and
 `lr-datum-visibility-change`, carrying `index`, `visible` and the frozen `hiddenDatums` snapshot.
+`lr-before-datum-visibility-change` is a **deprecated** alias of `lr-datum-visibility-change-request`
+(removal not before 21.0.0).
 
 **Slots:** default JSON configuration script, `data-table`, `center`.
 

package/llms/components/lr-policy-summary.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 12 parts, 3 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 13 parts, 3 custom properties — see this component's own `@csspart`/`@cssprop` list below
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
 
 ---
@@ -37,7 +37,8 @@ resolve/acknowledge action — see `lr-tool-approval-dialog`/`lr-confirm-bar` fo
 gate.
 
 **CSS parts:** `base`, `empty`, `summary`, `count`, `state-badge`,
-`list`, `decision`, `decision-header`, `category`, `label`, `detail`, `explanation`.
+`list`, `decision`, `decision-header`, `category`, `label`, `detail`, `explanation`, `limit`
+(localized notice shown when `decisions` exceeds the 500-row render ceiling).
 
 **Themeable custom properties:** `--lr-policy-summary-count-allow-color` (default
 `var(--lr-color-success)`), `--lr-policy-summary-count-deny-color` (default

package/llms/components/lr-progress-bar.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 5 parts, 11 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 5 parts, 12 custom properties — see this component's own `@csspart`/`@cssprop` list below
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
 
 ---
@@ -47,6 +47,9 @@ presence-based, so an explicitly empty value remains empty rather than invoking
 fallback, and the private `--_lr-progress-track-height` is the `size` property's own tier value,
 `1rem` at the `m` default, unchanged),
 `--lr-progress-track-color` (default `var(--lr-color-brand-quiet)`),
+`--lr-progress-track-radius` (default `var(--lr-radius-pill)`; `indicator`'s `border-radius:
+inherit` picks up the same value, so retuning the track retunes both without a
+`::part(track)`/`::part(indicator)` rule),
 `--lr-progress-indicator-color` (default `var(--lr-progress-indicator-variant-color)`), and
 `--lr-progress-label-color` (default `var(--lr-color-text)`). Upstream aliases are `--height` and
 `--track-height`, plus `--track-color`, `--indicator-color`, and `--label-color`.

package/llms/components/lr-prompt-input.md

@@ -44,7 +44,10 @@ LyraAttachmentCapability[] = ['files', 'image', 'audio']`, `mentionItems: readon
 `voiceCatalog?: LyraCatalog<LyraVoiceCatalogEntry>`,
 `sources: readonly LyraSourceEntry[] = []`, `selectedSourceIds: readonly string[] = []`, and `queue:
 readonly PromptQueueItem[] = []` (all attribute: false); `model: string = ''`; `voice: string = ''`;
-`label: string = ''`; `accessibleLabel: string | null = null` (attribute `aria-label`).
+`label?: string` — accessible name for the prompt section. Omitting it localizes the default
+`promptInputLabel` message; an explicit empty string suppresses that default and renders no label.
+`accessibleLabel: string | null = null` (attribute `aria-label`) — wins over `label` and the
+localized default.
 Source roots and queued prompts require unique nonblank `id` values; malformed rows and later
 duplicates are omitted first-wins before section gating and child forwarding. Controlled selected
 source ids use the same unique nonblank projection.

package/llms/components/lr-prompt-queue.md

@@ -25,13 +25,16 @@ receives focus. Removing an unfocused row does not move focus.
 
 **Properties:** `items: readonly PromptQueueItem[] = []` (attribute: false); `editable: boolean = true`
 (reflected, string-aware true-default converter); `disabled: boolean = false` (reflected);
-`label: string = ''`; `accessibleLabel: string | null = null` (attribute `aria-label`).
+`label?: string`; `accessibleLabel: string | null = null` (attribute `aria-label`).
 `PromptQueueItem = { id: string; value: string; attachments?: readonly DocumentRef[]; createdAt?: number;
 metadata?: Record<string, unknown> }`.
 
 Item ids are occurrence identities. Empty ids and later duplicates are ignored before rendering or
 proposing a mutation, preserving one unambiguous `itemId`. Attachment names render visibly for both
-editable and read-only rows; the host `label` is also the visible queue heading.
+editable and read-only rows; the host `label` is also the visible queue heading. Omitting `label`
+localizes the default `promptQueueLabel` message; an explicit empty string suppresses that default
+and renders no visible heading (`accessibleLabel` still overrides the region's accessible name
+independently).
 
 Supported item and attachment fields are read once when `items` is assigned; create and reassign a
 new collection after changes, because changing an assigned record or reassigning the same mutated

package/llms/components/lr-radar-chart.md

@@ -41,11 +41,14 @@ of every entry in these lists.**
 `refreshTheme()`.
 
 **Events:** `lr-zoom` (`detail: { zoomed: boolean }`), `lr-datum-activate`, `lr-point-click` (`detail: { datasetIndex,
-index, label, value }`), `lr-before-legend-visibility-change` (cancelable), and
+index, label, value }`), `lr-legend-visibility-change-request` (cancelable), and
 `lr-legend-visibility-change` (commit; both legend events carry `datasetIndex`, `visible`, and the
-complete `hiddenDatasets` snapshot).
-Radial category legends additionally emit `lr-before-datum-visibility-change` (cancelable) and
+complete `hiddenDatasets` snapshot). `lr-before-legend-visibility-change` is a **deprecated** alias
+of `lr-legend-visibility-change-request` (removal not before 21.0.0).
+Radial category legends additionally emit `lr-datum-visibility-change-request` (cancelable) and
 `lr-datum-visibility-change`, carrying `index`, `visible` and the frozen `hiddenDatums` snapshot.
+`lr-before-datum-visibility-change` is a **deprecated** alias of `lr-datum-visibility-change-request`
+(removal not before 21.0.0).
 
 **Slots:** default JSON configuration script, `data-table`, `center`.
 

package/llms/components/lr-rag-eval-dashboard.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 14 parts, 1 custom property — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 15 parts, 1 custom property — see this component's own `@csspart`/`@cssprop` list below
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
 
 ---
@@ -36,13 +36,18 @@ Metrics and runs are canonicalized independently by nonblank `id`. Malformed row
 duplicates are omitted first-wins before metric fallback, slice derivation/filtering, cards, charts,
 history, counts, rendering, or actions.
 
+At most 500 of the currently filtered runs render as `run` buttons and feed the trend chart; a
+filtered set past that length renders a localized `limit` notice after the run history rather than
+mounting an unbounded number of rows.
+
 **Events:** `lr-metric-change` (`{ metricId }`), `lr-slice-change` (`{ slice }`), and
 `lr-run-change` (`{ run }`). All are controlled intents; the component does not mutate the
 corresponding selection properties.
 
 **CSS parts:** `base`, `heading`, `slices`, `slice`, `slice-selected`, `metrics`, `metric`,
 `metric-selected`, `metric-category` (the caller-supplied category rendered visibly on each metric),
-`chart`, `runs`, `runs-heading`, `run`, `empty`.
+`chart`, `runs`, `runs-heading`, `run`, `limit` (localized notice shown when the filtered runs
+exceed the 500-run render ceiling), `empty`.
 
 **Themeable custom properties:** `--lr-rag-eval-dashboard-selected-border-color` (default
 `var(--lr-color-brand)`) — border color shared by the controlled active slice and metric.

package/llms/components/lr-realtime-session.md

@@ -27,7 +27,9 @@ clamped by the composed visualizer); `stream: MediaStream | null = null`; `sessi
 entry announcement identity; `entries: LyraTranscriptEntry[] = []` (attribute: false);
 `muted: boolean = false` (reflected);
 `showCapture: boolean = true` (attribute `show-capture`, reflected, string-aware true-default
-converter); `label: string = ''`. Invalid attribute or direct-property values for `state` and
+converter); `label?: string` — accessible name for the session shell. Omitting it localizes the
+default `realtimeSessionLabel` message; an explicit empty string suppresses that default and
+renders no label. Invalid attribute or direct-property values for `state` and
 `voiceState` normalize to their safe defaults (`'disconnected'` and `'idle'`) through the same
 closed-set converter.