@aceshooting/lyra-ui 26.0.0 → 27.0.0

package/llms/components/lr-eval-dataset.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** 12 parts, 21 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 13 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`
 
 ---
@@ -61,28 +61,13 @@ loses focus, since native focus neither bubbles nor crosses the shadow boundary.
 All three built-in columns are sortable; activating one of their headers produces that commit for
 the host to apply to its controlled `examples` array.
 
-**CSS parts:** `base`, `toolbar`, `search`, `search-input`, `search-clear` (replaces the native
-search-cancel glyph the component resets; rendered only while the field has text), `tag-filter`,
+**CSS parts:** `base`, `toolbar`, `search`, `search-input` (the composed `lr-input type="search"`),
+`search-input-field` (its native `<input>`), `search-clear` (its clear button, rendered only while the field has text), `tag-filter`,
 `grid`, `add-button`, `remove-button`, `limit` (shown when the source examples exceed the snapshot
 cap), `import` (the internal `compact` `lr-file-input`; its
 dropzone text and accessible name are the localized `evalDatasetImportLabel`), `export`.
 
-**Themeable custom properties:** `--lr-eval-dataset-search-min-height` (default `auto`),
-`--lr-eval-dataset-search-font-size` (default `inherit`),
-`--lr-eval-dataset-search-padding-inline` (default `var(--lr-space-s)`),
-`--lr-eval-dataset-search-padding-block` (default `var(--lr-space-xs)`) and
-`--lr-eval-dataset-search-radius` (default `var(--lr-radius)`) size the built-in search field; point
-the height at a `--lr-form-control-height-*` tier to match it to a themed search field. The trailing
-inline gutter is reserved for the overlaid `search-clear` button and is not a knob. When a
-component-specific geometry hook is unset, the field also honors matching `--lr-input-*` and
-`--lr-form-control-*` hooks. Its clear action honors the shared `--lr-icon-button-*` paint hooks.
-The search field accepts `--lr-input-fill`, `--lr-input-border-color`,
-`--lr-input-focus-border-color`, `--lr-input-placeholder-color`,
-`--lr-input-action-color`, and `--lr-input-action-hover-color`. The clear action accepts
-`--lr-icon-button-bg`, `--lr-icon-button-bg-hover`, `--lr-icon-button-bg-active`,
-`--lr-icon-button-border`, `--lr-icon-button-border-hover`, `--lr-icon-button-border-active`,
-`--lr-icon-button-color`, `--lr-icon-button-color-hover`, `--lr-icon-button-color-active`, and
-`--lr-icon-button-radius` for its resting, hover, and pressed paint.
+**Themeable custom properties:** the built-in search field is a composed `lr-input`, so it is themed through the shared `--lr-input-*` and `--lr-form-control-*` tokens (the former `--lr-eval-dataset-search-*` hooks are removed).
 The search field remains a filter toolbar, with the native editing hints listed above.
 
 **Known gotchas:**

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

@@ -6,7 +6,7 @@
 - **Class** `LyraExportButton`, also available unregistered from `@aceshooting/lyra-ui/components/utility/export-button/export-button.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** 6 parts, 16 custom properties — see this component's own `@csspart`/`@cssprop` list below
@@ -117,13 +117,13 @@ corner radius without a `::part(trigger)` rule. Plus shared
 tokens, including `--lr-popover-viewport-clamp` (default `92vw`) — the shared narrow-viewport ceiling the `menu`'s max-inline-size is `min()`ed
 against, alongside its own `20rem` cap and the positioner's available space. See `lr-tour` for the
 shared-clamp note.
-The menu popup is a floating surface and paints from the **shared overlay-surface family** (16.0.0):
+The menu popup is a floating surface and paints from the **shared overlay-surface family**:
 `--lr-overlay-surface` (default `var(--lr-color-surface-overlay)`), `--lr-overlay-border` (default
 `var(--lr-color-border-subtle)`) and `--lr-overlay-shadow-anchored` (default `var(--lr-shadow-m)`). None is
 declared on `:host`, so one declaration on `:root` — or on any ancestor, to scope it — retints this
 surface together with every other floating surface in the library. `--lr-overlay-radius` (default `var(--lr-radius)`) is the matching corner radius.
 
