@orkestrel/browser 0.0.6 → 0.0.8

package/dist/src/core/index.js

@@ -1,5 +1,6 @@
-import { attempt, instanceOf, isArray, isBoolean, isFiniteNumber, isInstance, isInteger, isRecord, isString, parseArray, parseEnum, parseJSON } from "@orkestrel/contract";
+import { attempt, instanceOf, isArray, isBoolean, isFiniteNumber, isFunction, isInstance, isInteger, isRecord, isString, parseArray, parseEnum, parseJSON } from "@orkestrel/contract";
 import { Emitter } from "@orkestrel/emitter";
+import { createHTML, renderText } from "@orkestrel/html";
 //#region src/core/constants.ts
 /** Base64 alphabet, index-ordered, used to build {@link BASE64_LOOKUP}. */
 var BASE64_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
@@ -74,7 +75,7 @@ var BROWSER_MOUSE_BUTTON_MASKS = Object.freeze({
 /** Tool identity embedded in HAR 1.2 documents. */
 var BROWSER_HAR_CREATOR = Object.freeze({
 	name: "@orkestrel/browser",
-	version: "0.0.5"
+	version: "0.0.8"
 });
 /** Attribute used to tag temporary screenshot styles and masks. */
 var BROWSER_SCREENSHOT_ATTRIBUTE = "data-orkestrel-screenshot";
@@ -558,10 +559,10 @@ function createBrowserHAREntry(pending, duration, body, error) {
 			cookies: [],
 			headers: requestHeaders,
 			queryString: query,
-			postData: post === void 0 ? void 0 : {
+			...post !== void 0 ? { postData: {
 				mimeType: requestMime,
 				text: post
-			},
+			} } : {},
 			headersSize: -1,
 			bodySize: post === void 0 ? 0 : textToBytes(post).byteLength
 		},
@@ -574,8 +575,10 @@ function createBrowserHAREntry(pending, duration, body, error) {
 			content: {
 				size,
 				mimeType: response?.mime ?? "application/octet-stream",
-				text,
-				encoding: text === void 0 ? void 0 : "base64"
+				...text !== void 0 ? {
+					text,
+					encoding: "base64"
+				} : {}
 			},
 			redirectURL: redirect,
 			headersSize: -1,
@@ -1387,7 +1390,7 @@ function readBrowserCookiePartition(value) {
 	if (!isRecord(value) || !isString(value["topLevelSite"])) return void 0;
 	return {
 		site: value["topLevelSite"],
-		ancestor: isBoolean(value["hasCrossSiteAncestor"]) ? value["hasCrossSiteAncestor"] : void 0
+		...isBoolean(value["hasCrossSiteAncestor"]) ? { ancestor: value["hasCrossSiteAncestor"] } : {}
 	};
 }
 /**
@@ -1609,7 +1612,7 @@ function readBrowserDownloadProgress(value) {
 		status,
 		received: value["receivedBytes"],
 		total: value["totalBytes"],
-		path: isString(value["filePath"]) ? value["filePath"] : void 0
+		...isString(value["filePath"]) ? { path: value["filePath"] } : {}
 	}];
 }
 /**
@@ -2820,326 +2823,6 @@ function decodeBrowserSnapshot(value, styles = [], limit = BROWSER_SNAPSHOT_NODE
 	};
 }
 /**
-* Lazily walk every captured browser node in structural depth-first order.
-*
-* @remarks
-* Iframe content documents are entered at their owner element. Orphaned or
-* cyclic protocol nodes are still yielded once through an identity guard.
-*
-* @param snapshot - Captured browser snapshot
-* @returns A lazy node generator
-*/
-function* walkBrowserSnapshot(snapshot) {
-	const seeds = [];
-	for (const document of snapshot.documents) seeds.push(...document.nodes.filter((node) => node.parent === void 0));
-	for (const document of snapshot.documents) seeds.push(...document.nodes);
-	const visited = /* @__PURE__ */ new Set();
-	for (const seed of seeds) {
-		const stack = [seed];
-		while (stack.length > 0) {
-			const node = stack.pop();
-			if (node === void 0) break;
-			const identity = `${node.document}:${node.index}`;
-			if (visited.has(identity)) continue;
-			visited.add(identity);
-			yield node;
-			const children = childrenOfBrowserNode(snapshot, node);
-			for (let index = children.length - 1; index >= 0; index -= 1) {
-				const child = children[index];
-				if (child !== void 0) stack.push(child);
-			}
-		}
-	}
-}
-/**
-* Lazily walk every captured node in structural breadth-first order.
-*
-* @param snapshot - Captured browser snapshot
-* @returns A lazy breadth-first generator
-*/
-function* walkBrowserSnapshotBreadthFirst(snapshot) {
-	const seeds = [];
-	for (const document of snapshot.documents) seeds.push(...document.nodes.filter((node) => node.parent === void 0));
-	for (const document of snapshot.documents) seeds.push(...document.nodes);
-	const visited = /* @__PURE__ */ new Set();
-	for (const seed of seeds) {
-		const queue = [seed];
-		let cursor = 0;
-		while (cursor < queue.length) {
-			const node = queue[cursor];
-			cursor += 1;
-			if (node === void 0) continue;
-			const identity = `${node.document}:${node.index}`;
-			if (visited.has(identity)) continue;
-			visited.add(identity);
-			yield node;
-			queue.push(...childrenOfBrowserNode(snapshot, node));
-		}
-	}
-}
-/**
-* Lazily walk one captured browser-node subtree in depth-first order.
-*
-* @param snapshot - Captured browser snapshot
-* @param root - Root node, included as the first result
-* @returns A lazy subtree generator
-*/
-function* walkBrowserNode(snapshot, root) {
-	const stack = [root];
-	const visited = /* @__PURE__ */ new Set();
-	while (stack.length > 0) {
-		const node = stack.pop();
-		if (node === void 0) break;
-		const identity = `${node.document}:${node.index}`;
-		if (visited.has(identity)) continue;
-		visited.add(identity);
-		yield node;
-		const children = childrenOfBrowserNode(snapshot, node);
-		for (let index = children.length - 1; index >= 0; index -= 1) {
-			const child = children[index];
-			if (child !== void 0) stack.push(child);
-		}
-	}
-}
-/**
-* Lazily walk one captured browser-node subtree in breadth-first order.
-*
-* @param snapshot - Captured browser snapshot
-* @param root - Root node, included as the first result
-* @returns A lazy breadth-first subtree generator
-*/
-function* walkBrowserNodeBreadthFirst(snapshot, root) {
-	const queue = [root];
-	const visited = /* @__PURE__ */ new Set();
-	let cursor = 0;
-	while (cursor < queue.length) {
-		const node = queue[cursor];
-		cursor += 1;
-		if (node === void 0) continue;
-		const identity = `${node.document}:${node.index}`;
-		if (visited.has(identity)) continue;
-		visited.add(identity);
-		yield node;
-		queue.push(...childrenOfBrowserNode(snapshot, node));
-	}
-}
-/**
-* Lazily walk descendants of one captured node, excluding the node itself.
-*
-* @param snapshot - Captured browser snapshot
-* @param root - Root whose descendants are required
-* @returns A lazy descendant generator
-*/
-function* descendantsOfBrowserNode(snapshot, root) {
-	let first = true;
-	for (const node of walkBrowserNode(snapshot, root)) {
-		if (first) {
-			first = false;
-			continue;
-		}
-		yield node;
-	}
-}
-/**
-* Resolve the document containing a browser node.
-*
-* @param snapshot - Captured browser snapshot
-* @param node - Node whose document is required
-* @returns The containing document, or undefined
-*/
-function documentOfBrowserNode(snapshot, node) {
-	return snapshot.documents.find((document) => document.index === node.document);
-}
-/**
-* Return direct children of a captured browser node.
-*
-* @remarks
-* Includes the root nodes of an iframe's linked content document. Shadow DOM
-* and template content already carry flattened parent indexes from CDP.
-*
-* @param snapshot - Captured browser snapshot
-* @param node - Parent node
-* @returns Direct children in snapshot order
-*/
-function childrenOfBrowserNode(snapshot, node) {
-	const document = documentOfBrowserNode(snapshot, node);
-	if (document === void 0) return [];
-	const children = document.nodes.filter((candidate) => candidate.parent === node.index);
-	if (node.content === void 0) return children;
-	const content = snapshot.documents.find((candidate) => candidate.index === node.content);
-	if (content === void 0) return children;
-	return [...children, ...content.nodes.filter((candidate) => candidate.parent === void 0)];
-}
-/**
-* Resolve the structural parent of a captured browser node.
-*
-* @remarks
-* An iframe content-document root resolves to its owning iframe node.
-*
-* @param snapshot - Captured browser snapshot
-* @param node - Child node
-* @returns Parent node, or undefined for a top-level document root
-*/
-function parentOfBrowserNode(snapshot, node) {
-	const document = documentOfBrowserNode(snapshot, node);
-	if (document === void 0) return void 0;
-	return node.parent === void 0 ? findBrowserNode(snapshot, (candidate) => candidate.content === node.document) : document.nodes[node.parent];
-}
-/**
-* Return every structural sibling except the supplied browser node.
-*
-* @param snapshot - Captured browser snapshot
-* @param node - Node whose siblings are required
-* @returns Siblings in structural order
-*/
-function siblingsOfBrowserNode(snapshot, node) {
-	const parent = parentOfBrowserNode(snapshot, node);
-	return (parent === void 0 ? documentOfBrowserNode(snapshot, node)?.nodes.filter((candidate) => candidate.parent === void 0) ?? [] : childrenOfBrowserNode(snapshot, parent)).filter((candidate) => candidate.document !== node.document || candidate.index !== node.index);
-}
-/**
-* Return structural siblings before the supplied browser node.
-*
-* @param snapshot - Captured browser snapshot
-* @param node - Reference node
-* @returns Earlier siblings in structural order
-*/
-function precedingSiblingsOfBrowserNode(snapshot, node) {
-	const parent = parentOfBrowserNode(snapshot, node);
-	const candidates = parent === void 0 ? documentOfBrowserNode(snapshot, node)?.nodes.filter((candidate) => candidate.parent === void 0) ?? [] : childrenOfBrowserNode(snapshot, parent);
-	const index = candidates.findIndex((candidate) => candidate.document === node.document && candidate.index === node.index);
-	return index < 0 ? [] : candidates.slice(0, index);
-}
-/**
-* Return structural siblings after the supplied browser node.
-*
-* @param snapshot - Captured browser snapshot
-* @param node - Reference node
-* @returns Later siblings in structural order
-*/
-function followingSiblingsOfBrowserNode(snapshot, node) {
-	const parent = parentOfBrowserNode(snapshot, node);
-	const candidates = parent === void 0 ? documentOfBrowserNode(snapshot, node)?.nodes.filter((candidate) => candidate.parent === void 0) ?? [] : childrenOfBrowserNode(snapshot, parent);
-	const index = candidates.findIndex((candidate) => candidate.document === node.document && candidate.index === node.index);
-	return index < 0 ? [] : candidates.slice(index + 1);
-}
-/**
-* Return the nearest-first ancestor chain for a captured browser node.
-*
-* @param snapshot - Captured browser snapshot
-* @param node - Descendant node
-* @returns Nearest-first ancestor list
-*/
-function ancestorsOfBrowserNode(snapshot, node) {
-	const ancestors = [];
-	const visited = /* @__PURE__ */ new Set();
-	let current = node;
-	while (true) {
-		const parent = parentOfBrowserNode(snapshot, current);
-		if (parent === void 0) break;
-		const identity = `${parent.document}:${parent.index}`;
-		if (visited.has(identity)) break;
-		visited.add(identity);
-		ancestors.push(parent);
-		current = parent;
-	}
-	return ancestors;
-}
-/**
-* Test whether one captured node is below another across frame boundaries.
-*
-* @param snapshot - Captured browser snapshot
-* @param node - Candidate descendant
-* @param ancestor - Candidate ancestor
-* @returns Whether the relationship exists
-*/
-function isBrowserNodeDescendant(snapshot, node, ancestor) {
-	return ancestorsOfBrowserNode(snapshot, node).some((candidate) => candidate.document === ancestor.document && candidate.index === ancestor.index);
-}
-/**
-* Resolve the nearest common ancestor of two captured browser nodes.
-*
-* @param snapshot - Captured browser snapshot
-* @param first - First node
-* @param second - Second node
-* @returns Common ancestor, or undefined
-*/
-function commonAncestorOfBrowserNodes(snapshot, first, second) {
-	const firstAncestors = [first, ...ancestorsOfBrowserNode(snapshot, first)];
-	const secondAncestors = [second, ...ancestorsOfBrowserNode(snapshot, second)];
-	const identities = new Set(firstAncestors.map((node) => `${node.document}:${node.index}`));
-	return secondAncestors.find((node) => identities.has(`${node.document}:${node.index}`));
-}
-/**
-* Compute the edge count between two captured browser nodes.
-*
-* @param snapshot - Captured browser snapshot
-* @param first - First node
-* @param second - Second node
-* @returns Tree distance, or undefined when no common ancestor exists
-*/
-function computeBrowserNodeDistance(snapshot, first, second) {
-	const common = commonAncestorOfBrowserNodes(snapshot, first, second);
-	if (common === void 0) return void 0;
-	const firstPath = [first, ...ancestorsOfBrowserNode(snapshot, first)];
-	const secondPath = [second, ...ancestorsOfBrowserNode(snapshot, second)];
-	const firstDistance = firstPath.findIndex((node) => node.document === common.document && node.index === common.index);
-	const secondDistance = secondPath.findIndex((node) => node.document === common.document && node.index === common.index);
-	if (firstDistance < 0 || secondDistance < 0) return void 0;
-	return firstDistance + secondDistance;
-}
-/**
-* Find the first captured node satisfying a predicate.
-*
-* @param snapshot - Captured browser snapshot
-* @param predicate - Node predicate
-* @returns First matching node, or undefined
-*/
-function findBrowserNode(snapshot, predicate) {
-	for (const node of walkBrowserSnapshot(snapshot)) if (predicate(node)) return node;
-}
-/**
-* Find captured nodes satisfying a predicate.
-*
-* @param snapshot - Captured browser snapshot
-* @param predicate - Node predicate
-* @param limit - Optional maximum result count
-* @returns Matching nodes in snapshot order
-*/
-function findBrowserNodes(snapshot, predicate, limit) {
-	if (limit !== void 0 && (!isInteger(limit) || limit < 0)) throw new BrowserError("Browser node result limit must be a non-negative integer", void 0, { limit });
-	if (limit === 0) return [];
-	const found = [];
-	for (const node of walkBrowserSnapshot(snapshot)) {
-		if (!predicate(node)) continue;
-		found.push(node);
-		if (limit !== void 0 && found.length >= limit) break;
-	}
-	return found;
-}
-/**
-* Find the first matching descendant beneath one captured node.
-*
-* @param snapshot - Captured browser snapshot
-* @param root - Root whose descendants are searched
-* @param predicate - Node predicate
-* @returns First matching descendant, or undefined
-*/
-function findBrowserDescendant(snapshot, root, predicate) {
-	for (const node of descendantsOfBrowserNode(snapshot, root)) if (predicate(node)) return node;
-}
-/**
-* Find the nearest matching node from the candidate through its ancestors.
-*
-* @param snapshot - Captured browser snapshot
-* @param node - Starting node, included in the search
-* @param predicate - Node predicate
-* @returns Closest matching node, or undefined
-*/
-function closestBrowserNode(snapshot, node, predicate) {
-	if (predicate(node)) return node;
-	return ancestorsOfBrowserNode(snapshot, node).find(predicate);
-}
-/**
 * Read one captured node attribute.
 *
 * @param node - Captured browser node
@@ -3150,6 +2833,23 @@ function attributeOfBrowserNode(node, name) {
 	return node.attributes[name];
 }
 /**
+* Test whether a browser-node matcher is a declarative query.
+*
+* @param value - Browser-node query or predicate
+* @returns Whether the matcher is a declarative query
+*
+* @example
+* ```ts
+* import { isBrowserNodeQuery } from '@src/core'
+*
+* isBrowserNodeQuery({ name: 'main' }) // true
+* isBrowserNodeQuery(() => true) // false
+* ```
+*/
+function isBrowserNodeQuery(value) {
+	return !isFunction(value);
+}
+/**
 * Test a captured node against a declarative query.
 *
 * @param node - Captured browser node
@@ -3177,36 +2877,6 @@ function isBrowserNodeVisible(node) {
 	const bounds = node.layout?.bounds;
 	return bounds !== void 0 && bounds[2] > 0 && bounds[3] > 0;
 }
-/**
-* Build a deterministic, serializable path for a captured browser node.
-*
-* @param snapshot - Captured browser snapshot
-* @param node - Captured browser node
-* @returns Frame-qualified structural path
-*/
-function nodeToPath(snapshot, node) {
-	const document = documentOfBrowserNode(snapshot, node);
-	if (document === void 0) return `document:${node.document} > node:${node.index}`;
-	const chain = [...ancestorsOfBrowserNode(snapshot, node)].reverse();
-	chain.push(node);
-	const segments = [];
-	for (const current of chain) {
-		if (current.type !== 1) {
-			segments.push(`${current.name.toLowerCase()}:${current.index}`);
-			continue;
-		}
-		let ordinal = 1;
-		if (current.parent !== void 0) {
-			const owner = documentOfBrowserNode(snapshot, current);
-			for (const sibling of owner?.nodes ?? []) {
-				if (sibling.index >= current.index) break;
-				if (sibling.parent === current.parent && sibling.name === current.name) ordinal += 1;
-			}
-		}
-		segments.push(`${current.name.toLowerCase()}:${ordinal}`);
-	}
-	return `frame(${JSON.stringify(document.frame)}) > ${segments.join(" > ")}`;
-}
 //#endregion
 //#region src/core/CDPClient.ts
 /**
@@ -3509,7 +3179,7 @@ var BrowserClock = class {
 	#installed = false;
 	#advancing = false;
 	#budgetResolve;
-	#budgetHandler = () => this.#budgetResolve?.();
+	#budgetHandler = this.#handleBudget.bind(this);
 	constructor(frame) {
 		this.#frame = frame;
 	}
@@ -3609,6 +3279,9 @@ var BrowserClock = class {
 	#idle() {
 		if (this.#advancing) throw new BrowserError("Browser clock advance is already active");
 	}
+	#handleBudget() {
+		this.#budgetResolve?.();
+	}
 };
 //#endregion
 //#region src/core/BrowserCoverage.ts
@@ -3806,8 +3479,8 @@ var BrowserCookieManager = class {
 			expires: cookie.expires,
 			http: cookie.http,
 			secure: cookie.secure,
-			site: cookie.site,
-			partition: cookie.partition
+			...cookie.site !== void 0 ? { site: cookie.site } : {},
+			...cookie.partition !== void 0 ? { partition: cookie.partition } : {}
 		})) };
 		if (this.#context !== void 0) restore["browserContextId"] = this.#context;
 		const result = await this.#client.send("Storage.setCookies", restore);
@@ -3951,12 +3624,14 @@ var BrowserCodegen = class {
 	#stopping;
 	#shutdown;
 	#emitter;
+	#onBindingCalled = this.#handleBindingCalled.bind(this);
+	#onFrameNavigated = this.#handleFrameNavigated.bind(this);
 	constructor(client, sessionId, options) {
 		this.#client = client;
 		this.#sessionId = sessionId;
 		this.#emitter = new Emitter({
-			on: options?.on,
-			error: options?.error
+			...options?.on !== void 0 ? { on: options.on } : {},
+			...options?.error !== void 0 ? { error: options.error } : {}
 		});
 	}
 	get emitter() {
@@ -4051,19 +3726,19 @@ var BrowserCodegen = class {
 		this.#actions = [];
 		this.#emitter.destroy();
 	}
-	#onBindingCalled = (params) => {
+	#handleBindingCalled(params) {
 		if (params["name"] !== "__orkestrelBrowserCodegen") return;
 		const action = parseCodegenActionPayload(params["payload"]);
 		if (action === void 0) return;
 		this.#actions.push(action);
 		this.#emitter.emit("action", action);
-	};
-	#onFrameNavigated = (params) => {
+	}
+	#handleFrameNavigated(params) {
 		const action = readCodegenNavigateAction(params);
 		if (action === void 0) return;
 		this.#actions.push(action);
 		this.#emitter.emit("action", action);
-	};
+	}
 	#unsubscribe() {
 		this.#client.unsubscribe("Runtime.bindingCalled", this.#onBindingCalled, this.#sessionId);
 		this.#client.unsubscribe("Page.frameNavigated", this.#onFrameNavigated, this.#sessionId);
@@ -4133,12 +3808,7 @@ var BrowserTracing = class {
 	#active = false;
 	#options;
 	#completion;
-	#completeHandler = (params) => {
-		const completion = this.#completion;
-		if (completion === void 0) return;
-		if (isString(params["stream"])) completion.resolve(params["stream"]);
-		else completion.reject(new BrowserError("Browser trace did not return an IO stream"));
-	};
+	#completeHandler = this.#handleComplete.bind(this);
 	constructor(frame, writer) {
 		this.#frame = frame;
 		this.#writer = writer;
@@ -4214,6 +3884,12 @@ var BrowserTracing = class {
 			clearTimeout(timer);
 		}
 	}
+	#handleComplete(params) {
+		const completion = this.#completion;
+		if (completion === void 0) return;
+		if (isString(params["stream"])) completion.resolve(params["stream"]);
+		else completion.reject(new BrowserError("Browser trace did not return an IO stream"));
+	}
 };
 //#endregion
 //#region src/core/BrowserDiagnostics.ts
@@ -4931,8 +4607,8 @@ var BrowserLocator = class BrowserLocator {
 		let targetHandle;
 		try {
 			await target.wait({
-				timeout: options?.timeout,
-				strict: options?.strict,
+				...options?.timeout !== void 0 ? { timeout: options.timeout } : {},
+				...options?.strict !== void 0 ? { strict: options.strict } : {},
 				state: "visible"
 			});
 			targetHandle = await target.frame.handle(compileLocatorExpression(target.query));
@@ -4955,8 +4631,8 @@ var BrowserLocator = class BrowserLocator {
 	async #resolve(options, state) {
 		validateBrowserActionOptions(options);
 		await this.wait({
-			timeout: options?.timeout,
-			strict: options?.strict,
+			...options?.timeout !== void 0 ? { timeout: options.timeout } : {},
+			...options?.strict !== void 0 ? { strict: options.strict } : {},
 			state
 		});
 		return await this.#frame.handle(compileLocatorExpression(this.#query));
@@ -4964,7 +4640,7 @@ var BrowserLocator = class BrowserLocator {
 	async #point(handle, options, actionability) {
 		if (options?.force !== true) await handle.call(compileActionabilityFunction({
 			...actionability,
-			position: options?.position
+			...options?.position !== void 0 ? { position: options.position } : {}
 		}));
 		const quad = await this.#quad(handle);
 		if (options?.position === void 0) return quad.center;
@@ -5003,9 +4679,7 @@ var BrowserLocator = class BrowserLocator {
 			case "enabled":
 				expression = `(() => { const element = ${compileLocatorExpression(this.#query)}; return Boolean(element && !element.matches(':disabled')) })()`;
 				break;
-			case "editable":
-				expression = `(() => { const element = ${compileLocatorExpression(this.#query)}; return Boolean(element && !element.matches(':disabled,[readonly]') && (element.isContentEditable || 'value' in element)) })()`;
-				break;
+			case "editable": expression = `(() => { const element = ${compileLocatorExpression(this.#query)}; return Boolean(element && !element.matches(':disabled,[readonly]') && (element.isContentEditable || 'value' in element)) })()`;
 		}
 		return await this.#frame.evaluate(expression) === true;
 	}
@@ -5038,29 +4712,29 @@ var BrowserSelectorManager = class {
 		return new BrowserLocator(this.#frame, {
 			selector: "role",
 			value,
-			name: options?.name,
-			exact: options?.exact
+			...options?.name !== void 0 ? { name: options.name } : {},
+			...options?.exact !== void 0 ? { exact: options.exact } : {}
 		});
 	}
 	text(value, options) {
 		return new BrowserLocator(this.#frame, {
 			selector: "text",
 			value,
-			exact: options?.exact
+			...options?.exact !== void 0 ? { exact: options.exact } : {}
 		});
 	}
 	label(value, options) {
 		return new BrowserLocator(this.#frame, {
 			selector: "label",
 			value,
-			exact: options?.exact
+			...options?.exact !== void 0 ? { exact: options.exact } : {}
 		});
 	}
 	placeholder(value, options) {
 		return new BrowserLocator(this.#frame, {
 			selector: "placeholder",
 			value,
-			exact: options?.exact
+			...options?.exact !== void 0 ? { exact: options.exact } : {}
 		});
 	}
 	test(value) {
@@ -5166,7 +4840,7 @@ var BrowserFrame = class {
 		this.assert();
 		const [title, html, text, currentUrl] = await Promise.all([
 			this.#evaluate("document.title"),
-			this.#evaluate(guardEvaluateExpression("document.documentElement.outerHTML", BROWSER_RESULT_LIMIT)),
+			this.#captureHTML(),
 			this.#evaluate(guardEvaluateExpression("document.body ? document.body.innerText : \"\"", BROWSER_RESULT_LIMIT)),
 			this.#evaluate("location.href")
 		]);
@@ -5179,6 +4853,11 @@ var BrowserFrame = class {
 			text: requireBrowserString(text, "Document text")
 		};
 	}
+	async article() {
+		this.assert();
+		const html = requireBrowserString(await this.#captureHTML(), "Document HTML");
+		return renderText(createHTML(html).distill().document);
+	}
 	async click(selector, options) {
 		this.assert();
 		await this.#selectors.css(selector).click(options);
@@ -5239,6 +4918,9 @@ var BrowserFrame = class {
 	update(url) {
 		this.#url = url;
 	}
+	async #captureHTML() {
+		return await this.#evaluate(guardEvaluateExpression("document.documentElement.outerHTML", BROWSER_RESULT_LIMIT));
+	}
 	async #evaluate(expression, timeout) {
 		const session = await this.#sessionId();
 		const params = {
@@ -5330,45 +5012,11 @@ var BrowserHARManager = class {
 	#failure;
 	#archive;
 	#fallback = false;
-	#requestHandler = (request) => {
-		if (!this.#recording) return;
-		this.#pending.set(request.id, {
-			request,
-			started: request.walltime === void 0 ? Date.now() : request.walltime * 1e3,
-			response: void 0
-		});
-	};
-	#responseHandler = (response) => {
-		const pending = this.#pending.get(response.id);
-		if (pending === void 0) return;
-		this.#pending.set(response.id, {
-			request: pending.request,
-			started: pending.started,
-			response
-		});
-	};
-	#failureHandler = (failure) => {
-		const pending = this.#pending.get(failure.id);
-		if (pending === void 0) return;
-		this.#pending.delete(failure.id);
-		this.#entries.push(createBrowserHAREntry(pending, Math.max(0, Date.now() - pending.started), void 0, failure.error));
-	};
-	#finishHandler = (id) => this.#track(this.#complete(id));
-	#replayHandler = async (route) => {
-		const entry = this.#archive?.log.entries.find((candidate) => candidate.request.url === route.request.url && candidate.request.method === route.request.method);
-		if (entry === void 0 || entry.response.status === 0) {
-			if (this.#fallback) await route.continue();
-			else await route.abort("Failed");
-			return;
-		}
-		const body = entry.response.content.text === void 0 ? void 0 : entry.response.content.encoding === "base64" ? decodeBase64(entry.response.content.text) : entry.response.content.text;
-		await route.fulfill({
-			status: entry.response.status,
-			phrase: entry.response.statusText,
-			headers: browserHARHeadersToRecord(entry.response.headers),
-			body
-		});
-	};
+	#requestHandler = this.#handleRequest.bind(this);
+	#responseHandler = this.#handleResponse.bind(this);
+	#failureHandler = this.#handleFailure.bind(this);
+	#finishHandler = this.#handleFinish.bind(this);
+	#replayHandler = this.#handleReplay.bind(this);
 	constructor(network, writer) {
 		this.#network = network;
 		this.#writer = writer;
@@ -5447,6 +5095,47 @@ var BrowserHARManager = class {
 		this.#entries.length = 0;
 		this.#pending.clear();
 	}
+	#handleRequest(request) {
+		if (!this.#recording) return;
+		this.#pending.set(request.id, {
+			request,
+			started: request.walltime === void 0 ? Date.now() : request.walltime * 1e3,
+			response: void 0
+		});
+	}
+	#handleResponse(response) {
+		const pending = this.#pending.get(response.id);
+		if (pending === void 0) return;
+		this.#pending.set(response.id, {
+			request: pending.request,
+			started: pending.started,
+			response
+		});
+	}
+	#handleFailure(failure) {
+		const pending = this.#pending.get(failure.id);
+		if (pending === void 0) return;
+		this.#pending.delete(failure.id);
+		this.#entries.push(createBrowserHAREntry(pending, Math.max(0, Date.now() - pending.started), void 0, failure.error));
+	}
+	#handleFinish(id) {
+		this.#track(this.#complete(id));
+	}
+	async #handleReplay(route) {
+		const entry = this.#archive?.log.entries.find((candidate) => candidate.request.url === route.request.url && candidate.request.method === route.request.method);
+		if (entry === void 0 || entry.response.status === 0) {
+			if (this.#fallback) await route.continue();
+			else await route.abort("Failed");
+			return;
+		}
+		const body = entry.response.content.text === void 0 ? void 0 : entry.response.content.encoding === "base64" ? decodeBase64(entry.response.content.text) : entry.response.content.text;
+		await route.fulfill({
+			status: entry.response.status,
+			phrase: entry.response.statusText,
+			headers: browserHARHeadersToRecord(entry.response.headers),
+			...body !== void 0 ? { body } : {}
+		});
+	}
 	async #complete(id) {
 		const pending = this.#pending.get(id);
 		if (pending === void 0) return;
@@ -5596,54 +5285,17 @@ var BrowserNetworkManager = class {
 	#fetch = false;
 	#destroyed = false;
 	#starting;
-	#requestHandler = (params) => {
-		const request = readBrowserRequest(params);
-		if (request !== void 0) this.#emitter.emit("request", request);
-	};
-	#responseHandler = (params) => {
-		const response = readBrowserResponse(params);
-		if (response !== void 0) this.#emitter.emit("response", response);
-	};
-	#failureHandler = (params) => {
-		const failure = readBrowserRequestFailure(params);
-		if (failure !== void 0) this.#emitter.emit("failure", failure);
-	};
-	#finishHandler = (params) => {
-		if (isString(params["requestId"])) this.#emitter.emit("finish", params["requestId"]);
-	};
-	#pausedHandler = (params) => {
-		this.#route(params).catch(() => void 0);
-	};
-	#authHandler = (params) => {
-		this.#authenticate(params).catch(() => void 0);
-	};
-	#socketHandler = (params) => {
-		if (!isString(params["requestId"]) || !isString(params["url"])) return;
-		const socket = new BrowserWebSocket(params["requestId"], params["url"]);
-		this.#sockets.set(socket.id, socket);
-		this.#emitter.emit("socket", socket);
-	};
-	#socketReceiveHandler = (params) => {
-		const socket = isString(params["requestId"]) ? this.#sockets.get(params["requestId"]) : void 0;
-		const frame = readBrowserWebSocketFrame(params);
-		if (socket !== void 0 && frame !== void 0) socket.receive(frame);
-	};
-	#socketTransmitHandler = (params) => {
-		const socket = isString(params["requestId"]) ? this.#sockets.get(params["requestId"]) : void 0;
-		const frame = readBrowserWebSocketFrame(params);
-		if (socket !== void 0 && frame !== void 0) socket.transmit(frame);
-	};
-	#socketErrorHandler = (params) => {
-		const socket = isString(params["requestId"]) ? this.#sockets.get(params["requestId"]) : void 0;
-		if (socket !== void 0 && isString(params["errorMessage"])) socket.fail(params["errorMessage"]);
-	};
-	#socketCloseHandler = (params) => {
-		if (!isString(params["requestId"])) return;
-		const socket = this.#sockets.get(params["requestId"]);
-		if (socket === void 0) return;
-		this.#sockets.delete(params["requestId"]);
-		socket.close(isFiniteNumber(params["timestamp"]) ? params["timestamp"] : Date.now() / 1e3);
-	};
+	#requestHandler = this.#handleRequest.bind(this);
+	#responseHandler = this.#handleResponse.bind(this);
+	#failureHandler = this.#handleFailure.bind(this);
+	#finishHandler = this.#handleFinish.bind(this);
+	#pausedHandler = this.#handlePause.bind(this);
+	#authHandler = this.#handleAuth.bind(this);
+	#socketHandler = this.#handleSocket.bind(this);
+	#socketReceiveHandler = this.#handleSocketReceive.bind(this);
+	#socketTransmitHandler = this.#handleSocketTransmit.bind(this);
+	#socketErrorHandler = this.#handleSocketError.bind(this);
+	#socketCloseHandler = this.#handleSocketClose.bind(this);
 	constructor(frame, writer) {
 		this.#frame = frame;
 		this.#emitter = new Emitter();
@@ -5773,29 +5425,77 @@ var BrowserNetworkManager = class {
 		this.#emitter.destroy();
 		if (failed) throw failure;
 	}
-	async #begin() {
-		try {
-			await this.#subscribe();
-			await this.#frame.send("Network.enable");
-			this.#started = true;
-			await this.#configure();
-		} catch (error) {
-			this.#started = false;
-			this.#fetch = false;
-			await this.#frame.send("Fetch.disable").catch(() => void 0);
-			await this.#frame.send("Network.disable").catch(() => void 0);
-			await this.#unsubscribe().catch(() => void 0);
-			throw error;
-		}
+	#handleRequest(params) {
+		const request = readBrowserRequest(params);
+		if (request !== void 0) this.#emitter.emit("request", request);
 	}
-	async #configure() {
-		if (!(this.#routes.length > 0 || this.#credentials !== void 0)) {
-			if (this.#fetch) {
-				await this.#frame.send("Fetch.disable");
-				this.#fetch = false;
-			}
-			return;
-		}
+	#handleResponse(params) {
+		const response = readBrowserResponse(params);
+		if (response !== void 0) this.#emitter.emit("response", response);
+	}
+	#handleFailure(params) {
+		const failure = readBrowserRequestFailure(params);
+		if (failure !== void 0) this.#emitter.emit("failure", failure);
+	}
+	#handleFinish(params) {
+		if (isString(params["requestId"])) this.#emitter.emit("finish", params["requestId"]);
+	}
+	#handlePause(params) {
+		this.#route(params).catch(() => void 0);
+	}
+	#handleAuth(params) {
+		this.#authenticate(params).catch(() => void 0);
+	}
+	#handleSocket(params) {
+		if (!isString(params["requestId"]) || !isString(params["url"])) return;
+		const socket = new BrowserWebSocket(params["requestId"], params["url"]);
+		this.#sockets.set(socket.id, socket);
+		this.#emitter.emit("socket", socket);
+	}
+	#handleSocketReceive(params) {
+		const socket = isString(params["requestId"]) ? this.#sockets.get(params["requestId"]) : void 0;
+		const frame = readBrowserWebSocketFrame(params);
+		if (socket !== void 0 && frame !== void 0) socket.receive(frame);
+	}
+	#handleSocketTransmit(params) {
+		const socket = isString(params["requestId"]) ? this.#sockets.get(params["requestId"]) : void 0;
+		const frame = readBrowserWebSocketFrame(params);
+		if (socket !== void 0 && frame !== void 0) socket.transmit(frame);
+	}
+	#handleSocketError(params) {
+		const socket = isString(params["requestId"]) ? this.#sockets.get(params["requestId"]) : void 0;
+		if (socket !== void 0 && isString(params["errorMessage"])) socket.fail(params["errorMessage"]);
+	}
+	#handleSocketClose(params) {
+		if (!isString(params["requestId"])) return;
+		const socket = this.#sockets.get(params["requestId"]);
+		if (socket === void 0) return;
+		this.#sockets.delete(params["requestId"]);
+		socket.close(isFiniteNumber(params["timestamp"]) ? params["timestamp"] : Date.now() / 1e3);
+	}
+	async #begin() {
+		try {
+			await this.#subscribe();
+			await this.#frame.send("Network.enable");
+			this.#started = true;
+			await this.#configure();
+		} catch (error) {
+			this.#started = false;
+			this.#fetch = false;
+			await this.#frame.send("Fetch.disable").catch(() => void 0);
+			await this.#frame.send("Network.disable").catch(() => void 0);
+			await this.#unsubscribe().catch(() => void 0);
+			throw error;
+		}
+	}
+	async #configure() {
+		if (!(this.#routes.length > 0 || this.#credentials !== void 0)) {
+			if (this.#fetch) {
+				await this.#frame.send("Fetch.disable");
+				this.#fetch = false;
+			}
+			return;
+		}
 		await this.#frame.send("Fetch.enable", {
 			patterns: this.#routes.map((definition) => ({
 				urlPattern: definition.query.url ?? "*",
@@ -5876,21 +5576,8 @@ var BrowserNetworkManager = class {
 var BrowserNavigationManager = class {
 	#page;
 	#waits = /* @__PURE__ */ new Map();
-	#navigateHandler = (url) => {
-		for (const [id, wait] of this.#waits) {
-			if (!matchesBrowserURL(url, wait.pattern)) continue;
-			clearTimeout(wait.timer);
-			this.#waits.delete(id);
-			wait.resolve(url);
-		}
-	};
-	#closeHandler = () => {
-		for (const [id, wait] of this.#waits) {
-			clearTimeout(wait.timer);
-			this.#waits.delete(id);
-			wait.reject(new BrowserError("Browser URL wait ended because the page closed"));
-		}
-	};
+	#navigateHandler = this.#handleNavigate.bind(this);
+	#closeHandler = this.#handleClose.bind(this);
 	constructor(page) {
 		this.#page = page;
 		this.#page.emitter.on("navigate", this.#navigateHandler);
@@ -5925,6 +5612,21 @@ var BrowserNavigationManager = class {
 			timeout
 		});
 	}
