@aceshooting/lyra-ui 2.9.0 → 2.11.0

package/dist/components/button/button.class.d.ts

@@ -0,0 +1,57 @@
+import { type TemplateResult } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+export type ButtonVariant = 'neutral' | 'brand' | 'success' | 'warning' | 'danger';
+export type ButtonAppearance = 'filled' | 'outlined' | 'plain';
+export type ButtonSize = 'xs' | 's' | 'm' | 'l' | 'xl';
+export type ButtonType = 'button' | 'submit' | 'reset';
+/**
+ * `<lyra-button>` — a generic action-button primitive, the `lyra-*` equivalent of a plain
+ * `wa-button`. Renders an internal native `<button part="base">` (never a real `<wa-button>` —
+ * this library has no runtime dependency on Web Awesome, matching `<lyra-copy-button>`/
+ * `<lyra-export-button>`'s own clean-room, API-mirroring approach). `type="submit"`/`type="reset"`
+ * are handled by this component itself via the host's own `closest('form')` — a shadow-internal
+ * native `<button type="submit">` does not participate in an ancestor light-DOM form's submission
+ * on its own, since form-submitter semantics don't cross the shadow boundary.
+ *
+ * A host `aria-label` is forwarded to the internal button as a literal string (for an icon-only
+ * button with no visible label); external `aria-labelledby`/`aria-describedby` idrefs are not
+ * copied across the shadow boundary.
+ *
+ * @customElement lyra-button
+ * @slot - Default slot: the button's label content.
+ * @slot start - Leading icon/content, rendered before the label.
+ * @slot end - Trailing icon/content, rendered after the label.
+ * @csspart base - The internal native `<button>`.
+ * @csspart label - The default-slot label wrapper.
+ * @csspart start - The `start` slot wrapper.
+ * @csspart end - The `end` slot wrapper.
+ * @csspart spinner - The loading spinner, present only while `loading` is `true`.
+ */
+export declare class LyraButton extends LyraElement {
+    static styles: import("lit").CSSResultGroup[];
+    /** Tone vocabulary shared with `<lyra-chip>`/`<lyra-avatar>`'s own `tone` property, named
+     *  `variant` here (not `tone`) to mirror `wa-button`'s own attribute name for a mechanical
+     *  migration off a plain `wa-button`. */
+    variant: ButtonVariant;
+    appearance: ButtonAppearance;
+    size: ButtonSize;
+    /** Forwarded to this component's own submit/reset handling — see the class doc comment above
+     *  for why this component (not the shadow-internal `<button>`) owns that behavior. */
+    type: ButtonType;
+    /** Shows an internal spinner in place of interaction affordance and disables the button, without
+     *  clearing `disabled` — a consumer's own `disabled` state and a transient `loading` state are
+     *  independent (mirrors `<lyra-export-button>`'s own `loading`/`disabled` pair). */
+    loading: boolean;
+    disabled: boolean;
+    private buttonEl?;
+    focus(options?: FocusOptions): void;
+    blur(): void;
+    private onClick;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-button': LyraButton;
+    }
+}
+//# sourceMappingURL=button.class.d.ts.map

package/dist/components/button/button.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.class.d.ts","sourceRoot":"","sources":["../../../src/components/button/button.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAI7D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AACnF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAC/D,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,MAAM,CAAC,MAAM,iCAAgC;IAE7C;;6CAEyC;IACZ,OAAO,EAAE,aAAa,CAAa;IACnC,UAAU,EAAE,gBAAgB,CAAY;IACxC,IAAI,EAAE,UAAU,CAAO;IACpD;0FACsF;IAC1E,IAAI,EAAE,UAAU,CAAY;IACxC;;wFAEoF;IACxC,OAAO,UAAS;IAChB,QAAQ,UAAS;IAE5C,OAAO,CAAC,QAAQ,CAAC,CAAoB;IAE7C,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAE3C;IAEQ,IAAI,IAAI,IAAI,CAEpB;IAED,OAAO,CAAC,OAAO,CAMb;IAEF,MAAM,IAAI,cAAc,CAiBvB;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,aAAa,EAAE,UAAU,CAAC;KAC3B;CACF"}

