@aceshooting/lyra-ui 19.0.0 → 20.0.0

package/llms/components/lr-rubric-form.md

@@ -43,7 +43,10 @@ discriminated union is `ScoreRubricKey | CategoryRubricKey | CommentRubricKey`.
 first-wins identity and retained valid spelling is not rewritten. Shared fields are
 `key`, `label?`, `description?`, and `required?`; only scores expose `min?`/`max?`/`step?`, only
 categories expose readonly `RubricKeyOption[]` plus `multiple?`, and only comments expose
-`placeholder?`. Runtime schema normalization retains the first occurrence of each nonempty key and
+`placeholder?`. Each `RubricKeyOption` also accepts an optional `icon?: unknown` -- a decorative
+leading visual rendered into `<lr-option>`'s `start` slot in the single-select branch, or inline
+before the label in the multiple-select `<lr-checkbox>` branch, inert and `aria-hidden` either way,
+matching `LyraFilterBarOption.icon`. Runtime schema normalization retains the first occurrence of each nonempty key and
 rejects malformed rows. `value: RubricValue = {}` is a defensive readonly snapshot and
 `defaultValue: RubricValue = {}` is its explicit form-reset baseline (both attribute: false).
 `itemId: string = ''`
@@ -90,6 +93,8 @@ state exposed as `errors.base`, rather than being attributed to one rubric key.
 clearing it hides that region unless the `error` slot supplies other content.
 `click()` forwards to the active field (the same one a submit-and-next transition auto-focuses),
 so the host behaves like a single control under both a `<label>`-driven and a programmatic click.
+`focus(options?)` moves focus to that same active field, matching `click()`'s target; this is also
+what lets the native `autofocus` attribute reach the rubric.
 
 **CSS parts:** `base` (the outer `role="group"` wrapper), `form-control` (aggregate chrome wrapper),
 `aggregate-label` / `form-control-label`, `fields` / `form-control-input`, `aggregate-hint` /

package/llms/components/lr-scatter-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-segmented.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** 4 parts, 19 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 4 parts, 20 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`
 
 ---
@@ -159,6 +159,8 @@ resolves.
 
 - `--lr-segmented-track-gap` — Gap between segments. Default: `var(--lr-size-0-125rem)`.
 - `--lr-segmented-track-radius` — Track corner radius. Default: `var(--lr-radius)`.
+- `--lr-segmented-segment-radius` — Each segment's own corner radius, independent of the track's.
+  Default: `calc(var(--lr-form-control-radius) * 0.7)`.
 - `--lr-segmented-track-padding` — Track inset padding. Default: `var(--lr-size-0-125rem)`.
 - `--lr-segmented-track-bg` — Background of the `base` track. Undeclared by default (transparent),
   matching its own current absence of a background.

package/llms/components/lr-select.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** 34 parts, 35 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 34 parts, 36 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`
 
 ---
@@ -407,6 +407,12 @@ invalid CSS and never matches — which is exactly why these tokens exist.
 `[part='option-badge']` "not in catalog" badge `show-unknown-option` renders on the synthetic
 listbox row, independent of the unknown-value chip's border above.
 
+`--lr-select-tag-remove-hover-bg` (default `var(--lr-color-brand-quiet)`) retints a hovered
+`[part='tag__remove-button']`'s background without a `::part(tag__remove-button)` rule; the pressed
+state mixes from this same token. Scoped independently of `--lr-select-trigger-hover-bg` and
+`--lr-select-option-active-bg` above, which already scope the identical shared token for their own
+purposes.
+
 **Optional peer deps:** none.
 
 ```html

package/llms/components/lr-selection-toolbar.md

@@ -22,7 +22,10 @@ Nonmodal, Escape-dismissible text-selection toolbar carrying selected text plus
 **Properties:** `open: boolean = false` (reflected); `text: string = ''`;
 clone-owned `anchor: DocumentLocator | null = null`, `rect: DOMRectReadOnly | null = null`, and
 clone-owned `actions: readonly SelectionAction[] = ['ask', 'quote', 'cite', 'copy']` (attribute: false);
-`label: string = ''`; `accessibleLabel: string | null = null` (attribute `aria-label`).
+`label?: string` — accessible name for the toolbar. Omitting it localizes the default
+`selectionToolbarLabel` 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.
 `SelectionAction = 'ask' | 'quote' | 'cite' | 'copy'`. Duplicate built-in names are omitted
 first-wins before rendering, roving focus, and action events. The anchor (including any path) and
 actions are bounded frozen snapshots; reassign a new record or array after changes.

package/llms/components/lr-sequence-strip.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** 11 parts, 5 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 11 parts, 7 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`
 
 ---
