browser-debugger-cli 0.15.0 → 0.16.0

package/dist/runtime/dom/captureArea.js

@@ -0,0 +1,203 @@
+/**
+ * The area an element screenshot captures: its border box, grown to what
+ * the element paints beyond it (overflowing descendants, text, shadows,
+ * outline), plus any `--padding`.
+ */
+import { TypedCDPConnection } from '../../connection/typed-cdp.js';
+import { CommandError } from '../../errors/index.js';
+import { elementNotVisibleError, elementZeroDimensionsError } from '../../errors/messages.js';
+import { resolveNodeInBdgWorld } from '../page/bdgWorld.js';
+import { createLogger } from '../../ui/logging/index.js';
+import { getErrorMessage } from '../../utils/errors.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+const log = createLogger('dom');
+/** Descendants {@link CONTENT_OVERFLOW_JS} looks at, so a huge element stays cheap */
+const OVERFLOW_SCAN_LIMIT = 2000;
+/**
+ * Page-side distances (CSS px, never negative) by which what an element
+ * paints reaches beyond its border box on each side: its rendered
+ * descendants (uncleared floats, absolutely positioned and transformed
+ * children), its text (descenders past a tight line height, read from its
+ * scroll size beyond its client size, in transformed px, to the left on an
+ * RTL element), and its own outer box shadows and outline (a focus ring).
+ * Descendants of an element that clips its overflow (`overflow` other than
+ * `visible`) are cut off by it and not counted, nor are fixed ones (they
+ * belong to the viewport) or what lies outside the document (skip links at
+ * -9999px). Only the shadows and outline count when the element clips its
+ * own overflow.
+ */
+const CONTENT_OVERFLOW_JS = `function () {
+  const view = this.ownerDocument.defaultView;
+  const scroller = this.ownerDocument.scrollingElement || this.ownerDocument.documentElement;
+  const own = this.getBoundingClientRect();
+  const reach = { left: own.left, top: own.top, right: own.right, bottom: own.bottom };
+  const page = { left: -view.scrollX, top: -view.scrollY, right: scroller.scrollWidth - view.scrollX, bottom: scroller.scrollHeight - view.scrollY };
+  const clips = (style) => style.overflowX !== 'visible' || style.overflowY !== 'visible';
+  let budget = ${OVERFLOW_SCAN_LIMIT};
+  const walk = (el) => {
+    for (const child of el.children) {
+      if (--budget < 0) return;
+      const style = view.getComputedStyle(child);
+      if (style.display === 'none' || style.position === 'fixed') continue;
+      const r = child.getBoundingClientRect();
+      if (r.width > 0 && r.height > 0 && style.visibility === 'visible') {
+        reach.left = Math.min(reach.left, Math.max(r.left, page.left));
+        reach.top = Math.min(reach.top, Math.max(r.top, page.top));
+        reach.right = Math.max(reach.right, Math.min(r.right, page.right));
+        reach.bottom = Math.max(reach.bottom, Math.min(r.bottom, page.bottom));
+      }
+      if (!clips(style)) walk(child);
+    }
+  };
+  const ownStyle = view.getComputedStyle(this);
+  if (!clips(ownStyle)) {
+    walk(this);
+    const scaleX = this.offsetWidth ? own.width / this.offsetWidth : 1;
+    const scaleY = this.offsetHeight ? own.height / this.offsetHeight : 1;
+    const wider = Math.max(0, this.scrollWidth - this.clientWidth) * scaleX;
+    const taller = Math.max(0, this.scrollHeight - this.clientHeight) * scaleY;
+    if (ownStyle.direction === 'rtl') reach.left = Math.min(reach.left, own.left - wider);
+    else reach.right = Math.max(reach.right, own.right + wider);
+    reach.bottom = Math.max(reach.bottom, own.bottom + taller);
+  }
+  const ink = { left: 0, top: 0, right: 0, bottom: 0 };
+  const grow = (side, amount) => { ink[side] = Math.max(ink[side], amount); };
+  for (const layer of ownStyle.boxShadow === 'none' ? [] : ownStyle.boxShadow.split(/,(?![^(]*\\))/)) {
+    if (/\\binset\\b/.test(layer)) continue;
+    const [x = 0, y = 0, blur = 0, spread = 0] = (layer.replace(/(rgba?|hsla?|color|oklch|lab|lch)\\([^)]*\\)/g, '').match(/-?[\\d.]+px/g) || []).map(parseFloat);
+    grow('left', blur + spread - x);
+    grow('right', blur + spread + x);
+    grow('top', blur + spread - y);
+    grow('bottom', blur + spread + y);
+  }
+  if (ownStyle.outlineStyle !== 'none') {
+    const outline = parseFloat(ownStyle.outlineWidth) + parseFloat(ownStyle.outlineOffset);
+    ['left', 'top', 'right', 'bottom'].forEach((side) => grow(side, outline));
+  }
+  return {
+    left: Math.max(own.left - reach.left, ink.left),
+    top: Math.max(own.top - reach.top, ink.top),
+    right: Math.max(reach.right - own.right, ink.right),
+    bottom: Math.max(reach.bottom - own.bottom, ink.bottom)
+  };
+}`;
+/** Overflow (px) below which the capture keeps to the border box (subpixel rounding) */
+const OVERFLOW_SLACK = 1;
+/** Measurements so far, naming each one's object group (captures may run side by side) */
+let measurements = 0;
+/**
+ * Throw an element error with exit code 81.
+ *
+ * @param err - Message and suggestion
+ * @throws CommandError (81)
+ */
+function throwInvalid(err) {
+    throw new CommandError(err.message, { suggestion: err.suggestion }, EXIT_CODES.INVALID_ARGUMENTS);
+}
+/**
+ * The border box of an element (padding and border included), relative to
+ * the viewport.
+ *
+ * @param cdp - Session connection
+ * @param ref - The element
+ * @returns Bounds in CSS px
+ * @throws CommandError (81) when it is not rendered or has no area
+ */
+export async function getElementBounds(cdp, ref) {
+    const boxModel = await new TypedCDPConnection(cdp)
+        .send('DOM.getBoxModel', ref)
+        .catch((error) => {
+        log.debug(`No box model: ${getErrorMessage(error)}`);
+        return undefined;
+    });
+    const border = boxModel?.model.border;
+    if (!border)
+        throwInvalid(elementNotVisibleError());
+    const x = border[0] ?? 0;
+    const y = border[1] ?? 0;
+    const width = (border[2] ?? 0) - x;
+    const height = (border[5] ?? 0) - y;
+    if (width <= 0 || height <= 0)
+        throwInvalid(elementZeroDimensionsError());
+    return { x, y, width, height };
+}
+/**
+ * Area an element screenshot captures: the border box, grown to the content
+ * that overflows it ({@link CONTENT_OVERFLOW_JS}), so floated children are
+ * not cropped away.
+ *
+ * @param cdp - Session connection
+ * @param ref - The element
+ * @param bounds - Border box (DOM.getBoxModel coordinates)
+ * @param padding - Extra space around it (CSS px)
+ * @returns The area, or the border box (with the padding) when nothing
+ *   overflows (or the page cannot be asked)
+ */
+export async function captureArea(cdp, ref, bounds, padding) {
+    const area = await paintedArea(cdp, ref, bounds);
+    return padding > 0
+        ? {
+            x: area.x - padding,
+            y: area.y - padding,
+            width: area.width + 2 * padding,
+            height: area.height + 2 * padding,
+        }
+        : area;
+}
+/**
+ * The border box grown to what the element paints beyond it
+ * ({@link CONTENT_OVERFLOW_JS}).
+ *
+ * @param cdp - Session connection
+ * @param ref - The element
+ * @param bounds - Border box
+ * @returns The area
+ */
+async function paintedArea(cdp, ref, bounds) {
+    try {
+        const overflow = await measureOverflow(cdp, ref);
+        if (!overflow)
+            return bounds;
+        const [left, top, right, bottom] = ['left', 'top', 'right', 'bottom'].map((side) => Math.max(0, overflow[side] ?? 0));
+        if (Math.max(left, top, right, bottom) <= OVERFLOW_SLACK)
+            return bounds;
+        return {
+            x: bounds.x - left,
+            y: bounds.y - top,
+            width: bounds.width + left + right,
+            height: bounds.height + top + bottom,
+        };
+    }
+    catch (error) {
+        log.debug(`Could not measure overflowing content: ${getErrorMessage(error)}`);
+        return bounds;
+    }
+}
+/**
+ * Run {@link CONTENT_OVERFLOW_JS} on the element in bdg's world.
+ *
+ * @param cdp - Session connection
+ * @param ref - The element
+ * @returns Overflow per side, or undefined when the page did not answer
+ */
+async function measureOverflow(cdp, ref) {
+    const objectGroup = `bdg-screenshot-${++measurements}`;
+    try {
+        const resolved = await resolveNodeInBdgWorld(cdp, { ...ref, objectGroup });
+        const objectId = resolved.object.objectId;
+        if (!objectId)
+            return undefined;
+        const response = await new TypedCDPConnection(cdp).send('Runtime.callFunctionOn', {
+            objectId,
+            functionDeclaration: CONTENT_OVERFLOW_JS,
+            returnByValue: true,
+        });
+        return response.result.value;
+    }
+    finally {
+        await cdp
+            .send('Runtime.releaseObjectGroup', { objectGroup })
+            .catch((error) => log.debug(`Object group not released: ${getErrorMessage(error)}`));
+    }
+}
+//# sourceMappingURL=captureArea.js.map

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

