@browserbasehq/orca 3.0.9-alpha-4 → 3.1.0-patch.0

package/dist/esm/lib/v3/dom/genDomScripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genDomScripts.js","sourceRoot":"","sources":["../../../../../lib/v3/dom/genDomScripts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAC1C,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAE1C,OAAO,CAAC,SAAS,CAAC;IAChB,WAAW,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAClD,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,IAAI;IACZ,aAAa,EAAE,MAAM;IACrB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC;CAC1C,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;AACzE,MAAM,OAAO,GAAG,kCAAkC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC;AAE5E,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAAE,OAAO,CAAC,CAAC;AAEnE,OAAO,CAAC,SAAS,CAAC;IAChB,WAAW,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iCAAiC,CAAC,CAAC;IACjE,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,IAAI;IACZ,aAAa,EAAE,MAAM;IACrB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC;CAChD,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,EAAE,CAAC,YAAY,CACpC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,EACtC,MAAM,CACP,CAAC;AACF,MAAM,eAAe,GAAG,wCAAwC,IAAI,CAAC,SAAS,CAC5E,cAAc,CACf,GAAG,CAAC;AACL,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,0BAA0B,CAAC,EAC7C,eAAe,CAChB,CAAC","sourcesContent":["/**\n * Build the v3 DOM script into a single JS file and then export its contents\n * as a string constant (`v3ScriptContent`) for CDP injection (document-start).\n */\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport esbuild from \"esbuild\";\n\nconst here = path.dirname(fileURLToPath(import.meta.url));\nconst outDir = path.join(here, \"./build\");\nfs.mkdirSync(outDir, { recursive: true });\n\nesbuild.buildSync({\n  entryPoints: [path.join(here, \"piercer.entry.ts\")],\n  bundle: true,\n  format: \"iife\",\n  platform: \"browser\",\n  target: \"es2020\",\n  minify: true,\n  legalComments: \"none\",\n  outfile: path.join(outDir, \"v3-index.js\"),\n});\n\nconst script = fs.readFileSync(path.join(outDir, \"v3-index.js\"), \"utf8\");\nconst content = `export const v3ScriptContent = ${JSON.stringify(script)};`;\n\nfs.writeFileSync(path.join(outDir, \"scriptV3Content.ts\"), content);\n\nesbuild.buildSync({\n  entryPoints: [path.join(here, \"rerenderMissingShadows.entry.ts\")],\n  bundle: true,\n  format: \"iife\",\n  platform: \"browser\",\n  target: \"es2020\",\n  minify: true,\n  legalComments: \"none\",\n  outfile: path.join(outDir, \"rerender-index.js\"),\n});\n\nconst rerenderScript = fs.readFileSync(\n  path.join(outDir, \"rerender-index.js\"),\n  \"utf8\",\n);\nconst rerenderContent = `export const reRenderScriptContent = ${JSON.stringify(\n  rerenderScript,\n)};`;\nfs.writeFileSync(\n  path.join(outDir, \"reRenderScriptContent.ts\"),\n  rerenderContent,\n);\n"]}

package/dist/esm/lib/v3/dom/genLocatorScripts.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/lib/v3/dom/genLocatorScripts.js