@@ -148,8 +148,12 @@ block-size), `--lr-sequence-strip-marker-color` (default `var(--lr-color-text)`
 (default `0.625rem` — a legend swatch's inline- and block-size, category and marker rows alike), and
 `--lr-sequence-strip-legend-marker-bg` (default `var(--lr-color-surface-raised)` — the neutral chip
 background behind the marker legend row's bar; it stands in for "any cell", so it deliberately
-matches no category color), and `--lr-sequence-strip-disabled-opacity` (default `var(--lr-opacity-disabled)` — opacity of
-a cell whose activated item sets `disabled`); the tooltip also consumes shared tokens
+matches no category color), `--lr-sequence-strip-disabled-opacity` (default `var(--lr-opacity-disabled)` — opacity of
+a cell whose activated item sets `disabled`), `--lr-sequence-strip-selected-color` (default
+`var(--lr-color-text)` — colour of the persistent selection ring on a cell whose index is in
+`selectedIndex`), and `--lr-sequence-strip-selected-focus-color` (default
+`var(--lr-focus-ring-color)` — colour of that same ring while the cell also has keyboard focus); the
+tooltip also consumes shared tokens
 `--lr-color-surface`, `--lr-color-text`, `--lr-font-size-xs`, `--lr-radius`, and `--lr-shadow`, and
 the legend consumes `--lr-space-2xs`, `--lr-space-xs`, `--lr-space-s`, `--lr-font-size-xs`,
 `--lr-color-text-quiet`, and `--lr-radius-xs`.

package/llms/components/lr-source-card.md

@@ -33,6 +33,15 @@ direct light-DOM children of the list (plain composition — no `.items` array p
   header summary, e.g. `"3 sources"` or `"1 source"`; this component never counts or pluralizes on
   its own. Takes precedence over `label` when both are set. If neither is set, the header falls back
   to the localized `sourceListDefaultLabel` string (English default: `"Sources"`).
+- `compact: boolean = false` (reflected) — tighter header and list padding/gap, for a panel
+  rendered repeatedly down a message transcript — same convention as this list's own slotted
+  `lr-source-card` children's `compact`. Purely a density knob: the outer border and surface stay,
+  so pair it with `frame="plain"` to remove card chrome.
+- `frame: LyraFrame = 'card'` (reflected) — container treatment, in the library-wide `frame`
+  vocabulary (`'card' | 'plain'`). `'card'` (the default) keeps the bordered, filled outer
+  container. `'plain'` removes that outer border, background, and corner radius so a list nested
+  inside existing message chrome does not double it. Plain preserves the header/list divider and
+  whichever regular or compact padding applies.
 
 **Getters:** `sourceCount: number` — read-only, live-updated count of the currently-slotted children,
 handy for building a `label-plural` string reactively, e.g. `` list.labelPlural = `${list.sourceCount} sources` ``.
@@ -52,7 +61,13 @@ list/listitem semantics return.
 `toggle` (the chevron indicator inside the header), `list` (wrapper around the default slot, `hidden`
 while collapsed).
 
-**Themeable custom properties:** shared tokens only — `--lr-color-border`, `--lr-color-surface`,
+**Themeable custom properties:** `--lr-source-list-compact-header-padding` (default
+`var(--lr-space-2xs) var(--lr-space-s)`) and `--lr-source-list-compact-header-gap` (default
+`var(--lr-space-2xs)`) — `[part="header"]` padding/gap while `compact`; `--lr-source-list-compact-gap`
+(default `var(--lr-space-2xs)`) and `--lr-source-list-compact-list-padding` (default
+`var(--lr-space-s)`) — `[part="list"]` gap/padding while `compact`. All four are inline `var()`
+fallbacks at their point of use, so any can be set on the element or an ancestor. Otherwise shared
+tokens — `--lr-color-border`, `--lr-color-surface`,
 `--lr-color-text`, `--lr-color-brand` / `-brand-quiet`, `--lr-radius`, `--lr-space-xs`/`-s`/
 `-m`, `--lr-transition-fast`, `--lr-focus-ring-*`.
 

package/llms/components/lr-source-list.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** 4 parts, 0 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 4 parts, 4 custom properties — see this component's own `@csspart`/`@cssprop` list below
 - **Documented with** `lr-source-card` (same section below)
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
 
@@ -33,6 +33,15 @@ direct light-DOM children of the list (plain composition — no `.items` array p
   header summary, e.g. `"3 sources"` or `"1 source"`; this component never counts or pluralizes on
   its own. Takes precedence over `label` when both are set. If neither is set, the header falls back
   to the localized `sourceListDefaultLabel` string (English default: `"Sources"`).
+- `compact: boolean = false` (reflected) — tighter header and list padding/gap, for a panel
+  rendered repeatedly down a message transcript — same convention as this list's own slotted
+  `lr-source-card` children's `compact`. Purely a density knob: the outer border and surface stay,
+  so pair it with `frame="plain"` to remove card chrome.
+- `frame: LyraFrame = 'card'` (reflected) — container treatment, in the library-wide `frame`
+  vocabulary (`'card' | 'plain'`). `'card'` (the default) keeps the bordered, filled outer
+  container. `'plain'` removes that outer border, background, and corner radius so a list nested
+  inside existing message chrome does not double it. Plain preserves the header/list divider and
+  whichever regular or compact padding applies.
 
 **Getters:** `sourceCount: number` — read-only, live-updated count of the currently-slotted children,
 handy for building a `label-plural` string reactively, e.g. `` list.labelPlural = `${list.sourceCount} sources` ``.
@@ -52,7 +61,13 @@ list/listitem semantics return.
 `toggle` (the chevron indicator inside the header), `list` (wrapper around the default slot, `hidden`
 while collapsed).
 
-**Themeable custom properties:** shared tokens only — `--lr-color-border`, `--lr-color-surface`,
+**Themeable custom properties:** `--lr-source-list-compact-header-padding` (default
+`var(--lr-space-2xs) var(--lr-space-s)`) and `--lr-source-list-compact-header-gap` (default
+`var(--lr-space-2xs)`) — `[part="header"]` padding/gap while `compact`; `--lr-source-list-compact-gap`
+(default `var(--lr-space-2xs)`) and `--lr-source-list-compact-list-padding` (default
+`var(--lr-space-s)`) — `[part="list"]` gap/padding while `compact`. All four are inline `var()`
+fallbacks at their point of use, so any can be set on the element or an ancestor. Otherwise shared
+tokens — `--lr-color-border`, `--lr-color-surface`,
 `--lr-color-text`, `--lr-color-brand` / `-brand-quiet`, `--lr-radius`, `--lr-space-xs`/`-s`/
 `-m`, `--lr-transition-fast`, `--lr-focus-ring-*`.
 

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

@@ -53,7 +53,9 @@ string; mimeType?: string; name?: string; children?: LyraSourceEntry[] }`; flat
   omitted state and removes the attribute
 
 **Events:** `lr-sources-change` (`detail: { selectedSourceIds }`, the complete updated leaf-id array,
-fired after every toggle including select-all).
+fired after every toggle including select-all. Also fired when a `sources` reassignment prunes a
+previously-selected id that is no longer a valid leaf. Not fired when a consumer sets
+`selectedSourceIds` directly; that assignment is normalized silently).
 
 **Slots:** none.
 

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

@@ -45,9 +45,12 @@ counts, selection, and events.
 `task`, `model`, `progress`, `actions`, `cancel`, `retry`, `limit`, `empty`.
 
 At most 500 runs render, and visual indentation is capped at 12 levels while ARIA hierarchy keeps
-the logical depth. The visible `limit` text is ordinary and non-live; newly reaching or changing the
-run ceiling after the initial baseline appends the localized message to the shared polite light-DOM
-announcement sink, while initial and reconnect renders stay silent. The roving treeitem accepts
+the logical depth. When `selectedRunId` names a run beyond the 500-run ceiling, that run and its
+resolvable ancestor chain reserve positions inside the cap ahead of ordinary array order, so the
+controlled selection remains visible. The visible `limit` text is ordinary and non-live; newly
+reaching or changing the run ceiling after the initial baseline appends the localized message to the
+shared polite light-DOM announcement sink, while initial and reconnect renders stay silent. The
+roving treeitem accepts
 Enter/Space as well as pointer activation for `lr-run-activate`; cancel/retry action names include the
 run label so repeated row actions remain distinguishable to assistive technology. Progress is finite
 and clamped. **Slots:** none.

package/llms/components/lr-switch.md

@@ -57,7 +57,7 @@ normally.
 **Events:** a user state change (click, Space, a logical ArrowLeft/ArrowRight change, or the
 programmatic `click()` activation path) emits
 `input`, then `lr-input`, then `change`, then `lr-change` (both aliases carry
-`detail: { checked: boolean }`) — in that order, matching
+`detail: { checked: boolean, value: string }`, matching `lr-radio`'s shape) — in that order, matching
 the native checkbox/radio contract. The two native-style events are **new in 8.0.0**: a boolean
 control that emitted only the `lr-`-prefixed alias was invisible to every form library, validation
 helper, and `<form>`-level `change` listener that binds the native names, which is the ordinary way
@@ -69,8 +69,9 @@ assignment, `form.reset()`, or session-state restoration. The internal control's
 check finds the switch invalid.
 **Refusing a toggle.** `lr-switch-toggle-request` is cancelable and fires *before* `checked` moves,
 on every user path (click, Space, a logical ArrowLeft/ArrowRight change, and the host `click()`
-activation it forwards). `detail: { checked: boolean }` is the state the switch **would** take;
-`checked` itself still holds the old value while the event dispatches. `preventDefault()` keeps the
+activation it forwards). `detail: { checked: boolean, value: string }` is the state the switch
+**would** take (`value` is the current `.value`, unaffected by the toggle); `checked` itself still
+holds the old value while the event dispatches. `preventDefault()` keeps the
 current state, so the switch never slides at all rather than sliding and snapping back, and none of
 `input`/`lr-input`/`change`/`lr-change` follow. A listener can instead answer by assigning `checked`
 itself during the dispatch, which suppresses the built-in write the same way. It does not fire for a

package/llms/components/lr-table.md

@@ -57,7 +57,7 @@ unchanged.
 
 - `columns: readonly TableColumn<T>[] = []` (attribute: false; clone-owned frozen collection,
   bounded to the first 10,000 source positions; blank keys and later duplicates are omitted first-wins
-  before header, cell, sort, focus, and event paths; reassign to update) — `{ key, label,
+  before header, cell, sort, focus, and event paths; reassign to update) — `{ key, label, ariaLabel?,
 headerCell?, width?, minWidth?, maxWidth?,
 resizable?, sortable?, sortValue?, defaultSortDir?: 'asc'|'desc', align?: 'start'|'end',
 priority?: 'medium'|'low',
@@ -66,6 +66,11 @@ editType?: 'text'|'number'|'select',
 editOptions?: { value: string; label: string }[], footer?, cellStyle?, heatValue?,
 cell: (row) => unknown }` — `cell` is required for every `editTrigger` except `'always'`, whose
   persistent editor renders unconditionally so the table's render path never falls back to it —
+  `ariaLabel` overrides that column header's accessible name (applied as the `<th>`'s `aria-label`
+  whenever set) — e.g. an icon-only `headerCell` with no plain-text `label` to fall back on; when
+  `label` is blank (or whitespace-only) and `ariaLabel` is also omitted, the header's accessible
+  name falls back to `key` while the visible header itself stays blank, matching a deliberate
+  icon-only column —
   `sortValue(row) => string | number | null | undefined` supplies the comparable value backing
   client-mode sorting for that column: a finite number sorts numerically, a string sorts through an
   `Intl.Collator` built from the component's effective locale with `numeric: true` (so `item2`

package/llms/components/lr-thinking-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** 6 parts, 13 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 6 parts, 14 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`
 
 ---
@@ -27,9 +27,10 @@ plain text) — this component has no dependency on either.
 - `label?: string` — omitted localizes `thinkingPanelLabel` (`'Thinking'` in the built-in English
   catalog). Any supplied string is an explicit override and renders verbatim, including
   `label="Thinking"` under a non-English `.strings` catalog and `label=""`.
-- `compact: boolean = false` (reflected) — tightens the header/body padding and the header's
-  internal gap for dense transcript rows. This is only a density control: its card border and
-  surface remain, so use `frame="plain"` when surrounding message chrome already supplies them.
+- `compact: boolean = false` (reflected) — tightens the header/body padding, the header's internal
+  gap, and the header/body font size for dense transcript rows. This is only a density control: its
+  card border and surface remain, so use `frame="plain"` when surrounding message chrome already
+  supplies them.
 - `frame: LyraFrame = 'card'` (reflected) — the library-wide container-frame vocabulary
   (`'card' | 'plain'`). `'card'` keeps the bordered, filled outer container. `'plain'` removes its
   border, background, and corner radius so a nested panel does not double an existing frame;
@@ -82,7 +83,9 @@ pending duration/toggle accent without changing the shared brand token;
 `--lr-thinking-panel-compact-header-font-size` (default `var(--lr-font-size-sm)`) — font size of
 `[part="header"]` while `compact`; and
 `--lr-thinking-panel-compact-body-padding` (default `var(--lr-space-s)`) — `[part="body"]`
-padding while `compact`. `--lr-thinking-panel-background` (default `var(--lr-color-surface)`),
+padding while `compact`; and `--lr-thinking-panel-compact-body-font-size` (default
+`var(--lr-font-size-sm)`) — font size of `[part="body"]` while `compact`.
+`--lr-thinking-panel-background` (default `var(--lr-color-surface)`),
 `--lr-thinking-panel-border-color` (default `var(--lr-color-border)`) and
 `--lr-thinking-panel-radius` (default `var(--lr-radius)`) retune `[part="base"]`'s card chrome
 without a `::part(base)` override; the border-color hook also colors the header/body divider that

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

@@ -38,7 +38,12 @@ noneditable token layout remains the default.
 **Properties:** live, non-reflecting `value`, reflected `defaultValue` (attribute `value`, encoded
 as a JSON string array), `customError` (`custom-error`), `label`, `hint`, `errorText`
 (`error-text`), `placeholder`, `name`,
-`required`, `disabled`, `accessibleLabel` (attribute `aria-label` — forwarded to the input wrapper
+`required`, `disabled`,
+`readonly: boolean = false` (reflected — forwards native read-only behavior to the draft input and
+the inline token editor, and blocks adding, removing or editing a token while leaving the draft
+input, tokens and remove buttons focusable and the current value submitted with the form, mirroring
+`lr-input`'s `readonly`),
+`accessibleLabel` (attribute `aria-label` — forwarded to the input wrapper
 and draft text input; precedence is presence-based, so `aria-label=""` remains an explicit empty
 override and suppresses visible-label linkage), `spellcheck: boolean = true`, `autocapitalize: string = ''`, and `autocorrect` (read: `boolean = true`; write: `boolean | string`, attribute values
 `on`/`off`) — all three native text-entry hints are forwarded to both the draft input and the inline
@@ -122,6 +127,15 @@ controlled `value`/pristine `defaultValue` shrink, DOM focus moves to the neares
 equivalent surface at the clamped index. If no token remains it moves to the draft input; a newer
 explicit focus destination outside the component is never reclaimed.
 
+**`readonly` — locking the committed list.** Reflects native read-only behavior onto both the draft
+input and the inline token editor, and blocks every other value-committing affordance: typing (or a
+programmatic `input`/`change` dispatch) into the draft, Enter/delimiter/Tab draft commits,
+Backspace-removes-last-token, clicking a remove button, and opening or committing the inline
+editor (`editable`). Unlike `disabled`, it never removes the draft input, a token label, or a
+remove button from the tab order, never blocks `focus()`, and never excludes the current value from
+`FormData` on submit — only `disabled` does that. Turning it on while a draft is half-typed or an
+inline editor is open discards that uncommitted state without moving focus.
+
 **`delimiter` is nullable, and only a single character acts as a commit key.** It does two separate
 jobs: it splits a committed draft into several tokens, and — _only when it is exactly one
 character_ — it is the keystroke that commits the draft. A multi-character delimiter still splits a

package/llms/components/lr-tool-call-chip.md

@@ -133,5 +133,7 @@ duration"`). A host `aria-label` remains on the host and is not cloned onto that
   not place links, buttons, or other controls there; use the chip activation or detail slot instead
 - Escape only dismisses the tooltip when it's open; it does not fire any event or otherwise affect
   `status`/`open` state, since the chip has no "open" state of its own beyond the tooltip
