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

package/README.md

@@ -501,6 +501,8 @@ Beyond props, the component exposes imperative methods (declared once in the Roz
 | `focusCell` | Move + focus the active cell (grid interaction mode) — `focusCell(rowIndex, colIndex)`. `rowIndex` is the ABSOLUTE display-order position in `getPrePaginationRowModel().rows` (filter+sort+expand applied, BEFORE pagination/windowing), in BOTH paginated and virtual modes: a paginated `focusCell(abs)` switches to `Math.floor(abs/pageSize)` then focuses; a virtual `focusCell(abs)` scrolls-then-focuses. Args coerced to integers + clamped to bounds. Fires `activecell-change` with the absolute `rowIndex`. (Named `focusCell`, not `focus`: a bare `focus` verb shadows the inherited `HTMLElement.focus` on Lit — ROZ137.) |
 | `getActiveCell` | Return the current active-cell position — `getActiveCell()` → `{ rowIndex, colIndex, isHeader }`. For a body cell `rowIndex` is the ABSOLUTE display-order index (matching `focusCell` / `activecell-change`) and `isHeader` is `false`; for a header-active cell `rowIndex` is `null` and `isHeader` is `true` (integers only — no row data, no DOM node). |
 | `clearActiveCell` | Reset the roving active-cell position to the entry cell and exit interaction mode — `clearActiveCell()`. The next Tab-in re-enters at the entry cell. (Named `clearActiveCell`, not `clear`: distinct from the listbox `clear` selection verb.) |
+| `scrollToRow` | Scroll a row into view on a `virtual` table — `scrollToRow(index, options?)` where `options` mirrors TanStack virtual-core's own `ScrollToOptions` (`{ align?: 'start'|'center'|'end'|'auto', behavior?: 'auto'|'smooth'|'instant' }`) and is forwarded UNCHANGED to `virtualizer.scrollToIndex`. INDEPENDENT of grid-mode focus: never moves the roving active cell and never fires `activecell-change`, callable in either `interactionMode`. `index` is coerced to an integer (never range-clamped here — virtual-core's own `scrollToIndex` already clamps to `[0, options.count-1]`). A no-op when rows are not windowed (`virtual` off, or `'columns'`-only). |
+| `getScrollElement` | Return the scroll-container DOM node the row and column virtualizer(s) observe — `getScrollElement()` → `HTMLElement | null`. The supported replacement for reaching into the internal `.rdt-scroll` class selector. Returns `null` when nothing is windowed. |
 | `getRowIndexRelativeToPage` | Convert an ABSOLUTE display-order row index (the `focusCell` / `getActiveCell` / `activecell-change` space) to the PAGE-RELATIVE index — `getRowIndexRelativeToPage(absRow?)` → `number`. With no argument it converts the current active cell (`abs - pageIndex*pageSize`). In virtual mode (no pagination) it returns the absolute index unchanged. Mirrors MUI `getRowIndexRelativeToVisibleRows`. (Named `getRowIndexRelativeToPage`: collision-clean against the verb/event/prop and Lit ROZ137 reserved sets.) |
 | `editCell` | Programmatically open the editor on a cell — `editCell(rowIndex, colIndex)`, addressed by index over the visible model (args coerced to integers + clamped). No-op on a non-editable cell. (Named `editCell`, not `edit`: collision-clean against the verb/event/prop and Lit ROZ137 reserved sets.) |
 | `commitEditing` | Programmatically commit the open editor — `commitEditing()`. Runs the column validator; on success writes the two-way `data` model and fires one `cell-edit-commit`; on a validation failure keeps the editor open. No-op when no cell is editing. (Named `commitEditing`, not `commit`.) |

package/dist/index.cjs

@@ -1146,6 +1146,11 @@ let DataTable = class DataTable extends (0, _lit_labs_preact_signals.SignalWatch
 				composed: true
 			}));
 		};
