@aceshooting/lyra-ui 21.0.0 → 21.1.0

package/llms/components/lr-app-rail.md

@@ -124,9 +124,10 @@ letting a consumer that syncs app chrome to the rail's mode pick up the restored
   the host's re-render has applied. That second pass only acts while focus is still inside the rail
   or has fallen to `<body>` — focus moved elsewhere in the meantime is never taken back — and
   focuses the first candidate that can actually hold focus: the trigger, then the element that held
-  focus when the overlay opened, then the built-in `[part='toggle']` (unavailable under
-  `hideToggle`), and finally the rail host; when even the host cannot take focus (hidden, or inert —
-  under an inert ancestor or behind a stacked modal), focus is left where it is. The host
+  focus when the overlay opened (none when focus was on `<body>`), then the built-in
+  `[part='toggle']` (unavailable under `hideToggle`), then the rail host, and finally
+  `focusFallback` when set; when none of them can take focus (the host hidden, or inert — under an
+  inert ancestor or behind a stacked modal), focus is left where it is. The host
   temporarily receives `tabindex="-1"` only when it has no authored tabindex; the temporary
   attribute is removed once focus moves off the host or the rail disconnects, while a blur caused
   only by the window or tab losing system focus (the host stays the focused element) leaves it in
@@ -139,7 +140,8 @@ letting a consumer that syncs app chrome to the rail's mode pick up the restored
   `null`), no external element is a return candidate: a close still returns focus to the built-in
   toggle when its own click opened the overlay, otherwise to the element that held focus at open,
   and the deferred pass still runs over its remaining candidates (that element, the built-in toggle,
-  then the rail host) — only the trigger candidate depends on the association. The resolved trigger
+  the rail host, then `focusFallback`) — only the trigger candidate depends on the association. The
+  resolved trigger
   also receives `aria-expanded` (rendered in both states) and `aria-controls` pointing at the rail's
   own panel, so an external control announces the overlay's state across the shadow boundary.
   Because a light-DOM element cannot hold a raw reference into another element's shadow tree,
@@ -151,6 +153,29 @@ letting a consumer that syncs app chrome to the rail's mode pick up the restored
   label/`htmlFor`-style alternative to assigning `trigger` directly (mirrors `<lr-page-rail>`'s
   `for`). Resolved against this element's own root (shadow root or document) when the overlay opens
   and again when it closes. Ignored once `trigger` is itself set.
+- `focusFallback: HTMLElement | string | null = null` (attribute `focus-fallback`) — opt-in
+  last-resort target for the mobile overlay's deferred focus return, tried only after every built-in
+  target (the `trigger`/`for` association, the element that held focus at open, `[part='toggle']`,
+  the rail host) is unavailable — typically the application's main region, for a host that takes the
+  navigation, or the region around it, out of the layout as the overlay closes. Accepts an element or
+  an id, the same element-or-id shape as `<lr-intersection-observer>`'s `root`; an id (the attribute
+  always holds one — an id, not a selector) is resolved like `for`, against the rail's own root
+  (shadow root or document), and `''` means unset. Resolved when the deferred pass runs, so
+  reassigning it after opening, or re-creating the element under the same id before the pass runs,
+  is honored; property and attribute writes set the same value and the last write wins. It never
+  outranks a target that can take focus, so it changes no close that already lands, and it is not
+  used by the synchronous attempt, by a close caused by leaving `'mobile'` (a breakpoint or
+  `forceMode` change), or in the full/icon-only presentations. A target that is missing,
+  disconnected, in another document, hidden, inert or under an inert ancestor, `aria-hidden`,
+  disabled, or not focusable leaves focus where it is, and so does anything inside this rail
+  (unavailable whenever the rail host is). The target needs `tabindex="-1"` (or another way to take
+  focus): unlike the host, the rail never adds a tabindex to it. Unset (`null`) reproduces the
+  existing behavior exactly.
+
+  ```html
+  <main id="content" tabindex="-1">…</main>
+  <lr-app-rail hide-toggle for="menu-button" focus-fallback="content">…</lr-app-rail>
+  ```
 - `resizable: boolean = false` (reflected) — opts a continuously draggable width in for the `'full'`
   state, exposing a `[part='resizer']` handle clamped to `[minRailWidthPx, maxRailWidthPx]`. `false`
   (the default) renders no resizer and leaves the fixed-width `--lr-app-rail-width` CSS token

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

