@aceshooting/lyra-ui 2.1.0 → 2.2.0

package/llms-full.txt

@@ -1,24 +1,29 @@
 # @aceshooting/lyra-ui — LLM API Reference
 
 `@aceshooting/lyra-ui` is a library of free, clean-room [Lit](https://lit.dev) web components — a
-companion to [Web Awesome](https://webawesome.com) that reimplements several Web Awesome **Pro**
-components as open-source equivalents (same tag shape, attributes, slots, events, and CSS parts,
-under a `lyra-` prefix instead of `wa-`), plus a number of extras that have no Web Awesome
+companion to [Web Awesome](https://webawesome.com) that reimplements selected Web Awesome **Pro**
+components as open-source equivalents (documented compatible tag shape, attributes, slots, events,
+and CSS parts under a `lyra-` prefix instead of `wa-`), plus a number of extras that have no Web Awesome
 counterpart at all (dashboard atoms, temporal/graph widgets, chart wrappers, a map component, a
 file dropzone). It is **token-compatible with Web Awesome**: every component's stylesheet resolves
 through Web Awesome's `--wa-*` design tokens first, falling back to its own `--lyra-*` tokens, so
 components read as native inside a Web Awesome-themed app and are equally usable standalone with no
 theme at all. This document is the complete, component-by-component API reference intended for
-coding assistants integrating the library; for install instructions, the full tag/tier table, and
+coding assistants integrating the library; for install instructions, the full component catalog, and
 the `<wa-*>` → `<lyra-*>` migration notes, see the package [README](./README.md) — or the shorter
 curated index at [`llms.txt`](./llms.txt) if you just need the shape of the library before diving in
 here.
 
+Component entry points such as `components/empty/empty.js` register their custom-element tag.
+Every component also exposes a matching `.class.js` entry for subclassing or type-directed
+composition without registration; for example, `components/empty/empty.class.js` exports
+`LyraEmpty` without touching `customElements`.
+
 ## Contents
 
 - **Shared foundation** — `internal/` (base class, form-association mixin, positioning helper, design tokens)
-- **v1 core** — `lyra-combobox`/`lyra-option`, `lyra-select`, `lyra-date-picker`/`lyra-date-input`, `lyra-toast` family, `lyra-sparkline`, `lyra-flag`
-- **Dashboard atoms** — `lyra-empty`, `lyra-skeleton`, `lyra-stat`, `lyra-table`, `lyra-gauge`, `lyra-export-button`, `lyra-split`, `lyra-widget`, `lyra-word-cloud`
+- **Form controls, toasts, sparkline, and flags** — `lyra-combobox`/`lyra-option`, `lyra-select`, `lyra-date-picker`/`lyra-date-input`, `lyra-toast` family, `lyra-sparkline`, `lyra-flag`
+- **Dashboard atoms** — `lyra-empty`, `lyra-skeleton`, `lyra-stat`, `lyra-table`, `lyra-gauge`, `lyra-export-button`, `lyra-copy-button`, `lyra-split`, `lyra-widget`, `lyra-word-cloud`
 - **Temporal & graph** — `lyra-time-range`, `lyra-playback`, `lyra-heatmap`, `lyra-graph`, `lyra-tree`/`lyra-tree-node`
 - **Chart family** — `lyra-chart` (core), typed subclasses, `lyra-histogram`, `lyra-box-plot`,
   `lyra-lite-chart` (dependency-free bar/line alternative, no peer deps)
@@ -34,7 +39,7 @@ here.
   `lyra-tool-param-form`, `lyra-menu`/`lyra-menu-item`, `lyra-chip`/`lyra-chip-group`,
   `lyra-model-settings-panel`, `lyra-context-meter`, `lyra-dock-panel`, `lyra-document-preview`,
   `lyra-media-card`, `lyra-attachment-trigger`, `lyra-kbd`, `lyra-result-card`/`lyra-result-field`
-- **Cross-cutting notes** — packaging and adoption caveats that apply across the whole library
+- **Cross-cutting notes** — packaging notes that apply across the whole library
 
 ---
 
@@ -45,9 +50,10 @@ Not a custom element itself — infrastructure every `lyra-*` component in the l
 - **`LyraElement`** (`internal/lyra-element.ts`) — base class every `lyra-*` component `extends`.
   `static styles = [tokens]` (the design-token layer below); subclasses prepend `LyraElement.styles`
   to their own `static styles` array to inherit it. Supplies
-  `protected emit<T>(name: string, detail?: T): CustomEvent<T>` — dispatches a
-  `{ bubbles: true, composed: true, cancelable: true }` `CustomEvent` and returns it, so callers can
-  do `const ev = this.emit('lyra-export', {...}); if (ev.defaultPrevented) return;`.
+  `protected emit<T>(name: string, detail?: T, options?: LyraEmitOptions): CustomEvent<T>` — dispatches
+  a bubbling/composed notification that is non-cancelable by default. A true veto point opts into
+  `{ cancelable: true }` and checks `defaultPrevented` before applying its operation, as
+  `lyra-export` does. Native-like `input`/`change` events use the same non-cancelable default.
 - **`FormAssociated(Base)`** mixin (`internal/form-associated.ts`) — makes a `LitElement`
   form-associated: `static formAssociated = true`, `attachInternals()` in the constructor (which also
   eagerly calls `internals.setFormValue('')`, so an untouched control is present in `FormData` as
@@ -102,9 +108,9 @@ Not a custom element itself — infrastructure every `lyra-*` component in the l
   set: `--lyra-color-surface / -text / -text-quiet / -border / -brand / -brand-quiet / -success /
   -success-quiet / -warning / -warning-quiet / -danger / -danger-quiet`,
   `--lyra-color-on-brand / -on-success / -on-warning / -on-danger` (paired
-  text/icon colors for content painted on the corresponding solid semantic fill; the standalone
-  fallbacks switch from light content in light mode to dark content on the brighter dark-mode
-  fills), `--lyra-space-xs / -s / -m / -l`, `--lyra-radius`, `--lyra-shadow`,
+  text/icon colors for content painted on the corresponding solid semantic fill; standalone light
+  and dark fallbacks choose a contrasting foreground for each fill, while a Web Awesome theme can
+  provide its own `*-on-loud` values), `--lyra-space-xs / -s / -m / -l`, `--lyra-radius`, `--lyra-shadow`,
   `--lyra-font`, `--lyra-transition-fast` / `-base` (motion timing every animating component should
   share), `--lyra-opacity-disabled` (one shared disabled-state opacity), `--lyra-focus-ring-width` /
   `-color` / `-offset` (every `:focus-visible` rule should reference these), `--lyra-icon-button-size`
@@ -156,7 +162,7 @@ Not a custom element itself — infrastructure every `lyra-*` component in the l
 
 ---
 
-# v1 core: forms, toasts, sparkline, flag
+# Form controls, toasts, sparkline, and flags
 
 ## `lyra-combobox` / `lyra-option`
 
@@ -356,7 +362,7 @@ secondary line, when `sub` is set), `expand-icon`, `error`, `hint`
 
 **Themeable custom properties:** `--lyra-select-trigger-padding`, `--lyra-select-trigger-min-height`,
 `--lyra-select-font-size` — all three auto-swapped per `size` (`xs`…`xl`), the same pattern
-`lyra-toast-item`'s `--padding`/`--font-size` use.
+`lyra-toast-item`'s `--lyra-toast-padding`/`--lyra-toast-font-size` use.
 
 **Optional peer deps:** none.
 
@@ -572,9 +578,8 @@ One per page recommended — the region.
 
 **CSS parts:** `stack`
 
-**Themeable custom properties:** `--gap` (default `var(--lyra-space-s)`), `--width` (default
-`28rem`) — set directly on the `<lyra-toast>` element (not `--lyra-`-prefixed, but overridable
-per-instance).
+**Themeable custom properties:** `--lyra-toast-gap` (default `var(--lyra-space-s)`),
+`--lyra-toast-width` (default `28rem`) — set directly on the `<lyra-toast>` element.
 
 **Optional peer deps:** none.
 
@@ -584,7 +589,7 @@ A single notification.
 
 **Properties:**
 - `duration: number = 5000` (ms; `Infinity` or `<= 0` disables auto-dismiss)
-- `size: 'xs'|'s'|'m'|'l'|'xl' = 'm'` (reflected — drives both `--padding` and the toast's own
+- `size: 'xs'|'s'|'m'|'l'|'xl' = 'm'` (reflected — drives both `--lyra-toast-padding` and the toast's own
   font-size via `:host([size=...])`, from a compact `xs` up to a roomier `xl`)
 - `variant: 'brand'|'success'|'warning'|'danger'|'neutral' = 'neutral'` (reflected)
 - `withIcon: boolean = false` (attribute `with-icon`)
@@ -598,11 +603,12 @@ DOM.
 
 **CSS parts:** `toast-item`, `accent`, `icon`, `content`, `close-button`
 
-**Themeable custom properties:** `--accent-width` (4px), `--show-duration`/`--hide-duration`
+**Themeable custom properties:** `--lyra-toast-accent-width` (4px),
+`--lyra-toast-show-duration`/`--lyra-toast-hide-duration`
 (`var(--lyra-transition-base, 180ms ease-out)` — 180ms by default, matching the JS-side show/hide
-animation timer, which is not itself reading this token), `--padding` (`var(--lyra-space-m)`),
-`--font-size` (`1rem`) — both `--padding` and `--font-size` are auto-swapped per `size`, from a
-compact `xs` up to a roomier `xl` — `--accent-color` (defaults to `--lyra-color-border`,
+animation timer, which is not itself reading this token), `--lyra-toast-padding`
+(`var(--lyra-space-m)`), `--lyra-toast-font-size` (`1rem`) — both are auto-swapped per `size`, from a
+compact `xs` up to a roomier `xl` — `--lyra-toast-accent-color` (defaults to `--lyra-color-border`,
 auto-swapped per `variant` to `--lyra-color-brand/-success/-warning/-danger`).
 
 **Optional peer deps:** none.
@@ -747,7 +753,9 @@ overridden directly — non-`round` corner radius); also consumes `--lyra-color-
 ring around the flag image).
 
 **Optional peer deps:** `@aceshooting/lyra-flags` — required for the component to actually render an
-image; without it, renders an empty template (see gotchas).
+image when `country` or `language` is used. Import `components/flag/flag-peer.js` once to opt into
+that resolver; a pre-resolved `src` works without the peer registration entry. If the peer is not
+installed, renders an empty template (see gotchas).
 
 Also exported from the package root:
 `languageToCountry(language: string): string | undefined` and the `LANGUAGE_TO_COUNTRY` lookup
@@ -765,9 +773,15 @@ need different defaults).
 pnpm add @aceshooting/lyra-flags   # required peer — without it, <lyra-flag> renders nothing
 ```
 
+```js
+import '@aceshooting/lyra-ui/components/flag/flag-peer.js';
+```
+
 **Known gotchas:**
-- Requires the optional peer `@aceshooting/lyra-flags` to actually render an image; without it the
-  component still shows a `<lyra-skeleton variant="rect">` placeholder (with `aria-busy="true"` on
+- `country`/`language` resolution is opt-in through `components/flag/flag-peer.js`; the root barrel
+  registers the component without importing the optional flag asset graph. Requires the optional
+  peer `@aceshooting/lyra-flags` to actually render an image; without it the component still shows a
+  `<lyra-skeleton variant="rect">` placeholder (with `aria-busy="true"` on
   the host) while resolving, then settles into an **empty template** plus a one-time `console.warn`
   once the resolver rejects (lazy `import()`, cached module-wide so the warning fires only once per
   page even with many `<lyra-flag>` instances).
@@ -790,11 +804,11 @@ pnpm add @aceshooting/lyra-flags   # required peer — without it, <lyra-flag> r
   newer one: each resolver call is tagged with a token captured at the time it was kicked off, and a
   `.then()` that fires after a later change (or after the field was cleared) is discarded instead of
   clobbering the rendered image/`loading`.
-- `country`/`language` resolve through `@aceshooting/lyra-flags`'s `flagUrl(code)`, which is itself
-  genuinely code-split per flag: using `<lyra-flag country="fr">` anywhere in an app fetches only
-  the flags actually requested at runtime (verified with a real Vite build — referencing 2 codes
-  shipped ~28 KB total, not all 249). If you already have a flag's URL at build time, `src` skips
-  the peer-package round trip (and its loading-skeleton flash) entirely.
+- `country`/`language` resolve through `@aceshooting/lyra-flags`'s `flagUrl(code)`, which lazily
+  fetches one requested flag at runtime. A bundler may still emit the complete reachable lazy-chunk
+  graph because every supported code has a literal loader import; use a literal asset subpath
+  import when the deployment artifact must be pruned. If you already have a flag's URL at build
+  time, `src` skips the peer-package round trip (and its loading-skeleton flash) entirely.
 - 65 of `@aceshooting/lyra-flags`' 249 flags (any whose design includes a detailed coat of
   arms/seal/emblem, e.g. `es`, `pt`, `sv`) ship **three** fidelity tiers, selected via the `variant`
   property (`flagUrl(code, { variant })` under the hood): `"compact"` — a tiny WebP raster for
@@ -1178,6 +1192,40 @@ downloadBlob(content: string, filename: string, mime: string): void      // trig
 
 ---
 
+## `lyra-copy-button`
+
+A standalone icon-only copy-to-clipboard button for a plain text `value` — swaps its icon to a
+checkmark for ~1.5s on activation. Takes no positioning opinion of its own; a consumer
+wraps/positions the host element (e.g. absolutely positioned in the corner of a `wa-textarea` or a
+read-only output field). Unlike `lyra-code-block`'s or `lyra-json-viewer`'s own built-in copy
+buttons, this has no code/JSON content model to adopt just to reuse the copy affordance.
+
+**Properties:**
+- `value: string = ''` — the plain text to copy.
+
+**Events:** `lyra-copy` (`detail: { text: string }`) — fires on activation, always with the current
+`value`, regardless of whether the OS clipboard write actually succeeded (same convention as
+`lyra-code-block`'s/`lyra-json-viewer`'s own copy buttons).
+
+**Slots:** none.
+
+**CSS parts:** `base` — the button itself.
+
+**Themeable custom properties:** shared tokens only.
+
+**Optional peer deps:** none.
+
+```html
+<lyra-copy-button value="npm install @aceshooting/lyra-ui"></lyra-copy-button>
+```
+
+**Known gotchas:**
+- best-effort clipboard write: `navigator.clipboard` is absent in insecure contexts/older browsers,
+  and some engines throw synchronously rather than rejecting — either way `lyra-copy` still fires
+  with the intended text so a consumer can always show its own confirmation/fallback UI.
+
+---
+
 ## `lyra-split`
 
 Resizable panels for dashboard layouts. Direct **light-DOM children are the panels**; a divider is
@@ -2752,10 +2800,11 @@ the control still has an accessible name.
 background), `thumb` (the circular knob that slides across the track), `label` (wrapper around the
 default slot)
 
-**Themeable custom properties:** `--track-inline-size` (default `2.25rem`), `--track-block-size`
-(default `1.25rem`), `--thumb-offset` (default `2px`) — component-local geometry knobs, set on
-`:host`, since a fully-rounded pill/thumb needs a radius well past the shared `--lyra-radius`
-default — plus shared tokens `--lyra-space-s`, `--lyra-color-border/-brand/-surface/-text`,
+**Themeable custom properties:** `--lyra-switch-track-inline-size` (default `2.25rem`),
+`--lyra-switch-track-block-size` (default `1.25rem`), `--lyra-switch-thumb-offset` (default
+`2px`) — component-local geometry knobs, set on `:host`, since a fully-rounded pill/thumb needs
+a radius well past the shared `--lyra-radius` default — plus shared tokens
+`--lyra-space-s`, `--lyra-color-border/-brand/-surface/-text`,
 `--lyra-transition-fast`, `--lyra-focus-ring-width/-color/-offset`, `--lyra-opacity-disabled`.
 
 **Optional peer deps:** none.
@@ -2988,9 +3037,8 @@ produced HTML in a single pass (no second DOM walk after insertion).
   the page already finished loading); falls back to the normal async path (with its brief
   plain-text-fallback first paint) when the cache isn't warm yet. `false` (the default) is
   byte-identical to always taking the async path
