@aceshooting/lyra-ui 29.0.2 → 29.1.0

package/llms/components/lr-mind-map.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** none
-- **Themeable via** 9 parts, 2 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 17 parts, 2 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`
 
 ---
@@ -22,19 +22,92 @@ no force simulation, no communities, no edge labels (that's `lr-graph`). Zero-de
 radial layout is closed-form arithmetic, in its own `mind-map-layout.ts` module, mirroring
 `lr-word-cloud`'s dependency-free precedent.
 
+**Complete source topics:** `treeSource: MindMapSource | undefined`
+(attribute: false) takes precedence over `topics`. Invalid defined sources fail visibly without
+legacy fallback; only `undefined` restores the current legacy topics and their expansion state.
+
+```ts
+import "@aceshooting/lyra-ui/components/lr-mind-map.js";
+import type { MindMapSource, LyraTopic } from
+  "@aceshooting/lyra-ui/components/retrieval/mind-map/mind-map.class.js";
+import type { LyraHierarchySource, LyraHierarchyQuery, LyraHierarchyRow } from
+  "@aceshooting/lyra-ui/data-sources.js";
+```
+
+`MindMapSource = LyraHierarchySource<LyraTopic, LyraHierarchyQuery>`; its exact shared protocols
+are in [shared source contracts](../shared/events-and-types.md). The provider implements
+`project({ revision, locale, signal, query, state, action })`, with fixed query
+`{ search: '', hiddenKinds: [] }`. Revision is a nonempty string or finite number. A projection
+supplies a nonempty immutable `state` token of at most 65,536 UTF-16 units, global logical `total`,
+a complete visible-preorder `rows` view and optional `focusIndex`. `rows.count <= total`, and the view is either indexed
+`count`/`itemAt`/`keyAt`/`indexOfKey`, or ranged `count`/`read`/`indexOfKey` with exact in-bounds
+reads and direct key resolution. Provider preorder, parent keys, one-based `level`, `position`
+and `setSize`, `childCount`, `expanded`, `selected`, optional `disabled` and `selectionState`
+remain authoritative. This route never reads nested `value.children`, seeds expansion from
+`expandDepth`, or applies local expansion overrides.
+
+The semantic tree navigator reaches the complete provider-visible preorder, with global
+Home/End, Up/Down, RTL-aware expansion/parent keys and disabled-row handling.
+`revealSourceKey(key: string): Promise<boolean>` asks the provider to reveal any logical key and
+focuses its returned `focusIndex`; false means unset/invalid/absent/disabled, failed focus
+transfer or superseded work. Reveal, refresh and reconnect emit no topic event.
+
+The SVG is a bounded view of one connected represented subtree drawn from ready mounted
+navigator rows, at most 301. Its local root is the first represented row whose parent is absent
+from that mounted set. Only exact represented parent links join the subtree; omitted ancestors
+and other disconnected branches are not fabricated. The local root need not be the global root.
+The navigator keeps full global depth/sibling metadata even when ancestry lies outside the cache.
+The diagram uses provider child counts and expansion flags, so a clipped parent is still a parent.
+A localized `limit` notice reports diagram nodes shown versus the complete visible-preorder
+count, rather than implying the SVG contains the full source. `source-diagram` has a bounded
+`var(--lr-size-20rem)` block size; the global navigator remains available with that view.
+No full-source layout or second provider collection is built.
+
+Only own data fields `id` and `label` are projected; `id` must be nonblank and equal `row.key`,
+nonstring labels normalize to empty text, and accessor-backed/oversized fields fail visibly.
+Each normalized row's key, parent key, id and label share a 65,536 UTF-16-unit budget; retained
+rows, focused reserve and pending admission share a 2,000,000-unit payload ceiling. Four 100-row
+pages retain at most 400 rows plus one focused row; at most 301 navigator rows mount and at most
+two physical range reads run. Projection work permits one physical call plus only the latest
+queued intent. Ignored aborts keep physical permits until settlement; providers should settle
+promptly after cancellation. Diagram rows reference only current normalized mounted rows and
+bounded geometry; provider storage/index construction remains caller-owned.
+
+Accepted current user parent expansion emits the existing `lr-topic-toggle { topicId, expanded }`;
+accepted current leaf selection emits `lr-topic-select { topicId }`, always with the original key.
+Source activations delegate provider actions instead of mutating legacy expansion state. Diagram
+keyboard navigation delegates to the global navigator. Loading, failure and obsolete actions
+cannot emit events against a replacement row, even if it reuses the key. Source parts are
+`source-list`, `source-row`, `source-toggle`, `source-label`, `source-status`, `source-error` and
+`source-diagram`; localized loading, complete visible/logical counts, empty and projection/row
+failure with retry are distinct states.
+
+Reassign even the same source or call a keyless `requestUpdate()` after revision/state changes.
+Named local paints, resize and direction changes reuse admitted rows; effective locale/revision
+changes request a new projection. Replacement, superseding project/reveal, unset, disconnect and
+adoption revoke old diagram rows, navigation callbacks and actions; reconnect requests current
+input. The accepted request's original revision/signal remains authoritative during normalization,
+so a reentrant source change cannot finish an obsolete display record.
+
+The following array admission, initial-depth expansion and 500-node sampling rules apply with
+`treeSource` unset.
+
 **Properties:**
 
-- `topics: LyraTopic[] = []` (attribute: false) — `LyraTopic { id: string; label: string; children?:
-LyraTopic[] }`; a single root sits at the center, multiple roots hang off an implicit center hub.
-  A tree too large for one collection snapshot (10,000 entries / 50,000 values) keeps its first
-  50,000 topics, shallowest first, as `{ id, label, children }` records
+- `topics: readonly LyraTopic[] = []` (attribute: false) — `LyraTopic { id: string; label: string; children?:
+readonly LyraTopic[] }`; a single root sits at the center, multiple roots hang off an implicit center hub.
+  Assignment copies own data fields without invoking accessors, inspecting at most 50,000 source
+  positions breadth-first and retaining at most 64 descendant levels. Invalid entries consume
+  the inspection allowance. Shared occurrences keep the existing depth-first first-ID layout
+  behavior
 - `label?: string` — accessible name for the SVG group and the implicit hub's text; omission uses
   the localized mind-map label, while an explicit empty string stays empty
 - `expandDepth: number = 1` (attribute `expand-depth`) — initial expansion depth (root + first
   ring); expansion state afterward is component-managed per topic id and survives `topics`
   reassignment
 
-Above 500 currently-visible nodes (per the current expand/collapse state), the SVG and the
+With `treeSource` unset, above 500 currently-visible nodes (per the current expand/collapse state),
+the SVG and the
 parallel sr-only tree both render a deterministic, connectivity-preserving, subtree-size-weighted
 sample instead of every node: a kept node's parent, if any, is always kept too (no floating nodes
 with a dangling connector or a gap in the `role="tree"` walk), and a larger branch keeps
@@ -42,6 +115,9 @@ proportionally more of its own nodes than a small one, sampled evenly across a w
 own child list rather than dropping its tail outright. A surviving node keeps the position the
 full layout gave it. A localized "showing N of M" notice appears in `[part="limit"]`.
 
+The legacy `input-limit` part reports omitted branches even when collapsed. Unseen descendant
+totals are not counted; the render-decimation notice describes only the retained hierarchy.
+
 **Events:** `lr-topic-select` (`detail: { topicId }`, a _leaf_ topic was activated),
 `lr-topic-toggle` (`detail: { topicId, expanded }`, a parent topic was activated, or auto-expanded by
 keyboard descent).
@@ -50,8 +126,13 @@ keyboard descent).
 
 **CSS parts:** `base`, `svg` (the single-tab-stop focus target), `node`, `node-label`, `link`
 (parent-child connector), `focus-ring` (keyboard focus ring), `limit` (the "showing N of M"
-render-cap notice, present only above 500 currently-visible nodes), `live-region` (visually hidden
-announcement region), `empty` (shown when `topics` is empty).
+render-cap notice, present above 500 legacy visible nodes and always in source mode),
+`input-limit` (legacy input-admission notice), `live-region` (visually hidden
+announcement region), `empty` (shown when legacy `topics` is empty).
+Source-mode parts: `source-diagram` (the bounded connected subtree), `source-list` (the global
+virtualized navigator), `source-row` (a hierarchy row with global position metadata),
+`source-toggle` (expand, collapse or retry action), `source-label` (topic label), `source-status`
+(loading, empty and global-count status), and `source-error` (failure and retry status).
 
 **Themeable custom properties:** `--lr-mind-map-ring-gap` (default `6rem`, radius step per depth
 ring, read on each relayout: connect, resize, `dir`/`lang`, data or expansion change). `--lr-mind-map-node-hover-halo` (default `var(--lr-color-brand-quiet)`) — stroke color of
@@ -82,13 +163,13 @@ clickable" feedback keyboard users already get from the drawn `focus-ring` part.
 
 **Known gotchas:**
 
-- A user's explicit expand/collapse only ever overrides the `depth < expandDepth` default in the
+- With `treeSource` unset, a user's explicit expand/collapse only ever overrides the `depth < expandDepth` default in the
   direction chosen — reassigning `topics` (even with the same ids) never silently discards that
   override.
 - Node-position transitions use `--lr-transition-base`, which already collapses to near-zero under
   `prefers-reduced-motion: reduce` globally, so expansion snaps rather than tweening for a
   reduced-motion user with no extra branching in this component.
-- Topic ids must be nonblank and unique across the complete hierarchy. Later depth-first duplicates
+- Legacy topic ids must be nonblank and unique across the complete hierarchy. Later depth-first duplicates
   and their subtrees are omitted before layout, navigation, expansion state, rendering, or events.
 
 ---

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

@@ -9,14 +9,14 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [conversation](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/conversation.md)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 15 parts, 30 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 16 parts, 30 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`
 
 ---
 
 ## `lr-model-select`
 
