@rickcedwhat/playwright-smart-table 6.23.1-next.e2bf5cf → 6.23.1-next.f369c63

package/dist/engine/rowFinder.js

@@ -135,12 +135,13 @@ class RowFinder {
         await (0, loadingWait_1.waitWhileTableLoading)(this.config, context, this.rootLocator.page(), 'waitForTableReady');
     }
     async findRows(filters = {}, options) {
-        var _a, _b, _c;
+        var _a;
+        var _b, _c;
         const filtersRecord = filters;
         const map = await this.tableMapper.getMap();
         const allRows = [];
-        const effectiveMaxPages = (_b = (_a = options === null || options === void 0 ? void 0 : options.maxPages) !== null && _a !== void 0 ? _a : this.config.maxPages) !== null && _b !== void 0 ? _b : Infinity;
-        const useBulk = (options === null || options === void 0 ? void 0 : options.useBulkPagination) === true && !!((_c = this.config.strategies.pagination) === null || _c === void 0 ? void 0 : _c.goNextBulk);
+        const effectiveMaxPages = (_c = (_b = options === null || options === void 0 ? void 0 : options.maxPages) !== null && _b !== void 0 ? _b : this.config.maxPages) !== null && _c !== void 0 ? _c : Infinity;
+        const useBulk = (options === null || options === void 0 ? void 0 : options.useBulkPagination) === true && !!((_a = this.config.strategies.pagination) === null || _a === void 0 ? void 0 : _a.goNextBulk);
         const hasPagination = !!this.config.strategies.pagination;
         (0, debugUtils_1.logDebug)(this.config, 'verbose', `findRows: starting (maxPages=${effectiveMaxPages}, filters=${JSON.stringify(filtersRecord)})`);
         const tracker = new elementTracker_1.ElementTracker('findRows');
@@ -154,10 +155,11 @@ class RowFinder {
                 config: this.config,
                 waitForReady: () => this.waitForTableReady(),
             }, async () => {
-                var _a, _b, _c, _d;
+                var _a;
+                var _b, _c, _d;
                 let rowLocators = this.resolve(this.config.rowSelector, this.rootLocator);
                 if (Object.keys(domFilters).length > 0) {
-                    rowLocators = this.filterEngine.applyFilters(rowLocators, domFilters, map, (_a = options === null || options === void 0 ? void 0 : options.exact) !== null && _a !== void 0 ? _a : false, this.rootLocator.page(), this.rootLocator);
+                    rowLocators = this.filterEngine.applyFilters(rowLocators, domFilters, map, (_b = options === null || options === void 0 ? void 0 : options.exact) !== null && _b !== void 0 ? _b : false, this.rootLocator.page(), this.rootLocator);
                 }
                 const newIndices = await tracker.getUnseenIndices(rowLocators);
                 const currentRows = await rowLocators.all();
@@ -171,7 +173,7 @@ class RowFinder {
                     if (loadingOutcome !== 'process') {
                         barrier === null || barrier === void 0 ? void 0 : barrier.markFinished();
                         if (loadingOutcome === 'throw') {
-                            throw new Error(`[SmartTable] Row ${allRows.length} did not finish loading within ${(_b = this.config.strategies.loading) === null || _b === void 0 ? void 0 : _b.rowLoadingTimeout}ms`);
+                            throw new Error(`[SmartTable] Row ${allRows.length} did not finish loading within ${(_a = this.config.strategies.loading) === null || _a === void 0 ? void 0 : _a.rowLoadingTimeout}ms`);
                         }
                         continue;
                     }
@@ -202,10 +204,11 @@ class RowFinder {
         return (0, smartRowArray_1.createSmartRowArray)(allRows);
     }
     async findRowLocator(filters, options = {}) {
-        var _a, _b;
+        var _a;
+        var _b;
         const map = await this.tableMapper.getMap();
-        const effectiveMaxPages = (_a = options.maxPages) !== null && _a !== void 0 ? _a : this.config.maxPages;
-        const useBulk = options.useBulkPagination === true && !!((_b = this.config.strategies.pagination) === null || _b === void 0 ? void 0 : _b.goNextBulk);
+        const effectiveMaxPages = (_b = options.maxPages) !== null && _b !== void 0 ? _b : this.config.maxPages;
+        const useBulk = options.useBulkPagination === true && !!((_a = this.config.strategies.pagination) === null || _a === void 0 ? void 0 : _a.goNextBulk);
         let found = null;
         (0, debugUtils_1.logDebug)(this.config, 'verbose', `Looking for row: ${JSON.stringify(filters)} (MaxPages: ${effectiveMaxPages})`);
         await (0, scanPages_1.scanPages)({

package/dist/engine/tableMapper.js

@@ -14,7 +14,8 @@ class TableMapper {
         (0, debugUtils_1.logDebug)(this.config, 'verbose', msg);
     }
     async getMap(timeout) {
-        var _a, _b;
+        var _a;
+        var _b;
         if (this._headerMap)
             return this._headerMap;
         this.log('Mapping headers...');

package/dist/packageVersion.d.ts

@@ -3,4 +3,4 @@
  * Generated by scripts/embed-version.mjs from package.json
  */
 /** Semver of this package. Use in logs or diagnostics to confirm the installed build. */
-export declare const PLAYWRIGHT_SMART_TABLE_VERSION: "6.23.1-next.e2bf5cf";
+export declare const PLAYWRIGHT_SMART_TABLE_VERSION: "6.23.1-next.f369c63";

package/dist/packageVersion.js

@@ -6,4 +6,4 @@ exports.PLAYWRIGHT_SMART_TABLE_VERSION = void 0;
  * Generated by scripts/embed-version.mjs from package.json
  */
 /** Semver of this package. Use in logs or diagnostics to confirm the installed build. */
-exports.PLAYWRIGHT_SMART_TABLE_VERSION = "6.23.1-next.e2bf5cf";
+exports.PLAYWRIGHT_SMART_TABLE_VERSION = "6.23.1-next.f369c63";

package/dist/plugins/index.d.ts

@@ -12,6 +12,24 @@
 export declare const Plugins: {
     /** @deprecated Use `presets.rdg` */
     RDG: {
+        headerSelector?: import("..").TableSelector;
+        rowSelector?: import("..").TableSelector;
+        cellSelector?: import("..").TableSelector;
+        maxPages?: number;
+        concurrency?: import("../types").RowIterationMode;
+        headerTransformer?: (args: {
+            text: string;
+            index: number;
+            locator: import("@playwright/test").Locator;
+            seenHeaders: Set<string>;
+        }) => string | Promise<string>;
+        autoScroll?: boolean;
+        debug?: import("..").DebugConfig;
+        onReset?: (context: import("..").TableContext) => Promise<void>;
+        strategies?: import("..").TableStrategies;
+        columnOverrides?: Partial<Record<string | number | symbol, import("..").ColumnOverride<any>>> | undefined;
+        syntheticColumns?: Record<string, import("..").SyntheticColumnDef<any>> | undefined;
+        emptyState?: import("@playwright/test").Locator;
         Strategies: {
             header: (context: import("..").TableContext) => Promise<string[]>;
             getCellLocator: ({ row, columnIndex }: {
@@ -27,36 +45,31 @@ export declare const Plugins: {
             };
             pagination: import("..").PaginationPrimitives;
         };
-        headerSelector?: import("..").TableSelector | undefined;
-        rowSelector?: import("..").TableSelector | undefined;
-        cellSelector?: import("..").TableSelector | undefined;
-        maxPages?: number | undefined;
-        concurrency?: import("../types").RowIterationMode | undefined;
-        headerTransformer?: ((args: {
+    };
+    /** @deprecated Use `presets.glide` */
+    Glide: {
+        headerSelector?: import("..").TableSelector;
+        rowSelector?: import("..").TableSelector;
+        cellSelector?: import("..").TableSelector;
+        maxPages?: number;
+        concurrency?: import("../types").RowIterationMode;
+        headerTransformer?: (args: {
             text: string;
             index: number;
             locator: import("@playwright/test").Locator;
             seenHeaders: Set<string>;
-        }) => string | Promise<string>) | undefined;
-        autoScroll?: boolean | undefined;
-        debug?: import("..").DebugConfig | undefined;
-        onReset?: ((context: import("..").TableContext) => Promise<void>) | undefined;
-        strategies?: import("..").TableStrategies | undefined;
+        }) => string | Promise<string>;
+        autoScroll?: boolean;
+        debug?: import("..").DebugConfig;
+        onReset?: (context: import("..").TableContext) => Promise<void>;
+        strategies?: import("..").TableStrategies;
         columnOverrides?: Partial<Record<string | number | symbol, import("..").ColumnOverride<any>>> | undefined;
         syntheticColumns?: Record<string, import("..").SyntheticColumnDef<any>> | undefined;
-        emptyState?: import("@playwright/test").Locator | undefined;
-    };
-    /** @deprecated Use `presets.glide` */
-    Glide: {
+        emptyState?: import("@playwright/test").Locator;
         Strategies: {
-            fillSimple: import("..").FillStrategy;
             fill: import("..").FillStrategy;
             pagination: import("..").PaginationPrimitives;
-            header: (context: import("..").StrategyContext, options?: {
-                limit?: number;
-                selector?: string;
-                scrollAmount?: number;
-            }) => Promise<string[]>;
+            header: typeof import("../presets/glide/headers").scrollRightHeader;
             viewport: import("..").ViewportStrategy;
             loading: {
                 isHeaderLoading: () => Promise<boolean>;
@@ -67,49 +80,32 @@ export declare const Plugins: {
                 columnIndex: number;
                 locator: any;
             } | null>;
+            fillSimple: import("..").FillStrategy;
         };
-        headerSelector?: import("..").TableSelector | undefined;
-        rowSelector?: import("..").TableSelector | undefined;
-        cellSelector?: import("..").TableSelector | undefined;
-        maxPages?: number | undefined;
-        concurrency?: import("../types").RowIterationMode | undefined;
-        headerTransformer?: ((args: {
-            text: string;
-            index: number;
-            locator: import("@playwright/test").Locator;
-            seenHeaders: Set<string>;
-        }) => string | Promise<string>) | undefined;
-        autoScroll?: boolean | undefined;
-        debug?: import("..").DebugConfig | undefined;
-        onReset?: ((context: import("..").TableContext) => Promise<void>) | undefined;
-        strategies?: import("..").TableStrategies | undefined;
-        columnOverrides?: Partial<Record<string | number | symbol, import("..").ColumnOverride<any>>> | undefined;
-        syntheticColumns?: Record<string, import("..").SyntheticColumnDef<any>> | undefined;
-        emptyState?: import("@playwright/test").Locator | undefined;
     };
     /**
      * @deprecated Use `presets.muiDataGrid`.
      * DataGrid only — for MUI `<Table>` use `presets.muiTable`.
      */
     MUI: {
-        Strategies: import("..").TableStrategies | undefined;
-        headerSelector?: import("..").TableSelector | undefined;
-        rowSelector?: import("..").TableSelector | undefined;
-        cellSelector?: import("..").TableSelector | undefined;
-        maxPages?: number | undefined;
-        concurrency?: import("../types").RowIterationMode | undefined;
-        headerTransformer?: ((args: {
+        headerSelector?: import("..").TableSelector;
+        rowSelector?: import("..").TableSelector;
+        cellSelector?: import("..").TableSelector;
+        maxPages?: number;
+        concurrency?: import("../types").RowIterationMode;
+        headerTransformer?: (args: {
             text: string;
             index: number;
             locator: import("@playwright/test").Locator;
             seenHeaders: Set<string>;
-        }) => string | Promise<string>) | undefined;
-        autoScroll?: boolean | undefined;
-        debug?: import("..").DebugConfig | undefined;
-        onReset?: ((context: import("..").TableContext) => Promise<void>) | undefined;
-        strategies?: import("..").TableStrategies | undefined;
+        }) => string | Promise<string>;
+        autoScroll?: boolean;
+        debug?: import("..").DebugConfig;
+        onReset?: (context: import("..").TableContext) => Promise<void>;
+        strategies?: import("..").TableStrategies;
         columnOverrides?: Partial<Record<string | number | symbol, import("..").ColumnOverride<any>>> | undefined;
         syntheticColumns?: Record<string, import("..").SyntheticColumnDef<any>> | undefined;
-        emptyState?: import("@playwright/test").Locator | undefined;
+        emptyState?: import("@playwright/test").Locator;
+        Strategies: import("..").TableStrategies | undefined;
     };
 };

package/dist/presets/glide/index.d.ts

@@ -1,27 +1,26 @@
 import { FillStrategy, TableConfig } from '../../types';
+import { scrollRightHeader } from './headers';
 export { createGlideViewport } from './viewport';
 export type { GlideViewportOptions } from './viewport';
 import { GlideViewportOptions } from './viewport';
+declare const glideGetCellLocator: ({ row, columnIndex }: any) => any;
+declare const glideGetActiveCell: ({ page }: any) => Promise<{
+    rowIndex: number;
+    columnIndex: number;
+    locator: any;
+} | null>;
 /** Strategies only for Glide Data Grid. Includes fillSimple; use when you want to supply your own selectors or override fill. */
 export declare const GlideStrategies: {
-    fillSimple: FillStrategy;
     fill: FillStrategy;
     pagination: import("../..").PaginationPrimitives;
-    header: (context: import("../..").StrategyContext, options?: {
-        limit?: number;
-        selector?: string;
-        scrollAmount?: number;
-    }) => Promise<string[]>;
+    header: typeof scrollRightHeader;
     viewport: import("../..").ViewportStrategy;
     loading: {
         isHeaderLoading: () => Promise<boolean>;
     };
-    getCellLocator: ({ row, columnIndex }: any) => any;
-    getActiveCell: ({ page }: any) => Promise<{
-        rowIndex: number;
-        columnIndex: number;
-        locator: any;
-    } | null>;
+    getCellLocator: typeof glideGetCellLocator;
+    getActiveCell: typeof glideGetActiveCell;
+    fillSimple: FillStrategy;
 };
 /** Alias of {@link GlideViewportOptions}. All fields are forwarded to the viewport strategy. */
 export type GlideOptions = GlideViewportOptions;

package/dist/presets/glide/viewport.js

@@ -41,7 +41,8 @@ const createGlideViewport = (options = {}) => {
             return { first: Math.min(...indices), last: Math.max(...indices) };
         },
         scrollToColumn: async (context, colIndex) => {
-            var _a, _b;
+            var _a;
+            var _b;
             const { page } = context;
             const scroller = page.locator('.dvn-scroller').first();
             // Derive total column count from the initialized header map (available post-init).

package/dist/presets/rdg.d.ts

@@ -1,12 +1,18 @@
 import type { Locator } from '@playwright/test';
 import { TableContext, TableConfig, ViewportStrategy, StrategyContext } from '../types';
+/**
+ * Scrolls the grid horizontally to collect all column headers.
+ * Handles empty headers by labeling them (e.g. "Checkbox").
+ */
+declare const scrollRightHeaderRDG: (context: TableContext) => Promise<string[]>;
+declare const rdgGetCellLocator: ({ row, columnIndex }: {
+    row: Locator;
+    columnIndex: number;
+}) => Locator;
 /** Full strategies for React Data Grid. Use when you want to supply your own selectors: `strategies: presets.rdg.Strategies` */
 export declare const RDGStrategies: {
-    header: (context: TableContext) => Promise<string[]>;
-    getCellLocator: ({ row, columnIndex }: {
-        row: Locator;
-        columnIndex: number;
-    }) => Locator;
+    header: typeof scrollRightHeaderRDG;
+    getCellLocator: typeof rdgGetCellLocator;
     navigation: {
         goRight: ({ root }: StrategyContext) => Promise<void>;
         goLeft: ({ root }: StrategyContext) => Promise<void>;
@@ -20,12 +26,8 @@ export declare const RDG: Partial<TableConfig> & {
     Strategies: typeof RDGStrategies;
 };
 export declare const RDG2DStrategies: {
-    viewport: ViewportStrategy;
-    header: (context: TableContext) => Promise<string[]>;
-    getCellLocator: ({ row, columnIndex }: {
-        row: Locator;
-        columnIndex: number;
-    }) => Locator;
+    header: typeof scrollRightHeaderRDG;
+    getCellLocator: typeof rdgGetCellLocator;
     navigation: {
         goRight: ({ root }: StrategyContext) => Promise<void>;
         goLeft: ({ root }: StrategyContext) => Promise<void>;
@@ -34,6 +36,7 @@ export declare const RDG2DStrategies: {
         goHome: ({ root }: StrategyContext) => Promise<void>;
     };
     pagination: import("..").PaginationPrimitives;
+    viewport: ViewportStrategy;
 };
 export declare const RDG2D: Partial<TableConfig> & {
     Strategies: typeof RDG2DStrategies;

package/dist/smartRow.js

@@ -327,7 +327,8 @@ const createSmartRow = (rowLocator, map, rowIndex, config, rootLocator, resolve,
     smart._barrier = barrier;
     // Attach Methods
     smart.getCell = (colName) => {
-        var _a, _b;
+        var _a;
+        var _b;
         if ((_a = config.syntheticColumns) === null || _a === void 0 ? void 0 : _a[colName]) {
             throw new Error(`Column "${colName}" is synthetic (no DOM cell) — use getValue("${colName}") or toJSON() instead`);
         }
@@ -393,7 +394,8 @@ const createSmartRow = (rowLocator, map, rowIndex, config, rootLocator, resolve,
         return !smart[sentinel_1.SENTINEL_ROW];
     };
     smart.getValue = async (colName) => {
-        var _a, _b, _c;
+        var _a, _b;
+        var _c;
         const syntheticDef = (_a = config.syntheticColumns) === null || _a === void 0 ? void 0 : _a[colName];
         if (syntheticDef) {
             const guardedRow = Object.create(smart);
@@ -409,9 +411,9 @@ const createSmartRow = (rowLocator, map, rowIndex, config, rootLocator, resolve,
         }
         const idx = map.get(colName);
         if (idx === undefined) {
-            throw new Error((0, stringUtils_1.buildColumnNotFoundError)(colName, [...map.keys(), ...Object.keys((_b = config.syntheticColumns) !== null && _b !== void 0 ? _b : {})]));
+            throw new Error((0, stringUtils_1.buildColumnNotFoundError)(colName, [...map.keys(), ...Object.keys((_c = config.syntheticColumns) !== null && _c !== void 0 ? _c : {})]));
         }
-        const columnOverride = (_c = config.columnOverrides) === null || _c === void 0 ? void 0 : _c[colName];
+        const columnOverride = (_b = config.columnOverrides) === null || _b === void 0 ? void 0 : _b[colName];
         const page = rootLocator.page();
         // Same nav pipeline as toJSON / getCell().bringIntoView() (#430) so virtualized
         // off-screen columns don't return empty/stale text.
@@ -441,7 +443,8 @@ const createSmartRow = (rowLocator, map, rowIndex, config, rootLocator, resolve,
         return (await cell.innerText()).trim();
     };
     smart.toJSON = async (options) => {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+        var _a, _b, _c, _d, _e, _f;
+        var _g, _h, _j;
         // Atomic mode: snapshot the row in a single evaluate, then apply column overrides
         // against a frozen reconstruction. Zero inter-column stagger — even in-place React
         // re-renders can't affect it because overrides read from a detached clone.
@@ -467,7 +470,7 @@ const createSmartRow = (rowLocator, map, rowIndex, config, rootLocator, resolve,
                             if (rResult !== undefined && (0, rowResolution_1.normalizeRowIndexResult)(rResult).index === rowIndex)
                                 return r;
                         }
-                        catch ( /* element may have detached during scan */_a) { /* element may have detached during scan */ }
+                        catch (_a) { /* element may have detached during scan */ }
                     }
                     return null;
                 }
@@ -599,7 +602,7 @@ const createSmartRow = (rowLocator, map, rowIndex, config, rootLocator, resolve,
                         result[col] = snapshot.cells[idx].text;
                     }
                 }
-                for (const [name, def] of Object.entries((_c = config.syntheticColumns) !== null && _c !== void 0 ? _c : {})) {
+                for (const [name, def] of Object.entries((_g = config.syntheticColumns) !== null && _g !== void 0 ? _g : {})) {
                     if ((options === null || options === void 0 ? void 0 : options.columns) && !options.columns.includes(name))
                         continue;
                     const snapshotRow = Object.create(smart);
@@ -698,7 +701,7 @@ const createSmartRow = (rowLocator, map, rowIndex, config, rootLocator, resolve,
             // Re-pin to the correct logical row before reading this column (#366).
             const stableRow = await resolveStableRow();
             // Check if we have a column override for this column
-            const columnOverride = (_d = config.columnOverrides) === null || _d === void 0 ? void 0 : _d[col];
+            const columnOverride = (_c = config.columnOverrides) === null || _c === void 0 ? void 0 : _c[col];
             const mapper = columnOverride === null || columnOverride === void 0 ? void 0 : columnOverride.read;
             // --- Navigation Logic Start ---
             const cell = config.strategies.getCellLocator
@@ -747,13 +750,13 @@ const createSmartRow = (rowLocator, map, rowIndex, config, rootLocator, resolve,
                 });
             }
             // Cell loading wait (if configured)
-            const isCellLoading = (_e = config.strategies.loading) === null || _e === void 0 ? void 0 : _e.isCellLoading;
-            const rawCellTimeout = (_f = config.strategies.loading) === null || _f === void 0 ? void 0 : _f.cellLoadingTimeout;
+            const isCellLoading = (_d = config.strategies.loading) === null || _d === void 0 ? void 0 : _d.isCellLoading;
+            const rawCellTimeout = (_e = config.strategies.loading) === null || _e === void 0 ? void 0 : _e.cellLoadingTimeout;
             // undefined = unset (read as-is immediately); 0 = no wait (immediate check); >0 = wait up to N ms
             const cellLoadingTimeout = rawCellTimeout !== undefined && Number.isFinite(rawCellTimeout) && rawCellTimeout >= 0
                 ? rawCellTimeout
                 : undefined;
-            const onCellLoadingTimeout = (_h = (_g = config.strategies.loading) === null || _g === void 0 ? void 0 : _g.onCellLoadingTimeout) !== null && _h !== void 0 ? _h : 'read-as-is';
+            const onCellLoadingTimeout = (_h = (_f = config.strategies.loading) === null || _f === void 0 ? void 0 : _f.onCellLoadingTimeout) !== null && _h !== void 0 ? _h : 'read-as-is';
             if (isCellLoading) {
                 let loading = await isCellLoading(targetCell, col, smart);
                 // First-paint race: the cell node can attach a tick before the loading
@@ -820,7 +823,8 @@ const createSmartRow = (rowLocator, map, rowIndex, config, rootLocator, resolve,
         return result;
     };
     smart.smartFill = async (data, fillOptions) => {
-        var _a, _b, _c;
+        var _a, _b;
+        var _c;
         (0, debugUtils_1.logDebug)(config, 'info', 'Filling row', data);
         for (const [colName, value] of Object.entries(data)) {
             if (value === undefined)
@@ -830,7 +834,7 @@ const createSmartRow = (rowLocator, map, rowIndex, config, rootLocator, resolve,
             }
             const colIdx = map.get(colName);
             if (colIdx === undefined) {
-                throw new Error((0, stringUtils_1.buildColumnNotFoundError)(colName, [...map.keys(), ...Object.keys((_b = config.syntheticColumns) !== null && _b !== void 0 ? _b : {})]));
+                throw new Error((0, stringUtils_1.buildColumnNotFoundError)(colName, [...map.keys(), ...Object.keys((_c = config.syntheticColumns) !== null && _c !== void 0 ? _c : {})]));
             }
             await _navigateToCell({
                 config,
@@ -845,7 +849,7 @@ const createSmartRow = (rowLocator, map, rowIndex, config, rootLocator, resolve,
                 renderWindowPosition,
                 barrier: smart._barrier
             });
-            const columnOverride = (_c = config.columnOverrides) === null || _c === void 0 ? void 0 : _c[colName];
+            const columnOverride = (_b = config.columnOverrides) === null || _b === void 0 ? void 0 : _b[colName];
             if (columnOverride === null || columnOverride === void 0 ? void 0 : columnOverride.write) {
                 const cellLocator = smart.getCell(colName);
                 let currentValue;

package/dist/strategies/index.d.ts

@@ -29,13 +29,13 @@ export declare const Strategies: {
         }, options?: {
             nextBulkPages?: number;
             previousBulkPages?: number;
-            numberOfPages?: number | ((root: import("@playwright/test").Locator) => number | Promise<number>);
-            detectCurrentPage?: (root: import("@playwright/test").Locator) => number | Promise<number>;
+            numberOfPages?: number | ((root: import('@playwright/test').Locator) => number | Promise<number>);
+            detectCurrentPage?: (root: import('@playwright/test').Locator) => number | Promise<number>;
             stabilization?: import("./stabilization").StabilizationStrategy;
             timeout?: number;
         }) => import("..").PaginationStrategy;
         infiniteScroll: (options?: {
-            action?: "scroll" | "js-scroll";
+            action?: 'scroll' | 'js-scroll';
             scrollTarget?: import("..").Selector;
             scrollAmount?: number;
             stabilization?: import("./stabilization").StabilizationStrategy;
@@ -81,7 +81,7 @@ export declare const Strategies: {
     };
     Stabilization: {
         contentChanged: (options?: {
-            scope?: "all" | "first";
+            scope?: 'all' | 'first';
             timeout?: number;
         }) => import("./stabilization").StabilizationStrategy;
         rowCountIncreased: (options?: {

package/dist/strategies/pagination.d.ts

@@ -19,8 +19,8 @@ export declare const PaginationStrategies: {
     }, options?: {
         nextBulkPages?: number;
         previousBulkPages?: number;
-        numberOfPages?: number | ((root: import("@playwright/test").Locator) => number | Promise<number>);
-        detectCurrentPage?: (root: import("@playwright/test").Locator) => number | Promise<number>;
+        numberOfPages?: number | ((root: import('@playwright/test').Locator) => number | Promise<number>);
+        detectCurrentPage?: (root: import('@playwright/test').Locator) => number | Promise<number>;
         stabilization?: StabilizationStrategy;
         timeout?: number;
     }) => PaginationStrategy;
@@ -36,7 +36,7 @@ export declare const PaginationStrategies: {
      *        Use `contentChanged` for virtualization.
      */
     infiniteScroll: (options?: {
-        action?: "scroll" | "js-scroll";
+        action?: 'scroll' | 'js-scroll';
         scrollTarget?: Selector;
         scrollAmount?: number;
         stabilization?: StabilizationStrategy;

package/dist/strategies/stabilization.d.ts

@@ -9,7 +9,7 @@ export declare const StabilizationStrategies: {
      * Waits for the visible text of the table rows to change.
      */
     contentChanged: (options?: {
-        scope?: "all" | "first";
+        scope?: 'all' | 'first';
         timeout?: number;
     }) => StabilizationStrategy;
     /**

package/dist/strategies/viewport.d.ts

@@ -50,6 +50,38 @@ export type DataAttributeViewportOptions = {
      */
     columnOffset?: number;
 };
+/**
+ * Viewport strategies for tables where row and cell elements carry a DOM attribute
+ * equal to their index (e.g. Braintrust logs table, TanStack-style grids).
+ *
+ * Derives selectors from the table config so no duplication is needed:
+ *   - getVisibleColumnRange — reads column attribute from cells in the first visible row
+ *   - getVisibleRowRange   — reads row attribute from all visible row elements
+ *   - scrollToColumn       — aligns header's left edge to container left, waits for cell mount
+ *   - scrollToRow          — scrolls row into view, waits for row mount
+ *
+ * **Important:** `rowAttribute` must be present on the elements matched by `rowSelector`,
+ * not on child cells. If row elements lack the attribute, `getVisibleRowRange` returns
+ * `{first:0, last:0}` and logs a warning at the `error` log level.
+ *
+ * @example
+ * // TanStack / Braintrust — pass your scroll container explicitly (no Tailwind default)
+ * viewport: Strategies.Viewport.dataAttribute({
+ *   scrollContainer: 'div[class*="overflow-auto"]',
+ * })
+ *
+ * @example
+ * // ARIA grid (aria-rowindex / aria-colindex, 1-based)
+ * viewport: Strategies.Viewport.dataAttribute({
+ *   scrollContainer: '.MuiDataGrid-virtualScroller',
+ *   rowAttribute: 'aria-rowindex',
+ *   columnAttribute: 'aria-colindex',
+ *   rowOffset: 1,
+ *   columnOffset: 1,
+ * })
+ */
+declare const dataAttribute: (options?: DataAttributeViewportOptions) => ViewportStrategy;
 export declare const ViewportStrategies: {
-    dataAttribute: (options?: DataAttributeViewportOptions) => ViewportStrategy;
+    dataAttribute: typeof dataAttribute;
 };
+export {};

package/dist/useTable.js

@@ -319,13 +319,14 @@ const useTable = (rootLocator, configOptions = {}) => {
             return resolve(config.headerSelector, rootLocator).nth(idx);
         },
         countRows: async (filters, options) => {
-            var _a, _b, _c, _d, _e;
+            var _a, _b, _c, _d;
+            var _e;
             if (tableState.empty)
                 return 0;
             await _autoInit();
             const filtersRecord = (filters !== null && filters !== void 0 ? filters : {});
             const hasFilters = Object.keys(filtersRecord).length > 0;
-            const effectiveMaxPages = (_a = options === null || options === void 0 ? void 0 : options.maxPages) !== null && _a !== void 0 ? _a : config.maxPages;
+            const effectiveMaxPages = (_e = options === null || options === void 0 ? void 0 : options.maxPages) !== null && _e !== void 0 ? _e : config.maxPages;
             const pag = config.strategies.pagination;
             const hasPagination = effectiveMaxPages > 1 && !!((pag === null || pag === void 0 ? void 0 : pag.goNext) || (pag === null || pag === void 0 ? void 0 : pag.goNextBulk));
             const domFilters = {};
@@ -333,10 +334,10 @@ const useTable = (rootLocator, configOptions = {}) => {
             const syntheticFilters = {};
             if (hasFilters) {
                 for (const [key, value] of Object.entries(filtersRecord)) {
-                    if ((_b = config.syntheticColumns) === null || _b === void 0 ? void 0 : _b[key]) {
+                    if ((_a = config.syntheticColumns) === null || _a === void 0 ? void 0 : _a[key]) {
                         syntheticFilters[key] = value;
                     }
-                    else if ((_d = (_c = config.columnOverrides) === null || _c === void 0 ? void 0 : _c[key]) === null || _d === void 0 ? void 0 : _d.read) {
+                    else if ((_c = (_b = config.columnOverrides) === null || _b === void 0 ? void 0 : _b[key]) === null || _c === void 0 ? void 0 : _c.read) {
                         overrideFilters[key] = value;
                     }
                     else {
@@ -378,7 +379,7 @@ const useTable = (rootLocator, configOptions = {}) => {
                 return count;
             };
             // Wait for table to finish loading before counting
-            const isTableLoading = (_e = config.strategies.loading) === null || _e === void 0 ? void 0 : _e.isTableLoading;
+            const isTableLoading = (_d = config.strategies.loading) === null || _d === void 0 ? void 0 : _d.isTableLoading;
             if (isTableLoading) {
                 const ctx = createStrategyContext();
                 await (0, loadingWait_1.waitWhileTableLoading)(config, ctx, rootLocator.page(), 'countRows');
@@ -597,7 +598,8 @@ const useTable = (rootLocator, configOptions = {}) => {
         },
         sorting: {
             apply: async (columnName, direction) => {
-                var _a, _b, _c, _d, _e, _f;
+                var _a, _b;
+                var _c, _d, _e, _f;
                 await _autoInit();
                 if (!config.strategies.sorting)
                     throw new Error('No sorting strategy has been configured.');
@@ -612,15 +614,15 @@ const useTable = (rootLocator, configOptions = {}) => {
                     }
                     await config.strategies.sorting.doSort({ columnName, direction, context });
                     if ((_a = config.strategies.loading) === null || _a === void 0 ? void 0 : _a.isTableLoading) {
-                        const timeout = (_c = (_b = config.strategies.loading.sortStabilizationTimeout) !== null && _b !== void 0 ? _b : config.strategies.loading.loadingTimeout) !== null && _c !== void 0 ? _c : 10000;
-                        const poll = (_d = config.strategies.loading.sortStabilizationPollInterval) !== null && _d !== void 0 ? _d : 100;
+                        const timeout = (_d = (_c = config.strategies.loading.sortStabilizationTimeout) !== null && _c !== void 0 ? _c : config.strategies.loading.loadingTimeout) !== null && _d !== void 0 ? _d : 10000;
+                        const poll = (_e = config.strategies.loading.sortStabilizationPollInterval) !== null && _e !== void 0 ? _e : 100;
                         await (0, loadingWait_1.waitWhileTableLoading)(config, context, rootLocator.page(), 'sorting.apply', {
                             timeout,
                             pollInterval: poll,
                         });
                     }
                     else {
-                        const fallback = (_f = (_e = config.strategies.loading) === null || _e === void 0 ? void 0 : _e.sortStabilizationFallbackDelay) !== null && _f !== void 0 ? _f : 200;
+                        const fallback = (_f = (_b = config.strategies.loading) === null || _b === void 0 ? void 0 : _b.sortStabilizationFallbackDelay) !== null && _f !== void 0 ? _f : 200;
                         await rootLocator.page().waitForTimeout(fallback);
                     }
                     await (0, debugUtils_1.debugDelay)(config, 'default');

package/dist/utils/debugUtils.js

@@ -8,7 +8,8 @@ exports.warnIfDebugInCI = warnIfDebugInCI;
  * Get delay for specific action type
  */
 function getDebugDelay(config, actionType) {
-    var _a, _b, _c;
+    var _a;
+    var _b, _c;
     if (!((_a = config.debug) === null || _a === void 0 ? void 0 : _a.slow))
         return 0;
     if (typeof config.debug.slow === 'number') {
@@ -29,7 +30,8 @@ async function debugDelay(config, actionType) {
  * Log debug message based on log level
  */
 function logDebug(config, level, message, data) {
-    var _a, _b;
+    var _a;
+    var _b;
     const logLevel = (_b = (_a = config.debug) === null || _a === void 0 ? void 0 : _a.logLevel) !== null && _b !== void 0 ? _b : 'none';
     const levels = { none: 0, error: 1, info: 2, verbose: 3 };
     if (levels[logLevel] >= levels[level]) {

package/dist/utils/loadingWait.js

@@ -12,7 +12,8 @@ const debugUtils_1 = require("./debugUtils");
  * 3. 10_000 ms default
  */
 async function waitWhileTableLoading(config, context, page, label, options) {
-    var _a, _b, _c, _d, _e;
+    var _a;
+    var _b, _c, _d, _e;
     const isTableLoading = (_a = config.strategies.loading) === null || _a === void 0 ? void 0 : _a.isTableLoading;
     if (!isTableLoading)
         return;

package/dist/utils/mergeTableConfig.js

@@ -22,7 +22,8 @@ exports.mergeTableConfig = mergeTableConfig;
  * });
  */
 function mergeTableConfig(base, overrides) {
-    var _a, _b, _c, _d;
+    var _a, _b;
+    var _c, _d;
     const result = Object.assign(Object.assign({}, base), overrides);
     // Deep-merge strategies one level down
     if (base.strategies || overrides.strategies) {
@@ -31,12 +32,12 @@ function mergeTableConfig(base, overrides) {
         // so that e.g. base.strategies.loading and overrides.strategies.loading are combined.
         // Function values (pagination, header, dedupe, getCellLocator, etc.) are replaced, not merged.
         const strategyKeys = new Set([
-            ...Object.keys((_a = base.strategies) !== null && _a !== void 0 ? _a : {}),
-            ...Object.keys((_b = overrides.strategies) !== null && _b !== void 0 ? _b : {}),
+            ...Object.keys((_c = base.strategies) !== null && _c !== void 0 ? _c : {}),
+            ...Object.keys((_d = overrides.strategies) !== null && _d !== void 0 ? _d : {}),
         ]);
         for (const key of strategyKeys) {
-            const baseVal = (_c = base.strategies) === null || _c === void 0 ? void 0 : _c[key];
-            const overrideVal = (_d = overrides.strategies) === null || _d === void 0 ? void 0 : _d[key];
+            const baseVal = (_a = base.strategies) === null || _a === void 0 ? void 0 : _a[key];
+            const overrideVal = (_b = overrides.strategies) === null || _b === void 0 ? void 0 : _b[key];
             if (baseVal !== undefined &&
                 overrideVal !== undefined &&
                 typeof baseVal === 'object' &&

package/dist/utils/resolveCellLocator.js

@@ -7,10 +7,11 @@ exports.resolveCellLocatorForFilter = resolveCellLocatorForFilter;
  * otherwise `cellSelector` + `.nth(columnIndex)`.
  */
 function resolveCellLocator(args) {
-    var _a, _b;
+    var _a;
+    var _b;
     const { config, resolve, row, root, columnName, columnIndex, rowIndex } = args;
-    const page = (_a = args.page) !== null && _a !== void 0 ? _a : root.page();
-    if ((_b = config.strategies) === null || _b === void 0 ? void 0 : _b.getCellLocator) {
+    const page = (_b = args.page) !== null && _b !== void 0 ? _b : root.page();
+    if ((_a = config.strategies) === null || _a === void 0 ? void 0 : _a.getCellLocator) {
         return config.strategies.getCellLocator({
             row,
             root,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rickcedwhat/playwright-smart-table",
-  "version": "6.23.1-next.e2bf5cf",
+  "version": "6.23.1-next.f369c63",
   "description": "Smart, column-aware table interactions for Playwright",
   "author": "Cedrick Catalan",
   "license": "MIT",
@@ -121,12 +121,12 @@
     "@playwright/test": "^1.59.1",
     "@stryker-mutator/core": "^9.6.0",
     "@stryker-mutator/vitest-runner": "^9.6.0",
-    "@types/node": "^25.5.2",
+    "@types/node": "^26.6.2",
     "@vitest/coverage-v8": "^3.2.6",
     "@vitest/ui": "^3.2.6",
     "happy-dom": "^20.10.6",
     "husky": "^9.1.7",
-    "typescript": "^6.0.2",
+    "typescript": "^7.0.2",
     "vitepress": "^1.6.4",
     "vitepress-plugin-tabs": "^0.9.0",
     "vitest": "^3.2.6"