-- `streaming: boolean = false` (reflected) — forward-compatible hint for a future streaming renderer
-  expected to build on this component (coalescing partial tokens as they arrive); setting it has no
-  rendering effect yet, it only lets a consumer already target `lyra-markdown[streaming]` in CSS
+- `streaming: boolean = false` (reflected) — reserved hint for a host-provided streaming renderer;
+  setting it has no rendering effect, but lets a consumer target `lyra-markdown[streaming]` in CSS
 
 **Events:** `lyra-link-click` (`detail: { href: string, internal: true }`, fired — with the click
 prevented — when a rendered link's `href` starts with `internal-link-prefix`; ordinary external
@@ -3326,10 +3374,9 @@ shell around it.
   `<lyra-json-viewer>` fallback)
 - `args: unknown` (property only, no attribute) — the tool call's original arguments, if available,
   handed to the matched renderer's `render()` alongside `result`
-- `fallback: string = 'json'` (reflected) — forward-compatible fallback-kind selector; only `"json"`
-  (an unconditional `<lyra-json-viewer>`) is implemented today, but the property/attribute is still
-  accepted so markup that already sets `fallback="…"` for a future value doesn't need to change again
-  once more fallback kinds land
+- `fallback: string = 'json'` (reflected) — fallback-kind selector; only `"json"` (an unconditional
+  `<lyra-json-viewer>`) is currently implemented, but other values are accepted and use the same
+  JSON fallback
 
 **Events:** `lyra-render-error` (`detail: { toolName: string; error: unknown }`) — fired immediately
 before falling back to `<lyra-json-viewer>`, whether because no renderer matched, a candidate
