tamash-playwright 0.3.0 → 0.5.0

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;AACA,qCAAqC;AAErC,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,EAAE,AAAD,EAAG,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAE5C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,MAAM,IAAA,kBAAS,EAAC,IAAI,CAAC,CAAC;YACtB,MAAM;QACR,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;YAC9D,MAAM;QACR;YACE,OAAO,CAAC,GAAG,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;YAC9D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/cli/scanDescribe.d.ts

@@ -0,0 +1,11 @@
+export type LocatorOccurrence = {
+    file: string;
+    line: number;
+    method: string;
+    snippet: string;
+    hasDescribe: boolean;
+    priority: 'high' | 'normal';
+};
+export declare function scanFileForLocators(filePath: string, content: string): LocatorOccurrence[];
+export declare function scanTestDirectory(testDir: string, pattern?: RegExp): LocatorOccurrence[];
+//# sourceMappingURL=scanDescribe.d.ts.map

package/dist/cli/scanDescribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanDescribe.d.ts","sourceRoot":"","sources":["../../src/cli/scanDescribe.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC7B,CAAC;AAmBF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE,CA0B1F;AAsBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAA+B,GAAG,iBAAiB,EAAE,CAQhH"}

package/dist/cli/scanDescribe.js

@@ -0,0 +1,84 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanFileForLocators = scanFileForLocators;
+exports.scanTestDirectory = scanTestDirectory;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const LOCATOR_FACTORY_METHODS = ['locator', 'getByRole', 'getByLabel', 'getByPlaceholder', 'getByText', 'getByAltText', 'getByTitle', 'getByTestId'];
+const LOCATOR_FACTORY_PATTERN = new RegExp(`\\.(${LOCATOR_FACTORY_METHODS.join('|')})\\(`, 'g');
+// `.locator()` (raw CSS/XPath) carries no semantic meaning on its own, so a missing .describe()
+// hurts it the most — the other factories at least auto-derive a usable description from their
+// own arguments (see describeFactoryCall in src/bindings/locator.binding.ts).
+const HIGH_PRIORITY_METHODS = new Set(['locator']);
+const SKIP_DIRECTORIES = new Set(['node_modules', 'dist', '.git', 'test-results', 'playwright-report']);
+const STATEMENT_LOOKAHEAD_CHARS = 300;
+function statementHasDescribe(content, matchIndex) {
+    const window = content.slice(matchIndex, matchIndex + STATEMENT_LOOKAHEAD_CHARS);
+    const semicolonIndex = window.indexOf(';');
+    const statement = semicolonIndex === -1 ? window : window.slice(0, semicolonIndex);
+    return statement.includes('.describe(');
+}
+function lineNumberAt(content, index) {
+    let line = 1;
+    for (let i = 0; i < index; i++) {
+        if (content[i] === '\n')
+            line++;
+    }
+    return line;
+}
+// A plain regex scan over source text, not a real TS parser — good enough to flag likely issues
+// for a human (or an AI IDE) to review, not a strict/exhaustive linter.
+function scanFileForLocators(filePath, content) {
+    const occurrences = [];
+    const lines = content.split('\n');
+    LOCATOR_FACTORY_PATTERN.lastIndex = 0;
+    let match;
+    while ((match = LOCATOR_FACTORY_PATTERN.exec(content))) {
+        const method = match[1];
+        const line = lineNumberAt(content, match.index);
+        const lineText = (lines[line - 1] ?? '').trim();
+        if (lineText.startsWith('//') || lineText.startsWith('*')) {
+            continue;
+        }
+        occurrences.push({
+            file: filePath,
+            line,
+            method,
+            snippet: lineText.slice(0, 100),
+            hasDescribe: statementHasDescribe(content, match.index),
+            priority: HIGH_PRIORITY_METHODS.has(method) ? 'high' : 'normal',
+        });
+    }
+    return occurrences;
+}
+function walk(dir, pattern, occurrences) {
+    for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isDirectory()) {
+            if (SKIP_DIRECTORIES.has(entry.name))
+                continue;
+            walk(path_1.default.join(dir, entry.name), pattern, occurrences);
+            continue;
+        }
+        if (pattern.test(entry.name)) {
+            const fullPath = path_1.default.join(dir, entry.name);
+            const content = fs_1.default.readFileSync(fullPath, 'utf-8');
+            occurrences.push(...scanFileForLocators(fullPath, content));
+        }
+    }
+}
+// Scans files matching `pattern` (test/spec files by default) for Playwright locators defined
+// directly inline. Every occurrence returned here is, by definition, a locator written straight
+// into a test file rather than inside a Page Object — that's what powers the page-object-usage
+// recommendation in doctor.ts, on top of the per-locator missing-.describe() findings.
+function scanTestDirectory(testDir, pattern = /\.(spec|test)\.tsx?$/) {
+    if (!fs_1.default.existsSync(testDir)) {
+        return [];
+    }
+    const occurrences = [];
+    walk(testDir, pattern, occurrences);
+    return occurrences;
+}
+//# sourceMappingURL=scanDescribe.js.map

