@happyvertical/smrt-ui 0.42.4 → 0.42.6

package/dist/components/data/DataTable.svelte.d.ts

@@ -9,7 +9,7 @@
  * - Responsive with sticky header option
  * - Material 3 styling with theme token support
  */
-import type { Snippet } from 'svelte';
+import { type Snippet } from 'svelte';
 import type { DataTableColumn, DataTableProps } from './types.js';
 interface ExtendedProps<T> extends DataTableProps<T> {
     /** Global cell renderer - takes precedence over column.cell */

package/dist/components/data/DataTable.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataTable.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/data/DataTable.svelte.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAkBtC,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAa,MAAM,YAAY,CAAC;AAI7E,UAAU,aAAa,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAClD,+DAA+D;IAC/D,IAAI,CAAC,EAAE,OAAO,CACZ;QAAC;YAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;YAAC,GAAG,EAAE,CAAC,CAAC;YAAC,KAAK,EAAE,OAAO,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE;KAAC,CACxE,CAAC;CACH;AAAC,iBAAS,QAAQ,CAAC,CAAC;WAomBQ,aAAa,CAAC,CAAC,CAAC;;;;;EAAgH;AAC7J,cAAM,iBAAiB,CAAC,CAAC;IACrB,KAAK,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,MAAM,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAClD,KAAK,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,QAAQ;IACR,OAAO;CACV;AAED,UAAU,qBAAqB;IAC3B,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;KAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5X,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3H,YAAY,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;CACjE;AACD,QAAA,MAAM,SAAS,EAAE,qBAAmC,CAAC;AACnC,KAAK,SAAS,CAAC,CAAC,IAAI,YAAY,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,eAAe,SAAS,CAAC"}
+{"version":3,"file":"DataTable.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/data/DataTable.svelte.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,KAAK,OAAO,EAAQ,MAAM,QAAQ,CAAC;AA4B5C,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAGf,MAAM,YAAY,CAAC;AAIpB,UAAU,aAAa,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAClD,+DAA+D;IAC/D,IAAI,CAAC,EAAE,OAAO,CACZ;QAAC;YAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;YAAC,GAAG,EAAE,CAAC,CAAC;YAAC,KAAK,EAAE,OAAO,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE;KAAC,CACxE,CAAC;CACH;AAAC,iBAAS,QAAQ,CAAC,CAAC;WAsxCQ,aAAa,CAAC,CAAC,CAAC;;;;;EAAgH;AAC7J,cAAM,iBAAiB,CAAC,CAAC;IACrB,KAAK,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,MAAM,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAClD,KAAK,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,QAAQ;IACR,OAAO;CACV;AAED,UAAU,qBAAqB;IAC3B,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;KAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5X,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3H,YAAY,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;CACjE;AACD,QAAA,MAAM,SAAS,EAAE,qBAAmC,CAAC;AACnC,KAAK,SAAS,CAAC,CAAC,IAAI,YAAY,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,eAAe,SAAS,CAAC"}

package/dist/components/data/DataTableController.d.ts

@@ -51,6 +51,16 @@ export interface DataTableColumnVisibility {
     columnId: string;
     visible: boolean;
 }
+/** A persisted width in CSS pixels. Static column widths remain presentation defaults. */
+export interface DataTableColumnWidth {
+    columnId: string;
+    width: number;
+}
+/** A persisted edge pin. Column order is retained within each pin partition. */
+export interface DataTableColumnPinning {
+    columnId: string;
+    position: 'start' | 'end';
+}
 /**
  * The JSON-safe, persistable portion of a table view. Selection and expansion
  * are serialized as canonical arrays rather than Sets.
@@ -63,6 +73,8 @@ export interface DataTableViewState {
     pageSize: number | null;
     columnOrder: string[];
     columnVisibility: DataTableColumnVisibility[];
+    columnWidths: DataTableColumnWidth[];
+    columnPinning: DataTableColumnPinning[];
     selection: DataTableSelection;
     /**
      * Legacy shorthand for row-ID selections. It is always derived from
@@ -72,15 +84,19 @@ export interface DataTableViewState {
     expandedRowIds: DataTableRowId[];
 }
 /**
- * Accepts a version-1 controlled state while the controller always emits the
- * normalized version-2 `DataTableViewState` with an explicit selection.
+ * Accepts version-1 and version-2 controlled state while the controller emits
+ * normalized version-3 state with explicit selection and column layout.
  */
-export type DataTableViewStateInput = Omit<DataTableViewState, 'selection'> & {
+export type DataTableViewStateInput = Omit<DataTableViewState, 'selection' | 'columnWidths' | 'columnPinning'> & {
     selection?: DataTableSelection;
+    /** Optional while restoring version-1 or version-2 state. */
+    columnWidths?: DataTableColumnWidth[];
+    /** Optional while restoring version-1 or version-2 state. */
+    columnPinning?: DataTableColumnPinning[];
 };
 /** The stable envelope intended for URL and saved-view adapters. */
 export interface DataTableSnapshot {
-    version: 2;
+    version: 3;
     modes: DataTableModes;
     state: DataTableViewState;
 }
@@ -110,6 +126,20 @@ export type DataTableCommand = {
 } | {
     type: 'setColumnVisibility';
     columns: DataTableColumnVisibility[];
+} | {
+    type: 'setColumnWidths';
+    columns: DataTableColumnWidth[];
+} | {
+    type: 'setColumnWidth';
+    columnId: string;
+    width: number | null;
+} | {
+    type: 'setColumnPinning';
+    columns: DataTableColumnPinning[];
+} | {
+    type: 'setColumnPin';
+    columnId: string;
+    position: DataTableColumnPinning['position'] | null;
 } | {
     type: 'setSelection';
     selection: DataTableSelection;
@@ -148,6 +178,8 @@ export interface DataTableControllerOptions {
     modes?: Partial<DataTableModes>;
     /** Optional known columns let the controller ignore stale saved-view fields. */
     columnIds?: readonly string[];
+    /** Static schema constraints that saved or controlled state may not override. */
+    hiddenColumnIds?: readonly string[];
     onStateChange?: (state: DataTableViewState, command: DataTableCommand) => void;
 }
 export type DataTableStateListener = (transition: DataTableTransition) => void;
@@ -168,6 +200,13 @@ export declare class DataTableController {
     private state;
     private modes;
     private columnIds?;
+    private hiddenColumnIds?;
+    /**
+     * Static schema visibility is a rendering constraint, not a saved-view
+     * preference. Keep the latter while a column is constrained so removing the
+     * constraint restores the caller's prior intent.
+     */
+    private readonly visibilityBeforeStaticHide;
     private controlled;
     private readonly listeners;
     private readonly onStateChange?;
@@ -186,7 +225,8 @@ export declare class DataTableController {
     /** Configures transformation ownership; this remains outside persisted state. */
     setModes(modes: Partial<DataTableModes>): DataTableTransition;
     /** Reconciles stale saved-view column IDs with the renderer's current columns. */
-    setColumnIds(columnIds: readonly string[]): DataTableTransition;
+    setColumnIds(columnIds: readonly string[], hiddenColumnIds?: readonly string[]): DataTableTransition;
+    private rememberStaticVisibility;
     /** Clamp against a reliable total. A missing total intentionally does not guess. */
     clampPage(totalRows: number | null | undefined): DataTableTransition;
     private emit;

package/dist/components/data/DataTableController.d.ts.map

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

package/dist/components/data/DataTableController.js

@@ -17,6 +17,8 @@ const DEFAULT_STATE = {
     pageSize: null,
     columnOrder: [],
     columnVisibility: [],
+    columnWidths: [],
+    columnPinning: [],
     selection: { scope: 'explicit', rowIds: [] },
     selectedRowIds: [],
     expandedRowIds: [],
@@ -271,6 +273,34 @@ function normalizeVisibility(values) {
         .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
         .map(([columnId, visible]) => ({ columnId, visible }));
 }
+function normalizeWidths(values) {
+    const entries = new Map();
+    for (const entry of values) {
+        const columnId = assertColumnId(entry?.columnId, 'width column id');
+        if (typeof entry?.width !== 'number' ||
+            !Number.isFinite(entry.width) ||
+            entry.width <= 0) {
+            throw new TypeError('DataTable column widths must be positive finite numbers');
+        }
+        entries.set(columnId, entry.width);
+    }
+    return [...entries.entries()]
+        .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
+        .map(([columnId, width]) => ({ columnId, width }));
+}
+function normalizePinning(values) {
+    const entries = new Map();
+    for (const entry of values) {
+        const columnId = assertColumnId(entry?.columnId, 'pin column id');
+        if (entry?.position !== 'start' && entry?.position !== 'end') {
+            throw new TypeError('DataTable column pins must be start or end');
+        }
+        entries.set(columnId, entry.position);
+    }
+    return [...entries.entries()]
+        .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
+        .map(([columnId, position]) => ({ columnId, position }));
+}
 function normalizeModes(modes) {
     const result = { ...DEFAULT_MODES, ...modes };
     for (const mode of Object.values(result)) {
@@ -280,12 +310,13 @@ function normalizeModes(modes) {
     }
     return result;
 }
-function normalizeState(state, columnIds) {
+function normalizeState(state, columnIds, hiddenColumnIds) {
     const input = state ?? {};
     const selection = normalizeSelection(input.selection, input.selectedRowIds ?? DEFAULT_STATE.selectedRowIds);
     const knownColumns = columnIds ? normalizeUniqueColumnIds(columnIds) : null;
     const allowed = knownColumns ? new Set(knownColumns) : null;
     const keepKnown = (columnId) => !allowed || allowed.has(columnId);
+    const hidden = new Set((hiddenColumnIds ? normalizeUniqueColumnIds(hiddenColumnIds) : []).filter(keepKnown));
     const visibility = normalizeVisibility(input.columnVisibility ?? DEFAULT_STATE.columnVisibility).filter((entry) => keepKnown(entry.columnId));
     const knownVisibility = new Map(visibility.map((entry) => [entry.columnId, entry.visible]));
     if (knownColumns) {
@@ -294,6 +325,8 @@ function normalizeState(state, columnIds) {
                 knownVisibility.set(columnId, true);
         }
     }
+    for (const columnId of hidden)
+        knownVisibility.set(columnId, false);
     const columnOrder = normalizeUniqueColumnIds(input.columnOrder ?? DEFAULT_STATE.columnOrder).filter(keepKnown);
     if (knownColumns) {
         for (const columnId of knownColumns) {
@@ -301,6 +334,8 @@ function normalizeState(state, columnIds) {
                 columnOrder.push(columnId);
         }
     }
+    const columnWidths = normalizeWidths(input.columnWidths ?? DEFAULT_STATE.columnWidths).filter((entry) => keepKnown(entry.columnId));
+    const columnPinning = normalizePinning(input.columnPinning ?? DEFAULT_STATE.columnPinning).filter((entry) => keepKnown(entry.columnId));
     return {
         search: typeof input.search === 'string' ? input.search : DEFAULT_STATE.search,
         filters: normalizeFilters(input.filters ?? DEFAULT_STATE.filters).filter((filter) => keepKnown(filter.columnId)),
@@ -312,6 +347,8 @@ function normalizeState(state, columnIds) {
             columnId,
             visible,
         }))),
+        columnWidths,
+        columnPinning,
         selection,
         selectedRowIds: selectedRowIdsFor(selection),
         expandedRowIds: normalizeRowIds(input.expandedRowIds ?? DEFAULT_STATE.expandedRowIds),
@@ -413,6 +450,57 @@ export function transitionDataTableState(state, command) {
                 columnVisibility: normalizeVisibility(command.columns),
             };
             break;
+        case 'setColumnWidths':
+            next = {
+                ...current,
+                columnWidths: normalizeWidths(command.columns),
+            };
+            break;
+        case 'setColumnWidth': {
+            const columnId = assertColumnId(command.columnId, 'width column id');
+            const widths = new Map(current.columnWidths.map((entry) => [entry.columnId, entry.width]));
+            if (command.width === null) {
+                widths.delete(columnId);
+            }
+            else {
+                const normalized = normalizeWidths([
+                    { columnId, width: command.width },
+                ]);
+                widths.set(columnId, normalized[0].width);
+            }
+            next = {
+                ...current,
+                columnWidths: normalizeWidths([...widths.entries()].map(([id, width]) => ({ columnId: id, width }))),
+            };
+            break;
+        }
+        case 'setColumnPinning':
+            next = {
+                ...current,
+                columnPinning: normalizePinning(command.columns),
+            };
+            break;
+        case 'setColumnPin': {
+            const columnId = assertColumnId(command.columnId, 'pin column id');
+            const pins = new Map(current.columnPinning.map((entry) => [entry.columnId, entry.position]));
+            if (command.position === null) {
+                pins.delete(columnId);
+            }
+            else {
+                const normalized = normalizePinning([
+                    { columnId, position: command.position },
+                ]);
+                pins.set(columnId, normalized[0].position);
+            }
+            next = {
+                ...current,
+                columnPinning: normalizePinning([...pins.entries()].map(([id, position]) => ({
+                    columnId: id,
+                    position,
+                }))),
+            };
+            break;
+        }
         case 'setSelection':
             next = withSelection(current, command.selection);
             break;
@@ -478,10 +566,10 @@ export function hydrateDataTableSnapshot(value) {
         throw new TypeError('DataTable snapshot must be a plain object');
     }
     const input = value;
-    if (input.version !== 1 && input.version !== 2)
+    if (input.version !== 1 && input.version !== 2 && input.version !== 3)
         throw new TypeError('Unsupported DataTable snapshot version');
     return {
-        version: 2,
+        version: 3,
         modes: normalizeModes(input.modes),
         state: normalizeState(input.state),
     };
@@ -491,6 +579,13 @@ export class DataTableController {
     state;
     modes;
     columnIds;
+    hiddenColumnIds;
+    /**
+     * Static schema visibility is a rendering constraint, not a saved-view
+     * preference. Keep the latter while a column is constrained so removing the
+     * constraint restores the caller's prior intent.
+     */
+    visibilityBeforeStaticHide = new Map();
     controlled;
     listeners = new Set();
     onStateChange;
@@ -499,8 +594,12 @@ export class DataTableController {
         this.columnIds = options.columnIds
             ? normalizeUniqueColumnIds(options.columnIds)
             : undefined;
+        this.hiddenColumnIds = options.hiddenColumnIds
+            ? normalizeUniqueColumnIds(options.hiddenColumnIds)
+            : undefined;
+        this.rememberStaticVisibility(options.state ?? options.initialState ?? {}, this.hiddenColumnIds ?? []);
         this.controlled = options.state !== undefined;
-        this.state = normalizeState(options.state ?? options.initialState, this.columnIds);
+        this.state = normalizeState(options.state ?? options.initialState, this.columnIds, this.hiddenColumnIds);
         this.modes = normalizeModes(options.modes);
         this.onStateChange = options.onStateChange;
     }
@@ -511,7 +610,7 @@ export class DataTableController {
         return { ...this.modes };
     }
     snapshot() {
-        return { version: 2, modes: this.getModes(), state: this.getState() };
+        return { version: 3, modes: this.getModes(), state: this.getState() };
     }
     subscribe(listener) {
         this.listeners.add(listener);
@@ -520,9 +619,9 @@ export class DataTableController {
     /** Dispatches a serializable command. Controlled controllers emit a proposal only. */
     dispatch(command) {
         const previous = this.snapshot();
-        const candidate = normalizeState(transitionDataTableState(this.state, command), this.columnIds);
+        const candidate = normalizeState(transitionDataTableState(this.state, command), this.columnIds, this.hiddenColumnIds);
         const next = {
-            version: 2,
+            version: 3,
             modes: this.getModes(),
             state: candidate,
         };
@@ -552,9 +651,12 @@ export class DataTableController {
     /** Supplies state from a controlled host or an external persistence adapter. */
     replaceState(state) {
         const previous = this.snapshot();
-        const nextState = normalizeState(state, this.columnIds);
+        if (this.controlled) {
+            this.rememberStaticVisibility(state, this.hiddenColumnIds ?? [], true);
+        }
+        const nextState = normalizeState(state, this.columnIds, this.hiddenColumnIds);
         const next = {
-            version: 2,
+            version: 3,
             modes: this.getModes(),
             state: nextState,
         };
@@ -589,10 +691,34 @@ export class DataTableController {
         return transition;
     }
     /** Reconciles stale saved-view column IDs with the renderer's current columns. */
-    setColumnIds(columnIds) {
+    setColumnIds(columnIds, hiddenColumnIds = []) {
         const previous = this.snapshot();
+        const previousHidden = new Set(this.hiddenColumnIds ?? []);
         this.columnIds = normalizeUniqueColumnIds(columnIds);
-        this.state = normalizeState(this.state, this.columnIds);
+        this.hiddenColumnIds = normalizeUniqueColumnIds(hiddenColumnIds);
+        this.rememberStaticVisibility(this.state, this.hiddenColumnIds.filter((columnId) => !previousHidden.has(columnId)));
+        const restoredVisibility = new Map(this.state.columnVisibility.map((entry) => [
+            entry.columnId,
+            entry.visible,
+        ]));
+        for (const columnId of previousHidden) {
+            if (this.hiddenColumnIds.includes(columnId))
+                continue;
+            const visible = this.visibilityBeforeStaticHide.get(columnId);
+            if (visible !== undefined)
+                restoredVisibility.set(columnId, visible);
+            this.visibilityBeforeStaticHide.delete(columnId);
+        }
+        const knownColumns = new Set(this.columnIds);
+        for (const columnId of this.visibilityBeforeStaticHide.keys()) {
+            if (!knownColumns.has(columnId)) {
+                this.visibilityBeforeStaticHide.delete(columnId);
+            }
+        }
+        this.state = normalizeState({
+            ...this.state,
+            columnVisibility: [...restoredVisibility.entries()].map(([columnId, visible]) => ({ columnId, visible })),
+        }, this.columnIds, this.hiddenColumnIds);
         const next = this.snapshot();
         const changed = snapshotSignature(previous) !== snapshotSignature(next);
         const transition = { command: null, previous, next, changed };
@@ -600,6 +726,22 @@ export class DataTableController {
             this.emit(transition);
         return transition;
     }
+    rememberStaticVisibility(state, hiddenColumnIds, overwrite = false) {
+        const visibility = new Map(normalizeVisibility(state.columnVisibility ?? []).map((entry) => [
+            entry.columnId,
+            entry.visible,
+        ]));
+        for (const columnId of hiddenColumnIds) {
+            const visible = visibility.get(columnId);
+            if (visible !== undefined &&
+                (overwrite || !this.visibilityBeforeStaticHide.has(columnId))) {
+                this.visibilityBeforeStaticHide.set(columnId, visible);
+            }
+            else if (!this.visibilityBeforeStaticHide.has(columnId)) {
+                this.visibilityBeforeStaticHide.set(columnId, true);
+            }
+        }
+    }
     /** Clamp against a reliable total. A missing total intentionally does not guess. */
     clampPage(totalRows) {
         if (totalRows === null || totalRows === undefined) {

package/dist/components/data/DataTableLayout.d.ts

@@ -0,0 +1,37 @@
+import type { DataTableColumnPinning, DataTableViewState } from './DataTableController.js';
+import type { DataTableColumn } from './types.js';
+export interface DataTableResolvedColumn<T> {
+    column: DataTableColumn<T>;
+    pin?: DataTableColumnPinning['position'];
+    /** A persisted pixel width supersedes the column's presentational default. */
+    width?: number;
+    /** CSS-safe width used for a sticky offset when one is available. */
+    offsetWidth: string;
+    stickyOffset?: string;
+}
+export interface DataTableHeaderGroupCell {
+    kind: 'group';
+    key: string;
+    label: string;
+    colspan: number;
+    rowspan: number;
+    pin?: DataTableColumnPinning['position'];
+    stickyOffset?: string;
+}
+export interface DataTableHeaderLeafCell<T> {
+    kind: 'leaf';
+    column: DataTableResolvedColumn<T>;
+    rowspan: number;
+}
+export type DataTableHeaderCell<T> = DataTableHeaderGroupCell | DataTableHeaderLeafCell<T>;
+export interface DataTableLayout<T> {
+    columns: DataTableResolvedColumn<T>[];
+    headerRows: DataTableHeaderCell<T>[][];
+}
+/**
+ * Resolve a DOM-safe table layout from canonical controller state. Pinning is
+ * a partition of the configured order so the visual and assistive orders stay
+ * aligned. Header groups are then rebuilt from the final visible leaf order.
+ */
+export declare function resolveDataTableLayout<T>(columns: readonly DataTableColumn<T>[], state: Pick<DataTableViewState, 'columnOrder' | 'columnVisibility' | 'columnWidths' | 'columnPinning'>, measuredWidths?: Readonly<Record<string, number>>): DataTableLayout<T>;
+//# sourceMappingURL=DataTableLayout.d.ts.map

package/dist/components/data/DataTableLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataTableLayout.d.ts","sourceRoot":"","sources":["../../../src/components/data/DataTableLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,eAAe,EAA8B,MAAM,YAAY,CAAC;AAE9E,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC3B,GAAG,CAAC,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IACzC,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAC7B,wBAAwB,GACxB,uBAAuB,CAAC,CAAC,CAAC,CAAC;AAE/B,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;CACxC;AA4GD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,OAAO,EAAE,SAAS,eAAe,CAAC,CAAC,CAAC,EAAE,EACtC,KAAK,EAAE,IAAI,CACT,kBAAkB,EAClB,aAAa,GAAG,kBAAkB,GAAG,cAAc,GAAG,eAAe,CACtE,EACD,cAAc,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GACpD,eAAe,CAAC,CAAC,CAAC,CA2DpB"}

package/dist/components/data/DataTableLayout.js

@@ -0,0 +1,135 @@
+function compareOrder(left, right, order) {
+    const leftOrder = order.get(left.id) ?? Number.MAX_SAFE_INTEGER;
+    const rightOrder = order.get(right.id) ?? Number.MAX_SAFE_INTEGER;
+    return leftOrder === rightOrder ? 0 : leftOrder - rightOrder;
+}
+function headerPath(column) {
+    const path = column.headerPath ?? [];
+    for (const segment of path) {
+        if (!segment ||
+            typeof segment.id !== 'string' ||
+            segment.id.length === 0 ||
+            typeof segment.label !== 'string' ||
+            segment.label.length === 0) {
+            throw new TypeError(`DataTable headerPath entries for ${column.id} require non-empty id and label`);
+        }
+    }
+    return path;
+}
+function offsetWidth(column, width, measuredWidth) {
+    if (measuredWidth !== undefined && measuredWidth > 0) {
+        return `${measuredWidth}px`;
+    }
+    if (width !== undefined)
+        return `${width}px`;
+    return column.width ?? column.minWidth ?? '0px';
+}
+function resolveHeaderRows(columns) {
+    const paths = columns.map(({ column }) => headerPath(column));
+    const groupDepth = Math.max(0, ...paths.map((path) => path.length));
+    if (groupDepth === 0) {
+        return [columns.map((column) => ({ kind: 'leaf', column, rowspan: 1 }))];
+    }
+    const rows = Array.from({ length: groupDepth + 1 }, () => []);
+    for (let level = 0; level <= groupDepth; level += 1) {
+        let index = 0;
+        while (index < columns.length) {
+            const path = paths[index];
+            if (path.length < level) {
+                index += 1;
+                continue;
+            }
+            if (path.length === level) {
+                rows[level].push({
+                    kind: 'leaf',
+                    column: columns[index],
+                    rowspan: groupDepth - level + 1,
+                });
+                index += 1;
+                continue;
+            }
+            const segment = path[level];
+            let end = index + 1;
+            while (end < columns.length &&
+                paths[end][level]?.id === segment.id &&
+                paths[end][level]?.label === segment.label) {
+                end += 1;
+            }
+            rows[level].push({
+                kind: 'group',
+                key: `${level}:${index}:${segment.id}`,
+                label: segment.label,
+                colspan: end - index,
+                rowspan: 1,
+                ...resolveGroupPin(columns.slice(index, end)),
+            });
+            index = end;
+        }
+    }
+    return rows;
+}
+function resolveGroupPin(columns) {
+    const pin = columns[0]?.pin;
+    if (!pin || !columns.every((column) => column.pin === pin))
+        return {};
+    const edge = pin === 'start' ? columns[0] : columns.at(-1);
+    return { pin, stickyOffset: edge?.stickyOffset };
+}
+/**
+ * Resolve a DOM-safe table layout from canonical controller state. Pinning is
+ * a partition of the configured order so the visual and assistive orders stay
+ * aligned. Header groups are then rebuilt from the final visible leaf order.
+ */
+export function resolveDataTableLayout(columns, state, measuredWidths = {}) {
+    const order = new Map(state.columnOrder.map((id, index) => [id, index]));
+    const visibility = new Map(state.columnVisibility.map((entry) => [entry.columnId, entry.visible]));
+    const widths = new Map(state.columnWidths.map((entry) => [entry.columnId, entry.width]));
+    const pinning = new Map(state.columnPinning.map((entry) => [entry.columnId, entry.position]));
+    const ordered = columns
+        .filter((column) => !column.hidden && visibility.get(column.id) !== false)
+        .slice()
+        .sort((left, right) => compareOrder(left, right, order));
+    const partitions = {
+        start: ordered.filter((column) => pinning.get(column.id) === 'start'),
+        center: ordered.filter((column) => !pinning.has(column.id)),
+        end: ordered.filter((column) => pinning.get(column.id) === 'end'),
+    };
+    const resolved = [];
+    let startOffset = '0px';
+    for (const column of partitions.start) {
+        const width = widths.get(column.id);
+        const offset = offsetWidth(column, width, measuredWidths[column.id]);
+        resolved.push({
+            column,
+            pin: 'start',
+            width,
+            offsetWidth: offset,
+            stickyOffset: startOffset,
+        });
+        startOffset = `calc(${startOffset} + ${offset})`;
+    }
+    for (const column of partitions.center) {
+        const width = widths.get(column.id);
+        resolved.push({
+            column,
+            width,
+            offsetWidth: offsetWidth(column, width, measuredWidths[column.id]),
+        });
+    }
+    let endOffset = '0px';
+    const endColumns = [];
+    for (const column of partitions.end.slice().reverse()) {
+        const width = widths.get(column.id);
+        const offset = offsetWidth(column, width, measuredWidths[column.id]);
+        endColumns.unshift({
+            column,
+            pin: 'end',
+            width,
+            offsetWidth: offset,
+            stickyOffset: endOffset,
+        });
+        endOffset = `calc(${endOffset} + ${offset})`;
+    }
+    resolved.push(...endColumns);
+    return { columns: resolved, headerRows: resolveHeaderRows(resolved) };
+}

package/dist/components/data/DataTablePerformance.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Published, testable scale guidance for the DataTable pipeline.
+ *
+ * These are interaction thresholds, not hard data limits. Use the benchmark
+ * fixture before raising them for a new renderer, browser target, or cell shape.
+ */
+export declare const DATA_TABLE_SCALE_THRESHOLDS: {
+    readonly localRender: {
+        readonly maxRows: 250;
+        readonly maxCells: 5000;
+        readonly recommendation: "Use normal semantic rendering for ordinary, bounded result sets.";
+    };
+    readonly clientTransforms: {
+        readonly maxRows: 1000;
+        readonly maxCells: 20000;
+        readonly recommendation: "Use manual filtering, sorting, or paging once a client transform exceeds this budget.";
+    };
+    readonly manualPaging: {
+        readonly recommendedPageSize: 100;
+        readonly maxRenderedRows: 250;
+        readonly recommendation: "Keep remote pages bounded and pass totalRows only for a known server total.";
+    };
+    readonly virtualization: {
+        readonly minRows: 250;
+        readonly recommendation: "Use fixed-height virtualization for continuous browsing above the local render budget; preserve stable rowKey values and retain remote paging for unbounded data.";
+    };
+};
+export type DataTableScaleStrategy = 'local' | 'manual-paging' | 'virtualization';
+/** Returns the recommended rendering strategy for a known row and column count. */
+export declare function recommendDataTableScaleStrategy(rowCount: number, columnCount: number): DataTableScaleStrategy;
+//# sourceMappingURL=DataTablePerformance.d.ts.map

package/dist/components/data/DataTablePerformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataTablePerformance.d.ts","sourceRoot":"","sources":["../../../src/components/data/DataTablePerformance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;CAwB9B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAC9B,OAAO,GACP,eAAe,GACf,gBAAgB,CAAC;AAErB,mFAAmF;AACnF,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,sBAAsB,CAwBxB"}