@@ -3877,9 +3924,8 @@ invention (no Web Awesome equivalent).
   which is only a safe identity while `items` never reorders/inserts/removes — provide this whenever
   possible, or scroll position and per-row DOM state (e.g. an `<audio>` element's playback position)
   can attach to the wrong row across a mutation.
-- `groups?: VirtualListGroup[]` (attribute: false) — reserved for a future sticky-header sectioning
-  feature; accepted but **not currently read or rendered** — every row still renders flat, in `items`
-  order.
+- `groups?: VirtualListGroup[]` (attribute: false) — accepted for compatibility but **not currently
+  read or rendered** — every row still renders flat, in `items` order.
 - `rowHeight: string = 'auto'` (attribute `row-height`) — `'auto'` measures each row's real height via
   `ResizeObserver`; a numeric string (e.g. `"56"`) fixes every row to that many pixels. Anything else
   (non-numeric, zero, negative, non-finite) silently falls back to `'auto'` rather than throwing.
@@ -3895,10 +3941,11 @@ invention (no Web Awesome equivalent).
   fires `lyra-load-more` (gated by `loading`).
 
 **Exported types:** `VirtualListRange { start: number; end: number }` (the `lyra-visible-range-changed`
-detail shape); `VirtualListGroup { key: string | number; label?: string; startIndex: number }` — a
-placeholder shape for the not-yet-implemented grouping feature above. No exported helper functions ship
-in this pass (a paired `groupByRecency()` helper referenced in the source's own class doc doesn't exist
-yet).
+detail shape); `VirtualListGroup { key: string | number; label?: string; startIndex: number }` — an
+accepted grouping shape that the list does not currently render.
+The package root also exports `groupByRecency(items, options?)`, a DOM-free helper that returns
+non-empty Today/Yesterday/Previous 7 Days/Older buckets, preserves input order within each bucket,
+and accepts a timestamp extractor, reference date, and label overrides.
 
 **Events:** `lyra-load-more` (no detail — fired once per approach to the bottom of the list while
 `has-more` is true and `loading` is false; does not refire on every scroll tick while still near the
@@ -4002,7 +4049,7 @@ component — not fired when the trimmed draft is empty or unchanged from the or
 as an implicit cancel)
 
 **Slots:** `actions` — overflow/icon-button controls rendered at the trailing edge of the row (e.g. a
-future pin/delete button); only visually shown once it actually has assigned elements.
+pin/delete control); only visually shown once it actually has assigned elements.
 
 **CSS parts:** `base`, `option`, `content`, `title`, `title-input`, `rename-button`, `excerpt`,
 `timestamp`, `actions`