-`--lr-positioning-strategy` (16.0.0) — the format menu reads this same cascading `absolute`/`fixed`
+`--lr-positioning-strategy` — the format menu reads this same cascading `absolute`/`fixed`
 override documented on `<lr-popover>` when it is (re)positioned, falling back to its own `fixed`
 default when nothing is set. There is no per-instance `positioning-strategy` property on
 `<lr-export-button>`; set the custom property on `:root`, a theme, or one clipping ancestor to

package/llms/components/lr-file-icon.md

@@ -30,11 +30,6 @@ next to the label in `mode="label"`; `0`, the default, renders no size), `label`
 registry). A host `aria-label` wins over the computed localized file-type/size name. `decorative`
 changes the semantic owner to presentation and renders `aria-hidden="true"` explicitly.
 
-**Renamed in 8.0.0 — breaking:** the byte count is `bytes`, not `size`. Everywhere else in this
-library `size` names a tier on the shared size ladder, and a numeric byte count answering to the
-same property name is a collision a consumer only discovers at runtime. A leftover `size="245000"`
-is an unknown attribute now: `bytes` stays `0` and the badge silently renders without a size.
-
 **CSS parts:** `base`, `icon`, `label`, `description` (consumer-authored registry metadata in label
 mode), and `size` (the part keeps its name — it is the rendered size _text_, and renaming a part
 would break shipped `::part()` rules for no gain).

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

@@ -30,8 +30,8 @@ enabled buttons retain pointer feedback.
 
 **Properties:**
 
-- `multiple: boolean = false` (reflected) — a plain HTML boolean like `wa-file-input`'s, so
-  `multiple="false"` is still true here; `lr-drop-zone` and `lr-attachment-trigger` read it as false
+- `multiple: boolean = false` (reflected) — `multiple="false"` reads as false, like
+  `lr-drop-zone` and `lr-attachment-trigger`; bare `multiple` opts into batches
 - `disabled: boolean = false` (reflected)
 - `files: File[] = []` — selected files; programmatic writes are event-silent and immediately
   synchronize rendering, validity, and form submission
@@ -104,9 +104,7 @@ enabled buttons retain pointer feedback.
   below); `s` and the steps below it give a denser dropzone for constrained spaces (a toolbar, a
   table cell).
 - `validators: LyraFileInputValidator[] = []` (attribute: false) — additional JavaScript
-  constraints, run after the intrinsic `required` check. **Fixed in 9.0.0:** the property was
-  previously declared (typed `unknown[]`) and read by nothing, so an assigned validator silently
-  never ran. It now implements the same contract as `lr-date-input`/`lr-combobox`:
+  constraints, run after the intrinsic `required` check. It implements the same contract as `lr-date-input`/`lr-combobox`:
   - a function `(files: File[], input: LyraFileInput) => void | boolean | string | ValidityStateFlags`
     — `undefined`/`true` passes, a string is the validation message (raising `customError`), `false`
     is a generic failure using the localized `valueInvalid` string, and a `ValidityStateFlags` object

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

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

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

@@ -6,7 +6,7 @@
 - **Class** `LyraFilterBar`, also available unregistered from `@aceshooting/lyra-ui/components/layout/filter-bar/filter-bar.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.1.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [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** 30 parts, 2 custom properties — see this component's own `@csspart`/`@cssprop` list below
@@ -201,6 +201,10 @@ flex-basis is themeable via `--lr-filter-bar-field-basis` (default `var(--lr-siz
 `end` slot, the reset button, and the loading status in the `controls` row. Both are byte-identical
 to the previous hardcoded values when unset.
 
+The reset button and the `end` slot form one wrapping action group, and the `end` wrapper reserves the
+same trailing validation spacer as a field, so slotted end actions sit on the field frames' bottom
+edge (level with Reset) and wrap to the next row together.
+
 Each field wrapper also carries a second, per-filter part token, `field-<filterId>` (for example
 `part="field field-status"`), so a single field can be targeted directly --
 `lr-filter-bar::part(field-status) { flex: 2 1 20rem; }` -- setting any layout property, not just a

package/llms/components/lr-flag.md

@@ -50,8 +50,7 @@ Country/language flag image. Flag artwork ships in a **separate, optional peer p
   card/row sizes (~28–96px); `'detailed'` = the
   pristine full-fidelity vector for hero-scale display. No effect when `src` is set.)
 
