@rickcedwhat/playwright-smart-table 6.3.2 → 6.4.0

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './useTable';
 export * from './types';
 export * from './plugins';
+export * from './strategies';

package/dist/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./useTable"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./plugins"), exports);
+__exportStar(require("./strategies"), exports);

package/dist/minimalConfigContext.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 🤖 AUTO-GENERATED FILE. DO NOT EDIT.
+ * This file is generated by scripts/embed-config-types.mjs
+ * It contains minimal type definitions for config generation prompts.
+ */
+export declare const MINIMAL_CONFIG_CONTEXT = "\n/**\n * Flexible selector type - can be a CSS string or function returning a Locator.\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 * Debug configuration for development and troubleshooting\n */\nexport type DebugConfig = {\n  slow?: number | {\n    pagination?: number;\n    getCell?: number;\n    findRow?: number;\n    default?: number;\n  };\n  logLevel?: 'verbose' | 'info' | 'error' | 'none';\n};\n\n/**\n * Configuration options for useTable - focus on selectors and basic setup\n */\nexport interface TableConfig<T = any> {\n  /** CSS selector or function for table headers */\n  headerSelector?: string | ((root: Locator) => Locator);\n  \n  /** CSS selector or function for table rows */\n  rowSelector?: string | ((root: Locator) => Locator);\n  \n  /** CSS selector or function for cells within a row */\n  cellSelector?: string | ((row: Locator) => Locator);\n  \n  /** Transform header text (e.g., normalize, deduplicate) */\n  headerTransformer?: (args: { \n    text: string; \n    index: number; \n    locator: Locator;\n    seenHeaders: Set<string>;\n  }) => string | Promise<string>;\n  \n  /** Automatically scroll to table on init (default: true) */\n  autoScroll?: boolean;\n  \n  /** Debug options for development and troubleshooting */\n  debug?: DebugConfig;\n  \n  /** Advanced: Custom strategies for pagination, sorting, navigation, etc. */\n  strategies?: TableStrategies;\n  \n  /** Custom data mappers for extracting complex types (boolean, number) */\n  dataMapper?: Partial<Record<keyof T, (cell: Locator) => Promise<T[keyof T]> | T[keyof T]>>;\n}\n\n/**\n * Example usage:\n */\n// const table = useTable(page.locator('table'), {\n//   headerSelector: 'thead th',\n//   rowSelector: 'tbody tr',\n//   cellSelector: 'td',\n//   headerTransformer: ({ text }) => text.trim()\n// });\n\n";

package/dist/minimalConfigContext.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MINIMAL_CONFIG_CONTEXT = void 0;
+/**
+ * 🤖 AUTO-GENERATED FILE. DO NOT EDIT.
+ * This file is generated by scripts/embed-config-types.mjs
+ * It contains minimal type definitions for config generation prompts.
+ */
+exports.MINIMAL_CONFIG_CONTEXT = `
+/**
+ * Flexible selector type - can be a CSS string or function returning a Locator.
+ * @example
+ * // String selector
+ * rowSelector: 'tbody tr'
+ * 
+ * // Function selector
+ * rowSelector: (root) => root.locator('[role="row"]')
+ */
+export type Selector = string | ((root: Locator | Page) => Locator);
+
+/**
+ * Debug configuration for development and troubleshooting
+ */
+export type DebugConfig = {
+  slow?: number | {
+    pagination?: number;
+    getCell?: number;
+    findRow?: number;
+    default?: number;
+  };
+  logLevel?: 'verbose' | 'info' | 'error' | 'none';
+};
+
+/**
+ * Configuration options for useTable - focus on selectors and basic setup
+ */
+export interface TableConfig<T = any> {
+  /** CSS selector or function for table headers */
+  headerSelector?: string | ((root: Locator) => Locator);
+  
+  /** CSS selector or function for table rows */
+  rowSelector?: string | ((root: Locator) => Locator);
+  
+  /** CSS selector or function for cells within a row */
+  cellSelector?: string | ((row: Locator) => Locator);
+  
+  /** Transform header text (e.g., normalize, deduplicate) */
+  headerTransformer?: (args: { 
+    text: string; 
+    index: number; 
+    locator: Locator;
+    seenHeaders: Set<string>;
+  }) => string | Promise<string>;
+  
+  /** Automatically scroll to table on init (default: true) */
+  autoScroll?: boolean;
+  
+  /** Debug options for development and troubleshooting */
+  debug?: DebugConfig;
+  
+  /** Advanced: Custom strategies for pagination, sorting, navigation, etc. */
+  strategies?: TableStrategies;
+  
+  /** Custom data mappers for extracting complex types (boolean, number) */
+  dataMapper?: Partial<Record<keyof T, (cell: Locator) => Promise<T[keyof T]> | T[keyof T]>>;
+}
+
+/**
+ * Example usage:
+ */
+// const table = useTable(page.locator('table'), {
+//   headerSelector: 'thead th',
+//   rowSelector: 'tbody tr',
+//   cellSelector: 'td',
+//   headerTransformer: ({ text }) => text.trim()
+// });
+
+`;

