@aceshooting/lyra-ui 26.0.0 → 27.0.0

package/dist/testing/happy-dom-shims.js

@@ -1 +1 @@
-function createStubInternals(host){return{get form(){return host.closest("form")},labels:document.createDocumentFragment().querySelectorAll("label"),states:new Set,validity:{valid:!0},validationMessage:"",willValidate:!0,setFormValue(){},checkValidity(){return!0},reportValidity(){return!0},setValidity(){}}}function installHappyDomFormAssociatedShims(){typeof HTMLElement>"u"||typeof HTMLElement.prototype.attachInternals!="function"&&(HTMLElement.prototype.attachInternals=function(){return createStubInternals(this)})}function installStubInternalsForTest(host){return createStubInternals(host)}export{installHappyDomFormAssociatedShims,installStubInternalsForTest};
+function createStubInternals(host){return{get form(){return host.closest("form")},labels:document.createDocumentFragment().querySelectorAll("label"),states:new Set,validity:{valid:!0},validationMessage:"",willValidate:!0,setFormValue(){},checkValidity(){return!0},reportValidity(){return!0},setValidity(){}}}function installHappyDomFormAssociatedShims(){typeof HTMLElement>"u"||typeof HTMLElement.prototype.attachInternals!="function"&&(HTMLElement.prototype.attachInternals=function(){return createStubInternals(this)})}function siblingActiveElementThrows(){const body=document.body;if(!body)return!1;const previous=document.activeElement,hosts=[document.createElement("div"),document.createElement("div")],roots=hosts.map(host=>host.attachShadow({mode:"open"})),button=document.createElement("button");roots[0]?.appendChild(button),hosts.forEach(host=>body.appendChild(host));try{return button.focus(),roots[1].activeElement,!1}catch{return!0}finally{button.blur(),hosts.forEach(host=>host.remove()),previous instanceof HTMLElement&&previous.focus()}}function detachedActiveElementThrows(){const root=document.createElement("div").attachShadow({mode:"open"});try{return root.activeElement,!1}catch{return!0}}function guardShadowActiveElement(proto,misbehaves){const descriptor=Object.getOwnPropertyDescriptor(proto,"activeElement"),native=descriptor?.get;if(!(!descriptor||!native||!misbehaves()))return Object.defineProperty(proto,"activeElement",{...descriptor,get(){try{return native.call(this)}catch(error){if(error instanceof TypeError)return null;throw error}}}),()=>Object.defineProperty(proto,"activeElement",descriptor)}function installHappyDomShadowFocusShim(){return typeof ShadowRoot>"u"||typeof document>"u"?()=>{}:guardShadowActiveElement(ShadowRoot.prototype,()=>siblingActiveElementThrows()||detachedActiveElementThrows())??(()=>{})}function isInScope(source,target){const targetRoot=target.getRootNode();let root=source.getRootNode();for(;root;){if(root===targetRoot)return!0;root="host"in root?root.host.getRootNode():null}return!1}function createAriaControlsElementsDescriptor(){const explicit=new WeakMap;return{configurable:!0,enumerable:!0,get(){const attr=this.getAttribute("aria-controls");if(attr===null)return null;const stored=explicit.get(this);if(stored&&stored.attr===attr)return stored.elements.filter(element=>isInScope(this,element));const root=this.getRootNode();return attr.split(/\s+/).filter(Boolean).map(id=>root.getElementById?.(id)??null).filter(element=>element!==null)},set(value){if(value==null){explicit.delete(this),this.removeAttribute("aria-controls");return}this.setAttribute("aria-controls",""),explicit.set(this,{elements:Array.from(value),attr:""})}}}function installHappyDomAriaControlsShim(proto=globalThis.Element?.prototype){!proto||"ariaControlsElements"in proto||Object.defineProperty(proto,"ariaControlsElements",createAriaControlsElementsDescriptor())}function installHappyDomShims(){installHappyDomFormAssociatedShims(),installHappyDomShadowFocusShim(),installHappyDomAriaControlsShim()}function installStubInternalsForTest(host){return createStubInternals(host)}export{createAriaControlsElementsDescriptor,guardShadowActiveElement,installHappyDomAriaControlsShim,installHappyDomFormAssociatedShims,installHappyDomShadowFocusShim,installHappyDomShims,installStubInternalsForTest};

package/dist/testing/index.d.ts

@@ -1 +1 @@
-export*from'./happy-dom-shims.js';export*from'./event-factory.js';export*from'./interaction-drivers.js';export*from'./wait-for-mount.js';
+export{installHappyDomAriaControlsShim,installHappyDomFormAssociatedShims,installHappyDomShadowFocusShim,installHappyDomShims,installStubInternalsForTest,}from'./happy-dom-shims.js';export*from'./event-factory.js';export*from'./interaction-drivers.js';export*from'./wait-for-mount.js';

package/dist/testing/index.js

@@ -1 +1 @@
-export*from"./happy-dom-shims.js";export*from"./event-factory.js";export*from"./interaction-drivers.js";export*from"./wait-for-mount.js";
+import{installHappyDomAriaControlsShim,installHappyDomFormAssociatedShims,installHappyDomShadowFocusShim,installHappyDomShims,installStubInternalsForTest}from"./happy-dom-shims.js";export*from"./event-factory.js";export*from"./interaction-drivers.js";export*from"./wait-for-mount.js";export{installHappyDomAriaControlsShim,installHappyDomFormAssociatedShims,installHappyDomShadowFocusShim,installHappyDomShims,installStubInternalsForTest};

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

