@browserbasehq/orca 3.7.1-preview.0 → 3.7.2-preview.0

package/dist/cjs/lib/v3/types/public/options.js.map

@@ -1 +1 @@
-{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/public/options.ts"],"names":[],"mappings":";;;AAIA,qCAGkB;AAIlB,0DAA0D;AAC7C,QAAA,+BAA+B,GAAG,wCAA+B,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { LLMClient } from \"../../llm/LLMClient.js\";\nimport { ModelConfiguration } from \"./model.js\";\nimport { LogLine } from \"./logs.js\";\nimport {\n  type BrowserbaseSessionCreateParams,\n  LocalBrowserLaunchOptionsSchema,\n} from \"./api.js\";\n\nexport type V3Env = \"LOCAL\" | \"BROWSERBASE\";\n\n// Re-export for backwards compatibility (camelCase alias)\nexport const localBrowserLaunchOptionsSchema = LocalBrowserLaunchOptionsSchema;\n\nexport type LocalBrowserLaunchOptions = z.infer<\n  typeof LocalBrowserLaunchOptionsSchema\n>;\n\n/** Constructor options for V3 */\nexport interface V3Options {\n  env: V3Env;\n  /**\n   * Optional external session identifier to use for flow logging/event storage.\n   * When omitted, Stagehand falls back to its internal instance id.\n   * This currently ends up 1:1 with the Browserbase session id when one exists,\n   * but callers should not rely on that remaining a permanent invariant.\n   */\n  sessionId?: string;\n  // Browserbase (required when env = \"BROWSERBASE\")\n  apiKey?: string;\n  projectId?: string;\n  /**\n   * Optional: fine-tune Browserbase session creation or resume an existing session.\n   */\n  browserbaseSessionCreateParams?: BrowserbaseSessionCreateParams;\n  browserbaseSessionID?: string;\n  /**\n   * Controls browser keepalive behavior. When set, it overrides any value in\n   * browserbaseSessionCreateParams.keepAlive.\n   */\n  keepAlive?: boolean;\n\n  // Local Chromium (optional)\n  localBrowserLaunchOptions?: LocalBrowserLaunchOptions;\n\n  model?: ModelConfiguration;\n  llmClient?: LLMClient; // allow user to pass their own\n  systemPrompt?: string;\n  logInferenceToFile?: boolean;\n  experimental?: boolean;\n  verbose?: 0 | 1 | 2;\n  selfHeal?: boolean;\n  // V2 compatibility fields - only included because the server imports this type and supports V2\n  waitForCaptchaSolves?: boolean;\n  actTimeoutMs?: number;\n  /** Disable pino logging backend (useful for tests or minimal environments). */\n  disablePino?: boolean;\n  /** Optional external logger hook for integrating with host apps. */\n  logger?: (line: LogLine) => void;\n  /** Directory used to persist cached actions for act(). */\n  cacheDir?: string;\n  domSettleTimeout?: number;\n  disableAPI?: boolean;\n  /**\n   * When true, enables server-side caching for API requests.\n   * When false, disables server-side caching.\n   * Defaults to true (caching enabled).\n   * Can be overridden per-method in act(), extract(), and observe() options.\n   */\n  serverCache?: boolean;\n}\n"]}
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/public/options.ts"],"names":[],"mappings":";;;AAIA,qCAGkB;AAIlB,0DAA0D;AAC7C,QAAA,+BAA+B,GAAG,wCAA+B,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { LLMClient } from \"../../llm/LLMClient.js\";\nimport { ModelConfiguration } from \"./model.js\";\nimport { LogLine } from \"./logs.js\";\nimport {\n  type BrowserbaseSessionCreateParams,\n  LocalBrowserLaunchOptionsSchema,\n} from \"./api.js\";\n\nexport type V3Env = \"LOCAL\" | \"BROWSERBASE\";\n\n// Re-export for backwards compatibility (camelCase alias)\nexport const localBrowserLaunchOptionsSchema = LocalBrowserLaunchOptionsSchema;\n\nexport type LocalBrowserLaunchOptions = z.infer<\n  typeof LocalBrowserLaunchOptionsSchema\n>;\n\n/** Constructor options for V3 */\nexport interface V3Options {\n  env: V3Env;\n  /**\n   * Optional external session identifier to use for flow logging/event storage.\n   * When omitted, Stagehand falls back to its internal instance id.\n   * This currently ends up 1:1 with the Browserbase session id when one exists,\n   * but callers should not rely on that remaining a permanent invariant.\n   */\n  sessionId?: string;\n  // Browserbase (required when env = \"BROWSERBASE\")\n  apiKey?: string;\n  projectId?: string;\n  /**\n   * Optional: fine-tune Browserbase session creation or resume an existing session.\n   */\n  browserbaseSessionCreateParams?: BrowserbaseSessionCreateParams;\n  browserbaseSessionID?: string;\n  /**\n   * Controls browser keepalive behavior. When set, it overrides any value in\n   * browserbaseSessionCreateParams.keepAlive.\n   */\n  keepAlive?: boolean;\n\n  // Local Chromium (optional)\n  localBrowserLaunchOptions?: LocalBrowserLaunchOptions;\n\n  /**\n   * Actuate coordinate pointer actions as touch (a real `Input.dispatchTouchEvent`\n   * tap) instead of mouse input. Mobile layouts commonly gate their handlers on\n   * touch/pointer events, where a synthesized mouse click never registers — e.g. a\n   * size selector that keeps reporting \"please choose a size\". Set this when the\n   * session renders a mobile layout (e.g. Browserbase `browserSettings.os:\n   * \"mobile\"`).\n   *\n   * Explicit opt-in only — nothing is derived from the session.\n   *\n   * @default false\n   */\n  useTouch?: boolean;\n\n  model?: ModelConfiguration;\n  llmClient?: LLMClient; // allow user to pass their own\n  systemPrompt?: string;\n  logInferenceToFile?: boolean;\n  experimental?: boolean;\n  verbose?: 0 | 1 | 2;\n  selfHeal?: boolean;\n  // V2 compatibility fields - only included because the server imports this type and supports V2\n  waitForCaptchaSolves?: boolean;\n  actTimeoutMs?: number;\n  /** Disable pino logging backend (useful for tests or minimal environments). */\n  disablePino?: boolean;\n  /** Optional external logger hook for integrating with host apps. */\n  logger?: (line: LogLine) => void;\n  /** Directory used to persist cached actions for act(). */\n  cacheDir?: string;\n  domSettleTimeout?: number;\n  disableAPI?: boolean;\n  /**\n   * When true, enables server-side caching for API requests.\n   * When false, disables server-side caching.\n   * Defaults to true (caching enabled).\n   * Can be overridden per-method in act(), extract(), and observe() options.\n   */\n  serverCache?: boolean;\n}\n"]}

package/dist/cjs/lib/v3/understudy/locator.d.ts

@@ -104,6 +104,18 @@ export declare class Locator {
         button?: MouseButton;
         clickCount?: number;
     }): Promise<void>;
