@orkestrel/browser 0.0.29 → 0.0.31

package/dist/src/browser/index.js

@@ -1,7 +1,7 @@
 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 { BROWSER_DEFAULT_TIMEOUT_MS, BROWSER_INTERACTIVE_ROLES, BROWSER_OUTLINE_LIMIT, BROWSER_REFERENCE_PREFIX, BROWSER_RESULT_LIMIT, BROWSER_WAIT_EVENTS, BrowserError, BrowserTransition, createBrowserContent, describeBrowserRefusal, filterBrowserOutline, normalizeBrowserName, parseBrowserReference, renderBrowserElement, renderBrowserOutline, validateBrowserTimeout } from "../core/index.js";
 import { Emitter } from "@orkestrel/emitter";
-//#region src/browser/constants.ts
+// src/browser/constants.ts
 /**
 * Sets the default `wait` deadline for DOM waits in a browser document toolset, `5_000`
 * milliseconds.
@@ -180,8 +180,87 @@ var BROWSER_TYPED_INPUTS = Object.freeze(/* @__PURE__ */ new Set([
 * `controls`, `input` other than `hidden`, `label`, `select`, and `textarea`.
 */
 var BROWSER_INTERACTIVE_CONTENT = "a[href], audio[controls], button, details, embed, iframe, img[usemap], img[controls], input:not([type=\"hidden\" i]), label, select, textarea, video[controls]";
-//#endregion
-//#region src/browser/helpers.ts
+// src/browser/BrowserAncestors.ts
+/** Traverses ancestors lazily while retaining the previously yielded node. */
+var BrowserAncestors = class extends Iterator {
+	#parent;
+	#current;
+	#previous;
+	#started = false;
+	constructor(node, parent) {
+		super();
+		this.#current = node;
+		this.#previous = node;
+		this.#parent = parent;
+	}
+	next() {
+		if (this.#started && this.#current !== null) {
+			this.#previous = this.#current;
+			this.#current = this.#parent(this.#current);
+		}
+		this.#started = true;
+		return this.#current === null ? {
+			done: true,
+			value: void 0
+		} : {
+			done: false,
+			value: this.#current
+		};
+	}
+	get previous() {
+		return this.#previous;
+	}
+};
+// src/browser/BrowserCaptureSiblings.ts
+/** Traverses paired live and inert siblings while preserving pointers across pruning. */
+var BrowserCaptureSiblings = class extends Iterator {
+	#element;
+	#counterpart;
+	#child;
+	#mirror;
+	#previous;
+	constructor(live, twin) {
+		super();
+		this.#element = live.lastElementChild;
+		this.#counterpart = twin.lastElementChild;
+		this.#child = live.lastChild;
+		this.#mirror = twin.lastChild;
+	}
+	next() {
+		if (this.#previous !== void 0) {
+			if (this.#child?.nodeType === 1) {
+				this.#element = this.#previous.element;
+				this.#counterpart = this.#previous.counterpart;
+			}
+			this.#child = this.#previous.child;
+			this.#mirror = this.#previous.mirror;
+		}
+		if (this.#child === null || this.#mirror === null) {
+			this.#previous = void 0;
+			this.#child = null;
+			return {
+				done: true,
+				value: void 0
+			};
+		}
+		this.#previous = {
+			child: this.#child.previousSibling,
+			mirror: this.#mirror.previousSibling,
+			element: this.#element?.previousElementSibling ?? null,
+			counterpart: this.#counterpart?.previousElementSibling ?? null
+		};
+		return {
+			done: false,
+			value: {
+				child: this.#child,
+				mirror: this.#mirror,
+				element: this.#element,
+				counterpart: this.#counterpart
+			}
+		};
+	}
+};
+// src/browser/helpers.ts
 /**
 * Narrows a value to a `Document` attached to a window.
 *
@@ -198,8 +277,8 @@ function isBrowserDocument(value) {
 * @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.
+* sequence. A reading a caller builds with `createBrowserContent` passes through no limit.
+* {@link BrowserContentInput} defines the inert capture, lowering, redaction, and limits.
 *
 * @param node - The root whose rendered markup is captured; its owner document supplies `URL`
 * and `title`
@@ -217,15 +296,19 @@ function readBrowserCapture(node) {
 	const view = document.defaultView;
 	const rendered = view !== null && node.isConnected;
 	const inert = document.implementation.createHTMLDocument("");
-	let root = inert.importNode(node, true);
+	const root = inert.importNode(node, true);
+	const output = inert.createDocumentFragment();
+	output.append(root);
 	const pending = [{
 		live: node,
 		twin: root,
 		visited: false
 	}];
 	if (rendered) {
-		let child = node;
-		for (let parent = node; parent?.ownerDocument === document; parent = readBrowserParent(parent)) {
+		const ancestors = new BrowserAncestors(node, readBrowserParent);
+		for (const parent of ancestors) {
+			if (parent.ownerDocument !== document) break;
+			const child = ancestors.previous ?? node;
 			const style = view.getComputedStyle(parent);
 			const outside = parent !== node && (style.contentVisibility === "hidden" || [
 				"canvas",
@@ -249,11 +332,10 @@ function readBrowserCapture(node) {
 			].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;
+				root.remove();
 				pending.length = 0;
 				break;
 			}
-			child = parent;
 		}
 	}
 	while (pending.length > 0) {
@@ -279,14 +361,12 @@ function readBrowserCapture(node) {
 			"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) {
@@ -313,35 +393,13 @@ function readBrowserCapture(node) {
 			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;
+			for (const { child, mirror, element, counterpart } of new BrowserCaptureSiblings(live, twin)) if (readBrowserCaptureOmission(live, child, view, rendered, rendered && (summary !== void 0 && child !== summary || conditional && child !== branch)) || 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
+				});
 			}
 			continue;
 		}
@@ -354,82 +412,10 @@ function readBrowserCapture(node) {
 			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 value = readBrowserCaptureValue(live, twin, view, inert, invisible, tag);
+		if (value === void 0) continue;
+		const { fragments, container } = value;
+		const lines = invisible && !container && tag !== "svg" ? [] : value.lines;
 		const block = !style?.display.startsWith("inline") && style?.display !== "contents";
 		const carrier = inert.createElement(block ? "div" : "span");
 		if (container) carrier.append(...twin.childNodes);
@@ -443,10 +429,9 @@ function readBrowserCapture(node) {
 			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 ?? "";
+	for (const input of output.firstElementChild?.querySelectorAll("input[type=\"password\" i],input[type=\"hidden\" i]") ?? []) input.remove();
+	capture.html = output.firstElementChild?.outerHTML ?? "";
 	const length = JSON.stringify(capture).length;
 	if (length > BROWSER_RESULT_LIMIT) throw new BrowserError("RESULT_LIMIT", "Document capture exceeds BROWSER_RESULT_LIMIT", {
 		length,
@@ -605,16 +590,17 @@ function computeBrowserText(root, context) {
 function readBrowserContent(root, context) {
 	const view = root.ownerDocument?.defaultView ?? null;
 	const shadow = view !== null && root instanceof view.Element ? root.shadowRoot : null;
-	const children = shadow !== null ? Array.from(shadow.childNodes) : view !== null && root instanceof view.HTMLSlotElement ? root.assignedNodes({ flatten: true }) : Array.from(root.childNodes);
-	let text = "";
-	let previous = false;
-	for (const child of children) {
+	return (shadow !== null ? Array.from(shadow.childNodes) : view !== null && root instanceof view.HTMLSlotElement ? root.assignedNodes({ flatten: true }) : Array.from(root.childNodes)).reduce((state, child) => {
 		const piece = computeBrowserAlternative(child, context);
 		const block = view !== null && child instanceof view.Element && matchesBrowserBlock(child);
-		if (piece !== "") text += text !== "" && (block || previous) ? ` ${piece}` : piece;
-		previous = block;
-	}
-	return text;
+		return {
+			text: piece === "" ? state.text : state.text + (state.text !== "" && (block || state.previous) ? ` ${piece}` : piece),
+			previous: block
+		};
+	}, {
+		text: "",
+		previous: false
+	}).text;
 }
 /**
 * Computes the text one node contributes to an accessible name: its own text alternative, or its
@@ -734,7 +720,7 @@ function matchesBrowserInvisible(element) {
 * ```
 */
 function matchesBrowserOmitted(element) {
-	for (let current = element; current !== null; current = readBrowserParent(current)) if (matchesBrowserHidden(current)) return true;
+	for (const current of new BrowserAncestors(element, readBrowserParent)) if (matchesBrowserHidden(current)) return true;
 	return false;
 }
 /**
@@ -793,7 +779,9 @@ function matchesBrowserBlock(element) {
 function collectBrowserRoots(root) {
 	const roots = [root.getRootNode()];
 	const queue = [root];
-	for (let current = queue.shift(); current !== void 0; current = queue.shift()) {
+	while (queue.length > 0) {
+		const current = queue.shift();
+		if (current === void 0) continue;
 		const view = (isBrowserDocument(current) ? current : current.ownerDocument)?.defaultView ?? null;
 		const own = view !== null && current instanceof view.Element ? [current] : [];
 		for (const element of [...own, ...current.querySelectorAll("*")]) {
@@ -842,20 +830,15 @@ function matchesBrowserPopup(element) {
 	const type = Reflect.get(element, "type");
 	const submitter = tag === "button" && type === "submit" || tag === "input" && (type === "submit" || type === "image");
 	const form = tag === "form" ? element : Reflect.get(element, "form");
-	let target;
-	if ((tag === "a" || tag === "area") && element.hasAttribute("href")) target = element.getAttribute("target") ?? base;
-	else if (view !== null && form instanceof view.HTMLFormElement && (tag === "form" || submitter)) target = (submitter ? element.getAttribute("formtarget") : null) ?? form.getAttribute("target") ?? base;
+	const target = (tag === "a" || tag === "area") && element.hasAttribute("href") ? element.getAttribute("target") ?? base : view !== null && form instanceof view.HTMLFormElement && (tag === "form" || submitter) ? (submitter ? element.getAttribute("formtarget") : null) ?? form.getAttribute("target") ?? base : void 0;
 	if (target === void 0) return false;
 	const keyword = target.trim().toLowerCase();
 	if (BROWSER_CONTEXT_TARGETS.has(keyword)) return false;
 	if (keyword === "_blank") return true;
 	const selector = `iframe[name="${CSS.escape(target)}"], frame[name="${CSS.escape(target)}"]`;
-	let current = view;
-	while (current !== null) {
-		const frame = current;
+	for (const frame of new BrowserAncestors(view, (entry) => entry.parent === entry ? null : entry.parent)) {
 		const found = attempt(() => frame.name === target || frame.document.querySelector(selector) !== null);
 		if (found.success && found.value) return false;
-		current = frame.parent === frame ? null : frame.parent;
 	}
 	return true;
 }
@@ -881,7 +864,10 @@ function matchesBrowserPopup(element) {
 * ```
 */
 function matchesBrowserActivation(target, label) {
-	for (let current = target; current !== null && current !== label; current = current.parentElement) if (current.matches("a[href], audio[controls], button, details, embed, iframe, img[usemap], img[controls], input:not([type=\"hidden\" i]), label, select, textarea, video[controls]")) return false;
+	for (const current of new BrowserAncestors(target, (entry) => entry.parentElement)) {
+		if (current === label) break;
+		if (current.matches("a[href], audio[controls], button, details, embed, iframe, img[usemap], img[controls], input:not([type=\"hidden\" i]), label, select, textarea, video[controls]")) return false;
+	}
 	return true;
 }
 /**
@@ -898,12 +884,11 @@ function matchesBrowserActivation(target, label) {
 * ```
 */
 function skipBrowserSubtree(walker) {
-	let node = walker.nextSibling();
-	while (node === null) {
+	while (true) {
+		const node = walker.nextSibling();
+		if (node !== null) return node;
 		if (walker.parentNode() === null) return null;
-		node = walker.nextSibling();
 	}
-	return node;
 }
 /**
 * Reads the nearest block container of an element, the unit that separates runs of text.
@@ -923,10 +908,9 @@ function skipBrowserSubtree(walker) {
 * ```
 */
 function readBrowserBlock(element, root) {
-	let current = element;
-	while (current !== null && current !== root) {
+	for (const current of new BrowserAncestors(element, (entry) => entry.parentElement)) {
+		if (current === root) break;
 		if (matchesBrowserBlock(current)) return current;
-		current = current.parentElement;
 	}
 	return root;
 }
@@ -1011,8 +995,100 @@ function readBrowserStates(element, role) {
 	}
 	return states;
 }
-//#endregion
-//#region src/browser/elements/BrowserDOMElement.ts
+/** Derives rendered form values and SVG fragments for an inert capture. */
+function readBrowserCaptureValue(live, twin, view, inert, invisible, tag) {
+	if (live instanceof view.HTMLInputElement) {
+		if ([
+			"text",
+			"email",
+			"search",
+			"tel",
+			"url",
+			"number"
+		].includes(live.type)) {
+			if (live.type !== "number" || !live.validity.badInput) {
+				const placeholder = view.getComputedStyle(live, "::placeholder");
+				return { 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)) return { lines: [live.value] };
+		else if (live.type === "file" && live.files?.length === 1) return { lines: Array.from(live.files ?? [], (file) => file.name) };
+		else if (live.type === "image" && live.getAttribute("aria-hidden") !== "true") return { lines: [live.getAttribute("aria-label")?.trim() || live.alt] };
+		return { lines: [] };
+	} else if (live instanceof view.HTMLTextAreaElement) {
+		const placeholder = view.getComputedStyle(live, "::placeholder");
+		return { 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) {
+		const 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);
+				}
+			}
+		}
+		return { lines };
+	} else if (tag === "svg") {
+		if (twin.parentElement?.closest("svg, foreignObject")?.localName === "svg") return void 0;
+		const lines = [];
+		const 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 (!invisible && fragments.length === 0 && live.getAttribute("aria-hidden") !== "true") lines.push(live.getAttribute("aria-label")?.trim() || live.querySelector(":scope > title")?.textContent || "");
+		return {
+			lines,
+			...fragments.length === 0 ? {} : { fragments }
+		};
+	} else if ([
+		"form",
+		"dialog",
+		"button"
+	].includes(tag)) {
+		if (live instanceof view.HTMLButtonElement && !invisible && live.innerText.trim() === "") {
+			const name = live.getAttribute("aria-label")?.trim();
+			if (name) return { lines: [name] };
+		}
+		return { container: true };
+	}
+}
+/** Checks shadow-slot ancestors for capture omission without skipping style reads. */
+function readBrowserCaptureOmission(live, child, view, rendered, excluded) {
+	if (!rendered || live.shadowRoot === null || view === null) return excluded;
+	const slot = child instanceof view.Element || child instanceof view.Text ? child.assignedSlot : null;
+	if (slot === null) return true;
+	return new BrowserAncestors(slot, (entry) => entry === live ? null : readBrowserParent(entry)).reduce((omitted, parent) => parent === live ? omitted : view.getComputedStyle(parent).display === "none" || omitted, excluded);
+}
+// src/browser/BrowserDOMSubmission.ts
+/** Observes whether one form submission dispatches its submit event. */
+var BrowserDOMSubmission = class {
+	#submitted = false;
+	get submitted() {
+		return this.#submitted;
+	}
+	handleEvent() {
+		this.#submitted = true;
+	}
+};
+// src/browser/elements/BrowserDOMElement.ts
 /**
 * Drives a referenced element of a DOM document without trusted input.
 *
@@ -1122,7 +1198,7 @@ var BrowserDOMElement = class {
 	}
 	async read(options) {
 		const [node] = this.#current(options);
-		return createBrowserReading({
+		return createBrowserContent({
 			...readBrowserCapture(node),
 			navigation: this.#input.navigation
 		});
@@ -1144,17 +1220,15 @@ var BrowserDOMElement = class {
 			reference: this.reference,
 			reason: "UNTRUSTED"
 		});
-		let submitted = false;
+		const submission = new BrowserDOMSubmission();
 		const release = new AbortController();
-		owner.addEventListener("submit", () => {
-			submitted = true;
-		}, { signal: release.signal });
+		owner.addEventListener("submit", submission, { signal: release.signal });
 		try {
 			owner.requestSubmit(submitter ?? null);
 		} finally {
 			release.abort();
 		}
-		if (submitted) return;
+		if (submission.submitted) return;
 		const invalid = Array.from(owner.elements).find((control) => control.localName !== "fieldset" && control.matches(":invalid"));
 		if (invalid === void 0) throw new BrowserError("DOCUMENT_SUBMIT", "did not submit", { reference: this.reference });
 		const field = computeBrowserName(invalid) || (invalid.getAttribute("name") ?? invalid.localName);
@@ -1200,8 +1274,118 @@ var BrowserDOMElement = class {
 		});
 	}
 };
-//#endregion
-//#region src/browser/BrowserDOMWait.ts
+// src/browser/BrowserDOMOutline.ts
+/** Captures one flat-tree subtree while retaining its text and visibility state. */
+var BrowserDOMOutline = class {
+	#input;
+	#text = "";
+	#block;
+	#silenced;
+	#node = null;
+	constructor(input) {
+		this.#input = input;
+	}
+	capture() {
+		const { root, rows, muted } = this.#input;
+		this.#text = "";
+		this.#block = void 0;
+		this.#silenced = void 0;
+		const document = root.ownerDocument;
+		const view = document.defaultView;
+		if (view === null) return;
+		if (root instanceof view.Element && matchesBrowserHidden(root)) return;
+		this.#input.watch(document);
+		const walker = document.createTreeWalker(root, NodeFilter.SHOW_ELEMENT | NodeFilter.SHOW_TEXT, (node) => node instanceof view.Element && matchesBrowserHidden(node) ? NodeFilter.FILTER_REJECT : NodeFilter.FILTER_ACCEPT);
+		this.#node = root instanceof view.Element ? root : walker.nextNode();
+		while (this.#node !== null) {
+			if (this.#silenced !== void 0 && !this.#silenced.contains(this.#node)) this.#silenced = void 0;
+			const quiet = muted || this.#silenced !== void 0;
+			if (!(this.#node instanceof view.Element)) {
+				const parent = this.#node.parentElement;
+				const data = this.#node.textContent ?? "";
+				const blank = data.trim() === "";
+				if (!quiet && (!blank || this.#text !== "") && (parent === null || !matchesBrowserInvisible(parent))) {
+					const container = readBrowserBlock(parent, root);
+					if (!blank) {
+						if (this.#block !== void 0 && this.#block !== container) this.#text = this.#flush(rows, this.#text, this.#block);
+						this.#text += data;
+						this.#block = container;
+					} else if (container === this.#block) this.#text += data;
+				}
+				this.#node = walker.nextNode();
+				continue;
+			}
+			const invisible = matchesBrowserInvisible(this.#node);
+			if (this.#node.localName === "br") {
+				if (!quiet && this.#text !== "") this.#text += "\n";
+				this.#node = walker.nextNode();
+				continue;
+			}
+			if (this.#node instanceof view.HTMLIFrameElement) {
+				this.#text = this.#flush(rows, this.#text, this.#block);
+				const child = this.#node.contentDocument;
+				if (invisible) {
+					this.#node = skipBrowserSubtree(walker);
+					continue;
+				}
+				if (child === null) this.#input.text(rows, `iframe ${JSON.stringify(computeBrowserName(this.#node))} (cross-origin, not readable)`);
+				else this.#input.walk(child.documentElement, rows, quiet);
+				this.#node = skipBrowserSubtree(walker);
+				continue;
+			}
+			if (this.#node instanceof view.HTMLSlotElement) {
+				this.#text = this.#flush(rows, this.#text, this.#block);
+				for (const assigned of this.#node.assignedNodes({ flatten: true })) if (assigned instanceof view.Element) this.#input.walk(assigned, rows, quiet);
+				else if (!quiet) this.#flush(rows, assigned.textContent ?? "");
+				this.#node = skipBrowserSubtree(walker);
+				continue;
+			}
+			const tool = this.#node.localName === "form" ? this.#node.getAttribute("toolname") ?? "" : "";
+			const role = tool === "" ? computeBrowserRole(this.#node) : "form";
+			if (!invisible && role !== void 0 && (BROWSER_INTERACTIVE_ROLES.has(role) || [
+				"heading",
+				"image",
+				"img",
+				"listitem",
+				"row",
+				"cell",
+				"gridcell",
+				"columnheader",
+				"rowheader"
+			].includes(role) || tool !== "")) {
+				this.#text = this.#flush(rows, this.#text, this.#block);
+				const row = this.#input.row(this.#node, role, view, String(rows.length));
+				rows.push(row);
+				this.#input.positions.set(this.#node, row.id);
+				if (this.#silenced === void 0 && BROWSER_CONTENT_NAMED_ROLES.has(role) && ![
+					"row",
+					"cell",
+					"gridcell",
+					"columnheader",
+					"rowheader"
+				].includes(role)) this.#silenced = this.#node;
+				if (this.#node.localName === "textarea") {
+					this.#node = skipBrowserSubtree(walker);
+					continue;
+				}
+			}
+			const shadow = this.#node.shadowRoot;
+			if (shadow !== null) {
+				this.#text = this.#flush(rows, this.#text, this.#block);
+				this.#input.walk(shadow, rows, muted || this.#silenced !== void 0);
+				this.#node = skipBrowserSubtree(walker);
+				continue;
+			}
+			this.#node = walker.nextNode();
+		}
+		this.#flush(rows, this.#text, this.#block);
+	}
+	#flush(rows, text, parent) {
+		if (normalizeBrowserName(text) !== "") this.#input.text(rows, text, parent);
+		return "";
+	}
+};
+// src/browser/BrowserDOMWait.ts
 /**
 * Parks one condition on DOM mutations and finished transitions and animations until it holds, with one deadline and coalesced wake tasks.
 *
@@ -1367,8 +1551,7 @@ var BrowserDOMWait = class {
 		this.#observers.clear();
 	}
 };
-//#endregion
-//#region src/browser/elements/BrowserDOMElementManager.ts
+// src/browser/elements/BrowserDOMElementManager.ts
 /**
 * Outlines a DOM document from its elements and binds stable references to the interactive ones.
 *
@@ -1497,98 +1680,16 @@ var BrowserDOMElementManager = class {
 		return collectBrowserRoots(this.#root(this.#input.document(), within));
 	}
 	#walk(root, rows, muted) {
-		const document = root.ownerDocument;
-		const view = document.defaultView;
-		if (view === null) return;
-		if (root instanceof view.Element && matchesBrowserHidden(root)) return;
-		this.#watch(document);
-		const walker = document.createTreeWalker(root, NodeFilter.SHOW_ELEMENT | NodeFilter.SHOW_TEXT, (node) => node instanceof view.Element && matchesBrowserHidden(node) ? NodeFilter.FILTER_REJECT : NodeFilter.FILTER_ACCEPT);
-		let text = "";
-		let block;
-		let silenced;
-		let node = root instanceof view.Element ? root : walker.nextNode();
-		while (node !== null) {
-			if (silenced !== void 0 && !silenced.contains(node)) silenced = void 0;
-			const quiet = muted || silenced !== void 0;
-			if (!(node instanceof view.Element)) {
-				const parent = node.parentElement;
-				const data = node.textContent ?? "";
-				const blank = data.trim() === "";
-				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, block);
-						text += data;
-						block = container;
-					} else if (container === block) text += data;
-				}
-				node = walker.nextNode();
-				continue;
-			}
-			const invisible = matchesBrowserInvisible(node);
-			if (node.localName === "br") {
-				if (!quiet && text !== "") text += "\n";
-				node = walker.nextNode();
-				continue;
-			}
-			if (node instanceof view.HTMLIFrameElement) {
-				text = this.#flush(rows, text, block);
-				const child = node.contentDocument;
-				if (invisible) {
-					node = skipBrowserSubtree(walker);
-					continue;
-				}
-				if (child === null) this.#text(rows, `iframe ${JSON.stringify(computeBrowserName(node))} (cross-origin, not readable)`);
-				else this.#walk(child.documentElement, rows, quiet);
-				node = skipBrowserSubtree(walker);
-				continue;
-			}
-			if (node instanceof view.HTMLSlotElement) {
-				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);
-				continue;
-			}
-			const tool = node.localName === "form" ? node.getAttribute("toolname") ?? "" : "";
-			const role = tool === "" ? computeBrowserRole(node) : "form";
-			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;
-				}
-			}
-			const shadow = node.shadowRoot;
-			if (shadow !== null) {
-				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, block);
+		new BrowserDOMOutline({
+			root,
+			rows,
+			muted,
+			positions: this.#positions,
+			watch: this.#watch.bind(this),
+			walk: this.#walk.bind(this),
+			text: this.#text.bind(this),
+			row: this.#row.bind(this)
+		}).capture();
 	}
 	#watch(document) {
 		const view = document.defaultView;
@@ -1610,10 +1711,6 @@ var BrowserDOMElementManager = class {
 		const target = document.deref();
 		return target === void 0 ? -1 : this.#input.navigation() + (this.#epochs.get(target) ?? 0);
 	}
-	#flush(rows, text, parent) {
-		if (normalizeBrowserName(text) !== "") this.#text(rows, text, parent);
-		return "";
-	}
 	#text(rows, text, parent) {
 		rows.push({
 			id: String(rows.length),
@@ -1639,11 +1736,7 @@ var BrowserDOMElementManager = class {
 		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;
-		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;
+		const value = element instanceof view.HTMLSelectElement ? Array.from(element.selectedOptions, (option) => option.label).join(", ") : element instanceof view.HTMLTextAreaElement ? element.value : input?.type === "password" ? "•".repeat(input.value.length) : input === void 0 ? void 0 : input.type === "password" ? void 0 : BROWSER_TYPED_INPUTS.has(input.type) || input.type === "range" ? input.value : void 0;
 		return {
 			id: reference ?? id,
 			parent: this.#parent(element.parentNode),
@@ -1670,10 +1763,9 @@ var BrowserDOMElementManager = class {
 		};
 	}
 	#parent(node) {
-		while (node !== null) {
-			const id = this.#positions.get(node);
+		for (const current of new BrowserAncestors(node, (entry) => entry.parentNode)) {
+			const id = this.#positions.get(current);
 			if (id !== void 0) return id;
-			node = node.parentNode;
 		}
 	}
 	#bind(element, role, name) {
@@ -1715,8 +1807,7 @@ var BrowserDOMElementManager = class {
 		return this.#descriptions.get(node) ?? captured;
 	}
 };
-//#endregion
-//#region src/browser/BrowserDOMView.ts
+// src/browser/BrowserDOMView.ts
 /**
 * Reads and drives a DOM document from a realm that can reach it, without trusted input.
 *
@@ -1781,7 +1872,7 @@ var BrowserDOMView = class {
 	async read(options) {
 		this.#release.signal.throwIfAborted();
 		options?.signal?.throwIfAborted();
-		return createBrowserReading({
+		return createBrowserContent({
 			...readBrowserCapture(this.#current().documentElement),
 			navigation: this.#navigation.bind(this)
 		});
@@ -1832,8 +1923,7 @@ var BrowserDOMView = class {
 		listenBrowserNavigation(this.#window, this.#navigateHandler, this.#listeners.signal);
 	}
 };
-//#endregion
-//#region src/browser/transports/SocketCDPTransport.ts
+// src/browser/transports/SocketCDPTransport.ts
 /**
 * Provides a raw CDP text transport over the browser's native `WebSocket`.
 *
@@ -1961,8 +2051,7 @@ var SocketCDPTransport = class {
 		return new BrowserError("CONNECTION", `Socket CDP connection to ${this.#url} ${reason}`, { url: this.#url });
 	}
 };
-//#endregion
-//#region src/browser/factories.ts
+// src/browser/factories.ts
 /**
 * Creates a view that reads and drives a DOM document without trusted input.
 *
@@ -2000,7 +2089,6 @@ function createBrowserDOMView(options) {
 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, 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 };
+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, BrowserAncestors, BrowserCaptureSiblings, BrowserDOMOutline, BrowserDOMSubmission, BrowserDOMView, BrowserDOMWait, SocketCDPTransport, collectBrowserRoots, computeBrowserAlternative, computeBrowserName, computeBrowserRole, computeBrowserText, createBrowserDOMView, createSocketCDPTransport, isBrowserDocument, listenBrowserNavigation, matchesBrowserActivation, matchesBrowserBlock, matchesBrowserHidden, matchesBrowserInvisible, matchesBrowserOmitted, matchesBrowserPopup, readBrowserBlock, readBrowserCapture, readBrowserCaptureOmission, readBrowserCaptureValue, readBrowserContent, readBrowserParent, readBrowserStates, readBrowserToken, skipBrowserSubtree };
 
 //# sourceMappingURL=index.js.map