-The v9 vocabulary replaces `round` with `shape="circle"` and `variant` with `fidelity`; exported
-authoring types are `LyraFlagShape`, `LyraFlagFidelity`, and `LyraFlagUrlResolver`.
+Exported authoring types are `LyraFlagShape`, `LyraFlagFidelity`, and `LyraFlagUrlResolver`.
 
 **Events:** none.
 

package/llms/components/lr-flow-canvas.md

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

package/llms/components/lr-flow-controls.md

@@ -6,7 +6,7 @@
 - **Class** `LyraFlowControls`, also available unregistered from `@aceshooting/lyra-ui/components/data/flow-controls/flow-controls.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** 5 parts, 1 custom property — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-flow-minimap.md

@@ -6,7 +6,7 @@
 - **Class** `LyraFlowMinimap`, also available unregistered from `@aceshooting/lyra-ui/components/data/flow-minimap/flow-minimap.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** 7 parts, 10 custom properties — see this component's own `@csspart`/`@cssprop` list below
@@ -52,7 +52,7 @@ latest viewport-change text).
 `--lr-flow-status-denied-color`.
 `--lr-flow-minimap-viewport-color` (default `var(--lr-color-brand)`) colors `[part="viewport"]`'s
 fill (mixed 15% into transparent) and stroke, independent of every per-status node fill above.
-`--lr-flow-minimap-viewport-min-size` (default `var(--lr-icon-button-size)`, normally 40px) floors
+`--lr-flow-minimap-viewport-min-size` (default `var(--lr-icon-button-size)`, normally 36px) floors
 only the transparent `viewport-hit-area` along each axis. The visible `viewport` remains the exact
 viewport-to-content ratio. The token inherits from ancestors; set it to `0` to opt out.
 

package/llms/components/lr-flow-node.md

@@ -6,7 +6,7 @@
 - **Class** `LyraFlowNode`, also available unregistered from `@aceshooting/lyra-ui/components/data/flow-node/flow-node.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 slot** `icon` since `26.0.0`; use slot `slot="start"`; removal not before `28.0.0` — The header glyph uses the shared start slot vocabulary; existing icon slot content remains rendered during migration.
 - **Optional peers** none
 - **Themeable via** 12 parts, 15 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-flow-run-status.md

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

package/llms/components/lr-format-bytes.md

@@ -6,7 +6,7 @@
 - **Class** `LyraFormatBytes`, also available unregistered from `@aceshooting/lyra-ui/components/utility/format/format-bytes.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
@@ -25,8 +25,7 @@ Text-only host — no CSS parts, events, or own tokens; locale resolution and
 - `value: number = 0`
 - `unit: 'byte' | 'bit' = 'byte'`
 - `display: 'long' | 'short' | 'narrow' = 'short'` — forwarded as `unitDisplay`
-- `unitStep: number = 1000` (attribute `unit-step`) — mapped decimal scaling. **Changed in 8.0.0:**
-  the former Lyra default was `1024`; it remains an opt-in extension
+- `unitStep: number = 1000` (attribute `unit-step`) — mapped decimal scaling. `1024` is the opt-in binary extension
 - `decimals: number = 1` — maximum fraction digits on the scaled amount
 
 **Slots:** default — fallback content, rendered only when `value` is not finite.

package/llms/components/lr-format-date.md

@@ -6,7 +6,7 @@
 - **Class** `LyraFormatDate`, also available unregistered from `@aceshooting/lyra-ui/components/utility/format/format-date.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 @@ resolution and `Intl`-instance caching are as described in
 
 - `date: string | number | Date = new Date()` — unset means the construction-time current instant.
   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 fallback content
+  zero and negative epochs); nonnumeric strings retain ordinary date/ISO parsing.
 - optional granular fields: `weekday`, `era`, `year`, `month`, `day`, `hour`, `minute`, `second`,
   and `timeZoneName` (attribute `time-zone-name`), each restricted to its corresponding published
   `Intl.DateTimeFormat` literal set

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

@@ -6,7 +6,7 @@
 - **Class** `LyraFormatNumber`, also available unregistered from `@aceshooting/lyra-ui/components/utility/format/format-number.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

package/llms/components/lr-funnel.md

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

package/llms/components/lr-gauge.md

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

package/llms/components/lr-generation-metrics.md