-The model list follows the [shared surface treatment](shared/styles-and-tokens.md);
+The model list follows the [shared surface treatment](../shared/styles-and-tokens.md);
 its editing field retains an opaque fill.
 
 A provider/model picker that renders as a closed dropdown when a fixed `catalog` is available, or as a
@@ -76,7 +76,11 @@ focus move.
 - `catalog?: LyraCatalog<LyraModelCatalogEntry>` (attribute: false) — the full model list. Omit (or
   leave empty) to fall back to plain free-text entry. Ids use the shared unique, nonempty,
   first-wins catalog rule above. The array is clone-owned, bounded, and frozen; reassign a new
-  catalog array after changing its rows.
+  catalog array after changing its rows. Admission retains the first 1,024 source rows within the
+  shared 50,000-value deep snapshot budget; normalization examines that admitted prefix. The
+  localized `limit` part reports omitted input through `catalogPickerInputLimit`. A synthetic row
+  for a committed value outside the catalog can still be appended. Closed listboxes contain no
+  option rows after their exit transition; trigger labels and free-text behavior remain available.
 - `allowCustom: boolean = false` (attribute `allow-custom`, reflected) — let the user type/commit a
   value that isn't in `catalog`, even when `catalog` is non-empty.
 - `label: string = ''` — optional visible title above the control, rendered alongside the `label`
