@aceshooting/lyra-ui 26.0.0 → 27.0.0

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

@@ -90,20 +90,10 @@ toolbar's roving tab stop is leased on the native control rather than the host),
 embedded `lr-message-feedback`).
 
 The toolbar has no `size`/`compact` property: every built-in's hit area is `<lr-icon-button>`'s
-shared `--lr-icon-button-size` floor (2.5rem/40px), same as everywhere else in the library. For a
+shared `--lr-icon-button-size` floor (2.25rem/36px), same as everywhere else in the library. For a
 dense action row, lower `--lr-theme-icon-button-size` (not `--lr-icon-button-size`, which every
 `LyraElement` re-declares on its own `:host` and so never reaches a composed child) on this element
 or an ancestor, or reach a built-in's composed native control directly through
 `::part(regenerate-button-control)` / `::part(edit-button-control)`. A coarse-pointer/no-hover
 media rule then floors the rendered hit area at 2.75rem/44px regardless of how far a dense-row
 override lowered it, so the shrink is safe on a touch device.
-
-**Migrating a pre-16.0.0 `::part()` rule.** This component's icon-only actions are composed
-`<lr-icon-button>`s, so a part naming one of them now names the composed child's HOST, which paints
-nothing. A `border`, `background` or `border-radius` set on it is silently dead — only `color` still
-appears to work, because it inherits, which makes such a rule look half-alive rather than broken.
-Set `--lr-icon-button-bg`/`-color`/`-border`/`-radius` (and their `-hover`/`-active`
-variants) on this element or an ancestor instead: the composed control reads those public tokens
-ahead of any default this component supplies. For SIZE use `--lr-theme-icon-button-size`, not
-`--lr-icon-button-size` — every `LyraElement` re-declares the latter on its own `:host`, so it never
-reaches a composed child (see `llms/tokens.md`).

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

@@ -126,7 +126,7 @@ events pass through unchanged: `lr-anchor-result`, `lr-citation-open`, `lr-copy`
 `lr-highlight-activate`, `lr-link-activate`, `lr-preview-request`, `lr-remove`, `lr-render-error`, `lr-retry`,
 `lr-search-change`, `lr-text-select`, `lr-toggle` (from reasoning panels and tool-call blocks),
 `lr-tool-call-chip-select`, `lr-widget-action`,
-and `lr-widget-state-change`. The `lr-tool-chip-select` alias passthrough was removed in 9.0.0.
+and `lr-widget-state-change`.
 In block display, `lr-toggle` also arrives from tool-call blocks (`{ expanded, callId }`) and
 `lr-render-error` from an expanded block carries `callId`; `lr-tool-call-chip-select` is not
 emitted. Tool errors are never announced; only `error` parts are.
@@ -175,8 +175,7 @@ import "@aceshooting/lyra-ui/components/lr-message-parts.js";
 - `lr-copy-error` event — Passthrough from rendered JSON content or a Markdown code-block header.
 - `lr-highlight-activate` event — Passthrough from rendered Markdown.
 - `lr-link-activate` event — Passthrough from rendered Markdown.
-- `lr-preview-request` event — Passthrough from a rendered attachment. Not cancelable as of 10.0.0:
-  `<lr-attachment-chip>` dropped the flag, since it owns no preview default action to veto.
+- `lr-preview-request` event — Passthrough from a rendered attachment. Not cancelable.
 - `lr-remove` event — Passthrough from a rendered attachment.
 - `lr-render-error` event — Passthrough from rendered Markdown, tool-result, or widget content, or
   tool-call block (`callId` included).
@@ -184,8 +183,7 @@ import "@aceshooting/lyra-ui/components/lr-message-parts.js";
 - `lr-search-change` event — Passthrough from rendered JSON content.
 - `lr-text-select` event — Passthrough from rendered Markdown.
 - `lr-toggle` event — Passthrough from a rendered reasoning panel or tool-call block.
-- `lr-tool-call-chip-select` event — Passthrough from a rendered tool-call chip. The
-  `lr-tool-chip-select` alias it replaced was removed in 9.0.0.
+- `lr-tool-call-chip-select` event — Passthrough from a rendered tool-call chip.
 - `lr-widget-action` event — Passthrough from a rendered declarative widget.
 - `lr-widget-state-change` event — Passthrough from a rendered controlled widget.
 

package/llms/components/lr-model-select.md

