@aceshooting/lyra-ui 19.0.1 → 20.0.1

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

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 11 parts, 1 custom property — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 11 parts, 3 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`
 
 ---
@@ -29,7 +29,8 @@ string; summary?: string; memberCount?: number }`; `memberCount` is a non-negati
 - `members: LyraEntity[] = []` (attribute: false) — rendered as chips, up to `maxMembers`
 - `maxMembers: number = 8` (attribute `max-members`) — remaining members collapse into a "+N"
   overflow chip
-- `compact: boolean = false` (reflected) — omits the summary excerpt and member chips
+- `compact: boolean = false` (reflected) — omits the summary excerpt and member chips, and tightens
+  `[part='base']`'s padding/gap — same convention as the sibling `lr-entity-card`'s `compact`
 - `frame: LyraFrame = 'card'` (reflected) — container treatment, in the library-wide `frame`
   vocabulary (`'card' | 'plain'`), the same property this component's sibling `lr-entity-card`
   carries. `'card'` (the default) keeps the bordered, filled, padded box; `'plain'` removes the
@@ -50,8 +51,10 @@ activated).
 
 **Themeable custom properties:** `--lr-community-card-bg` (default `var(--lr-color-surface)`) —
 `[part='base']`'s RESTING background, so a panel retinting its `lr-entity-card`/`lr-source-card`
-siblings can retint this card with it; `frame='plain'` still drops the fill entirely. Otherwise
-shared tokens.
+siblings can retint this card with it; `frame='plain'` still drops the fill entirely.
+`--lr-community-card-compact-padding` (default `var(--lr-space-s)`) and
+`--lr-community-card-compact-gap` (default `var(--lr-space-xs)`) — `[part='base']` padding/gap
+while `compact`. Otherwise shared tokens.
 
 **Optional peer deps:** none.
 

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

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 15 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`
 
 ---
@@ -62,4 +62,5 @@ menu. These composed child events surface unchanged; the inspector does not emit
 **CSS parts:** `base`, `toolbar`,
 `segments`, `segment`, `segment-header`, `segment-label`, `segment-text`, `segment-tokens`,
 `meter` (the embedded `lr-context-meter`), `citation`, `redaction` (one redaction placeholder
-marker), `truncation-boundary`, `copy-button`, `export-button`, `empty`.
+marker), `truncation-boundary`, `copy-button`, `export-button`, `empty`, `limit` (localized notice
+shown when `segments` exceeds the 500-row render ceiling).

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

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 17 parts, 10 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 17 parts, 14 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`
 
 ---