@@ -208,7 +212,7 @@ constraint validation — its own `disabled` or `readonly`, or an ancestor `<fie
 reports no violation and publishes neither `:state(invalid)` nor
 `:state(user-invalid)`, matching native `:invalid`. `required`/`optional` keep publishing.
 
-**CSS parts:** `form-control` (the complete label, control, hint, error, and listbox frame),
+**CSS parts:** `limit` (input-loss notice), `form-control` (the complete label, control, hint, error, and listbox frame),
 `form-control-label` (the `<label>` element containing the `label` property and slot), `trigger` (closed-dropdown mode's
 `<button role="combobox">`, also its positioning anchor), `combobox` (free-text mode's input
 container, also its positioning anchor), `combobox-input` (the free-text `<input>`),

package/llms/components/lr-model-settings-panel.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [conversation](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/conversation.md)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 7 parts, 1 custom property — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 8 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`
 
 ---
@@ -52,6 +52,13 @@ of `catalog`/`allowCustom` and `temperatureMin`/`temperatureMax`/`temperatureSte
   reach either, since a form-associated control's own `disabled` IDL property/attribute is never
   mutated by fieldset cascading.
 
+The panel snapshots `catalog` before forwarding it to the model picker. Its own deep input budget
+can omit rows before the child reaches its catalog ceiling. A localized `catalogPickerInputLimit`
+notice in the panel's `part="limit"` discloses that outer loss from the original assignment,
+independently of the child's notice. Rebinding the retained snapshot preserves it; a fresh input
+below the limit clears it. Initial mounting and reconnecting are quiet; later changed input loss
+is politely announced.
+
 **Events:** `lr-change` — `detail: { model: string; inCatalog: boolean; temperature: number }`.
 Fires whenever _either_ child control's own `lr-change` fires, and always carries the full current
 settings snapshot, not just whichever field actually changed. `inCatalog` is recomputed fresh from
@@ -63,7 +70,8 @@ assigned directly instead of via the child's own event. The nested selector's na
 **Slots:** none — this is a fixed two-control composition, not a generic layout shell.
 
 **CSS parts:** `base`, `model-row`, `model-select`, `model-label` (forwarded visible internal
-selector label), `temperature-row`, `temperature-label`, `temperature-value`
+selector label), `temperature-row`, `temperature-label`, `temperature-value`, `limit` (outer catalog
+input-loss notice)
 
 **Themeable custom properties:** `--lr-model-settings-panel-max-inline-size` — the card's own width
 ceiling (default `var(--lr-size-28rem)`). Set a length to retune it, or `none` for a full-width

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

@@ -17,7 +17,7 @@
 
 ## `lr-navigation-menu`
 
-Floating navigation disclosures follow the [shared surface treatment](shared/styles-and-tokens.md);
+Floating navigation disclosures follow the [shared surface treatment](../shared/styles-and-tokens.md);
 inline disclosures retain their flow presentation.
 
 Site-header navigation following the WAI-ARIA **disclosure navigation** pattern (first-party, no

package/llms/components/lr-neighbor-list.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** none
-- **Themeable via** 9 parts, 0 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`
 
 ---
