browser-debugger-cli 0.11.0 → 0.13.0

package/dist/runtime/dom/elementInfo.js

@@ -3,6 +3,31 @@
  * `dom layout`, DOM context of console messages): their text as a user sees
  * it and where they live (iframes, shadow roots).
  */
+/**
+ * A class that is a fragment of a declaration-like class attribute
+ * (`class="brush: html"` has the class `brush:`), left out of labels.
+ */
+const CLASS_FRAGMENT = /[:;,]$/;
+/**
+ * Whether a class name is shown in element labels: not empty and not a
+ * fragment of a declaration-like class attribute ({@link CLASS_FRAGMENT}).
+ *
+ * @param name - Class name
+ * @returns True to show it
+ */
+export function isLabelClass(name) {
+    return name !== '' && !CLASS_FRAGMENT.test(name);
+}
+/**
+ * Page-side `(node) => string[]`: the element's classes shown in labels
+ * ({@link isLabelClass}), read without array helpers a page may replace
+ */
+export const LABEL_CLASSES_JS = `(node) => {
+  const shown = [];
+  const list = node.classList || [];
+  for (let i = 0; i < list.length; i++) if (!${CLASS_FRAGMENT}.test(list[i])) shown[shown.length] = list[i];
+  return shown;
+}`;
 /** Length of the text preview shown for elements. */
 const PREVIEW_LENGTH = 80;
 /** Length of the text `dom get` shows for an element. */
@@ -36,27 +61,88 @@ export const WITHOUT_DECORATIONS_JS = `(el, text) => {
   }
   return result;
 }`;
