@rickcedwhat/playwright-smart-table 6.0.1 → 6.1.1

package/dist/{examples/glide-strategies → strategies/glide}/columns.d.ts

@@ -1,4 +1,4 @@
-import { StrategyContext } from '../../src/types';
+import { StrategyContext } from '../../types';
 /**
  * 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).

package/dist/{examples/glide-strategies → strategies/glide}/headers.d.ts

@@ -1,4 +1,4 @@
-import { StrategyContext } from '../../src/types';
+import { StrategyContext } from '../../types';
 /**
  * Scans for headers by finding a scrollable container and setting scrollLeft.
  */

package/dist/{src/strategies → strategies}/glide.js

@@ -10,8 +10,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GlideStrategies = exports.glideGetActiveCell = exports.glideGetCellLocator = exports.glidePaginationStrategy = exports.glideFillStrategy = void 0;
-const columns_1 = require("../../examples/glide-strategies/columns");
-const headers_1 = require("../../examples/glide-strategies/headers");
+const columns_1 = require("./glide/columns");
+const headers_1 = require("./glide/headers");
 const pagination_1 = require("./pagination");
 const stabilization_1 = require("./stabilization");
 const glideFillStrategy = (_a) => __awaiter(void 0, [_a], void 0, function* ({ value, page }) {

package/dist/strategies/index.d.ts

@@ -4,10 +4,21 @@ export * from './columns';
 export * from './headers';
 export * from './fill';
 export * from './resolution';
+export * from './dedupe';
+export * from './loading';
 export declare const Strategies: {
     Pagination: {
-        clickNext: (nextButtonSelector: import("..").Selector, timeout?: number) => import("..").PaginationStrategy;
-        infiniteScroll: (timeout?: number) => import("..").PaginationStrategy;
+        clickNext: (nextButtonSelector: import("..").Selector, options?: {
+            stabilization?: import("./stabilization").StabilizationStrategy;
+            timeout?: number;
+        }) => import("..").PaginationStrategy;
+        infiniteScroll: (options?: {
+            action?: "scroll" | "js-scroll";
+            scrollTarget?: import("..").Selector;
+            scrollAmount?: number;
+            stabilization?: import("./stabilization").StabilizationStrategy;
+            timeout?: number;
+        }) => import("..").PaginationStrategy;
     };
     Sorting: {
         AriaSort: () => import("..").SortingStrategy;
@@ -24,4 +35,20 @@ export declare const Strategies: {
     Resolution: {
         default: import("./resolution").ColumnResolutionStrategy;
     };
+    Dedupe: {
+        byTopPosition: (tolerance?: number) => import("..").DedupeStrategy;
+    };
+    Loading: {
+        Table: {
+            hasSpinner: (selector?: string) => ({ root }: import("..").TableContext) => Promise<boolean>;
+            custom: (fn: (context: import("..").TableContext) => Promise<boolean>) => (context: import("..").TableContext) => Promise<boolean>;
+            never: () => Promise<boolean>;
+        };
+        Row: {
+            hasClass: (className?: string) => (row: import("..").SmartRow) => Promise<boolean>;
+            hasText: (text?: string | RegExp) => (row: import("..").SmartRow) => Promise<boolean>;
+            hasEmptyCells: () => (row: import("..").SmartRow) => Promise<boolean>;
+            never: () => Promise<boolean>;
+        };
+    };
 };

package/dist/strategies/index.js

@@ -21,12 +21,16 @@ const columns_1 = require("./columns");
 const headers_1 = require("./headers");
 const fill_1 = require("./fill");
 const resolution_1 = require("./resolution");
+const dedupe_1 = require("./dedupe");
+const loading_1 = require("./loading");
 __exportStar(require("./pagination"), exports);
 __exportStar(require("./sorting"), exports);
 __exportStar(require("./columns"), exports);
 __exportStar(require("./headers"), exports);
 __exportStar(require("./fill"), exports);
 __exportStar(require("./resolution"), exports);
+__exportStar(require("./dedupe"), exports);
+__exportStar(require("./loading"), exports);
 exports.Strategies = {
     Pagination: pagination_1.PaginationStrategies,
     Sorting: sorting_1.SortingStrategies,
@@ -34,4 +38,6 @@ exports.Strategies = {
     Header: headers_1.HeaderStrategies,
     Fill: fill_1.FillStrategies,
     Resolution: resolution_1.ResolutionStrategies,
+    Dedupe: dedupe_1.DedupeStrategies,
+    Loading: loading_1.LoadingStrategies,
 };

package/dist/strategies/pagination.d.ts

@@ -1,11 +1,33 @@
 import type { PaginationStrategy, Selector } from '../types';
+import { StabilizationStrategy } from './stabilization';
 export declare const PaginationStrategies: {
     /**
-     * Strategy: Clicks a "Next" button and waits for the first row of data to change.
+     * Strategy: Clicks a "Next" button and waits for stabilization.
+     * @param nextButtonSelector Selector for the next page button.
+     * @param options.stabilization Strategy to determine when the page has updated.
+     *        Defaults to `contentChanged({ scope: 'first' })`.
+     * @param options.timeout Timeout for the click action.
      */
-    clickNext: (nextButtonSelector: Selector, timeout?: number) => PaginationStrategy;
+    clickNext: (nextButtonSelector: Selector, options?: {
+        stabilization?: StabilizationStrategy;
+        timeout?: number;
+    }) => PaginationStrategy;
     /**
-     * Strategy: Scrolls to the bottom and waits for more rows to appear.
+     * Strategy: Infinite Scroll (generic).
+     * Supports both simple "Scroll to Bottom" and "Virtualized Scroll".
+     *
+     * @param options.action 'scroll' (mouse wheel) or 'js-scroll' (direct scrollTop).
+     * @param options.scrollTarget Selector for the scroll container (defaults to table root).
+     * @param options.scrollAmount Amount to scroll in pixels (default 500).
+     * @param options.stabilization Strategy to determine if new content loaded.
+     *        Defaults to `rowCountIncreased` (simple append).
+     *        Use `contentChanged` for virtualization.
      */
-    infiniteScroll: (timeout?: number) => PaginationStrategy;
+    infiniteScroll: (options?: {
+        action?: "scroll" | "js-scroll";
+        scrollTarget?: Selector;
+        scrollAmount?: number;
+        stabilization?: StabilizationStrategy;
+        timeout?: number;
+    }) => PaginationStrategy;
 };

package/dist/strategies/pagination.js

@@ -10,41 +10,70 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PaginationStrategies = void 0;
-const utils_1 = require("../utils");
+const stabilization_1 = require("./stabilization");
 exports.PaginationStrategies = {
     /**
-     * Strategy: Clicks a "Next" button and waits for the first row of data to change.
+     * Strategy: Clicks a "Next" button and waits for stabilization.
+     * @param nextButtonSelector Selector for the next page button.
+     * @param options.stabilization Strategy to determine when the page has updated.
+     *        Defaults to `contentChanged({ scope: 'first' })`.
+     * @param options.timeout Timeout for the click action.
      */
-    clickNext: (nextButtonSelector, timeout = 5000) => {
-        return (_a) => __awaiter(void 0, [_a], void 0, function* ({ root, config, resolve, page }) {
+    clickNext: (nextButtonSelector, options = {}) => {
+        return (context) => __awaiter(void 0, void 0, void 0, function* () {
+            var _a;
+            const { root, resolve, page } = context;
             const nextBtn = resolve(nextButtonSelector, root).first();
             if (!(yield nextBtn.isVisible()) || !(yield nextBtn.isEnabled())) {
                 return false;
             }
-            const firstRow = resolve(config.rowSelector, root).first();
-            const oldText = yield firstRow.innerText().catch(() => "");
-            yield nextBtn.click({ timeout: 2000 }).catch(() => { });
-            const success = yield (0, utils_1.waitForCondition)(() => __awaiter(void 0, void 0, void 0, function* () {
-                const newText = yield firstRow.innerText().catch(() => "");
-                return newText !== oldText;
-            }), timeout, page);
+            // Default stabilization: Wait for first row content to change
+            const stabilization = (_a = options.stabilization) !== null && _a !== void 0 ? _a : stabilization_1.StabilizationStrategies.contentChanged({ scope: 'first', timeout: options.timeout });
+            // Stabilization: Wrap action
+            const success = yield stabilization(context, () => __awaiter(void 0, void 0, void 0, function* () {
+                yield nextBtn.click({ timeout: 2000 }).catch(() => { });
+            }));
             return success;
         });
     },
     /**
-     * Strategy: Scrolls to the bottom and waits for more rows to appear.
+     * Strategy: Infinite Scroll (generic).
+     * Supports both simple "Scroll to Bottom" and "Virtualized Scroll".
+     *
+     * @param options.action 'scroll' (mouse wheel) or 'js-scroll' (direct scrollTop).
+     * @param options.scrollTarget Selector for the scroll container (defaults to table root).
+     * @param options.scrollAmount Amount to scroll in pixels (default 500).
+     * @param options.stabilization Strategy to determine if new content loaded.
+     *        Defaults to `rowCountIncreased` (simple append).
+     *        Use `contentChanged` for virtualization.
      */
-    infiniteScroll: (timeout = 5000) => {
-        return (_a) => __awaiter(void 0, [_a], void 0, function* ({ root, config, resolve, page }) {
-            const rows = resolve(config.rowSelector, root);
-            const oldCount = yield rows.count();
-            if (oldCount === 0)
-                return false;
-            yield rows.last().scrollIntoViewIfNeeded();
-            return yield (0, utils_1.waitForCondition)(() => __awaiter(void 0, void 0, void 0, function* () {
-                const newCount = yield rows.count();
-                return newCount > oldCount;
-            }), timeout, page);
+    infiniteScroll: (options = {}) => {
+        return (context) => __awaiter(void 0, void 0, void 0, function* () {
+            var _a, _b;
+            const { root, resolve, page } = context;
+            const scrollTarget = options.scrollTarget
+                ? resolve(options.scrollTarget, root)
+                : root;
+            // Default stabilization: Wait for row count to increase (Append mode)
+            const stabilization = (_a = options.stabilization) !== null && _a !== void 0 ? _a : stabilization_1.StabilizationStrategies.rowCountIncreased({ timeout: options.timeout });
+            const amount = (_b = options.scrollAmount) !== null && _b !== void 0 ? _b : 500;
+            const doScroll = () => __awaiter(void 0, void 0, void 0, function* () {
+                const box = yield scrollTarget.boundingBox();
+                // Action: Scroll
+                if (options.action === 'js-scroll' || !box) {
+                    yield scrollTarget.evaluate((el, y) => {
+                        el.scrollTop += y;
+                    }, amount);
+                }
+                else {
+                    // Mouse Wheel
+                    yield page.mouse.move(box.x + box.width / 2, box.y + box.height / 2);
+                    yield page.mouse.wheel(0, amount);
+                }
+            });
+            // Stabilization: Wait
+            const success = yield stabilization(context, doScroll);
+            return success;
         });
     }
 };

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 = "\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\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 {\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  /** 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\nexport interface FinalTableConfig extends TableConfig {\n  headerSelector: string;\n  rowSelector: string;\n  cellSelector: string;\n  maxPages: number;\n  autoScroll: boolean;\n  debug?: TableConfig['debug'];\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\n/**\n * Options for generateConfigPrompt\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  /**\n   * Include TypeScript type definitions in the prompt\n   * @default true\n   */\n  includeTypes?: boolean;\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   * Gets all rows on the current page only (does not paginate).\n   * Auto-initializes the table if not already initialized.\n   * Returns a SmartRowArray which extends Array with a toJSON() helper method.\n   * @param options - Filter options\n   */\n  getRows: (options?: { filter?: Record<string, any>, exact?: boolean }) => Promise<SmartRowArray>;\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   * Generate an AI-friendly configuration prompt for debugging.\n   * Outputs table HTML and TypeScript definitions to help AI assistants generate config.\n   */\n  generateConfigPrompt: (options?: PromptOptions) => Promise<void>;\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";
+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\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 {\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 * Strategy to check if the table or rows are loading.\n */\nexport interface LoadingStrategy {\n  isTableLoading?: (context: TableContext) => Promise<boolean>;\n  isRowLoading?: (row: SmartRow) => Promise<boolean>;\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  /** 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  /** Custom helper to check if a table is fully loaded/ready */\n  isTableLoaded?: (args: TableContext) => Promise<boolean>;\n  /** Custom helper to check if a row is fully loaded/ready */\n  isRowLoaded?: (args: { row: Locator, index: number }) => Promise<boolean>;\n  /** Custom helper to check if a cell is fully loaded/ready (e.g. for editing) */\n  isCellLoaded?: (args: { cell: Locator, column: string, row: Locator }) => Promise<boolean>;\n  /** Strategy for detecting loading states */\n  loading?: LoadingStrategy;\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, 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\nexport interface FinalTableConfig extends TableConfig {\n  headerSelector: string;\n  rowSelector: string;\n  cellSelector: string;\n  maxPages: number;\n  autoScroll: boolean;\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 * Options for generateConfigPrompt\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  /**\n   * Include TypeScript type definitions in the prompt\n   * @default true\n   */\n  includeTypes?: boolean;\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   * Gets all rows on the current page only (does not paginate).\n   * Auto-initializes the table if not already initialized.\n   * Returns a SmartRowArray which extends Array with a toJSON() helper method.\n   * @param options - Filter options\n   */\n  getRows: (options?: { filter?: Record<string, any>, exact?: boolean }) => Promise<SmartRowArray>;\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: SmartRowArray;\n      allData: T[];\n      table: RestrictedTableResult;\n      batchInfo?: {\n        startIndex: number;\n        endIndex: number;\n        size: number;\n      };\n\n    }) => T | T[] | Promise<T | 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       * If true, flattens array results from callback into the main data array.\n       * If false (default), pushes the return value as-is (preserves batching/arrays).\n       */\n      autoFlatten?: boolean;\n    }\n  ) => Promise<T[]>;\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   */\n  generateConfigPrompt: (options?: PromptOptions) => Promise<void>;\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";

package/dist/typeContext.js

@@ -210,6 +210,14 @@ export interface FilterStrategy {
   }): Locator;
 }
 
+/**
+ * Strategy to check if the table or rows are loading.
+ */
+export interface LoadingStrategy {
+  isTableLoading?: (context: TableContext) => Promise<boolean>;
+  isRowLoading?: (row: SmartRow) => Promise<boolean>;
+}
+
 /**
  * Organized container for all table interaction strategies.
  */
@@ -224,10 +232,20 @@ export interface TableStrategies {
   pagination?: PaginationStrategy;
   /** Strategy for sorting columns */
   sorting?: SortingStrategy;
+  /** Strategy for deduplicating rows during iteration/scrolling */
+  dedupe?: DedupeStrategy;
   /** Function to get a cell locator */
   getCellLocator?: GetCellLocatorFn;
   /** Function to get the currently active/focused cell */
   getActiveCell?: GetActiveCellFn;
+  /** Custom helper to check if a table is fully loaded/ready */
+  isTableLoaded?: (args: TableContext) => Promise<boolean>;
+  /** Custom helper to check if a row is fully loaded/ready */
+  isRowLoaded?: (args: { row: Locator, index: number }) => Promise<boolean>;
+  /** Custom helper to check if a cell is fully loaded/ready (e.g. for editing) */
+  isCellLoaded?: (args: { cell: Locator, column: string, row: Locator }) => Promise<boolean>;
+  /** Strategy for detecting loading states */
+  loading?: LoadingStrategy;
 }
 
 /**
@@ -243,7 +261,7 @@ export interface TableConfig {
   /** Number of pages to scan for verification */
   maxPages?: number;
   /** Hook to rename columns dynamically */
-  headerTransformer?: (args: { text: string, index: number, locator: Locator }) => string | Promise<string>;
+  headerTransformer?: (args: { text: string, index: number, locator: Locator, seenHeaders: Set<string> }) => string | Promise<string>;
   /** Automatically scroll to table on init */
   autoScroll?: boolean;
   /** Debug options for development and troubleshooting */
@@ -261,7 +279,7 @@ export interface FinalTableConfig extends TableConfig {
   maxPages: number;
   autoScroll: boolean;
   debug?: TableConfig['debug'];
-  headerTransformer: (args: { text: string, index: number, locator: Locator }) => string | Promise<string>;
+  headerTransformer: (args: { text: string, index: number, locator: Locator, seenHeaders: Set<string> }) => string | Promise<string>;
   onReset: (context: TableContext) => Promise<void>;
   strategies: TableStrategies;
 }
@@ -406,7 +424,7 @@ export interface TableResult<T = any> {
       index: number;
       isFirst: boolean;
       isLast: boolean;
-      rows: SmartRow[];
+      rows: SmartRowArray;
       allData: T[];
       table: RestrictedTableResult;
       batchInfo?: {
@@ -414,7 +432,8 @@ export interface TableResult<T = any> {
         endIndex: number;
         size: number;
       };
-    }) => T | Promise<T>,
+
+    }) => T | T[] | Promise<T | T[]>,
     options?: {
       pagination?: PaginationStrategy;
       dedupeStrategy?: DedupeStrategy;
@@ -424,6 +443,11 @@ export interface TableResult<T = any> {
       getIsLast?: (context: { index: number, paginationResult: boolean }) => boolean;
       beforeFirst?: (context: { index: number, rows: SmartRow[], allData: any[] }) => void | Promise<void>;
       afterLast?: (context: { index: number, rows: SmartRow[], allData: any[] }) => void | Promise<void>;
+      /**
+       * If true, flattens array results from callback into the main data array.
+       * If false (default), pushes the return value as-is (preserves batching/arrays).
+       */
+      autoFlatten?: boolean;
     }
   ) => Promise<T[]>;
 

package/dist/types.d.ts

@@ -192,6 +192,13 @@ export interface FilterStrategy {
         tableContext: TableContext;
     }): Locator;
 }
+/**
+ * Strategy to check if the table or rows are loading.
+ */
+export interface LoadingStrategy {
+    isTableLoading?: (context: TableContext) => Promise<boolean>;
+    isRowLoading?: (row: SmartRow) => Promise<boolean>;
+}
 /**
  * Organized container for all table interaction strategies.
  */
@@ -206,10 +213,27 @@ export interface TableStrategies {
     pagination?: PaginationStrategy;
     /** Strategy for sorting columns */
     sorting?: SortingStrategy;
+    /** Strategy for deduplicating rows during iteration/scrolling */
+    dedupe?: DedupeStrategy;
     /** Function to get a cell locator */
     getCellLocator?: GetCellLocatorFn;
     /** Function to get the currently active/focused cell */
     getActiveCell?: GetActiveCellFn;
+    /** Custom helper to check if a table is fully loaded/ready */
+    isTableLoaded?: (args: TableContext) => Promise<boolean>;
+    /** Custom helper to check if a row is fully loaded/ready */
+    isRowLoaded?: (args: {
+        row: Locator;
+        index: number;
+    }) => Promise<boolean>;
+    /** Custom helper to check if a cell is fully loaded/ready (e.g. for editing) */
+    isCellLoaded?: (args: {
+        cell: Locator;
+        column: string;
+        row: Locator;
+    }) => Promise<boolean>;
+    /** Strategy for detecting loading states */
+    loading?: LoadingStrategy;
 }
 /**
  * Configuration options for useTable.
@@ -228,6 +252,7 @@ export interface TableConfig {
         text: string;
         index: number;
         locator: Locator;
+        seenHeaders: Set<string>;
     }) => string | Promise<string>;
     /** Automatically scroll to table on init */
     autoScroll?: boolean;
@@ -249,6 +274,7 @@ export interface FinalTableConfig extends TableConfig {
         text: string;
         index: number;
         locator: Locator;
+        seenHeaders: Set<string>;
     }) => string | Promise<string>;
     onReset: (context: TableContext) => Promise<void>;
     strategies: TableStrategies;
@@ -384,7 +410,7 @@ export interface TableResult<T = any> {
         index: number;
         isFirst: boolean;
         isLast: boolean;
-        rows: SmartRow[];
+        rows: SmartRowArray;
         allData: T[];
         table: RestrictedTableResult;
         batchInfo?: {
@@ -392,7 +418,7 @@ export interface TableResult<T = any> {
             endIndex: number;
             size: number;
         };
-    }) => T | Promise<T>, options?: {
+    }) => T | T[] | Promise<T | T[]>, options?: {
         pagination?: PaginationStrategy;
         dedupeStrategy?: DedupeStrategy;
         maxIterations?: number;
@@ -414,6 +440,11 @@ export interface TableResult<T = any> {
             rows: SmartRow[];
             allData: any[];
         }) => void | Promise<void>;
+        /**
+         * If true, flattens array results from callback into the main data array.
+         * If false (default), pushes the return value as-is (preserves batching/arrays).
+         */
+        autoFlatten?: boolean;
     }) => Promise<T[]>;
     /**
      * Generate an AI-friendly configuration prompt for debugging.

package/dist/useTable.d.ts

@@ -1,5 +1,5 @@
 import type { Locator } from '@playwright/test';
-import { TableConfig, Selector, TableResult, PaginationStrategy } from './types';
+import { TableConfig, TableContext, Selector, TableResult, SmartRow as SmartRowType, DedupeStrategy, PaginationStrategy } from './types';
 import { FillStrategies } from './strategies/fill';
 import { HeaderStrategies } from './strategies/headers';
 import { CellNavigationStrategies } from './strategies/columns';
@@ -10,10 +10,35 @@ import { Strategies } from './strategies';
  */
 export declare const useTable: <T = any>(rootLocator: Locator, configOptions?: TableConfig) => TableResult<T>;
 export declare const PaginationStrategies: {
-    clickNext: (nextButtonSelector: Selector, timeout?: number) => PaginationStrategy;
-    infiniteScroll: (timeout?: number) => PaginationStrategy;
+    clickNext: (nextButtonSelector: Selector, options?: {
+        stabilization?: import("./strategies/stabilization").StabilizationStrategy;
+        timeout?: number;
+    }) => PaginationStrategy;
+    infiniteScroll: (options?: {
+        action?: "scroll" | "js-scroll";
+        scrollTarget?: Selector;
+        scrollAmount?: number;
+        stabilization?: import("./strategies/stabilization").StabilizationStrategy;
+        timeout?: number;
+    }) => PaginationStrategy;
+};
+export declare const LoadingStrategies: {
+    Table: {
+        hasSpinner: (selector?: string) => ({ root }: TableContext) => Promise<boolean>;
+        custom: (fn: (context: TableContext) => Promise<boolean>) => (context: TableContext) => Promise<boolean>;
+        never: () => Promise<boolean>;
+    };
+    Row: {
+        hasClass: (className?: string) => (row: SmartRowType) => Promise<boolean>;
+        hasText: (text?: string | RegExp) => (row: SmartRowType) => Promise<boolean>;
+        hasEmptyCells: () => (row: SmartRowType) => Promise<boolean>;
+        never: () => Promise<boolean>;
+    };
 };
 export declare const SortingStrategies: {
     AriaSort: () => import("./types").SortingStrategy;
 };
+export declare const DedupeStrategies: {
+    byTopPosition: (tolerance?: number) => DedupeStrategy;
+};
 export { FillStrategies, HeaderStrategies, CellNavigationStrategies, ResolutionStrategies, Strategies };