@rickcedwhat/playwright-smart-table 6.9.0 → 6.10.1

package/dist/utils/paginationPath.js

@@ -1,24 +1,22 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.planNavigationPath = planNavigationPath;
 exports.executeNavigationWithGoToPageRetry = executeNavigationWithGoToPageRetry;
 exports.executeNavigationPath = executeNavigationPath;
+function computeCost(path) {
+    return path.reduce((sum, step) => {
+        if ('count' in step)
+            return sum + step.count;
+        return sum + 1; // goToPage and goToLast count as 1
+    }, 0);
+}
 /**
  * Plans an optimal path from currentPageIndex to targetPageIndex using available primitives.
  * Prefers goToPage when present; otherwise uses bulk steps (goNextBulk / goPreviousBulk) then
  * single steps (goNext / goPrevious). May choose to overshoot with bulk then step back when
  * that reduces total primitive calls (e.g. page 3 → 12 with bulk 10: goNextBulk once, goPrevious once).
  */
-function planNavigationPath(currentPageIndex, targetPageIndex, primitives) {
+function planNavigationPath(currentPageIndex, targetPageIndex, primitives, totalPages) {
     var _a, _b;
     if (currentPageIndex === targetPageIndex)
         return [];
@@ -32,37 +30,58 @@ function planNavigationPath(currentPageIndex, targetPageIndex, primitives) {
         const stepsForward = targetPageIndex - currentPageIndex;
         const hasBulk = !!(primitives.goNextBulk && nextBulkSize > 0);
         const hasPrev = !!primitives.goPrevious;
+        let forwardPath = [];
         if (!hasBulk || nextBulkSize <= 0) {
             if (primitives.goNext) {
-                return [{ type: 'goNext', count: stepsForward }];
+                forwardPath = [{ type: 'goNext', count: stepsForward }];
             }
-            return [];
         }
-        const bulkCountA = Math.floor(stepsForward / nextBulkSize);
-        const remA = stepsForward % nextBulkSize;
-        const totalA = bulkCountA + remA;
-        let totalB = Infinity;
-        let bulkCountB = 0;
-        let overB = 0;
-        if (hasPrev && primitives.goPreviousBulk && prevBulkSize > 0) {
-            bulkCountB = Math.ceil(stepsForward / nextBulkSize);
-            overB = bulkCountB * nextBulkSize - stepsForward;
-            totalB = bulkCountB + overB;
+        else {
+            const bulkCountA = Math.floor(stepsForward / nextBulkSize);
+            const remA = stepsForward % nextBulkSize;
+            const totalA = (remA === 0 || primitives.goNext)
+                ? bulkCountA + remA
+                : Infinity;
+            let totalB = Infinity;
+            let bulkCountB = 0;
+            let overB = 0;
+            if (hasPrev) {
+                bulkCountB = Math.ceil(stepsForward / nextBulkSize);
+                overB = bulkCountB * nextBulkSize - stepsForward;
+                totalB = bulkCountB + overB;
+            }
+            forwardPath = (totalB < totalA)
+                ? (() => {
+                    const path = [];
+                    if (bulkCountB > 0)
+                        path.push({ type: 'goNextBulk', count: bulkCountB });
+                    if (overB > 0)
+                        path.push({ type: 'goPrevious', count: overB });
+                    return path;
+                })()
+                : Number.isFinite(totalA) ? (() => {
+                    const path = [];
+                    if (bulkCountA > 0)
+                        path.push({ type: 'goNextBulk', count: bulkCountA });
+                    if (remA > 0)
+                        path.push({ type: 'goNext', count: remA });
+                    return path;
+                })() : [];
         }
-        if (totalB < totalA) {
-            const path = [];
-            if (bulkCountB > 0)
-                path.push({ type: 'goNextBulk', count: bulkCountB });
-            if (overB > 0)
-                path.push({ type: 'goPrevious', count: overB });
-            return path;
+        if (totalPages !== undefined && primitives.goToLast) {
+            const lastPageIndex = totalPages - 1;
+            if (targetPageIndex <= lastPageIndex) {
+                // Evaluate wrap-around path
+                const backwardPath = planNavigationPath(lastPageIndex, targetPageIndex, primitives);
+                if (backwardPath.length > 0 || targetPageIndex === lastPageIndex) {
+                    const wrapPath = [{ type: 'goToLast', targetIndex: lastPageIndex }, ...backwardPath];
+                    if (forwardPath.length === 0 || computeCost(wrapPath) < computeCost(forwardPath)) {
+                        return wrapPath;
+                    }
+                }
+            }
         }
-        const path = [];
-        if (bulkCountA > 0)
-            path.push({ type: 'goNextBulk', count: bulkCountA });
-        if (remA > 0)
-            path.push({ type: 'goNext', count: remA });
-        return path;
+        return forwardPath;
     }
     // Backward: current → target
     const stepsBack = currentPageIndex - targetPageIndex;
@@ -108,123 +127,127 @@ const MAX_GO_TO_PAGE_RETRIES = 200;
  * steps once toward target (goNextBulk/goNext or goPreviousBulk/goPrevious), then retries.
  * Example: from 3 to 38 with windowed goToPage → goToPage(38) false, goNextBulk(), goToPage(38) false, … goToPage(38) true.
  */
-function executeNavigationWithGoToPageRetry(targetPageIndex, primitives, context, getCurrentPage, setCurrentPage) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b;
-        if (!primitives.goToPage)
+async function executeNavigationWithGoToPageRetry(targetPageIndex, primitives, context, getCurrentPage, setCurrentPage) {
+    var _a, _b;
+    if (!primitives.goToPage)
+        return;
+    for (let i = 0; i < MAX_GO_TO_PAGE_RETRIES; i++) {
+        const current = getCurrentPage();
+        if (current === targetPageIndex)
+            return;
+        const ok = await primitives.goToPage(targetPageIndex, context);
+        if (ok) {
+            setCurrentPage(targetPageIndex);
             return;
-        for (let i = 0; i < MAX_GO_TO_PAGE_RETRIES; i++) {
-            const current = getCurrentPage();
-            if (current === targetPageIndex)
-                return;
-            const ok = yield primitives.goToPage(targetPageIndex, context);
-            if (ok) {
-                setCurrentPage(targetPageIndex);
-                return;
+        }
+        // Step once toward target. Don't use bulk if it would overshoot and we can't step back (no goPrevious/goNext).
+        if (targetPageIndex > current) {
+            const nextBulkSize = (_a = primitives.nextBulkPages) !== null && _a !== void 0 ? _a : 1;
+            const wouldOvershoot = (current + nextBulkSize) > targetPageIndex;
+            const canStepBack = !!primitives.goPrevious;
+            const useBulk = primitives.goNextBulk && (!wouldOvershoot || canStepBack);
+            if (useBulk && primitives.goNextBulk) {
+                const result = await primitives.goNextBulk(context);
+                if (!result)
+                    throw new Error('bringIntoView: goNextBulk failed during goToPage retry');
+                const jumped = typeof result === 'number' ? result : nextBulkSize;
+                setCurrentPage(getCurrentPage() + jumped);
+            }
+            else if (primitives.goNext) {
+                const stepped = await primitives.goNext(context);
+                if (!stepped)
+                    throw new Error('bringIntoView: goNext failed during goToPage retry');
+                setCurrentPage(getCurrentPage() + 1);
             }
-            // Step once toward target. Don't use bulk if it would overshoot and we can't step back (no goPrevious/goNext).
-            if (targetPageIndex > current) {
-                const nextBulkSize = (_a = primitives.nextBulkPages) !== null && _a !== void 0 ? _a : 1;
-                const wouldOvershoot = (current + nextBulkSize) > targetPageIndex;
-                const canStepBack = !!primitives.goPrevious;
-                const useBulk = primitives.goNextBulk && (!wouldOvershoot || canStepBack);
-                if (useBulk && primitives.goNextBulk) {
-                    const result = yield primitives.goNextBulk(context);
+            else {
+                const available = Object.keys(primitives).filter(k => primitives[k]);
+                throw new Error(`bringIntoView: goToPage(${targetPageIndex}) returned false and no goNext/goNextBulk to advance. Available primitives: ${available.join(', ')}`);
+            }
+        }
+        else {
+            const prevBulkSize = (_b = primitives.previousBulkPages) !== null && _b !== void 0 ? _b : 1;
+            const wouldOvershoot = (current - prevBulkSize) < targetPageIndex;
+            const canStepBack = !!primitives.goNext;
+            const useBulk = primitives.goPreviousBulk && (!wouldOvershoot || canStepBack);
+            if (useBulk && primitives.goPreviousBulk) {
+                const result = await primitives.goPreviousBulk(context);
+                if (!result)
+                    throw new Error('bringIntoView: goPreviousBulk failed during goToPage retry');
+                const jumped = typeof result === 'number' ? result : prevBulkSize;
+                setCurrentPage(getCurrentPage() - jumped);
+            }
+            else if (primitives.goPrevious) {
+                const stepped = await primitives.goPrevious(context);
+                if (!stepped)
+                    throw new Error('bringIntoView: goPrevious failed during goToPage retry');
+                setCurrentPage(getCurrentPage() - 1);
+            }
+            else {
+                const available = Object.keys(primitives).filter(k => primitives[k]);
+                throw new Error(`bringIntoView: goToPage(${targetPageIndex}) returned false and no goPrevious/goPreviousBulk to step back. Available primitives: ${available.join(', ')}`);
+            }
+        }
+    }
+    const available = Object.keys(primitives).filter(k => primitives[k]);
+    throw new Error(`bringIntoView: failed to reach page ${targetPageIndex} after ${MAX_GO_TO_PAGE_RETRIES} goToPage retries. Available primitives: ${available.join(', ')}`);
+}
+/**
+ * Executes a navigation path by calling the corresponding primitives.
+ * Updates currentPageIndex via the provided setter as steps run.
+ */
+async function executeNavigationPath(path, primitives, context, getCurrentPage, setCurrentPage) {
+    for (const step of path) {
+        switch (step.type) {
+            case 'goToPage':
+                if (primitives.goToPage) {
+                    const ok = await primitives.goToPage(step.pageIndex, context);
+                    if (!ok)
+                        throw new Error(`goToPage(${step.pageIndex}) failed`);
+                    setCurrentPage(step.pageIndex);
+                }
+                break;
+            case 'goToLast':
+                if (primitives.goToLast) {
+                    const ok = await primitives.goToLast(context);
+                    if (!ok)
+                        throw new Error(`goToLast failed`);
+                    setCurrentPage(step.targetIndex);
+                }
+                break;
+            case 'goNextBulk':
+                for (let i = 0; i < step.count && primitives.goNextBulk; i++) {
+                    const result = await primitives.goNextBulk(context);
                     if (!result)
-                        throw new Error('bringIntoView: goNextBulk failed during goToPage retry');
-                    const jumped = typeof result === 'number' ? result : nextBulkSize;
+                        throw new Error('goNextBulk failed');
+                    const jumped = typeof result === 'number' ? result : 1;
                     setCurrentPage(getCurrentPage() + jumped);
                 }
-                else if (primitives.goNext) {
-                    const stepped = yield primitives.goNext(context);
-                    if (!stepped)
-                        throw new Error('bringIntoView: goNext failed during goToPage retry');
+                break;
+            case 'goNext':
+                for (let i = 0; i < step.count && primitives.goNext; i++) {
+                    const ok = await primitives.goNext(context);
+                    if (!ok)
+                        throw new Error('goNext failed');
                     setCurrentPage(getCurrentPage() + 1);
                 }
-                else {
-                    const available = Object.keys(primitives).filter(k => primitives[k]);
-                    throw new Error(`bringIntoView: goToPage(${targetPageIndex}) returned false and no goNext/goNextBulk to advance. Available primitives: ${available.join(', ')}`);
-                }
-            }
-            else {
-                const prevBulkSize = (_b = primitives.previousBulkPages) !== null && _b !== void 0 ? _b : 1;
-                const wouldOvershoot = (current - prevBulkSize) < targetPageIndex;
-                const canStepBack = !!primitives.goNext;
-                const useBulk = primitives.goPreviousBulk && (!wouldOvershoot || canStepBack);
-                if (useBulk && primitives.goPreviousBulk) {
-                    const result = yield primitives.goPreviousBulk(context);
+                break;
+            case 'goPreviousBulk':
+                for (let i = 0; i < step.count && primitives.goPreviousBulk; i++) {
+                    const result = await primitives.goPreviousBulk(context);
                     if (!result)
-                        throw new Error('bringIntoView: goPreviousBulk failed during goToPage retry');
-                    const jumped = typeof result === 'number' ? result : prevBulkSize;
+                        throw new Error('goPreviousBulk failed');
+                    const jumped = typeof result === 'number' ? result : 1;
                     setCurrentPage(getCurrentPage() - jumped);
                 }
-                else if (primitives.goPrevious) {
-                    const stepped = yield primitives.goPrevious(context);
-                    if (!stepped)
-                        throw new Error('bringIntoView: goPrevious failed during goToPage retry');
+                break;
+            case 'goPrevious':
+                for (let i = 0; i < step.count && primitives.goPrevious; i++) {
+                    const ok = await primitives.goPrevious(context);
+                    if (!ok)
+                        throw new Error('goPrevious failed');
                     setCurrentPage(getCurrentPage() - 1);
                 }
-                else {
-                    const available = Object.keys(primitives).filter(k => primitives[k]);
-                    throw new Error(`bringIntoView: goToPage(${targetPageIndex}) returned false and no goPrevious/goPreviousBulk to step back. Available primitives: ${available.join(', ')}`);
-                }
-            }
-        }
-        const available = Object.keys(primitives).filter(k => primitives[k]);
-        throw new Error(`bringIntoView: failed to reach page ${targetPageIndex} after ${MAX_GO_TO_PAGE_RETRIES} goToPage retries. Available primitives: ${available.join(', ')}`);
-    });
-}
-/**
- * Executes a navigation path by calling the corresponding primitives.
- * Updates currentPageIndex via the provided setter as steps run.
- */
-function executeNavigationPath(path, primitives, context, getCurrentPage, setCurrentPage) {
-    return __awaiter(this, void 0, void 0, function* () {
-        for (const step of path) {
-            switch (step.type) {
-                case 'goToPage':
-                    if (primitives.goToPage) {
-                        const ok = yield primitives.goToPage(step.pageIndex, context);
-                        if (!ok)
-                            throw new Error(`goToPage(${step.pageIndex}) failed`);
-                        setCurrentPage(step.pageIndex);
-                    }
-                    break;
-                case 'goNextBulk':
-                    for (let i = 0; i < step.count && primitives.goNextBulk; i++) {
-                        const result = yield primitives.goNextBulk(context);
-                        if (!result)
-                            throw new Error('goNextBulk failed');
-                        const jumped = typeof result === 'number' ? result : 1;
-                        setCurrentPage(getCurrentPage() + jumped);
-                    }
-                    break;
-                case 'goNext':
-                    for (let i = 0; i < step.count && primitives.goNext; i++) {
-                        const ok = yield primitives.goNext(context);
-                        if (!ok)
-                            throw new Error('goNext failed');
-                        setCurrentPage(getCurrentPage() + 1);
-                    }
-                    break;
-                case 'goPreviousBulk':
-                    for (let i = 0; i < step.count && primitives.goPreviousBulk; i++) {
-                        const result = yield primitives.goPreviousBulk(context);
-                        if (!result)
-                            throw new Error('goPreviousBulk failed');
-                        const jumped = typeof result === 'number' ? result : 1;
-                        setCurrentPage(getCurrentPage() - jumped);
-                    }
-                    break;
-                case 'goPrevious':
-                    for (let i = 0; i < step.count && primitives.goPrevious; i++) {
-                        const ok = yield primitives.goPrevious(context);
-                        if (!ok)
-                            throw new Error('goPrevious failed');
-                        setCurrentPage(getCurrentPage() - 1);
-                    }
-                    break;
-            }
+                break;
         }
-    });
+    }
 }

package/dist/utils/smartRowArray.js

@@ -1,13 +1,4 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSmartRowArray = createSmartRowArray;
 /**
@@ -15,8 +6,8 @@ exports.createSmartRowArray = createSmartRowArray;
  */
 function createSmartRowArray(rows) {
     const arr = rows;
-    arr.toJSON = () => __awaiter(this, void 0, void 0, function* () {
+    arr.toJSON = async () => {
         return Promise.all(rows.map(r => r.toJSON()));
-    });
+    };
     return arr;
 }

package/dist/utils.js

@@ -1,13 +1,4 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.waitForCondition = void 0;
 /**
@@ -15,15 +6,15 @@ exports.waitForCondition = void 0;
  * Replaces the dependency on 'expect(...).toPass()' to ensure compatibility
  * with environments where 'expect' is not globally available.
  */
-const waitForCondition = (predicate, timeout, page) => __awaiter(void 0, void 0, void 0, function* () {
+const waitForCondition = async (predicate, timeout, page) => {
     const startTime = Date.now();
     while (Date.now() - startTime < timeout) {
-        if (yield predicate()) {
+        if (await predicate()) {
             return true;
         }
         // Wait 100ms before next check (Standard Polling)
-        yield page.waitForTimeout(100).catch(() => new Promise(r => setTimeout(r, 100)));
+        await page.waitForTimeout(100).catch(() => new Promise(r => setTimeout(r, 100)));
     }
     return false;
-});
+};
 exports.waitForCondition = waitForCondition;

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@rickcedwhat/playwright-smart-table",
-  "version": "6.9.0",
+  "version": "6.10.1",
   "description": "Smart, column-aware table interactions for Playwright",
   "author": "Cedrick Catalan",
   "license": "MIT",
   "homepage": "https://rickcedwhat.github.io/playwright-smart-table/",
   "repository": {
     "type": "git",
-    "url": "https://github.com/rickcedwhat/playwright-smart-table.git"
+    "url": "git+https://github.com/rickcedwhat/playwright-smart-table.git"
   },
   "bugs": {
     "url": "https://github.com/rickcedwhat/playwright-smart-table/issues"
@@ -23,8 +23,9 @@
     "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",
+    "docs:dev": "vitepress dev docs --host",
+    "docs:build": "node scripts/docs-build-prod.mjs",
+    "docs:build:all": "vitepress build docs",
     "docs:verify-links": "node scripts/verify-vitepress-links.mjs",
     "embed-version": "node scripts/embed-version.mjs",
     "build": "npm run embed-version && 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",
@@ -39,9 +40,10 @@
     "pretest:e2e": "npm run clean-port",
     "posttest:e2e": "npm run clean-port",
     "test:e2e": "npx playwright test",
+    "test:playground": "npx playwright test --config tests-external/playground/playwright.config.ts 2>&1 | tee \"tests-external/playground/logs/run-$(date +%Y%m%d-%H%M%S).log\"",
     "dev:playground": "cd playground && npm run dev",
     "dev:mui": "cd tests/apps/mui-datagrid && npm run dev",
-    "prepare": "husky install"
+    "prepare": "husky"
   },
   "exports": {
     ".": {
@@ -81,16 +83,19 @@
     "@playwright/test": "^1.40.0"
   },
   "devDependencies": {
-    "@playwright/test": "^1.58.2",
+    "@playwright/test": "^1.59.1",
     "@stryker-mutator/core": "^9.6.0",
     "@stryker-mutator/vitest-runner": "^9.6.0",
-    "@types/node": "^25.3.5",
+    "@types/node": "^25.5.2",
     "@vitest/coverage-v8": "^4.1.0",
     "@vitest/ui": "^4.1.0",
     "happy-dom": "^20.8.3",
     "husky": "^9.1.7",
-    "typescript": "^5.7.2",
+    "typescript": "^6.0.2",
     "vitepress": "^1.6.4",
     "vitest": "^4.1.0"
+  },
+  "dependencies": {
+    "@scarf/scarf": "^1.4.0"
   }
 }