+/**
+ * Page-side check whether `innerText` misses part of what an element shows:
+ * it is a `<slot>` or hosts an open shadow root, or one of its descendants
+ * is or does. `innerText` follows neither shadow roots nor slots.
+ */
+export const COMPOSED_JS = `(node) => {
+  const composes = (n) => Boolean(n.shadowRoot) || n.localName === 'slot';
+  if (composes(node)) return true;
+  const walker = node.ownerDocument.createTreeWalker(node, NodeFilter.SHOW_ELEMENT);
+  while (walker.nextNode()) if (composes(walker.currentNode)) return true;
+  return false;
+}`;
+/**
+ * Page-side text of an element as the flat tree renders it, for elements
+ * `innerText` cannot read ({@link COMPOSED_JS}): a shadow host is read from
+ * its open shadow root (its own labels and fallback content; light children
+ * only where a slot shows them), and each slot is replaced by what it
+ * shows, its assigned nodes flattened through nested slots (or its fallback
+ * content when nothing is assigned). Parts without slots or shadow roots
+ * are read with `innerText`; elements that are not rendered and text under
+ * `visibility: hidden` are left out, elements that are not inline are set
+ * apart by line breaks, as is a `<br>`. Fields and editable regions inside
+ * it (inputs, textareas, selects, a contenteditable editor) are skipped, so
+ * what a user typed is never read; raw text keeps `innerText`'s collapsed
+ * whitespace. The text is cut at `limit` characters, and a
+ * part whose text alone passes the limit is read from its text nodes
+ * (`textContent`) instead of `innerText`, which would lay out all of it.
+ */
+export const FLAT_TEXT_JS = `(el, limit) => {
+  const composed = ${COMPOSED_JS};
+  const view = el.ownerDocument.defaultView;
+  let text = '';
+  const nodesOf = (node) =>
+    node.localName === 'slot' ? node.assignedNodes({ flatten: true }) : Array.from((node.shadowRoot || node).childNodes);
+  const read = (node, visible) => {
+    if (text.length >= limit) return;
+    if (node.nodeType === 3 && visible) text += node.data.replace(/\\s+/g, ' ');
+    if (node.nodeType !== 1) return;
+    if (/^(input|textarea|select)$/.test(node.localName) || node.isContentEditable) return;
+    const style = view.getComputedStyle(node);
+    if (node.checkVisibility && !node.checkVisibility() && style.display !== 'contents') return;
+    if (node.localName === 'br') text += '\\n';
+    const apart = style.display.startsWith('inline') || style.display === 'contents' ? '' : '\\n';
+    text += apart;
+    const own = node.textContent || '';
+    if (composed(node)) nodesOf(node).forEach((child) => read(child, style.visibility === 'visible'));
+    else if (own.length > limit - text.length) text += own.slice(0, limit - text.length);
+    else text += typeof node.innerText === 'string' ? node.innerText : own;
+    text += apart;
+  };
+  const visible = view.getComputedStyle(el).visibility === 'visible';
+  nodesOf(el).forEach((child) => read(child, visible));
+  return text.slice(0, limit);
+}`;
 /**
  * Page-side text of an element as a user sees it: `innerText` for a rendered
  * element (CSS-hidden parts left out, inline elements not split apart), none
  * for an element that is not rendered, `textContent` for SVG and other
  * elements without `innerText` and for `display: contents` wrappers (no box
  * of their own, but their children are shown), and the label of an
- * `<option>` (which its `<select>` renders). For large containers (more
- * than 2000 characters of text) only the start is read, from the text nodes
- * whose parent is rendered, so a preview never lays out a whole page's text,
- * unless `full` is set. Decorations are left out ({@link WITHOUT_DECORATIONS_JS}).
+ * `<option>` (which its `<select>` renders). A web component, a slot, and
+ * an element holding either are read through the flat tree
+ * ({@link FLAT_TEXT_JS}): the text a component renders from its shadow
+ * root, slotted content in place of its slots, blocks set apart. For large
+ * containers (more than 2000 characters of text) only the start is read,
+ * from the text nodes whose parent is rendered, so a preview never lays out
+ * a whole page's text, unless `full` is set. Decorations are left out
+ * ({@link WITHOUT_DECORATIONS_JS}).
  */
 export const ELEMENT_TEXT_JS = `(el, full) => {
   const withoutDecorations = ${WITHOUT_DECORATIONS_JS};
+  const composed = ${COMPOSED_JS};
+  const flatText = ${FLAT_TEXT_JS};
   const all = el.textContent || '';
   if (el.tagName === 'OPTION') return el.label;
   if (typeof el.innerText !== 'string') return full ? all : all.slice(0, 2000);
   const rendered = (node) => !node.checkVisibility || node.checkVisibility();
-  if (!rendered(el)) {
-    const boxless = el.ownerDocument.defaultView.getComputedStyle(el).display === 'contents';
-    return boxless ? withoutDecorations(el, full ? all : all.slice(0, 2000)) : '';
-  }
+  const shown = rendered(el);
+  const boxless = !shown && el.ownerDocument.defaultView.getComputedStyle(el).display === 'contents';
+  if (!shown && !boxless) return '';
+  if (composed(el)) return withoutDecorations(el, flatText(el, full ? Infinity : 2000));
+  if (boxless) return withoutDecorations(el, full ? all : all.slice(0, 2000));
   if (full || all.length <= 2000) return withoutDecorations(el, el.innerText);
   const walker = el.ownerDocument.createTreeWalker(el, NodeFilter.SHOW_TEXT);
   let start = '';
@@ -132,12 +218,38 @@ export const ELEMENT_STATE_JS = `(el) => {
   }
 }`;
 /**
- * Page-side short description of an element: tag, id and up to two classes,
- * e.g. `button#save.primary.large`.
+ * Page-side short description of an element: tag, id and up to two classes
+ * ({@link LABEL_CLASSES_JS}), e.g. `button#save.primary.large`.
  */
