browser-debugger-cli 0.8.0 → 0.10.0

package/dist/runtime/dom/evalHelpers.js

@@ -1,5 +1,6 @@
+import { CDPProtocolError } from '../../connection/errors.js';
 import { CommandError } from '../../errors/index.js';
-import { navigationPendingError, pageBusyError, promiseTimeoutError, scriptExecutionError, scriptTimeoutError, } from '../../errors/messages.js';
+import { navigationPendingError, pageBusyError, pageClosedDuringEvalError, pageNavigatedDuringEvalError, promiseTimeoutError, scriptExecutionError, scriptTimeoutError, } from '../../errors/messages.js';
 import { pendingNavigationUrl } from '../page/navigation.js';
 import { senderFor } from '../../telemetry/objectExpander.js';
 import { formatRemoteObject } from '../../telemetry/remoteObject.js';
@@ -302,9 +303,10 @@ async function withDeadline(work, ms, onTimeout) {
  * answering because a navigation still waits for the server is left alone.
  *
  * @param cdp - CDP connection
+ * @param scope - Whether the target is the page or an iframe
  * @returns The timeout error to report
  */
-async function terminatePageScripts(cdp) {
+async function terminatePageScripts(cdp, scope) {
     const pendingUrl = await pendingNavigationUrl(cdp).catch((error) => {
         log.debug(`Could not check for a pending navigation: ${getErrorMessage(error)}`);
         return undefined;
@@ -313,14 +315,50 @@ async function terminatePageScripts(cdp) {
         const err = navigationPendingError(pendingUrl);
         return new CommandError(err.message, { suggestion: err.suggestion }, EXIT_CODES.CDP_TIMEOUT);
     }
-    await cdp
-        .send('Runtime.terminateExecution')
-        .catch((error) => log.debug(`terminateExecution failed: ${getErrorMessage(error)}`));
-    const err = pageBusyError(EVAL_TIMEOUT_MS);
+    const err = pageBusyError(EVAL_TIMEOUT_MS, scope, await terminateExecution(cdp));
     return new CommandError(err.message, { suggestion: err.suggestion }, EXIT_CODES.CDP_TIMEOUT);
 }
+/**
+ * Ask V8 to terminate the target's running script.
+ *
+ * @param cdp - CDP connection of the target
+ * @returns Whether the target acknowledged it in time
+ */
+async function terminateExecution(cdp) {
+    try {
+        const stopped = await settledWithin(cdp.send('Runtime.terminateExecution'), LIVENESS_CHECK_MS);
+        return stopped.settled;
+    }
+    catch (error) {
+        log.debug(`terminateExecution failed: ${getErrorMessage(error)}`);
+        return false;
+    }
+}
 /** How long a page gets to answer a liveness check before it counts as busy */
 const LIVENESS_CHECK_MS = 2_000;
+/**
+ * Whether the target answers a trivial evaluation in time.
+ *
+ * @param cdp - CDP connection
+ * @param ms - Time limit
+ * @returns False when its scripts keep it busy
+ */
+async function isAnswering(cdp, ms) {
+    const probe = await settledWithin(cdp.send('Runtime.evaluate', { expression: '1', returnByValue: true }), ms);
+    return probe.settled;
+}
+/** Chrome's messages for a command whose execution context or target went away */
+const CONTEXT_LOST_PATTERN = /Execution context was destroyed|Inspected target navigated or closed|Cannot find context with specified id|uniqueContextId not found|Session with given id not found/i;
+/**
+ * Whether Chrome failed a command because the document it ran in went away
+ * (navigation, a removed iframe).
+ *
+ * @param error - Error thrown by a CDP command
+ * @returns True for a lost context
+ */
+export function isContextLostError(error) {
+    return error instanceof CDPProtocolError && CONTEXT_LOST_PATTERN.test(error.message);
+}
 /**
  * Run a CDP command on the page, recovering a page kept busy by its own
  * scripts. If the command has not answered when a script would have been
@@ -331,19 +369,19 @@ const LIVENESS_CHECK_MS = 2_000;
  *
  * @param cdp - CDP connection
  * @param command - The pending command
- * @param limits - When to check the page, and how long it gets to answer
+ * @param options - When to check the page, how long it gets to answer, what to call it
  * @returns The command's result
  * @throws CommandError (102) when the page was busy
  */
-export async function withBusyPageRecovery(cdp, command, limits = { busyAfterMs: EVAL_TIMEOUT_MS + TERMINATION_GRACE_MS, livenessMs: LIVENESS_CHECK_MS }) {
+export async function withBusyPageRecovery(cdp, command, options = {}) {
+    const { busyAfterMs = EVAL_TIMEOUT_MS + TERMINATION_GRACE_MS, livenessMs = LIVENESS_CHECK_MS, scope = 'page', } = options;
     command.catch(() => undefined);
-    const early = await settledWithin(command, limits.busyAfterMs);
+    const early = await settledWithin(command, busyAfterMs);
     if (early.settled)
         return early.value;
-    const probe = await settledWithin(cdp.send('Runtime.evaluate', { expression: '1', returnByValue: true }), limits.livenessMs);
-    if (probe.settled)
+    if (await isAnswering(cdp, livenessMs))
         return command;
-    throw await terminatePageScripts(cdp);
+    throw await terminatePageScripts(cdp, scope);
 }
 /**
  * The work's value if it settles within `ms` (its rejection is passed on).
@@ -352,7 +390,7 @@ export async function withBusyPageRecovery(cdp, command, limits = { busyAfterMs:
  * @param ms - Time limit
  * @returns `{ settled: true, value }`, or `{ settled: false }` when time ran out
  */
-async function settledWithin(work, ms) {
+export async function settledWithin(work, ms) {
     let timer;
     const timeout = new Promise((resolve) => {
         timer = setTimeout(() => resolve({ settled: false }), ms);
@@ -364,6 +402,80 @@ async function settledWithin(work, ms) {
         clearTimeout(timer);
     }
 }
+/**
+ * The error for an evaluation that did not answer in time: a target that
+ * still answers was only waiting for a promise that never settled
+ * (`await new Promise(() => {})`); one that does not answer is busy, and its
+ * scripts are terminated.
+ *
+ * @param cdp - CDP connection of the target
+ * @param scope - Whether the script ran in the page or an iframe
+ * @returns The error to report (102)
+ */
+async function evaluationTimeoutError(cdp, scope) {
+    if (await isAnswering(cdp, LIVENESS_CHECK_MS))
+        return promiseTimeout();
+    return terminatePageScripts(cdp, scope);
+}
+/**
+ * A promise the script awaited or returned did not settle in time.
+ *
+ * @returns Command error (102)
+ */
+function promiseTimeout() {
+    const err = promiseTimeoutError(EVAL_TIMEOUT_MS);
+    return new CommandError(err.message, { suggestion: err.suggestion }, EXIT_CODES.CDP_TIMEOUT);
+}
+/** Chrome's message for a command sent to a session (target) that is gone */
+const SESSION_GONE_PATTERN = /Session with given id not found/i;
+/**
+ * Whether the page still answers. A page that does not answer in time is
+ * taken as open: commands wait while a navigation is pending.
+ *
+ * @param cdp - CDP connection of the page
+ * @returns False when the page (tab) was closed
+ */
+export async function pageStillOpen(cdp) {
+    try {
+        await settledWithin(cdp.send('Runtime.evaluate', { expression: '1', returnByValue: true }), LIVENESS_CHECK_MS);
+        return true;
+    }
+    catch (error) {
+        log.debug(`Page did not answer: ${getErrorMessage(error)}`);
+        return false;
+    }
+}
+/**
+ * The error for a page script whose context went away: the page navigated,
+ * or the tab was closed.
+ *
+ * @param error - Chrome's context-lost error
+ * @param cdp - CDP connection of the page
+ * @returns Command error (83)
+ */
+async function pageContextLostError(error, cdp) {
+    const sessionGone = SESSION_GONE_PATTERN.test(getErrorMessage(error));
+    const err = sessionGone || !(await pageStillOpen(cdp))
+        ? pageClosedDuringEvalError()
+        : pageNavigatedDuringEvalError();
+    return new CommandError(err.message, { suggestion: err.suggestion }, EXIT_CODES.RESOURCE_NOT_FOUND);
+}
+/**
+ * `Runtime.evaluate` options of a `bdg dom eval` script.
+ *
+ * @param target - Execution context to run in
+ * @returns Options (REPL mode, previews, 20 s limit)
+ */
+function evaluateOptions(target) {
+    return {
+        returnByValue: false,
+        generatePreview: true,
+        replMode: true,
+        objectGroup: EVAL_OBJECT_GROUP,
+        timeout: EVAL_TIMEOUT_MS,
+        ...(target.uniqueContextId && { uniqueContextId: target.uniqueContextId }),
+    };
+}
 /**
  * Evaluate a `bdg dom eval` script.
  *
@@ -378,25 +490,23 @@ async function settledWithin(work, ms) {
  * @param script - JavaScript expression
  * @param target - Session and execution context to run in (default: the page)
  * @returns Value and type
- * @throws CommandError (102) when the script was terminated, (91) when it threw
+ * @throws CommandError (102) when the script was terminated or a promise did
+ *   not settle, (91) when it threw, (83) when the page navigated while it ran
+ *   (in a frame, Chrome's context-lost error is passed on for the caller to explain)
  */
 export async function evaluateScript(cdp, script, target = {}) {
     const session = senderFor(cdp, target.sessionId);
+    const scope = target.uniqueContextId ? 'frame' : 'page';
     try {
-        const response = await withDeadline(executeScript(session, script, {
-            returnByValue: false,
-            generatePreview: true,
-            replMode: true,
-            objectGroup: EVAL_OBJECT_GROUP,
-            timeout: EVAL_TIMEOUT_MS,
-            ...(target.uniqueContextId && { uniqueContextId: target.uniqueContextId }),
-        }), EVAL_TIMEOUT_MS + TERMINATION_GRACE_MS, () => terminatePageScripts(session));
-        const settled = await withDeadline(settlePromise(session, response.result, script), EVAL_TIMEOUT_MS, () => {
-            const err = promiseTimeoutError(EVAL_TIMEOUT_MS);
-            return new CommandError(err.message, { suggestion: err.suggestion }, EXIT_CODES.CDP_TIMEOUT);
-        });
+        const response = await withDeadline(executeScript(session, script, evaluateOptions(target)), EVAL_TIMEOUT_MS + TERMINATION_GRACE_MS, () => evaluationTimeoutError(target.recovery ?? session, scope));
+        const settled = await withDeadline(settlePromise(session, response.result, script), EVAL_TIMEOUT_MS, promiseTimeout);
         return await toEvalResult(session, settled);
     }
+    catch (error) {
+        throw scope === 'page' && isContextLostError(error)
+            ? await pageContextLostError(error, session)
+            : error;
+    }
     finally {
         void session
             .send('Runtime.releaseObjectGroup', { objectGroup: EVAL_OBJECT_GROUP })

package/dist/runtime/dom/eventListeners.d.ts

@@ -4,7 +4,8 @@
  * Collects the listeners of the element, every ancestor (through open shadow
  * roots), its document and its window with `DOMDebugger.getEventListeners`,
  * so handlers that frameworks attach by delegation (React on its root
- * container, jQuery on `document`) are found too. The Debugger domain is not
+ * container, jQuery on `document`) are found too, along with the handlers
+ * behind them (jQuery's handlers, React's `on…` props). The Debugger domain is not
  * enabled: that would make `debugger;` statements pause the page.
  */
 import type { CDPConnection } from '../../connection/cdp.js';

package/dist/runtime/dom/eventListeners.js

@@ -4,15 +4,17 @@
  * Collects the listeners of the element, every ancestor (through open shadow
  * roots), its document and its window with `DOMDebugger.getEventListeners`,
  * so handlers that frameworks attach by delegation (React on its root
- * container, jQuery on `document`) are found too. The Debugger domain is not
+ * container, jQuery on `document`) are found too, along with the handlers
+ * behind them (jQuery's handlers, React's `on…` props). The Debugger domain is not
  * enabled: that would make `debugger;` statements pause the page.
  */
 import { CDPProtocolError } from '../../connection/errors.js';
 import { CommandError } from '../../errors/index.js';
-import { eventListenersUnavailableError, indexOutOfRangeError, noNodesFoundError, operationFailedError, staleNodeError, } from '../../errors/messages.js';
+import { eventListenersUnavailableError, operationFailedError } from '../../errors/messages.js';
 import { throwIfInvalidSelector, withMultipleMatchesWarning, } from './formFillHelpers/shared.js';
-import { buildListenerReport, describeChainEntry, } from './listenerSummary.js';
-import { DEEP_QUERY_JS, selectorArgsJS } from './targetNode.js';
+import { ELEMENT_INFO_JS } from './listenerPageScripts.js';
+import { buildListenerReport, describeChainEntry, suggestEventTypes, } from './listenerSummary.js';
+import { DEEP_QUERY_JS, missingElementError, selectorArgsJS } from './targetNode.js';
 import { createLogger } from '../../ui/logging/index.js';
 import { getErrorMessage } from '../../utils/errors.js';
 import { EXIT_CODES } from '../../utils/exitCodes.js';
@@ -41,10 +43,6 @@ const CHAIN_JS = `function () {
   if (view) chain.push(view);
   return chain;
 }`;
-/** Page function: names of the given functions (null for non-functions) */
-const NAMES_JS = `function (...fns) {
-  return fns.map((fn) => (typeof fn === 'function' ? fn.name : null));
-}`;
 /** Distinguishes the object groups of concurrent calls */
 let groupCounter = 0;
 /**
@@ -60,15 +58,24 @@ export async function inspectEventListeners(cdp, params) {
     const objectGroup = `bdg-listeners-${++groupCounter}`;
     try {
         const { matchCount, chain } = await findEventTargetChain(cdp, params, objectGroup);
-        const found = await collectListeners(cdp, chain);
-        const handlers = found.flatMap((entry) => entry.listeners.map((l) => l.handler));
-        const names = await handlerNames(cdp, chain[0]?.objectId ?? '', handlers);
+        const collected = await collectListeners(cdp, chain);
+        const page = await pageDetails(cdp, chain, collected, objectGroup, params.types);
+        const found = collected.map((item) => {
+            const framework = page.roots[item.position];
+            return framework ? { ...item, entry: { ...item.entry, framework } } : item;
+        });
+        const report = buildListenerReport(found, page.details, params, page.react);
         const result = {
             success: true,
             selector: params.selector,
             ...(params.index !== undefined && { index: params.index }),
             element: describeChainEntry(chain[0] ?? {}),
-            listeners: buildListenerReport(found, names, params.types),
+            ...(page.frame && { frame: page.frame }),
+            listeners: report.listeners,
+            ...(report.collapsed.length > 0 && { collapsed: report.collapsed }),
+            ...typeSuggestions(found, report, params.types),
+            ...(page.jquerySkipped && { jqueryHandlersSkipped: page.jquerySkipped }),
+            ...(page.reactSkipped && { reactHandlersSkipped: page.reactSkipped }),
             ...(params.backendNodeId === undefined && { matchCount }),
         };
         return withMultipleMatchesWarning(result, params.index, 'listing the first');
@@ -161,25 +168,6 @@ async function nodeChain(cdp, backendNodeId, objectGroup) {
         ? [{ objectId: item.objectId, className: item.className, description: item.description }]
         : []);
 }
-/**
- * Error for an element that could not be found.
- *
- * @param params - Request
- * @param matchCount - Elements the selector matched
- * @returns Stale (87), out of range (81) or not found (83) error
- */
-function missingElementError(params, matchCount) {
-    if (params.backendNodeId !== undefined) {
-        const err = staleNodeError();
-        return new CommandError(err.message, { suggestion: err.suggestion }, EXIT_CODES.STALE_CACHE);
-    }
-    if (matchCount > 0) {
-        const err = indexOutOfRangeError(params.index ?? 0, matchCount - 1);
-        return new CommandError(err.message, { suggestion: err.suggestion }, EXIT_CODES.INVALID_ARGUMENTS);
-    }
-    const err = noNodesFoundError(params.selector);
-    return new CommandError(err.message, { suggestion: err.suggestion }, EXIT_CODES.RESOURCE_NOT_FOUND);
-}
 /**
  * Items of an array in the page, in order.
  *
@@ -223,30 +211,179 @@ async function collectListeners(cdp, chain) {
     }
 }
 /**
- * Ask the page for the handlers' names (`Function.name` also knows names of
- * arrow functions assigned to variables, and `bound f` for bound functions).
+ * `--type` values the user probably meant, when none matched.
+ *
+ * @param found - All listeners found
+ * @param report - The filtered report
+ * @param types - Requested types
+ * @returns `{ typeSuggestions }` when there are any
+ */
+function typeSuggestions(found, report, types) {
+    if (!types?.length || report.listeners.length > 0 || report.collapsed.length > 0)
+        return {};
+    const available = [...new Set(found.flatMap((entry) => entry.listeners.map((l) => l.type)))];
+    const suggestions = suggestEventTypes(types, available);
+    return suggestions.length > 0 ? { typeSuggestions: suggestions } : {};
+}
+/**
+ * Ask the page about the element and its listeners' handlers: their names
+ * (`Function.name` also knows names of arrow functions assigned to
+ * variables, and `bound f` for bound functions), which function object each
+ * calls, the jQuery handlers behind jQuery's dispatcher, the React `on…`
+ * props that run for the element's events, React root containers and the
+ * element's iframe.
  *
  * @param cdp - CDP connection
- * @param elementId - Object id of the element (the page context to run in)
- * @param handlers - Handler objects, in report order
- * @returns Names in the same order; empty when the page could not tell
+ * @param chain - Event targets, element first
+ * @param found - Listeners per chain entry
+ * @param objectGroup - Object group for the handles
+ * @param types - Requested event types (React props of others are not read)
+ * @returns Details; empty when the page could not tell
  */
-async function handlerNames(cdp, elementId, handlers) {
-    if (handlers.length === 0)
-        return [];
+async function pageDetails(cdp, chain, found, objectGroup, types) {
+    const listeners = found.flatMap((entry) => entry.listeners.map((listener) => ({ position: entry.position, listener })));
+    const handlers = listeners.map(({ listener }) => listener.handler);
     try {
+        const targets = await Promise.all(handlers.map((handler) => boundTarget(cdp, handler)));
         const response = (await cdp.send('Runtime.callFunctionOn', {
-            objectId: elementId,
-            functionDeclaration: NAMES_JS,
-            arguments: handlers.map((handler) => handler?.objectId ? { objectId: handler.objectId } : { value: null }),
-            returnByValue: true,
+            objectId: chain[0]?.objectId,
+            functionDeclaration: ELEMENT_INFO_JS,
+            arguments: [
+                {
+                    value: listeners.map(({ position, listener }) => ({
+                        position,
+                        type: listener.type,
+                        capture: listener.useCapture,
+                    })),
+                },
+                { value: types ?? null },
+                ...chain.map((entry) => ({ objectId: entry.objectId })),
+                ...handlers.map(objectArgument),
+                ...targets.map(objectArgument),
+            ],
+            objectGroup,
         }));
-        const names = response.result.value;
-        return (names ?? []).map((name) => name ?? undefined);
+        const [infoObject, ...fns] = await arrayItems(cdp, response.result.objectId ?? '');
+        const info = await valueOf(cdp, infoObject?.objectId ?? '');
+        return toPageDetails(info, await Promise.all(fns.map((fn) => handlerSource(cdp, fn))));
     }
     catch (error) {
-        log.debug(`Handler names not read: ${getErrorMessage(error)}`);
-        return [];
+        log.debug(`Handler details not read: ${getErrorMessage(error)}`);
+        return { details: [], roots: [], react: [] };
+    }
+}
+/**
+ * A `Runtime.callFunctionOn` argument for a remote object.
+ *
+ * @param object - The object, if any
+ * @returns Its handle, or null
+ */
+function objectArgument(object) {
+    return object?.objectId ? { objectId: object.objectId } : { value: null };
+}
+/**
+ * An internal property (`[[TargetFunction]]`, `[[FunctionLocation]]`) of a
+ * page object.
+ *
+ * @param cdp - CDP connection
+ * @param objectId - The object
+ * @param name - Property name
+ * @returns Its value, undefined when missing or unreadable
+ */
+async function internalProperty(cdp, objectId, name) {
+    try {
+        const { internalProperties = [] } = (await cdp.send('Runtime.getProperties', {
+            objectId,
+            ownProperties: true,
+        }));
+        return internalProperties.find((property) => property.name === name)?.value;
     }
+    catch (error) {
+        log.debug(`${name} not read: ${getErrorMessage(error)}`);
+        return undefined;
+    }
+}
+/**
+ * The function a bound handler calls (React binds one dispatcher per event
+ * type), so dispatchers are recognised by function identity.
+ *
+ * @param cdp - CDP connection
+ * @param handler - Listener handler
+ * @returns The target function, undefined for handlers that are not bound
+ */
+async function boundTarget(cdp, handler) {
+    if (!handler?.objectId || !handler.description?.includes('[native code]'))
+        return undefined;
+    return internalProperty(cdp, handler.objectId, '[[TargetFunction]]');
+}
+/**
+ * Copy a page object by value.
+ *
+ * @param cdp - CDP connection
+ * @param objectId - The object
+ * @returns Its JSON value
+ */
+async function valueOf(cdp, objectId) {
+    const response = (await cdp.send('Runtime.callFunctionOn', {
+        objectId,
+        functionDeclaration: 'function () { return this; }',
+        returnByValue: true,
+    }));
+    return response.result.value;
+}
+/**
+ * Source and location of a framework handler function (no location when
+ * it cannot be read).
+ *
+ * @param cdp - CDP connection
+ * @param fn - The function
+ * @returns Its source and location
+ */
+async function handlerSource(cdp, fn) {
+    const source = { source: fn?.description, scriptId: '0', lineNumber: 0, columnNumber: 0 };
+    if (!fn?.objectId)
+        return source;
+    const location = (await internalProperty(cdp, fn.objectId, '[[FunctionLocation]]'))?.value;
+    return { ...source, ...location };
+}
+/** Location of a handler whose source could not be read */
+const UNKNOWN_SOURCE = { scriptId: '0', lineNumber: 0, columnNumber: 0 };
+/**
+ * Combine the page's report with the framework handlers' sources.
+ *
+ * @param info - Page report
+ * @param sources - Source and location of each jQuery or Preact handler,
+ *   then each React prop handler, in report order
+ * @returns Details per listener and the React prop handlers
+ */
+function toPageDetails(info, sources) {
+    let next = 0;
+    const details = info.listeners.map(({ name, identity, targetName, jquery, preact }) => ({
+        name: name ?? undefined,
+        identity: identity ?? undefined,
+        targetName: targetName ?? undefined,
+        jquery: jquery?.map((handler) => ({
+            type: handler.type,
+            selector: handler.selector ?? undefined,
+            name: handler.name,
+            ...(sources[next++] ?? UNKNOWN_SOURCE),
+        })),
+        preact: preact && {
+            name: preact.name,
+            ...(sources[next++] ?? UNKNOWN_SOURCE),
+        },
+    }));
+    const react = info.react.map((handler) => ({
+        ...handler,
+        ...(sources[next++] ?? UNKNOWN_SOURCE),
+    }));
+    return {
+        details,
+        roots: info.roots,
+        react,
+        ...(info.frame && { frame: info.frame }),
+        ...(info.jquerySkipped > 0 && { jquerySkipped: info.jquerySkipped }),
+        ...(info.reactSkipped > 0 && { reactSkipped: info.reactSkipped }),
+    };
 }
 //# sourceMappingURL=eventListeners.js.map

package/dist/runtime/dom/formDiscovery.d.ts

@@ -15,7 +15,7 @@ import type { RawFormData } from './formTypes.js';
  * - Current values and validation state
  * - Form relevance scoring for multi-form pages
  */
-export declare const FORM_DISCOVERY_SCRIPT = "\n(function() {\n  const result = { forms: [] };\n\n  function isUnique(selector) {\n    try {\n      return document.querySelectorAll(selector).length === 1;\n    } catch (e) {\n      return false;\n    }\n  }\n\n  function generateSelector(element) {\n    if (element.id && isUnique('#' + CSS.escape(element.id))) {\n      return '#' + CSS.escape(element.id);\n    }\n    if (element.name) {\n      const byName = element.tagName.toLowerCase() + '[name=\"' + CSS.escape(element.name) + '\"]';\n      if (isUnique(byName)) return byName;\n      const byValue = byName + '[value=\"' + CSS.escape(element.getAttribute('value') || '') + '\"]';\n      if (element.hasAttribute('value') && isUnique(byValue)) return byValue;\n    }\n    const tag = element.tagName.toLowerCase();\n    const parent = element.parentElement;\n    if (!parent) return tag;\n    const siblings = Array.from(parent.children).filter(c => c.tagName === element.tagName);\n    if (siblings.length === 1) {\n      const parentSelector = generateSelector(parent);\n      return parentSelector + ' > ' + tag;\n    }\n    const index = siblings.indexOf(element);\n    const parentSelector = generateSelector(parent);\n    return parentSelector + ' > ' + tag + ':nth-of-type(' + (index + 1) + ')';\n  }\n\n  function cleanLabelText(text) {\n    if (!text) return text;\n    const patterns = [\n      /Previous\\s*arrow/gi,\n      /Next\\s*arrow/gi,\n      /\\barrow\\b/gi,\n      /\\bchevron\\b/gi,\n      /\u2190|\u2192|\u2191|\u2193|\u25B2|\u25BC|\u25C0|\u25B6/g,\n      /\\u25C0|\\u25B6|\\u25B2|\\u25BC/g,\n      /^\\s*[<>]\\s*/,\n      /\\s*[<>]\\s*$/,\n    ];\n    let cleaned = text;\n    for (const pattern of patterns) {\n      cleaned = cleaned.replace(pattern, '');\n    }\n    cleaned = cleaned.replace(/\\s{2,}/g, ' ').trim();\n    return cleaned || text.trim();\n  }\n\n  function extractLabel(element) {\n    if (element.id) {\n      const labelFor = document.querySelector('label[for=\"' + CSS.escape(element.id) + '\"]');\n      if (labelFor) return cleanLabelText(labelFor.textContent);\n    }\n    const ariaLabel = element.getAttribute('aria-label');\n    if (ariaLabel) return cleanLabelText(ariaLabel);\n    const ariaLabelledBy = element.getAttribute('aria-labelledby');\n    if (ariaLabelledBy) {\n      const labelEl = document.getElementById(ariaLabelledBy);\n      if (labelEl) return cleanLabelText(labelEl.textContent);\n    }\n    const wrappingLabel = element.closest('label');\n    if (wrappingLabel) {\n      const clone = wrappingLabel.cloneNode(true);\n      const inputs = clone.querySelectorAll('input, select, textarea, button');\n      inputs.forEach(i => i.remove());\n      const text = clone.textContent.trim();\n      if (text) return cleanLabelText(text);\n    }\n    if (element.placeholder) return cleanLabelText(element.placeholder);\n    const title = element.getAttribute('title');\n    if (title) return cleanLabelText(title);\n    if (element.name) {\n      return element.name\n        .replace(/[_-]/g, ' ')\n        .replace(/([a-z])([A-Z])/g, '$1 $2')\n        .replace(/^./, s => s.toUpperCase());\n    }\n    return 'Unlabeled field';\n  }\n\n  function extractButtonLabel(element) {\n    const ariaLabel = element.getAttribute('aria-label');\n    if (ariaLabel) return ariaLabel.trim();\n    if (element.value && element.type !== 'submit') return element.value;\n    const text = element.textContent.trim();\n    if (text) return text;\n    if (element.value) return element.value;\n    const title = element.getAttribute('title');\n    if (title) return title;\n    return 'Button';\n  }\n\n  function getFieldValue(element) {\n    const tag = element.tagName.toLowerCase();\n    const type = element.type?.toLowerCase() || 'text';\n    if (tag === 'select') {\n      if (element.multiple) {\n        return Array.from(element.selectedOptions).map(o => o.value);\n      }\n      return element.value;\n    }\n    if (type === 'checkbox' || type === 'radio') {\n      return element.checked;\n    }\n    if (element.getAttribute('role') === 'checkbox' || element.getAttribute('role') === 'switch') {\n      return element.getAttribute('aria-checked') === 'true';\n    }\n    if (element.isContentEditable) {\n      return element.textContent || '';\n    }\n    return element.value || '';\n  }\n\n  function getFieldState(element, value) {\n    const type = element.type?.toLowerCase() || 'text';\n    if (type === 'checkbox' || element.getAttribute('role') === 'checkbox' || element.getAttribute('role') === 'switch') {\n      return value ? 'checked' : 'unchecked';\n    }\n    if (type === 'radio') {\n      return value ? 'checked' : 'unchecked';\n    }\n    if (Array.isArray(value)) {\n      return value.length > 0 ? 'filled' : 'empty';\n    }\n    if (typeof value === 'string') {\n      return value.length > 0 ? 'filled' : 'empty';\n    }\n    return 'empty';\n  }\n\n  function getFieldType(element) {\n    const tag = element.tagName.toLowerCase();\n    const role = element.getAttribute('role');\n    if (role === 'textbox') return 'textbox';\n    if (role === 'checkbox') return 'checkbox';\n    if (role === 'radio') return 'radio';\n    if (role === 'combobox') return 'combobox';\n    if (role === 'listbox') return 'listbox';\n    if (role === 'switch') return 'switch';\n    if (element.isContentEditable) return 'contenteditable';\n    if (tag === 'textarea') return 'textarea';\n    if (tag === 'select') return 'select';\n    if (tag === 'input') {\n      const type = element.type?.toLowerCase() || 'text';\n      return type;\n    }\n    return 'unknown';\n  }\n\n  function isNativeInput(element) {\n    const tag = element.tagName.toLowerCase();\n    return tag === 'input' || tag === 'textarea' || tag === 'select';\n  }\n\n  function getSelectOptions(element) {\n    if (element.tagName.toLowerCase() !== 'select') return undefined;\n    return Array.from(element.options).map(opt => ({\n      value: opt.value,\n      label: opt.textContent.trim(),\n      selected: opt.selected\n    }));\n  }\n\n  function findSiblingError(element) {\n    const next = element.nextElementSibling;\n    if (next) {\n      const isError = next.classList.contains('error') ||\n                      next.classList.contains('invalid') ||\n                      next.classList.contains('field-error') ||\n                      next.classList.contains('error-message') ||\n                      next.getAttribute('role') === 'alert';\n      if (isError) return next.textContent.trim();\n    }\n    // aria-errormessage always names the error; aria-describedby does when the\n    // field is marked invalid or the description looks like an error\n    const invalid = element.getAttribute('aria-invalid') === 'true';\n    const errorIds = (element.getAttribute('aria-errormessage') || '').split(/\\s+/).filter(Boolean);\n    const describedIds = (element.getAttribute('aria-describedby') || '').split(/\\s+/).filter(Boolean);\n    for (const id of [...errorIds, ...describedIds]) {\n      const target = document.getElementById(id);\n      const looksLikeError = errorIds.includes(id) || invalid ||\n        /error|invalid|alert/i.test(target ? target.className + ' ' + (target.getAttribute('role') || '') : '');\n      if (target && looksLikeError && target.textContent.trim()) {\n        return target.textContent.trim();\n      }\n    }\n    const parent = element.parentElement;\n    const controls = parent ? parent.querySelectorAll('input, select, textarea, [contenteditable=\"true\"]') : [];\n    if (parent && controls.length === 1) {\n      const errorEl = parent.querySelector('.error-message, .field-error, [role=\"alert\"]');\n      if (errorEl && errorEl !== element) return errorEl.textContent.trim();\n    }\n    return undefined;\n  }\n\n  function calculateRelevance(formEl, fields, buttons) {\n    let score = 0;\n    const rect = formEl.getBoundingClientRect();\n    const viewportHeight = window.innerHeight;\n    const viewportWidth = window.innerWidth;\n    const centerX = rect.left + rect.width / 2;\n    const centerY = rect.top + rect.height / 2;\n    if (centerX > viewportWidth * 0.2 && centerX < viewportWidth * 0.8) score += 10;\n    if (centerY > 0 && centerY < viewportHeight) score += 5;\n    const isInMain = formEl.closest('main, [role=\"main\"], article, .main-content, #main');\n    if (isInMain) score += 15;\n    const isInHeader = formEl.closest('header, [role=\"banner\"], nav, [role=\"navigation\"]');\n    if (isInHeader) score -= 10;\n    const isInAside = formEl.closest('aside, [role=\"complementary\"], footer, [role=\"contentinfo\"]');\n    if (isInAside) score -= 5;\n    const distinctFields = new Set(\n      fields.map((f) => (f.type === 'radio' || f.type === 'checkbox') && f.name ? f.type + ':' + f.name : f.index)\n    ).size;\n    score += Math.min(distinctFields * 3, 30);\n    const textTypes = ['text', 'search', 'email', 'password', 'textarea', 'tel', 'url', 'number', 'textbox'];\n    if (fields.some((f) => textTypes.includes(f.type))) score += 10;\n    const hasSubmit = buttons.some(b => b.type === 'submit' || b.isPrimary);\n    if (hasSubmit) score += 10;\n    const style = window.getComputedStyle(formEl);\n    if (style.display === 'none' || style.visibility === 'hidden') score -= 100;\n    return score;\n  }\n\n  function detectFormStep(formEl) {\n    const stepIndicators = formEl.querySelectorAll('[aria-current=\"step\"], .step.active, .wizard-step.current');\n    if (stepIndicators.length === 0) {\n      const pageSteps = document.querySelectorAll('.step, .wizard-step, [role=\"tablist\"] [role=\"tab\"]');\n      if (pageSteps.length > 1) {\n        const activeIndex = Array.from(pageSteps).findIndex(s =>\n          s.classList.contains('active') ||\n          s.classList.contains('current') ||\n          s.getAttribute('aria-selected') === 'true'\n        );\n        if (activeIndex >= 0) {\n          return { current: activeIndex + 1, total: pageSteps.length };\n        }\n      }\n    }\n    const ariaStep = formEl.querySelector('[aria-current=\"step\"]');\n    if (ariaStep) {\n      const allSteps = formEl.querySelectorAll('[role=\"listitem\"], .step');\n      const currentIdx = Array.from(allSteps).indexOf(ariaStep);\n      if (currentIdx >= 0) {\n        return { current: currentIdx + 1, total: allSteps.length };\n      }\n    }\n    return null;\n  }\n\n  function findNearbyHeading(formEl) {\n    let sibling = formEl.previousElementSibling;\n    let distance = 0;\n    while (sibling && distance < 3) {\n      if (sibling.matches('h1, h2, h3, h4, h5, h6, [role=\"heading\"]')) {\n        return sibling.textContent.trim();\n      }\n      const heading = sibling.querySelector('h1, h2, h3, h4, h5, h6, [role=\"heading\"]');\n      if (heading) return heading.textContent.trim();\n      sibling = sibling.previousElementSibling;\n      distance++;\n    }\n    const parent = formEl.parentElement;\n    if (parent) {\n      const heading = parent.querySelector(':scope > h1, :scope > h2, :scope > h3');\n      if (heading && heading.compareDocumentPosition(formEl) & Node.DOCUMENT_POSITION_FOLLOWING) {\n        return heading.textContent.trim();\n      }\n    }\n    return null;\n  }\n\n  function matchesWord(text, word) {\n    const pattern = new RegExp('\\\\b' + word + '\\\\b', 'i');\n    return pattern.test(text);\n  }\n\n  function inferFormType(formEl) {\n    const inputs = formEl.querySelectorAll('input, textarea, select');\n    const types = Array.from(inputs).map(i => i.type?.toLowerCase() || i.tagName.toLowerCase());\n    const names = Array.from(inputs).map(i => (i.name || '').toLowerCase());\n    const allText = (Array.from(inputs).map(i => i.name + ' ' + i.placeholder + ' ' + i.id).join(' ')).toLowerCase();\n    if (types.includes('password')) {\n      if (types.filter(t => t === 'password').length >= 2) return 'Change Password';\n      if (matchesWord(allText, 'register') || matchesWord(allText, 'signup') || matchesWord(allText, 'create')) return 'Registration';\n      return 'Login';\n    }\n    const hasSearchRole = formEl.closest('[role=\"search\"]') || formEl.getAttribute('role') === 'search';\n    const hasSearchInput = formEl.querySelector('[type=\"search\"], [aria-label*=\"search\" i]');\n    if (hasSearchRole || hasSearchInput) return 'Search';\n    const interactiveTypes = types.filter(t => !['hidden', 'submit', 'button', 'reset', 'image'].includes(t));\n    if (interactiveTypes.length <= 2 && matchesWord(allText, 'search')) return 'Search';\n    if (matchesWord(allText, 'address') || matchesWord(allText, 'street') || matchesWord(allText, 'postcode') ||\n        matchesWord(allText, 'zipcode') || matchesWord(allText, 'city') || matchesWord(allText, 'county')) {\n      return 'Address';\n    }\n    if (matchesWord(allText, 'email') && (matchesWord(allText, 'message') || matchesWord(allText, 'subject'))) {\n      return 'Contact';\n    }\n    if (matchesWord(allText, 'card') || matchesWord(allText, 'cvv') || matchesWord(allText, 'expiry')) {\n      return 'Payment';\n    }\n    if (names.some(n => matchesWord(n, 'subscribe') || matchesWord(n, 'newsletter'))) {\n      return 'Newsletter';\n    }\n    return null;\n  }\n\n  function extractFormName(formEl) {\n    const ariaLabel = formEl.getAttribute('aria-label');\n    if (ariaLabel) return ariaLabel;\n    const ariaLabelledBy = formEl.getAttribute('aria-labelledby');\n    if (ariaLabelledBy) {\n      const labelEl = document.getElementById(ariaLabelledBy);\n      if (labelEl) return labelEl.textContent.trim();\n    }\n    const headings = formEl.querySelectorAll('h1, h2, h3, h4, h5, h6, [role=\"heading\"]');\n    for (const h of headings) {\n      if (!h.closest('[role=\"dialog\"], [role=\"alertdialog\"], [aria-modal=\"true\"]')) {\n        return h.textContent.trim();\n      }\n    }\n    const title = formEl.getAttribute('title');\n    if (title) return title;\n    const name = formEl.getAttribute('name');\n    if (name) {\n      return name\n        .replace(/[_-]/g, ' ')\n        .replace(/([a-z])([A-Z])/g, '$1 $2')\n        .replace(/^./, s => s.toUpperCase());\n    }\n    const nearbyHeading = findNearbyHeading(formEl);\n    if (nearbyHeading) return nearbyHeading;\n    const inferredType = inferFormType(formEl);\n    if (inferredType) return inferredType;\n    return null;\n  }\n\n  function discoverFields(container, formIndex, startIndex) {\n    const fields = [];\n    const nativeInputs = container.querySelectorAll(\n      'input:not([type=\"hidden\"]):not([type=\"submit\"]):not([type=\"button\"]):not([type=\"reset\"]):not([type=\"image\"]), ' +\n      'textarea, ' +\n      'select'\n    );\n    const customInputs = container.querySelectorAll(\n      '[role=\"textbox\"], ' +\n      '[role=\"checkbox\"]:not(input), ' +\n      '[role=\"radio\"]:not(input), ' +\n      '[role=\"combobox\"], ' +\n      '[role=\"listbox\"], ' +\n      '[role=\"switch\"], ' +\n      '[contenteditable=\"true\"]'\n    );\n    const allInputs = new Set([...nativeInputs, ...customInputs]);\n    let idx = startIndex;\n    for (const el of allInputs) {\n      const style = window.getComputedStyle(el);\n      const isHidden = style.display === 'none' || style.visibility === 'hidden' || el.type === 'hidden';\n      const value = getFieldValue(el);\n      fields.push({\n        index: idx,\n        formIndex: formIndex,\n        selector: generateSelector(el),\n        type: getFieldType(el),\n        inputType: el.type?.toLowerCase(),\n        label: extractLabel(el),\n        name: el.name || null,\n        placeholder: el.placeholder || undefined,\n        required: el.required || el.getAttribute('aria-required') === 'true',\n        disabled: el.disabled || el.getAttribute('aria-disabled') === 'true',\n        readOnly: el.readOnly || false,\n        hidden: isHidden,\n        native: isNativeInput(el),\n        value: value,\n        checked: el.checked,\n        validationMessage: el.validationMessage || undefined,\n        isValid: el.validity ? el.validity.valid : true,\n        valueMissing: el.validity ? el.validity.valueMissing : false,\n        ariaInvalid: el.getAttribute('aria-invalid') === 'true',\n        hasErrorClass: el.classList.contains('error') || el.classList.contains('invalid'),\n        siblingErrorText: findSiblingError(el),\n        options: getSelectOptions(el)\n      });\n      idx++;\n    }\n    return fields;\n  }\n\n  function discoverButtons(container, startIndex) {\n    const buttons = [];\n    const buttonEls = container.querySelectorAll(\n      'button, ' +\n      'input[type=\"submit\"], ' +\n      'input[type=\"button\"], ' +\n      'input[type=\"reset\"], ' +\n      '[role=\"button\"]'\n    );\n    let idx = startIndex;\n    for (const el of buttonEls) {\n      const style = window.getComputedStyle(el);\n      if (style.display === 'none' || style.visibility === 'hidden') continue;\n      const type = el.type?.toLowerCase() || 'button';\n      const btnType = type === 'submit' ? 'submit' : type === 'reset' ? 'reset' : 'button';\n      const isPrimary = btnType === 'submit' ||\n                        el.classList.contains('primary') ||\n                        el.classList.contains('btn-primary') ||\n                        el.classList.contains('submit');\n      buttons.push({\n        index: idx,\n        selector: generateSelector(el),\n        label: extractButtonLabel(el),\n        type: btnType,\n        disabled: el.disabled || el.getAttribute('aria-disabled') === 'true',\n        isPrimary: isPrimary\n      });\n      idx++;\n    }\n    return buttons;\n  }\n\n  const forms = document.querySelectorAll('form');\n  let globalIndex = 0;\n\n  if (forms.length === 0) {\n    const bodyFields = discoverFields(document.body, 0, 0);\n    const bodyButtons = discoverButtons(document.body, bodyFields.length);\n    if (bodyFields.length > 0) {\n      result.forms.push({\n        index: 0,\n        name: document.title || 'Page',\n        action: null,\n        method: 'GET',\n        step: null,\n        relevanceScore: bodyFields.length * 3,\n        inIframe: false,\n        fields: bodyFields,\n        buttons: bodyButtons\n      });\n    }\n  } else {\n    for (let i = 0; i < forms.length; i++) {\n      const formEl = forms[i];\n      const fields = discoverFields(formEl, i, globalIndex);\n      globalIndex += fields.length;\n      const buttons = discoverButtons(formEl, globalIndex);\n      globalIndex += buttons.length;\n      const inIframe = formEl.ownerDocument !== document;\n      result.forms.push({\n        index: i,\n        name: extractFormName(formEl),\n        action: formEl.action || null,\n        method: (formEl.method || 'GET').toUpperCase(),\n        step: detectFormStep(formEl),\n        relevanceScore: calculateRelevance(formEl, fields, buttons),\n        inIframe: inIframe,\n        fields: fields,\n        buttons: buttons\n      });\n    }\n  }\n\n  result.forms.sort((a, b) => b.relevanceScore - a.relevanceScore);\n\n  // Forms the main document does not contain may be in its same-origin iframes\n  if (result.forms.length === 0) {\n    result.frameForms = [];\n    for (const frame of document.querySelectorAll('iframe, frame')) {\n      let frameDocument = null;\n      try { frameDocument = frame.contentDocument; } catch (e) { frameDocument = null; }\n      if (frameDocument && frameDocument.querySelector('form, input:not([type=hidden]), select, textarea')) {\n        result.frameForms.push({ url: frame.src || 'about:blank' });\n      }\n    }\n  }\n\n  return result;\n})()\n";
+export declare const FORM_DISCOVERY_SCRIPT = "\n(function() {\n  const result = { forms: [] };\n\n  // Rendered and not visibility-hidden, ancestors included (opacity is left\n  // out: styled checkboxes and radios are often transparent)\n  function isShown(element) {\n    if (typeof element.checkVisibility === 'function') {\n      return element.checkVisibility({ visibilityProperty: true });\n    }\n    const style = window.getComputedStyle(element);\n    return style.display !== 'none' && style.visibility !== 'hidden';\n  }\n\n  // Inside an open dialog: <dialog open>, aria-modal or a dialog role, or a\n  // modal without them (DocSearch): an overlay ancestor below <body>\n  // (position fixed or absolute) that is raised (z-index > 0) or has a\n  // backdrop and whose class names a modal or dialog, or a fixed overlay over\n  // half the viewport or more that is raised or lies over other page content\n  // at the viewport centre. Static wrappers (Drupal's\n  // dialog-off-canvas-main-canvas) and fixed app shells holding the whole\n  // page are not dialogs.\n  function inDialog(element) {\n    if (element.closest('dialog[open], [aria-modal=\"true\"], [role=\"dialog\"], [role=\"alertdialog\"]')) return true;\n    const viewportArea = window.innerWidth * window.innerHeight;\n    for (let node = element.parentElement; node && node !== document.body; node = node.parentElement) {\n      const style = window.getComputedStyle(node);\n      if (style.position !== 'fixed' && style.position !== 'absolute') continue;\n      const raised = parseInt(style.zIndex, 10) > 0;\n      const className = typeof node.className === 'string' ? node.className : '';\n      if (/(^|[\\s_-])(modal|dialog)($|[\\s_-])/i.test(className) && (raised || hasBackdrop(node))) return true;\n      if (style.position !== 'fixed') continue;\n      const box = node.getBoundingClientRect();\n      if (box.width * box.height >= viewportArea / 2 && (raised || coversContent(node))) return true;\n    }\n    return false;\n  }\n\n  // A backdrop element next to or inside an overlay\n  function hasBackdrop(node) {\n    const backdrop = /backdrop|overlay/i;\n    const near = [node.previousElementSibling, node.nextElementSibling, ...Array.from(node.children)];\n    return near.some((n) => n && typeof n.className === 'string' && backdrop.test(n.className));\n  }\n\n  // The overlay is on top at the viewport centre with other page content\n  // (not its ancestors) below it\n  function coversContent(node) {\n    const stack = document.elementsFromPoint(window.innerWidth / 2, window.innerHeight / 2);\n    if (!stack.length || !node.contains(stack[0])) return false;\n    return stack.some((n) => !n.contains(node) && !node.contains(n));\n  }\n\n  function isUnique(selector) {\n    try {\n      return document.querySelectorAll(selector).length === 1;\n    } catch (e) {\n      return false;\n    }\n  }\n\n  function generateSelector(element) {\n    if (element.id && isUnique('#' + CSS.escape(element.id))) {\n      return '#' + CSS.escape(element.id);\n    }\n    if (element.name) {\n      const byName = element.tagName.toLowerCase() + '[name=\"' + CSS.escape(element.name) + '\"]';\n      if (isUnique(byName)) return byName;\n      const byValue = byName + '[value=\"' + CSS.escape(element.getAttribute('value') || '') + '\"]';\n      if (element.hasAttribute('value') && isUnique(byValue)) return byValue;\n    }\n    const tag = element.tagName.toLowerCase();\n    const parent = element.parentElement;\n    if (!parent) return tag;\n    const siblings = Array.from(parent.children).filter(c => c.tagName === element.tagName);\n    if (siblings.length === 1) {\n      const parentSelector = generateSelector(parent);\n      return parentSelector + ' > ' + tag;\n    }\n    const index = siblings.indexOf(element);\n    const parentSelector = generateSelector(parent);\n    return parentSelector + ' > ' + tag + ':nth-of-type(' + (index + 1) + ')';\n  }\n\n  function cleanLabelText(text) {\n    if (!text) return text;\n    const patterns = [\n      /Previous\\s*arrow/gi,\n      /Next\\s*arrow/gi,\n      /\\barrow\\b/gi,\n      /\\bchevron\\b/gi,\n      /\u2190|\u2192|\u2191|\u2193|\u25B2|\u25BC|\u25C0|\u25B6/g,\n      /\\u25C0|\\u25B6|\\u25B2|\\u25BC/g,\n      /^\\s*[<>]\\s*/,\n      /\\s*[<>]\\s*$/,\n    ];\n    let cleaned = text;\n    for (const pattern of patterns) {\n      cleaned = cleaned.replace(pattern, '');\n    }\n    cleaned = cleaned.replace(/\\s{2,}/g, ' ').trim();\n    cleaned = cleaned.replace(/^\\*\\s+/, '').replace(/\\s+\\*(\\s*:?)$/, '$1');\n    return cleaned || text.trim();\n  }\n\n  // The element labelling a field: label[for], aria-labelledby, wrapping label\n  function labelElement(element) {\n    const labelFor = element.id ? document.querySelector('label[for=\"' + CSS.escape(element.id) + '\"]') : null;\n    const labelledBy = element.getAttribute('aria-labelledby');\n    return labelFor || (labelledBy && document.getElementById(labelledBy)) || element.closest('label');\n  }\n\n  // A standalone required star in label text: \"* Name\", \"Name *\", \"Name *:\"\n  // (not a footnote mark such as \"Terms*\")\n  function labelMarksRequired(text) {\n    return /^\\*\\s|\\s\\*\\s*:?$/.test(String(text).trim());\n  }\n\n  // Required by attribute, ARIA, or a label marked with a standalone star,\n  // or with an element of its own holding just \"*\" (<span aria-hidden>*</span>)\n  function isRequired(element) {\n    if (element.required || element.getAttribute('aria-required') === 'true') return true;\n    const label = labelElement(element);\n    if (!label) return false;\n    const clone = label.cloneNode(true);\n    clone.querySelectorAll('input, select, textarea, button').forEach(i => i.remove());\n    return labelMarksRequired(clone.textContent || '') ||\n      Array.from(clone.querySelectorAll('*')).some(n => n.textContent.trim() === '*');\n  }\n\n  // Name of the radio or checkbox group a field belongs to: its radiogroup's\n  // label, its fieldset's legend, or its name\n  function groupLabel(element) {\n    const type = element.type?.toLowerCase();\n    if ((type !== 'radio' && type !== 'checkbox') || !element.name) return undefined;\n    const group = element.closest('[role=\"radiogroup\"], fieldset');\n    const named = group && (group.getAttribute('aria-label') ||\n      (group.querySelector(':scope > legend') || {}).textContent);\n    if (named && named.trim()) return cleanLabelText(named);\n    return element.name\n      .replace(/[_-]/g, ' ')\n      .replace(/([a-z])([A-Z])/g, '$1 $2')\n      .replace(/^./, s => s.toUpperCase());\n  }\n\n  function extractLabel(element) {\n    if (element.id) {\n      const labelFor = document.querySelector('label[for=\"' + CSS.escape(element.id) + '\"]');\n      if (labelFor) return cleanLabelText(labelFor.textContent);\n    }\n    const ariaLabel = element.getAttribute('aria-label');\n    if (ariaLabel) return cleanLabelText(ariaLabel);\n    const ariaLabelledBy = element.getAttribute('aria-labelledby');\n    if (ariaLabelledBy) {\n      const labelEl = document.getElementById(ariaLabelledBy);\n      if (labelEl) return cleanLabelText(labelEl.textContent);\n    }\n    const wrappingLabel = element.closest('label');\n    if (wrappingLabel) {\n      const clone = wrappingLabel.cloneNode(true);\n      const inputs = clone.querySelectorAll('input, select, textarea, button');\n      inputs.forEach(i => i.remove());\n      const text = clone.textContent.trim();\n      if (text) return cleanLabelText(text);\n    }\n    if (element.placeholder) return cleanLabelText(element.placeholder);\n    const title = element.getAttribute('title');\n    if (title) return cleanLabelText(title);\n    if (element.name) {\n      return element.name\n        .replace(/[_-]/g, ' ')\n        .replace(/([a-z])([A-Z])/g, '$1 $2')\n        .replace(/^./, s => s.toUpperCase());\n    }\n    return 'Unlabeled field';\n  }\n\n  function extractButtonLabel(element) {\n    const ariaLabel = element.getAttribute('aria-label');\n    if (ariaLabel) return ariaLabel.trim();\n    if (element.value && element.type !== 'submit') return element.value;\n    const text = element.textContent.trim();\n    if (text) return text;\n    if (element.value) return element.value;\n    const title = element.getAttribute('title');\n    if (title) return title;\n    return 'Button';\n  }\n\n  function getFieldValue(element) {\n    const tag = element.tagName.toLowerCase();\n    const type = element.type?.toLowerCase() || 'text';\n    if (tag === 'select') {\n      if (element.multiple) {\n        return Array.from(element.selectedOptions).map(o => o.value);\n      }\n      return element.value;\n    }\n    if (type === 'checkbox' || type === 'radio') {\n      return element.checked;\n    }\n    if (element.getAttribute('role') === 'checkbox' || element.getAttribute('role') === 'switch') {\n      return element.getAttribute('aria-checked') === 'true';\n    }\n    if (element.isContentEditable) {\n      return element.textContent || '';\n    }\n    return element.value || '';\n  }\n\n  function getFieldState(element, value) {\n    const type = element.type?.toLowerCase() || 'text';\n    if (type === 'checkbox' || element.getAttribute('role') === 'checkbox' || element.getAttribute('role') === 'switch') {\n      return value ? 'checked' : 'unchecked';\n    }\n    if (type === 'radio') {\n      return value ? 'checked' : 'unchecked';\n    }\n    if (Array.isArray(value)) {\n      return value.length > 0 ? 'filled' : 'empty';\n    }\n    if (typeof value === 'string') {\n      return value.length > 0 ? 'filled' : 'empty';\n    }\n    return 'empty';\n  }\n\n  function getFieldType(element) {\n    const tag = element.tagName.toLowerCase();\n    const role = element.getAttribute('role');\n    if (role === 'textbox') return 'textbox';\n    if (role === 'checkbox') return 'checkbox';\n    if (role === 'radio') return 'radio';\n    if (role === 'combobox') return 'combobox';\n    if (role === 'listbox') return 'listbox';\n    if (role === 'switch') return 'switch';\n    if (element.isContentEditable) return 'contenteditable';\n    if (tag === 'textarea') return 'textarea';\n    if (tag === 'select') return 'select';\n    if (tag === 'input') {\n      const type = element.type?.toLowerCase() || 'text';\n      return type;\n    }\n    return 'unknown';\n  }\n\n  function isNativeInput(element) {\n    const tag = element.tagName.toLowerCase();\n    return tag === 'input' || tag === 'textarea' || tag === 'select';\n  }\n\n  function getSelectOptions(element) {\n    if (element.tagName.toLowerCase() !== 'select') return undefined;\n    return Array.from(element.options).map(opt => ({\n      value: opt.value,\n      label: opt.textContent.trim(),\n      selected: opt.selected\n    }));\n  }\n\n  function findSiblingError(element) {\n    const next = element.nextElementSibling;\n    if (next) {\n      const isError = next.classList.contains('error') ||\n                      next.classList.contains('invalid') ||\n                      next.classList.contains('field-error') ||\n                      next.classList.contains('error-message') ||\n                      next.getAttribute('role') === 'alert';\n      if (isError) return next.textContent.trim();\n    }\n    // aria-errormessage always names the error; aria-describedby does when the\n    // field is marked invalid or the description looks like an error\n    const invalid = element.getAttribute('aria-invalid') === 'true';\n    const errorIds = (element.getAttribute('aria-errormessage') || '').split(/\\s+/).filter(Boolean);\n    const describedIds = (element.getAttribute('aria-describedby') || '').split(/\\s+/).filter(Boolean);\n    for (const id of [...errorIds, ...describedIds]) {\n      const target = document.getElementById(id);\n      const looksLikeError = errorIds.includes(id) || invalid ||\n        /error|invalid|alert/i.test(target ? target.className + ' ' + (target.getAttribute('role') || '') : '');\n      if (target && looksLikeError && target.textContent.trim()) {\n        return target.textContent.trim();\n      }\n    }\n    const parent = element.parentElement;\n    const controls = parent ? parent.querySelectorAll('input, select, textarea, [contenteditable=\"true\"]') : [];\n    if (parent && controls.length === 1) {\n      const errorEl = parent.querySelector('.error-message, .field-error, [role=\"alert\"]');\n      if (errorEl && errorEl !== element) return errorEl.textContent.trim();\n    }\n    return undefined;\n  }\n\n  function calculateRelevance(formEl, fields, buttons) {\n    let score = 0;\n    const rect = formEl.getBoundingClientRect();\n    const viewportHeight = window.innerHeight;\n    const viewportWidth = window.innerWidth;\n    const centerX = rect.left + rect.width / 2;\n    const centerY = rect.top + rect.height / 2;\n    if (centerX > viewportWidth * 0.2 && centerX < viewportWidth * 0.8) score += 10;\n    if (centerY > 0 && centerY < viewportHeight) score += 5;\n    const isInMain = formEl.closest('main, [role=\"main\"], article, .main-content, #main');\n    if (isInMain) score += 15;\n    const isInHeader = formEl.closest('header, [role=\"banner\"], nav, [role=\"navigation\"]');\n    if (isInHeader) score -= 10;\n    const isInAside = formEl.closest('aside, [role=\"complementary\"], footer, [role=\"contentinfo\"]');\n    if (isInAside) score -= 5;\n    const distinctFields = new Set(\n      fields.map((f) => (f.type === 'radio' || f.type === 'checkbox') && f.name ? f.type + ':' + f.name : f.index)\n    ).size;\n    score += Math.min(distinctFields * 3, 30);\n    const textTypes = ['text', 'search', 'email', 'password', 'textarea', 'tel', 'url', 'number', 'textbox'];\n    if (fields.some((f) => textTypes.includes(f.type))) score += 10;\n    const hasSubmit = buttons.some(b => b.type === 'submit' || b.primaryClass);\n    if (hasSubmit) score += 10;\n    const style = window.getComputedStyle(formEl);\n    if (style.display === 'none' || style.visibility === 'hidden') score -= 100;\n    return score;\n  }\n\n  function detectFormStep(formEl) {\n    const stepIndicators = formEl.querySelectorAll('[aria-current=\"step\"], .step.active, .wizard-step.current');\n    if (stepIndicators.length === 0) {\n      const pageSteps = document.querySelectorAll('.step, .wizard-step, [role=\"tablist\"] [role=\"tab\"]');\n      if (pageSteps.length > 1) {\n        const activeIndex = Array.from(pageSteps).findIndex(s =>\n          s.classList.contains('active') ||\n          s.classList.contains('current') ||\n          s.getAttribute('aria-selected') === 'true'\n        );\n        if (activeIndex >= 0) {\n          return { current: activeIndex + 1, total: pageSteps.length };\n        }\n      }\n    }\n    const ariaStep = formEl.querySelector('[aria-current=\"step\"]');\n    if (ariaStep) {\n      const allSteps = formEl.querySelectorAll('[role=\"listitem\"], .step');\n      const currentIdx = Array.from(allSteps).indexOf(ariaStep);\n      if (currentIdx >= 0) {\n        return { current: currentIdx + 1, total: allSteps.length };\n      }\n    }\n    return null;\n  }\n\n  function findNearbyHeading(formEl) {\n    let sibling = formEl.previousElementSibling;\n    let distance = 0;\n    while (sibling && distance < 3) {\n      if (sibling.matches('h1, h2, h3, h4, h5, h6, [role=\"heading\"]')) {\n        return sibling.textContent.trim();\n      }\n      const heading = sibling.querySelector('h1, h2, h3, h4, h5, h6, [role=\"heading\"]');\n      if (heading) return heading.textContent.trim();\n      sibling = sibling.previousElementSibling;\n      distance++;\n    }\n    const parent = formEl.parentElement;\n    if (parent) {\n      const heading = parent.querySelector(':scope > h1, :scope > h2, :scope > h3');\n      if (heading && heading.compareDocumentPosition(formEl) & Node.DOCUMENT_POSITION_FOLLOWING) {\n        return heading.textContent.trim();\n      }\n    }\n    return null;\n  }\n\n  function matchesWord(text, word) {\n    const pattern = new RegExp('\\\\b' + word + '\\\\b', 'i');\n    return pattern.test(text);\n  }\n\n  function inferFormType(formEl) {\n    const inputs = formEl.querySelectorAll('input, textarea, select');\n    const types = Array.from(inputs).map(i => i.type?.toLowerCase() || i.tagName.toLowerCase());\n    const names = Array.from(inputs).map(i => (i.name || '').toLowerCase());\n    const allText = (Array.from(inputs).map(i => i.name + ' ' + i.placeholder + ' ' + i.id).join(' ')).toLowerCase();\n    if (types.includes('password')) {\n      if (types.filter(t => t === 'password').length >= 2) return 'Change Password';\n      if (matchesWord(allText, 'register') || matchesWord(allText, 'signup') || matchesWord(allText, 'create')) return 'Registration';\n      return 'Login';\n    }\n    const hasSearchRole = formEl.closest('[role=\"search\"]') || formEl.getAttribute('role') === 'search';\n    const hasSearchInput = formEl.querySelector('[type=\"search\"], [aria-label*=\"search\" i]');\n    if (hasSearchRole || hasSearchInput) return 'Search';\n    const interactiveTypes = types.filter(t => !['hidden', 'submit', 'button', 'reset', 'image'].includes(t));\n    if (interactiveTypes.length <= 2 && matchesWord(allText, 'search')) return 'Search';\n    if (matchesWord(allText, 'address') || matchesWord(allText, 'street') || matchesWord(allText, 'postcode') ||\n        matchesWord(allText, 'zipcode') || matchesWord(allText, 'city') || matchesWord(allText, 'county')) {\n      return 'Address';\n    }\n    if (matchesWord(allText, 'email') && (matchesWord(allText, 'message') || matchesWord(allText, 'subject'))) {\n      return 'Contact';\n    }\n    if (matchesWord(allText, 'card') || matchesWord(allText, 'cvv') || matchesWord(allText, 'expiry')) {\n      return 'Payment';\n    }\n    if (names.some(n => matchesWord(n, 'subscribe') || matchesWord(n, 'newsletter'))) {\n      return 'Newsletter';\n    }\n    return null;\n  }\n\n  function extractFormName(formEl) {\n    const ariaLabel = formEl.getAttribute('aria-label');\n    if (ariaLabel) return ariaLabel;\n    const ariaLabelledBy = formEl.getAttribute('aria-labelledby');\n    if (ariaLabelledBy) {\n      const labelEl = document.getElementById(ariaLabelledBy);\n      if (labelEl) return labelEl.textContent.trim();\n    }\n    const headings = formEl.querySelectorAll('h1, h2, h3, h4, h5, h6, [role=\"heading\"]');\n    for (const h of headings) {\n      if (!h.closest('[role=\"dialog\"], [role=\"alertdialog\"], [aria-modal=\"true\"]')) {\n        return h.textContent.trim();\n      }\n    }\n    const title = formEl.getAttribute('title');\n    if (title) return title;\n    const name = formEl.getAttribute('name');\n    if (name) {\n      return name\n        .replace(/[_-]/g, ' ')\n        .replace(/([a-z])([A-Z])/g, '$1 $2')\n        .replace(/^./, s => s.toUpperCase());\n    }\n    const nearbyHeading = findNearbyHeading(formEl);\n    if (nearbyHeading) return nearbyHeading;\n    const inferredType = inferFormType(formEl);\n    if (inferredType) return inferredType;\n    return null;\n  }\n\n  function discoverFields(container, formIndex, startIndex) {\n    const fields = [];\n    const nativeInputs = container.querySelectorAll(\n      'input:not([type=\"hidden\"]):not([type=\"submit\"]):not([type=\"button\"]):not([type=\"reset\"]):not([type=\"image\"]), ' +\n      'textarea, ' +\n      'select'\n    );\n    const customInputs = container.querySelectorAll(\n      '[role=\"textbox\"], ' +\n      '[role=\"checkbox\"]:not(input), ' +\n      '[role=\"radio\"]:not(input), ' +\n      '[role=\"combobox\"], ' +\n      '[role=\"listbox\"], ' +\n      '[role=\"switch\"], ' +\n      '[contenteditable=\"true\"]'\n    );\n    const allInputs = new Set([...nativeInputs, ...customInputs]);\n    let idx = startIndex;\n    for (const el of allInputs) {\n      const isHidden = el.type === 'hidden' || !isShown(el);\n      const value = getFieldValue(el);\n      fields.push({\n        index: idx,\n        formIndex: formIndex,\n        selector: generateSelector(el),\n        type: getFieldType(el),\n        inputType: el.type?.toLowerCase(),\n        label: extractLabel(el),\n        name: el.name || null,\n        placeholder: el.placeholder || undefined,\n        required: isRequired(el),\n        groupLabel: groupLabel(el),\n        disabled: el.disabled || el.getAttribute('aria-disabled') === 'true',\n        readOnly: el.readOnly || false,\n        hidden: isHidden,\n        native: isNativeInput(el),\n        value: value,\n        checked: el.checked,\n        validationMessage: el.validationMessage || undefined,\n        isValid: el.validity ? el.validity.valid : true,\n        valueMissing: el.validity ? el.validity.valueMissing : false,\n        ariaInvalid: el.getAttribute('aria-invalid') === 'true',\n        hasErrorClass: el.classList.contains('error') || el.classList.contains('invalid'),\n        siblingErrorText: findSiblingError(el),\n        options: getSelectOptions(el)\n      });\n      idx++;\n    }\n    return fields;\n  }\n\n  function discoverButtons(container, startIndex) {\n    const buttons = [];\n    const buttonEls = container.querySelectorAll(\n      'button, ' +\n      'input[type=\"submit\"], ' +\n      'input[type=\"button\"], ' +\n      'input[type=\"reset\"], ' +\n      '[role=\"button\"]'\n    );\n    let idx = startIndex;\n    for (const el of buttonEls) {\n      if (!isShown(el)) continue;\n      const type = el.type?.toLowerCase() || 'button';\n      const btnType = type === 'submit' ? 'submit' : type === 'reset' ? 'reset' : 'button';\n      const explicitSubmit = btnType === 'submit' &&\n        (el.tagName === 'INPUT' || (el.getAttribute('type') || '').toLowerCase() === 'submit');\n      const formDefault = btnType === 'submit' && !explicitSubmit && Boolean(el.form);\n      const primaryClass = Array.from(el.classList).some(c => /^(btn[-_])?(primary|submit)$/i.test(c));\n      buttons.push({\n        index: idx,\n        selector: generateSelector(el),\n        label: extractButtonLabel(el),\n        type: btnType,\n        disabled: el.disabled || el.getAttribute('aria-disabled') === 'true',\n        explicitSubmit: explicitSubmit,\n        formDefault: formDefault,\n        primaryClass: primaryClass\n      });\n      idx++;\n    }\n    return buttons;\n  }\n\n  const forms = document.querySelectorAll('form');\n  let globalIndex = 0;\n\n  // A page still loading may not have a body yet\n  const pageRoot = document.body || document.documentElement;\n  if (forms.length === 0 && pageRoot) {\n    const bodyFields = discoverFields(pageRoot, 0, 0);\n    const bodyButtons = discoverButtons(pageRoot, bodyFields.length);\n    if (bodyFields.length > 0) {\n      result.forms.push({\n        index: 0,\n        name: document.title || 'Page',\n        action: null,\n        method: 'GET',\n        step: null,\n        relevanceScore: bodyFields.length * 3,\n        hidden: false,\n        inDialog: false,\n        inIframe: false,\n        fields: bodyFields,\n        buttons: bodyButtons\n      });\n    }\n  } else {\n    for (let i = 0; i < forms.length; i++) {\n      const formEl = forms[i];\n      const fields = discoverFields(formEl, i, globalIndex);\n      globalIndex += fields.length;\n      const buttons = discoverButtons(formEl, globalIndex);\n      globalIndex += buttons.length;\n      const inIframe = formEl.ownerDocument !== document;\n      // Shown when a field or a button is (buttons list shown ones only), or\n      // it has neither (a form with only type=hidden inputs and no button)\n      const shown = isShown(formEl) &&\n        (fields.some((f) => !f.hidden) || buttons.length > 0 || fields.length === 0);\n      result.forms.push({\n        index: i,\n        name: extractFormName(formEl),\n        action: formEl.action || null,\n        method: (formEl.method || 'GET').toUpperCase(),\n        step: detectFormStep(formEl),\n        relevanceScore: calculateRelevance(formEl, fields, buttons),\n        hidden: !shown,\n        inDialog: shown && inDialog(formEl),\n        inIframe: inIframe,\n        fields: fields,\n        buttons: buttons\n      });\n    }\n  }\n\n  // Forms the main document does not contain may be in its same-origin iframes\n  if (result.forms.length === 0) {\n    result.frameForms = [];\n    for (const frame of document.querySelectorAll('iframe, frame')) {\n      let frameDocument = null;\n      try { frameDocument = frame.contentDocument; } catch (e) { frameDocument = null; }\n      if (frameDocument && frameDocument.querySelector('form, input:not([type=hidden]), select, textarea')) {\n        result.frameForms.push({ url: frame.src || 'about:blank' });\n      }\n    }\n  }\n\n  result.readyState = document.readyState;\n  return result;\n})()\n";
 /**
  * Type guard for raw form data.
  *