@aceshooting/lyra-ui 6.0.0 → 6.2.0

package/dist/components/data/table/table.class.d.ts

@@ -285,6 +285,7 @@ export interface LyraTableEventMap<T = unknown> {
  *   the same reason as `focus`.
  * @csspart base - The root wrapper around the `<table>` and its footer controls.
  * @csspart table - The `<table role="grid">` element.
+ * @csspart caption - The `<caption>` element, rendered only when `caption` is set.
  * @csspart head - The `<thead>` element.
  * @csspart header-cell - Each `<th>` header cell.
  * @csspart resize-handle - The focusable separator used to resize a `resizable` column.
@@ -353,6 +354,12 @@ export interface LyraTableEventMap<T = unknown> {
  *   `aria-selected` is `true`. Shadow Parts forbids an attribute selector after `::part()`, so
  *   `::part(row)[aria-selected]` is invalid CSS and the selected row could otherwise only be
  *   restyled by hijacking the library-wide `--lr-color-brand-quiet` token.
+ * @cssprop [--lr-table-header-sorted-bg=transparent] - Background of the currently-sorted column's
+ *   header cell (`[aria-sort]` other than `none`). Same rationale as `--lr-table-row-selected-bg`:
+ *   `::part(header-cell)[aria-sort]` is invalid CSS, so this token is the supported way to recolor
+ *   the sorted header without hijacking a library-wide token.
+ * @cssprop [--lr-table-header-sorted-color=inherit] - Text color of the currently-sorted column's
+ *   header cell.
  * @cssprop [--lr-table-sticky-offset=0] - Distance a `sticky` column pins from the inline edge.
  *   Measured and set inline per column by the component so multiple sticky columns stack instead
  *   of overlapping; falls back to `0` for the first one, or before the first measurement pass.
@@ -376,6 +383,16 @@ export declare class LyraTable<T = unknown> extends LyraElement<LyraTableEventMa
     layout: 'auto' | 'fixed';
     sortKey: string;
     sortDir: 'asc' | 'desc';
+    /** Accessible name for the `role="grid"` — a typed alternative to setting `aria-label` on the
+     *  host. When set it becomes the grid's `aria-label`; a host `aria-label` is used as a fallback
+     *  when this is unset. Consumer-supplied text, so it is NOT run through `this.localize()`. */
+    accessibleLabel: string;
+    /** Optional visible caption rendered as the table's `<caption>`. Also names the grid (via
+     *  `aria-labelledby`) when no `accessibleLabel`/host `aria-label` is set. Consumer-supplied
+     *  text, not localized. */
+    caption: string;
+    /** Stable id for the `<caption>`, so `aria-labelledby` can point at it. */
+    private readonly captionId;
     /** Derives each row's stable identity for `repeat()`'s DOM-reconciliation
      *  key and the delegated click/keydown row lookup (`rowsByKey`,
      *  `data-row-key`). When omitted, `keyOf()` falls back to the row's index
@@ -501,6 +518,15 @@ export declare class LyraTable<T = unknown> extends LyraElement<LyraTableEventMa
      *  the `lr-columns-revealed` event, fired whenever the button toggles it
      *  — to persist the current one. */
     showAllColumns: boolean;
+    /** Persists `showAllColumns` to `localStorage` across reloads when set. Namespaced as
+     *  `lr-table:${storageKey}` -- mirrors `lr-app-rail`'s identical `storage-key` pattern. */
+    storageKey?: string;
+    private get storageFullKey();
+    /** Skips the very first `updated()` pass so mounting never writes to storage -- `willUpdate()`
+     *  restored `showAllColumns` on that first pass, and Lit has already flipped `hasUpdated` to true
+     *  by the time `updated()` runs, so a dedicated flag is needed. Mirrors `lr-app-rail`'s
+     *  `persistReady`. */
+    private persistReady;
     /** Roving-tabindex position among header cells; `null` until a header is
      *  clicked/navigated to, at which point `focusedColKey()` falls back to
      *  the first column. */
@@ -568,6 +594,7 @@ export declare class LyraTable<T = unknown> extends LyraElement<LyraTableEventMa
      *  tick. A second tick that lands while a frame is already pending is a no-op; the id resets once
      *  the scheduled frame runs, so the very next tick after that schedules a fresh one. */
     private scheduleLayoutSync;
+    protected firstUpdated(changed: PropertyValues): void;
     connectedCallback(): void;
     disconnectedCallback(): void;
     private observeBase;

package/dist/components/data/table/table.class.d.ts.map

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

package/dist/components/data/table/table.class.js

@@ -10,8 +10,9 @@ import { repeat } from 'lit/directives/repeat.js';
 import { styleMap } from 'lit/directives/style-map.js';
 import { LyraElement } from '../../../internal/lyra-element.js';
 import { isRtl } from '../../../internal/rtl.js';
-import { srOnly } from '../../../internal/a11y.js';
+import { srOnly, nextId } from '../../../internal/a11y.js';
 import { finiteCount, finiteInteger } from '../../../internal/numbers.js';
+import { readPersistedState, writePersistedState } from '../../../internal/persisted-state.js';
 import { styles } from './table.styles.js';
 import { chevronIcon } from '../../../internal/icons.js';
 import { minMax } from '../heatmap/heatmap-scale.js';
@@ -276,6 +277,7 @@ function closestInteractive(target, boundary) {
  *   the same reason as `focus`.
  * @csspart base - The root wrapper around the `<table>` and its footer controls.
  * @csspart table - The `<table role="grid">` element.
+ * @csspart caption - The `<caption>` element, rendered only when `caption` is set.
  * @csspart head - The `<thead>` element.
  * @csspart header-cell - Each `<th>` header cell.
  * @csspart resize-handle - The focusable separator used to resize a `resizable` column.
@@ -344,6 +346,12 @@ function closestInteractive(target, boundary) {
  *   `aria-selected` is `true`. Shadow Parts forbids an attribute selector after `::part()`, so
  *   `::part(row)[aria-selected]` is invalid CSS and the selected row could otherwise only be
  *   restyled by hijacking the library-wide `--lr-color-brand-quiet` token.
+ * @cssprop [--lr-table-header-sorted-bg=transparent] - Background of the currently-sorted column's
+ *   header cell (`[aria-sort]` other than `none`). Same rationale as `--lr-table-row-selected-bg`:
+ *   `::part(header-cell)[aria-sort]` is invalid CSS, so this token is the supported way to recolor
+ *   the sorted header without hijacking a library-wide token.
+ * @cssprop [--lr-table-header-sorted-color=inherit] - Text color of the currently-sorted column's
+ *   header cell.
  * @cssprop [--lr-table-sticky-offset=0] - Distance a `sticky` column pins from the inline edge.
  *   Measured and set inline per column by the component so multiple sticky columns stack instead
  *   of overlapping; falls back to `0` for the first one, or before the first measurement pass.
@@ -368,6 +376,16 @@ export class LyraTable extends LyraElement {
         this.layout = 'auto';
         this.sortKey = '';
         this.sortDir = 'asc';
+        /** Accessible name for the `role="grid"` — a typed alternative to setting `aria-label` on the
+         *  host. When set it becomes the grid's `aria-label`; a host `aria-label` is used as a fallback
+         *  when this is unset. Consumer-supplied text, so it is NOT run through `this.localize()`. */
+        this.accessibleLabel = '';
+        /** Optional visible caption rendered as the table's `<caption>`. Also names the grid (via
+         *  `aria-labelledby`) when no `accessibleLabel`/host `aria-label` is set. Consumer-supplied
+         *  text, not localized. */
+        this.caption = '';
+        /** Stable id for the `<caption>`, so `aria-labelledby` can point at it. */
+        this.captionId = nextId('lr-table-caption');
         this.selectedKey = null;
         this.selectionMode = 'none';
         this.selectedKeys = new Set();
@@ -447,6 +465,11 @@ export class LyraTable extends LyraElement {
          *  the `lr-columns-revealed` event, fired whenever the button toggles it
          *  — to persist the current one. */
         this.showAllColumns = false;
+        /** Skips the very first `updated()` pass so mounting never writes to storage -- `willUpdate()`
+         *  restored `showAllColumns` on that first pass, and Lit has already flipped `hasUpdated` to true
+         *  by the time `updated()` runs, so a dedicated flag is needed. Mirrors `lr-app-rail`'s
+         *  `persistReady`. */
+        this.persistReady = false;
         /** Roving-tabindex position among header cells; `null` until a header is
          *  clicked/navigated to, at which point `focusedColKey()` falls back to
          *  the first column. */
@@ -474,7 +497,7 @@ export class LyraTable extends LyraElement {
         this.observedHeaders = new Set();
         this.onResizePointerDown = (event) => {
             const handle = event.currentTarget;
-            const key = handle.dataset.colKey;
+            const key = handle.dataset['colKey'];
             const column = key ? this.columnsByKey.get(key) : undefined;
             const header = handle.closest('th[data-col-key]');
             if (!key || !column || !header)
@@ -509,7 +532,7 @@ export class LyraTable extends LyraElement {
         };
         this.onResizeKeyDown = (event) => {
             const handle = event.currentTarget;
-            const key = handle.dataset.colKey;
+            const key = handle.dataset['colKey'];
             const column = key ? this.columnsByKey.get(key) : undefined;
             if (!column)
                 return;
@@ -590,8 +613,8 @@ export class LyraTable extends LyraElement {
             const target = event.target;
             const cell = target?.closest?.('td[data-col-key]');
             const row = target?.closest?.('[data-row-key]');
-            const columnKey = cell?.dataset.colKey;
-            const rowKey = row?.dataset.rowKey;
+            const columnKey = cell?.dataset['colKey'];
+            const rowKey = row?.dataset['rowKey'];
             this.focusedEditorCell =
                 target?.getAttribute('part') === 'cell-editor' &&
                     columnKey !== undefined &&
@@ -629,8 +652,8 @@ export class LyraTable extends LyraElement {
                 return;
             const cell = target.closest('[part="cell"][data-col-key]');
             const row = target.closest('[data-row-key]');
-            if (cell && row?.dataset.rowKey && cell.dataset.colKey) {
-                this.startEditing(row.dataset.rowKey, cell.dataset.colKey);
+            if (cell && row?.dataset['rowKey'] && cell.dataset['colKey']) {
+                this.startEditing(row.dataset['rowKey'], cell.dataset['colKey']);
             }
         };
         this.toggleColumns = () => {
@@ -652,10 +675,10 @@ export class LyraTable extends LyraElement {
             // below.
             const th = target.closest('th[data-col-key]');
             if (th)
-                return this.activateColumn(th.dataset.colKey);
+                return this.activateColumn(th.dataset['colKey']);
             const tr = target.closest('[data-row-key]');
             if (tr)
-                this.activateRow(tr.dataset.rowKey);
+                this.activateRow(tr.dataset['rowKey']);
         };
         this.onTableKeyDown = (e) => {
             const target = e.target;
@@ -675,6 +698,9 @@ export class LyraTable extends LyraElement {
         };
     }
     static { this.styles = [LyraElement.styles, styles, srOnly]; }
+    get storageFullKey() {
+        return this.storageKey ? `lr-table:${this.storageKey}` : undefined;
+    }
     parsePixelLength(value) {
         if (!value)
             return undefined;
@@ -748,7 +774,7 @@ export class LyraTable extends LyraElement {
     }
     syncResizeHandleValues() {
         for (const handle of this.renderRoot.querySelectorAll('[part="resize-handle"]')) {
-            const key = handle.dataset.colKey;
+            const key = handle.dataset['colKey'];
             if (!key)
                 continue;
             const column = this.columnsByKey.get(key);
@@ -762,6 +788,15 @@ export class LyraTable extends LyraElement {
                 handle.setAttribute('aria-valuenow', String(Math.round(rendered)));
         }
     }
+    firstUpdated(changed) {
+        super.firstUpdated(changed);
+        // A grid with no accessible name is a real a11y defect but silently renders. Warn once per
+        // element (dev signal; the guard keeps it out of hot render paths and prevents log spam).
+        if (!this.accessibleLabel && !this.getAttribute('aria-label') && !this.caption) {
+            console.warn('<lr-table> has no accessible name: set `accessibleLabel`, a host `aria-label`, or ' +
+                '`caption` so assistive technology can identify the grid.');
+        }
+    }
     connectedCallback() {
         super.connectedCallback();
         this.resizeObserver = new ResizeObserver(this.scheduleLayoutSync);
@@ -843,8 +878,8 @@ export class LyraTable extends LyraElement {
         const visible = this.visibleHeaders();
         if (visible.length === 0 || this.activeColKey === null)
             return;
-        if (!visible.some((header) => header.dataset.colKey === this.activeColKey)) {
-            this.activeColKey = visible[0].dataset.colKey ?? null;
+        if (!visible.some((header) => header.dataset['colKey'] === this.activeColKey)) {
+            this.activeColKey = visible[0].dataset['colKey'] ?? null; // safe: length === 0 returned above
         }
     }
     keyOf(row, index) {
@@ -930,12 +965,12 @@ export class LyraTable extends LyraElement {
     /** The header cell that currently owns `tabindex="0"`. */
     focusedColKey() {
         const visible = this.visibleHeaders();
-        const visibleKeys = new Set(visible.map((el) => el.dataset.colKey).filter((key) => key !== undefined && this.columnsByKey.has(key)));
+        const visibleKeys = new Set(visible.map((el) => el.dataset['colKey']).filter((key) => key !== undefined && this.columnsByKey.has(key)));
         if (this.activeColKey !== null && this.columnsByKey.has(this.activeColKey)) {
             if (visibleKeys.size === 0 || visibleKeys.has(this.activeColKey))
                 return this.activeColKey;
         }
-        return visible.find((el) => el.dataset.colKey !== undefined && this.columnsByKey.has(el.dataset.colKey))?.dataset.colKey ?? this.columns[0]?.key ?? null;
+        return visible.find((el) => el.dataset['colKey'] !== undefined && this.columnsByKey.has(el.dataset['colKey']))?.dataset['colKey'] ?? this.columns[0]?.key ?? null;
     }
     /** The body row that currently owns `tabindex="0"`. */
     focusedRowKey() {
@@ -952,6 +987,16 @@ export class LyraTable extends LyraElement {
     }
     willUpdate(changed) {
         super.willUpdate(changed);
+        // Restore a persisted `showAllColumns` preference once, before the first render, so the restored
+        // value folds into the first paint with no follow-up update -- doing this in firstUpdated()
+        // (after the first render) would schedule a second update and trip Lit's dev warning. Mirrors
+        // lr-app-rail's loadPersisted() call in its own willUpdate(). The `persistReady` gate in
+        // updated() keeps this restored value from being written straight back.
+        if (!this.hasUpdated) {
+            const parsed = readPersistedState(this.storageFullKey, (v) => typeof v === 'object' && v !== null);
+            if (parsed && typeof parsed.showAllColumns === 'boolean')
+                this.showAllColumns = parsed.showAllColumns;
+        }
         if (changed.has('rows') ||
             changed.has('rowKey') ||
             changed.has('filterText') ||
@@ -990,7 +1035,7 @@ export class LyraTable extends LyraElement {
         // matching a first-match linear scan over document order.
         const headerWidths = new Map();
         for (const el of this.renderRoot.querySelectorAll('th[data-col-key]')) {
-            const key = el.dataset.colKey;
+            const key = el.dataset['colKey'];
             if (key !== undefined && !headerWidths.has(key))
                 headerWidths.set(key, el.offsetWidth);
         }
@@ -1013,6 +1058,8 @@ export class LyraTable extends LyraElement {
         let runningEnd = 0;
         for (let i = this.columns.length - 1; i >= 0; i--) {
             const col = this.columns[i];
+            if (!col)
+                continue; // safe: counted loop over this.columns — never undefined in-bounds
             if (stickyDirection(col.sticky) !== 'end')
                 continue;
             offsets.set(col.key, runningEnd);
@@ -1059,7 +1106,7 @@ export class LyraTable extends LyraElement {
             return;
         const offsets = this.stickyOffsets();
         this.renderRoot.querySelectorAll('[data-col-key]').forEach((el) => {
-            const key = el.dataset.colKey;
+            const key = el.dataset['colKey'];
             if (key !== undefined && offsets.has(key)) {
                 el.style.setProperty('--lr-table-sticky-offset', `${offsets.get(key)}px`);
             }
@@ -1082,6 +1129,13 @@ export class LyraTable extends LyraElement {
      *  reflects the rendered columns. */
     updated(changed) {
         super.updated(changed);
+        // Persist `showAllColumns` whenever it changes, but never on the initial update -- willUpdate()
+        // restored it on that pass, so writing it back would be redundant, and with no `storage-key` set
+        // `writePersistedState(undefined, ...)` is a silent no-op regardless.
+        if (this.persistReady && changed.has('showAllColumns')) {
+            writePersistedState(this.storageFullKey, { showAllColumns: this.showAllColumns });
+        }
+        this.persistReady = true;
         if (changed.has('columns') || changed.has('rows') || changed.has('rowKey'))
             this.applyStickyOffsets();
         this.syncResizeHandleValues();
@@ -1176,9 +1230,9 @@ export class LyraTable extends LyraElement {
      *  selector: both are consumer-supplied strings, and the row key additionally carries an encoding
      *  prefix (`string:a`), so neither is safe to splat into CSS unescaped. */
     editorElementFor(rowKey, columnKey) {
-        const row = [...this.renderRoot.querySelectorAll('[data-row-key]')].find((el) => el.dataset.rowKey === rowKey);
+        const row = [...this.renderRoot.querySelectorAll('[data-row-key]')].find((el) => el.dataset['rowKey'] === rowKey);
         const cell = row
-            ? [...row.querySelectorAll('td[data-col-key]')].find((el) => el.dataset.colKey === columnKey)
+            ? [...row.querySelectorAll('td[data-col-key]')].find((el) => el.dataset['colKey'] === columnKey)
             : undefined;
         return cell?.querySelector('[part="cell-editor"]') ?? null;
     }
@@ -1214,21 +1268,21 @@ export class LyraTable extends LyraElement {
         return [...this.renderRoot.querySelectorAll('th[data-col-key]')].filter((el) => el.offsetParent !== null);
     }
     focusHeader(el) {
-        if (!el?.dataset.colKey)
+        if (!el?.dataset['colKey'])
             return;
-        this.activeColKey = el.dataset.colKey;
+        this.activeColKey = el.dataset['colKey'];
         el.focus();
     }
     focusRow(el) {
-        if (!el?.dataset.rowKey)
+        if (!el?.dataset['rowKey'])
             return;
-        this.activeRowKey = el.dataset.rowKey;
+        this.activeRowKey = el.dataset['rowKey'];
         el.focus();
     }
     onHeaderKeyDown(e, th) {
         if (e.key === 'Enter' || e.key === ' ') {
             e.preventDefault();
-            this.activateColumn(th.dataset.colKey);
+            this.activateColumn(th.dataset['colKey']);
             return;
         }
         const headers = this.visibleHeaders();
@@ -1244,25 +1298,25 @@ export class LyraTable extends LyraElement {
         switch (e.key) {
             case 'ArrowLeft':
                 e.preventDefault();
-                this.focusHeader(headers[rtl ? Math.min(headers.length - 1, index + 1) : Math.max(0, index - 1)]);
+                this.focusHeader(headers[rtl ? Math.min(headers.length - 1, index + 1) : Math.max(0, index - 1)] ?? null);
                 return;
             case 'ArrowRight':
                 e.preventDefault();
-                this.focusHeader(headers[rtl ? Math.max(0, index - 1) : Math.min(headers.length - 1, index + 1)]);
+                this.focusHeader(headers[rtl ? Math.max(0, index - 1) : Math.min(headers.length - 1, index + 1)] ?? null);
                 return;
             case 'Home':
                 e.preventDefault();
-                this.focusHeader(headers[0]);
+                this.focusHeader(headers[0] ?? null);
                 return;
             case 'End':
                 e.preventDefault();
-                this.focusHeader(headers[headers.length - 1]);
+                this.focusHeader(headers[headers.length - 1] ?? null);
                 return;
             case 'ArrowDown': {
                 e.preventDefault();
                 const rows = [...this.renderRoot.querySelectorAll('[data-row-key]')];
                 const key = this.focusedRowKey();
-                this.focusRow(rows.find((r) => r.dataset.rowKey === key) ?? rows[0] ?? null);
+                this.focusRow(rows.find((r) => r.dataset['rowKey'] === key) ?? rows[0] ?? null);
                 return;
             }
             default:
@@ -1272,7 +1326,7 @@ export class LyraTable extends LyraElement {
     onRowKeyDown(e, tr) {
         if (e.key === 'Enter' || e.key === ' ') {
             e.preventDefault();
-            this.activateRow(tr.dataset.rowKey);
+            this.activateRow(tr.dataset['rowKey']);
             return;
         }
         const bodyRows = [...this.renderRoot.querySelectorAll('[data-row-key]')];
@@ -1282,26 +1336,26 @@ export class LyraTable extends LyraElement {
         switch (e.key) {
             case 'ArrowDown':
                 e.preventDefault();
-                this.focusRow(bodyRows[Math.min(bodyRows.length - 1, index + 1)]);
+                this.focusRow(bodyRows[Math.min(bodyRows.length - 1, index + 1)] ?? null);
                 return;
             case 'ArrowUp':
                 e.preventDefault();
                 if (index === 0) {
                     const headers = this.visibleHeaders();
                     const key = this.focusedColKey();
-                    this.focusHeader(headers.find((h) => h.dataset.colKey === key) ?? headers[0] ?? null);
+                    this.focusHeader(headers.find((h) => h.dataset['colKey'] === key) ?? headers[0] ?? null);
                 }
                 else {
-                    this.focusRow(bodyRows[index - 1]);
+                    this.focusRow(bodyRows[index - 1] ?? null);
                 }
                 return;
             case 'Home':
                 e.preventDefault();
-                this.focusRow(bodyRows[0]);
+                this.focusRow(bodyRows[0] ?? null);
                 return;
             case 'End':
                 e.preventDefault();
-                this.focusRow(bodyRows[bodyRows.length - 1]);
+                this.focusRow(bodyRows[bodyRows.length - 1] ?? null);
                 return;
             default:
                 return;
@@ -1468,7 +1522,10 @@ export class LyraTable extends LyraElement {
             : html `<table
             part="table"
             role="grid"
-            aria-label=${this.getAttribute('aria-label') || nothing}
+            aria-label=${this.accessibleLabel || this.getAttribute('aria-label') || nothing}
+            aria-labelledby=${!this.accessibleLabel && !this.getAttribute('aria-label') && this.caption
+                ? this.captionId
+                : nothing}
             aria-multiselectable=${this.selectionMode === 'multiple' ? 'true' : nothing}
             ?data-has-column-widths=${hasColumnWidths}
             data-layout=${effectiveLayout}
@@ -1477,6 +1534,7 @@ export class LyraTable extends LyraElement {
             @dblclick=${this.onTableDoubleClick}
             @focusin=${this.onTableFocusIn}
           >
+            ${this.caption ? html `<caption part="caption" id=${this.captionId}>${this.caption}</caption>` : nothing}
             <colgroup>
               ${hasExpand ? html `<col style=${styleMap({ 'inline-size': 'var(--lr-icon-button-size)' })} />` : nothing}
               ${this.columns.map((col) => html `<col style=${styleMap({
@@ -1710,6 +1768,12 @@ __decorate([
 __decorate([
     property({ attribute: 'sort-dir' })
 ], LyraTable.prototype, "sortDir", void 0);
+__decorate([
+    property({ attribute: 'accessible-label' })
+], LyraTable.prototype, "accessibleLabel", void 0);
+__decorate([
+    property()
+], LyraTable.prototype, "caption", void 0);
 __decorate([
     property({ attribute: false })
 ], LyraTable.prototype, "rowKey", void 0);
@@ -1827,6 +1891,9 @@ __decorate([
 __decorate([
     property({ type: Boolean, attribute: 'show-all-columns', reflect: true })
 ], LyraTable.prototype, "showAllColumns", void 0);
+__decorate([
+    property({ attribute: 'storage-key' })
+], LyraTable.prototype, "storageKey", void 0);
 __decorate([
     state()
 ], LyraTable.prototype, "activeColKey", void 0);