@@ -72,21 +72,23 @@ export declare const ELEMENT_TEXT_JS = "(el, full) => {\n  const withoutDecorati
 export declare const MASKED_VALUE = "\u2022\u2022\u2022\u2022";
 /**
  * Regular expression source (case-insensitive) matching names of fields that
- * hold a password, one-time code or card code: `password`, `passwd`, `pwd`,
- * `passcode`, `otp`, `cvv`, `cvc`. Shared by the page-side
- * {@link SENSITIVE_FIELD_JS} and HAR sanitization.
+ * hold a password, one-time code, PIN, social security number or card data:
+ * `password`, `passwd`, `pwd`, `passcode`, `passphrase`, `otp`, `pin`, `ssn`
+ * (these three as whole words), `cvv`, `cvc`, `card_number`, `cardNo` (whole
+ * words). Shared
+ * by the page-side {@link SENSITIVE_FIELD_JS} and HAR sanitization.
  */
-export declare const SENSITIVE_NAME_SOURCE = "passw|passwd|pwd|passcode|(^|[^a-z])otp([^a-z]|$)|cvv|cvc";
+export declare const SENSITIVE_NAME_SOURCE = "passw|passwd|pwd|passcode|passphrase|(^|[^a-z])(otp|pin|ssn)([^a-z]|$)|cvv|cvc|card[-_]?(num(ber)?|no)([^a-z]|$)";
 /**
  * Page-side check whether a form control holds a secret whose value must
  * never leave the page: a password field (live type or type attribute), a
  * field shown masked by CSS (`-webkit-text-security` other than `none`),
  * one whose `autocomplete` names a password, a payment card (`cc-*`) or a
- * one-time code, or a field named like a password, one-time code or card code
- * (`password`, `passwd`, `pwd`, `passcode`, `otp`, `cvv`, `cvc`), which
+ * one-time code, or a field named like a password, one-time code, PIN, SSN
+ * or card data ({@link SENSITIVE_NAME_SOURCE}), which
  * covers a password field switched to text by a "show password" button.
  */
