@rickcedwhat/playwright-smart-table 6.16.0 → 6.17.0

package/dist/index.d.ts

@@ -5,3 +5,4 @@ export { Strategies } from './strategies';
 export * as presets from './presets';
 /** @deprecated Use `presets` instead. Plugins will be removed in v7.0.0. */
 export { Plugins } from './plugins';
+export { mergeTableConfig } from './utils/mergeTableConfig';

package/dist/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Plugins = exports.presets = exports.Strategies = exports.useTable = exports.PLAYWRIGHT_SMART_TABLE_VERSION = void 0;
+exports.mergeTableConfig = exports.Plugins = exports.presets = exports.Strategies = exports.useTable = exports.PLAYWRIGHT_SMART_TABLE_VERSION = void 0;
 var packageVersion_1 = require("./packageVersion");
 Object.defineProperty(exports, "PLAYWRIGHT_SMART_TABLE_VERSION", { enumerable: true, get: function () { return packageVersion_1.PLAYWRIGHT_SMART_TABLE_VERSION; } });
 var useTable_1 = require("./useTable");
@@ -45,3 +45,5 @@ exports.presets = __importStar(require("./presets"));
 /** @deprecated Use `presets` instead. Plugins will be removed in v7.0.0. */
 var plugins_1 = require("./plugins");
 Object.defineProperty(exports, "Plugins", { enumerable: true, get: function () { return plugins_1.Plugins; } });
+var mergeTableConfig_1 = require("./utils/mergeTableConfig");
+Object.defineProperty(exports, "mergeTableConfig", { enumerable: true, get: function () { return mergeTableConfig_1.mergeTableConfig; } });

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.16.0";
+export declare const PLAYWRIGHT_SMART_TABLE_VERSION: "6.17.0";

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.16.0";
+exports.PLAYWRIGHT_SMART_TABLE_VERSION = "6.17.0";

package/dist/presets/index.d.ts

@@ -1,4 +1,5 @@
-export { muiTable, muiDataGrid } from './mui';
+export { muiTable, muiDataGrid, createMuiTable, createMuiDataGrid } from './mui';
+export type { MuiButtonLabels } from './mui';
 export { RDG as rdg, RDG2D as rdg2D } from './rdg';
 export { Glide as glide, createGlide, createGlideViewport } from './glide';
 export type { GlideOptions, GlideViewportOptions } from './glide';

package/dist/presets/index.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createGlideViewport = exports.createGlide = exports.glide = exports.rdg2D = exports.rdg = exports.muiDataGrid = exports.muiTable = void 0;
+exports.createGlideViewport = exports.createGlide = exports.glide = exports.rdg2D = exports.rdg = exports.createMuiDataGrid = exports.createMuiTable = exports.muiDataGrid = exports.muiTable = void 0;
 var mui_1 = require("./mui");
 Object.defineProperty(exports, "muiTable", { enumerable: true, get: function () { return mui_1.muiTable; } });
 Object.defineProperty(exports, "muiDataGrid", { enumerable: true, get: function () { return mui_1.muiDataGrid; } });
+Object.defineProperty(exports, "createMuiTable", { enumerable: true, get: function () { return mui_1.createMuiTable; } });
+Object.defineProperty(exports, "createMuiDataGrid", { enumerable: true, get: function () { return mui_1.createMuiDataGrid; } });
 var rdg_1 = require("./rdg");
 Object.defineProperty(exports, "rdg", { enumerable: true, get: function () { return rdg_1.RDG; } });
 Object.defineProperty(exports, "rdg2D", { enumerable: true, get: function () { return rdg_1.RDG2D; } });

package/dist/presets/mui.d.ts

@@ -1,16 +1,28 @@
 import { TableConfig } from '../types';
+/** Aria-labels for MUI pagination buttons. Override for non-English locales. */
+export interface MuiButtonLabels {
+    nextPage?: string;
+    previousPage?: string;
+    firstPage?: string;
+}
 /**
- * Preset configuration for the standard Material UI `<Table />` component.
+ * Creates a preset configuration for the standard Material UI `<Table />` component.
  *
- * Handles:
- * - Selectors for `.MuiTableRow-root`, `.MuiTableCell-head`, etc.
- * - Pagination via the standard `.MuiTablePagination-actions` footer.
- * - Sorting via the `.MuiTableSortLabel-root` header classes.
- * - Virtualized DOM deduplication (falls back to cell text if unvirtualized).
+ * @param opts.buttonLabels - Override aria-labels for pagination buttons (use for non-English locales).
+ *
+ * @example
+ * // French locale
+ * const table = useTable(loc, createMuiTable({ buttonLabels: { nextPage: 'Page suivante', previousPage: 'Page précédente' } }));
  */
+export declare function createMuiTable(opts?: {
+    buttonLabels?: MuiButtonLabels;
+}): Partial<TableConfig>;
+/** Default preset for MUI `<Table />`. For non-English locales use `createMuiTable({ buttonLabels })`. */
 export declare const muiTable: Partial<TableConfig>;
 /**
- * Preset configuration for the MUI DataGrid component (@mui/x-data-grid).
+ * Creates a preset configuration for the MUI DataGrid component (@mui/x-data-grid).
+ *
+ * @param opts.buttonLabels - Override aria-labels for pagination buttons (use for non-English locales).
  *
  * Handles:
  * - Selectors for `.MuiDataGrid-row`, `.MuiDataGrid-cell`, and `.MuiDataGrid-columnHeader`.
@@ -19,4 +31,8 @@ export declare const muiTable: Partial<TableConfig>;
  * - Vertical Virtualization deduplication using `data-rowindex`.
  * - Horizontal Virtualization support via `aria-colindex`.
  */
+export declare function createMuiDataGrid(opts?: {
+    buttonLabels?: MuiButtonLabels;
+}): Partial<TableConfig>;
+/** Default preset for MUI DataGrid. For non-English locales use `createMuiDataGrid({ buttonLabels })`. */
 export declare const muiDataGrid: Partial<TableConfig>;

package/dist/presets/mui.js

@@ -1,7 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.muiDataGrid = exports.muiTable = void 0;
+exports.createMuiTable = createMuiTable;
+exports.createMuiDataGrid = createMuiDataGrid;
 const debugUtils_1 = require("../utils/debugUtils");
+const DEFAULT_LABELS = {
+    nextPage: 'Go to next page',
+    previousPage: 'Go to previous page',
+    firstPage: 'Go to first page',
+};
 /**
  * Safely wait for MUI pagination to stabilize.
  * Polls for displayed row text changes and waits for loading overlays to disappear.
@@ -45,120 +52,136 @@ async function getPaginationRoot(context) {
     return context.root.locator('xpath=following::div[contains(@class, "MuiTablePagination-root")][1]').first();
 }
 /**
- * Preset configuration for the standard Material UI `<Table />` component.
+ * Creates a preset configuration for the standard Material UI `<Table />` component.
  *
- * Handles:
- * - Selectors for `.MuiTableRow-root`, `.MuiTableCell-head`, etc.
- * - Pagination via the standard `.MuiTablePagination-actions` footer.
- * - Sorting via the `.MuiTableSortLabel-root` header classes.
- * - Virtualized DOM deduplication (falls back to cell text if unvirtualized).
+ * @param opts.buttonLabels - Override aria-labels for pagination buttons (use for non-English locales).
+ *
+ * @example
+ * // French locale
+ * const table = useTable(loc, createMuiTable({ buttonLabels: { nextPage: 'Page suivante', previousPage: 'Page précédente' } }));
  */