@@ -4667,6 +4714,22 @@ component only lays out whatever is slotted and can't inspect or fix up a consum
   across the move — `disconnectedCallback`/`connectedCallback` fire back-to-back with no update in
   between, so `willUpdate()` alone wouldn't otherwise notice.
 
+### `lyra-app-rail-item`
+
+An explicit navigation item for `<lyra-app-rail>`. It renders an accessible link when `href` is
+set and enabled, otherwise a button; the rail can add its `icon-only` presentation state without
+removing the label from the accessibility tree.
+
+**Properties:** `href: string = ''`, `target: string = ''`, and `disabled: boolean = false`
+(reflected). A disabled item remains visible but cannot be activated.
+
+**Slots:** default (the visible label), `icon` (the leading icon, hidden from assistive technology
+when the item has an explicit `aria-label`).
+
+**CSS parts:** `base`, `icon`, `label`.
+
+**Optional peer deps:** none.
+
 ---
 
 ## `lyra-responsive-panel`

package/llms.txt

@@ -17,20 +17,20 @@ Awesome-themed app and works standalone with no theme at all.
   events, slots, CSS parts, themeable custom properties, optional peer deps, usage snippets, and
   known gotchas) for every tag in the library — the primary resource for a coding assistant
   integrating `@aceshooting/lyra-ui`.
