@rickcedwhat/playwright-smart-table 5.4.0 → 6.0.0

package/dist/src/utils/debugUtils.js

@@ -0,0 +1,62 @@
+"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.getDebugDelay = getDebugDelay;
+exports.debugDelay = debugDelay;
+exports.logDebug = logDebug;
+exports.warnIfDebugInCI = warnIfDebugInCI;
+/**
+ * Get delay for specific action type
+ */
+function getDebugDelay(config, actionType) {
+    var _a, _b, _c;
+    if (!((_a = config.debug) === null || _a === void 0 ? void 0 : _a.slow))
+        return 0;
+    if (typeof config.debug.slow === 'number') {
+        return config.debug.slow;
+    }
+    return (_c = (_b = config.debug.slow[actionType]) !== null && _b !== void 0 ? _b : config.debug.slow.default) !== null && _c !== void 0 ? _c : 0;
+}
+/**
+ * Add debug delay for specific action type
+ */
+function debugDelay(config, actionType) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const delay = getDebugDelay(config, actionType);
+        if (delay > 0) {
+            yield new Promise(resolve => setTimeout(resolve, delay));
+        }
+    });
+}
+/**
+ * Log debug message based on log level
+ */
+function logDebug(config, level, message, data) {
+    var _a, _b;
+    const logLevel = (_b = (_a = config.debug) === null || _a === void 0 ? void 0 : _a.logLevel) !== null && _b !== void 0 ? _b : 'none';
+    const levels = { none: 0, error: 1, info: 2, verbose: 3 };
+    if (levels[logLevel] >= levels[level]) {
+        const prefix = level === 'error' ? '❌' : level === 'info' ? 'ℹ️' : '🔍';
+        const timestamp = new Date().toISOString().split('T')[1].split('.')[0];
+        console.log(`${prefix} [${timestamp}] [SmartTable] ${message}`, data !== null && data !== void 0 ? data : '');
+    }
+}
+/**
+ * Warn if debug.slow is enabled in CI environment
+ */
+function warnIfDebugInCI(config) {
+    var _a;
+    if (process.env.CI === 'true' && ((_a = config.debug) === null || _a === void 0 ? void 0 : _a.slow)) {
+        console.warn('⚠️  [SmartTable] Warning: debug.slow is enabled in CI environment.\n' +
+            '   This will significantly slow down test execution.\n' +
+            '   Consider disabling debug mode in CI.');
+    }
+}

package/dist/src/utils/smartRowArray.d.ts

@@ -0,0 +1,14 @@
+import { SmartRow } from '../types';
+/**
+ * Extended array type with a toJSON helper method
+ */
+export interface SmartRowArray<T = any> extends Array<SmartRow<T>> {
+    /**
+     * Converts all rows to JSON objects
+     */
+    toJSON(): Promise<T[]>;
+}
+/**
+ * Wraps a SmartRow array with a convenient toJSON() method
+ */
+export declare function createSmartRowArray<T>(rows: SmartRow<T>[]): SmartRowArray<T>;

package/dist/src/utils/smartRowArray.js

@@ -0,0 +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.createSmartRowArray = createSmartRowArray;
+/**
+ * Wraps a SmartRow array with a convenient toJSON() method
+ */
+function createSmartRowArray(rows) {
+    const arr = rows;
+    arr.toJSON = () => __awaiter(this, void 0, void 0, function* () {
+        return Promise.all(rows.map(r => r.toJSON()));
+    });
+    return arr;
+}

package/dist/src/utils/stringUtils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Calculate Levenshtein distance between two strings
+ * Used for "did you mean?" suggestions
+ */
+export declare function levenshteinDistance(a: string, b: string): number;
+/**
+ * Calculate similarity score between two strings (0-1)
+ * 1 = identical, 0 = completely different
+ */
+export declare function stringSimilarity(a: string, b: string): number;
+/**
+ * Find similar strings from a list
+ * Returns matches above threshold, sorted by similarity
+ */
+export declare function findSimilar(input: string, available: string[], threshold?: number): Array<{
+    value: string;
+    score: number;
+}>;
+/**
+ * Build a helpful error message for column not found
+ */
+export declare function buildColumnNotFoundError(columnName: string, availableColumns: string[]): string;