+	#handleNavigate(url) {
+		for (const [id, wait] of this.#waits) {
+			if (!matchesBrowserURL(url, wait.pattern)) continue;
+			clearTimeout(wait.timer);
+			this.#waits.delete(id);
+			wait.resolve(url);
+		}
+	}
+	#handleClose() {
+		for (const [id, wait] of this.#waits) {
+			clearTimeout(wait.timer);
+			this.#waits.delete(id);
+			wait.reject(new BrowserError("Browser URL wait ended because the page closed"));
+		}
+	}
 	#timeout(options) {
 		const timeout = options?.timeout ?? 3e4;
 		validateBrowserTimeout(timeout);
@@ -5942,9 +5644,7 @@ var BrowserScriptManager = class {
 	#scripts = /* @__PURE__ */ new Map();
 	#subscribed = false;
 	#destroyed = false;
-	#bindingHandler = (params) => {
-		this.#call(params).catch(() => void 0);
-	};
+	#bindingHandler = this.#handleBinding.bind(this);
 	constructor(frame) {
 		this.#frame = frame;
 	}
@@ -6040,11 +5740,197 @@ var BrowserScriptManager = class {
 			});
 		}
 	}
+	#handleBinding(params) {
+		this.#call(params).catch(() => void 0);
+	}
 	#assert() {
 		if (this.#destroyed) throw new BrowserError("Browser script manager is destroyed");
 	}
 };
 //#endregion