@@ -129,9 +129,15 @@ ring stays intact. `--lr-context-meter-selected-arc-stroke` (default `16`, in th
 one bounding box, so a selected arc reports itself by thickening in place rather than by an outline
 that would trace the whole ring identically for every selection.
 `--lr-context-meter-disabled-opacity` (default `var(--lr-opacity-disabled)`) dims a band or legend row whose entry sets
-`disabled`; the band keeps its own colour, since that colour is the datum. Otherwise the component consumes shared tokens
+`disabled`; the band keeps its own colour, since that colour is the datum. Each `data-tone` band
+color is independently retintable, scoped to just this component rather than the shared token
+every other component also reads: `--lr-context-meter-tone-brand-bg` (default
+`var(--lr-color-brand)`), `--lr-context-meter-tone-success-bg` (default `var(--lr-color-success)`),
+`--lr-context-meter-tone-warning-bg` (default `var(--lr-color-warning)`) and
+`--lr-context-meter-tone-danger-bg` (default `var(--lr-color-danger)`) — each read by the bar
+segment, its legend swatch, and (as the `stroke`) the ring shape's arc, so all three surfaces for a
+tone stay in sync. Otherwise the component consumes shared tokens
 `--lr-space-xs`, `--lr-color-text-quiet`, `--lr-font`, `--lr-radius`, `--lr-color-border`,
-`--lr-color-brand`, `--lr-color-success`, `--lr-color-warning`, `--lr-color-danger`,
 `--lr-transition-base`.
 
 **Optional peer deps:** none.
@@ -166,8 +172,10 @@ bar/ring either: an over-`total` `segments` array renders as a fully (not over-)
 later segments truncated or squeezed to zero width/arc-length as the budget runs out. `total <= 0`
 (or non-finite) renders zero segments — an empty track/ring — and the announced summary falls back to
 just `"{used} used"` with no `"of {total}"` clause, regardless of what's in `segments`. Ring geometry
-(a 40-radius circle, 12px stroke, centered at 50,50) intentionally matches `lr-gauge`'s own radial
-numbers, so the two circular-meter components in the library share one visual scale.
+(a 40-radius circle centered at 50,50) has its RADIUS/CENTER match `lr-gauge`'s own radial numbers,
+so both components' rings sit on the same circle within their viewBox. The stroke does not match:
+at 12px it is intentionally heavier than `lr-gauge`'s 10px, since tightly-packed multi-tone arcs
+need more width to stay visually distinct than a gauge's single fill arc.
 
 **Known gotchas:**
 

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

@@ -127,6 +127,8 @@ ARIA values as page-local positions rather than as the dataset-wide total.
 `filterType`, `filterFn`, `hidden`, `hideable`, `resizable`, `movable`, `pinnable`, `pinned`,
 `footer`, `aggregation`, and `aggregatedFormatter`. A column with neither `field` nor `value` is an
 action column: its formatter receives `undefined`, and it is not sorted or searched by default.
+An omitted or explicitly blank (or whitespace-only) `label` both render the same humanized
+`field`/`id` fallback for the header cell — only a non-blank `label` overrides it.
 `cellTitle(row) => string | undefined` renders as the generated cell's native `title`, symmetrical
 with `<lr-table>`'s `columns[].cellTitle` — e.g. the untruncated text behind an ellipsized cell, or
 a formatted timestamp behind a relative one. Returning `undefined` or `''` omits the `title`

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

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 22 parts, 24 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 22 parts, 25 custom properties — see this component's own `@csspart`/`@cssprop` list below
 - **Documented with** `lr-date-picker` (same section below)
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
 
@@ -180,7 +180,13 @@ Text field + calendar popover, **form-associated** via the shared `FormAssociate
 
 **Properties (44):**
 
-- `appearance: 'filled'|'outlined'|'filled-outlined' = 'outlined'` (reflected)
+- `appearance: 'accent' | 'filled' | 'outlined' | 'filled-outlined' | 'plain' = 'outlined'`
+  (reflected) — the library's shared field-surface vocabulary, matching `lr-select`'s trigger and
+  `lr-combobox`'s own `appearance`. `outlined` (the default) is a bordered surface; `filled` swaps
+  the border for a raised fill; `filled-outlined` keeps both; `plain` drops both; `accent` paints
+  the loud brand fill with on-brand text (the placeholder, start/end adornments and clear/expand
+  buttons all ride that on-brand color rather than the quiet-text tokens). An unsupported value,
+  including a raw attribute/property write outside this type, clamps to the `'outlined'` default
 - `appliedPreset: LyraDateRangePreset | undefined` (read-only, new in 12.0.0) — the `presets` entry
   whose button produced the current `value`, or `undefined` when the value was picked on the
   calendar, typed into the field, cleared, or reset. Read it inside your own `change`/`input`
@@ -319,7 +325,10 @@ With no label text the part is hidden and no glyph is painted.
 `--lr-form-control-height`. All four defaults follow the shared size ladder, including
 `small`/`medium`/`large` aliases and inherited `--lr-theme-form-control-height-*` overrides.
 Inherited or direct public values win. `pill` changes the private radius default to
-`--lr-radius-pill`; a public `--lr-date-input-radius` still wins.
+`--lr-radius-pill`; a public `--lr-date-input-radius` still wins. `--lr-date-input-text-color`
+(default `inherit`) recolors the row's own text; `appearance="accent"` defaults it instead to
+`var(--lr-color-on-brand)`, keeping the placeholder and clear/calendar actions readable on the loud
+brand fill.
 
 Calendar and clear actions fit inside the selected row height while retaining at least 24×24
 CSS-pixel targets. At the default root size, rows measure 30/40/48/56px for s/m/l/xl; 2xs and xs

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

@@ -180,7 +180,13 @@ Text field + calendar popover, **form-associated** via the shared `FormAssociate
 
 **Properties (44):**
 
-- `appearance: 'filled'|'outlined'|'filled-outlined' = 'outlined'` (reflected)
+- `appearance: 'accent' | 'filled' | 'outlined' | 'filled-outlined' | 'plain' = 'outlined'`
+  (reflected) — the library's shared field-surface vocabulary, matching `lr-select`'s trigger and
+  `lr-combobox`'s own `appearance`. `outlined` (the default) is a bordered surface; `filled` swaps
+  the border for a raised fill; `filled-outlined` keeps both; `plain` drops both; `accent` paints
+  the loud brand fill with on-brand text (the placeholder, start/end adornments and clear/expand
+  buttons all ride that on-brand color rather than the quiet-text tokens). An unsupported value,
+  including a raw attribute/property write outside this type, clamps to the `'outlined'` default
 - `appliedPreset: LyraDateRangePreset | undefined` (read-only, new in 12.0.0) — the `presets` entry
   whose button produced the current `value`, or `undefined` when the value was picked on the
   calendar, typed into the field, cleared, or reset. Read it inside your own `change`/`input`
@@ -319,7 +325,10 @@ With no label text the part is hidden and no glyph is painted.
 `--lr-form-control-height`. All four defaults follow the shared size ladder, including
 `small`/`medium`/`large` aliases and inherited `--lr-theme-form-control-height-*` overrides.
 Inherited or direct public values win. `pill` changes the private radius default to
-`--lr-radius-pill`; a public `--lr-date-input-radius` still wins.
+`--lr-radius-pill`; a public `--lr-date-input-radius` still wins. `--lr-date-input-text-color`
+(default `inherit`) recolors the row's own text; `appearance="accent"` defaults it instead to
+`var(--lr-color-on-brand)`, keeping the placeholder and clear/calendar actions readable on the loud
+brand fill.
 
 Calendar and clear actions fit inside the selected row height while retaining at least 24×24
 CSS-pixel targets. At the default root size, rows measure 30/40/48/56px for s/m/l/xl; 2xs and xs

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

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** `shiki` — see `llms/peers.md`
-- **Themeable via** 5 parts, 8 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 7 parts, 16 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,6 +22,14 @@ over an already-formatted string (`<lr-code-block>`'s `language="diff"` only lex
 string the consumer already unified-diffed; it has no two-string-compare entry point of its own).
 First-party invention (no Web Awesome equivalent).
 
+Adopts `DocumentAnchorTarget`: a `line-range` anchor's `start` (and, for `highlights`, the optional
+`end`) addresses the 0-based index into the rendered diff's own op sequence — not an old-file/
+new-file source line number, since those diverge on any insertion or deletion. `scrollToAnchor()`
+resolves it, and both it and search navigation transparently expand (and, for a `highlights` range,
+paint through) any `contextLines` fold currently hiding the target run instead of leaving it
+inaccessible behind a static marker. `search()` is a locale-aware case-insensitive substring match
+over each rendered line's own text, one match per line ordered by that same op index.
+
 **Properties:**
 
 - `oldText: string = ''` (attribute: false) — the "before" text. Default `''` renders an