-export declare const SENSITIVE_FIELD_JS = "(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}";
+export declare const SENSITIVE_FIELD_JS = "(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|passphrase|(^|[^a-z])(otp|pin|ssn)([^a-z]|$)|cvv|cvc|card[-_]?(num(ber)?|no)([^a-z]|$)/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}";
 /**
  * Page-side live state of a form control, which its attributes do not show:
  * the type and current value of an `<input>` (for checkboxes and radios
@@ -100,7 +102,7 @@ export declare const SENSITIVE_FIELD_JS = "(el) => {\n  const autocomplete = el.
  * is replaced by {@link MASKED_VALUE}, whatever its length, with
  * `sensitive: true`.
  */
-export declare const ELEMENT_STATE_JS = "(el) => {\n  const isSensitive = (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};\n  const mask = (value) => (value ? '\u2022\u2022\u2022\u2022' : '');\n  const guarded = (state) => {\n    if (!isSensitive(el)) return state;\n    const result = { ...state, sensitive: true };\n    if ('value' in result) result.value = mask(result.value);\n    if ('selected' in result) result.selected = mask(result.selected);\n    return result;\n  };\n  switch (el.localName) {\n    case 'input':\n      if (el.type === 'hidden') return { type: 'hidden' };\n      return guarded(\n        /^(checkbox|radio)$/.test(el.type)\n          ? { type: el.type, checked: el.checked, value: el.getAttribute('value') || '' }\n          : { type: el.type, value: el.value }\n      );\n    case 'textarea':\n      return guarded({ value: el.value });\n    case 'select':\n      return guarded({ selected: Array.from(el.selectedOptions || [], (option) => option.label).join(', ') });\n    case 'button':\n      return el.form ? { type: el.type } : {};\n    default:\n      return {};\n  }\n}";
+export declare const ELEMENT_STATE_JS = "(el) => {\n  const isSensitive = (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|passphrase|(^|[^a-z])(otp|pin|ssn)([^a-z]|$)|cvv|cvc|card[-_]?(num(ber)?|no)([^a-z]|$)/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};\n  const mask = (value) => (value ? '\u2022\u2022\u2022\u2022' : '');\n  const guarded = (state) => {\n    if (!isSensitive(el)) return state;\n    const result = { ...state, sensitive: true };\n    if ('value' in result) result.value = mask(result.value);\n    if ('selected' in result) result.selected = mask(result.selected);\n    return result;\n  };\n  switch (el.localName) {\n    case 'input':\n      if (el.type === 'hidden') return { type: 'hidden' };\n      return guarded(\n        /^(checkbox|radio)$/.test(el.type)\n          ? { type: el.type, checked: el.checked, value: el.getAttribute('value') || '' }\n          : { type: el.type, value: el.value }\n      );\n    case 'textarea':\n      return guarded({ value: el.value });\n    case 'select':\n      return guarded({ selected: Array.from(el.selectedOptions || [], (option) => option.label).join(', ') });\n    case 'button':\n      return el.form ? { type: el.type } : {};\n    default:\n      return {};\n  }\n}";
 /**
  * Page-side short description of an element: tag, id and up to two classes
  * ({@link LABEL_CLASSES_JS}), e.g. `button#save.primary.large`.

package/dist/runtime/dom/elementInfo.js

@@ -159,18 +159,20 @@ export const ELEMENT_TEXT_JS = `(el, full) => {
 export const MASKED_VALUE = '••••';
 /**
  * Regular expression source (case-insensitive) matching names of fields that
- * hold a password, one-time code or card code: `password`, `passwd`, `pwd`,
- * `passcode`, `otp`, `cvv`, `cvc`. Shared by the page-side
- * {@link SENSITIVE_FIELD_JS} and HAR sanitization.
+ * hold a password, one-time code, PIN, social security number or card data:
+ * `password`, `passwd`, `pwd`, `passcode`, `passphrase`, `otp`, `pin`, `ssn`
+ * (these three as whole words), `cvv`, `cvc`, `card_number`, `cardNo` (whole
+ * words). Shared
+ * by the page-side {@link SENSITIVE_FIELD_JS} and HAR sanitization.
  */
