@aceshooting/lyra-ui 14.0.0 → 14.1.0

package/llms/components/lr-timeline.md

@@ -26,6 +26,12 @@ item's `title`/`description` routinely hold focusable content, so wrapping the r
 would trip `nested-interactive`). The opt-in clustered time scale adds only native count-marker
 buttons; it does not make the individual rows interactive.
 
+Horizontal time layouts using `collision="overlap"` or `collision="stack"` allocate their block size
+from the actual item content and lane offsets. The height follows content growth, shrinkage, and
+changes in lane count. `--lr-timeline-time-extent` still controls only the main-axis distance, and
+horizontal scrolling retains clipping on the cross axis. Cluster mode keeps its existing sizing
+behavior.
+
 **`lr-timeline` properties:** `orientation: 'vertical' | 'horizontal' = 'vertical'` — note the
 opposite default from `lr-stepper`; `horizontal` makes `[part='base']` a horizontally scrollable row.
 `accessibleLabel?: string` (attribute `aria-label`) overrides the localized `"Timeline"` name —

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

@@ -21,6 +21,20 @@ prevented, so focus still advances normally. Backspace removes the last token. `
 readonly owned `readonly string[]` snapshot and repeated values are submitted under `name`; mutate
 a new array and reassign it to change the list.
 
+Composing keyboard events (`isComposing` or legacy key code 229) remain with the native draft or
+inline editor without adding/removing tokens, committing an edit or closing the editor. Normal
+Enter, delimiter, Tab, Backspace and Escape behavior is unchanged after composition.
+
+Host `aria-describedby` references resolve in the host's root and precede local hint/error guidance
+on the native draft input. Live source replacement, removal, reinsertion, host reconnection and
+document adoption update the relationship. Removing `label`, `hint` or `error-text` safely removes
+that copy while preserving native attribute-removal property readback, including `null`; explicit
+empty and later replacement strings remain supported.
+
+Editable token labels vertically center their text within the existing pointer target while
+retaining narrow-content ellipsis, wrapping and alignment with the remove action. The ordinary
+noneditable token layout remains the default.
+
 **Properties:** live, non-reflecting `value`, reflected `defaultValue` (attribute `value`, encoded
 as a JSON string array), `customError` (`custom-error`), `label`, `hint`, `errorText`
 (`error-text`), `placeholder`, `name`,

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

@@ -23,6 +23,9 @@ focused) fires `lr-tool-call-chip-select`; a consumer wires that to opening a
 `<lr-tool-result-dialog>` (or anything else) at the call site, keeping the chip reusable wherever
 a compact call summary is useful, with or without a detail surface behind it.
 
+Removing `category` or `summary` hides that optional text; assigning either attribute again restores
+its content.
+
 **Properties:**
 
 - `name: string = ''` — the tool/function name, e.g. `web_search`
@@ -109,9 +112,8 @@ sub-1000ms `"820ms"`, else trimmed to at most one decimal of seconds (`"1.5s"`,
 
 **Known gotchas:**
 
-- the default slot is checked for emptiness by scanning `Array.from(this.children)` for elements
-  once on first update, then kept in sync via `slotchange` — only _element_ children count (a bare
-  text node assigned to the default slot won't trigger the tooltip)
+- meaningful default-slot text or element content enables the preview tooltip; whitespace-only
+  text does not. A text preview needs no wrapper, and the preview remains inert and noninteractive
 - the native button always keeps its purpose-specific generated name (`"name — summary — Status —
 duration"`). A host `aria-label` remains on the host and is not cloned onto that button; even an
   explicit empty host label never leaves the actionable button unnamed

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

@@ -24,6 +24,10 @@ can name the form-associated host. A non-empty host `aria-label` remains on the
 aggregate semantic owner, so `base` omits its duplicate role/name. The individual generated fields
 keep their own purpose-specific names in every case.
 
