@aceshooting/lyra-ui 26.0.0 → 28.0.0

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

package/llms/components/lr-segmented.md

@@ -6,7 +6,7 @@
 - **Class** `LyraSegmented`, also available unregistered from `@aceshooting/lyra-ui/components/layout/segmented/segmented.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** 4 parts, 20 custom properties — see this component's own `@csspart`/`@cssprop` list below
@@ -101,11 +101,15 @@ The floor at the two compact tiers is the ladder's own (20px at `2xs`, 24px at `
 `2xs`/`xs` _segment_ separately carries a 24×24px minimum box, so the tappable target holds even
 when a label is a single character and the track ends up taller than its nominal floor.
 
-`--lr-segmented-selected-bg` (default `var(--lr-color-surface)`), `--lr-segmented-selected-color`
-(default `var(--lr-color-text)`), `--lr-segmented-selected-font-weight` (default
+`--lr-segmented-selected-bg` (default `var(--lr-color-text)`), `--lr-segmented-selected-color`
+(default `var(--lr-color-surface)`), `--lr-segmented-selected-font-weight` (default
 `var(--lr-font-weight-semibold)`) and `--lr-segmented-selected-shadow` (default
 `var(--lr-shadow-xs)` — the shallowest step in the elevation scale, since the checked segment is a
-thumb lifted a hair off its own track) style the checked segment's pill;
+thumb lifted a hair off its own track) style the checked segment's pill. The default pill is the
+inverse of the surface (text-coloured fill, surface-coloured label), so the checked state stays at
+least 3:1 against a card or dialog in every look and mode; when you override
+`--lr-segmented-selected-bg`, also set `--lr-segmented-selected-color` to a label that contrasts with
+your fill;
 `--lr-segmented-hover-color` (default `var(--lr-color-text)`) styles a hovered segment that is
 neither checked nor disabled, independently of the four above — so recoloring the checked pill never
 bleeds onto hover. `--lr-segmented-hover-bg` (default `transparent`) and `--lr-segmented-hover-shadow`

package/llms/components/lr-select.md

@@ -6,7 +6,7 @@
 - **Class** `LyraSelect`, also available unregistered from `@aceshooting/lyra-ui/components/forms/select/select.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** 34 parts, 36 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-sequence-playback.md

@@ -47,8 +47,7 @@ internal `focus`/`blur` are relayed exactly once as owner-realm native `FocusEve
 composed, preserving `relatedTarget`).
 
 **Class and event types:** `LyraSequencePlayback`, `LyraSequencePlaybackEventMap`, and
-`LyraSequencePlaybackStepDetail`. The former generic `LyraPlayback`, `<lr-playback>`, `length`,
-`index`, and `lr-step` names are removed in v9 rather than retained as ambiguous aliases.
+`LyraSequencePlaybackStepDetail`.
 
 **Slots:** `play-icon`, `pause-icon` — decorative glyphs for the paused and playing states; an empty
 slot keeps the built-in glyph. Assigned content renders in an inert, `aria-hidden` layer inside the

package/llms/components/lr-sequence-strip.md