package/dist/cli/scanDescribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanDescribe.js","sourceRoot":"","sources":["../../src/cli/scanDescribe.ts"],"names":[],"mappings":"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"}

package/dist/healer/action-recovery.d.ts

@@ -0,0 +1,14 @@
+import type { Locator } from '@playwright/test';
+import type { ActionTactic, HealProvider, TokenUsage } from './providers/types';
+export declare function applyActionTactic(tactic: Exclude<ActionTactic, 'none'>, locator: Locator, action: string, callArgs: unknown[]): Promise<unknown>;
+export type ActionRecoveryOutcome = {
+    healing: {
+        provider: string;
+        warning: string;
+        result: unknown;
+    } | null;
+    usage?: TokenUsage;
+    stage?: 'action_recovery_declined' | 'action_recovery_failed';
+};
+export declare function tryActionRecovery(provider: HealProvider, locator: Locator, action: string, callArgs: unknown[], replayErrorMessage: string, timeoutMs: number | undefined): Promise<ActionRecoveryOutcome>;
+//# sourceMappingURL=action-recovery.d.ts.map

package/dist/healer/action-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-recovery.d.ts","sourceRoot":"","sources":["../../src/healer/action-recovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAuDhF,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBtJ;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACvE,KAAK,CAAC,EAAE,UAAU,CAAC;IAMnB,KAAK,CAAC,EAAE,0BAA0B,GAAG,wBAAwB,CAAC;CAC/D,CAAC;AAMF,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EAAE,EACnB,kBAAkB,EAAE,MAAM,EAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAuBhC"}

package/dist/healer/action-recovery.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyActionTactic = applyActionTactic;
+exports.tryActionRecovery = tryActionRecovery;
+const replay_action_1 = require("./replay-action");
+// Verified directly against the installed playwright-core type definitions (not assumed) — these
+// are the only Locator methods whose options accept `force`. `dragTo` also accepts it but isn't
+// in the replayable action set at all, so it's irrelevant here.
+const FORCE_CAPABLE_ACTIONS = new Set([
+    'check', 'clear', 'click', 'dblclick', 'fill', 'hover', 'selectOption', 'selectText', 'setChecked', 'tap', 'uncheck',
+]);
+// Deliberately small and explicit — anything not listed here declines the `dispatch` tactic
+// rather than guessing at an event name that might not correspond to real browser behavior.
+const DISPATCH_EVENT_MAP = {
+    click: 'click',
+    dblclick: 'dblclick',
+    focus: 'focus',
+    blur: 'blur',
+    hover: 'mouseover',
+};
+const WAIT_TACTIC_DELAY_MS = 500;
+async function replayActionWithForce(locator, action, callArgs) {
+    const [firstArg] = callArgs;
+    switch (action) {
+        case 'click':
+            return locator.click({ force: true });
+        case 'dblclick':
+            return locator.dblclick({ force: true });
+        case 'tap':
+            return locator.tap({ force: true });
+        case 'hover':
+            return locator.hover({ force: true });
+        case 'check':
+            return locator.check({ force: true });
+        case 'uncheck':
+            return locator.uncheck({ force: true });
+        case 'fill':
+            return locator.fill(String(firstArg ?? ''), { force: true });
+        case 'clear':
+            return locator.clear({ force: true });
+        case 'selectOption':
+            return locator.selectOption(firstArg, { force: true });
+        case 'selectText':
+            return locator.selectText({ force: true });
+        case 'setChecked':
+            return locator.setChecked(Boolean(firstArg), { force: true });
+        default:
+            // Unreachable given the FORCE_CAPABLE_ACTIONS check in applyActionTactic() below, but kept
+            // as a real error (not a silent no-op) in case the two ever drift out of sync.
+            throw new Error(`Action "${action}" does not support a force retry.`);
+    }
+}
+async function applyActionTactic(tactic, locator, action, callArgs) {
+    switch (tactic) {
+        case 'scroll':
+            await locator.scrollIntoViewIfNeeded();
+            return (0, replay_action_1.replayAction)(locator, action, callArgs);
+        case 'wait':
+            await new Promise((resolve) => setTimeout(resolve, WAIT_TACTIC_DELAY_MS));
+            return (0, replay_action_1.replayAction)(locator, action, callArgs);
+        case 'force':
+            if (!FORCE_CAPABLE_ACTIONS.has(action)) {
+                throw new Error(`Action "${action}" does not support a force retry.`);
+            }
+            return replayActionWithForce(locator, action, callArgs);
+        case 'dispatch': {
+            const eventType = DISPATCH_EVENT_MAP[action];
+            if (!eventType) {
+                throw new Error(`Action "${action}" has no direct DOM event to dispatch.`);
+            }
+            return locator.dispatchEvent(eventType);
+        }
+    }
+}
+// Strictly a second-order fallback: only ever called after a locator has already been
+// successfully healed (by the text or vision path) but replaying the original action on it still
+// failed. Bounded by design — the AI only ever picks among applyActionTactic()'s fixed menu, it
+// never decides how to interact with the page on its own.
+async function tryActionRecovery(provider, locator, action, callArgs, replayErrorMessage, timeoutMs) {
+    const result = await provider.suggestActionTactic({ action, errorMessage: replayErrorMessage, timeoutMs });
+    if (!result) {
+        return { healing: null, stage: 'action_recovery_failed' };
+    }
+    if (result.tactic === 'none') {
+        return { healing: null, usage: result.usage, stage: 'action_recovery_declined' };
+    }
+    try {
+        const tacticResult = await applyActionTactic(result.tactic, locator, action, callArgs);
+        return {
+            healing: {
+                provider: provider.name,
+                warning: `Recovered using ${provider.name} via action recovery (${result.tactic}).`,
+                result: tacticResult,
+            },
+            usage: result.usage,
+        };
+    }
+    catch {
+        return { healing: null, usage: result.usage, stage: 'action_recovery_failed' };
+    }
+}
+//# sourceMappingURL=action-recovery.js.map