-- [README.md](./README.md): Install instructions, the full tag/tier table, `<wa-*>` →
+- [README.md](./README.md): Install instructions, the full component catalog, `<wa-*>` →
   `<lyra-*>` migration notes, theming, and package-level development commands.
 
-## Component tiers
+## Component categories
 
-The library shipped in six incremental batches; `llms-full.txt` is ordered the same way:
+The catalog is grouped by capability; `llms-full.txt` follows the same consumer-facing order:
 
-- **v1 core** — form controls, toasts, sparkline, and flags: `lyra-combobox`/`lyra-option`,
+- **Form controls, toasts, sparkline, and flags** — `lyra-combobox`/`lyra-option`,
   `lyra-select` (a closed-list, button-trigger single-select sharing `lyra-option` with
   `lyra-combobox`), `lyra-date-picker`/`lyra-date-input`, `lyra-toast`/`lyra-toast-item`/`toast()`,
   `lyra-sparkline`, `lyra-flag` (needs the optional peer `@aceshooting/lyra-flags`).
 - **Dashboard atoms** — first-party, no-Web-Awesome-equivalent building blocks for dashboards:
   `lyra-empty`, `lyra-skeleton`, `lyra-stat`, `lyra-table`, `lyra-gauge`, `lyra-export-button`,
