@aceshooting/lyra-ui 26.0.0 → 27.0.0

package/llms/components/lr-combobox.md

@@ -6,7 +6,7 @@
 - **Class** `LyraCombobox`, also available unregistered from `@aceshooting/lyra-ui/components/forms/combobox/combobox.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
@@ -354,13 +354,14 @@ alias. Set the boolean `autocorrect` IDL, or use `autocorrect="on"` / `autocorre
 
 `ComboboxSourceRow = { readonly value: string; readonly label: string; readonly sub?: string; readonly icon?: unknown; readonly start?: unknown;
 readonly end?: unknown; readonly badge?: string |
-number; accessibleLabel?: string; data?: unknown; dotColor?: string; group?: string; disabled?:
+number; readonly title?: string; accessibleLabel?: string; data?: unknown; dotColor?: string; group?: string; disabled?:
 boolean }` — the row shape used by the async `source` path. `start` and `end` (new in 11.0.0) are
 the async counterparts of `<lr-option>`'s `start`/`end` adornment slots and render as the
 `option-start` / `option-end` parts, inert and aria-hidden exactly like `icon`. A string or number `start`/`end` truncates with an ellipsis when it outgrows the part; template content should render an element at its top level to do the same. `icon` renders as a decorative leading
 visual whose rendered subtree stays visible but is inert and hidden from assistive technology;
 put independent actions outside it. `badge` renders as trailing metadata, `accessibleLabel` can
-provide richer spoken text than the visible label, and `data` is retained without being rendered
+provide richer spoken text than the visible label, `title` is the row's tooltip text (never part
+of the accessible name), and `data` is retained without being rendered
 for retrieval through `selectedRows`.
 `dotColor` accepts a valid CSS `color`; invalid values, declaration-breaking input, and `url()`
 render a transparent dot.
@@ -621,6 +622,8 @@ box visibly (nothing is clipped or made unreachable), so leave it unset there.
 - `selected: boolean = false` (property only) — live selectedness. The parent combobox/select
   updates it as the current value changes; those live writes never rewrite the `selected`
   attribute or `defaultSelected`
+- `title: string = ''` — tooltip text forwarded to the row the owning `lr-select`/`lr-combobox` renders
+  for this option and to its multiple-mode tag; never part of the accessible name; omitted when empty
 - `group: string = ''` (section header)
 - `searchText: string = ''` (attribute `search-text` — extra text the filter matches beyond the
   visible label)

package/llms/components/lr-command-palette.md