@@ -20,6 +20,70 @@ One entity's relationship rows: relation, direction, neighbor, with per-row navi
 expand-in-graph affordances. Never computes neighbors itself (the host derives rows from its own
 graph data) and never mutates a graph.
 
+With `graphSource` unset, the `limit` part reports retained/source relationship-row counts when input admission omits
+rows. Virtualization covers the retained rows; it does not recover omitted source rows.
+
+**Full-source neighborhood:** `graphSource: NeighborListSource | undefined`
+(attribute: false) takes precedence over `rows`; invalid defined providers fail visibly.
+Setting `undefined` restores the latest legacy rows. `NeighborListSource` aliases the public
+`GraphSource` contract. This adapter queries its `records` only; it never requests a graph scene,
+scans adjacency or copies the complete neighborhood.
+
+```ts
+import type { NeighborListSource, NeighborSourceDirection } from
+  "@aceshooting/lyra-ui/components/retrieval/neighbor-list/neighbor-list.class.js";
+import type { LyraGraphSourceQuery, LyraGraphSourceSummary } from
+  "@aceshooting/lyra-ui/data-sources.js";
+```
+
+`centerKey: string | null = null` (attribute: false) is a canonical `'node:' + originalId` key;
+null shows a localized choose-center state with no query. Nonblank canonical node keys are at most
+65,536 UTF-16 units. `sourceDirection: NeighborSourceDirection = 'both'` (`source-direction`)
+accepts `'in' | 'out' | 'both'`. Property-only
+`sourceNodeTypes: readonly string[] = []` accepts at most 500 input entries, then deduplicates/sorts
+nonblank type IDs, each at
+most 65,536 UTF-16 units and together at most 2,000,000 units. Invalid scopes fail visibly.
+Scope/page-size changes reset page zero.
+
+`sourcePage: number = 0` (`source-page`) is zero-based;
+`sourcePageSize: number = 100` (`source-page-size`) normalizes to 1–500. Readonly
+`sourceTotal: number | null` reports the authoritative matching neighborhood count after success,
+or `null` without a source/center or while unavailable. A total shrink receives at most one
+corrective last-page request. Pager navigation reaches the complete matching domain with at most
+500 current native-button rows, independent of the legacy `virtualizeAt` threshold.
+
+Source and `records` revisions must agree and remain immutable (nonempty string or finite number).
+`records.query({ revision, locale, signal, page, pageSize, query })` receives
+`{ kind: 'nodes', search: '', centerKey, direction: sourceDirection, nodeTypes: sourceNodeTypes }`.
+It returns `{ rows, total, summary: { nodes, edges } }`; all counts are safe nonnegative integers,
+with `total <= summary.nodes`. Each row is `{ key, order, value: { kind: 'node', value: node } }`,
+where `key === 'node:' + node.id`, `order` is a safe canonical source ordinal, and page keys/orders
+are unique. Returned rows exactly fill the requested in-bounds page. Closed own-data node
+snapshots retain only `id`, optional `label`, `accessibleLabel` and `type`; strings are at most
+65,536 units each and the page's projected text shares a 2,000,000-unit bound. Malformed/oversized
+pages fail atomically. Group/facet metadata is not accepted. The provider owns full-source
+indexing, order, neighborhood membership and summary truth beyond bounded consistency checks.
+
+Source mode presents node neighbors without invented relation, per-row direction or group headers;
+`groupByRelation` and legacy relation/direction/type-degree chrome do not apply. `expandable`
+retains the native expand button. Activation emits unchanged `lr-entity-select { entityId }` and
+`lr-node-expand { nodeId }` with original entity IDs, excluding the canonical `'node:'` prefix.
+
+`revealSourceKey(key: string): Promise<boolean>` uses `records.locate(key, query, context)` to
+find a matching global node, loads its page and focuses its exact row. It emits no select/expand
+event. Invalid, absent, failed, superseded or disconnected requests resolve `false`; a same-page
+reveal preserves live row/expand actions without another page query. Global lookup is required by
+the records contract, but ordinary paging/reveal does not enumerate other pages or request scenes.
+
+Reassign even the same source, or call a keyless `requestUpdate()`, after revision/state changes.
+Named presentation updates reuse accepted data. Replacement, scope/page changes, disconnect and
+adoption revoke obsolete controls/reveals. Page/lookup/locate lanes allow one physical provider
+call each and only the latest queued intent; ignored aborts occupy their permits until settlement.
+Bounded current/in-progress pages are retained, with no complete neighbor index. `source-status`,
+`source-retry` and `source-summary` expose localized choose/loading/error/empty and shown/global
+count states. Existing `base`, `row`, `node-label` and `expand-button` parts apply to source rows.
+The following relationship-array rules describe the legacy route.
+
 **Properties:**
 
 - `rows: LyraNeighborRow[] = []` (attribute: false) — `LyraNeighborRow { relation: string; direction:
@@ -46,8 +110,11 @@ name and detail shape as `lr-graph`'s own event, so one host handler serves both
 name), `row` (`role="listitem"`; above `virtualizeAt` this is the internal virtual-list's own row
 wrapper, re-exported under the same name), `direction` (`aria-hidden` glyph), `relation`,
 `node-label`, `node-meta` (secondary type/degree text, when present), `expand-button` (only when
-`expandable`), `empty` (shown when `rows` is empty). Every part presents identically either side of
+`expandable`), `limit` (input-admission notice), `empty` (shown when `rows` is empty). Every part presents identically either side of
 `virtualizeAt`.
+Source-mode parts: `source-status` (loading, failure, empty or missing-center feedback),
+`source-summary` (exact neighborhood total and current page count), and `source-retry`
+(the current failed request's retry action).
 
 **Themeable custom properties:** shared tokens only.
 

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

@@ -9,6 +9,6 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [charts](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/charts.md)
 - **Deprecations** none
 - **Optional peers** `chart.js`, `chartjs-plugin-annotation`, `chartjs-plugin-datalabels`, `chartjs-plugin-zoom` — see `llms/peers.md`
-- **Themeable via** 17 parts, 39 custom properties — see `lr-line-chart.md`
+- **Themeable via** 18 parts, 39 custom properties — see `lr-line-chart.md`
 - **Documented with** `lr-line-chart`: see [lr-line-chart.md](./lr-line-chart.md).
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`