@@ -6,7 +6,7 @@
 - **Class** `LyraAccordionItem`, also available unregistered from `@aceshooting/lyra-ui/components/layout/details/accordion-item.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecated part** `base` since `8.2.3`; use part `::part(accordion-item)`; removal not before `10.0.0` — The accordion-item part names the outer wrapper explicitly; base remains on that same node during the compatibility window. That version is a policy floor, not a plan: Web Awesome still publishes its own deprecated `base` part on `wa-accordion-item`, and a mirrored tag owes its whole upstream surface, so this alias is removed only when upstream's is.
 - **Optional peers** none
 - **Themeable via** 8 parts, 17 custom properties — see `lr-details.md`

package/llms/components/lr-accordion.md

@@ -6,7 +6,7 @@
 - **Class** `LyraAccordion`, also available unregistered from `@aceshooting/lyra-ui/components/layout/details/accordion.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 1 part, 6 custom properties — see `lr-details.md`

package/llms/components/lr-alert.md

@@ -46,8 +46,8 @@ when migrated markup relies on `open`, timed dismissal, countdown, or identity-p
   rather than a density knob — and its optical pull-out toward the panel edge is clamped to the
   tier's own gutter, so the two smallest tiers cannot push it through the panel's clipped border. An
   unsupported value normalizes to the omitted state and removes the attribute.
-- `variant: 'primary' | 'success' | 'neutral' | 'warning' | 'danger' = 'primary'` (reflected) —
-  `primary` resolves through Lyra's shared brand semantic tokens. Unsupported attributes and
+- `variant: 'primary' | 'brand' | 'success' | 'neutral' | 'warning' | 'danger' = 'primary'` (reflected) —
+  `primary` and `brand` resolve through Lyra's shared brand semantic tokens. Unsupported attributes and
   untyped property writes normalize to reflected `primary`.
 - `duration: number = Infinity` — milliseconds before automatic dismissal. `Infinity` stays open;
   hover or focus pauses the timer, and leaving interaction restarts the full duration.

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

@@ -6,7 +6,7 @@
 - **Class** `LyraAppRailGroup`, also available unregistered from `@aceshooting/lyra-ui/components/layout/app-rail-group/app-rail-group.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `experimental` since `16.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 8 parts, 8 custom properties — see `lr-app-rail.md`

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

@@ -6,7 +6,7 @@
 - **Class** `LyraAppRailItem`, also available unregistered from `@aceshooting/lyra-ui/components/layout/app-rail/app-rail-item.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecated slot** `icon` since `26.0.0`; use slot `slot="start"`; removal not before `28.0.0` — The leading glyph uses the shared start slot vocabulary; existing icon slot content remains rendered during migration.
 - **Optional peers** none
 - **Themeable via** 10 parts, 22 custom properties — see `lr-app-rail.md`

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

@@ -6,7 +6,7 @@
 - **Class** `LyraAppRail`, also available unregistered from `@aceshooting/lyra-ui/components/layout/app-rail/app-rail.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 11 parts, 33 custom properties — see this component's own `@csspart`/`@cssprop` list below

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

@@ -88,12 +88,6 @@ coalesce into one update.
   neither `file` nor `name` supplies a name. Omitting it reads back `undefined` and uses the
   localized default (`'Untitled file'` in English)
 
-**Renamed in 8.0.0 — breaking:** the byte count is `bytes`, not `size` (same rename as
-`lr-file-icon`'s). In this library `size` names a tier on the shared size ladder, and a numeric byte
-count answering to the same property name is a collision a consumer only discovers at runtime. A
-leftover `size="245000"` is not a byte count: it is an unsupported tier, so it normalizes to unset
-and is removed, `bytes` stays omitted and the `size` part renders nothing.
-
 The component identifies _which_ attachment an action event is about through `attachmentId`. Set
 `attachment-id="..."` when you have a stable server-side identity; when unset or whitespace-only
 and `file` is set, a stable attachment id is
@@ -104,10 +98,7 @@ generated internal id is used as a last resort.
 `without-remove-button` is set), `lr-retry`
 (`detail: { attachmentId }`, only rendered while `status="error"`), and
 `lr-preview-request` (`detail: { attachmentId, name, mimeType, src }`) — a plain, non-cancelable
-notification that the preview action was activated. **Breaking in 10.0.0:** this event was
-advertised as cancelable, but the chip never read `defaultPrevented` and owns no preview default
-action to veto (it never registers or owns a viewer/overlay), so `preventDefault()` was a no-op.
-The flag is gone rather than left as a promise the component cannot keep.
+notification that the preview action was activated.
 
 **Slots:** none.
 

package/llms/components/lr-attachment-trigger.md

@@ -83,16 +83,6 @@ painted surface sits one boundary deeper),
 hidden via CSS by default, exposed as a part only so a consumer can override that with
 `::part(hidden-input)` in the unlikely case their integration needs to).
 