@@ -9,91 +9,6 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** `chart.js`, `chartjs-plugin-annotation`, `chartjs-plugin-datalabels`, `chartjs-plugin-zoom` — see `llms/peers.md`
-- **Themeable via** 16 parts, 37 custom properties — see this component's own `@csspart`/`@cssprop` list below
-- **Documented with** `lr-line-chart`, `lr-pie-chart`, `lr-doughnut-chart`, `lr-radar-chart`, `lr-polar-area-chart`, `lr-bubble-chart`, `lr-scatter-chart` (same section below)
+- **Themeable via** 16 parts, 37 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`
-
----
-
-## Typed subclasses: `lr-line-chart`, `lr-bar-chart`, `lr-pie-chart`, `lr-doughnut-chart`, `lr-radar-chart`, `lr-polar-area-chart`, `lr-bubble-chart`, `lr-scatter-chart`
-
-Each is `LyraChart` with a named default `type` — respectively `line`, `bar`, `pie`, `doughnut`,
-`radar`, `polarArea`, `bubble`, `scatter`. In parity with the mirrored tags, `type` remains writable
-and accepts the full `LyraChartType` vocabulary; the tag name is a convenient default, not a lock.
-
-Everything else is inherited verbatim from `lr-chart`; each name below has the same type, default,
-and behavior there. **See `llms/components/lr-chart.md` for the details, code example, and gotchas
-of every entry in these lists.**
-
-**Properties:** `description`, `grid`, `axes`, `compact`, `indexAxis` (`index-axis`), `label`, `hiddenDatasets`, `legendPosition`
-(`legend-position`), `hiddenDatums`, `legendMode` (`legend-mode`), `legendDisplay` (`legend-display`),
-`max`, `min`, `plugins`, `scaleType` (`scale-type`), `annotations`,
-`stacked`, `stackedAxes`, `withoutAnimation` (`without-animation`),
-`withoutLegend` (`without-legend`), `withoutTooltip` (`without-tooltip`), `xLabel` (`x-label`),
-`yLabel` (`y-label`), plus additive `labels`, `datasets`, `valueFormatter`, `formatter`,
-`tooltipTitleFormatter`, `tooltipFooterFormatter`, `area`, `zoom`,
-`height`, `y2Label` (`y2-label`), `beginAtZero` (`begin-at-zero`), `dataLabels`
-(`data-labels`), `stackTotals` (`stack-totals`), `config`, `showDataTable`
-(`show-data-table`), `dataTableToggle` (`data-table-toggle`), `chartArea` (readonly), and `chart`.
-`type` differs only in its initial value.
-
-**Methods:** `appendData(label, values, maxPoints?)`, `exportData('csv' | 'png')`, `renderChart()`, `resetZoom()`,
-`refreshTheme()`.
-
-**Events:** `lr-zoom` (`detail: { zoomed: boolean }`), `lr-datum-activate`, `lr-point-click` (`detail: { datasetIndex,
-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). `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`.
-
-**CSS parts:** `base`, `plot`, `canvas`, `legend`, `legend-item`, `legend-item-hidden`, `legend-swatch`,
-`reset-zoom-button`, `description`, `notices`, `data-table`, `data-table-toggle`, `data-truncation`, `feature-warning`, `center`, `error` (neutral visible message
-rendered in place of `canvas` when the optional `chart.js` peer dependency fails to load; the
-failure transition is announced through the shared document-level light-DOM assertive sink — see
-`llms/components/lr-chart.md`).
-
-**Themeable custom properties:** `--lr-chart-height`, `--lr-chart-grid-color`,
-`--lr-chart-tick-color`, `--lr-chart-tick-font-size`, `--lr-chart-legend-color`, `--lr-chart-tooltip-bg`,
-`--lr-chart-tooltip-text`, `--lr-chart-legend-item-hover-bg`,
-`--lr-chart-legend-item-active-bg`, `--lr-chart-data-table-button-hover-bg`,
-`--lr-chart-data-table-button-active-bg`, `--lr-chart-data-table-toggle-hover-bg`,
-`--lr-chart-data-table-toggle-active-bg`, `--lr-chart-reset-zoom-button-hover-bg`,
-`--lr-chart-reset-zoom-button-active-bg`, `--lr-chart-canvas-hover-outline-width`, and
-`--lr-chart-canvas-hover-outline-color`, `--lr-chart-pattern-step`, plus `--lr-chart-legend-side-max` — all inherited from `LyraChart`, identical in meaning and default (see
-`lr-chart` above); each of the eight variants below reads the same set, so one rule retunes them
-together. The mirrored hooks are `--border-color-1`,
-`--border-color-2`, `--border-color-3`, `--border-color-4`, `--border-color-5`,
-`--border-color-6`, `--fill-color-1`, `--fill-color-2`, `--fill-color-3`, `--fill-color-4`,
-`--fill-color-5`, `--fill-color-6`, `--border-radius`, `--border-width`, `--grid-border-width`,
-`--grid-color`, `--line-border-width`, and `--point-radius`, also identical to the core chart.
-
-**Optional peer deps:** same as `lr-chart` — `chart.js`, plus `chartjs-plugin-zoom` only once
-`zoom` is set, `chartjs-plugin-datalabels` only once `data-labels`/`stack-totals` is set, and
-`chartjs-plugin-annotation` only once `annotations` contains a usable entry.
-
-```html
-<lr-bar-chart></lr-bar-chart>
-<lr-pie-chart></lr-pie-chart>
-<script>
-  document.querySelector('lr-bar-chart').labels = ['A', 'B'];
-  document.querySelector('lr-bar-chart').datasets = [{ label: 'Count', data: [4, 9] }];
-
-  document.querySelector('lr-pie-chart').labels = ['A', 'B', 'C'];
-  document.querySelector('lr-pie-chart').datasets = [{ label: 'Share', data: [30, 45, 25], color: ['#2563eb', '#16a34a', '#dc2626'] }];
-</script>
-```
-
-**Known gotchas (in addition to the core `lr-chart` list in `llms/components/lr-chart.md`):**
-- Changing `type` after construction may rebuild the underlying Chart.js instance; any active zoom
-  state is reset and announced before the new type renders.
-- `lr-bubble-chart` consumes the exported `LyraChartPoint` shape directly. Set `x`/`y`, optional `r`
-  for bubble radius, and optional `label` for the point-level accessible/event/export label; no
-  runtime cast is needed.
-
----