@@ -6,7 +6,7 @@
 - **Class** `LyraSequenceStrip`, also available unregistered from `@aceshooting/lyra-ui/components/data/sequence-strip/sequence-strip.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** 12 parts, 7 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-signature-pad.md

@@ -6,7 +6,7 @@
 - **Class** `LyraSignaturePad`, also available unregistered from `@aceshooting/lyra-ui/components/forms/signature-pad/signature-pad.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `experimental` since `26.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** 8 parts, 6 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-skeleton.md

@@ -22,11 +22,9 @@ with `text`/`circle`/`rect` geometry and opt-in `pulse`/`sheen` effects.
 **Properties:**
 
 - `shape: 'text'|'circle'|'rect' = 'text'` (reflected) — the canonical geometry vocabulary;
-  exported as `LyraSkeletonShape`. The former `variant` property/attribute and `SkeletonVariant`
-  type are removed in v9; use `shape` and `LyraSkeletonShape`.
+  exported as `LyraSkeletonShape`.
 - `effect: 'pulse'|'sheen'|'none' = 'none'` (not reflected; the live value is exposed as
-  `data-effect` on `[part="base"]`) — animation is opt-in. **Changed in
-  8.0.0:** the Lyra default was `pulse`; set `effect="pulse"` to preserve that motion explicitly.
+  `data-effect` on `[part="base"]`) — animation is opt-in.
 - `width?: string`
 - `height?: string`
 - `label?: string` — text announced when `announce` is set. Only absence uses the localized

package/llms/components/lr-slider.md

@@ -6,7 +6,7 @@
 - **Class** `LyraSlider`, also available unregistered from `@aceshooting/lyra-ui/components/forms/slider/slider.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** 26 parts, 24 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-sparkline.md

@@ -6,7 +6,7 @@
 - **Class** `LyraSparkline`, also available unregistered from `@aceshooting/lyra-ui/components/data/sparkline/sparkline.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)
 - **Deprecated part** `base` since `8.0.0`; use part `::part(sparkline)`; removal not before `10.0.0` — The sparkline part names the rendered SVG wrapper unambiguously; base remains on that same node during the compatibility window. That version is a policy floor, not a plan: `wa-sparkline` still publishes its own deprecated `base` part, so this alias is removed only when upstream's is.
 - **Optional peers** none
 - **Themeable via** 5 parts, 3 custom properties — see this component's own `@csspart`/`@cssprop` list below

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

@@ -6,7 +6,7 @@
 - **Class** `LyraSplitPanel`, also available unregistered from `@aceshooting/lyra-ui/components/layout/split-panel/split-panel.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** 5 parts, 10 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-stat.md

@@ -6,7 +6,7 @@
 - **Class** `LyraStat`, also available unregistered from `@aceshooting/lyra-ui/components/data/stat/stat.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** 14 parts, 18 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-stepper.md

@@ -6,7 +6,7 @@
 - **Class** `LyraStepper`, also available unregistered from `@aceshooting/lyra-ui/components/layout/stepper/stepper.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** 7 parts, 10 custom properties — see this component's own `@csspart`/`@cssprop` list below

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

@@ -6,7 +6,7 @@
 - **Class** `LyraSwatchPicker`, also available unregistered from `@aceshooting/lyra-ui/components/forms/swatch-picker/swatch-picker.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** 5 parts, 10 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-switch.md

@@ -6,7 +6,7 @@
 - **Class** `LyraSwitch`, also available unregistered from `@aceshooting/lyra-ui/components/forms/switch/switch.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** 12 parts, 18 custom properties — see this component's own `@csspart`/`@cssprop` list below
@@ -40,6 +40,7 @@ normally.
 - `required: boolean = false` (reflected — enforced via `internals.setValidity()`)
 - `name: string = ''`
 - `value: string = 'on'` — only contributed to form submission while `checked`
+- `defaultValue: string` — the native alias of `value`
 - `customError: string | null` (attribute `custom-error`) — reflected consumer validation message
 - `hint: string = ''` — hint text below the switch. Unset: no hint chrome renders.
 - `helpText: string = ''` (attribute `help-text`) — Shoelace alias for `hint`; `hint` wins when both

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

@@ -7,7 +7,7 @@
 - **Class** `LyraTabGroup`, also available unregistered from `@aceshooting/lyra-ui/components/layout/tab-group/tab-group.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** 16 parts, 17 custom properties — see this component's own `@csspart`/`@cssprop` list below

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

@@ -6,7 +6,7 @@
 - **Class** `LyraTabPanel`, also available unregistered from `@aceshooting/lyra-ui/components/layout/tab-group/tab-panel.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** 1 part, 1 custom property — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-tab.md