package/dist/src/utils/stringUtils.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.levenshteinDistance = levenshteinDistance;
+exports.stringSimilarity = stringSimilarity;
+exports.findSimilar = findSimilar;
+exports.buildColumnNotFoundError = buildColumnNotFoundError;
+/**
+ * Calculate Levenshtein distance between two strings
+ * Used for "did you mean?" suggestions
+ */
+function levenshteinDistance(a, b) {
+    const matrix = [];
+    for (let i = 0; i <= b.length; i++) {
+        matrix[i] = [i];
+    }
+    for (let j = 0; j <= a.length; j++) {
+        matrix[0][j] = j;
+    }
+    for (let i = 1; i <= b.length; i++) {
+        for (let j = 1; j <= a.length; j++) {
+            if (b.charAt(i - 1) === a.charAt(j - 1)) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
+                matrix[i][j - 1] + 1, // insertion
+                matrix[i - 1][j] + 1 // deletion
+                );
+            }
+        }
+    }
+    return matrix[b.length][a.length];
+}
+/**
+ * Calculate similarity score between two strings (0-1)
+ * 1 = identical, 0 = completely different
+ */
+function stringSimilarity(a, b) {
+    const distance = levenshteinDistance(a.toLowerCase(), b.toLowerCase());
+    const maxLen = Math.max(a.length, b.length);
+    return maxLen === 0 ? 1 : 1 - (distance / maxLen);
+}
+/**
+ * Find similar strings from a list
+ * Returns matches above threshold, sorted by similarity
+ */
+function findSimilar(input, available, threshold = 0.5) {
+    return available
+        .map(value => ({
+        value,
+        score: stringSimilarity(input, value)
+    }))
+        .filter(x => x.score >= threshold)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, 3); // Top 3 suggestions
+}
+/**
+ * Build a helpful error message for column not found
+ */
+function buildColumnNotFoundError(columnName, availableColumns) {
+    const suggestions = findSimilar(columnName, availableColumns);
+    let message = `Column '${columnName}' not found`;
+    if (suggestions.length > 0) {
+        message += `\n\nDid you mean:`;
+        suggestions.forEach(({ value, score }) => {
+            const percentage = Math.round(score * 100);
+            message += `\n  • ${value} (${percentage}% match)`;
+        });
+    }
+    message += `\n\nAvailable columns: ${availableColumns.join(', ')}`;
+    message += `\n\nTip: Column names are case-sensitive`;
+    return message;
+}

package/dist/src/utils.d.ts

@@ -0,0 +1,7 @@
+import { Page } from '@playwright/test';
+/**
+ * Internal helper to wait for a condition to be met.
+ * Replaces the dependency on 'expect(...).toPass()' to ensure compatibility
+ * with environments where 'expect' is not globally available.
+ */
+export declare const waitForCondition: (predicate: () => Promise<boolean>, timeout: number, page: Page) => Promise<boolean>;

package/dist/src/utils.js

@@ -0,0 +1,29 @@
+"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;
+/**
+ * Internal helper to wait for a condition to be met.
+ * 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 startTime = Date.now();
+    while (Date.now() - startTime < timeout) {
+        if (yield predicate()) {
+            return true;
+        }
+        // Wait 100ms before next check (Standard Polling)
+        yield page.waitForTimeout(100).catch(() => new Promise(r => setTimeout(r, 100)));
+    }
+    return false;
+});
+exports.waitForCondition = waitForCondition;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rickcedwhat/playwright-smart-table",
-  "version": "5.4.0",
+  "version": "6.0.0",
   "description": "Smart, column-aware table interactions for Playwright",
   "author": "Cedrick Catalan",
   "license": "MIT",
@@ -42,7 +42,5 @@
     "typescript": "^5.7.2",
     "vitepress": "^1.6.4"
   },
-  "dependencies": {
-    "string-similarity": "^4.0.4"
-  }
+  "dependencies": {}
 }