+- An open tooltip participates in shared Escape ordering even while only hovered, deferring to a
+  genuinely topmost overlay opened on top of it
 
 ---

package/llms/components/lr-tool-param-form.md

@@ -50,7 +50,12 @@ boolean; readonly autocapitalize?: string; readonly autoCorrect?: string; readon
 string; readonly enterKeyHint?: string }` — one `schema.properties`
   entry. `enum` is only meaningful when `type` is `'string'` (rendered as a `<lr-select>`); `const`
   enforces one exact primitive value; `title` is the display label; `description` is helper text;
-  `default` pre-fills a field whenever `value` doesn't already have that key. For a free-form
+  `default` pre-fills a field whenever `value` doesn't already have that key. For a `'string'`
+  (non-enum) or `'number'`/`'integer'` field, `const` also pre-fills the field (taking priority
+  over `default` when both are present) and renders its native control `readonly` — visible,
+  focusable and copyable, but not editable, and still submitted as the locked value. The
+  `'boolean'`/enum `<lr-select>` fields are unaffected: `const` there remains pure post-touch
+  validation, as before. For a free-form
   string field, `autocomplete`, `spellcheck`, `autocapitalize`, `autoCorrect`, `inputMode`, and
   `enterKeyHint` forward the corresponding native editing hints to the rendered text input;
   `spellcheck` defaults to `true`, and the other hints are omitted unless supplied.
@@ -74,7 +79,9 @@ Readonly<Record<string, ToolParamFormProperty>>; readonly required?: readonly st
   `lr-input`) as that default, but the `value` property itself is left alone until the user actually
   edits that field. JSON Schema ordinarily treats `default` as an annotation; this renderer
   deliberately materializes it before validation/submission, so a valid default can satisfy
-  `required`.
+  `required`. A `const` on a `'string'` (non-enum) or `'number'`/`'integer'` field takes priority
+  over `default` for this same materialization, and additionally renders that field's control
+  `readonly` so the locked value is visible and submitted but not editable.
 - `name: string = ''` — submission key for optional native `<form>` participation
 - `disabled: boolean = false` (reflected)
 - `customError: string | null = null` (attribute `custom-error`) — reflected consumer validation
@@ -87,9 +94,10 @@ Readonly<Record<string, ToolParamFormProperty>>; readonly required?: readonly st
 
 - `effectiveValue: ToolParamFormValue` — a detached, deeply frozen `value` snapshot with every
   property missing from it filled in
-  from `schema`'s own `default`; this is what actually renders and what `lr-input`'s detail carries.
+  from `schema`'s own `const` (when present) or `default`; this is what actually renders and what
+  `lr-input`'s detail carries.
   A key the user has explicitly cleared (a real own property set to `undefined`) stays cleared rather
-  than snapping back to its default — only a key genuinely absent from `value` falls back.
+  than snapping back to its `const`/default — only a key genuinely absent from `value` falls back.
 - `errors: Readonly<Record<string, string>>` — a frozen effective validation-error snapshot.
   Intrinsic errors use their schema property key; a schema-wide/serialization error or consumer
   custom-validity message uses `base`, the whole-control part. It is independent of which fields
@@ -121,6 +129,9 @@ Readonly<Record<string, ToolParamFormProperty>>; readonly required?: readonly st
 - `click(): void` — forwards a host click to the first generated field's control, so the form
   behaves like a single control under both a `<label>`-driven and a programmatic click; a no-op
   while `disabled`.
+- `focus(options?: FocusOptions): void` — moves focus to the first generated field's control,
+  mirroring `click()`; a no-op while `disabled`.
+- `blur(): void` — blurs whichever generated field currently holds focus.
 
 **Events:** `lr-input` (deeply frozen `detail: { value: ToolParamFormValue }` — the full detached
 current value snapshot, every property with defaults resolved, not just the field that changed),

package/llms/components/lr-tooltip.md

@@ -102,10 +102,14 @@ Tooltip motion resolves `tooltip.show` / `tooltip.hide` through the public anima
 The same per-element/global precedence, RTL keyframe selection, token-timing fallback,
 reduced-motion flattening, and null-disable lifecycle rules documented for `lr-popover` apply.
 
-**Slots:** both mapped shapes are supported. Web Awesome uses named `trigger` plus default tooltip
-content. Shoelace uses the default slot for the trigger and `slot="content"` (or the `content`
-property) for tooltip content. A named trigger always selects the first shape; without one, an
-explicit content source makes the default slot unambiguously the trigger.
+**Slots:** both mapped shapes are supported, plus a Lyra-original addition. `trigger` (the
+highest-priority interaction/ARIA owner, mirroring `<lr-popover>`'s own `trigger` slot) is not a
+Web Awesome shape: `wa-tooltip` has only its single unnamed default slot for tooltip content, and
+its own anchor mechanism is the `for` attribute plus the unrelated `trigger` activation-mode
+attribute documented above. Shoelace uses the default slot for the trigger and `slot="content"`
+(or the `content` property) for tooltip content. A named `trigger` slot always selects that shape;
+without one, an explicit content source (`slot="content"` or the `content` property) makes the
+default slot unambiguously the trigger, matching Shoelace.
 
 **CSS parts:** `popup base tooltip base__popup` are aliases on the same wrapper; `trigger`; `body`;
 and `arrow base__arrow` (rendered unless suppressed). The arrow also carries the resolved side —

package/llms/components/lr-trace-tree.md

@@ -65,13 +65,16 @@ element or any ancestor, and they exist because `::part(row)[data-active]` is in
 `--lr-trace-tree-max-indent` (default `var(--lr-size-12rem)`) caps visual nesting indentation;
 semantic `aria-level` remains exact at deeper levels.
 
-**Contrast note:** the active row is more than a tint. Its secondary text would sit at ~4.25:1
+**Contrast note:** the active row is more than a tint. Its secondary text would sit at ~4.17:1
 against the default tint if it stayed at `--lr-color-text-quiet`, so it rises to full-strength
 `--lr-color-text` while the row is active, and the semantic `status-text` labels are rendered as
 `color-mix(in srgb, var(--lr-color-<tone>) 75%, var(--lr-color-text))` — keeping the status hue
-(an error row stays red) while clearing the 4.5:1 floor (success 4.46 → 6.18, `denied` 4.28 →
-5.96). Both adjustments are theme-symmetric, because `--lr-color-text` flips with the color
-scheme. `[part='bar']` is deliberately untouched: it is a non-text graphic on a 3:1 floor, and its
+(an error row stays red) while clearing the 4.5:1 floor with a full point of margin or more for
+every currently shipped default tone. The exact ratio moves with every palette ramp revision
+(`src/internal/tokens/palette.styles.ts`), so no specific number is pinned here — recompute against
+the live tokens before quoting one. Both adjustments are theme-symmetric, because `--lr-color-text`
+flips with the color scheme. `[part='bar']` is deliberately untouched: it is a non-text graphic on
+a 3:1 floor, and its
 saturation is the row's primary status signal.
 
 The two properties are a **pair**. The defaults assume the active background stays on the same

package/llms/components/lr-video-playlist.md

@@ -46,11 +46,13 @@ convenience; every enabled row is independently reachable through ordinary seque
 native `FocusEvent`s (bubbling and composed, preserving `relatedTarget`).
 `lr-video-change` is bubbling and composed but non-cancelable, with exact
 detail `{ previousIndex, currentIndex, video }`. `video` is a fresh detached, recursively frozen plain-data snapshot with
-exact shape `{ title, poster, sources, tracks }`, not the live child element. `sources` contains
-fresh `{ src, type, media }` records for the child's direct `src` and `<source>` declarations;
-`tracks` contains fresh `{ src, kind, srclang, label, default }` records. A listener that needs to
-annotate or reshape the payload must create its own mutable copy; the dispatched detail and every
-nested record/array reject mutation.
+exact shape `{ title, poster, sources, tracks }`, not the live child element, or `null`. `sources`
+contains fresh `{ src, type, media }` records for the child's direct `src` and `<source>`
+declarations; `tracks` contains fresh `{ src, kind, srclang, label, default }` records. A listener
+that needs to annotate or reshape the payload must create its own mutable copy; the dispatched
+detail and every nested record/array reject mutation. Also fired when a light-DOM mutation (a video
+removed, or every remaining video made `inert`/disabled) leaves no enabled video to replace a
+previously active one: `video` is `null` and `currentIndex` is `-1` in that case.
 
 **Slot:** the default slot accepts direct `<lr-video>` children. Nested videos and other elements
 are not playlist items.

package/llms/components/lr-voice-picker.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** 17 parts, 28 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 18 parts, 28 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`
 
 ---