@@ -6,7 +6,7 @@
 - **Class** `LyraCommandPalette`, also available unregistered from `@aceshooting/lyra-ui/components/layout/command-palette/command-palette.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** 15 parts, 16 custom properties — see this component's own `@csspart`/`@cssprop` list below
@@ -77,7 +77,10 @@ count through the shared polite announcement sink; a query matching nothing anno
 
 **Events:** cancelable `lr-show` (`detail: null`) before opening; cancelable `lr-close-request`
 with `{ reason: 'api' | 'escape' | 'backdrop' | 'select' }` before dismissal; non-cancelable
-`lr-close` with that same reason object after closing; `lr-select`
+`lr-hide` with that same reason object once the close is accepted (the veto is
+`lr-close-request`, so `lr-hide` is not cancelable here, unlike `lr-dialog`); non-cancelable
+`lr-close` with that same reason object after closing; no-detail `lr-after-show` / `lr-after-hide`
+once the palette has rendered open / closed (it has no transition to wait for); `lr-select`
 (`detail: { command }`, fired before the command's own `onSelect` runs and before the palette
 closes), and no-detail `focus`/`blur` events re-dispatched from the host whenever the search input
 gains or loses focus. The `focus`/`blur` bridge is

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

@@ -32,9 +32,7 @@ number` (attribute: false, epoch milliseconds), `files: CommitFileChange[] = []`
 `deletions` across `files`. Counts are normalized to finite non-negative integers before per-file
 display, total arithmetic, localization, and accessible summaries. `path` is the file identity;
 empty/blank paths and later duplicates are omitted before both diffstat arithmetic and row events. `filesExpanded:
-boolean = false` (attribute `files-expanded`, reflected — renamed from `filesCollapsed` in 9.0.0,
-default inverted so the rendered starting state is unchanged: `el.filesCollapsed = true` becomes
-`el.filesExpanded = false`), and `withoutCopyButton: boolean = false` (attribute
+boolean = false` (attribute `files-expanded`, reflected), and `withoutCopyButton: boolean = false` (attribute
 `without-copy-button`, reflected) — hides the hash copy button.
 `size: LyraSize = 'm'` (reflected) — density on the shared size scale: `s` (and the smaller
 `xs`/`2xs`) tightens `[part="base"]` padding for a commit rendered as a row in a list or PR

package/llms/components/lr-condition-builder.md

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

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

@@ -59,8 +59,7 @@ library's shared container-frame vocabulary and behaving exactly as it does on `
 `lr-commit-card`, `lr-result-card`, `lr-task-list`, `lr-terminal` and `lr-thinking-panel`:
 `'plain'` removes the border, background, padding and corner radius so a bar nested inside a
 container that already draws a border doesn't double it, and wins over the dense `size` tier when
-both are set. Before 9.0.0 the density knob alone did both jobs; a bar that relied on that now needs
-`size="s" frame="plain"`. `ConfirmBarDecision = ApprovalDecision | null` names the final-state type.
+both are set. `ConfirmBarDecision = ApprovalDecision | null` names the final-state type.
 `pendingAction: ApprovalAction | null = null` (attribute `pending-action`, reflected) — which action
 is awaiting host resolution while an `lr-approve-request`/`lr-deny-request` listener has called `preventDefault()` on
 the now-cancelable event; the pending button shows `loading`, the other is `disabled`. Set
@@ -124,9 +123,9 @@ then writing `pendingAction` and later `decision` by hand — still works unchan
 resolves the decision itself synchronously, by writing `decision` or `pendingAction` during the dispatch,
 wins outright over both: the bar applies no bookkeeping of its own, `waitUntil()`'s included.
 
-`waitUntil` is this component's alone: `<lr-tool-approval-dialog>` emits the same `lr-approve-request`/
-`lr-deny-request` names without it, so a listener bound to the shared name rather than to one component
-must narrow on `event.target` — see that component's Events section.
+`<lr-tool-approval-dialog>` emits the same `lr-approve-request`/`lr-deny-request` names with the same
+`waitUntil`, so a listener bound to the shared name rather than to one component should still narrow on
+`event.target` — see that component's Events section.
 
 `lr-decision-settled` fires after the decided `[part="status"]` has rendered and its live-region
 announcement has been made, on every path that reaches a decision — the bar's own, a `waitUntil()`
@@ -135,11 +134,8 @@ awaiting a single `updateComplete` after your own promise resolves is not enough
 promise chain and Lit's update queue interleave. A `decision` present in the initial markup
 announces and settles nothing — it never transitioned.
 
-**16.0.0 — breaking detail change.** `lr-deny`'s detail changed from `null` to `{ waitUntil }` and
-`lr-approve`'s from `{ args }` to `{ args, waitUntil }`. The canonical request events use those same
-detail shapes. A listener that compared the whole detail
-object (`detail === null`, or a deep-equality check against `{ args }`) must read the fields it uses
-instead.
+`lr-deny`'s detail is `{ waitUntil }` and `lr-approve`'s is `{ args, waitUntil }`; the canonical
+request events use the same shapes. Read the fields rather than comparing the whole detail object.
 
 
 **CSS parts:** `base` (`role="group"`), `heading`/`tool-name`, `body`, `args` (the
@@ -161,9 +157,7 @@ scoped to `[part="base"]` while `size` is `s` or smaller: `--lr-confirm-bar-comp
 `--lr-confirm-bar-compact-gap` (default `var(--lr-space-s)`, the gap between the row's items). They
 are inline `var()` fallbacks at their point of use rather than `:host` declarations, so either can
 be set on the element _or on any ancestor_, which is what makes "tighten every dense confirm bar
-in this panel" a one-rule change on the panel. The dense tier's former chrome-removing border,
-fill and radius properties were removed in 9.0.0 along with its chrome behavior: chrome is now
-`frame`'s job, so keep the default `frame="card"` (and restyle via `::part(base)`) instead of
+in this panel" a one-rule change on the panel. Chrome is `frame`'s job, so keep the default `frame="card"` (and restyle via `::part(base)`) instead of
 re-chroming a chrome-less dense bar.
 
 Two further properties recolor the decided state: `--lr-confirm-bar-approved-color` (default

package/llms/components/lr-connector-manager.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** 14 parts, 0 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 16 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`
 
 ---
@@ -47,6 +47,8 @@ remains empty.
 | `status` | Localized controlled connection status (`tabindex="-1"`). |
 | `error` | Optional host-localized error text. |
 | `action` | Native action button, themed through the shared `--lr-button-*` tokens. |
+| `action-base` | The action button's internal control (forwarded from `<lr-button>`). |
+| `action-label` | The action button's label wrapper (forwarded from `<lr-button>`). |
 | `empty` | Empty state. |
 | `limit` | Notice that more than 100 valid connectors were supplied. |
 

package/llms/components/lr-context-inspector.md

@@ -39,7 +39,7 @@ end: number; reason?: string }` marks character ranges within `text` that are re
   copy/export text rather than rejecting the render.
 - `total: number = 0` — the full token budget `segments` are measured against; passed straight to
   `lr-context-meter.total`
-- `label: string = ''` — accessible group name, and the embedded meter's visible caption (e.g.
+- `label?: string` — accessible group name (`''` is used verbatim), and the embedded meter's visible caption (e.g.
   "128K context window")
 - `exportFormats: readonly LyraExportFormatOption[] = ['json']` (attribute: false) — forwarded to the embedded
   `lr-export-button`; one id renders a plain button, more than one a format-choice menu

package/llms/components/lr-context-meter.md

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

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

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

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

@@ -6,7 +6,7 @@
 - **Class** `LyraCopyButton`, also available unregistered from `@aceshooting/lyra-ui/components/utility/copy-button/copy-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** 13 parts, 2 custom properties — see this component's own `@csspart`/`@cssprop` list below
@@ -53,9 +53,9 @@ buttons.
   icon-only trigger always remains named; remove the attribute or assign `null` for the same
   fallback.
 - `disabled: boolean = false` (reflected)
-- `feedbackDuration: number = 1000` (attribute `feedback-duration`) — milliseconds before the
+- `feedbackDuration: number = 1500` (attribute `feedback-duration`) — milliseconds before the
   confirmation **or** the failure state returns to the copy icon. A non-finite value falls back to
-  `1000` rather than leaving the state stuck; a negative one clamps to `0`.
+  `1500` rather than leaving the state stuck; a negative one clamps to `0`.
 
 **Methods:** `focus(options?)`, `blur()` and `click()` forward to the active built-in or custom
 trigger. `getToolbarActions(): readonly LyraToolbarAction[]` implements the public logical-toolbar
@@ -89,7 +89,7 @@ the built-in button. Exactly one named icon is rendered at a time.
 
 **CSS parts:**
 
-- `base` / `button` — the built-in trigger, a composed `<lr-icon-button>` as of 16.0.0. It owns the
+- `base` / `button` — the built-in trigger, a composed `<lr-icon-button>`. It owns the
   accessible name, the activation and every state part below; its background, radius, hover/press
   mixes, focus ring and hit-area floor come from `--lr-icon-button-*`.
 - `base-control` — the composed `<lr-icon-button>`'s own native `<button>`. A rule that set
@@ -168,12 +168,10 @@ import type {
 
 **Known gotchas:**
 
-- **Changed in 8.0.0:** the button used to enter the "Copied" confirmation on activation whether or
-  not the clipboard write succeeded. It now waits for `navigator.clipboard.writeText()` to settle: a
-  rejection renders the failure glyph instead, announces the localized failure text through the
-  shared polite region mirrored by `[part="feedback"]`, and emits `lr-error` plus `lr-copy-error`.
-  `lr-copy` is now the success-only fulfilled outcome; code that tracked activation attempts from
-  that event should instead track the initiating click separately.
+- The button enters "Copied" only after `navigator.clipboard.writeText()` resolves. A rejection
+  renders the failure glyph, announces the localized failure text through the shared polite region
+  mirrored by `[part="feedback"]`, and emits `lr-error` plus `lr-copy-error`. `lr-copy` is the
+  success-only outcome; track activation attempts from the initiating click.
 - An empty `value`, missing `from` target/member, or empty resolved source is an error; no clipboard
   write is attempted. `from` always wins over `value`, including when it is invalid.
 - `navigator.clipboard` is absent in insecure contexts/older browsers, and some engines throw

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

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

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

@@ -6,7 +6,7 @@
 - **Class** `LyraCurrencyPicker`, also available unregistered from `@aceshooting/lyra-ui/components/forms/currency-picker/currency-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-dashboard-grid.md

@@ -6,7 +6,7 @@
 - **Class** `LyraDashboardGrid`, also available unregistered from `@aceshooting/lyra-ui/components/layout/dashboard-grid/dashboard-grid.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** `dompurify`, `katex`, `marked`, `shiki` — see `llms/peers.md`
 - **Themeable via** 5 parts, 7 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-data-grid.md

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

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

@@ -6,7 +6,7 @@
 - **Class** `LyraDateInput`, also available unregistered from `@aceshooting/lyra-ui/components/forms/date-picker/date-input.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `experimental` 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** 22 parts, 28 custom properties — see `lr-date-picker.md`

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

@@ -6,10 +6,10 @@
 - **Class** `LyraDatePicker`, also available unregistered from `@aceshooting/lyra-ui/components/forms/date-picker/date-picker.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `experimental` 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** 38 parts, 33 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 38 parts, 36 custom properties — see this component's own `@csspart`/`@cssprop` list below
 - **Documented with** `lr-date-input` (same section below)
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
 
@@ -296,8 +296,10 @@ Text field + calendar popover, **form-associated** via the shared `FormAssociate
 
 Lyra retains additive native-wrapper and form-chrome properties: `placeholder`, `locale`,
 `errorText`, `accessibleLabel` (attribute `aria-label`), `clearLabel`, `openLabel`, `dialogLabel`,
-`spellcheck`, `autocapitalize`, `autoCorrect` (attribute `autocorrect`), `inputMode: string = ''`
-(attribute `inputmode`), `enterKeyHint: string = ''` (attribute `enterkeyhint`), and the reflected
+`spellcheck`, `autocapitalize`, boolean `autocorrect` (the string `autoCorrect` is removed; attribute `autocorrect="on|off"`),
+`inputMode: string = ''` (attribute `inputmode`, lowercase `inputmode` property alias),
+`enterKeyHint: string = ''` (attribute `enterkeyhint`, lowercase `enterkeyhint` property alias), the host `name`, which is also
+forwarded to the internal text input (as it is on `lr-otp-input`), and the reflected
 `customError: string | null` (attribute `custom-error`). `withLabel` and `withHint` are SSR hints:
 they force those slot wrappers into the first render so server output and hydration have the same
 structure even before assigned-slot state is observable. The shared Lyra FACE contract also
@@ -500,6 +502,11 @@ and `dateTimeFormat(locale, options)`.
   `--lr-date-picker-preset-selected-color` (default `var(--lr-color-on-brand)`) independently
   theme a selected preset's border and foreground; the selected background token controls only its
   background.
+- `--lr-date-picker-preset-hover-border-color` (default `var(--lr-color-brand)`),
+  `--lr-date-picker-preset-pressed-border-color` (default an active-state mix of
+  `var(--lr-color-brand)`) and `--lr-date-picker-preset-selected-border-color` (default
+  `var(--lr-color-brand)`; wins over `--lr-date-picker-preset-selected-border`) — the border color of
+  a hovered, pressed and selected quick-range button.
 - `--lr-date-picker-title-hover-color`, `--lr-date-picker-title-active-color`,
   `--lr-date-picker-title-active-bg`, and `--lr-date-picker-title-active-radius` — Month-title
   hover/press paint and pressed shape; defaults to brand, brand, brand-quiet, and

package/llms/components/lr-details.md

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

package/llms/components/lr-dialog.md

@@ -37,11 +37,9 @@ read, and neither is deprecated.
 
 **Properties:**
 
-- `open: boolean = false` (reflected) — **changed in 8.0.0:** `lr-dialog` now also has a
-  `show()`/`hide()` pair, and assigning `open` runs exactly the same lifecycle as calling them, so
+- `open: boolean = false` (reflected) — assigning `open` runs exactly the same lifecycle as calling `show()`/`hide()`, so
   the property, the reflected attribute and the two methods can never disagree. `el.open = false`
-  therefore emits the full close lifecycle and can be vetoed, where it used to be a silent state
-  flip. Markup that renders open from the start (`<lr-dialog open>`) emits nothing.
+  therefore emits the full close lifecycle and can be vetoed. Markup that renders open from the start (`<lr-dialog open>`) emits nothing.
 - `label: string = ''` — mapped visible title. The richer `label` slot wins over it.
 - `headingLevel: LyraHeadingLevel = '3'` (attribute `heading-level`, reflected) — `1`–`6` expose
   the generated visible title (string property or rich `label` slot) at that semantic level;
@@ -53,7 +51,7 @@ read, and neither is deprecated.
   localized close (X) button, which renders by default.
 - `noHeader: boolean = false` (attribute `no-header`, reflected) — Shoelace's spelling
   (`sl-dialog`'s `no-header`), which suppresses the entire header row
-- `withoutHeader: boolean = false` (attribute `without-header`, reflected) — **new in 8.0.0.**
+- `withoutHeader: boolean = false` (attribute `without-header`, reflected) —
   Web Awesome's spelling (`wa-dialog`'s `without-header`) for the same header suppression. Both
   names are current upstream spellings, both are read, and neither is deprecated or removable
 - `withFooter: boolean = false` (attribute `with-footer`, reflected) — keeps the footer wrapper
@@ -64,10 +62,7 @@ read, and neither is deprecated.
   (`l`/`large`), `48rem` (`xl`) — each value feeds `--lr-dialog-max-width`'s private default. An
   explicit `--lr-dialog-width`/`--lr-dialog-max-width` still wins over every tier.
 - `lightDismiss: boolean = false` (attribute `light-dismiss`) — opt in to a backdrop click closing
-  the dialog; Escape and explicit `close()`/`hide()` calls remain available. **Changed in 8.0.0:**
-  this was previously spelled `no-light-dismiss`, an opt-_out_ whose default left backdrop dismissal
-  on. The polarity now matches `wa-dialog` exactly, so a mechanical rename no longer flips what the
-  markup does.
+  the dialog; Escape and explicit `close()`/`hide()` calls remain available.
 - `modal: LyraDialogModalController` (writable, property only) — `activateExternal()` temporarily
   yields focus/Escape ownership to a third-party modal; balanced `deactivateExternal()` resumes it
   without changing `open`
@@ -122,13 +117,7 @@ The two `lr-after-*` events are never cancelable.
 The open sequence is `lr-show` → `lr-initial-focus` (when focus would move) → `lr-after-show`; the
 direct close sequence is `lr-hide` → `lr-close-request` → state change → `lr-close` → `lr-after-hide`.
 A built-in dismissal prepends `lr-request-close`. **Both state pre-events fire _before_ the state changes**, so reading
-`el.open` inside an `lr-show`/`lr-hide` handler returns the _old_ value — this is the polarity
-`wa-show`/`wa-hide` already had, and the opposite of what Lyra 7.x's own `lr-show`/`lr-hide` did on
-`lr-popover`/`lr-dropdown`. The `wa-*` → `lr-*` migration table treats the rename as mechanical, and
-as of 8.0.0 that is finally true for these four names: `wa-show`/`wa-after-show`/`wa-hide`/
-`wa-after-hide` map to `lr-show`/`lr-after-show`/`lr-hide`/`lr-after-hide` with matching timing and
-matching cancelability. Code written against Lyra 7.x that read `el.open` in a handler, or assumed
-the events were informational rather than vetoable, has to be re-read.
+`el.open` inside an `lr-show`/`lr-hide` handler returns the _old_ value.
 
 `lr-after-show`/`lr-after-hide` settle after the public registry animations `dialog.show` /
 `dialog.hide` (panel) and `dialog.overlay.show` / `dialog.overlay.hide` (backdrop). Per-element
@@ -160,7 +149,7 @@ rendered inside `[part="heading"]` and used as the panel's accessible name, winn
 plain-string `label` and legacy `heading` properties), `header-actions` (extra header controls,
 rendered in the header row _before_
 the built-in close button), `footer` (action buttons, rendered in a bottom row, hidden entirely when
-empty). The `label` and `header-actions` slots are new in 8.0.0.
+empty).
 
 **CSS parts:** `base`; `backdrop overlay`; `panel dialog`; `header`; `heading title label`;
 `header-actions`; `close-button close-button__base`; `close-button-control`; `body`; `footer`.
@@ -189,16 +178,6 @@ focusable control _inside_ the body, and the body itself is used only when there
 focus. So a dialog full of form controls behaves exactly as before, and a dialog full of text is now
 scrollable with the arrow keys, Page Up/Down and Home/End once Tab reaches it.
 
-**Migrating a pre-16.0.0 `::part()` rule.** This component's icon-only action is a composed
-`<lr-icon-button>`, so the part naming that action 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`).
-
 **Border reaches the composed close control the same way background/color/radius do.** This
 component paints no resting border of its own, so it relays no `--_lr-icon-button-border-default`
 into the close control's private fallback tier — but that absence is not a gap. The public
@@ -372,8 +351,7 @@ if (ok) deleteConversation();
 
 Resolves `true` only when the confirm button is pressed — Escape, a backdrop click, and the cancel
 button all resolve `false`. It sets `lightDismiss = true` on its transient dialog explicitly, so the
-backdrop-click branch survives 8.0.0's flip of that property's own default to `false`, and
-`withoutCloseButton = true`, so it renders no header close button. Mounts a
+backdrop-click branch works, and `withoutCloseButton = true`, so it renders no header close button. Mounts a
 transient `<lr-dialog>` on `document.body` for the duration
 of the call and removes it after its exit animation, rather than reusing a persistent page-level region
 (contrast `lr-toast`'s `toaster.ts`). It remains interactive above an already-open native modal through
@@ -381,8 +359,7 @@ of the call and removes it after its exit animation, rather than reusing a persi
 stack, each tied to its own returned promise. `title` becomes a direct light-DOM `<h2>`, which per `<lr-dialog>`'s
 own heading-detection also drives the dialog's accessible name; `description`, if provided, becomes
 a direct light-DOM `<p>`. `variant: 'danger'` fills the confirm button with `--lr-color-danger`
-instead of `--lr-color-brand`, for destructive actions. The deprecated `tone` option that preceded
-`variant` was removed in 10.0.0. Confirm/cancel actions deliberately use native
+instead of `--lr-color-brand`, for destructive actions. Confirm/cancel actions deliberately use native
 inline-styled `<button>` elements so this helper does not register or import the broader button
 component; every color value is still a `--lr-*` token reference, never a raw literal. They carry the same interaction
 states as every other control in the library: a hover/pressed fill mixed toward

package/llms/components/lr-diff-view.md

@@ -6,7 +6,7 @@
 - **Class** `LyraDiffView`, also available unregistered from `@aceshooting/lyra-ui/components/utility/diff-view/diff-view.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** `shiki` — see `llms/peers.md`
 - **Themeable via** 7 parts, 16 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-divider.md

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

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

@@ -6,7 +6,7 @@
 - **Class** `LyraDockPanel`, also available unregistered from `@aceshooting/lyra-ui/components/layout/dock-panel/dock-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)
 - **Deprecated event** `lr-collapse-change` since `26.0.0`; use event `@lr-toggle`; removal not before `28.0.0` — The shared toggle event carries the same expanded detail; the older name remains emitted during migration.
 - **Deprecated event** `lr-collapse-request` since `26.0.0`; use event `@lr-toggle-request`; removal not before `28.0.0` — The shared cancelable toggle request carries the same expanded proposal; the older name remains emitted during migration.
 - **Optional peers** none

package/llms/components/lr-document-library.md

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

package/llms/components/lr-drawer.md

@@ -28,9 +28,7 @@ the slide animation are its own.
 
 - `open: boolean = false` (attribute `open`, reflected) — assigning it runs the same lifecycle as
   `show()`/`hide()`, so the property, the reflected attribute and the two methods can never disagree
-- `placement: 'start'|'end'|'top'|'bottom' = 'end'` (attribute `placement`, reflected). **Changed in
-  8.0.0:** the default used to be `start`. `end` is what `wa-drawer` does, so a mechanical
-  `wa-drawer` → `lr-drawer` rename no longer silently slides the panel in from the other edge.
+- `placement: 'start'|'end'|'top'|'bottom' = 'end'` (attribute `placement`, reflected).
 - `contained: boolean = false` (attribute `contained`, reflected) — position within the nearest
   containing block without a backdrop, page inerting, focus trap, scroll lock, top-layer
   promotion, or global Escape ownership
@@ -85,16 +83,6 @@ controls, rendered before the built-in close button), `footer` — all inherited
 Names grouped together are aliases on the same functional node; `close-button-control` is the
 composed `<lr-icon-button>`'s own native `<button>`, inherited from `lr-dialog` as of 16.0.0.
 