-**Migrating a pre-16.0.0 `::part()` rule.** This component's icon-only action is a composed
-`<lr-icon-button>`, so the part naming that action now names the composed child's HOST, which
-paints nothing. A `border`, `background` or `border-radius` set on it is silently dead — only
-`color` still appears to work, because it inherits, which makes such a rule look half-alive rather
-than broken. Set `--lr-icon-button-bg`/`-color`/`-border`/`-radius` (and their
-`-hover`/`-active` variants) on this element or an ancestor instead: the composed control reads
-those public tokens ahead of any default this component supplies. For SIZE use
-`--lr-theme-icon-button-size`, not `--lr-icon-button-size` — every `LyraElement` re-declares the
-latter on its own `:host`, so it never reaches a composed child (see `llms/tokens.md`).
-
 **An ancestor's public border wins over this component's own relayed default, not just its
 absence.** Unlike most composing components, the `outlined`/`filled-outlined` appearances here DO
 relay a non-zero `--_lr-icon-button-border-default` (a themed edge) into the trigger's private

package/llms/components/lr-avatar.md

@@ -32,14 +32,12 @@ values restore the image or fallback name.
   image is set, or the image fails to load and no `icon` slot content is provided.
 - `image: string = ''` — image URL; takes priority over the `icon` slot and `initials` when set and
   loads successfully, falling back to them on a load
-  error. **Renamed from `src` in 8.0.0** to match `wa-avatar`: a mechanical `wa-` → `lr-` rename
-  used to leave the property unset, so a migrated avatar silently dropped its photo and rendered
-  initials instead.
+  error. Matches `wa-avatar`'s `image`.
 - `label: string = ''` — upstream-compatible accessible description. A host `aria-label` wins.
   The same resolved name reaches the image `alt` and every fallback tier.
 - host `aria-label` — overrides `label` as the image/fallback accessible name without changing the
   visible initials or image
-- `loading: 'eager' | 'lazy' = 'eager'` (new in 8.0.0) — passthrough to the rendered `<img>`'s
+- `loading: 'eager' | 'lazy' = 'eager'` — passthrough to the rendered `<img>`'s
   native `loading` attribute. `'lazy'` defers the request until the avatar approaches the viewport,
   which is worth setting for avatars far down a long list and never for one above the fold. It only
   reaches the DOM while the image tier is the one rendering; the default matches the native default,
@@ -51,13 +49,11 @@ values restore the image or fallback name.
   normalize to `medium`.
 - `shape: 'circle' | 'rounded' | 'square' = 'circle'` (reflected) — three distinct corner radii:
   `circle` (the pill radius), `rounded` (the shared `--lr-radius`), `square` (no radius at all).
-  **`rounded` is new in 8.0.0.**
 - `variant: 'neutral' | 'brand' | 'success' | 'warning' | 'danger' = 'neutral'` (reflected) —
   recolors the initials-fallback background/text on the library's one semantic-tone vocabulary;
-  `neutral` (the default) reads as a plain, unaccented circle. **Renamed from `tone` in 8.0.0**,
-  with no alias: `tone="brand"` is an unknown attribute now and renders the neutral circle.
+  `neutral` (the default) reads as a plain, unaccented circle.
 
-**Events:** `lr-error` (`detail: { image: string }`, new in 8.0.0) — the image failed to load;
+**Events:** `lr-error` (`detail: { image: string }`) — the image failed to load;
 `detail.image` carries the URL that failed, so a consumer can retry or report it. Bubbling,
 composed, non-cancelable, and purely informational: by the time it fires the avatar has already
 fallen back to the `icon` slot or the initials on its own. It never fires for an avatar with no

package/llms/components/lr-badge.md

@@ -23,12 +23,6 @@ mirrored upstreams and avoiding repeated announcements when a category badge is
 Authors can opt a genuinely changing badge into live semantics with `role="status"`; that and every
 other author-supplied role remain authoritative across updates, hydration, and reconnect.
 
-**Visual break in 8.0.0 — a badge is no longer a pill by default.** Both components used to render
-fully-rounded ends unconditionally. `--lr-badge-radius` now defaults to `var(--lr-radius)` (a rounded
-rectangle) and the pill treatment moved behind the new opt-in `pill` boolean. Existing markup keeps
-its corner radius only if you add `pill`, or set `--lr-badge-radius: var(--lr-radius-pill)` once at
-the app level.
-
 **Properties** (all are declared by `lr-badge` and inherited by `lr-tag`; `lr-tag` adds the
 `variant="text"` spelling plus `withRemove` / `removable`):
 
@@ -41,16 +35,16 @@ the app level.
   dimensions. Both short and long upstream spellings round-trip verbatim while resolving to the
   same private effective size for rendering.
 - `appearance: 'accent' | 'filled' | 'outlined' | 'filled-outlined' | 'plain' = 'filled-outlined'`
-  (reflected) — **new in 8.0.0.** The second visual axis: `variant` picks the palette, `appearance`
+  (reflected) — The second visual axis: `variant` picks the palette, `appearance`
   decides how much of it lands on the fill, the border and the text. `filled-outlined` (the default)
-  is quiet tint + loud border + loud text, i.e. exactly the pre-8.0.0 treatment; `filled` drops the
+  is quiet tint + loud border + loud text; `filled` drops the
   border, `outlined` drops the fill, `accent` fills solidly with on-loud text, and `plain` drops both
   fill and border while keeping the label color. The border-less appearances use a `transparent`
   border rather than `none`, so switching appearance never changes the badge's layout box.