@@ -41,8 +41,10 @@ custom-value editor: they do not navigate options, commit a selection or custom
 popup. Ordinary keyboard behavior resumes after composition.
 
 **Exported types:** `LyraVoiceCatalogEntry extends LyraCatalogEntry { language?: string;
-description?: string; previewUrl?: string }` — `language`/`description` render as a quiet
-`[part="option-meta"]` second line. Voice catalogs use the shared
+description?: string; previewUrl?: string; icon?: string }` — `language`/`description` render as a
+quiet `[part="option-meta"]` second line; `icon` is an optional literal icon hint (for example, an
+emoji), rendered decoratively as the leading `[part="option-icon"]`, matching
+`lr-model-select`'s identical `LyraModelCatalogEntry.icon` field. Voice catalogs use the shared
 `LyraCatalog<LyraVoiceCatalogEntry>` homogeneous readonly union documented under `lr-model-select`,
 including the shared `disabled` field: a disabled voice row cannot be selected by click or keyboard
 and is stepped over by arrow-key/Home/End navigation, but its own `[part="option-preview"]` stays
@@ -133,7 +135,8 @@ reports no violation and publishes neither `:state(invalid)` nor
 `:state(user-invalid)`.
 
 **CSS parts:** `form-control` (the complete field frame), `form-control-label`, `trigger` (closed-dropdown mode), `combobox`/`combobox-input`
-(free-text mode), `provider-badge`, `listbox`, `option`, `option-label`, `option-meta` (the quiet
+(free-text mode), `provider-badge`, `listbox`, `option`, `option-icon` (an object-shaped catalog
+row's optional decorative leading icon), `option-label`, `option-meta` (the quiet
 `language · description` second line), `option-badge` (the "not in catalog" badge on a synthetic
 stale-value row), `option-preview` (a pointer-only per-row preview icon, `tabindex="-1"`,
 `aria-hidden`), `preview-button` (the standalone, keyboard-reachable preview toggle beside the

package/llms/components/lr-widget.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, 9 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 16 parts, 13 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`
 
 ---