+		this.scrollToRow = (index, options) => {
+			if (!this.rowsWindowed() || !this.virtualizer) return;
+			this.virtualizer.scrollToIndex(Math.trunc(Number(index)) || 0, options || void 0);
+		};
+		this.getScrollElement = () => this.gridScrollEl;
 		this.virtualItemKey = (i) => {
 			const src = this.windowSource();
 			return src && src[i] ? src[i].id : void 0;

package/dist/index.d.cts

@@ -447,6 +447,11 @@ declare class DataTable extends DataTable_base {
   lastRangeStart: number;
   lastRangeEnd: number;
   emitVisibleRangeIfChanged: () => void;
+  scrollToRow: (index: any, options?: {
+    align?: "start" | "center" | "end" | "auto";
+    behavior?: "auto" | "smooth" | "instant";
+  }) => void;
+  getScrollElement: () => any;
   virtualItemKey: (i: any) => any;
   COL_OVERSCAN: number;
   colRtlObserver: any;

package/dist/index.d.mts

@@ -447,6 +447,11 @@ declare class DataTable extends DataTable_base {
   lastRangeStart: number;
   lastRangeEnd: number;
   emitVisibleRangeIfChanged: () => void;
+  scrollToRow: (index: any, options?: {
+    align?: "start" | "center" | "end" | "auto";
+    behavior?: "auto" | "smooth" | "instant";
+  }) => void;
+  getScrollElement: () => any;
   virtualItemKey: (i: any) => any;
   COL_OVERSCAN: number;
   colRtlObserver: any;

package/dist/index.mjs

@@ -1142,6 +1142,11 @@ let DataTable = class DataTable extends SignalWatcher(LitElement) {
 				composed: true
 			}));
 		};
+		this.scrollToRow = (index, options) => {
+			if (!this.rowsWindowed() || !this.virtualizer) return;
+			this.virtualizer.scrollToIndex(Math.trunc(Number(index)) || 0, options || void 0);
+		};
+		this.getScrollElement = () => this.gridScrollEl;
 		this.virtualItemKey = (i) => {
 			const src = this.windowSource();
 			return src && src[i] ? src[i].id : void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rozie-ui/data-table-lit",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "private": false,
   "license": "MIT",

package/src/DataTable.ts

@@ -3420,6 +3420,35 @@ ${this.groupable ? html`<div class="rdt-group-bar-host" data-rozie-s-d5dcab4c>
   }));
 };
 
+  // scrollToRow(index, options?) — quick 260927-a2r (oinbox dogfooding): plain scroll-into-view
+  // for a windowed row, forwarding TanStack virtual-core's own ScrollToOptions ({ align?,
+  // behavior? }) UNCHANGED to virtualizer.scrollToIndex — the SAME call focusActiveCell's D-12
+  // off-window scroll-then-focus path (gridFocusNav.rzts) already drives, exposed here as a
+  // standalone public verb rather than invented plumbing. INDEPENDENT of grid-mode focus
+  // (feedback_no_false_equivalent_options / the todo's own open question): never reads or
+  // writes $data.activeRow/activeColIndex, never emits activecell-change, and is callable in
+  // EITHER interactionMode ('table' or 'grid') — a scroll, not a focus move. No-op when rows
+  // are not windowed or the row virtualizer has not been constructed yet — mirrors the
+  // isGrid()-gated no-op precedent on focusCell/clearActiveCell (gridActiveCellVerbs.rzts) for
+  // the identical reason: the capability this verb drives isn't active. `index` is coerced
+  // (T-260927A2R-01) — never range-clamped here: virtual-core's own scrollToIndex already
+  // clamps to [0, options.count-1] internally (verified in @tanstack/virtual-core source).
+  scrollToRow = (index: any, options?: {
+  align?: 'start' | 'center' | 'end' | 'auto';
+  behavior?: 'auto' | 'smooth' | 'instant';
+}): void => {
+  if (!this.rowsWindowed() || !this.virtualizer) return;
+  this.virtualizer.scrollToIndex(Math.trunc(Number(index)) || 0, options || undefined);
+};
+
+  // getScrollElement() — quick 260927-a2r: returns the DOM node the row AND column
+  // virtualizer(s) observe/scroll (the `.rdt-scroll` div captured post-mount in
+  // DataTable.rozie's own $onMount, D-03) — the supported replacement for a consumer reaching
+  // into the internal `.rdt-scroll` class selector. Returns null when nothing is windowed:
+  // gridScrollEl is only ever assigned inside the isWindowed() guard, so no extra gate is
+  // needed here beyond that natural null.
+  getScrollElement = (): any => this.gridScrollEl;
+
   // ══ Generic vertical windowing math (Phase 64, D-04) — the target-agnostic virtual-core bridge ══
   // Lifted verbatim from the DataTable virtualization.rzts (the Phase 53/63 B13 baseline). This partial
   // holds ONLY the PURE windowing math; every DOM/refs/virtualizer-instance impurity stays per-consumer