@@ -94,10 +94,8 @@ focus move.
   honored — matches `<lr-textarea>`/`<lr-date-input>`).
 - `autocapitalize: string = ''` — forwarded to the free-text mode's native `<input>`; empty omits
   the attribute.
-- `autoCorrect: string = ''` (attribute `autocorrect`) — forwarded to the free-text mode's native
-  `<input>`'s own `autocorrect` (Safari/WebKit-specific); empty omits the attribute. Named
-  `autoCorrect` in JS purely to dodge a `lib.dom.d.ts` typing collision — the wire attribute is
-  still plain `autocorrect`.
+- `autocorrect: boolean = true` — forwarded to the free-text mode's native `<input>` as
+  `autocorrect="on"|"off"`; the attribute is omitted until `autocorrect` is written or set.
 - `autocomplete: string = 'off'`, `inputMode: string = ''` (attribute `inputmode`), and
   `enterKeyHint: string = ''` (attribute `enterkeyhint`) — forwarded to the free-text input;
   they have no effect in closed-dropdown mode

package/llms/components/lr-multi-split.md

@@ -6,7 +6,7 @@
 - **Class** `LyraMultiSplit`, also available unregistered from `@aceshooting/lyra-ui/components/layout/multi-split/multi-split.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `9.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 3 parts, 8 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-mutation-observer.md

@@ -6,7 +6,7 @@
 - **Class** `LyraMutationObserver`, also available unregistered from `@aceshooting/lyra-ui/components/utility/mutation-observer/mutation-observer.class.js`
 - **Family** `components/utility/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [utility](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/utility.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 1 part, 0 custom properties — see this component's own `@csspart`/`@cssprop` list below
@@ -41,7 +41,7 @@ malformed or accessor-backed entries are skipped, a valid prefix remains active,
 unusable value falls back to an empty filter. A new array with the same names does not rebuild the
 observer.
 
-**Events:** `lr-mutation`; its detail and bounded readonly record sequence are frozen.
+**Events:** `lr-mutation`; its detail and bounded readonly record sequence are frozen. Changing the observed options delivers any records already queued under the old options first.
 `detail.records` and mapped `detail.mutationList` reference the same sequence, while each native
 `MutationRecord` retains identity.
 

package/llms/components/lr-native-time-input.md

@@ -6,7 +6,7 @@
 - **Class** `LyraNativeTimeInput`, also available unregistered from `@aceshooting/lyra-ui/components/forms/input/native-time-input.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `8.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 18 parts, 23 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-navigation-menu-item.md

@@ -6,7 +6,7 @@
 - **Class** `LyraNavigationMenuItem`, also available unregistered from `@aceshooting/lyra-ui/components/layout/navigation-menu-item/navigation-menu-item.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `experimental` since `21.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 8 parts, 22 custom properties — see `lr-navigation-menu.md`

package/llms/components/lr-navigation-menu.md

@@ -6,7 +6,7 @@
 - **Class** `LyraNavigationMenu`, also available unregistered from `@aceshooting/lyra-ui/components/layout/navigation-menu/navigation-menu.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `experimental` since `21.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecated event** `lr-expanded-change` since `26.0.0`; use event `@lr-toggle`; removal not before `28.0.0` — The shared toggle event carries the same expanded and source detail; the older name remains emitted during migration.
 - **Optional peers** none
 - **Themeable via** 7 parts, 5 custom properties — see this component's own `@csspart`/`@cssprop` list below

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

@@ -6,7 +6,7 @@
 - **Class** `LyraNumberInput`, also available unregistered from `@aceshooting/lyra-ui/components/forms/input/number-input.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 23 parts, 23 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-option.md