-export const ELEMENT_DESCRIPTION_JS = `(node) => node.tagName.toLowerCase() +
-  (node.id ? '#' + node.id : '') +
-  (node.classList && node.classList.length ? '.' + Array.from(node.classList).slice(0, 2).join('.') : '')`;
+export const ELEMENT_DESCRIPTION_JS = `(node) => {
+  const classes = (${LABEL_CLASSES_JS})(node);
+  return node.tagName.toLowerCase() + (node.id ? '#' + node.id : '') + (classes[0] ? '.' + classes[0] : '') + (classes[1] ? '.' + classes[1] : '');
+}`;
+/**
+ * Page-side reason an element is disabled, or null when it is not. A native
+ * control (`button`, `input`, `select`, `textarea`, `fieldset`, `optgroup`,
+ * `option`) is disabled by its `disabled attribute` or by being `inside a
+ * disabled <fieldset>` (not in its first `<legend>`), an `<option>` by
+ * being `inside a disabled <optgroup>`; any other element
+ * (e.g. a custom element) when its `disabled` property is set (empty
+ * reason). Reads the element's own attributes rather than
+ * `matches(':disabled')`, which pages replace.
+ */
+export const DISABLED_CAUSE_JS = `(el) => {
+  if (!/^(button|input|select|textarea|fieldset|optgroup|option)$/.test(el.localName)) return el.disabled ? '' : null;
+  if (el.hasAttribute('disabled')) return 'disabled attribute';
+  if (el.localName === 'option') {
+    const group = el.parentElement;
+    return group && group.localName === 'optgroup' && group.hasAttribute('disabled') ? 'inside a disabled <optgroup>' : null;
+  }
+  for (let node = el.parentElement; node; node = node.parentElement) {
+    if (node.localName !== 'fieldset' || !node.hasAttribute('disabled')) continue;
+    let legend = node.firstElementChild;
+    while (legend && legend.localName !== 'legend') legend = legend.nextElementSibling;
+    if (!legend || !legend.contains(el)) return 'inside a disabled <fieldset>';
+  }
+  return null;
+}`;
 /**
  * Page-side position of an element among its parent's children with the
  * same short description ({@link ELEMENT_DESCRIPTION_JS}), e.g. `(2nd of 3)`;
@@ -159,12 +271,15 @@ export const SIBLING_POSITION_JS = `(el) => {
  * Page-side identity of an element an action hit, so the output says which
  * one it was, as one string: its short description
  * ({@link ELEMENT_DESCRIPTION_JS}) and visible text (button value for button
- * inputs, decorations left out), e.g. `button#add.btn "Add to cart"`. A
- * `<select>` is named by its label, aria-label or name, else by its selected
+ * inputs, decorations left out; read through the flat tree for web
+ * components and slots, {@link FLAT_TEXT_JS}), e.g.
+ * `button#add.btn "Add to cart"`. A `<select>` is named by its label
+ * (`aria-labelledby` or `<label>`), aria-label or name, else by its selected
  * option, e.g. `select.sort "Sort products"`. An element without visible
  * text is described by itself first: by its position among same-looking
  * siblings ({@link SIBLING_POSITION_JS}), e.g. `div.figure (2nd of 3)`, with
- * its aria-label, placeholder or title when it has one. Only an element
+ * its name when it has one: aria-label, label, placeholder, title, or the
+ * alt text of an image (in it). Only an element
  * without an id that is the only one of its kind is named by the nearest of
  * three ancestors that has text, e.g.
  * `input.toggle in div.view "Write report"` (rows of a list share their
@@ -172,7 +287,7 @@ export const SIBLING_POSITION_JS = `(el) => {
  * of `<select>`s in it (read like `innerText`: CSS-hidden text is left out of
  * a rendered ancestor; at most 500 text nodes; selects in shadow roots are
  * not looked into), and never past an editable ancestor, whose text may be
- * typed input; otherwise its aria-label, placeholder or title is used. Texts
+ * typed input; otherwise its name is used. Texts
  * are cut at 40 characters. Contenteditable elements count as controls: what
  * was typed into them is never echoed (nor their ancestors' text).
  */