package/dist/plugins.d.ts

@@ -4,6 +4,13 @@ export declare const Plugins: {
             header: (context: import("./types").TableContext) => Promise<string[]>;
             getCellLocator: ({ row, columnIndex }: any) => any;
             cellNavigation: ({ root, page, index }: any) => Promise<void>;
+            navigation: {
+                goRight: ({ root, page }: any) => Promise<void>;
+                goLeft: ({ root, page }: any) => Promise<void>;
+                goDown: ({ root, page }: any) => Promise<void>;
+                goUp: ({ root, page }: any) => Promise<void>;
+                goHome: ({ root, page }: any) => Promise<void>;
+            };
             pagination: import("./types").PaginationStrategy;
         };
     };

package/dist/smartRow.js

@@ -77,33 +77,21 @@ const _navigateToCell = (params) => __awaiter(void 0, void 0, void 0, function*
             }
         }
         yield page.waitForTimeout(50);
-    }
-    else if (config.strategies.cellNavigation) {
-        // Fallback to legacy cellNavigation strategy
-        yield config.strategies.cellNavigation({
-            config,
-            root: rootLocator,
-            page,
-            resolve,
-            column,
-            index,
-            rowLocator,
-            rowIndex,
-            activeCell
-        });
-    }
-    // Get the active cell locator after navigation (for virtualized tables)
-    if (config.strategies.getActiveCell) {
-        const updatedActiveCell = yield config.strategies.getActiveCell({
-            config,
-            root: rootLocator,
-            page,
-            resolve
-        });
-        if (updatedActiveCell) {
-            return updatedActiveCell.locator;
+        // Get the active cell locator after navigation (for virtualized tables)
+        if (config.strategies.getActiveCell) {
+            const updatedActiveCell = yield config.strategies.getActiveCell({
+                config,
+                root: rootLocator,
+                page,
+                resolve
+            });
+            if (updatedActiveCell) {
+                return updatedActiveCell.locator;
+            }
         }
+        return null;
     }
+    ;
     return null;
 });
 /**

package/dist/strategies/rdg.d.ts

@@ -17,9 +17,23 @@ export declare const rdgCellNavigation: ({ root, page, index }: any) => Promise<
  * Scrolls the grid vertically to load more virtualized rows.
  */
 export declare const rdgPaginationStrategy: import("../types").PaginationStrategy;
