@aceshooting/lyra-ui 2.0.0 → 2.1.0

package/dist/components/attachment-chip/attachment-chip.d.ts

@@ -1,4 +1,4 @@
-import { type TemplateResult, type PropertyValues } from 'lit';
+import { type TemplateResult } from 'lit';
 import { LyraElement } from '../../internal/lyra-element.js';
 export type AttachmentChipStatus = 'pending' | 'uploading' | 'error' | 'done';
 export interface AttachmentChipIdDetail {
@@ -25,9 +25,9 @@ export declare function formatFileSize(bytes: number): string;
  *    (e.g. after a page reload, when no real `File` object exists any more).
  *
  * `file` always wins when both are present — see each accessor's own doc.
- * The image thumbnail for a real `File` is a lazily-created (only once the
- * thumbnail is actually about to render, not eagerly on assignment)
- * `URL.createObjectURL()` blob URL, revoked automatically once `file`
+ * The image thumbnail for a real `File` is a cached `URL.createObjectURL()`
+ * blob URL, created in the update lifecycle immediately before the thumbnail
+ * renders and revoked automatically once `file`
  * changes away from the object it was created for, and on disconnect — this
  * component never leaks a blob URL.
  *
@@ -43,6 +43,16 @@ export declare function formatFileSize(bytes: number): string;
  * consumer to invent one. When neither is available, a generated internal id
  * is used as a last resort so the event always has *some* id.
  *
+ * i18n/locale: every translatable word rendered by this component is
+ * override-able via a dedicated property — `removeLabel`/`retryLabel`
+ * (the verb prefixed to the remove/retry buttons' `aria-label`, keeping the
+ * `displayName` interpolation), and `uploadingLabel`/`uploadFailedLabel` (the
+ * verb/phrase used in the visible `status-text`, keeping the live percentage
+ * interpolation for `uploadingLabel`). All four default to today's exact
+ * hardcoded English text (`'Remove'`, `'Retry'`, `'Uploading'`, `'Upload
+ * failed'`), so leaving them unset changes nothing. These are plain
+ * properties, not slots — this component still exposes no slots.
+ *
  * @customElement lyra-attachment-chip
  * @event lyra-remove - The user activated the remove (×) button. `detail: { id }`. Only rendered while `removable`.
  * @event lyra-retry - The user activated the retry button. `detail: { id }`. Only rendered while `status="error"`.
@@ -51,7 +61,7 @@ export declare function formatFileSize(bytes: number): string;
  * @csspart meta - Wrapper around `name` and `size`.
  * @csspart name - The filename (ellipsis-truncated via CSS; the untruncated name is always available via the native `title` tooltip).
  * @csspart size - The human-readable formatted file size. Hidden when no size is known.
- * @csspart status-text - The visible text twin of the status accent color — carries the state in text, not just color. Empty/hidden for `pending`/`done`.
+ * @csspart status-text - The visible text twin of the status accent color — carries the state in text, not just color. Empty/hidden for `pending`/`done`. Gets `role="alert"` for `status="error"` only, so a screen-reader user not already focused on the chip still hears an upload failure; the ticking `'uploading'` readout deliberately stays out of the accessibility tree the same way `<lyra-generation-status>`'s per-second elapsed/token readout does — a live region re-announcing every progress tick would be noise, not information, while a one-shot failure is exactly the kind of infrequent, actionable transition a live region exists for.
  * @csspart progress - The numeric upload progress bar (`role="progressbar"`), shown only while `status="uploading"` and `progress` is a meaningful (>0) number.
  * @csspart progress-fill - The filled portion of `progress`.
  * @csspart spinner - The indeterminate upload spinner, shown instead of `progress` while `status="uploading"` and `progress` is unset/0.
@@ -83,6 +93,26 @@ export declare class LyraAttachmentChip extends LyraElement {
     progress: number;
     /** Shows the remove (×) button. */
     removable: boolean;
+    /** Verb used in the remove button's `aria-label`, interpolated as
+     *  `` `${removeLabel} ${displayName}` `` -- override for i18n/locale.
+     *  Defaults to `'Remove'`, reproducing today's exact `"Remove ${displayName}"`
+     *  text byte-for-byte. */
+    removeLabel: string;
+    /** Verb used in the retry button's `aria-label`, interpolated as
+     *  `` `${retryLabel} ${displayName}` `` -- override for i18n/locale.
+     *  Defaults to `'Retry'`, reproducing today's exact `"Retry ${displayName}"`
+     *  text byte-for-byte. */
+    retryLabel: string;
+    /** Verb used in the visible uploading status text -- rendered as
+     *  `` `${uploadingLabel} ${percent}%` `` once progress is a meaningful
+     *  number, else `` `${uploadingLabel}…` ``. Override for i18n/locale.
+     *  Defaults to `'Uploading'`, reproducing today's exact `"Uploading N%"`/
+     *  `"Uploading…"` text byte-for-byte. */
+    uploadingLabel: string;
+    /** Visible status text shown for `status="error"`. Override for
+     *  i18n/locale. Defaults to `'Upload failed'`, reproducing today's exact
+     *  text byte-for-byte. */
+    uploadFailedLabel: string;
     private objectUrl?;
     private objectUrlFile?;
     private readonly fallbackId;
@@ -93,14 +123,11 @@ export declare class LyraAttachmentChip extends LyraElement {
     private get hasNumericProgress();
     private get clampedProgress();
     /** Returns (creating or reusing as needed) the object URL for `file`'s
-     *  image thumbnail. Only ever called from `render()`, i.e. only once a
-     *  thumbnail is actually about to be painted -- never eagerly from a
-     *  `file`/`willUpdate`/`updated` property-change hook -- so a `file` that's
-     *  reassigned several times before the next paint never creates URLs that
-     *  are immediately thrown away unused. */
+     * image thumbnail. Called from the update lifecycle, never from `render()`,
+     * so rendering stays a pure projection of already-prepared state. */
     private ensureObjectUrl;
     private revokeObjectUrl;
-    protected updated(changed: PropertyValues): void;
+    protected willUpdate(): void;
     disconnectedCallback(): void;
     private onRemoveClick;
     private onRetryClick;

package/dist/components/attachment-chip/attachment-chip.js

@@ -5,7 +5,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { html, nothing, svg } from 'lit';
-import { property, state } from 'lit/decorators.js';
+import { property } from 'lit/decorators.js';
 import { LyraElement } from '../../internal/lyra-element.js';
 import { defineElement } from '../../internal/prefix.js';
 import { nextId } from '../../internal/a11y.js';
@@ -78,12 +78,20 @@ export function formatFileSize(bytes) {
     return `${value.toFixed(1)} ${BYTE_UNITS[unitIndex]}`;
 }
 /** Visible (not just color-coded) text for every non-resting status --
- *  `'pending'`/`'done'` render nothing here, they're resting states. */
-function statusText(status, progress) {
+ *  `'pending'`/`'done'` render nothing here, they're resting states.
+ *  `clampedProgress` (not the raw `progress`) is what gets displayed, so the
+ *  percentage shown here can never drift from the progressbar's own
+ *  `aria-valuenow`/fill-width, which reads from the same clamped value.
+ *  `uploadingLabel`/`uploadFailedLabel` are the host's (possibly overridden)
+ *  verb/phrase -- defaulting to `'Uploading'`/`'Upload failed'` reproduces
+ *  today's exact hardcoded text byte-for-byte. */
+function statusText(status, progress, clampedProgress, uploadingLabel, uploadFailedLabel) {
     if (status === 'error')
-        return 'Upload failed';
+        return uploadFailedLabel;
     if (status === 'uploading') {
-        return Number.isFinite(progress) && progress > 0 ? `Uploading ${Math.round(Math.min(100, progress))}%` : 'Uploading…';
+        return Number.isFinite(progress) && progress > 0
+            ? `${uploadingLabel} ${Math.round(clampedProgress)}%`
+            : `${uploadingLabel}…`;
     }
     return '';
 }
@@ -101,9 +109,9 @@ function statusText(status, progress) {
  *    (e.g. after a page reload, when no real `File` object exists any more).
  *
  * `file` always wins when both are present — see each accessor's own doc.
- * The image thumbnail for a real `File` is a lazily-created (only once the
- * thumbnail is actually about to render, not eagerly on assignment)
- * `URL.createObjectURL()` blob URL, revoked automatically once `file`
+ * The image thumbnail for a real `File` is a cached `URL.createObjectURL()`
+ * blob URL, created in the update lifecycle immediately before the thumbnail
+ * renders and revoked automatically once `file`
  * changes away from the object it was created for, and on disconnect — this
  * component never leaks a blob URL.
  *
@@ -119,6 +127,16 @@ function statusText(status, progress) {
  * consumer to invent one. When neither is available, a generated internal id
  * is used as a last resort so the event always has *some* id.
  *
+ * i18n/locale: every translatable word rendered by this component is
+ * override-able via a dedicated property — `removeLabel`/`retryLabel`
+ * (the verb prefixed to the remove/retry buttons' `aria-label`, keeping the
+ * `displayName` interpolation), and `uploadingLabel`/`uploadFailedLabel` (the
+ * verb/phrase used in the visible `status-text`, keeping the live percentage
+ * interpolation for `uploadingLabel`). All four default to today's exact
+ * hardcoded English text (`'Remove'`, `'Retry'`, `'Uploading'`, `'Upload
+ * failed'`), so leaving them unset changes nothing. These are plain
+ * properties, not slots — this component still exposes no slots.
+ *
  * @customElement lyra-attachment-chip
  * @event lyra-remove - The user activated the remove (×) button. `detail: { id }`. Only rendered while `removable`.
  * @event lyra-retry - The user activated the retry button. `detail: { id }`. Only rendered while `status="error"`.
@@ -127,7 +145,7 @@ function statusText(status, progress) {
  * @csspart meta - Wrapper around `name` and `size`.
  * @csspart name - The filename (ellipsis-truncated via CSS; the untruncated name is always available via the native `title` tooltip).
  * @csspart size - The human-readable formatted file size. Hidden when no size is known.
- * @csspart status-text - The visible text twin of the status accent color — carries the state in text, not just color. Empty/hidden for `pending`/`done`.
+ * @csspart status-text - The visible text twin of the status accent color — carries the state in text, not just color. Empty/hidden for `pending`/`done`. Gets `role="alert"` for `status="error"` only, so a screen-reader user not already focused on the chip still hears an upload failure; the ticking `'uploading'` readout deliberately stays out of the accessibility tree the same way `<lyra-generation-status>`'s per-second elapsed/token readout does — a live region re-announcing every progress tick would be noise, not information, while a one-shot failure is exactly the kind of infrequent, actionable transition a live region exists for.
  * @csspart progress - The numeric upload progress bar (`role="progressbar"`), shown only while `status="uploading"` and `progress` is a meaningful (>0) number.
  * @csspart progress-fill - The filled portion of `progress`.
  * @csspart spinner - The indeterminate upload spinner, shown instead of `progress` while `status="uploading"` and `progress` is unset/0.
@@ -156,6 +174,26 @@ export class LyraAttachmentChip extends LyraElement {
         this.progress = 0;
         /** Shows the remove (×) button. */
         this.removable = true;
+        /** Verb used in the remove button's `aria-label`, interpolated as
+         *  `` `${removeLabel} ${displayName}` `` -- override for i18n/locale.
+         *  Defaults to `'Remove'`, reproducing today's exact `"Remove ${displayName}"`
+         *  text byte-for-byte. */
+        this.removeLabel = 'Remove';
+        /** Verb used in the retry button's `aria-label`, interpolated as
+         *  `` `${retryLabel} ${displayName}` `` -- override for i18n/locale.
+         *  Defaults to `'Retry'`, reproducing today's exact `"Retry ${displayName}"`
+         *  text byte-for-byte. */
+        this.retryLabel = 'Retry';
+        /** Verb used in the visible uploading status text -- rendered as
+         *  `` `${uploadingLabel} ${percent}%` `` once progress is a meaningful
+         *  number, else `` `${uploadingLabel}…` ``. Override for i18n/locale.
+         *  Defaults to `'Uploading'`, reproducing today's exact `"Uploading N%"`/
+         *  `"Uploading…"` text byte-for-byte. */
+        this.uploadingLabel = 'Uploading';
+        /** Visible status text shown for `status="error"`. Override for
+         *  i18n/locale. Defaults to `'Upload failed'`, reproducing today's exact
+         *  text byte-for-byte. */
+        this.uploadFailedLabel = 'Upload failed';
         // Last-resort id, generated once per instance -- see the class doc's
         // "Identifying which attachment..." section.
         this.fallbackId = nextId('attachment-chip');
@@ -190,11 +228,8 @@ export class LyraAttachmentChip extends LyraElement {
         return Math.min(100, Math.max(0, this.progress));
     }
     /** Returns (creating or reusing as needed) the object URL for `file`'s
-     *  image thumbnail. Only ever called from `render()`, i.e. only once a
-     *  thumbnail is actually about to be painted -- never eagerly from a
-     *  `file`/`willUpdate`/`updated` property-change hook -- so a `file` that's
-     *  reassigned several times before the next paint never creates URLs that
-     *  are immediately thrown away unused. */
+     * image thumbnail. Called from the update lifecycle, never from `render()`,
+     * so rendering stays a pure projection of already-prepared state. */
     ensureObjectUrl(file) {
         if (this.objectUrlFile === file && this.objectUrl)
             return this.objectUrl;
@@ -209,15 +244,15 @@ export class LyraAttachmentChip extends LyraElement {
         this.objectUrl = undefined;
         this.objectUrlFile = undefined;
     }
-    updated(changed) {
-        // `file` changed to a different object (including to `undefined`) since
-        // the URL currently held was created -- it no longer represents anything
-        // this chip still shows, so revoke it now rather than waiting for a
-        // render that may never again call `ensureObjectUrl()` (e.g. the new
-        // `file` isn't an image, or is unset).
-        if (changed.has('file') && this.objectUrlFile && this.objectUrlFile !== this.file) {
+    willUpdate() {
+        // Prepare or revoke the non-reactive cache before render. This keeps URL
+        // allocation out of the render phase and also handles a file changing to
+        // a non-image or to undefined, where no thumbnail render would otherwise
+        // revisit the old cache entry.
+        if (this.file?.type.startsWith('image/'))
+            this.ensureObjectUrl(this.file);
+        else if (this.objectUrlFile)
             this.revokeObjectUrl();
-        }
     }
     disconnectedCallback() {
         super.disconnectedCallback();
@@ -226,7 +261,7 @@ export class LyraAttachmentChip extends LyraElement {
     renderThumbnail() {
         if (this.file) {
             return this.effectiveMimeType.startsWith('image/')
-                ? html `<img src=${this.ensureObjectUrl(this.file)} alt="" />`
+                ? html `<img src=${this.objectUrl ?? ''} alt="" />`
                 : html `${fileGlyph()}`;
         }
         // No `file`: `thumbnail-src` is used whenever present, regardless of
@@ -242,7 +277,7 @@ export class LyraAttachmentChip extends LyraElement {
         // distinguish a genuinely empty file from a size that was simply never
         // supplied) -- hide the part entirely rather than show a literal "0 B".
         const sizeText = this.effectiveSize > 0 ? formatFileSize(this.effectiveSize) : '';
-        const text = statusText(this.status, this.progress);
+        const text = statusText(this.status, this.progress, this.clampedProgress, this.uploadingLabel, this.uploadFailedLabel);
         const uploading = this.status === 'uploading';
         return html `
       <div part="base">
@@ -250,7 +285,7 @@ export class LyraAttachmentChip extends LyraElement {
         <span part="meta">
           <span part="name" title=${name || 'Untitled file'}>${displayName}</span>
           <span part="size" ?hidden=${!sizeText}>${sizeText || nothing}</span>
-          <span part="status-text" ?hidden=${!text}>${text || nothing}</span>
+          <span part="status-text" role=${this.status === 'error' ? 'alert' : nothing} ?hidden=${!text}>${text || nothing}</span>
         </span>
         ${uploading
             ? this.hasNumericProgress
@@ -269,12 +304,12 @@ export class LyraAttachmentChip extends LyraElement {
                 : html `<span part="spinner" role="status" aria-label=${`Uploading ${displayName}`}></span>`
             : nothing}
         ${this.status === 'error'
-            ? html `<button part="retry-button" type="button" aria-label=${`Retry ${displayName}`} @click=${this.onRetryClick}>
+            ? html `<button part="retry-button" type="button" aria-label=${`${this.retryLabel} ${displayName}`} @click=${this.onRetryClick}>
               ${retryIcon()}
             </button>`
             : nothing}
         ${this.removable
-            ? html `<button part="remove-button" type="button" aria-label=${`Remove ${displayName}`} @click=${this.onRemoveClick}>
+            ? html `<button part="remove-button" type="button" aria-label=${`${this.removeLabel} ${displayName}`} @click=${this.onRemoveClick}>
               ${closeIcon()}
             </button>`
             : nothing}
@@ -307,6 +342,15 @@ __decorate([
     property({ type: Boolean, reflect: true })
 ], LyraAttachmentChip.prototype, "removable", void 0);
 __decorate([
-    state()
-], LyraAttachmentChip.prototype, "objectUrl", void 0);
+    property({ attribute: 'remove-label' })
+], LyraAttachmentChip.prototype, "removeLabel", void 0);
+__decorate([
+    property({ attribute: 'retry-label' })
+], LyraAttachmentChip.prototype, "retryLabel", void 0);
+__decorate([
+    property({ attribute: 'uploading-label' })
+], LyraAttachmentChip.prototype, "uploadingLabel", void 0);
+__decorate([
+    property({ attribute: 'upload-failed-label' })
+], LyraAttachmentChip.prototype, "uploadFailedLabel", void 0);
 defineElement('attachment-chip', LyraAttachmentChip);

package/dist/components/attachment-trigger/attachment-trigger.d.ts

@@ -50,6 +50,12 @@ export interface AttachmentPickDetail {
  * actual capture flow.
  * @csspart trigger - The single-capability icon button. Only rendered when `capabilities.length === 1`.
  * @csspart menu - The `<lyra-menu>` wrapper. Only rendered when `capabilities.length > 1`.
+ * @csspart menu-trigger - The multi-capability button slotted into `<lyra-menu>`'s own `trigger` slot. Only rendered when `capabilities.length > 1`.
+ * @csspart expand-icon - The disclosure chevron inside the multi-capability trigger button. Only rendered when `capabilities.length > 1`.
+ *
+ * `triggerLabel` lets a host override the single-capability trigger button's
+ * `aria-label` (i18n) — see that property's own doc for exactly what it
+ * does and doesn't affect.
  */
 export declare class LyraAttachmentTrigger extends LyraElement {
     static styles: import("lit").CSSResultGroup[];
@@ -60,6 +66,13 @@ export declare class LyraAttachmentTrigger extends LyraElement {
      *  `'.pdf,.docx'`), forwarded to the hidden file input for the
      *  `files`/`image` capabilities — see the class doc for how each uses it. */
     accept: string;
+    /** Overrides the single-capability trigger button's `aria-label`, which
+     *  otherwise comes from `CAPABILITY_META[capability].triggerLabel` (e.g.
+     *  `'Attach files'`). Set this to localize the accessible name; leave it
+     *  unset to keep the built-in English default. Only affects the
+     *  single-capability button ([part='trigger']) — the multi-capability
+     *  menu's own trigger keeps its fixed `'Add attachment'` label regardless. */
+    triggerLabel?: string;
     /** Forwarded to the hidden file input's own `multiple` attribute. */
     multiple: boolean;
     disabled: boolean;

package/dist/components/attachment-trigger/attachment-trigger.js

@@ -8,6 +8,7 @@ import { html, nothing, svg } from 'lit';
 import { property, query } from 'lit/decorators.js';
 import { LyraElement } from '../../internal/lyra-element.js';
 import { defineElement } from '../../internal/prefix.js';
+import { chevronIcon } from '../../internal/icons.js';
 import { styles } from './attachment-trigger.styles.js';
 import '../menu/menu.js';
 import '../menu/menu-item.js';
@@ -104,6 +105,12 @@ const CAPABILITY_META = {
  * actual capture flow.
  * @csspart trigger - The single-capability icon button. Only rendered when `capabilities.length === 1`.
  * @csspart menu - The `<lyra-menu>` wrapper. Only rendered when `capabilities.length > 1`.
+ * @csspart menu-trigger - The multi-capability button slotted into `<lyra-menu>`'s own `trigger` slot. Only rendered when `capabilities.length > 1`.
+ * @csspart expand-icon - The disclosure chevron inside the multi-capability trigger button. Only rendered when `capabilities.length > 1`.
+ *
+ * `triggerLabel` lets a host override the single-capability trigger button's
+ * `aria-label` (i18n) — see that property's own doc for exactly what it
+ * does and doesn't affect.
  */
 export class LyraAttachmentTrigger extends LyraElement {
     constructor() {
@@ -198,7 +205,7 @@ export class LyraAttachmentTrigger extends LyraElement {
         part="trigger"
         class="trigger-button"
         type="button"
-        aria-label=${meta.triggerLabel}
+        aria-label=${this.triggerLabel ?? meta.triggerLabel}
         ?disabled=${this.disabled}
         @click=${this.onTriggerClick}
       >
@@ -211,12 +218,14 @@ export class LyraAttachmentTrigger extends LyraElement {
       <lyra-menu part="menu" label="Add attachment" @lyra-menu-select=${this.onMenuSelect}>
         <button
           slot="trigger"
+          part="menu-trigger"
           class="trigger-button"
           type="button"
           aria-label="Add attachment"
           ?disabled=${this.disabled}
         >
           ${paperclipIcon()}
+          <span part="expand-icon" aria-hidden="true">${chevronIcon()}</span>
         </button>
         ${this.capabilities.map((capability) => {
             const meta = CAPABILITY_META[capability];
@@ -246,6 +255,9 @@ __decorate([
 __decorate([
     property()
 ], LyraAttachmentTrigger.prototype, "accept", void 0);
+__decorate([
+    property({ attribute: 'trigger-label' })
+], LyraAttachmentTrigger.prototype, "triggerLabel", void 0);
 __decorate([
     property({ type: Boolean, reflect: true })
 ], LyraAttachmentTrigger.prototype, "multiple", void 0);

package/dist/components/attachment-trigger/attachment-trigger.styles.js

@@ -11,12 +11,13 @@ export const styles = css `
   }
 
   /* Shared visual treatment for both the single-capability button
-     ([part='trigger']) and the multi-capability button slotted into
-     lyra-menu's own trigger slot -- the latter can't itself carry
-     part='trigger' (that name is reserved for the single-capability case,
-     so a consumer's ::part(trigger) selector unambiguously targets exactly
-     one button), so both buttons share this plain class instead of
-     duplicating the same declaration block twice. */
+     ([part='trigger']) and the multi-capability button ([part='menu-trigger'])
+     slotted into lyra-menu's own trigger slot -- the latter can't reuse
+     part='trigger' itself (that name is reserved for the single-capability
+     case, so a consumer's ::part(trigger) selector unambiguously targets
+     exactly one button), so both buttons share this plain class for the
+     declarations that genuinely are identical, on top of each one's own
+     distinct part name. */
   .trigger-button {
     display: inline-flex;
     flex: 0 0 auto;
@@ -60,6 +61,27 @@ export const styles = css `
     display: block;
   }
 
+  /* [part='menu-trigger'] carries a second glyph (the paperclip plus this
+     disclosure chevron) alongside the single-capability [part='trigger']'s
+     one, so it alone needs a gap between them. */
+  [part='menu-trigger'] {
+    gap: var(--lyra-space-xs);
+  }
+
+  /* Disclosure cue for the multi-capability trigger, matching
+     lyra-combobox/lyra-select's own [part='expand-icon'] convention (same
+     chevronIcon() rotated to point down) -- but sized down from their
+     dedicated-touch-target treatment since here it's a second glyph inside
+     one already-compact icon button, not its own separate control. */
+  [part='expand-icon'] {
+    display: inline-flex;
+    flex: 0 0 auto;
+    font-size: 0.75em;
+  }
+  [part='expand-icon'] svg {
+    transform: rotate(90deg);
+  }
+
   @media (prefers-reduced-motion: reduce) {
     .trigger-button {
       transition: none !important;

package/dist/components/chart/bar-chart.js

@@ -1,4 +1,4 @@
-import { LyraChart } from './chart.js';
+import { LyraChart, lockChartType } from './chart.js';
 import { defineElement } from '../../internal/prefix.js';
 /**
  * `<lyra-bar-chart>` — `<lyra-chart>` with `type` locked to `"bar"`.
@@ -7,21 +7,5 @@ import { defineElement } from '../../internal/prefix.js';
  */
 export class LyraBarChart extends LyraChart {
 }
-// `type` is locked read-only rather than a settable class field with just a
-// default value — `LyraChart` declares it as a plain (decorator-managed)
-// class field, and TypeScript forbids a subclass from re-declaring a base
-// field as a getter/setter pair via ordinary class syntax (TS2611) — so the
-// accessor pair is installed directly on the prototype instead, which is
-// runtime-equivalent (same shadowing semantics as a class-syntax override)
-// without tripping that check.
-Object.defineProperty(LyraBarChart.prototype, 'type', {
-    configurable: true,
-    enumerable: true,
-    get() {
-        return 'bar';
-    },
-    set(_v) {
-        /* locked to 'bar'; direct writes are ignored */
-    },
-});
+lockChartType(LyraBarChart, 'bar');
 defineElement('bar-chart', LyraBarChart);

package/dist/components/chart/box-plot.d.ts

@@ -19,7 +19,11 @@ export interface BoxPlotSeries {
  * Awesome's chart set — useful for summarizing distributions.
  *
  * @customElement lyra-box-plot
- * @csspart base, canvas
+ * @csspart base - The chart wrapper.
+ * @csspart canvas - The box-plot canvas.
+ * @csspart description - The accessible box-plot summary.
+ * @csspart data-table - The optional generated or slotted data table.
+ * @slot data-table - An optional consumer-provided accessible table alternative.
  */
 export declare class LyraBoxPlot extends LyraElement {
     static styles: import("lit").CSSResultGroup[];
@@ -29,21 +33,41 @@ export declare class LyraBoxPlot extends LyraElement {
     height: string;
     yLabel: string;
     beginAtZero: boolean;
+    /** Accessible name applied to the canvas. Falls back to the box labels. */
+    accessibleLabel: string;
+    /** Accessible description for the canvas. When unset, a five-number summary is generated. */
+    accessibleDescription: string;
+    /** Makes the generated data table visible; it remains screen-reader available when false. */
+    showDataTable: boolean;
     /**
      * True until the lazy-loaded `chart.js` + `@sgratzl/chartjs-chart-boxplot`
      * peer dependencies have settled (success or failure) — mirrors
      * `LyraChart`'s `loading` state.
      */
     private loading;
+    private visible;
+    private intersectionObserver?;
     private canvasEl?;
     private chart?;
     private chartJsModule?;
+    private descriptionId;
     connectedCallback(): void;
     private onBoxPlotPluginLoaded;
     disconnectedCallback(): void;
     protected updated(changed: PropertyValues): void;
+    /**
+     * Resolves the `--lyra-chart-*` theme tokens (declared in
+     * `box-plot.styles.ts`, each layered over an existing semantic token) via
+     * `getComputedStyle`. Chart.js renders to canvas, not the DOM, so it can't
+     * consume CSS `var()` directly — same constraint `chart.ts`'s
+     * `themeColors()` documents — so this is called fresh from `buildConfig()`
+     * on every draw rather than cached.
+     */
+    private themeColors;
     private buildConfig;
     private draw;
+    private boxPlotDescription;
+    private renderDataTable;
     render(): TemplateResult;
 }
 declare global {