package/dist/components/button/button.class.js

@@ -0,0 +1,108 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { html, nothing } from 'lit';
+import { property, query } from 'lit/decorators.js';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { spinnerIcon } from '../../internal/icons.js';
+import { styles } from './button.styles.js';
+/**
+ * `<lyra-button>` — a generic action-button primitive, the `lyra-*` equivalent of a plain
+ * `wa-button`. Renders an internal native `<button part="base">` (never a real `<wa-button>` —
+ * this library has no runtime dependency on Web Awesome, matching `<lyra-copy-button>`/
+ * `<lyra-export-button>`'s own clean-room, API-mirroring approach). `type="submit"`/`type="reset"`
+ * are handled by this component itself via the host's own `closest('form')` — a shadow-internal
+ * native `<button type="submit">` does not participate in an ancestor light-DOM form's submission
+ * on its own, since form-submitter semantics don't cross the shadow boundary.
+ *
+ * A host `aria-label` is forwarded to the internal button as a literal string (for an icon-only
+ * button with no visible label); external `aria-labelledby`/`aria-describedby` idrefs are not
+ * copied across the shadow boundary.
+ *
+ * @customElement lyra-button
+ * @slot - Default slot: the button's label content.
+ * @slot start - Leading icon/content, rendered before the label.
+ * @slot end - Trailing icon/content, rendered after the label.
+ * @csspart base - The internal native `<button>`.
+ * @csspart label - The default-slot label wrapper.
+ * @csspart start - The `start` slot wrapper.
+ * @csspart end - The `end` slot wrapper.
+ * @csspart spinner - The loading spinner, present only while `loading` is `true`.
+ */
+export class LyraButton extends LyraElement {
+    constructor() {
+        super(...arguments);
+        /** Tone vocabulary shared with `<lyra-chip>`/`<lyra-avatar>`'s own `tone` property, named
+         *  `variant` here (not `tone`) to mirror `wa-button`'s own attribute name for a mechanical
+         *  migration off a plain `wa-button`. */
+        this.variant = 'neutral';
+        this.appearance = 'filled';
+        this.size = 'm';
+        /** Forwarded to this component's own submit/reset handling — see the class doc comment above
+         *  for why this component (not the shadow-internal `<button>`) owns that behavior. */
+        this.type = 'button';
+        /** Shows an internal spinner in place of interaction affordance and disables the button, without
+         *  clearing `disabled` — a consumer's own `disabled` state and a transient `loading` state are
+         *  independent (mirrors `<lyra-export-button>`'s own `loading`/`disabled` pair). */
+        this.loading = false;
+        this.disabled = false;
+        this.onClick = () => {
+            if (this.type === 'submit') {
+                this.closest('form')?.requestSubmit();
+            }
+            else if (this.type === 'reset') {
+                this.closest('form')?.reset();
+            }
+        };
+    }
+    static { this.styles = [LyraElement.styles, styles]; }
+    focus(options) {
+        this.buttonEl?.focus(options);
+    }
+    blur() {
+        this.buttonEl?.blur();
+    }
+    render() {
+        const ariaLabel = this.getAttribute('aria-label');
+        return html `
+      <button
+        part="base"
+        type="button"
+        aria-label=${ariaLabel || nothing}
+        aria-busy=${this.loading ? 'true' : 'false'}
+        ?disabled=${this.disabled || this.loading}
+        @click=${this.onClick}
+      >
+        <span part="start"><slot name="start"></slot></span>
+        <span part="label"><slot></slot></span>
+        <span part="end"><slot name="end"></slot></span>
+        ${this.loading ? html `<span part="spinner" aria-hidden="true">${spinnerIcon()}</span>` : ''}
+      </button>
+    `;
+    }
+}
+__decorate([
+    property({ reflect: true })
+], LyraButton.prototype, "variant", void 0);
+__decorate([
+    property({ reflect: true })
+], LyraButton.prototype, "appearance", void 0);
+__decorate([
+    property({ reflect: true })
+], LyraButton.prototype, "size", void 0);
+__decorate([
+    property()
+], LyraButton.prototype, "type", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraButton.prototype, "loading", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraButton.prototype, "disabled", void 0);
+__decorate([
+    query('button')
+], LyraButton.prototype, "buttonEl", void 0);
+//# sourceMappingURL=button.class.js.map

