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

package/dist/cjs/lib/v3/tests/wait-for-selector.spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/wait-for-selector.spec.ts"],
+  "sourcesContent": ["import { expect, test } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\nimport { closeV3 } from \"./testUtils.js\";\n\ntest.describe.configure({ mode: \"serial\" });\ntest.describe(\"Page.waitForSelector tests\", () => {\n  let v3: V3;\n\n  test.beforeAll(async () => {\n    v3 = new V3(v3DynamicTestConfig);\n    await v3.init();\n  });\n\n  test.beforeEach(async () => {\n    const pages = v3.context.pages();\n    if (pages.length === 0) {\n      await v3.context.newPage(\"about:blank\");\n      return;\n    }\n\n    const [primary, ...extras] = pages;\n    for (const page of extras) {\n      await page.close().catch(() => {});\n    }\n\n    v3.context.setActivePage(primary);\n    await primary.goto(\"about:blank\", {\n      waitUntil: \"load\",\n      timeoutMs: 15_000,\n    });\n  });\n\n  test.afterAll(async () => {\n    await closeV3(v3);\n  });\n\n  test.describe(\"Basic state tests\", () => {\n    test(\"resolves when element is already visible\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent('<button id=\"submit-btn\">Submit</button>'),\n      );\n\n      const result = await page.waitForSelector(\"#submit-btn\");\n      expect(result).toBe(true);\n    });\n\n    test(\"resolves when element appears after delay\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            \"<div id='container'></div>\" +\n              \"<script>\" +\n              \"setTimeout(() => {\" +\n              \"  const btn = document.createElement('button');\" +\n              \"  btn.id = 'delayed-btn';\" +\n              \"  btn.textContent = 'Delayed Button';\" +\n              \"  document.getElementById('container').appendChild(btn);\" +\n              \"}, 300);\" +\n              \"</script>\",\n          ),\n      );\n\n      const result = await page.waitForSelector(\"#delayed-btn\", {\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n\n    test(\"state 'attached' resolves for hidden elements\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"hidden-div\" style=\"display: none;\">Hidden Content</div>',\n          ),\n      );\n\n      const result = await page.waitForSelector(\"#hidden-div\", {\n        state: \"attached\",\n      });\n      expect(result).toBe(true);\n    });\n\n    test(\"state 'visible' waits for element to become visible\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"show-later\" style=\"display: none;\">Now Visible</div>' +\n              \"<script>\" +\n              \"setTimeout(() => {\" +\n              \"  document.getElementById('show-later').style.display = 'block';\" +\n              \"}, 300);\" +\n              \"</script>\",\n          ),\n      );\n\n      const result = await page.waitForSelector(\"#show-later\", {\n        state: \"visible\",\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n\n    test(\"state 'hidden' waits for element to become hidden\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"hide-later\" style=\"display: block;\">Will Hide</div>' +\n              \"<script>\" +\n              \"setTimeout(() => {\" +\n              \"  document.getElementById('hide-later').style.display = 'none';\" +\n              \"}, 300);\" +\n              \"</script>\",\n          ),\n      );\n\n      const result = await page.waitForSelector(\"#hide-later\", {\n        state: \"hidden\",\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n\n    test(\"state 'detached' waits for element to be removed\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"remove-me\">Will Be Removed</div>' +\n              \"<script>\" +\n              \"setTimeout(() => {\" +\n              \"  const el = document.getElementById('remove-me');\" +\n              \"  el.parentNode.removeChild(el);\" +\n              \"}, 300);\" +\n              \"</script>\",\n          ),\n      );\n\n      const result = await page.waitForSelector(\"#remove-me\", {\n        state: \"detached\",\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n\n    test(\"state 'detached' resolves immediately for non-existent element\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" + encodeURIComponent(\"<div>Content</div>\"),\n      );\n\n      const result = await page.waitForSelector(\"#does-not-exist\", {\n        state: \"detached\",\n        timeout: 1000,\n      });\n      expect(result).toBe(true);\n    });\n  });\n\n  test.describe(\"Timeout behavior\", () => {\n    test(\"throws on timeout when element never appears\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" + encodeURIComponent(\"<div>No button here</div>\"),\n      );\n\n      let error: Error | null = null;\n      try {\n        await page.waitForSelector(\"#nonexistent\", { timeout: 300 });\n      } catch (e) {\n        error = e as Error;\n      }\n\n      expect(error).not.toBeNull();\n      expect(error?.message).toContain(\"Timeout\");\n      expect(error?.message).toContain(\"#nonexistent\");\n    });\n\n    test(\"respects custom timeout duration\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" + encodeURIComponent(\"<div>Content</div>\"),\n      );\n\n      const startTime = Date.now();\n      try {\n        await page.waitForSelector(\"#nonexistent\", { timeout: 500 });\n      } catch {\n        // Expected to timeout\n      }\n      const elapsed = Date.now() - startTime;\n\n      // Should timeout around 500ms (allow some margin)\n      expect(elapsed).toBeGreaterThanOrEqual(450);\n      expect(elapsed).toBeLessThan(2000);\n    });\n  });\n\n  test.describe(\"CSS selector variants\", () => {\n    test(\"handles complex CSS selectors\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div class=\"container\">' +\n              '<form id=\"login-form\">' +\n              '<button type=\"submit\">Login</button>' +\n              \"</form>\" +\n              \"</div>\",\n          ),\n      );\n\n      const result = await page.waitForSelector(\n        \".container #login-form button[type='submit']\",\n      );\n      expect(result).toBe(true);\n    });\n  });\n\n  test.describe(\"Open shadow DOM\", () => {\n    test(\"finds element inside open shadow DOM with pierceShadow: true\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"host\"></div>' +\n              \"<script>\" +\n              'const host = document.getElementById(\"host\");' +\n              'const shadow = host.attachShadow({mode: \"open\"});' +\n              'shadow.innerHTML = \"<button id=\\\\\"shadow-btn\\\\\">Shadow Button</button>\";' +\n              \"</script>\",\n          ),\n        { waitUntil: \"load\", timeoutMs: 30000 },\n      );\n      await page.waitForTimeout(100);\n\n      const result = await page.waitForSelector(\"#shadow-btn\", {\n        pierceShadow: true,\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n\n    test(\"does NOT find shadow DOM element with pierceShadow: false\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"host\"></div>' +\n              \"<script>\" +\n              'const host = document.getElementById(\"host\");' +\n              'const shadow = host.attachShadow({mode: \"open\"});' +\n              'shadow.innerHTML = \"<button id=\\\\\"shadow-only-btn\\\\\">Shadow Only</button>\";' +\n              \"</script>\",\n          ),\n        { waitUntil: \"load\", timeoutMs: 30000 },\n      );\n      await page.waitForTimeout(100);\n\n      let error: Error | null = null;\n      try {\n        await page.waitForSelector(\"#shadow-only-btn\", {\n          pierceShadow: false,\n          timeout: 300,\n        });\n      } catch (e) {\n        error = e as Error;\n      }\n\n      expect(error).not.toBeNull();\n      expect(error?.message).toContain(\"Timeout\");\n    });\n\n    test(\"finds element in nested open shadow DOM\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"outer-host\"></div>' +\n              \"<script>\" +\n              'const outerHost = document.getElementById(\"outer-host\");' +\n              'const outerShadow = outerHost.attachShadow({mode: \"open\"});' +\n              'outerShadow.innerHTML = \"<div id=\\\\\"inner-host\\\\\"></div>\";' +\n              'const innerHost = outerShadow.getElementById(\"inner-host\");' +\n              'const innerShadow = innerHost.attachShadow({mode: \"open\"});' +\n              'innerShadow.innerHTML = \"<span id=\\\\\"deep-element\\\\\">Deep!</span>\";' +\n              \"</script>\",\n          ),\n        { waitUntil: \"load\", timeoutMs: 30000 },\n      );\n      await page.waitForTimeout(100);\n\n      const result = await page.waitForSelector(\"#deep-element\", {\n        pierceShadow: true,\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n  });\n\n  test.describe(\"Closed shadow DOM (via piercer)\", () => {\n    test(\"finds element inside closed shadow DOM via custom element\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            \"<closed-shadow-host></closed-shadow-host>\" +\n              \"<script>\" +\n              \"class ClosedShadowHost extends HTMLElement {\" +\n              \"  constructor() {\" +\n              \"    super();\" +\n              '    const shadow = this.attachShadow({mode: \"closed\"});' +\n              '    shadow.innerHTML = \"<button id=\\\\\"closed-btn\\\\\">Closed Shadow Button</button>\";' +\n              \"  }\" +\n              \"}\" +\n              \"customElements.define('closed-shadow-host', ClosedShadowHost);\" +\n              \"</script>\",\n          ),\n        { waitUntil: \"load\", timeoutMs: 30000 },\n      );\n      await page.waitForTimeout(100);\n\n      // The piercer hooks attachShadow and stores closed shadow roots\n      const result = await page.waitForSelector(\"#closed-btn\", {\n        pierceShadow: true,\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n\n    test(\"finds element in nested closed shadow DOM\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            \"<outer-closed></outer-closed>\" +\n              \"<script>\" +\n              \"class InnerClosed extends HTMLElement {\" +\n              \"  constructor() {\" +\n              \"    super();\" +\n              '    const shadow = this.attachShadow({mode: \"closed\"});' +\n              '    shadow.innerHTML = \"<span id=\\\\\"deeply-closed\\\\\">Deeply Nested Closed</span>\";' +\n              \"  }\" +\n              \"}\" +\n              \"customElements.define('inner-closed', InnerClosed);\" +\n              \"\" +\n              \"class OuterClosed extends HTMLElement {\" +\n              \"  constructor() {\" +\n              \"    super();\" +\n              '    const shadow = this.attachShadow({mode: \"closed\"});' +\n              '    shadow.innerHTML = \"<inner-closed></inner-closed>\";' +\n              \"  }\" +\n              \"}\" +\n              \"customElements.define('outer-closed', OuterClosed);\" +\n              \"</script>\",\n          ),\n        { waitUntil: \"load\", timeoutMs: 30000 },\n      );\n      await page.waitForTimeout(100);\n\n      const result = await page.waitForSelector(\"#deeply-closed\", {\n        pierceShadow: true,\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n\n    test(\"finds element in mixed open/closed nested shadow DOM\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"open-host\"></div>' +\n              \"<script>\" +\n              // Inner closed component\n              \"class ClosedInner extends HTMLElement {\" +\n              \"  constructor() {\" +\n              \"    super();\" +\n              '    const shadow = this.attachShadow({mode: \"closed\"});' +\n              '    shadow.innerHTML = \"<button id=\\\\\"mixed-deep-btn\\\\\">Mixed Deep Button</button>\";' +\n              \"  }\" +\n              \"}\" +\n              \"customElements.define('closed-inner', ClosedInner);\" +\n              // Outer open shadow\n              'const openHost = document.getElementById(\"open-host\");' +\n              'const openShadow = openHost.attachShadow({mode: \"open\"});' +\n              'openShadow.innerHTML = \"<closed-inner></closed-inner>\";' +\n              \"</script>\",\n          ),\n        { waitUntil: \"load\", timeoutMs: 30000 },\n      );\n      await page.waitForTimeout(100);\n\n      const result = await page.waitForSelector(\"#mixed-deep-btn\", {\n        pierceShadow: true,\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n\n    test(\"waits for element to appear inside closed shadow DOM\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            \"<delayed-closed-host></delayed-closed-host>\" +\n              \"<script>\" +\n              \"class DelayedClosedHost extends HTMLElement {\" +\n              \"  constructor() {\" +\n              \"    super();\" +\n              '    const shadow = this.attachShadow({mode: \"closed\"});' +\n              '    shadow.innerHTML = \"<div id=\\\\\"container\\\\\"></div>\";' +\n              \"    setTimeout(() => {\" +\n              '      shadow.getElementById(\"container\").innerHTML = ' +\n              '        \"<button id=\\\\\"delayed-closed-btn\\\\\">Appeared!</button>\";' +\n              \"    }, 300);\" +\n              \"  }\" +\n              \"}\" +\n              \"customElements.define('delayed-closed-host', DelayedClosedHost);\" +\n              \"</script>\",\n          ),\n        { waitUntil: \"load\", timeoutMs: 30000 },\n      );\n\n      const result = await page.waitForSelector(\"#delayed-closed-btn\", {\n        pierceShadow: true,\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n  });\n\n  test.describe(\"XPath selectors\", () => {\n    test(\"finds element with basic XPath\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent('<button id=\"xpath-btn\">XPath Button</button>'),\n      );\n\n      const result = await page.waitForSelector(\"//button[@id='xpath-btn']\", {\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n\n    test(\"finds element with xpath= prefix\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"container\"><span class=\"target\">Target</span></div>',\n          ),\n      );\n\n      const result = await page.waitForSelector(\n        \"xpath=//span[@class='target']\",\n        {\n          timeout: 5000,\n        },\n      );\n      expect(result).toBe(true);\n    });\n\n    test(\"waits for element to appear with XPath\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            \"<div id='container'></div>\" +\n              \"<script>\" +\n              \"setTimeout(() => {\" +\n              '  document.getElementById(\"container\").innerHTML = ' +\n              '    \"<span id=\\\\\"delayed-xpath\\\\\">Delayed XPath</span>\";' +\n              \"}, 300);\" +\n              \"</script>\",\n          ),\n      );\n\n      const result = await page.waitForSelector(\"//span[@id='delayed-xpath']\", {\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n\n    test(\"finds element in open shadow DOM with XPath\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"host\"></div>' +\n              \"<script>\" +\n              'const host = document.getElementById(\"host\");' +\n              'const shadow = host.attachShadow({mode: \"open\"});' +\n              'shadow.innerHTML = \"<button id=\\\\\"shadow-xpath-btn\\\\\">Shadow XPath</button>\";' +\n              \"</script>\",\n          ),\n        { waitUntil: \"load\", timeoutMs: 30000 },\n      );\n      await page.waitForTimeout(100);\n\n      const result = await page.waitForSelector(\n        \"//button[@id='shadow-xpath-btn']\",\n        {\n          pierceShadow: true,\n          timeout: 5000,\n        },\n      );\n      expect(result).toBe(true);\n    });\n\n    test(\"finds element in closed shadow DOM with XPath\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            \"<xpath-closed-host></xpath-closed-host>\" +\n              \"<script>\" +\n              \"class XPathClosedHost extends HTMLElement {\" +\n              \"  constructor() {\" +\n              \"    super();\" +\n              '    const shadow = this.attachShadow({mode: \"closed\"});' +\n              '    shadow.innerHTML = \"<span id=\\\\\"xpath-closed-target\\\\\">Closed XPath Target</span>\";' +\n              \"  }\" +\n              \"}\" +\n              \"customElements.define('xpath-closed-host', XPathClosedHost);\" +\n              \"</script>\",\n          ),\n        { waitUntil: \"load\", timeoutMs: 30000 },\n      );\n      await page.waitForTimeout(100);\n\n      const result = await page.waitForSelector(\n        \"//span[@id='xpath-closed-target']\",\n        {\n          pierceShadow: true,\n          timeout: 5000,\n        },\n      );\n      expect(result).toBe(true);\n    });\n  });\n\n  test.describe(\"Iframe hop notation (>>)\", () => {\n    test(\"finds element inside single iframe\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<button id=\"main-btn\">Main Button</button>' +\n              '<iframe id=\"my-frame\"></iframe>' +\n              \"<script>\" +\n              'const frame = document.getElementById(\"my-frame\");' +\n              \"const doc = frame.contentDocument;\" +\n              \"doc.open();\" +\n              'doc.write(\"<button id=\\\\\"frame-btn\\\\\">Frame Button</button>\");' +\n              \"doc.close();\" +\n              \"</script>\",\n          ),\n      );\n      await page.waitForTimeout(100);\n\n      const result = await page.waitForSelector(\n        \"iframe#my-frame >> #frame-btn\",\n        {\n          timeout: 5000,\n        },\n      );\n      expect(result).toBe(true);\n    });\n\n    test(\"finds element through multiple iframe hops\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<iframe id=\"outer-frame\"></iframe>' +\n              \"<script>\" +\n              'const outerFrame = document.getElementById(\"outer-frame\");' +\n              \"const outerDoc = outerFrame.contentDocument;\" +\n              \"outerDoc.open();\" +\n              'outerDoc.write(\"<iframe id=\\\\\"inner-frame\\\\\"></iframe>\");' +\n              \"outerDoc.close();\" +\n              \"setTimeout(() => {\" +\n              '  const innerFrame = outerDoc.getElementById(\"inner-frame\");' +\n              \"  const innerDoc = innerFrame.contentDocument;\" +\n              \"  innerDoc.open();\" +\n              '  innerDoc.write(\"<div id=\\\\\"nested-content\\\\\">Deeply Nested</div>\");' +\n              \"  innerDoc.close();\" +\n              \"}, 100);\" +\n              \"</script>\",\n          ),\n      );\n      await page.waitForTimeout(300);\n\n      const result = await page.waitForSelector(\n        \"iframe#outer-frame >> iframe#inner-frame >> #nested-content\",\n        { timeout: 5000 },\n      );\n      expect(result).toBe(true);\n    });\n\n    test(\"waits for element to appear inside iframe\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<iframe id=\"delay-frame\"></iframe>' +\n              \"<script>\" +\n              'const frame = document.getElementById(\"delay-frame\");' +\n              \"const doc = frame.contentDocument;\" +\n              \"doc.open();\" +\n              'doc.write(\"<div id=\\\\\"container\\\\\"></div>\");' +\n              \"doc.close();\" +\n              \"setTimeout(() => {\" +\n              '  doc.getElementById(\"container\").innerHTML = ' +\n              '    \"<span id=\\\\\"delayed-in-frame\\\\\">Appeared!</span>\";' +\n              \"}, 300);\" +\n              \"</script>\",\n          ),\n      );\n\n      const result = await page.waitForSelector(\n        \"iframe#delay-frame >> #delayed-in-frame\",\n        {\n          timeout: 5000,\n        },\n      );\n      expect(result).toBe(true);\n    });\n  });\n\n  test.describe(\"Visibility edge cases\", () => {\n    test(\"visibility: hidden is not visible\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"vis-hidden\" style=\"visibility: hidden;\">Hidden</div>',\n          ),\n      );\n\n      // Should be attached but not visible\n      const attached = await page.waitForSelector(\"#vis-hidden\", {\n        state: \"attached\",\n      });\n      expect(attached).toBe(true);\n\n      let error: Error | null = null;\n      try {\n        await page.waitForSelector(\"#vis-hidden\", {\n          state: \"visible\",\n          timeout: 200,\n        });\n      } catch (e) {\n        error = e as Error;\n      }\n      expect(error).not.toBeNull();\n    });\n\n    test(\"opacity: 0 is not visible\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"transparent\" style=\"opacity: 0;\">Transparent</div>',\n          ),\n      );\n\n      const attached = await page.waitForSelector(\"#transparent\", {\n        state: \"attached\",\n      });\n      expect(attached).toBe(true);\n\n      let error: Error | null = null;\n      try {\n        await page.waitForSelector(\"#transparent\", {\n          state: \"visible\",\n          timeout: 200,\n        });\n      } catch (e) {\n        error = e as Error;\n      }\n      expect(error).not.toBeNull();\n    });\n\n    test(\"zero dimensions is not visible\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"zero-size\" style=\"width: 0; height: 0;\">Zero</div>',\n          ),\n      );\n\n      const attached = await page.waitForSelector(\"#zero-size\", {\n        state: \"attached\",\n      });\n      expect(attached).toBe(true);\n\n      let error: Error | null = null;\n      try {\n        await page.waitForSelector(\"#zero-size\", {\n          state: \"visible\",\n          timeout: 200,\n        });\n      } catch (e) {\n        error = e as Error;\n      }\n      expect(error).not.toBeNull();\n    });\n\n    test(\"detects visibility change via class toggle\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            \"<style>.hidden { display: none; }</style>\" +\n              '<div id=\"class-toggle\" class=\"hidden\">Class Toggle</div>' +\n              \"<script>\" +\n              \"setTimeout(() => {\" +\n              \"  document.getElementById('class-toggle').classList.remove('hidden');\" +\n              \"}, 300);\" +\n              \"</script>\",\n          ),\n      );\n\n      const result = await page.waitForSelector(\"#class-toggle\", {\n        state: \"visible\",\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n\n    test(\"detects visibility change via style attribute\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"style-toggle\" style=\"display: none;\">Style Toggle</div>' +\n              \"<script>\" +\n              \"setTimeout(() => {\" +\n              \"  document.getElementById('style-toggle').style.display = 'block';\" +\n              \"}, 300);\" +\n              \"</script>\",\n          ),\n      );\n\n      const result = await page.waitForSelector(\"#style-toggle\", {\n        state: \"visible\",\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n  });\n\n  test.describe(\"Dynamic DOM scenarios\", () => {\n    test(\"handles rapid DOM mutations\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            \"<div id='container'></div>\" +\n              \"<script>\" +\n              \"let count = 0;\" +\n              \"const interval = setInterval(() => {\" +\n              \"  count++;\" +\n              \"  const div = document.createElement('div');\" +\n              \"  div.id = 'item-' + count;\" +\n              \"  div.textContent = 'item';\" +\n              \"  document.getElementById('container').appendChild(div);\" +\n              \"  if (count >= 10) clearInterval(interval);\" +\n              \"}, 50);\" +\n              \"</script>\",\n          ),\n        { waitUntil: \"load\", timeoutMs: 30000 },\n      );\n      // Small delay to ensure script starts\n      await page.waitForTimeout(50);\n\n      const result = await page.waitForSelector(\"#item-7\", { timeout: 10000 });\n      expect(result).toBe(true);\n    });\n\n    test(\"handles element removed and re-added\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent('<div id=\"toggle-me\">Toggle</div>'),\n      );\n\n      const browserTarget = (\n        process.env.STAGEHAND_BROWSER_TARGET ?? \"local\"\n      ).toLowerCase();\n      const isBrowserbase = browserTarget === \"browserbase\";\n      const removeDelayMs = isBrowserbase ? 1000 : 200;\n      const addDelayMs = isBrowserbase ? 1600 : 500;\n      const waitTimeoutMs = isBrowserbase ? 10000 : 5000;\n\n      // Start waiting before scheduling DOM changes to avoid racey timing in CI.\n      const detachedPromise = page.waitForSelector(\"#toggle-me\", {\n        state: \"detached\",\n        timeout: waitTimeoutMs,\n      });\n      await page.evaluate(\n        ({ removeDelay, addDelay }) => {\n          const el = document.getElementById(\"toggle-me\");\n          const parent = el?.parentNode;\n          if (!el || !parent) return;\n          setTimeout(() => parent.removeChild(el), removeDelay);\n          setTimeout(() => parent.appendChild(el), addDelay);\n        },\n        { removeDelay: removeDelayMs, addDelay: addDelayMs },\n      );\n\n      const detached = await detachedPromise;\n      expect(detached).toBe(true);\n\n      // Then wait for visible again\n      const visible = await page.waitForSelector(\"#toggle-me\", {\n        state: \"visible\",\n        timeout: waitTimeoutMs,\n      });\n      expect(visible).toBe(true);\n    });\n\n    test(\"handles dynamically replaced innerHTML\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"container\">Loading...</div>' +\n              \"<script>\" +\n              \"setTimeout(() => {\" +\n              '  document.getElementById(\"container\").innerHTML = ' +\n              '    \"<button id=\\\\\"loaded-btn\\\\\">Loaded!</button>\";' +\n              \"}, 300);\" +\n              \"</script>\",\n          ),\n      );\n\n      const result = await page.waitForSelector(\"#loaded-btn\", {\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n\n    test(\"handles element created via insertAdjacentHTML\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"anchor\"></div>' +\n              \"<script>\" +\n              \"setTimeout(() => {\" +\n              '  document.getElementById(\"anchor\").insertAdjacentHTML(' +\n              '    \"afterend\", \"<div id=\\\\\"inserted\\\\\">Inserted</div>\"' +\n              \"  );\" +\n              \"}, 300);\" +\n              \"</script>\",\n          ),\n      );\n\n      const result = await page.waitForSelector(\"#inserted\", { timeout: 5000 });\n      expect(result).toBe(true);\n    });\n  });\n\n  test.describe(\"Shadow DOM visibility changes\", () => {\n    test(\"detects element becoming visible inside open shadow DOM\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"host\"></div>' +\n              \"<script>\" +\n              'const host = document.getElementById(\"host\");' +\n              'const shadow = host.attachShadow({mode: \"open\"});' +\n              'shadow.innerHTML = \"<button id=\\\\\"shadow-btn\\\\\" style=\\\\\"display:none\\\\\">Shadow</button>\";' +\n              \"setTimeout(() => {\" +\n              '  shadow.getElementById(\"shadow-btn\").style.display = \"block\";' +\n              \"}, 300);\" +\n              \"</script>\",\n          ),\n        { waitUntil: \"load\", timeoutMs: 30000 },\n      );\n\n      const result = await page.waitForSelector(\"#shadow-btn\", {\n        state: \"visible\",\n        pierceShadow: true,\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n\n    test(\"detects element becoming hidden inside shadow DOM\", async () => {\n      const page = v3.context.pages()[0];\n      await page.goto(\n        \"data:text/html,\" +\n          encodeURIComponent(\n            '<div id=\"host\"></div>' +\n              \"<script>\" +\n              'const host = document.getElementById(\"host\");' +\n              'const shadow = host.attachShadow({mode: \"open\"});' +\n              'shadow.innerHTML = \"<button id=\\\\\"hide-shadow-btn\\\\\">Will Hide</button>\";' +\n              \"setTimeout(() => {\" +\n              '  shadow.getElementById(\"hide-shadow-btn\").style.display = \"none\";' +\n              \"}, 300);\" +\n              \"</script>\",\n          ),\n        { waitUntil: \"load\", timeoutMs: 30000 },\n      );\n      await page.waitForTimeout(100);\n\n      const result = await page.waitForSelector(\"#hide-shadow-btn\", {\n        state: \"hidden\",\n        pierceShadow: true,\n        timeout: 5000,\n      });\n      expect(result).toBe(true);\n    });\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/lib/v3/tests/wait-for-timeout.spec.js

@@ -0,0 +1,97 @@
+var import_test = require("@playwright/test");
+var import_v3 = require("../v3.js");
+var import_v3_dynamic_config = require("./v3.dynamic.config.js");
+var import_testUtils = require("./testUtils.js");
+import_test.test.describe("Page.waitForTimeout tests", () => {
+  let v3;
+  import_test.test.beforeEach(async () => {
+    v3 = new import_v3.V3(import_v3_dynamic_config.v3DynamicTestConfig);
+    await v3.init();
+  });
+  import_test.test.afterEach(async () => {
+    await (0, import_testUtils.closeV3)(v3);
+  });
+  (0, import_test.test)("waitForTimeout resolves after specified duration", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent("<div>Test Page</div>")
+    );
+    const startTime = Date.now();
+    await page.waitForTimeout(200);
+    const elapsed = Date.now() - startTime;
+    (0, import_test.expect)(elapsed).toBeGreaterThanOrEqual(190);
+  });
+  (0, import_test.test)("waitForTimeout resolves immediately for 0ms", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent("<div>Test Page</div>")
+    );
+    const startTime = Date.now();
+    await page.waitForTimeout(0);
+    const elapsed = Date.now() - startTime;
+    (0, import_test.expect)(elapsed).toBeLessThan(50);
+  });
+  (0, import_test.test)("waitForTimeout can be chained with other operations", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent(
+        "<div id='counter'>0</div><script>let count = 0;setInterval(() => {  count++;  document.getElementById('counter').textContent = count;}, 100);</script>"
+      )
+    );
+    await page.waitForTimeout(350);
+    const text = await page.mainFrame().locator("#counter").textContent();
+    (0, import_test.expect)(parseInt(text ?? "0")).toBeGreaterThanOrEqual(3);
+  });
+  (0, import_test.test)("waitForTimeout works with async/await syntax", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto("data:text/html," + encodeURIComponent("<div>Test</div>"));
+    const results = [];
+    results.push(1);
+    await page.waitForTimeout(50);
+    results.push(2);
+    await page.waitForTimeout(50);
+    results.push(3);
+    (0, import_test.expect)(results).toEqual([1, 2, 3]);
+  });
+  (0, import_test.test)("waitForTimeout allows DOM to update", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent(
+        "<div id='delayed'></div><script>window.startUpdate = () => {  setTimeout(() => {    document.getElementById('delayed').textContent = 'Loaded';  }, 200);};</script>"
+      )
+    );
+    await page.evaluate(() => {
+      window.startUpdate();
+    });
+    await page.waitForTimeout(300);
+    const afterText = await page.mainFrame().locator("#delayed").textContent();
+    (0, import_test.expect)(afterText).toBe("Loaded");
+  });
+  (0, import_test.test)("waitForTimeout with small increments", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto("data:text/html," + encodeURIComponent("<div>Test</div>"));
+    const startTime = Date.now();
+    await page.waitForTimeout(50);
+    await page.waitForTimeout(50);
+    await page.waitForTimeout(50);
+    await page.waitForTimeout(50);
+    const elapsed = Date.now() - startTime;
+    (0, import_test.expect)(elapsed).toBeGreaterThanOrEqual(190);
+  });
+  (0, import_test.test)("waitForTimeout does not block other async operations", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent(
+        "<div id='async-test'>Initial</div><script>window.updateText = () => {  document.getElementById('async-test').textContent = 'Updated';};</script>"
+      )
+    );
+    const timeoutPromise = page.waitForTimeout(100);
+    await page.evaluate(() => {
+      window.updateText();
+    });
+    const text = await page.mainFrame().locator("#async-test").textContent();
+    (0, import_test.expect)(text).toBe("Updated");
+    await timeoutPromise;
+  });
+});
+//# sourceMappingURL=wait-for-timeout.spec.js.map