package/llms/components/lr-polar-area-chart.md

@@ -9,6 +9,6 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [charts](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/charts.md)
 - **Deprecations** none
 - **Optional peers** `chart.js`, `chartjs-plugin-annotation`, `chartjs-plugin-datalabels`, `chartjs-plugin-zoom` — see `llms/peers.md`
-- **Themeable via** 17 parts, 39 custom properties — see `lr-line-chart.md`
+- **Themeable via** 18 parts, 39 custom properties — see `lr-line-chart.md`
 - **Documented with** `lr-line-chart`: see [lr-line-chart.md](./lr-line-chart.md).
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`

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

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [conversation](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/conversation.md)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 10 parts, 1 custom property — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 11 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`
 
 ---
@@ -65,6 +65,13 @@ Every array-valued property above is a clone-owned, bounded, frozen readonly sna
 nested source children and queued attachments. Mutating a previously assigned collection has no
 effect; create and reassign a new array after changes.
 
+The outer snapshot can omit `modelCatalog`, `voiceCatalog`, `mentionItems`, or `commandItems`
+before the corresponding child reaches its own input ceiling. The prompt's `part="limit"` uses
+`promptInputInputLimit` to disclose that original assignment loss, including when no valid child
+catalog remains to render. Rebinding a retained snapshot preserves the notice; a fresh input below
+the limit clears it. Initial mounting and reconnecting are quiet; later changed input loss is
+politely announced.
+
 `LyraPromptSuggestion` extends `LyraMentionItem { suggestionId, label, description?, icon?, disabled? }`
 with optional `insertText` (defaults to `label`). The selected occurrence's original, pre-filter `index`
 is preserved in the event detail. `LyraPromptInputAttachment` replaces `DocumentRef.id` with