@@ -6,7 +6,7 @@
 - **Class** `LyraOption`, also available unregistered from `@aceshooting/lyra-ui/components/forms/combobox/option.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 7 parts, 7 custom properties — see `lr-combobox.md`

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

@@ -6,7 +6,7 @@
 - **Class** `LyraOtpInput`, also available unregistered from `@aceshooting/lyra-ui/components/forms/otp-input/otp-input.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `8.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 12 parts, 15 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-page.md

@@ -6,7 +6,7 @@
 - **Class** `LyraPage`, also available unregistered from `@aceshooting/lyra-ui/components/layout/page/page.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `8.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 22 parts, 23 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-pagination.md

@@ -6,7 +6,7 @@
 - **Class** `LyraPagination`, also available unregistered from `@aceshooting/lyra-ui/components/data/pagination/pagination.class.js`
 - **Family** `components/data/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [data](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/data.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 22 parts, 22 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-pan-zoom.md

@@ -59,9 +59,7 @@ relayed exactly once as owner-realm native `FocusEvent`s (bubbling and composed,
 action and that visible percentage, so the visible label is contained in the computed name.
 
 **Themeable custom properties:** `--lr-pan-zoom-min-block-size` (default `var(--lr-size-10rem)`)
-and the read-only `--lr-pan-zoom-zoom`. The former `--lr-zoomable-frame-min-block-size` and
-`--lr-zoomable-frame-zoom` compatibility names were removed in v9; migrate them to the two
-`--lr-pan-zoom-*` names. Scaling
+and the read-only `--lr-pan-zoom-zoom`. Scaling
 uses layout-participating CSS `zoom`, not a paint-only transform, so the viewport's native scroll
 range reaches the entire painted footprint at both logical edges in LTR and RTL.
 

package/llms/components/lr-permission-grant.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [agent-tools](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/agent-tools.md)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 9 parts, 0 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 11 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`
 
 ---
@@ -40,6 +40,8 @@ overrides the internal fieldset name.
 | `status` | Localized controlled request status (`tabindex="-1"`). |
 | `actions` | Decision buttons, shown only while pending. |
 | `decision` | One native decision button, themed through the shared `--lr-button-*` tokens. |
+| `decision-base` | A decision button's internal control (forwarded from `<lr-button>`). |
+| `decision-label` | A decision button's label wrapper (forwarded from `<lr-button>`). |
 
 
 **Events:** non-cancelable `lr-permission-decision` (`detail: { requestId, decision }`) reports the host’s authorization choice; the component does not authorize or persist the operation.

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

@@ -6,7 +6,7 @@
 - **Class** `LyraPhoneInput`, also available unregistered from `@aceshooting/lyra-ui/components/forms/phone-input/phone-input.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 15 parts, 17 custom properties — see this component's own `@csspart`/`@cssprop` list below
@@ -123,8 +123,8 @@ null` (attribute `custom-error`) carries a consumer-supplied validation message.
   — SSR slot-presence hints for slotted label/hint content that cannot be inspected before
   hydration.
 - `placeholder: string = ''` — forwarded to the native telephone input.
-- `spellcheck: boolean = true`, `autocapitalize: string = ''`, `autoCorrect: string = ''`
-  (attribute `autocorrect`) — forwarded to the internal telephone input's own `spellcheck`/
+- `spellcheck: boolean = true`, `autocapitalize: string = ''`, `autocorrect: boolean = true`
+  (attribute `autocorrect`, same shape as `<lr-input>`; the string `autoCorrect` is removed) — forwarded to the internal telephone input's own `spellcheck`/
   `autocapitalize`/`autocorrect`; `spellcheck="false"` is parsed as `false` via a string-aware
   converter (Lit's default presence-based boolean converter would otherwise treat any attribute
   value, including the literal string `"false"`, as `true`).
@@ -151,8 +151,10 @@ null` (attribute `custom-error`) carries a consumer-supplied validation message.
   including the English default, wins verbatim. An empty override retains the localized native
   error reason. Removing the attribute restores its declared English property default and resumes
   localization.
-- `autocomplete: string = 'tel'`, `inputmode: 'tel'|'numeric'|'text' = 'tel'`,
-  `enterkeyhint: string = ''` — forwarded to the internal `<input type="tel">`.
+- `autocomplete: string = 'tel'`, `inputMode: string = 'tel'` (attribute `inputmode`),
+  `enterKeyHint: string = ''` (attribute `enterkeyhint`) — forwarded to the internal
+  `<input type="tel">`; lowercase `inputmode`/`enterkeyhint` accessors delegate to them. The host
+  `name` is forwarded to the internal field.
 - `readonly: boolean = false` (reflected) — forwards to the native telephone input, locks the
   country selector and all user edit handlers, and bars validation while retaining focus,
   selection/copying, canonical form value, and submission.

package/llms/components/lr-poll-status.md

@@ -6,7 +6,7 @@
 - **Class** `LyraPollStatus`, also available unregistered from `@aceshooting/lyra-ui/components/utility/poll-status/poll-status.class.js`
 - **Family** `components/utility/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [utility](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/utility.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 5 parts, 5 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-popover.md

@@ -116,7 +116,7 @@ If the import fails, leave the native disclosure visible and usable.
 - `distance: number = 8` — anchor-offset distance in px (Floating UI's main-axis `offset()`). May
   legitimately be negative to overlap the trigger; a non-finite value falls back to the default.
 - `skidding: number = 0` — offset _along_ the anchor's edge, in px (Floating UI's cross-axis
-  offset). New in 8.0.0.
+  offset).
 - `for: string = ''` (reflected) — id of an element resolved in this element's own root. It is the
   positioning source behind a direct `.anchor`; when it resolves to a live HTML element and no
   trigger is slotted, it also owns click and generated ARIA. A slotted trigger wins interaction/ARIA
@@ -149,7 +149,7 @@ If the import fails, leave the native disclosure visible and usable.
 - `accessibleLabel: string = ''` (attribute **`aria-label`**) — names the popup. An authored host
   attribute wins by presence, including `aria-label=""`; only when it is absent does the property
   or localized "Popover" ("Menu" when `popupRole` is `menu`) fallback apply
-- `popupRole: 'dialog'|'menu'|'none' = 'dialog'` (attribute `popup-role`). `none` (new in 11.0.0)
+- `popupRole: 'dialog'|'menu'|'none' = 'dialog'` (attribute `popup-role`). `none`
   renders **no** `role` and no generated `aria-label` on the popup surface, and leaves
   `aria-haspopup` off the trigger, so slotted content owns its own semantics and accessible name.
   Unsupported attribute values and untyped property writes normalize to `dialog` before any role
@@ -174,7 +174,7 @@ If the import fails, leave the native disclosure visible and usable.
   For a whole bar of such flyouts — coordinated so one opens at a time, sharing one panel region,
   with arrow keys between triggers and an optional collapsed layout — use `lr-navigation-menu`
   (documented in `layout.md`) instead of several popovers.
-- `disabled: boolean = false` (reflected, new in 10.0.0) — prevents opening the popover; pointer,
+- `disabled: boolean = false` (reflected) — prevents opening the popover; pointer,
   keyboard, and programmatic `show()`/`open = true` are all refused while set. Becoming disabled also
   closes an already-open popover, and initial `disabled` plus `open` normalizes closed in either
   attribute order. `lr-dropdown` now inherits this from `lr-popover` rather than declaring its own;
@@ -248,15 +248,11 @@ an open ancestor popover containing the newcomer or its trigger remain independe
 the same `show()` or `hide()` request from its own before-event coalesces onto one transition
 promise and emits the lifecycle once.
 
-**Breaking in 8.0.0:** `lr-show`/`lr-hide` now fire _before_ the state changes and are cancelable —
+`lr-show`/`lr-hide` fire _before_ the state changes and are cancelable —
 `preventDefault()` on `lr-show` leaves the popover closed for the trigger click, `show()` and
 `open = true` alike, and on `lr-hide` keeps it open for every dismissal path (Escape, light dismiss,
 `hide()`, `open = false`). Reading `el.open` inside such a handler therefore returns the _old_
-value; in 7.x these events fired after the fact and were purely informational. That is exactly the
-timing `wa-show`/`wa-hide` always had, so the `wa-*` → `lr-*` migration table's "mechanical rename"
-promise now holds for these names too — which also means 7.x Lyra code that read `el.open` in the
-handler was relying on the _opposite_ polarity and must be re-read. `lr-after-show`/`lr-after-hide`
-are new in 8.0.0 and settle after the public `popover.show` / `popover.hide` registry animation.
+value. `lr-after-show`/`lr-after-hide` settle after the public `popover.show` / `popover.hide` registry animation.
 Per-element overrides win over page defaults; keyframes-only overrides retain the popup's
 `--show-duration` / `--hide-duration` and shared easing. Reduced motion flattens timing to zero, and
 a `null` registration skips interpolation, but neither path skips the after-event or its

package/llms/components/lr-popup.md

@@ -17,9 +17,7 @@
 ## `lr-popup`
 
 The low-level anchored-positioning primitive `lr-popover`, `lr-dropdown` and `lr-tooltip` are built
-on. Mirrors `wa-popup` / `sl-popup`. **New in 8.0.0** — the positioning logic already existed as an
-internal module, but a migrating consumer had no public element to rename `wa-popup`/`sl-popup` to
-and had to reimplement it by hand.
+on. Mirrors `wa-popup` / `sl-popup`.
 
 It positions its default slot against an anchor and keeps the two aligned through scroll, resize and
 layout change — and does nothing else. **No dismiss behaviour, no focus management, no ARIA

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

@@ -20,7 +20,8 @@ A determinate or indeterminate progress bar with an independently visible label
 formatted percentage.
 
 **Properties:** `value` (reflected), `max`, `indeterminate`, `variant`, `withValue` (`with-value`),
-`label` (mapped accessible-name property), and `size: LyraSize = 'm'` (reflected) —
+`label` (mapped accessible-name property), the read-only `indicator` element and `indicatorOffset` (the unfilled
+percentage of the track; `65` while indeterminate), shared with the ring, and `size: LyraSize = 'm'` (reflected) —
 `'2xs' | 'xs' | 's' | 'm' | 'l' | 'xl' | 'small' | 'medium' |
 'large'`. Track/indicator thickness tier, on the shared six-step ladder: `0.25rem` (`2xs`),
 `0.375rem` (`xs`), `0.625rem` (`s`/`small`), `1rem` (`m`/`medium`, unchanged from before this

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

@@ -19,7 +19,7 @@
 A circular progress indicator with the same value contract as `lr-progress-bar`.
 
 **Properties:** `value: number = 0` (reflected), `max: number = 100`, `indeterminate: boolean = false`
-(reflected), `variant: LyraProgressVariant = 'brand'` (reflected, added in 9.0.0 — matches sibling
+(reflected), `variant: LyraProgressVariant = 'brand'` (reflected — matches sibling
 `lr-progress-bar`'s semantic-palette vocabulary: `neutral`/`brand`/`success`/`warning`/`danger`;
 `primary` is an alias of `brand`, and an unsupported value falls back to `brand` on both),
 `withValue: boolean = false` (attribute `with-value`),
@@ -39,12 +39,8 @@ back to `100`, `value` clamps to `[0, max]`) rather than producing NaN geometry.
 **Slots:** default — replaces the built-in center label, which otherwise renders the rounded
 percentage **only when `with-value` is set** (and nothing at all while `indeterminate`); `label` —
 named alias for center content, matching `lr-progress-bar`.
-**Breaking in 10.0.0:** a determinate ring used to render its percentage unconditionally, with no way
-to suppress it short of slotting replacement content. It now gains `showValue`/`show-value` defaulting
-to `false`, exactly matching `lr-progress-bar` — which is what "the same value contract as
-`lr-progress-bar`" above has always claimed but did not deliver. Add `show-value` (now spelled
-`with-value`) to keep the percentage. `aria-valuetext` still carries it regardless, mirroring `lr-progress-bar`'s own
-independence there, so the accessible value is unaffected.
+The percentage is opt-in via `with-value` (default `false`), matching `lr-progress-bar`.
+`aria-valuetext` carries it regardless, so the accessible value is unaffected.
 Its accessible text uses the same visibility filtering, forwarding-slot mutation/reassignment
 tracking, and explicit-empty host-label precedence as `lr-progress-bar`.
 **Live members:** `indicator: SVGCircleElement | null` returns the rendered indicator circle (or
@@ -65,7 +61,7 @@ bridge directly, which `theme.css` declares at `3px`),
 `--lr-progress-ring-indicator-width` (defaulting to the track width),
 `--lr-progress-ring-indicator-color` (default
 `var(--lr-progress-ring-indicator-variant-color)`, so the active `variant` supplies the color),
-`--lr-progress-ring-indicator-variant-color` (added in 9.0.0, same override precedence as
+`--lr-progress-ring-indicator-variant-color` (same override precedence as
 `lr-progress-bar`'s `--lr-progress-indicator-variant-color` — the palette slot `variant` resolves
 into),
 `--lr-progress-ring-indicator-transition-duration` (default `var(--lr-transition-base)`), and

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

@@ -34,7 +34,9 @@ their corresponding data can be supplied. The default entry registers all childr
 `withoutEnterSubmit: boolean = false` (attribute `without-enter-submit`);
 `submitDisabled: boolean = false` (attribute `submit-disabled`), `withoutStop: boolean = false`
 (attribute `without-stop`), `minRows: number = 1` (attribute `min-rows`) and `maxRows: number = 8`
-(attribute `max-rows`) forward to the composed `lr-chat-composer` with its semantics;
+(attribute `max-rows`), `frame: 'card' | 'plain' = 'card'` and `actionsLayout: 'inline' | 'stacked' = 'inline'`
+(attribute `actions-layout`) forward to the composed `lr-chat-composer` with its semantics, and a slotted
+`toolbar` child is forwarded to the composer's `toolbar` slot;
 `spellcheck: boolean = true` (string-aware true-default converter), `autocapitalize: string = ''`,
 `autocorrect: boolean = true` (legacy string writes `'off'`/`'false'` normalize to `false`),
 `wrap: 'hard' | 'soft' | 'off' = 'soft'`,

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

@@ -37,10 +37,10 @@ persistence.
 empty/blank message and version ids are omitted and later duplicates use deterministic first-wins
 identity before rendering, editing, focus, selection, and events;
 runtime `null`/non-array values for any of the three not-yet-loaded collections render as empty;
-`selectedVersionId: string | null = null` (attribute `selected-version-id`); `label: string = ''`;
+`selectedVersionId: string | null = null` (attribute `selected-version-id`); `label?: string` (accessible region name, `''` used verbatim; omission uses the heading);
 `heading?: string` — visible toolbar heading, falling back to the localized Prompt Studio
-label when omitted (an explicit `''` is kept); `headingLevel: LyraHeadingLevel = '2'` (attribute `heading-level`) — its semantic
-level (`none` keeps the visual heading text without heading semantics);
+label when omitted (an explicit `''` is kept); `headingLevel: LyraHeadingLevel = 'none'` (attribute `heading-level`) — its semantic
+level (`none`, the default, keeps the visual heading text without heading semantics; `1`–`6` render that heading level);
 `running: boolean = false`, `disabled: boolean = false`, and `reorderable: boolean = false`
 (all reflected). `reorderable` adds native move-up/move-down controls for each message. A move first
 emits a cancelable request, so a host can veto it while persisting the proposed order and later
@@ -74,7 +74,7 @@ boundary, so without the re-dispatch an
 focus movement, not a synthetic host-level focus signal: moving between two fields inside the
 studio emits a `blur` and then a `focus`.
 
-**Headings and malformed rows:** `heading` is used verbatim including `''` (omission localizes “Prompt studio”), and the Variables and Preview titles sit one level below `heading-level` (no heading semantics under `none`). A `null` variable row, or one without a string `name`/`value`, is skipped instead of blanking the studio.
+**Headings and malformed rows:** `heading-level` defaults to `none`; `heading` is used verbatim including `''` (omission localizes “Prompt studio”), and the Variables and Preview titles sit one level below `heading-level` (no heading semantics under `none`). A `null` variable row, or one without a string `name`/`value`, is skipped instead of blanking the studio.
 
 **CSS parts:** `base`, `toolbar`, `editor`, `messages`, `message`, `message-role`,
 `message-content`, `message-actions`, `move-message-up`, `move-message-down`, `remove-message`,

package/llms/components/lr-radio-button.md

@@ -6,7 +6,7 @@
 - **Class** `LyraRadioButton`, also available unregistered from `@aceshooting/lyra-ui/components/forms/radio/radio-button.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `8.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 13 parts, 24 custom properties — see this component's own `@csspart`/`@cssprop` list below
@@ -46,7 +46,7 @@ The exact-320px story shows that behavior in LTR and RTL.
 
 **Properties and methods:** exactly the same functional surface as `lr-radio`. Its writable fields
 are `appearance`, `checked`, `defaultChecked`, `customError`, `disabled`, `name`, `required`, `value`,
-`size`, and `pill`. Its effective form/validity state is also inherited: read-only
+`defaultValue`, `size`, and `pill`. Its effective form/validity state is also inherited: read-only
 `effectiveDisabled`, `effectiveRequired`, `form`, `labels`, `validity`, `validationMessage`, and
 `willValidate`. The delegated methods are `click()`, `focus()`, `blur()`, `getForm()`,
 `checkValidity()`, `reportValidity()`, `setCustomValidity()`, and `resetValidity()`; form reset,

package/llms/components/lr-radio-group.md

@@ -7,7 +7,7 @@
 - **Class** `LyraRadioGroup`, also available unregistered from `@aceshooting/lyra-ui/components/forms/radio/radio-group.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 11 parts, 5 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-radio.md

@@ -6,7 +6,7 @@
 - **Class** `LyraRadio`, also available unregistered from `@aceshooting/lyra-ui/components/forms/radio/radio.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 13 parts, 13 custom properties — see this component's own `@csspart`/`@cssprop` list below
@@ -29,7 +29,8 @@ applies to the button appearance of `lr-radio`.
 
 **Properties:** live, non-reflecting `checked`; reflected `defaultChecked` (attribute `checked`);
 reflected `customError: string | null` (attribute `custom-error`); `disabled`, `required`, `name`,
-and `value`. A selected standalone radio submits its value through `ElementInternals`.
+`value` and its native alias `defaultValue`. A selected standalone radio submits its value through
+`ElementInternals`.
 An empty `name` is canonicalized to an omitted attribute rather than reappearing as `name=""`.
 `effectiveRequired` exposes the required state inherited from a containing radio group.
 `effectiveName` and `effectiveSize` expose the owning group's aggregate projections while `name`

package/llms/components/lr-random-content.md

@@ -6,7 +6,7 @@
 - **Class** `LyraRandomContent`, also available unregistered from `@aceshooting/lyra-ui/components/utility/random-content/random-content.class.js`
 - **Family** `components/utility/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [utility](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/utility.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 3 parts, 11 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-rating.md

@@ -76,8 +76,7 @@ host ARIA never creates a competing second slider.
 Assigning `null` to `name` is accepted for mapped source compatibility; it removes the attribute and
 clears to the canonical `''` read value rather than creating a nullable state.
 
-`getSymbol?: (value: number, selected: boolean) => unknown` (property only, no attribute) — **new in
-8.0.0.** Renders a consumer-supplied symbol per position instead of the built-in star. It is called
+`getSymbol?: (value: number, selected: boolean) => unknown` (property only, no attribute) — Renders a consumer-supplied symbol per position instead of the built-in star. It is called
 _twice per position_: once for the empty backdrop (`selected` false) and once for the overlay
 clipped to that position's filled fraction (`selected` true), which is what keeps a fractional
 `precision` rendering a partial fill. Return any Lit-renderable value; a plain string renders as
@@ -106,7 +105,7 @@ Left unset, the built-in star outline/solid pair is unchanged.
   no click at all. When the commit _does_ move the value, `change` and `lr-change` are emitted
   first, so a listener reading `value` from any of the three sees the settled rating. A
   non-interactive (`readonly`/`disabled`) rating fires none of them.
-- `lr-hover` — **new in 8.0.0.** `detail: { phase: 'start' | 'move' | 'end', value }`, where `value`
+- `lr-hover` — `detail: { phase: 'start' | 'move' | 'end', value }`, where `value`
   is the rating that committing the current pointer position _would_ produce — enough to render a
   live description of what is being hovered without waiting for a click. Fires only while the rating
   is settable (neither `disabled`, fieldset-disabled, nor `readonly`). `start` also covers a pointer

package/llms/components/lr-relative-time.md

@@ -6,7 +6,7 @@
 - **Class** `LyraRelativeTime`, also available unregistered from `@aceshooting/lyra-ui/components/utility/format/relative-time.class.js`
 - **Family** `components/utility/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [utility](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/utility.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** nothing component-specific — inherits only the shared surface
@@ -24,8 +24,7 @@ are as described under `lr-format-number` above.
 
 - `date: string | number | Date = new Date()` — the target instant; unset means now. Numeric HTML
   attributes are epoch milliseconds, matching numeric property assignment (including zero and
-  negative epochs); nonnumeric strings retain ordinary date/ISO parsing. **Changed in 8.0.0:** the
-  former empty-string default rendered no content
+  negative epochs); nonnumeric strings retain ordinary date/ISO parsing.
 - `unit: 'second'|'minute'|'hour'|'day'|'week'|'month'|'quarter'|'year'|'auto' = 'auto'` — `'auto'`
   picks the largest unit whose own length fits inside the elapsed time, then rounds; naming a unit
   forces it (so a 90-minute delta with `unit="day"` rounds to "today"/0 days)

package/llms/components/lr-reorder-item.md

@@ -6,7 +6,7 @@
 - **Class** `LyraReorderItem`, also available unregistered from `@aceshooting/lyra-ui/components/layout/reorder-list/reorder-item.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `6.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 6 parts, 5 custom properties — see `lr-reorder-list.md`

package/llms/components/lr-reorder-list.md

@@ -6,7 +6,7 @@
 - **Class** `LyraReorderList`, also available unregistered from `@aceshooting/lyra-ui/components/layout/reorder-list/reorder-list.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `6.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 1 part, 1 custom property — see this component's own `@csspart`/`@cssprop` list below

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

@@ -38,6 +38,8 @@ record, and renders at most 100 steps. `label` sets the visible group heading an
 unless a non-empty host `aria-label` owns it; the progressbar is always named from the label (the
 localized default for an empty one). The `headingLevel` property and `heading-level` attribute
 (`'2'` by default; `'none'` keeps the text without heading semantics) set the heading's level.
+- `size: LyraSize = 'm'` (reflected) — density on the shared size scale. `s` (and the smaller `xs`/`2xs`) tightens the `base` padding; `m` and larger keep the full padding.
+- `frame: LyraFrame = 'card'` (reflected) — container treatment. `'card'` keeps the panel's bordered box; `'plain'` removes the border, corner radius and padding from `base`, for use inside an already-bordered container.
 
 **CSS parts:**
 

package/llms/components/lr-resize-observer.md

@@ -6,7 +6,7 @@
 - **Class** `LyraResizeObserver`, also available unregistered from `@aceshooting/lyra-ui/components/utility/resize-observer/resize-observer.class.js`
 - **Family** `components/utility/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [utility](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/utility.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 1 part, 0 custom properties — see this component's own `@csspart`/`@cssprop` list below

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

@@ -6,7 +6,7 @@
 - **Class** `LyraResponsivePanel`, also available unregistered from `@aceshooting/lyra-ui/components/layout/responsive-panel/responsive-panel.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 6 parts, 5 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-retrieval-compare.md

@@ -30,6 +30,8 @@ owner, while an explicitly empty host label stays empty on the region).
 trace metadata, and `scores?: { dense?, sparse?, rerank?, final }`.
 Each set's chunk buttons share one Tab stop and move with ArrowUp/ArrowDown/Home/End; the selected
 chunk remains controlled by `selectedChunkId`.
+- `size: LyraSize = 'm'` (reflected) — density on the shared size scale. `s` (and the smaller `xs`/`2xs`) tightens the compared `chunk` buttons' padding; `m` and larger keep the full padding.
+- `frame: LyraFrame = 'card'` (reflected) — container treatment. `'card'` keeps each compared chunk's bordered, filled button; `'plain'` removes the border, background and corner radius from every `chunk`, for use inside an already-bordered container.
 
 Set ids and each set's nested chunk ids are canonicalized independently. Malformed/blank rows and
 later duplicates are omitted first-wins before empty state, overlap/count calculations, ranking,

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

@@ -51,6 +51,8 @@ unknown> }` — `chunks` is **`RetrievalChunk` from `@aceshooting/lyra-ui/ai`**
   explicit empty string clears it. An authored host `aria-label` independently names the trace and is
   not cloned onto the timeline; explicit-empty/dynamic host changes preserve that single-owner
   distinction
+- `size: LyraSize = 'm'` (reflected) — density on the shared size scale. `s` (and the smaller `xs`/`2xs`) tightens the `evidence-toggle` and `evidence-body` padding; `m` and larger keep the full padding.
+- `frame: LyraFrame = 'card'` (reflected) — container treatment. `'card'` keeps each `evidence-row`'s bordered box; `'plain'` removes the border and corner radius from every `evidence-row`, for use inside an already-bordered container.
 
 **Events:** `lr-stage-select` (`detail: { stageId: string }`, a stage's bar was activated — click,
 Enter, Space), `lr-stage-toggle` (`detail: { stageId: string; expanded: boolean }`, deprecated alias of `lr-toggle`; an evidence panel was

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

@@ -6,7 +6,7 @@
 - **Class** `LyraRubricForm`, also available unregistered from `@aceshooting/lyra-ui/components/forms/rubric-form/rubric-form.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 20 parts, 15 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-scroller.md

@@ -6,7 +6,7 @@
 - **Class** `LyraScroller`, also available unregistered from `@aceshooting/lyra-ui/components/layout/scroller/scroller.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 10 parts, 12 custom properties — see this component's own `@csspart`/`@cssprop` list below