@@ -78,7 +78,9 @@ toggle button. Not emitted when a consumer assigns `fullscreen` directly), `lr-v
 (cancelable; `detail: { viewId }` is the view proposed by a header view-toggle click. Call
 `preventDefault()` to leave `activeViewId` unchanged. Not emitted when a consumer assigns
 `activeViewId` directly), `lr-view-change` (non-cancelable; `detail: { viewId }`, the accepted
-active view's `viewId`. Not emitted when a consumer sets `activeViewId` directly), and
+active view's `viewId`. Also emitted when a `views` reassignment drops the currently-active view,
+forcing a fallback to the first remaining view. Not emitted when a consumer sets `activeViewId`
+directly, even to a now-invalid id), and
 `lr-activate` (non-cancelable; `detail: { value }` — note the key is `value`, not `viewId` — is the
 activated view's `viewId`, fired on **every** accepted header view-toggle activation whether or not
 `activeViewId` actually moved. `lr-view-request` stays the veto point, and a vetoed activation emits
@@ -142,6 +144,17 @@ rendering is unchanged.
 _hover_ state, and the `:hover` rule wraps its selector in `:where()` so a consumer's own
 `::part(view-toggle):hover` override wins without `!important`.
 
+`--lr-widget-collapse-button-hover-bg` (default `var(--lr-color-brand-quiet)`) and
+`--lr-widget-collapse-button-hover-color` (default `var(--lr-color-brand)`), plus
+`--lr-widget-fullscreen-button-hover-bg` (default `var(--lr-color-brand-quiet)`) and
+`--lr-widget-fullscreen-button-hover-color` (default `var(--lr-color-brand)`), are
+the same inline-`var()`-fallback shape for `[part="collapse-button"]` and `[part="fullscreen-button"]`
+respectively; each button's pressed fill mixes from its own `-hover-bg` token. Before these existed,
+both buttons read the library-wide `--lr-color-brand-quiet`/`--lr-color-brand` tokens directly, so a
+consumer retinting those tokens upstream to change only the view toggle's hover (the reason the
+view-toggle pair above exists) also silently repainted these two buttons; each now has its own scoped
+escape hatch, independent of the other and of the view toggle.
+
 **Optional peer deps:** none.
 
 ```html