@@ -102,7 +109,7 @@ host can play its own TTS preview (call `preventDefault()`) for catalog entries
 replaces the built-in composer action.
 
 **CSS parts:** `base`, `controls`, `sources`, `sources-summary`, `source-picker`, `queue`,
-`composer`, `start`, `chips`, `footer`.
+`composer`, `start`, `chips`, `footer`, `limit` (outer suggestion or catalog input-loss notice).
 
 **Themeable custom properties:** `--lr-prompt-input-control-width` (default `--lr-size-12rem`) is
 the preferred width of each generated model, voice, and source control before wrapping.

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

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [conversation](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/conversation.md)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 11 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`
 
 ---
@@ -18,6 +18,10 @@
 
 Controlled editable queue of follow-up turns. Reordering, editing, and removal emit a complete
 proposed queue; send-now emits the complete selected item.
+Admission inspects at most 10,000 item positions and 10,000 attachment positions across one
+assignment, including invalid positions. Internal pages contain at most 20 rows, with localized
+first/previous/next/last controls reaching every admitted item. Each row previews at most 50
+retained attachment names. Separate notices distinguish input loss from the attachment preview.
 
 When a focused row action requests removal and the host applies the proposed queue, focus moves to
 the equivalent action on the nearest surviving row. If the queue becomes empty, its stable region
@@ -44,14 +48,18 @@ Supported item and attachment fields are read once when `items` is assigned; cre
 new collection after changes, because changing an assigned record or reassigning the same mutated
 array does not update the view. Rows or attachments without valid direct data are ignored. Duplicate IDs are resolved
 after validation, so the first valid item wins. `metadata` is opaque and retains identity in
-proposed queue/send-now payloads, while emitted items are new frozen snapshots.
+proposed queue/send-now payloads. Proposals contain the complete admitted queue in a frozen array;
+unchanged frozen exported rows and attachment arrays are reused, including after the host accepts
+a proposal. Send-now includes all retained attachments. Draft text survives page navigation.
 
 **Events:** `lr-queue-change` (`PromptQueueChangeDetail = { items, reason, itemId }`, with
 `reason: 'edit' | 'remove' | 'reorder'`), `lr-send-now` (`{ item }`). The queue is controlled:
 these events propose complete next values without mutating `items`.
 
 **CSS parts:** `base`, `heading`, `list`, `item`, `value`, `editor`, `attachments`, `attachment`,
-`actions`, `action`, `empty`.
+`actions`, `action`, `empty`, `input-limit`, `attachment-limit`, `pagination`, `page-status`,
+`page-button`. Initial input-limit notes are quiet; later changed omissions and user page changes
+are politely announced.
 
 **Slots:** none. **Optional peer deps:** none.
 

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

@@ -9,6 +9,6 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [charts](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/charts.md)
 - **Deprecations** none
 - **Optional peers** `chart.js`, `chartjs-plugin-annotation`, `chartjs-plugin-datalabels`, `chartjs-plugin-zoom` — see `llms/peers.md`
-- **Themeable via** 17 parts, 39 custom properties — see `lr-line-chart.md`
+- **Themeable via** 18 parts, 39 custom properties — see `lr-line-chart.md`
 - **Documented with** `lr-line-chart`: see [lr-line-chart.md](./lr-line-chart.md).
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`