-**Migrating a pre-16.0.0 `::part()` rule.** This component's icon-only action is a composed
-`<lr-icon-button>`, so the part naming that action 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`).
-
 **Themeable custom properties:** mapped `--size` controls the active axis. For start/end drawers,
 the inherited `--width` and `--lr-dialog-width` remain compatibility fallbacks when neither
 `--size` nor `--lr-drawer-width` is set, and `--lr-dialog-max-width` remains an effective cap,

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

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

package/llms/components/lr-drop-zone.md

@@ -47,6 +47,10 @@ reimplemented.
   `heldFileCount`/`heldTotalSize`: `0` (the default) means "nothing held" and reproduces prior
   behavior exactly, and a negative, `NaN`, or `Infinity` override is normalized to `0` via
   `finiteCount` rather than corrupting every later comparison.
+- `allowedMimeTypes` / `forbiddenMimeTypes: readonly string[] = []` (property only) — exact MIME
+  allow/deny lists, identical to `lr-file-input`'s (denylist first); a mismatch rejects with `'type'`.
+- `acceptedMessage` / `rejectedMessage: string` (attributes `accepted-message` / `rejected-message`) —
+  caller-owned outcome copy with `{count}`; unset uses the localized default.
 - `readonly dragging: boolean` — `true` during an active drag session
 - `size: LyraSize = 'm'` (reflected) — density tier for the overlay's padding, icon and
   instructional text; identical contract and scale to `lr-file-input`'s own `size`, so a drop-zone

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

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

package/llms/components/lr-ebook-viewer.md

@@ -75,9 +75,7 @@ non-live shadow content and later loading transitions use the shared document-le
 assertive sink), plus `anchor-live-region` (an aria-hidden, non-live shadow mirror of the latest
 anchor-jump message; the spoken copy is appended to the shared document-level polite sink only
 while the viewer and its composed ancestors are exposed to the accessibility tree). Search results
-are appended to the shared document-level polite sink, which lives in the host's light DOM; the
-empty `announcer` shadow mirror that used to carry a part of that name was removed in 9.0.0 (it had
-no styling of its own and never held any text).
+are appended to the shared document-level polite sink, which lives in the host's light DOM.
 
 **Themeable custom properties:** `--lr-ebook-viewer-max-height` (default `none`) — maximum block
 size of `[part="mount"]` before it scrolls internally; also settable via the `max-height` property,
@@ -87,6 +85,9 @@ The toolbar buttons use the component-specific localized labels `ebookViewerPrev
 `ebookViewerNextChapter` (English: “Previous chapter” / “Next chapter”), so they remain
 unambiguous beside other previous/next controls and are overridable through `.strings`.
 