-- `pill: boolean = false` (reflected) — **new in 8.0.0.** Fully-rounded ends instead of the default
+- `pill: boolean = false` (reflected) — Fully-rounded ends instead of the default
   rounded rectangle; see the visual break above. Since it defaults to `false`, `pill="false"` is not
   a way to switch it off — remove the attribute, or assign `.pill = false`.
-- `attention: 'none' | 'pulse' | 'bounce' = 'none'` (reflected) — **new in 8.0.0.** An opt-in,
+- `attention: 'none' | 'pulse' | 'bounce' = 'none'` (reflected) — An opt-in,
   infinitely-looping attention animation for a badge that has to be noticed: `pulse` draws an
   expanding ring, `bounce` hops the surface vertically (block-direction, so it needs no RTL
   mirroring). Both stop outright — not merely shorten — under `prefers-reduced-motion: reduce`.
@@ -61,13 +55,14 @@ the app level.
   intentional `variant="neutral"` and `appearance="filled-outlined"` defaults remain unchanged
   because the two pinned upstreams disagree on both defaults.
 - `value?: string` — opaque bookkeeping value echoed in `lr-remove`'s detail; never rendered.
-- `withRemove: boolean = false` (attribute `with-remove`, reflected) — **`lr-tag` only, new in
-  8.0.0.** Renders the remove affordance. `lr-badge` never renders one, even if the attribute is
+- `withRemove: boolean = false` (attribute `with-remove`, reflected) — **`lr-tag` only.** Renders the remove affordance. `lr-badge` never renders one, even if the attribute is
   present on the markup.
 - `removable: boolean = false` (attribute `removable`) — **`lr-tag` only.** Shoelace-compatible
   alias for `withRemove`; reading either property reports the shared state. Either authored
   attribute keeps removal enabled until both are absent. Assigning `false` through either property
   clears both attributes, while assigning `true` reflects that property's own spelling.
+- `disabled: boolean = false` (reflected) — **`lr-tag` only.** Disables the remove button and suppresses
+  `lr-remove`; a tag without `withRemove` has no action to gate.
 
 **Events:** `lr-remove` — noncancelable, bubbles and composes, `detail: { value }` echoing the tag's
 `value` property (`undefined` when never set), exactly like `lr-chip`'s, so one handler serves both.
@@ -75,8 +70,9 @@ Emitted by `lr-tag` only (a badge emits nothing at all) when the remove button i
 or by Enter/Space while focused; it is a real native `<button>`, so both come for free. Only
 rendered, and therefore only fired, while `withRemove` / `removable` is set, and the event's
 `target` is the tag itself. `lr-tag` and `lr-chip` share the removable-pill contract: `lr-remove`