package/llms/components/lr-box-plot.md

@@ -121,7 +121,7 @@ bounded-alternative sampling notice)
 `--lr-chart-tooltip-text` — same public host-level precedence, token names, and defaults as `lr-chart`
 (also `getComputedStyle`-resolved and CSS-color-validated on every draw; invalid expressions use
 concrete semantic fallbacks rather than retaining a prior canvas paint), but declared in its own stylesheet, not a
-re-export: `lr-box-plot` has no `zoom`, so no `reset-zoom-button` chrome exists here. A `BoxPlotSeries`
+re-export: `lr-box-plot` has no `zoom`, so no `reset-zoom-button` chrome exists here. A `LyraBoxPlotSeries`
 that sets no `color` is assigned an entry from the same `--lr-color-chart-1..8` ramp `lr-chart` uses,
 so `--lr-theme-color-chart-*` retheming reaches box plots too. That resolved color then layers two
 further per-series override tokens for the canvas paint, each wrapping modulo 8 like the underlying

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

@@ -9,71 +9,6 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** none
-- **Themeable via** 7 parts, 2 custom properties — see this component's own `@csspart`/`@cssprop` list below
-- **Documented with** `lr-breadcrumb` (same section below)
+- **Themeable via** 7 parts, 2 custom properties — see `lr-breadcrumb.md`
+- **Documented with** `lr-breadcrumb`: see [lr-breadcrumb.md](./lr-breadcrumb.md).
 - **Library-wide behavior** (events, form association, `locale`/`strings`, tokens, TS types): `llms/shared.md`