package/llms/migration.md

@@ -72,9 +72,9 @@ set with a warning. Expand or classify them before applying, then rerun to verif
 
 | Ecosystem | Exact | Rewritten | Warning required | Conceptual only | Unsupported | Automatic | Manual |
 |---|---:|---:|---:|---:|---:|---:|---:|
-| Web Awesome | 34 | 38 | 15 | 0 | 0 | 72 | 15 |
+| Web Awesome | 34 | 37 | 16 | 0 | 0 | 71 | 16 |
 | Shoelace | 18 | 28 | 12 | 0 | 0 | 46 | 12 |
-| **Total** | **52** | **66** | **27** | **0** | **0** | **118** | **27** |
+| **Total** | **52** | **65** | **28** | **0** | **0** | **117** | **28** |
 
 ## Web Awesome (87)
 
@@ -102,11 +102,11 @@ The pinned Web Awesome manifest is authoritative for this inventory; only rows m
 | `<wa-checkbox>` | `<lr-checkbox>` | `rewritten` | Automatic: tag/import plus events: wa-invalid → lr-invalid. Equivalent surface representation: name defaults null ≡ ; no source rewrite. |
 | `<wa-checkbox-group>` | `<lr-checkbox-group>` | `exact` | Automatic: tag and supported side-effect registration import. Form-associated group of checkboxes with array values and group validation. |
 | `<wa-color-picker>` | `<lr-color-picker>` | `rewritten` | Automatic: tag/import plus events: wa-after-hide → lr-after-hide; events: wa-after-show → lr-after-show; events: wa-hide → lr-hide; events: wa-invalid → lr-invalid; events: wa-show → lr-show. Equivalent surface representation: name defaults null ≡ ; no source rewrite. |