@@ -180,19 +295,36 @@ export const ELEMENT_IDENTITY_JS = `(el) => {
   const describe = ${ELEMENT_DESCRIPTION_JS};
   const siblingPosition = ${SIBLING_POSITION_JS};
   const withoutDecorations = ${WITHOUT_DECORATIONS_JS};
+  const composed = ${COMPOSED_JS};
+  const flatText = ${FLAT_TEXT_JS};
   const clean = (text) => (text || '').replace(/\\s+/g, ' ').trim();
   const cut = (text) => {
     const characters = Array.from(text);
     return characters.length > 40 ? characters.slice(0, 40).join('') + '…' : text;
   };
   const isControl = (node) => /^(input|select|textarea)$/.test(node.localName) || node.isContentEditable;
-  const shownText = (node) =>
-    isControl(node) ? '' : clean(withoutDecorations(node, typeof node.innerText === 'string' ? node.innerText : node.textContent));
+  const textOf = (node) =>
+    composed(node) ? flatText(node, 200) : typeof node.innerText === 'string' ? node.innerText : node.textContent;
+  const shownText = (node) => (isControl(node) ? '' : clean(withoutDecorations(node, textOf(node))));
   const buttonValue = (node) => (node.localName === 'input' && /^(submit|button|reset)$/i.test(node.type) ? clean(node.value) : '');
+  const labelText = (node) => {
+    const ids = (node.getAttribute('aria-labelledby') || '').split(/\\s+/).filter(Boolean);
+    const root = node.getRootNode();
+    const labels = ids.length ? ids.map((id) => root.getElementById(id)) : Array.from(node.labels || []);
+    return clean(labels.filter(Boolean).map(textOf).join(' '));
+  };
+  const imageAlt = (node) => {
+    const image = node.localName === 'img' ? node : node.querySelector('img[alt]');
+    return image ? clean(image.getAttribute('alt')) : '';
+  };
   const attributeText = (node) =>
-    clean(node.getAttribute('aria-label')) || clean(node.getAttribute('placeholder')) || clean(node.getAttribute('title'));
+    clean(node.getAttribute('aria-label')) ||
+    labelText(node) ||
+    clean(node.getAttribute('placeholder')) ||
+    clean(node.getAttribute('title')) ||
+    imageAlt(node);
   const selectName = (node) =>
-    clean(node.labels && node.labels[0] && node.labels[0].innerText) ||
+    labelText(node) ||
     clean(node.getAttribute('aria-label')) ||
     clean(node.getAttribute('name')) ||
     clean(node.selectedOptions && node.selectedOptions[0] && node.selectedOptions[0].label);
@@ -225,21 +357,42 @@ export const ELEMENT_IDENTITY_JS = `(el) => {
 }`;
 /**
  * Page-side location of an element: the iframes it is in (outermost first)
- * and the shadow root holding it, e.g. `iframe#pay > shadow root of <x-card>`;
- * empty for the main document.
+ * and the shadow root holding it, with the host's first class and the text
+ * a user sees of it ({@link ELEMENT_TEXT_JS}, cut at 30 characters with
+ * `…`), e.g. `iframe#pay > shadow root of <sl-button.primary "Save">`;
+ * empty for the main document. Each host's text is read once per script
+ * run, as many matches share a host.
  */