@@ -49,6 +57,8 @@ First-party invention (no Web Awesome equivalent).
   side. Larger input renders the localized `diffViewTooLarge` fallback without computing or
   highlighting the diff. `Infinity` relaxes this line-count ceiling, but the fixed aggregate
   character and comparison-work ceilings remain in force.
+- `anchorKinds: readonly LyraAnchorKind[] = ['line-range']` (this viewer's supported
+  `LyraAnchor.kind` values for the shared anchor-target contract).
 
 Grammar entries are read from own enumerable data fields into a bounded frozen map. A getter,
 unreadable field, non-enumerable field, or malformed proxy branch is skipped without preventing a
@@ -56,6 +66,13 @@ later valid grammar from being used; grammar values themselves remain opaque to
 Non-enumerable names do not consume language slots, but every inspected name counts toward the
 20,000 structural ceiling.
 
+**Methods:** `search(query)` resolves the match count via a case-insensitive substring match over
+each rendered line's own text, ordered by `line-range` op index (empty/whitespace query behaves like
+`clearSearch()`); `searchNext()`/`searchPrevious()` advance/step back through matches (wrapping,
+resolving `false` when there are none); `clearSearch()` clears the query, matches, and painted
+marks. `scrollToAnchor(target)` (inherited from `DocumentAnchorTarget`) resolves a `line-range`
+anchor or a `highlights` id string.
+
 **Events:**
 
 - `lr-copy` (`detail: LyraClipboardWriteSuccess`, `{ ok: true; text: string }`) — the frozen full
@@ -64,6 +81,14 @@ Non-enumerable names do not consume language slots, but every inspected name cou
 - `lr-copy-error` (`detail: LyraClipboardWriteFailure`) — the frozen failure outcome contains
   `ok: false`, the text, a `LyraCopyErrorReason`, and the original error. The reason is
   `'unsupported' | 'denied' | 'failed'`.