@@ -0,0 +1,51 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import esbuild from "esbuild";
+const here = path.dirname(fileURLToPath(import.meta.url));
+const outDir = path.join(here, "./build");
+const entry = path.join(here, "./locatorScripts/index.ts");
+const moduleOutfile = path.join(outDir, "locatorScripts.mjs");
+const bundleOutfile = path.join(outDir, "locatorScripts.bundle.js");
+async function main() {
+    fs.mkdirSync(outDir, { recursive: true });
+    esbuild.buildSync({
+        entryPoints: [entry],
+        bundle: true,
+        format: "esm",
+        platform: "browser",
+        target: "es2020",
+        minify: true,
+        outfile: moduleOutfile,
+    });
+    esbuild.buildSync({
+        entryPoints: [entry],
+        bundle: true,
+        format: "iife",
+        platform: "browser",
+        target: "es2020",
+        globalName: "__stagehandLocatorScriptsFactory",
+        minify: true,
+        outfile: bundleOutfile,
+    });
+    const bundleRaw = fs.readFileSync(bundleOutfile, "utf8").trim();
+    const bootstrap = `if (!globalThis.__stagehandLocatorScripts) { ${bundleRaw}\n  globalThis.__stagehandLocatorScripts = __stagehandLocatorScriptsFactory;\n}`;
+    const compiledModule = (await import(pathToFileURL(moduleOutfile).href));
+    const entries = Object.entries(compiledModule).filter(([, value]) => typeof value === "function");
+    const sorted = entries.sort(([a], [b]) => a.localeCompare(b));
+    const scriptMap = Object.fromEntries(sorted.map(([name, fn]) => {
+        const callable = fn;
+        return [name, callable.toString()];
+    }));
+    const banner = `/*\n * AUTO-GENERATED FILE. DO NOT EDIT.\n * Update sources in lib/v3/dom/locatorScripts and run genLocatorScripts.ts.\n */`;
+    const globalRefs = Object.fromEntries(sorted.map(([name]) => [
+        name,
+        `globalThis.__stagehandLocatorScripts.${name}`,
+    ]));
+    const content = `${banner}\nexport const locatorScriptBootstrap = ${JSON.stringify(bootstrap)};\nexport const locatorScriptSources = ${JSON.stringify(scriptMap, null, 2)} as const;\nexport const locatorScriptGlobalRefs = ${JSON.stringify(globalRefs, null, 2)} as const;\nexport type LocatorScriptName = keyof typeof locatorScriptSources;\n`;
+    fs.writeFileSync(path.join(outDir, "locatorScripts.generated.ts"), content);
+    await fs.promises.unlink(moduleOutfile).catch(() => { });
+    await fs.promises.unlink(bundleOutfile).catch(() => { });
+}
+void main();
+//# sourceMappingURL=genLocatorScripts.js.map

package/dist/esm/lib/v3/dom/genLocatorScripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genLocatorScripts.js","sourceRoot":"","sources":["../../../../../lib/v3/dom/genLocatorScripts.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport esbuild from \"esbuild\";\n\nconst here = path.dirname(fileURLToPath(import.meta.url));\nconst outDir = path.join(here, \"./build\");\nconst entry = path.join(here, \"./locatorScripts/index.ts\");\nconst moduleOutfile = path.join(outDir, \"locatorScripts.mjs\");\nconst bundleOutfile = path.join(outDir, \"locatorScripts.bundle.js\");\n\nasync function main(): Promise<void> {\n  fs.mkdirSync(outDir, { recursive: true });\n\n  esbuild.buildSync({\n    entryPoints: [entry],\n    bundle: true,\n    format: \"esm\",\n    platform: \"browser\",\n    target: \"es2020\",\n    minify: true,\n    outfile: moduleOutfile,\n  });\n\n  esbuild.buildSync({\n    entryPoints: [entry],\n    bundle: true,\n    format: \"iife\",\n    platform: \"browser\",\n    target: \"es2020\",\n    globalName: \"__stagehandLocatorScriptsFactory\",\n    minify: true,\n    outfile: bundleOutfile,\n  });\n\n  const bundleRaw = fs.readFileSync(bundleOutfile, \"utf8\").trim();\n  const bootstrap = `if (!globalThis.__stagehandLocatorScripts) { ${bundleRaw}\\n  globalThis.__stagehandLocatorScripts = __stagehandLocatorScriptsFactory;\\n}`;\n\n  const compiledModule = (await import(\n    pathToFileURL(moduleOutfile).href\n  )) as Record<string, unknown>;\n\n  const entries = Object.entries(compiledModule).filter(\n    ([, value]) => typeof value === \"function\",\n  );\n  const sorted = entries.sort(([a], [b]) => a.localeCompare(b));\n\n  const scriptMap: Record<string, string> = Object.fromEntries(\n    sorted.map(([name, fn]) => {\n      const callable = fn as (...args: unknown[]) => unknown;\n      return [name, callable.toString()];\n    }),\n  );\n\n  const banner = `/*\\n * AUTO-GENERATED FILE. DO NOT EDIT.\\n * Update sources in lib/v3/dom/locatorScripts and run genLocatorScripts.ts.\\n */`;\n\n  const globalRefs: Record<string, string> = Object.fromEntries(\n    sorted.map(([name]) => [\n      name,\n      `globalThis.__stagehandLocatorScripts.${name}`,\n    ]),\n  );\n\n  const content = `${banner}\\nexport const locatorScriptBootstrap = ${JSON.stringify(bootstrap)};\\nexport const locatorScriptSources = ${JSON.stringify(scriptMap, null, 2)} as const;\\nexport const locatorScriptGlobalRefs = ${JSON.stringify(globalRefs, null, 2)} as const;\\nexport type LocatorScriptName = keyof typeof locatorScriptSources;\\n`;\n\n  fs.writeFileSync(path.join(outDir, \"locatorScripts.generated.ts\"), content);\n\n  await fs.promises.unlink(moduleOutfile).catch(() => {});\n  await fs.promises.unlink(bundleOutfile).catch(() => {});\n}\n\nvoid main();\n"]}