package/llms/components/lr-rag-eval-dashboard.md

@@ -11,7 +11,7 @@
 - **Deprecated event** `lr-run-change` since `26.0.0`; use event `@lr-run-activate`; removal not before `28.0.0` — lr-run-activate matches the activate vocabulary of the library's other run lists; the alias fires right after it for one major.
 - **Deprecated event** `lr-slice-change` since `26.0.0`; use event `@lr-slice-change-request`; removal not before `28.0.0` — lr-slice-change-request names a request the application decides on; the old event fires right after it for one major.
 - **Optional peers** none
-- **Themeable via** 15 parts, 1 custom property — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 17 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`
 
 ---
@@ -45,6 +45,13 @@ history, counts, rendering, or actions.
 At most the 500 most recent of the currently filtered runs (the array end is newest) render as
 `run` buttons and feed the trend chart; a filtered set past that length renders a localized
 `limit` notice after the run history rather than mounting an unbounded number of rows.
+Input admission itself retains the newest bounded run tail and reports any earlier loss in
+`input-limit`. Latest metric cards still consider every admitted filtered run, including a finite
+metric outside the 500-row history window. Slice controls are capped at 500 including All: at most
+499 named slices, reserving the selected slice when it exists. `slices-limit` reports the displayed
+and full admitted slice counts. Run, metric, and slice projections are reused across presentation
+updates; localized formatting remains live. Initial and reconnect omission notes are quiet;
+later changed omissions are politely announced.
 
 **Events:** `lr-metric-change-request` (`{ metricId }`), `lr-slice-change-request` (`{ slice }`) and
 `lr-run-activate` (`{ runId, run }`). All are controlled intents; the component does not mutate the
@@ -54,7 +61,7 @@ corresponding selection properties. The deprecated `lr-metric-change`, `lr-slice
 **CSS parts:** `base`, `heading`, `slices`, `slice`, `slice-selected`, `metrics`, `metric`,
 `metric-selected`, `metric-category` (the caller-supplied category rendered visibly on each metric),
 `chart`, `runs`, `runs-heading`, `run`, `limit` (localized notice that only the most recent 500
-filtered runs are shown), `empty`.
+filtered runs are shown), `input-limit`, `slices-limit`, `empty`.
 
 **Themeable custom properties:** `--lr-rag-eval-dashboard-selected-border-color` (default
 `var(--lr-color-brand)`) — border color shared by the controlled active slice and metric.