-with `{ value }`, the `removable` attribute (`with-remove` is `lr-tag`'s upstream-mirroring alias),
-`--lr-<tag>-remove-hover-bg` and the same × glyph size; only `lr-chip` has `disabled`.
+with `{ value }`, the `removable` and `with-remove` attributes (aliases on both),
+`--lr-<tag>-remove-hover-bg`, the same × glyph size and `disabled` (which disables the remove button
+and suppresses `lr-remove`); `lr-chip` also accepts `with-remove` as an alias of `removable`.
 
 Like `<lr-chip>`, a removable `lr-tag` is controlled: activation only announces the request. The
 tag remains connected even if a listener calls `preventDefault()` (the event is not cancelable),
@@ -95,7 +91,7 @@ available during that same-task window so it can release the stale focused butto
 there is no owner to blur.
 
 **Slots:** default (the label), `start` (content before the label, typically an icon) and `end`
-(content after it) — both new in 8.0.0. Each wrapper collapses entirely (`display: none`, so no
+(content after it). Each wrapper collapses entirely (`display: none`, so no
 stray gap) while its slot is empty, and is seeded from the light-DOM children before the first
 render so declarative content never flashes hidden for a frame. Mark purely decorative slotted
 content `aria-hidden`.
@@ -117,7 +113,7 @@ win over whatever `variant`/`appearance` resolved: `--lr-badge-background` (fall
 `--lr-badge-fill`), `--lr-badge-border` (falls back to `--lr-badge-stroke`), `--lr-badge-color`
 (falls back to `--lr-badge-text`).
 
-_Palette — what `variant` chooses_ (new in 8.0.0): `--lr-badge-tint` (private default
+_Palette — what `variant` chooses_: `--lr-badge-tint` (private default
 `var(--lr-color-surface)`, the quiet fill; each non-neutral variant changes that private default to
 `var(--lr-color-fill-quiet)`, which the shared variants sheet has already re-pointed at that
 variant's row of the semantic grid), `--lr-badge-solid` (private default
@@ -129,7 +125,7 @@ variant's row of the semantic grid), `--lr-badge-solid` (private default
 the only variant whose border and text colors differ, which is why `-edge` and `-ink` are separate
 slots rather than one loud color.
 
-_Surface — what `appearance` routes onto the box_ (new in 8.0.0): `--lr-badge-fill` (default
+_Surface — what `appearance` routes onto the box_: `--lr-badge-fill` (default
 `var(--lr-badge-tint)`), `--lr-badge-stroke` (default `var(--lr-badge-edge)`) and `--lr-badge-text`
 (default `var(--lr-badge-ink)`). Set one of these to retune a single appearance without touching the
 palette.
@@ -138,14 +134,14 @@ _Density and shape:_ `--lr-badge-font-size` (default `var(--lr-font-size-sm)`),
 `--lr-badge-padding-inline` (default `var(--lr-space-s)`) and `--lr-badge-min-height` (default
 `var(--lr-size-1-25rem)`) — the trio each private effective-size rule rewrites to that step's font size,
 inline padding and minimum block size; the `m` defaults above exactly reproduce the pre-`size` fixed
-badge treatment. `--lr-badge-gap` (default `var(--lr-space-2xs)`, new in 8.0.0) is the space between
+badge treatment. `--lr-badge-gap` (default `var(--lr-space-2xs)`) is the space between
 the `start` slot, the label and the `end` slot — it collapses on its own when a wrapper is empty,
 because the empty wrapper is `display: none` rather than zero-width. `--lr-badge-radius` (default
 `var(--lr-radius)`; `pill` raises it to `var(--lr-radius-pill)`) is `[part='base']`'s corner radius,
 retunable without a `::part(base)` rule and, unlike the density trio, does not vary by `size` — the
 same `--lr-button-radius` pattern.
 
-_Attention_ (all new in 8.0.0): `--lr-badge-attention-duration` (default
+_Attention_: `--lr-badge-attention-duration` (default
 `var(--lr-duration-ambient)` — one cycle of the animation), `--lr-badge-attention-easing` (default
 `var(--lr-easing-emphasized)` — kept a separate token from the duration so the `animation` shorthand
 expands to exactly one timing function), `--lr-badge-pulse-color` (default
@@ -154,7 +150,7 @@ expands to exactly one timing function), `--lr-badge-pulse-color` (default
 `--lr-badge-pulse-spread` (default `var(--lr-size-0-25rem)` — how far the ring expands) and
 `--lr-badge-bounce-distance` (default `var(--lr-size-0-1875rem)` — the hop's peak travel).
 
-_`lr-tag`'s own two_ (new in 8.0.0): `--lr-tag-remove-radius` (default `var(--lr-badge-radius)`, so
+_`lr-tag`'s own two_: `--lr-tag-remove-radius` (default `var(--lr-badge-radius)`, so
 retuning the tag's corner retunes the remove button's with it) and
 `--lr-tag-remove-hover-bg` (default `color-mix(in srgb, currentColor 16%, transparent)` —
 the remove button's `:hover` fill).

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

@@ -74,7 +74,7 @@ their structural parameter and result types are available through the function's
   `max`) plus the hovered box's source `datasetIndex`, `index`, `label` and `seriesLabel`.
 - `withDataTable: boolean = false` (attribute `with-data-table`) — reveals the accessible data
   table.
-- `dataTableToggle: boolean = false` (attribute `data-table-toggle`, new in 11.0.0) — renders a
+- `dataTableToggle: boolean = false` (attribute `data-table-toggle`) — renders a
   localized disclosure button (`part="data-table-toggle"`) above the data table so a *sighted*
   reader can reveal the numbers on demand. `withDataTable` alone is all-or-nothing, which left
   consumers wrapping a duplicated table in their own `<details>`. With the toggle on,

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

@@ -6,7 +6,7 @@
 - **Class** `LyraBreadcrumbItem`, also available unregistered from `@aceshooting/lyra-ui/components/layout/breadcrumb/breadcrumb-item.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 7 parts, 3 custom properties — see `lr-breadcrumb.md`

package/llms/components/lr-breadcrumb.md

@@ -6,7 +6,7 @@
 - **Class** `LyraBreadcrumb`, also available unregistered from `@aceshooting/lyra-ui/components/layout/breadcrumb/breadcrumb.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 3 parts, 0 custom properties — see this component's own `@csspart`/`@cssprop` list below

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

@@ -6,7 +6,7 @@
 - **Class** `LyraButtonGroup`, also available unregistered from `@aceshooting/lyra-ui/components/layout/button-group/button-group.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 1 part, 1 custom property — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-button.md

@@ -6,7 +6,7 @@
 - **Class** `LyraButton`, also available unregistered from `@aceshooting/lyra-ui/components/forms/button/button.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 9 parts, 35 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-calendar.md

@@ -6,7 +6,7 @@
 - **Class** `LyraCalendar`, also available unregistered from `@aceshooting/lyra-ui/components/data/calendar/calendar.class.js`
 - **Family** `components/data/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [data](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/data.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 19 parts, 12 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-callout.md

@@ -19,7 +19,7 @@
 An inline status, warning, or error surface. Set `inline` for lightweight reactive form or mutation
 errors without panel chrome.
 
-**Properties:** `variant: 'neutral'|'brand'|'success'|'warning'|'danger' = 'brand'` (reflected when
+**Properties:** `variant: 'neutral'|'brand'|'primary'|'success'|'warning'|'danger' = 'brand'` (`primary` is stored and reflected as `brand`; reflected when
 explicit — an unset nested callout inherits its ancestor's semantic colour context without
 materializing a `variant` attribute. Explicitly writing even the same-default `brand` materializes
 the attribute and pins the local brand palette; removing the attribute restores contextual
@@ -27,7 +27,7 @@ inheritance),
 `appearance: 'accent'|'filled'|'outlined'|'plain'|'filled-outlined'` (reflected, with no explicit
 default — when set, controls how much of the active variant palette is spent on fill, border, and
 text; leaving it unset preserves the established quiet-fill/loud-edge treatment),
-`size: LyraSize = 'm'` (reflected when explicit — **new in 8.0.0**; visual density on the library's shared ladder,
+`size: LyraSize = 'm'` (reflected when explicit — visual density on the library's shared ladder,
 accepting both spellings of the aliased tiers (`s`/`small`, `m`/`medium`, `l`/`large`) so markup migrated
 from `wa-callout` needs no attribute rewrite. An unset nested callout inherits its ancestor's size
 context; standalone fallback is `m`. Explicitly writing even the same-default `m` pins the local
@@ -79,16 +79,6 @@ The surface chrome lives on the custom-element host, not inside `base`. Ordinary
 work directly and take normal author precedence. `inline` removes the host's border, background,
 and padding.
 
-**Migrating a pre-16.0.0 `::part()` rule.** This component's icon-only action is a composed
-`<lr-icon-button>`, so the part naming that action now names the composed child's HOST, which
-paints nothing. A `border`, `background` or `border-radius` set on it is silently dead — only
-`color` still appears to work, because it inherits, which makes such a rule look half-alive rather
-than broken. Set `--lr-icon-button-bg`/`-color`/`-border`/`-radius` (and their
-`-hover`/`-active` variants) on this element or an ancestor instead: the composed control reads
-those public tokens ahead of any default this component supplies. For SIZE use
-`--lr-theme-icon-button-size`, not `--lr-icon-button-size` — every `LyraElement` re-declares the
-latter on its own `:host`, so it never reaches a composed child (see `llms/tokens.md`).
-
 **Themeable custom properties:** `--lr-callout-bg`, `--lr-callout-color`, and
 `--lr-callout-border` read the inherited generic semantic quiet/loud slots, with brand quiet/loud
 as their standalone fallback. An explicit `variant` maps all generic slots locally; leaving it
@@ -102,7 +92,7 @@ retargets for the panel itself) so a consumer can retint the hover fill — e.g.
 `variant="brand"` panel, which shares the same default token — without a collateral effect on the
 panel background, and vice versa.
 
-Three more, all new in 8.0.0: `--lr-callout-font-size` (private default
+Three more: `--lr-callout-font-size` (private default
 `var(--lr-form-control-font-size, var(--lr-font-size-m))` — the callout's text size; each explicit
 `size` tier maps that private default from the shared ladder), `--lr-callout-padding` (private
 default `var(--lr-form-control-padding-inline, var(--lr-space-m))` — the panel's padding on _both_

package/llms/components/lr-card.md

@@ -6,7 +6,7 @@
 - **Class** `LyraCard`, also available unregistered from `@aceshooting/lyra-ui/components/layout/card/card.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 8 parts, 14 custom properties — see this component's own `@csspart`/`@cssprop` list below

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

@@ -6,7 +6,7 @@
 - **Class** `LyraCarouselItem`, also available unregistered from `@aceshooting/lyra-ui/components/layout/carousel/carousel-item.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 1 part, 1 custom property — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-carousel.md

@@ -6,7 +6,7 @@
 - **Class** `LyraCarousel`, also available unregistered from `@aceshooting/lyra-ui/components/layout/carousel/carousel.class.js`
 - **Family** `components/layout/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [layout](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/layout.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 18 parts, 18 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-chart.md

@@ -55,7 +55,7 @@ structured points retain their y-value formatting.
   controls angle lines and `y` controls concentric grid lines
 - `indexAxis: 'x'|'y' = 'x'` (attribute `index-axis`) — Chart.js index axis. `'y'` is Chart.js's own
   mechanism for horizontal bars (it also flips `line`/`area` types onto a horizontal category axis).
-  The `horizontal` boolean that used to alias `'y'` was removed in 9.0.0 — use `index-axis="y"`
+  Use `index-axis="y"` for a horizontal bar
 - `label: string | null = null` — accessible chart label. Host `aria-label` has highest precedence
   by presence, including an explicit empty string
 - `max: number | null = null`, `min: number | null = null` — finite value-axis bounds. They apply to
@@ -94,9 +94,7 @@ structured points retain their y-value formatting.
 - `labels: readonly string[] = []` (attribute: false)
 - `datasets: readonly LyraChartSeries[] = []` (attribute: false) — `LyraChartSeries { readonly
   label: string; readonly data?: readonly (number|null)[]; readonly points?: readonly
-  LyraChartPoint[]; readonly color?: string|readonly string[]; readonly stack?: string; ... }`. The
-  deprecated `Series` and `ChartPoint` names were removed in 9.0.0 — import
-  `LyraChartSeries`/`LyraChartPoint` instead.
+  LyraChartPoint[]; readonly color?: string|readonly string[]; readonly stack?: string; ... }`.
   - `stack` is a Chart.js dataset `stack` group id: series sharing one `stack` value on the same
     (stacked) axis accumulate into one stack; a different id starts an independent stack Chart.js
     draws side by side with the first on that axis. Omitted series share one implicit group, so
@@ -286,7 +284,7 @@ structured points retain their y-value formatting.
   displaces the caller's options.
 - `withDataTable: boolean = false` (attribute `with-data-table`) — makes the always-available
   accessible data table visible rather than screen-reader-only.
-- `dataTableToggle: boolean = false` (attribute `data-table-toggle`, new in 11.0.0) — renders a
+- `dataTableToggle: boolean = false` (attribute `data-table-toggle`) — renders a
   localized disclosure button (`part="data-table-toggle"`) above the data table so a *sighted*
   reader can reveal the numbers on demand. `withDataTable` alone is all-or-nothing, which left
   consumers wrapping a duplicated table in their own `<details>`. With the toggle on,
@@ -434,8 +432,8 @@ optional overlay content positioned at the chart area's center, useful for dough
 **Bounded rendering and data alternative:** simplified `labels`/`datasets` canvas rendering, the
 DOM legend, generated table, keyboard-operable datum model, generated point-details in the summary,
 and automatic canvas name process at most 1,000 category×series records. When sampling is necessary,
-the selected category and series indexes are distributed
-deterministically and retain their first and last endpoints; a localized `data-truncation` notice
+every series stays plotted and listed in the legend; only categories are thinned to the first,
+last and evenly spaced entries (series are thinned only beyond 500); a localized `data-truncation` notice
 is shown and announced. The sample is evenly spaced, not extreme-preserving: an isolated spike
 between sampled categories is not drawn, so pre-aggregate (for example a minimum and maximum per
 bucket) when every spike must stay visible. Supplying `slot="data-table"` suppresses the generated detailed sample and

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

@@ -7,7 +7,7 @@
 - **Class** `LyraCheckboxGroup`, also available unregistered from `@aceshooting/lyra-ui/components/forms/checkbox-group/checkbox-group.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 6 parts, 7 custom properties — see this component's own `@csspart`/`@cssprop` list below

package/llms/components/lr-checkbox.md

@@ -6,7 +6,7 @@
 - **Class** `LyraCheckbox`, also available unregistered from `@aceshooting/lyra-ui/components/forms/checkbox/checkbox.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 15 parts, 11 custom properties — see this component's own `@csspart`/`@cssprop` list below
@@ -36,6 +36,7 @@ Explicit empty text stays empty; later supplied text renders normally.
 - `name: string = ''`
 - `value: string = 'on'` — only contributed to form submission while `checked` (a native checkbox
   submits nothing at all, not even an empty string, while unchecked)
+- `defaultValue: string` — the native alias of `value` (a checkbox's `value` is its attribute)
 - `customError: string | null` (attribute `custom-error`) — reflected consumer validation message
 - `hint: string = ''` — WA supporting text below the control
 - `helpText: string = ''` (attribute `help-text`) — Shoelace alias for the same supporting-text

package/llms/components/lr-chip.md

@@ -27,19 +27,6 @@ already follow.
 Collapsed groups reapply `max-visible` when assigned children are replaced or reordered at the same
 count, preserving authored hidden/inert state and releasing departed visibility leases.
 
-**Two breaks in 8.0.0.** `tone` is now `variant`, with no alias — one concept, one spelling,
-library-wide. And a chip is **no longer a pill by default**: `--lr-chip-radius` used to be
-`var(--lr-radius-pill)` unconditionally, is now `var(--lr-radius)` (a rounded rectangle), and the
-fully-rounded treatment moved behind the new opt-in `pill` boolean. Existing markup keeps its corner
-radius only if you add `pill`, or set `--lr-chip-radius: var(--lr-radius-pill)` once at the app
-level. `<lr-badge>`/`<lr-tag>` made the identical shape change, with the identical `pill` opt-in.
-
-**Two breaks in 9.0.0.** The chip's leading adornment slot and CSS part are now `start`, matching
-the library-wide adornment vocabulary; migrate `slot="icon"` to `slot="start"` and
-`::part(icon)` to `::part(start)`. Also, `toggleable` is now the sole toggle-mode opt-in:
-`selected` represents only current pressed state, so add `toggleable` anywhere that previously
-relied on `<lr-chip selected>` to create an action.
-
 ### `lr-chip`
 
 **Properties:**
@@ -50,17 +37,16 @@ relied on `<lr-chip selected>` to create an action.
   of `s`/`m`/`l` and round-trip unchanged. Unsupported attributes and untyped property writes
   normalize to reflected `m`.
 - `variant: 'neutral' | 'brand' | 'primary' | 'success' | 'warning' | 'danger' = 'neutral'`
-  (reflected) — `primary` is an alias that renders as `brand`.
-  **renamed from `tone` in 8.0.0, with no alias** (see above). `<lr-badge>`, `<lr-callout>` and
+  (reflected) — `primary` is an alias that renders as `brand`. `<lr-badge>`, `<lr-callout>` and
   `<lr-toast-item>` all already spelled it `variant`. It tints the whole surface using the
   loud-color-on-quiet-tint convention: background is the
   variant's quiet fill, text/icon its loud fill, both read from the shared semantic grid. `neutral`
   deliberately opts out of that grid and falls back to a plain bordered-surface look. Unsupported
   attributes and untyped property writes normalize to reflected `neutral`.
-- `removable: boolean = false` (reflected — shows the remove (×) button)
+- `removable: boolean = false` (reflected — shows the remove (×) button); `withRemove` (`with-remove`) is `lr-tag`'s spelling of the same state, last write wins
 - `disabled: boolean = false` (reflected) — disables the active native toggle/remove control,
   blocks focus and activation, and suppresses selection/removal requests without mutating state
-- `pill: boolean = false` (reflected) — **new in 8.0.0.** Fully-rounded ends instead of the default
+- `pill: boolean = false` (reflected) — Fully-rounded ends instead of the default
   rounded rectangle; the same property `<lr-badge>`/`<lr-tag>` carry. Since it defaults to `false`,
   `pill="false"` is not a way to switch it off — remove the attribute, or assign `.pill = false`.
 - `selected: boolean = false` (reflected) — current pressed value. It does not opt into interaction

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

@@ -50,7 +50,8 @@ number; sourceId: string; title?: string; page?: string | number; anchor?: LyraC
   sole overall owner; an explicitly empty host label stays empty
 - `ordinalIndex?: number` / `ordinalTotal?: number` (attribute: false) — optional one-based result
   position and count supplied by a containing results list. Standalone rows use their position in
-  the sorted inspector list. The open-button name includes this ordinal, title, and score tier.
+  the sorted inspector list. The open-button name includes this ordinal, title, and score tier. Setting it marks the inspector as one row of that list, so it renders without its own
+  group, list or listitem semantics.
 
 **Events:** `lr-chunk-open` (`detail: { chunkId, sourceId, anchor? }`, a chunk's title/open button was
 activated — the event a host routes into `lr-document-viewer`, setting `src` from `sourceId` and

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

@@ -71,13 +71,13 @@ public value remains authoritative in every status. Shared tokens include
 > per-confidence colors)? Set the component hooks above on their ancestor wrapper. Use
 > `--lr-theme-*` instead only when changing a shared semantic palette input for the entire subtree.
 
-The anchored source-preview popover is a floating surface and paints from the **shared overlay-surface family** (16.0.0):
+The anchored source-preview popover is a floating surface and paints from the **shared overlay-surface family**:
 `--lr-overlay-surface` (default `var(--lr-color-surface-overlay)`), `--lr-overlay-border` (default
 `var(--lr-color-border-subtle)`) and `--lr-overlay-shadow-anchored` (default `var(--lr-shadow-m)`). None is
 declared on `:host`, so one declaration on `:root` — or on any ancestor, to scope it — retints this
 surface together with every other floating surface in the library. `--lr-overlay-radius` (default `var(--lr-radius)`) is the matching corner radius.
 
-`--lr-positioning-strategy` (16.0.0) — the source-preview popover reads this same cascading
+`--lr-positioning-strategy` — the source-preview popover reads this same cascading
 `absolute`/`fixed` override documented on `<lr-popover>` when it is (re)positioned, falling back to
 its own `fixed` default when nothing is set. There is no per-instance `positioning-strategy`
 property on `<lr-citation-badge>`; set the custom property on `:root`, a theme, or one clipping

package/llms/components/lr-code-block.md

@@ -130,16 +130,6 @@ header gap — a rule that sets `display` on it must qualify itself with `:not([
 `line-button` (a gutter line-number button, only rendered while `activatableLines` and `lineNumbers`
 are both set)
 
-**Migrating a pre-16.0.0 `::part()` rule.** This component's icon-only action is a composed
-`<lr-icon-button>`, so the part naming that action now names the composed child's HOST, which
-paints nothing. A `border`, `background` or `border-radius` set on it is silently dead — only
-`color` still appears to work, because it inherits, which makes such a rule look half-alive rather
-than broken. Set `--lr-icon-button-bg`/`-color`/`-border`/`-radius` (and their
-`-hover`/`-active` variants) on this element or an ancestor instead: the composed control reads
-those public tokens ahead of any default this component supplies. For SIZE use
-`--lr-theme-icon-button-size`, not `--lr-icon-button-size` — every `LyraElement` re-declares the
-latter on its own `:host`, so it never reaches a composed child (see `llms/tokens.md`).
-
 **Border reaches the composed copy control the same way background/color/radius do.** This
 component paints no resting border of its own, so it relays no `--_lr-icon-button-border-default`
 into the copy control's private fallback tier — but that absence is not a gap. The public

package/llms/components/lr-code-editor.md

@@ -6,7 +6,7 @@
 - **Class** `LyraCodeEditor`, also available unregistered from `@aceshooting/lyra-ui/components/forms/code-editor/code-editor.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 8 parts, 16 custom properties — see this component's own `@csspart`/`@cssprop` list below

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

@@ -6,7 +6,7 @@
 - **Class** `LyraColorPicker`, also available unregistered from `@aceshooting/lyra-ui/components/forms/color-picker/color-picker.class.js`
 - **Family** `components/forms/` — see `llms/index.md` for its siblings
 - **Status** `stable` since `4.0.0` — see the maturity and deprecation policy in `llms/shared.md`
-- **Release history** [CHANGELOG.md](../../CHANGELOG.md); family-wide breaking-change summaries: [forms](https://github.com/aceshooting/lyra-ui/blob/main/packages/lyra-ui/llms/forms.md)
+- **Release history** [CHANGELOG.md](../../CHANGELOG.md)
 - **Deprecations** none
 - **Optional peers** none
 - **Themeable via** 43 parts, 35 custom properties — see this component's own `@csspart`/`@cssprop` list below