-| `<wa-combobox>` | `<lr-combobox>` | `warning-required` | Manual: Lyra snapshots each input/change event's value into a frozen readonly value at dispatch time, and since 16.0.0 narrows it through the picker value generic, so the detail reads as string when multiple is false rather than the upstream union; migrated handlers that mutate the event detail in place, or that rely on the union being present on a single-select combobox, must be reviewed. |
+| `<wa-combobox>` | `<lr-combobox>` | `warning-required` | Manual: Lyra snapshots each input/change event's value into a frozen readonly value at dispatch time, and since 16.0.0 narrows it through the picker value generic, so the detail reads as string when multiple is false rather than the upstream union; migrated handlers that mutate the event detail in place, or that rely on the union being present on a single-select combobox, must be reviewed. Its appearance also accepts the full shared LyraAppearance vocabulary (accent and plain in addition to the three upstream values) since 20.0.0; every upstream value keeps its meaning, so only exhaustive TypeScript switches over the narrower upstream union need review. |
 | `<wa-comparison>` | `<lr-image-comparer>` | `exact` | Automatic: tag and supported side-effect registration import. Before/after slotted surfaces with a keyboard-accessible range divider. |
 | `<wa-copy-button>` | `<lr-copy-button>` | `rewritten` | Automatic: tag/import plus events: wa-copy → lr-copy; events: wa-error → lr-error. |
 | `<wa-data-grid>` | `<lr-data-grid>` | `warning-required` | Manual: Lyra snapshots collection inputs and event details synchronously into frozen readonly values, and removes the redundant wa-data-request alias in favor of the typed request event. Migrated code that mutates arrays or event details in place, assigns derived collections, or listens for the removed alias must be reviewed. |
