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

package/dist/index.d.cts

@@ -61,6 +61,10 @@ declare class DataTable extends DataTable_base {
    */
   _expanded_attr: any | boolean;
   private _expandedControllable;
+  /**
+   * Row identity `(originalRow, index, parentRow?) => string | number` — the key `rowSelection`, `expanded` and the per-row caches use. Default null → table-core keys rows by position (`"0"`, `"1"`, … and `"0.1"` for sub-rows), so inserting or removing rows above a selected or expanded row moves that state onto whatever row now sits at its index. Supply it whenever rows can be added or removed while state is held (server push, live lists); the result is coerced to a string.
+   */
+  getRowId: ((...args: any[]) => any) | null;
   /**
    * Table-level child-row accessor `(originalRow, index) => TData[] | undefined` that drives nested sub-rows. When supplied (with `expandable`), table-core flattens the hierarchy and the expand seam reveals depth-indented child rows. Null → the `#detail` scoped slot is the expand mode.
    */
@@ -169,10 +173,12 @@ declare class DataTable extends DataTable_base {
   private _rangeAnchor;
   private _rangeFocus;
   private _pasteAnnounce;
+  private _rangeAnnounce;
   private _liveAnnounce;
   private _ref__rozieRoot;
   private __rozieWatchInitial_0;
   private __rozieWatchInitial_1;
+  private __rozieWatchInitial_2;
   private __rozieCtxProvider_data_table_columns;
   private _rozieSlotDistributor;
   private _hasSlotDefault;
@@ -196,6 +202,12 @@ declare class DataTable extends DataTable_base {
   private _slotDynamicColHeaderElements;
   private _hasSlotDynamicFilter;
   private _slotDynamicFilterElements;
+  private _hasSlotPlaceholder;
+  private _slotPlaceholderElements;
+  placeholder?: (scope: {
+    index: any;
+    columnId: any;
+  }) => unknown;
   private _hasSlotSelectCell;
   private _slotSelectCellElements;
   selectCell?: (scope: {
@@ -226,6 +238,7 @@ declare class DataTable extends DataTable_base {
     value: any;
     uniqueValues: any;
     minMax: any;
+    columnLabel: any;
     setFilter: any;
   }) => unknown;
   private _hasSlotCell;
@@ -245,6 +258,7 @@ declare class DataTable extends DataTable_base {
     value: any;
     commit: any;
     cancel: any;
+    columnLabel: any;
     autofocus: any;
   }) => unknown;
   rozieSlots?: {
@@ -258,6 +272,7 @@ declare class DataTable extends DataTable_base {
       value: any;
       uniqueValues: any;
       minMax: any;
+      columnLabel: any;
       setFilter: any;
     }) => unknown;
     [key: `cell-${string}`]: (scope: {
@@ -273,6 +288,7 @@ declare class DataTable extends DataTable_base {
       value: any;
       commit: any;
       cancel: any;
+      columnLabel: any;
       autofocus: any;
     }) => unknown;
   } & Record<string, (scope: any) => unknown>;
@@ -294,8 +310,13 @@ declare class DataTable extends DataTable_base {
   remeasurePending: boolean;
   remeasureRaf: any;
   remeasureDisposed: boolean;
+  scrollEndPinned: boolean;
+  scrollEndPinnedCount: number;
+  scrollEndPinnedTop: number;
   GRID_PAGE_STEP: number;
   gridRoot: any;
+  outsidePointerDown: boolean;
+  docPointerDown: any;
   programmatic: number;
   focusIntentEpoch: number;
   DATA_WRITE_TOKEN_KEY: string;
@@ -309,21 +330,37 @@ declare class DataTable extends DataTable_base {
   seedColumnPinning: () => void;
   currentState: () => any;
   currentData: () => any;
+  /**
+   * A-01 — translate the public per-column `width` into table-core's `size`.
+   *
+   * `width` was written onto the ColumnDef in both build branches and read by NOTHING:
+   * table-core resolves column width from `size` (a NUMBER of px), which only the two
+   * chrome columns ever set. So the documented API was completely inert — the exact
+   * sibling of the inert `pinned` that 0.5.0 closed.
+   *
+   * `size` is numeric px by construction, so only a number or a px string can map onto
+   * it; any other CSS length (`12rem`, `20%`, `auto`) has no numeric px value at build
+   * time and is deliberately NOT guessed — it returns null and the column keeps
+   * table-core's default. The `width` prop's docs say exactly this.
+   *
+   * Returns null (not undefined) for "no usable width" so callers can test `!= null`
+   * without tripping over a legitimate 0.
+   */
+  parseWidthToSize: (w: any) => number;
+  editorWarned: any;
+  checkEditorKind: (id: any, editor: any) => any;
   buildConfigDef: (c: any) => {
     id: string;
     header: any;
     columns: any[];
-    accessorKey?: undefined;
-    enableSorting?: undefined;
-    enableColumnFilter?: undefined;
-    filterable?: undefined;
-    expandable?: undefined;
-    groupable?: undefined;
-    aggregationFn?: undefined;
-    pinned?: undefined;
-    width?: undefined;
-    meta?: undefined;
   } | {
+    meta: {
+      editable: boolean;
+      editor: any;
+      editorOptions: any;
+      validate: any;
+    };
+    size?: number;
     id: string;
     accessorKey: any;
     header: any;
@@ -335,12 +372,6 @@ declare class DataTable extends DataTable_base {
     aggregationFn: string | ((columnId: any, leafRows: any, childRows: any) => any);
     pinned: any;
     width: any;
-    meta: {
-      editable: boolean;
-      editor: any;
-      editorOptions: any;
-      validate: any;
-    };
     columns?: undefined;
   };
   columnDefsCache: any[] | null;
@@ -399,11 +430,23 @@ declare class DataTable extends DataTable_base {
   forcedColumns: () => number[];
   windowedCells: (row: any) => any;
   windowSource: () => any;
+  REMEASURE_MAX_FRAMES: number;
   scheduleRemeasure: () => void;
   teardownRemeasure: () => void;
   pinnedEditIndex: () => any;
   pinnedMeasurement: (pin: any) => any;
-  remeasureWindow: () => void;
+  remeasureWindow: () => boolean;
+  LAZY_PLACEHOLDER_KEY: string;
+  LAZY_PLACEHOLDER_ROW_ID_PREFIX: string;
+  lazyPlaceholders: Record<number, any>;
+  lazyRowsActive: () => boolean;
+  isLazyPlaceholder: (orig: any) => boolean;
+  rowIsLazyPlaceholder: (row: any) => boolean;
+  feedData: () => any[];
+  migratePlaceholderSizeCache: () => void;
+  lastRangeStart: number;
+  lastRangeEnd: number;
+  emitVisibleRangeIfChanged: () => void;
   virtualItemKey: (i: any) => any;
   COL_OVERSCAN: number;
   colRtlObserver: any;
@@ -448,6 +491,8 @@ declare class DataTable extends DataTable_base {
   effectiveColumnFilters: () => any[];
   effectiveGlobalFilter: () => string;
   buildSortFilterAnnounce: () => string;
+  rowIdOption: () => (originalRow: any, index: any, parent: any) => string;
+  rowSelectionOption: () => boolean | ((row: any) => boolean);
   reFeed: () => void;
   lastPropsData: unknown;
   maybeClearHistoryOnExternalSwap: () => void;
@@ -475,7 +520,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: (header: any) => string;
+  thStyle: (header: any, widthPx?: any) => string;
   onGlobalFilterInput: (evt: any) => void;
   onColumnFilterInput: (colId: any, evt: any) => void;
   globalFilterValue: () => any;
@@ -537,18 +582,20 @@ declare class DataTable extends DataTable_base {
   rowIndexOf: (row: any) => number;
   colIndexOf: (row: any, cellCtx: any) => any;
   headerColIndexOf: (hg: any, header: any) => any;
+  headerLeafStart: (hg: any, header: any) => number;
   pageRowOffset: () => number;
   toAbsRow: (localRow: any) => any;
   prePaginationRowCount: () => any;
   cellTabindex: (rowKey: any, colIndex: any, level?: any) => 0 | -1;
   isActiveCell: (rowKey: any, colIndex: any, level?: any) => boolean;
-  resolveCellEl: (rowKey: any, colIndex: any, level?: any) => any;
+  resolveCellEl: (rowKey: any, colIndex: any, level?: number | null) => any;
   focusActiveCell: (nextRow?: any, nextCol?: any, nextIsHeader?: any, nextLevel?: any) => void;
   totalRowCount: () => any;
   headerRowCount: () => number;
   gridAriaRowCount: () => any;
   ariaPageOffset: () => number;
   bodyAriaRowIndex: (row: any) => number;
+  gridAriaColCount: () => any;
   visibleColCount: () => any;
   bodyRowCount: () => number;
   headerLeafLevel: () => number;
@@ -574,22 +621,28 @@ declare class DataTable extends DataTable_base {
     col: number;
   };
   currentCellEl: () => any;
+  activeCellHasControls: () => boolean;
   enterControl: () => void;
   cycleWithinCell: (cellEl: any, forward: any) => void;
   onGridKeyDown: (e: any) => void;
   syncActiveFromEvent: (e: any) => void;
   onGridMouseDown: (e: any) => void;
   onGridDblClick: (e: any) => void;
+  activateRowAt: (index: any, trigger: any) => void;
+  ROW_ACTIVATE_CONTROLS: string;
+  maybeActivateRowFromClick: (e: any) => void;
   onGridClick: (e: any) => void;
   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;
+  lastColSizeSig: number;
+  remeasureColumnSizes: () => void;
   remeasureColumnWindow: () => void;
   gridEmptyFallback: boolean;
   rangeTransition: boolean;
-  rangeClickPending: boolean;
+  rangeClickPending: any;
   rangeActive: boolean;
   inRange: (rIdx: any, cIdx: any) => boolean;
   getSelectedRange: () => {
@@ -603,10 +656,14 @@ declare class DataTable extends DataTable_base {
     };
   };
   isFillHandleCell: (rIdx: any, cIdx: any) => boolean;
+  rangeSummary: (anchor: any, focus: any) => string;
   emitRangeChange: (anchor: any, focus: any) => void;
   extendRange: (dRow: any, dCol: any) => void;
-  setRangeFocus: (rIdx: any, cIdx: any) => void;
+  setRangeFocus: (rIdx: any, cIdx: any, anchorR?: any, anchorC?: any) => void;
   selectAllBody: () => void;
+  rangeFocusRow: () => any;
+  rangeFocusCol: () => any;
+  selectActiveColumn: () => void;
   clearRange: () => void;
   clampRange: (maxRowArg: any, maxColArg: any) => void;
   announce: (msg: any) => void;
@@ -619,9 +676,12 @@ declare class DataTable extends DataTable_base {
     c1: any;
   };
   rangeToTsv: () => string;
+  clipboardWriteAvailable: () => boolean;
+  clipboardReadAvailable: () => boolean;
   copyRange: () => void;
-  applyGridToRange: (grid: any, originRow: any, originCol: any) => {
+  applyGridToRange: (grid: any, originRow: any, originCol: any, verb: any) => {
     wrote: number;
+    changed: number;
     total: number;
   };
   rowOriginalAt: (rowIndex: any) => any;
@@ -699,6 +759,11 @@ declare class DataTable extends DataTable_base {
   editTransition: boolean;
   pendingEditFollow: any;
   committedThisSession: boolean;
+  rowDraftSync: Record<string, any>;
+  dropinTabFlush: {
+    called: boolean;
+    committed: boolean;
+  } | null;
   inRowEdit: () => boolean;
   editorValueFor: (colId: any) => any;
   editorCheckedFor: (colId: any) => boolean;
@@ -709,6 +774,7 @@ declare class DataTable extends DataTable_base {
   setRowDraft: (colId: any, value: any) => void;
   rowEditTab: (target: any, backward: any) => void;
   onEditorKeyDown: (e: any) => void;
+  onEditorDropinKeyDown: (e: any) => void;
   onEditorBlur: (e: any) => void;
   editCell: (rowIndex: any, colIndex: any) => void;
   commitEditing: () => void;
@@ -786,7 +852,7 @@ declare class Column extends Column_base {
    */
   pinned: string;
   /**
-   * Optional fixed/initial column width — a CSS length string or a px number.
+   * Optional fixed/initial column width, applied as the column's starting size — a px number (`120`) or a px string (`'120px'`). Column sizing is numeric px, so other CSS lengths (`'12rem'`, `'20%'`, `'auto'`) have no px value to apply and are ignored; the column keeps the default width. An interactive resize overrides this.
    */
   width: string | number;
   /**
@@ -879,7 +945,12 @@ declare class EditorText extends EditorText_base {
    * Focus this editor's primary input when true — the host sets it for the one editor that should hold focus; reactive.
    */
   autofocus: boolean;
+  /**
+   * The column's human header, forwarded by the slot scope — used as the control's accessible name in place of the internal column id.
+   */
+  columnLabel: string;
   private _draft;
+  private _touched;
   private _refInputEl;
   private __rozieFirstUpdateDone;
   private _disconnectCleanups;
@@ -888,11 +959,13 @@ declare class EditorText extends EditorText_base {
   updated(changedProperties: Map<string, unknown>): void;
   disconnectedCallback(): void;
   render(): _$lit.TemplateResult<1>;
+  draftValue: () => string;
   onInput: (e: any) => void;
   doCommit: () => void;
   doCancel: () => void;
   onKeydown: (e: any) => void;
   onBlur: () => void;
+  a11yLabel: () => string;
 }
 //#endregion
 //#region src/EditorNumber.d.ts
@@ -923,17 +996,31 @@ declare class EditorNumber extends EditorNumber_base {
    * `() => void` — revert the edit (Escape). Null-guarded at call sites.
    */
   cancel: ((...args: any[]) => any) | null;
+  /**
+   * Focus this editor's primary control when true — the host sets it for the one editor that should hold focus; reactive.
+   */
+  autofocus: boolean;
+  /**
+   * The column's human header, forwarded by the slot scope — used as the control's accessible name in place of the internal column id.
+   */
+  columnLabel: string;
   private _draft;
+  private _touched;
+  private _refInputEl;
+  private __rozieFirstUpdateDone;
   private _disconnectCleanups;
   private _rozieTornDown;
   firstUpdated(): void;
+  updated(changedProperties: Map<string, unknown>): void;
   disconnectedCallback(): void;
   render(): _$lit.TemplateResult<1>;
+  draftValue: () => string;
   onInput: (e: any) => void;
   doCommit: () => void;
   doCancel: () => void;
   onKeydown: (e: any) => void;
   onBlur: () => void;
+  a11yLabel: () => string;
 }
 //#endregion
 //#region src/EditorSelect.d.ts
@@ -968,17 +1055,31 @@ declare class EditorSelect extends EditorSelect_base {
    * The select options — `[{ value, label }]`. Mirrors `<Column editorOptions>`.
    */
   options: any[];
+  /**
+   * Focus this editor's primary control when true — the host sets it for the one editor that should hold focus; reactive.
+   */
+  autofocus: boolean;
+  /**
+   * The column's human header, forwarded by the slot scope — used as the control's accessible name in place of the internal column id.
+   */
+  columnLabel: string;
   private _draft;
+  private _touched;
+  private _refSelectEl;
+  private __rozieFirstUpdateDone;
   private _disconnectCleanups;
   private _rozieTornDown;
   firstUpdated(): void;
+  updated(changedProperties: Map<string, unknown>): void;
   disconnectedCallback(): void;
   render(): _$lit.TemplateResult<1>;
+  draftValue: () => string;
   onChange: (e: any) => void;
   doCommit: () => void;
   doCancel: () => void;
   onKeydown: (e: any) => void;
   onBlur: () => void;
+  a11yLabel: () => string;
 }
 //#endregion
 //#region src/EditorCheckbox.d.ts
@@ -1009,12 +1110,25 @@ declare class EditorCheckbox extends EditorCheckbox_base {
    * `() => void` — revert the edit (Escape). Null-guarded at call sites.
    */
   cancel: ((...args: any[]) => any) | null;
+  /**
+   * Focus this editor's primary control when true — the host sets it for the one editor that should hold focus; reactive.
+   */
+  autofocus: boolean;
+  /**
+   * The column's human header, forwarded by the slot scope — used as the control's accessible name in place of the internal column id.
+   */
+  columnLabel: string;
+  private _refInputEl;
+  private __rozieFirstUpdateDone;
   private _disconnectCleanups;
   private _rozieTornDown;
+  firstUpdated(): void;
+  updated(changedProperties: Map<string, unknown>): void;
   disconnectedCallback(): void;
   render(): _$lit.TemplateResult<1>;
   onChange: (e: any) => void;
   onKeydown: (e: any) => void;
+  a11yLabel: () => string;
 }
 //#endregion
 //#region src/EditorDate.d.ts
@@ -1045,18 +1159,32 @@ declare class EditorDate extends EditorDate_base {
    * `() => void` — revert the edit (Escape). Null-guarded at call sites.
    */
   cancel: ((...args: any[]) => any) | null;
+  /**
+   * Focus this editor's primary control when true — the host sets it for the one editor that should hold focus; reactive.
+   */
+  autofocus: boolean;
+  /**
+   * The column's human header, forwarded by the slot scope — used as the control's accessible name in place of the internal column id.
+   */
+  columnLabel: string;
   private _draft;
+  private _touched;
+  private _refInputEl;
+  private __rozieFirstUpdateDone;
   private _disconnectCleanups;
   private _rozieTornDown;
   firstUpdated(): void;
+  updated(changedProperties: Map<string, unknown>): void;
   disconnectedCallback(): void;
   render(): _$lit.TemplateResult<1>;
+  draftValue: () => string;
   onInput: (e: any) => void;
   doCommit: () => void;
   doCancel: () => void;
   onChange: (e: any) => void;
   onKeydown: (e: any) => void;
   onBlur: () => void;
+  a11yLabel: () => string;
 }
 //#endregion
 //#region src/FilterText.d.ts
@@ -1079,17 +1207,25 @@ declare class FilterText extends FilterText_base {
    * `(columnId, value) => void` — apply the column filter (Enter / blur applies, Escape clears). Null-guarded at call sites.
    */
   setFilter: ((...args: any[]) => any) | null;
+  /**
+   * The column's human header, forwarded by the `#filter` slot scope — used as the control's accessible name in place of the internal column id.
+   */
+  columnLabel: string;
   private _draft;
+  private _touched;
+  private __rozieFirstUpdateDone;
   private _disconnectCleanups;
   private _rozieTornDown;
-  firstUpdated(): void;
+  updated(changedProperties: Map<string, unknown>): void;
   disconnectedCallback(): void;
   render(): _$lit.TemplateResult<1>;
+  draftValue: () => string;
   onInput: (e: any) => void;
   applyFilter: () => void;
   clearFilter: () => void;
   onKeydown: (e: any) => void;
   onBlur: () => void;
+  a11yLabel: () => string;
 }
 //#endregion
 //#region src/FilterNumberRange.d.ts
@@ -1116,18 +1252,29 @@ declare class FilterNumberRange extends FilterNumberRange_base {
    * The faceted `[min, max]` bounds for this column (`[number, number]` or null) — drives the input placeholders only.
    */
   minMax: unknown;
+  /**
+   * The column's human header, forwarded by the `#filter` slot scope — used as the control's accessible name in place of the internal column id.
+   */
+  columnLabel: string;
   private _minDraft;
   private _maxDraft;
+  private _touched;
+  private __rozieWatchInitial_0;
   private _disconnectCleanups;
   private _rozieTornDown;
   firstUpdated(): void;
   disconnectedCallback(): void;
   render(): _$lit.TemplateResult<1>;
+  minDraftValue: () => string;
+  maxDraftValue: () => string;
   onMinInput: (e: any) => void;
   onMaxInput: (e: any) => void;
+  onKeydown: (e: any) => void;
+  onBlur: () => void;
   minPlaceholder: () => string;
   maxPlaceholder: () => string;
-  applyRange: () => void;
+  applyRange: (minDraft: any, maxDraft: any) => void;
+  a11yLabel: () => string;
 }
 //#endregion
 //#region src/FilterSelect.d.ts
@@ -1154,12 +1301,17 @@ declare class FilterSelect extends FilterSelect_base {
    * The faceted distinct keys for this column (cross-filtered, keys only — no occurrence counts) used to build the `<option>` list.
    */
   uniqueValues: any[];
+  /**
+   * The column's human header, forwarded by the `#filter` slot scope — used as the control's accessible name in place of the internal column id.
+   */
+  columnLabel: string;
   private _disconnectCleanups;
   private _rozieTornDown;
   disconnectedCallback(): void;
   render(): _$lit.TemplateResult<1>;
   selectValue: () => string;
   onChange: (e: any) => void;
+  a11yLabel: () => string;
 }
 //#endregion
 //#region src/GroupBar.d.ts
@@ -1199,6 +1351,9 @@ declare class GroupBar extends GroupBar_base {
   onDragEnd: () => void;
   onDrop: (e: any) => void;
   removeKey: (key: any) => void;
+  toggleKey: (id: any) => void;
+  moveKey: (key: any, delta: any) => void;
+  onTokenKeydown: (e: any, gk: any) => void;
   clearAll: () => void;
   labelFor: (key: any) => any;
 }