-
----
-
-## `lr-breadcrumb` and `lr-breadcrumb-item`
-
-Responsive navigation trail primitives.
-
-**`lr-breadcrumb` properties:** `label?: string` names the trail; omitting it reads back `undefined`
-and falls back to the localized `"Breadcrumb"`, while an explicitly empty string stays empty.
-`accessibleLabel?: string` (attribute **`aria-label`**) overrides both, with the same
-omitted-versus-explicitly-empty distinction. The
-shadow-root `<nav>` landmark never inherits a host attribute on its own, so the value is copied onto
-it. **Fixed in 9.0.0:** the property used to be declared but never read — only the literal host
-`aria-label` attribute reached the landmark, so `el.accessibleLabel = 'Docs trail'` type-checked and
-did nothing. Both spellings now work, with an authored host attribute still winning (including an
-explicitly empty `aria-label=""`, which stays empty rather than falling back).
-
-**`lr-breadcrumb-item` properties:** `href: string = ''` (URL-sanitized; an unsafe scheme renders the
-non-link form; assigning `undefined` clears it and reads back as the canonical `''`),
-`target?: LyraBreadcrumbItemTarget`, and `current: boolean = false` (reflected — renders a
-`<span aria-current="page">` instead of an `<a>`, even when `href` is set). A target derives
-the mandatory `noopener noreferrer` floor. `rel: string = 'noreferrer noopener'` is independently
-settable: author tokens are preserved, `opener` is stripped, and any target force-adds the floor. Each item
-sets `role="listitem"` on itself. A non-current item without `href` renders a native button. A host
-`aria-label` is forwarded to either non-current native owner by attribute presence, including an
-explicitly empty value; when absent, the default slot supplies its name.
-
-**`lr-breadcrumb-item` methods:** `click(): void` activates the internal native link or button. It
-is a no-op for the current-page label.
-
-Changing `href` or `current` while that native owner has focus transfers focus across the link,
-button, and programmatically focusable current-page label. External focus is preserved.
-
-**Slots:** breadcrumb's default slot takes `lr-breadcrumb-item` children and its `separator` slot is
-copied to every item without an item-level override. Both breadcrumb and item `separator` slots are
-decorative-only: their rendered content is inert and hidden from assistive technology, so it must not
-provide interactive behavior, a focus target, or form state. Generated shared copies omit identifiers,
-ID-reference relationships, form associations, and submission attributes. Source text, attributes,
-and compatible subtrees update live; identity-compatible clone nodes are patched in place instead of
-being disconnected and recreated. The first owned breadcrumb item is determined independently of
-separator sources or other auxiliary siblings, so it never renders a leading separator. An item's default slot is
-its label; `start`/`prefix` and `end`/`suffix` are the two upstream adornment vocabularies, and
-`separator` overrides the `/` fallback.
-
-**CSS parts:** breadcrumb `base` and `breadcrumb` are aliases on the same `<nav>`; `list` is the
-`role="list"` flex row wrapping the slotted items; item `base` (the `<a>`, `<button>`, or current
-`<span>`), `label`,
-`separator`, and the alias pairs `start`/`prefix` and `end`/`suffix`.
-Interactive link/button bases retain a 24px minimum target in both axes even with empty content;
-the inert current-page label remains content-sized.
-
-**Themeable custom properties:** `--lr-breadcrumb-current-color` (default
-`var(--lr-color-text-quiet)`) — text color of the current-page item (`current`/`aria-current="page"`).
-It is an inline `var()` fallback at the point of use rather than a `:host` declaration, so it can be
-set on the item, on `<lr-breadcrumb>`, or on any ancestor above the trail:
-`::part(base)[aria-current='page']` is invalid CSS (Shadow Parts forbids an attribute selector after
-`::part()`), so tinting the current item previously meant overriding the library-wide
-`--lr-color-text-quiet` token and repainting everything else that read it. Unset, it falls back to
-that token.
-`--lr-breadcrumb-item-active-bg` independently themes a non-current link/button's pressed fill;
-unset, it retains the former transparent active mix.
-
-**Additional API surface:**
-
-- `part="separator"` — Decorative separator shown before non-first items.

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

@@ -9,91 +9,6 @@
 - **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [llms-full.txt](../../llms-full.txt)
 - **Deprecations** none
 - **Optional peers** `chart.js`, `chartjs-plugin-annotation`, `chartjs-plugin-datalabels`, `chartjs-plugin-zoom` — see `llms/peers.md`