+export declare const rdgNavigation: {
+    goRight: ({ root, page }: any) => Promise<void>;
+    goLeft: ({ root, page }: any) => Promise<void>;
+    goDown: ({ root, page }: any) => Promise<void>;
+    goUp: ({ root, page }: any) => Promise<void>;
+    goHome: ({ root, page }: any) => Promise<void>;
+};
 export declare const RDGStrategies: {
     header: (context: TableContext) => Promise<string[]>;
     getCellLocator: ({ row, columnIndex }: any) => any;
     cellNavigation: ({ root, page, index }: any) => Promise<void>;
+    navigation: {
+        goRight: ({ root, page }: any) => Promise<void>;
+        goLeft: ({ root, page }: any) => Promise<void>;
+        goDown: ({ root, page }: any) => Promise<void>;
+        goUp: ({ root, page }: any) => Promise<void>;
+        goHome: ({ root, page }: any) => Promise<void>;
+    };
     pagination: import("../types").PaginationStrategy;
 };

package/dist/strategies/rdg.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RDGStrategies = exports.rdgPaginationStrategy = exports.rdgCellNavigation = exports.rdgGetCellLocator = exports.scrollRightHeaderRDG = void 0;
+exports.RDGStrategies = exports.rdgNavigation = exports.rdgPaginationStrategy = exports.rdgCellNavigation = exports.rdgGetCellLocator = exports.scrollRightHeaderRDG = void 0;
 /**
  * Scrolls the grid horizontally to collect all column headers.
  * Handles empty headers by labeling them (e.g. "Checkbox").
@@ -20,6 +20,7 @@ const scrollRightHeaderRDG = (context) => __awaiter(void 0, void 0, void 0, func
     const gridHandle = yield root.evaluateHandle((el) => {
         return el.querySelector('[role="grid"]') || el.closest('[role="grid"]');
     });
+    const scrollContainer = gridHandle; // RDG usually scrolls the grid container itself
     const expectedColumns = yield gridHandle.evaluate(el => el ? parseInt(el.getAttribute('aria-colcount') || '0', 10) : 0);
     const getVisible = () => __awaiter(void 0, void 0, void 0, function* () {
         const headerLoc = resolve(config.headerSelector, root);
@@ -92,9 +93,50 @@ exports.rdgPaginationStrategy = pagination_1.PaginationStrategies.infiniteScroll
     scrollAmount: 500,
     stabilization: stabilization_1.StabilizationStrategies.contentChanged({ timeout: 5000 })
 });
+exports.rdgNavigation = {
+    goRight: (_a) => __awaiter(void 0, [_a], void 0, function* ({ root, page }) {
+        yield root.evaluate((el) => {
+            // Find grid container
+            const grid = el.querySelector('[role="grid"]') || el.closest('[role="grid"]') || el;
+            if (grid)
+                grid.scrollLeft += 150;
+        });
+    }),
+    goLeft: (_a) => __awaiter(void 0, [_a], void 0, function* ({ root, page }) {
+        yield root.evaluate((el) => {
+            const grid = el.querySelector('[role="grid"]') || el.closest('[role="grid"]') || el;
+            if (grid)
+                grid.scrollLeft -= 150;
+        });
+    }),
+    goDown: (_a) => __awaiter(void 0, [_a], void 0, function* ({ root, page }) {
+        yield root.evaluate((el) => {
+            const grid = el.querySelector('[role="grid"]') || el.closest('[role="grid"]') || el;
+            if (grid)
+                grid.scrollTop += 35;
+        });
+    }),
+    goUp: (_a) => __awaiter(void 0, [_a], void 0, function* ({ root, page }) {
+        yield root.evaluate((el) => {
+            const grid = el.querySelector('[role="grid"]') || el.closest('[role="grid"]') || el;
+            if (grid)
+                grid.scrollTop -= 35;
+        });
+    }),
+    goHome: (_a) => __awaiter(void 0, [_a], void 0, function* ({ root, page }) {
+        yield root.evaluate((el) => {
+            const grid = el.querySelector('[role="grid"]') || el.closest('[role="grid"]') || el;
+            if (grid) {
+                grid.scrollLeft = 0;
+                grid.scrollTop = 0;
+            }
+        });
+    })
+};
 exports.RDGStrategies = {
     header: exports.scrollRightHeaderRDG,
     getCellLocator: exports.rdgGetCellLocator,
     cellNavigation: exports.rdgCellNavigation,
+    navigation: exports.rdgNavigation,
     pagination: exports.rdgPaginationStrategy
 };

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 * Value used to filter rows.\n * - string/number/RegExp: filter by text content of the cell.\n * - function: filter by custom locator logic within the cell.\n * @example\n * // Text filter\n * { Name: 'John' }\n * \n * // Custom locator filter (e.g. checkbox is checked)\n * { Status: (cell) => cell.locator('input:checked') }\n */\nexport type FilterValue = string | RegExp | number | ((cell: Locator) => Locator);\n\n/**\n * Function to get a cell locator given row, column info.\n * Replaces the old cellResolver.\n */\nexport type GetCellLocatorFn = (args: {\n  row: Locator;\n  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<T = any> {\n  root: Locator;\n  config: FinalTableConfig<T>;\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, NavigationPrimitives } 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: FilterValue };\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  isHeaderLoading?: (context: TableContext) => 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  /** Primitive navigation functions (goUp, goDown, goLeft, goRight, goHome) */\n  navigation?: NavigationPrimitives;\n  /** @deprecated Use navigation primitives instead. 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 */\n/**\n * Configuration options for useTable.\n */\nexport interface TableConfig<T = any> {\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   * Custom data mappers for specific columns.\n   * Allows extracting complex data types (boolean, number) instead of just string.\n   */\n  dataMapper?: Partial<Record<keyof T, (cell: Locator) => Promise<T[keyof T]> | T[keyof T]>>;\n}\n\nexport interface FinalTableConfigLike<T = any> extends TableConfig<T> {\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// Alias for backward compatibility if needed, or update usages\nexport type FinalTableConfig<T = any> = FinalTableConfigLike<T>;\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, FilterValue>,\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, FilterValue>,\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 and max pages\n   */\n  findRows: (\n    filters: Record<string, FilterValue>,\n    options?: { exact?: boolean, maxPages?: number }\n  ) => Promise<SmartRowArray<T>>;\n\n  /**\n   * Navigates to a specific column using the configured CellNavigationStrategy.\n   */\n  scrollToColumn: (columnName: string) => Promise<void>;\n\n  /**\n   * 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: SmartRowArray, allData: any[] }) => void | Promise<void>;\n      afterLast?: (context: { index: number, rows: SmartRowArray, 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";
+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 * Value used to filter rows.\n * - string/number/RegExp: filter by text content of the cell.\n * - function: filter by custom locator logic within the cell.\n * @example\n * // Text filter\n * { Name: 'John' }\n * \n * // Custom locator filter (e.g. checkbox is checked)\n * { Status: (cell) => cell.locator('input:checked') }\n */\nexport type FilterValue = string | RegExp | number | ((cell: Locator) => Locator);\n\n/**\n * Function to get a cell locator given row, column info.\n * Replaces the old cellResolver.\n */\nexport type GetCellLocatorFn = (args: {\n  row: Locator;\n  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<T = any> {\n  root: Locator;\n  config: FinalTableConfig<T>;\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\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';\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: FilterValue };\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  isHeaderLoading?: (context: TableContext) => 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  /** Primitive navigation functions (goUp, goDown, goLeft, goRight, goHome) */\n  navigation?: NavigationPrimitives;\n\n  /** Strategy for filling form inputs */\n  fill?: FillStrategy;\n  /** Strategy for paginating through data */\n  pagination?: PaginationStrategy;\n  /** Strategy for sorting columns */\n  sorting?: SortingStrategy;\n  /** Strategy for deduplicating rows during iteration/scrolling */\n  dedupe?: DedupeStrategy;\n  /** Function to get a cell locator */\n  getCellLocator?: GetCellLocatorFn;\n  /** Function to get the currently active/focused cell */\n  getActiveCell?: GetActiveCellFn;\n  /** 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\nexport interface TableConfig<T = any> {\n  /** Selector for the table headers */\n  headerSelector?: string | ((root: Locator) => Locator);\n  /** Selector for the table rows */\n  rowSelector?: string;\n  /** Selector for the cells within a row */\n  cellSelector?: string;\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   * Custom data mappers for specific columns.\n   * Allows extracting complex data types (boolean, number) instead of just string.\n   */\n  dataMapper?: Partial<Record<keyof T, (cell: Locator) => Promise<T[keyof T]> | T[keyof T]>>;\n}\n\nexport interface FinalTableConfig<T = any> extends TableConfig<T> {\n  headerSelector: string | ((root: Locator) => Locator);\n  rowSelector: string;\n  cellSelector: string;\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, FilterValue>,\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, FilterValue>,\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 and max pages\n   */\n  findRows: (\n    filters: Record<string, FilterValue>,\n    options?: { exact?: boolean, maxPages?: number }\n  ) => Promise<SmartRowArray<T>>;\n\n  /**\n   * Navigates to a specific column using the configured CellNavigationStrategy.\n   */\n  scrollToColumn: (columnName: string) => Promise<void>;\n\n\n\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: SmartRowArray, allData: any[] }) => void | Promise<void>;\n      afterLast?: (context: { index: number, rows: SmartRowArray, 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

@@ -182,15 +182,7 @@ export type PaginationStrategy = (context: TableContext) => Promise<boolean>;
 
 export type DedupeStrategy = (row: SmartRow) => string | number | Promise<string | number>;
 
-export interface PromptOptions {
-  /**
-   * Output Strategy:
-   * - 'error': Throws an error with the prompt (useful for platforms that capture error output cleanly).
-   * - 'console': Standard console logs (Default).
-   */
-  output?: 'console' | 'error';
-  includeTypes?: boolean;
-}
+
 
 export type FillStrategy = (options: {
   row: SmartRow;
@@ -204,7 +196,6 @@ export type FillStrategy = (options: {
 }) => Promise<void>;
 
 export type { HeaderStrategy } from './strategies/headers';
-export type { CellNavigationStrategy, NavigationPrimitives } from './strategies/columns';
 
 /**
  * Strategy to resolve column names (string or regex) to their index.
@@ -240,8 +231,7 @@ export interface TableStrategies {
   header?: HeaderStrategy;
   /** Primitive navigation functions (goUp, goDown, goLeft, goRight, goHome) */
   navigation?: NavigationPrimitives;
-  /** @deprecated Use navigation primitives instead. Strategy for navigating to specific cells (row + column) */
-  cellNavigation?: CellNavigationStrategy;
+
   /** Strategy for filling form inputs */
   fill?: FillStrategy;
   /** Strategy for paginating through data */
@@ -264,15 +254,10 @@ export interface TableStrategies {
   loading?: LoadingStrategy;
 }
 
-/**
- * Configuration options for useTable.
- */
-/**
- * Configuration options for useTable.
- */
+
 export interface TableConfig<T = any> {
   /** Selector for the table headers */
-  headerSelector?: string;
+  headerSelector?: string | ((root: Locator) => Locator);
   /** Selector for the table rows */
   rowSelector?: string;
   /** Selector for the cells within a row */
@@ -296,8 +281,8 @@ export interface TableConfig<T = any> {
   dataMapper?: Partial<Record<keyof T, (cell: Locator) => Promise<T[keyof T]> | T[keyof T]>>;
 }
 
-export interface FinalTableConfigLike<T = any> extends TableConfig<T> {
-  headerSelector: string;
+export interface FinalTableConfig<T = any> extends TableConfig<T> {
+  headerSelector: string | ((root: Locator) => Locator);
   rowSelector: string;
   cellSelector: string;
   maxPages: number;
@@ -307,8 +292,6 @@ export interface FinalTableConfigLike<T = any> extends TableConfig<T> {
   onReset: (context: TableContext) => Promise<void>;
   strategies: TableStrategies;
 }
-// Alias for backward compatibility if needed, or update usages
-export type FinalTableConfig<T = any> = FinalTableConfigLike<T>;
 
 
 export interface FillOptions {
@@ -399,13 +382,7 @@ export interface TableResult<T = any> {
    */
   scrollToColumn: (columnName: string) => Promise<void>;
 
-  /**
-   * Gets all rows on the current page only (does not paginate).
-   * Auto-initializes the table if not already initialized.
-   * Returns a SmartRowArray which extends Array with a toJSON() helper method.
-   * @param options - Filter options
-   */
-  getRows: (options?: { filter?: Record<string, any>, exact?: boolean }) => Promise<SmartRowArray>;
+
 
   /**
    * Resets the table state (clears cache, flags) and invokes the onReset strategy.

package/dist/types.d.ts

@@ -163,15 +163,6 @@ export interface TableContext<T = any> {
 }
 export type PaginationStrategy = (context: TableContext) => Promise<boolean>;
 export type DedupeStrategy = (row: SmartRow) => string | number | Promise<string | number>;
-export interface PromptOptions {
-    /**
-     * Output Strategy:
-     * - 'error': Throws an error with the prompt (useful for platforms that capture error output cleanly).
-     * - 'console': Standard console logs (Default).
-     */
-    output?: 'console' | 'error';
-    includeTypes?: boolean;
-}
 export type FillStrategy = (options: {
     row: SmartRow;
     columnName: string;
@@ -182,10 +173,9 @@ export type FillStrategy = (options: {
     table: TableResult;
     fillOptions?: FillOptions;
 }) => Promise<void>;
-export type { HeaderStrategy } from './strategies/headers';
-export type { CellNavigationStrategy, NavigationPrimitives } from './strategies/columns';
 import { HeaderStrategy } from './strategies/headers';
-import { CellNavigationStrategy, NavigationPrimitives } from './strategies/columns';
+export type { HeaderStrategy } from './strategies/headers';
+import { NavigationPrimitives } from './strategies/columns';
 /**
  * Strategy to resolve column names (string or regex) to their index.
  */
@@ -220,8 +210,6 @@ export interface TableStrategies {
     header?: HeaderStrategy;
     /** Primitive navigation functions (goUp, goDown, goLeft, goRight, goHome) */
     navigation?: NavigationPrimitives;
-    /** @deprecated Use navigation primitives instead. Strategy for navigating to specific cells (row + column) */
-    cellNavigation?: CellNavigationStrategy;
     /** Strategy for filling form inputs */
     fill?: FillStrategy;
     /** Strategy for paginating through data */
@@ -250,15 +238,9 @@ export interface TableStrategies {
     /** Strategy for detecting loading states */
     loading?: LoadingStrategy;
 }
-/**
- * Configuration options for useTable.
- */
-/**
- * Configuration options for useTable.
- */
 export interface TableConfig<T = any> {
     /** Selector for the table headers */
-    headerSelector?: string;
+    headerSelector?: string | ((root: Locator) => Locator);
     /** Selector for the table rows */
     rowSelector?: string;
     /** Selector for the cells within a row */
@@ -286,8 +268,8 @@ export interface TableConfig<T = any> {
      */
     dataMapper?: Partial<Record<keyof T, (cell: Locator) => Promise<T[keyof T]> | T[keyof T]>>;
 }
-export interface FinalTableConfigLike<T = any> extends TableConfig<T> {
-    headerSelector: string;
+export interface FinalTableConfig<T = any> extends TableConfig<T> {
+    headerSelector: string | ((root: Locator) => Locator);
     rowSelector: string;
     cellSelector: string;
     maxPages: number;
@@ -302,7 +284,6 @@ export interface FinalTableConfigLike<T = any> extends TableConfig<T> {
     onReset: (context: TableContext) => Promise<void>;
     strategies: TableStrategies;
 }
-export type FinalTableConfig<T = any> = FinalTableConfigLike<T>;
 export interface FillOptions {
     /**
      * Custom input mappers for specific columns.
@@ -381,16 +362,6 @@ export interface TableResult<T = any> {
      * Navigates to a specific column using the configured CellNavigationStrategy.
      */
     scrollToColumn: (columnName: string) => Promise<void>;
-    /**
-     * Gets all rows on the current page only (does not paginate).
-     * Auto-initializes the table if not already initialized.
-     * Returns a SmartRowArray which extends Array with a toJSON() helper method.
-     * @param options - Filter options
-     */
-    getRows: (options?: {
-        filter?: Record<string, any>;
-        exact?: boolean;
-    }) => Promise<SmartRowArray>;
     /**
      * Resets the table state (clears cache, flags) and invokes the onReset strategy.
      */

package/dist/useTable.d.ts

@@ -1,48 +1,6 @@
 import type { Locator } from '@playwright/test';
-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';
-import { ResolutionStrategies } from './strategies/resolution';
-import { Strategies } from './strategies';
+import { TableConfig, TableResult } from './types';
 /**
  * Main hook to interact with a table.
  */
 export declare const useTable: <T = any>(rootLocator: Locator, configOptions?: TableConfig<T>) => TableResult<T>;
-export declare const PaginationStrategies: {
-    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>;
-    };
-    Headers: {
-        stable: (duration?: number) => (context: TableContext) => 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 };

package/dist/useTable.js

@@ -9,26 +9,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Strategies = exports.ResolutionStrategies = exports.CellNavigationStrategies = exports.HeaderStrategies = exports.FillStrategies = exports.DedupeStrategies = exports.SortingStrategies = exports.LoadingStrategies = exports.PaginationStrategies = exports.useTable = void 0;
-const typeContext_1 = require("./typeContext");
-const sorting_1 = require("./strategies/sorting");
-const pagination_1 = require("./strategies/pagination");
-const dedupe_1 = require("./strategies/dedupe");
+exports.useTable = void 0;
+const minimalConfigContext_1 = require("./minimalConfigContext");
 const loading_1 = require("./strategies/loading");
 const fill_1 = require("./strategies/fill");
-Object.defineProperty(exports, "FillStrategies", { enumerable: true, get: function () { return fill_1.FillStrategies; } });
 const headers_1 = require("./strategies/headers");
-Object.defineProperty(exports, "HeaderStrategies", { enumerable: true, get: function () { return headers_1.HeaderStrategies; } });
-const columns_1 = require("./strategies/columns");
-Object.defineProperty(exports, "CellNavigationStrategies", { enumerable: true, get: function () { return columns_1.CellNavigationStrategies; } });
 const smartRow_1 = require("./smartRow");
 const filterEngine_1 = require("./filterEngine");
 const tableMapper_1 = require("./engine/tableMapper");
 const rowFinder_1 = require("./engine/rowFinder");
-const resolution_1 = require("./strategies/resolution");
-Object.defineProperty(exports, "ResolutionStrategies", { enumerable: true, get: function () { return resolution_1.ResolutionStrategies; } });
-const strategies_1 = require("./strategies");
-Object.defineProperty(exports, "Strategies", { enumerable: true, get: function () { return strategies_1.Strategies; } });
 const debugUtils_1 = require("./utils/debugUtils");
 const smartRowArray_1 = require("./utils/smartRowArray");
 /**
@@ -42,7 +31,6 @@ const useTable = (rootLocator, configOptions = {}) => {
     const defaultStrategies = {
         fill: fill_1.FillStrategies.default,
         header: headers_1.HeaderStrategies.visible,
-        cellNavigation: columns_1.CellNavigationStrategies.default,
         pagination: () => __awaiter(void 0, void 0, void 0, function* () { return false; }),
         loading: {
             isHeaderLoading: loading_1.LoadingStrategies.Headers.stable(200)
@@ -117,7 +105,7 @@ const useTable = (rootLocator, configOptions = {}) => {
         const { output = 'console', includeTypes = true } = options;
         let finalPrompt = content;
         if (includeTypes) {
-            finalPrompt += `\n\n👇 Useful TypeScript Definitions 👇\n\`\`\`typescript\n${typeContext_1.TYPE_CONTEXT}\n\`\`\`\n`;
+            finalPrompt += `\n\n👇 Useful TypeScript Definitions 👇\n\`\`\`typescript\n${minimalConfigContext_1.MINIMAL_CONFIG_CONTEXT}\n\`\`\`\n`;
         }
         if (output === 'error') {
             console.log(`⚠️ Throwing error to display [${promptName}] cleanly...`);
@@ -144,14 +132,9 @@ const useTable = (rootLocator, configOptions = {}) => {
             const idx = map.get(columnName);
             if (idx === undefined)
                 throw _createColumnError(columnName, map);
-            yield config.strategies.cellNavigation({
-                config: config,
-                root: rootLocator,
-                page: rootLocator.page(),
-                resolve,
-                column: columnName,
-                index: idx
-            });
+            // Use header cell for scrolling
+            const headerCell = resolve(config.headerSelector, rootLocator).nth(idx);
+            yield headerCell.scrollIntoViewIfNeeded();
         }),
         getHeaders: () => __awaiter(void 0, void 0, void 0, function* () {
             const map = yield tableMapper.getMap();
@@ -228,11 +211,6 @@ const useTable = (rootLocator, configOptions = {}) => {
             // @ts-ignore
             return rowFinder.findRow(filters, options);
         }),
-        getRows: (options) => __awaiter(void 0, void 0, void 0, function* () {
-            console.warn('DEPRECATED: table.getRows() is deprecated and will be removed in a future version. Use table.findRows() instead.');
-            // @ts-ignore
-            return rowFinder.findRows((options === null || options === void 0 ? void 0 : options.filter) || {}, Object.assign(Object.assign({}, options), { maxPages: 1 }));
-        }),
         findRows: (filters, options) => __awaiter(void 0, void 0, void 0, function* () {
             return rowFinder.findRows(filters, options);
         }),
@@ -273,7 +251,6 @@ const useTable = (rootLocator, configOptions = {}) => {
                 getRow: result.getRow,
                 getRowByIndex: result.getRowByIndex,
                 findRow: result.findRow,
-                getRows: result.getRows,
                 findRows: result.findRows,
                 getColumnValues: result.getColumnValues,
                 isInitialized: result.isInitialized,
@@ -438,7 +415,3 @@ const useTable = (rootLocator, configOptions = {}) => {
     return result;
 };
 exports.useTable = useTable;
-exports.PaginationStrategies = Object.assign({}, pagination_1.PaginationStrategies);
-exports.LoadingStrategies = loading_1.LoadingStrategies;
-exports.SortingStrategies = sorting_1.SortingStrategies;
-exports.DedupeStrategies = dedupe_1.DedupeStrategies;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rickcedwhat/playwright-smart-table",
-  "version": "6.3.2",
+  "version": "6.4.0",
   "description": "Smart, column-aware table interactions for Playwright",
   "author": "Cedrick Catalan",
   "license": "MIT",
@@ -15,12 +15,13 @@
   ],
   "scripts": {
     "generate-types": "node scripts/embed-types.mjs",
+    "generate-config-types": "node scripts/embed-config-types.mjs",
     "generate-docs": "node scripts/generate-readme.mjs",
     "generate-all-api-docs": "node scripts/generate-all-api-docs.mjs",
     "update-all-api-signatures": "node scripts/update-all-api-signatures.mjs",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
-    "build": "npm run generate-types && npm run generate-docs && npm run generate-all-api-docs && npm run update-all-api-signatures && tsc",
+    "build": "npm run generate-types && npm run generate-config-types && npm run generate-docs && npm run generate-all-api-docs && npm run update-all-api-signatures && tsc",
     "prepublishOnly": "npm run build",
     "test": "npm run test:unit && npx playwright test",
     "test:unit": "vitest run --reporter=verbose --reporter=html",