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

package/dist/index.d.cts

@@ -120,13 +120,17 @@ declare class DataTable extends DataTable_base {
    */
   undoLimit: number;
   /**
-   * Opt-in vertical **row windowing**. When `true`, only the visible slice of rows renders 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. Default `false` is byte-identical to a non-virtual table.
+   * 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`.
    */
-  virtual: boolean;
+  virtual: boolean | string;
   /**
-   * Estimated row height (px) seeding the windowing engine before `measureElement` refines actual heights. Only consulted when `virtual` is on.
+   * Estimated row height (px) — the first-paint seed for the windowing engine before any row has been measured. Only consulted when rows are windowed. When `autoMeasure` is `true`, later renders progressively refine the estimate from measured content; when `autoMeasure` is `false` this remains the explicit override for every render.
    */
   estimateRowHeight: number;
+  /**
+   * Opt-in content-driven row-size estimation. When `true`, the windowing engine feeds `estimateSize()` a running mean of measured row heights instead of the fixed `estimateRowHeight` seed, so `getTotalSize()` converges to the true content total on a large table with variable-height rows. Falls back to `estimateRowHeight` before any row has been measured. Default `false` keeps the estimate fixed at `estimateRowHeight` for every render (today's behavior).
+   */
+  autoMeasure: boolean;
   /**
    * A CSS length string bounding the `rdt-scroll` container when `virtual` is on (e.g. `'400px'`). Mirrored to the `--rozie-data-table-max-height` custom property; the prop wins, the token is the fallback.
    */
@@ -249,7 +253,11 @@ declare class DataTable extends DataTable_base {
   virtualizer: any;
   virtualizerCleanup: any;
   gridScrollEl: any;
+  colVirtualizer: any;
+  colVirtualizerCleanup: any;
   remeasurePending: boolean;
+  remeasureRaf: any;
+  remeasureDisposed: boolean;
   GRID_PAGE_STEP: number;
   gridRoot: any;
   programmatic: number;
@@ -263,8 +271,6 @@ declare class DataTable extends DataTable_base {
   effectiveColumnPinning: () => any;
   currentState: () => any;
   currentData: () => any;
-  isSafeKey: (k: any) => boolean;
-  wrapAggregationFn: (fn: any) => string | ((columnId: any, leafRows: any, childRows: any) => any);
   buildConfigDef: (c: any) => {
     id: string;
     header: any;
@@ -299,13 +305,17 @@ declare class DataTable extends DataTable_base {
     };
     columns?: undefined;
   };
+  columnDefsCache: any[] | null;
+  columnDefsCacheColumnsRef: any;
+  columnDefsCacheColRegRef: any;
+  columnDefsIndexCache: any;
   columnDefs: () => any[];
+  defIndex: () => any;
   SELECT_COL_ID: string;
   EXPANDER_COL_ID: string;
   selectionEnabled: () => boolean;
   tableColumns: () => any[];
   writeSorting: (next: any) => void;
-  applyUpdater: (updater: any, current: any) => any;
   writeExpanded: (next: any) => void;
   writeGrouping: (next: any) => void;
   writeGlobalFilter: (next: any) => void;
@@ -340,12 +350,39 @@ declare class DataTable extends DataTable_base {
   onColumnOrderChangeCb: (updater: any) => void;
   onColumnPinningChangeCb: (updater: any) => void;
   onColumnSizingInfoChangeCb: (updater: any) => void;
+  resolveVirtual: () => "rows" | "columns" | "both" | "off";
+  rowsWindowed: () => boolean;
+  colsWindowed: () => boolean;
+  isWindowed: () => boolean;
+  autoMeasureOn: () => boolean;
+  columnCount: () => number;
+  columnSize: (i: number) => number;
+  forcedColumns: () => number[];
+  windowedCells: (row: any) => any;
   windowSource: () => any;
   scheduleRemeasure: () => void;
+  teardownRemeasure: () => void;
   pinnedEditIndex: () => any;
   pinnedMeasurement: (pin: any) => any;
   remeasureWindow: () => void;
   virtualItemKey: (i: any) => any;
+  COL_OVERSCAN: number;
+  colRtlObserver: any;
+  colRtlObserverEl: any;
+  isColRtl: () => boolean;
+  ensureColRtlWatch: () => void;
+  teardownColRtlWatch: () => void;
+  columnVirtualizerOptions: () => any;
+  measuredRowTotal: number;
+  measuredRowCount: number;
+  lastFedRowEstimate: number;
+  foldedRowHeights: Record<number, number>;
+  windowVerBumpPending: boolean;
+  bumpWindowVer: () => void;
+  ESTIMATE_REFEED_DELTA_PX: number;
+  estimateRowSize: (i: number) => number;
+  foldMeasuredRow: (index: number, height: number) => void;
+  refineRowEstimate: () => void;
   virtualizerOptions: () => any;
   pinMeasurement: (pin: number) => {
     start: number;
@@ -358,6 +395,11 @@ declare class DataTable extends DataTable_base {
   padBottom: () => number;
   pmIndexInWindow: (items: any, idx: any) => boolean;
   rowIsOutsideWindow: (r: any) => boolean;
+  windowedColIndices: () => any;
+  colPadLeft: () => any;
+  colPadRight: () => number;
+  colIsOutsideWindow: (c: any) => boolean;
+  afterRowRemeasure: () => void;
   announceState: {
     sorting: unknown;
     columnFilters: unknown;
@@ -416,11 +458,16 @@ declare class DataTable extends DataTable_base {
   onToggleExpand: (row: any, evt: any) => void;
   bodyCellStyle: (row: any, colId: any) => string;
   rowIsGrouped: (row: any) => boolean;
+  rowIndexIsGrouped: (rowIndex: any) => boolean;
   groupingActive: () => boolean;
   cellIsGrouped: (cellCtx: any) => boolean;
   cellIsAggregated: (cellCtx: any) => boolean;
   cellIsPlaceholder: (cellCtx: any) => boolean;
   groupSubRowCount: (row: any) => any;
+  groupRowDescriptorCache: any;
+  groupRowDescriptorCacheVer: any;
+  groupRowDescriptor: (row: any) => any;
+  cellSlotRow: (row: any) => any;
   groupingKeys: () => any;
   groupableColumns: () => any[];
   stopEvent: (evt: any) => void;
@@ -467,7 +514,6 @@ declare class DataTable extends DataTable_base {
   bodyAriaRowIndex: (row: any) => number;
   visibleColCount: () => any;
   bodyRowCount: () => number;
-  clamp: (v: any, lo: any, hi: any) => any;
   headerLeafLevel: () => number;
   headerCountAtLevel: (level: any) => any;
   headerAt: (level: any, colIndex: any) => any;
@@ -491,7 +537,6 @@ declare class DataTable extends DataTable_base {
     col: number;
   };
   currentCellEl: () => any;
-  focusables: (cellEl: any) => any[];
   enterControl: () => void;
   cycleWithinCell: (cellEl: any, forward: any) => void;
   onGridKeyDown: (e: any) => void;
@@ -502,6 +547,9 @@ declare class DataTable extends DataTable_base {
   onGridFocusOut: (e: any) => void;
   recoverGridFocus: (rowKey: any, col: any, level: any, guardMoved?: boolean) => void;
   clampActiveCell: (rowCount: any, colCount: any) => void;
+  windowedHeadersFor: (hg: any, hgLevel: any) => any;
+  windowedColSpan: () => any;
+  remeasureColumnWindow: () => void;
   gridEmptyFallback: boolean;
   rangeTransition: boolean;
   rangeClickPending: boolean;
@@ -533,9 +581,7 @@ declare class DataTable extends DataTable_base {
     c0: any;
     c1: any;
   };
-  escapeTsvField: (s: any) => any;
   rangeToTsv: () => string;
-  parseTsv: (text: any) => any[];
   copyRange: () => void;
   applyGridToRange: (grid: any, originRow: any, originCol: any) => {
     wrote: number;
@@ -543,15 +589,20 @@ declare class DataTable extends DataTable_base {
   };
   rowOriginalAt: (rowIndex: any) => any;
   rowIdAt: (rowIndex: any) => any;
-  tileGridToBox: (grid: any, box: any) => any;
   pasteRange: () => void;
   cutRange: () => void;
   clearActiveRange: () => void;
-  tileIndex: (i: any, lo: any, hi: any) => any;
   fillRange: (sourceBox: any, endCell: any) => void;
   fillDragging: boolean;
   fillDragMove: any;
   fillDragUp: any;
+  fillEdgeScrollRaf: any;
+  FILL_EDGE_SCROLL_PX: number;
+  FILL_EDGE_SCROLL_STEP: number;
+  edgeDelta: (clientX: any, clientY: any) => {
+    dx: number;
+    dy: number;
+  };
   teardownFillDrag: () => void;
   cellIndexFromPoint: (clientX: any, clientY: any) => {
     r: number;
@@ -570,7 +621,6 @@ declare class DataTable extends DataTable_base {
   cellAriaInvalid: (rowIndex: any, colIndex: any) => "true" | null;
   runValidator: (colId: any, value: any, row: any) => string | true;
   setInvalid: (msg: any) => void;
-  replaceRowValue: (rows: any, rowIndex: any, field: any, value: any) => any[];
   sourceIndexOfRow: (visibleRowIndex: any) => any;
   editingColumnId: () => any;
   editingColumnField: () => any;
@@ -582,7 +632,6 @@ declare class DataTable extends DataTable_base {
   cellValueAt: (rowIndex: any, colIndex: any) => any;
   beginEdit: (rowIndex: any, colIndex: any, seed: any) => void;
   focusCellWhenReady: (row: any, col: any) => void;
-  indexOfRowIn: (rows: any, rowOriginal: any, rowId: any) => number;
   endEdit: () => void;
   endRowEdit: () => void;
   editorAutofocusFor: (colId: any, rowIndex: any) => boolean;
@@ -595,7 +644,6 @@ declare class DataTable extends DataTable_base {
   beginRowEdit: (row: any) => void;
   commitRow: () => boolean;
   cancelRow: () => void;
-  replaceRowValues: (rows: any, rowIndex: any, fieldValues: any) => any[];
   nextEditableCell: (fromRow: any, fromCol: any) => {
     row: any;
     col: any;

package/dist/index.d.mts

@@ -120,13 +120,17 @@ declare class DataTable extends DataTable_base {
    */
   undoLimit: number;
   /**
-   * Opt-in vertical **row windowing**. When `true`, only the visible slice of rows renders 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. Default `false` is byte-identical to a non-virtual table.
+   * 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`.
    */
-  virtual: boolean;
+  virtual: boolean | string;
   /**
-   * Estimated row height (px) seeding the windowing engine before `measureElement` refines actual heights. Only consulted when `virtual` is on.
+   * Estimated row height (px) — the first-paint seed for the windowing engine before any row has been measured. Only consulted when rows are windowed. When `autoMeasure` is `true`, later renders progressively refine the estimate from measured content; when `autoMeasure` is `false` this remains the explicit override for every render.
    */
   estimateRowHeight: number;
+  /**
+   * Opt-in content-driven row-size estimation. When `true`, the windowing engine feeds `estimateSize()` a running mean of measured row heights instead of the fixed `estimateRowHeight` seed, so `getTotalSize()` converges to the true content total on a large table with variable-height rows. Falls back to `estimateRowHeight` before any row has been measured. Default `false` keeps the estimate fixed at `estimateRowHeight` for every render (today's behavior).
+   */
+  autoMeasure: boolean;
   /**
    * A CSS length string bounding the `rdt-scroll` container when `virtual` is on (e.g. `'400px'`). Mirrored to the `--rozie-data-table-max-height` custom property; the prop wins, the token is the fallback.
    */
@@ -249,7 +253,11 @@ declare class DataTable extends DataTable_base {
   virtualizer: any;
   virtualizerCleanup: any;
   gridScrollEl: any;
+  colVirtualizer: any;
+  colVirtualizerCleanup: any;
   remeasurePending: boolean;
+  remeasureRaf: any;
+  remeasureDisposed: boolean;
   GRID_PAGE_STEP: number;
   gridRoot: any;
   programmatic: number;
@@ -263,8 +271,6 @@ declare class DataTable extends DataTable_base {
   effectiveColumnPinning: () => any;
   currentState: () => any;
   currentData: () => any;
-  isSafeKey: (k: any) => boolean;
-  wrapAggregationFn: (fn: any) => string | ((columnId: any, leafRows: any, childRows: any) => any);
   buildConfigDef: (c: any) => {
     id: string;
     header: any;
@@ -299,13 +305,17 @@ declare class DataTable extends DataTable_base {
     };
     columns?: undefined;
   };
+  columnDefsCache: any[] | null;
+  columnDefsCacheColumnsRef: any;
+  columnDefsCacheColRegRef: any;
+  columnDefsIndexCache: any;
   columnDefs: () => any[];
+  defIndex: () => any;
   SELECT_COL_ID: string;
   EXPANDER_COL_ID: string;
   selectionEnabled: () => boolean;
   tableColumns: () => any[];
   writeSorting: (next: any) => void;
-  applyUpdater: (updater: any, current: any) => any;
   writeExpanded: (next: any) => void;
   writeGrouping: (next: any) => void;
   writeGlobalFilter: (next: any) => void;
@@ -340,12 +350,39 @@ declare class DataTable extends DataTable_base {
   onColumnOrderChangeCb: (updater: any) => void;
   onColumnPinningChangeCb: (updater: any) => void;
   onColumnSizingInfoChangeCb: (updater: any) => void;
+  resolveVirtual: () => "rows" | "columns" | "both" | "off";
+  rowsWindowed: () => boolean;
+  colsWindowed: () => boolean;
+  isWindowed: () => boolean;
+  autoMeasureOn: () => boolean;
+  columnCount: () => number;
+  columnSize: (i: number) => number;
+  forcedColumns: () => number[];
+  windowedCells: (row: any) => any;
   windowSource: () => any;
   scheduleRemeasure: () => void;
+  teardownRemeasure: () => void;
   pinnedEditIndex: () => any;
   pinnedMeasurement: (pin: any) => any;
   remeasureWindow: () => void;
   virtualItemKey: (i: any) => any;
+  COL_OVERSCAN: number;
+  colRtlObserver: any;
+  colRtlObserverEl: any;
+  isColRtl: () => boolean;
+  ensureColRtlWatch: () => void;
+  teardownColRtlWatch: () => void;
+  columnVirtualizerOptions: () => any;
+  measuredRowTotal: number;
+  measuredRowCount: number;
+  lastFedRowEstimate: number;
+  foldedRowHeights: Record<number, number>;
+  windowVerBumpPending: boolean;
+  bumpWindowVer: () => void;
+  ESTIMATE_REFEED_DELTA_PX: number;
+  estimateRowSize: (i: number) => number;
+  foldMeasuredRow: (index: number, height: number) => void;
+  refineRowEstimate: () => void;
   virtualizerOptions: () => any;
   pinMeasurement: (pin: number) => {
     start: number;
@@ -358,6 +395,11 @@ declare class DataTable extends DataTable_base {
   padBottom: () => number;
   pmIndexInWindow: (items: any, idx: any) => boolean;
   rowIsOutsideWindow: (r: any) => boolean;
+  windowedColIndices: () => any;
+  colPadLeft: () => any;
+  colPadRight: () => number;
+  colIsOutsideWindow: (c: any) => boolean;
+  afterRowRemeasure: () => void;
   announceState: {
     sorting: unknown;
     columnFilters: unknown;
@@ -416,11 +458,16 @@ declare class DataTable extends DataTable_base {
   onToggleExpand: (row: any, evt: any) => void;
   bodyCellStyle: (row: any, colId: any) => string;
   rowIsGrouped: (row: any) => boolean;
+  rowIndexIsGrouped: (rowIndex: any) => boolean;
   groupingActive: () => boolean;
   cellIsGrouped: (cellCtx: any) => boolean;
   cellIsAggregated: (cellCtx: any) => boolean;
   cellIsPlaceholder: (cellCtx: any) => boolean;
   groupSubRowCount: (row: any) => any;
+  groupRowDescriptorCache: any;
+  groupRowDescriptorCacheVer: any;
+  groupRowDescriptor: (row: any) => any;
+  cellSlotRow: (row: any) => any;
   groupingKeys: () => any;
   groupableColumns: () => any[];
   stopEvent: (evt: any) => void;
@@ -467,7 +514,6 @@ declare class DataTable extends DataTable_base {
   bodyAriaRowIndex: (row: any) => number;
   visibleColCount: () => any;
   bodyRowCount: () => number;
-  clamp: (v: any, lo: any, hi: any) => any;
   headerLeafLevel: () => number;
   headerCountAtLevel: (level: any) => any;
   headerAt: (level: any, colIndex: any) => any;
@@ -491,7 +537,6 @@ declare class DataTable extends DataTable_base {
     col: number;
   };
   currentCellEl: () => any;
-  focusables: (cellEl: any) => any[];
   enterControl: () => void;
   cycleWithinCell: (cellEl: any, forward: any) => void;
   onGridKeyDown: (e: any) => void;
@@ -502,6 +547,9 @@ declare class DataTable extends DataTable_base {
   onGridFocusOut: (e: any) => void;
   recoverGridFocus: (rowKey: any, col: any, level: any, guardMoved?: boolean) => void;
   clampActiveCell: (rowCount: any, colCount: any) => void;
+  windowedHeadersFor: (hg: any, hgLevel: any) => any;
+  windowedColSpan: () => any;
+  remeasureColumnWindow: () => void;
   gridEmptyFallback: boolean;
   rangeTransition: boolean;
   rangeClickPending: boolean;
@@ -533,9 +581,7 @@ declare class DataTable extends DataTable_base {
     c0: any;
     c1: any;
   };
-  escapeTsvField: (s: any) => any;
   rangeToTsv: () => string;
-  parseTsv: (text: any) => any[];
   copyRange: () => void;
   applyGridToRange: (grid: any, originRow: any, originCol: any) => {
     wrote: number;
@@ -543,15 +589,20 @@ declare class DataTable extends DataTable_base {
   };
   rowOriginalAt: (rowIndex: any) => any;
   rowIdAt: (rowIndex: any) => any;
-  tileGridToBox: (grid: any, box: any) => any;
   pasteRange: () => void;
   cutRange: () => void;
   clearActiveRange: () => void;
-  tileIndex: (i: any, lo: any, hi: any) => any;
   fillRange: (sourceBox: any, endCell: any) => void;
   fillDragging: boolean;
   fillDragMove: any;
   fillDragUp: any;
+  fillEdgeScrollRaf: any;
+  FILL_EDGE_SCROLL_PX: number;
+  FILL_EDGE_SCROLL_STEP: number;
+  edgeDelta: (clientX: any, clientY: any) => {
+    dx: number;
+    dy: number;
+  };
   teardownFillDrag: () => void;
   cellIndexFromPoint: (clientX: any, clientY: any) => {
     r: number;
@@ -570,7 +621,6 @@ declare class DataTable extends DataTable_base {
   cellAriaInvalid: (rowIndex: any, colIndex: any) => "true" | null;
   runValidator: (colId: any, value: any, row: any) => string | true;
   setInvalid: (msg: any) => void;
-  replaceRowValue: (rows: any, rowIndex: any, field: any, value: any) => any[];
   sourceIndexOfRow: (visibleRowIndex: any) => any;
   editingColumnId: () => any;
   editingColumnField: () => any;
@@ -582,7 +632,6 @@ declare class DataTable extends DataTable_base {
   cellValueAt: (rowIndex: any, colIndex: any) => any;
   beginEdit: (rowIndex: any, colIndex: any, seed: any) => void;
   focusCellWhenReady: (row: any, col: any) => void;
-  indexOfRowIn: (rows: any, rowOriginal: any, rowId: any) => number;
   endEdit: () => void;
   endRowEdit: () => void;
   editorAutofocusFor: (colId: any, rowIndex: any) => boolean;
@@ -595,7 +644,6 @@ declare class DataTable extends DataTable_base {
   beginRowEdit: (row: any) => void;
   commitRow: () => boolean;
   cancelRow: () => void;
-  replaceRowValues: (rows: any, rowIndex: any, fieldValues: any) => any[];
   nextEditableCell: (fromRow: any, fromCol: any) => {
     row: any;
     col: any;