@@ -6,7 +6,7 @@
 - **Class** `LyraTab`, also available unregistered from `@aceshooting/lyra-ui/components/layout/tab-group/tab.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** 4 parts, 0 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-table.md

@@ -6,10 +6,10 @@
 - **Class** `LyraTable`, also available unregistered from `@aceshooting/lyra-ui/components/data/table/table.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** 47 parts, 25 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 56 parts, 27 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,7 @@ cell: (row) => unknown }` — `cell` is required for every `editTrigger` except
   `scroll-mode="auto"`, adapts to actual overflow rather than a fixed token threshold, and can be
   reversed with `[part='reveal-columns-button']`; `sticky` pins headers/cells to the logical start
   or end while scrolling. Sticky columns stack in logical order using
-  `--lr-table-sticky-offset` rather than overlap. A sticky body cell's
+  `--lr-table-sticky-offset` rather than overlap. Open overlays in a sticky cell stay on top. A sticky body cell's
   background always matches its own row's effective fill — striped, selected, hovered, or pressed —
   rather than painting a flat opaque surface over that state; a sticky header cell is unaffected
   (headers are never striped/selected) and keeps its plain surface fill, see
@@ -275,15 +275,15 @@ cell: (row) => unknown }` — `cell` is required for every `editTrigger` except
 - `paginationMode: 'client'|'server' = 'client'` (attribute `pagination-mode`, reflected) — client
   mode slices rows and updates `page`; server mode leaves `page` controlled and bounds the supplied
   page to `pageSize`
-- `unknownTotal: boolean = false` (attribute `unknown-total`, reflected) — server pagination for a
-  caller with no total item count, only whether one more page exists (`hasNext`). Forwarded to the
-  nested `<lr-pagination>` as its own indeterminate mode (`total="-1"`): previous/next only, no
-  numbered page list, no item-range summary. Ignored outside `paginationMode: 'server'` — client
-  mode always knows the exact row count it slices. A dedicated boolean rather than reusing
-  `totalItems`'s own `-1` sentinel, which already means "derive from the currently matching rows"
-- `hasNext: boolean = true` (attribute `has-next`, reflected) — whether at least one more page
-  exists past the current one; consulted only alongside `unknownTotal` and forwarded verbatim to
-  the nested `<lr-pagination>`'s own `hasNext`
+- `unknownTotal: boolean = false` (attribute `unknown-total`, reflected) — server pagination with
+  no total, only `hasNext`: the pager's indeterminate mode (previous/next only). Ignored outside
+  `paginationMode: 'server'`
+- `hasNext: boolean = true` (attribute `has-next`, reflected) — whether another page exists;
+  read only with `unknownTotal`
+- `paginationWithSummary: boolean = false` (attribute `pagination-with-summary`, reflected) —
+  pager item-range summary at the inline start, controls at the inline end
+- `paginationFormat: 'standard'|'compact' = 'compact'` (attribute `pagination-format`) — pager
+  `format`; invalid values resolve to `compact`
 - Editable columns emit `lr-cell-edit` on commit and never mutate the supplied row object.
 - `groupBy?: (row: T) => string | number` (attribute: false) — inserts a non-focusable full-width
   group row wherever this key changes between consecutive rendered rows. Supply `rows` with each
@@ -519,7 +519,9 @@ affordance; the part has no live-region role in either appearance),
 and cells reuse the ordinary `row`/`cell`/`row-total-cell` parts, which is exactly what keeps them
 geometrically identical to real rows, so `skeleton` is the part to target for the placeholder's own
 look: `::part(skeleton) { --lr-skeleton-h: 2em; }`), and
