@rickcedwhat/playwright-smart-table 6.20.1 → 6.21.0-next.3ab7a18

package/dist/plugins/index.d.ts

@@ -1,13 +1,32 @@
 /**
  * @deprecated Use `presets` instead. Plugins will be removed in v7.0.0.
- * Presets for specific table/grid libraries. Each plugin exposes:
- * - Plugins.X — full preset (selectors + headerTransformer if any + strategies). Spread: useTable(loc, { ...Presets.MUI, maxPages: 5 }).
- * - Plugins.X.Strategies — strategies only. Use with your own selectors: useTable(loc, { rowSelector: '...', strategies: Presets.MUI.Strategies }).
+ *
+ * Compatibility shim over official presets:
+ * - `Plugins.MUI` → `presets.muiDataGrid` (**DataGrid only** — not `presets.muiTable`)
+ * - `Plugins.RDG` → `presets.rdg`
+ * - `Plugins.Glide` → `presets.glide`
+ *
+ * Prefer: `useTable(loc, { ...presets.muiDataGrid, maxPages: 5 })`.
+ * Strategies only: `useTable(loc, { rowSelector: '...', strategies: presets.muiDataGrid.strategies })`.
  */
 export declare const Plugins: {
     /** @deprecated Use `presets.rdg` */
     RDG: {
-        Strategies: import("../types").TableStrategies | undefined;
+        Strategies: {
+            header: (context: import("..").TableContext) => Promise<string[]>;
+            getCellLocator: ({ row, columnIndex }: {
+                row: import("@playwright/test").Locator;
+                columnIndex: number;
+            }) => import("@playwright/test").Locator;
+            navigation: {
+                goRight: ({ root }: import("..").StrategyContext) => Promise<void>;
+                goLeft: ({ root }: import("..").StrategyContext) => Promise<void>;
+                goDown: ({ root }: import("..").StrategyContext) => Promise<void>;
+                goUp: ({ root }: import("..").StrategyContext) => Promise<void>;
+                goHome: ({ root }: import("..").StrategyContext) => Promise<void>;
+            };
+            pagination: import("..").PaginationPrimitives;
+        };
         headerSelector?: string | ((root: import("@playwright/test").Locator) => import("@playwright/test").Locator) | undefined;
         rowSelector?: string | undefined;
         cellSelector?: string | ((row: import("@playwright/test").Locator) => import("@playwright/test").Locator) | undefined;
@@ -22,14 +41,33 @@ export declare const Plugins: {
         autoScroll?: boolean | undefined;
         debug?: import("..").DebugConfig | undefined;
         onReset?: ((context: import("..").TableContext) => Promise<void>) | undefined;
-        strategies?: import("../types").TableStrategies | undefined;
+        strategies?: import("..").TableStrategies | undefined;
         columnOverrides?: Partial<Record<string | number | symbol, import("..").ColumnOverride<any>>> | undefined;
         syntheticColumns?: Record<string, import("..").SyntheticColumnDef<any>> | undefined;
         emptyState?: import("@playwright/test").Locator | undefined;
     };
     /** @deprecated Use `presets.glide` */
     Glide: {
-        Strategies: import("../types").TableStrategies | undefined;
+        Strategies: {
+            fillSimple: import("..").FillStrategy;
+            fill: import("..").FillStrategy;
+            pagination: import("..").PaginationPrimitives;
+            header: (context: import("..").StrategyContext, options?: {
+                limit?: number;
+                selector?: string;
+                scrollAmount?: number;
+            }) => Promise<string[]>;
+            viewport: import("..").ViewportStrategy;
+            loading: {
+                isHeaderLoading: () => Promise<boolean>;
+            };
+            getCellLocator: ({ row, columnIndex }: any) => any;
+            getActiveCell: ({ page }: any) => Promise<{
+                rowIndex: number;
+                columnIndex: number;
+                locator: any;
+            } | null>;
+        };
         headerSelector?: string | ((root: import("@playwright/test").Locator) => import("@playwright/test").Locator) | undefined;
         rowSelector?: string | undefined;
         cellSelector?: string | ((row: import("@playwright/test").Locator) => import("@playwright/test").Locator) | undefined;
@@ -44,14 +82,17 @@ export declare const Plugins: {
         autoScroll?: boolean | undefined;
         debug?: import("..").DebugConfig | undefined;
         onReset?: ((context: import("..").TableContext) => Promise<void>) | undefined;
-        strategies?: import("../types").TableStrategies | undefined;
+        strategies?: import("..").TableStrategies | undefined;
         columnOverrides?: Partial<Record<string | number | symbol, import("..").ColumnOverride<any>>> | undefined;
         syntheticColumns?: Record<string, import("..").SyntheticColumnDef<any>> | undefined;
         emptyState?: import("@playwright/test").Locator | undefined;
     };
-    /** @deprecated Use `presets.muiDataGrid` */
+    /**
+     * @deprecated Use `presets.muiDataGrid`.
+     * DataGrid only — for MUI `<Table>` use `presets.muiTable`.
+     */
     MUI: {
-        Strategies: import("../types").TableStrategies | undefined;
+        Strategies: import("..").TableStrategies | undefined;
         headerSelector?: string | ((root: import("@playwright/test").Locator) => import("@playwright/test").Locator) | undefined;
         rowSelector?: string | undefined;
         cellSelector?: string | ((row: import("@playwright/test").Locator) => import("@playwright/test").Locator) | undefined;
@@ -66,7 +107,7 @@ export declare const Plugins: {
         autoScroll?: boolean | undefined;
         debug?: import("..").DebugConfig | undefined;
         onReset?: ((context: import("..").TableContext) => Promise<void>) | undefined;
-        strategies?: import("../types").TableStrategies | undefined;
+        strategies?: import("..").TableStrategies | undefined;
         columnOverrides?: Partial<Record<string | number | symbol, import("..").ColumnOverride<any>>> | undefined;
         syntheticColumns?: Record<string, import("..").SyntheticColumnDef<any>> | undefined;
         emptyState?: import("@playwright/test").Locator | undefined;

package/dist/plugins/index.js

@@ -4,15 +4,23 @@ exports.Plugins = void 0;
 const presets_1 = require("../presets");
 /**
  * @deprecated Use `presets` instead. Plugins will be removed in v7.0.0.
- * Presets for specific table/grid libraries. Each plugin exposes:
- * - Plugins.X — full preset (selectors + headerTransformer if any + strategies). Spread: useTable(loc, { ...Presets.MUI, maxPages: 5 }).
- * - Plugins.X.Strategies — strategies only. Use with your own selectors: useTable(loc, { rowSelector: '...', strategies: Presets.MUI.Strategies }).
+ *
+ * Compatibility shim over official presets:
+ * - `Plugins.MUI` → `presets.muiDataGrid` (**DataGrid only** — not `presets.muiTable`)
+ * - `Plugins.RDG` → `presets.rdg`
+ * - `Plugins.Glide` → `presets.glide`
+ *
+ * Prefer: `useTable(loc, { ...presets.muiDataGrid, maxPages: 5 })`.
+ * Strategies only: `useTable(loc, { rowSelector: '...', strategies: presets.muiDataGrid.strategies })`.
  */
 exports.Plugins = {
     /** @deprecated Use `presets.rdg` */
-    RDG: Object.assign(Object.assign({}, presets_1.rdg), { Strategies: presets_1.rdg.strategies }),
+    RDG: Object.assign(Object.assign({}, presets_1.rdg), { Strategies: presets_1.rdg.Strategies }),
     /** @deprecated Use `presets.glide` */
-    Glide: Object.assign(Object.assign({}, presets_1.glide), { Strategies: presets_1.glide.strategies }),
-    /** @deprecated Use `presets.muiDataGrid` */
+    Glide: Object.assign(Object.assign({}, presets_1.glide), { Strategies: presets_1.glide.Strategies }),
+    /**
+     * @deprecated Use `presets.muiDataGrid`.
+     * DataGrid only — for MUI `<Table>` use `presets.muiTable`.
+     */
     MUI: Object.assign(Object.assign({}, presets_1.muiDataGrid), { Strategies: presets_1.muiDataGrid.strategies }),
 };

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

@@ -12,7 +12,7 @@ export declare const GlideStrategies: {
         selector?: string;
         scrollAmount?: number;
     }) => Promise<string[]>;
-    viewport: import("../../types").ViewportStrategy;
+    viewport: import("../..").ViewportStrategy;
     loading: {
         isHeaderLoading: () => Promise<boolean>;
     };

package/dist/presets/glide/index.js

@@ -123,8 +123,8 @@ function createGlide(options = {}) {
 }
 /**
  * Full preset for Glide Data Grid (selectors + default strategies only).
- * Spread: useTable(loc, { ...Plugins.Glide, maxPages: 5 }).
- * Strategies only (including fillSimple): useTable(loc, { rowSelector: '...', strategies: Plugins.Glide.Strategies }).
+ * Spread: `useTable(loc, { ...presets.glide, maxPages: 5 })`.
+ * Strategies only (including fillSimple): `useTable(loc, { rowSelector: '...', strategies: presets.glide.Strategies })`.
  * For a non-64-column grid, use `createGlide({ columnCount })` instead.
  */
 const GlidePreset = {

package/dist/presets/mui.js

@@ -146,22 +146,14 @@ function createMuiTable(opts) {
                         return 'asc';
                     return 'none';
                 },
-                doSort: async ({ columnName, direction, context }) => {
-                    var _a, _b;
+                doSort: async ({ columnName, context }) => {
+                    // Trigger-only: core `sorting.apply` owns retries + state checks (#434).
                     if (!context.getHeaderCell)
                         return;
                     const header = await context.getHeaderCell(columnName);
                     const sortLabel = header.locator('.MuiTableSortLabel-root').first();
                     const target = await sortLabel.isVisible().catch(() => false) ? sortLabel : header;
-                    let current = await ((_a = context.config.strategies.sorting) === null || _a === void 0 ? void 0 : _a.getSortState({ columnName, context })) || 'none';
-                    let attempts = 0;
-                    // Click until the state matches the target direction, max 3 times (none -> asc -> desc)
-                    while (current !== direction && attempts < 3) {
-                        await target.click();
-                        await context.page.waitForTimeout(100);
-                        current = await ((_b = context.config.strategies.sorting) === null || _b === void 0 ? void 0 : _b.getSortState({ columnName, context })) || 'none';
-                        attempts++;
-                    }
+                    await target.click();
                 }
             },
             dedupe: async (row) => {
@@ -303,28 +295,22 @@ function createMuiDataGrid(opts) {
                         return 'desc';
                     return 'none';
                 },
-                doSort: async ({ columnName, direction, context }) => {
-                    var _a, _b;
+                doSort: async ({ columnName, context }) => {
+                    // Trigger-only: core `sorting.apply` owns retries + state checks (#434).
                     if (!context.getHeaderCell)
                         return;
                     const header = await context.getHeaderCell(columnName);
-                    let current = await ((_a = context.config.strategies.sorting) === null || _a === void 0 ? void 0 : _a.getSortState({ columnName, context })) || 'none';
-                    let attempts = 0;
-                    while (current !== direction && attempts < 3) {
-                        const clickTarget = header.locator('.MuiDataGrid-columnHeaderTitleContainer').first();
-                        if (await clickTarget.isVisible()) {
-                            await clickTarget.click({ force: true });
-                        }
-                        else {
-                            await header.click({ force: true });
-                        }
-                        // Wait for stabilization (using DataGrid specific overlay check inside helper)
-                        const displayedRows = context.root.locator('.MuiTablePagination-displayedRows');
-                        const text = await displayedRows.innerText().catch(() => '');
-                        await waitForMuiPaginationStabilization(context, displayedRows, text);
-                        current = await ((_b = context.config.strategies.sorting) === null || _b === void 0 ? void 0 : _b.getSortState({ columnName, context })) || 'none';
-                        attempts++;
+                    const clickTarget = header.locator('.MuiDataGrid-columnHeaderTitleContainer').first();
+                    if (await clickTarget.isVisible()) {
+                        await clickTarget.click({ force: true });
+                    }
+                    else {
+                        await header.click({ force: true });
                     }
+                    // One stabilization wait after the click; core also polls isTableLoading.
+                    const displayedRows = context.root.locator('.MuiTablePagination-displayedRows');
+                    const text = await displayedRows.innerText().catch(() => '');
+                    await waitForMuiPaginationStabilization(context, displayedRows, text);
                 }
             },
             dedupe: async (row) => {

package/dist/presets/rdg.d.ts

@@ -1,6 +1,6 @@
 import type { Locator } from '@playwright/test';
 import { TableContext, TableConfig, ViewportStrategy, StrategyContext } from '../types';
-/** Full strategies for React Data Grid. Use when you want to supply your own selectors: strategies: Plugins.RDG.Strategies */
+/** Full strategies for React Data Grid. Use when you want to supply your own selectors: `strategies: presets.rdg.Strategies` */
 export declare const RDGStrategies: {
     header: (context: TableContext) => Promise<string[]>;
     getCellLocator: ({ row, columnIndex }: {

package/dist/presets/rdg.js

@@ -92,20 +92,20 @@ const rdgNavigation = {
         });
     }
 };
-/** Default strategies for the RDG preset (used when you spread Plugins.RDG). */
+/** Default strategies for the RDG preset (used when you spread `presets.rdg`). */
 const RDGDefaultStrategies = {
     header: scrollRightHeaderRDG,
     getCellLocator: rdgGetCellLocator,
     navigation: rdgNavigation,
     pagination: rdgPaginationStrategy
 };
-/** Full strategies for React Data Grid. Use when you want to supply your own selectors: strategies: Plugins.RDG.Strategies */
+/** Full strategies for React Data Grid. Use when you want to supply your own selectors: `strategies: presets.rdg.Strategies` */
 // fallow-ignore-next-line unused-export
 exports.RDGStrategies = RDGDefaultStrategies;
 /**
  * Full preset for React Data Grid (selectors + default strategies).
- * Spread: useTable(loc, { ...Plugins.RDG, maxPages: 5 }).
- * Strategies only: useTable(loc, { rowSelector: '...', strategies: Plugins.RDG.Strategies }).
+ * Spread: `useTable(loc, { ...presets.rdg, maxPages: 5 })`.
+ * Strategies only: `useTable(loc, { rowSelector: '...', strategies: presets.rdg.Strategies })`.
  */
 const RDGPreset = {
     rowSelector: '[role="row"].rdg-row',

package/dist/smartRow.d.ts

@@ -1,4 +1,4 @@
-import type { Locator, Page } from '@playwright/test';
+import { type Locator, type Page } from '@playwright/test';
 import { SmartRow as SmartRowType, FinalTableConfig, TableResult } from './types';
 import { NavigationBarrier } from './utils/navigationBarrier';
 /**
@@ -9,5 +9,5 @@ import { NavigationBarrier } from './utils/navigationBarrier';
  * @internal Internal factory for creating SmartRow objects.
  * Not part of the public package surface; tests and consumers should use public APIs.
  */
-declare const createSmartRow: <T = any>(rowLocator: Locator, map: Map<string, number>, rowIndex: number | undefined, config: FinalTableConfig<T>, rootLocator: Locator, resolve: (item: any, parent: Locator | Page) => Locator, table: TableResult<T> | null, tablePageIndex?: number, barrier?: NavigationBarrier) => SmartRowType<T>;
+declare const createSmartRow: <T = any>(rowLocator: Locator, map: Map<string, number>, rowIndex: number | undefined, config: FinalTableConfig<T>, rootLocator: Locator, resolve: (item: any, parent: Locator | Page) => Locator, table: TableResult<T> | null, tablePageIndex?: number, barrier?: NavigationBarrier, renderWindowPosition?: boolean) => SmartRowType<T>;
 export default createSmartRow;