package/dist/esm/lib/v3/dom/genScreenshotScripts.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/lib/v3/dom/genScreenshotScripts.js

@@ -0,0 +1,37 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import esbuild from "esbuild";
+const here = path.dirname(fileURLToPath(import.meta.url));
+const srcDir = path.join(here, "./screenshotScripts");
+const outDir = path.join(here, "./build");
+const entry = path.join(srcDir, "index.ts");
+const moduleOut = path.join(outDir, "screenshotScripts.mjs");
+async function main() {
+    fs.mkdirSync(outDir, { recursive: true });
+    esbuild.buildSync({
+        entryPoints: [entry],
+        bundle: true,
+        format: "esm",
+        platform: "browser",
+        target: "es2020",
+        minify: true,
+        outfile: moduleOut,
+    });
+    const compiledModule = (await import(pathToFileURL(moduleOut).href));
+    const entries = Object.entries(compiledModule).filter(([, value]) => typeof value === "function");
+    const sorted = entries.sort(([a], [b]) => a.localeCompare(b));
+    const scriptMap = Object.fromEntries(sorted.map(([name, fn]) => {
+        const callable = fn;
+        return [name, callable.toString()];
+    }));
+    const banner = `/*\n * AUTO-GENERATED FILE. DO NOT EDIT.\n * Update sources in lib/v3/dom/screenshotScripts and run genScreenshotScripts.ts.\n */`;
+    const content = `${banner}
+export const screenshotScriptSources = ${JSON.stringify(scriptMap, null, 2)} as const;
+export type ScreenshotScriptName = keyof typeof screenshotScriptSources;
+`;
+    fs.writeFileSync(path.join(outDir, "screenshotScripts.generated.ts"), content);
+    await fs.promises.unlink(moduleOut).catch(() => { });
+}
+void main();
+//# sourceMappingURL=genScreenshotScripts.js.map

