@rozie-ui/data-table-lit 0.3.2 → 0.5.0

package/dist/index.d.cts

@@ -6,14 +6,14 @@ declare class DataTable extends DataTable_base {
   static shadowRootOptions: ShadowRootInit;
   static styles: _$lit.CSSResult;
   /**
-   * The row data — `model: true`, so a committed cell/row edit writes a **fresh** array back through `r-model:data` (uncontrolled fallback `dataDefault`). A stable reference per Rozie's setup-once model — fed directly into table-core (never map/cloned in the watcher).
+   * The row data — `model: true`, so a committed cell/row edit writes a **fresh** array back through the two-way `data` binding (uncontrolled fallback `dataDefault`). A stable reference per Rozie's setup-once model — fed directly into table-core (never map/cloned in the watcher).
    * @example
    * <rozie-data-table .data=${rows} @data-change=${…} .columns=${cols}></rozie-data-table>
    */
   _data_attr: any[];
   private _dataControllable;
   /**
-   * Config-array column fallback (lower precedence than `<Column>` children). Each entry: `{ id?, field, header?, sortable?, filterable?, pinned?, width? }`. Columns may come from this array, from `<Column>` children, or both (id-keyed last-write-wins union).
+   * Config-array column fallback (lower precedence than `<Column>` children). Each entry: `{ id?, field, header?, sortable?, filterable?, pinned?, width? }`. Columns may come from this array, from `<Column>` children, or both (id-keyed last-write-wins union). A `pinned` value of `'left'` or `'right'` is applied once as the table's initial `columnPinning` state — identical to `<Column pinned>` — which also REORDERS that column, since table-core orders visible cells `[left-pinned, center, right-pinned]`. A consumer who has already expressed a pin (an initial two-way `columnPinning` model value or an interactive pin) owns the slice and this declaration is ignored.
    */
   columns: any[];
   /**
@@ -53,7 +53,7 @@ declare class DataTable extends DataTable_base {
    */
   pageCount: number | null;
   /**
-   * Opt-in **expandable rows**. When `true`, a leading chevron expander column auto-injects (after the select column) and `getExpandedRowModel` activates; default `false` is byte-identical-off. Every row can expand to reveal a `#detail` panel unless `getSubRows` is supplied (then only rows with children expand). Bind `:expandable="true"` (a bare attr only coerces on Vue+Lit).
+   * Opt-in **expandable rows**. When `true`, a leading chevron expander column auto-injects (after the select column) and `getExpandedRowModel` activates; default `false` is byte-identical-off. Every row can expand to reveal a `#detail` panel unless `getSubRows` is supplied (then only rows with children expand). Pass `expandable` as a real boolean — a valueless attribute only coerces to `true` on Vue and Lit.
    */
   expandable: boolean;
   /**
@@ -70,7 +70,7 @@ declare class DataTable extends DataTable_base {
    */
   groupable: boolean;
   /**
-   * `GroupingState` — an ordered `string[]` of column ids (multi-column → nested groups, e.g. `['region','category']`). An empty/unbound list is ungrouped (byte-identical-off). Group-header rows are collapsible (they ride the expand model). Surfaces through `group-change`; uncontrolled fallback (`$data.groupingDefault`, default `[]`) when unbound — the default is `null` (mirroring `expanded`) so the uncontrolled fallback is reachable and the grouping auto-expand default can activate when a consumer applies grouping without binding `r-model:grouping` (a non-null `[]` default would short-circuit it). All reads are null-guarded, so table-core still receives an array.
+   * `GroupingState` — an ordered `string[]` of column ids (multi-column → nested groups, e.g. `['region','category']`). An empty/unbound list is ungrouped (byte-identical-off). Group-header rows are collapsible (they ride the expand model). Surfaces through `group-change`; uncontrolled fallback (`$data.groupingDefault`, default `[]`) when unbound — the default is `null` (mirroring `expanded`) so the uncontrolled fallback is reachable and the grouping auto-expand default can activate when a consumer applies grouping without binding the two-way `grouping` model (a non-null `[]` default would short-circuit it). All reads are null-guarded, so table-core still receives an array.
    */
   _grouping_attr: any[] | null;
   private _groupingControllable;
@@ -104,7 +104,7 @@ declare class DataTable extends DataTable_base {
    */
   stickyHeader: boolean;
   /**
-   * `'table'` (default, row-oriented, byte-behaviorally identical to a plain accessible table) | `'grid'` (GA since Phase 63) — lights up the full WAI-ARIA **[grid interaction mode](/components/data-table-grid-mode)**: `role="grid"`, a roving single tab-stop, 2-D APG arrow-key cell navigation, range selection, and clipboard support.
+   * `'table'` (default, row-oriented, byte-behaviorally identical to a plain accessible table) | `'grid'` — lights up the full WAI-ARIA **[grid interaction mode](/components/data-table-grid-mode)**: `role="grid"`, a roving single tab-stop, 2-D APG arrow-key cell navigation, range selection, and clipboard support.
    */
   interactionMode: string;
   /**
@@ -192,6 +192,26 @@ declare class DataTable extends DataTable_base {
     indeterminate: any;
     toggle: any;
   }) => unknown;
+  private _hasSlotDynamicColHeader;
+  private _slotDynamicColHeaderElements;
+  private _hasSlotDynamicFilter;
+  private _slotDynamicFilterElements;
+  private _hasSlotSelectCell;
+  private _slotSelectCellElements;
+  selectCell?: (scope: {
+    row: any;
+    checked: any;
+    toggle: any;
+  }) => unknown;
+  private _hasSlotDynamicCell;
+  private _slotDynamicCellElements;
+  private _hasSlotDynamicEditor;
+  private _slotDynamicEditorElements;
+  private _hasSlotDetail;
+  private _slotDetailElements;
+  detail?: (scope: {
+    row: any;
+  }) => unknown;
   private _hasSlotColHeader;
   private _slotColHeaderElements;
   colHeader?: (scope: {
@@ -208,13 +228,6 @@ declare class DataTable extends DataTable_base {
     minMax: any;
     setFilter: any;
   }) => unknown;
-  private _hasSlotSelectCell;
-  private _slotSelectCellElements;
-  selectCell?: (scope: {
-    row: any;
-    checked: any;
-    toggle: any;
-  }) => unknown;
   private _hasSlotCell;
   private _slotCellElements;
   cell?: (scope: {
@@ -234,12 +247,35 @@ declare class DataTable extends DataTable_base {
     cancel: any;
     autofocus: any;
   }) => unknown;
-  private _hasSlotDetail;
-  private _slotDetailElements;
-  detail?: (scope: {
-    row: any;
-  }) => unknown;
-  rozieSlots?: Record<string, (scope: any) => unknown>;
+  rozieSlots?: {
+    [key: `colHeader-${string}`]: (scope: {
+      columnId: any;
+      column: any;
+      label: any;
+    }) => unknown;
+    [key: `filter-${string}`]: (scope: {
+      columnId: any;
+      value: any;
+      uniqueValues: any;
+      minMax: any;
+      setFilter: any;
+    }) => unknown;
+    [key: `cell-${string}`]: (scope: {
+      columnId: any;
+      column: any;
+      row: any;
+      value: any;
+    }) => unknown;
+    [key: `editor-${string}`]: (scope: {
+      columnId: any;
+      column: any;
+      row: any;
+      value: any;
+      commit: any;
+      cancel: any;
+      autofocus: any;
+    }) => unknown;
+  } & Record<string, (scope: any) => unknown>;
   private _disconnectCleanups;
   private _rozieTornDown;
   private _armListeners;
@@ -269,6 +305,8 @@ declare class DataTable extends DataTable_base {
   expandedTouched: boolean;
   groupingActiveDefault: () => boolean;
   effectiveColumnPinning: () => any;
+  pinSeedApplied: boolean;
+  seedColumnPinning: () => void;
   currentState: () => any;
   currentData: () => any;
   buildConfigDef: (c: any) => {
@@ -349,6 +387,7 @@ declare class DataTable extends DataTable_base {
   onColumnSizingChangeCb: (updater: any) => void;
   onColumnOrderChangeCb: (updater: any) => void;
   onColumnPinningChangeCb: (updater: any) => void;
+  columnSizingInfoSync: any;
   onColumnSizingInfoChangeCb: (updater: any) => void;
   resolveVirtual: () => "rows" | "columns" | "both" | "off";
   rowsWindowed: () => boolean;
@@ -424,11 +463,9 @@ declare class DataTable extends DataTable_base {
   columnEditable: (colId: any) => boolean;
   editorTypeOf: (colId: any) => any;
   editorOptionsOf: (colId: any) => any;
-  hasEditorSlot: (colId: any) => boolean;
-  hasFilterSlot: () => boolean;
   columnIsFilterable: (colId: any) => boolean;
   headerLabel: (colId: any) => any;
-  headerWidth: (colId: any) => string;
+  headerWidth: (header: any) => string;
   onResizeStart: (colId: any, evt: any) => void;
   findHeader: (colId: any) => any;
   columnIsResizing: (colId: any) => boolean;
@@ -438,7 +475,7 @@ declare class DataTable extends DataTable_base {
   columnPinSide: (colId: any) => any;
   onPinColumn: (colId: any, side: any, evt: any) => void;
   pinStyle: (colId: any, zIndex?: number) => string;
-  thStyle: (colId: any) => string;
+  thStyle: (header: any) => string;
   onGlobalFilterInput: (evt: any) => void;
   onColumnFilterInput: (colId: any, evt: any) => void;
   globalFilterValue: () => any;
@@ -604,6 +641,12 @@ declare class DataTable extends DataTable_base {
     dy: number;
   };
   teardownFillDrag: () => void;
+  FILL_HITTEST_PROBE_RADIUS_PX: number;
+  FILL_HITTEST_PROBE_STEP_PX: number;
+  resolveCellAt: (clientX: any, clientY: any) => {
+    r: number;
+    c: number;
+  };
   cellIndexFromPoint: (clientX: any, clientY: any) => {
     r: number;
     c: number;
@@ -627,7 +670,8 @@ declare class DataTable extends DataTable_base {
   editingCellValue: () => any;
   editingRowOriginal: () => any;
   editingRowId: () => any;
-  focusEditorWhenReady: (selectAll?: boolean) => void;
+  resolveEditFocusCellEl: (rowIndex: any, colIndex: any) => any;
+  focusEditorWhenReady: (rowIndex: any, colIndex: any, selectAll?: boolean) => void;
   columnIdAt: (rowIndex: any, colIndex: any) => any;
   cellValueAt: (rowIndex: any, colIndex: any) => any;
   beginEdit: (rowIndex: any, colIndex: any, seed: any) => void;
@@ -738,7 +782,7 @@ declare class Column extends Column_base {
    */
   filterable: boolean;
   /**
-   * Pin side: `''` (unpinned) | `'left'` | `'right'`. Reserved metadata carried into the parent's column pinning state.
+   * Initial pin side: `''` (unpinned) | `'left'` | `'right'`. Applied once as the table's starting `columnPinning` state, so `getIsPinned()` reports it and the column joins the matching sticky rail — which also reorders it, since visible cells are ordered `[left-pinned, center, right-pinned]`. Ignored if the consumer has already pinned something; an interactive unpin is never re-applied.
    */
   pinned: string;
   /**
@@ -762,7 +806,7 @@ declare class Column extends Column_base {
    */
   editable: boolean;
   /**
-   * Built-in editor type for this column: `'text'` | `'number'` | `'select'` | `'checkbox'`. Ignored when a custom `#editor` scoped slot handles the column. Default `'text'`.
+   * Editor type for this column: `'text'` | `'number'` | `'select'` | `'checkbox'` (built-in inputs), or `'custom'` to hand rendering to the `#editor` scoped slot (or a per-column `editor-<columnId>` fill). Default `'text'`. **`'custom'` is the gate:** a column left on a built-in type ignores any `#editor` fill and renders the built-in input. Requires `editable: true` — and, for any pointer or keyboard edit entry, `interactionMode="grid"` on the table.
    */
   editor: string;
   /**

package/dist/index.d.mts

@@ -6,14 +6,14 @@ declare class DataTable extends DataTable_base {
   static shadowRootOptions: ShadowRootInit;
   static styles: _$lit.CSSResult;
   /**
-   * The row data — `model: true`, so a committed cell/row edit writes a **fresh** array back through `r-model:data` (uncontrolled fallback `dataDefault`). A stable reference per Rozie's setup-once model — fed directly into table-core (never map/cloned in the watcher).
+   * The row data — `model: true`, so a committed cell/row edit writes a **fresh** array back through the two-way `data` binding (uncontrolled fallback `dataDefault`). A stable reference per Rozie's setup-once model — fed directly into table-core (never map/cloned in the watcher).
    * @example
    * <rozie-data-table .data=${rows} @data-change=${…} .columns=${cols}></rozie-data-table>
    */
   _data_attr: any[];
   private _dataControllable;
   /**
-   * Config-array column fallback (lower precedence than `<Column>` children). Each entry: `{ id?, field, header?, sortable?, filterable?, pinned?, width? }`. Columns may come from this array, from `<Column>` children, or both (id-keyed last-write-wins union).
+   * Config-array column fallback (lower precedence than `<Column>` children). Each entry: `{ id?, field, header?, sortable?, filterable?, pinned?, width? }`. Columns may come from this array, from `<Column>` children, or both (id-keyed last-write-wins union). A `pinned` value of `'left'` or `'right'` is applied once as the table's initial `columnPinning` state — identical to `<Column pinned>` — which also REORDERS that column, since table-core orders visible cells `[left-pinned, center, right-pinned]`. A consumer who has already expressed a pin (an initial two-way `columnPinning` model value or an interactive pin) owns the slice and this declaration is ignored.
    */
   columns: any[];
   /**
@@ -53,7 +53,7 @@ declare class DataTable extends DataTable_base {
    */
   pageCount: number | null;
   /**
-   * Opt-in **expandable rows**. When `true`, a leading chevron expander column auto-injects (after the select column) and `getExpandedRowModel` activates; default `false` is byte-identical-off. Every row can expand to reveal a `#detail` panel unless `getSubRows` is supplied (then only rows with children expand). Bind `:expandable="true"` (a bare attr only coerces on Vue+Lit).
+   * Opt-in **expandable rows**. When `true`, a leading chevron expander column auto-injects (after the select column) and `getExpandedRowModel` activates; default `false` is byte-identical-off. Every row can expand to reveal a `#detail` panel unless `getSubRows` is supplied (then only rows with children expand). Pass `expandable` as a real boolean — a valueless attribute only coerces to `true` on Vue and Lit.
    */
   expandable: boolean;
   /**
@@ -70,7 +70,7 @@ declare class DataTable extends DataTable_base {
    */
   groupable: boolean;
   /**
-   * `GroupingState` — an ordered `string[]` of column ids (multi-column → nested groups, e.g. `['region','category']`). An empty/unbound list is ungrouped (byte-identical-off). Group-header rows are collapsible (they ride the expand model). Surfaces through `group-change`; uncontrolled fallback (`$data.groupingDefault`, default `[]`) when unbound — the default is `null` (mirroring `expanded`) so the uncontrolled fallback is reachable and the grouping auto-expand default can activate when a consumer applies grouping without binding `r-model:grouping` (a non-null `[]` default would short-circuit it). All reads are null-guarded, so table-core still receives an array.
+   * `GroupingState` — an ordered `string[]` of column ids (multi-column → nested groups, e.g. `['region','category']`). An empty/unbound list is ungrouped (byte-identical-off). Group-header rows are collapsible (they ride the expand model). Surfaces through `group-change`; uncontrolled fallback (`$data.groupingDefault`, default `[]`) when unbound — the default is `null` (mirroring `expanded`) so the uncontrolled fallback is reachable and the grouping auto-expand default can activate when a consumer applies grouping without binding the two-way `grouping` model (a non-null `[]` default would short-circuit it). All reads are null-guarded, so table-core still receives an array.
    */
   _grouping_attr: any[] | null;
   private _groupingControllable;
@@ -104,7 +104,7 @@ declare class DataTable extends DataTable_base {
    */
   stickyHeader: boolean;
   /**
-   * `'table'` (default, row-oriented, byte-behaviorally identical to a plain accessible table) | `'grid'` (GA since Phase 63) — lights up the full WAI-ARIA **[grid interaction mode](/components/data-table-grid-mode)**: `role="grid"`, a roving single tab-stop, 2-D APG arrow-key cell navigation, range selection, and clipboard support.
+   * `'table'` (default, row-oriented, byte-behaviorally identical to a plain accessible table) | `'grid'` — lights up the full WAI-ARIA **[grid interaction mode](/components/data-table-grid-mode)**: `role="grid"`, a roving single tab-stop, 2-D APG arrow-key cell navigation, range selection, and clipboard support.
    */
   interactionMode: string;
   /**
@@ -192,6 +192,26 @@ declare class DataTable extends DataTable_base {
     indeterminate: any;
     toggle: any;
   }) => unknown;
+  private _hasSlotDynamicColHeader;
+  private _slotDynamicColHeaderElements;
+  private _hasSlotDynamicFilter;
+  private _slotDynamicFilterElements;
+  private _hasSlotSelectCell;
+  private _slotSelectCellElements;
+  selectCell?: (scope: {
+    row: any;
+    checked: any;
+    toggle: any;
+  }) => unknown;
+  private _hasSlotDynamicCell;
+  private _slotDynamicCellElements;
+  private _hasSlotDynamicEditor;
+  private _slotDynamicEditorElements;
+  private _hasSlotDetail;
+  private _slotDetailElements;
+  detail?: (scope: {
+    row: any;
+  }) => unknown;
   private _hasSlotColHeader;
   private _slotColHeaderElements;
   colHeader?: (scope: {
@@ -208,13 +228,6 @@ declare class DataTable extends DataTable_base {
     minMax: any;
     setFilter: any;
   }) => unknown;
-  private _hasSlotSelectCell;
-  private _slotSelectCellElements;
-  selectCell?: (scope: {
-    row: any;
-    checked: any;
-    toggle: any;
-  }) => unknown;
   private _hasSlotCell;
   private _slotCellElements;
   cell?: (scope: {
@@ -234,12 +247,35 @@ declare class DataTable extends DataTable_base {
     cancel: any;
     autofocus: any;
   }) => unknown;
-  private _hasSlotDetail;
-  private _slotDetailElements;
-  detail?: (scope: {
-    row: any;
-  }) => unknown;
-  rozieSlots?: Record<string, (scope: any) => unknown>;
+  rozieSlots?: {
+    [key: `colHeader-${string}`]: (scope: {
+      columnId: any;
+      column: any;
+      label: any;
+    }) => unknown;
+    [key: `filter-${string}`]: (scope: {
+      columnId: any;
+      value: any;
+      uniqueValues: any;
+      minMax: any;
+      setFilter: any;
+    }) => unknown;
+    [key: `cell-${string}`]: (scope: {
+      columnId: any;
+      column: any;
+      row: any;
+      value: any;
+    }) => unknown;
+    [key: `editor-${string}`]: (scope: {
+      columnId: any;
+      column: any;
+      row: any;
+      value: any;
+      commit: any;
+      cancel: any;
+      autofocus: any;
+    }) => unknown;
+  } & Record<string, (scope: any) => unknown>;
   private _disconnectCleanups;
   private _rozieTornDown;
   private _armListeners;
@@ -269,6 +305,8 @@ declare class DataTable extends DataTable_base {
   expandedTouched: boolean;
   groupingActiveDefault: () => boolean;
   effectiveColumnPinning: () => any;
+  pinSeedApplied: boolean;
+  seedColumnPinning: () => void;
   currentState: () => any;
   currentData: () => any;
   buildConfigDef: (c: any) => {
@@ -349,6 +387,7 @@ declare class DataTable extends DataTable_base {
   onColumnSizingChangeCb: (updater: any) => void;
   onColumnOrderChangeCb: (updater: any) => void;
   onColumnPinningChangeCb: (updater: any) => void;
+  columnSizingInfoSync: any;
   onColumnSizingInfoChangeCb: (updater: any) => void;
   resolveVirtual: () => "rows" | "columns" | "both" | "off";
   rowsWindowed: () => boolean;
@@ -424,11 +463,9 @@ declare class DataTable extends DataTable_base {
   columnEditable: (colId: any) => boolean;
   editorTypeOf: (colId: any) => any;
   editorOptionsOf: (colId: any) => any;
-  hasEditorSlot: (colId: any) => boolean;
-  hasFilterSlot: () => boolean;
   columnIsFilterable: (colId: any) => boolean;
   headerLabel: (colId: any) => any;
-  headerWidth: (colId: any) => string;
+  headerWidth: (header: any) => string;
   onResizeStart: (colId: any, evt: any) => void;
   findHeader: (colId: any) => any;
   columnIsResizing: (colId: any) => boolean;
@@ -438,7 +475,7 @@ declare class DataTable extends DataTable_base {
   columnPinSide: (colId: any) => any;
   onPinColumn: (colId: any, side: any, evt: any) => void;
   pinStyle: (colId: any, zIndex?: number) => string;
-  thStyle: (colId: any) => string;
+  thStyle: (header: any) => string;
   onGlobalFilterInput: (evt: any) => void;
   onColumnFilterInput: (colId: any, evt: any) => void;
   globalFilterValue: () => any;
@@ -604,6 +641,12 @@ declare class DataTable extends DataTable_base {
     dy: number;
   };
   teardownFillDrag: () => void;
+  FILL_HITTEST_PROBE_RADIUS_PX: number;
+  FILL_HITTEST_PROBE_STEP_PX: number;
+  resolveCellAt: (clientX: any, clientY: any) => {
+    r: number;
+    c: number;
+  };
   cellIndexFromPoint: (clientX: any, clientY: any) => {
     r: number;
     c: number;
@@ -627,7 +670,8 @@ declare class DataTable extends DataTable_base {
   editingCellValue: () => any;
   editingRowOriginal: () => any;
   editingRowId: () => any;
-  focusEditorWhenReady: (selectAll?: boolean) => void;
+  resolveEditFocusCellEl: (rowIndex: any, colIndex: any) => any;
+  focusEditorWhenReady: (rowIndex: any, colIndex: any, selectAll?: boolean) => void;
   columnIdAt: (rowIndex: any, colIndex: any) => any;
   cellValueAt: (rowIndex: any, colIndex: any) => any;
   beginEdit: (rowIndex: any, colIndex: any, seed: any) => void;
@@ -738,7 +782,7 @@ declare class Column extends Column_base {
    */
   filterable: boolean;
   /**
-   * Pin side: `''` (unpinned) | `'left'` | `'right'`. Reserved metadata carried into the parent's column pinning state.
+   * Initial pin side: `''` (unpinned) | `'left'` | `'right'`. Applied once as the table's starting `columnPinning` state, so `getIsPinned()` reports it and the column joins the matching sticky rail — which also reorders it, since visible cells are ordered `[left-pinned, center, right-pinned]`. Ignored if the consumer has already pinned something; an interactive unpin is never re-applied.
    */
   pinned: string;
   /**
@@ -762,7 +806,7 @@ declare class Column extends Column_base {
    */
   editable: boolean;
   /**
-   * Built-in editor type for this column: `'text'` | `'number'` | `'select'` | `'checkbox'`. Ignored when a custom `#editor` scoped slot handles the column. Default `'text'`.
+   * Editor type for this column: `'text'` | `'number'` | `'select'` | `'checkbox'` (built-in inputs), or `'custom'` to hand rendering to the `#editor` scoped slot (or a per-column `editor-<columnId>` fill). Default `'text'`. **`'custom'` is the gate:** a column left on a built-in type ignores any `#editor` fill and renders the built-in input. Requires `editable: true` — and, for any pointer or keyboard edit entry, `interactionMode="grid"` on the table.
    */
   editor: string;
   /**