+//#region src/core/BrowserSnapshot.ts
+/** A navigable, serializable browser DOM snapshot. */
+var BrowserSnapshot = class {
+	#owners;
+	documents;
+	styles;
+	constructor(input) {
+		this.documents = Object.freeze([...input.documents]);
+		this.styles = Object.freeze([...input.styles]);
+	}
+	walk(options) {
+		return options?.order === "breadth" ? this.#breadth(options.root) : this.#depth(options?.root);
+	}
+	*descendants(node) {
+		let first = true;
+		for (const descendant of this.#depth(node)) {
+			if (first) {
+				first = false;
+				continue;
+			}
+			yield descendant;
+		}
+	}
+	document(node) {
+		return this.documents.find((document) => document.index === node.document);
+	}
+	children(node) {
+		const document = this.document(node);
+		if (document === void 0) return [];
+		const children = document.nodes.filter((candidate) => candidate.parent === node.index);
+		if (node.content === void 0) return children;
+		const content = this.documents.find((candidate) => candidate.index === node.content);
+		if (content === void 0) return children;
+		return [...children, ...content.nodes.filter((candidate) => candidate.parent === void 0)];
+	}
+	parent(node) {
+		const document = this.document(node);
+		if (document === void 0) return void 0;
+		return node.parent === void 0 ? this.#owner(node.document) : document.nodes[node.parent];
+	}
+	siblings(node, relation) {
+		const candidates = this.#candidates(node);
+		const index = candidates.findIndex((candidate) => candidate.document === node.document && candidate.index === node.index);
+		if (relation === "preceding") return index < 0 ? [] : candidates.slice(0, index);
+		if (relation === "following") return index < 0 ? [] : candidates.slice(index + 1);
+		return candidates.filter((candidate) => candidate.document !== node.document || candidate.index !== node.index);
+	}
+	ancestors(node) {
+		const ancestors = [];
+		const visited = /* @__PURE__ */ new Set();
+		let current = node;
+		while (true) {
+			const parent = this.parent(current);
+			if (parent === void 0) break;
+			const identity = this.#identity(parent);
+			if (visited.has(identity)) break;
+			visited.add(identity);
+			ancestors.push(parent);
+			current = parent;
+		}
+		return ancestors;
+	}
+	common(first, second) {
+		const firstAncestors = this.#chain(first);
+		const secondAncestors = this.#chain(second);
+		const identities = new Set(firstAncestors.map((node) => this.#identity(node)));
+		return secondAncestors.find((node) => identities.has(this.#identity(node)));
+	}
+	distance(first, second) {
+		const common = this.common(first, second);
+		if (common === void 0) return void 0;
+		const identity = this.#identity(common);
+		const firstDistance = this.#chain(first).findIndex((node) => this.#identity(node) === identity);
+		const secondDistance = this.#chain(second).findIndex((node) => this.#identity(node) === identity);
+		if (firstDistance < 0 || secondDistance < 0) return void 0;
+		return firstDistance + secondDistance;
+	}
+	find(query) {
+		for (const node of this.walk()) if (this.#match(node, query)) return node;
+	}
+	filter(query, limit) {
+		if (limit !== void 0 && (!isInteger(limit) || limit < 0)) throw new BrowserError("Browser node result limit must be a non-negative integer", void 0, { limit });
+		if (limit === 0) return [];
+		const found = [];
+		for (const node of this.walk()) {
+			if (!this.#match(node, query)) continue;
+			found.push(node);
+			if (limit !== void 0 && found.length >= limit) break;
+		}
+		return found;
+	}
+	closest(node, query) {
+		if (this.#match(node, query)) return node;
+		for (const ancestor of this.ancestors(node)) if (this.#match(ancestor, query)) return ancestor;
+	}
+	path(node) {
+		const document = this.document(node);
+		if (document === void 0) return `document:${node.document} > node:${node.index}`;
+		const chain = [...this.ancestors(node)].reverse();
+		chain.push(node);
+		const segments = [];
+		for (const current of chain) {
+			if (current.type !== 1) {
+				segments.push(`${current.name.toLowerCase()}:${current.index}`);
+				continue;
+			}
+			let ordinal = 1;
+			if (current.parent !== void 0) {
+				const owner = this.document(current);
+				for (const sibling of owner?.nodes ?? []) {
+					if (sibling.index >= current.index) break;
+					if (sibling.parent === current.parent && sibling.name === current.name) ordinal += 1;
+				}
+			}
+			segments.push(`${current.name.toLowerCase()}:${ordinal}`);
+		}
+		return `frame(${JSON.stringify(document.frame)}) > ${segments.join(" > ")}`;
+	}
+	#roots() {
+		const roots = [];
+		for (const document of this.documents) roots.push(...document.nodes.filter((node) => node.parent === void 0));
+		for (const document of this.documents) roots.push(...document.nodes);
+		return roots;
+	}
+	#owner(document) {
+		const owners = this.#owners;
+		if (owners !== void 0) return owners.get(document);
+		const index = /* @__PURE__ */ new Map();
+		for (const node of this.walk()) if (node.content !== void 0 && !index.has(node.content)) index.set(node.content, node);
+		this.#owners = index;
+		return index.get(document);
+	}
+	*#depth(root) {
+		const visited = /* @__PURE__ */ new Set();
+		for (const seed of root === void 0 ? this.#roots() : [root]) {
+			const stack = [seed];
+			while (stack.length > 0) {
+				const node = stack.pop();
+				if (node === void 0) break;
+				const identity = this.#identity(node);
+				if (visited.has(identity)) continue;
+				visited.add(identity);
+				yield node;
+				const children = this.children(node);
+				for (let index = children.length - 1; index >= 0; index -= 1) {
+					const child = children[index];
+					if (child !== void 0) stack.push(child);
+				}
+			}
+		}
+	}
+	*#breadth(root) {
+		const visited = /* @__PURE__ */ new Set();
+		for (const seed of root === void 0 ? this.#roots() : [root]) {
+			const queue = [seed];
+			let cursor = 0;
+			while (cursor < queue.length) {
+				const node = queue[cursor];
+				cursor += 1;
+				if (node === void 0) continue;
+				const identity = this.#identity(node);
+				if (visited.has(identity)) continue;
+				visited.add(identity);
+				yield node;
+				queue.push(...this.children(node));
+			}
+		}
+	}
+	#candidates(node) {
+		const parent = this.parent(node);
+		return parent === void 0 ? this.document(node)?.nodes.filter((candidate) => candidate.parent === void 0) ?? [] : this.children(parent);
+	}
+	#chain(node) {
+		return [node, ...this.ancestors(node)];
+	}
+	#match(node, query) {
+		return isBrowserNodeQuery(query) ? matchesBrowserNode(node, query) : query(node);
+	}
+	#identity(node) {
+		return `${node.document}:${node.index}`;
+	}
+};
+//#endregion
 //#region src/core/BrowserWorker.ts
 /**
 * Dedicated, shared, or service worker attached through a flattened target session.
@@ -6135,129 +6021,21 @@ var BrowserPage = class BrowserPage extends BrowserFrame {
 	#loadResolve;
 	#loadReject;
 	#responses;
-	#navigationResponseHandler = (response) => {
-		if (response.frame === this.id) this.#responses?.push(response);
-	};
-	#destroyHandler = (params) => {
-		if (!isString(params["targetId"]) || params["targetId"] !== this.#targetId) return;
-		this.#closed = true;
-		this.#release().catch(() => void 0);
-	};
-	#loadHandler = (params) => {
-		if (this.#loadEvents.includes("Page.navigatedWithinDocument")) {
-			const frame = params["frameId"];
-			if (isString(frame) && frame === this.id) {
-				this.#sameDocument = true;
-				this.#resolveLoad();
-				return;
-			}
-		}
-		if (this.#loadEvents.includes("Page.frameNavigated")) {
-			const frame = params["frame"];
-			if (isRecord(frame) && frame["id"] === this.id) this.#resolveLoad();
-			return;
-		}
-		if (this.#loadEvents.includes("Page.loadEventFired") || this.#loadEvents.includes("Page.domContentEventFired")) this.#resolveLoad();
-	};
-	#frameAttachedHandler = (params) => {
-		const frame = params["frameId"];
-		const parent = params["parentFrameId"];
-		if (!isString(frame)) return;
-		this.#emitter.emit("attach", new BrowserFrame(this.#client, (id) => this.#resolveFrameSession(id), frame, "about:blank", isString(parent) ? parent : void 0));
-	};
-	#frameNavigatedHandler = (params) => {
-		const frame = params["frame"];
-		if (!isRecord(frame) || !isString(frame["id"]) || !isString(frame["url"])) return;
-		if (frame["id"] === this.id) {
-			this.update(frame["url"]);
-			this.#emitter.emit("navigate", frame["url"]);
-		}
-	};
-	#frameDetachedHandler = (params) => {
-		const frame = params["frameId"];
-		if (!isString(frame)) return;
-		this.#frameSessions.delete(frame);
-		this.#emitter.emit("detach", frame);
-	};
-	#dialogHandler = (params) => {
-		const category = params["type"];
-		if (category !== "alert" && category !== "confirm" && category !== "prompt" && category !== "beforeunload" || !isString(params["message"])) return;
-		this.#emitter.emit("dialog", new BrowserDialog(this, category, params["message"], isString(params["defaultPrompt"]) ? params["defaultPrompt"] : ""));
-	};
-	#chooserHandler = (params) => {
-		const backend = params["backendNodeId"];
-		const mode = params["mode"];
-		if (!isInteger(backend)) return;
-		this.#emitter.emit("chooser", new BrowserFileChooser(this, backend, mode === "selectMultiple"));
-	};
-	#consoleHandler = (params) => {
-		const message = readBrowserConsoleMessage(params);
-		if (message !== void 0) this.#emitter.emit("console", message);
-	};
-	#errorHandler = (params) => {
-		const error = readBrowserPageError(params);
-		if (error !== void 0) this.#emitter.emit("error", error);
-	};
-	#crashHandler = () => this.#emitter.emit("crash");
-	#downloadHandler = (params) => {
-		const start = readBrowserDownloadStart(params);
-		if (start === void 0 || start.frame !== this.id && !this.#frameSessions.has(start.frame)) return;
-		const download = new BrowserDownload(this.#client, start.id, start.url, start.name, this.#contextId);
-		this.#downloads.set(start.id, download);
-		this.#emitter.emit("download", download);
-	};
-	#downloadProgressHandler = (params) => {
-		const decoded = readBrowserDownloadProgress(params);
-		if (decoded === void 0) return;
-		const [id, progress] = decoded;
-		const download = this.#downloads.get(id);
-		if (download === void 0) return;
-		download.update(progress);
-		if (progress.status !== "pending") this.#downloads.delete(id);
-	};
-	#attachedHandler = (params) => {
-		const target = params["targetInfo"];
-		const session = params["sessionId"];
-		if (!isRecord(target) || !isString(target["targetId"]) || !isString(session)) return;
-		const category = target["type"];
-		if (category === "worker" || category === "service_worker" || category === "shared_worker") {
-			this.#attachWorker(session, target["targetId"], isString(target["url"]) ? target["url"] : "", category);
-			return;
-		}
-		if (category === "page") {
-			this.#attachPopup(session, target["targetId"], isString(target["url"]) ? target["url"] : "about:blank");
-			return;
-		}
-		if (category !== "iframe") return;
-		const frame = target["targetId"];
-		const attempt = this.#enableFrameSession(session);
-		this.#frameSessions.set(frame, attempt);
-		this.#frameIds.set(session, frame);
-		attempt.catch(() => {
-			if (this.#frameSessions.get(frame) === attempt) this.#frameSessions.delete(frame);
-			if (this.#frameIds.get(session) === frame) this.#frameIds.delete(session);
-			this.#detachChild(session);
-		});
-	};
-	#detachedHandler = (params) => {
-		const session = params["sessionId"];
-		const target = params["targetId"];
-		if (isString(target)) {
-			const worker = this.#workers.get(target);
-			if (worker !== void 0) {
-				worker.detach();
-				this.#workers.delete(target);
-			}
-			const popup = this.#popups.get(target);
-			if (popup !== void 0) {
-				this.#popups.delete(target);
-				popup.destroy().catch(() => void 0);
-			}
-		}
-		const frame = isString(target) ? target : isString(session) ? this.#frameIds.get(session) : void 0;
-		if (frame !== void 0) this.#frameSessions.delete(frame);
-		if (isString(session)) this.#frameIds.delete(session);
-	};
+	#navigationResponseHandler = this.#handleNavigationResponse.bind(this);
+	#destroyHandler = this.#handleDestroy.bind(this);
+	#loadHandler = this.#handleLoad.bind(this);
+	#frameAttachedHandler = this.#handleFrameAttached.bind(this);
+	#frameNavigatedHandler = this.#handleFrameNavigated.bind(this);
+	#frameDetachedHandler = this.#handleFrameDetached.bind(this);
+	#dialogHandler = this.#handleDialog.bind(this);
+	#chooserHandler = this.#handleChooser.bind(this);
+	#consoleHandler = this.#handleConsole.bind(this);
+	#errorHandler = this.#handleError.bind(this);
+	#crashHandler = this.#handleCrash.bind(this);
+	#downloadHandler = this.#handleDownload.bind(this);
+	#downloadProgressHandler = this.#handleDownloadProgress.bind(this);
+	#attachedHandler = this.#handleAttached.bind(this);
+	#detachedHandler = this.#handleDetached.bind(this);
 	constructor(client, targetId, sessionId, writer, url, frameId, contextId, opener) {
 		super(client, sessionId, frameId ?? targetId, url ?? "about:blank", void 0, void 0, false);
 		this.#client = client;
@@ -6441,11 +6219,11 @@ var BrowserPage = class BrowserPage extends BrowserFrame {
 	async snapshot(options) {
 		this.assert();
 		const styles = options?.styles ?? [];
-		return decodeBrowserSnapshot(await this.request("DOMSnapshot.captureSnapshot", {
+		return new BrowserSnapshot(decodeBrowserSnapshot(await this.request("DOMSnapshot.captureSnapshot", {
 			computedStyles: [...styles],
 			includePaintOrder: options?.paint ?? false,
 			includeDOMRects: options?.rects ?? false
-		}), styles, options?.limit ?? 1e5);
+		}), styles, options?.limit ?? 1e5));
 	}
 	async codegen(options) {
 		this.assert();
@@ -6717,6 +6495,131 @@ var BrowserPage = class BrowserPage extends BrowserFrame {
 			await this.request("Page.stopLoading", void 0, timeout);
 		} catch {}
 	}
+	#handleNavigationResponse(response) {
+		if (response.frame === this.id) this.#responses?.push(response);
+	}
+	#handleDestroy(params) {
+		if (!isString(params["targetId"]) || params["targetId"] !== this.#targetId) return;
+		this.#closed = true;
+		this.#release().catch(() => void 0);
+	}
+	#handleLoad(params) {
+		if (this.#loadEvents.includes("Page.navigatedWithinDocument")) {
+			const frame = params["frameId"];
+			if (isString(frame) && frame === this.id) {
+				this.#sameDocument = true;
+				this.#resolveLoad();
+				return;
+			}
+		}
+		if (this.#loadEvents.includes("Page.frameNavigated")) {
+			const frame = params["frame"];
+			if (isRecord(frame) && frame["id"] === this.id) this.#resolveLoad();
+			return;
+		}
+		if (this.#loadEvents.includes("Page.loadEventFired") || this.#loadEvents.includes("Page.domContentEventFired")) this.#resolveLoad();
+	}
+	#handleFrameAttached(params) {
+		const frame = params["frameId"];
+		const parent = params["parentFrameId"];
+		if (!isString(frame)) return;
+		this.#emitter.emit("attach", new BrowserFrame(this.#client, (id) => this.#resolveFrameSession(id), frame, "about:blank", isString(parent) ? parent : void 0));
+	}
+	#handleFrameNavigated(params) {
+		const frame = params["frame"];
+		if (!isRecord(frame) || !isString(frame["id"]) || !isString(frame["url"])) return;
+		if (frame["id"] === this.id) {
+			this.update(frame["url"]);
+			this.#emitter.emit("navigate", frame["url"]);
+		}
+	}
+	#handleFrameDetached(params) {
+		const frame = params["frameId"];
+		if (!isString(frame)) return;
+		this.#frameSessions.delete(frame);
+		this.#emitter.emit("detach", frame);
+	}
+	#handleDialog(params) {
+		const category = params["type"];
+		if (category !== "alert" && category !== "confirm" && category !== "prompt" && category !== "beforeunload" || !isString(params["message"])) return;
+		this.#emitter.emit("dialog", new BrowserDialog(this, category, params["message"], isString(params["defaultPrompt"]) ? params["defaultPrompt"] : ""));
+	}
+	#handleChooser(params) {
+		const backend = params["backendNodeId"];
+		const mode = params["mode"];
+		if (!isInteger(backend)) return;
+		this.#emitter.emit("chooser", new BrowserFileChooser(this, backend, mode === "selectMultiple"));
+	}
+	#handleConsole(params) {
+		const message = readBrowserConsoleMessage(params);
+		if (message !== void 0) this.#emitter.emit("console", message);
+	}
+	#handleError(params) {
+		const error = readBrowserPageError(params);
+		if (error !== void 0) this.#emitter.emit("error", error);
+	}
+	#handleCrash() {
+		this.#emitter.emit("crash");
+	}
+	#handleDownload(params) {
+		const start = readBrowserDownloadStart(params);
+		if (start === void 0 || start.frame !== this.id && !this.#frameSessions.has(start.frame)) return;
+		const download = new BrowserDownload(this.#client, start.id, start.url, start.name, this.#contextId);
+		this.#downloads.set(start.id, download);
+		this.#emitter.emit("download", download);
+	}
+	#handleDownloadProgress(params) {
+		const decoded = readBrowserDownloadProgress(params);
+		if (decoded === void 0) return;
+		const [id, progress] = decoded;
+		const download = this.#downloads.get(id);
+		if (download === void 0) return;
+		download.update(progress);
+		if (progress.status !== "pending") this.#downloads.delete(id);
+	}
+	#handleAttached(params) {
+		const target = params["targetInfo"];
+		const session = params["sessionId"];
+		if (!isRecord(target) || !isString(target["targetId"]) || !isString(session)) return;
+		const category = target["type"];
+		if (category === "worker" || category === "service_worker" || category === "shared_worker") {
+			this.#attachWorker(session, target["targetId"], isString(target["url"]) ? target["url"] : "", category);
+			return;
+		}
+		if (category === "page") {
+			this.#attachPopup(session, target["targetId"], isString(target["url"]) ? target["url"] : "about:blank");
+			return;
+		}
+		if (category !== "iframe") return;
+		const frame = target["targetId"];
+		const attempt = this.#enableFrameSession(session);
+		this.#frameSessions.set(frame, attempt);
+		this.#frameIds.set(session, frame);
+		attempt.catch(() => {
+			if (this.#frameSessions.get(frame) === attempt) this.#frameSessions.delete(frame);
+			if (this.#frameIds.get(session) === frame) this.#frameIds.delete(session);
+			this.#detachChild(session);
+		});
+	}
+	#handleDetached(params) {
+		const session = params["sessionId"];
+		const target = params["targetId"];
+		if (isString(target)) {
+			const worker = this.#workers.get(target);
+			if (worker !== void 0) {
+				worker.detach();
+				this.#workers.delete(target);
+			}
+			const popup = this.#popups.get(target);
+			if (popup !== void 0) {
+				this.#popups.delete(target);
+				popup.destroy().catch(() => void 0);
+			}
+		}
+		const frame = isString(target) ? target : isString(session) ? this.#frameIds.get(session) : void 0;
+		if (frame !== void 0) this.#frameSessions.delete(frame);
+		if (isString(session)) this.#frameIds.delete(session);
+	}
 	#waitForLoadEvent(condition, timeout) {
 		const eventName = condition === "commit" ? "Page.frameNavigated" : condition === "domcontentloaded" ? "Page.domContentEventFired" : "Page.loadEventFired";
 		const deferred = Promise.withResolvers();
@@ -6818,8 +6721,8 @@ var BrowserStorageManager = class {
 				expires: cookie.expires,
 				http: cookie.http,
 				secure: cookie.secure,
-				site: cookie.site,
-				partition: cookie.partition
+				...cookie.site !== void 0 ? { site: cookie.site } : {},
+				...cookie.partition !== void 0 ? { partition: cookie.partition } : {}
 			})),
 			origins: storage
 		};
@@ -6967,7 +6870,7 @@ var BrowserContext = class {
 		try {
 			const viewport = options?.viewport ?? this.#viewport;
 			page = await this.#attach(targetId, options?.url ?? "about:blank", viewport);
-			if (options?.url !== void 0 && options.url !== "about:blank") await page.navigate(options.url, { timeout: options.timeout });
+			if (options?.url !== void 0 && options.url !== "about:blank") await page.navigate(options.url, { ...options.timeout !== void 0 ? { timeout: options.timeout } : {} });
 			if (this.#closed) throw new BrowserError("Browser context closed during page creation");
 			this.#pages.set(targetId, page);
 			this.#emitter.emit("page", page);
@@ -7203,7 +7106,24 @@ var BrowserContext = class {
 function createCDPClient(options) {
 	return new CDPClient(options);
 }
+/**
+* Create a navigable browser snapshot from decoded serializable data.
+*
+* @param input - Captured documents and computed-style names
+* @returns A {@link BrowserSnapshotInterface}
+*
+* @example
+* ```ts
+* import { createBrowserSnapshot, decodeBrowserSnapshot } from '@src/core'
+*
+* const snapshot = createBrowserSnapshot(decodeBrowserSnapshot(captured, ['display']))
+* snapshot.find({ name: 'main' })
+* ```
+*/
+function createBrowserSnapshot(input) {
+	return new BrowserSnapshot(input);
+}
 //#endregion