package/dist/esm/lib/v3/dom/genScreenshotScripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genScreenshotScripts.js","sourceRoot":"","sources":["../../../../../lib/v3/dom/genScreenshotScripts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;AACtD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;AAE7D,KAAK,UAAU,IAAI;IACjB,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,OAAO,CAAC,SAAS,CAAC;QAChB,WAAW,EAAE,CAAC,KAAK,CAAC;QACpB,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,SAAS;KACnB,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,CAAC,MAAM,MAAM,CAClC,aAAa,CAAC,SAAS,CAAC,CAAC,IAAI,CAC9B,CAA4B,CAAC;IAE9B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,MAAM,CACnD,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,UAAU,CAC3C,CAAC;IACF,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9D,MAAM,SAAS,GAA2B,MAAM,CAAC,WAAW,CAC1D,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QACxB,MAAM,QAAQ,GAAG,EAAqC,CAAC;QACvD,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrC,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,MAAM,GAAG,mIAAmI,CAAC;IAEnJ,MAAM,OAAO,GAAG,GAAG,MAAM;yCACc,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;;CAE1E,CAAC;IAEA,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,gCAAgC,CAAC,EACnD,OAAO,CACR,CAAC;IAEF,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,KAAK,IAAI,EAAE,CAAC","sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport esbuild from \"esbuild\";\n\nconst here = path.dirname(fileURLToPath(import.meta.url));\nconst srcDir = path.join(here, \"./screenshotScripts\");\nconst outDir = path.join(here, \"./build\");\nconst entry = path.join(srcDir, \"index.ts\");\nconst moduleOut = path.join(outDir, \"screenshotScripts.mjs\");\n\nasync function main(): Promise<void> {\n  fs.mkdirSync(outDir, { recursive: true });\n\n  esbuild.buildSync({\n    entryPoints: [entry],\n    bundle: true,\n    format: \"esm\",\n    platform: \"browser\",\n    target: \"es2020\",\n    minify: true,\n    outfile: moduleOut,\n  });\n\n  const compiledModule = (await import(\n    pathToFileURL(moduleOut).href\n  )) as Record<string, unknown>;\n\n  const entries = Object.entries(compiledModule).filter(\n    ([, value]) => typeof value === \"function\",\n  );\n  const sorted = entries.sort(([a], [b]) => a.localeCompare(b));\n\n  const scriptMap: Record<string, string> = Object.fromEntries(\n    sorted.map(([name, fn]) => {\n      const callable = fn as (...args: unknown[]) => unknown;\n      return [name, callable.toString()];\n    }),\n  );\n\n  const banner = `/*\\n * AUTO-GENERATED FILE. DO NOT EDIT.\\n * Update sources in lib/v3/dom/screenshotScripts and run genScreenshotScripts.ts.\\n */`;\n\n  const content = `${banner}\nexport const screenshotScriptSources = ${JSON.stringify(scriptMap, null, 2)} as const;\nexport type ScreenshotScriptName = keyof typeof screenshotScriptSources;\n`;\n\n  fs.writeFileSync(\n    path.join(outDir, \"screenshotScripts.generated.ts\"),\n    content,\n  );\n\n  await fs.promises.unlink(moduleOut).catch(() => {});\n}\n\nvoid main();\n"]}

package/dist/esm/lib/v3/dom/index.d.ts

@@ -0,0 +1 @@
+export * from "./piercer.runtime.js";

package/dist/esm/lib/v3/dom/index.js

@@ -0,0 +1,2 @@
+export * from "./piercer.runtime.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/v3/dom/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../lib/v3/dom/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC","sourcesContent":["export * from \"./piercer.runtime.js\";\n"]}

package/dist/esm/lib/v3/dom/locatorScripts/counts.d.ts

@@ -0,0 +1,15 @@
+export interface TextMatchSample {
+    tag: string;
+    id: string;
+    class: string;
+    text: string;
+}
+export interface TextMatchResult {
+    count: number;
+    sample: TextMatchSample[];
+    error: null;
+}
+export declare function countCssMatchesPrimary(selectorRaw: string): number;
+export declare function countCssMatchesPierce(selectorRaw: string): number;
+export declare function countTextMatches(rawNeedle: string): TextMatchResult;
+export declare function countXPathMatchesMainWorld(rawXp: string): number;

package/dist/esm/lib/v3/dom/locatorScripts/counts.js