-- **Themeable via** 16 parts, 37 custom properties — see this component's own `@csspart`/`@cssprop` list below
-- **Documented with** `lr-line-chart`, `lr-bar-chart`, `lr-pie-chart`, `lr-doughnut-chart`, `lr-radar-chart`, `lr-polar-area-chart`, `lr-scatter-chart` (same section below)
+- **Themeable via** 16 parts, 37 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`
-
----
-
-## Typed subclasses: `lr-line-chart`, `lr-bar-chart`, `lr-pie-chart`, `lr-doughnut-chart`, `lr-radar-chart`, `lr-polar-area-chart`, `lr-bubble-chart`, `lr-scatter-chart`
-
-Each is `LyraChart` with a named default `type` — respectively `line`, `bar`, `pie`, `doughnut`,
-`radar`, `polarArea`, `bubble`, `scatter`. In parity with the mirrored tags, `type` remains writable
-and accepts the full `LyraChartType` vocabulary; the tag name is a convenient default, not a lock.
-
-Everything else is inherited verbatim from `lr-chart`; each name below has the same type, default,
-and behavior there. **See `llms/components/lr-chart.md` for the details, code example, and gotchas
-of every entry in these lists.**
-
-**Properties:** `description`, `grid`, `axes`, `compact`, `indexAxis` (`index-axis`), `label`, `hiddenDatasets`, `legendPosition`
-(`legend-position`), `hiddenDatums`, `legendMode` (`legend-mode`), `legendDisplay` (`legend-display`),
-`max`, `min`, `plugins`, `scaleType` (`scale-type`), `annotations`,
-`stacked`, `stackedAxes`, `withoutAnimation` (`without-animation`),
-`withoutLegend` (`without-legend`), `withoutTooltip` (`without-tooltip`), `xLabel` (`x-label`),
-`yLabel` (`y-label`), plus additive `labels`, `datasets`, `valueFormatter`, `formatter`,
-`tooltipTitleFormatter`, `tooltipFooterFormatter`, `area`, `zoom`,
-`height`, `y2Label` (`y2-label`), `beginAtZero` (`begin-at-zero`), `dataLabels`
-(`data-labels`), `stackTotals` (`stack-totals`), `config`, `showDataTable`
-(`show-data-table`), `dataTableToggle` (`data-table-toggle`), `chartArea` (readonly), and `chart`.
-`type` differs only in its initial value.
-
-**Methods:** `appendData(label, values, maxPoints?)`, `exportData('csv' | 'png')`, `renderChart()`, `resetZoom()`,
-`refreshTheme()`.
-
-**Events:** `lr-zoom` (`detail: { zoomed: boolean }`), `lr-datum-activate`, `lr-point-click` (`detail: { datasetIndex,
-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). `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`.
-
-**CSS parts:** `base`, `plot`, `canvas`, `legend`, `legend-item`, `legend-item-hidden`, `legend-swatch`,
-`reset-zoom-button`, `description`, `notices`, `data-table`, `data-table-toggle`, `data-truncation`, `feature-warning`, `center`, `error` (neutral visible message
-rendered in place of `canvas` when the optional `chart.js` peer dependency fails to load; the
-failure transition is announced through the shared document-level light-DOM assertive sink — see
-`llms/components/lr-chart.md`).
-
-**Themeable custom properties:** `--lr-chart-height`, `--lr-chart-grid-color`,
-`--lr-chart-tick-color`, `--lr-chart-tick-font-size`, `--lr-chart-legend-color`, `--lr-chart-tooltip-bg`,
-`--lr-chart-tooltip-text`, `--lr-chart-legend-item-hover-bg`,
-`--lr-chart-legend-item-active-bg`, `--lr-chart-data-table-button-hover-bg`,
-`--lr-chart-data-table-button-active-bg`, `--lr-chart-data-table-toggle-hover-bg`,
-`--lr-chart-data-table-toggle-active-bg`, `--lr-chart-reset-zoom-button-hover-bg`,
-`--lr-chart-reset-zoom-button-active-bg`, `--lr-chart-canvas-hover-outline-width`, and
-`--lr-chart-canvas-hover-outline-color`, `--lr-chart-pattern-step`, plus `--lr-chart-legend-side-max` — all inherited from `LyraChart`, identical in meaning and default (see
-`lr-chart` above); each of the eight variants below reads the same set, so one rule retunes them
-together. The mirrored hooks are `--border-color-1`,
-`--border-color-2`, `--border-color-3`, `--border-color-4`, `--border-color-5`,
-`--border-color-6`, `--fill-color-1`, `--fill-color-2`, `--fill-color-3`, `--fill-color-4`,
-`--fill-color-5`, `--fill-color-6`, `--border-radius`, `--border-width`, `--grid-border-width`,
-`--grid-color`, `--line-border-width`, and `--point-radius`, also identical to the core chart.
-
-**Optional peer deps:** same as `lr-chart` — `chart.js`, plus `chartjs-plugin-zoom` only once
-`zoom` is set, `chartjs-plugin-datalabels` only once `data-labels`/`stack-totals` is set, and
-`chartjs-plugin-annotation` only once `annotations` contains a usable entry.
-
-```html
-<lr-bar-chart></lr-bar-chart>
-<lr-pie-chart></lr-pie-chart>
-<script>
-  document.querySelector('lr-bar-chart').labels = ['A', 'B'];
-  document.querySelector('lr-bar-chart').datasets = [{ label: 'Count', data: [4, 9] }];
-
-  document.querySelector('lr-pie-chart').labels = ['A', 'B', 'C'];
-  document.querySelector('lr-pie-chart').datasets = [{ label: 'Share', data: [30, 45, 25], color: ['#2563eb', '#16a34a', '#dc2626'] }];
-</script>
-```
-
-**Known gotchas (in addition to the core `lr-chart` list in `llms/components/lr-chart.md`):**
-- Changing `type` after construction may rebuild the underlying Chart.js instance; any active zoom
-  state is reset and announced before the new type renders.
-- `lr-bubble-chart` consumes the exported `LyraChartPoint` shape directly. Set `x`/`y`, optional `r`
-  for bubble radius, and optional `label` for the point-level accessible/event/export label; no
-  runtime cast is needed.
-
----

