@orkestrel/browser 0.0.26 → 0.0.28

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, BROWSER_WAIT_EVENTS, BrowserConnectionError, BrowserElementError, BrowserError, BrowserResultLimitError, BrowserToolset, BrowserTransition, createBrowserReading, filterBrowserOutline, normalizeBrowserName, parseBrowserReference, renderBrowserOutline, validateBrowserTimeout } from "../core/index.js";
+import { attempt, isInteger, isJSONValue, isObject, isString } from "@orkestrel/contract";
+import { BROWSER_DEFAULT_TIMEOUT_MS, BROWSER_INTERACTIVE_ROLES, BROWSER_OUTLINE_LIMIT, BROWSER_REFERENCE_PREFIX, BROWSER_RESULT_LIMIT, BROWSER_WAIT_EVENTS, BrowserError, BrowserTransition, createBrowserReading, describeBrowserRefusal, filterBrowserOutline, normalizeBrowserName, parseBrowserReference, renderBrowserElement, renderBrowserOutline, validateBrowserTimeout } from "../core/index.js";
 import { Emitter } from "@orkestrel/emitter";
 //#region src/browser/constants.ts
 /**
@@ -204,7 +204,7 @@ function isBrowserDocument(value) {
 * @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
+* @throws Thrown as a `BrowserError` when the serialized capture is longer than
 * `BROWSER_RESULT_LIMIT` characters, with `length` and `limit` in its context.
 */
 function readBrowserCapture(node) {
@@ -448,7 +448,7 @@ function readBrowserCapture(node) {
 	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", {
+	if (length > BROWSER_RESULT_LIMIT) throw new BrowserError("RESULT_LIMIT", "Document capture exceeds BROWSER_RESULT_LIMIT", {
 		length,
 		limit: BROWSER_RESULT_LIMIT
 	});
@@ -1021,7 +1021,7 @@ function readBrowserStates(element, role) {
 * prototype setter and dispatch `input` and `change`, and `fill` refuses `UNKNOWN` an element
 * that is not a text control and a read-only one; `submit` runs `form.requestSubmit()` and
 * observes the outcome through a `submit` listener registered across the call. Each action
-* refuses with a `BrowserElementError` naming the reason: `DISABLED` for a disabled control,
+* refuses with a `BrowserError` naming the reason: `DISABLED` for a disabled control,
 * `HIDDEN` for an element that does not render, and `UNTRUSTED` for what an untrusted event
 * cannot do, which is a click or submission that opens another browsing context, a click that
 * opens a file chooser, and typing into a contenteditable element. A click that activates a
@@ -1033,12 +1033,6 @@ function readBrowserStates(element, role) {
 * capture, and a dropped reference keeps its last capture. Every action on an element removed
 * from its document, collected, or held across a navigation reports `GONE`.
 *
-* @example
-* ```ts
-* const view = createBrowserDOMView({ document: frame.contentDocument })
-* await view.elements.outline()
-* await view.elements.element('e1')?.click()
-* ```
 */
 var BrowserDOMElement = class {
 	#input;
@@ -1059,7 +1053,10 @@ var BrowserDOMElement = class {
 		const label = node instanceof view.HTMLLabelElement ? node : node.closest("label");
 		const control = label !== null && matchesBrowserActivation(node, label) ? label.control : null;
 		if (control !== null && control !== node) {
-			if (control.matches(":disabled")) throw new BrowserElementError(this.reference, "DISABLED", "labels a disabled control");
+			if (control.matches(":disabled")) throw new BrowserError("ELEMENT", describeBrowserRefusal({ subject: `Element ${renderBrowserElement(this)}` }, "DISABLED", "labels a disabled control"), {
+				reference: this.reference,
+				reason: "DISABLED"
+			});
 			this.#refuse(control);
 		}
 		this.#refuse(node);
@@ -1075,12 +1072,21 @@ var BrowserDOMElement = class {
 	}
 	async fill(value, options) {
 		const [node, view] = this.#actionable(options);
-		if (node instanceof view.HTMLElement && node.isContentEditable) throw new BrowserElementError(this.reference, "UNTRUSTED", "is contenteditable, which an untrusted event cannot type into");
+		if (node instanceof view.HTMLElement && node.isContentEditable) throw new BrowserError("ELEMENT", describeBrowserRefusal({ subject: `Element ${renderBrowserElement(this)}` }, "UNTRUSTED", "is contenteditable, which an untrusted event cannot type into"), {
+			reference: this.reference,
+			reason: "UNTRUSTED"
+		});
 		const input = node instanceof view.HTMLInputElement ? node : void 0;
 		const control = input ?? (node instanceof view.HTMLTextAreaElement ? node : void 0);
 		const setter = Reflect.getOwnPropertyDescriptor(input === void 0 ? view.HTMLTextAreaElement.prototype : view.HTMLInputElement.prototype, "value")?.set;
-		if (control === void 0 || input !== void 0 && !BROWSER_TYPED_INPUTS.has(input.type)) throw new BrowserElementError(this.reference, "UNKNOWN", "is not a text control");
-		if (control.readOnly || setter === void 0) throw new BrowserElementError(this.reference, "UNKNOWN", "is not editable");
+		if (control === void 0 || input !== void 0 && !BROWSER_TYPED_INPUTS.has(input.type)) throw new BrowserError("ELEMENT", describeBrowserRefusal({ subject: `Element ${renderBrowserElement(this)}` }, "UNKNOWN", "is not a text control"), {
+			reference: this.reference,
+			reason: "UNKNOWN"
+		});
+		if (control.readOnly || setter === void 0) throw new BrowserError("ELEMENT", describeBrowserRefusal({ subject: `Element ${renderBrowserElement(this)}` }, "UNKNOWN", "is not editable"), {
+			reference: this.reference,
+			reason: "UNKNOWN"
+		});
 		control.focus();
 		Reflect.apply(setter, control, [value]);
 		control.dispatchEvent(new view.InputEvent("input", {
@@ -1093,10 +1099,16 @@ var BrowserDOMElement = class {
 	}
 	async select(values, options) {
 		const [node, view] = this.#actionable(options);
-		if (!(node instanceof view.HTMLSelectElement)) throw new BrowserElementError(this.reference, "UNKNOWN", "is not a select control");
+		if (!(node instanceof view.HTMLSelectElement)) throw new BrowserError("ELEMENT", describeBrowserRefusal({ subject: `Element ${renderBrowserElement(this)}` }, "UNKNOWN", "is not a select control"), {
+			reference: this.reference,
+			reason: "UNKNOWN"
+		});
 		const choices = Array.from(node.options);
 		const selected = values.map((value) => choices.find((option) => option.value === value) ?? choices.find((option) => option.label === value));
-		if (values.find((_value, index) => selected[index] === void 0) !== void 0) throw new BrowserElementError(this.reference, "UNKNOWN", "has no such option");
+		if (values.find((_value, index) => selected[index] === void 0) !== void 0) throw new BrowserError("ELEMENT", describeBrowserRefusal({ subject: `Element ${renderBrowserElement(this)}` }, "UNKNOWN", "has no such option"), {
+			reference: this.reference,
+			reason: "UNKNOWN"
+		});
 		for (const option of choices) option.selected = selected.includes(option);
 		node.dispatchEvent(new view.Event("input", {
 			bubbles: true,
@@ -1118,11 +1130,20 @@ var BrowserDOMElement = class {
 	async submit(options) {
 		const [node, view] = this.#current(options);
 		const owner = node instanceof view.HTMLFormElement ? node : Reflect.get(node, "form");
-		if (!(owner instanceof view.HTMLFormElement)) throw new BrowserElementError(this.reference, "UNKNOWN", "is not in a form");
+		if (!(owner instanceof view.HTMLFormElement)) throw new BrowserError("ELEMENT", describeBrowserRefusal({ subject: `Element ${renderBrowserElement(this)}` }, "UNKNOWN", "is not in a form"), {
+			reference: this.reference,
+			reason: "UNKNOWN"
+		});
 		const type = Reflect.get(node, "type");
 		const submitter = node instanceof view.HTMLButtonElement && type === "submit" || node instanceof view.HTMLInputElement && (type === "submit" || type === "image") ? node : void 0;
-		if (submitter?.matches(":disabled") === true) throw new BrowserElementError(this.reference, "DISABLED");
-		if (matchesBrowserPopup(submitter ?? owner)) throw new BrowserElementError(this.reference, "UNTRUSTED", "submits into another browsing context, which an untrusted submission cannot open");
+		if (submitter?.matches(":disabled") === true) throw new BrowserError("ELEMENT", describeBrowserRefusal({ subject: `Element ${renderBrowserElement(this)}` }, "DISABLED"), {
+			reference: this.reference,
+			reason: "DISABLED"
+		});
+		if (matchesBrowserPopup(submitter ?? owner)) throw new BrowserError("ELEMENT", describeBrowserRefusal({ subject: `Element ${renderBrowserElement(this)}` }, "UNTRUSTED", "submits into another browsing context, which an untrusted submission cannot open"), {
+			reference: this.reference,
+			reason: "UNTRUSTED"
+		});
 		let submitted = false;
 		const release = new AbortController();
 		owner.addEventListener("submit", () => {
@@ -1135,11 +1156,11 @@ var BrowserDOMElement = class {
 		}
 		if (submitted) return;
 		const invalid = Array.from(owner.elements).find((control) => control.localName !== "fieldset" && control.matches(":invalid"));
-		if (invalid === void 0) throw new BrowserError("did not submit", "BROWSER_DOCUMENT_SUBMIT", { reference: this.reference });
+		if (invalid === void 0) throw new BrowserError("DOCUMENT_SUBMIT", "did not submit", { reference: this.reference });
 		const field = computeBrowserName(invalid) || (invalid.getAttribute("name") ?? invalid.localName);
 		const reason = Reflect.get(invalid, "validationMessage");
 		const message = isString(reason) ? reason : "";
-		throw new BrowserError(`did not submit: ${field} — ${message}`, "BROWSER_DOCUMENT_SUBMIT", {
+		throw new BrowserError("DOCUMENT_SUBMIT", `did not submit: ${field} — ${message}`, {
 			reference: this.reference,
 			field,
 			message
@@ -1149,19 +1170,34 @@ var BrowserDOMElement = class {
 		options?.signal?.throwIfAborted();
 		const node = this.#input.node.deref();
 		const view = node?.ownerDocument.defaultView ?? null;
-		if (!this.#input.current() || node === void 0 || !node.isConnected || view === null) throw new BrowserElementError(this.reference, "GONE");
+		if (!this.#input.current() || node === void 0 || !node.isConnected || view === null) throw new BrowserError("ELEMENT", describeBrowserRefusal({ subject: `Element ${renderBrowserElement(this)}` }, "GONE"), {
+			reference: this.reference,
+			reason: "GONE"
+		});
 		return [node, view];
 	}
 	#actionable(options) {
 		const current = this.#current(options);
 		const [node] = current;
-		if (!node.checkVisibility()) throw new BrowserElementError(this.reference, "HIDDEN");
-		if (node.matches(":disabled")) throw new BrowserElementError(this.reference, "DISABLED");
+		if (!node.checkVisibility()) throw new BrowserError("ELEMENT", describeBrowserRefusal({ subject: `Element ${renderBrowserElement(this)}` }, "HIDDEN"), {
+			reference: this.reference,
+			reason: "HIDDEN"
+		});
+		if (node.matches(":disabled")) throw new BrowserError("ELEMENT", describeBrowserRefusal({ subject: `Element ${renderBrowserElement(this)}` }, "DISABLED"), {
+			reference: this.reference,
+			reason: "DISABLED"
+		});
 		return current;
 	}
 	#refuse(target) {
-		if (matchesBrowserPopup(target)) throw new BrowserElementError(this.reference, "UNTRUSTED", "opens another browsing context, which an untrusted click cannot do");
-		if (target.localName === "input" && Reflect.get(target, "type") === "file") throw new BrowserElementError(this.reference, "UNTRUSTED", "opens a file chooser, which an untrusted click cannot do");
+		if (matchesBrowserPopup(target)) throw new BrowserError("ELEMENT", describeBrowserRefusal({ subject: `Element ${renderBrowserElement(this)}` }, "UNTRUSTED", "opens another browsing context, which an untrusted click cannot do"), {
+			reference: this.reference,
+			reason: "UNTRUSTED"
+		});
+		if (target.localName === "input" && Reflect.get(target, "type") === "file") throw new BrowserError("ELEMENT", describeBrowserRefusal({ subject: `Element ${renderBrowserElement(this)}` }, "UNTRUSTED", "opens a file chooser, which an untrusted click cannot do"), {
+			reference: this.reference,
+			reason: "UNTRUSTED"
+		});
 	}
 };
 //#endregion
@@ -1179,7 +1215,7 @@ var BrowserDOMElement = class {
 * 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
-* `BROWSER_WAIT_TIMEOUT`, on a `pagehide` in the first root's window with `GONE`, or with whatever
+* `TIMEOUT`, on a `pagehide` in the first root's window with `GONE`, or with whatever
 * the check or the roots function throws. A signal that aborts while `check` or `roots` runs
 * settles the wait with its reason, and wins over a value that same check returns. Settlement
 * disconnects every observer and removes every listener synchronously, so a mutation queued
@@ -1300,10 +1336,16 @@ var BrowserDOMWait = class {
 		return this.#wait.start + this.#wait.timeout - (now === void 0 ? performance.now() : now());
 	}
 	#expire() {
-		this.#fail(new BrowserError(`${this.#wait.subject} timed out`, "BROWSER_WAIT_TIMEOUT", { timeout: this.#wait.timeout }));
+		this.#fail(new BrowserError("TIMEOUT", `${this.#wait.subject} timed out`, {
+			operation: "wait",
+			timeout: this.#wait.timeout
+		}));
 	}
 	#unload() {
-		this.#fail(new BrowserElementError({ subject: "document" }, "GONE"));
+		this.#fail(new BrowserError("ELEMENT", describeBrowserRefusal({ subject: "document" }, "GONE"), {
+			subject: "document",
+			reason: "GONE"
+		}));
 	}
 	#succeed(value) {
 		this.#stop();
@@ -1358,12 +1400,6 @@ var BrowserDOMWait = class {
 * at the next observed mutation or `load`, so a match inserted there with no other observed
 * change is not seen before the deadline.
 *
-* @example
-* ```ts
-* const view = createBrowserDOMView({ document: frame.contentDocument })
-* const outline = await view.elements.outline()
-* const [save] = await view.elements.find({ role: 'button', name: 'save' })
-* ```
 */
 var BrowserDOMElementManager = class {
 	#input;
@@ -1373,17 +1409,23 @@ var BrowserDOMElementManager = class {
 	#epochs = /* @__PURE__ */ new WeakMap();
 	#watched = /* @__PURE__ */ new WeakSet();
 	#count = 0;
+	#positions = /* @__PURE__ */ new WeakMap();
 	constructor(input) {
 		this.#input = input;
 	}
 	async outline(options) {
 		this.#input.signal.throwIfAborted();
 		const limit = options?.limit ?? BROWSER_OUTLINE_LIMIT;
-		if (!isInteger(limit) || limit < 0) throw new BrowserError("Outline limit must be a nonnegative integer", void 0, { limit });
+		if (!isInteger(limit) || limit < 0) throw new BrowserError("ARGUMENT", "Outline limit must be a nonnegative integer", { limit });
 		options?.signal?.throwIfAborted();
 		const document = this.#input.document();
+		const epoch = this.#epoch(new WeakRef(document));
 		const rows = this.#capture(this.#root(document, options?.within), options?.within);
-		return renderBrowserOutline(document.URL, document.title, rows, limit, options?.search);
+		if (document !== this.#input.document() || epoch !== this.#epoch(new WeakRef(document))) throw new BrowserError("ELEMENT", describeBrowserRefusal({ subject: "outline" }, "GONE"), {
+			subject: "outline",
+			reason: "GONE"
+		});
+		return renderBrowserOutline(document.URL, document.title, rows, limit, options?.secrets);
 	}
 	async find(query, options) {
 		this.#input.signal.throwIfAborted();
@@ -1428,7 +1470,7 @@ var BrowserDOMElementManager = class {
 		const css = query.css;
 		if (css === void 0) return matches;
 		const selected = attempt(() => Array.from(root.querySelectorAll(css)));
-		if (!selected.success) throw new BrowserError(`CSS query is invalid: ${css}`, "BROWSER_ELEMENT_QUERY", { css });
+		if (!selected.success) throw new BrowserError("ELEMENT_QUERY", `CSS query is invalid: ${css}`, { css });
 		const bound = selected.value.map((element) => {
 			const role = computeBrowserRole(element) ?? "generic";
 			return this.#bind(element, role, computeBrowserName(element, role));
@@ -1438,13 +1480,17 @@ var BrowserDOMElementManager = class {
 	}
 	#capture(root, within) {
 		const rows = [];
+		this.#positions = /* @__PURE__ */ new WeakMap();
 		if (within === void 0 || !matchesBrowserOmitted(root)) this.#walk(root, rows, false);
 		return rows;
 	}
 	#root(document, within) {
 		if (within === void 0) return document.documentElement;
 		const node = this.#records.get(parseBrowserReference(within) ?? "")?.node.deref();
-		if (node === void 0 || !node.isConnected || node.ownerDocument.defaultView === null) throw new BrowserElementError(within, "GONE");
+		if (node === void 0 || !node.isConnected || node.ownerDocument.defaultView === null) throw new BrowserError("ELEMENT", describeBrowserRefusal(within, "GONE"), {
+			reference: within,
+			reason: "GONE"
+		});
 		return node;
 	}
 	#roots(within) {
@@ -1471,7 +1517,7 @@ var BrowserDOMElementManager = class {
 				if (!quiet && (!blank || text !== "") && (parent === null || !matchesBrowserInvisible(parent))) {
 					const container = readBrowserBlock(parent, root);
 					if (!blank) {
-						if (block !== void 0 && block !== container) text = this.#flush(rows, text);
+						if (block !== void 0 && block !== container) text = this.#flush(rows, text, block);
 						text += data;
 						block = container;
 					} else if (container === block) text += data;
@@ -1486,7 +1532,7 @@ var BrowserDOMElementManager = class {
 				continue;
 			}
 			if (node instanceof view.HTMLIFrameElement) {
-				text = this.#flush(rows, text);
+				text = this.#flush(rows, text, block);
 				const child = node.contentDocument;
 				if (invisible) {
 					node = skipBrowserSubtree(walker);
@@ -1498,7 +1544,7 @@ var BrowserDOMElementManager = class {
 				continue;
 			}
 			if (node instanceof view.HTMLSlotElement) {
-				text = this.#flush(rows, text);
+				text = this.#flush(rows, text, block);
 				for (const assigned of node.assignedNodes({ flatten: true })) if (assigned instanceof view.Element) this.#walk(assigned, rows, quiet);
 				else if (!quiet) this.#flush(rows, assigned.textContent ?? "");
 				node = skipBrowserSubtree(walker);
@@ -1506,10 +1552,28 @@ var BrowserDOMElementManager = class {
 			}
 			const tool = node.localName === "form" ? node.getAttribute("toolname") ?? "" : "";
 			const role = tool === "" ? computeBrowserRole(node) : "form";
-			if (!invisible && role !== void 0 && (BROWSER_INTERACTIVE_ROLES.has(role) || role === "heading" || tool !== "")) {
-				text = this.#flush(rows, text);
-				rows.push(this.#row(node, role, view, String(rows.length)));
-				if (silenced === void 0 && BROWSER_CONTENT_NAMED_ROLES.has(role)) silenced = node;
+			if (!invisible && role !== void 0 && (BROWSER_INTERACTIVE_ROLES.has(role) || [
+				"heading",
+				"image",
+				"img",
+				"listitem",
+				"row",
+				"cell",
+				"gridcell",
+				"columnheader",
+				"rowheader"
+			].includes(role) || tool !== "")) {
+				text = this.#flush(rows, text, block);
+				const row = this.#row(node, role, view, String(rows.length));
+				rows.push(row);
+				this.#positions.set(node, row.id);
+				if (silenced === void 0 && BROWSER_CONTENT_NAMED_ROLES.has(role) && ![
+					"row",
+					"cell",
+					"gridcell",
+					"columnheader",
+					"rowheader"
+				].includes(role)) silenced = node;
 				if (node.localName === "textarea") {
 					node = skipBrowserSubtree(walker);
 					continue;
@@ -1517,14 +1581,14 @@ var BrowserDOMElementManager = class {
 			}
 			const shadow = node.shadowRoot;
 			if (shadow !== null) {
-				text = this.#flush(rows, text);
+				text = this.#flush(rows, text, block);
 				this.#walk(shadow, rows, muted || silenced !== void 0);
 				node = skipBrowserSubtree(walker);
 				continue;
 			}
 			node = walker.nextNode();
 		}
-		this.#flush(rows, text);
+		this.#flush(rows, text, block);
 	}
 	#watch(document) {
 		const view = document.defaultView;
@@ -1546,14 +1610,14 @@ var BrowserDOMElementManager = class {
 		const target = document.deref();
 		return target === void 0 ? -1 : this.#input.navigation() + (this.#epochs.get(target) ?? 0);
 	}
-	#flush(rows, text) {
-		if (normalizeBrowserName(text) !== "") this.#text(rows, text);
+	#flush(rows, text, parent) {
+		if (normalizeBrowserName(text) !== "") this.#text(rows, text, parent);
 		return "";
 	}
-	#text(rows, text) {
+	#text(rows, text, parent) {
 		rows.push({
 			id: String(rows.length),
-			parent: void 0,
+			parent: parent === void 0 ? void 0 : this.#parent(parent),
 			children: [],
 			backend: void 0,
 			frame: void 0,
@@ -1570,7 +1634,7 @@ var BrowserDOMElementManager = class {
 	#row(element, role, view, id) {
 		const name = computeBrowserName(element, role);
 		const tool = element.localName === "form" ? element.getAttribute("toolname") : null;
-		const reference = role === "heading" ? void 0 : this.#bind(element, role, name).reference;
+		const reference = BROWSER_INTERACTIVE_ROLES.has(role) || tool !== null ? this.#bind(element, role, name).reference : void 0;
 		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();
@@ -1578,10 +1642,11 @@ var BrowserDOMElementManager = class {
 		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;
+		else if (input?.type === "password") value = "•".repeat(input.value.length);
 		else if (input !== void 0 && input.type !== "password" && (BROWSER_TYPED_INPUTS.has(input.type) || input.type === "range")) value = input.value;
 		return {
 			id: reference ?? id,
-			parent: void 0,
+			parent: this.#parent(element.parentNode),
 			children: [],
 			backend: void 0,
 			frame: void 0,
@@ -1591,6 +1656,9 @@ var BrowserDOMElementManager = class {
 			description: void 0,
 			value,
 			properties: {
+				level: role === "heading" ? Number(element.getAttribute("aria-level") ?? element.localName.slice(1)) : void 0,
+				url: element instanceof view.HTMLAnchorElement ? element.href : void 0,
+				password: input?.type === "password",
 				checked,
 				disabled: element.matches(":disabled"),
 				focused,
@@ -1601,6 +1669,13 @@ var BrowserDOMElementManager = class {
 			reference
 		};
 	}
+	#parent(node) {
+		while (node !== null) {
+			const id = this.#positions.get(node);
+			if (id !== void 0) return id;
+			node = node.parentNode;
+		}
+	}
 	#bind(element, role, name) {
 		const known = this.#identities.get(element);
 		const existing = known === void 0 ? void 0 : this.#records.get(known);
@@ -1654,7 +1729,7 @@ var BrowserDOMElementManager = class {
 * fires none of those events, so a reading there stays current across it. A cross-document
 * navigation also clears every element reference. `destroy()` releases the listeners and every
 * reference, and fails every pending wait with a `BrowserError` coded
-* `BROWSER_DOCUMENT_DESTROYED`; after it, `title()`, `read()`, `wait()`, and the element manager's
+* `DOCUMENT_DESTROYED`; after it, `title()`, `read()`, `wait()`, and the element manager's
 * `outline()`, `find()`, and `wait()` reject with that error, and a second `destroy()` does
 * nothing more. `trusted` is `false`: no action grants user activation, and
 * every event the view's actions dispatch themselves carries `isTrusted` `false`. The `submit`
@@ -1678,8 +1753,8 @@ var BrowserDOMView = class {
 	#listeners = new AbortController();
 	constructor(options) {
 		const document = options.document;
-		if (!isBrowserDocument(document) || document.defaultView === null) throw new BrowserError("Browser DOM view requires a document attached to a window", "BROWSER_DOCUMENT");
-		if (document === globalThis.document && options.own !== true) throw new BrowserError("Browser DOM view drives globalThis.document only with own: true, because an action that navigates the realm it runs in cannot return", "BROWSER_DOCUMENT_OWN");
+		if (!isBrowserDocument(document) || document.defaultView === null) throw new BrowserError("DOCUMENT", "Browser DOM view requires a document attached to a window");
+		if (document === globalThis.document && options.own !== true) throw new BrowserError("DOCUMENT_OWN", "Browser DOM view drives globalThis.document only with own: true, because an action that navigates the realm it runs in cannot return");
 		this.#window = document.defaultView;
 		this.#document = document;
 		this.#elements = new BrowserDOMElementManager({
@@ -1727,7 +1802,7 @@ var BrowserDOMView = class {
 		}).execute();
 	}
 	destroy() {
-		this.#release.abort(new BrowserError("Browser DOM view was destroyed", "BROWSER_DOCUMENT_DESTROYED"));
+		this.#release.abort(new BrowserError("DOCUMENT_DESTROYED", "Browser DOM view was destroyed"));
 		this.#listeners.abort();
 		this.#elements.clear();
 	}
@@ -1763,7 +1838,7 @@ var BrowserDOMView = class {
 * Provides a raw CDP text transport over the browser's native `WebSocket`.
 *
 * @remarks
-* `start()` resolves on the socket's `open` event and rejects with a `BrowserConnectionError`
+* `start()` resolves on the socket's `open` event and rejects with a `BrowserError`
 * carrying `url` for a URL whose scheme is not `ws:` or `wss:`, for a URL the `WebSocket`
 * constructor refuses (one with a fragment), for a socket that fails or closes before it opens,
 * and at the `timeout` deadline. Concurrent and repeated `start()` and `close()`
@@ -1810,7 +1885,7 @@ var SocketCDPTransport = class {
 	}
 	async send(data) {
 		const socket = this.#socket;
-		if (socket === void 0 || socket.readyState !== WebSocket.OPEN) throw new BrowserConnectionError("Socket CDP transport is not open", { url: this.#url });
+		if (socket === void 0 || socket.readyState !== WebSocket.OPEN) throw new BrowserError("CONNECTION", "Socket CDP transport is not open", { url: this.#url });
 		socket.send(data);
 	}
 	async close() {
@@ -1818,15 +1893,15 @@ var SocketCDPTransport = class {
 	}
 	async #start() {
 		const parsed = attempt(() => new URL(this.#url));
-		if (!parsed.success) throw new BrowserConnectionError(`Socket CDP URL is invalid: ${this.#url}`, {
+		if (!parsed.success) throw new BrowserError("CONNECTION", `Socket CDP URL is invalid: ${this.#url}`, {
 			url: this.#url,
-			error: parsed.error
+			error: isJSONValue(parsed.error) ? parsed.error : String(parsed.error)
 		});
-		if (parsed.value.protocol !== "ws:" && parsed.value.protocol !== "wss:") throw new BrowserConnectionError(`Socket CDP connection requires a ws: or wss: URL: ${this.#url}`, { url: this.#url });
+		if (parsed.value.protocol !== "ws:" && parsed.value.protocol !== "wss:") throw new BrowserError("CONNECTION", `Socket CDP connection requires a ws: or wss: URL: ${this.#url}`, { url: this.#url });
 		const created = attempt(() => new WebSocket(this.#url));
-		if (!created.success) throw new BrowserConnectionError(`Socket CDP connection to ${this.#url} could not open`, {
+		if (!created.success) throw new BrowserError("CONNECTION", `Socket CDP connection to ${this.#url} could not open`, {
 			url: this.#url,
-			error: created.error
+			error: isJSONValue(created.error) ? created.error : String(created.error)
 		});
 		const socket = created.value;
 		this.#socket = socket;
@@ -1883,7 +1958,7 @@ var SocketCDPTransport = class {
 		});
 	}
 	#refuse(reason) {
-		return new BrowserConnectionError(`Socket CDP connection to ${this.#url} ${reason}`, { url: this.#url });
+		return new BrowserError("CONNECTION", `Socket CDP connection to ${this.#url} ${reason}`, { url: this.#url });
 	}
 };
 //#endregion
@@ -1894,8 +1969,8 @@ var SocketCDPTransport = class {
 * @param options - The driven document, and `own` to admit the realm's own document
 * @returns A {@link BrowserDOMViewInterface} over the document's window
 * @throws Thrown when `document` is not a document attached to a window, with the code
-* `BROWSER_DOCUMENT`, and when it is `globalThis.document` without `own: true`, with the code
-* `BROWSER_DOCUMENT_OWN`.
+* `DOCUMENT`, and when it is `globalThis.document` without `own: true`, with the code
+* `DOCUMENT_OWN`.
 *
 * @example
 * ```ts
@@ -1909,55 +1984,6 @@ function createBrowserDOMView(options) {
 	return new BrowserDOMView(options);
 }
 /**
-* Creates a `BrowserToolsetInterface` that publishes the five view tools over a DOM document and
-* adopts a source's page tools beside them.
-*
-* @remarks
-* The toolset runs over a view {@link createBrowserDOMView} creates for `document`, so it
-* 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()`
-* removes the toolset's tools, then destroys the view, which releases its listeners and fails
-* its pending waits, and a construction that throws destroys the view before it rethrows.
-* `journeys` adds `record`, `save`, `journeys`, `edit`, and `replay` at construction; a replay
-* runs the steps the document placement executes.
-*
-* @param options - The driven document, `own`, the page-tool source, the manager, the bound, the
-* journey stores, and the emitter hooks
-* @returns A {@link BrowserToolsetInterface} whose `view` drives the document
-* @throws Thrown when `document` is not a document attached to a window, with the code
-* `BROWSER_DOCUMENT`, when it is `globalThis.document` without `own: true`, with the code
-* `BROWSER_DOCUMENT_OWN`, and when `limit` is not a positive integer.
-*
-* @example
-* ```ts
-* const toolset = createDocumentToolset({ document: frame.contentDocument, source: bridge })
-* await toolset.start()
-* await toolset.tools.execute({ id: '1', name: 'look', arguments: { search: 'form' } })
-* ```
-*/
-function createDocumentToolset(options) {
-	const view = createBrowserDOMView({
-		document: options.document,
-		...options.own === void 0 ? {} : { own: options.own }
-	});
-	try {
-		return new BrowserToolset(view, {
-			...options.on === void 0 ? {} : { on: options.on },
-			...options.error === void 0 ? {} : { error: options.error },
-			...options.tools === void 0 ? {} : { tools: options.tools },
-			...options.source === void 0 ? {} : { source: options.source },
-			...options.limit === void 0 ? {} : { limit: options.limit },
-			...options.journeys === void 0 ? {} : { journeys: options.journeys },
-			release: view.destroy.bind(view)
-		});
-	} catch (error) {
-		view.destroy();
-		throw error;
-	}
-}
-/**
 * Creates a CDP transport over the browser's native `WebSocket`.
 *
 * @param options - The CDP WebSocket debugger URL, the opening deadline, and emitter hooks
@@ -1975,6 +2001,6 @@ function createSocketCDPTransport(options) {
 	return new SocketCDPTransport(options);
 }
 //#endregion
-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 };
+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, BrowserDOMView, BrowserDOMWait, SocketCDPTransport, collectBrowserRoots, computeBrowserAlternative, computeBrowserName, computeBrowserRole, computeBrowserText, createBrowserDOMView, createSocketCDPTransport, isBrowserDocument, listenBrowserNavigation, matchesBrowserActivation, matchesBrowserBlock, matchesBrowserHidden, matchesBrowserInvisible, matchesBrowserOmitted, matchesBrowserPopup, readBrowserBlock, readBrowserCapture, readBrowserContent, readBrowserParent, readBrowserStates, readBrowserToken, skipBrowserSubtree };
 
 //# sourceMappingURL=index.js.map