@@ -65,7 +65,7 @@ is unset and `status="running"`)
 **Themeable custom properties:** shared tokens only — `--lr-color-text-quiet` (base readout and
 tokens/throughput text color), `--lr-color-text` (the elapsed segment's higher-contrast color,
 and the stop-button's icon color), `--lr-space-s` (stop-button margin), `--lr-icon-button-size`
-(stop-button minimum sizing; the full shared 40px-equivalent hit floor applies), `--lr-color-border`/`-surface`/`-brand`
+(stop-button minimum sizing; the full shared hit floor applies), `--lr-color-border`/`-surface`/`-brand`
 (stop-button border/background/hover), `--lr-focus-ring-width`/`-color`/`-offset`,
 `--lr-transition-fast`.
 

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

@@ -6,7 +6,7 @@
 - **Class** `LyraGraphQueryBuilder`, also available unregistered from `@aceshooting/lyra-ui/components/data/graph-query-builder/graph-query-builder.class.js`
 - **Family** `components/data/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.1.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [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** 28 parts, 16 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-heatmap.md

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

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

@@ -6,7 +6,7 @@
 - **Class** `LyraIconButton`, also available unregistered from `@aceshooting/lyra-ui/components/forms/icon-button/icon-button.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** `dompurify` — see `llms/peers.md`
 - **Themeable via** 3 parts, 11 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-icon.md

@@ -6,7 +6,7 @@
 - **Class** `LyraIcon`, also available unregistered from `@aceshooting/lyra-ui/components/utility/icon/icon.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)
 - **Deprecated property** `autoWidth` / `auto-width` since `8.0.0`; use property `canvas="auto"`; removal not before `10.0.0` — autoWidth is a boolean compatibility spelling that cannot express fixed canvas sizes; canvas covers both automatic and explicit sizing. That version is a policy floor, not a plan: `wa-icon` still publishes its own deprecated `auto-width` attribute, so this alias is removed only when upstream's is.
 - **Optional peers** `dompurify` — see `llms/peers.md`
 - **Themeable via** 4 parts, 44 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-input.md

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

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

@@ -6,7 +6,7 @@
 - **Class** `LyraIntersectionObserver`, also available unregistered from `@aceshooting/lyra-ui/components/utility/intersection-observer/intersection-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-json-viewer.md

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

package/llms/components/lr-knowledge-graph-explorer.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [retrieval](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/retrieval.md)
 - **Deprecations** none
 - **Optional peers** `d3-drag`, `d3-force`, `d3-selection`, `d3-zoom` — see `llms/peers.md`
-- **Themeable via** 14 parts, 1 custom property — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 15 parts, 1 custom property — see this component's own `@csspart`/`@cssprop` list below
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
 
 ---
@@ -146,7 +146,7 @@ pin toggle; no effect while `details` is overridden.
 composed `lr-graph-legend`), `search-results` (only while `query` is non-empty; at most 50 rows,
 one tab stop moved with ArrowUp/ArrowDown/Home/End, while the announced count covers every match),
 `search-result` (`role="listitem"` wrapping a `<button>`), `search-empty`, `search-limit` (a localized
-shown/total notice when more than 50 nodes match), `pinned` (only while
+shown/total notice when more than 50 nodes match), `details-limit` (a localized shown/total notice when `entityDetails` is too large to keep), `pinned` (only while
 `pinnedNodeIds` is non-empty), `pinned-heading`, `graph` (the composed `lr-graph`), `path` (only
 while `path` is non-empty), `detail-popover`, `detail-card`.
 

package/llms/components/lr-known-date.md

@@ -6,7 +6,7 @@
 - **Class** `LyraKnownDate`, also available unregistered from `@aceshooting/lyra-ui/components/utility/known-date/known-date.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)
 - **Deprecated part** `label` since `8.0.0`; use part `::part(form-control-label)`; removal not before `10.0.0` — The form-control-label part matches the shared form-control vocabulary; label remains on that same node during the compatibility window. That version is a policy floor, not a plan: `wa-known-date` still publishes its own deprecated `label` part, so this alias is removed only when upstream's is.
 - **Optional peers** none
 - **Themeable via** 17 parts, 13 custom properties — see this component's own `@csspart`/`@cssprop` list below

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

@@ -45,8 +45,7 @@ is no "every item in the tooltip" surface to hook a title or footer formatter on
 - `labels: readonly string[] = []` (attribute: false)
 - `datasets: readonly LyraLiteChartSeries[] = []` (attribute: false) —
   `LyraLiteChartSeries { readonly label: string; readonly data: readonly (number|null)[];
-  readonly color?: string }`. The legacy `LiteSeries` name was removed in 9.0.0 — import
-  `LyraLiteChartSeries` instead.
+  readonly color?: string }`.
   `color` accepts a valid CSS `color`, while invalid values,
   declaration-breaking input, and `url()` paint servers fall back to the built-in palette. A
   runtime entry whose required `data` member is not an array is dropped while valid siblings