+- `lr-search-change` (`detail: { query, matchCount, matchCountExact, activeIndex }`) — from
+  search/navigation/clear, and effective-locale re-evaluation. Search accepts at most 4,096 query
+  code units, scans at most 4,000,000 line code units, and retains at most 10,000 matches;
+  `matchCountExact=false` identifies a ceiling-truncated lower bound.
+- `lr-highlight-activate` (`detail: { highlightId }`) — a `highlights` entry's
+  `[part="line-highlight-action"]` button was clicked or activated via Enter/Space.
+- `lr-anchor-result` (`detail: { found }`) — fired after an `anchor` assignment or a
+  `scrollToAnchor()` call.
 
 The copy button stays in its resting state until `writeText()` resolves. Success renders and
 announces localized `copied`; failure renders and announces localized `copyFailed`. A newer
@@ -75,13 +100,29 @@ retires an older pending outcome, so stale writes cannot confirm or fail a hidde
 **CSS parts:** `base` (the root wrapper), `line` (a single line; carries
 `data-type="equal"|"add"|"remove"|"empty"|"fold"` — `"empty"` is an unbalanced-replace placeholder cell in
 `layout="split"` and never carries a `+`/`-` prefix; `"fold"` is the localized unchanged-lines
-marker), `copy-button` (the copy affordance, only
-rendered while `copyable`), `limit` (the localized over-`maxLines` fallback), `side` (one column in
-`layout="split"`, `data-side="old"|"new"`).
+marker — plus `data-match`/`data-active-match` while a search result covers it, and
+`data-highlight` (the resolved tone, default `accent`) with `data-active-highlight` while a
+`highlights` entry covers it), `line-highlight-action` (the focusable button a resolved
+`highlights` entry adds to the line it first covers; emits `lr-highlight-activate`), `copy-button`
+(the copy affordance, only rendered while `copyable`), `limit` (the localized over-`maxLines`
+fallback), `side` (one column in `layout="split"`, `data-side="old"|"new"`), `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).
 
 **Themeable custom properties:** `--lr-diff-view-max-height` (default `none` — an independently
 settable scroll cap on `[part="base"]`; the `maxHeight` property writes the same custom property
-inline on `[part="base"]`), `--lr-diff-view-font` (default `var(--lr-font-mono)`), plus
+inline on `[part="base"]`), `--lr-diff-view-font` (default `var(--lr-font-mono)`),
+`--lr-diff-view-match-color`/`--lr-diff-view-active-match-color` (default
+`var(--lr-color-warning)` for both — outline of a line carrying a non-active/active search match),
+`--lr-diff-view-highlight-accent-background` (default `var(--lr-color-brand-quiet)`),
+`--lr-diff-view-highlight-success-background` (default `var(--lr-color-success-quiet)`),
+`--lr-diff-view-highlight-warning-background` (default `var(--lr-color-warning-quiet)`),
+`--lr-diff-view-highlight-danger-background` (default `var(--lr-color-danger-quiet)`), and
+`--lr-diff-view-highlight-neutral-background` (default `var(--lr-color-surface-raised)`) —
+background of a `highlights` line by tone,
+`--lr-diff-view-highlight-active-outline` (default `var(--lr-color-brand)` — outline of the line
+whose covering highlight is `activeHighlightId`), plus
 shared tokens `--lr-color-border`/`-surface`/`-success`/`-success-quiet`/`-danger`/
 `-danger-quiet`/`-text`, `--lr-radius`, `--lr-space-xs`/`-s`, `--lr-font-size-sm`,
 `--lr-line-height-snug`, `--lr-focus-ring-*`.

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

@@ -41,11 +41,14 @@ of every entry in these lists.**
 `refreshTheme()`.
 
 **Events:** `lr-zoom` (`detail: { zoomed: boolean }`), `lr-datum-activate`, `lr-point-click` (`detail: { datasetIndex,
-index, label, value }`), `lr-before-legend-visibility-change` (cancelable), and
+index, label, value }`), `lr-legend-visibility-change-request` (cancelable), and
 `lr-legend-visibility-change` (commit; both legend events carry `datasetIndex`, `visible`, and the
-complete `hiddenDatasets` snapshot).
-Radial category legends additionally emit `lr-before-datum-visibility-change` (cancelable) and
+complete `hiddenDatasets` snapshot). `lr-before-legend-visibility-change` is a **deprecated** alias
+of `lr-legend-visibility-change-request` (removal not before 21.0.0).
+Radial category legends additionally emit `lr-datum-visibility-change-request` (cancelable) and
 `lr-datum-visibility-change`, carrying `index`, `visible` and the frozen `hiddenDatums` snapshot.
