@orkestrel/browser 0.0.20 → 0.0.22

package/dist/src/browser/index.js

@@ -1,5 +1,5 @@
 import { attempt, isInteger, isObject, isString } from "@orkestrel/contract";
-import { BROWSER_DEFAULT_TIMEOUT_MS, BROWSER_INTERACTIVE_ROLES, BROWSER_OUTLINE_LIMIT, BROWSER_REFERENCE_PREFIX, BROWSER_RESULT_LIMIT, BrowserConnectionError, BrowserElementError, BrowserError, BrowserResultLimitError, BrowserToolset, BrowserTransition, createBrowserReading, filterBrowserOutline, normalizeBrowserName, parseBrowserReference, renderBrowserOutline, validateBrowserTimeout } from "../core/index.js";
+import { BROWSER_DEFAULT_TIMEOUT_MS, BROWSER_INTERACTIVE_ROLES, BROWSER_OUTLINE_LIMIT, BROWSER_REFERENCE_PREFIX, BROWSER_RESULT_LIMIT, BROWSER_WAIT_EVENTS, BrowserConnectionError, BrowserElementError, BrowserError, BrowserResultLimitError, BrowserToolset, BrowserTransition, createBrowserReading, filterBrowserOutline, normalizeBrowserName, parseBrowserReference, renderBrowserOutline, validateBrowserTimeout } from "../core/index.js";
 import { Emitter } from "@orkestrel/emitter";
 //#region src/browser/constants.ts
 /**
@@ -129,6 +129,35 @@ var BROWSER_CONTEXT_TARGETS = Object.freeze(/* @__PURE__ */ new Set([
 	"_parent",
 	"_top"
 ]));
