@rickcedwhat/playwright-smart-table 4.0.0 → 5.1.0

package/dist/smartRow.js

@@ -11,6 +11,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSmartRow = void 0;
 const fill_1 = require("./strategies/fill");
+const stringUtils_1 = require("./utils/stringUtils");
+const traceUtils_1 = require("./utils/traceUtils");
 /**
  * Factory to create a SmartRow by extending a Playwright Locator.
  * We avoid Class/Proxy to ensure full compatibility with Playwright's expect(locator) matchers.
@@ -19,13 +21,11 @@ const createSmartRow = (rowLocator, map, rowIndex, config, rootLocator, resolve,
     const smart = rowLocator;
     // Attach State
     smart.rowIndex = rowIndex;
-    smart.getRequestIndex = () => rowIndex;
     // Attach Methods
     smart.getCell = (colName) => {
         const idx = map.get(colName);
         if (idx === undefined) {
-            const availableColumns = Array.from(map.keys());
-            throw new Error(`Column "${colName}" not found. Available: ${availableColumns.join(', ')}`);
+            throw new Error((0, stringUtils_1.buildColumnNotFoundError)(colName, Array.from(map.keys())));
         }
         if (config.strategies.getCellLocator) {
             return config.strategies.getCellLocator({
@@ -36,6 +36,8 @@ const createSmartRow = (rowLocator, map, rowIndex, config, rootLocator, resolve,
                 page: rootLocator.page()
             });
         }
+        // Add trace event
+        (0, traceUtils_1.addTraceEvent)(rootLocator.page(), 'getCell', { column: colName, columnIndex: idx, rowIndex }).catch(() => { });
         return resolve(config.cellSelector, rowLocator).nth(idx);
     };
     smart.toJSON = (options) => __awaiter(void 0, void 0, void 0, function* () {
@@ -112,8 +114,7 @@ const createSmartRow = (rowLocator, map, rowIndex, config, rootLocator, resolve,
         }
         return result;
     });
-    // @ts-ignore
-    smart.fill = (data, fillOptions) => __awaiter(void 0, void 0, void 0, function* () {
+    smart.smartFill = (data, fillOptions) => __awaiter(void 0, void 0, void 0, function* () {
         for (const [colName, value] of Object.entries(data)) {
             const colIdx = map.get(colName);
             if (colIdx === undefined) {
@@ -144,12 +145,11 @@ const createSmartRow = (rowLocator, map, rowIndex, config, rootLocator, resolve,
     });
     smart.bringIntoView = () => __awaiter(void 0, void 0, void 0, function* () {
         if (rowIndex === undefined) {
-            throw new Error('Cannot bring row into view - row index is unknown. Use getByRowIndex() instead of getByRow().');
+            throw new Error('Cannot bring row into view - row index is unknown. Use getRowByIndex() instead of getRow().');
         }
         // Scroll row into view using Playwright's built-in method
         yield rowLocator.scrollIntoViewIfNeeded();
     });
-    smart.smartFill = smart.fill;
     return smart;
 };
 exports.createSmartRow = createSmartRow;

package/dist/strategies/columns.d.ts

@@ -9,44 +9,10 @@ export type CellNavigationStrategy = (context: StrategyContext & {
     index: number;
     rowIndex?: number;
 }) => Promise<void>;
-/** @deprecated Use CellNavigationStrategy instead */
-export type ColumnStrategy = CellNavigationStrategy;
 export declare const CellNavigationStrategies: {
     /**
      * Default strategy: Assumes column is accessible or standard scrolling works.
      * No specific action taken other than what Playwright's default locator handling does.
      */
     default: () => Promise<void>;
-    /**
-     * Strategy that clicks into the table to establish focus and then uses the Right Arrow key
-     * to navigate to the target CELL (navigates down to the row, then right to the column).
-     *
-     * Useful for canvas-based grids like Glide where DOM scrolling might not be enough for interaction
-     * or where keyboard navigation is the primary way to move focus.
-     */
-    keyboard: (context: StrategyContext & {
-        column: string;
-        index: number;
-        rowIndex?: number;
-    }) => Promise<void>;
-};
-/** @deprecated Use CellNavigationStrategies instead */
-export declare const ColumnStrategies: {
-    /**
-     * Default strategy: Assumes column is accessible or standard scrolling works.
-     * No specific action taken other than what Playwright's default locator handling does.
-     */
-    default: () => Promise<void>;
-    /**
-     * Strategy that clicks into the table to establish focus and then uses the Right Arrow key
-     * to navigate to the target CELL (navigates down to the row, then right to the column).
-     *
-     * Useful for canvas-based grids like Glide where DOM scrolling might not be enough for interaction
-     * or where keyboard navigation is the primary way to move focus.
-     */
-    keyboard: (context: StrategyContext & {
-        column: string;
-        index: number;
-        rowIndex?: number;
-    }) => Promise<void>;
 };