+`lr-before-datum-visibility-change` is a **deprecated** alias of `lr-datum-visibility-change-request`
+(removal not before 21.0.0).
 
 **Slots:** default JSON configuration script, `data-table`, `center`.
 

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

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 6 parts, 10 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 6 parts, 11 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`
 
 ---
@@ -49,6 +49,9 @@ reimplemented.
   behavior exactly, and a negative, `NaN`, or `Infinity` override is normalized to `0` via
   `finiteCount` rather than corrupting every later comparison.
 - `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
+  can match a neighboring compact `lr-file-input` in the same dense layout.
 
 **Events:** `lr-files` (`detail: LyraDropZoneFilesDetail`, with fresh frozen readonly `files` and
 `rejected` arrays and frozen rejected-file records, plus `remainingFiles`/`remainingTotalSize`
@@ -75,8 +78,9 @@ while one exists).
 `--lr-drop-zone-overlay-border-color` (default `var(--lr-color-brand)`, the dashed overlay border in
 its neutral drag state, before an accept/reject verdict) and `--lr-drop-zone-overlay-bg` (default
 `color-mix(in srgb, var(--lr-color-brand) 8%, transparent)`, that same neutral state's fill),
-`--lr-drop-zone-overlay-font-size` (default `var(--lr-font-size-md-sm)`),
-`--lr-drop-zone-overlay-icon-size` (default `var(--lr-font-size-xl)`),
+`--lr-drop-zone-overlay-font-size` (default `var(--lr-font-size-md-sm)`, retuned per `size` tier),
+`--lr-drop-zone-overlay-icon-size` (default `var(--lr-font-size-xl)`, retuned per `size` tier),
+`--lr-drop-zone-overlay-padding` (default `var(--lr-space-l)`, retuned per `size` tier),
 `--lr-drop-zone-overlay-gap` (default `var(--lr-space-xs)`), and the drag accept/reject highlight —
 `--lr-drop-zone-accept-border-color`/`--lr-drop-zone-accept-bg` (defaults `var(--lr-color-success)`/
 `color-mix(in srgb, var(--lr-color-success) 12%, transparent)`) and

package/llms/components/lr-embedding-explorer.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 8 parts, 10 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 9 parts, 10 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`
 
 ---
@@ -34,11 +34,17 @@ Pointer and programmatic focus synchronize the single roving tab stop, and every
 least a 24×24 CSS px pointer target at narrow allocations without enlarging its marker. Optional
 cluster membership is exposed as each option's description and in a visible text legend, so the
 grouping never depends on color alone.
+Above 1,000 points, the plot renders a deterministic, evenly spaced sample of the whole array
+(spanning the full input, not a leading run) instead of every point, keeping DOM node and listener
+count bounded while the sampled points stay representative of the full plotted distribution; a
+localized "showing N of M" notice appears in `[part="limit"]`. `bounds` and the cluster legend
+still derive from the complete `points` array, so a decimated view keeps the same scale and the
+same complete legend as the full plot.
 
 **Events:** `lr-point-select` (`{ point }`), activated by click or Enter/Space.
 
 **CSS parts:** `base`, `plot`, `point`, `legend`, `legend-item`, `legend-swatch`, `legend-label`,
-`empty`.
+`limit` (the "showing N of M" render-cap notice, present only above 1,000 points), `empty`.
 
 **Themeable custom properties:** `--lr-embedding-explorer-selected-stroke` (default
 `var(--lr-color-brand)`) — stroke color of the selected point; `--lr-embedding-explorer-height`

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

@@ -20,7 +20,11 @@ A searchable, keyboard-navigable, form-associated emoji picker. `groups` is full
 — the component ships no emoji data of its own — in the same "zero/optional-peer dependency" spirit
 as `<lr-lite-chart>`/`<lr-heatmap>`; an optional convenience auto-loader fetches a default set on
 connect from the `emoji-picker-element-data` peer, but only when `groups` hasn't already been
-supplied (an explicit empty array still counts as supplied and skips the auto-load).
+supplied (an explicit empty array still counts as supplied and skips the auto-load). The auto-loader
+picks the peer's locale directory closest to `effectiveLocale` (an exact match, then the base
+language, else English), so each emoji's name — and therefore both its accessible name and the
+search index, not just the group headings — follows the page's locale; a later locale change
+reloads it. This only applies to the built-in dataset, never to a consumer-supplied `groups`.
 When the filtered set reaches 200 items, the grid automatically windows its visible rows while
 preserving the full option count through `aria-setsize`/`aria-posinset`.
 

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

@@ -81,5 +81,7 @@ ancestor to change every unset entity chip beneath it.
   `lr-entity-card` as shown above, and handle the chip's own `lr-entity-select`/`lr-entity-open`
   events for navigation.
 - A blank `entityId` disables the chip and cannot produce an activation/open event.
+- An open popover participates in shared Escape ordering even while only hovered, deferring to a
+  genuinely topmost overlay opened on top of it.
 
 ---

package/llms/components/lr-eval-run.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** `dompurify`, `katex`, `marked`, `shiki` — see `llms/peers.md`
-- **Themeable via** 24 parts, 0 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 25 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`
 
 ---
@@ -69,4 +69,5 @@ child events as `lr-example-claim-select` (`{ exampleId, claim }`),
 `header-label`, `progress`, `summary`, `counts`, `count`, `examples`, `example`, `example-summary`,
 `example-label`, `example-status`, `example-status-message`, `input-section`, `input`, `output-section`, `output`,
 `grounding-section`, `grounding-summary`, `tool-trace-section`, `tool-trace`, `section-heading`,
-`live-region`, `empty`.
+`live-region`, `empty`, `limit` (localized notice shown when `examples` exceeds the 500-row render
+ceiling).

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

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 6 parts, 14 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 6 parts, 16 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`
 
 ---
@@ -106,7 +106,10 @@ hover, `--lr-export-button-hover-background`, `--lr-export-button-hover-color` a
 the current `appearance` resolves to and leaves the other paints alone, so they are also the way to
 keep `appearance="outlined"` chrome while returning its label to neutral text — `outlined` paints
 the label `--lr-color-brand` and, unlike `lr-button`, this component has no `variant` of its own to
-opt out. Before 18.4.0 none of these existed and the only lever was `::part(trigger)`. Plus shared
+opt out. Before 18.4.0 none of these existed and the only lever was `::part(trigger)`.
+`--lr-export-button-gap` (default `var(--lr-space-xs)`, constant across the `size` ladder) and
+`--lr-export-button-radius` (default `var(--lr-radius)`) retune the trigger's icon/label gap and
+corner radius without a `::part(trigger)` rule. Plus shared
 tokens, including `--lr-popover-viewport-clamp` (default `92vw`) — the shared narrow-viewport ceiling the `menu`'s max-inline-size is `min()`ed
 against, alongside its own `20rem` cap and the positioner's available space. See `lr-tour` for the
 shared-clamp note.

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

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 12 parts, 14 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 12 parts, 15 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`
 
 ---
@@ -35,8 +35,9 @@ owns none of that.
 - `statusDetail: string = ''` (attribute `status-detail`) — appended to the status line
 - `durationMs: number | null = null` (attribute `duration-ms`) — formatted into the status line
 - `selected: boolean = false` (reflected)
-- `compact: boolean = false` (reflected) — tighter card padding for dense canvases and palette
-  previews; the border, background, shadow and the `selected`/`status="running"` treatments all stay
+- `compact: boolean = false` (reflected) — tighter card padding, row gap, and header icon-to-heading
+  gap for dense canvases and palette previews; the border, background, shadow and the
+  `selected`/`status="running"` treatments all stay
 - `inputs: readonly FlowHandle[] = [{ id: 'in' }]`, `outputs: readonly FlowHandle[] = [{ id: 'out'
 }]` (attribute: false) — detached, frozen snapshots of at most the first 10,000 readonly
   `{ id, label? }` handles; blank ids and later duplicates are omitted first-valid/first-wins
@@ -58,7 +59,9 @@ carries no card chrome of its own), `card` (the bordered, filled node card), `he
 
 **Themeable custom properties:** `--lr-flow-node-min-inline-size` (default `11rem`),
 `--lr-flow-node-compact-padding` (default `var(--lr-space-xs)`) and `--lr-flow-node-compact-gap`
-(default `var(--lr-space-2xs)`) — `[part="card"]`'s padding and row gap while `compact` — and
+(default `var(--lr-space-2xs)`) — `[part="card"]`'s padding and row gap while `compact`;
+`--lr-flow-node-compact-header-gap` (default `var(--lr-space-2xs)`) — `[part="header"]`'s own
+icon-to-heading gap while `compact` — and
 `--lr-flow-node-selected-outline-color` (default `var(--lr-color-brand)`) — the card's outline color
 while `selected`. Like the other state-scoped custom properties here, it is an inline `var()`
 fallback at its point of use rather than a `:host` declaration, so it can be set on the element _or any

package/llms/components/lr-funnel.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 14 parts, 4 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 15 parts, 4 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`
 
 ---