-  `lyra-split`, `lyra-widget`, `lyra-word-cloud` (zero-dependency SVG word/tag cloud).
+  `lyra-copy-button`, `lyra-split`, `lyra-widget`, `lyra-word-cloud` (zero-dependency SVG word/tag cloud).
 - **Temporal & graph** — time-series and hierarchy/network widgets: `lyra-time-range`,
   `lyra-playback`, `lyra-heatmap` (matrix and calendar layouts), `lyra-graph` (needs the optional peer
   deps `d3-force`/`d3-drag`/`d3-zoom`/`d3-selection`), `lyra-tree`/`lyra-tree-node`.
@@ -54,7 +54,7 @@ The library shipped in six incremental batches; `llms-full.txt` is ordered the s
   (form-associated), `lyra-attachment-chip`, `lyra-stream-status`, `lyra-virtual-list`,
   `lyra-conversation-item`, `lyra-model-select`, `lyra-slider` (form-associated),
   `lyra-tool-select-dialog`, `lyra-citation-badge`, `lyra-source-list`/`lyra-source-card`,
-  `lyra-app-rail`, `lyra-responsive-panel`, `lyra-mention-popover`, `lyra-streaming-text`,
+  `lyra-app-rail`/`lyra-app-rail-item`, `lyra-responsive-panel`, `lyra-mention-popover`, `lyra-streaming-text`,
   `lyra-thinking-panel`, `lyra-generation-status`, `lyra-code-block` (needs the optional peer
   `shiki`), `lyra-tool-approval-dialog`, `lyra-tool-param-form`, `lyra-menu`/`lyra-menu-item`,
   `lyra-chip`/`lyra-chip-group`, `lyra-model-settings-panel`, `lyra-context-meter`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aceshooting/lyra-ui",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Free, clean-room Lit web components — a companion to Web Awesome.",
   "keywords": [
     "web-components",
@@ -52,8 +52,178 @@
     "./internal/*": "./dist/internal/*"
   },
   "sideEffects": [
-    "**/components/**/*.js",
-    "**/components/**/*.ts",
+    "./dist/components/app-rail/app-rail-item.js",
+    "./dist/components/app-rail/app-rail.js",
+    "./dist/components/attachment-chip/attachment-chip.js",
+    "./dist/components/attachment-trigger/attachment-trigger.js",
+    "./dist/components/chart/bar-chart.js",
+    "./dist/components/chart/box-plot.js",
+    "./dist/components/chart/bubble-chart.js",
+    "./dist/components/chart/chart.js",
+    "./dist/components/chart/doughnut-chart.js",
+    "./dist/components/chart/histogram.js",
+    "./dist/components/chart/line-chart.js",
+    "./dist/components/chart/lite-chart.js",
+    "./dist/components/chart/pie-chart.js",
+    "./dist/components/chart/polar-area-chart.js",
+    "./dist/components/chart/radar-chart.js",
+    "./dist/components/chart/scatter-chart.js",
+    "./dist/components/chat-composer/chat-composer.js",
+    "./dist/components/chat-message/chat-message.js",
+    "./dist/components/checkbox/checkbox.js",
+    "./dist/components/chip/chip-group.js",
+    "./dist/components/chip/chip.js",
+    "./dist/components/citation-badge/citation-badge.js",
+    "./dist/components/code-block/code-block.js",
+    "./dist/components/combobox/combobox.js",
+    "./dist/components/combobox/option.js",
+    "./dist/components/context-meter/context-meter.js",
+    "./dist/components/conversation-item/conversation-item.js",
+    "./dist/components/copy-button/copy-button.js",
+    "./dist/components/date-picker/date-input.js",
+    "./dist/components/date-picker/date-picker.js",
+    "./dist/components/dialog/dialog.js",
+    "./dist/components/dock-panel/dock-panel.js",
+    "./dist/components/document-preview/document-preview.js",
+    "./dist/components/empty/empty.js",
+    "./dist/components/export-button/export-button.js",
+    "./dist/components/file-input/file-input.js",
+    "./dist/components/flag/flag.js",
+    "./dist/components/gauge/gauge.js",
+    "./dist/components/generation-status/generation-status.js",
+    "./dist/components/graph/graph.js",
+    "./dist/components/heatmap/heatmap.js",
+    "./dist/components/json-viewer/json-viewer.js",
+    "./dist/components/kbd/kbd.js",
+    "./dist/components/live-region/live-region.js",
+    "./dist/components/map/map.js",
+    "./dist/components/markdown/markdown.js",
+    "./dist/components/media-card/media-card.js",
+    "./dist/components/mention-popover/mention-popover.js",
+    "./dist/components/menu/menu-item.js",
+    "./dist/components/menu/menu.js",
+    "./dist/components/model-select/model-select.js",
+    "./dist/components/model-settings-panel/model-settings-panel.js",
+    "./dist/components/playback/playback.js",
+    "./dist/components/responsive-panel/responsive-panel.js",
+    "./dist/components/result-card/result-card.js",
+    "./dist/components/result-card/result-field.js",
+    "./dist/components/select/select.js",
+    "./dist/components/skeleton/skeleton.js",
+    "./dist/components/slider/slider.js",
+    "./dist/components/source-card/source-card.js",
+    "./dist/components/source-list/source-list.js",
+    "./dist/components/sparkline/sparkline.js",
+    "./dist/components/split/split.js",
+    "./dist/components/stat/stat.js",
+    "./dist/components/stream-status/stream-status.js",
+    "./dist/components/streaming-text/streaming-text.js",
+    "./dist/components/switch/switch.js",
+    "./dist/components/table/table.js",
+    "./dist/components/tabs/tabs.js",
+    "./dist/components/thinking-panel/thinking-panel.js",
+    "./dist/components/time-range/time-range.js",
+    "./dist/components/toast/toast-item.js",
+    "./dist/components/toast/toast.js",
+    "./dist/components/tool-approval-dialog/tool-approval-dialog.js",
+    "./dist/components/tool-call-chip/tool-call-chip.js",
+    "./dist/components/tool-param-form/tool-param-form.js",
+    "./dist/components/tool-result-dialog/tool-result-dialog.js",
+    "./dist/components/tool-result-view/tool-result-view.js",
+    "./dist/components/tool-select-dialog/tool-select-dialog.js",
+    "./dist/components/tree/tree-node.js",
+    "./dist/components/tree/tree.js",
+    "./dist/components/typing-indicator/typing-indicator.js",
+    "./dist/components/virtual-list/virtual-list.js",
+    "./dist/components/widget/widget.js",
+    "./dist/components/word-cloud/word-cloud.js",
+    "./dist/components/flag/flag-peer.js",
+    "./src/components/app-rail/app-rail-item.ts",
+    "./src/components/app-rail/app-rail.ts",
+    "./src/components/attachment-chip/attachment-chip.ts",
+    "./src/components/attachment-trigger/attachment-trigger.ts",
+    "./src/components/chart/bar-chart.ts",
+    "./src/components/chart/box-plot.ts",
+    "./src/components/chart/bubble-chart.ts",
+    "./src/components/chart/chart.ts",
+    "./src/components/chart/doughnut-chart.ts",
+    "./src/components/chart/histogram.ts",
+    "./src/components/chart/line-chart.ts",
+    "./src/components/chart/lite-chart.ts",
+    "./src/components/chart/pie-chart.ts",
+    "./src/components/chart/polar-area-chart.ts",
+    "./src/components/chart/radar-chart.ts",
+    "./src/components/chart/scatter-chart.ts",
+    "./src/components/chat-composer/chat-composer.ts",
+    "./src/components/chat-message/chat-message.ts",
+    "./src/components/checkbox/checkbox.ts",
+    "./src/components/chip/chip-group.ts",
+    "./src/components/chip/chip.ts",
+    "./src/components/citation-badge/citation-badge.ts",
+    "./src/components/code-block/code-block.ts",
+    "./src/components/combobox/combobox.ts",
+    "./src/components/combobox/option.ts",
+    "./src/components/context-meter/context-meter.ts",
+    "./src/components/conversation-item/conversation-item.ts",
+    "./src/components/copy-button/copy-button.ts",
+    "./src/components/date-picker/date-input.ts",
+    "./src/components/date-picker/date-picker.ts",
+    "./src/components/dialog/dialog.ts",
+    "./src/components/dock-panel/dock-panel.ts",
+    "./src/components/document-preview/document-preview.ts",
+    "./src/components/empty/empty.ts",
+    "./src/components/export-button/export-button.ts",
+    "./src/components/file-input/file-input.ts",
+    "./src/components/flag/flag.ts",
+    "./src/components/gauge/gauge.ts",
+    "./src/components/generation-status/generation-status.ts",
+    "./src/components/graph/graph.ts",
+    "./src/components/heatmap/heatmap.ts",
+    "./src/components/json-viewer/json-viewer.ts",
+    "./src/components/kbd/kbd.ts",
+    "./src/components/live-region/live-region.ts",
+    "./src/components/map/map.ts",
+    "./src/components/markdown/markdown.ts",
+    "./src/components/media-card/media-card.ts",
+    "./src/components/mention-popover/mention-popover.ts",
+    "./src/components/menu/menu-item.ts",
+    "./src/components/menu/menu.ts",
+    "./src/components/model-select/model-select.ts",
+    "./src/components/model-settings-panel/model-settings-panel.ts",
+    "./src/components/playback/playback.ts",
+    "./src/components/responsive-panel/responsive-panel.ts",
+    "./src/components/result-card/result-card.ts",
+    "./src/components/result-card/result-field.ts",
+    "./src/components/select/select.ts",
+    "./src/components/skeleton/skeleton.ts",
+    "./src/components/slider/slider.ts",
+    "./src/components/source-card/source-card.ts",
+    "./src/components/source-list/source-list.ts",
+    "./src/components/sparkline/sparkline.ts",
+    "./src/components/split/split.ts",
+    "./src/components/stat/stat.ts",
+    "./src/components/stream-status/stream-status.ts",
+    "./src/components/streaming-text/streaming-text.ts",
+    "./src/components/switch/switch.ts",
+    "./src/components/table/table.ts",
+    "./src/components/tabs/tabs.ts",
+    "./src/components/thinking-panel/thinking-panel.ts",
+    "./src/components/time-range/time-range.ts",
+    "./src/components/toast/toast-item.ts",
+    "./src/components/toast/toast.ts",
+    "./src/components/tool-approval-dialog/tool-approval-dialog.ts",
+    "./src/components/tool-call-chip/tool-call-chip.ts",
+    "./src/components/tool-param-form/tool-param-form.ts",
+    "./src/components/tool-result-dialog/tool-result-dialog.ts",
+    "./src/components/tool-result-view/tool-result-view.ts",
+    "./src/components/tool-select-dialog/tool-select-dialog.ts",
+    "./src/components/tree/tree-node.ts",
+    "./src/components/tree/tree.ts",
+    "./src/components/typing-indicator/typing-indicator.ts",
+    "./src/components/virtual-list/virtual-list.ts",
+    "./src/components/widget/widget.ts",
+    "./src/components/word-cloud/word-cloud.ts",
+    "./src/components/flag/flag-peer.ts",
     "./dist/lyra.js",
     "./src/lyra.ts"
   ],
