@testmuai/playwright-bindings 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 TestMu AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# @testmuai/playwright-bindings
+
+Thin runtime for testmu-style Playwright tests in TypeScript/JavaScript. Companion to [`testmuai-playwright-bindings`](../playwright-python/) (Python).
+
+## Install
+
+```bash
+npm install @testmuai/playwright-bindings playwright
+```
+
+## Usage
+
+```typescript
+import testmu, { v, setVar } from "@testmuai/playwright-bindings";
+import { expect } from "@playwright/test";
+
+testmu.configure({
+  build: "build-123",
+  name: "Login Test",
+  variables: { email: "user@test.com" },
+  testParams: { BASE_URL: "https://example.com" },
+});
+
+testmu.test("Login flow", async (page) => {
+  testmu.step("Navigate");
+  await page.goto(v("${BASE_URL}"));
+  testmu.done();
+
+  testmu.step("Fill credentials");
+  await page.locator("#email").fill(v("{{email}}"));
+  testmu.done();
+});
+
+testmu.run();
+```
+
+## Env vars
+
+| Var                            | Purpose                                                          |
+| ------------------------------ | ---------------------------------------------------------------- |
+| `TESTMU_RUN_TARGET`            | `local` (default) or `cloud`                                     |
+| `LT_USERNAME`, `LT_ACCESS_KEY` | LambdaTest credentials (enables ATMS + vision)                   |
+| `TESTMU_SMART`                 | `1` enables vision/heal (validated at run() — requires LT creds) |
+
+## Build
+
+```bash
+npm run build       # tsc → dist/
+npm test            # vitest run
+npm run typecheck   # tsc --noEmit
+```

package/dist/capability.d.ts

@@ -0,0 +1,60 @@
+export interface ChromeOption {
+    key: string;
+    value?: string;
+    type?: 'file' | 'no-args' | string;
+}
+export interface LTOptions {
+    platform: string;
+    user: string | undefined;
+    accessKey: string | undefined;
+    video: boolean;
+    resolution: string;
+    network: boolean;
+    'network.full.har': boolean;
+    build: string;
+    project: string;
+    name: string;
+    w3c: true;
+    plugin: string;
+    visual: boolean;
+    console: boolean;
+    'tms.tc_id': string;
+    loadExtensions: (string | undefined)[];
+    playwrightClientVersion: string;
+    tunnel: boolean;
+    performance: boolean;
+    dedicatedProxy: boolean;
+    idleTimeout: number;
+    accessibility: boolean;
+    hideInternalCommandLogs: true;
+    dependentTestsInScenario: boolean;
+    timezone?: string;
+    geoLocation?: string;
+    customHeaders?: Record<string, string>;
+    'goog:chromeOptions'?: string[];
+    'ms:edgeOptions'?: string[];
+    firefoxUserPrefs?: Record<string, unknown>;
+}
+export interface Capabilities {
+    browserName: string;
+    browserVersion: string;
+    'LT:Options': LTOptions;
+}
+/**
+ * Build and return the LambdaTest capabilities dict.
+ * Async because testConfig resolution is async.
+ */
+export declare function buildCapabilities(): Promise<Capabilities>;
+/**
+ * Build the LambdaTest CDP WebSocket URL from a capabilities dict.
+ * Credentials live inside LT:Options — no user/accessKey URL params.
+ */
+export declare function getCdpUrl(caps: Capabilities): string;
+/**
+ * Parse a resolution string like '1920x1080' into a viewport dict.
+ */
+export declare function getViewport(resolution?: string): {
+    width: number;
+    height: number;
+};
+//# sourceMappingURL=capability.d.ts.map

package/dist/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,IAAI,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IACvC,uBAAuB,EAAE,MAAM,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,uBAAuB,EAAE,IAAI,CAAC;IAC9B,wBAAwB,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,SAAS,CAAC;CACzB;AAwBD;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,YAAY,CAAC,CA6J/D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAKpD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAKlF"}

package/dist/capability.js