-`pagination`, `cell-editor`, `group-row`, `group-cell`, and `resize-handle` (the focusable column
+`pagination` (the pager host; re-exported as `pagination-summary`,
+`pagination-controls`, `pagination-pages`, `pagination-page`, `pagination-page-current`,
+`pagination-page-field`, `pagination-page-input`, `pagination-page-count`, `pagination-button`), `cell-editor`, `group-row`, `group-cell`, and `resize-handle` (the focusable column
 separator, with a finite explicit ARIA maximum even when no CSS `maxWidth` was supplied). The built-in empty state is addressable rather than fixed: `empty` is the `<lr-empty>`
 host in all three empty states, and it re-exports that element's own inner parts as `empty-base`,
 `empty-icon`, `empty-heading`, `empty-description` and `empty-actions`. Note that the no-columns and
@@ -568,7 +570,7 @@ the padding of a header cell, a body cell, and the row-total cell; `--lr-table-c
 footer cell, which default to a tighter block/inline shorthand rather than sharing the first token
 outright — two hooks instead of one preserve that distinction. `--lr-table-font-size` (default
 `inherit`) sets the `<table>` element's font size; the rest of the font shorthand (family,
-weight, etc.) keeps inheriting from the host regardless of this override. `--lr-table-max-height` (default `none`; controls the scrollable
+weight, etc.) keeps inheriting from the host regardless of this override. `--lr-table-surface` (default `var(--lr-color-surface)`) is the one surface the frame, resting/striped rows, sticky header and sticky columns, expanded rows and footer all paint, so recolouring a raised panel needs one declaration; `--lr-table-radius` (default `var(--lr-radius-container)`) is the frame radius, and the frame clips painted content to it (`overflow: clip` while `scroll-mode="auto"` content fits, so no scroll container appears and the sticky header still pins to the page; `page` mode clips the same way while content fits and falls back to `overflow: visible` only when the table is wider than its host, so it still overflows the page). `--lr-table-max-height` (default `none`; controls the scrollable
 body's `max-block-size`). `--lr-table-heat-tint-lo` (default `var(--lr-color-brand-quiet)`) and
 `--lr-table-heat-tint-hi` (default `var(--lr-color-brand)`) — the `color-mix()` ramp endpoints
 for heat-tint mode's per-cell background, consulted only on columns/rows that define `heatValue`;

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

@@ -40,10 +40,10 @@ It emits a request only; the host must assign a new reordered `items` array befo
 moves or an announcement is made. `heading?: string` — the visible section title; omission
 localizes `taskListLabel` (`'Tasks'` in the built-in English catalog); any supplied value is an
 explicit verbatim override, including `'Tasks'` under a non-English `.strings` catalog and `''`.
-`headingLevel: LyraHeadingLevel = '3'`
+`headingLevel: LyraHeadingLevel = 'none'`
 (attribute `heading-level`, reflected) — `1`–`6` expose the visible header as that semantic heading
-level around either its disclosure button or static content, invalid untyped values retain level 3,
-and `none` is the explicit visual-only opt-out. `collapsed: boolean = false` (reflected) — hides the
+level around either its disclosure button or static content, invalid untyped values use level 3,
+and `none` (the default) keeps the header visual-only. `collapsed: boolean = false` (reflected) — hides the
 body; the list starts shown. `withoutCollapse: boolean = false` (attribute
 `without-collapse`) — renders the header as a static heading with no toggle; `collapsed` can still
 be set programmatically. `size: LyraSize = 'm'` (reflected)

package/llms/components/lr-test-results.md

@@ -47,10 +47,8 @@ a test. Derive the complete name with the exported
 segments; isolated UTF-16 surrogates, which that built-in rejects, use deterministic uppercase
 `%uXXXX` code-unit escapes. It renders after the plain `message` once expanded (for example, suite
 `unit` and test `same` use `slot="detail-unit:same"`). This is the only detail slot the component
-reads, and exactly one is mounted per row. The legacy `detail-{suiteId}-{testId}` and
-`detail-{testId}` spellings were removed in 9.0.0 — content assigned to either is never slotted and
-never makes a row expandable; migrate by deriving the name with
-`testResultDetailSlotName(suiteId, testId)`. Slot listeners remain mounted while detail is absent,
+reads, and exactly one is mounted per row. Derive the slot name with
+`testResultDetailSlotName(suiteId, testId)`; other `detail-*` spellings are never slotted. Slot listeners remain mounted while detail is absent,
 so appending matching slotted content after the component's first render immediately enables the
 row's disclosure.
 

package/llms/components/lr-textarea.md

@@ -6,7 +6,7 @@
 - **Class** `LyraTextarea`, also available unregistered from `@aceshooting/lyra-ui/components/forms/textarea/textarea.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, 12 custom properties — see this component's own `@csspart`/`@cssprop` list below

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

@@ -290,9 +290,10 @@ lr-thread-list::part(row-item-label) {
 }
 ```
 
-Do **not** reach for `::part(row) { --lr-theme-space-s: … }` instead. That is a whole-subtree
-retheme: it shrinks everything nested inside the row, including the items of a `renderActions` menu,
-which pushes their touch targets below the accessible minimum. The `row-item-*` parts exist so row
+Do **not** reach for `::part(row) { --lr-theme-space-s: … }` instead. A part is not a theme scope,
+so the input does not re-derive the spacing of the components nested in the row; and a scope there
+would be a whole-subtree retheme that shrinks everything inside the row, including the items of a
+`renderActions` menu, below the accessible touch-target minimum. The `row-item-*` parts exist so row
 density can be tuned without that blast radius.
 
 **Sizing:** the internal list fills whatever height this component is given, with no consumer CSS —

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

@@ -6,7 +6,7 @@
 - **Class** `LyraTimeInput`, also available unregistered from `@aceshooting/lyra-ui/components/forms/input/time-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, 36 custom properties — see this component's own `@csspart`/`@cssprop` list below

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

@@ -6,10 +6,10 @@
 - **Class** `LyraTimeRange`, also available unregistered from `@aceshooting/lyra-ui/components/forms/time-range/time-range.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, 22 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 7 parts, 23 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`
 
 ---
@@ -155,9 +155,10 @@ and win over the `preset-active-*` names, so one theme can style both controls'
 
 Pointer states and handle chrome are independently themeable too:
 
-- `--lr-time-range-preset-hover-border-color`,
+- `--lr-time-range-preset-hover-bg`, `--lr-time-range-preset-hover-border-color`,
   `--lr-time-range-preset-pressed-border-color`, and `--lr-time-range-preset-pressed-bg` control
-  preset hover/press paint.
+  preset hover/press paint; `<lr-date-picker>` takes the same `-hover-border-color`,
+  `-pressed-border-color` and `-selected-border-color` names, and both rows share one paint sheet.
 - `--lr-time-range-handle-bg`, `--lr-time-range-handle-border-color`,
   `--lr-time-range-handle-hover-bg`, and `--lr-time-range-handle-pressed-bg` control the handle's
   resting, hovered, and pressed paint.

package/llms/components/lr-time-zone-picker.md

@@ -6,7 +6,7 @@
 - **Class** `LyraTimeZonePicker`, also available unregistered from `@aceshooting/lyra-ui/components/forms/time-zone-picker/time-zone-picker.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `experimental` since `25.5.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, 0 custom properties — see this component's own `@csspart`/`@cssprop` list below

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

@@ -6,7 +6,7 @@
 - **Class** `LyraTimelineItem`, also available unregistered from `@aceshooting/lyra-ui/components/data/timeline/timeline-item.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** 11 parts, 8 custom properties — see `lr-timeline.md`

package/llms/components/lr-timeline.md

@@ -6,7 +6,7 @@
 - **Class** `LyraTimeline`, also available unregistered from `@aceshooting/lyra-ui/components/data/timeline/timeline.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** 1 part, 7 custom properties — see this component's own `@csspart`/`@cssprop` list below

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

@@ -6,7 +6,7 @@
 - **Class** `LyraToggleGroup`, also available unregistered from `@aceshooting/lyra-ui/components/forms/toggle-group/toggle-group.class.js`
 - **Family** `components/forms/` — 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: [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** 1 part, 2 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-toggle.md

@@ -6,7 +6,7 @@
 - **Class** `LyraToggle`, also available unregistered from `@aceshooting/lyra-ui/components/forms/toggle/toggle.class.js`
 - **Family** `components/forms/` — 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: [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** 5 parts, 11 custom properties — see this component's own `@csspart`/`@cssprop` list below

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

@@ -6,7 +6,7 @@
 - **Class** `LyraTokenInput`, also available unregistered from `@aceshooting/lyra-ui/components/forms/token-input/token-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** 12 parts, 25 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-tool-approval-dialog.md

@@ -83,11 +83,11 @@ renders at the start of the action row, before Deny/Edit/Approve.
 void` and `close(reason = 'api'): void` close through the same reasoned lifecycle, emit `lr-close`,
 and return focus to whatever had it before opening; all are no-ops when already in the target state.
 
-**Events:** `lr-approve-request` (`detail: { args: unknown }` — the current, already-parsed arguments: the
+**Events:** `lr-approve-request` (`detail: { args: unknown, waitUntil }` — the current, already-parsed arguments: the
 original `args` prop, or the user's edited-and-validated version if an edit was in progress.
 Cancelable: a listener calling `preventDefault()` sets `pendingAction` to `'approve'` instead of
 closing; otherwise followed by `lr-close` with reason `'approve'`), `lr-deny-request`
-(`detail: null`, cancelable, with the same `pendingAction` mechanism,
+(`detail: { waitUntil }`, cancelable, with the same `pendingAction` mechanism,
 setting `pendingAction` to `'deny'`; otherwise followed by `lr-close` with reason `'deny'`), `lr-close`
 (`detail: { reason: ToolApprovalDialogCloseReason }` — fired exactly once per dismissal, via Escape, an opted-in
 backdrop click, the Approve/Deny buttons, or a `close()` call; not dialog-scoped — nesting this
@@ -95,14 +95,16 @@ dialog inside a consumer's own `<lr-dialog>` means that dialog's `lr-close` list
 this event, see `<lr-dialog>`'s `lr-close` section in `overlays.md` for the full list of emitters
 and the target-filtering guard), and no-detail `focus`/`blur` events
 re-dispatched when the raw-JSON editor gains or loses focus.
-`lr-close` remains the non-cancelable dismissal notification.
-
-`waitUntil()` is `<lr-confirm-bar>`-only and this dialog does not carry it. The two components share
-the `lr-approve-request`/`lr-deny-request` event *names*, so the generated `HTMLElementEventMap['lr-approve-request']` is the
-union of both details and only the confirm bar's arm has the field: a listener bound to the shared
-name (`document.addEventListener('lr-approve-request', ...)`) must narrow on `event.target` before reaching
-for it, while one bound through `LyraConfirmBarEventMap`/`LyraToolApprovalDialogEventMap` already
-sees the right detail. Hold a decision open here with `preventDefault()` + `pendingAction`, then
+`lr-close` remains the non-cancelable dismissal notification. Non-cancelable `lr-decision-settled`
+(`detail: { decision: 'approved' | 'denied' }`) follows the `lr-close` whose reason is `'approve'` or
+`'deny'` on every path that reaches a decision.
+
+`waitUntil(promise: Promise<unknown>) => void` is ExtendableEvent-style and has the same contract as
+`<lr-confirm-bar>`'s (see that section): call it synchronously from an `lr-approve-request`/
+`lr-deny-request` listener to hold the decision pending (`pendingAction`) until every passed promise
+settles; a rejection restores the undecided state, a later call warns and does nothing. The event names
+are shared with the confirm bar, so a listener bound to the shared name should still narrow on
+`event.target`. Alternatively hold a decision open with `preventDefault()` + `pendingAction`, then
 finalize with `close('approve'|'deny')` or bounce back by clearing `.pendingAction`.
 
 **Slots:** `footer` — optional supplementary content (e.g. a "remember this choice" checkbox),