package/llms/components/lr-realtime-session.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [conversation](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/conversation.md)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 12 parts, 0 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`
 
 ---
@@ -18,6 +18,10 @@
 
 Provider-neutral realtime voice shell composing connection state, `lr-audio-visualizer`,
 `lr-push-to-talk`, and `lr-transcript-feed`. Transport/authentication/playback remain host-owned.
+When the shell's own admission drops older entries, its `input-limit` note reports the original
+assigned count and retained count. The child transcript's smaller rendered window remains a
+separate limit. Initial and reconnect notes are quiet; later changed omissions are politely
+announced.
 
 **Properties:** `state: RealtimeConnectionState = 'disconnected'` (reflected), where the closed set
 is `'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'error'`; `voiceState:
@@ -50,7 +54,7 @@ The composed transcript's internal `lr-follow-change` event is contained and is
 session shell's public event surface.
 
 **CSS parts:** `base`, `header`, `status`, `activity`, `controls`, `connect`, `disconnect`, `mute`,
-`interrupt`, `capture`, `transcript`, `error`.
+`interrupt`, `capture`, `transcript`, `error`, `input-limit`.
 
 Visible status and error text remain ordinary, non-live content. After the initial baseline,
 non-error `state` transitions are appended to the shared polite light-DOM announcement sink and a

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

@@ -39,6 +39,10 @@ controls; making it invalid disables them. Identity edits do not emit a reorder
 value attribute from a standalone item renders it as absent while preserving `null` readback; an
 explicit empty string remains supplied and later valid values recover.
 
+Movement boundaries reconcile once after an accepted internal move; native slot changes and item
+identity changes remain authoritative. An explicit item `aria-label` avoids content-name
+observation; otherwise the item refreshes its cached accessible name when slotted content changes.
+
 ### `lr-reorder-list`
 
 **Properties:**

package/llms/components/lr-retrieval-compare.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** none
-- **Themeable via** 14 parts, 1 custom property — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 19 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`
 
 ---
@@ -21,7 +21,7 @@ dense/sparse/rerank/final score breakdowns.
 
 **Properties:** `sets: RetrievalComparisonSet[] = []` (attribute: false), where
 `RetrievalComparisonSet = { id: string; label: string; chunks: RetrievalChunk[] }`;
-`topK: number = 10` (attribute `top-k`, finite integer with minimum 1);
+`topK: number = 10` (attribute `top-k`, finite integer clamped to 1–100);
 `selectedChunkId: string = ''` (attribute `selected-chunk-id`); `headingLevel: LyraHeadingLevel =
 '3'` (attribute `heading-level`, each set heading; `'none'` keeps the visible text without heading
 semantics); `label?: string` (fallback name for the overall comparison region; a non-empty host `aria-label` makes the host the sole overall
@@ -40,10 +40,15 @@ controlled selection, rendering, or events.
 **Events:** `lr-chunk-select` (`{ setId, chunk }`).
 
 **CSS parts:** `base`, `overlap`, `sets`, `set`, `set-heading`, `chunks`, `chunk`,
-`chunk-selected`, `chunk-rank`, `chunk-title`, `chunk-text`, `scores`, `score`, `empty`.
+`chunk-selected`, `chunk-rank`, `chunk-title`, `chunk-text`, `scores`, `score`, `empty`,
+`input-limit`, `result-limit`, `pagination`, `page-status`, `page-button`.
 
 Chunks are ordered by effective rank, then score, then input order before the top-k slice. Overlap
-is pairwise Jaccard similarity across those visible chunk ids. Selection is controlled. A result
+is pairwise Jaccard similarity across those visible chunk ids on the current page. Internal pages
+contain at most eight sets, so at most 28 overlap pairs are computed. Localized first/previous/next/
+last controls reach every admitted set. `input-limit` discloses input admission loss, while each
+`result-limit` reports visible top-k rows against that set's retained result count. Ranking and
+overlap projections are reused for presentation-only updates. Selection is controlled. A result
 button is named by its rank and source title (a blank name shows the localized "untitled source");
 its text and scores are the button's description.
 **Slots:** none. **Optional peer deps:** none.