+Choosing Boolean Unset keeps an explicit `undefined` value when a schema default exists; deleting
+that key or replacing the value with an absent key restores default materialization. Without a
+schema default, Unset removes the key.
+
 **Supported schema subset:** a _flat_ object whose properties use one primitive `type`
 (`'string'`, `'number'`, `'integer'`, or `'boolean'`), `required` property presence, string `enum`,
 primitive `const`, and the `title`/`description`/`default` annotations. Nested objects, arrays, type

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

@@ -24,6 +24,10 @@ so slot-forwarding does not put a forwarding `<slot>` where a slotted `<lr-tab-g
 child scan expects real projected content, while its modal behavior participates in the shared
 overlay stack.
 
+Assigning `accessibleLabel` directly names the inner dialog when no host `aria-label` is present. A
+host `aria-label` retains its separate host ownership, and an empty direct value uses the tool
+title.
+
 **Properties:**
 
 - `open: boolean = false` (reflected) — whether the dialog is open; set it directly or use the

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

@@ -21,6 +21,10 @@ available in a conversation. It keeps its own panel template rather than nesting
 it has no dependency on the general-purpose dialog, while its modal behavior participates in the
 shared overlay stack. First-party invention (no Web Awesome equivalent).
 
+Programmatic `selectedToolIds` and `useDefaults` replacements synchronize the live checkbox and
+switch state after user edits without emitting change events. Removing `search-placeholder` restores
+localized copy, while an explicitly empty placeholder stays empty.
+
 **Exported types:**
 
 - `ToolSelectDialogTool { id: string; name: string; description?: string; category?: string; icon?:

package/llms/components/lr-tooltip.md

@@ -19,6 +19,12 @@
 A tooltip for a consumer-owned trigger, positioned with the shared Floating UI positioner. Which
 interactions open it is configurable as of 8.0.0; by default it is still hover and focus.
 
+An open lr-tooltip repositions when its effective host or inherited text direction changes,
+preserving open state without emitting lifecycle events.
+
+Removing `content` safely omits tooltip fallback text while preserving `null` property readback;
+later text renders normally.
+
 **Properties:**
 
 - `open: boolean = false` (reflected) — assigning it runs the same lifecycle as `show()`/`hide()`.

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

@@ -20,6 +20,9 @@ A collapsible span hierarchy for one agent/LLM trace (Langfuse/LangSmith run-tre
 name, status, an inline duration bar on the shared trace time scale, and optional tokens/cost
 columns. Consumes the same `LyraSpan[]` as `<lr-span-waterfall>`.
 
+Span views omit whitespace-only IDs and preserve every nonblank business ID exactly, including
+surrounding whitespace. The first valid admitted duplicate continues to win.
+
 **Properties:** `spans: LyraSpan[] = []` (attribute: false) — the same `LyraSpan` shape documented
 under `lr-span-waterfall` above (exported from `trace-tree/span.ts`); hierarchy comes from
 `parentId`, and a span whose `parentId` is missing or doesn't resolve within the same array renders

package/llms/components/lr-transcript-feed.md

@@ -21,6 +21,9 @@ with in-place upgrades keyed by `id`, and a stick-to-bottom auto-scroll with rel
 `follow`/`lr-follow-change` contract `<lr-terminal>` uses. Live captions only — recorded-media
 transcript sync is a separate concern.
 
+Activating the focused jump action resumes follow and transfers focus to the scroll base when the
+action disappears, unless a newer outside focus move takes precedence.
+
 **Properties:** `entries: LyraTranscriptEntry[] = []` (attribute: false) — `LyraTranscriptEntry { id:
 string; speaker?: string; text: string; interim?: boolean; timestamp?: LyraTimestamp }` (exported by
 this module; `LyraTimestamp = Date | string | number`, normalized through Date/TimeClip). Reconciled

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

@@ -20,6 +20,11 @@
 An expand/collapse hierarchy (document/graph navigation tree). Mirrors `wa-tree`/`wa-tree-item` and
 `sl-tree`/`sl-tree-item`.
 
+An otherwise unnamed data row receives its stable `id` as a semantic name. Usable `accessibleLabel`,
+visible label, description, badge content and explicit host naming retain precedence; the fallback
+changes neither visible content nor installed data. Blank visible labels remain supported.
+Declarative items receive no automatic ID fallback.
+
 **Renamed in 8.0.0 — breaking:** the child element is `<lr-tree-item>` (class `LyraTreeItem`), not
 `<lr-tree-node>`/`LyraTreeNode`. It was the only child element in the library whose tag diverged
 from both upstreams, so `wa-tree-item`/`sl-tree-item` markup had nothing to rename to. The shared
@@ -72,9 +77,10 @@ deeply-nested node's own shadow root still reaches it).
 - `data: readonly LyraTreeNodeData[] = []` (attribute: false) — the object child model; ignored
   while any author-written `<lr-tree-item>` child is present. Assignment installs a detached,
   recursively frozen snapshot: mutate caller data only before assignment, then reassign after
-  changes. Normalization accepts at most 1,000 valid nodes and 64 descendant levels, never invokes
-  caller accessors, and exposes `dataTruncated = true` when malformed or over-budget input was
-  omitted. Collapsed branches do not instantiate descendants; disclosure projects only normalized
+  changes. Normalization accepts at most 1,000 valid nodes and 64 descendant levels, and lazily
+  inspects at most 10,000 root/child array positions globally in depth-first order. It never
+  invokes caller accessors and exposes `dataTruncated = true` when malformed or over-budget input
+  was omitted or the inspected-position ceiling was reached. Collapsed branches do not instantiate descendants; disclosure projects only normalized
   children while `aria-setsize` preserves the declared sibling count. `LyraTreeNodeData` is
   `{ readonly id: string; readonly label: string; readonly children?: readonly LyraTreeNodeData[];
 readonly selected?: boolean; readonly disabled?: boolean; readonly lazy?: boolean; readonly
@@ -88,7 +94,7 @@ LyraVariant; readonly label?: string }`. `badges` renders tone-mapped chips in o
   author-supplied host `aria-label` takes precedence by presence and is never overwritten or
   removed by later object refreshes; removing the author attribute restores the current data name.
   `id` is the event, roving-focus, reconciliation, and reorder identity and must be unique across
-  the complete reachable hierarchy; malformed/blank rows and later duplicates are omitted as described above
+  the complete reachable hierarchy; malformed rows, blank IDs and later duplicates are omitted as described above
 - `selection: 'single'|'multiple'|'leaf'|'leaf-multiple' = 'single'` — self-managed selection for
   both child models. `single` selects one item; `leaf` selects one loaded leaf; `multiple` displays
   checkboxes and cascades through enabled descendants; `leaf-multiple` applies that cascade only
@@ -213,7 +219,8 @@ when assigned):
 - `isDisabled: boolean` — `item.disabled` in the data model, the `disabled` property in the
   declarative one
 - `nodeLabel: string` — this item's spoken name, used for the tree's reorder announcements: a host
-  `aria-label` is authoritative in both models; otherwise `item.accessibleLabel || item.label` in
+  `aria-label` is authoritative in both models
+  (including the component-owned stable-ID fallback for otherwise unnamed data rows); otherwise `item.accessibleLabel || item.label` in
   the data model, or flattened accessibility-visible slotted label text (nested items excluded)
   followed by the `label` fallback in the declarative one. Direct and forwarding-slot
   text/ARIA/visibility mutations update the name

package/llms/components/lr-tree.md

@@ -20,6 +20,11 @@
 An expand/collapse hierarchy (document/graph navigation tree). Mirrors `wa-tree`/`wa-tree-item` and
 `sl-tree`/`sl-tree-item`.
 
+An otherwise unnamed data row receives its stable `id` as a semantic name. Usable `accessibleLabel`,
+visible label, description, badge content and explicit host naming retain precedence; the fallback
+changes neither visible content nor installed data. Blank visible labels remain supported.
+Declarative items receive no automatic ID fallback.
+
 **Renamed in 8.0.0 — breaking:** the child element is `<lr-tree-item>` (class `LyraTreeItem`), not
 `<lr-tree-node>`/`LyraTreeNode`. It was the only child element in the library whose tag diverged
 from both upstreams, so `wa-tree-item`/`sl-tree-item` markup had nothing to rename to. The shared
@@ -72,9 +77,10 @@ deeply-nested node's own shadow root still reaches it).
 - `data: readonly LyraTreeNodeData[] = []` (attribute: false) — the object child model; ignored
   while any author-written `<lr-tree-item>` child is present. Assignment installs a detached,
   recursively frozen snapshot: mutate caller data only before assignment, then reassign after
-  changes. Normalization accepts at most 1,000 valid nodes and 64 descendant levels, never invokes
-  caller accessors, and exposes `dataTruncated = true` when malformed or over-budget input was
-  omitted. Collapsed branches do not instantiate descendants; disclosure projects only normalized
+  changes. Normalization accepts at most 1,000 valid nodes and 64 descendant levels, and lazily
+  inspects at most 10,000 root/child array positions globally in depth-first order. It never
+  invokes caller accessors and exposes `dataTruncated = true` when malformed or over-budget input
+  was omitted or the inspected-position ceiling was reached. Collapsed branches do not instantiate descendants; disclosure projects only normalized
   children while `aria-setsize` preserves the declared sibling count. `LyraTreeNodeData` is
   `{ readonly id: string; readonly label: string; readonly children?: readonly LyraTreeNodeData[];
 readonly selected?: boolean; readonly disabled?: boolean; readonly lazy?: boolean; readonly
@@ -88,7 +94,7 @@ LyraVariant; readonly label?: string }`. `badges` renders tone-mapped chips in o
   author-supplied host `aria-label` takes precedence by presence and is never overwritten or
   removed by later object refreshes; removing the author attribute restores the current data name.
   `id` is the event, roving-focus, reconciliation, and reorder identity and must be unique across
-  the complete reachable hierarchy; malformed/blank rows and later duplicates are omitted as described above
+  the complete reachable hierarchy; malformed rows, blank IDs and later duplicates are omitted as described above
 - `selection: 'single'|'multiple'|'leaf'|'leaf-multiple' = 'single'` — self-managed selection for
   both child models. `single` selects one item; `leaf` selects one loaded leaf; `multiple` displays
   checkboxes and cascades through enabled descendants; `leaf-multiple` applies that cascade only
@@ -213,7 +219,8 @@ when assigned):
 - `isDisabled: boolean` — `item.disabled` in the data model, the `disabled` property in the
   declarative one
 - `nodeLabel: string` — this item's spoken name, used for the tree's reorder announcements: a host