package/dist/strategies/columns.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ColumnStrategies = exports.CellNavigationStrategies = void 0;
+exports.CellNavigationStrategies = void 0;
 exports.CellNavigationStrategies = {
     /**
      * Default strategy: Assumes column is accessible or standard scrolling works.
@@ -17,38 +17,5 @@ exports.CellNavigationStrategies = {
      */
     default: () => __awaiter(void 0, void 0, void 0, function* () {
         // No-op
-    }),
-    /**
-     * Strategy that clicks into the table to establish focus and then uses the Right Arrow key
-     * to navigate to the target CELL (navigates down to the row, then right to the column).
-     *
-     * Useful for canvas-based grids like Glide where DOM scrolling might not be enough for interaction
-     * or where keyboard navigation is the primary way to move focus.
-     */
-    keyboard: (context) => __awaiter(void 0, void 0, void 0, function* () {
-        const { root, page, index, rowLocator, rowIndex } = context;
-        if (typeof rowIndex !== 'number') {
-            throw new Error('Row index is required for keyboard navigation');
-        }
-        yield root.focus();
-        yield page.waitForTimeout(100);
-        // Robust Navigation:
-        // 1. Jump to Top-Left (Reset) - Sequence for Cross-OS (Mac/Windows)
-        yield page.keyboard.press('Control+Home');
-        yield page.keyboard.press('Meta+ArrowUp'); // Mac Go-To-Top
-        yield page.keyboard.press('Home'); // Ensure start of row
-        yield page.waitForTimeout(150);
-        // 2. Move Down to Target Row
-        for (let i = 0; i < rowIndex; i++) {
-            yield page.keyboard.press('ArrowDown');
-        }
-        // 3. Move Right to Target Column
-        for (let i = 0; i < index; i++) {
-            yield page.keyboard.press('ArrowRight');
-        }
-        yield page.waitForTimeout(50);
     })
 };
-// Backwards compatibility - deprecated
-/** @deprecated Use CellNavigationStrategies instead */
-exports.ColumnStrategies = exports.CellNavigationStrategies;

package/dist/strategies/headers.d.ts

@@ -10,20 +10,4 @@ export declare const HeaderStrategies: {
      * This is fast but won't find virtualized columns off-screen.
      */
     visible: ({ config, resolve, root }: StrategyContext) => Promise<string[]>;
-    /**
-     * Scans for headers by finding a scrollable container and setting scrollLeft.
-     */
-    scrollRight: (context: StrategyContext, options?: {
-        limit?: number;
-        selector?: string;
-        scrollAmount?: number;
-    }) => Promise<string[]>;
-    /**
-     * Strategy that clicks into the table to establish focus and then uses the Right Arrow key
-     * to navigate cell-by-cell, collecting headers found along the way.
-     */
-    keyboard: (context: StrategyContext, options?: {
-        limit?: number;
-        maxSilentClicks?: number;
-    }) => Promise<string[]>;
 };

package/dist/strategies/headers.js

@@ -26,117 +26,5 @@ exports.HeaderStrategies = {
         }
         const texts = yield headerLoc.allInnerTexts();
         return texts.map(t => t.trim());