+**Reparenting:** a synchronous same-task reparent (`append()` of the connected element) reloads the book,
+because it destroys the chapter iframes epub.js renders into; use `moveBefore()` to keep the book and its position.
+
 **Optional peer dependency:** install `epubjs` with `pnpm add epubjs`. The document-viewer registry
 matches `application/epub+zip` and `.epub` filenames, declaring `{ anchors: ['cfi', 'text-quote'],
 search: true, textSelect: true }` capabilities and forwarding `anchor`/`highlights` to the mounted

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

@@ -6,7 +6,7 @@
 - **Class** `LyraEmojiPicker`, also available unregistered from `@aceshooting/lyra-ui/components/forms/emoji-picker/emoji-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** `emoji-picker-element-data` — see `llms/peers.md`
 - **Themeable via** 18 parts, 28 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-entity-chip.md

@@ -50,13 +50,13 @@ floating popover on hover or keyboard focus (the focused control matches `:focus
 text/accent color), `--lr-entity-chip-bg` (default `var(--lr-color-brand-quiet)`),
 `--lr-entity-chip-border` (default `transparent`, the chip's `--lr-border-width-thin` outline).
 
-The anchored detail popover is a floating surface and paints from the **shared overlay-surface family** (16.0.0):
+The anchored detail popover 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 preview popover reads this same cascading
+`--lr-positioning-strategy` — the preview popover 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-entity-chip>`; set the custom property on `:root`, a theme, or one clipping

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

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