-export const ELEMENT_CONTEXT_JS = `(el) => {
+export const ELEMENT_CONTEXT_JS = `(() => {
+  const textOf = ${ELEMENT_TEXT_JS};
+  const hostTexts = new WeakMap();
+  const hostText = (host) => {
+    if (!hostTexts.has(host)) {
+      const characters = Array.from(String(textOf(host, false)).replace(/\\s+/g, ' ').trim());
+      hostTexts.set(host, characters.length > 30 ? characters.slice(0, 30).join('') + '…' : characters.join(''));
+    }
+    return hostTexts.get(host);
+  };
   const describe = (node) => node.tagName.toLowerCase() + (node.id ? '#' + node.id : '');
-  const parts = [];
-  for (let doc = el.ownerDocument; doc && doc.defaultView && doc.defaultView.frameElement; ) {
-    const frame = doc.defaultView.frameElement;
-    parts.unshift(describe(frame));
-    doc = frame.ownerDocument;
-  }
-  const root = el.getRootNode();
-  if (root.host) parts.push('shadow root of <' + describe(root.host) + '>');
-  return parts.join(' > ');
-}`;
+  const labelClasses = ${LABEL_CLASSES_JS};
+  return (el) => {
+    const parts = [];
+    for (let doc = el.ownerDocument; doc && doc.defaultView && doc.defaultView.frameElement; ) {
+      const frame = doc.defaultView.frameElement;
+      parts.unshift(describe(frame));
+      doc = frame.ownerDocument;
+    }
+    const root = el.getRootNode();
+    if (root.host) {
+      const host = root.host;
+      const firstClass = labelClasses(host)[0];
+      const label = describe(host) + (!host.id && firstClass ? '.' + firstClass : '');
+      const text = hostText(host);
+      parts.push('shadow root of <' + label + (text ? ' "' + text + '"' : '') + '>');
+    }
+    return parts.join(' > ');
+  };
+})()`;
 /**
  * Short text preview of an element's text: whitespace collapsed, cut on a
  * whole character (an emoji is never split, which would make JSON invalid).

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

@@ -11,6 +11,13 @@ import { type CDPSender } from '../../telemetry/objectExpander.js';
  * @throws Error When script execution throws exception or returns invalid response
  */
 export declare function executeScript(cdp: CDPSender, script: string, options?: Omit<Protocol.Runtime.EvaluateRequest, 'expression'>): Promise<Protocol.Runtime.EvaluateResponse>;
+/**
+ * Message of an exception, including thrown non-Error values (`throw "x"`).
+ *
+ * @param details - Exception details
+ * @returns Readable message
+ */
+export declare function describeException(details: Protocol.Runtime.ExceptionDetails): string;
 /** Result of `bdg dom eval`: a JSON-safe value plus its JavaScript type. */
 export interface EvalResult {
     /** JSON value, or a readable description for values JSON cannot represent */
@@ -19,6 +26,8 @@ export interface EvalResult {
     type: string;
     /** Object subtype (`node`, `date`, `map`, `array`, ...) */
     subtype?: string;
+    /** Set when the page replaced built-ins bdg's copy of the result uses, so the browser copied it */
+    warning?: string;
 }
 /**
  * Page-side copy of an object as JSON, keeping what JSON would lose inside
@@ -28,9 +37,10 @@ export interface EvalResult {
  * `12n`, functions `function name()`, and cycles `[Circular]` (an object
  * shared by two properties is copied twice). Works for objects of iframes
  * (other realms); lists and objects are cut after 1000 entries, and a
- * throwing getter becomes `[Error: …]`.
+ * throwing getter becomes `[Error: …]`. It uses the page's built-ins
+ * ({@link COPY_BUILTINS}), so it only runs when the page left them alone.
  */
-export declare const JSON_SAFE_COPY_FUNCTION = "function () {\n  const MAX_ITEMS = 1000;\n  const ancestors = new Set();\n  const kind = (value) => Object.prototype.toString.call(value).slice(8, -1);\n  const isNode = (value) => typeof value.nodeType === 'number' && typeof value.nodeName === 'string';\n  const describeNode = (node) => {\n    if (node.nodeType !== 1) return node.nodeName.toLowerCase();\n    return node.tagName.toLowerCase() + (node.id ? '#' + node.id : '') +\n      (node.classList && node.classList.length ? '.' + Array.from(node.classList).join('.') : '');\n  };\n  const items = (list, next) => {\n    const result = [];\n    let count = 0;\n    for (const item of list) {\n      if (count++ === MAX_ITEMS) { result.push('\u2026'); break; }\n      result.push(next(item));\n    }\n    return result;\n  };\n  const leaf = (value) => {\n    if (value === undefined) return null;\n    if (typeof value === 'number') {\n      if (Number.isNaN(value) || !Number.isFinite(value)) return String(value);\n      return Object.is(value, -0) ? '-0' : value;\n    }\n    if (typeof value === 'bigint') return value + 'n';\n    if (typeof value === 'symbol') return value.toString();\n    if (typeof value === 'function') return 'function ' + (value.name || '(anonymous)') + '()';\n    return value;\n  };\n  const copy = (value, depth) => {\n    if (value === null || typeof value !== 'object') return leaf(value);\n    if (ancestors.has(value)) return '[Circular]';\n    if (depth > 20) return '[\u2026]';\n    const next = (item) => copy(item, depth + 1);\n    const type = kind(value);\n    if (isNode(value)) return describeNode(value);\n    if (value.window === value) return 'Window';\n    if (type === 'Date') return isNaN(value) ? 'Invalid Date' : value.toISOString();\n    if (type === 'RegExp') return String(value);\n    if (type === 'Error' || value instanceof Error) return value.name + ': ' + value.message;\n    ancestors.add(value);\n    try {\n      if (type === 'Map') return items(value, ([k, v]) => [next(k), next(v)]);\n      if (type === 'Set' || type === 'NodeList' || type === 'HTMLCollection') return items(value, next);\n      if (ArrayBuffer.isView(value) && type !== 'DataView') return items(value, next);\n      if (Array.isArray(value)) return items(value, next);\n      const result = {};\n      const keys = Object.keys(value);\n      for (const key of keys.slice(0, MAX_ITEMS)) {\n        try { result[key] = next(value[key]); } catch (e) { result[key] = '[Error: ' + (e && e.message) + ']'; }\n      }\n      if (keys.length > MAX_ITEMS) result['\u2026'] = (keys.length - MAX_ITEMS) + ' more keys';\n      return result;\n    } finally {\n      ancestors.delete(value);\n    }\n  };\n  return copy(this, 0);\n}";
+export declare const JSON_SAFE_COPY_FUNCTION = "function () {\n  const MAX_ITEMS = 1000;\n  const ancestors = new Set();\n  const kind = (value) => Object.prototype.toString.call(value).slice(8, -1);\n  const isNode = (value) => typeof value.nodeType === 'number' && typeof value.nodeName === 'string';\n  const describeNode = (node) => {\n    if (node.nodeType !== 1) return node.nodeName.toLowerCase();\n    return node.tagName.toLowerCase() + (node.id ? '#' + node.id : '') +\n      (node.classList && node.classList.length ? '.' + Array.from(node.classList).join('.') : '');\n  };\n  const items = (list, next) => {\n    const result = [];\n    if (typeof list.length === 'number') {\n      for (let i = 0; i < list.length; i++) {\n        if (i === MAX_ITEMS) { result.push('\u2026'); break; }\n        result.push(next(list[i]));\n      }\n      return result;\n    }\n    let count = 0;\n    for (const item of list) {\n      if (count++ === MAX_ITEMS) { result.push('\u2026'); break; }\n      result.push(next(item));\n    }\n    return result;\n  };\n  const leaf = (value) => {\n    if (value === undefined) return null;\n    if (typeof value === 'number') {\n      if (Number.isNaN(value) || !Number.isFinite(value)) return String(value);\n      return Object.is(value, -0) ? '-0' : value;\n    }\n    if (typeof value === 'bigint') return value + 'n';\n    if (typeof value === 'symbol') return value.toString();\n    if (typeof value === 'function') return 'function ' + (value.name || '(anonymous)') + '()';\n    return value;\n  };\n  const copy = (value, depth) => {\n    if (value === null || typeof value !== 'object') return leaf(value);\n    if (ancestors.has(value)) return '[Circular]';\n    if (depth > 20) return '[\u2026]';\n    const next = (item) => copy(item, depth + 1);\n    const type = kind(value);\n    if (isNode(value)) return describeNode(value);\n    if (value.window === value) return 'Window';\n    if (type === 'Date') return isNaN(value) ? 'Invalid Date' : value.toISOString();\n    if (type === 'RegExp') return String(value);\n    if (type === 'Error' || value instanceof Error) return value.name + ': ' + value.message;\n    ancestors.add(value);\n    try {\n      if (type === 'Map') return items(value, ([k, v]) => [next(k), next(v)]);\n      if (type === 'Set' || type === 'NodeList' || type === 'HTMLCollection') return items(value, next);\n      if (ArrayBuffer.isView(value) && type !== 'DataView') return items(value, next);\n      if (Array.isArray(value)) return items(value, next);\n      const result = {};\n      const keys = Object.keys(value);\n      for (const key of keys.slice(0, MAX_ITEMS)) {\n        try { result[key] = next(value[key]); } catch (e) { result[key] = '[Error: ' + (e && e.message) + ']'; }\n      }\n      if (keys.length > MAX_ITEMS) result['\u2026'] = (keys.length - MAX_ITEMS) + ' more keys';\n      return result;\n    } finally {\n      ancestors.delete(value);\n    }\n  };\n  return copy(this, 0);\n}";
 /** What a busy target is called in messages: the page, or an iframe (`--frame`) */
 export type BusyScope = 'page' | 'frame';
 /** When {@link withBusyPageRecovery} checks the target, and what it calls it */

package/dist/runtime/dom/evalHelpers.js

@@ -2,8 +2,10 @@ import { CDPProtocolError } from '../../connection/errors.js';
 import { CommandError } from '../../errors/index.js';
 import { navigationPendingError, pageBusyError, pageClosedDuringEvalError, pageNavigatedDuringEvalError, promiseTimeoutError, scriptExecutionError, scriptTimeoutError, } from '../../errors/messages.js';
 import { pendingNavigationUrl } from '../page/navigation.js';
+import { findReplacedBuiltins } from '../page/replacedBuiltins.js';
 import { senderFor } from '../../telemetry/objectExpander.js';
 import { formatRemoteObject } from '../../telemetry/remoteObject.js';
+import { evalCopiedByBrowserWarning, evalPreviewWarning } from '../../ui/messages/commands.js';
 import { createLogger } from '../../ui/logging/index.js';
 import { getErrorMessage } from '../../utils/errors.js';
 import { EXIT_CODES } from '../../utils/exitCodes.js';
@@ -121,7 +123,7 @@ async function settlePromise(cdp, result, script) {
  * @param details - Exception details
  * @returns Readable message
  */
-function describeException(details) {
+export function describeException(details) {
     const exception = details.exception;
     if (exception?.type === 'object' && exception.subtype !== 'error' && exception.preview) {
         return `Uncaught ${formatRemoteObject(exception)}`;
@@ -164,7 +166,8 @@ const BRIEF_SUBTYPES = new Set(['node', 'arraybuffer', 'dataview']);
  * `12n`, functions `function name()`, and cycles `[Circular]` (an object
  * shared by two properties is copied twice). Works for objects of iframes
  * (other realms); lists and objects are cut after 1000 entries, and a
- * throwing getter becomes `[Error: …]`.
+ * throwing getter becomes `[Error: …]`. It uses the page's built-ins
+ * ({@link COPY_BUILTINS}), so it only runs when the page left them alone.
  */
 export const JSON_SAFE_COPY_FUNCTION = `function () {
   const MAX_ITEMS = 1000;
@@ -178,6 +181,13 @@ export const JSON_SAFE_COPY_FUNCTION = `function () {
   };
   const items = (list, next) => {
     const result = [];
+    if (typeof list.length === 'number') {
+      for (let i = 0; i < list.length; i++) {
+        if (i === MAX_ITEMS) { result.push('…'); break; }
+        result.push(next(list[i]));
+      }
+      return result;
+    }
     let count = 0;
     for (const item of list) {
       if (count++ === MAX_ITEMS) { result.push('…'); break; }
@@ -226,6 +236,33 @@ export const JSON_SAFE_COPY_FUNCTION = `function () {
   };
   return copy(this, 0);
 }`;
+/** Built-ins {@link JSON_SAFE_COPY_FUNCTION} uses (it runs in the page's world, next to the result) */
+const COPY_BUILTINS = [
+    'Object.keys',
+    'Object.is',
+    'Object.prototype.toString',
+    'Function.prototype.call',
+    'Array.from',
+    'Array.isArray',
+    'Array.prototype.push',
+    'Array.prototype.slice',
+    'Array.prototype.join',
+    'ArrayBuffer.isView',
+    'Number.isNaN',
+    'Number.isFinite',
+    'String',
+    'String.prototype.slice',
+    'String.prototype.toLowerCase',
+    'Set',
+    'Set.prototype.add',
+    'Set.prototype.has',
+    'Set.prototype.delete',
+    'Set.prototype.values',
+    'Map.prototype.entries',
+    'Date.prototype.toISOString',
+];
+/** Returns the object it is called on (for the browser to copy it by value) */
+const SELF_FUNCTION = 'function () { return this; }';
 /**
  * Whether an exception is V8 terminating a script that ran too long.
  *
@@ -240,7 +277,10 @@ function isTerminated(details) {
  *
  * Plain objects and arrays are copied by value; values JSON cannot represent
  * (NaN, -0, BigInt, functions, symbols, DOM nodes, dates, maps, errors, the
- * window, cyclic objects) are given as their readable description.
+ * window, cyclic objects) are given as their readable description. On a
+ * page that replaced built-ins that copy uses, the browser copies the
+ * object (JSON-like values exactly, the others as null or `{}`), or else
+ * its preview is given, with a warning naming them.
  *
  * @param cdp - CDP connection
  * @param remote - Remote object returned by Runtime.evaluate
@@ -260,19 +300,39 @@ async function toEvalResult(cdp, remote) {
     if (remote.type !== 'object' || DESCRIBED_SUBTYPES.has(remote.subtype ?? '')) {
         return { value: formatRemoteObject(remote), ...kind };
     }
+    const replaced = await findReplacedBuiltins(cdp, COPY_BUILTINS, remote.objectId);
+    const copy = await copyByValue(cdp, remote.objectId, replaced.length === 0 ? JSON_SAFE_COPY_FUNCTION : SELF_FUNCTION);
+    const value = copy ? copy.value : formatRemoteObject(remote);
+    if (replaced.length === 0)
+        return { value, ...kind };
+    const warning = copy ? evalCopiedByBrowserWarning(replaced) : evalPreviewWarning(replaced);
+    return { value, ...kind, warning };
+}
+/**
+ * Copy a result by value: what a function called on it returns, which the
+ * browser serialises itself (without the page's built-ins).
+ *
+ * @param cdp - CDP connection
+ * @param objectId - The result
+ * @param functionDeclaration - {@link JSON_SAFE_COPY_FUNCTION}, or
+ *   {@link SELF_FUNCTION} for the browser's plain copy (it fails on cycles
+ *   and BigInts)
+ * @returns The copy, or undefined when it failed
+ */
+async function copyByValue(cdp, objectId, functionDeclaration) {
     try {
         const copy = (await cdp.send('Runtime.callFunctionOn', {
-            objectId: remote.objectId,
-            functionDeclaration: JSON_SAFE_COPY_FUNCTION,
+            objectId,
+            functionDeclaration,
             returnByValue: true,
         }));
         if (!copy.exceptionDetails)
-            return { value: copy.result?.value, ...kind };
+            return { value: copy.result?.value };
     }
     catch (error) {
         log.debug(`Could not copy eval result by value: ${getErrorMessage(error)}`);
     }
-    return { value: formatRemoteObject(remote), ...kind };
+    return undefined;
 }
 /**
  * Wait for `work`, or fail when it takes longer than `ms`.

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

@@ -12,10 +12,14 @@ import type { RawFormData } from './formTypes.js';
  * - Native form elements and inputs
  * - Custom components with ARIA roles
  * - Labels via priority chain (label[for], aria-label, placeholder, etc.)
- * - Current values and validation state
+ * - Current values and validation state (never a secret: a hidden input's
+ *   value is left out, a sensitive text field's or select's
+ *   ({@link SENSITIVE_FIELD_JS}; checkboxes and radios named like one keep
+ *   their checked state) is {@link MASKED_VALUE} when filled, and a
+ *   sensitive select's options do not say which is chosen)
  * - Form relevance scoring for multi-form pages
  */
-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";
+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 (type === 'hidden') return '';\n    if (isSecret(element)) {\n      return (element.isContentEditable ? element.textContent : element.value) ? '\u2022\u2022\u2022\u2022' : '';\n    }\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 isSecret(element) {\n    const type = element.type?.toLowerCase() || 'text';\n    if (type === 'checkbox' || type === 'radio') return false;\n    if (element.getAttribute('role') === 'checkbox' || element.getAttribute('role') === 'switch') return false;\n    return ((el) => {\n  const autocomplete = el.getAttribute('autocomplete') || '';\n  if (/(^|\\s)(cc-[a-z-]+|one-time-code|current-password|new-password)(\\s|$)/i.test(autocomplete)) return true;\n  if (el.type === 'password' || /^password$/i.test(el.getAttribute('type') || '')) return true;\n  const names = [el.getAttribute('name'), el.id, autocomplete].join(' ');\n  if (/passw|passwd|pwd|passcode|(^|[^a-z])otp([^a-z]|$)|cvv|cvc/i.test(names)) return true;\n  try {\n    const security = el.ownerDocument.defaultView.getComputedStyle(el).getPropertyValue('-webkit-text-security');\n    return Boolean(security) && security !== 'none';\n  } catch (e) {\n    return false;\n  }\n})(element);\n  }\n\n  function getSelectOptions(element) {\n    if (element.tagName.toLowerCase() !== 'select') return undefined;\n    const secret = isSecret(element);\n    return Array.from(element.options).map(opt => ({\n      value: secret ? '' : opt.value,\n      label: opt.textContent.trim(),\n      selected: secret ? false : 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.
  *