@@ -0,0 +1,272 @@
+import { countXPathMatches } from "./xpathResolver.js";
+export function countCssMatchesPrimary(selectorRaw) {
+    const selector = String(selectorRaw ?? "").trim();
+    if (!selector)
+        return 0;
+    const seen = new WeakSet();
+    const visit = (root) => {
+        if (!root || seen.has(root))
+            return 0;
+        seen.add(root);
+        let total = 0;
+        try {
+            const queryable = root;
+            if (typeof queryable.querySelectorAll === "function") {
+                total += queryable.querySelectorAll(selector).length;
+            }
+        }
+        catch {
+            // ignore query errors
+        }
+        try {
+            const doc = root instanceof Document
+                ? root
+                : (root?.ownerDocument ?? document);
+            const walker = doc.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);
+            let node;
+            while ((node = walker.nextNode())) {
+                if (node instanceof Element && node.shadowRoot) {
+                    total += visit(node.shadowRoot);
+                }
+            }
+        }
+        catch {
+            // ignore traversal errors
+        }
+        return total;
+    };
+    try {
+        return visit(document);
+    }
+    catch {
+        try {
+            return document.querySelectorAll(selector).length;
+        }
+        catch {
+            return 0;
+        }
+    }
+}
+export function countCssMatchesPierce(selectorRaw) {
+    const selector = String(selectorRaw ?? "").trim();
+    if (!selector)
+        return 0;
+    const backdoor = window.__stagehandV3__;
+    if (!backdoor || typeof backdoor.getClosedRoot !== "function") {
+        try {
+            return document.querySelectorAll(selector).length;
+        }
+        catch {
+            return 0;
+        }
+    }
+    const seen = new WeakSet();
+    const queue = [];
+    const enqueue = (node) => {
+        if (!node || seen.has(node))
+            return;
+        seen.add(node);
+        queue.push(node);
+    };
+    enqueue(document);
+    let total = 0;
+    const visitElement = (element) => {
+        const open = element.shadowRoot;
+        if (open)
+            enqueue(open);
+        try {
+            const closed = backdoor.getClosedRoot(element);
+            if (closed)
+                enqueue(closed);
+        }
+        catch {
+            // ignore
+        }
+    };
+    while (queue.length) {
+        const root = queue.shift();
+        if (!root)
+            continue;
+        try {
+            const queryable = root;
+            if (typeof queryable.querySelectorAll === "function") {
+                total += queryable.querySelectorAll(selector).length;
+            }
+        }
+        catch {
+            // ignore query errors
+        }
+        try {
+            const doc = root instanceof Document
+                ? root
+                : root instanceof ShadowRoot
+                    ? (root.host?.ownerDocument ?? document)
+                    : (root.ownerDocument ?? document);
+            const walker = doc.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);
+            let node;
+            while ((node = walker.nextNode())) {
+                if (node instanceof Element) {
+                    visitElement(node);
+                }
+            }
+        }
+        catch {
+            // ignore traversal errors
+        }
+    }
+    return total;
+}
+export function countTextMatches(rawNeedle) {
+    const needle = String(rawNeedle ?? "");
+    if (!needle) {
+        return { count: 0, sample: [], error: null };
+    }
+    const needleLc = needle.toLowerCase();
+    const skipTags = new Set([
+        "SCRIPT",
+        "STYLE",
+        "TEMPLATE",
+        "NOSCRIPT",
+        "HEAD",
+        "TITLE",
+        "LINK",
+        "META",
+        "HTML",
+        "BODY",
+    ]);
+    const shouldSkip = (node) => {
+        if (!node)
+            return false;
+        const tag = node.tagName?.toUpperCase() ?? "";
+        return skipTags.has(tag);
+    };
+    const extractText = (element) => {
+        try {
+            if (shouldSkip(element))
+                return "";
+            const inner = element.innerText;
+            if (typeof inner === "string" && inner.trim())
+                return inner.trim();
+        }
+        catch {
+            // ignore
+        }
+        try {
+            const text = element.textContent;
+            if (typeof text === "string")
+                return text.trim();
+        }
+        catch {
+            // ignore
+        }
+        return "";
+    };
+    const matches = (element) => {
+        const text = extractText(element);
+        return !!text && text.toLowerCase().includes(needleLc);
+    };
+    const backdoor = window.__stagehandV3__;
+    const getClosedRoot = backdoor && typeof backdoor.getClosedRoot === "function"
+        ? (host) => {
+            try {
+                return backdoor.getClosedRoot(host) ?? null;
+            }
+            catch {
+                return null;
+            }
+        }
+        : (host) => {
+            void host;
+            return null;
+        };
+    const seen = new WeakSet();
+    const queue = [];
+    const enqueue = (node) => {
+        if (!node || seen.has(node))
+            return;
+        seen.add(node);
+        queue.push(node);
+    };
+    const walkerFor = (root) => {
+        try {
+            const doc = root instanceof Document
+                ? root
+                : (root?.ownerDocument ?? document);
+            return doc.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);
+        }
+        catch {
+            return null;
+        }
+    };
+    const matchesList = [];
+    enqueue(document);
+    while (queue.length) {
+        const root = queue.shift();
+        if (!root)
+            continue;
+        if (root instanceof Element && matches(root)) {
+            matchesList.push({
+                element: root,
+                tag: root.tagName ?? "",
+                id: root.id ?? "",
+                className: root.className ?? "",
+                text: extractText(root),
+            });
+        }
+        const walker = walkerFor(root);
+        if (!walker)
+            continue;
+        let node;
+        while ((node = walker.nextNode())) {
+            if (!(node instanceof Element))
+                continue;
+            if (matches(node)) {
+                matchesList.push({
+                    element: node,
+                    tag: node.tagName ?? "",
+                    id: node.id ?? "",
+                    className: node.className ?? "",
+                    text: extractText(node),
+                });
+            }
+            const open = node.shadowRoot;
+            if (open)
+                enqueue(open);
+            const closed = getClosedRoot(node);
+            if (closed)
+                enqueue(closed);
+        }
+    }
+    const innermost = [];
+    for (const item of matchesList) {
+        const el = item.element;
+        let skip = false;
+        for (const other of matchesList) {
+            if (item === other)
+                continue;
+            try {
+                if (el.contains(other.element)) {
+                    skip = true;
+                    break;
+                }
+            }
+            catch {
+                // ignore containment errors
+            }
+        }
+        if (!skip)
+            innermost.push(item);
+    }
+    const count = innermost.length;
+    const sample = innermost.slice(0, 5).map((item) => ({
+        tag: item.tag,
+        id: item.id,
+        class: item.className,
+        text: item.text,
+    }));
+    return { count, sample, error: null };
+}
+export function countXPathMatchesMainWorld(rawXp) {
+    return countXPathMatches(rawXp, { pierceShadow: true });
+}
+//# sourceMappingURL=counts.js.map