@@ -89,7 +88,7 @@ is no "every item in the tooltip" surface to hook a title or footer formatter on
 - `withDataTable: boolean = false` (attribute `with-data-table`) — makes the generated accessible
   table visible rather than screen-reader-only. Same meaning as `lr-chart`'s property of the same
   name.
-- `dataTableToggle: boolean = false` (attribute `data-table-toggle`, new in 11.1.0) — renders a
+- `dataTableToggle: boolean = false` (attribute `data-table-toggle`) — renders a
   localized disclosure button (`part="data-table-toggle"`, with `aria-expanded` and
   `aria-controls`) above the table, so a *sighted* reader can reveal the numbers on demand;
   `withDataTable` then becomes the disclosure's **initial** state rather than its whole behavior.
@@ -295,7 +294,7 @@ mark), `line`, `legend`, `legend-item`, `legend-swatch`, `legend-text` (extra pe
 the series label, rendered only when `legendText` is set), `live-region` (the current mark
 announcement for keyboard users), `data-list` (a visually hidden sampled list of plotted data
 points — single-series only), `data-table` (the generated/slotted alternative container),
-`data-table-toggle` (the `dataTableToggle` disclosure button — new in 11.1.0), `table`
+`data-table-toggle` (the `dataTableToggle` disclosure button), `table`
 (the generated semantic category×series table rendered when there is more than one dataset), and
 `data-truncation` (the
 visible/announced sampling notice).

package/llms/components/lr-live-region.md

@@ -6,7 +6,7 @@
 - **Class** `LyraLiveRegion`, also available unregistered from `@aceshooting/lyra-ui/components/utility/live-region/live-region.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-locale-picker.md

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

package/llms/components/lr-map.md

@@ -177,7 +177,7 @@ string; geojson: GeoJSON.FeatureCollection; field: string; stops: [number, strin
   the documented way to weight a ramp toward the low end). **`stops` stay in the data's own units
   under either mode**, so the legend keeps reading in real values instead of log units — no
   pre-transforming to log10 and hand-relabelling the legend back.
-  `'step'` (new in 11.0.0) emits maplibre's `['step', …]` instead of `['interpolate', …]`, giving
+  `'step'` emits maplibre's `['step', …]` instead of `['interpolate', …]`, giving
   **discrete bands rather than a continuous ramp**. Use it whenever the legend advertises a fixed
   set of ranges with one swatch each: a ramp would put colours on the map that appear nowhere in the
   legend, and would render two regions in the same advertised band as visibly different colours
@@ -458,8 +458,6 @@ payload beside the map.
 `LyraMapPointIconLineCap`, `LyraMapPointIconLineJoin`, `LyraMapMarker`, `LyraMapMarkerActivationDetail`,
 `LyraMapMarkerActivationSource`, `LyraMapLegendToggleDetail`, `LyraMapLegendPanelToggleDetail`,
 `LyraMapStyleSpecification`, and `LyraMapInstance`.
-The former `LegendEntry`, `ChoroplethLayer`, `GeoJsonDataLayer`, and `MapMarker` names are removed
-in v9 rather than retained as aliases.
 
 **Getters:** `map: LyraMapInstance | undefined` → the underlying runtime `maplibregl.Map`, exposed
 through the peer-neutral `getCanvas()`, `getCenter()`, `getZoom()`, `setCenter()`, `setZoom()`, and

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

@@ -79,15 +79,8 @@ and later MIME values restore detection.
   'date' | 'time' | 'true' | 'false'` and reaches every kind, anchor included. Anything outside
   those sets is dropped rather than passed through.
 
-**Renamed in 8.0.0 — breaking:** this was `appearance`. Library-wide, `appearance` now means only
-"how a control fills itself" and `frame` means "whether a container draws itself as a bounded card";
-this property was always the second. There is no alias — `appearance` on `<lr-media-card>` is simply
-an unknown attribute now, so a card left on `appearance="plain"` silently renders the full card
-chrome again.
-
 **Authoring types:** `LyraMediaCardKind` and `LyraMediaCardOpenDetail`; `frame` uses the shared