@@ -0,0 +1,212 @@
+/**
+ * LambdaTest capability builder for Playwright TypeScript.
+ *
+ * Fallback chain: configure() > HE testConfig > env vars > defaults.
+ * Sets smart_os / smart_browser_name / etc. env vars as side-effect
+ * so that vars.ts {{smart.os_type}} / {{smart.browser_name}} resolve.
+ *
+ * Full Python parity with testmu/_capability.py::get_capabilities().
+ * Intentional deviation: plugin = "node-node" (Python uses "python-python").
+ */
+import { createRequire } from 'node:module';
+import { get, wasSet } from './configure.js';
+import { getCapValue, loadTestConfig } from './testConfig.js';
+// ESM-safe require for reading playwright/package.json at runtime
+const _require = createRequire(import.meta.url);
+function getPwVersion() {
+    try {
+        return _require('playwright/package.json').version;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function getDownloadsFolder() {
+    if (process.platform === 'win32') {
+        return `${process.env['USERPROFILE'] ?? ''}\\Downloads`;
+    }
+    return `${process.env['HOME'] ?? '~'}/Downloads`;
+}
+async function boolHe(key, def) {
+    const v = await getCapValue(key, undefined);
+    if (v === undefined || v === null)
+        return def;
+    if (typeof v === 'boolean')
+        return v;
+    return ['1', 'true', 'yes'].includes(String(v).toLowerCase());
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Build and return the LambdaTest capabilities dict.
+ * Async because testConfig resolution is async.
+ */
+export async function buildCapabilities() {
+    // Top-level fields: configure() not in scope for these, so env > default
+    const browserName = process.env['LT_BROWSER'] ?? 'Chrome';
+    const browserVersion = process.env['LT_BROWSER_VERSION'] ?? 'latest';
+    const resolution = process.env['LT_RESOLUTION'] ?? '1920x1080';
+    const platform = process.env['LT_PLATFORM'] ?? 'linux';
+    const user = process.env['LT_USERNAME'];
+    const accessKey = process.env['LT_ACCESS_KEY'];
+    // build + name + tc_id: configure() > HE testConfig > env > default
+    const build = String((wasSet('build') ? get('build') : '') ||
+        (await getCapValue('BUILD', process.env['BUILD'] ?? '')));
+    const name = String((wasSet('name') ? get('name') : '') ||
+        (await getCapValue('TEST_NAME', process.env['TEST_NAME'] ?? '')));
+    const tcId = String((wasSet('tcId') ? get('tcId') : '') ||
+        (process.env['LT_TC_ID'] ?? ''));
+    // network: configure() wins when explicitly set, else HE testConfig > env > false
+    const network = wasSet('network')
+        ? Boolean(get('network'))
+        : await boolHe('NETWORK', false);
+    // multipleProfiles: configure() wins when explicitly set, else false
+    const multipleProfiles = wasSet('multipleProfiles')
+        ? Boolean(get('multipleProfiles'))
+        : false;
+    // Bool caps: configure() has no explicit setters → HE testConfig > env > default
+    const video = await boolHe('VIDEO', true);
+    const visual = await boolHe('VISUAL', true);
+    const consoleLog = await boolHe('CONSOLE', true);
+    const tunnel = await boolHe('TUNNEL', false);
+    const performance = await boolHe('PERFORMANCE', false);
+    const dedicatedProxy = await boolHe('DEDICATED_PROXY', false);
+    const accessibility = await boolHe('ACCESSIBILITY', false);
+    const idleTimeout = Number((await getCapValue('IDLE_TIMEOUT', process.env['IDLE_TIMEOUT'] ?? '1800')) ?? '1800');
+    const caps = {
+        browserName,
+        browserVersion,
+        'LT:Options': {
+            platform,
+            user,
+            accessKey,
+            video,
+            resolution,
+            network,
+            'network.full.har': network,
+            build,
+            project: 'Auteur-Code-Export',
+            name,
+            w3c: true,
+            plugin: 'node-node', // intentional deviation: Python uses "python-python"
+            visual,
+            console: consoleLog,
+            'tms.tc_id': tcId,
+            loadExtensions: [process.env['EXTENSION']],
+            playwrightClientVersion: getPwVersion(),
+            tunnel,
+            performance,
+            dedicatedProxy,
+            idleTimeout,
+            accessibility,
+            hideInternalCommandLogs: true,
+            dependentTestsInScenario: multipleProfiles,
+        },
+    };
+    // Geolocation — conditional (only set if env var present)
+    if (process.env['GEO_LOCATION']) {
+        caps['LT:Options'].geoLocation = process.env['GEO_LOCATION'];
+    }
+    // Timezone — configure() > testConfig.timezone.region > env var
+    let tz = wasSet('timezone') ? String(get('timezone')) : '';
+    if (!tz) {
+        const tc = await loadTestConfig();
+        if (tc) {
+            const tzVal = tc['timezone'];
+            if (tzVal && typeof tzVal === 'object' && 'region' in tzVal) {
+                const region = tzVal.region;
+                if (region)
+                    tz = region;
+            }
+        }
+    }
+    if (!tz)
+        tz = process.env['TIMEZONE'] ?? '';
+    if (tz)
+        caps['LT:Options'].timezone = tz;
+    // Custom headers — conditional
+    const hdrs = get('customHeaders');
+    if (Object.keys(hdrs).length > 0) {
+        caps['LT:Options'].customHeaders = hdrs;
+    }
+    // Browser-specific options
+    const bLow = browserName.toLowerCase();
+    if (bLow === 'chrome' || bLow === 'pw-chromium') {
+        const defaultArgs = [
+            '--enable-logging',
+            '--disable-notifications',
+            '--no-sandbox',
+            '--log-level=0',
+            '--ignore-certificate-errors',
+            '--disable-blink-features=AutomationControlled',
+            '--password-store=basic',
+            '--safebrowsing-disable-auto-update',
+            '--disable-sync',
+        ];
+        caps['LT:Options']['goog:chromeOptions'] = [...defaultArgs];
+        const chromeOpts = get('chromeOptions');
+        for (const op of chromeOpts) {
+            const k = op.key ?? '';
+            const t = op.type ?? '';
+            const val = op.value ?? '';
+            if (t === 'no-args') {
+                caps['LT:Options']['goog:chromeOptions'].push(k);
+            }
+            else if (t === 'file') {
+                const filePath = `${getDownloadsFolder()}/${val}`;
+                caps['LT:Options']['goog:chromeOptions'].push(`${k}=${filePath}`);
+            }
+            else {
+                caps['LT:Options']['goog:chromeOptions'].push(`${k}=${val}`);
+            }
+        }
+    }
+    else if (bLow === 'microsoftedge') {
+        caps['LT:Options']['ms:edgeOptions'] = [
+            '--enable-logging',
+            '--disable-notifications',
+            '--log-level=0',
+            '--disable-blink-features=AutomationControlled',
+            '--password-store=basic',
+            '--safebrowsing-disable-auto-update',
+            '--disable-sync',
+        ];
+    }
+    else if (bLow === 'firefox' || bLow === 'pw-firefox') {
+        caps['LT:Options'].firefoxUserPrefs = {
+            'dom.webnotifications.enabled': false,
+            'signon.rememberSignons': false,
+            'signon.autofillForms': false,
+            'permissions.default.desktop-notification': 2,
+        };
+    }
+    // Side-effect: set smart_* env vars (same as Python template)
+    process.env['smart_os'] = caps['LT:Options'].platform;
+    process.env['smart_os_version'] = 'latest';
+    process.env['smart_browser_name'] = caps.browserName;
+    process.env['smart_browser_version'] = caps.browserVersion;
+    return caps;
+}
+/**
+ * Build the LambdaTest CDP WebSocket URL from a capabilities dict.
+ * Credentials live inside LT:Options — no user/accessKey URL params.
+ */
+export function getCdpUrl(caps) {
+    return ('wss://cdp.lambdatest.com/playwright?capabilities=' +
+        encodeURIComponent(JSON.stringify(caps)));
+}
+/**
+ * Parse a resolution string like '1920x1080' into a viewport dict.
+ */
+export function getViewport(resolution) {
+    const res = resolution ?? process.env['LT_RESOLUTION'] ?? '1920x1080';
+    const m = res.toLowerCase().match(/^(\d+)x(\d+)$/);
+    if (!m)
+        return { width: 1920, height: 1080 };
+    return { width: Number(m[1]), height: Number(m[2]) };
+}
+//# sourceMappingURL=capability.js.map

package/dist/capability.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+export type RunTarget = 'local' | 'cloud';
+export interface Config {
+    runTarget: RunTarget;
+    ltAuth: boolean;
+    smart: boolean;
+}
+export declare function readConfig(): Config;
+export declare const config: {
+    readonly current: Config;
+};
+export declare function _refresh(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1C,MAAM,WAAW,MAAM;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,UAAU,IAAI,MAAM,CAOnC;AAGD,eAAO,MAAM,MAAM,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAI9C,CAAC;AACF,wBAAgB,QAAQ,IAAI,IAAI,CAE/B"}

package/dist/config.js

@@ -0,0 +1,16 @@
+export function readConfig() {
+    const runTarget = process.env['TESTMU_RUN_TARGET'] === 'cloud' ? 'cloud' : 'local';
+    const ltAuth = Boolean(process.env['LT_USERNAME']) && Boolean(process.env['LT_ACCESS_KEY']);
+    const smart = process.env['TESTMU_SMART'] === '1';
+    return { runTarget, ltAuth, smart };
+}
+let _snapshot = readConfig();
+export const config = {
+    get current() {
+        return _snapshot;
+    },
+};
+export function _refresh() {
+    _snapshot = readConfig();
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,UAAU;IACxB,MAAM,SAAS,GACb,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACnE,MAAM,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,GAAG,CAAC;IAClD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC;AAED,IAAI,SAAS,GAAW,UAAU,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,MAAM,GAAiC;IAClD,IAAI,OAAO;QACT,OAAO,SAAS,CAAC;IACnB,CAAC;CACF,CAAC;AACF,MAAM,UAAU,QAAQ;IACtB,SAAS,GAAG,UAAU,EAAE,CAAC;AAC3B,CAAC"}

package/dist/configure.d.ts

@@ -0,0 +1,30 @@
+export interface GlobalVariable {
+    name: string;
+    value: string;
+    is_persist: boolean;
+    session_value?: string;
+}
+export interface ConfigureOptions {
+    build?: string;
+    name?: string;
+    tcId?: string;
+    network?: boolean;
+    timezone?: string;
+    chromeOptions?: string[];
+    customHeaders?: Record<string, string>;
+    multipleProfiles?: boolean;
+    variables?: Record<string, unknown>;
+    testParams?: Record<string, unknown>;
+    globalVariables?: GlobalVariable[];
+    uploadedFiles?: string[];
+}
+declare const DEFAULTS: Required<ConfigureOptions>;
+type ConfigKey = keyof typeof DEFAULTS;
+type ConfigureHook = (opts: ConfigureOptions) => void;
+export declare function _registerConfigureHook(hook: ConfigureHook): void;
+export declare function configure(opts: ConfigureOptions): void;
+export declare function get<K extends ConfigKey>(key: K): (typeof DEFAULTS)[K];
+export declare function wasSet(key: ConfigKey): boolean;
+export declare function _reset(): void;
+export {};
+//# sourceMappingURL=configure.d.ts.map

package/dist/configure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../src/configure.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,QAAA,MAAM,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAaxC,CAAC;AAEF,KAAK,SAAS,GAAG,MAAM,OAAO,QAAQ,CAAC;AAKvC,KAAK,aAAa,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAGtD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAEhE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAUtD;AAED,wBAAgB,GAAG,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAErE;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAE9C;AAED,wBAAgB,MAAM,IAAI,IAAI,CAU7B"}

package/dist/configure.js

@@ -0,0 +1,53 @@
+const DEFAULTS = {
+    build: '',
+    name: '',
+    tcId: '',
+    network: false,
+    timezone: '',
+    chromeOptions: [],
+    customHeaders: {},
+    multipleProfiles: false,
+    variables: {},
+    testParams: {},
+    globalVariables: [],
+    uploadedFiles: [],
+};
+const data = { ...DEFAULTS };
+const setKeys = new Set();
+const hooks = [];
+export function _registerConfigureHook(hook) {
+    hooks.push(hook);
+}
+export function configure(opts) {
+    for (const key of Object.keys(opts)) {
+        if (!(key in DEFAULTS)) {
+            console.warn(`testmu.configure: unknown key '${key}', ignoring`);
+            continue;
+        }
+        data[key] = opts[key];
+        setKeys.add(key);
+    }
+    for (const hook of hooks)
+        hook(opts);
+}
+export function get(key) {
+    return data[key];
+}
+export function wasSet(key) {
+    return setKeys.has(key);
+}
+export function _reset() {
+    for (const key of Object.keys(DEFAULTS)) {
+        const def = DEFAULTS[key];
+        if (Array.isArray(def))
+            data[key] = [];
+        else if (typeof def === 'object' && def !== null)
+            data[key] = {};
+        else
+            data[key] = def;
+    }
+    setKeys.clear();
+    // NOTE: hooks are NOT cleared — they are registered once at module load and are stable
+    // for the process lifetime. Clearing them would break configure→vars wiring after _reset().
+}
+//# sourceMappingURL=configure.js.map

package/dist/configure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.js","sourceRoot":"","sources":["../src/configure.ts"],"names":[],"mappings":"AAsBA,MAAM,QAAQ,GAA+B;IAC3C,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,EAAE;IACZ,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,gBAAgB,EAAE,KAAK;IACvB,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,EAAE;IACd,eAAe,EAAE,EAAE;IACnB,aAAa,EAAE,EAAE;CAClB,CAAC;AAIF,MAAM,IAAI,GAA+B,EAAE,GAAG,QAAQ,EAAE,CAAC;AACzD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAa,CAAC;AAGrC,MAAM,KAAK,GAAoB,EAAE,CAAC;AAElC,MAAM,UAAU,sBAAsB,CAAC,IAAmB;IACxD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAsB;IAC9C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAgB,EAAE,CAAC;QACnD,IAAI,CAAC,CAAC,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,kCAAkC,GAAG,aAAa,CAAC,CAAC;YACjE,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,GAAG,CAAsB,GAAM;IAC7C,OAAO,IAAI,CAAC,GAAG,CAAyB,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAc;IACnC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,MAAM;IACpB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAgB,EAAE,CAAC;QACvD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAG,IAAmC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;aAClE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;YAAG,IAAmC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;;YAC3F,IAAmC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACvD,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,CAAC;IAChB,uFAAuF;IACvF,4FAA4F;AAC9F,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class TestmuConfigError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,7 @@
+export class TestmuConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'TestmuConfigError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}

package/dist/healPatch.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Install heal wrappers on Locator.prototype.
+ * Idempotent: safe to call multiple times; the second call is a no-op.
+ */
+export declare function installHealPatch(): void;
+/**
+ * Restore Locator.prototype to its original state.
+ * Used by tests to prevent patch leakage across test files.
+ */
+export declare function _uninstallHealPatch(): void;
+//# sourceMappingURL=healPatch.d.ts.map

package/dist/healPatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healPatch.d.ts","sourceRoot":"","sources":["../src/healPatch.ts"],"names":[],"mappings":"AAqEA;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAYvC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}

package/dist/healPatch.js

@@ -0,0 +1,82 @@
+import { currentStep } from './step.js';
+import { config } from './config.js';
+import { getVisionCoordinates } from './helpers/vision.js';
+const HEAL_METHODS = [
+    'click', 'dblclick', 'fill', 'type', 'press',
+    'hover', 'check', 'uncheck', 'selectOption',
+    'setInputFiles', 'scrollIntoViewIfNeeded', 'focus', 'tap',
+];
+const COORD_METHODS = new Set(['click', 'dblclick', 'hover']);
+const originals = new Map();
+let installed = false;
+function wrap(name, original) {
+    return async function wrapped(...args) {
+        const stepInfo = currentStep();
+        // Outside a step or smart mode off — pure passthrough, no overhead.
+        if (!stepInfo || !config.current.smart)
+            return original.apply(this, args);
+        try {
+            return await original.apply(this, args);
+        }
+        catch (e) {
+            const err = e;
+            if (err?.name === 'TimeoutError' &&
+                (await this.count()) === 0 &&
+                COORD_METHODS.has(name)) {
+                // Element is genuinely absent — try vision-coordinate heal.
+                // getVisionCoordinates may throw (Python 13d9f6b: no silent fallback
+                // when smart is ON); on any vision failure, re-throw the original
+                // TimeoutError so the test surfaces the real problem.
+                try {
+                    const page = this.page();
+                    const coords = await getVisionCoordinates(page, stepInfo.description, name);
+                    if (coords) {
+                        if (name === 'hover')
+                            return page.mouse.move(coords.x, coords.y);
+                        // click and dblclick exist on page.mouse under the same name.
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        return page.mouse[name](coords.x, coords.y);
+                    }
+                }
+                catch {
+                    // Vision heal failed — surface original TimeoutError below.
+                }
+            }
+            // Heal not applicable or heal failed — surface original error.
+            throw e;
+        }
+    };
+}
+/**
+ * Install heal wrappers on Locator.prototype.
+ * Idempotent: safe to call multiple times; the second call is a no-op.
+ */
+export function installHealPatch() {
+    if (installed)
+        return;
+    // @ts-ignore — Locator is an interface in TS but a concrete class at runtime.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const proto = Locator.prototype;
+    for (const name of HEAL_METHODS) {
+        const orig = proto[name];
+        if (typeof orig !== 'function')
+            continue;
+        originals.set(name, orig);
+        proto[name] = wrap(name, orig);
+    }
+    installed = true;
+}
+/**
+ * Restore Locator.prototype to its original state.
+ * Used by tests to prevent patch leakage across test files.
+ */
+export function _uninstallHealPatch() {
+    // @ts-ignore — Locator is an interface in TS but a concrete class at runtime.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const proto = Locator.prototype;
+    for (const [name, orig] of originals)
+        proto[name] = orig;
+    originals.clear();
+    installed = false;
+}
+//# sourceMappingURL=healPatch.js.map

package/dist/healPatch.js.map

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

package/dist/helpers/assertion.d.ts

@@ -0,0 +1,23 @@
+import type { Page } from 'playwright';
+export interface SubCheck {
+    store_key?: string;
+    operator: string;
+    expected_value?: unknown;
+    expected?: unknown;
+    extracted_value?: unknown;
+    description?: string;
+    transforms?: string[];
+}
+export interface AssertionTree {
+    composite_operator: 'and' | 'or';
+    sub_checks: SubCheck[];
+    claim?: string;
+    verification?: unknown;
+}
+export interface AssertionResult {
+    status: 'passed' | 'failed';
+    sub_results?: unknown[];
+}
+export declare function verifyAssertion(page: Page, claim: string, tree: AssertionTree): Promise<AssertionResult>;
+export declare function evaluateBranch(subChecks: SubCheck[], compositeOperator?: 'and' | 'or'): Promise<boolean>;
+//# sourceMappingURL=assertion.d.ts.map

package/dist/helpers/assertion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertion.d.ts","sourceRoot":"","sources":["../../src/helpers/assertion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAQvC,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,kBAAkB,EAAE,KAAK,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;CACzB;AAkCD,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,eAAe,CAAC,CA+C1B;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,QAAQ,EAAE,EACrB,iBAAiB,GAAE,KAAK,GAAG,IAAY,GACtC,OAAO,CAAC,OAAO,CAAC,CAWlB"}