-exports.muiTable = {
-    rowSelector: 'tbody tr, tbody .MuiTableRow-root',
-    cellSelector: 'td, th, .MuiTableCell-body',
-    headerSelector: 'thead th, .MuiTableCell-head',
-    headerTransformer: ({ text }) => text.replace(/\bsorted\s+(?:ascending|descending)\b/i, '').trim(),
-    strategies: {
-        pagination: {
-            goNext: async (context) => {
-                const root = await getPaginationRoot(context);
-                const nextBtn = root.locator('button[aria-label="Go to next page"]');
-                if (await nextBtn.count() === 0 || await nextBtn.isDisabled())
-                    return false;
-                const displayedRows = root.locator('.MuiTablePagination-displayedRows');
-                const oldText = await displayedRows.innerText().catch(() => '');
-                // Force click ignores cookie banners obscuring the footer
-                await nextBtn.click({ force: true });
-                await waitForMuiPaginationStabilization(context, displayedRows, oldText);
-                return true;
-            },
-            goPrevious: async (context) => {
-                const root = await getPaginationRoot(context);
-                const prevBtn = root.locator('button[aria-label="Go to previous page"]');
-                if (await prevBtn.count() === 0 || await prevBtn.isDisabled())
-                    return false;
-                const displayedRows = root.locator('.MuiTablePagination-displayedRows');
-                const oldText = await displayedRows.innerText().catch(() => '');
-                await prevBtn.click({ force: true });
-                await waitForMuiPaginationStabilization(context, displayedRows, oldText);
-                return true;
-            },
-            goToFirst: async (context) => {
-                const root = await getPaginationRoot(context);
-                const prevBtn = root.locator('button[aria-label="Go to previous page"]');
-                const displayedRows = root.locator('.MuiTablePagination-displayedRows');
-                let clicked = false;
-                let noProgressCount = 0;
-                const NO_PROGRESS_LIMIT = 3;
-                while (await prevBtn.count() > 0 && !(await prevBtn.isDisabled())) {
+function createMuiTable(opts) {
+    const labels = Object.assign(Object.assign({}, DEFAULT_LABELS), opts === null || opts === void 0 ? void 0 : opts.buttonLabels);
+    return {
+        rowSelector: 'tbody tr, tbody .MuiTableRow-root',
+        cellSelector: 'td, th, .MuiTableCell-body',
+        headerSelector: 'thead th, .MuiTableCell-head',
+        headerTransformer: ({ text }) => text.replace(/\bsorted\s+(?:ascending|descending)\b/i, '').trim(),
+        strategies: {
+            pagination: {
+                goNext: async (context) => {
+                    const root = await getPaginationRoot(context);
+                    const nextBtn = root.getByRole('button', { name: labels.nextPage, exact: true });
+                    if (await nextBtn.count() === 0 || await nextBtn.isDisabled())
+                        return false;
+                    const displayedRows = root.locator('.MuiTablePagination-displayedRows');
                     const oldText = await displayedRows.innerText().catch(() => '');
-                    await prevBtn.click();
+                    // Force click ignores cookie banners obscuring the footer
+                    await nextBtn.click({ force: true });
                     await waitForMuiPaginationStabilization(context, displayedRows, oldText);
-                    clicked = true;
-                    const newText = await displayedRows.innerText().catch(() => '');
-                    if (newText === oldText) {
-                        noProgressCount++;
-                        if (noProgressCount >= NO_PROGRESS_LIMIT) {
-                            (0, debugUtils_1.logDebug)(context.config, 'error', `goToFirst: no pagination progress after ${NO_PROGRESS_LIMIT} consecutive clicks — aborting to avoid infinite loop`);
-                            return false;
-                        }
+                    return true;
+                },
+                goPrevious: async (context) => {
+                    const root = await getPaginationRoot(context);
+                    const prevBtn = root.getByRole('button', { name: labels.previousPage, exact: true });
+                    if (await prevBtn.count() === 0 || await prevBtn.isDisabled())
+                        return false;
+                    const displayedRows = root.locator('.MuiTablePagination-displayedRows');
+                    const oldText = await displayedRows.innerText().catch(() => '');
+                    await prevBtn.click({ force: true });
+                    await waitForMuiPaginationStabilization(context, displayedRows, oldText);
+                    return true;
+                },
+                goToFirst: async (context) => {
+                    const root = await getPaginationRoot(context);
+                    const displayedRows = root.locator('.MuiTablePagination-displayedRows');
+                    // MUI TablePagination optionally renders a "first page" button (showFirstButton prop)
+                    const firstBtn = root.getByRole('button', { name: labels.firstPage, exact: true });
+                    if (await firstBtn.count() > 0 && !(await firstBtn.isDisabled())) {
+                        const oldText = await displayedRows.innerText().catch(() => '');
+                        await firstBtn.click({ force: true });
+                        await waitForMuiPaginationStabilization(context, displayedRows, oldText);
+                        return true;
                     }
-                    else {
-                        noProgressCount = 0;
+                    // Fall back to stepping backward one page at a time
+                    const prevBtn = root.getByRole('button', { name: labels.previousPage, exact: true });
+                    let clicked = false;
+                    let noProgressCount = 0;
+                    const NO_PROGRESS_LIMIT = 3;
+                    while (await prevBtn.count() > 0 && !(await prevBtn.isDisabled())) {
+                        const oldText = await displayedRows.innerText().catch(() => '');
+                        await prevBtn.click({ force: true });
+                        await waitForMuiPaginationStabilization(context, displayedRows, oldText);
+                        clicked = true;
+                        const newText = await displayedRows.innerText().catch(() => '');
+                        if (newText === oldText) {
+                            noProgressCount++;
+                            if (noProgressCount >= NO_PROGRESS_LIMIT) {
+                                (0, debugUtils_1.logDebug)(context.config, 'error', `goToFirst: no pagination progress after ${NO_PROGRESS_LIMIT} consecutive clicks — aborting to avoid infinite loop`);
+                                return false;
+                            }
+                        }
+                        else {
+                            noProgressCount = 0;
+                        }
                     }
+                    return clicked;
                 }
-                return clicked;
-            }
-        },
-        sorting: {
-            getSortState: async ({ columnName, context }) => {
-                if (!context.getHeaderCell)
-                    return 'none';
-                const header = await context.getHeaderCell(columnName);
-                const sortLabel = header.locator('.MuiTableSortLabel-root').first();
-                if (!(await sortLabel.isVisible().catch(() => false)))
-                    return 'none';
-                const className = await sortLabel.getAttribute('class') || '';
-                if (className.includes('directionAsc'))
-                    return 'asc';
-                if (className.includes('directionDesc'))
-                    return 'desc';
-                // Often, if the label is active but lacks explicit direction classes, MUI defaults to ascending
-                if (className.includes('active'))
-                    return 'asc';
-                return 'none';
             },
-            doSort: async ({ columnName, direction, context }) => {
-                var _a, _b;
-                if (!context.getHeaderCell)
-                    return;
-                const header = await context.getHeaderCell(columnName);
-                const sortLabel = header.locator('.MuiTableSortLabel-root').first();
-                const target = await sortLabel.isVisible().catch(() => false) ? sortLabel : header;
-                let current = await ((_a = context.config.strategies.sorting) === null || _a === void 0 ? void 0 : _a.getSortState({ columnName, context })) || 'none';
-                let attempts = 0;
-                // Click until the state matches the target direction, max 3 times (none -> asc -> desc)
-                while (current !== direction && attempts < 3) {
-                    await target.click();
-                    await context.page.waitForTimeout(100);
-                    current = await ((_b = context.config.strategies.sorting) === null || _b === void 0 ? void 0 : _b.getSortState({ columnName, context })) || 'none';
-                    attempts++;
+            sorting: {
+                getSortState: async ({ columnName, context }) => {
+                    if (!context.getHeaderCell)
+                        return 'none';
+                    const header = await context.getHeaderCell(columnName);
+                    const sortLabel = header.locator('.MuiTableSortLabel-root').first();
+                    if (!(await sortLabel.isVisible().catch(() => false)))
+                        return 'none';
+                    const className = await sortLabel.getAttribute('class') || '';
+                    if (className.includes('directionAsc'))
+                        return 'asc';
+                    if (className.includes('directionDesc'))
+                        return 'desc';
+                    // Often, if the label is active but lacks explicit direction classes, MUI defaults to ascending
+                    if (className.includes('active'))
+                        return 'asc';
+                    return 'none';
+                },
+                doSort: async ({ columnName, direction, context }) => {
+                    var _a, _b;
+                    if (!context.getHeaderCell)
+                        return;
+                    const header = await context.getHeaderCell(columnName);
+                    const sortLabel = header.locator('.MuiTableSortLabel-root').first();
+                    const target = await sortLabel.isVisible().catch(() => false) ? sortLabel : header;
+                    let current = await ((_a = context.config.strategies.sorting) === null || _a === void 0 ? void 0 : _a.getSortState({ columnName, context })) || 'none';
+                    let attempts = 0;
+                    // Click until the state matches the target direction, max 3 times (none -> asc -> desc)
+                    while (current !== direction && attempts < 3) {
+                        await target.click();
+                        await context.page.waitForTimeout(100);
+                        current = await ((_b = context.config.strategies.sorting) === null || _b === void 0 ? void 0 : _b.getSortState({ columnName, context })) || 'none';
+                        attempts++;
+                    }
                 }
+            },
+            dedupe: async (row) => {
+                // MUI virtualized tables attach data-index to rows 
+                const dataIndex = await row.getAttribute('data-index');
+                if (dataIndex !== null)
+                    return dataIndex;
+                // Unvirtualized tables don't recycle nodes, but if they do duplicate, fallback to first cell's text
+                const text = await row.locator('td, th').first().innerText().catch(() => '');
+                return text || String(Math.random());
             }
-        },
-        dedupe: async (row) => {
-            // MUI virtualized tables attach data-index to rows 
-            const dataIndex = await row.getAttribute('data-index');
-            if (dataIndex !== null)
-                return dataIndex;
-            // Unvirtualized tables don't recycle nodes, but if they do duplicate, fallback to first cell's text
-            const text = await row.locator('td, th').first().innerText().catch(() => '');
-            return text || String(Math.random());
         }
-    }
-};
+    };
+}
+/** Default preset for MUI `<Table />`. For non-English locales use `createMuiTable({ buttonLabels })`. */
+exports.muiTable = createMuiTable();
 /**
- * Preset configuration for the MUI DataGrid component (@mui/x-data-grid).
+ * Creates a preset configuration for the MUI DataGrid component (@mui/x-data-grid).
+ *
+ * @param opts.buttonLabels - Override aria-labels for pagination buttons (use for non-English locales).
  *
  * Handles:
  * - Selectors for `.MuiDataGrid-row`, `.MuiDataGrid-cell`, and `.MuiDataGrid-columnHeader`.
@@ -167,184 +190,238 @@ exports.muiTable = {
  * - Vertical Virtualization deduplication using `data-rowindex`.
  * - Horizontal Virtualization support via `aria-colindex`.
  */
-exports.muiDataGrid = {
-    rowSelector: '.MuiDataGrid-row',
-    cellSelector: '.MuiDataGrid-cell',
-    headerSelector: '.MuiDataGrid-columnHeader',
-    strategies: {
-        pagination: {
-            goNext: async (context) => {
-                const footer = context.root.locator('.MuiDataGrid-footerContainer');
-                const nextBtn = footer.locator('button[aria-label="Go to next page"]');
-                try {
-                    await nextBtn.waitFor({ state: 'visible', timeout: 2000 });
-                }
-                catch (e) {
-                    return false;
+function createMuiDataGrid(opts) {
+    const labels = Object.assign(Object.assign({}, DEFAULT_LABELS), opts === null || opts === void 0 ? void 0 : opts.buttonLabels);
+    return {
+        rowSelector: '.MuiDataGrid-row',
+        cellSelector: '.MuiDataGrid-cell',
+        headerSelector: '.MuiDataGrid-columnHeader',
+        strategies: {
+            pagination: {
+                goNext: async (context) => {
+                    const footer = context.root.locator('.MuiDataGrid-footerContainer');
+                    const nextBtn = footer.getByRole('button', { name: labels.nextPage, exact: true });
+                    try {
+                        await nextBtn.waitFor({ state: 'visible', timeout: 2000 });
+                    }
+                    catch (e) {
+                        return false;
+                    }
+                    if (await nextBtn.isDisabled())
+                        return false;
+                    const displayedRows = footer.locator('.MuiTablePagination-displayedRows');
+                    const oldText = await displayedRows.innerText().catch(() => '');
+                    await nextBtn.scrollIntoViewIfNeeded().catch(() => { });
+                    await nextBtn.click({ force: true });
+                    await waitForMuiPaginationStabilization(context, displayedRows, oldText);
+                    return true;
+                },
+                goPrevious: async (context) => {
+                    const footer = context.root.locator('.MuiDataGrid-footerContainer');
+                    const prevBtn = footer.getByRole('button', { name: labels.previousPage, exact: true });
+                    try {
+                        await prevBtn.waitFor({ state: 'visible', timeout: 2000 });
+                    }
+                    catch (e) {
+                        return false;
+                    }
+                    if (await prevBtn.isDisabled())
+                        return false;
+                    const displayedRows = footer.locator('.MuiTablePagination-displayedRows');
+                    const oldText = await displayedRows.innerText().catch(() => '');
+                    await prevBtn.scrollIntoViewIfNeeded().catch(() => { });
+                    await prevBtn.click({ force: true });
+                    await waitForMuiPaginationStabilization(context, displayedRows, oldText);
+                    return true;
+                },
+                goToFirst: async (context) => {
+                    const footer = context.root.locator('.MuiDataGrid-footerContainer');
+                    const displayedRows = footer.locator('.MuiTablePagination-displayedRows');
+                    const firstBtn = footer.getByRole('button', { name: labels.firstPage, exact: true });
+                    try {
+                        await firstBtn.waitFor({ state: 'visible', timeout: 1000 });
+                        if (!(await firstBtn.isDisabled())) {
+                            const oldText = await displayedRows.innerText().catch(() => '');
+                            await firstBtn.scrollIntoViewIfNeeded().catch(() => { });
+                            await firstBtn.click({ force: true });
+                            await waitForMuiPaginationStabilization(context, displayedRows, oldText);
+                            return true;
+                        }
+                    }
+                    catch (_a) {
+                        // first-page button not present; fall back to stepping backward
+                    }
+                    const prevBtn = footer.getByRole('button', { name: labels.previousPage, exact: true });
+                    let clicked = false;
+                    let noProgressCount = 0;
+                    const NO_PROGRESS_LIMIT = 3;
+                    while (true) {
+                        try {
+                            await prevBtn.waitFor({ state: 'visible', timeout: 2000 });
+                        }
+                        catch (_b) {
+                            break;
+                        }
+                        if (await prevBtn.isDisabled())
+                            break;
+                        const oldText = await displayedRows.innerText().catch(() => '');
+                        await prevBtn.scrollIntoViewIfNeeded().catch(() => { });
+                        await prevBtn.click({ force: true });
+                        await waitForMuiPaginationStabilization(context, displayedRows, oldText);
+                        clicked = true;
+                        const newText = await displayedRows.innerText().catch(() => '');
+                        if (newText === oldText) {
+                            noProgressCount++;
+                            if (noProgressCount >= NO_PROGRESS_LIMIT) {
+                                (0, debugUtils_1.logDebug)(context.config, 'error', `goToFirst: no pagination progress after ${NO_PROGRESS_LIMIT} consecutive clicks — aborting to avoid infinite loop`);
+                                return false;
+                            }
+                        }
+                        else {
+                            noProgressCount = 0;
+                        }
+                    }
+                    return clicked;
                 }
-                if (await nextBtn.isDisabled())
-                    return false;
-                const displayedRows = footer.locator('.MuiTablePagination-displayedRows');
-                const oldText = await displayedRows.innerText().catch(() => '');
-                await nextBtn.scrollIntoViewIfNeeded().catch(() => { });
-                await nextBtn.click({ force: true });
-                await waitForMuiPaginationStabilization(context, displayedRows, oldText);
-                return true;
             },
-            goPrevious: async (context) => {
-                const footer = context.root.locator('.MuiDataGrid-footerContainer');
-                const prevBtn = footer.locator('button[aria-label="Go to previous page"]');
-                try {
-                    await prevBtn.waitFor({ state: 'visible', timeout: 2000 });
-                }
-                catch (e) {
-                    return false;
-                }
-                if (await prevBtn.isDisabled())
-                    return false;
-                const displayedRows = footer.locator('.MuiTablePagination-displayedRows');
-                const oldText = await displayedRows.innerText().catch(() => '');
-                await prevBtn.scrollIntoViewIfNeeded().catch(() => { });
-                await prevBtn.click({ force: true });
-                await waitForMuiPaginationStabilization(context, displayedRows, oldText);
-                return true;
-            }
-        },
-        sorting: {
-            getSortState: async ({ columnName, context }) => {
-                if (!context.getHeaderCell)
+            sorting: {
+                getSortState: async ({ columnName, context }) => {
+                    if (!context.getHeaderCell)
+                        return 'none';
+                    const header = await context.getHeaderCell(columnName);
+                    const sortAttr = await header.getAttribute('aria-sort');
+                    if (sortAttr === 'ascending')
+                        return 'asc';
+                    if (sortAttr === 'descending')
+                        return 'desc';
                     return 'none';
-                const header = await context.getHeaderCell(columnName);
-                const sortAttr = await header.getAttribute('aria-sort');
-                if (sortAttr === 'ascending')
-                    return 'asc';
-                if (sortAttr === 'descending')
-                    return 'desc';
-                return 'none';
-            },
-            doSort: async ({ columnName, direction, context }) => {
-                var _a, _b;
-                if (!context.getHeaderCell)
-                    return;
-                const header = await context.getHeaderCell(columnName);
-                let current = await ((_a = context.config.strategies.sorting) === null || _a === void 0 ? void 0 : _a.getSortState({ columnName, context })) || 'none';
-                let attempts = 0;
-                while (current !== direction && attempts < 3) {
-                    const clickTarget = header.locator('.MuiDataGrid-columnHeaderTitleContainer').first();
-                    if (await clickTarget.isVisible()) {
-                        await clickTarget.click({ force: true });
-                    }
-                    else {
-                        await header.click({ force: true });
+                },
+                doSort: async ({ columnName, direction, context }) => {
+                    var _a, _b;
+                    if (!context.getHeaderCell)
+                        return;
+                    const header = await context.getHeaderCell(columnName);
+                    let current = await ((_a = context.config.strategies.sorting) === null || _a === void 0 ? void 0 : _a.getSortState({ columnName, context })) || 'none';
+                    let attempts = 0;
+                    while (current !== direction && attempts < 3) {
+                        const clickTarget = header.locator('.MuiDataGrid-columnHeaderTitleContainer').first();
+                        if (await clickTarget.isVisible()) {
+                            await clickTarget.click({ force: true });
+                        }
+                        else {
+                            await header.click({ force: true });
+                        }
+                        // Wait for stabilization (using DataGrid specific overlay check inside helper)
+                        const displayedRows = context.root.locator('.MuiTablePagination-displayedRows');
+                        const text = await displayedRows.innerText().catch(() => '');
+                        await waitForMuiPaginationStabilization(context, displayedRows, text);
+                        current = await ((_b = context.config.strategies.sorting) === null || _b === void 0 ? void 0 : _b.getSortState({ columnName, context })) || 'none';
+                        attempts++;
                     }
-                    // Wait for stabilization (using DataGrid specific overlay check inside helper)
-                    const displayedRows = context.root.locator('.MuiTablePagination-displayedRows');
-                    const text = await displayedRows.innerText().catch(() => '');
-                    await waitForMuiPaginationStabilization(context, displayedRows, text);
-                    current = await ((_b = context.config.strategies.sorting) === null || _b === void 0 ? void 0 : _b.getSortState({ columnName, context })) || 'none';
-                    attempts++;
                 }
-            }
-        },
-        dedupe: async (row) => {
-            var _a;
-            // DataGrid uses data-rowindex for its own virtualization management
-            return (_a = (await row.getAttribute('data-rowindex').catch(() => null))) !== null && _a !== void 0 ? _a : '';
-        },
-        getCellLocator: ({ row, columnIndex }) => {
-            // Horizontal virtualization uses aria-colindex (1-indexed)
-            return row.locator(`[aria-colindex="${columnIndex + 1}"]`);
-        },
-        // MUI DataGrid virtualizes rows vertically (always) and columns horizontally (when
-        // columnBuffer is configured). The virtualScroller is a descendant of root, so
-        // scroll methods use querySelector rather than closest().
-        viewport: {
-            getVisibleRowRange: async ({ root, config }) => {
-                const rowSel = config.rowSelector;
-                return root.evaluate((el, rowSel) => {
-                    const indices = Array.from(el.querySelectorAll(rowSel))
-                        .map(r => Number(r.getAttribute('data-rowindex')))
-                        .filter(n => !isNaN(n));
-                    if (!indices.length)
-                        return { first: 0, last: 0 };
-                    return { first: Math.min(...indices), last: Math.max(...indices) };
-                }, rowSel);
             },
-            getVisibleColumnRange: async ({ root, config }) => {
-                const rowSel = config.rowSelector;
-                const cellSel = typeof config.cellSelector === 'string' ? config.cellSelector : '[aria-colindex]';
-                return root.evaluate((el, { rowSel, cellSel }) => {
-                    const firstRow = el.querySelector(rowSel);
-                    if (!firstRow)
-                        return { first: 0, last: 0 };
-                    const indices = Array.from(firstRow.querySelectorAll(cellSel))
-                        .map(c => Number(c.getAttribute('aria-colindex')) - 1)
-                        .filter(n => !isNaN(n));
-                    if (!indices.length)
-                        return { first: 0, last: 0 };
-                    return { first: Math.min(...indices), last: Math.max(...indices) };
-                }, { rowSel, cellSel });
+            dedupe: async (row) => {
+                var _a;
+                // DataGrid uses data-rowindex for its own virtualization management
+                return (_a = (await row.getAttribute('data-rowindex').catch(() => null))) !== null && _a !== void 0 ? _a : '';
             },
-            scrollToRow: async ({ root, config }, rowIndex) => {
-                const rowSel = config.rowSelector;
-                await root.evaluate((el, { rowSel, idx }) => {
-                    const scroller = el.querySelector('.MuiDataGrid-virtualScroller');
-                    if (!scroller)
-                        return;
-                    const row = el.querySelector(`${rowSel}[data-rowindex="${idx}"]`);
-                    if (row) {
-                        row.scrollIntoView({ block: 'nearest', inline: 'nearest' });
-                        return;
-                    }
-                    const visibleRows = Array.from(el.querySelectorAll(rowSel));
-                    const heights = visibleRows
-                        .map(visibleRow => visibleRow.getBoundingClientRect().height)
-                        .filter(height => height > 0);
-                    const estimatedHeight = heights.length
-                        ? heights.reduce((sum, height) => sum + height, 0) / heights.length
-                        : 52;
-                    scroller.scrollTop = Math.max(0, idx * estimatedHeight - 20);
-                }, { rowSel, idx: rowIndex });
-                await root.locator(`${rowSel}[data-rowindex="${rowIndex}"]`)
-                    .waitFor({ state: 'attached', timeout: 3000 });
+            getCellLocator: ({ row, columnIndex }) => {
+                // Horizontal virtualization uses aria-colindex (1-indexed)
+                return row.locator(`[aria-colindex="${columnIndex + 1}"]`);
             },
-            scrollToColumn: async ({ root, config }, colIndex) => {
-                const headerSel = typeof config.headerSelector === 'string' ? config.headerSelector : null;
-                await root.evaluate((el, { headerSel, idx }) => {
-                    // virtualScroller is a descendant — querySelector, not closest
-                    const scroller = el.querySelector('.MuiDataGrid-virtualScroller');
-                    if (!scroller || !headerSel)
-                        return;
-                    const headers = Array.from(el.querySelectorAll(headerSel));
-                    const target = headers[idx];
-                    if (!target) {
-                        const widths = headers
-                            .map(header => header.getBoundingClientRect().width)
-                            .filter(width => width > 0);
-                        const estimatedWidth = widths.length
-                            ? widths.reduce((sum, width) => sum + width, 0) / widths.length
-                            : 100;
-                        scroller.scrollLeft = Math.max(0, idx * estimatedWidth - 20);
-                        return;
-                    }
-                    const cRect = scroller.getBoundingClientRect();
-                    const tRect = target.getBoundingClientRect();
-                    if (tRect.left < cRect.left) {
-                        scroller.scrollLeft -= (cRect.left - tRect.left) + 20;
-                    }
-                    else if (tRect.right > cRect.right) {
-                        scroller.scrollLeft += (tRect.right - cRect.right) + 20;
-                    }
-                }, { headerSel, idx: colIndex });
-                await root.locator(`${config.rowSelector} [aria-colindex="${colIndex + 1}"]`)
-                    .first()
-                    .waitFor({ state: 'attached', timeout: 3000 });
+            // MUI DataGrid virtualizes rows vertically (always) and columns horizontally (when
+            // columnBuffer is configured). The virtualScroller is a descendant of root, so
+            // scroll methods use querySelector rather than closest().
+            viewport: {
+                getVisibleRowRange: async ({ root, config }) => {
+                    const rowSel = config.rowSelector;
+                    return root.evaluate((el, rowSel) => {
+                        const indices = Array.from(el.querySelectorAll(rowSel))
+                            .map(r => Number(r.getAttribute('data-rowindex')))
+                            .filter(n => !isNaN(n));
+                        if (!indices.length)
+                            return { first: 0, last: 0 };
+                        return { first: Math.min(...indices), last: Math.max(...indices) };
+                    }, rowSel);
+                },
+                getVisibleColumnRange: async ({ root, config }) => {
+                    const rowSel = config.rowSelector;
+                    const cellSel = typeof config.cellSelector === 'string' ? config.cellSelector : '[aria-colindex]';
+                    return root.evaluate((el, { rowSel, cellSel }) => {
+                        const firstRow = el.querySelector(rowSel);
+                        if (!firstRow)
+                            return { first: 0, last: 0 };
+                        const indices = Array.from(firstRow.querySelectorAll(cellSel))
+                            .map(c => Number(c.getAttribute('aria-colindex')) - 1)
+                            .filter(n => !isNaN(n));
+                        if (!indices.length)
+                            return { first: 0, last: 0 };
+                        return { first: Math.min(...indices), last: Math.max(...indices) };
+                    }, { rowSel, cellSel });
+                },
+                scrollToRow: async ({ root, config }, rowIndex) => {
+                    const rowSel = config.rowSelector;
+                    await root.evaluate((el, { rowSel, idx }) => {
+                        const scroller = el.querySelector('.MuiDataGrid-virtualScroller');
+                        if (!scroller)
+                            return;
+                        const row = el.querySelector(`${rowSel}[data-rowindex="${idx}"]`);
+                        if (row) {
+                            row.scrollIntoView({ block: 'nearest', inline: 'nearest' });
+                            return;
+                        }
+                        const visibleRows = Array.from(el.querySelectorAll(rowSel));
+                        const heights = visibleRows
+                            .map(visibleRow => visibleRow.getBoundingClientRect().height)
+                            .filter(height => height > 0);
+                        const estimatedHeight = heights.length
+                            ? heights.reduce((sum, height) => sum + height, 0) / heights.length
+                            : 52;
+                        scroller.scrollTop = Math.max(0, idx * estimatedHeight - 20);
+                    }, { rowSel, idx: rowIndex });
+                    await root.locator(`${rowSel}[data-rowindex="${rowIndex}"]`)
+                        .waitFor({ state: 'attached', timeout: 3000 });
+                },
+                scrollToColumn: async ({ root, config }, colIndex) => {
+                    const headerSel = typeof config.headerSelector === 'string' ? config.headerSelector : null;
+                    await root.evaluate((el, { headerSel, idx }) => {
+                        // virtualScroller is a descendant — querySelector, not closest
+                        const scroller = el.querySelector('.MuiDataGrid-virtualScroller');
+                        if (!scroller || !headerSel)
+                            return;
+                        const headers = Array.from(el.querySelectorAll(headerSel));
+                        const target = headers[idx];
+                        if (!target) {
+                            const widths = headers
+                                .map(header => header.getBoundingClientRect().width)
+                                .filter(width => width > 0);
+                            const estimatedWidth = widths.length
+                                ? widths.reduce((sum, width) => sum + width, 0) / widths.length
+                                : 100;
+                            scroller.scrollLeft = Math.max(0, idx * estimatedWidth - 20);
+                            return;
+                        }
+                        const cRect = scroller.getBoundingClientRect();
+                        const tRect = target.getBoundingClientRect();
+                        if (tRect.left < cRect.left) {
+                            scroller.scrollLeft -= (cRect.left - tRect.left) + 20;
+                        }
+                        else if (tRect.right > cRect.right) {
+                            scroller.scrollLeft += (tRect.right - cRect.right) + 20;
+                        }
+                    }, { headerSel, idx: colIndex });
+                    await root.locator(`${config.rowSelector} [aria-colindex="${colIndex + 1}"]`)
+                        .first()
+                        .waitFor({ state: 'attached', timeout: 3000 });
+                },
             },
-        },
-        loading: {
-            isTableLoading: async (context) => {
-                return await context.root.locator('.MuiDataGrid-overlay').isVisible().catch(() => false);
+            loading: {
+                isTableLoading: async (context) => {
+                    return await context.root.locator('.MuiDataGrid-overlay').isVisible().catch(() => false);
+                }
             }
         }
-    }
-};
+    };
+}
+/** Default preset for MUI DataGrid. For non-English locales use `createMuiDataGrid({ buttonLabels })`. */
+exports.muiDataGrid = createMuiDataGrid();

package/dist/presets/rdg.d.ts

@@ -1,14 +1,18 @@
-import { TableContext, TableConfig, ViewportStrategy } from '../types';
+import type { Locator } from '@playwright/test';
+import { TableContext, TableConfig, ViewportStrategy, StrategyContext } from '../types';
 /** Full strategies for React Data Grid. Use when you want to supply your own selectors: strategies: Plugins.RDG.Strategies */
 export declare const RDGStrategies: {
     header: (context: TableContext) => Promise<string[]>;
-    getCellLocator: ({ row, columnIndex }: any) => any;
+    getCellLocator: ({ row, columnIndex }: {
+        row: Locator;
+        columnIndex: number;
+    }) => Locator;
     navigation: {
-        goRight: ({ root, page }: any) => Promise<void>;
-        goLeft: ({ root, page }: any) => Promise<void>;
-        goDown: ({ root, page }: any) => Promise<void>;
-        goUp: ({ root, page }: any) => Promise<void>;
-        goHome: ({ root, page }: any) => Promise<void>;
+        goRight: ({ root }: StrategyContext) => Promise<void>;
+        goLeft: ({ root }: StrategyContext) => Promise<void>;
+        goDown: ({ root }: StrategyContext) => Promise<void>;
+        goUp: ({ root }: StrategyContext) => Promise<void>;
+        goHome: ({ root }: StrategyContext) => Promise<void>;
     };
     pagination: import("..").PaginationPrimitives;
 };
@@ -18,13 +22,16 @@ export declare const RDG: Partial<TableConfig> & {
 export declare const RDG2DStrategies: {
     viewport: ViewportStrategy;
     header: (context: TableContext) => Promise<string[]>;
-    getCellLocator: ({ row, columnIndex }: any) => any;
+    getCellLocator: ({ row, columnIndex }: {
+        row: Locator;
+        columnIndex: number;
+    }) => Locator;
     navigation: {
-        goRight: ({ root, page }: any) => Promise<void>;
-        goLeft: ({ root, page }: any) => Promise<void>;
-        goDown: ({ root, page }: any) => Promise<void>;
-        goUp: ({ root, page }: any) => Promise<void>;
-        goHome: ({ root, page }: any) => Promise<void>;
+        goRight: ({ root }: StrategyContext) => Promise<void>;
+        goLeft: ({ root }: StrategyContext) => Promise<void>;
+        goDown: ({ root }: StrategyContext) => Promise<void>;
+        goUp: ({ root }: StrategyContext) => Promise<void>;
+        goHome: ({ root }: StrategyContext) => Promise<void>;
     };
     pagination: import("..").PaginationPrimitives;
 };

package/dist/presets/rdg.js

@@ -54,35 +54,35 @@ const rdgPaginationStrategy = pagination_1.PaginationStrategies.infiniteScroll({
     stabilization: stabilization_1.StabilizationStrategies.contentChanged({ timeout: 5000 })
 });
 const rdgNavigation = {
-    goRight: async ({ root, page }) => {
+    goRight: async ({ root }) => {
         await root.evaluate((el) => {
             const grid = el.querySelector('[role="grid"]') || el.closest('[role="grid"]') || el;
             if (grid)
                 grid.scrollLeft += 150;
         });
     },
-    goLeft: async ({ root, page }) => {
+    goLeft: async ({ root }) => {
         await root.evaluate((el) => {
             const grid = el.querySelector('[role="grid"]') || el.closest('[role="grid"]') || el;
             if (grid)
                 grid.scrollLeft -= 150;
         });
     },
-    goDown: async ({ root, page }) => {
+    goDown: async ({ root }) => {
         await root.evaluate((el) => {
             const grid = el.querySelector('[role="grid"]') || el.closest('[role="grid"]') || el;
             if (grid)
                 grid.scrollTop += 35;
         });
     },
-    goUp: async ({ root, page }) => {
+    goUp: async ({ root }) => {
         await root.evaluate((el) => {
             const grid = el.querySelector('[role="grid"]') || el.closest('[role="grid"]') || el;
             if (grid)
                 grid.scrollTop -= 35;
         });
     },
-    goHome: async ({ root, page }) => {
+    goHome: async ({ root }) => {
         await root.evaluate((el) => {
             const grid = el.querySelector('[role="grid"]') || el.closest('[role="grid"]') || el;
             if (grid) {

package/dist/typeContext.d.ts

@@ -3,4 +3,4 @@
  * This file is generated by scripts/embed-types.mjs
  * It contains the raw text of types.ts to provide context for LLM prompts.
  */
-export declare const TYPE_CONTEXT = "\n/**\n * Flexible selector type - can be a CSS string, function returning a Locator, or Locator itself.\n * @example\n * // String selector\n * rowSelector: 'tbody tr'\n * \n * // Function selector\n * headerSelector: (root) => root.locator('[role=\"columnheader\"]')\n */\nexport type Selector = string | ((root: Locator | Page) => Locator) | ((root: Locator) => Locator);\n\n/**\n * Value used to filter rows.\n * - string/number/RegExp: filter by text content of the cell.\n * - function: filter by custom locator logic within the cell.\n * @example\n * // Text filter\n * { Name: 'John' }\n * \n * // Custom locator filter (e.g. checkbox is checked)\n * { Status: (cell) => cell.locator('input:checked') }\n */\nexport type FilterValue = string | RegExp | number | ((cell: Locator) => Locator);\n\n/**\n * Function to get a cell locator given row, column info.\n * Replaces the old cellResolver.\n */\nexport type GetCellLocatorFn = (args: {\n  row: Locator;\n  /** The root locator passed to useTable(). Useful for re-querying stale row locators. */\n  root: Locator;\n  columnName: string;\n  columnIndex: number;\n  rowIndex?: number;\n  page: Page;\n  config: FinalTableConfig<any>;\n}) => Locator;\n\n/**\n * Hook called before each cell value is read in `toJSON` (and `columnOverrides.read`).\n *\n * Use this to scroll off-screen columns into view in **horizontally** virtualized tables,\n * wait for lazy-rendered content (popovers, tooltips, async cell renderers), or perform\n * any other pre-read setup that doesn't involve Y-axis scrolling.\n *\n * ---\n *\n * **\u26A0\uFE0F Y-scroll footgun \u2014 do NOT call `scrollIntoViewIfNeeded()` on row-virtualized grids.**\n *\n * `scrollIntoViewIfNeeded` adjusts *both* scroll axes. On grids that recycle DOM nodes\n * based on the Y position (MUI DataGrid, AG Grid, react-window, etc.) calling it will\n * shift the viewport vertically, unmounting the row you are currently reading and\n * silently returning stale or empty cell values for the remainder of the row.\n *\n * Safe uses:\n * - Column-only (X-axis) virtualization where rows are always in the DOM.\n * - Calling `scrollIntoViewIfNeeded` on the **header cell** only, when that header is\n *   guaranteed not to trigger a Y-scroll (e.g. sticky header grids).\n *\n * For grids with **both** row and column virtualization, use the `viewport` strategy\n * instead \u2014 it drives explicit `scrollToRow` / `scrollToColumn` calls and is aware of\n * the virtualization lifecycle.\n *\n * @example\n * // Safe: column-only horizontal virtualization (rows always in DOM)\n * strategies: {\n *   beforeCellRead: async ({ columnName, getHeaderCell }) => {\n *     const header = await getHeaderCell(columnName);\n *     await header.scrollIntoViewIfNeeded(); // only scrolls X \u2014 rows stay mounted\n *   }\n * }\n *\n * @example\n * // Safe: wait for a lazy-rendered popover/tooltip before reading its text\n * strategies: {\n *   beforeCellRead: async ({ cell }) => {\n *     await cell.hover();\n *     await cell.page().waitForSelector('.cell-tooltip', { state: 'visible' });\n *   }\n * }\n */\nexport type BeforeCellReadFn = (args: {\n  /** The resolved cell locator */\n  cell: Locator;\n  columnName: string;\n  columnIndex: number;\n  row: Locator;\n  page: Page;\n  root: Locator;\n  /** Resolves a column name to its header cell locator */\n  getHeaderCell: (columnName: string) => Promise<Locator>;\n}) => Promise<void>;\n\n/**\n * Function to get the currently active/focused cell.\n * Returns null if no cell is active.\n */\nexport type GetActiveCellFn = (args: TableContext) => Promise<{\n  rowIndex: number;\n  columnIndex: number;\n  columnName?: string;\n  locator: Locator;\n} | null>;\n\n/**\n * Viewport oracle strategies for virtualized tables.\n *\n * These tell the library *what is currently in the DOM* rather than *how to move*.\n * When present, the cell-reading engine uses them to jump directly to a target\n * row/column instead of stepping blindly with navigation primitives.\n *\n * This is the primary fix for the 2D scroll hazard: scrolling right to bring a\n * column into view can knock rows out of the vertical viewport (and vice versa).\n * With `getVisibleRowRange` the engine detects this and calls `scrollToRow` to\n * restore the row before reading \u2014 eliminating the hazard without polling loops.\n *\n * All members are optional. Supply whichever the underlying grid exposes:\n * - Range oracles alone enable hazard detection with graceful fallback to navigation primitives.\n * - Scroll primitives alone enable direct jumps without range awareness.\n * - Both together give the most reliable, fastest path.\n *\n * @example\n * // MUI DataGrid via apiRef\n * strategies: {\n *   viewport: {\n *     getVisibleRowRange: async ({ root }) =>\n *       root.evaluate(el => {\n *         const api = (el as any).__muiDataGrid__;\n *         return { first: api.getFirstVisibleRow(), last: api.getLastVisibleRow() };\n *       }),\n *     scrollToRow: async ({ root }, rowIndex) =>\n *       root.evaluate((el, idx) =>\n *         (el as any).__muiDataGrid__.scrollToIndexes({ rowIndex: idx }), rowIndex),\n *     scrollToColumn: async ({ root }, colIndex) =>\n *       root.evaluate((el, idx) =>\n *         (el as any).__muiDataGrid__.scrollToIndexes({ colIndex: idx }), colIndex),\n *   }\n * }\n *\n * @example\n * // aria-rowindex / aria-colindex DOM fallback (works without internal API access)\n * strategies: {\n *   viewport: {\n *     getVisibleRowRange: async ({ root }) =>\n *       root.evaluate(el => {\n *         const rows = [...el.querySelectorAll('[role=\"row\"][aria-rowindex]')];\n *         const idxs = rows.map(r => Number(r.getAttribute('aria-rowindex')) - 1);\n *         return { first: Math.min(...idxs), last: Math.max(...idxs) };\n *       }),\n *   }\n * }\n */\nexport interface ViewportStrategy {\n  /**\n   * Returns the 0-based index range of rows currently rendered in the DOM.\n   * Used to detect when a target row has been scrolled out of view and needs recovery.\n   */\n  getVisibleRowRange?: (context: TableContext) => Promise<{ first: number; last: number }>;\n\n  /**\n   * Returns the 0-based index range of columns currently rendered in the DOM.\n   * Used to detect when a target column is not yet mounted before reading.\n   */\n  getVisibleColumnRange?: (context: TableContext) => Promise<{ first: number; last: number }>;\n\n  /**\n   * Scrolls or jumps directly to make a row visible by 0-based index.\n   * Replaces blind goDown()/goUp() step loops for grids that expose a scroll API.\n   */\n  scrollToRow?: (context: TableContext, rowIndex: number) => Promise<void>;\n\n  /**\n   * Scrolls or jumps directly to make a column visible by 0-based index.\n   * Replaces blind goRight()/goLeft() step loops for grids that expose a scroll API.\n   */\n  scrollToColumn?: (context: TableContext, colIndex: number) => Promise<void>;\n\n  /**\n   * When true, disables the automatic memoization of getVisibleColumnRange and\n   * getVisibleRowRange results. By default the library caches each range value and\n   * invalidates it after the corresponding scroll call, eliminating redundant DOM\n   * evaluate() round-trips between scrolls.\n   */\n  disableCache?: boolean;\n}\n\n\n/**\n * SmartCell - A Playwright Locator with table-aware methods for single-cell operations.\n * \n * Extends all standard Locator methods (click, isVisible, etc.).\n */\nexport type SmartCell = Locator & {\n  /**\n   * Scrolls/paginates to bring this specific cell into view using the configured strategies.\n   * Useful when the grid is horizontally virtualized and the column must be scrolled\n   * into view before it can be interacted with or read.\n   */\n  bringIntoView(): Promise<void>;\n};\n\n\n/**\n * SmartRow - A Playwright Locator with table-aware methods.\n * \n * Extends all standard Locator methods (click, isVisible, etc.) with table-specific functionality.\n * \n * @example\n * const row = table.getRow({ Name: 'John Doe' });\n * await row.click(); // Standard Locator method\n * const email = row.getCell('Email'); // Table-aware method\n * const data = await row.toJSON(); // Extract all row data\n * await row.smartFill({ Name: 'Jane', Status: 'Active' }); // Fill form fields\n */\nexport type SmartRow<T = any> = Locator & {\n  /** Optional row index (0-based) if known */\n  rowIndex?: number;\n\n  /** Optional page index this row was found on (0-based) */\n  tablePageIndex?: number;\n\n  /** Reference to the parent TableResult */\n  table: TableResult<T>;\n\n  /**\n   * Get a cell locator by column name.\n   * @param column - Column name (case-sensitive)\n   * @returns SmartCell (Locator + bringIntoView)\n   * @example\n   * const emailCell = row.getCell('Email');\n   * await emailCell.bringIntoView();\n   * await expect(emailCell).toHaveText('john@example.com');\n   */\n  getCell(column: string): SmartCell;\n\n  /**\n   * Extract all cell data as a key-value object.\n   * @param options - Optional configuration\n   * @param options.columns - Specific columns to extract (extracts all if not specified)\n   * @returns Promise resolving to row data\n   * @example\n   * const data = await row.toJSON();\n   * // { Name: 'John', Email: 'john@example.com', ... }\n   * \n   * const partial = await row.toJSON({ columns: ['Name', 'Email'] });\n   * // { Name: 'John', Email: 'john@example.com' }\n   */\n  toJSON(options?: { columns?: string[] }): Promise<T>;\n\n  /**\n   * Scrolls/paginates to bring this row into view.\n   * Works when row position metadata is known (e.g., from getRowByIndex, findRow,\n   * findRows, filter, or async iteration).\n   * @throws Error if row position metadata is unknown\n   */\n  bringIntoView(): Promise<void>;\n\n  /**\n   * Intelligently fills form fields in the row.\n   * Automatically detects input types (text, select, checkbox, contenteditable).\n   * \n   * @param data - Column-value pairs to fill\n   * @param options - Optional configuration\n   * @param options.inputMappers - Custom input selectors per column\n   * @example\n   * // Auto-detection\n   * await row.smartFill({ Name: 'John', Status: 'Active', Subscribe: true });\n   * \n   * // Custom input mappers\n   * await row.smartFill(\n   *   { Name: 'John' },\n   *   { inputMappers: { Name: (cell) => cell.locator('.custom-input') } }\n   * );\n   */\n  smartFill: (data: Partial<T> | Record<string, any>, options?: FillOptions) => Promise<void>;\n\n  /**\n   * Returns whether the row exists in the DOM (i.e. is not a sentinel row).\n   */\n  wasFound(): boolean;\n};\n\nexport type StrategyContext = TableContext & {\n  rowLocator?: Locator;\n  rowIndex?: number;\n};\n\n/**\n * Defines the contract for a sorting strategy.\n */\nexport interface SortingStrategy {\n  /**\n   * Performs the sort action on a column.\n   */\n  doSort(options: {\n    columnName: string;\n    direction: 'asc' | 'desc';\n    context: StrategyContext;\n  }): Promise<void>;\n\n  /**\n   * Retrieves the current sort state of a column.\n   */\n  getSortState(options: {\n    columnName: string;\n    context: StrategyContext;\n  }): Promise<'asc' | 'desc' | 'none'>;\n}\n\n/**\n * Debug configuration for development and troubleshooting\n */\nexport type DebugConfig = {\n  /**\n   * Slow down operations for debugging\n   * - number: Apply same delay to all operations (ms)\n   * - object: Granular delays per operation type\n   */\n  slow?: number | {\n    pagination?: number;\n    getCell?: number;\n    findRow?: number;\n    default?: number;\n  };\n  /**\n   * Log level for debug output\n   * - 'verbose': All logs (verbose, info, error)\n   * - 'info': Info and error logs only\n   * - 'error': Error logs only\n   * - 'none': No logs\n   */\n  logLevel?: 'verbose' | 'info' | 'error' | 'none';\n};\n\nexport interface TableContext<T = any> {\n  root: Locator;\n  config: FinalTableConfig<T>;\n  page: Page;\n  resolve: (selector: Selector, parent: Locator | Page) => Locator;\n  /** Resolves a column name to its header cell locator. Available after table is initialized. */\n  getHeaderCell?: (columnName: string) => Promise<Locator>;\n  /** Returns all column names in order. Available after table is initialized. */\n  getHeaders?: () => Promise<string[]>;\n  /** Scrolls the table horizontally to bring the given column's header into view. */\n  scrollToColumn?: (columnName: string) => Promise<void>;\n}\n\nexport interface PaginationPrimitives {\n  /** Classic \"Next Page\" or \"Scroll Down\" */\n  goNext?: (context: TableContext) => Promise<boolean>;\n\n  /** Classic \"Previous Page\" or \"Scroll Up\" */\n  goPrevious?: (context: TableContext) => Promise<boolean>;\n\n  /** Bulk skip forward multiple pages at once. Returns number of pages skipped. */\n  goNextBulk?: (context: TableContext) => Promise<boolean | number>;\n\n  /** Bulk skip backward multiple pages at once. Returns number of pages skipped. */\n  goPreviousBulk?: (context: TableContext) => Promise<boolean | number>;\n\n  /** Jump to first page / scroll to top */\n  goToFirst?: (context: TableContext) => Promise<boolean>;\n\n  /** Jump to last page / scroll to bottom */\n  goToLast?: (context: TableContext) => Promise<boolean>;\n\n  /**\n   * Fetch the total number of pages currently available.\n   * Can be used to optimize pagination paths (e.g. jumping to last page and going backwards).\n   */\n  getTotalPages?: (context: TableContext) => Promise<number | null>;\n\n  /**\n   * Jump to specific page index (0-indexed).\n   * Can be full-range (e.g. page number input: any page works) or windowed (e.g. only visible links 6\u201314).\n   * Return false when the page is not reachable in the current UI; the library will step toward the target (goNextBulk/goNext or goPreviousBulk/goPrevious) and retry goToPage until it succeeds.\n   */\n  goToPage?: (pageIndex: number, context: TableContext) => Promise<boolean>;\n\n  /** How many pages one goNextBulk() advances. Used by navigation path planner for optimal bringIntoView. */\n  nextBulkPages?: number;\n\n  /** How many pages one goPreviousBulk() goes back. Used by navigation path planner for optimal bringIntoView. */\n  previousBulkPages?: number;\n\n  /**\n   * Called once during init() to sync the library's page counter with the actual DOM state.\n   * Use when a table may open on a page other than the first (e.g. a deep-linked URL that\n   * lands on page 5). Returns a 0-indexed page number.\n   * @example\n   * detectCurrentPage: async (root) => {\n   *   const text = await root.locator('[aria-current=\"page\"]').textContent();\n   *   return parseInt(text ?? '1') - 1;\n   * }\n   */\n  detectCurrentPage?: (root: import('@playwright/test').Locator) => number | Promise<number>;\n}\n\nexport type PaginationStrategy = PaginationPrimitives;\n\nexport type DedupeStrategy = (row: SmartRow) => string | number | Promise<string | number>;\n\n\n\nexport type FillStrategy = (options: {\n  row: SmartRow;\n  columnName: string;\n  value: any;\n  index: number;\n  page: Page;\n  rootLocator: Locator;\n  config: FinalTableConfig<any>;\n  table: TableResult; // The parent table instance\n  fillOptions?: FillOptions;\n}) => Promise<void>;\n\nexport interface ColumnOverride<TValue = any> {\n  /** \n   * How to extract the value from the cell.\n   * `context` provides access to the parent row, permitting multi-cell logic or bypassing the default cell locator.\n   */\n  read?: (cell: Locator) => Promise<TValue> | TValue;\n\n  /** \n   * How to fill the cell with a new value. (Replaces smartFill default logic)\n   * Provides the current value (via `read`) if a `write` wants to check state first.\n   */\n  write?: (params: {\n    cell: Locator;\n    targetValue: TValue;\n    currentValue?: TValue;\n    row: SmartRow<any>;\n  }) => Promise<void>;\n}\n\nexport type { HeaderStrategy } from './strategies/headers';\n\n/**\n * Strategy to resolve column names (string or regex) to their index.\n */\n// fallow-ignore-next-line unused-type\nexport type { ColumnResolutionStrategy } from './strategies/resolution';\n\n/**\n * Strategy to filter rows based on criteria. Applied when using getRow/findRow/findRows with filters.\n * The default engine handles string, RegExp, number, and function (cell) => Locator filters.\n */\nexport interface FilterStrategy {\n  apply(options: {\n    rows: Locator;\n    filter: { column: string, value: FilterValue };\n    colIndex: number;\n    tableContext: TableContext;\n  }): Locator;\n}\n\n/**\n * Strategy to check if the table or rows are loading. Used after pagination/sort to wait for content.\n * E.g. isHeaderLoading for init stability; isTableLoading after sort/pagination.\n */\nexport interface LoadingStrategy {\n  isTableLoading?: (context: TableContext) => Promise<boolean>;\n  isRowLoading?: (row: SmartRow) => Promise<boolean>;\n  isHeaderLoading?: (context: TableContext) => Promise<boolean>;\n\n  /**\n   * How long (ms) to wait for a loading row to resolve before applying onRowLoadingTimeout.\n   * When not set, loading rows are immediately skipped (backward-compatible behavior).\n   */\n  rowLoadingTimeout?: number;\n\n  /**\n   * What to do when a row is still loading after rowLoadingTimeout ms.\n   * - 'skip': drop the row from results (matches legacy skip behavior)\n   * - 'read-as-is': include the row even though it's still loading (default)\n   * - 'throw': throw an error with row index and timeout info\n   * Defaults to 'read-as-is' when rowLoadingTimeout is set.\n   */\n  onRowLoadingTimeout?: 'skip' | 'read-as-is' | 'throw';\n\n  /**\n   * Predicate called before reading each cell. Return true if the cell is still loading.\n   * When cellLoadingTimeout is also set, the engine waits up to that many ms for the\n   * cell to resolve before applying onCellLoadingTimeout.\n   */\n  isCellLoading?: (cell: import('@playwright/test').Locator, columnName: string, row: SmartRow) => Promise<boolean>;\n\n  /**\n   * How long (ms) to wait for a loading cell to resolve before applying onCellLoadingTimeout.\n   * When not set and isCellLoading returns true, the cell is read as-is immediately.\n   */\n  cellLoadingTimeout?: number;\n\n  /**\n   * What to do when a cell is still loading after cellLoadingTimeout ms.\n   * - 'skip': use empty string for this cell value\n   * - 'read-as-is': read the cell content even though it's still loading (default)\n   * - 'throw': throw an error with column name, row index and timeout info\n   * - callback: called with (cell, columnName, row); its return value becomes the cell's string value\n   * Defaults to 'read-as-is' when cellLoadingTimeout is set.\n   */\n  onCellLoadingTimeout?:\n    | 'skip'\n    | 'read-as-is'\n    | 'throw'\n    | ((cell: import('@playwright/test').Locator, columnName: string, row: SmartRow) => Promise<string>);\n}\n\n/**\n * Organized container for all table interaction strategies.\n */\nexport interface TableStrategies {\n  /** Strategy for discovering/scanning headers */\n  header?: HeaderStrategy;\n  /** Primitive navigation functions (goUp, goDown, goLeft, goRight, goHome) */\n  navigation?: NavigationPrimitives;\n\n  /** Strategy for filling form inputs */\n  fill?: FillStrategy;\n  /** Strategy for paginating through data */\n  pagination?: PaginationStrategy;\n  /** Strategy for sorting columns */\n  sorting?: SortingStrategy;\n  /** Strategy for deduplicating rows during iteration/scrolling */\n  dedupe?: DedupeStrategy;\n  /** Function to get a cell locator */\n  getCellLocator?: GetCellLocatorFn;\n  /** Function to get the currently active/focused cell */\n  getActiveCell?: GetActiveCellFn;\n  /**\n   * Strategy for filtering rows. If present, FilterEngine will delegate filter application\n   * to this pluggable strategy.\n   */\n  filter?: FilterStrategy;\n  /**\n   * Hook called before each cell value is read in toJSON and columnOverrides.read.\n   * Fires for both the default innerText extraction and custom read mappers.\n   * Useful for scrolling off-screen columns into view in horizontally virtualized tables.\n   */\n  beforeCellRead?: BeforeCellReadFn;\n  /**\n   * Strategy for detecting loading states. Use this for table-, row-, and header-level readiness.\n   * E.g. after sort/pagination, the engine uses loading.isTableLoading when present.\n   */\n  loading?: LoadingStrategy;\n\n  /**\n   * Viewport oracle strategies for 2D virtualized tables (e.g. MUI DataGrid, AG Grid,\n   * Braintrust-style grids where both rows and columns are virtualized simultaneously).\n   *\n   * When present, the cell-reading engine uses these to jump directly to the target\n   * row/column and to detect the 2D scroll hazard (scrolling to reveal a column can\n   * knock rows out of the vertical viewport, and vice versa).\n   *\n   * Completely optional and additive \u2014 existing `navigation` primitives remain the fallback.\n   */\n  viewport?: ViewportStrategy;\n}\n\n\nexport interface TableConfig<T = any> {\n  /** Selector for the table headers */\n  headerSelector?: string | ((root: Locator) => Locator);\n  /** Selector for the table rows */\n  rowSelector?: string;\n  /** Selector for the cells within a row */\n  cellSelector?: string | ((row: Locator) => Locator);\n  /** Number of pages to scan for verification */\n  maxPages?: number;\n  /**\n   * Default concurrency strategy for iteration methods.\n   * Can be overridden by the options passed to forEach, map, or filter.\n   */\n  concurrency?: RowIterationMode;\n  /** Hook to rename columns dynamically */\n  headerTransformer?: (args: { text: string, index: number, locator: Locator, seenHeaders: Set<string> }) => string | Promise<string>;\n  /** Automatically scroll to table on init */\n  autoScroll?: boolean;\n  /** Debug options for development and troubleshooting */\n  debug?: DebugConfig;\n  /** Reset hook */\n  onReset?: (context: TableContext) => Promise<void>;\n  /** All interaction strategies */\n  strategies?: TableStrategies;\n\n  /**\n   * Unified interface for reading and writing data to specific columns.\n   * Overrides both default extraction (toJSON) and filling (smartFill) logic.\n   */\n  columnOverrides?: Partial<Record<keyof T, ColumnOverride<T[keyof T]>>>;\n}\n\nexport interface FinalTableConfig<T = any> extends TableConfig<T> {\n  headerSelector: string | ((root: Locator) => Locator);\n  rowSelector: string;\n  cellSelector: string | ((row: Locator) => Locator);\n  maxPages: number;\n  autoScroll: boolean;\n  concurrency?: RowIterationMode;\n  debug?: TableConfig['debug'];\n  headerTransformer: (args: { text: string, index: number, locator: Locator, seenHeaders: Set<string> }) => string | Promise<string>;\n  onReset: (context: TableContext) => Promise<void>;\n  strategies: TableStrategies;\n}\n\n\nexport interface FillOptions {\n  /**\n   * Custom input mappers for specific columns.\n   * Maps column names to functions that return the input locator for that cell.\n   */\n  inputMappers?: Record<string, (cell: Locator) => Locator>;\n}\n\n\n\n/** Callback context passed to forEach, map, and filter. */\nexport type RowIterationContext<T = any> = {\n  row: SmartRow<T>;\n  /** 0-based iteration counter \u2014 the order this row was visited, not its DOM position or grid identity. @deprecated Use `index` instead. `rowIndex` will be removed in v7.0.0. */\n  rowIndex: number;\n  /** 0-based iteration counter \u2014 the order this row was visited, not its DOM position or grid identity. */\n  index: number;\n  /** 0-based page index \u2014 which page this row was collected from. */\n  pageIndex: number;\n  stop: () => void;\n};\n\n/** Concurrency modes for row iteration. */\nexport type RowIterationMode = 'parallel' | 'sequential' | 'synchronized';\n\n/** Shared options for forEach, map, and filter. */\nexport type RowIterationOptions = {\n  /** Maximum number of pages to iterate. Defaults to config.maxPages. */\n  maxPages?: number;\n  /**\n   * Concurrency strategy for iteration.\n   * - 'parallel': Full parallel execution of both navigation and actions.\n   * - 'synchronized': Parallel navigation (lock-step) with serial actions.\n   * - 'sequential': Strictly serial one-at-a-time execution. No parallel navigation.\n   * @default 'parallel' (for map), 'sequential' (for forEach/filter)\n   */\n  concurrency?: RowIterationMode;\n  /**\n   * Deduplication strategy. Use when rows may repeat across iterations\n   * (e.g. infinite scroll tables). Returns a unique key per row.\n   */\n  dedupe?: DedupeStrategy;\n  /**\n   * When true, use goNextBulk (if present) to advance pages during iteration.\n   * @default false \u2014 uses goNext for one-page-at-a-time advancement\n   */\n  useBulkPagination?: boolean;\n};\n\nexport interface TableResult<T = any> extends AsyncIterable<{ row: SmartRow<T>; rowIndex: number; index: number; pageIndex: number }> {\n  /**\n   * Represents the current page index of the table's DOM.\n   * Starts at 0. Automatically maintained by the library during pagination and bringIntoView.\n   */\n  currentPageIndex: number;\n\n  /**\n   * Initializes the table by resolving headers. Must be called before using sync methods.\n   * @param options Optional timeout for header resolution (default: 3000ms)\n   */\n  init(options?: { timeout?: number }): Promise<TableResult<T>>;\n\n  /**\n   * SYNC: Checks if the table has been initialized.\n   * @returns true if init() has been called and completed, false otherwise\n   */\n  isInitialized(): boolean;\n\n  getHeaders: () => Promise<string[]>;\n  getHeaderCell: (columnName: string) => Promise<Locator>;\n\n  /**\n   * Finds a row by filters on the current page only. Returns immediately (sync).\n   * Throws error if table is not initialized.\n   * @note The returned SmartRow may have `rowIndex` as 0 when the match is not the first row.\n   * Use getRowByIndex(index) when you need a known index (e.g. for bringIntoView()).\n   */\n  getRow: (\n    filters: Record<string, FilterValue>,\n    options?: { exact?: boolean }\n  ) => SmartRow<T>;\n\n  /**\n   * Gets a row by 0-based index on the current page.\n   * Throws error if table is not initialized.\n   * @param index 0-based row index\n   */\n  getRowByIndex: (\n    index: number\n  ) => SmartRow<T>;\n\n  /**\n   * ASYNC: Searches for a single row across pages using pagination.\n   * Auto-initializes the table if not already initialized.\n   * @param filters - The filter criteria to match\n   * @param options - Search options including exact match and max pages\n   */\n  findRow: (\n    filters: Record<string, FilterValue>,\n    options?: { exact?: boolean, maxPages?: number }\n  ) => Promise<SmartRow<T>>;\n\n  /**\n   * ASYNC: Searches for all matching rows across pages using pagination.\n   * Auto-initializes the table if not already initialized.\n   * @param filters - The filter criteria to match (omit or pass {} for all rows)\n   * @param options - Search options including exact match and max pages\n   */\n  findRows: (\n    filters?: Record<string, FilterValue>,\n    options?: { exact?: boolean, maxPages?: number, useBulkPagination?: boolean }\n  ) => Promise<SmartRowArray<T>>;\n\n  /**\n   * Navigates to a specific column using the configured CellNavigationStrategy.\n   */\n  scrollToColumn: (columnName: string) => Promise<void>;\n\n  /**\n   * Counts the number of rows currently on the page.\n   * Does not paginate.\n   */\n  countRows: () => Promise<number>;\n\n  /**\n   * Iterates over rows and extracts the value of a single column.\n   * More efficient than map + toJSON for single-column extraction.\n   * @param columnName - The name of the column to extract\n   * @param options - Iteration options\n   */\n  mapColumn<R = string>(columnName: string, options?: RowIterationOptions): Promise<R[]>;\n\n  /**\n   * Iterates over rows and extracts the value of a single column as strings.\n   * @param columnName - The name of the column to extract\n   * @param options - Iteration options\n   */\n  getColumnValues(columnName: string, options?: RowIterationOptions): Promise<string[]>;\n\n\n  /**\n   * Resets the table state (clears cache, flags) and invokes the onReset strategy.\n   */\n  reset: () => Promise<void>;\n\n  /**\n   * Revalidates the table's structure (headers, columns) without resetting pagination or state.\n   * Useful when columns change visibility or order dynamically.\n   */\n  revalidate: () => Promise<void>;\n\n  /**\n   * Iterates every row across all pages, calling the callback for side effects.\n   * Execution is sequential by default (safe for interactions like clicking/filling).\n   * Call `stop()` in the callback to end iteration early.\n   *\n   * @param callback - Function receiving { row, rowIndex, stop }\n   * @param options - maxPages, concurrency, dedupe, useBulkPagination\n   *\n   * @example\n   * await table.forEach(async ({ row, stop }) => {\n   *   if (await row.getCell('Status').innerText() === 'Done') stop();\n   *   await row.getCell('Checkbox').click();\n   * });\n   */\n  forEach(\n    callback: (ctx: RowIterationContext<T>) => void | Promise<void>,\n    options?: RowIterationOptions\n  ): Promise<void>;\n\n  /**\n   * Transforms every row across all pages into a value. Returns a flat array.\n   * Execution is parallel within each page by default (safe for reads).\n   * Call `stop()` to halt after the current page finishes.\n   *\n   * > **\u26A0\uFE0F UI Interactions:** `map` defaults to `concurrency: 'parallel'`. If your callback opens popovers,\n   * > fills inputs, or otherwise mutates UI state, pass `concurrency: 'sequential'` (or `'synchronized'`\n   * > when navigation must stay lock-step) to avoid overlapping interactions.\n   *\n   * @param callback - Function receiving { row, rowIndex, stop }\n   * @param options - maxPages, concurrency, dedupe, useBulkPagination\n   *\n   * @example\n   * // Data extraction \u2014 parallel is safe\n   * const emails = await table.map(({ row }) => row.getCell('Email').innerText());\n   *\n   * @example\n   * // UI interactions \u2014 use sequential (or synchronized) concurrency\n   * const assignees = await table.map(async ({ row }) => {\n   *   await row.getCell('Assignee').locator('button').click();\n   *   const name = await page.locator('.popover .name').innerText();\n   *   await page.keyboard.press('Escape');\n   *   return name;\n   * }, { concurrency: 'sequential' });\n   */\n  map<R>(\n    callback: (ctx: RowIterationContext<T>) => R | Promise<R>,\n    options?: RowIterationOptions\n  ): Promise<R[]>;\n\n  /**\n   * Filters rows across all pages by an async predicate. Returns a SmartRowArray.\n   * Rows are returned as-is \u2014 call `bringIntoView()` on each if needed.\n   * Execution is sequential by default.\n   *\n   * @param predicate - Function receiving { row, rowIndex, stop }\n   * @param options - maxPages, concurrency, dedupe, useBulkPagination\n   *\n   * @example\n   * const active = await table.filter(async ({ row }) =>\n   *   await row.getCell('Status').innerText() === 'Active'\n   * );\n   */\n  filter(\n    predicate: (ctx: RowIterationContext<T>) => boolean | Promise<boolean>,\n    options?: RowIterationOptions\n  ): Promise<SmartRowArray<T>>;\n\n  /**\n   * Provides access to sorting actions and assertions.\n   */\n  sorting: {\n    /**\n     * Applies the configured sorting strategy to the specified column.\n     * @param columnName The name of the column to sort.\n     * @param direction The direction to sort ('asc' or 'desc').\n     */\n    apply(columnName: string, direction: 'asc' | 'desc'): Promise<void>;\n    /**\n     * Gets the current sort state of a column using the configured sorting strategy.\n     * @param columnName The name of the column to check.\n     * @returns A promise that resolves to 'asc', 'desc', or 'none'.\n     */\n    getState(columnName: string): Promise<'asc' | 'desc' | 'none'>;\n  };\n\n  /**\n   * Generate an AI-friendly configuration prompt for debugging.\n   * Outputs table HTML and TypeScript definitions to help AI assistants generate config.\n   * Automatically throws an Error containing the prompt.\n   */\n  generateConfig: () => Promise<void>;\n\n  /**\n   * @deprecated Use `generateConfig()` instead. Will be removed in v7.0.0.\n   */\n  generateConfigPrompt: () => Promise<void>;\n}\n";
+export declare const TYPE_CONTEXT = "\n/**\n * Flexible selector type - can be a CSS string, function returning a Locator, or Locator itself.\n * @example\n * // String selector\n * rowSelector: 'tbody tr'\n * \n * // Function selector\n * headerSelector: (root) => root.locator('[role=\"columnheader\"]')\n */\nexport type Selector = string | ((root: Locator | Page) => Locator) | ((root: Locator) => Locator);\n\n/**\n * Value used to filter rows.\n * - string/number/RegExp: filter by text content of the cell.\n * - function: filter by custom locator logic within the cell.\n * @example\n * // Text filter\n * { Name: 'John' }\n * \n * // Custom locator filter (e.g. checkbox is checked)\n * { Status: (cell) => cell.locator('input:checked') }\n */\nexport type FilterValue = string | RegExp | number | ((cell: Locator) => Locator);\n\n/**\n * Function to get a cell locator given row, column info.\n * Replaces the old cellResolver.\n */\nexport type GetCellLocatorFn = (args: {\n  row: Locator;\n  /** The root locator passed to useTable(). Useful for re-querying stale row locators. */\n  root: Locator;\n  columnName: string;\n  columnIndex: number;\n  rowIndex?: number;\n  page: Page;\n  config: FinalTableConfig<any>;\n}) => Locator;\n\n/**\n * Hook called before each cell value is read in `toJSON` (and `columnOverrides.read`).\n *\n * Use this to scroll off-screen columns into view in **horizontally** virtualized tables,\n * wait for lazy-rendered content (popovers, tooltips, async cell renderers), or perform\n * any other pre-read setup that doesn't involve Y-axis scrolling.\n *\n * ---\n *\n * **\u26A0\uFE0F Y-scroll footgun \u2014 do NOT call `scrollIntoViewIfNeeded()` on row-virtualized grids.**\n *\n * `scrollIntoViewIfNeeded` adjusts *both* scroll axes. On grids that recycle DOM nodes\n * based on the Y position (MUI DataGrid, AG Grid, react-window, etc.) calling it will\n * shift the viewport vertically, unmounting the row you are currently reading and\n * silently returning stale or empty cell values for the remainder of the row.\n *\n * Safe uses:\n * - Column-only (X-axis) virtualization where rows are always in the DOM.\n * - Calling `scrollIntoViewIfNeeded` on the **header cell** only, when that header is\n *   guaranteed not to trigger a Y-scroll (e.g. sticky header grids).\n *\n * For grids with **both** row and column virtualization, use the `viewport` strategy\n * instead \u2014 it drives explicit `scrollToRow` / `scrollToColumn` calls and is aware of\n * the virtualization lifecycle.\n *\n * @example\n * // Safe: column-only horizontal virtualization (rows always in DOM)\n * strategies: {\n *   beforeCellRead: async ({ columnName, getHeaderCell }) => {\n *     const header = await getHeaderCell(columnName);\n *     await header.scrollIntoViewIfNeeded(); // only scrolls X \u2014 rows stay mounted\n *   }\n * }\n *\n * @example\n * // Safe: wait for a lazy-rendered popover/tooltip before reading its text\n * strategies: {\n *   beforeCellRead: async ({ cell }) => {\n *     await cell.hover();\n *     await cell.page().waitForSelector('.cell-tooltip', { state: 'visible' });\n *   }\n * }\n */\nexport type BeforeCellReadFn = (args: {\n  /** The resolved cell locator */\n  cell: Locator;\n  columnName: string;\n  columnIndex: number;\n  row: Locator;\n  page: Page;\n  root: Locator;\n  /** Resolves a column name to its header cell locator */\n  getHeaderCell: (columnName: string) => Promise<Locator>;\n}) => Promise<void>;\n\n/**\n * Function to get the currently active/focused cell.\n * Returns null if no cell is active.\n */\nexport type GetActiveCellFn = (args: TableContext) => Promise<{\n  rowIndex: number;\n  columnIndex: number;\n  columnName?: string;\n  locator: Locator;\n} | null>;\n\n/**\n * Viewport oracle strategies for virtualized tables.\n *\n * These tell the library *what is currently in the DOM* rather than *how to move*.\n * When present, the cell-reading engine uses them to jump directly to a target\n * row/column instead of stepping blindly with navigation primitives.\n *\n * This is the primary fix for the 2D scroll hazard: scrolling right to bring a\n * column into view can knock rows out of the vertical viewport (and vice versa).\n * With `getVisibleRowRange` the engine detects this and calls `scrollToRow` to\n * restore the row before reading \u2014 eliminating the hazard without polling loops.\n *\n * All members are optional. Supply whichever the underlying grid exposes:\n * - Range oracles alone enable hazard detection with graceful fallback to navigation primitives.\n * - Scroll primitives alone enable direct jumps without range awareness.\n * - Both together give the most reliable, fastest path.\n *\n * @example\n * // MUI DataGrid via apiRef\n * strategies: {\n *   viewport: {\n *     getVisibleRowRange: async ({ root }) =>\n *       root.evaluate(el => {\n *         const api = (el as any).__muiDataGrid__;\n *         return { first: api.getFirstVisibleRow(), last: api.getLastVisibleRow() };\n *       }),\n *     scrollToRow: async ({ root }, rowIndex) =>\n *       root.evaluate((el, idx) =>\n *         (el as any).__muiDataGrid__.scrollToIndexes({ rowIndex: idx }), rowIndex),\n *     scrollToColumn: async ({ root }, colIndex) =>\n *       root.evaluate((el, idx) =>\n *         (el as any).__muiDataGrid__.scrollToIndexes({ colIndex: idx }), colIndex),\n *   }\n * }\n *\n * @example\n * // aria-rowindex / aria-colindex DOM fallback (works without internal API access)\n * strategies: {\n *   viewport: {\n *     getVisibleRowRange: async ({ root }) =>\n *       root.evaluate(el => {\n *         const rows = [...el.querySelectorAll('[role=\"row\"][aria-rowindex]')];\n *         const idxs = rows.map(r => Number(r.getAttribute('aria-rowindex')) - 1);\n *         return { first: Math.min(...idxs), last: Math.max(...idxs) };\n *       }),\n *   }\n * }\n */\nexport interface ViewportStrategy {\n  /**\n   * Returns the 0-based index range of rows currently rendered in the DOM.\n   * Used to detect when a target row has been scrolled out of view and needs recovery.\n   */\n  getVisibleRowRange?: (context: TableContext) => Promise<{ first: number; last: number }>;\n\n  /**\n   * Returns the 0-based index range of columns currently rendered in the DOM.\n   * Used to detect when a target column is not yet mounted before reading.\n   */\n  getVisibleColumnRange?: (context: TableContext) => Promise<{ first: number; last: number }>;\n\n  /**\n   * Scrolls or jumps directly to make a row visible by 0-based index.\n   * Replaces blind goDown()/goUp() step loops for grids that expose a scroll API.\n   */\n  scrollToRow?: (context: TableContext, rowIndex: number) => Promise<void>;\n\n  /**\n   * Scrolls or jumps directly to make a column visible by 0-based index.\n   * Replaces blind goRight()/goLeft() step loops for grids that expose a scroll API.\n   */\n  scrollToColumn?: (context: TableContext, colIndex: number) => Promise<void>;\n\n  /**\n   * When true, disables the automatic memoization of getVisibleColumnRange and\n   * getVisibleRowRange results. By default the library caches each range value and\n   * invalidates it after the corresponding scroll call, eliminating redundant DOM\n   * evaluate() round-trips between scrolls.\n   */\n  disableCache?: boolean;\n}\n\n\n/**\n * SmartCell - A Playwright Locator with table-aware methods for single-cell operations.\n * \n * Extends all standard Locator methods (click, isVisible, etc.).\n */\nexport type SmartCell = Locator & {\n  /**\n   * Scrolls/paginates to bring this specific cell into view using the configured strategies.\n   * Useful when the grid is horizontally virtualized and the column must be scrolled\n   * into view before it can be interacted with or read.\n   */\n  bringIntoView(): Promise<void>;\n};\n\n\n/**\n * SmartRow - A Playwright Locator with table-aware methods.\n * \n * Extends all standard Locator methods (click, isVisible, etc.) with table-specific functionality.\n * \n * @example\n * const row = table.getRow({ Name: 'John Doe' });\n * await row.click(); // Standard Locator method\n * const email = row.getCell('Email'); // Table-aware method\n * const data = await row.toJSON(); // Extract all row data\n * await row.smartFill({ Name: 'Jane', Status: 'Active' }); // Fill form fields\n */\nexport type SmartRow<T = any> = Locator & {\n  /** Optional row index (0-based) if known */\n  rowIndex?: number;\n\n  /** Optional page index this row was found on (0-based) */\n  tablePageIndex?: number;\n\n  /** Reference to the parent TableResult */\n  table: TableResult<T>;\n\n  /**\n   * Get a cell locator by column name.\n   * @param column - Column name (case-sensitive)\n   * @returns SmartCell (Locator + bringIntoView)\n   * @example\n   * const emailCell = row.getCell('Email');\n   * await emailCell.bringIntoView();\n   * await expect(emailCell).toHaveText('john@example.com');\n   */\n  getCell(column: string): SmartCell;\n\n  /**\n   * Extract all cell data as a key-value object.\n   * @param options - Optional configuration\n   * @param options.columns - Specific columns to extract (extracts all if not specified)\n   * @returns Promise resolving to row data\n   * @example\n   * const data = await row.toJSON();\n   * // { Name: 'John', Email: 'john@example.com', ... }\n   * \n   * const partial = await row.toJSON({ columns: ['Name', 'Email'] });\n   * // { Name: 'John', Email: 'john@example.com' }\n   */\n  toJSON(options?: { columns?: string[] }): Promise<T>;\n\n  /**\n   * Scrolls/paginates to bring this row into view.\n   * Works when row position metadata is known (e.g., from getRowByIndex, findRow,\n   * findRows, filter, or async iteration).\n   * @throws Error if row position metadata is unknown\n   */\n  bringIntoView(): Promise<void>;\n\n  /**\n   * Intelligently fills form fields in the row.\n   * Automatically detects input types (text, select, checkbox, contenteditable).\n   * \n   * @param data - Column-value pairs to fill\n   * @param options - Optional configuration\n   * @param options.inputMappers - Custom input selectors per column\n   * @example\n   * // Auto-detection\n   * await row.smartFill({ Name: 'John', Status: 'Active', Subscribe: true });\n   * \n   * // Custom input mappers\n   * await row.smartFill(\n   *   { Name: 'John' },\n   *   { inputMappers: { Name: (cell) => cell.locator('.custom-input') } }\n   * );\n   */\n  smartFill: (data: Partial<T> | Record<string, any>, options?: FillOptions) => Promise<void>;\n\n  /**\n   * Returns whether the row exists in the DOM (i.e. is not a sentinel row).\n   */\n  wasFound(): boolean;\n};\n\nexport type StrategyContext = TableContext & {\n  rowLocator?: Locator;\n  rowIndex?: number;\n};\n\n/**\n * Defines the contract for a sorting strategy.\n */\nexport interface SortingStrategy {\n  /**\n   * Performs the sort action on a column.\n   */\n  doSort(options: {\n    columnName: string;\n    direction: 'asc' | 'desc';\n    context: StrategyContext;\n  }): Promise<void>;\n\n  /**\n   * Retrieves the current sort state of a column.\n   */\n  getSortState(options: {\n    columnName: string;\n    context: StrategyContext;\n  }): Promise<'asc' | 'desc' | 'none'>;\n}\n\n/**\n * Debug configuration for development and troubleshooting\n */\nexport type DebugConfig = {\n  /**\n   * Slow down operations for debugging\n   * - number: Apply same delay to all operations (ms)\n   * - object: Granular delays per operation type\n   */\n  slow?: number | {\n    pagination?: number;\n    getCell?: number;\n    findRow?: number;\n    default?: number;\n  };\n  /**\n   * Log level for debug output\n   * - 'verbose': All logs (verbose, info, error)\n   * - 'info': Info and error logs only\n   * - 'error': Error logs only\n   * - 'none': No logs\n   */\n  logLevel?: 'verbose' | 'info' | 'error' | 'none';\n};\n\nexport interface TableContext<T = any> {\n  root: Locator;\n  config: FinalTableConfig<T>;\n  page: Page;\n  resolve: (selector: Selector, parent: Locator | Page) => Locator;\n  /** Resolves a column name to its header cell locator. Available after table is initialized. */\n  getHeaderCell?: (columnName: string) => Promise<Locator>;\n  /** Returns all column names in order. Available after table is initialized. */\n  getHeaders?: () => Promise<string[]>;\n  /** Scrolls the table horizontally to bring the given column's header into view. */\n  scrollToColumn?: (columnName: string) => Promise<void>;\n}\n\nexport interface PaginationPrimitives {\n  /** Classic \"Next Page\" or \"Scroll Down\" */\n  goNext?: (context: TableContext) => Promise<boolean>;\n\n  /** Classic \"Previous Page\" or \"Scroll Up\" */\n  goPrevious?: (context: TableContext) => Promise<boolean>;\n\n  /** Bulk skip forward multiple pages at once. Returns number of pages skipped. */\n  goNextBulk?: (context: TableContext) => Promise<boolean | number>;\n\n  /** Bulk skip backward multiple pages at once. Returns number of pages skipped. */\n  goPreviousBulk?: (context: TableContext) => Promise<boolean | number>;\n\n  /** Jump to first page / scroll to top */\n  goToFirst?: (context: TableContext) => Promise<boolean>;\n\n  /** Jump to last page / scroll to bottom */\n  goToLast?: (context: TableContext) => Promise<boolean>;\n\n  /**\n   * Fetch the total number of pages currently available.\n   * Can be used to optimize pagination paths (e.g. jumping to last page and going backwards).\n   */\n  getTotalPages?: (context: TableContext) => Promise<number | null>;\n\n  /**\n   * Jump to specific page index (0-indexed).\n   * Can be full-range (e.g. page number input: any page works) or windowed (e.g. only visible links 6\u201314).\n   * Return false when the page is not reachable in the current UI; the library will step toward the target (goNextBulk/goNext or goPreviousBulk/goPrevious) and retry goToPage until it succeeds.\n   */\n  goToPage?: (pageIndex: number, context: TableContext) => Promise<boolean>;\n\n  /** How many pages one goNextBulk() advances. Used by navigation path planner for optimal bringIntoView. */\n  nextBulkPages?: number;\n\n  /** How many pages one goPreviousBulk() goes back. Used by navigation path planner for optimal bringIntoView. */\n  previousBulkPages?: number;\n\n  /**\n   * Called once during init() to sync the library's page counter with the actual DOM state.\n   * Use when a table may open on a page other than the first (e.g. a deep-linked URL that\n   * lands on page 5). Returns a 0-indexed page number.\n   * @example\n   * detectCurrentPage: async (root) => {\n   *   const text = await root.locator('[aria-current=\"page\"]').textContent();\n   *   return parseInt(text ?? '1') - 1;\n   * }\n   */\n  detectCurrentPage?: (root: import('@playwright/test').Locator) => number | Promise<number>;\n}\n\nexport type PaginationStrategy = PaginationPrimitives;\n\nexport type DedupeStrategy = (row: SmartRow) => string | number | Promise<string | number>;\n\n\n\nexport type FillStrategy = (options: {\n  row: SmartRow;\n  columnName: string;\n  value: any;\n  index: number;\n  page: Page;\n  rootLocator: Locator;\n  config: FinalTableConfig<any>;\n  table: TableResult; // The parent table instance\n  fillOptions?: FillOptions;\n}) => Promise<void>;\n\nexport interface ColumnOverride<TValue = any> {\n  /** \n   * How to extract the value from the cell.\n   * `context` provides access to the parent row, permitting multi-cell logic or bypassing the default cell locator.\n   */\n  read?: (cell: Locator) => Promise<TValue> | TValue;\n\n  /** \n   * How to fill the cell with a new value. (Replaces smartFill default logic)\n   * Provides the current value (via `read`) if a `write` wants to check state first.\n   */\n  write?: (params: {\n    cell: Locator;\n    targetValue: TValue;\n    currentValue?: TValue;\n    row: SmartRow<any>;\n  }) => Promise<void>;\n}\n\nexport type { HeaderStrategy } from './strategies/headers';\n\n/**\n * Strategy to resolve column names (string or regex) to their index.\n */\n// fallow-ignore-next-line unused-type\nexport type { ColumnResolutionStrategy } from './strategies/resolution';\n\n/**\n * Strategy to filter rows based on criteria. Applied when using getRow/findRow/findRows with filters.\n * The default engine handles string, RegExp, number, and function (cell) => Locator filters.\n */\nexport interface FilterStrategy {\n  apply(options: {\n    rows: Locator;\n    filter: { column: string, value: FilterValue };\n    colIndex: number;\n    tableContext: TableContext;\n  }): Locator;\n}\n\n/**\n * Strategy to check if the table or rows are loading. Used after pagination/sort to wait for content.\n * E.g. isHeaderLoading for init stability; isTableLoading after sort/pagination.\n */\nexport interface LoadingStrategy {\n  isTableLoading?: (context: TableContext) => Promise<boolean>;\n  isRowLoading?: (row: SmartRow) => Promise<boolean>;\n  isHeaderLoading?: (context: TableContext) => Promise<boolean>;\n\n  /**\n   * How long (ms) to wait for a loading row to resolve before applying onRowLoadingTimeout.\n   * When not set, loading rows are immediately skipped (backward-compatible behavior).\n   */\n  rowLoadingTimeout?: number;\n\n  /**\n   * What to do when a row is still loading after rowLoadingTimeout ms.\n   * - 'skip': drop the row from results (matches legacy skip behavior)\n   * - 'read-as-is': include the row even though it's still loading (default)\n   * - 'throw': throw an error with row index and timeout info\n   * Defaults to 'read-as-is' when rowLoadingTimeout is set.\n   */\n  onRowLoadingTimeout?: 'skip' | 'read-as-is' | 'throw';\n\n  /**\n   * Predicate called before reading each cell. Return true if the cell is still loading.\n   * When cellLoadingTimeout is also set, the engine waits up to that many ms for the\n   * cell to resolve before applying onCellLoadingTimeout.\n   */\n  isCellLoading?: (cell: import('@playwright/test').Locator, columnName: string, row: SmartRow) => Promise<boolean>;\n\n  /**\n   * How long (ms) to wait for a loading cell to resolve before applying onCellLoadingTimeout.\n   * When not set and isCellLoading returns true, the cell is read as-is immediately.\n   */\n  cellLoadingTimeout?: number;\n\n  /**\n   * What to do when a cell is still loading after cellLoadingTimeout ms.\n   * - 'skip': use empty string for this cell value\n   * - 'read-as-is': read the cell content even though it's still loading (default)\n   * - 'throw': throw an error with column name, row index and timeout info\n   * - callback: called with (cell, columnName, row); its return value becomes the cell's string value\n   * Defaults to 'read-as-is' when cellLoadingTimeout is set.\n   */\n  onCellLoadingTimeout?:\n    | 'skip'\n    | 'read-as-is'\n    | 'throw'\n    | ((cell: import('@playwright/test').Locator, columnName: string, row: SmartRow) => Promise<string>);\n}\n\n/**\n * Organized container for all table interaction strategies.\n */\nexport interface TableStrategies {\n  /** Strategy for discovering/scanning headers */\n  header?: HeaderStrategy;\n  /** Primitive navigation functions (goUp, goDown, goLeft, goRight, goHome) */\n  navigation?: NavigationPrimitives;\n\n  /** Strategy for filling form inputs */\n  fill?: FillStrategy;\n  /** Strategy for paginating through data */\n  pagination?: PaginationStrategy;\n  /** Strategy for sorting columns */\n  sorting?: SortingStrategy;\n  /** Strategy for deduplicating rows during iteration/scrolling */\n  dedupe?: DedupeStrategy;\n  /** Function to get a cell locator */\n  getCellLocator?: GetCellLocatorFn;\n  /** Function to get the currently active/focused cell */\n  getActiveCell?: GetActiveCellFn;\n  /**\n   * Strategy for filtering rows. If present, FilterEngine will delegate filter application\n   * to this pluggable strategy.\n   */\n  filter?: FilterStrategy;\n  /**\n   * Hook called before each cell value is read in toJSON and columnOverrides.read.\n   * Fires for both the default innerText extraction and custom read mappers.\n   * Useful for scrolling off-screen columns into view in horizontally virtualized tables.\n   */\n  beforeCellRead?: BeforeCellReadFn;\n  /**\n   * Strategy for detecting loading states. Use this for table-, row-, and header-level readiness.\n   * E.g. after sort/pagination, the engine uses loading.isTableLoading when present.\n   */\n  loading?: LoadingStrategy;\n\n  /**\n   * Viewport oracle strategies for 2D virtualized tables (e.g. MUI DataGrid, AG Grid,\n   * Braintrust-style grids where both rows and columns are virtualized simultaneously).\n   *\n   * When present, the cell-reading engine uses these to jump directly to the target\n   * row/column and to detect the 2D scroll hazard (scrolling to reveal a column can\n   * knock rows out of the vertical viewport, and vice versa).\n   *\n   * Completely optional and additive \u2014 existing `navigation` primitives remain the fallback.\n   */\n  viewport?: ViewportStrategy;\n}\n\n\nexport interface TableConfig<T = any> {\n  /** Selector for the table headers */\n  headerSelector?: string | ((root: Locator) => Locator);\n  /** Selector for the table rows */\n  rowSelector?: string;\n  /** Selector for the cells within a row */\n  cellSelector?: string | ((row: Locator) => Locator);\n  /** Number of pages to scan for verification */\n  maxPages?: number;\n  /**\n   * Default concurrency strategy for iteration methods.\n   * Can be overridden by the options passed to forEach, map, or filter.\n   */\n  concurrency?: RowIterationMode;\n  /** Hook to rename columns dynamically */\n  headerTransformer?: (args: { text: string, index: number, locator: Locator, seenHeaders: Set<string> }) => string | Promise<string>;\n  /** Automatically scroll to table on init */\n  autoScroll?: boolean;\n  /** Debug options for development and troubleshooting */\n  debug?: DebugConfig;\n  /** Reset hook */\n  onReset?: (context: TableContext) => Promise<void>;\n  /** All interaction strategies */\n  strategies?: TableStrategies;\n\n  /**\n   * Unified interface for reading and writing data to specific columns.\n   * Overrides both default extraction (toJSON) and filling (smartFill) logic.\n   */\n  columnOverrides?: Partial<Record<keyof T, ColumnOverride<T[keyof T]>>>;\n}\n\nexport interface FinalTableConfig<T = any> extends TableConfig<T> {\n  headerSelector: string | ((root: Locator) => Locator);\n  rowSelector: string;\n  cellSelector: string | ((row: Locator) => Locator);\n  maxPages: number;\n  autoScroll: boolean;\n  concurrency?: RowIterationMode;\n  debug?: TableConfig['debug'];\n  headerTransformer: (args: { text: string, index: number, locator: Locator, seenHeaders: Set<string> }) => string | Promise<string>;\n  onReset: (context: TableContext) => Promise<void>;\n  strategies: TableStrategies;\n}\n\n\nexport interface FillOptions {\n  /**\n   * Custom input mappers for specific columns.\n   * Maps column names to functions that return the input locator for that cell.\n   */\n  inputMappers?: Record<string, (cell: Locator) => Locator>;\n}\n\n\n\n/** Callback context passed to forEach, map, and filter. */\nexport type RowIterationContext<T = any> = {\n  row: SmartRow<T>;\n  /** 0-based iteration counter \u2014 the order this row was visited, not its DOM position or grid identity. @deprecated Use `index` instead. `rowIndex` will be removed in v7.0.0. */\n  rowIndex: number;\n  /** 0-based iteration counter \u2014 the order this row was visited, not its DOM position or grid identity. */\n  index: number;\n  /** 0-based page index \u2014 which page this row was collected from. */\n  pageIndex: number;\n  stop: () => void;\n};\n\n/** Concurrency modes for row iteration. */\nexport type RowIterationMode = 'parallel' | 'sequential' | 'synchronized';\n\n/** Shared options for forEach, map, and filter. */\nexport type RowIterationOptions = {\n  /** Maximum number of pages to iterate. Defaults to config.maxPages. */\n  maxPages?: number;\n  /**\n   * Concurrency strategy for iteration.\n   * - 'parallel': Full parallel execution of both navigation and actions.\n   * - 'synchronized': Parallel navigation (lock-step) with serial actions.\n   * - 'sequential': Strictly serial one-at-a-time execution. No parallel navigation.\n   * @default 'parallel' (for map), 'sequential' (for forEach/filter)\n   */\n  concurrency?: RowIterationMode;\n  /**\n   * Deduplication strategy. Use when rows may repeat across iterations\n   * (e.g. infinite scroll tables). Returns a unique key per row.\n   */\n  dedupe?: DedupeStrategy;\n  /**\n   * When true, use goNextBulk (if present) to advance pages during iteration.\n   * @default false \u2014 uses goNext for one-page-at-a-time advancement\n   */\n  useBulkPagination?: boolean;\n};\n\nexport interface TableResult<T = any> extends AsyncIterable<{ row: SmartRow<T>; rowIndex: number; index: number; pageIndex: number }> {\n  /**\n   * Represents the current page index of the table's DOM.\n   * Starts at 0. Automatically maintained by the library during pagination and bringIntoView.\n   */\n  currentPageIndex: number;\n\n  /**\n   * Initializes the table by resolving headers. Must be called before using sync methods.\n   * @param options Optional timeout for header resolution (default: 3000ms)\n   */\n  init(options?: { timeout?: number }): Promise<TableResult<T>>;\n\n  /**\n   * SYNC: Checks if the table has been initialized.\n   * @returns true if init() has been called and completed, false otherwise\n   */\n  isInitialized(): boolean;\n\n  getHeaders: () => Promise<string[]>;\n  getHeaderCell: (columnName: string) => Promise<Locator>;\n\n  /**\n   * Finds a row by filters on the current page only. Returns immediately (sync).\n   * Throws error if table is not initialized.\n   * @note The returned SmartRow may have `rowIndex` as 0 when the match is not the first row.\n   * Use getRowByIndex(index) when you need a known index (e.g. for bringIntoView()).\n   */\n  getRow: (\n    filters: Record<string, FilterValue>,\n    options?: { exact?: boolean }\n  ) => SmartRow<T>;\n\n  /**\n   * Gets a row by 0-based index on the current page.\n   * Throws error if table is not initialized.\n   * @param index 0-based row index\n   */\n  getRowByIndex: (\n    index: number\n  ) => SmartRow<T>;\n\n  /**\n   * ASYNC: Searches for a single row across pages using pagination.\n   * Auto-initializes the table if not already initialized.\n   * @param filters - The filter criteria to match\n   * @param options - Search options including exact match and max pages\n   */\n  findRow: (\n    filters: Record<string, FilterValue>,\n    options?: { exact?: boolean, maxPages?: number }\n  ) => Promise<SmartRow<T>>;\n\n  /**\n   * ASYNC: Searches for all matching rows across pages using pagination.\n   * Auto-initializes the table if not already initialized.\n   * @param filters - The filter criteria to match (omit or pass {} for all rows)\n   * @param options - Search options including exact match and max pages\n   */\n  findRows: (\n    filters?: Record<string, FilterValue>,\n    options?: { exact?: boolean, maxPages?: number, useBulkPagination?: boolean }\n  ) => Promise<SmartRowArray<T>>;\n\n  /**\n   * Navigates to a specific column using the configured CellNavigationStrategy.\n   */\n  scrollToColumn: (columnName: string) => Promise<void>;\n\n  /**\n   * Counts the number of rows currently on the page.\n   * Does not paginate.\n   */\n  countRows: () => Promise<number>;\n\n  /**\n   * Iterates over rows and extracts the value of a single column.\n   * More efficient than map + toJSON for single-column extraction.\n   * @param columnName - The name of the column to extract\n   * @param options - Iteration options\n   */\n  mapColumn<R = string>(columnName: string, options?: RowIterationOptions): Promise<R[]>;\n\n  /**\n   * Iterates over rows and extracts the value of a single column as strings.\n   * @param columnName - The name of the column to extract\n   * @param options - Iteration options\n   */\n  getColumnValues(columnName: string, options?: RowIterationOptions): Promise<string[]>;\n\n\n  /**\n   * Resets the table state (clears cache, flags) and invokes the onReset strategy.\n   */\n  reset: () => Promise<void>;\n\n  /**\n   * Revalidates the table's structure (headers, columns) without resetting pagination or state.\n   * Useful when columns change visibility or order dynamically.\n   */\n  revalidate: () => Promise<void>;\n\n  /**\n   * Iterates every row across all pages, calling the callback for side effects.\n   * Execution is sequential by default (safe for interactions like clicking/filling).\n   * Call `stop()` in the callback to end iteration early.\n   *\n   * @param callback - Function receiving { row, rowIndex, stop }\n   * @param options - maxPages, concurrency, dedupe, useBulkPagination\n   *\n   * @example\n   * await table.forEach(async ({ row, stop }) => {\n   *   if (await row.getCell('Status').innerText() === 'Done') stop();\n   *   await row.getCell('Checkbox').click();\n   * });\n   */\n  forEach(\n    callback: (ctx: RowIterationContext<T>) => void | Promise<void>,\n    options?: RowIterationOptions\n  ): Promise<void>;\n\n  /**\n   * Transforms every row across all pages into a value. Returns a flat array.\n   * Execution is parallel within each page by default (safe for reads).\n   * Call `stop()` to halt after the current page finishes.\n   *\n   * > **\u26A0\uFE0F UI Interactions:** `map` defaults to `concurrency: 'parallel'`. If your callback opens popovers,\n   * > fills inputs, or otherwise mutates UI state, pass `concurrency: 'sequential'` (or `'synchronized'`\n   * > when navigation must stay lock-step) to avoid overlapping interactions.\n   *\n   * @param callback - Function receiving { row, rowIndex, stop }\n   * @param options - maxPages, concurrency, dedupe, useBulkPagination\n   *\n   * @example\n   * // Data extraction \u2014 parallel is safe\n   * const emails = await table.map(({ row }) => row.getCell('Email').innerText());\n   *\n   * @example\n   * // UI interactions \u2014 use sequential (or synchronized) concurrency\n   * const assignees = await table.map(async ({ row }) => {\n   *   await row.getCell('Assignee').locator('button').click();\n   *   const name = await page.locator('.popover .name').innerText();\n   *   await page.keyboard.press('Escape');\n   *   return name;\n   * }, { concurrency: 'sequential' });\n   */\n  map<R>(\n    callback: (ctx: RowIterationContext<T>) => R | Promise<R>,\n    options?: RowIterationOptions\n  ): Promise<R[]>;\n\n  /**\n   * Shorthand for `map()` + `reset()`. Iterates every row across all pages, applies the\n   * callback (defaults to `row.toJSON()`), then resets the table back to page 1 \u2014 even if\n   * the callback throws.\n   *\n   * @param callback - Optional map function. Defaults to `({ row }) => row.toJSON()`.\n   * @param options - Same options as `map()`.\n   *\n   * @example\n   * // Zero-arg: returns toJSON() for every row\n   * const rows = await table.toArray();\n   *\n   * @example\n   * // Custom callback\n   * const names = await table.toArray(({ row }) => row.getCell('Name').innerText());\n   *\n   * @example\n   * // With options\n   * const rows = await table.toArray(({ row }) => row.toJSON(), { concurrency: 'parallel' });\n   */\n  toArray<R = Record<string, unknown>>(\n    callback?: (ctx: RowIterationContext<T>) => R | Promise<R>,\n    options?: RowIterationOptions\n  ): Promise<R[]>;\n\n  /**\n   * Filters rows across all pages by an async predicate. Returns a SmartRowArray.\n   * Rows are returned as-is \u2014 call `bringIntoView()` on each if needed.\n   * Execution is sequential by default.\n   *\n   * @param predicate - Function receiving { row, rowIndex, stop }\n   * @param options - maxPages, concurrency, dedupe, useBulkPagination\n   *\n   * @example\n   * const active = await table.filter(async ({ row }) =>\n   *   await row.getCell('Status').innerText() === 'Active'\n   * );\n   */\n  filter(\n    predicate: (ctx: RowIterationContext<T>) => boolean | Promise<boolean>,\n    options?: RowIterationOptions\n  ): Promise<SmartRowArray<T>>;\n\n  /**\n   * Provides access to sorting actions and assertions.\n   */\n  sorting: {\n    /**\n     * Applies the configured sorting strategy to the specified column.\n     * @param columnName The name of the column to sort.\n     * @param direction The direction to sort ('asc' or 'desc').\n     */\n    apply(columnName: string, direction: 'asc' | 'desc'): Promise<void>;\n    /**\n     * Gets the current sort state of a column using the configured sorting strategy.\n     * @param columnName The name of the column to check.\n     * @returns A promise that resolves to 'asc', 'desc', or 'none'.\n     */\n    getState(columnName: string): Promise<'asc' | 'desc' | 'none'>;\n  };\n\n  /**\n   * Generate an AI-friendly configuration prompt for debugging.\n   * Outputs table HTML and TypeScript definitions to help AI assistants generate config.\n   * Automatically throws an Error containing the prompt.\n   */\n  generateConfig: () => Promise<void>;\n\n  /**\n   * @deprecated Use `generateConfig()` instead. Will be removed in v7.0.0.\n   */\n  generateConfigPrompt: () => Promise<void>;\n}\n";

package/dist/typeContext.js

@@ -814,6 +814,31 @@ export interface TableResult<T = any> extends AsyncIterable<{ row: SmartRow<T>;
     options?: RowIterationOptions
   ): Promise<R[]>;
 
+  /**
+   * Shorthand for \`map()\` + \`reset()\`. Iterates every row across all pages, applies the
+   * callback (defaults to \`row.toJSON()\`), then resets the table back to page 1 — even if
+   * the callback throws.
+   *
+   * @param callback - Optional map function. Defaults to \`({ row }) => row.toJSON()\`.
+   * @param options - Same options as \`map()\`.
+   *
+   * @example
+   * // Zero-arg: returns toJSON() for every row
+   * const rows = await table.toArray();
+   *
+   * @example
+   * // Custom callback
+   * const names = await table.toArray(({ row }) => row.getCell('Name').innerText());
+   *
+   * @example
+   * // With options
+   * const rows = await table.toArray(({ row }) => row.toJSON(), { concurrency: 'parallel' });
+   */
+  toArray<R = Record<string, unknown>>(
+    callback?: (ctx: RowIterationContext<T>) => R | Promise<R>,
+    options?: RowIterationOptions
+  ): Promise<R[]>;
+
   /**
    * Filters rows across all pages by an async predicate. Returns a SmartRowArray.
    * Rows are returned as-is — call \`bringIntoView()\` on each if needed.

package/dist/types.d.ts

@@ -740,6 +740,27 @@ export interface TableResult<T = any> extends AsyncIterable<{
      * }, { concurrency: 'sequential' });
      */
     map<R>(callback: (ctx: RowIterationContext<T>) => R | Promise<R>, options?: RowIterationOptions): Promise<R[]>;
+    /**
+     * Shorthand for `map()` + `reset()`. Iterates every row across all pages, applies the
+     * callback (defaults to `row.toJSON()`), then resets the table back to page 1 — even if
+     * the callback throws.
+     *
+     * @param callback - Optional map function. Defaults to `({ row }) => row.toJSON()`.
+     * @param options - Same options as `map()`.
+     *
+     * @example
+     * // Zero-arg: returns toJSON() for every row
+     * const rows = await table.toArray();
+     *
+     * @example
+     * // Custom callback
+     * const names = await table.toArray(({ row }) => row.getCell('Name').innerText());
+     *
+     * @example
+     * // With options
+     * const rows = await table.toArray(({ row }) => row.toJSON(), { concurrency: 'parallel' });
+     */
+    toArray<R = Record<string, unknown>>(callback?: (ctx: RowIterationContext<T>) => R | Promise<R>, options?: RowIterationOptions): Promise<R[]>;
     /**
      * Filters rows across all pages by an async predicate. Returns a SmartRowArray.
      * Rows are returned as-is — call `bringIntoView()` on each if needed.

package/dist/useTable.js

@@ -469,6 +469,16 @@ const useTable = (rootLocator, configOptions = {}) => {
                 getCurrentPageIndex: () => tableState.currentPageIndex,
             }, callback, options);
         },
+        toArray: async (callback, options = {}) => {
+            log(`toArray: options=${safeStringify(options)}`);
+            const cb = callback !== null && callback !== void 0 ? callback : (({ row }) => row.toJSON());
+            try {
+                return await result.map(cb, options);
+            }
+            finally {
+                await result.reset();
+            }
+        },
         filter: async (predicate, options = {}) => {
             log(`filter: options=${safeStringify(options)}`);
             await _autoInit();

package/dist/utils/mergeTableConfig.d.ts

@@ -0,0 +1,22 @@
+import type { TableConfig } from '../types';
+/**
+ * Deep-merges two `TableConfig` objects.
+ *
+ * Merge semantics:
+ * - Top-level keys (`rowSelector`, `maxPages`, etc.): overrides win — same as `{ ...base, ...overrides }`.
+ * - `strategies`: each sub-key is merged independently. Object-valued strategies (`loading`,
+ *   `viewport`, `pagination`) are merged key-by-key so that neither side silently wipes the
+ *   other's settings. Function-valued strategies (`header`, `dedupe`, `getCellLocator`, etc.)
+ *   are replaced in full by the override value (a function cannot be meaningfully object-spread).
+ * - `columnOverrides`: merged key-by-key (each column entry merged independently).
+ * - Everything else: overrides win (shallow merge).
+ *
+ * @example
+ * const config = mergeTableConfig(baseConfig, {
+ *   maxPages: 20,
+ *   strategies: {
+ *     loading: { isTableLoading: myLoadingFn },
+ *   },
+ * });
+ */
+export declare function mergeTableConfig<T = any>(base: TableConfig<T>, overrides: TableConfig<T>): TableConfig<T>;

package/dist/utils/mergeTableConfig.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeTableConfig = mergeTableConfig;
+/**
+ * Deep-merges two `TableConfig` objects.
+ *
+ * Merge semantics:
+ * - Top-level keys (`rowSelector`, `maxPages`, etc.): overrides win — same as `{ ...base, ...overrides }`.
+ * - `strategies`: each sub-key is merged independently. Object-valued strategies (`loading`,
+ *   `viewport`, `pagination`) are merged key-by-key so that neither side silently wipes the
+ *   other's settings. Function-valued strategies (`header`, `dedupe`, `getCellLocator`, etc.)
+ *   are replaced in full by the override value (a function cannot be meaningfully object-spread).
+ * - `columnOverrides`: merged key-by-key (each column entry merged independently).
+ * - Everything else: overrides win (shallow merge).
+ *
+ * @example
+ * const config = mergeTableConfig(baseConfig, {
+ *   maxPages: 20,
+ *   strategies: {
+ *     loading: { isTableLoading: myLoadingFn },
+ *   },
+ * });
+ */
+function mergeTableConfig(base, overrides) {
+    var _a, _b, _c, _d;
+    const result = Object.assign(Object.assign({}, base), overrides);
+    // Deep-merge strategies one level down
+    if (base.strategies || overrides.strategies) {
+        result.strategies = Object.assign(Object.assign({}, base.strategies), overrides.strategies);
+        // For strategy sub-keys that are plain objects on *both* sides, merge key-by-key
+        // 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 : {}),
+        ]);
+        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];
+            if (baseVal !== undefined &&
+                overrideVal !== undefined &&
+                typeof baseVal === 'object' &&
+                typeof overrideVal === 'object' &&
+                !Array.isArray(baseVal) &&
+                !Array.isArray(overrideVal) &&
+                typeof baseVal !== 'function' &&
+                typeof overrideVal !== 'function') {
+                // The spread result can't be expressed as the union of all strategy types;
+                // the runtime object-check above guarantees safety.
+                result.strategies[key] =
+                    Object.assign(Object.assign({}, baseVal), overrideVal);
+            }
+        }
+    }
+    // Deep-merge columnOverrides one level down (each column entry merged independently)
+    if (base.columnOverrides || overrides.columnOverrides) {
+        result.columnOverrides = Object.assign(Object.assign({}, base.columnOverrides), overrides.columnOverrides);
+    }
+    return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rickcedwhat/playwright-smart-table",
-  "version": "6.16.0",
+  "version": "6.17.0",
   "description": "Smart, column-aware table interactions for Playwright",
   "author": "Cedrick Catalan",
   "license": "MIT",