+    /**
+     * Tap the element at its visual center with a real (trusted) touch.
+     * Mirrors {@link click} but synthesizes touch input via `Input.dispatchTouchEvent`
+     * instead of mouse input, so mobile layouts that gate handlers on touch/pointer
+     * (`pointerType: "touch"`) events — where a mouse click never registers — respond
+     * correctly. This is the deterministic (selector-based) counterpart used when a
+     * recorded CUA `tap` step is replayed.
+     *
+     * Does not require touch emulation: CDP delivers a trusted touch sequence even on
+     * a session reporting `maxTouchPoints: 0`.
+     */
+    tap(): Promise<void>;
     /**
      * Dispatch a DOM 'click' MouseEvent on the element itself.
      * - Does not synthesize real pointer input; directly dispatches an event.

package/dist/cjs/lib/v3/understudy/locator.js

@@ -392,6 +392,50 @@ class Locator {
             }
         }
     }
+    /**
+     * Tap the element at its visual center with a real (trusted) touch.
+     * Mirrors {@link click} but synthesizes touch input via `Input.dispatchTouchEvent`
+     * instead of mouse input, so mobile layouts that gate handlers on touch/pointer
+     * (`pointerType: "touch"`) events — where a mouse click never registers — respond
+     * correctly. This is the deterministic (selector-based) counterpart used when a
+     * recorded CUA `tap` step is replayed.
+     *
+     * Does not require touch emulation: CDP delivers a trusted touch sequence even on
+     * a session reporting `maxTouchPoints: 0`.
+     */
+    async tap() {
+        const session = this.frame.session;
+        const { objectId } = await this.resolveNode();
+        try {
+            await session.send("DOM.scrollIntoViewIfNeeded", { objectId });
+            const box = await session.send("DOM.getBoxModel", { objectId });
+            if (!box.model)
+                throw new sdkErrors_js_1.ElementNotVisibleError(this.selector);
+            const { cx, cy } = this.centerFromBoxContent(box.model.content);
+            // Pipelined burst, matching click's press/release batching: CDP preserves
+            // per-session command order, so awaiting each dispatch in turn would only
+            // add a round trip (a full network RTT against a remote browser).
+            await Promise.all([
+                session.send("Input.dispatchTouchEvent", {
+                    type: "touchStart",
+                    touchPoints: [{ x: cx, y: cy }],
+                }),
+                session.send("Input.dispatchTouchEvent", {
+                    type: "touchEnd",
+                    touchPoints: [],
+                }),
+            ]);
+        }
+        finally {
+            try {
+                await session.send("Runtime.releaseObject", { objectId });
+            }
+            catch {
+                // If the context navigated or was destroyed (e.g., link opens new tab),
+                // releaseObject may fail with -32000. Ignore as best-effort cleanup.
+            }
+        }
+    }
     /**
      * Dispatch a DOM 'click' MouseEvent on the element itself.
      * - Does not synthesize real pointer input; directly dispatches an event.

package/dist/cjs/lib/v3/understudy/locator.js.map

@@ -1 +1 @@
-{"version":3,"file":"locator.js","sourceRoot":"","sources":["../../../../../lib/v3/understudy/locator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,uCAAyB;AACzB,uCAAyB;AACzB,2CAA6B;AAC7B,0FAIkD;AAElD,+DAG+B;AAC/B,+DAKsC;AACtC,6DAA2D;AAI3D,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,oCAAoC;AAEtF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,OAAO;IASC;IACA;IACA;IAVF,gBAAgB,CAAwB;IAExC,aAAa,CAAgB;IAE9C,qFAAqF;IACpE,QAAQ,CAAS;IAElC,YACmB,KAAY,EACZ,QAAgB,EAChB,OAA4C,EAC7D,WAAmB,CAAC,CAAC;QAHJ,UAAK,GAAL,KAAK,CAAO;QACZ,aAAQ,GAAR,QAAQ,CAAQ;QAChB,YAAO,GAAP,OAAO,CAAqC;QAG7D,IAAI,CAAC,gBAAgB,GAAG,IAAI,2CAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9D,IAAI,CAAC,aAAa,GAAG,2CAAqB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACnE,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,QAAQ,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IACnD,CAAC;IAED,oFAAoF;IAC7E,QAAQ;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;;;;;OAQG;IACI,KAAK,CAAC,aAAa,CAAC,KAA4B;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAE9C,MAAM,SAAS,GAAa,EAAE,CAAC;QAE/B,IAAI,CAAC;YACH,6CAA6C;YAC7C,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;oBACE,QAAQ;oBACR,mBAAmB,EAAE,kDAAoB,CAAC,sBAAsB;oBAChE,aAAa,EAAE,IAAI;iBACpB,CACF,CAAC;gBACF,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACrC,IAAI,CAAC,EAAE;oBACL,MAAM,IAAI,4CAA6B,CACrC,8CAA8C,CAC/C,CAAC;YACN,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,4CAA6B,CACrC,CAAC,YAAY,KAAK;oBAChB,CAAC,CAAC,CAAC,CAAC,OAAO;oBACX,CAAC,CAAC,qCAAqC,CAC1C,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,IAAA,wCAAmB,EAAC,KAAK,CAAC,CAAC;YAEpD,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;gBACvB,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE;oBACjD,QAAQ;oBACR,KAAK,EAAE,EAAE;iBACV,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,IAAI,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,CAAC;gBACjC,MAAM,IAAI,CAAC,8BAA8B,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;gBAChE,OAAO;YACT,CAAC;YAED,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;gBACjC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;oBACzB,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;oBACrC,SAAS;gBACX,CAAC;gBACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACvC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CACnB,EAAE,CAAC,MAAM,EAAE,EACX,oBAAoB,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAC9E,CAAC;gBACF,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBACjD,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpB,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;YAED,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE;gBACjD,QAAQ;gBACR,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,qEAAqE;YACrE,MAAM,OAAO;iBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACnB,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC;oBACH,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC9B,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,8BAA8B,CAC1C,QAAyC,EACzC,KAA8B;QAE9B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAEnC,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;YAC5B,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,uBAAuB,EAAE,CAAC;gBACpD,MAAM,IAAI,4CAA6B,CACrC,0BAA0B,OAAO,CAAC,IAAI,oDAAoD,CAC3F,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;SAC1C,CAAC,CAAC,CAAC;QAEJ,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;YACE,QAAQ;YACR,mBAAmB,EACjB,kDAAoB,CAAC,gCAAgC;YACvD,SAAS,EAAE;gBACT;oBACE,KAAK,EAAE,UAAU;iBAClB;aACF;YACD,aAAa,EAAE,IAAI;SACpB,CACF,CAAC;QAEF,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,4CAA6B,CACrC,wDAAwD,CACzD,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACjD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CACjC,kBAAkB,EAClB,EAAE,QAAQ,EAAE,CACb,CAAC;YACF,OAAO,IAAI,CAAC,aAA2C,CAAC;QAC1D,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO;iBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,8DAA8D;IACvD,KAAK,CAAC,KAAK;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACrC,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACzD,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,QAAQ;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,OAAO;iBACV,IAAI,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAChD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACnB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,iBAAiB,EACjB,EAAE,QAAQ,EAAE,CACb,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,KAAK;gBAAE,MAAM,IAAI,qCAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAChE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAChE,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAClD,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO;iBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,SAAS,CAAC,OAItB;QACC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,IAAI,GAAG,CAAC,CAAC;QAEzD,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;QAC3E,MAAM,YAAY,GAChB,OAAO,EAAE,YAAY,IAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAY,CAAC;QAEvE,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACrD,MAAM,OAAO;iBACV,IAAI,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAChD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEnB,8EAA8E;YAC9E,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACjD,IAAI,aAAqD,CAAC;YAC1D,IAAI,CAAC;gBACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CACjC,kBAAkB,EAClB,EAAE,QAAQ,EAAE,CACb,CAAC;gBACF,aAAa,GAAG,IAAI,CAAC,aAA2C,CAAC;YACnE,CAAC;YAAC,MAAM,CAAC;gBACP,aAAa,GAAG,SAAS,CAAC;YAC5B,CAAC;YAED,MAAM,eAAe,GAAqC;gBACxD,QAAQ,EAAE,KAAK;gBACf,UAAU,EAAE,KAAK;gBACjB,UAAU,EAAE,KAAK;gBACjB,kBAAkB,EAAE,KAAK;gBACzB,WAAW;gBACX,YAAY;aACuB,CAAC;YAEtC,MAAM,aAAa,GAAG,KAAK,IAAI,EAAE;gBAC/B,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE;oBACjD,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;oBACrD,eAAe;iBAChB,CAAC,CAAC;YACL,CAAC,CAAC;YAEF,eAAe;YACf,MAAM,aAAa,EAAE,CAAC;YAEtB,oFAAoF;YACpF,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACjB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;gBACrE,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,QAAQ,EAAE,CAAC;oBACrC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;oBAC9C,IAAI,CAAC;wBACH,MAAM,aAAa,EAAE,CAAC;oBACxB,CAAC;oBAAC,MAAM,CAAC;wBACP,0BAA0B;oBAC5B,CAAC;gBACH,CAAC;gBACD,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,2EAA2E;YAC3E,MAAM,OAAO;iBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,OAAO;iBACV,IAAI,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAChD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEnB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,iBAAiB,EACjB,EAAE,QAAQ,EAAE,CACb,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,KAAK;gBAAE,MAAM,IAAI,qCAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAChE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAEhE,MAAM,OAAO,CAAC,IAAI,CAAQ,0BAA0B,EAAE;gBACpD,IAAI,EAAE,YAAY;gBAClB,CAAC,EAAE,EAAE;gBACL,CAAC,EAAE,EAAE;gBACL,MAAM,EAAE,MAAM;aAC6B,CAAC,CAAC;QACjD,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO;iBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,CAAC,OAGX;QACC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAE9C,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,MAAM,CAAC;QACzC,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,CAAC,CAAC;QAE5C,IAAI,CAAC;YACH,sEAAsE;YACtE,MAAM,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YAE/D,8BAA8B;YAC9B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,iBAAiB,EACjB,EAAE,QAAQ,EAAE,CACb,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,KAAK;gBAAE,MAAM,IAAI,qCAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAChE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAEhE,yEAAyE;YACzE,+CAA+C;YAC/C,MAAM,UAAU,GAA4B,EAAE,CAAC;YAC/C,UAAU,CAAC,IAAI,CACb,OAAO,CAAC,IAAI,CAAQ,0BAA0B,EAAE;gBAC9C,IAAI,EAAE,YAAY;gBAClB,CAAC,EAAE,EAAE;gBACL,CAAC,EAAE,EAAE;gBACL,MAAM,EAAE,MAAM;aAC6B,CAAC,CAC/C,CAAC;YAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrC,UAAU,CAAC,IAAI,CACb,OAAO,CAAC,IAAI,CAAQ,0BAA0B,EAAE;oBAC9C,IAAI,EAAE,cAAc;oBACpB,CAAC,EAAE,EAAE;oBACL,CAAC,EAAE,EAAE;oBACL,MAAM;oBACN,UAAU,EAAE,CAAC;iBAC8B,CAAC,CAC/C,CAAC;gBACF,UAAU,CAAC,IAAI,CACb,OAAO,CAAC,IAAI,CAAQ,0BAA0B,EAAE;oBAC9C,IAAI,EAAE,eAAe;oBACrB,CAAC,EAAE,EAAE;oBACL,CAAC,EAAE,EAAE;oBACL,MAAM;oBACN,UAAU,EAAE,CAAC;iBAC8B,CAAC,CAC/C,CAAC;YACJ,CAAC;YACD,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChC,CAAC;gBAAS,CAAC;YACT,6BAA6B;YAC7B,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YACnE,CAAC;YAAC,MAAM,CAAC;gBACP,wEAAwE;gBACxE,qEAAqE;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,OAKpB;QACC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC;QACzC,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC;QAC/C,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC;QAC3C,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,OAAO;iBACV,IAAI,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAChD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACnB,MAAM,OAAO,CAAC,IAAI,CAChB,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,gBAAgB;gBAC1D,SAAS,EAAE;oBACT;wBACE,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE;qBACjD;iBACF;gBACD,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO;iBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAwB;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAChB,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,sBAAsB;gBAChE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,OAA4B,EAAE,CAAC;gBACpD,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO;iBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,KAAa;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,mFAAmF;QACnF,MAAM,eAAe,GAAG,qBAAqB,oDAAsB,YAAY,qDAAuB,CAAC,gBAAgB,uBAAuB,CAAC;QAC/I,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAE9C,IAAI,aAAa,GAAG,IAAI,CAAC;QAEzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,eAAe;gBACpC,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;gBACtB,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YACF,IAAI,GAAG,CAAC,gBAAgB,EAAE,CAAC;gBACzB,yDAAyD;gBACzD,MAAM,OAAO,GACX,GAAG,CAAC,gBAAgB,CAAC,SAAS,EAAE,WAAW;oBAC3C,GAAG,CAAC,gBAAgB,CAAC,IAAI;oBACzB,2CAA2C,CAAC;gBAC9C,MAAM,IAAI,oCAAqB,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrE,CAAC;YAED,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,KAGb,CAAC;YACd,MAAM,MAAM,GACV,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;YAEnE,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,OAAO;YACT,CAAC;YAED,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;gBAC5B,qFAAqF;gBACrF,MAAM,OAAO;qBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;qBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACnB,aAAa,GAAG,KAAK,CAAC;gBAEtB,MAAM,WAAW,GACf,OAAO,MAAM,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;gBAE3D,IAAI,QAAQ,GAAG,KAAK,CAAC;gBACrB,IAAI,CAAC;oBACH,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;oBAC5D,IAAI,CAAC;wBACH,MAAM,OAAO,GACX,MAAM,OAAO,CAAC,IAAI,CAChB,wBAAwB,EACxB;4BACE,QAAQ,EAAE,YAAY;4BACtB,mBAAmB,EACjB,kDAAoB,CAAC,uBAAuB;4BAC9C,aAAa,EAAE,IAAI;yBACpB,CACF,CAAC;wBACJ,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC3C,CAAC;4BAAS,CAAC;wBACT,MAAM,OAAO;6BACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;6BAChE,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;oBACrB,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,sEAAsE;gBACxE,CAAC;gBAED,IAAI,CAAC,QAAQ,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxC,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;oBAC7B,OAAO;gBACT,CAAC;gBAED,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC7B,oEAAoE;oBACpE,MAAM,OAAO,CAAC,IAAI,CAAQ,wBAAwB,EAAE;wBAClD,IAAI,EAAE,SAAS;wBACf,GAAG,EAAE,WAAW;wBAChB,IAAI,EAAE,WAAW;wBACjB,qBAAqB,EAAE,CAAC;wBACxB,oBAAoB,EAAE,CAAC;qBACkB,CAAC,CAAC;oBAC7C,MAAM,OAAO,CAAC,IAAI,CAAQ,wBAAwB,EAAE;wBAClD,IAAI,EAAE,OAAO;wBACb,GAAG,EAAE,WAAW;wBAChB,IAAI,EAAE,WAAW;wBACjB,qBAAqB,EAAE,CAAC;wBACxB,oBAAoB,EAAE,CAAC;qBACkB,CAAC,CAAC;gBAC/C,CAAC;qBAAM,CAAC;oBACN,MAAM,OAAO,CAAC,IAAI,CAAQ,kBAAkB,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;gBACvE,CAAC;gBAED,OAAO;YACT,CAAC;YAED,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;gBACvB,MAAM,MAAM,GACV,OAAO,MAAM,EAAE,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;oBAC5D,CAAC,CAAC,MAAM,CAAC,MAAM;oBACf,CAAC,CAAC,wBAAwB,CAAC;gBAC/B,MAAM,IAAI,4CAA6B,CACrC,2BAA2B,MAAM,GAAG,CACrC,CAAC;YACJ,CAAC;YAED,8FAA8F;YAC9F,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,OAAO;qBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;qBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,OAA4B;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAE9C,IAAI,CAAC;YACH,4CAA4C;YAC5C,MAAM,OAAO,CAAC,IAAI,CAChB,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,YAAY;gBACtD,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YAEF,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;gBACpB,MAAM,OAAO,CAAC,IAAI,CAAQ,kBAAkB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;gBACxD,OAAO;YACT,CAAC;YAED,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;gBACtB,MAAM,OAAO,CAAC,IAAI,CAAQ,wBAAwB,EAAE;oBAClD,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,EAAE;oBACR,GAAG,EAAE,EAAE;iBACkC,CAAC,CAAC;gBAE7C,MAAM,OAAO,CAAC,IAAI,CAAQ,wBAAwB,EAAE;oBAClD,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,EAAE;oBACR,GAAG,EAAE,EAAE;iBACkC,CAAC,CAAC;gBAE7C,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,MAAyB;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,oBAAoB;gBAC9D,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;gBAC/B,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YAEF,OAAQ,GAAG,CAAC,MAAM,CAAC,KAAkB,IAAI,EAAE,CAAC;QAC9C,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,gBAAgB;gBAC1D,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YACF,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,gBAAgB;gBAC1D,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YACF,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,qBAAqB;gBAC/D,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YACF,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,sBAAsB;gBAChE,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YACF,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,oBAAoB;gBAC9D,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YACF,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,oBAAoB;gBAC9D,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YACF,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IAED,8EAA8E;IAC9E,GAAG,CAAC,KAAa;QACf,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,4CAA6B,CACrC,8CAA8C,CAC/C,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,SAAS,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACzE,CAAC;IAED,gCAAgC;IAEhC;;;OAGG;IACI,KAAK,CAAC,WAAW;QAItB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAEnC,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACrC,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEjC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;QACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,cAAc,CACzD,IAAI,CAAC,aAAa,EAClB,KAAK,CACN,CAAC;QACF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,4CAA6B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,mBAAmB;QAM9B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAEnC,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACrC,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEjC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,cAAc,CACzD,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,QAAQ,CACd,CAAC;YACF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,4CAA6B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5E,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrB,MAAM,IAAI,4CAA6B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,0DAA0D;IAClD,oBAAoB,CAAC,OAAiB;QAC5C,0CAA0C;QAC1C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,4CAA6B,CAAC,gCAAgC,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IACpB,CAAC;CACF;AA93BD,0BA83BC","sourcesContent":["// lib/v3/understudy/locator.ts\nimport { Protocol } from \"devtools-protocol\";\nimport * as fs from \"fs\";\nimport * as os from \"os\";\nimport * as path from \"path\";\nimport {\n  locatorScriptBootstrap,\n  locatorScriptGlobalRefs,\n  locatorScriptSources,\n} from \"../dom/build/locatorScripts.generated.js\";\nimport type { Frame } from \"./frame.js\";\nimport {\n  FrameSelectorResolver,\n  type SelectorQuery,\n} from \"./selectorResolver.js\";\nimport {\n  StagehandElementNotFoundError,\n  StagehandInvalidArgumentError,\n  StagehandLocatorError,\n  ElementNotVisibleError,\n} from \"../types/public/sdkErrors.js\";\nimport { normalizeInputFiles } from \"./fileUploadUtils.js\";\nimport { SetInputFilesArgument, MouseButton } from \"../types/public/locator.js\";\nimport { NormalizedFilePayload } from \"../types/private/locator.js\";\n\nconst MAX_REMOTE_UPLOAD_BYTES = 50 * 1024 * 1024; // 50MB guard copied from Playwright\n\n/**\n * Locator\n *\n * Purpose:\n * A small, CDP-based element interaction helper scoped to a specific `Frame`.\n * It resolves a CSS/XPath selector inside the frame’s **isolated world**, and then\n * performs low-level actions (click, type, select) using DOM/Runtime/Input\n * protocol domains with minimal abstraction.\n *\n * Key change:\n * - Prefer **objectId**-based CDP calls (scroll, geometry) to avoid brittle\n *   frontend nodeId mappings. nodeId is resolved on a best-effort basis and\n *   returned for compatibility, but actions do not depend on it.\n *\n * Notes:\n * - Resolution is lazy: every action resolves the selector again.\n * - Uses `Page.createIsolatedWorld` so evaluation is isolated from page scripts.\n * - Releases remote objects (`Runtime.releaseObject`) where appropriate.\n */\nexport class Locator {\n  private readonly selectorResolver: FrameSelectorResolver;\n\n  private readonly selectorQuery: SelectorQuery;\n\n  // -1 means \"no explicit nth()\"; default locator resolves to first match for actions.\n  private readonly nthIndex: number;\n\n  constructor(\n    private readonly frame: Frame,\n    private readonly selector: string,\n    private readonly options?: { deep?: boolean; depth?: number },\n    nthIndex: number = -1,\n  ) {\n    this.selectorResolver = new FrameSelectorResolver(this.frame);\n    this.selectorQuery = FrameSelectorResolver.parseSelector(selector);\n    const normalized = Number.isFinite(nthIndex) ? Math.floor(nthIndex) : -1;\n    this.nthIndex = normalized < 0 ? -1 : normalized;\n  }\n\n  /** Return the owning Frame for this locator (typed accessor, no private access). */\n  public getFrame(): Frame {\n    return this.frame;\n  }\n\n  /**\n   * Set files on an <input type=\"file\"> element.\n   *\n   * Mirrors Playwright's Locator.setInputFiles basics:\n   * - Accepts file path(s) or payload object(s) { name, mimeType, buffer }.\n   * - Uses CDP DOM.setFileInputFiles under the hood.\n   * - Best‑effort dispatches change/input via CDP (Chrome does by default).\n   * - Passing an empty array clears the selection.\n   */\n  public async setInputFiles(files: SetInputFilesArgument): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    const tempFiles: string[] = [];\n\n    try {\n      // Validate element is an <input type=\"file\">\n      try {\n        const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n          \"Runtime.callFunctionOn\",\n          {\n            objectId,\n            functionDeclaration: locatorScriptSources.ensureFileInputElement,\n            returnByValue: true,\n          },\n        );\n        const ok = Boolean(res.result.value);\n        if (!ok)\n          throw new StagehandInvalidArgumentError(\n            'Target is not an <input type=\"file\"> element',\n          );\n      } catch (e) {\n        throw new StagehandInvalidArgumentError(\n          e instanceof Error\n            ? e.message\n            : \"Unable to verify file input element\",\n        );\n      }\n\n      const normalized = await normalizeInputFiles(files);\n\n      if (!normalized.length) {\n        await session.send<never>(\"DOM.setFileInputFiles\", {\n          objectId,\n          files: [],\n        });\n        return;\n      }\n\n      if (this.frame.isBrowserRemote()) {\n        await this.assignFilesViaPayloadInjection(objectId, normalized);\n        return;\n      }\n\n      const filePaths: string[] = [];\n      for (const payload of normalized) {\n        if (payload.absolutePath) {\n          filePaths.push(payload.absolutePath);\n          continue;\n        }\n        const ext = path.extname(payload.name);\n        const tmp = path.join(\n          os.tmpdir(),\n          `stagehand-upload-${Date.now()}-${Math.random().toString(36).slice(2)}${ext}`,\n        );\n        await fs.promises.writeFile(tmp, payload.buffer);\n        tempFiles.push(tmp);\n        filePaths.push(tmp);\n      }\n\n      await session.send<never>(\"DOM.setFileInputFiles\", {\n        objectId,\n        files: filePaths,\n      });\n    } finally {\n      // Cleanup: release element and remove any temporary files we created\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n      for (const p of tempFiles) {\n        try {\n          await fs.promises.unlink(p);\n        } catch {\n          // ignore\n        }\n      }\n    }\n  }\n\n  /**\n   * Remote browser fallback: build File objects inside the page and attach them via JS.\n   *\n   * When Stagehand is driving a browser that cannot see the local filesystem (Browserbase,\n   * remote CDP, etc.), CDP's DOM.setFileInputFiles would fail because Chrome can't reach\n   * our temp files. Instead we base64-encode the payloads, send them into the page, and\n   * let a DOM helper create File objects + dispatch change/input events.\n   */\n  private async assignFilesViaPayloadInjection(\n    objectId: Protocol.Runtime.RemoteObjectId,\n    files: NormalizedFilePayload[],\n  ): Promise<void> {\n    const session = this.frame.session;\n\n    for (const payload of files) {\n      if (payload.buffer.length > MAX_REMOTE_UPLOAD_BYTES) {\n        throw new StagehandInvalidArgumentError(\n          `setInputFiles(): file \"${payload.name}\" is larger than the 50MB limit for remote uploads`,\n        );\n      }\n    }\n\n    const serialized = files.map((payload) => ({\n      name: payload.name,\n      mimeType: payload.mimeType,\n      lastModified: payload.lastModified,\n      base64: payload.buffer.toString(\"base64\"),\n    }));\n\n    const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n      \"Runtime.callFunctionOn\",\n      {\n        objectId,\n        functionDeclaration:\n          locatorScriptSources.assignFilePayloadsToInputElement,\n        arguments: [\n          {\n            value: serialized,\n          },\n        ],\n        returnByValue: true,\n      },\n    );\n\n    const ok = Boolean(res.result?.value);\n    if (!ok) {\n      throw new StagehandInvalidArgumentError(\n        \"Unable to assign file payloads to remote input element\",\n      );\n    }\n  }\n\n  /**\n   * Return the DOM backendNodeId for this locator's target element.\n   * Useful for identity comparisons without needing element handles.\n   */\n  async backendNodeId(): Promise<Protocol.DOM.BackendNodeId> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session.send(\"DOM.enable\").catch(() => {});\n      const { node } = await session.send<{ node: Protocol.DOM.Node }>(\n        \"DOM.describeNode\",\n        { objectId },\n      );\n      return node.backendNodeId as Protocol.DOM.BackendNodeId;\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /** Return how many nodes the current selector resolves to. */\n  public async count(): Promise<number> {\n    const session = this.frame.session;\n    await session.send(\"Runtime.enable\");\n    await session.send(\"DOM.enable\");\n    return this.selectorResolver.count(this.selectorQuery);\n  }\n\n  /**\n   * Return the center of the element's bounding box in the owning frame's viewport\n   * (CSS pixels), rounded to integers. Scrolls into view best-effort.\n   */\n  public async centroid(): Promise<{ x: number; y: number }> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n      return { x: Math.round(cx), y: Math.round(cy) };\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Highlight the element's bounding box using the CDP Overlay domain.\n   * - Scrolls element into view best-effort.\n   * - Shows a semi-transparent overlay briefly, then hides it.\n   */\n  public async highlight(options?: {\n    durationMs?: number;\n    borderColor?: { r: number; g: number; b: number; a?: number };\n    contentColor?: { r: number; g: number; b: number; a?: number };\n  }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    const duration = Math.max(0, options?.durationMs ?? 800);\n\n    const borderColor = options?.borderColor ?? { r: 255, g: 0, b: 0, a: 0.9 };\n    const contentColor =\n      options?.contentColor ?? ({ r: 255, g: 200, b: 0, a: 0.2 } as const);\n\n    try {\n      await session.send(\"Overlay.enable\").catch(() => {});\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n\n      // Prefer backendNodeId to keep highlight stable even if objectId is released.\n      await session.send(\"DOM.enable\").catch(() => {});\n      let backendNodeId: Protocol.DOM.BackendNodeId | undefined;\n      try {\n        const { node } = await session.send<{ node: Protocol.DOM.Node }>(\n          \"DOM.describeNode\",\n          { objectId },\n        );\n        backendNodeId = node.backendNodeId as Protocol.DOM.BackendNodeId;\n      } catch {\n        backendNodeId = undefined;\n      }\n\n      const highlightConfig: Protocol.Overlay.HighlightConfig = {\n        showInfo: false,\n        showStyles: false,\n        showRulers: false,\n        showExtensionLines: false,\n        borderColor,\n        contentColor,\n      } as Protocol.Overlay.HighlightConfig;\n\n      const highlightOnce = async () => {\n        await session.send<never>(\"Overlay.highlightNode\", {\n          ...(backendNodeId ? { backendNodeId } : { objectId }),\n          highlightConfig,\n        });\n      };\n\n      // Initial draw\n      await highlightOnce();\n\n      // Keep alive until duration elapses to resist overlay clears on mouse move/repaints\n      if (duration > 0) {\n        const start = Date.now();\n        const tick = Math.min(300, Math.max(100, Math.floor(duration / 50)));\n        while (Date.now() - start < duration) {\n          await new Promise((r) => setTimeout(r, tick));\n          try {\n            await highlightOnce();\n          } catch {\n            // ignore transient errors\n          }\n        }\n        await session.send<never>(\"Overlay.hideHighlight\").catch(() => {});\n      }\n    } finally {\n      // Releasing objectId should not affect highlight when using backendNodeId.\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Move the mouse cursor to the element's visual center without clicking.\n   * - Scrolls into view best-effort, resolves geometry, then dispatches a mouse move.\n   */\n  async hover(): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n\n      await session.send<never>(\"Input.dispatchMouseEvent\", {\n        type: \"mouseMoved\",\n        x: cx,\n        y: cy,\n        button: \"none\",\n      } as Protocol.Input.DispatchMouseEventRequest);\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Click the element at its visual center.\n   * Steps:\n   *  1) Resolve selector to { objectId } in the frame world.\n   *  2) Scroll into view via `DOM.scrollIntoViewIfNeeded({ objectId })`.\n   *  3) Read geometry via `DOM.getBoxModel({ objectId })` → compute a center point.\n   *  4) Synthesize mouse press + release via `Input.dispatchMouseEvent`.\n   */\n  async click(options?: {\n    button?: MouseButton;\n    clickCount?: number;\n  }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    const button = options?.button ?? \"left\";\n    const clickCount = options?.clickCount ?? 1;\n\n    try {\n      // Scroll into view using objectId (avoids frontend nodeId dependence)\n      await session.send(\"DOM.scrollIntoViewIfNeeded\", { objectId });\n\n      // Get geometry using objectId\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n\n      // Dispatch click events in a pipelined burst to reduce inter-click delay\n      // from network/CPU jitter between round trips.\n      const dispatches: Array<Promise<unknown>> = [];\n      dispatches.push(\n        session.send<never>(\"Input.dispatchMouseEvent\", {\n          type: \"mouseMoved\",\n          x: cx,\n          y: cy,\n          button: \"none\",\n        } as Protocol.Input.DispatchMouseEventRequest),\n      );\n\n      for (let i = 1; i <= clickCount; i++) {\n        dispatches.push(\n          session.send<never>(\"Input.dispatchMouseEvent\", {\n            type: \"mousePressed\",\n            x: cx,\n            y: cy,\n            button,\n            clickCount: i,\n          } as Protocol.Input.DispatchMouseEventRequest),\n        );\n        dispatches.push(\n          session.send<never>(\"Input.dispatchMouseEvent\", {\n            type: \"mouseReleased\",\n            x: cx,\n            y: cy,\n            button,\n            clickCount: i,\n          } as Protocol.Input.DispatchMouseEventRequest),\n        );\n      }\n      await Promise.all(dispatches);\n    } finally {\n      // release the element handle\n      try {\n        await session.send<never>(\"Runtime.releaseObject\", { objectId });\n      } catch {\n        // If the context navigated or was destroyed (e.g., link opens new tab),\n        // releaseObject may fail with -32000. Ignore as best-effort cleanup.\n      }\n    }\n  }\n\n  /**\n   * Dispatch a DOM 'click' MouseEvent on the element itself.\n   * - Does not synthesize real pointer input; directly dispatches an event.\n   * - Useful for elements that rely on click handlers without needing hit-testing.\n   */\n  async sendClickEvent(options?: {\n    bubbles?: boolean;\n    cancelable?: boolean;\n    composed?: boolean;\n    detail?: number;\n  }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    const bubbles = options?.bubbles ?? true;\n    const cancelable = options?.cancelable ?? true;\n    const composed = options?.composed ?? true;\n    const detail = options?.detail ?? 1;\n    try {\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n      await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.dispatchDomClick,\n          arguments: [\n            {\n              value: { bubbles, cancelable, composed, detail },\n            },\n          ],\n          returnByValue: true,\n        },\n      );\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Scroll the element vertically to a given percentage (0–100).\n   * - If the element is <html> or <body>, scrolls the window/document.\n   * - Otherwise, scrolls the element itself via element.scrollTo.\n   */\n  async scrollTo(percent: number | string): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.scrollElementToPercent,\n          arguments: [{ value: percent as unknown as number }],\n          returnByValue: true,\n        },\n      );\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Fill an input/textarea/contenteditable element.\n   * Mirrors Playwright semantics: the DOM helper either applies the native\n   * value setter (for special input types) or asks us to type text via the CDP\n   * Input domain after focusing/selecting.\n   */\n  async fill(value: string): Promise<void> {\n    const session = this.frame.session;\n    // Use the bundled locator globals; the raw fill snippet depends on helper symbols.\n    const fillDeclaration = `function(value) { ${locatorScriptBootstrap}; return ${locatorScriptGlobalRefs.fillElementValue}.call(this, value); }`;\n    const { objectId } = await this.resolveNode();\n\n    let releaseNeeded = true;\n\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: fillDeclaration,\n          arguments: [{ value }],\n          returnByValue: true,\n        },\n      );\n      if (res.exceptionDetails) {\n        // prefer exception.description over text (eg \"Uncaught\")\n        const message =\n          res.exceptionDetails.exception?.description ??\n          res.exceptionDetails.text ??\n          \"Unknown exception during locator().fill()\";\n        throw new StagehandLocatorError(\"Filling\", this.selector, message);\n      }\n\n      const result = res.result.value as\n        | { status?: string; reason?: string; value?: string }\n        | null\n        | undefined;\n      const status =\n        typeof result === \"object\" && result ? result.status : undefined;\n\n      if (status === \"done\") {\n        return;\n      }\n\n      if (status === \"needsinput\") {\n        // Release the current handle before synthesizing keyboard input to avoid leaking it.\n        await session\n          .send<never>(\"Runtime.releaseObject\", { objectId })\n          .catch(() => {});\n        releaseNeeded = false;\n\n        const valueToType =\n          typeof result?.value === \"string\" ? result.value : value;\n\n        let prepared = false;\n        try {\n          const { objectId: prepObjectId } = await this.resolveNode();\n          try {\n            const prepRes =\n              await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n                \"Runtime.callFunctionOn\",\n                {\n                  objectId: prepObjectId,\n                  functionDeclaration:\n                    locatorScriptSources.prepareElementForTyping,\n                  returnByValue: true,\n                },\n              );\n            prepared = Boolean(prepRes.result.value);\n          } finally {\n            await session\n              .send<never>(\"Runtime.releaseObject\", { objectId: prepObjectId })\n              .catch(() => {});\n          }\n        } catch {\n          // Ignore preparation failures; we'll fall back to typing best-effort.\n        }\n\n        if (!prepared && valueToType.length > 0) {\n          await this.type(valueToType);\n          return;\n        }\n\n        if (valueToType.length === 0) {\n          // Simulate deleting the currently selected text to clear the field.\n          await session.send<never>(\"Input.dispatchKeyEvent\", {\n            type: \"keyDown\",\n            key: \"Backspace\",\n            code: \"Backspace\",\n            windowsVirtualKeyCode: 8,\n            nativeVirtualKeyCode: 8,\n          } as Protocol.Input.DispatchKeyEventRequest);\n          await session.send<never>(\"Input.dispatchKeyEvent\", {\n            type: \"keyUp\",\n            key: \"Backspace\",\n            code: \"Backspace\",\n            windowsVirtualKeyCode: 8,\n            nativeVirtualKeyCode: 8,\n          } as Protocol.Input.DispatchKeyEventRequest);\n        } else {\n          await session.send<never>(\"Input.insertText\", { text: valueToType });\n        }\n\n        return;\n      }\n\n      if (status === \"error\") {\n        const reason =\n          typeof result?.reason === \"string\" && result.reason.length > 0\n            ? result.reason\n            : \"Failed to fill element\";\n        throw new StagehandInvalidArgumentError(\n          `Failed to fill element (${reason})`,\n        );\n      }\n\n      // Backward compatibility: if no status is returned (older bundle), fall back to setter logic.\n      if (!status) {\n        await this.type(value);\n      }\n    } finally {\n      if (releaseNeeded) {\n        await session\n          .send<never>(\"Runtime.releaseObject\", { objectId })\n          .catch(() => {});\n      }\n    }\n  }\n\n  /**\n   * Type text into the element (focuses first).\n   * - Focus via element.focus() in page JS (no DOM.focus(nodeId)).\n   * - If no delay, uses `Input.insertText` for efficiency.\n   * - With delay, synthesizes `keyDown`/`keyUp` per character.\n   */\n  async type(text: string, options?: { delay?: number }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    try {\n      // Focus using JS (avoids DOM.focus(nodeId))\n      await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.focusElement,\n          returnByValue: true,\n        },\n      );\n\n      if (!options?.delay) {\n        await session.send<never>(\"Input.insertText\", { text });\n        return;\n      }\n\n      for (const ch of text) {\n        await session.send<never>(\"Input.dispatchKeyEvent\", {\n          type: \"keyDown\",\n          text: ch,\n          key: ch,\n        } as Protocol.Input.DispatchKeyEventRequest);\n\n        await session.send<never>(\"Input.dispatchKeyEvent\", {\n          type: \"keyUp\",\n          text: ch,\n          key: ch,\n        } as Protocol.Input.DispatchKeyEventRequest);\n\n        await new Promise((r) => setTimeout(r, options.delay));\n      }\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Select one or more options on a `<select>` element.\n   * Returns the values actually selected after the operation.\n   */\n  async selectOption(values: string | string[]): Promise<string[]> {\n    const session = this.frame.session;\n    const desired = Array.isArray(values) ? values : [values];\n    const { objectId } = await this.resolveNode();\n\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.selectElementOptions,\n          arguments: [{ value: desired }],\n          returnByValue: true,\n        },\n      );\n\n      return (res.result.value as string[]) ?? [];\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return true if the element is attached and visible (rough heuristic).\n   */\n  async isVisible(): Promise<boolean> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.isElementVisible,\n          returnByValue: true,\n        },\n      );\n      return Boolean(res.result.value);\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return true if the element is an input[type=checkbox|radio] and is checked.\n   * Also considers aria-checked for ARIA widgets.\n   */\n  async isChecked(): Promise<boolean> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.isElementChecked,\n          returnByValue: true,\n        },\n      );\n      return Boolean(res.result.value);\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's input value (for input/textarea/select/contenteditable).\n   */\n  async inputValue(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementInputValue,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's textContent (raw, not innerText).\n   */\n  async textContent(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementTextContent,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's innerHTML string.\n   */\n  async innerHtml(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementInnerHTML,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's innerText (layout-aware, visible text).\n   */\n  async innerText(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementInnerText,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return a locator narrowed to the first match.\n   */\n  first(): Locator {\n    return this.nth(0);\n  }\n\n  /** Return a locator narrowed to the element at the given zero-based index. */\n  nth(index: number): Locator {\n    const value = Number(index);\n    if (!Number.isFinite(value) || value < 0) {\n      throw new StagehandInvalidArgumentError(\n        \"locator().nth() expects a non-negative index\",\n      );\n    }\n\n    const nextIndex = Math.floor(value);\n    if (nextIndex === this.nthIndex) {\n      return this;\n    }\n\n    return new Locator(this.frame, this.selector, this.options, nextIndex);\n  }\n\n  // ---------- helpers ----------\n\n  /**\n   * Resolve `this.selector` within the frame to `{ objectId, nodeId? }`:\n   * Delegates to a shared selector resolver so all selector logic stays in sync.\n   */\n  public async resolveNode(): Promise<{\n    nodeId: Protocol.DOM.NodeId | null;\n    objectId: Protocol.Runtime.RemoteObjectId;\n  }> {\n    const session = this.frame.session;\n\n    await session.send(\"Runtime.enable\");\n    await session.send(\"DOM.enable\");\n\n    const index = this.nthIndex < 0 ? 0 : this.nthIndex;\n    const resolved = await this.selectorResolver.resolveAtIndex(\n      this.selectorQuery,\n      index,\n    );\n    if (!resolved) {\n      throw new StagehandElementNotFoundError([this.selector]);\n    }\n\n    return resolved;\n  }\n\n  /**\n   * Resolve all matching nodes for this locator.\n   * If the locator is narrowed via nth(), only that index is returned.\n   */\n  public async resolveNodesForMask(): Promise<\n    Array<{\n      nodeId: Protocol.DOM.NodeId | null;\n      objectId: Protocol.Runtime.RemoteObjectId;\n    }>\n  > {\n    const session = this.frame.session;\n\n    await session.send(\"Runtime.enable\");\n    await session.send(\"DOM.enable\");\n\n    if (this.nthIndex >= 0) {\n      const resolved = await this.selectorResolver.resolveAtIndex(\n        this.selectorQuery,\n        this.nthIndex,\n      );\n      if (!resolved) {\n        throw new StagehandElementNotFoundError([this.selector]);\n      }\n      return [resolved];\n    }\n\n    const resolved = await this.selectorResolver.resolveAll(this.selectorQuery);\n    if (!resolved.length) {\n      throw new StagehandElementNotFoundError([this.selector]);\n    }\n    return resolved;\n  }\n\n  /** Compute a center point from a BoxModel content quad */\n  private centerFromBoxContent(content: number[]): { cx: number; cy: number } {\n    // content is [x1,y1, x2,y2, x3,y3, x4,y4]\n    if (!content || content.length < 8) {\n      throw new StagehandInvalidArgumentError(\"Invalid box model content quad\");\n    }\n    const xs = [content[0], content[2], content[4], content[6]];\n    const ys = [content[1], content[3], content[5], content[7]];\n    const cx = (xs[0] + xs[1] + xs[2] + xs[3]) / 4;\n    const cy = (ys[0] + ys[1] + ys[2] + ys[3]) / 4;\n    return { cx, cy };\n  }\n}\n"]}
+{"version":3,"file":"locator.js","sourceRoot":"","sources":["../../../../../lib/v3/understudy/locator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,uCAAyB;AACzB,uCAAyB;AACzB,2CAA6B;AAC7B,0FAIkD;AAElD,+DAG+B;AAC/B,+DAKsC;AACtC,6DAA2D;AAI3D,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,oCAAoC;AAEtF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,OAAO;IASC;IACA;IACA;IAVF,gBAAgB,CAAwB;IAExC,aAAa,CAAgB;IAE9C,qFAAqF;IACpE,QAAQ,CAAS;IAElC,YACmB,KAAY,EACZ,QAAgB,EAChB,OAA4C,EAC7D,WAAmB,CAAC,CAAC;QAHJ,UAAK,GAAL,KAAK,CAAO;QACZ,aAAQ,GAAR,QAAQ,CAAQ;QAChB,YAAO,GAAP,OAAO,CAAqC;QAG7D,IAAI,CAAC,gBAAgB,GAAG,IAAI,2CAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9D,IAAI,CAAC,aAAa,GAAG,2CAAqB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACnE,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,QAAQ,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IACnD,CAAC;IAED,oFAAoF;IAC7E,QAAQ;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;;;;;OAQG;IACI,KAAK,CAAC,aAAa,CAAC,KAA4B;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAE9C,MAAM,SAAS,GAAa,EAAE,CAAC;QAE/B,IAAI,CAAC;YACH,6CAA6C;YAC7C,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;oBACE,QAAQ;oBACR,mBAAmB,EAAE,kDAAoB,CAAC,sBAAsB;oBAChE,aAAa,EAAE,IAAI;iBACpB,CACF,CAAC;gBACF,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACrC,IAAI,CAAC,EAAE;oBACL,MAAM,IAAI,4CAA6B,CACrC,8CAA8C,CAC/C,CAAC;YACN,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,4CAA6B,CACrC,CAAC,YAAY,KAAK;oBAChB,CAAC,CAAC,CAAC,CAAC,OAAO;oBACX,CAAC,CAAC,qCAAqC,CAC1C,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,IAAA,wCAAmB,EAAC,KAAK,CAAC,CAAC;YAEpD,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;gBACvB,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE;oBACjD,QAAQ;oBACR,KAAK,EAAE,EAAE;iBACV,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,IAAI,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,CAAC;gBACjC,MAAM,IAAI,CAAC,8BAA8B,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;gBAChE,OAAO;YACT,CAAC;YAED,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;gBACjC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;oBACzB,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;oBACrC,SAAS;gBACX,CAAC;gBACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACvC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CACnB,EAAE,CAAC,MAAM,EAAE,EACX,oBAAoB,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAC9E,CAAC;gBACF,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBACjD,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpB,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;YAED,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE;gBACjD,QAAQ;gBACR,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,qEAAqE;YACrE,MAAM,OAAO;iBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACnB,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC;oBACH,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC9B,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,8BAA8B,CAC1C,QAAyC,EACzC,KAA8B;QAE9B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAEnC,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;YAC5B,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,uBAAuB,EAAE,CAAC;gBACpD,MAAM,IAAI,4CAA6B,CACrC,0BAA0B,OAAO,CAAC,IAAI,oDAAoD,CAC3F,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;SAC1C,CAAC,CAAC,CAAC;QAEJ,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;YACE,QAAQ;YACR,mBAAmB,EACjB,kDAAoB,CAAC,gCAAgC;YACvD,SAAS,EAAE;gBACT;oBACE,KAAK,EAAE,UAAU;iBAClB;aACF;YACD,aAAa,EAAE,IAAI;SACpB,CACF,CAAC;QAEF,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,4CAA6B,CACrC,wDAAwD,CACzD,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACjD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CACjC,kBAAkB,EAClB,EAAE,QAAQ,EAAE,CACb,CAAC;YACF,OAAO,IAAI,CAAC,aAA2C,CAAC;QAC1D,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO;iBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,8DAA8D;IACvD,KAAK,CAAC,KAAK;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACrC,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACzD,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,QAAQ;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,OAAO;iBACV,IAAI,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAChD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACnB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,iBAAiB,EACjB,EAAE,QAAQ,EAAE,CACb,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,KAAK;gBAAE,MAAM,IAAI,qCAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAChE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAChE,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAClD,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO;iBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,SAAS,CAAC,OAItB;QACC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,IAAI,GAAG,CAAC,CAAC;QAEzD,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;QAC3E,MAAM,YAAY,GAChB,OAAO,EAAE,YAAY,IAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAY,CAAC;QAEvE,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACrD,MAAM,OAAO;iBACV,IAAI,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAChD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEnB,8EAA8E;YAC9E,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACjD,IAAI,aAAqD,CAAC;YAC1D,IAAI,CAAC;gBACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CACjC,kBAAkB,EAClB,EAAE,QAAQ,EAAE,CACb,CAAC;gBACF,aAAa,GAAG,IAAI,CAAC,aAA2C,CAAC;YACnE,CAAC;YAAC,MAAM,CAAC;gBACP,aAAa,GAAG,SAAS,CAAC;YAC5B,CAAC;YAED,MAAM,eAAe,GAAqC;gBACxD,QAAQ,EAAE,KAAK;gBACf,UAAU,EAAE,KAAK;gBACjB,UAAU,EAAE,KAAK;gBACjB,kBAAkB,EAAE,KAAK;gBACzB,WAAW;gBACX,YAAY;aACuB,CAAC;YAEtC,MAAM,aAAa,GAAG,KAAK,IAAI,EAAE;gBAC/B,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE;oBACjD,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;oBACrD,eAAe;iBAChB,CAAC,CAAC;YACL,CAAC,CAAC;YAEF,eAAe;YACf,MAAM,aAAa,EAAE,CAAC;YAEtB,oFAAoF;YACpF,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACjB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;gBACrE,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,QAAQ,EAAE,CAAC;oBACrC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;oBAC9C,IAAI,CAAC;wBACH,MAAM,aAAa,EAAE,CAAC;oBACxB,CAAC;oBAAC,MAAM,CAAC;wBACP,0BAA0B;oBAC5B,CAAC;gBACH,CAAC;gBACD,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,2EAA2E;YAC3E,MAAM,OAAO;iBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,OAAO;iBACV,IAAI,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAChD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEnB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,iBAAiB,EACjB,EAAE,QAAQ,EAAE,CACb,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,KAAK;gBAAE,MAAM,IAAI,qCAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAChE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAEhE,MAAM,OAAO,CAAC,IAAI,CAAQ,0BAA0B,EAAE;gBACpD,IAAI,EAAE,YAAY;gBAClB,CAAC,EAAE,EAAE;gBACL,CAAC,EAAE,EAAE;gBACL,MAAM,EAAE,MAAM;aAC6B,CAAC,CAAC;QACjD,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO;iBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,CAAC,OAGX;QACC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAE9C,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,MAAM,CAAC;QACzC,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,CAAC,CAAC;QAE5C,IAAI,CAAC;YACH,sEAAsE;YACtE,MAAM,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YAE/D,8BAA8B;YAC9B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,iBAAiB,EACjB,EAAE,QAAQ,EAAE,CACb,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,KAAK;gBAAE,MAAM,IAAI,qCAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAChE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAEhE,yEAAyE;YACzE,+CAA+C;YAC/C,MAAM,UAAU,GAA4B,EAAE,CAAC;YAC/C,UAAU,CAAC,IAAI,CACb,OAAO,CAAC,IAAI,CAAQ,0BAA0B,EAAE;gBAC9C,IAAI,EAAE,YAAY;gBAClB,CAAC,EAAE,EAAE;gBACL,CAAC,EAAE,EAAE;gBACL,MAAM,EAAE,MAAM;aAC6B,CAAC,CAC/C,CAAC;YAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrC,UAAU,CAAC,IAAI,CACb,OAAO,CAAC,IAAI,CAAQ,0BAA0B,EAAE;oBAC9C,IAAI,EAAE,cAAc;oBACpB,CAAC,EAAE,EAAE;oBACL,CAAC,EAAE,EAAE;oBACL,MAAM;oBACN,UAAU,EAAE,CAAC;iBAC8B,CAAC,CAC/C,CAAC;gBACF,UAAU,CAAC,IAAI,CACb,OAAO,CAAC,IAAI,CAAQ,0BAA0B,EAAE;oBAC9C,IAAI,EAAE,eAAe;oBACrB,CAAC,EAAE,EAAE;oBACL,CAAC,EAAE,EAAE;oBACL,MAAM;oBACN,UAAU,EAAE,CAAC;iBAC8B,CAAC,CAC/C,CAAC;YACJ,CAAC;YACD,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChC,CAAC;gBAAS,CAAC;YACT,6BAA6B;YAC7B,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YACnE,CAAC;YAAC,MAAM,CAAC;gBACP,wEAAwE;gBACxE,qEAAqE;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,GAAG;QACP,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YAE/D,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,iBAAiB,EACjB,EAAE,QAAQ,EAAE,CACb,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,KAAK;gBAAE,MAAM,IAAI,qCAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAChE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAEhE,0EAA0E;YAC1E,0EAA0E;YAC1E,kEAAkE;YAClE,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAQ,0BAA0B,EAAE;oBAC9C,IAAI,EAAE,YAAY;oBAClB,WAAW,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;iBACY,CAAC;gBAC9C,OAAO,CAAC,IAAI,CAAQ,0BAA0B,EAAE;oBAC9C,IAAI,EAAE,UAAU;oBAChB,WAAW,EAAE,EAAE;iBAC4B,CAAC;aAC/C,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YACnE,CAAC;YAAC,MAAM,CAAC;gBACP,wEAAwE;gBACxE,qEAAqE;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,OAKpB;QACC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC;QACzC,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC;QAC/C,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC;QAC3C,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,OAAO;iBACV,IAAI,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAChD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACnB,MAAM,OAAO,CAAC,IAAI,CAChB,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,gBAAgB;gBAC1D,SAAS,EAAE;oBACT;wBACE,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE;qBACjD;iBACF;gBACD,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO;iBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAwB;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAChB,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,sBAAsB;gBAChE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,OAA4B,EAAE,CAAC;gBACpD,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO;iBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;iBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,KAAa;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,mFAAmF;QACnF,MAAM,eAAe,GAAG,qBAAqB,oDAAsB,YAAY,qDAAuB,CAAC,gBAAgB,uBAAuB,CAAC;QAC/I,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAE9C,IAAI,aAAa,GAAG,IAAI,CAAC;QAEzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,eAAe;gBACpC,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;gBACtB,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YACF,IAAI,GAAG,CAAC,gBAAgB,EAAE,CAAC;gBACzB,yDAAyD;gBACzD,MAAM,OAAO,GACX,GAAG,CAAC,gBAAgB,CAAC,SAAS,EAAE,WAAW;oBAC3C,GAAG,CAAC,gBAAgB,CAAC,IAAI;oBACzB,2CAA2C,CAAC;gBAC9C,MAAM,IAAI,oCAAqB,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrE,CAAC;YAED,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,KAGb,CAAC;YACd,MAAM,MAAM,GACV,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;YAEnE,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,OAAO;YACT,CAAC;YAED,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;gBAC5B,qFAAqF;gBACrF,MAAM,OAAO;qBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;qBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACnB,aAAa,GAAG,KAAK,CAAC;gBAEtB,MAAM,WAAW,GACf,OAAO,MAAM,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;gBAE3D,IAAI,QAAQ,GAAG,KAAK,CAAC;gBACrB,IAAI,CAAC;oBACH,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;oBAC5D,IAAI,CAAC;wBACH,MAAM,OAAO,GACX,MAAM,OAAO,CAAC,IAAI,CAChB,wBAAwB,EACxB;4BACE,QAAQ,EAAE,YAAY;4BACtB,mBAAmB,EACjB,kDAAoB,CAAC,uBAAuB;4BAC9C,aAAa,EAAE,IAAI;yBACpB,CACF,CAAC;wBACJ,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC3C,CAAC;4BAAS,CAAC;wBACT,MAAM,OAAO;6BACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;6BAChE,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;oBACrB,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,sEAAsE;gBACxE,CAAC;gBAED,IAAI,CAAC,QAAQ,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxC,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;oBAC7B,OAAO;gBACT,CAAC;gBAED,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC7B,oEAAoE;oBACpE,MAAM,OAAO,CAAC,IAAI,CAAQ,wBAAwB,EAAE;wBAClD,IAAI,EAAE,SAAS;wBACf,GAAG,EAAE,WAAW;wBAChB,IAAI,EAAE,WAAW;wBACjB,qBAAqB,EAAE,CAAC;wBACxB,oBAAoB,EAAE,CAAC;qBACkB,CAAC,CAAC;oBAC7C,MAAM,OAAO,CAAC,IAAI,CAAQ,wBAAwB,EAAE;wBAClD,IAAI,EAAE,OAAO;wBACb,GAAG,EAAE,WAAW;wBAChB,IAAI,EAAE,WAAW;wBACjB,qBAAqB,EAAE,CAAC;wBACxB,oBAAoB,EAAE,CAAC;qBACkB,CAAC,CAAC;gBAC/C,CAAC;qBAAM,CAAC;oBACN,MAAM,OAAO,CAAC,IAAI,CAAQ,kBAAkB,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;gBACvE,CAAC;gBAED,OAAO;YACT,CAAC;YAED,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;gBACvB,MAAM,MAAM,GACV,OAAO,MAAM,EAAE,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;oBAC5D,CAAC,CAAC,MAAM,CAAC,MAAM;oBACf,CAAC,CAAC,wBAAwB,CAAC;gBAC/B,MAAM,IAAI,4CAA6B,CACrC,2BAA2B,MAAM,GAAG,CACrC,CAAC;YACJ,CAAC;YAED,8FAA8F;YAC9F,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,OAAO;qBACV,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;qBAClD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,OAA4B;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAE9C,IAAI,CAAC;YACH,4CAA4C;YAC5C,MAAM,OAAO,CAAC,IAAI,CAChB,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,YAAY;gBACtD,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YAEF,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;gBACpB,MAAM,OAAO,CAAC,IAAI,CAAQ,kBAAkB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;gBACxD,OAAO;YACT,CAAC;YAED,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;gBACtB,MAAM,OAAO,CAAC,IAAI,CAAQ,wBAAwB,EAAE;oBAClD,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,EAAE;oBACR,GAAG,EAAE,EAAE;iBACkC,CAAC,CAAC;gBAE7C,MAAM,OAAO,CAAC,IAAI,CAAQ,wBAAwB,EAAE;oBAClD,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,EAAE;oBACR,GAAG,EAAE,EAAE;iBACkC,CAAC,CAAC;gBAE7C,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,MAAyB;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,oBAAoB;gBAC9D,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;gBAC/B,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YAEF,OAAQ,GAAG,CAAC,MAAM,CAAC,KAAkB,IAAI,EAAE,CAAC;QAC9C,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,gBAAgB;gBAC1D,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YACF,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,gBAAgB;gBAC1D,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YACF,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,qBAAqB;gBAC/D,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YACF,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,sBAAsB;gBAChE,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YACF,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,oBAAoB;gBAC9D,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YACF,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC5B,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,kDAAoB,CAAC,oBAAoB;gBAC9D,aAAa,EAAE,IAAI;aACpB,CACF,CAAC;YACF,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,IAAI,CAAQ,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IAED,8EAA8E;IAC9E,GAAG,CAAC,KAAa;QACf,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,4CAA6B,CACrC,8CAA8C,CAC/C,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,SAAS,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACzE,CAAC;IAED,gCAAgC;IAEhC;;;OAGG;IACI,KAAK,CAAC,WAAW;QAItB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAEnC,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACrC,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEjC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;QACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,cAAc,CACzD,IAAI,CAAC,aAAa,EAClB,KAAK,CACN,CAAC;QACF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,4CAA6B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,mBAAmB;QAM9B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAEnC,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACrC,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEjC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,cAAc,CACzD,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,QAAQ,CACd,CAAC;YACF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,4CAA6B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5E,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrB,MAAM,IAAI,4CAA6B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,0DAA0D;IAClD,oBAAoB,CAAC,OAAiB;QAC5C,0CAA0C;QAC1C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,4CAA6B,CAAC,gCAAgC,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IACpB,CAAC;CACF;AA96BD,0BA86BC","sourcesContent":["// lib/v3/understudy/locator.ts\nimport { Protocol } from \"devtools-protocol\";\nimport * as fs from \"fs\";\nimport * as os from \"os\";\nimport * as path from \"path\";\nimport {\n  locatorScriptBootstrap,\n  locatorScriptGlobalRefs,\n  locatorScriptSources,\n} from \"../dom/build/locatorScripts.generated.js\";\nimport type { Frame } from \"./frame.js\";\nimport {\n  FrameSelectorResolver,\n  type SelectorQuery,\n} from \"./selectorResolver.js\";\nimport {\n  StagehandElementNotFoundError,\n  StagehandInvalidArgumentError,\n  StagehandLocatorError,\n  ElementNotVisibleError,\n} from \"../types/public/sdkErrors.js\";\nimport { normalizeInputFiles } from \"./fileUploadUtils.js\";\nimport { SetInputFilesArgument, MouseButton } from \"../types/public/locator.js\";\nimport { NormalizedFilePayload } from \"../types/private/locator.js\";\n\nconst MAX_REMOTE_UPLOAD_BYTES = 50 * 1024 * 1024; // 50MB guard copied from Playwright\n\n/**\n * Locator\n *\n * Purpose:\n * A small, CDP-based element interaction helper scoped to a specific `Frame`.\n * It resolves a CSS/XPath selector inside the frame’s **isolated world**, and then\n * performs low-level actions (click, type, select) using DOM/Runtime/Input\n * protocol domains with minimal abstraction.\n *\n * Key change:\n * - Prefer **objectId**-based CDP calls (scroll, geometry) to avoid brittle\n *   frontend nodeId mappings. nodeId is resolved on a best-effort basis and\n *   returned for compatibility, but actions do not depend on it.\n *\n * Notes:\n * - Resolution is lazy: every action resolves the selector again.\n * - Uses `Page.createIsolatedWorld` so evaluation is isolated from page scripts.\n * - Releases remote objects (`Runtime.releaseObject`) where appropriate.\n */\nexport class Locator {\n  private readonly selectorResolver: FrameSelectorResolver;\n\n  private readonly selectorQuery: SelectorQuery;\n\n  // -1 means \"no explicit nth()\"; default locator resolves to first match for actions.\n  private readonly nthIndex: number;\n\n  constructor(\n    private readonly frame: Frame,\n    private readonly selector: string,\n    private readonly options?: { deep?: boolean; depth?: number },\n    nthIndex: number = -1,\n  ) {\n    this.selectorResolver = new FrameSelectorResolver(this.frame);\n    this.selectorQuery = FrameSelectorResolver.parseSelector(selector);\n    const normalized = Number.isFinite(nthIndex) ? Math.floor(nthIndex) : -1;\n    this.nthIndex = normalized < 0 ? -1 : normalized;\n  }\n\n  /** Return the owning Frame for this locator (typed accessor, no private access). */\n  public getFrame(): Frame {\n    return this.frame;\n  }\n\n  /**\n   * Set files on an <input type=\"file\"> element.\n   *\n   * Mirrors Playwright's Locator.setInputFiles basics:\n   * - Accepts file path(s) or payload object(s) { name, mimeType, buffer }.\n   * - Uses CDP DOM.setFileInputFiles under the hood.\n   * - Best‑effort dispatches change/input via CDP (Chrome does by default).\n   * - Passing an empty array clears the selection.\n   */\n  public async setInputFiles(files: SetInputFilesArgument): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    const tempFiles: string[] = [];\n\n    try {\n      // Validate element is an <input type=\"file\">\n      try {\n        const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n          \"Runtime.callFunctionOn\",\n          {\n            objectId,\n            functionDeclaration: locatorScriptSources.ensureFileInputElement,\n            returnByValue: true,\n          },\n        );\n        const ok = Boolean(res.result.value);\n        if (!ok)\n          throw new StagehandInvalidArgumentError(\n            'Target is not an <input type=\"file\"> element',\n          );\n      } catch (e) {\n        throw new StagehandInvalidArgumentError(\n          e instanceof Error\n            ? e.message\n            : \"Unable to verify file input element\",\n        );\n      }\n\n      const normalized = await normalizeInputFiles(files);\n\n      if (!normalized.length) {\n        await session.send<never>(\"DOM.setFileInputFiles\", {\n          objectId,\n          files: [],\n        });\n        return;\n      }\n\n      if (this.frame.isBrowserRemote()) {\n        await this.assignFilesViaPayloadInjection(objectId, normalized);\n        return;\n      }\n\n      const filePaths: string[] = [];\n      for (const payload of normalized) {\n        if (payload.absolutePath) {\n          filePaths.push(payload.absolutePath);\n          continue;\n        }\n        const ext = path.extname(payload.name);\n        const tmp = path.join(\n          os.tmpdir(),\n          `stagehand-upload-${Date.now()}-${Math.random().toString(36).slice(2)}${ext}`,\n        );\n        await fs.promises.writeFile(tmp, payload.buffer);\n        tempFiles.push(tmp);\n        filePaths.push(tmp);\n      }\n\n      await session.send<never>(\"DOM.setFileInputFiles\", {\n        objectId,\n        files: filePaths,\n      });\n    } finally {\n      // Cleanup: release element and remove any temporary files we created\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n      for (const p of tempFiles) {\n        try {\n          await fs.promises.unlink(p);\n        } catch {\n          // ignore\n        }\n      }\n    }\n  }\n\n  /**\n   * Remote browser fallback: build File objects inside the page and attach them via JS.\n   *\n   * When Stagehand is driving a browser that cannot see the local filesystem (Browserbase,\n   * remote CDP, etc.), CDP's DOM.setFileInputFiles would fail because Chrome can't reach\n   * our temp files. Instead we base64-encode the payloads, send them into the page, and\n   * let a DOM helper create File objects + dispatch change/input events.\n   */\n  private async assignFilesViaPayloadInjection(\n    objectId: Protocol.Runtime.RemoteObjectId,\n    files: NormalizedFilePayload[],\n  ): Promise<void> {\n    const session = this.frame.session;\n\n    for (const payload of files) {\n      if (payload.buffer.length > MAX_REMOTE_UPLOAD_BYTES) {\n        throw new StagehandInvalidArgumentError(\n          `setInputFiles(): file \"${payload.name}\" is larger than the 50MB limit for remote uploads`,\n        );\n      }\n    }\n\n    const serialized = files.map((payload) => ({\n      name: payload.name,\n      mimeType: payload.mimeType,\n      lastModified: payload.lastModified,\n      base64: payload.buffer.toString(\"base64\"),\n    }));\n\n    const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n      \"Runtime.callFunctionOn\",\n      {\n        objectId,\n        functionDeclaration:\n          locatorScriptSources.assignFilePayloadsToInputElement,\n        arguments: [\n          {\n            value: serialized,\n          },\n        ],\n        returnByValue: true,\n      },\n    );\n\n    const ok = Boolean(res.result?.value);\n    if (!ok) {\n      throw new StagehandInvalidArgumentError(\n        \"Unable to assign file payloads to remote input element\",\n      );\n    }\n  }\n\n  /**\n   * Return the DOM backendNodeId for this locator's target element.\n   * Useful for identity comparisons without needing element handles.\n   */\n  async backendNodeId(): Promise<Protocol.DOM.BackendNodeId> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session.send(\"DOM.enable\").catch(() => {});\n      const { node } = await session.send<{ node: Protocol.DOM.Node }>(\n        \"DOM.describeNode\",\n        { objectId },\n      );\n      return node.backendNodeId as Protocol.DOM.BackendNodeId;\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /** Return how many nodes the current selector resolves to. */\n  public async count(): Promise<number> {\n    const session = this.frame.session;\n    await session.send(\"Runtime.enable\");\n    await session.send(\"DOM.enable\");\n    return this.selectorResolver.count(this.selectorQuery);\n  }\n\n  /**\n   * Return the center of the element's bounding box in the owning frame's viewport\n   * (CSS pixels), rounded to integers. Scrolls into view best-effort.\n   */\n  public async centroid(): Promise<{ x: number; y: number }> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n      return { x: Math.round(cx), y: Math.round(cy) };\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Highlight the element's bounding box using the CDP Overlay domain.\n   * - Scrolls element into view best-effort.\n   * - Shows a semi-transparent overlay briefly, then hides it.\n   */\n  public async highlight(options?: {\n    durationMs?: number;\n    borderColor?: { r: number; g: number; b: number; a?: number };\n    contentColor?: { r: number; g: number; b: number; a?: number };\n  }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    const duration = Math.max(0, options?.durationMs ?? 800);\n\n    const borderColor = options?.borderColor ?? { r: 255, g: 0, b: 0, a: 0.9 };\n    const contentColor =\n      options?.contentColor ?? ({ r: 255, g: 200, b: 0, a: 0.2 } as const);\n\n    try {\n      await session.send(\"Overlay.enable\").catch(() => {});\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n\n      // Prefer backendNodeId to keep highlight stable even if objectId is released.\n      await session.send(\"DOM.enable\").catch(() => {});\n      let backendNodeId: Protocol.DOM.BackendNodeId | undefined;\n      try {\n        const { node } = await session.send<{ node: Protocol.DOM.Node }>(\n          \"DOM.describeNode\",\n          { objectId },\n        );\n        backendNodeId = node.backendNodeId as Protocol.DOM.BackendNodeId;\n      } catch {\n        backendNodeId = undefined;\n      }\n\n      const highlightConfig: Protocol.Overlay.HighlightConfig = {\n        showInfo: false,\n        showStyles: false,\n        showRulers: false,\n        showExtensionLines: false,\n        borderColor,\n        contentColor,\n      } as Protocol.Overlay.HighlightConfig;\n\n      const highlightOnce = async () => {\n        await session.send<never>(\"Overlay.highlightNode\", {\n          ...(backendNodeId ? { backendNodeId } : { objectId }),\n          highlightConfig,\n        });\n      };\n\n      // Initial draw\n      await highlightOnce();\n\n      // Keep alive until duration elapses to resist overlay clears on mouse move/repaints\n      if (duration > 0) {\n        const start = Date.now();\n        const tick = Math.min(300, Math.max(100, Math.floor(duration / 50)));\n        while (Date.now() - start < duration) {\n          await new Promise((r) => setTimeout(r, tick));\n          try {\n            await highlightOnce();\n          } catch {\n            // ignore transient errors\n          }\n        }\n        await session.send<never>(\"Overlay.hideHighlight\").catch(() => {});\n      }\n    } finally {\n      // Releasing objectId should not affect highlight when using backendNodeId.\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Move the mouse cursor to the element's visual center without clicking.\n   * - Scrolls into view best-effort, resolves geometry, then dispatches a mouse move.\n   */\n  async hover(): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n\n      await session.send<never>(\"Input.dispatchMouseEvent\", {\n        type: \"mouseMoved\",\n        x: cx,\n        y: cy,\n        button: \"none\",\n      } as Protocol.Input.DispatchMouseEventRequest);\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Click the element at its visual center.\n   * Steps:\n   *  1) Resolve selector to { objectId } in the frame world.\n   *  2) Scroll into view via `DOM.scrollIntoViewIfNeeded({ objectId })`.\n   *  3) Read geometry via `DOM.getBoxModel({ objectId })` → compute a center point.\n   *  4) Synthesize mouse press + release via `Input.dispatchMouseEvent`.\n   */\n  async click(options?: {\n    button?: MouseButton;\n    clickCount?: number;\n  }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    const button = options?.button ?? \"left\";\n    const clickCount = options?.clickCount ?? 1;\n\n    try {\n      // Scroll into view using objectId (avoids frontend nodeId dependence)\n      await session.send(\"DOM.scrollIntoViewIfNeeded\", { objectId });\n\n      // Get geometry using objectId\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n\n      // Dispatch click events in a pipelined burst to reduce inter-click delay\n      // from network/CPU jitter between round trips.\n      const dispatches: Array<Promise<unknown>> = [];\n      dispatches.push(\n        session.send<never>(\"Input.dispatchMouseEvent\", {\n          type: \"mouseMoved\",\n          x: cx,\n          y: cy,\n          button: \"none\",\n        } as Protocol.Input.DispatchMouseEventRequest),\n      );\n\n      for (let i = 1; i <= clickCount; i++) {\n        dispatches.push(\n          session.send<never>(\"Input.dispatchMouseEvent\", {\n            type: \"mousePressed\",\n            x: cx,\n            y: cy,\n            button,\n            clickCount: i,\n          } as Protocol.Input.DispatchMouseEventRequest),\n        );\n        dispatches.push(\n          session.send<never>(\"Input.dispatchMouseEvent\", {\n            type: \"mouseReleased\",\n            x: cx,\n            y: cy,\n            button,\n            clickCount: i,\n          } as Protocol.Input.DispatchMouseEventRequest),\n        );\n      }\n      await Promise.all(dispatches);\n    } finally {\n      // release the element handle\n      try {\n        await session.send<never>(\"Runtime.releaseObject\", { objectId });\n      } catch {\n        // If the context navigated or was destroyed (e.g., link opens new tab),\n        // releaseObject may fail with -32000. Ignore as best-effort cleanup.\n      }\n    }\n  }\n\n  /**\n   * Tap the element at its visual center with a real (trusted) touch.\n   * Mirrors {@link click} but synthesizes touch input via `Input.dispatchTouchEvent`\n   * instead of mouse input, so mobile layouts that gate handlers on touch/pointer\n   * (`pointerType: \"touch\"`) events — where a mouse click never registers — respond\n   * correctly. This is the deterministic (selector-based) counterpart used when a\n   * recorded CUA `tap` step is replayed.\n   *\n   * Does not require touch emulation: CDP delivers a trusted touch sequence even on\n   * a session reporting `maxTouchPoints: 0`.\n   */\n  async tap(): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    try {\n      await session.send(\"DOM.scrollIntoViewIfNeeded\", { objectId });\n\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n\n      // Pipelined burst, matching click's press/release batching: CDP preserves\n      // per-session command order, so awaiting each dispatch in turn would only\n      // add a round trip (a full network RTT against a remote browser).\n      await Promise.all([\n        session.send<never>(\"Input.dispatchTouchEvent\", {\n          type: \"touchStart\",\n          touchPoints: [{ x: cx, y: cy }],\n        } as Protocol.Input.DispatchTouchEventRequest),\n        session.send<never>(\"Input.dispatchTouchEvent\", {\n          type: \"touchEnd\",\n          touchPoints: [],\n        } as Protocol.Input.DispatchTouchEventRequest),\n      ]);\n    } finally {\n      try {\n        await session.send<never>(\"Runtime.releaseObject\", { objectId });\n      } catch {\n        // If the context navigated or was destroyed (e.g., link opens new tab),\n        // releaseObject may fail with -32000. Ignore as best-effort cleanup.\n      }\n    }\n  }\n\n  /**\n   * Dispatch a DOM 'click' MouseEvent on the element itself.\n   * - Does not synthesize real pointer input; directly dispatches an event.\n   * - Useful for elements that rely on click handlers without needing hit-testing.\n   */\n  async sendClickEvent(options?: {\n    bubbles?: boolean;\n    cancelable?: boolean;\n    composed?: boolean;\n    detail?: number;\n  }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    const bubbles = options?.bubbles ?? true;\n    const cancelable = options?.cancelable ?? true;\n    const composed = options?.composed ?? true;\n    const detail = options?.detail ?? 1;\n    try {\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n      await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.dispatchDomClick,\n          arguments: [\n            {\n              value: { bubbles, cancelable, composed, detail },\n            },\n          ],\n          returnByValue: true,\n        },\n      );\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Scroll the element vertically to a given percentage (0–100).\n   * - If the element is <html> or <body>, scrolls the window/document.\n   * - Otherwise, scrolls the element itself via element.scrollTo.\n   */\n  async scrollTo(percent: number | string): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.scrollElementToPercent,\n          arguments: [{ value: percent as unknown as number }],\n          returnByValue: true,\n        },\n      );\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Fill an input/textarea/contenteditable element.\n   * Mirrors Playwright semantics: the DOM helper either applies the native\n   * value setter (for special input types) or asks us to type text via the CDP\n   * Input domain after focusing/selecting.\n   */\n  async fill(value: string): Promise<void> {\n    const session = this.frame.session;\n    // Use the bundled locator globals; the raw fill snippet depends on helper symbols.\n    const fillDeclaration = `function(value) { ${locatorScriptBootstrap}; return ${locatorScriptGlobalRefs.fillElementValue}.call(this, value); }`;\n    const { objectId } = await this.resolveNode();\n\n    let releaseNeeded = true;\n\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: fillDeclaration,\n          arguments: [{ value }],\n          returnByValue: true,\n        },\n      );\n      if (res.exceptionDetails) {\n        // prefer exception.description over text (eg \"Uncaught\")\n        const message =\n          res.exceptionDetails.exception?.description ??\n          res.exceptionDetails.text ??\n          \"Unknown exception during locator().fill()\";\n        throw new StagehandLocatorError(\"Filling\", this.selector, message);\n      }\n\n      const result = res.result.value as\n        | { status?: string; reason?: string; value?: string }\n        | null\n        | undefined;\n      const status =\n        typeof result === \"object\" && result ? result.status : undefined;\n\n      if (status === \"done\") {\n        return;\n      }\n\n      if (status === \"needsinput\") {\n        // Release the current handle before synthesizing keyboard input to avoid leaking it.\n        await session\n          .send<never>(\"Runtime.releaseObject\", { objectId })\n          .catch(() => {});\n        releaseNeeded = false;\n\n        const valueToType =\n          typeof result?.value === \"string\" ? result.value : value;\n\n        let prepared = false;\n        try {\n          const { objectId: prepObjectId } = await this.resolveNode();\n          try {\n            const prepRes =\n              await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n                \"Runtime.callFunctionOn\",\n                {\n                  objectId: prepObjectId,\n                  functionDeclaration:\n                    locatorScriptSources.prepareElementForTyping,\n                  returnByValue: true,\n                },\n              );\n            prepared = Boolean(prepRes.result.value);\n          } finally {\n            await session\n              .send<never>(\"Runtime.releaseObject\", { objectId: prepObjectId })\n              .catch(() => {});\n          }\n        } catch {\n          // Ignore preparation failures; we'll fall back to typing best-effort.\n        }\n\n        if (!prepared && valueToType.length > 0) {\n          await this.type(valueToType);\n          return;\n        }\n\n        if (valueToType.length === 0) {\n          // Simulate deleting the currently selected text to clear the field.\n          await session.send<never>(\"Input.dispatchKeyEvent\", {\n            type: \"keyDown\",\n            key: \"Backspace\",\n            code: \"Backspace\",\n            windowsVirtualKeyCode: 8,\n            nativeVirtualKeyCode: 8,\n          } as Protocol.Input.DispatchKeyEventRequest);\n          await session.send<never>(\"Input.dispatchKeyEvent\", {\n            type: \"keyUp\",\n            key: \"Backspace\",\n            code: \"Backspace\",\n            windowsVirtualKeyCode: 8,\n            nativeVirtualKeyCode: 8,\n          } as Protocol.Input.DispatchKeyEventRequest);\n        } else {\n          await session.send<never>(\"Input.insertText\", { text: valueToType });\n        }\n\n        return;\n      }\n\n      if (status === \"error\") {\n        const reason =\n          typeof result?.reason === \"string\" && result.reason.length > 0\n            ? result.reason\n            : \"Failed to fill element\";\n        throw new StagehandInvalidArgumentError(\n          `Failed to fill element (${reason})`,\n        );\n      }\n\n      // Backward compatibility: if no status is returned (older bundle), fall back to setter logic.\n      if (!status) {\n        await this.type(value);\n      }\n    } finally {\n      if (releaseNeeded) {\n        await session\n          .send<never>(\"Runtime.releaseObject\", { objectId })\n          .catch(() => {});\n      }\n    }\n  }\n\n  /**\n   * Type text into the element (focuses first).\n   * - Focus via element.focus() in page JS (no DOM.focus(nodeId)).\n   * - If no delay, uses `Input.insertText` for efficiency.\n   * - With delay, synthesizes `keyDown`/`keyUp` per character.\n   */\n  async type(text: string, options?: { delay?: number }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    try {\n      // Focus using JS (avoids DOM.focus(nodeId))\n      await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.focusElement,\n          returnByValue: true,\n        },\n      );\n\n      if (!options?.delay) {\n        await session.send<never>(\"Input.insertText\", { text });\n        return;\n      }\n\n      for (const ch of text) {\n        await session.send<never>(\"Input.dispatchKeyEvent\", {\n          type: \"keyDown\",\n          text: ch,\n          key: ch,\n        } as Protocol.Input.DispatchKeyEventRequest);\n\n        await session.send<never>(\"Input.dispatchKeyEvent\", {\n          type: \"keyUp\",\n          text: ch,\n          key: ch,\n        } as Protocol.Input.DispatchKeyEventRequest);\n\n        await new Promise((r) => setTimeout(r, options.delay));\n      }\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Select one or more options on a `<select>` element.\n   * Returns the values actually selected after the operation.\n   */\n  async selectOption(values: string | string[]): Promise<string[]> {\n    const session = this.frame.session;\n    const desired = Array.isArray(values) ? values : [values];\n    const { objectId } = await this.resolveNode();\n\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.selectElementOptions,\n          arguments: [{ value: desired }],\n          returnByValue: true,\n        },\n      );\n\n      return (res.result.value as string[]) ?? [];\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return true if the element is attached and visible (rough heuristic).\n   */\n  async isVisible(): Promise<boolean> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.isElementVisible,\n          returnByValue: true,\n        },\n      );\n      return Boolean(res.result.value);\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return true if the element is an input[type=checkbox|radio] and is checked.\n   * Also considers aria-checked for ARIA widgets.\n   */\n  async isChecked(): Promise<boolean> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.isElementChecked,\n          returnByValue: true,\n        },\n      );\n      return Boolean(res.result.value);\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's input value (for input/textarea/select/contenteditable).\n   */\n  async inputValue(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementInputValue,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's textContent (raw, not innerText).\n   */\n  async textContent(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementTextContent,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's innerHTML string.\n   */\n  async innerHtml(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementInnerHTML,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's innerText (layout-aware, visible text).\n   */\n  async innerText(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementInnerText,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return a locator narrowed to the first match.\n   */\n  first(): Locator {\n    return this.nth(0);\n  }\n\n  /** Return a locator narrowed to the element at the given zero-based index. */\n  nth(index: number): Locator {\n    const value = Number(index);\n    if (!Number.isFinite(value) || value < 0) {\n      throw new StagehandInvalidArgumentError(\n        \"locator().nth() expects a non-negative index\",\n      );\n    }\n\n    const nextIndex = Math.floor(value);\n    if (nextIndex === this.nthIndex) {\n      return this;\n    }\n\n    return new Locator(this.frame, this.selector, this.options, nextIndex);\n  }\n\n  // ---------- helpers ----------\n\n  /**\n   * Resolve `this.selector` within the frame to `{ objectId, nodeId? }`:\n   * Delegates to a shared selector resolver so all selector logic stays in sync.\n   */\n  public async resolveNode(): Promise<{\n    nodeId: Protocol.DOM.NodeId | null;\n    objectId: Protocol.Runtime.RemoteObjectId;\n  }> {\n    const session = this.frame.session;\n\n    await session.send(\"Runtime.enable\");\n    await session.send(\"DOM.enable\");\n\n    const index = this.nthIndex < 0 ? 0 : this.nthIndex;\n    const resolved = await this.selectorResolver.resolveAtIndex(\n      this.selectorQuery,\n      index,\n    );\n    if (!resolved) {\n      throw new StagehandElementNotFoundError([this.selector]);\n    }\n\n    return resolved;\n  }\n\n  /**\n   * Resolve all matching nodes for this locator.\n   * If the locator is narrowed via nth(), only that index is returned.\n   */\n  public async resolveNodesForMask(): Promise<\n    Array<{\n      nodeId: Protocol.DOM.NodeId | null;\n      objectId: Protocol.Runtime.RemoteObjectId;\n    }>\n  > {\n    const session = this.frame.session;\n\n    await session.send(\"Runtime.enable\");\n    await session.send(\"DOM.enable\");\n\n    if (this.nthIndex >= 0) {\n      const resolved = await this.selectorResolver.resolveAtIndex(\n        this.selectorQuery,\n        this.nthIndex,\n      );\n      if (!resolved) {\n        throw new StagehandElementNotFoundError([this.selector]);\n      }\n      return [resolved];\n    }\n\n    const resolved = await this.selectorResolver.resolveAll(this.selectorQuery);\n    if (!resolved.length) {\n      throw new StagehandElementNotFoundError([this.selector]);\n    }\n    return resolved;\n  }\n\n  /** Compute a center point from a BoxModel content quad */\n  private centerFromBoxContent(content: number[]): { cx: number; cy: number } {\n    // content is [x1,y1, x2,y2, x3,y3, x4,y4]\n    if (!content || content.length < 8) {\n      throw new StagehandInvalidArgumentError(\"Invalid box model content quad\");\n    }\n    const xs = [content[0], content[2], content[4], content[6]];\n    const ys = [content[1], content[3], content[5], content[7]];\n    const cx = (xs[0] + xs[1] + xs[2] + xs[3]) / 4;\n    const cy = (ys[0] + ys[1] + ys[2] + ys[3]) / 4;\n    return { cx, cy };\n  }\n}\n"]}

package/dist/cjs/lib/v3/understudy/page.d.ts

@@ -314,6 +314,21 @@ export declare class Page {
         clickCount?: number;
         returnXpath?: boolean;
     }): Promise<string>;
+    /**
+     * Tap at absolute page coordinates (CSS pixels) with a real (trusted) touch.
+     * Mirrors {@link click} but synthesizes touch input via `Input.dispatchTouchEvent`
+     * instead of mouse input, so mobile layouts that gate their handlers on
+     * touch/pointer events (`pointerType: "touch"`) — where a synthesized mouse click
+     * never registers — respond correctly. Coordinates are relative to the viewport
+     * origin (top-left). Does not scroll.
+     *
+     * Does not require touch emulation: CDP delivers a trusted touch sequence even on
+     * a session reporting `maxTouchPoints: 0`. Whether the agent *chooses* this over
+     * {@link click} is decided by `V3.usesTouch`.
+     */
+    tap(x: number, y: number, options?: {
+        returnXpath?: boolean;
+    }): Promise<string>;
     /**
      * Hover at absolute page coordinates (CSS pixels).
      * Dispatches mouseMoved via CDP Input domain on the top-level page target's

package/dist/cjs/lib/v3/understudy/page.js

@@ -126,6 +126,7 @@ let Page = (() => {
     let _waitForSelector_decorators;
     let _evaluate_decorators;
     let _click_decorators;
+    let _tap_decorators;
     let _hover_decorators;
     let _scroll_decorators;
     let _dragAndDrop_decorators;
@@ -155,6 +156,7 @@ let Page = (() => {
                 })];
             _evaluate_decorators = [FlowLogger_js_1.FlowLogger.wrapWithLogging({ eventType: "PageEvaluate" })];
             _click_decorators = [FlowLogger_js_1.FlowLogger.wrapWithLogging({ eventType: "PageClick" })];
+            _tap_decorators = [FlowLogger_js_1.FlowLogger.wrapWithLogging({ eventType: "PageTap" })];
             _hover_decorators = [FlowLogger_js_1.FlowLogger.wrapWithLogging({ eventType: "PageHover" })];
             _scroll_decorators = [FlowLogger_js_1.FlowLogger.wrapWithLogging({ eventType: "PageScroll" })];
             _dragAndDrop_decorators = [FlowLogger_js_1.FlowLogger.wrapWithLogging({
@@ -175,6 +177,7 @@ let Page = (() => {
             __esDecorate(this, null, _waitForSelector_decorators, { kind: "method", name: "waitForSelector", static: false, private: false, access: { has: obj => "waitForSelector" in obj, get: obj => obj.waitForSelector }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _evaluate_decorators, { kind: "method", name: "evaluate", static: false, private: false, access: { has: obj => "evaluate" in obj, get: obj => obj.evaluate }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _click_decorators, { kind: "method", name: "click", static: false, private: false, access: { has: obj => "click" in obj, get: obj => obj.click }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _tap_decorators, { kind: "method", name: "tap", static: false, private: false, access: { has: obj => "tap" in obj, get: obj => obj.tap }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _hover_decorators, { kind: "method", name: "hover", static: false, private: false, access: { has: obj => "hover" in obj, get: obj => obj.hover }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _scroll_decorators, { kind: "method", name: "scroll", static: false, private: false, access: { has: obj => "scroll" in obj, get: obj => obj.scroll }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _dragAndDrop_decorators, { kind: "method", name: "dragAndDrop", static: false, private: false, access: { has: obj => "dragAndDrop" in obj, get: obj => obj.dragAndDrop }, metadata: _metadata }, null, _instanceExtraInitializers);
@@ -1523,6 +1526,53 @@ let Page = (() => {
             await Promise.all(dispatches);
             return xpathResult ?? "";
         }
+        /**
+         * Tap at absolute page coordinates (CSS pixels) with a real (trusted) touch.
+         * Mirrors {@link click} but synthesizes touch input via `Input.dispatchTouchEvent`
+         * instead of mouse input, so mobile layouts that gate their handlers on
+         * touch/pointer events (`pointerType: "touch"`) — where a synthesized mouse click
+         * never registers — respond correctly. Coordinates are relative to the viewport
+         * origin (top-left). Does not scroll.
+         *
+         * Does not require touch emulation: CDP delivers a trusted touch sequence even on
+         * a session reporting `maxTouchPoints: 0`. Whether the agent *chooses* this over
+         * {@link click} is decided by `V3.usesTouch`.
+         */
+        async tap(x, y, options) {
+            let xpathResult;
+            if (options?.returnXpath) {
+                // Resolve the deepest node at the tap coordinates so a recorded/replayed
+                // step can target it by XPath, mirroring click's returnXpath path.
+                try {
+                    const hit = await (0, index_js_1.resolveXpathForLocation)(this, x, y);
+                    if (hit) {
+                        xpathResult = hit.absoluteXPath;
+                    }
+                }
+                catch {
+                    // best-effort; fall through if resolution fails
+                }
+            }
+            // Keep the cursor overlay in sync with the action, like every other
+            // coordinate action (click/hover/drag), even though touch has no cursor.
+            await this.updateCursor(x, y);
+            // Dispatch touchStart/touchEnd as one pipelined burst, the same way click
+            // batches press/release. CDP processes commands on a session in the order
+            // they were written, so the pair still arrives ordered; awaiting each in
+            // turn only adds a round trip of latency (a full network RTT when the
+            // browser is remote).
+            await Promise.all([
+                this.mainSession.send("Input.dispatchTouchEvent", {
+                    type: "touchStart",
+                    touchPoints: [{ x, y }],
+                }),
+                this.mainSession.send("Input.dispatchTouchEvent", {
+                    type: "touchEnd",
+                    touchPoints: [],
+                }),
+            ]);
+            return xpathResult ?? "";
+        }
         /**
          * Hover at absolute page coordinates (CSS pixels).
          * Dispatches mouseMoved via CDP Input domain on the top-level page target's