-export { BASE64_CHARS, BASE64_LOOKUP, BROWSER_CODEGEN_BINDING_NAME, BROWSER_CODEGEN_SOURCE, BROWSER_DEFAULT_TIMEOUT_MS, BROWSER_DEFAULT_VIEWPORT_HEIGHT, BROWSER_DEFAULT_VIEWPORT_WIDTH, BROWSER_FRAME_WORLD_NAME, BROWSER_HAR_CREATOR, BROWSER_KEY_MODIFIERS, BROWSER_MOUSE_BUTTON_MASKS, BROWSER_RESULT_LIMIT, BROWSER_RESULT_LIMIT_PATTERN, BROWSER_RESULT_LIMIT_SENTINEL_PREFIX, BROWSER_SCREENSHOT_ATTRIBUTE, BROWSER_SNAPSHOT_NODE_LIMIT, BROWSER_STABLE_FRAME_COUNT, BROWSER_STOP_LOADING_TIMEOUT_MS, BROWSER_TEST_ID_ATTRIBUTE, BROWSER_WAIT_POLL_INTERVAL_MS, BrowserAccessibility, BrowserClock, BrowserCodegen, BrowserContext, BrowserCookieManager, BrowserCoverage, BrowserDiagnostics, BrowserDialog, BrowserDownload, BrowserEmulationManager, BrowserError, BrowserFileChooser, BrowserFrame, BrowserHARManager, BrowserHandle, BrowserKeyboard, BrowserLocator, BrowserMouse, BrowserNavigationManager, BrowserNetworkManager, BrowserPage, BrowserPerformance, BrowserPermissionManager, BrowserResultLimitError, BrowserRoute, BrowserScriptManager, BrowserSelectorError, BrowserSelectorManager, BrowserStorageManager, BrowserTouch, BrowserTracing, BrowserWebSocket, BrowserWorker, CDPClient, CDPConnectionError, CDPError, CDPTimeoutError, ancestorsOfBrowserNode, attributeOfBrowserNode, browserHARHeadersToRecord, browserHeadersToProtocol, browserPDFToParams, browserScreenshotToParams, bytesToText, childrenOfBrowserNode, closestBrowserNode, commonAncestorOfBrowserNodes, compileActionabilityFunction, compileAttachedLocatorWaitExpression, compileAttachedWaitExpression, compileBrowserBindingCleanup, compileBrowserBindingResult, compileBrowserBindingSource, compileClickExpression, compileCodegenScript, compileDetachedLocatorWaitExpression, compileDetachedWaitExpression, compileFillExpression, compileFunctionWaitExpression, compileHiddenLocatorWaitExpression, compileHiddenWaitExpression, compileLocatorExpression, compileLocatorListExpression, compileScreenshotCleanupExpression, compileScreenshotPreparationExpression, compileSelectExpression, compileStorageClearExpression, compileStorageReadExpression, compileStorageRestoreExpression, compileVisibleLocatorWaitExpression, compileVisibleWaitExpression, computeBrowserButtons, computeBrowserModifiers, computeBrowserNodeDistance, concatBytes, cookieToProtocol, createBrowserHAREntry, createCDPClient, decodeBase64, decodeBrowserAttributes, decodeBrowserSnapshot, decodeRareBooleanData, decodeRareIntegerData, decodeRareStringData, descendantsOfBrowserNode, documentOfBrowserNode, encodeBase64, findBrowserDescendant, findBrowserNode, findBrowserNodes, followingSiblingsOfBrowserNode, guardEvaluateExpression, isBrowserError, isBrowserNodeDescendant, isBrowserNodeVisible, isBrowserResultLimitError, isBrowserSelectorError, isCDPConnectionError, isCDPError, isCDPTimeoutError, keyToBrowserInput, matchesBrowserCookieURL, matchesBrowserNode, matchesBrowserRoute, matchesBrowserURL, mediaToFeatures, nodeToPath, normalizeCodegenActions, parentOfBrowserNode, parseBrowserChord, parseCodegenActionPayload, precedingSiblingsOfBrowserNode, readBrowserAXString, readBrowserAXValue, readBrowserAccessibility, readBrowserBindingCall, readBrowserConsoleMessage, readBrowserCookie, readBrowserCookiePartition, readBrowserCookies, readBrowserCoverageRanges, readBrowserDownloadProgress, readBrowserDownloadStart, readBrowserFrames, readBrowserHeaders, readBrowserMetrics, readBrowserPageError, readBrowserProfile, readBrowserProfileFrame, readBrowserQuad, readBrowserRect, readBrowserRemoteValue, readBrowserRequest, readBrowserRequestFailure, readBrowserResponse, readBrowserResponseRecord, readBrowserScriptCoverage, readBrowserScriptIdentifier, readBrowserSecurity, readBrowserStack, readBrowserStorageEntries, readBrowserStorageOrigin, readBrowserStreamChunk, readBrowserStyleCoverage, readBrowserTiming, readBrowserTimingRange, readBrowserWebSocketFrame, readCodegenNavigateAction, readEvaluationResult, readNumberArray, readSnapshotString, requireBrowserString, siblingsOfBrowserNode, textToBytes, validateBrowserAccessibilityOptions, validateBrowserActionOptions, validateBrowserContextOptions, validateBrowserEmulationOptions, validateBrowserHAR, validateBrowserPoint, validateBrowserRange, validateBrowserTimeout, validateBrowserViewport, walkBrowserNode, walkBrowserNodeBreadthFirst, walkBrowserSnapshot, walkBrowserSnapshotBreadthFirst };
+export { BASE64_CHARS, BASE64_LOOKUP, BROWSER_CODEGEN_BINDING_NAME, BROWSER_CODEGEN_SOURCE, BROWSER_DEFAULT_TIMEOUT_MS, BROWSER_DEFAULT_VIEWPORT_HEIGHT, BROWSER_DEFAULT_VIEWPORT_WIDTH, BROWSER_FRAME_WORLD_NAME, BROWSER_HAR_CREATOR, BROWSER_KEY_MODIFIERS, BROWSER_MOUSE_BUTTON_MASKS, BROWSER_RESULT_LIMIT, BROWSER_RESULT_LIMIT_PATTERN, BROWSER_RESULT_LIMIT_SENTINEL_PREFIX, BROWSER_SCREENSHOT_ATTRIBUTE, BROWSER_SNAPSHOT_NODE_LIMIT, BROWSER_STABLE_FRAME_COUNT, BROWSER_STOP_LOADING_TIMEOUT_MS, BROWSER_TEST_ID_ATTRIBUTE, BROWSER_WAIT_POLL_INTERVAL_MS, BrowserAccessibility, BrowserClock, BrowserCodegen, BrowserContext, BrowserCookieManager, BrowserCoverage, BrowserDiagnostics, BrowserDialog, BrowserDownload, BrowserEmulationManager, BrowserError, BrowserFileChooser, BrowserFrame, BrowserHARManager, BrowserHandle, BrowserKeyboard, BrowserLocator, BrowserMouse, BrowserNavigationManager, BrowserNetworkManager, BrowserPage, BrowserPerformance, BrowserPermissionManager, BrowserResultLimitError, BrowserRoute, BrowserScriptManager, BrowserSelectorError, BrowserSelectorManager, BrowserSnapshot, BrowserStorageManager, BrowserTouch, BrowserTracing, BrowserWebSocket, BrowserWorker, CDPClient, CDPConnectionError, CDPError, CDPTimeoutError, attributeOfBrowserNode, browserHARHeadersToRecord, browserHeadersToProtocol, browserPDFToParams, browserScreenshotToParams, bytesToText, compileActionabilityFunction, compileAttachedLocatorWaitExpression, compileAttachedWaitExpression, compileBrowserBindingCleanup, compileBrowserBindingResult, compileBrowserBindingSource, compileClickExpression, compileCodegenScript, compileDetachedLocatorWaitExpression, compileDetachedWaitExpression, compileFillExpression, compileFunctionWaitExpression, compileHiddenLocatorWaitExpression, compileHiddenWaitExpression, compileLocatorExpression, compileLocatorListExpression, compileScreenshotCleanupExpression, compileScreenshotPreparationExpression, compileSelectExpression, compileStorageClearExpression, compileStorageReadExpression, compileStorageRestoreExpression, compileVisibleLocatorWaitExpression, compileVisibleWaitExpression, computeBrowserButtons, computeBrowserModifiers, concatBytes, cookieToProtocol, createBrowserHAREntry, createBrowserSnapshot, createCDPClient, decodeBase64, decodeBrowserAttributes, decodeBrowserSnapshot, decodeRareBooleanData, decodeRareIntegerData, decodeRareStringData, encodeBase64, guardEvaluateExpression, isBrowserError, isBrowserNodeQuery, isBrowserNodeVisible, isBrowserResultLimitError, isBrowserSelectorError, isCDPConnectionError, isCDPError, isCDPTimeoutError, keyToBrowserInput, matchesBrowserCookieURL, matchesBrowserNode, matchesBrowserRoute, matchesBrowserURL, mediaToFeatures, normalizeCodegenActions, parseBrowserChord, parseCodegenActionPayload, readBrowserAXString, readBrowserAXValue, readBrowserAccessibility, readBrowserBindingCall, readBrowserConsoleMessage, readBrowserCookie, readBrowserCookiePartition, readBrowserCookies, readBrowserCoverageRanges, readBrowserDownloadProgress, readBrowserDownloadStart, readBrowserFrames, readBrowserHeaders, readBrowserMetrics, readBrowserPageError, readBrowserProfile, readBrowserProfileFrame, readBrowserQuad, readBrowserRect, readBrowserRemoteValue, readBrowserRequest, readBrowserRequestFailure, readBrowserResponse, readBrowserResponseRecord, readBrowserScriptCoverage, readBrowserScriptIdentifier, readBrowserSecurity, readBrowserStack, readBrowserStorageEntries, readBrowserStorageOrigin, readBrowserStreamChunk, readBrowserStyleCoverage, readBrowserTiming, readBrowserTimingRange, readBrowserWebSocketFrame, readCodegenNavigateAction, readEvaluationResult, readNumberArray, readSnapshotString, requireBrowserString, textToBytes, validateBrowserAccessibilityOptions, validateBrowserActionOptions, validateBrowserContextOptions, validateBrowserEmulationOptions, validateBrowserHAR, validateBrowserPoint, validateBrowserRange, validateBrowserTimeout, validateBrowserViewport };
 
 //# sourceMappingURL=index.js.map