-    }),
-    /**
-     * Scans for headers by finding a scrollable container and setting scrollLeft.
-     */
-    scrollRight: (context, options) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a, _b;
-        const { resolve, config, root, page } = context;
-        const limit = (_a = options === null || options === void 0 ? void 0 : options.limit) !== null && _a !== void 0 ? _a : 20;
-        const scrollAmount = (_b = options === null || options === void 0 ? void 0 : options.scrollAmount) !== null && _b !== void 0 ? _b : 300;
-        const collectedHeaders = new Set();
-        const getVisible = () => __awaiter(void 0, void 0, void 0, function* () {
-            const headerLoc = resolve(config.headerSelector, root);
-            const texts = yield headerLoc.allInnerTexts();
-            return texts.map(t => t.trim());
-        });
-        // Initial capture
-        let currentHeaders = yield getVisible();
-        currentHeaders.forEach(h => collectedHeaders.add(h));
-        // Find scroller using JS for better iframe/shadow support
-        const scrollerHandle = yield root.evaluateHandle((el, selector) => {
-            if (selector && el.matches(selector))
-                return el;
-            const effectiveSelector = selector || '.dvn-scroller';
-            const ancestor = el.closest(effectiveSelector);
-            if (ancestor)
-                return ancestor;
-            return document.querySelector(effectiveSelector);
-        }, options === null || options === void 0 ? void 0 : options.selector);
-        const isScrollerFound = yield scrollerHandle.evaluate(el => !!el);
-        if (isScrollerFound) {
-            yield scrollerHandle.evaluate(el => el.scrollLeft = 0);
-            yield page.waitForTimeout(200);
-            for (let i = 0; i < limit; i++) {
-                const sizeBefore = collectedHeaders.size;
-                yield scrollerHandle.evaluate((el, amount) => el.scrollLeft += amount, scrollAmount);
-                yield page.waitForTimeout(300);
-                const newHeaders = yield getVisible();
-                newHeaders.forEach(h => collectedHeaders.add(h));
-                if (collectedHeaders.size === sizeBefore) {
-                    yield scrollerHandle.evaluate((el, amount) => el.scrollLeft += amount, scrollAmount);
-                    yield page.waitForTimeout(300);
-                    const retryHeaders = yield getVisible();
-                    retryHeaders.forEach(h => collectedHeaders.add(h));
-                    if (collectedHeaders.size === sizeBefore)
-                        break;
-                }
-            }
-        }
-        else {
-            console.warn("HeaderStrategies.scrollRight: Could not find scroller. Returning visible headers.");
-        }
-        // Scroll back to start
-        yield scrollerHandle.evaluate(el => el.scrollLeft = 0);
-        yield page.waitForTimeout(200);
-        return Array.from(collectedHeaders);
-    }),
-    /**
-     * Strategy that clicks into the table to establish focus and then uses the Right Arrow key
-     * to navigate cell-by-cell, collecting headers found along the way.
-     */
-    keyboard: (context, options) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a, _b;
-        const { resolve, config, root, page } = context;
-        const limit = (_a = options === null || options === void 0 ? void 0 : options.limit) !== null && _a !== void 0 ? _a : 100;
-        const maxSilentClicks = (_b = options === null || options === void 0 ? void 0 : options.maxSilentClicks) !== null && _b !== void 0 ? _b : 10;
-        const collectedHeaders = new Set();
-        const getVisible = () => __awaiter(void 0, void 0, void 0, function* () {
-            const headerLoc = resolve(config.headerSelector, root);
-            const texts = yield headerLoc.allInnerTexts();
-            return texts.map(t => t.trim());
-        });
-        // 1. Initial capture
-        let currentHeaders = yield getVisible();
-        currentHeaders.forEach(h => collectedHeaders.add(h));
-        // 2. Click to focus
-        // Try to find the canvas sibling specifically for Glide, otherwise click root
-        const canvas = root.locator('xpath=ancestor::div').locator('canvas').first();
-        if ((yield canvas.count()) > 0) {
-            // Click lower in the canvas to hit a data cell instead of header
-            // Adjusted to y=60 to target Row 1
-            yield canvas.click({ position: { x: 50, y: 60 }, force: true }).catch(() => { });
-        }
-        else {
-            yield root.click({ position: { x: 10, y: 10 }, force: true }).catch(() => { });
-        }
-        // Reset to home
-        yield page.keyboard.press('Control+Home');
-        yield page.keyboard.press('Home');
-        // Wait for potential scroll/focus reset
-        yield page.evaluate(() => new Promise(requestAnimationFrame));
-        currentHeaders = yield getVisible();
-        currentHeaders.forEach(h => collectedHeaders.add(h));
-        // 3. Navigate right loop
-        let silentCounter = 0;
-        for (let i = 0; i < limit; i++) {
-            const sizeBefore = collectedHeaders.size;
-            yield page.keyboard.press('ArrowRight');
-            // Small breathing room for key press to register
-            yield page.evaluate(() => new Promise(requestAnimationFrame));
-            const newHeaders = yield getVisible();
-            newHeaders.forEach(h => collectedHeaders.add(h));
-            if (collectedHeaders.size === sizeBefore) {
-                silentCounter++;
-            }
-            else {
-                silentCounter = 0;
-            }
-            if (silentCounter >= maxSilentClicks) {
-                break;
-            }
-        }
-        return Array.from(collectedHeaders);
-    }),
+    })
 };

package/dist/strategies/index.d.ts