@@ -56,13 +56,18 @@ interface LyraFunnelStage {
 }
 ```
 
+At most 500 valid stages render, each as its own bar row; a `stages` array past that length renders
+a localized `limit` notice after the list rather than mounting an unbounded number of bars. Every
+stage's share is still measured against the true first stage regardless of truncation.
+
 **Events:** none.
 
 **Slots:** none.
 
 **CSS parts:** `base`, `stages` (the `<ol>`), `stage`, `dropoff`, `stage-header`, `stage-label`,
 `stage-value`, `stage-share`, `comparison-value`, `track`, `bar`, `bar-overflow` (a second token on
-`bar` when the stage exceeds the first stage), `comparison-bar`, `empty`
+`bar` when the stage exceeds the first stage), `comparison-bar`, `empty`, `limit` (localized notice
+shown when `stages` exceeds the 500-stage render ceiling)
 
 **Themeable custom properties:** `--lr-funnel-bar-color` (default `var(--lr-color-brand)`),
 `--lr-funnel-comparison-color` (default `var(--lr-color-border-strong)`), `--lr-funnel-track-color`

package/llms/components/lr-gauge.md

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 5 parts, 1 custom property — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 5 parts, 6 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`
 
 ---
@@ -69,7 +69,12 @@ true), `label` (rendered only while `label` is non-empty)
 
 **Themeable custom properties:** `--lr-gauge-fill` (fill stroke; overrides `variant`/`thresholds`
 entirely and falls back to the effective variant's shared semantic token —
-`--lr-color-brand` by default).
+`--lr-color-brand` by default). Each variant also has its own scoped fill, read as the innermost
+fallback before the shared token so a consumer can retint one variant without `--lr-gauge-fill`'s
+uniform override touching the others: `--lr-gauge-neutral-fill` (default `var(--lr-color-neutral)`),
+`--lr-gauge-brand-fill` (default `var(--lr-color-brand)`), `--lr-gauge-success-fill` (default
+`var(--lr-color-success)`), `--lr-gauge-warning-fill` (default `var(--lr-color-warning)`), and
+`--lr-gauge-danger-fill` (default `var(--lr-color-danger)`).
 
 **Optional peer deps:** none.
 

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

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** `maplibre-gl` — see `llms/peers.md`
-- **Themeable via** 7 parts, 0 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 7 parts, 1 custom property — see this component's own `@csspart`/`@cssprop` list below
 - **Documented with** `lr-geojson-viewer` (same section below)
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
 