-  `aria-label` is authoritative in both models; otherwise `item.accessibleLabel || item.label` in
+  `aria-label` is authoritative in both models
+  (including the component-owned stable-ID fallback for otherwise unnamed data rows); otherwise `item.accessibleLabel || item.label` in
   the data model, or flattened accessibility-visible slotted label text (nested items excluded)
   followed by the `label` fallback in the declarative one. Direct and forwarding-slot
   text/ARIA/visibility mutations update the name

package/llms/components/lr-typing-indicator.md

@@ -25,6 +25,9 @@ classic "typing…" affordance for a standalone status line), `pulse` (a single
 quieter cue for a tight space, e.g. next to an avatar), `cursor` (a blinking vertical bar, meant to
 sit inline at the tail end of streamed text still being appended to).
 
+Removing `label` restores the localized thinking name while preserving an explicit host
+`aria-label`. Later label assignments remain reactive.
+
 **Properties:**
 
 - `shape: TypingIndicatorShape = 'dots'` (`'dots' | 'pulse' | 'cursor'`, reflected)

package/llms/components/lr-usage-badge.md

@@ -23,6 +23,10 @@ The tooltip reuses `lr-tool-call-chip`'s hover/focus/Escape/`aria-describedby` c
 Not `lr-context-meter` (occupancy of a fixed capacity); not `lr-generation-metrics` (live, with a
 Stop button) — this is static after the fact.
 