-| `<wa-date-input>` | `<lr-date-input>` | `rewritten` | Automatic: tag/import plus events: wa-after-hide → lr-after-hide; events: wa-after-show → lr-after-show; events: wa-clear → lr-clear; events: wa-hide → lr-hide; events: wa-invalid → lr-invalid; events: wa-show → lr-show. |
+| `<wa-date-input>` | `<lr-date-input>` | `warning-required` | Manual: Since 20.0.0 lr-date-input accepts the full shared LyraAppearance vocabulary (accent and plain in addition to the three upstream values). Every upstream value keeps its meaning, so migrated markup is unaffected; only exhaustive TypeScript switches over the narrower upstream union need review. |
 | `<wa-date-picker>` | `<lr-date-picker>` | `rewritten` | Automatic: tag/import plus events: wa-focus-day → lr-focus-day; events: wa-view-change → lr-view-change. |
 | `<wa-details>` | `<lr-details>` | `rewritten` | Automatic: tag/import plus events: wa-after-hide → lr-after-hide; events: wa-after-show → lr-after-show; events: wa-hide → lr-hide; events: wa-show → lr-show. |
 | `<wa-dialog>` | `<lr-dialog>` | `rewritten` | Automatic: tag/import plus events: wa-after-hide → lr-after-hide; events: wa-after-show → lr-after-show; events: wa-hide → lr-hide; events: wa-show → lr-show. |