@@ -41,7 +41,11 @@ unbroken values from widening a 320px allocation.
 
 **Properties:** `src: string = ''` — URL to fetch and parse. `name: string = ''` — accessible label,
 used as `<lr-map>`'s `label` and the root's `aria-label` (falling back to the localized
-`geojsonViewLabel` when unset). A host `aria-label` takes precedence over `name`. The shared
+`geojsonViewLabel` when unset). A host `aria-label` takes precedence over `name`.
+`maxHeight: string = ''` (attribute `max-height`) is a CSS length that caps `[part="base"]` —
+covering the loaded map, the serialized metadata, and the missing-peer fallback alike — by writing
+`--lr-geojson-viewer-max-height` inline on it; invalid CSS `max-height` values, declaration breaks,
+and `url()` are ignored. The shared
 text-viewer contract adds `highlights`, `activeHighlightId`, `anchor`, and
 `anchorKinds` (`['text-quote', 'fragment']`), plus `search()`, `searchNext()`, `searchPrevious()`,
 `clearSearch()`, and `scrollToAnchor()` for the ordinary-DOM serialized feature metadata and status
@@ -83,6 +87,10 @@ body text: `error` is `--lr-color-danger` (matching `lr-docx-viewer`/`lr-email-v
 but working state, since the `lr-json-viewer` fallback below it still renders the data, not a failure
 -- and `status` is the quiet `--lr-color-text-quiet` metadata tone.
 
+**Themeable custom properties:** `--lr-geojson-viewer-max-height` (default `none`) — maximum block
+size of `[part="base"]`, matching every other viewer in this family. It is also settable via the
+`maxHeight` property, which writes this token inline on `[part="base"]`.
+
 The canonical tag is registered by importing `geojson-viewer/geojson-viewer.js`; the permanent
 compatibility tag and old deep route remain available through `geojson-view/geojson-view.js`.
 Remote

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

@@ -9,7 +9,7 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** `maplibre-gl` — see `llms/peers.md`
-- **Themeable via** 7 parts, 0 custom properties — see this component's own `@csspart`/`@cssprop` list below
+- **Themeable via** 7 parts, 1 custom property — see this component's own `@csspart`/`@cssprop` list below
 - **Documented with** `lr-geojson-view` (same section below)
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
 
@@ -41,7 +41,11 @@ unbroken values from widening a 320px allocation.
 
 **Properties:** `src: string = ''` — URL to fetch and parse. `name: string = ''` — accessible label,
 used as `<lr-map>`'s `label` and the root's `aria-label` (falling back to the localized
-`geojsonViewLabel` when unset). A host `aria-label` takes precedence over `name`. The shared
+`geojsonViewLabel` when unset). A host `aria-label` takes precedence over `name`.
+`maxHeight: string = ''` (attribute `max-height`) is a CSS length that caps `[part="base"]` —
+covering the loaded map, the serialized metadata, and the missing-peer fallback alike — by writing
+`--lr-geojson-viewer-max-height` inline on it; invalid CSS `max-height` values, declaration breaks,
+and `url()` are ignored. The shared
 text-viewer contract adds `highlights`, `activeHighlightId`, `anchor`, and
 `anchorKinds` (`['text-quote', 'fragment']`), plus `search()`, `searchNext()`, `searchPrevious()`,
 `clearSearch()`, and `scrollToAnchor()` for the ordinary-DOM serialized feature metadata and status
@@ -83,6 +87,10 @@ body text: `error` is `--lr-color-danger` (matching `lr-docx-viewer`/`lr-email-v
 but working state, since the `lr-json-viewer` fallback below it still renders the data, not a failure
 -- and `status` is the quiet `--lr-color-text-quiet` metadata tone.
 
+**Themeable custom properties:** `--lr-geojson-viewer-max-height` (default `none`) — maximum block
+size of `[part="base"]`, matching every other viewer in this family. It is also settable via the
+`maxHeight` property, which writes this token inline on `[part="base"]`.
+
 The canonical tag is registered by importing `geojson-viewer/geojson-viewer.js`; the permanent
 compatibility tag and old deep route remain available through `geojson-view/geojson-view.js`.
 Remote

package/llms/components/lr-graph-legend.md

@@ -7,7 +7,7 @@
 - **Family** `components/retrieval/` — 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: [llms-full.txt](../../llms-full.txt)
-- **Deprecations** none
+- **Deprecated event** `lr-before-visibility-change` since `19.0.1`; use event `addEventListener('lr-visibility-change-request', ...)`; removal not before `21.0.0` — Renamed to the library's dominant *-request veto-event convention; both names fire from the same gesture with an identical detail during the compatibility window, and either may veto.
 - **Optional peers** none
 - **Themeable via** 6 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`
@@ -37,10 +37,13 @@ string; shape?: 'circle' | 'square' | 'diamond' }`, the shared `lr-graph.nodeTyp
   `aria-label` makes the host the sole overall owner (the wrapper omits its duplicate role/name);
   an explicitly empty host label stays empty on the wrapper
 
-**Events:** cancelable `lr-before-visibility-change` (`detail: { hiddenTypes }`, a frozen complete
+**Events:** cancelable `lr-visibility-change-request` (`detail: { hiddenTypes }`, a frozen complete
 next array) fires before a toggle changes state or announces it. Preventing it suppresses all three.
 `lr-visibility-change` (`detail: { hiddenTypes }`, the complete updated array) fires after an
-accepted assignment and announcement.
+accepted assignment and announcement. `lr-before-visibility-change` is a **deprecated** alias of
+`lr-visibility-change-request`, fired immediately after it from the same gesture with the same
+frozen detail; either event may veto. It is slated for removal in 21.0.0 — migrate listeners to
+`lr-visibility-change-request`.
 
 **Slots:** none.