@testmuai/playwright-bindings 0.1.26 → 0.1.27

package/dist/helpers/scrollUntil.js.map

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

package/dist/helpers/tabs.d.ts

@@ -1,3 +1,44 @@
+/**
+ * Tab helpers — PY _helpers/tabs.py port. V3 adds tolerant tab-identifier
+ * resolution (exact → ci-exact title → host/prefix URL → ci-contains) with an
+ * automind /v1/heal/switch-tab rescue; the V4 index/exact-title paths stay
+ * byte-identical to the pre-V3 behavior.
+ */
 import type { BrowserContext, Page } from 'playwright';
-export declare function switchTab(context: BrowserContext, index: number): Promise<Page>;
+/** Host/prefix-aware URL match: bare domain or full URL identifiers; matching
+ * is by host (github.com ≠ gist.github.com ≠ github.com.evil.com); an
+ * identifier path must prefix the URL path; www. ignored both sides. */
+export declare function _urlMatches(identifier: string, url: string): boolean;
+type SeenPage = [Page, string, string];
+/** First non-empty tier wins: exact title/URL, ci-exact title, host/prefix
+ * URL, ci-contains title. */
+export declare function _matchTabTiers(seen: SeenPage[], identifier: string): Page[];
+/** Open a new tab; V3 blank tabs land on Google (V2 parity), V4 blank tabs
+ * do not navigate (legacy behavior preserved). */
+export declare function newTab(context: BrowserContext, url?: string | null): Promise<Page>;
+export interface SwitchTabOptions {
+    title?: string | null;
+    description?: string | null;
+}
+/** Switch by 0-based index, or by title (takes precedence). V3 resolves the
+ * identifier tolerantly with an automind rescue; V4 keeps exact-title only. */
+export declare function switchTab(context: BrowserContext, tabIndex: number, opts?: SwitchTabOptions): Promise<Page>;
+export interface CloseTabOptions {
+    index?: number | null;
+    title?: string | null;
+    description?: string | null;
+}
+/**
+ * Close a tab and activate the most-recent remaining one. V3: refuses to
+ * close the only tab; resolves title-first (V3 codegen's index defaults to a
+ * meaningless 0) with automind rescue, then intent, then index. V4 keeps the
+ * legacy index → exact-title → most-recent order.
+ */
+export declare function closeTab(context: BrowserContext, opts?: CloseTabOptions): Promise<void>;
+/**
+ * Return page if still open, else re-point to the last surviving tab (the
+ * per-action stale-window heal — V3 export calls this after tab ops).
+ */
+export declare function ensureActivePage(page: Page): Promise<Page>;
+export {};
 //# sourceMappingURL=tabs.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../src/helpers/tabs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvD,wBAAsB,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrF"}
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../src/helpers/tabs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAYvD;;wEAEwE;AACxE,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAoBpE;AAED,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAiBvC;6BAC6B;AAC7B,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,CAS3E;AAoFD;kDACkD;AAClD,wBAAsB,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxF;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;+EAC+E;AAC/E,wBAAsB,SAAS,CAC7B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA0Cf;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmCjG;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhE"}

package/dist/helpers/tabs.js

@@ -1,15 +1,269 @@
+import { get as configGet, isV3 } from '../configure.js';
 import { log } from '../log.js';