@@ -7,39 +7,16 @@ export * from './resolution';
 export declare const Strategies: {
     Pagination: {
         clickNext: (nextButtonSelector: import("..").Selector, timeout?: number) => import("..").PaginationStrategy;
-        clickLoadMore: (buttonSelector: import("..").Selector, timeout?: number) => import("..").PaginationStrategy;
         infiniteScroll: (timeout?: number) => import("..").PaginationStrategy;
     };
     Sorting: {
         AriaSort: () => import("..").SortingStrategy;
     };
-    Column: {
-        default: () => Promise<void>;
-        keyboard: (context: import("..").StrategyContext & {
-            column: string;
-            index: number;
-            rowIndex?: number;
-        }) => Promise<void>;
-    };
     CellNavigation: {
         default: () => Promise<void>;
-        keyboard: (context: import("..").StrategyContext & {
-            column: string;
-            index: number;
-            rowIndex?: number;
-        }) => Promise<void>;
     };
     Header: {
         visible: ({ config, resolve, root }: import("..").StrategyContext) => Promise<string[]>;
-        scrollRight: (context: import("..").StrategyContext, options?: {
-            limit?: number;
-            selector?: string;
-            scrollAmount?: number;
-        }) => Promise<string[]>;
-        keyboard: (context: import("..").StrategyContext, options?: {
-            limit?: number;
-            maxSilentClicks?: number;
-        }) => Promise<string[]>;
     };
     Fill: {
         default: ({ row, columnName, value, fillOptions }: Parameters<import("..").FillStrategy>[0]) => Promise<void>;
@@ -47,9 +24,4 @@ export declare const Strategies: {
     Resolution: {
         default: import("./resolution").ColumnResolutionStrategy;
     };
-    DeprecatedPagination: {
-        clickNext: (nextButtonSelector: import("..").Selector, timeout?: number) => import("..").PaginationStrategy;
-        clickLoadMore: (buttonSelector: import("..").Selector, timeout?: number) => import("..").PaginationStrategy;
-        infiniteScroll: (timeout?: number) => import("..").PaginationStrategy;
-    };
 };

package/dist/strategies/index.js

@@ -30,11 +30,8 @@ __exportStar(require("./resolution"), exports);
 exports.Strategies = {
     Pagination: pagination_1.PaginationStrategies,
     Sorting: sorting_1.SortingStrategies,
-    Column: columns_1.ColumnStrategies,
     CellNavigation: columns_1.CellNavigationStrategies,
     Header: headers_1.HeaderStrategies,
     Fill: fill_1.FillStrategies,
     Resolution: resolution_1.ResolutionStrategies,
-    // Alias for backward compatibility if needed, though we are encouraging the new structure
-    DeprecatedPagination: pagination_1.DeprecatedPaginationStrategies
 };

package/dist/strategies/pagination.d.ts

@@ -4,27 +4,6 @@ export declare const PaginationStrategies: {
      * Strategy: Clicks a "Next" button and waits for the first row of data to change.
      */
     clickNext: (nextButtonSelector: Selector, timeout?: number) => PaginationStrategy;
-    /**
-     * Strategy: Clicks a "Load More" button and waits for the row count to increase.
-     */
-    clickLoadMore: (buttonSelector: Selector, timeout?: number) => PaginationStrategy;
-    /**
-     * Strategy: Scrolls to the bottom and waits for more rows to appear.
-     */
-    infiniteScroll: (timeout?: number) => PaginationStrategy;
-};
-/**
- * @deprecated Use `PaginationStrategies` instead. This alias will be removed in a future major version.
- */
-export declare const DeprecatedPaginationStrategies: {
-    /**
-     * Strategy: Clicks a "Next" button and waits for the first row of data to change.
-     */
-    clickNext: (nextButtonSelector: Selector, timeout?: number) => PaginationStrategy;
-    /**
-     * Strategy: Clicks a "Load More" button and waits for the row count to increase.
-     */
-    clickLoadMore: (buttonSelector: Selector, timeout?: number) => PaginationStrategy;
     /**
      * Strategy: Scrolls to the bottom and waits for more rows to appear.
      */

package/dist/strategies/pagination.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DeprecatedPaginationStrategies = exports.PaginationStrategies = void 0;
+exports.PaginationStrategies = void 0;
 const utils_1 = require("../utils");
 exports.PaginationStrategies = {
     /**
@@ -31,24 +31,6 @@ exports.PaginationStrategies = {
             return success;
         });
     },
-    /**
-     * Strategy: Clicks a "Load More" button and waits for the row count to increase.
-     */
-    clickLoadMore: (buttonSelector, timeout = 5000) => {
-        return (_a) => __awaiter(void 0, [_a], void 0, function* ({ root, config, resolve, page }) {
-            const loadMoreBtn = resolve(buttonSelector, root).first();
-            if (!(yield loadMoreBtn.isVisible()) || !(yield loadMoreBtn.isEnabled())) {
-                return false;
-            }
-            const rows = resolve(config.rowSelector, root);
-            const oldCount = yield rows.count();
-            yield loadMoreBtn.click();
-            return yield (0, utils_1.waitForCondition)(() => __awaiter(void 0, void 0, void 0, function* () {
-                const newCount = yield rows.count();
-                return newCount > oldCount;
-            }), timeout, page);
-        });
-    },
     /**
      * Strategy: Scrolls to the bottom and waits for more rows to appear.
      */
@@ -66,7 +48,3 @@ exports.PaginationStrategies = {
         });
     }
 };
-/**
- * @deprecated Use `PaginationStrategies` instead. This alias will be removed in a future major version.
- */
-exports.DeprecatedPaginationStrategies = exports.PaginationStrategies;

package/dist/strategies/validation.d.ts

@@ -0,0 +1,22 @@
+import type { PaginationStrategy, SortingStrategy, FillStrategy } from '../types';
+/**
+ * Validates that a pagination strategy returns a boolean.
+ * @param result - The result from a pagination strategy
+ * @param strategyName - Name of the strategy for error messages
+ */
+export declare function validatePaginationResult(result: any, strategyName?: string): boolean;
+/**
+ * Validates that a pagination strategy is properly configured.
+ * @param strategy - The pagination strategy to validate
+ */
+export declare function validatePaginationStrategy(strategy: any): strategy is PaginationStrategy;
+/**
+ * Validates that a sorting strategy has the required methods.
+ * @param strategy - The sorting strategy to validate
+ */
+export declare function validateSortingStrategy(strategy: any): strategy is SortingStrategy;
+/**
+ * Validates that a fill strategy is properly configured.
+ * @param strategy - The fill strategy to validate
+ */
+export declare function validateFillStrategy(strategy: any): strategy is FillStrategy;

package/dist/strategies/validation.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePaginationResult = validatePaginationResult;
+exports.validatePaginationStrategy = validatePaginationStrategy;
+exports.validateSortingStrategy = validateSortingStrategy;
+exports.validateFillStrategy = validateFillStrategy;
+/**
+ * Validates that a pagination strategy returns a boolean.
+ * @param result - The result from a pagination strategy
+ * @param strategyName - Name of the strategy for error messages
+ */
+function validatePaginationResult(result, strategyName = 'Custom Pagination Strategy') {
+    if (typeof result !== 'boolean') {
+        throw new Error(`[${strategyName}] Pagination strategy must return a boolean (true if paginated, false if no more pages). ` +
+            `Received: ${typeof result} (${JSON.stringify(result)})`);
+    }
+    return result;
+}
+/**
+ * Validates that a pagination strategy is properly configured.
+ * @param strategy - The pagination strategy to validate
+ */
+function validatePaginationStrategy(strategy) {
+    if (typeof strategy !== 'function') {
+        throw new Error(`Pagination strategy must be a function. Received: ${typeof strategy}`);
+    }
+    return true;
+}
+/**
+ * Validates that a sorting strategy has the required methods.
+ * @param strategy - The sorting strategy to validate
+ */
+function validateSortingStrategy(strategy) {
+    if (!strategy || typeof strategy !== 'object') {
+        throw new Error(`Sorting strategy must be an object with 'doSort' and 'getSortState' methods. Received: ${typeof strategy}`);
+    }
+    if (typeof strategy.doSort !== 'function') {
+        throw new Error(`Sorting strategy must have a 'doSort' method. Missing or not a function.`);
+    }
+    if (typeof strategy.getSortState !== 'function') {
+        throw new Error(`Sorting strategy must have a 'getSortState' method. Missing or not a function.`);
+    }
+    return true;
+}
+/**
+ * Validates that a fill strategy is properly configured.
+ * @param strategy - The fill strategy to validate
+ */
+function validateFillStrategy(strategy) {
+    if (typeof strategy !== 'function') {
+        throw new Error(`Fill strategy must be a function. Received: ${typeof strategy}`);
+    }
+    return true;
+}

package/dist/typeContext.d.ts

@@ -3,4 +3,4 @@
  * This file is generated by scripts/embed-types.js
  * It contains the raw text of types.ts to provide context for LLM prompts.
  */
-export declare const TYPE_CONTEXT = "\nexport type Selector = string | ((root: Locator | Page) => 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  columnName: string;\n  columnIndex: number;\n  rowIndex?: number;\n  page: Page;\n}) => Locator;\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\nexport type SmartRow<T = any> = Locator & {\n  getRequestIndex(): number | undefined;\n  rowIndex?: number;\n  getCell(column: string): Locator;\n  toJSON(options?: { columns?: string[] }): Promise<T>;\n  /**\n   * Scrolls/paginates to bring this row into view.\n   * Only works if rowIndex is known.\n   */\n  bringIntoView(): Promise<void>;\n  /**\n   * Fills the row with data. Automatically detects input types.\n   */\n  fill: (data: Partial<T> | Record<string, any>, options?: FillOptions) => Promise<void>;\n  /**\n   * Alias for fill() to avoid conflict with Locator.fill()\n   */\n  smartFill: (data: Partial<T> | Record<string, any>, options?: FillOptions) => Promise<void>;\n};\n\nexport type StrategyContext = TableContext & { rowLocator?: Locator; rowIndex?: number };\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\nexport interface TableContext {\n  root: Locator;\n  config: FinalTableConfig;\n  page: Page;\n  resolve: (selector: Selector, parent: Locator | Page) => Locator;\n}\n\nexport type PaginationStrategy = (context: TableContext) => Promise<boolean>;\n\nexport type DedupeStrategy = (row: SmartRow) => string | number | Promise<string | number>;\n\nexport interface PromptOptions {\n  /**\n   * Output Strategy:\n   * - 'error': Throws an error with the prompt (useful for platforms that capture error output cleanly).\n   * - 'console': Standard console logs (Default).\n   */\n  output?: 'console' | 'error';\n  includeTypes?: boolean;\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  table: TableResult; // The parent table instance\n  fillOptions?: FillOptions;\n}) => Promise<void>;\n\nexport type { HeaderStrategy } from './strategies/headers';\nexport type { CellNavigationStrategy } from './strategies/columns';\n\n/**\n * Strategy to resolve column names (string or regex) to their index.\n */\nexport type { ColumnResolutionStrategy } from './strategies/resolution';\n\n/**\n * Strategy to filter rows based on criteria.\n */\nexport interface FilterStrategy {\n  apply(options: {\n    rows: Locator;\n    filter: { column: string, value: string | RegExp | number };\n    colIndex: number;\n    tableContext: TableContext;\n  }): Locator;\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  /** Strategy for navigating to specific cells (row + column) */\n  cellNavigation?: CellNavigationStrategy;\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  /** Function to get a cell locator */\n  getCellLocator?: GetCellLocatorFn;\n  /** Function to get the currently active/focused cell */\n  getActiveCell?: GetActiveCellFn;\n}\n\n/**\n * Configuration options for useTable.\n */\nexport interface TableConfig {\n  /** Selector for the table headers */\n  headerSelector?: string;\n  /** Selector for the table rows */\n  rowSelector?: string;\n  /** Selector for the cells within a row */\n  cellSelector?: string;\n  /** Number of pages to scan for verification */\n  maxPages?: number;\n  /** Hook to rename columns dynamically */\n  headerTransformer?: (args: { text: string, index: number, locator: Locator }) => string | Promise<string>;\n  /** Automatically scroll to table on init */\n  autoScroll?: boolean;\n  /** Enable debug logs */\n  debug?: boolean;\n  /** Reset hook */\n  onReset?: (context: TableContext) => Promise<void>;\n  /** All interaction strategies */\n  strategies?: TableStrategies;\n}\n\nexport interface FinalTableConfig extends TableConfig {\n  headerSelector: string;\n  rowSelector: string;\n  cellSelector: string;\n  maxPages: number;\n  autoScroll: boolean;\n  debug: boolean;\n  headerTransformer: (args: { text: string, index: number, locator: Locator }) => 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\nexport interface TableResult<T = any> {\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>;\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   */\n  getByRow: (\n    filters: Record<string, string | RegExp | number>,\n    options?: { exact?: boolean }\n  ) => SmartRow;\n\n  /**\n   * Gets a row by 1-based index on the current page.\n   * Throws error if table is not initialized.\n   * @param index 1-based row index\n   * @param options Optional settings including bringIntoView\n   */\n  getByRowIndex: (\n    index: number,\n    options?: { bringIntoView?: boolean }\n  ) => SmartRow;\n\n  /**\n   * Searches for a row across all available data using the configured strategy (pagination, scroll, etc.).\n   * Auto-initializes if needed.\n   */\n  searchForRow: (\n    filters: Record<string, string | RegExp | number>,\n    options?: { exact?: boolean, maxPages?: number }\n  ) => Promise<SmartRow>;\n\n  /**\n   * Navigates to a specific column using the configured CellNavigationStrategy.\n   */\n  scrollToColumn: (columnName: string) => Promise<void>;\n\n  getAllCurrentRows: <T extends { asJSON?: boolean }>(\n    options?: { filter?: Record<string, any>, exact?: boolean } & T\n  ) => Promise<T['asJSON'] extends true ? Record<string, string>[] : SmartRow[]>;\n\n  /**\n   * @deprecated Use getAllCurrentRows instead. This method will be removed in a future major version.\n   */\n  getAllRows: <T extends { asJSON?: boolean }>(\n    options?: { filter?: Record<string, any>, exact?: boolean } & T\n  ) => Promise<T['asJSON'] extends true ? Record<string, string>[] : SmartRow[]>;\n\n  generateConfigPrompt: (options?: PromptOptions) => Promise<void>;\n  generateStrategyPrompt: (options?: PromptOptions) => Promise<void>;\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   * Scans a specific column across all pages and returns the values.\n   */\n  getColumnValues: <V = string>(column: string, options?: { mapper?: (cell: Locator) => Promise<V> | V, maxPages?: number }) => Promise<V[]>;\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   * Iterates through paginated table data, calling the callback for each iteration.\n   * Callback return values are automatically appended to allData, which is returned.\n   */\n  iterateThroughTable: <T = any>(\n    callback: (context: {\n      index: number;\n      isFirst: boolean;\n      isLast: boolean;\n      rows: SmartRow[];\n      allData: T[];\n      table: RestrictedTableResult;\n    }) => T | Promise<T>,\n    options?: {\n      pagination?: PaginationStrategy;\n      dedupeStrategy?: DedupeStrategy;\n      maxIterations?: number;\n      getIsFirst?: (context: { index: number }) => boolean;\n      getIsLast?: (context: { index: number, paginationResult: boolean }) => boolean;\n      onFirst?: (context: { index: number, rows: SmartRow[], allData: any[] }) => void | Promise<void>;\n      onLast?: (context: { index: number, rows: SmartRow[], allData: any[] }) => void | Promise<void>;\n    }\n  ) => Promise<T[]>;\n}\n\n/**\n * Restricted table result that excludes methods that shouldn't be called during iteration.\n */\nexport type RestrictedTableResult<T = any> = Omit<TableResult<T>, 'searchForRow' | 'iterateThroughTable' | 'reset' | 'getAllRows'>;\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 * rowSelector: (root) => root.locator('[role=\"row\"]')\n */\nexport type Selector = string | ((root: Locator | Page) => 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  columnName: string;\n  columnIndex: number;\n  rowIndex?: number;\n  page: Page;\n}) => Locator;\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/**\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  /**\n   * Get a cell locator by column name.\n   * @param column - Column name (case-sensitive)\n   * @returns Locator for the cell\n   * @example\n   * const emailCell = row.getCell('Email');\n   * await expect(emailCell).toHaveText('john@example.com');\n   */\n  getCell(column: string): Locator;\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   * Only works if rowIndex is known (e.g., from getRowByIndex).\n   * @throws Error if rowIndex 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\nexport type StrategyContext = TableContext & { rowLocator?: Locator; rowIndex?: number };\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\nexport interface TableContext {\n  root: Locator;\n  config: FinalTableConfig;\n  page: Page;\n  resolve: (selector: Selector, parent: Locator | Page) => Locator;\n}\n\nexport type PaginationStrategy = (context: TableContext) => Promise<boolean>;\n\nexport type DedupeStrategy = (row: SmartRow) => string | number | Promise<string | number>;\n\nexport interface PromptOptions {\n  /**\n   * Output Strategy:\n   * - 'error': Throws an error with the prompt (useful for platforms that capture error output cleanly).\n   * - 'console': Standard console logs (Default).\n   */\n  output?: 'console' | 'error';\n  includeTypes?: boolean;\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  table: TableResult; // The parent table instance\n  fillOptions?: FillOptions;\n}) => Promise<void>;\n\nexport type { HeaderStrategy } from './strategies/headers';\nexport type { CellNavigationStrategy } from './strategies/columns';\n\n/**\n * Strategy to resolve column names (string or regex) to their index.\n */\nexport type { ColumnResolutionStrategy } from './strategies/resolution';\n\n/**\n * Strategy to filter rows based on criteria.\n */\nexport interface FilterStrategy {\n  apply(options: {\n    rows: Locator;\n    filter: { column: string, value: string | RegExp | number };\n    colIndex: number;\n    tableContext: TableContext;\n  }): Locator;\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  /** Strategy for navigating to specific cells (row + column) */\n  cellNavigation?: CellNavigationStrategy;\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  /** Function to get a cell locator */\n  getCellLocator?: GetCellLocatorFn;\n  /** Function to get the currently active/focused cell */\n  getActiveCell?: GetActiveCellFn;\n}\n\n/**\n * Configuration options for useTable.\n */\nexport interface TableConfig {\n  /** Selector for the table headers */\n  headerSelector?: string;\n  /** Selector for the table rows */\n  rowSelector?: string;\n  /** Selector for the cells within a row */\n  cellSelector?: string;\n  /** Number of pages to scan for verification */\n  maxPages?: number;\n  /** Hook to rename columns dynamically */\n  headerTransformer?: (args: { text: string, index: number, locator: Locator }) => string | Promise<string>;\n  /** Automatically scroll to table on init */\n  autoScroll?: boolean;\n  /** Enable debug logs */\n  debug?: boolean;\n  /** Reset hook */\n  onReset?: (context: TableContext) => Promise<void>;\n  /** All interaction strategies */\n  strategies?: TableStrategies;\n}\n\nexport interface FinalTableConfig extends TableConfig {\n  headerSelector: string;\n  rowSelector: string;\n  cellSelector: string;\n  maxPages: number;\n  autoScroll: boolean;\n  debug: boolean;\n  headerTransformer: (args: { text: string, index: number, locator: Locator }) => 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\nexport interface TableResult<T = any> {\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>;\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   */\n  getRow: (\n    filters: Record<string, string | RegExp | number>,\n    options?: { exact?: boolean }\n  ) => SmartRow;\n\n  /**\n   * Gets a row by 1-based index on the current page.\n   * Throws error if table is not initialized.\n   * @param index 1-based row index\n   * @param options Optional settings including bringIntoView\n   */\n  getRowByIndex: (\n    index: number,\n    options?: { bringIntoView?: boolean }\n  ) => SmartRow;\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, string | RegExp | number>,\n    options?: { exact?: boolean, maxPages?: number }\n  ) => Promise<SmartRow>;\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\n   * @param options - Search options including exact match, max pages, and asJSON\n   */\n  findRows: <R extends { asJSON?: boolean }>(\n    filters: Record<string, string | RegExp | number>,\n    options?: { exact?: boolean, maxPages?: number } & R\n  ) => Promise<R['asJSON'] extends true ? Record<string, string>[] : SmartRow[]>;\n\n  /**\n   * Navigates to a specific column using the configured CellNavigationStrategy.\n   */\n  scrollToColumn: (columnName: string) => Promise<void>;\n\n  /**\n   * ASYNC: Gets all rows on the current page only (does not paginate).\n   * Auto-initializes the table if not already initialized.\n   * @param options - Filter and formatting options\n   */\n  getRows: <R extends { asJSON?: boolean }>(\n    options?: { filter?: Record<string, any>, exact?: boolean } & R\n  ) => Promise<R['asJSON'] extends true ? Record<string, string>[] : SmartRow[]>;\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   * Scans a specific column across all pages and returns the values.\n   */\n  getColumnValues: <V = string>(column: string, options?: { mapper?: (cell: Locator) => Promise<V> | V, maxPages?: number }) => Promise<V[]>;\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   * Iterates through paginated table data, calling the callback for each iteration.\n   * Callback return values are automatically appended to allData, which is returned.\n   */\n  iterateThroughTable: <T = any>(\n    callback: (context: {\n      index: number;\n      isFirst: boolean;\n      isLast: boolean;\n      rows: SmartRow[];\n      allData: T[];\n      table: RestrictedTableResult;\n      batchInfo?: {\n        startIndex: number;\n        endIndex: number;\n        size: number;\n      };\n    }) => T | Promise<T>,\n    options?: {\n      pagination?: PaginationStrategy;\n      dedupeStrategy?: DedupeStrategy;\n      maxIterations?: number;\n      batchSize?: number;\n      getIsFirst?: (context: { index: number }) => boolean;\n      getIsLast?: (context: { index: number, paginationResult: boolean }) => boolean;\n      beforeFirst?: (context: { index: number, rows: SmartRow[], allData: any[] }) => void | Promise<void>;\n      afterLast?: (context: { index: number, rows: SmartRow[], allData: any[] }) => void | Promise<void>;\n    }\n  ) => Promise<T[]>;\n}\n\n/**\n * Restricted table result that excludes methods that shouldn't be called during iteration.\n */\nexport type RestrictedTableResult<T = any> = Omit<TableResult<T>, 'searchForRow' | 'iterateThroughTable' | 'reset'>;\n";