package/dist/esm/lib/v3/dom/locatorScripts/counts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"counts.js","sourceRoot":"","sources":["../../../../../../lib/v3/dom/locatorScripts/counts.ts"],"names":[],"mappings":"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","sourcesContent":["import { countXPathMatches } from \"./xpathResolver.js\";\n\nexport interface TextMatchSample {\n  tag: string;\n  id: string;\n  class: string;\n  text: string;\n}\n\nexport interface TextMatchResult {\n  count: number;\n  sample: TextMatchSample[];\n  error: null;\n}\n\nexport function countCssMatchesPrimary(selectorRaw: string): number {\n  const selector = String(selectorRaw ?? \"\").trim();\n  if (!selector) return 0;\n\n  const seen = new WeakSet<Node>();\n\n  const visit = (root: Node | null | undefined): number => {\n    if (!root || seen.has(root)) return 0;\n    seen.add(root);\n\n    let total = 0;\n    try {\n      const queryable = root as unknown as ParentNode & {\n        querySelectorAll?: Document[\"querySelectorAll\"];\n      };\n      if (typeof queryable.querySelectorAll === \"function\") {\n        total += queryable.querySelectorAll(selector).length;\n      }\n    } catch {\n      // ignore query errors\n    }\n\n    try {\n      const doc =\n        root instanceof Document\n          ? root\n          : ((root as Element)?.ownerDocument ?? document);\n      const walker = doc.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);\n      let node: Node | null;\n      while ((node = walker.nextNode())) {\n        if (node instanceof Element && node.shadowRoot) {\n          total += visit(node.shadowRoot);\n        }\n      }\n    } catch {\n      // ignore traversal errors\n    }\n\n    return total;\n  };\n\n  try {\n    return visit(document);\n  } catch {\n    try {\n      return document.querySelectorAll(selector).length;\n    } catch {\n      return 0;\n    }\n  }\n}\n\nexport function countCssMatchesPierce(selectorRaw: string): number {\n  const selector = String(selectorRaw ?? \"\").trim();\n  if (!selector) return 0;\n\n  const backdoor = window.__stagehandV3__;\n  if (!backdoor || typeof backdoor.getClosedRoot !== \"function\") {\n    try {\n      return document.querySelectorAll(selector).length;\n    } catch {\n      return 0;\n    }\n  }\n\n  const seen = new WeakSet<Node>();\n  const queue: Node[] = [];\n\n  const enqueue = (node: Node | null | undefined) => {\n    if (!node || seen.has(node)) return;\n    seen.add(node);\n    queue.push(node);\n  };\n\n  enqueue(document);\n  let total = 0;\n\n  const visitElement = (element: Element) => {\n    const open = element.shadowRoot;\n    if (open) enqueue(open);\n    try {\n      const closed = backdoor.getClosedRoot(element);\n      if (closed) enqueue(closed);\n    } catch {\n      // ignore\n    }\n  };\n\n  while (queue.length) {\n    const root = queue.shift();\n    if (!root) continue;\n\n    try {\n      const queryable = root as unknown as ParentNode & {\n        querySelectorAll?: Document[\"querySelectorAll\"];\n      };\n      if (typeof queryable.querySelectorAll === \"function\") {\n        total += queryable.querySelectorAll(selector).length;\n      }\n    } catch {\n      // ignore query errors\n    }\n\n    try {\n      const doc =\n        root instanceof Document\n          ? root\n          : root instanceof ShadowRoot\n            ? (root.host?.ownerDocument ?? document)\n            : ((root as Element).ownerDocument ?? document);\n      const walker = doc.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);\n      let node: Node | null;\n      while ((node = walker.nextNode())) {\n        if (node instanceof Element) {\n          visitElement(node);\n        }\n      }\n    } catch {\n      // ignore traversal errors\n    }\n  }\n\n  return total;\n}\n\nexport function countTextMatches(rawNeedle: string): TextMatchResult {\n  const needle = String(rawNeedle ?? \"\");\n  if (!needle) {\n    return { count: 0, sample: [], error: null };\n  }\n\n  const needleLc = needle.toLowerCase();\n  const skipTags = new Set([\n    \"SCRIPT\",\n    \"STYLE\",\n    \"TEMPLATE\",\n    \"NOSCRIPT\",\n    \"HEAD\",\n    \"TITLE\",\n    \"LINK\",\n    \"META\",\n    \"HTML\",\n    \"BODY\",\n  ]);\n\n  const shouldSkip = (node: Element | null | undefined): boolean => {\n    if (!node) return false;\n    const tag = node.tagName?.toUpperCase() ?? \"\";\n    return skipTags.has(tag);\n  };\n\n  const extractText = (element: Element): string => {\n    try {\n      if (shouldSkip(element)) return \"\";\n      const inner = (element as HTMLElement).innerText;\n      if (typeof inner === \"string\" && inner.trim()) return inner.trim();\n    } catch {\n      // ignore\n    }\n    try {\n      const text = element.textContent;\n      if (typeof text === \"string\") return text.trim();\n    } catch {\n      // ignore\n    }\n    return \"\";\n  };\n\n  const matches = (element: Element): boolean => {\n    const text = extractText(element);\n    return !!text && text.toLowerCase().includes(needleLc);\n  };\n\n  const backdoor = window.__stagehandV3__;\n  const getClosedRoot: (host: Element) => ShadowRoot | null =\n    backdoor && typeof backdoor.getClosedRoot === \"function\"\n      ? (host: Element): ShadowRoot | null => {\n          try {\n            return backdoor.getClosedRoot(host) ?? null;\n          } catch {\n            return null;\n          }\n        }\n      : (host: Element): ShadowRoot | null => {\n          void host;\n          return null;\n        };\n\n  const seen = new WeakSet<Node>();\n  const queue: Node[] = [];\n\n  const enqueue = (node: Node | null | undefined) => {\n    if (!node || seen.has(node)) return;\n    seen.add(node);\n    queue.push(node);\n  };\n\n  const walkerFor = (root: Node): TreeWalker | null => {\n    try {\n      const doc =\n        root instanceof Document\n          ? root\n          : ((root as Element)?.ownerDocument ?? document);\n      return doc.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);\n    } catch {\n      return null;\n    }\n  };\n\n  const matchesList: Array<{\n    element: Element;\n    tag: string;\n    id: string;\n    className: string;\n    text: string;\n  }> = [];\n\n  enqueue(document);\n\n  while (queue.length) {\n    const root = queue.shift();\n    if (!root) continue;\n\n    if (root instanceof Element && matches(root)) {\n      matchesList.push({\n        element: root,\n        tag: root.tagName ?? \"\",\n        id: root.id ?? \"\",\n        className: (root as HTMLElement).className ?? \"\",\n        text: extractText(root),\n      });\n    }\n\n    const walker = walkerFor(root);\n    if (!walker) continue;\n\n    let node: Node | null;\n    while ((node = walker.nextNode())) {\n      if (!(node instanceof Element)) continue;\n\n      if (matches(node)) {\n        matchesList.push({\n          element: node,\n          tag: node.tagName ?? \"\",\n          id: node.id ?? \"\",\n          className: (node as HTMLElement).className ?? \"\",\n          text: extractText(node),\n        });\n      }\n\n      const open = node.shadowRoot;\n      if (open) enqueue(open);\n\n      const closed = getClosedRoot(node);\n      if (closed) enqueue(closed);\n    }\n  }\n\n  const innermost: typeof matchesList = [];\n  for (const item of matchesList) {\n    const el = item.element;\n    let skip = false;\n    for (const other of matchesList) {\n      if (item === other) continue;\n      try {\n        if (el.contains(other.element)) {\n          skip = true;\n          break;\n        }\n      } catch {\n        // ignore containment errors\n      }\n    }\n    if (!skip) innermost.push(item);\n  }\n\n  const count = innermost.length;\n  const sample = innermost.slice(0, 5).map((item) => ({\n    tag: item.tag,\n    id: item.id,\n    class: item.className,\n    text: item.text,\n  }));\n\n  return { count, sample, error: null };\n}\n\nexport function countXPathMatchesMainWorld(rawXp: string): number {\n  return countXPathMatches(rawXp, { pierceShadow: true });\n}\n"]}