-export async function switchTab(context, index) {
-    log.helper(`[switch_tab] index=${index}`);
+const TAB_HEAL_PATH = '/v1/heal/switch-tab';
+// ── tolerant tab-identifier resolution ───────────────────────────────────────
+function stripWww(host) {
+    return host.startsWith('www.') ? host.slice(4) : host;
+}
+/** Host/prefix-aware URL match: bare domain or full URL identifiers; matching
+ * is by host (github.com ≠ gist.github.com ≠ github.com.evil.com); an
+ * identifier path must prefix the URL path; www. ignored both sides. */
+export function _urlMatches(identifier, url) {
+    if (typeof url !== 'string' || !url)
+        return false;
+    let parsedId;
+    try {
+        parsedId = new URL(identifier.includes('://') ? identifier : `http://${identifier}`);
+    }
+    catch {
+        return false;
+    }
+    const idHost = stripWww(parsedId.hostname.toLowerCase());
+    if (!idHost)
+        return false;
+    let parsedUrl;
+    try {
+        parsedUrl = new URL(url);
+    }
+    catch {
+        return false;
+    }
+    if (stripWww(parsedUrl.hostname.toLowerCase()) !== idHost)
+        return false;
+    const idPath = parsedId.pathname.replace(/\/+$/, '');
+    if (idPath && idPath !== '')
+        return parsedUrl.pathname.startsWith(idPath);
+    return true;
+}
+/** Snapshot (page, title, url) per open tab; a tab that errors mid-read
+ * contributes empty strings (fails to match) rather than aborting. */
+async function seenPages(context) {
+    const seen = [];
+    for (const page of context.pages()) {
+        let title = '', url = '';
+        try {
+            title = await page.title();
+            url = page.url();
+        }
+        catch { /* closed mid-iteration */ }
+        seen.push([page, title || '', url || '']);
+    }
+    return seen;
+}
+/** First non-empty tier wins: exact title/URL, ci-exact title, host/prefix
+ * URL, ci-contains title. */
+export function _matchTabTiers(seen, identifier) {
+    const identLower = identifier.toLowerCase();
+    const exact = seen.filter(([, t, u]) => t === identifier || u === identifier).map(([p]) => p);
+    if (exact.length)
+        return exact;
+    const ciExact = seen.filter(([, t]) => t.toLowerCase() === identLower).map(([p]) => p);
+    if (ciExact.length)
+        return ciExact;
+    const byUrl = seen.filter(([, , u]) => _urlMatches(identifier, u)).map(([p]) => p);
+    if (byUrl.length)
+        return byUrl;
+    return seen.filter(([, t]) => identLower !== '' && t.toLowerCase().includes(identLower)).map(([p]) => p);
+}
+async function resolveTabPage(context, identifier) {
+    const matches = _matchTabTiers(await seenPages(context), identifier);
+    if (!matches.length)
+        return null;
+    if (matches.length > 1) {
+        log.helper(`[tabs] ${matches.length} open tabs matched identifier ${JSON.stringify(identifier)}; using the first.`);
+    }
+    return matches[0];
+}
+// ── automind rescue (V2 kaneai_switch_tab_heal parity) ───────────────────────
+function orgIdInt(raw) {
+    const parsed = parseInt(String(raw), 10);
+    return Number.isNaN(parsed) ? 0 : parsed;
+}
+function requestId() {
+    return [...Array(16)].map(() => Math.floor(Math.random() * 16).toString(16)).join('');
+}
+/** Resolve the target tab via automind: op intent + live titles → tab index.
+ * Returns null on ANY failure so callers fall back to static behavior. */
+async function automindResolveTab(context, intent, operationType) {
+    try {
+        const baseUrl = String(configGet('automindUrl') ?? '');
+        const username = String(configGet('username') ?? '') || (process.env['LT_USERNAME'] ?? '');
+        const accesskey = String(configGet('accesskey') ?? '') || (process.env['LT_ACCESS_KEY'] ?? '');
+        if (!username || !accesskey || !baseUrl) {
+            log.helper('[tabs] automind tab resolution unavailable (missing creds/URL)');
+            return null;
+        }
+        const seen = await seenPages(context);
+        const titles = seen.map(([, t]) => t);
+        const payload = {
+            code_request_id: requestId(),
+            intent,
+            open_tabs: titles,
+            // No definitive "current tab" from the context alone; last = best-effort.
+            current_tab: titles.length ? titles[titles.length - 1] : '',
+            operation_type: operationType,
+            test_id: configGet('testId') ?? '',
+            session_id: configGet('sessionId') ?? '',
+            commit_id: configGet('commitId') ?? '',
+            org_id: orgIdInt(configGet('orgId')),
+            current_action: { operation_type: operationType, operation_intent: intent },
+            is_mobile: false,
+            device_os: '',
+        };
+        const resp = await fetch(`${baseUrl}${TAB_HEAL_PATH}`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Basic ${Buffer.from(`${username}:${accesskey}`).toString('base64')}`,
+            },
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(30_000),
+        });
+        if (resp.status !== 200) {
+            log.helper(`[tabs] automind ${TAB_HEAL_PATH} status=${resp.status}`);
+            return null;
+        }
+        const result = (await resp.json());
+        const idx = result.tab_index;
+        const i = Number(idx);
+        if (idx === null || idx === undefined || !Number.isInteger(i) || i < 0 || i >= seen.length) {
+            log.helper(`[tabs] automind tab resolution unusable: ${JSON.stringify(result)}`);
+            return null;
+        }
+        log.helper(`[tabs] automind resolved intent ${JSON.stringify(intent)} -> tab ${i}`);
+        return seen[i][0];
+    }
+    catch (e) {
+        log.helper(`[tabs] automind tab resolution failed: ${String(e)}`);
+        return null;
+    }
+}
+// ── public surface ───────────────────────────────────────────────────────────
+/** Open a new tab; V3 blank tabs land on Google (V2 parity), V4 blank tabs
+ * do not navigate (legacy behavior preserved). */
+export async function newTab(context, url) {
+    const page = await context.newPage();
+    let target = url ?? null;
+    if (target === null && isV3())
+        target = 'https://www.google.com';
+    if (target !== null)
+        await page.goto(target);
+    await page.bringToFront();
+    log.helper(`[new_tab] opened tab (url=${target ?? '<none>'})`);
+    return page;
+}
+/** Switch by 0-based index, or by title (takes precedence). V3 resolves the
+ * identifier tolerantly with an automind rescue; V4 keeps exact-title only. */
+export async function switchTab(context, tabIndex, opts = {}) {
+    const { title = null, description = null } = opts;
+    if (title === null && description !== null && isV3()) {
+        const page = await automindResolveTab(context, description, 'SWITCH_TAB');
+        if (page === null)
+            throw new Error(`No tab matching description ${JSON.stringify(description)}`);
+        await page.bringToFront();
+        log.helper(`[switch_tab] switched via automind description=${JSON.stringify(description)}`);
+        return page;
+    }
+    if (title !== null) {
+        if (isV3()) {
+            let page = await resolveTabPage(context, title);
+            if (page === null)
+                page = await automindResolveTab(context, title, 'SWITCH_TAB');
+            if (page === null)
+                throw new Error(`No tab with title ${JSON.stringify(title)}`);
+            await page.bringToFront();
+            log.helper(`[switch_tab] switched to tab identifier=${JSON.stringify(title)} (url=${page.url()})`);
+            return page;
+        }
+        for (const page of context.pages()) {
+            if ((await page.title()) === title) {
+                await page.bringToFront();
+                log.helper(`[switch_tab] switched to tab title=${JSON.stringify(title)} (url=${page.url()})`);
+                return page;
+            }
+        }
+        throw new Error(`No tab with title ${JSON.stringify(title)}`);
+    }
     let pages = context.pages();
-    if (index >= pages.length) {
+    log.helper(`[switch_tab] target_index=${tabIndex} current_tabs=${pages.length}`);
+    if (tabIndex >= pages.length) {
+        // Tab not in the list yet — a click may have opened target=_blank.
         await context.waitForEvent('page', { timeout: 5000 }).catch(() => null);
         pages = context.pages();
     }
-    const target = pages[index];
+    const target = pages[tabIndex];
     if (!target)
-        throw new Error(`Tab index ${index} does not exist (have ${pages.length})`);
+        throw new Error(`Tab ${tabIndex} does not exist (${pages.length} tabs open)`);
     await target.bringToFront();
+    log.helper(`[switch_tab] switched to tab ${tabIndex}`);
     return target;
 }
+/**
+ * Close a tab and activate the most-recent remaining one. V3: refuses to
+ * close the only tab; resolves title-first (V3 codegen's index defaults to a
+ * meaningless 0) with automind rescue, then intent, then index. V4 keeps the
+ * legacy index → exact-title → most-recent order.
+ */
+export async function closeTab(context, opts = {}) {
+    const { index = null, title = null, description = null } = opts;
+    const v3 = isV3();
+    if (v3 && context.pages().length <= 1) {
+        throw new Error('Cannot close the only open tab');
+    }
+    let target = null;
+    if (v3 && title !== null) {
+        target = await resolveTabPage(context, title);
+        if (target === null)
+            target = await automindResolveTab(context, description ?? title, 'CLOSE_TAB');
+        if (target === null)
+            throw new Error(`No tab with title ${JSON.stringify(title)}`);
+    }
+    else if (v3 && description !== null) {
+        target = await automindResolveTab(context, description, 'CLOSE_TAB');
+        if (target === null && index !== null)
+            target = context.pages()[index] ?? null;
+        if (target === null)
+            target = context.pages()[context.pages().length - 1] ?? null;
+    }
+    else if (index !== null) {
+        target = context.pages()[index] ?? null;
+        if (!target)
+            throw new Error(`Tab ${index} does not exist`);
+    }
+    else if (title !== null) {
+        for (const page of context.pages()) {
+            if ((await page.title()) === title) {
+                target = page;
+                break;
+            }
+        }
+        if (!target)
+            throw new Error(`No tab with title ${JSON.stringify(title)}`);
+    }
+    else {
+        target = context.pages()[context.pages().length - 1] ?? null;
+    }
+    if (!target)
+        throw new Error('close_tab: no tab to close');
+    log.helper(`[close_tab] closing tab (url=${target.url()})`);
+    await target.close();
+    const remaining = context.pages();
+    if (remaining.length)
+        await remaining[remaining.length - 1].bringToFront();
+}
+/**
+ * Return page if still open, else re-point to the last surviving tab (the
+ * per-action stale-window heal — V3 export calls this after tab ops).
+ */
+export async function ensureActivePage(page) {
+    if (!page.isClosed())
+        return page;
+    const survivors = page.context().pages().filter((p) => !p.isClosed());
+    if (!survivors.length) {
+        throw new Error('ensure_active_page: the active tab was closed and no surviving tab remains in the browser context');
+    }
+    const next = survivors[survivors.length - 1];
+    await next.bringToFront();
+    return next;
+}
 //# sourceMappingURL=tabs.js.map

package/dist/helpers/tabs.js.map

@@ -1 +1 @@
-{"version":3,"file":"tabs.js","sourceRoot":"","sources":["../../src/helpers/tabs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAuB,EAAE,KAAa;IACpE,GAAG,CAAC,MAAM,CAAC,sBAAsB,KAAK,EAAE,CAAC,CAAC;IAC1C,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAC5B,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACxE,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,yBAAyB,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACzF,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"tabs.js","sourceRoot":"","sources":["../../src/helpers/tabs.ts"],"names":[],"mappings":"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"}

package/dist/helpers/text.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Coerce a scalar fill/type value to the string Playwright requires.
+ *
+ * Variables are type-preserving — resolveVar returns the stored value
+ * untouched — so a number/boolean produced by executeJs (or stored via
+ * setVar) can reach a text-input verb as a non-string. Playwright's
+ * Locator.fill/type reject those ("expected string, got number").
+ *
+ * Only scalars are coerced (String() is locale-invariant by spec; toFixed /
+ * toLocaleString stay banned per the V3 contract). Objects and arrays are
+ * left untouched so they surface loudly as a clear Playwright error rather
+ * than silently filling "[object Object]". Mirrors PY _action_specs._coerce_text.
+ */
+export declare function asText(value: unknown): unknown;
+//# sourceMappingURL=text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/helpers/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAU9C"}

package/dist/helpers/text.js

@@ -0,0 +1,24 @@
+/**
+ * Coerce a scalar fill/type value to the string Playwright requires.
+ *
+ * Variables are type-preserving — resolveVar returns the stored value
+ * untouched — so a number/boolean produced by executeJs (or stored via
+ * setVar) can reach a text-input verb as a non-string. Playwright's
+ * Locator.fill/type reject those ("expected string, got number").
+ *
+ * Only scalars are coerced (String() is locale-invariant by spec; toFixed /
+ * toLocaleString stay banned per the V3 contract). Objects and arrays are
+ * left untouched so they surface loudly as a clear Playwright error rather
+ * than silently filling "[object Object]". Mirrors PY _action_specs._coerce_text.
+ */
+export function asText(value) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' ||
+        typeof value === 'boolean' ||
+        typeof value === 'bigint') {
+        return String(value);
+    }
+    return value;
+}
+//# sourceMappingURL=text.js.map

package/dist/helpers/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/helpers/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS;QAC1B,OAAO,KAAK,KAAK,QAAQ,EACzB,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/helpers/textNormalize.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Canonicalize text for substring/prefix/suffix matching, matching the
+ * Selenium runtime (PY oracle: _assertion_v3_eval._normalize_text).
+ *
+ * Folds accents/ligatures (NFKD + drop combining marks), maps smart
+ * punctuation and invisible characters, collapses whitespace, and optionally
+ * case-folds — so `contains`/`starts_with`/`ends_with` match the way the
+ * Selenium runtime evaluated them (e.g. "Café Menu" contains "cafe").
+ *
+ * Normalization is explicit per the V3 contract's runtime-conventions block:
+ * JS has no implicit equivalent of Python's unicodedata.normalize, and
+ * skipping it silently fails composed-vs-decomposed accent comparisons.
+ */
+export declare function normalizeText(value: unknown, opts?: {
+    caseInsensitive?: boolean;
+    asciiFold?: boolean;
+}): string;
+//# sourceMappingURL=textNormalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"textNormalize.d.ts","sourceRoot":"","sources":["../../src/helpers/textNormalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,IAAI,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAC5D,MAAM,CAcR"}

package/dist/helpers/textNormalize.js

@@ -0,0 +1,39 @@
+/**
+ * Canonicalize text for substring/prefix/suffix matching, matching the
+ * Selenium runtime (PY oracle: _assertion_v3_eval._normalize_text).
+ *
+ * Folds accents/ligatures (NFKD + drop combining marks), maps smart
+ * punctuation and invisible characters, collapses whitespace, and optionally
+ * case-folds — so `contains`/`starts_with`/`ends_with` match the way the
+ * Selenium runtime evaluated them (e.g. "Café Menu" contains "cafe").
+ *
+ * Normalization is explicit per the V3 contract's runtime-conventions block:
+ * JS has no implicit equivalent of Python's unicodedata.normalize, and
+ * skipping it silently fails composed-vs-decomposed accent comparisons.
+ */
+const SMART_PUNCT = {
+    '‘': "'", '’': "'", // curly single quotes
+    '“': '"', '”': '"', // curly double quotes
+    ' ': ' ', // non-breaking space
+    '​': '', '‌': '', '‍': '', '': '', // zero-width / BOM
+};
+const SMART_PUNCT_RE = /[‘’“” ​‌‍]/g;
+export function normalizeText(value, opts = {}) {
+    const { caseInsensitive = false, asciiFold = true } = opts;
+    let s = String(value);
+    if (!s)
+        return s;
+    if (asciiFold) {
+        // NFKD + strip combining marks — the accent fold.
+        s = s.normalize('NFKD').replace(/\p{M}/gu, '');
+    }
+    else {
+        s = s.normalize('NFKC');
+    }
+    s = s.replace(SMART_PUNCT_RE, (ch) => SMART_PUNCT[ch] ?? ch);
+    s = s.replace(/\s+/g, ' ').trim();
+    if (caseInsensitive)
+        s = s.toLowerCase();
+    return s;
+}
+//# sourceMappingURL=textNormalize.js.map

package/dist/helpers/textNormalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textNormalize.js","sourceRoot":"","sources":["../../src/helpers/textNormalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,GAA2B;IAC1C,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,sBAAsB;IAC1C,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,sBAAsB;IAC1C,GAAG,EAAE,GAAG,EAAiB,qBAAqB;IAC9C,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,mBAAmB;CACxD,CAAC;AAEF,MAAM,cAAc,GAAG,cAAc,CAAC;AAEtC,MAAM,UAAU,aAAa,CAC3B,KAAc,EACd,OAA2D,EAAE;IAE7D,MAAM,EAAE,eAAe,GAAG,KAAK,EAAE,SAAS,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IAC3D,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,IAAI,SAAS,EAAE,CAAC;QACd,kDAAkD;QAClD,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;SAAM,CAAC;QACN,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IACD,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,eAAe;QAAE,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/helpers/textualRead.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Async local attribute extraction for V3 textual_query — port of PY
+ * _helpers/_textual_read.py (itself a port of selenium's textual_query).
+ * Consumed only by the V3 locate-then-read path in visionV3.textualQueryV3;
+ * no V4 code imports this module.
+ *
+ * Every page function here is a REAL function, never a string — the grid CDP
+ * relay returns undefined for string page-functions (corner-case catalog).
+ *
+ * Intentional parity gaps carried over from PY (documented there; not bugs):
+ * role is explicit-attr only; size returns {width,height} floats ({} when not
+ * visible); rgbaToName HSV buckets are the selenium thresholds.
+ */
+import type { Locator } from 'playwright';
+export declare const LOCAL_READ_ATTRS: ReadonlySet<string>;
+/** rgb()/rgba() CSS string → basic colour name; '' on parse failure. HSV
+ * buckets verbatim from selenium (colorsys.rgb_to_hsv math inlined). */
+export declare function rgbaToName(cssValue: string | null | undefined): string;
+/** Meaningful text/value for any element: input/textarea → inputValue;
+ * select → option values/text; contenteditable → innerText; else innerText()
+ * (rendered visible text — Selenium .text parity, NOT textContent). */
+export declare function safeValue(el: Locator): Promise<string>;
+/**
+ * Dispatch over attribute name and return the raw value for `el`. Throws for
+ * `location`/`custom_attributes_dict`/unknown names (loud-not-silent parity
+ * with selenium — the caller degrades to the server fallback).
+ */
+export declare function populateAttribute(el: Locator, requestedAttribute: string): Promise<unknown>;
+/**
+ * Post-locate extraction — shared entry for the V3 locate-then-read path.
+ * img/canvas short-circuit, regex-over-outerHTML for text/value, then
+ * coerceTextualValue. Does NOT locate; callers own that. regexPattern is
+ * accepted for parity but the current caller always passes null (same
+ * deferred-dispatcher note as PY _extract_value).
+ */
+export declare function extractValue(el: Locator, selectedAttributeName: string, regexPattern: string | null, returnType: string): Promise<unknown>;
+//# sourceMappingURL=textualRead.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"textualRead.d.ts","sourceRoot":"","sources":["../../src/helpers/textualRead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAM1C,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAgB/C,CAAC;AAIH;wEACwE;AACxE,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAgCtE;AAED;;uEAEuE;AACvE,wBAAsB,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAuC5D;AA0BD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAmDjG;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,OAAO,EACX,qBAAqB,EAAE,MAAM,EAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAclB"}