package/dist/components/button/button.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.class.js","sourceRoot":"","sources":["../../../src/components/button/button.class.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAuB,MAAM,KAAK,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAO5C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,UAAW,SAAQ,WAAW;IAA3C;;QAGE;;iDAEyC;QACZ,YAAO,GAAkB,SAAS,CAAC;QACnC,eAAU,GAAqB,QAAQ,CAAC;QACxC,SAAI,GAAe,GAAG,CAAC;QACpD;8FACsF;QAC1E,SAAI,GAAe,QAAQ,CAAC;QACxC;;4FAEoF;QACxC,YAAO,GAAG,KAAK,CAAC;QAChB,aAAQ,GAAG,KAAK,CAAC;QAYrD,YAAO,GAAG,GAAS,EAAE;YAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;YACxC,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACjC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;YAChC,CAAC;QACH,CAAC,CAAC;IAoBJ,CAAC;aArDQ,WAAM,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,AAA/B,CAAgC;IAmBpC,KAAK,CAAC,OAAsB;QACnC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAEQ,IAAI;QACX,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC;IAUD,MAAM;QACJ,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QAClD,OAAO,IAAI,CAAA;;;;qBAIM,SAAS,IAAI,OAAO;oBACrB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;oBAC/B,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO;iBAChC,IAAI,CAAC,OAAO;;;;;UAKnB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA,2CAA2C,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE;;KAE9F,CAAC;IACJ,CAAC;CACF;AAhD8B;IAA5B,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;2CAAoC;AACnC;IAA5B,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;8CAAyC;AACxC;IAA5B,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;wCAAwB;AAGxC;IAAX,QAAQ,EAAE;wCAA6B;AAII;IAA3C,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;2CAAiB;AAChB;IAA3C,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;4CAAkB;AAEpC;IAAxB,KAAK,CAAC,QAAQ,CAAC;4CAAsC"}

package/dist/components/button/button.d.ts

@@ -0,0 +1,2 @@
+export * from './button.class.js';
+//# sourceMappingURL=button.d.ts.map

package/dist/components/button/button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../src/components/button/button.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/components/button/button.js

@@ -0,0 +1,5 @@
+export * from './button.class.js';
+import { LyraButton } from './button.class.js';
+import { defineElement } from '../../internal/prefix.js';
+defineElement('button', LyraButton);
+//# sourceMappingURL=button.js.map

package/dist/components/button/button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.js","sourceRoot":"","sources":["../../../src/components/button/button.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC"}

package/dist/components/button/button.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const styles: import("lit").CSSResult;
+//# sourceMappingURL=button.styles.d.ts.map

package/dist/components/button/button.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.styles.d.ts","sourceRoot":"","sources":["../../../src/components/button/button.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,yBAsHlB,CAAC"}

package/dist/components/button/button.styles.js