package/dist/healer/action-recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-recovery.js","sourceRoot":"","sources":["../../src/healer/action-recovery.ts"],"names":[],"mappings":"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"}

package/dist/healer/index.d.ts

@@ -1,6 +1,6 @@
-import type { Frame, Locator, Page } from '@playwright/test';
+import type { Frame, FrameLocator, Locator, Page } from '@playwright/test';
 import type { TokenUsage } from './providers/types';
-type BindingKind = 'locator' | 'page' | 'frame';
+type BindingKind = 'locator' | 'page' | 'frame' | 'frameLocator';
 export type SelfHealingReport = {
     action: string;
     kind: BindingKind;
@@ -11,7 +11,13 @@ export type SelfHealingReport = {
     reason: string;
     suggestedSelector?: string;
     tokenUsage?: TokenUsage;
+    failureStage?: string;
+    usedVision: boolean;
+    usedActionRecovery: boolean;
+    sourceLocation?: string;
 };
+export declare function isHealingEnabled(): boolean;
+export declare function isActionRecoveryEnabled(): boolean;
 export declare function healActionFailure(context: {
     action: string;
     kind: BindingKind;
@@ -19,6 +25,8 @@ export declare function healActionFailure(context: {
     error: unknown;
     target?: Locator | Page | Frame;
     callArgs?: unknown[];
+    frameScope?: FrameLocator;
+    sourceLocation?: string;
 }): Promise<{
     report: SelfHealingReport;
     recovered: boolean;

package/dist/healer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/healer/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAI7D,OAAO,KAAK,EAAsB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIxE,KAAK,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAoOF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,KAAK,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAyC/E;AAED,wBAAgB,iBAAiB,IAAI,iBAAiB,EAAE,CAEvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/healer/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAI3E,OAAO,KAAK,EAAoC,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAOtF,KAAK,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,cAAc,CAAC;AAEjE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IAKtB,UAAU,EAAE,OAAO,CAAC;IAIpB,kBAAkB,EAAE,OAAO,CAAC;IAK5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAsSF,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAMD,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD;AAmED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,KAAK,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IAKrB,UAAU,CAAC,EAAE,YAAY,CAAC;IAG1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAyJ/E;AAED,wBAAgB,iBAAiB,IAAI,iBAAiB,EAAE,CAEvD"}