@@ -143,11 +313,19 @@
   },
   "customElements": "custom-elements.json",
   "scripts": {
-    "build": "rm -rf dist && tsc -p tsconfig.json",
+    "build": "node scripts/build.mjs",
     "test": "wtr",
+    "test:platform": "wtr src/internal/form-associated.test.ts src/components/dialog/dialog.test.ts src/components/combobox/combobox.test.ts src/components/table/table.test.ts src/components/virtual-list/virtual-list.test.ts",
+    "test:coverage": "WTR_COVERAGE=1 wtr src/internal/form-associated.test.ts src/components/dialog/dialog.test.ts src/components/combobox/combobox.test.ts src/components/table/table.test.ts src/components/virtual-list/virtual-list.test.ts",
     "test:watch": "wtr --watch",
+    "test:architecture": "node scripts/check-registration-architecture.mjs",
+    "test:types": "tsc --noEmit -p tsconfig.type-tests.json",
+    "style-policy": "node scripts/check-style-policy.mjs",
+    "provenance-policy": "node scripts/check-provenance.mjs",
+    "contract-checklist": "node scripts/check-contract-checklist.mjs",
     "manifest": "cem analyze --litelement --outdir .",
     "manifest:check": "node scripts/check-manifest.mjs",
-    "lint": "tsc --noEmit -p tsconfig.json"
+    "contract-policy": "pnpm run style-policy && pnpm run provenance-policy && pnpm run contract-checklist && pnpm run manifest:check && pnpm run test:architecture",
+    "lint": "pnpm run contract-policy && tsc --noEmit -p tsconfig.json"
   }
 }