@@ -0,0 +1,121 @@
+import { css } from 'lit';
+export const styles = css `
+  :host {
+    display: inline-block;
+    --lyra-button-accent: var(--lyra-color-text);
+    --lyra-button-fill: var(--lyra-color-surface);
+    --lyra-button-on-fill: var(--lyra-color-text);
+    --lyra-button-border: var(--lyra-color-border);
+  }
+  :host([variant='brand']) {
+    --lyra-button-accent: var(--lyra-color-brand);
+    --lyra-button-fill: var(--lyra-color-brand);
+    --lyra-button-on-fill: var(--lyra-color-on-brand);
+    --lyra-button-border: var(--lyra-color-brand);
+  }
+  :host([variant='success']) {
+    --lyra-button-accent: var(--lyra-color-success);
+    --lyra-button-fill: var(--lyra-color-success);
+    --lyra-button-on-fill: var(--lyra-color-on-success);
+    --lyra-button-border: var(--lyra-color-success);
+  }
+  :host([variant='warning']) {
+    --lyra-button-accent: var(--lyra-color-warning);
+    --lyra-button-fill: var(--lyra-color-warning);
+    --lyra-button-on-fill: var(--lyra-color-on-warning);
+    --lyra-button-border: var(--lyra-color-warning);
+  }
+  :host([variant='danger']) {
+    --lyra-button-accent: var(--lyra-color-danger);
+    --lyra-button-fill: var(--lyra-color-danger);
+    --lyra-button-on-fill: var(--lyra-color-on-danger);
+    --lyra-button-border: var(--lyra-color-danger);
+  }
+  [part='base'] {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    gap: var(--lyra-space-2xs);
+    border-radius: var(--lyra-radius);
+    border: var(--lyra-border-width-thin) solid var(--lyra-button-border);
+    font: inherit;
+    font-weight: var(--lyra-font-weight-semibold);
+    cursor: pointer;
+  }
+  :host([appearance='filled']) [part='base'] {
+    background: var(--lyra-button-fill);
+    color: var(--lyra-button-on-fill);
+  }
+  :host([appearance='outlined']) [part='base'] {
+    background: transparent;
+    color: var(--lyra-button-accent);
+  }
+  :host([appearance='plain']) [part='base'] {
+    background: transparent;
+    color: var(--lyra-button-accent);
+    border-color: transparent;
+  }
+  [part='base']:disabled {
+    opacity: var(--lyra-opacity-disabled);
+    cursor: not-allowed;
+  }
+  [part='base']:focus-visible {
+    outline: var(--lyra-focus-ring-width) solid var(--lyra-focus-ring-color);
+    outline-offset: var(--lyra-focus-ring-offset);
+  }
+  [part='start']:empty,
+  [part='end']:empty {
+    display: none;
+  }
+  [part='start'],
+  [part='end'] {
+    display: inline-flex;
+    align-items: center;
+  }
+  :host([size='xs']) [part='base'] {
+    padding-inline: var(--lyra-space-xs);
+    padding-block: var(--lyra-space-2xs);
+    font-size: var(--lyra-font-size-xs);
+    min-block-size: var(--lyra-size-1-5rem);
+  }
+  :host([size='s']) [part='base'] {
+    padding-inline: var(--lyra-space-s);
+    padding-block: var(--lyra-space-2xs);
+    font-size: var(--lyra-font-size-sm);
+    min-block-size: var(--lyra-size-1-75rem);
+  }
+  :host([size='m']) [part='base'] {
+    padding-inline: var(--lyra-space-m);
+    padding-block: var(--lyra-space-xs);
+    font-size: var(--lyra-font-size-md-sm);
+    min-block-size: var(--lyra-size-2rem);
+  }
+  :host([size='l']) [part='base'] {
+    padding-inline: var(--lyra-space-l);
+    padding-block: var(--lyra-space-s);
+    font-size: var(--lyra-font-size-md);
+    min-block-size: var(--lyra-size-2-5rem);
+  }
+  :host([size='xl']) [part='base'] {
+    padding-inline: var(--lyra-space-2xl);
+    padding-block: var(--lyra-space-m);
+    font-size: var(--lyra-font-size-lg);
+    min-block-size: var(--lyra-size-3rem);
+  }
+  [part='spinner'] {
+    display: inline-flex;
+    animation: lyra-button-spin 1s linear infinite;
+  }
+  @keyframes lyra-button-spin {
+    to {
+      transform: rotate(360deg);
+    }
+  }
+  @media (prefers-reduced-motion: reduce) {
+    [part='spinner'] {
+      animation-duration: 0.001ms;
+      animation-iteration-count: 1;
+    }
+  }
+`;
+//# sourceMappingURL=button.styles.js.map

package/dist/components/button/button.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.styles.js","sourceRoot":"","sources":["../../../src/components/button/button.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsHxB,CAAC"}

package/dist/components/heatmap/heatmap.class.d.ts

@@ -31,6 +31,14 @@ export interface HeatmapAnnotation {
     date?: string;
     label?: string;
 }