+/**
+* Names the roles whose ARIA expansion state the DOM outline reads.
+*
+* @remarks
+* The role set follows the accessibility-tree reading from Chromium 141.0.7390.37.
+*/
+var BROWSER_EXPANDED_ROLES = Object.freeze(/* @__PURE__ */ new Set([
+	"button",
+	"link",
+	"checkbox",
+	"switch",
+	"menuitem",
+	"menuitemcheckbox",
+	"menuitemradio",
+	"tab",
+	"treeitem",
+	"combobox"
+]));
+/**
+* Names the roles whose selection state the DOM outline reads.
+*
+* @remarks
+* The role set follows the accessibility-tree reading from Chromium 141.0.7390.37.
+*/
+var BROWSER_SELECTED_ROLES = Object.freeze(/* @__PURE__ */ new Set([
+	"option",
+	"tab",
+	"treeitem"
+]));
 /** Names the `input` type states whose value an untrusted `fill` sets as typed text. */
 var BROWSER_TYPED_INPUTS = Object.freeze(/* @__PURE__ */ new Set([
 	"date",
@@ -163,15 +192,16 @@ function isBrowserDocument(value) {
 	return isObject(value) && Reflect.get(value, "nodeType") === 9 && isObject(Reflect.get(value, "defaultView"));
 }
 /**
-* Reads the URL, title, and serialized markup a DOM reading is built from, refusing a capture
+* Reads the URL, title, and rendered markup a DOM reading is built from, refusing a capture
 * over the result limit before any parse.
 *
 * @remarks
 * The measure is the length of `JSON.stringify({ url, title, html })`, the form the CDP capture
 * guard compares with `BROWSER_RESULT_LIMIT`, so a character JSON escapes counts as its escape
 * sequence. A reading a caller builds with `createBrowserReading` passes through no limit.
+* {@link BrowserReadingInput} defines the inert capture, lowering, redaction, and limits.
 *
-* @param node - The element whose `outerHTML` is captured; its owner document supplies `URL`
+* @param node - The root whose rendered markup is captured; its owner document supplies `URL`
 * and `title`
 * @returns The capture's `url`, `title`, and `html`
 * @throws Thrown as a `BrowserResultLimitError` when the serialized capture is longer than
@@ -182,8 +212,241 @@ function readBrowserCapture(node) {
 	const capture = {
 		url: document.URL,
 		title: document.title,
-		html: node.outerHTML
+		html: ""
 	};
+	const view = document.defaultView;
+	const rendered = view !== null && node.isConnected;
+	const inert = document.implementation.createHTMLDocument("");
+	let root = inert.importNode(node, true);
+	const pending = [{
+		live: node,
+		twin: root,
+		visited: false
+	}];
+	if (rendered) {
+		let child = node;
+		for (let parent = node; parent?.ownerDocument === document; parent = readBrowserParent(parent)) {
+			const style = view.getComputedStyle(parent);
+			const outside = parent !== node && (style.contentVisibility === "hidden" || [
+				"canvas",
+				"video",
+				"audio"
+			].includes(parent.localName) || parent instanceof view.HTMLInputElement || parent instanceof view.HTMLTextAreaElement || parent instanceof view.HTMLOptionElement || parent.namespaceURI === "http://www.w3.org/2000/svg" && parent.localName === "switch" && child !== (Array.from(parent.children).find((candidate) => candidate.getClientRects().length > 0) ?? parent.firstElementChild) || (parent instanceof view.HTMLSelectElement || parent instanceof view.HTMLOptGroupElement) && !(node instanceof view.HTMLOptionElement || node instanceof view.HTMLOptGroupElement) || [
+				"script",
+				"style",
+				"template",
+				"frame",
+				"frameset",
+				"iframe",
+				"object",
+				"embed",
+				"applet",
+				"noscript",
+				"meta",
+				"link",
+				"base",
+				"math"
+			].includes(parent.localName) || parent.localName === "details" && !parent.hasAttribute("open") && child !== parent.querySelector(":scope > summary"));
+			const unassigned = child.parentElement?.shadowRoot !== null && child.parentElement?.shadowRoot !== void 0 && child.assignedSlot === null;
+			if (style.display === "none" || outside || unassigned) {
+				root = void 0;
+				pending.length = 0;
+				break;
+			}
+			child = parent;
+		}
+	}
+	while (pending.length > 0) {
+		const entry = pending.pop();
+		if (entry === void 0) continue;
+		const { live, twin, visited } = entry;
+		const tag = live.localName;
+		const input = tag === "input" ? live.getAttribute("type")?.toLowerCase() ?? "text" : "";
+		if ([
+			"script",
+			"style",
+			"template",
+			"frame",
+			"frameset",
+			"iframe",
+			"object",
+			"embed",
+			"applet",
+			"noscript",
+			"meta",
+			"link",
+			"base",
+			"math"
+		].includes(tag) || tag === "input" && ["password", "hidden"].includes(input)) {
+			twin.remove();
+			if (twin === root) root = void 0;
+			continue;
+		}
+		const style = entry.style ?? (rendered ? view.getComputedStyle(live) : void 0);
+		const invisible = style?.visibility === "hidden" || style?.visibility === "collapse";
+		if (style?.display === "none" || invisible && !live.hasChildNodes()) {
+			twin.remove();
+			if (twin === root) root = void 0;
+			continue;
+		}
+		if (!visited) {
+			pending.push({
+				live,
+				twin,
+				style,
+				visited: true
+			});
+			if (rendered) {
+				twin.removeAttribute("hidden");
+				twin.removeAttribute("aria-hidden");
+			}
+			if (rendered && (live instanceof view.HTMLAnchorElement || live instanceof view.HTMLAreaElement) && live.hasAttribute("href")) twin.setAttribute("href", live.href);
+			if (style?.contentVisibility === "hidden" || [
+				"canvas",
+				"video",
+				"audio"
+			].includes(tag)) {
+				twin.replaceChildren();
+				continue;
+			}
+			if (rendered && (live instanceof view.HTMLInputElement || live instanceof view.HTMLTextAreaElement || live instanceof view.HTMLSelectElement || live instanceof view.HTMLOptionElement || live instanceof view.HTMLOptGroupElement)) continue;
+			const summary = tag === "details" && !live.hasAttribute("open") ? live.querySelector(":scope > summary") : void 0;
+			const conditional = tag === "switch" && live.namespaceURI === "http://www.w3.org/2000/svg";
+			const branch = rendered && conditional ? Array.from(live.children).find((candidate) => candidate.getClientRects().length > 0) ?? live.firstElementChild : void 0;
+			let element = live.lastElementChild;
+			let counterpart = twin.lastElementChild;
+			let child = live.lastChild;
+			let mirror = twin.lastChild;
+			while (child !== null && mirror !== null) {
+				const previous = child.previousSibling;
+				const previousMirror = mirror.previousSibling;
+				const previousElement = element?.previousElementSibling ?? null;
+				const previousCounterpart = counterpart?.previousElementSibling ?? null;
+				let omitted = rendered && (summary !== void 0 && child !== summary || conditional && child !== branch);
+				if (rendered && live.shadowRoot !== null) {
+					const slot = child instanceof view.Element || child instanceof view.Text ? child.assignedSlot : null;
+					if (slot === null) omitted = true;
+					else for (let parent = slot; parent !== null && parent !== live; parent = readBrowserParent(parent)) if (view.getComputedStyle(parent).display === "none") omitted = true;
+				}
+				if (omitted || child.nodeType === 3 && invisible) mirror.parentNode?.removeChild(mirror);
+				else if (child.nodeType === 1) {
+					if (element !== null && counterpart !== null) pending.push({
+						live: element,
+						twin: counterpart,
+						visited: false
+					});
+				}
+				if (child.nodeType === 1) {
+					element = previousElement;
+					counterpart = previousCounterpart;
+				}
+				child = previous;
+				mirror = previousMirror;
+			}
+			continue;
+		}
+		if (!rendered || style?.contentVisibility === "hidden") continue;
+		if ([
+			"div",
+			"summary",
+			"details"
+		].includes(tag) && !style?.display.startsWith("inline") && style?.display !== "contents" && twin.hasChildNodes()) {
+			twin.prepend(inert.createElement("br"));
+			twin.append(inert.createElement("br"));
+		}
+		let fragments;
+		let lines;
+		let container = false;
+		if (live instanceof view.HTMLInputElement) {
+			lines = [];
+			if ([
+				"text",
+				"email",
+				"search",
+				"tel",
+				"url",
+				"number"
+			].includes(live.type)) {
+				if (live.type !== "number" || !live.validity.badInput) {
+					const placeholder = view.getComputedStyle(live, "::placeholder");
+					lines = [live.value || (live.matches(":placeholder-shown") && placeholder.visibility === "visible" && placeholder.opacity !== "0" && placeholder.color !== "rgba(0, 0, 0, 0)" ? live.placeholder : "")];
+				}
+			} else if ([
+				"submit",
+				"reset",
+				"button"
+			].includes(live.type)) lines = [live.value];
+			else if (live.type === "file" && live.files?.length === 1) lines = Array.from(live.files ?? [], (file) => file.name);
+			else if (live.type === "image" && live.getAttribute("aria-hidden") !== "true") lines = [live.getAttribute("aria-label")?.trim() || live.alt];
+		} else if (live instanceof view.HTMLTextAreaElement) {
+			const placeholder = view.getComputedStyle(live, "::placeholder");
+			lines = (live.value || (live.matches(":placeholder-shown") && placeholder.visibility === "visible" && placeholder.opacity !== "0" && placeholder.color !== "rgba(0, 0, 0, 0)" ? live.placeholder : "")).split(/\r?\n/);
+		} else if (live instanceof view.HTMLSelectElement || live instanceof view.HTMLOptionElement || live instanceof view.HTMLOptGroupElement) {
+			lines = [];
+			const select = live instanceof view.HTMLSelectElement ? live : live.closest("select");
+			if (select !== null) {
+				if (!select.multiple && select.size <= 1) {
+					const option = select.selectedOptions[0];
+					if (option !== void 0 && (live === select || live === option || live.contains(option))) lines.push(option.label);
+				} else {
+					const box = select.getBoundingClientRect();
+					const top = box.top + select.clientTop;
+					const bottom = top + select.clientHeight;
+					const rows = live === select ? select.querySelectorAll("option,optgroup") : [live, ...live.querySelectorAll("option")];
+					for (const row of rows) {
+						const rowStyle = view.getComputedStyle(row);
+						const groupStyle = row.parentElement instanceof view.HTMLOptGroupElement ? view.getComputedStyle(row.parentElement) : void 0;
+						if (rowStyle.display === "none" || rowStyle.visibility !== "visible" || groupStyle?.display === "none") continue;
+						const rect = row.getBoundingClientRect();
+						if ((row instanceof view.HTMLOptGroupElement ? Array.from(row.querySelectorAll("option")).find((option) => option.getClientRects().length > 0)?.getBoundingClientRect().top ?? rect.bottom : rect.bottom) > top && rect.top < bottom && rect.right > box.left + select.clientLeft && rect.left < box.left + select.clientLeft + select.clientWidth && (row instanceof view.HTMLOptionElement || row instanceof view.HTMLOptGroupElement)) lines.push(row.label);
+					}
+				}
+			}
+		} else if (tag === "svg") {
+			if (twin.parentElement?.closest("svg, foreignObject")?.localName === "svg") continue;
+			lines = [];
+			fragments = [];
+			for (const content of twin.querySelectorAll("text, foreignObject")) {
+				if (content.parentElement?.closest("svg, foreignObject")?.localName === "foreignObject") continue;
+				if (content.localName === "text" && content.parentElement?.closest("text")?.closest("svg") === content.closest("svg")) continue;
+				if (content.localName === "foreignObject") fragments.push(...content.childNodes);
+				else if (content.textContent) fragments.push(inert.createTextNode(content.textContent));
+			}
+			if (fragments.length === 0) fragments = void 0;
+			if (!invisible && fragments === void 0 && live.getAttribute("aria-hidden") !== "true") lines.push(live.getAttribute("aria-label")?.trim() || live.querySelector(":scope > title")?.textContent || "");
+		} else if ([
+			"form",
+			"dialog",
+			"button"
+		].includes(tag)) {
+			container = true;
+			if (live instanceof view.HTMLButtonElement && !invisible && live.innerText.trim() === "") {
+				const name = live.getAttribute("aria-label")?.trim();
+				if (name) {
+					lines = [name];
+					container = false;
+				}
+			}
+		}
+		if (lines === void 0 && !container) continue;
+		if (invisible && !container && tag !== "svg") lines = [];
+		const block = !style?.display.startsWith("inline") && style?.display !== "contents";
+		const carrier = inert.createElement(block ? "div" : "span");
+		if (container) carrier.append(...twin.childNodes);
+		else if (fragments !== void 0) for (const fragment of fragments) carrier.append(fragment, inert.createElement("br"));
+		else for (const [index, line] of (lines ?? []).entries()) {
+			if (index > 0) carrier.append(inert.createElement("br"));
+			carrier.append(inert.createTextNode(line));
+		}
+		if (carrier.hasChildNodes()) {
+			carrier.prepend(inert.createElement("br"));
+			carrier.append(inert.createElement("br"));
+		}
+		twin.replaceWith(carrier);
+		if (twin === root) root = carrier;
+	}
+	for (const input of root?.querySelectorAll("input[type=\"password\" i],input[type=\"hidden\" i]") ?? []) input.remove();
+	capture.html = root?.outerHTML ?? "";
 	const length = JSON.stringify(capture).length;
 	if (length > BROWSER_RESULT_LIMIT) throw new BrowserResultLimitError("Document capture exceeds BROWSER_RESULT_LIMIT", {
 		length,
@@ -695,6 +958,59 @@ function listenBrowserNavigation(window, listener, signal) {
 	}
 	window.addEventListener("pagehide", listener, options);
 }
+/**
+* Reads a lowercased ARIA token, preserving whitespace and treating empty or undefined tokens as absent.
+*
+* @param element - The element carrying the attribute
+* @param attribute - The ARIA attribute name
+* @returns The lowercased token, or `undefined` for a missing, empty, or `undefined` attribute
+*
+* @example
+* ```ts
+* const button = document.createElement('button')
+* button.setAttribute('aria-pressed', 'TRUE')
+* readBrowserToken(button, 'aria-pressed') // 'true'
+* ```
+*/
+function readBrowserToken(element, attribute) {
+	const token = element.getAttribute(attribute)?.toLowerCase();
+	return token === "" || token === "undefined" ? void 0 : token;
+}
+/**
+* Reads the pressed, expanded, and selected states the DOM outline assigns to an element's role.
+*
+* @remarks
+* Only buttons carry pressed state. Expansion follows `BROWSER_EXPANDED_ROLES`, with native
+* single selects always collapsed. Selection follows `BROWSER_SELECTED_ROLES`: an ARIA token
+* overrides native option selectedness, and other elements without a token omit selection. Tokens are not
+* trimmed; values other than `false` are true, except the pressed token `mixed`.
+*
+* @param element - The element whose attributes and native state are read
+* @param role - Its computed accessibility role
+* @returns Present states, including false, with pressed represented as a tristate string
+*
+* @example
+* ```ts
+* const button = document.createElement('button')
+* button.setAttribute('aria-pressed', 'mixed')
+* readBrowserStates(button, 'button') // { pressed: 'mixed' }
+* ```
+*/
+function readBrowserStates(element, role) {
+	const states = {};
+	const pressed = readBrowserToken(element, "aria-pressed");
+	const expanded = readBrowserToken(element, "aria-expanded");
+	const selected = readBrowserToken(element, "aria-selected");
+	const view = element.ownerDocument.defaultView;
+	if (role === "button" && pressed !== void 0) states["pressed"] = pressed === "false" || pressed === "mixed" ? pressed : "true";
+	if (role === "combobox" && view !== null && element instanceof view.HTMLSelectElement && !element.multiple && element.size <= 1) states["expanded"] = false;
+	else if (BROWSER_EXPANDED_ROLES.has(role) && expanded !== void 0) states["expanded"] = expanded !== "false";
+	if (BROWSER_SELECTED_ROLES.has(role)) {
+		if (selected !== void 0) states["selected"] = selected !== "false";
+		else if (view !== null && element instanceof view.HTMLOptionElement) states["selected"] = element.selected;
+	}
+	return states;
+}
 //#endregion
 //#region src/browser/elements/BrowserDOMElement.ts
 /**
@@ -851,14 +1167,15 @@ var BrowserDOMElement = class {
 //#endregion
 //#region src/browser/BrowserDOMWait.ts
 /**
-* Parks one condition on DOM mutations until it holds, with one deadline and no other timer.
+* Parks one condition on DOM mutations and finished transitions and animations until it holds, with one deadline and coalesced wake tasks.
 *
 * @remarks
 * The wait observes every root `roots` returns, each through a `MutationObserver` of that root's
-* realm, and re-reads the roots after every mutation batch and every capture-phase `load` in an
-* observed root: a same-origin frame or an open shadow root that appears joins the observation,
+* realm, and re-reads the roots after every mutation batch, every capture-phase `load`, and
+* the task after a `BROWSER_WAIT_EVENTS` event in an observed root: a same-origin
+* frame or an open shadow root that appears joins the observation,
 * and a root that departed (a replaced frame document, a removed shadow root) leaves it, with its
-* observer disconnected and its `load` listener removed. The check runs before the wait parks and
+* observer disconnected and its listeners removed. The check runs before the wait parks and
 * again after every subscription, and no check runs once the deadline, counted from `start`, has
 * passed, which the wait reads again after `roots` returns. The wait settles one time: on the
 * check's first value, on the signal's abort with its reason, at the deadline with
@@ -870,9 +1187,9 @@ var BrowserDOMElement = class {
 * observer, listener, or further check behind.
 *
 * A shadow root attached after the wait began is a declared limit: attaching one fires no
-* mutation record and no event, so the wait discovers it at the next mutation or `load` it
-* observes, and a match inserted into it with no other observed change is not seen before the
-* deadline. The wait never polls to close that gap.
+* mutation record and no event, so the wait discovers it at the next mutation batch, `load`,
+* or `BROWSER_WAIT_EVENTS` event it observes, and a match inserted into it with no other
+* observed change is not seen before the deadline. The wait never polls to close that gap.
 *
 * @example
 * ```ts
@@ -892,7 +1209,10 @@ var BrowserDOMWait = class {
 	#observers = /* @__PURE__ */ new Map();
 	#main;
 	#timer;
+	#task;
 	#recheckHandler = this.#recheck.bind(this);
+	#scheduleHandler = this.#schedule.bind(this);
+	#wakeHandler = this.#wake.bind(this);
 	#unloadHandler = this.#unload.bind(this);
 	constructor(wait) {
 		this.#wait = wait;
@@ -911,6 +1231,14 @@ var BrowserDOMWait = class {
 		this.#recheck();
 		return await this.#settled.promise;
 	}
+	#schedule() {
+		if (this.#release.signal.aborted || this.#task !== void 0) return;
+		this.#task = setTimeout(this.#wakeHandler, 0);
+	}
+	#wake() {
+		this.#task = void 0;
+		this.#recheck();
+	}
 	#recheck() {
 		if (this.#release.signal.aborted) return;
 		if (this.#remaining() <= 0) {
@@ -954,6 +1282,10 @@ var BrowserDOMWait = class {
 				capture: true,
 				signal: release.signal
 			});
+			for (const name of BROWSER_WAIT_EVENTS) root.addEventListener(name, this.#scheduleHandler, {
+				capture: true,
+				signal: release.signal
+			});
 			this.#observers.set(root, {
 				observer,
 				release
@@ -983,6 +1315,8 @@ var BrowserDOMWait = class {
 	}
 	#stop() {
 		clearTimeout(this.#timer);
+		clearTimeout(this.#task);
+		this.#task = void 0;
 		this.#release.abort();
 		for (const entry of this.#observers.values()) {
 			entry.observer.disconnect();
@@ -1009,8 +1343,10 @@ var BrowserDOMWait = class {
 * wrapper reports that latest capture, also after the manager drops the reference. A reference
 * and a reading from any walked document record that document's epoch, which advances on its own
 * navigation events and on the view's; that document's `pagehide` drops its references. A form
-* carrying a `toolname` attribute renders `[tool=NAME]` after its role and name. A `select` row
-* is followed by one `option` row per option, named by its label. Whitespace between two texts of
+* carrying a `toolname` attribute renders `[tool=NAME]` after its role and name. A row carries
+* `focused` when its element is the active element of its own document or shadow root. Rows carry
+* pressed, expanded, and selected states through the Chromium mapping in `readBrowserStates`.
+* A `select` row is followed by one `option` row per option, named by its label. Whitespace between two texts of
 * one block renders as one space, as a rendered `br` between them does, and texts with neither
 * between them stay joined. A CSS query
 * searches the document the view drives, not its child documents or shadow trees. After the
@@ -1047,7 +1383,7 @@ var BrowserDOMElementManager = class {
 		options?.signal?.throwIfAborted();
 		const document = this.#input.document();
 		const rows = this.#capture(this.#root(document, options?.within), options?.within);
-		return renderBrowserOutline(document.URL, document.title, rows, limit);
+		return renderBrowserOutline(document.URL, document.title, rows, limit, options?.search);
 	}
 	async find(query, options) {
 		this.#input.signal.throwIfAborted();
@@ -1237,6 +1573,8 @@ var BrowserDOMElementManager = class {
 		const reference = role === "heading" ? void 0 : this.#bind(element, role, name).reference;
 		const input = element instanceof view.HTMLInputElement ? element : void 0;
 		const checked = input !== void 0 && (input.type === "checkbox" || input.type === "radio") ? input.checked : element.getAttribute("aria-checked") === "true";
+		const root = element.getRootNode();
+		const focused = (root instanceof view.Document || root instanceof view.ShadowRoot) && root.activeElement === element;
 		let value;
 		if (element instanceof view.HTMLSelectElement) value = Array.from(element.selectedOptions, (option) => option.label).join(", ");
 		else if (element instanceof view.HTMLTextAreaElement) value = element.value;
@@ -1254,7 +1592,9 @@ var BrowserDOMElementManager = class {
 			value,
 			properties: {
 				checked,
-				disabled: element.matches(":disabled")
+				disabled: element.matches(":disabled"),
+				focused,
+				...readBrowserStates(element, role)
 			},
 			...tool === null || tool === "" ? {} : { tool },
 			session: "",
@@ -1379,7 +1719,7 @@ var BrowserDOMView = class {
 		const document = this.#current();
 		await new BrowserDOMWait({
 			roots: collectBrowserRoots.bind(void 0, document),
-			check: this.#contains.bind(this, document, text),
+			check: this.#contains.bind(this, document, text, options?.absent === true),
 			timeout,
 			start,
 			signal: options?.signal === void 0 ? this.#release.signal : AbortSignal.any([options.signal, this.#release.signal]),
@@ -1408,8 +1748,8 @@ var BrowserDOMView = class {
 		this.#epoch += 1;
 		if (event === void 0 || event.type === "pagehide") this.#elements.clear();
 	}
-	#contains(document, text) {
-		return (document.body?.innerText ?? "").includes(text) ? true : void 0;
+	#contains(document, text, absent) {
+		return (document.body?.innerText ?? "").includes(text) !== absent ? true : void 0;
 	}
 	#listen() {
 		this.#listeners.abort();
@@ -1574,7 +1914,7 @@ function createBrowserDOMView(options) {
 *
 * @remarks
 * The toolset runs over a view {@link createBrowserDOMView} creates for `document`, so it
-* advertises `look`, `read`, `click`, `type`, and `wait`, and a click or type receipt ends with
+* advertises `look`, `read`, `plain`, `click`, `type`, and `wait`, and a click or type receipt ends with
 * ` (untrusted event)`. `source` supplies page tools, which the toolset adopts during `start()`
 * and again on every `change`; `toolset.native` never includes them, so publishing it to a
 * registry leaves that registry's own tools alone. The view belongs to the toolset: `destroy()`
@@ -1594,7 +1934,7 @@ function createBrowserDOMView(options) {
 * ```ts
 * const toolset = createDocumentToolset({ document: frame.contentDocument, source: bridge })
 * await toolset.start()
-* await toolset.tools.execute({ id: '1', name: 'look', arguments: { what: 'form' } })
+* await toolset.tools.execute({ id: '1', name: 'look', arguments: { search: 'form' } })
 * ```
 */
 function createDocumentToolset(options) {
@@ -1635,6 +1975,6 @@ function createSocketCDPTransport(options) {
 	return new SocketCDPTransport(options);
 }
 //#endregion
-export { BROWSER_CONTENT_NAMED_ROLES, BROWSER_CONTEXT_TARGETS, BROWSER_DOCUMENT_TIMEOUT_MS, BROWSER_IMPLICIT_ROLES, BROWSER_INTERACTIVE_CONTENT, BROWSER_TYPED_INPUTS, BrowserDOMElement, BrowserDOMElementManager, BrowserDOMView, BrowserDOMWait, SocketCDPTransport, collectBrowserRoots, computeBrowserAlternative, computeBrowserName, computeBrowserRole, computeBrowserText, createBrowserDOMView, createDocumentToolset, createSocketCDPTransport, isBrowserDocument, listenBrowserNavigation, matchesBrowserActivation, matchesBrowserBlock, matchesBrowserHidden, matchesBrowserInvisible, matchesBrowserOmitted, matchesBrowserPopup, readBrowserBlock, readBrowserCapture, readBrowserContent, readBrowserParent, skipBrowserSubtree };
+export { BROWSER_CONTENT_NAMED_ROLES, BROWSER_CONTEXT_TARGETS, BROWSER_DOCUMENT_TIMEOUT_MS, BROWSER_EXPANDED_ROLES, BROWSER_IMPLICIT_ROLES, BROWSER_INTERACTIVE_CONTENT, BROWSER_SELECTED_ROLES, BROWSER_TYPED_INPUTS, BrowserDOMElement, BrowserDOMElementManager, BrowserDOMView, BrowserDOMWait, SocketCDPTransport, collectBrowserRoots, computeBrowserAlternative, computeBrowserName, computeBrowserRole, computeBrowserText, createBrowserDOMView, createDocumentToolset, createSocketCDPTransport, isBrowserDocument, listenBrowserNavigation, matchesBrowserActivation, matchesBrowserBlock, matchesBrowserHidden, matchesBrowserInvisible, matchesBrowserOmitted, matchesBrowserPopup, readBrowserBlock, readBrowserCapture, readBrowserContent, readBrowserParent, readBrowserStates, readBrowserToken, skipBrowserSubtree };
 
 //# sourceMappingURL=index.js.map