package/dist/esm/lib/v3/dom/locatorScripts/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./scripts.js";
+export * from "./selectors.js";
+export * from "./counts.js";
+export * from "./waitForSelector.js";

package/dist/esm/lib/v3/dom/locatorScripts/index.js

@@ -0,0 +1,5 @@
+export * from "./scripts.js";
+export * from "./selectors.js";
+export * from "./counts.js";
+export * from "./waitForSelector.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/v3/dom/locatorScripts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../lib/v3/dom/locatorScripts/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC","sourcesContent":["export * from \"./scripts.js\";\nexport * from \"./selectors.js\";\nexport * from \"./counts.js\";\nexport * from \"./waitForSelector.js\";\n"]}

package/dist/esm/lib/v3/dom/locatorScripts/scripts.d.ts

@@ -0,0 +1,37 @@
+export interface ClickEventOptions {
+    bubbles?: boolean;
+    cancelable?: boolean;
+    composed?: boolean;
+    detail?: number;
+}
+export declare function ensureFileInputElement(this: Element): boolean;
+export interface SerializedFilePayload {
+    name: string;
+    mimeType: string;
+    base64: string;
+    lastModified?: number;
+}
+/** Attach File objects created from serialized payloads to an <input type="file">. */
+export declare function assignFilePayloadsToInputElement(this: Element, payloads: SerializedFilePayload[]): boolean;
+export declare function dispatchDomClick(this: Element, options?: ClickEventOptions): void;
+export declare function scrollElementToPercent(this: Element, percent: number | string): boolean;
+export type FillElementResult = {
+    status: "done";
+} | {
+    status: "needsinput";
+    value: string;
+    reason?: string;
+} | {
+    status: "error";
+    reason: string;
+};
+export declare function prepareElementForTyping(this: Element): boolean;
+export declare function fillElementValue(this: Element, rawValue: string): FillElementResult;
+export declare function focusElement(this: Element): void;
+export declare function selectElementOptions(this: Element, rawValues: string | string[]): string[];
+export declare function isElementVisible(this: Element): boolean;
+export declare function isElementChecked(this: Element): boolean;
+export declare function readElementInputValue(this: Element): string;
+export declare function readElementTextContent(this: Element): string;
+export declare function readElementInnerHTML(this: Element): string;
+export declare function readElementInnerText(this: Element): string;