-`LyraFrame` directly. The former `MediaCardKind`, `MediaCardOpenDetail`, and `MediaCardFrame`
-names are removed in v9 rather than retained as aliases. URL validators are implementation details,
+`LyraFrame` directly. URL validators are implementation details,
 not exports from the component entry.
 
 **Events:** `lr-media-open` (`detail: LyraMediaCardOpenDetail { src: string; filename: string }`,
@@ -98,8 +91,6 @@ cancelable only for a safe file anchor immediately before its native download/op
 `preventDefault()` there suppresses that exact default. `detail.src` is whichever internally
 validated safe-URL sink actually rendered, not necessarily the raw `src` property verbatim — a
 whitespace-padded value is trimmed, so it matches the rendered sink.
-The former generic `lr-open` event is removed in v9: notification and veto phases now have distinct,
-truthful names.
 Native `focus` and `blur` are each relayed once from the current primary action as bubbling,
 composed `FocusEvent`s whose target is the `lr-media-card` host.
 

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

@@ -42,6 +42,8 @@ shape?: 'circle' | 'square' | 'diamond' }`, forwarded verbatim to every expanded
 - `label?: string` — fallback name for the stable overall group; omission uses the localized memory
   panel label. A non-empty host `aria-label` makes the host the sole overall owner; an explicitly
   empty host label stays empty
+- `size: LyraSize = 'm'` (reflected) — density on the shared size scale. `s` (and the smaller `xs`/`2xs`) tightens each `item`'s padding; `m` and larger keep the full padding.
+- `frame: LyraFrame = 'card'` (reflected) — container treatment. `'card'` keeps each memory item's bordered, filled box; `'plain'` removes the border, background and corner radius from every `item`, for use inside an already-bordered container.
 
 Each memory list is canonicalized independently by nonblank `id`. Malformed rows and later
 duplicates are omitted first-wins before empty state, focus/disclosure state, confirmations, counts,

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

@@ -6,7 +6,7 @@
 - **Class** `LyraMentionPopover`, also available unregistered from `@aceshooting/lyra-ui/components/utility/mention-popover/mention-popover.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** 7 parts, 8 custom properties — see this component's own `@csspart`/`@cssprop` list below
@@ -137,7 +137,7 @@ row), and `--lr-popover-viewport-clamp` (default `92vw`) — the shared narrow-v
 popup's max-inline-size is `min()`ed against, alongside its own `24rem` cap and the positioner's
 available space. See `lr-tour` for the shared-clamp note.
 
-The popup is a floating surface and paints from the **shared overlay-surface family** (16.0.0):
+The popup is a floating surface and paints from the **shared overlay-surface family**:
 `--lr-overlay-surface` (default `var(--lr-color-surface-overlay)`), `--lr-overlay-border` (default
 `var(--lr-color-border)`) and `--lr-overlay-shadow-anchored` (default `var(--lr-shadow-m)`). None is
 declared on `:host`, so one declaration on `:root` — or on any ancestor, to scope it — retints this
@@ -146,7 +146,7 @@ The edge deliberately keeps the control tier, `var(--lr-color-border)`, rather t
 decorative `var(--lr-color-border-subtle)` floating panels default to: the listbox completes the
 value of the text field it is bound to and keeps that field's boundary contrast (see `<lr-popover>`).
 
-`--lr-positioning-strategy` (16.0.0) — the popup reads this same cascading `absolute`/`fixed`
+`--lr-positioning-strategy` — the popup reads this same cascading `absolute`/`fixed`
 override documented on `<lr-popover>` when it is (re)positioned, falling back to its own `fixed`
 default when nothing is set. There is no per-instance `positioning-strategy` property on
 `<lr-mention-popover>`; set the custom property on `:root`, a theme, or one clipping ancestor to

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

@@ -6,7 +6,7 @@
 - **Class** `LyraMenuItem`, also available unregistered from `@aceshooting/lyra-ui/components/layout/menu/menu-item.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** 12 parts, 13 custom properties — see `lr-menu.md`

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

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

package/llms/components/lr-menu.md

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

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

@@ -6,7 +6,7 @@
 - **Class** `LyraMenubarItem`, also available unregistered from `@aceshooting/lyra-ui/components/layout/menubar/menubar-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** 2 parts, 2 custom properties — see `lr-menubar.md`

package/llms/components/lr-menubar.md

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