-export const SENSITIVE_NAME_SOURCE = 'passw|passwd|pwd|passcode|(^|[^a-z])otp([^a-z]|$)|cvv|cvc';
+export const SENSITIVE_NAME_SOURCE = 'passw|passwd|pwd|passcode|passphrase|(^|[^a-z])(otp|pin|ssn)([^a-z]|$)|cvv|cvc|card[-_]?(num(ber)?|no)([^a-z]|$)';
 /**
  * Page-side check whether a form control holds a secret whose value must
  * never leave the page: a password field (live type or type attribute), a
  * field shown masked by CSS (`-webkit-text-security` other than `none`),
  * one whose `autocomplete` names a password, a payment card (`cc-*`) or a
- * one-time code, or a field named like a password, one-time code or card code
- * (`password`, `passwd`, `pwd`, `passcode`, `otp`, `cvv`, `cvc`), which
+ * one-time code, or a field named like a password, one-time code, PIN, SSN
+ * or card data ({@link SENSITIVE_NAME_SOURCE}), which
  * covers a password field switched to text by a "show password" button.
  */
 export const SENSITIVE_FIELD_JS = `(el) => {

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

@@ -19,7 +19,7 @@ import type { RawFormData } from './formTypes.js';
  *   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 (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";
+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|passphrase|(^|[^a-z])(otp|pin|ssn)([^a-z]|$)|cvv|cvc|card[-_]?(num(ber)?|no)([^a-z]|$)/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.
  *

package/dist/runtime/page/bdgWorld.d.ts

@@ -23,6 +23,15 @@ import type { Protocol } from '../../connection/typed-cdp.js';
 type PageConnection = Pick<CDPConnection, 'send'> & Partial<Pick<CDPConnection, 'on'>>;
 /** Name of bdg's isolated world (shown in DevTools' context selector) */
 export declare const BDG_WORLD_NAME = "bdg";
+/**
+ * Whether bdg's world is known for a connection: created or being created,
+ * and not forgotten since (the top frame navigated, or its contexts were
+ * cleared). Scripts left in a forgotten world went with its document.
+ *
+ * @param cdp - Connection to the page
+ * @returns True while the world is known
+ */
+export declare function hasBdgWorld(cdp: PageConnection): boolean;
 /**
  * `Runtime.evaluate` in bdg's world of the top frame. A call that names its
  * own context is sent as it is.

package/dist/runtime/page/bdgWorld.js

@@ -37,6 +37,17 @@ function worldContext(cdp) {
     worlds.set(cdp, created);
     return created;
 }
+/**
+ * Whether bdg's world is known for a connection: created or being created,
+ * and not forgotten since (the top frame navigated, or its contexts were
+ * cleared). Scripts left in a forgotten world went with its document.
+ *
+ * @param cdp - Connection to the page
+ * @returns True while the world is known
+ */
+export function hasBdgWorld(cdp) {
+    return worlds.has(cdp);
+}
 /**
  * Create the world in the top frame and forget it when the page changes.
  *

package/dist/runtime/page/captureEmulation.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Page emulation a screenshot changes for its capture, and puts back.
+ *
+ * A capture at a pixel ratio of 1 on a high-DPI page, and one beyond the
+ * viewport, override the device metrics (and hide the scrollbars). Each
+ * change is recorded before it is sent, so {@link CaptureEmulation.restore}
+ * (called once the capture ended, however it ended) undoes exactly what may
+ * have been changed: the session's emulation is put back from the daemon's
+ * own record of it as it is then (a `page emulate` during the capture
+ * counts), not from a file.
+ */
+import type { CDPConnection } from '../../connection/cdp.js';
+import type { ViewportSize } from '../../types.js';
+/** Width and height in CSS px */
+export interface Size {
+    width: number;
+    height: number;
+}
+/** A page position in CSS px */
+export interface ScrollPosition {
+    x: number;
+    y: number;
+}
+/**
+ * Evaluate one of bdg's page scripts and return its value.
+ *
+ * @param cdp - Session connection
+ * @param expression - Script
+ * @returns Its value, or undefined when it threw
+ */
+export declare function evaluateValue(cdp: CDPConnection, expression: string): Promise<unknown>;
+/**
+ * Two numbers a page script returned as an array.
+ *
+ * @param cdp - Session connection
+ * @param expression - Script returning `[a, b]`
+ * @returns The numbers, undefined where the page did not answer
+ */
+export declare function evaluatePair(cdp: CDPConnection, expression: string): Promise<[number | undefined, number | undefined]>;
+/**
+ * The page's scroll position.
+ *
+ * @param cdp - Session connection
+ * @returns Scroll offsets in CSS px
+ */
+export declare function scrollPosition(cdp: CDPConnection): Promise<ScrollPosition>;
+/**
+ * The emulation changes of one capture, undone by {@link restore}.
+ */
+export declare class CaptureEmulation {
+    private readonly connection;
+    private readonly sessionViewport;
+    private readonly cdp;
+    private metricsChanged;
+    private scrollbarsHidden;
+    private scrolledFrom;
+    /**
+     * @param connection - Session connection
+     * @param sessionViewport - Reads the session's emulated viewport
+     *   (`--viewport`, `--mobile`, `page emulate`) as it is now; put back
+     *   afterwards, none clears the override
+     */
+    constructor(connection: CDPConnection, sessionViewport: () => ViewportSize | undefined);
+    /**
+     * Capture at a pixel ratio of 1 (CSS px = image px) on a high-DPI page:
+     * the viewport is overridden at the session's viewport, else the window's
+     * size with its scrollbars (so the layout does not change).
+     *
+     * @param devicePixelRatio - Page's pixel ratio
+     * @param viewport - Visible viewport size, used when the page does not answer
+     */
+    useUnitPixelRatio(devicePixelRatio: number, viewport: Size): Promise<void>;
+    /**
+     * Lay the page out at its current width without scrollbars: a capture
+     * beyond the viewport hides them, and without this the page would widen by
+     * the scrollbar and centered content move after it was measured. The
+     * viewport is overridden at the visible size (CSS px, pixel ratio 1; still
+     * a phone in a phone session).
+     *
+     * @param view - Visible viewport size
+     */
+    keepLayoutWithoutScrollbars(view: Size): Promise<void>;
+    /**
+     * Record where the page was scrolled before the capture moved it, to
+     * scroll it back afterwards (the first position recorded wins).
+     *
+     * @param position - Scroll position before the capture
+     */
+    scrolledAwayFrom(position: ScrollPosition): void;
+    /**
+     * Put back what the capture changed: scrollbars shown, the session's
+     * device metrics (its viewport and a phone's touch input, which a capture
+     * beyond the viewport turns off), else none, and the scroll position. Each
+     * step runs even when an earlier one failed.
+     *
+     * @throws The first step's error, once every step ran
+     */
+    restore(): Promise<void>;
+    /**
+     * The steps {@link restore} runs, for what the capture changed.
+     *
+     * @returns Named steps, in order
+     */
+    private restoreSteps;
+    /**
+     * Put back the session's device metrics, or clear the override.
+     */
+    private restoreSessionMetrics;
+    /**
+     * The window's size with its scrollbars (`innerWidth`/`innerHeight`): an
+     * override at this size keeps the page's layout, where the visible size
+     * (without scrollbars) would narrow it and move centered content.
+     *
+     * @param viewport - Visible viewport size, used when the page does not answer
+     * @returns Width and height in CSS px
+     */
+    private windowSize;
+}
+//# sourceMappingURL=captureEmulation.d.ts.map