package/dist/cjs/lib/v3/tests/wait-for-timeout.spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/wait-for-timeout.spec.ts"],
+  "sourcesContent": ["import { expect, test } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\nimport { closeV3 } from \"./testUtils.js\";\n\ntest.describe(\"Page.waitForTimeout tests\", () => {\n  let v3: V3;\n\n  test.beforeEach(async () => {\n    v3 = new V3(v3DynamicTestConfig);\n    await v3.init();\n  });\n\n  test.afterEach(async () => {\n    await closeV3(v3);\n  });\n\n  test(\"waitForTimeout resolves after specified duration\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" + encodeURIComponent(\"<div>Test Page</div>\"),\n    );\n\n    const startTime = Date.now();\n    await page.waitForTimeout(200);\n    const elapsed = Date.now() - startTime;\n\n    // Should have waited at least 200ms (allow some tolerance)\n    expect(elapsed).toBeGreaterThanOrEqual(190);\n  });\n\n  test(\"waitForTimeout resolves immediately for 0ms\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" + encodeURIComponent(\"<div>Test Page</div>\"),\n    );\n\n    const startTime = Date.now();\n    await page.waitForTimeout(0);\n    const elapsed = Date.now() - startTime;\n\n    // Should resolve nearly immediately (within 50ms tolerance)\n    expect(elapsed).toBeLessThan(50);\n  });\n\n  test(\"waitForTimeout can be chained with other operations\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(\n          \"<div id='counter'>0</div>\" +\n            \"<script>\" +\n            \"let count = 0;\" +\n            \"setInterval(() => {\" +\n            \"  count++;\" +\n            \"  document.getElementById('counter').textContent = count;\" +\n            \"}, 100);\" +\n            \"</script>\",\n        ),\n    );\n\n    // Wait for counter to increment\n    await page.waitForTimeout(350);\n\n    // Counter should have incremented at least 3 times\n    const text = await page.mainFrame().locator(\"#counter\").textContent();\n    expect(parseInt(text ?? \"0\")).toBeGreaterThanOrEqual(3);\n  });\n\n  test(\"waitForTimeout works with async/await syntax\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\"data:text/html,\" + encodeURIComponent(\"<div>Test</div>\"));\n\n    const results: number[] = [];\n\n    results.push(1);\n    await page.waitForTimeout(50);\n    results.push(2);\n    await page.waitForTimeout(50);\n    results.push(3);\n\n    expect(results).toEqual([1, 2, 3]);\n  });\n\n  test(\"waitForTimeout allows DOM to update\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(\n          \"<div id='delayed'></div>\" +\n            \"<script>\" +\n            \"window.startUpdate = () => {\" +\n            \"  setTimeout(() => {\" +\n            \"    document.getElementById('delayed').textContent = 'Loaded';\" +\n            \"  }, 200);\" +\n            \"};\" +\n            \"</script>\",\n        ),\n    );\n\n    // Trigger the delayed update\n    await page.evaluate(() => {\n      (window as unknown as { startUpdate: () => void }).startUpdate();\n    });\n\n    // Wait for the timeout to allow DOM update\n    await page.waitForTimeout(300);\n\n    // Content should now be loaded\n    const afterText = await page.mainFrame().locator(\"#delayed\").textContent();\n    expect(afterText).toBe(\"Loaded\");\n  });\n\n  test(\"waitForTimeout with small increments\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\"data:text/html,\" + encodeURIComponent(\"<div>Test</div>\"));\n\n    const startTime = Date.now();\n\n    // Multiple small waits\n    await page.waitForTimeout(50);\n    await page.waitForTimeout(50);\n    await page.waitForTimeout(50);\n    await page.waitForTimeout(50);\n\n    const elapsed = Date.now() - startTime;\n\n    // Should have waited at least 200ms total (4 * 50ms)\n    expect(elapsed).toBeGreaterThanOrEqual(190);\n  });\n\n  test(\"waitForTimeout does not block other async operations\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(\n          \"<div id='async-test'>Initial</div>\" +\n            \"<script>\" +\n            \"window.updateText = () => {\" +\n            \"  document.getElementById('async-test').textContent = 'Updated';\" +\n            \"};\" +\n            \"</script>\",\n        ),\n    );\n\n    // Start a timeout\n    const timeoutPromise = page.waitForTimeout(100);\n\n    // Execute something else while waiting\n    await page.evaluate(() => {\n      (window as unknown as { updateText: () => void }).updateText();\n    });\n\n    // Verify the update happened\n    const text = await page.mainFrame().locator(\"#async-test\").textContent();\n    expect(text).toBe(\"Updated\");\n\n    // Wait for the timeout to complete\n    await timeoutPromise;\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/lib/v3/tests/xpath-for-location-deep.spec.js

@@ -0,0 +1,77 @@
+var import_test = require("@playwright/test");
+var import_v3 = require("../v3.js");
+var import_v3_dynamic_config = require("./v3.dynamic.config.js");
+var import_snapshot = require("../understudy/a11y/snapshot/index.js");
+var import_executionContextRegistry = require("../understudy/executionContextRegistry.js");
+var import_testUtils = require("./testUtils.js");
+import_test.test.describe("resolveNodeForLocationDeep", () => {
+  let v3;
+  import_test.test.beforeEach(async () => {
+    v3 = new import_v3.V3(import_v3_dynamic_config.v3DynamicTestConfig);
+    await v3.init();
+  });
+  import_test.test.afterEach(async () => {
+    await (0, import_testUtils.closeV3)(v3);
+  });
+  (0, import_test.test)("click resolves inside same-process iframe and returns absolute XPath", async () => {
+    const page = await v3.context.awaitActivePage();
+    await page.setViewportSize(1280, 720);
+    await page.goto(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/iframe-hn/",
+      { waitUntil: "networkidle" }
+    );
+    await page.waitForSelector("section iframe", {
+      state: "attached",
+      timeout: 1e4
+    });
+    const frame = await page.frameLocator("section iframe").resolveFrame();
+    await import_executionContextRegistry.executionContexts.waitForMainWorld(
+      frame.session,
+      frame.frameId,
+      5e3
+    );
+    await page.evaluate(() => {
+      window.scrollTo(0, document.body.scrollHeight);
+    });
+    await frame.evaluate(() => {
+      window.scrollTo(0, document.body.scrollHeight);
+    });
+    await new Promise((resolve) => setTimeout(resolve, 500));
+    const iframeOffset = await page.evaluate(() => {
+      const iframe = document.querySelector("section iframe");
+      if (!iframe) return null;
+      const rect = iframe.getBoundingClientRect();
+      return {
+        left: rect.left,
+        top: rect.top
+      };
+    });
+    const linkOffsetInFrame = await frame.evaluate(() => {
+      const table = document.querySelector(
+        "center > table > tbody > tr:nth-child(3) > td > table"
+      );
+      if (!table) return null;
+      const row88 = table.querySelector("tbody > tr:nth-child(88)");
+      if (!row88) return null;
+      const cell3 = row88.querySelector("td:nth-child(3)");
+      if (!cell3) return null;
+      const link = cell3.querySelector("span > a");
+      if (!link) return null;
+      const rect = link.getBoundingClientRect();
+      return {
+        x: rect.left + rect.width / 2,
+        y: rect.top + rect.height / 2
+      };
+    });
+    const x = iframeOffset && linkOffsetInFrame ? iframeOffset.left + linkOffsetInFrame.x : 356;
+    const y = iframeOffset && linkOffsetInFrame ? iframeOffset.top + linkOffsetInFrame.y : 503;
+    const result = await (0, import_snapshot.resolveXpathForLocation)(page, x, y);
+    console.log("=== Coordinates used:", { x, y });
+    console.log("=== Result:", result);
+    const xpath = result.absoluteXPath;
+    (0, import_test.expect)(xpath).toBe(
+      "/html[1]/body[1]/main[1]/section[3]/iframe[1]/html[1]/body[1]/center[1]/table[1]/tbody[1]/tr[3]/td[1]/table[1]/tbody[1]/tr[88]/td[3]/span[1]/a[1]"
+    );
+  });
+});
+//# sourceMappingURL=xpath-for-location-deep.spec.js.map

package/dist/cjs/lib/v3/tests/xpath-for-location-deep.spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/xpath-for-location-deep.spec.ts"],
+  "sourcesContent": ["import { expect, test } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\nimport { resolveXpathForLocation } from \"../understudy/a11y/snapshot/index.js\";\nimport { executionContexts } from \"../understudy/executionContextRegistry.js\";\nimport { closeV3 } from \"./testUtils.js\";\n\ntest.describe(\"resolveNodeForLocationDeep\", () => {\n  let v3: V3;\n\n  test.beforeEach(async () => {\n    v3 = new V3(v3DynamicTestConfig);\n    await v3.init();\n  });\n\n  test.afterEach(async () => {\n    await closeV3(v3);\n  });\n\n  test(\"click resolves inside same-process iframe and returns absolute XPath\", async () => {\n    const page = await v3.context.awaitActivePage();\n\n    // Set consistent viewport size to ensure stable rendering across environments\n    await page.setViewportSize(1280, 720);\n\n    await page.goto(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/iframe-hn/\",\n      { waitUntil: \"networkidle\" },\n    );\n\n    await page.waitForSelector(\"section iframe\", {\n      state: \"attached\",\n      timeout: 10000,\n    });\n    const frame = await page.frameLocator(\"section iframe\").resolveFrame();\n    await executionContexts.waitForMainWorld(\n      frame.session,\n      frame.frameId,\n      5000,\n    );\n\n    // scroll to the bottom of the page\n    await page.evaluate(() => {\n      window.scrollTo(0, document.body.scrollHeight);\n    });\n\n    // scroll to the bottom of the iframe\n    await frame.evaluate(() => {\n      window.scrollTo(0, document.body.scrollHeight);\n    });\n\n    // Wait a bit for the iframe content to settle after scrolling\n    await new Promise((resolve) => setTimeout(resolve, 500));\n\n    // Get the iframe's position in the main page\n    const iframeOffset = await page.evaluate(() => {\n      const iframe = document.querySelector(\"section iframe\");\n      if (!iframe) return null;\n      const rect = iframe.getBoundingClientRect();\n      return {\n        left: rect.left,\n        top: rect.top,\n      };\n    });\n\n    // Get the link's position within the iframe\n    const linkOffsetInFrame = await frame.evaluate(() => {\n      // Find the 88th row, 3rd column link (the one we're testing)\n      const table = document.querySelector(\n        \"center > table > tbody > tr:nth-child(3) > td > table\",\n      );\n      if (!table) return null;\n\n      const row88 = table.querySelector(\"tbody > tr:nth-child(88)\");\n      if (!row88) return null;\n\n      const cell3 = row88.querySelector(\"td:nth-child(3)\");\n      if (!cell3) return null;\n\n      const link = cell3.querySelector(\"span > a\");\n      if (!link) return null;\n\n      const rect = link.getBoundingClientRect();\n      // Return center coordinates of the link relative to iframe\n      return {\n        x: rect.left + rect.width / 2,\n        y: rect.top + rect.height / 2,\n      };\n    });\n\n    // Combine iframe offset and link offset to get page-level coordinates\n    // Fallback to hardcoded coordinates if element not found (shouldn't happen)\n    const x =\n      iframeOffset && linkOffsetInFrame\n        ? iframeOffset.left + linkOffsetInFrame.x\n        : 356;\n    const y =\n      iframeOffset && linkOffsetInFrame\n        ? iframeOffset.top + linkOffsetInFrame.y\n        : 503;\n\n    const result = await resolveXpathForLocation(page, x, y);\n    console.log(\"=== Coordinates used:\", { x, y });\n    console.log(\"=== Result:\", result);\n    const xpath = result.absoluteXPath;\n    expect(xpath).toBe(\n      \"/html[1]/body[1]/main[1]/section[3]/iframe[1]/html[1]/body[1]/center[1]/table[1]/tbody[1]/tr[3]/td[1]/table[1]/tbody[1]/tr[88]/td[3]/span[1]/a[1]\",\n    );\n  });\n});\n"],
+  "mappings": "AAAA,kBAA6B;AAC7B,gBAAmB;AACnB,+BAAoC;AACpC,sBAAwC;AACxC,sCAAkC;AAClC,uBAAwB;AAExB,iBAAK,SAAS,8BAA8B,MAAM;AAChD,MAAI;AAEJ,mBAAK,WAAW,YAAY;AAC1B,SAAK,IAAI,aAAG,4CAAmB;AAC/B,UAAM,GAAG,KAAK;AAAA,EAChB,CAAC;AAED,mBAAK,UAAU,YAAY;AACzB,cAAM,0BAAQ,EAAE;AAAA,EAClB,CAAC;AAED,wBAAK,wEAAwE,YAAY;AACvF,UAAM,OAAO,MAAM,GAAG,QAAQ,gBAAgB;AAG9C,UAAM,KAAK,gBAAgB,MAAM,GAAG;AAEpC,UAAM,KAAK;AAAA,MACT;AAAA,MACA,EAAE,WAAW,cAAc;AAAA,IAC7B;AAEA,UAAM,KAAK,gBAAgB,kBAAkB;AAAA,MAC3C,OAAO;AAAA,MACP,SAAS;AAAA,IACX,CAAC;AACD,UAAM,QAAQ,MAAM,KAAK,aAAa,gBAAgB,EAAE,aAAa;AACrE,UAAM,kDAAkB;AAAA,MACtB,MAAM;AAAA,MACN,MAAM;AAAA,MACN;AAAA,IACF;AAGA,UAAM,KAAK,SAAS,MAAM;AACxB,aAAO,SAAS,GAAG,SAAS,KAAK,YAAY;AAAA,IAC/C,CAAC;AAGD,UAAM,MAAM,SAAS,MAAM;AACzB,aAAO,SAAS,GAAG,SAAS,KAAK,YAAY;AAAA,IAC/C,CAAC;AAGD,UAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,GAAG,CAAC;AAGvD,UAAM,eAAe,MAAM,KAAK,SAAS,MAAM;AAC7C,YAAM,SAAS,SAAS,cAAc,gBAAgB;AACtD,UAAI,CAAC,OAAQ,QAAO;AACpB,YAAM,OAAO,OAAO,sBAAsB;AAC1C,aAAO;AAAA,QACL,MAAM,KAAK;AAAA,QACX,KAAK,KAAK;AAAA,MACZ;AAAA,IACF,CAAC;AAGD,UAAM,oBAAoB,MAAM,MAAM,SAAS,MAAM;AAEnD,YAAM,QAAQ,SAAS;AAAA,QACrB;AAAA,MACF;AACA,UAAI,CAAC,MAAO,QAAO;AAEnB,YAAM,QAAQ,MAAM,cAAc,0BAA0B;AAC5D,UAAI,CAAC,MAAO,QAAO;AAEnB,YAAM,QAAQ,MAAM,cAAc,iBAAiB;AACnD,UAAI,CAAC,MAAO,QAAO;AAEnB,YAAM,OAAO,MAAM,cAAc,UAAU;AAC3C,UAAI,CAAC,KAAM,QAAO;AAElB,YAAM,OAAO,KAAK,sBAAsB;AAExC,aAAO;AAAA,QACL,GAAG,KAAK,OAAO,KAAK,QAAQ;AAAA,QAC5B,GAAG,KAAK,MAAM,KAAK,SAAS;AAAA,MAC9B;AAAA,IACF,CAAC;AAID,UAAM,IACJ,gBAAgB,oBACZ,aAAa,OAAO,kBAAkB,IACtC;AACN,UAAM,IACJ,gBAAgB,oBACZ,aAAa,MAAM,kBAAkB,IACrC;AAEN,UAAM,SAAS,UAAM,yCAAwB,MAAM,GAAG,CAAC;AACvD,YAAQ,IAAI,yBAAyB,EAAE,GAAG,EAAE,CAAC;AAC7C,YAAQ,IAAI,eAAe,MAAM;AACjC,UAAM,QAAQ,OAAO;AACrB,4BAAO,KAAK,EAAE;AAAA,MACZ;AAAA,IACF;AAAA,EACF,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/cjs/lib/v3/timeoutConfig.d.ts

@@ -0,0 +1,2 @@
+export declare function getEnvTimeoutMs(name: string): number | undefined;
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, operation: string): Promise<T>;

package/dist/cjs/lib/v3/types/private/agent.d.ts

@@ -0,0 +1,6 @@
+export interface ActionMappingOptions {
+    toolCallName: string;
+    toolResult: unknown;
+    args: Record<string, unknown>;
+    reasoning?: string;
+}

package/dist/cjs/lib/v3/types/private/api.d.ts

@@ -0,0 +1,11 @@
+import type { Protocol } from "devtools-protocol";
+export interface SerializableResponse {
+    requestId: string;
+    frameId?: string;
+    loaderId?: string;
+    response: Protocol.Network.Response;
+    fromServiceWorkerFlag?: boolean;
+    finishedSettled?: boolean;
+    extraInfoHeaders?: Protocol.Network.Headers | null;
+    extraInfoHeadersText?: string;
+}

package/dist/cjs/lib/v3/types/private/cache.d.ts

@@ -0,0 +1,128 @@
+import type { ActOptions, ActResult, AvailableModel, Logger, AgentResult, Action, LoadState } from "../public/index.js";
+import { CacheStorage } from "../../cache/CacheStorage.js";
+import type { ActHandler } from "../../handlers/actHandler.js";
+import type { V3Context } from "../../understudy/context.js";
+import type { LLMClient } from "../../llm/LLMClient.js";
+export type ActFn = (instruction: string, options?: ActOptions) => Promise<ActResult>;
+export type AgentCacheContext = {
+    instruction: string;
+    startUrl: string;
+    options: SanitizedAgentExecuteOptions;
+    configSignature: string;
+    cacheKey: string;
+};
+export type AgentCacheTransferPayload = {
+    cacheKey: string;
+    entry: CachedAgentEntry;
+};
+export type AgentCacheDeps = {
+    storage: CacheStorage;
+    logger: Logger;
+    getActHandler: () => ActHandler | null;
+    getContext: () => V3Context | null;
+    getDefaultLlmClient: () => LLMClient;
+    getBaseModelName: () => AvailableModel;
+    getSystemPrompt: () => string | undefined;
+    domSettleTimeoutMs?: number;
+    act: ActFn;
+    bufferLatestEntry?: boolean;
+};
+export type ActCacheContext = {
+    instruction: string;
+    cacheKey: string;
+    pageUrl: string;
+    variableKeys: string[];
+    variables?: Record<string, string>;
+};
+export type ActCacheDeps = {
+    storage: CacheStorage;
+    logger: Logger;
+    getActHandler: () => ActHandler | null;
+    getDefaultLlmClient: () => LLMClient;
+    domSettleTimeoutMs?: number;
+};
+export type ReadJsonResult<T> = {
+    value: T | null;
+    path?: string;
+    error?: unknown;
+};
+export type WriteJsonResult = {
+    path?: string;
+    error?: unknown;
+};
+export interface CachedActEntry {
+    version: 1;
+    instruction: string;
+    url: string;
+    variableKeys: string[];
+    actions: Action[];
+    actionDescription?: string;
+    message?: string;
+}
+export type AgentReplayStep = AgentReplayActStep | AgentReplayFillFormStep | AgentReplayGotoStep | AgentReplayScrollStep | AgentReplayWaitStep | AgentReplayNavBackStep | AgentReplayKeysStep | {
+    type: string;
+    [key: string]: unknown;
+};
+export interface AgentReplayActStep {
+    type: "act";
+    instruction: string;
+    actions?: Action[];
+    actionDescription?: string;
+    message?: string;
+    timeout?: number;
+}
+export interface AgentReplayFillFormStep {
+    type: "fillForm";
+    fields?: Array<{
+        action: string;
+        value: string;
+    }>;
+    observeResults?: Action[];
+    actions?: Action[];
+}
+export interface AgentReplayGotoStep {
+    type: "goto";
+    url: string;
+    waitUntil?: LoadState;
+}
+export interface AgentReplayScrollStep {
+    type: "scroll";
+    deltaX?: number;
+    deltaY?: number;
+    anchor?: {
+        x: number;
+        y: number;
+    };
+}
+export interface AgentReplayWaitStep {
+    type: "wait";
+    timeMs: number;
+}
+export interface AgentReplayNavBackStep {
+    type: "navback";
+    waitUntil?: LoadState;
+}
+export interface AgentReplayKeysStep {
+    type: "keys";
+    instruction?: string;
+    playwrightArguments: {
+        method: "type" | "press";
+        text?: string;
+        keys?: string;
+        times?: number;
+    };
+}
+export interface SanitizedAgentExecuteOptions {
+    maxSteps?: number;
+    highlightCursor?: boolean;
+}
+export interface CachedAgentEntry {
+    version: 1;
+    instruction: string;
+    startUrl: string;
+    options: SanitizedAgentExecuteOptions;
+    configSignature: string;
+    steps: AgentReplayStep[];
+    result: AgentResult;
+    timestamp: string;
+}

package/dist/cjs/lib/v3/types/private/evaluator.d.ts

@@ -0,0 +1,40 @@
+export type EvaluateOptions = {
+    /** The question to ask about the task state */
+    question: string;
+    /** The answer to the question */
+    answer?: string;
+    /** Whether to take a screenshot of the task state, or array of screenshots to evaluate */
+    screenshot?: boolean | Buffer[];
+    /** Custom system prompt for the evaluator */
+    systemPrompt?: string;
+    /** Delay in milliseconds before taking the screenshot @default 250 */
+    screenshotDelayMs?: number;
+    /** The agent's reasoning/thought process for completing the task */
+    agentReasoning?: string;
+};
+export type BatchAskOptions = {
+    /** Array of questions with optional answers */
+    questions: Array<{
+        question: string;
+        answer?: string;
+    }>;
+    /** Whether to take a screenshot of the task state */
+    screenshot?: boolean;
+    /** Custom system prompt for the evaluator */
+    systemPrompt?: string;
+    /** Delay in milliseconds before taking the screenshot @default 1000 */
+    screenshotDelayMs?: number;
+};
+/**
+ * Result of an evaluation
+ */
+export interface EvaluationResult {
+    /**
+     * The evaluation result ('YES', 'NO', or 'INVALID' if parsing failed or value was unexpected)
+     */
+    evaluation: "YES" | "NO" | "INVALID";
+    /**
+     * The reasoning behind the evaluation
+     */
+    reasoning: string;
+}

package/dist/cjs/lib/v3/types/private/handlers.d.ts

@@ -0,0 +1,38 @@
+import { Page } from "../../understudy/page.js";
+import { ModelConfiguration } from "../public/model.js";
+import type { StagehandZodSchema } from "../../zodCompat.js";
+export interface ActHandlerParams {
+    instruction: string;
+    model?: ModelConfiguration;
+    variables?: Record<string, string>;
+    timeout?: number;
+    page: Page;
+}
+export interface ExtractHandlerParams<T extends StagehandZodSchema> {
+    instruction?: string;
+    schema?: T;
+    model?: ModelConfiguration;
+    timeout?: number;
+    selector?: string;
+    page: Page;
+}
+export interface ObserveHandlerParams {
+    instruction?: string;
+    model?: ModelConfiguration;
+    timeout?: number;
+    selector?: string;
+    page: Page;
+}
+export declare enum SupportedUnderstudyAction {
+    CLICK = "click",
+    FILL = "fill",
+    TYPE = "type",
+    PRESS = "press",
+    SCROLL = "scrollTo",
+    NEXT_CHUNK = "nextChunk",
+    PREV_CHUNK = "prevChunk",
+    SELECT_OPTION_FROM_DROPDOWN = "selectOptionFromDropdown",
+    HOVER = "hover",
+    DOUBLE_CLICK = "doubleClick",
+    DRAG_AND_DROP = "dragAndDrop"
+}

package/dist/cjs/lib/v3/types/private/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./api.js";
+export * from "./handlers.js";
+export * from "./internal.js";
+export * from "./evaluator.js";
+export * from "./cache.js";
+export * from "./agent.js";
+export * from "./snapshot.js";

package/dist/cjs/lib/v3/types/private/internal.d.ts

@@ -0,0 +1,39 @@
+import Browserbase from "@browserbasehq/sdk";
+import { LaunchedChrome } from "chrome-launcher";
+export type InitState = {
+    kind: "UNINITIALIZED";
+} | {
+    kind: "LOCAL";
+    chrome: LaunchedChrome;
+    ws: string;
+    userDataDir?: string;
+    createdTempProfile?: boolean;
+    preserveUserDataDir?: boolean;
+} | {
+    kind: "BROWSERBASE";
+    bb: Browserbase;
+    sessionId: string;
+    ws: string;
+};
+export type EncodedId = `${number}-${number}`;
+/**
+ * Represents a path through a Zod schema from the root object down to a
+ * particular field. The `segments` array describes the chain of keys/indices.
+ *
+ * - **String** segments indicate object property names.
+ * - **Number** segments indicate array indices.
+ *
+ * For example, `["users", 0, "homepage"]` might describe reaching
+ * the `homepage` field in `schema.users[0].homepage`.
+ */
+export interface ZodPathSegments {
+    /**
+     * The ordered list of keys/indices leading from the schema root
+     * to the targeted field.
+     */
+    segments: Array<string | number>;
+}
+export type InitScriptSource<Arg> = string | {
+    path?: string;
+    content?: string;
+} | ((arg: Arg) => unknown);

package/dist/cjs/lib/v3/types/private/locator.d.ts

@@ -0,0 +1,9 @@
+import { Buffer } from "buffer";
+export interface NormalizedFilePayload {
+    name: string;
+    mimeType: string;
+    buffer: Buffer;
+    lastModified: number;
+    /** Absolute path to the source file when provided by the caller. */
+    absolutePath?: string;
+}