@rozie-ui/data-table-lit 0.7.3 → 0.8.0

package/dist/index.d.cts

@@ -2,6 +2,24 @@ import * as _$lit from "lit";
 import { LitElement } from "lit";
 import { Column as Column$1, ColumnDef, ColumnFiltersState, ColumnOrderState, ColumnPinningState, ColumnSizingState, ExpandedState, GroupingState, PaginationState, RowSelectionState, SortingState, VisibilityState } from "@tanstack/table-core";
 
+//#region src/helpers/heldView.d.ts
+interface ViewState {
+  held: boolean;
+  filterMismatches: number;
+  sortMismatches: number;
+}
+interface HoldController {
+  setActive(active: boolean): void;
+  isActive(): boolean;
+  isHolding(): boolean;
+  capture(table: any): void;
+  release(): void;
+  noteWrite(prev: readonly unknown[], next: readonly unknown[]): void;
+  wrapFiltered(base: (table: any) => () => any): (table: any) => () => any;
+  wrapSorted(base: (table: any) => () => any): (table: any) => () => any;
+  viewState(table: any): ViewState;
+}
+//#endregion
 //#region src/DataTable.d.ts
 /** A cell position as integers over the visible (display-order) model. */
 interface DataTableCellPosition {
@@ -58,6 +76,12 @@ interface DataTableHistoryChangePayload {
   canUndo: boolean;
   canRedo: boolean;
 }
+/** The held-view state (`holdView`): whether the view is held right now, and how many rows the held view disagrees with. */
+interface DataTableViewState {
+  held: boolean;
+  filterMismatches: number;
+  sortMismatches: number;
+}
 /** The `range-change` payload: the new range corners (both `null` when the range cleared). */
 type DataTableRangeChangePayload = DataTableRange;
 /** The `row-activate` payload. `row` is the original data object and `index` its position in the rendered model. */
@@ -71,7 +95,7 @@ interface DataTableVisibleRangeChangePayload {
   start: number;
   end: number;
 }
-interface RozieDataTableEventMap extends Omit<HTMLElementEventMap, 'activecell-change' | 'cell-edit-commit' | 'expand-change' | 'filter-change' | 'group-change' | 'history-change' | 'page-change' | 'pin-change' | 'range-change' | 'reorder-change' | 'resize-change' | 'row-activate' | 'row-edit-commit' | 'selection-change' | 'sort-change' | 'visibility-change' | 'visible-range-change' | 'data-change' | 'sorting-change' | 'global-filter-change' | 'column-filters-change' | 'pagination-change' | 'expanded-change' | 'grouping-change' | 'row-selection-change' | 'column-visibility-change' | 'column-sizing-change' | 'column-order-change' | 'column-pinning-change'> {
+interface RozieDataTableEventMap extends Omit<HTMLElementEventMap, 'activecell-change' | 'cell-edit-commit' | 'expand-change' | 'filter-change' | 'group-change' | 'history-change' | 'page-change' | 'pin-change' | 'range-change' | 'reorder-change' | 'resize-change' | 'row-activate' | 'row-edit-commit' | 'selection-change' | 'sort-change' | 'visibility-change' | 'view-state-change' | 'visible-range-change' | 'data-change' | 'sorting-change' | 'global-filter-change' | 'column-filters-change' | 'pagination-change' | 'expanded-change' | 'grouping-change' | 'row-selection-change' | 'column-visibility-change' | 'column-sizing-change' | 'column-order-change' | 'column-pinning-change'> {
   'activecell-change': CustomEvent<DataTableActiveCellChangePayload>;
   'cell-edit-commit': CustomEvent<DataTableCellEditCommitPayload>;
   'expand-change': CustomEvent<ExpandedState>;
@@ -88,6 +112,7 @@ interface RozieDataTableEventMap extends Omit<HTMLElementEventMap, 'activecell-c
   'selection-change': CustomEvent<RowSelectionState>;
   'sort-change': CustomEvent<SortingState>;
   'visibility-change': CustomEvent<VisibilityState>;
+  'view-state-change': CustomEvent<DataTableViewState>;
   'visible-range-change': CustomEvent<DataTableVisibleRangeChangePayload>;
   'data-change': CustomEvent<any[]>;
   'sorting-change': CustomEvent<any[]>;
@@ -114,7 +139,7 @@ declare class DataTable extends DataTable_base {
   _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). 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.
+   * Config-array column fallback (lower precedence than `<Column>` children). Each entry: `{ id?, field, header?, sortable?, filterable?, filterFn?, sortingFn?, pinned?, width? }` (`filterFn`/`sortingFn` take a table-core built-in name or a custom function). 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[];
   /**
@@ -224,6 +249,10 @@ declare class DataTable extends DataTable_base {
    * The maximum number of undo steps retained (oldest evicted past this depth). Only consulted when `undoable` is `true`.
    */
   undoLimit: number;
+  /**
+   * When `true`, the table holds its current view through its own writes (edit, paste, fill, cut, clear, the boolean toggle, undo and redo): rows keep the membership and order they had before the write and new values render in place, so an edited row does not jump or vanish under an active sort or filter. The view is re-derived (and both mismatch counts reset to 0) when `sorting`, `columnFilters` or `globalFilter` change, when `refreshView()` is called, when the dataset is swapped externally, or when `holdView` is toggled. Paging, page size, column visibility/order/pinning/sizing and expanding rows move through the held rows; a table write or `refreshView()` never changes the page (a sort, filter or grouping change returns to the first page). Falls back to live behaviour (with one console warning) while grouping is active, in `manual` mode, or with tree data (`getSubRows`). Passing a fresh `data` array that did not come from the table (for example reloading from the server after a save) is an external swap: it re-derives the view and clears undo history. Track mismatches with `view-state-change` / `getViewState()`.
+   */
+  holdView: boolean;
   /**
    * Opt-in windowing grammar: `false` (default, off — byte-identical to a non-virtual table) | `true` or `'rows'` (vertical row windowing; `true` is byte-behavior-identical to every existing consumer, zero churn) | `'columns'` (horizontal column windowing) | `'both'` (both axes windowed). Row windowing renders only the visible slice of rows inside a bounded `rdt-scroll` container (with leading/trailing spacer rows preserving total scroll height), windowing over the full filtered + sorted (pre-pagination) model and suppressing the client pagination chrome. Column windowing renders only the visible slice of leaf columns inside the same `rdt-scroll` container. An unrecognised string behaves as `false`.
    */
@@ -426,6 +455,24 @@ declare class DataTable extends DataTable_base {
   undoStack: unknown[];
   redoStack: unknown[];
   restoringHistory: boolean;
+  holdCtrl: HoldController;
+  heldFilteredRowModel: (table: any) => () => any;
+  heldSortedRowModel: (table: any) => () => any;
+  pendingViewChange: boolean;
+  pendingWrite: boolean;
+  prevRowIds: string[] | null;
+  lastFedData: unknown;
+  lastViewState: ViewState;
+  lastHoldSorting: unknown;
+  lastHoldColumnFilters: unknown;
+  lastHoldGlobalFilter: unknown;
+  holdFallbackWarned: boolean;
+  lastPageGrouping: unknown;
+  lastColumnSig: string;
+  columnSetSignature: (defs: any) => string;
+  lastPropsData: unknown;
+  isExternalSwap: () => boolean;
+  syncHoldActive: (st: any) => void;
   expandedTouched: boolean;
   groupingActiveDefault: () => boolean;
   effectiveColumnPinning: () => any;
@@ -464,6 +511,10 @@ declare class DataTable extends DataTable_base {
       validate: any;
     };
     size?: number;
+    pinned: any;
+    width: any;
+    filterFn?: string | Function;
+    sortingFn?: string | Function;
     id: string;
     accessorKey: any;
     header: any;
@@ -473,8 +524,6 @@ declare class DataTable extends DataTable_base {
     expandable: boolean;
     groupable: boolean;
     aggregationFn: string | ((columnId: any, leafRows: any, childRows: any) => any);
-    pinned: any;
-    width: any;
     columns?: undefined;
   };
   columnDefsCache: any[] | null;
@@ -601,8 +650,8 @@ declare class DataTable extends DataTable_base {
   buildSortFilterAnnounce: () => string;
   rowIdOption: () => (originalRow: any, index: any, parent: any) => string;
   rowSelectionOption: () => boolean | ((row: any) => boolean);
+  writePaginationSoon: (next: any) => void;
   reFeed: () => void;
-  lastPropsData: unknown;
   maybeClearHistoryOnExternalSwap: () => void;
   lastData: any;
   lastDataLen: number;
@@ -684,6 +733,8 @@ declare class DataTable extends DataTable_base {
   pinColumn: (colId: string, side: 'left' | 'right' | false) => void;
   getRowIndexRelativeToPage: (absRow?: number) => number;
   cut: () => void;
+  refreshView: () => void;
+  getViewState: () => DataTableViewState;
   isGrid: () => boolean;
   tableRole: () => "grid" | "table";
   cellRole: () => "gridcell" | "cell";
@@ -742,13 +793,18 @@ declare class DataTable extends DataTable_base {
   onGridClick: (e: any) => void;
   onGridFocusOut: (e: any) => void;
   recoverGridFocus: (rowKey: any, col: any, level: any, guardMoved?: boolean) => void;
-  clampActiveCell: (rowCount: any, colCount: any) => void;
+  followOpenEditors: (prevIds: any, nextIds: any) => boolean;
+  rowIdInModel: (index: any) => any;
+  modelIndexOfRowId: (id: any) => number;
+  followActiveCell: (prevIds: any, nextIds: any, viewChangeOrWrite: any, rowCount: any, colCount: any, editFollowPending?: boolean) => void;
+  clampActiveCell: (rowCount: any, colCount: any, follow?: any, editFollowPending?: boolean, focusEmptyPark?: boolean) => void;
   windowedHeadersFor: (hg: any, hgLevel: any) => any;
   windowedColSpan: () => any;
   lastColSizeSig: number;
   remeasureColumnSizes: () => void;
   remeasureColumnWindow: () => void;
   gridEmptyFallback: boolean;
+  activeCellEngaged: boolean;
   rangeTransition: boolean;
   rangeClickPending: any;
   rangeActive: boolean;
@@ -902,8 +958,8 @@ declare class DataTable extends DataTable_base {
   set pagination(v: any);
   get expanded(): any | boolean;
   set expanded(v: any | boolean);
-  get grouping(): any[];
-  set grouping(v: any[]);
+  get grouping(): any[] | null;
+  set grouping(v: any[] | null);
   get rowSelection(): any;
   set rowSelection(v: any);
   get columnVisibility(): any;
@@ -966,6 +1022,14 @@ declare class Column extends Column_base {
    * The table-core aggregation for this column inside a group-header cell. Either a built-in name string — `'sum'` | `'min'` | `'max'` | `'extent'` | `'mean'` | `'median'` | `'unique'` | `'uniqueCount'` | `'count'` — or a custom function `(columnId, leafRows, childRows) => any` (defensively wrapped by the parent so a throw cannot crash grouping). Null → no aggregation (the group-header cell renders as a placeholder).
    */
   aggregationFn: string | (((...args: any[]) => any) | null);
+  /**
+   * The table-core filter rule for this column. Either a built-in name string (e.g. `'arrIncludesSome'`, `'equalsString'`) or a custom function `(value, filterValue, row) => boolean`, where `row` is the original data object. Null → table-core's auto rule for the column's value type.
+   */
+  filterFn: string | (((...args: any[]) => any) | null);
+  /**
+   * The table-core sort rule for this column. Either a built-in name string (e.g. `'alphanumeric'`, `'basic'`) or a custom ascending comparator `(a, b, rowA, rowB) => number` over the cell values, with the original data objects as `rowA` / `rowB`. Null → table-core's auto rule for the column's value type.
+   */
+  sortingFn: string | (((...args: any[]) => any) | null);
   /**
    * Whether this column's cells are editable (opt-in). Default `false` → the column is read-only and the display↔editor branch never mounts an editor. Bind `:editable="true"` (a bare attr only coerces on Vue+Lit).
    */
@@ -993,6 +1057,10 @@ declare class Column extends Column_base {
   render(): _$lit.TemplateResult<1>;
   reg: any;
   registered: boolean;
+  latestFilterFn: any;
+  latestSortingFn: any;
+  filterTrampoline: any;
+  sortingTrampoline: (...args: any[]) => any;
   colId: () => string;
   buildSpec: () => {
     id: string;
@@ -1005,6 +1073,8 @@ declare class Column extends Column_base {
     expandable: boolean;
     groupable: boolean;
     aggregationFn: string | ((...args: any[]) => any);
+    filterFn: any;
+    sortingFn: string | ((...args: any[]) => any);
     editable: boolean;
     editor: string;
     editorOptions: any[];
@@ -1478,4 +1548,4 @@ declare class DetailPanel extends DetailPanel_base {
   }[];
 }
 //#endregion
-export { Column, DataTable, DataTable as default, DataTableActiveCell, DataTableActiveCellChangePayload, DataTableCellChange, DataTableCellEditCommitPayload, DataTableCellPosition, DataTableFilterChangePayload, DataTableGroupableColumn, DataTableHistoryChangePayload, DataTableRange, DataTableRangeChangePayload, DataTableRowActivatePayload, DataTableRowEditCommitPayload, DataTableVisibleRangeChangePayload, DetailPanel, EditorCheckbox, EditorDate, EditorNumber, EditorSelect, EditorText, FilterNumberRange, FilterSelect, FilterText, GroupBar, type RozieDataTableEventMap };
+export { Column, DataTable, DataTable as default, DataTableActiveCell, DataTableActiveCellChangePayload, DataTableCellChange, DataTableCellEditCommitPayload, DataTableCellPosition, DataTableFilterChangePayload, DataTableGroupableColumn, DataTableHistoryChangePayload, DataTableRange, DataTableRangeChangePayload, DataTableRowActivatePayload, DataTableRowEditCommitPayload, DataTableViewState, DataTableVisibleRangeChangePayload, DetailPanel, EditorCheckbox, EditorDate, EditorNumber, EditorSelect, EditorText, FilterNumberRange, FilterSelect, FilterText, GroupBar, type RozieDataTableEventMap };

package/dist/index.d.mts

@@ -2,6 +2,24 @@ import * as _$lit from "lit";
 import { LitElement } from "lit";
 import { Column as Column$1, ColumnDef, ColumnFiltersState, ColumnOrderState, ColumnPinningState, ColumnSizingState, ExpandedState, GroupingState, PaginationState, RowSelectionState, SortingState, VisibilityState } from "@tanstack/table-core";
 
+//#region src/helpers/heldView.d.ts
+interface ViewState {
+  held: boolean;
+  filterMismatches: number;
+  sortMismatches: number;
+}
+interface HoldController {
+  setActive(active: boolean): void;
+  isActive(): boolean;
+  isHolding(): boolean;
+  capture(table: any): void;
+  release(): void;
+  noteWrite(prev: readonly unknown[], next: readonly unknown[]): void;
+  wrapFiltered(base: (table: any) => () => any): (table: any) => () => any;
+  wrapSorted(base: (table: any) => () => any): (table: any) => () => any;
+  viewState(table: any): ViewState;
+}
+//#endregion
 //#region src/DataTable.d.ts
 /** A cell position as integers over the visible (display-order) model. */
 interface DataTableCellPosition {
@@ -58,6 +76,12 @@ interface DataTableHistoryChangePayload {
   canUndo: boolean;
   canRedo: boolean;
 }
+/** The held-view state (`holdView`): whether the view is held right now, and how many rows the held view disagrees with. */
+interface DataTableViewState {
+  held: boolean;
+  filterMismatches: number;
+  sortMismatches: number;
+}
 /** The `range-change` payload: the new range corners (both `null` when the range cleared). */
 type DataTableRangeChangePayload = DataTableRange;
 /** The `row-activate` payload. `row` is the original data object and `index` its position in the rendered model. */
@@ -71,7 +95,7 @@ interface DataTableVisibleRangeChangePayload {
   start: number;
   end: number;
 }
-interface RozieDataTableEventMap extends Omit<HTMLElementEventMap, 'activecell-change' | 'cell-edit-commit' | 'expand-change' | 'filter-change' | 'group-change' | 'history-change' | 'page-change' | 'pin-change' | 'range-change' | 'reorder-change' | 'resize-change' | 'row-activate' | 'row-edit-commit' | 'selection-change' | 'sort-change' | 'visibility-change' | 'visible-range-change' | 'data-change' | 'sorting-change' | 'global-filter-change' | 'column-filters-change' | 'pagination-change' | 'expanded-change' | 'grouping-change' | 'row-selection-change' | 'column-visibility-change' | 'column-sizing-change' | 'column-order-change' | 'column-pinning-change'> {
+interface RozieDataTableEventMap extends Omit<HTMLElementEventMap, 'activecell-change' | 'cell-edit-commit' | 'expand-change' | 'filter-change' | 'group-change' | 'history-change' | 'page-change' | 'pin-change' | 'range-change' | 'reorder-change' | 'resize-change' | 'row-activate' | 'row-edit-commit' | 'selection-change' | 'sort-change' | 'visibility-change' | 'view-state-change' | 'visible-range-change' | 'data-change' | 'sorting-change' | 'global-filter-change' | 'column-filters-change' | 'pagination-change' | 'expanded-change' | 'grouping-change' | 'row-selection-change' | 'column-visibility-change' | 'column-sizing-change' | 'column-order-change' | 'column-pinning-change'> {
   'activecell-change': CustomEvent<DataTableActiveCellChangePayload>;
   'cell-edit-commit': CustomEvent<DataTableCellEditCommitPayload>;
   'expand-change': CustomEvent<ExpandedState>;
@@ -88,6 +112,7 @@ interface RozieDataTableEventMap extends Omit<HTMLElementEventMap, 'activecell-c
   'selection-change': CustomEvent<RowSelectionState>;
   'sort-change': CustomEvent<SortingState>;
   'visibility-change': CustomEvent<VisibilityState>;
+  'view-state-change': CustomEvent<DataTableViewState>;
   'visible-range-change': CustomEvent<DataTableVisibleRangeChangePayload>;
   'data-change': CustomEvent<any[]>;
   'sorting-change': CustomEvent<any[]>;
@@ -114,7 +139,7 @@ declare class DataTable extends DataTable_base {
   _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). 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.
+   * Config-array column fallback (lower precedence than `<Column>` children). Each entry: `{ id?, field, header?, sortable?, filterable?, filterFn?, sortingFn?, pinned?, width? }` (`filterFn`/`sortingFn` take a table-core built-in name or a custom function). 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[];
   /**
@@ -224,6 +249,10 @@ declare class DataTable extends DataTable_base {
    * The maximum number of undo steps retained (oldest evicted past this depth). Only consulted when `undoable` is `true`.
    */
   undoLimit: number;
+  /**
+   * When `true`, the table holds its current view through its own writes (edit, paste, fill, cut, clear, the boolean toggle, undo and redo): rows keep the membership and order they had before the write and new values render in place, so an edited row does not jump or vanish under an active sort or filter. The view is re-derived (and both mismatch counts reset to 0) when `sorting`, `columnFilters` or `globalFilter` change, when `refreshView()` is called, when the dataset is swapped externally, or when `holdView` is toggled. Paging, page size, column visibility/order/pinning/sizing and expanding rows move through the held rows; a table write or `refreshView()` never changes the page (a sort, filter or grouping change returns to the first page). Falls back to live behaviour (with one console warning) while grouping is active, in `manual` mode, or with tree data (`getSubRows`). Passing a fresh `data` array that did not come from the table (for example reloading from the server after a save) is an external swap: it re-derives the view and clears undo history. Track mismatches with `view-state-change` / `getViewState()`.
+   */
+  holdView: boolean;
   /**
    * Opt-in windowing grammar: `false` (default, off — byte-identical to a non-virtual table) | `true` or `'rows'` (vertical row windowing; `true` is byte-behavior-identical to every existing consumer, zero churn) | `'columns'` (horizontal column windowing) | `'both'` (both axes windowed). Row windowing renders only the visible slice of rows inside a bounded `rdt-scroll` container (with leading/trailing spacer rows preserving total scroll height), windowing over the full filtered + sorted (pre-pagination) model and suppressing the client pagination chrome. Column windowing renders only the visible slice of leaf columns inside the same `rdt-scroll` container. An unrecognised string behaves as `false`.
    */
@@ -426,6 +455,24 @@ declare class DataTable extends DataTable_base {
   undoStack: unknown[];
   redoStack: unknown[];
   restoringHistory: boolean;
+  holdCtrl: HoldController;
+  heldFilteredRowModel: (table: any) => () => any;
+  heldSortedRowModel: (table: any) => () => any;
+  pendingViewChange: boolean;
+  pendingWrite: boolean;
+  prevRowIds: string[] | null;
+  lastFedData: unknown;
+  lastViewState: ViewState;
+  lastHoldSorting: unknown;
+  lastHoldColumnFilters: unknown;
+  lastHoldGlobalFilter: unknown;
+  holdFallbackWarned: boolean;
+  lastPageGrouping: unknown;
+  lastColumnSig: string;
+  columnSetSignature: (defs: any) => string;
+  lastPropsData: unknown;
+  isExternalSwap: () => boolean;
+  syncHoldActive: (st: any) => void;
   expandedTouched: boolean;
   groupingActiveDefault: () => boolean;
   effectiveColumnPinning: () => any;
@@ -464,6 +511,10 @@ declare class DataTable extends DataTable_base {
       validate: any;
     };
     size?: number;
+    pinned: any;
+    width: any;
+    filterFn?: string | Function;
+    sortingFn?: string | Function;
     id: string;
     accessorKey: any;
     header: any;
@@ -473,8 +524,6 @@ declare class DataTable extends DataTable_base {
     expandable: boolean;
     groupable: boolean;
     aggregationFn: string | ((columnId: any, leafRows: any, childRows: any) => any);
-    pinned: any;
-    width: any;
     columns?: undefined;
   };
   columnDefsCache: any[] | null;
@@ -601,8 +650,8 @@ declare class DataTable extends DataTable_base {
   buildSortFilterAnnounce: () => string;
   rowIdOption: () => (originalRow: any, index: any, parent: any) => string;
   rowSelectionOption: () => boolean | ((row: any) => boolean);
+  writePaginationSoon: (next: any) => void;
   reFeed: () => void;
-  lastPropsData: unknown;
   maybeClearHistoryOnExternalSwap: () => void;
   lastData: any;
   lastDataLen: number;
@@ -684,6 +733,8 @@ declare class DataTable extends DataTable_base {
   pinColumn: (colId: string, side: 'left' | 'right' | false) => void;
   getRowIndexRelativeToPage: (absRow?: number) => number;
   cut: () => void;
+  refreshView: () => void;
+  getViewState: () => DataTableViewState;
   isGrid: () => boolean;
   tableRole: () => "grid" | "table";
   cellRole: () => "gridcell" | "cell";
@@ -742,13 +793,18 @@ declare class DataTable extends DataTable_base {
   onGridClick: (e: any) => void;
   onGridFocusOut: (e: any) => void;
   recoverGridFocus: (rowKey: any, col: any, level: any, guardMoved?: boolean) => void;
-  clampActiveCell: (rowCount: any, colCount: any) => void;
+  followOpenEditors: (prevIds: any, nextIds: any) => boolean;
+  rowIdInModel: (index: any) => any;
+  modelIndexOfRowId: (id: any) => number;
+  followActiveCell: (prevIds: any, nextIds: any, viewChangeOrWrite: any, rowCount: any, colCount: any, editFollowPending?: boolean) => void;
+  clampActiveCell: (rowCount: any, colCount: any, follow?: any, editFollowPending?: boolean, focusEmptyPark?: boolean) => void;
   windowedHeadersFor: (hg: any, hgLevel: any) => any;
   windowedColSpan: () => any;
   lastColSizeSig: number;
   remeasureColumnSizes: () => void;
   remeasureColumnWindow: () => void;
   gridEmptyFallback: boolean;
+  activeCellEngaged: boolean;
   rangeTransition: boolean;
   rangeClickPending: any;
   rangeActive: boolean;
@@ -902,8 +958,8 @@ declare class DataTable extends DataTable_base {
   set pagination(v: any);
   get expanded(): any | boolean;
   set expanded(v: any | boolean);
-  get grouping(): any[];
-  set grouping(v: any[]);
+  get grouping(): any[] | null;
+  set grouping(v: any[] | null);
   get rowSelection(): any;
   set rowSelection(v: any);
   get columnVisibility(): any;
@@ -966,6 +1022,14 @@ declare class Column extends Column_base {
    * The table-core aggregation for this column inside a group-header cell. Either a built-in name string — `'sum'` | `'min'` | `'max'` | `'extent'` | `'mean'` | `'median'` | `'unique'` | `'uniqueCount'` | `'count'` — or a custom function `(columnId, leafRows, childRows) => any` (defensively wrapped by the parent so a throw cannot crash grouping). Null → no aggregation (the group-header cell renders as a placeholder).
    */
   aggregationFn: string | (((...args: any[]) => any) | null);
+  /**
+   * The table-core filter rule for this column. Either a built-in name string (e.g. `'arrIncludesSome'`, `'equalsString'`) or a custom function `(value, filterValue, row) => boolean`, where `row` is the original data object. Null → table-core's auto rule for the column's value type.
+   */
+  filterFn: string | (((...args: any[]) => any) | null);
+  /**
+   * The table-core sort rule for this column. Either a built-in name string (e.g. `'alphanumeric'`, `'basic'`) or a custom ascending comparator `(a, b, rowA, rowB) => number` over the cell values, with the original data objects as `rowA` / `rowB`. Null → table-core's auto rule for the column's value type.
+   */
+  sortingFn: string | (((...args: any[]) => any) | null);
   /**
    * Whether this column's cells are editable (opt-in). Default `false` → the column is read-only and the display↔editor branch never mounts an editor. Bind `:editable="true"` (a bare attr only coerces on Vue+Lit).
    */
@@ -993,6 +1057,10 @@ declare class Column extends Column_base {
   render(): _$lit.TemplateResult<1>;
   reg: any;
   registered: boolean;
+  latestFilterFn: any;
+  latestSortingFn: any;
+  filterTrampoline: any;
+  sortingTrampoline: (...args: any[]) => any;
   colId: () => string;
   buildSpec: () => {
     id: string;
@@ -1005,6 +1073,8 @@ declare class Column extends Column_base {
     expandable: boolean;
     groupable: boolean;
     aggregationFn: string | ((...args: any[]) => any);
+    filterFn: any;
+    sortingFn: string | ((...args: any[]) => any);
     editable: boolean;
     editor: string;
     editorOptions: any[];
@@ -1478,4 +1548,4 @@ declare class DetailPanel extends DetailPanel_base {
   }[];
 }
 //#endregion
-export { Column, DataTable, DataTable as default, DataTableActiveCell, DataTableActiveCellChangePayload, DataTableCellChange, DataTableCellEditCommitPayload, DataTableCellPosition, DataTableFilterChangePayload, DataTableGroupableColumn, DataTableHistoryChangePayload, DataTableRange, DataTableRangeChangePayload, DataTableRowActivatePayload, DataTableRowEditCommitPayload, DataTableVisibleRangeChangePayload, DetailPanel, EditorCheckbox, EditorDate, EditorNumber, EditorSelect, EditorText, FilterNumberRange, FilterSelect, FilterText, GroupBar, type RozieDataTableEventMap };
+export { Column, DataTable, DataTable as default, DataTableActiveCell, DataTableActiveCellChangePayload, DataTableCellChange, DataTableCellEditCommitPayload, DataTableCellPosition, DataTableFilterChangePayload, DataTableGroupableColumn, DataTableHistoryChangePayload, DataTableRange, DataTableRangeChangePayload, DataTableRowActivatePayload, DataTableRowEditCommitPayload, DataTableViewState, DataTableVisibleRangeChangePayload, DetailPanel, EditorCheckbox, EditorDate, EditorNumber, EditorSelect, EditorText, FilterNumberRange, FilterSelect, FilterText, GroupBar, type RozieDataTableEventMap };