+/** A single cell to mark as persistently selected -- `row`/`col` in matrix mode, `date` in
+ *  calendar mode (whichever pair matches the active `mode`; the other field is ignored),
+ *  mirroring `HeatmapAnnotation`'s own row/col/date shape. */
+export interface HeatmapSelectedCell {
+    row?: number;
+    col?: number;
+    date?: string;
+}
 /**
  * Parses a strict `#rgb`/`#rgba`/`#rrggbb`/`#rrggbbaa` hex string into an
  * `[r, g, b, a]` quadruple (`a` in `[0, 1]`, defaulting to `1` for the
@@ -204,6 +212,16 @@ export declare class LyraHeatmap extends LyraElement<LyraHeatmapEventMap> {
     set bucketCount(value: number);
     /** Cells to ring-highlight — `row`/`col` in matrix mode, `date` in calendar mode. See `HeatmapAnnotation`. */
     annotations: HeatmapAnnotation[];
+    /**
+     * The single cell to mark as persistently selected -- `row`/`col` in matrix mode, `date` in
+     * calendar mode. Purely a controlled, consumer-owned visual/accessibility marker, mirroring
+     * `<lyra-lite-chart>`'s `selectedIndex` -- this component never mutates it itself; a consumer
+     * wires it up from `lyra-cell-click` (or any other source) to build a toggle-select
+     * interaction. Unset (the default, `null`) draws no selection ring, adds no selected-cell text
+     * to the host's `aria-label`, and adds no "(selected)" suffix to the live-region announcement,
+     * reproducing today's exact output.
+     */
+    selectedCell: HeatmapSelectedCell | null;
     /** Formats the per-cell tooltip and keyboard live-region text — receives the cell position
      *  (`MatrixCellPos` in matrix mode, `CalendarCellPos` in calendar mode) and its value. Falls back to
      *  the built-in English "Row X, Col Y: value" / "Mon DD: value" template when unset. */
@@ -319,6 +337,9 @@ export declare class LyraHeatmap extends LyraElement<LyraHeatmapEventMap> {
     private queueThemeRefresh;
     private watchTheme;
     protected willUpdate(changed: PropertyValues): void;
+    /** The localized "Selected: <cell>." description appended to the host `aria-label`, or `''` when
+     *  `selectedCell` is unset or doesn't resolve to a real cell in the current grid. */
+    private selectedCellDescription;
     /**
      * The real (non-no-data) value range across `values` (or `days` in
      * calendar mode), or `null` if there is none. Only called from
@@ -344,6 +365,14 @@ export declare class LyraHeatmap extends LyraElement<LyraHeatmapEventMap> {
     private focusRingColor;
     /** Reads the customizable canvas-drawn annotation-ring stroke color off the host's computed style. */
     private annotationColor;
+    /** Reads the customizable canvas-drawn selected-cell-ring stroke color off the host's computed style. */
+    private selectedColor;
+    /** Whether `selectedCell` refers to the given grid position, in whichever mode is active --
+     *  `row`/`col` equality in matrix mode, resolved-date equality in calendar mode (looking the
+     *  position's actual date up via `calendarCellAt()`, the same way the annotation ring resolves
+     *  `ann.date` against `cells`). Shared by the live-region announcement, which needs to know
+     *  whether the just-announced cell *is* the selection. */
+    private isSelectedPos;
     private draw;
     private scheduleDraw;
     private colorRamp;

package/dist/components/heatmap/heatmap.class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heatmap.class.d.ts","sourceRoot":"","sources":["../../../src/components/heatmap/heatmap.class.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"heatmap.class.d.ts","sourceRoot":"","sources":["../../../src/components/heatmap/heatmap.class.ts"],"names":[],"mappings":"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"}

package/dist/components/heatmap/heatmap.class.js

@@ -41,6 +41,7 @@ export const MAX_BUCKET_COUNT = 256;
 const RING_LINE_WIDTH = 2;
 const FALLBACK_FOCUS_RING_COLOR = '#0969da';
 const FALLBACK_ANNOTATION_COLOR = '#cf222e';