package/llms/components/lr-button.md

@@ -204,6 +204,13 @@ plus Shoelace aliases `prefix` → `start` and `suffix` → `end`.
 In a constrained button the default label ellipsizes and each adornment wrapper is capped at 40%
 of the control. Fixed icons remain visible while unbroken labels or metadata cannot widen the row.
 
+A detected icon-only label (the `icon-button` state) has no text to ellipsize, so it does not clip
+paint. A glow drawn around the glyph extends past the label box instead of being cut to a square,
+for example `gemstoneSelectedGlyphStyles`' drop-shadow halo on a `data-lr-gemstone-selected`
+wrapper. A text label keeps the truncation clip, even beside a glowing glyph. The `start`/`end`
+wrappers always clip, so put a glowing glyph in the default slot on its own. Hit area, focus ring,
+and label box are unchanged.
+
 **CSS parts:** `base` (compatibility name for the internal control; use `button`),
 `button` (the internal native `<button>`, or an `<a>` when `href` resolves to a safe link; it is
 the same node as `base`), `label`, `start`/`prefix` (the same wrapper), `end`/`suffix` (the same

package/llms/components/lr-chart.md

@@ -187,11 +187,10 @@ structured points retain their y-value formatting.
   axes, `'r'` for a radar/polar-area ring, and `undefined` where there is no axis at all (a
   pie/doughnut slice). Two value axes usually exist precisely because they carry different units,
   so without it one formatter cannot render a secondary axis correctly. `datasetIndex`, `index`,
-  `label` and `seriesLabel` now reach the `tick`, `tooltip`, `legend` and `visual` surfaces as well
-  as the `table`, `export` and `spoken` ones they always reached, and indexes are reported in
-  source space — the same space the data table, the CSV export and `lr-point-click` use. Every one
-  of these fields was `undefined` before, so no existing formatter changes behaviour. A
-  `stackTotals`/`tableTotals` stack total is the exception in the other direction: it is a sum
+  `label` and `seriesLabel` reach the `tooltip`, `legend`, `visual`, `table`, `export` and `spoken`
+  surfaces, with indexes in source space — the same space the data table, the CSV export and
+  `lr-point-click` use. A `tick` call carries `axis` but none of those four. A
+  `stackTotals`/`tableTotals` stack total is also an exception: it is a sum
   *across* the stack's datasets, so it carries `statistic: 'total'`, the category `index`/`label`
   and the stack's own `axis`, but no `datasetIndex` and no `seriesLabel` — naming the topmost
   series would make a unit-switching formatter render that one series' unit for a cross-series