+Removing `cost-text` or `summary` safely omits that content; explicit empty values remain empty and
+later values restore it. An open tooltip participates in shared Escape ordering even while only
+hovered, and dismissal preserves focus elsewhere.
+
 **Properties:** `tokensIn?: number` (attribute `tokens-in`) — input tokens, normalized to a
 non-negative integer, locale-formatted; segment omitted while unset/non-finite. `tokensOut?: number`
 (attribute `tokens-out`) — same rules. `costText: string = ''` (attribute `cost-text`) —

package/llms/components/lr-video.md

@@ -21,6 +21,10 @@ selectable captions, and bounded WebVTT thumbnail previews. It mirrors the publi
 API under the `lr-` prefix. Import the granular registration entry with
 `import '@aceshooting/lyra-ui/components/media/video/video.js'`.
 
+When progress is unavailable, the disabled native range input and its visible timeline track retain
+resting paint under hover and press. Once media duration makes progress available, the track retains
+its token-driven hover and press feedback.
+
 **Properties:** `autoplay: boolean = false`, `autoplayMuted: boolean = false` (attribute
 `autoplay-muted`), `autoplayOnVisible: boolean = false` (attribute `autoplay-on-visible`),
 `controls: 'none' | 'standard' | 'full' = 'standard'`, `currentTime: number = 0` (attribute
@@ -107,8 +111,10 @@ kept for mechanical Web Awesome migration. Lyra also supplies
 Caption and playback-rate selectors remain native `<select>` controls with decorative, pointer-inert
 chevrons; their option foreground and background inherit `--controls-color` and
 `--controls-background`. Controls, elapsed/title text, caption text, and selectors consistently use
-the semantic strong-overlay foreground. The fallback remains legible in light and dark themes;
-an explicit `--controls-color` still has final precedence, and forced-colors mode remains UA-owned.
+the semantic strong-overlay foreground. The fallback remains legible in light and dark themes.
+The poster play button and its glyph instead default to `--lr-color-text` against their
+`--lr-color-surface-overlay` surface. An explicit `--controls-color` retains final precedence on
+both poster and overlay controls, and forced-colors mode remains UA-owned.
 
 **RTL behavior:** surrounding controls follow the inherited direction, while the elapsed-media axis
 stays physical left-to-right. Native ArrowRight advances and ArrowLeft rewinds the timeline in both

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

@@ -134,7 +134,9 @@ the `lr-virtual-scroll` detail shape.
 `groupByRecency(items, options?)` is a DOM-free helper that returns non-empty
 Today/Yesterday/Previous 7 Days/Older buckets, preserves input order within each bucket, and accepts
 a timestamp extractor, reference date, and label overrides. Import it from its granular subpath —
-the package root re-exports it too, but that entry pulls in the eager registration barrel:
+the package root also re-exports it without registering custom elements, while the granular
+route limits the named-export module graph. `@aceshooting/lyra-ui/all.js` is the separate eager
+registration entry:
 
 ```ts
 import { groupByRecency } from "@aceshooting/lyra-ui/utilities/group-by-recency.js";
@@ -303,11 +305,11 @@ default estimate with sparse `ResizeObserver` measurements for rows that have ac
   Each row carries `will-change: transform` (a compositor hint for the per-frame translate), which
   makes every row its own stacking context. Rows otherwise carry no `z-index`, so they paint in DOM
   order and each one paints over the previous. Anything a row renders that overflows its own box —
-  an `<lr-menu>` popup in a row-action menu, a tooltip, an outward focus ring — is therefore painted
+  an `<lr-dropdown>` popup containing a row-action menu, a tooltip, an outward focus ring — is therefore painted
   _underneath_ every following row, no matter how high its own `z-index` is: that `z-index` only
   orders siblings inside the row's own context. The last row always looks correct, which is exactly
   why the failure tends to hide in short lists. A row lifts to `--lr-layer-content` while something
-  inside it holds focus or while it contains an open `lr-menu`. The explicit menu-open branch covers
+  inside it holds focus or while it contains an open `lr-dropdown`. The explicit dropdown-open branch covers
   imperative opening and virtual measurement/render cycles, where focus can temporarily return to
   the document while the popup remains visible. The value deliberately _matches_
   `[part='group']`'s rather than exceeding it, so the two land on the same layer and DOM order

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

@@ -32,6 +32,14 @@ control changes target; closing or filtering also retires a row-owned preview on
 control represents it. Does not synthesize speech, fetch catalogs, or persist selection; not a
 persona picker; `lr-model-select` stays for LLMs.
 
+Removing `label`, `hint`, or `error-text` clears that optional copy in both catalog and free-text
+modes. Removed string properties retain `null` readback, and later assignments restore their
+content.
+
+Composing key events (`isComposing` or legacy `keyCode === 229`) remain with the catalog query or
+custom-value editor: they do not navigate options, commit a selection or custom value, or close the
+popup. Ordinary keyboard behavior resumes after composition.
+
 **Exported types:** `LyraVoiceCatalogEntry extends LyraCatalogEntry { language?: string;
 description?: string; previewUrl?: string }` — `language`/`description` render as a quiet
 `[part="option-meta"]` second line. Voice catalogs use the shared

package/llms/components/lr-widget-renderer.md

@@ -30,6 +30,15 @@ navigates (no `href` props are allowlisted anywhere). Controlled state binding i
 narrow: a versioned document may bind an allowlisted primitive prop to a JSON Pointer, and the host
 must apply every requested change itself.
 
+Default authoring diagnostics are silent outside Lit's development mode. An explicit expert
+`ResolveContext.warn` callback remains active in every runtime; warning keys and the suppression cap
+remain scoped to the current context generation. Runtime `lr-render-error` reporting is independent
+of this development diagnostic policy.
+
+`createWidgetDocument` validates authored trees immediately. To handle a received, untrusted
+document, pass its envelope to the renderer's `document` boundary; malformed envelopes clear prior
+output and emit `lr-render-error`. The malformed-stream example exercises this boundary.
+
 **Exported types:**
 
 - `LyraWidgetNode { readonly type: string; readonly id?: string; readonly props?:

package/llms/components/lr-widget.md

@@ -23,8 +23,10 @@ position) survives the transition.
 
 **Properties:**
 
-- `label: string = ''`
-- `sublabel: string = ''`
+- `label: string = ''` — header title; a removed attribute renders as absent while preserving
+  `null` readback. Supplied empty strings remain empty and later values recover normally.
+- `sublabel: string = ''` — secondary header copy with the same removal, empty-string and recovery
+  behavior.
 - `collapsible: boolean = false` (reflected — shows the collapse/expand chevron button)
 - `collapsed: boolean = false` (reflected)
 - `expandable: boolean = false` (reflected — shows the fullscreen toggle button)

package/llms/components/lr-word-cloud.md

@@ -34,6 +34,10 @@ and repeated edge movements append repeated announcements even when their text i
 no live-region role of its own. Pointer input resolves the nearest word from the adequately-sized
 SVG surface; the potentially tiny text glyphs are not independent hit targets.
 
+Pinned opposite-sign finite endpoints such as `[-1e308, 1e308]` produce bounded finite scale
+fractions and SVG geometry, including with reversed endpoints or square-root scaling. Word weights
+remain nonnegative; placement budgets, font-size limits, and the omitted-word policy are unchanged.
+
 **Properties:**
 
 - `words: readonly WordCloudWord[] = []` (attribute: false) — readonly `{ text: string, weight:

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

@@ -25,6 +25,10 @@ matching. Every document type declaration is rejected before `DOMParser`, preven
 entity access and browser-specific internal-entity expansion. Not `lr-json-viewer` (JS values); not `lr-html-viewer`
 (sanitized _rendered_ HTML). No XPath/XSLT evaluation, no editing, no schema validation.
 
+The registration entry also matches extensionless `application/*+xml` MIME essences, ignoring
+parameters, case and outer whitespace. Exact registered MIME keys retain precedence over this
+fallback matcher.
+
 **Properties:** `src: string = ''` — URL to fetch and parse; ignored once `xml` is set. `xml?:
 string` (property only) — raw XML text to parse and render; wins over `src`, and setting it parses
 synchronously. Assigning `undefined` relinquishes inline authority and immediately resumes an
@@ -43,8 +47,11 @@ attribute. Invalid CSS `max-height` values, declaration breaks, and `url()` are
 every element's tag name, attribute names/values, and own text (empty/whitespace query behaves like
 `clearSearch()`), accepting at most 4,096 query code units and scanning at most 4,000,000 code
 units while retaining 10,000 matches; `searchNext()`/`searchPrevious()` advance/step back through matches (wrapping);
-`clearSearch()` clears the query and matches. All three resolve only after the newly active match's
-row has been scrolled into view (`block: 'center'`, `behavior: 'auto'` under
+`clearSearch()` clears the query and matches. Imperative `search()`, `searchNext()` and
+`searchPrevious()` reopen the selected match and its ancestors, including manually collapsed
+nodes, before scrolling. Other explicit collapse choices remain in effect, and later manual
+collapse still takes precedence over default expansion. All three resolve only after the newly
+active match's row has been scrolled into view (`block: 'center'`, `behavior: 'auto'` under
 `prefers-reduced-motion`) — before 9.0.0 they moved `data-active-match` without ever scrolling, so
 on a document taller than the viewport the reader never saw the match they had stepped to. Replacing
 the XML source clears document-relative matches and emits the canonical empty `lr-search-change`;

package/llms/components/lr-zoomable-frame.md

@@ -20,6 +20,9 @@ Sandboxed iframe preview that mirrors Web Awesome's zoomable-frame contract. It
 `<iframe>` through discrete controls without changing the document's own viewport, and fills its
 allocated inline size with a 16:9 aspect ratio by default (override `aspect-ratio` on the host).
 
+Focus on either zoom control does not enter the iframe browsing context, and `blur()` does not blur
+a focused zoom control.
+
 **Properties:**
 
 - `src: string = ''` — iframe URL. Relative, `http:`, `https:`, `blob:`, and exact `about:blank`
@@ -45,7 +48,7 @@ allocated inline size with a 16:9 aspect ratio by default (override `aspect-rati
   and carries no unsupported `aria-disabled` claim.
 - `accessibleLabel: string | null` (attribute `aria-label`) — a declarative attribute remains on
   the host while the iframe gets its localized purpose title, avoiding a duplicate name on two
-  semantic owners. A property-only value names the iframe. Explicit empty host naming is preserved
+  semantic owners. A property-only value names the iframe and updates reactively without creating a host attribute. Explicit empty host naming is preserved
   as an empty iframe title rather than replaced through truthiness.
 - readonly `iframe?: HTMLIFrameElement`, `contentWindow: Window | null`, and
   `contentDocument: Document | null`. Both content accessors return `null` while detached;
@@ -73,7 +76,7 @@ rather than a second interactive control; the native zoom buttons remain the sol
 actions.
 
 **Events:** internal `focus`/`blur` from the iframe are relayed exactly once as owner-realm native
-`FocusEvent`s (bubbling and composed, preserving `relatedTarget`);
+`FocusEvent`s (bubbling and composed, preserving external `relatedTarget`; a transition to or from an internal zoom control uses `null` because retargeting that control to the host would suppress the relay);
 native `load` and `error` are relayed exactly once from the current iframe
 generation as non-bubbling, non-composed `Event` instances. Navigation/source-policy changes
 replace the iframe, so a late event from an earlier document is ignored; detached frames do not
@@ -82,7 +85,7 @@ notify.
 **CSS parts:** `iframe`, `controls`, `zoom-in-button`, and `zoom-out-button`. Real focus entry into
 the browsing context (Tab, pointer, or `focus()`) exposes `data-frame-focused` on the host and paints
 the shared focus ring around the iframe boundary; blur, navigation rekey, disablement, and removal
-clear it.
+clear it. Moving between the iframe and a zoom control clears or restores the marker and emits one matching native blur or focus relay; focusing a zoom control alone leaves the marker absent.
 
 **CSS custom properties:** read-only `--lr-zoomable-frame-zoom`, resolved from the `zoom`
 property and applied to the internal iframe scale; and `--lr-zoomable-frame-control-hover-background`