+const FALLBACK_SELECTED_COLOR = '#1a7f37';
 const ARROW_KEYS = new Set(['ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight']);
 const MS_PER_DAY = 86_400_000;
 const HEX_RE = /^([0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/i;
@@ -278,6 +279,16 @@ export class LyraHeatmap extends LyraElement {
         this._bucketCount = DEFAULT_BUCKET_COUNT;
         /** Cells to ring-highlight — `row`/`col` in matrix mode, `date` in calendar mode. See `HeatmapAnnotation`. */
         this.annotations = [];
+        /**
+         * The single cell to mark as persistently selected -- `row`/`col` in matrix mode, `date` in
+         * calendar mode. Purely a controlled, consumer-owned visual/accessibility marker, mirroring
+         * `<lyra-lite-chart>`'s `selectedIndex` -- this component never mutates it itself; a consumer
+         * wires it up from `lyra-cell-click` (or any other source) to build a toggle-select
+         * interaction. Unset (the default, `null`) draws no selection ring, adds no selected-cell text
+         * to the host's `aria-label`, and adds no "(selected)" suffix to the live-region announcement,
+         * reproducing today's exact output.
+         */
+        this.selectedCell = null;
         this.themeRefreshQueued = false;
         /** The current value range, refreshed once per update cycle by `willUpdate()`. See `computeValueRange()`. */
         this.cachedValueRange = null;
@@ -510,24 +521,54 @@ export class LyraHeatmap extends LyraElement {
         if (!this.authorSuppliedRole)
             this.setAttribute('role', 'group');
         if (!this.authorSuppliedAriaLabel) {
+            let label;
             if (this.mode === 'calendar') {
-                this.setAttribute('aria-label', this.localize('heatmapCalendarLabel', undefined, {
+                label = this.localize('heatmapCalendarLabel', undefined, {
                     days: this.days.length,
                     label: this.valueLabel,
                     range,
-                }));
+                });
             }
             else {
                 const rows = this.rowLabels.length;
                 const cols = this.colLabels.length;
-                this.setAttribute('aria-label', this.localize('heatmapMatrixLabel', undefined, {
+                label = this.localize('heatmapMatrixLabel', undefined, {
                     rows,
                     cols,
                     label: this.valueLabel,
                     range,
-                }));
+                });
             }
+            // A persistent selection description, appended to the host's own accessible name -- *not*
+            // an `aria-describedby` idref pointing into this element's shadow root, since an idref like
+            // that can't resolve across the shadow boundary. Reusing the plain aria-label string here
+            // keeps it discoverable any time a screen reader user queries this element's accessible
+            // name, regardless of which cell (if any) currently has keyboard focus.
+            const selectedText = this.selectedCellDescription();
+            this.setAttribute('aria-label', selectedText ? `${label} ${selectedText}` : label);
+        }
+    }
+    /** The localized "Selected: <cell>." description appended to the host `aria-label`, or `''` when
+     *  `selectedCell` is unset or doesn't resolve to a real cell in the current grid. */
+    selectedCellDescription() {
+        if (!this.selectedCell)
+            return '';
+        if (this.mode === 'calendar') {
+            if (this.selectedCell.date == null)
+                return '';
+            const match = this.cachedCalendarGrid.cells.find((c) => c.date === this.selectedCell.date);
+            if (!match)
+                return '';
+            return this.localize('heatmapSelectedCellLabel', undefined, {
+                cell: this.calendarCellText({ week: match.week, weekday: match.weekday }),
+            });
         }
+        const { row, col } = this.selectedCell;
+        if (row == null || col == null)
+            return '';
+        if (row < 0 || row >= this.rowLabels.length || col < 0 || col >= this.colLabels.length)
+            return '';
+        return this.localize('heatmapSelectedCellLabel', undefined, { cell: this.matrixCellText({ row, col }) });
     }
     /**
      * The real (non-no-data) value range across `values` (or `days` in
@@ -561,6 +602,7 @@ export class LyraHeatmap extends LyraElement {
             'focusedCell',
             'colorSteps',
             'cellColor',
+            'selectedCell',
         ].some((name) => changed.has(name))) {
             this.draw();
         }
@@ -596,6 +638,25 @@ export class LyraHeatmap extends LyraElement {
     annotationColor() {
         return (getComputedStyle(this).getPropertyValue('--lyra-heatmap-annotation-color').trim() || FALLBACK_ANNOTATION_COLOR);
     }
+    /** Reads the customizable canvas-drawn selected-cell-ring stroke color off the host's computed style. */
+    selectedColor() {
+        return getComputedStyle(this).getPropertyValue('--lyra-heatmap-selected-color').trim() || FALLBACK_SELECTED_COLOR;
+    }
+    /** Whether `selectedCell` refers to the given grid position, in whichever mode is active --
+     *  `row`/`col` equality in matrix mode, resolved-date equality in calendar mode (looking the
+     *  position's actual date up via `calendarCellAt()`, the same way the annotation ring resolves
+     *  `ann.date` against `cells`). Shared by the live-region announcement, which needs to know
+     *  whether the just-announced cell *is* the selection. */
+    isSelectedPos(pos) {
+        if (!this.selectedCell)
+            return false;
+        if ('week' in pos) {
+            if (this.selectedCell.date == null)
+                return false;
+            return this.calendarCellAt(pos).date === this.selectedCell.date;
+        }
+        return this.selectedCell.row === pos.row && this.selectedCell.col === pos.col;
+    }
     draw() {
         if (this.mode === 'calendar')
             this.drawCalendar();
@@ -824,6 +885,20 @@ export class LyraHeatmap extends LyraElement {
                 ctx.strokeRect(x + 0.5, y + 0.5, cellSize - 1, cellSize - 1);
             }
         }
+        // Persistent "selected" ring, drawn after the annotation ring and before the keyboard focus
+        // ring so focus visually layers on top of a selection when both target the same cell.
+        // Independent of focusedCell -- unlike the transient focus cursor, this persists across focus
+        // moves and hover, driven entirely by the controlled `selectedCell` property.
+        if (this.selectedCell?.date != null) {
+            const match = cells.find((c) => c.date === this.selectedCell.date);
+            if (match) {
+                ctx.lineWidth = RING_LINE_WIDTH;
+                ctx.strokeStyle = this.selectedColor();
+                const x = this.columnXFor(match.week);
+                const y = this.rowYFor(match.weekday);
+                ctx.strokeRect(x + 0.5, y + 0.5, cellSize - 1, cellSize - 1);
+            }
+        }
         // Keyboard focus ring, redrawn on top of the fill pass (and any
         // annotation rings) on every draw.
         if (this.focusedCell && 'week' in this.focusedCell) {
@@ -942,6 +1017,19 @@ export class LyraHeatmap extends LyraElement {
                 ctx.strokeRect(x + 1, y + 1, cellSize - 3, cellSize - 3);
             }
         }
+        // Persistent "selected" ring, drawn after the annotation ring and before the keyboard focus
+        // ring so focus visually layers on top of a selection when both target the same cell.
+        // Independent of focusedCell -- see drawCalendar()'s twin of this block.
+        if (this.selectedCell?.row != null && this.selectedCell.col != null) {
+            const { row, col } = this.selectedCell;
+            if (row >= 0 && row < rows && col >= 0 && col < cols) {
+                ctx.lineWidth = RING_LINE_WIDTH;
+                ctx.strokeStyle = this.selectedColor();
+                const x = PAD_LEFT + col * cellSize;
+                const y = PAD_TOP + row * cellSize;
+                ctx.strokeRect(x + 1, y + 1, cellSize - 3, cellSize - 3);
+            }
+        }
         // Keyboard focus ring, redrawn on top of the fill pass (and any
         // annotation rings) on every draw — canvas has no persistent DOM focus
         // affordance of its own for an individual cell, only a `:focus-visible`
@@ -1130,7 +1218,8 @@ export class LyraHeatmap extends LyraElement {
     }
     /** Refreshes the visually-hidden live-region text for a newly-focused cell. */
     announce(pos) {
-        this.liveText = this.resolveCellText(pos);
+        const text = this.resolveCellText(pos);
+        this.liveText = this.isSelectedPos(pos) ? `${text}${this.localize('heatmapCellSelectedSuffix')}` : text;
     }
     emitCellClick(pos) {
         if ('week' in pos) {
@@ -1331,6 +1420,9 @@ __decorate([
 __decorate([
     property({ attribute: false })
 ], LyraHeatmap.prototype, "annotations", void 0);
+__decorate([
+    property({ attribute: false })
+], LyraHeatmap.prototype, "selectedCell", void 0);
 __decorate([
     property({ attribute: false })
 ], LyraHeatmap.prototype, "cellText", void 0);