effect-browser 0.3.0-beta.16 → 0.3.0-beta.19

package/dist/{page-ClEMFnBG.mjs → page-BKwfF6z-.mjs}

@@ -1,15 +1,16 @@
 import { Plan, Point } from "./Motion.mjs";
-import { Action, Box, CursorChanged, KeyChanged, Navigated, PageLoaded, PointerPressed, PointerReleased, Subject, SubjectContext, TextInserted, TrackEvent, TrackPerformed, TrackPlanned, WheelScrolled } from "./BrowserEvent.mjs";
+import { Action, Box, CursorChanged, KeyChanged, Navigated, PageLoaded, PointerPressed, PointerReleased, Subject, TextInserted, TrackEvent, TrackPerformed, TrackPlanned, WheelScrolled } from "./BrowserEvent.mjs";
 import { BrowserError, Failed, InvalidRequest, NavigationFailed, NotActionable, NotFound, PolicyTimeout, StaleRef, Timeout } from "./BrowserError.mjs";
-import { a as make$20, c as estimate, d as toBrowserSeconds, f as toHostTime, h as make$19, i as failWith, m as Current, n as contextGone, o as reasonOf, p as uncertaintyAt, r as decodeWith, s as undispatched, u as monotonicMillis } from "./context-rYTk-3Cv.mjs";
+import { a as make$20, c as undispatched, d as monotonicMillis, f as toBrowserSeconds, g as make$19, h as Current, i as failWith, l as estimate, m as uncertaintyAt, n as contextGone, o as reasonOf, p as toHostTime, r as decodeWith, s as refuse } from "./context-w3NJPRLo.mjs";
 import { i as redact, n as parse, s as Correlation, t as addresses } from "./url-Cd04Okid.mjs";
 import { BrowserPaint, CaptureStats, Frame, Image, Screenshot } from "./Frame.mjs";
-import { _ as evidence, c as State, g as guard, h as ValidatedInputResultSchema, i as InputRequest, l as Text, m as PreparedInputResultSchema, o as Region, p as redacted, r as Found, s as ResolvedTarget, u as Zoom } from "./Page-C_VkBVwI.mjs";
+import { _ as evidence, c as State, g as guard, h as ValidatedInputResultSchema, i as InputRequest, l as Text, m as PreparedInputResultSchema, o as Region, p as redacted, r as Found, s as ResolvedTarget, u as Zoom } from "./Page-CfB6Zn1p.mjs";
 import { Snapshot } from "./Snapshot.mjs";
 import { t as match } from "./match.inpage-xOe9LNO0.mjs";
 import { r as Changes, t as Change } from "./Change-DNvztNLu.mjs";
 import { Window } from "./Moment.mjs";
 import { Cause, Clock, Deferred, Duration, Effect, Exit, Fiber, MutableRef, Option, Queue, Random, Ref, Result, Schedule, Schema, Scope, Semaphore, Stream, SynchronizedRef } from "effect";
+import { jpegjs } from "playwright-core/lib/utilsBundle";
 //#region src/internal/input/edit.inpage.ts
 /**
 * In the page: editing a field. It refuses text that a focused control could act on, focuses a
@@ -17,7 +18,7 @@ import { Cause, Clock, Deferred, Duration, Effect, Exit, Fiber, MutableRef, Opti
 * may use.
 */
 const edit = (names, guard, placing) => {
-	const { activeElement, clean, describe, isDisabled, isHtml, isInput, isSecret, isSelect, isTextArea, lookup, nameOf, roleOf } = names;
+	const { activeElement, clean, describe, inCurrentDocument, isDisabled, isHtml, isInput, isSecret, isSelect, isTextArea, lookup, nameOf, roleOf } = names;
 	const { textEntry, typingRefusal } = guard;
 	/** Whether text may be typed into a ref or focus, and, for a `secret`, only into a secret field. */
 	const typeable = (ref, secret) => {
@@ -48,8 +49,21 @@ const edit = (names, guard, placing) => {
 			}
 		};
 	};
-	const focus = (ref, replace) => {
-		const element = lookup(ref);
+	/**
+	* The focused field, when it is a text field named `name`: one a page put in place of a field
+	* just pressed and gave focus to, as a typeahead does.
+	*/
+	const replacement = (name) => {
+		const active = activeElement();
+		return active !== null && textEntry(active) && inCurrentDocument(active) && nameOf(active, roleOf(active)) === name ? active : void 0;
+	};
+	/**
+	* Focus a field to type into. `follow` is the field's name when the action pressed it first: a
+	* page may answer the press with another field of that name in its place, focused, and the keys
+	* follow focus there, as a person's would.
+	*/
+	const focus = (ref, replace, follow) => {
+		const element = lookup(ref) ?? (follow === null ? void 0 : replacement(follow));
 		if (element === void 0) return {
 			error: `${ref} is not on the page any more`,
 			stale: true
@@ -334,11 +348,8 @@ const targets = (names, walked, placing) => {
 };
 const ResolvedPointSchema = Schema.Struct({
 	...Point.fields,
+	...Subject.fields,
 	element: Schema.String,
-	tag: Schema.String,
-	role: Schema.NullOr(Schema.String),
-	name: Schema.String,
-	context: SubjectContext,
 	box: Schema.optional(Box),
 	cursor: Schema.String,
 	href: Schema.optional(Schema.String)
@@ -2074,7 +2085,7 @@ const sight = (names, walked, texts, kept) => {
 */
 const install = (makeNames, makeWalk, makeMatch, makeContext, makeSubjects, makeExpectations, makeText, makeControls, makeFold, makeHistory, makeSight, makeMarks, makeRecord, makeChanges, makeReady, makeOutline, makeTargets, makeEvidence, makeGuard, makeEdit, makeAddresses) => {
 	const installed = globalThis.__effectBrowser;
-	if (installed !== void 0 && installed.version === 19) return installed;
+	if (installed !== void 0 && installed.version === 20) return installed;
 	const named = makeNames();
 	const walked = makeWalk(named);
 	const placing = makeContext(named, walked);
@@ -2091,7 +2102,7 @@ const install = (makeNames, makeWalk, makeMatch, makeContext, makeSubjects, make
 	const edited = makeEdit(named, guarded, placing);
 	const readiness = makeReady(walked, texts, kept, recorder);
 	const api = {
-		version: 19,
+		version: 20,
 		snapshot: read.snapshot,
 		find: subjected.find,
 		until: makeExpectations(named, subjected).until,
@@ -2298,6 +2309,20 @@ const make$18 = Effect.fnUntraced(function* (page) {
 * protocol session, stamped with the browser's clock when its run has a mapping, and is published
 * as it is submitted.
 */
+const buttonMask = {
+	none: 0,
+	left: 1,
+	right: 2,
+	middle: 4
+};
+/** A mouse button going down or up at a point, as the `clickCount`th click. */
+const buttonAt = (type, point, button = "left", clickCount = 1) => ({
+	type,
+	...point,
+	button,
+	buttons: type === "mousePressed" ? buttonMask[button] : 0,
+	clickCount
+});
 const make$17 = (page) => {
 	const { id, pointer, publish, now, noteInput, closedBy } = page;
 	const { send } = page.protocol;
@@ -2341,16 +2366,10 @@ const make$17 = (page) => {
 		if (event.type === "mouseReleased") return yield* run.up(held);
 		if (event.type === "mousePressed") {
 			yield* run.reserve(2);
-			yield* run.down(held, () => dispatchMouse(event, estimate, submitted), () => dispatchMouse({
-				type: "mouseReleased",
-				...Option.getOrElse(MutableRef.get(pointer), () => ({
-					x: event.x,
-					y: event.y
-				})),
-				button: event.button ?? "left",
-				buttons: 0,
-				clickCount: event.clickCount ?? 1
-			}, estimate));
+			yield* run.down(held, () => dispatchMouse(event, estimate, submitted), () => dispatchMouse(buttonAt("mouseReleased", Option.getOrElse(MutableRef.get(pointer), () => ({
+				x: event.x,
+				y: event.y
+			})), event.button, event.clickCount), estimate));
 		} else {
 			yield* run.reserve(1);
 			yield* run.send(() => dispatchMouse(event, estimate, submitted));
@@ -2411,8 +2430,8 @@ const make$16 = (page, bridge) => {
 	const { current, evaluateIn, evaluateWithContext } = bridge;
 	const preparePolicy = (action, info, targets, flags = {}) => Effect.gen(function* () {
 		for (const target of targets) {
-			if (typeof target === "string" && !/^e\d+$/.test(target)) return yield* failWith(action, new InvalidRequest({ detail: `"${target}" is not a ref; refs look like e12` }));
-			if (target !== null && typeof target !== "string" && (!Number.isFinite(target.x) || !Number.isFinite(target.y))) return yield* failWith(action, new InvalidRequest({ detail: "point coordinates must be finite" }));
+			if (typeof target === "string" && !/^e\d+$/.test(target)) return yield* refuse(action, `"${target}" is not a ref; refs look like e12`);
+			if (target !== null && typeof target !== "string" && (!Number.isFinite(target.x) || !Number.isFinite(target.y))) return yield* refuse(action, "point coordinates must be finite");
 		}
 		const input = {
 			action,
@@ -2878,10 +2897,7 @@ const admission = (page, pending, name) => {
 	};
 };
 /** Close a run on every exit while preserving its native replies for the page's next input. */
-const useRun = (page, sender, name, run, action) => action.pipe(Effect.matchEffect({
-	onFailure: (error) => run.close.pipe(Effect.andThen(sender.flush(name, run).pipe(Effect.ignore)), Effect.andThen(Effect.fail(error))),
-	onSuccess: (value) => run.close.pipe(Effect.andThen(sender.flush(name, run)), Effect.as(value))
-}), Effect.ensuring(run.close.pipe(Effect.andThen(page.openings.clear))), Effect.provideService(Current, run));
+const useRun = (page, sender, name, run, action, canStop) => action.pipe(Effect.tapError(() => run.close.pipe(Effect.andThen(sender.flush(name, run)), Effect.ignore)), Effect.tap(() => run.close.pipe(Effect.andThen(sender.flush(name, run)))), Effect.ensuring(run.close.pipe(Effect.andThen(page.openings.clear))), Effect.onError(() => run.recover(page.stopLoading, page.scope).pipe(Effect.when(canStop))), Effect.provideService(Current, run));
 const make$14 = (page, sender) => {
 	const { id, settings, mapping, lane, publish, now, noteInput, span, owned } = page;
 	const { inputClocks } = sender;
@@ -2916,7 +2932,7 @@ const make$14 = (page, sender) => {
 		const useInput = (action) => input.begin.pipe(Effect.tap((current) => Effect.sync(() => {
 			ticket.using(current);
 			if (estimate !== void 0) inputClocks.set(current, estimate);
-		})), Effect.flatMap((run) => useRun(page, sender, name, run, action(run))));
+		})), Effect.flatMap((run) => useRun(page, sender, name, run, action(run), info.input === false ? Effect.succeed(false) : Ref.get(sent))));
 		let queuedMillis;
 		const dispatch = (action) => Effect.suspend(() => {
 			const asked = now();
@@ -3017,7 +3033,7 @@ const make$13 = (page, dispatch, viewport) => {
 			y: Math.max(0, Math.min(size.height - 1, previous.y))
 		};
 		const planned = yield* style.glide(from, to, dragging);
-		const invalid = failWith(operation, new InvalidRequest({ detail: "motion must be a bounded, ordered schedule ending at the target" }));
+		const invalid = refuse(operation, "motion must be a bounded, ordered schedule ending at the target");
 		const samples = yield* Schema.decodeEffect(Plan)(planned).pipe(Effect.catch(() => invalid));
 		if (samples.at(-1)?.x !== to.x || samples.at(-1)?.y !== to.y) return yield* invalid;
 		yield* Effect.annotateCurrentSpan("samples", samples.length);
@@ -3114,12 +3130,12 @@ const make$12 = (page, bridge) => {
 	});
 	/** Wait for the page to settle after input sent since `before`. */
 	const settle = (operation, before) => Effect.gen(function* () {
-		yield* bridge.evaluate(operation, scriptCall("settle")).pipe(Effect.provideService(Current, void 0), Effect.catchIf(contextGone, () => Effect.void), Effect.onError(() => page.stopLoading));
+		yield* bridge.evaluate(operation, scriptCall("settle")).pipe(Effect.provideService(Current, void 0), Effect.catchIf(contextGone, () => Effect.void));
 		while (document() > before.document && parsed < document()) yield* Deferred.await(changed);
 	}).pipe(Effect.timeoutOrElse({
 		duration: settling,
 		orElse: () => Effect.fail("unsettled")
-	}), Effect.catch(() => Effect.annotateCurrentSpan("settled", false)), Effect.andThen(page.openings.settle(before.openings)), page.span("Page.settle", {}, "Debug"));
+	}), Effect.catch(() => page.stopLoading.pipe(Effect.andThen(Effect.annotateCurrentSpan("settled", false)))), Effect.andThen(page.openings.settle(before.openings)), page.span("Page.settle", {}, "Debug"));
 	return {
 		mark,
 		settle
@@ -3133,19 +3149,13 @@ const make$12 = (page, bridge) => {
 * viewers watch.
 */
 const pointFailure = (operation, target, result) => failWith(operation, result.error === "stale" && typeof target === "string" ? new StaleRef({ ref: target }) : result.error === "outside" ? new InvalidRequest({ detail: result.detail }) : new NotActionable({ detail: result.detail }));
-const resolvedTarget = (result) => new ResolvedTarget({
+const resolvedTarget = ({ x, y, box, ...target }) => new ResolvedTarget({
 	point: {
-		x: result.x,
-		y: result.y
+		x,
+		y
 	},
-	element: result.element,
-	tag: result.tag,
-	role: result.role,
-	name: result.name,
-	context: result.context,
-	box: result.box,
-	cursor: result.cursor,
-	...result.href === void 0 ? {} : { href: result.href }
+	box,
+	...target
 });
 const make$11 = (viewport, guard, pointer, dispatch, settling) => {
 	const { evaluate, mutate } = guard;
@@ -3153,8 +3163,8 @@ const make$11 = (viewport, guard, pointer, dispatch, settling) => {
 	const { flush } = dispatch;
 	const readPoint = (operation, target, approval, scroll) => evaluate(operation, scriptCall("point", target, scroll), approval).pipe(Effect.flatMap(decodeWith(operation, PointResultSchema)));
 	const resolve = (operation, target, approval, scroll = true) => {
-		if (typeof target === "string" && !/^e\d+$/.test(target)) return failWith(operation, new InvalidRequest({ detail: target + " is not a ref; refs look like e12" }));
-		if (typeof target !== "string" && (!Number.isFinite(target.x) || !Number.isFinite(target.y))) return failWith(operation, new InvalidRequest({ detail: "point coordinates must be finite" }));
+		if (typeof target === "string" && !/^e\d+$/.test(target)) return refuse(operation, target + " is not a ref; refs look like e12");
+		if (typeof target !== "string" && (!Number.isFinite(target.x) || !Number.isFinite(target.y))) return refuse(operation, "point coordinates must be finite");
 		return readPoint(operation, target, approval, scroll).pipe(Effect.flatMap((result) => "error" in result ? pointFailure(operation, target, result) : Effect.succeed(resolvedTarget(result))));
 	};
 	return {
@@ -3197,12 +3207,6 @@ const make$11 = (viewport, guard, pointer, dispatch, settling) => {
 * `perform`, which admits it, puts it to the input guard and records it. A click, a key or a scroll
 * then waits for the page to settle: a task and a frame, and a document if the input asked for one.
 */
-const buttonMask = {
-	none: 0,
-	left: 1,
-	right: 2,
-	middle: 4
-};
 const partsOf = (page, bridge, viewport) => {
 	const dispatch = make$17(page);
 	const pointer = make$13(page, dispatch, viewport);
@@ -3224,13 +3228,15 @@ const partsOf = (page, bridge, viewport) => {
 /** Whether every number given is finite; a number left out is. */
 const finite = (...values) => values.every((value) => value === void 0 || Number.isFinite(value));
 const named = (target) => typeof target === "string" ? target : `${target.x},${target.y}`;
+/** The ref a target names, if it names one rather than a point. */
+const refOf = (target) => typeof target === "string" ? target : void 0;
 /** A click's options, once its counts are finite. */
-const clickable = (options) => finite(options.clickCount, options.holdMillis) ? Effect.void : failWith("click", new InvalidRequest({ detail: "clickCount and holdMillis must be finite" }));
+const clickable = (options) => finite(options.clickCount, options.holdMillis) ? Effect.void : refuse("click", "clickCount and holdMillis must be finite");
 /** The keys a press sends, once they and its options are valid. */
 const pressed = (keys, options) => {
 	const parts$1 = parts(keys);
-	if (!finite(options.times, options.holdMillis)) return failWith("press", new InvalidRequest({ detail: "times and holdMillis must be finite" }));
-	if (parts$1 === void 0) return failWith("press", new InvalidRequest({ detail: `"${keys}" is not a key; try Enter, Space, ArrowLeft or Control+A` }));
+	if (!finite(options.times, options.holdMillis)) return refuse("press", "times and holdMillis must be finite");
+	if (parts$1 === void 0) return refuse("press", `"${keys}" is not a key; try Enter, Space, ArrowLeft or Control+A`);
 	return Effect.succeed(parts$1);
 };
 const click = (input) => {
@@ -3243,7 +3249,7 @@ const click = (input) => {
 			clickCount: clickOptions.clickCount,
 			holdMillis: clickOptions.holdMillis
 		}
-	}, settings.actionTimeout, Effect.suspend(() => clickable(clickOptions)).pipe(Effect.andThen(preparePolicy("click", { target: typeof target === "string" ? target : void 0 }, [target]))), (marks, approval) => Effect.gen(function* () {
+	}, settings.actionTimeout, Effect.suspend(() => clickable(clickOptions)).pipe(Effect.andThen(preparePolicy("click", { target: refOf(target) }, [target]))), (marks, approval) => Effect.gen(function* () {
 		yield* clickable(clickOptions);
 		const resolved = yield* targetFor("click", target, approval, marks);
 		const { point } = resolved;
@@ -3263,23 +3269,11 @@ const click = (input) => {
 				index: 0,
 				...point
 			}] }, flush("click", marks.input)).pipe(Effect.catchIf((error) => error.reason._tag === "StaleRef", () => failWith("click", new NotActionable({ detail: "an earlier click removed the approved target, so no further press was sent" }))));
-			yield* sendMouse("click", marks.input, {
-				type: "mousePressed",
-				...point,
-				button,
-				buttons: buttonMask[button],
-				clickCount: index
-			});
+			yield* sendMouse("click", marks.input, buttonAt("mousePressed", point, button, index));
 			const hold = clickOptions.holdMillis ?? (yield* marks.style.hold);
 			if (clickOptions.holdMillis === void 0) yield* marks.present(hold);
 			if (hold > 0) yield* Effect.sleep(Duration.millis(hold));
-			yield* sendMouse("click", marks.input, {
-				type: "mouseReleased",
-				...point,
-				button,
-				buttons: 0,
-				clickCount: index
-			});
+			yield* sendMouse("click", marks.input, buttonAt("mouseReleased", point, button, index));
 		}
 		yield* flush("click", marks.input);
 		yield* settle("click", before);
@@ -3289,7 +3283,7 @@ const click = (input) => {
 const hover = (input) => {
 	const { settings } = input.page;
 	const { perform, preparePolicy, targetFor, moveTo, flush } = input;
-	return (target, style = plain) => perform("hover", { target: named(target) }, settings.actionTimeout, preparePolicy("hover", { target: typeof target === "string" ? target : void 0 }, [target]), (marks, approval) => Effect.gen(function* () {
+	return (target, style = plain) => perform("hover", { target: named(target) }, settings.actionTimeout, preparePolicy("hover", { target: refOf(target) }, [target]), (marks, approval) => Effect.gen(function* () {
 		const resolved = yield* targetFor("hover", target, approval, marks);
 		const { point } = resolved;
 		yield* marks.at(point);
@@ -3329,21 +3323,9 @@ const drag = (input) => {
 			...end.point
 		}] });
 		yield* marks.sent;
-		yield* sendMouse("drag", marks.input, {
-			type: "mousePressed",
-			...start.point,
-			button: "left",
-			buttons: 1,
-			clickCount: 1
-		});
+		yield* sendMouse("drag", marks.input, buttonAt("mousePressed", start.point));
 		yield* moveTo("drag", marks, end.point, end.cursor, "drag");
-		yield* sendMouse("drag", marks.input, {
-			type: "mouseReleased",
-			...end.point,
-			button: "left",
-			buttons: 0,
-			clickCount: 1
-		});
+		yield* sendMouse("drag", marks.input, buttonAt("mouseReleased", end.point));
 		yield* flush("drag", marks.input);
 	}), style);
 };
@@ -3365,7 +3347,7 @@ const typeText = (input) => {
 	}, [typeOptions.into ?? null], { submit: typeOptions.submit ?? false }), (marks, approval) => Effect.gen(function* () {
 		const replace = typeOptions.replace ?? true;
 		const into = typeOptions.into;
-		if (into !== void 0 && !/^e\d+$/.test(into)) return yield* failWith("type", new InvalidRequest({ detail: `"${into}" is not a ref; refs look like e12` }));
+		if (into !== void 0 && !/^e\d+$/.test(into)) return yield* refuse("type", `"${into}" is not a ref; refs look like e12`);
 		const asked = scriptCall("typeable", into ?? null, typeOptions.secret === true);
 		const typeable = yield* evaluate("type", asked, approval).pipe(Effect.flatMap(decodeWith("type", TypeableResultSchema)));
 		if ("error" in typeable) return yield* failWith("type", typeable.error === "stale" && into !== void 0 ? new StaleRef({ ref: into }) : new NotActionable({ detail: typeable.detail }));
@@ -3383,17 +3365,12 @@ const typeText = (input) => {
 					...target.point
 				}] });
 				yield* marks.sent;
-				for (const type of ["mousePressed", "mouseReleased"]) yield* sendMouse("type", marks.input, {
-					type,
-					...target.point,
-					button: "left",
-					buttons: type === "mousePressed" ? 1 : 0,
-					clickCount: 1
-				});
+				for (const type of ["mousePressed", "mouseReleased"]) yield* sendMouse("type", marks.input, buttonAt(type, target.point));
 				yield* flush("type", marks.input);
 			}
 			yield* marks.sent;
-			const focused = yield* mutate("type", scriptCall("focus", into, replace), approval).pipe(Effect.flatMap(decodeWith("type", FocusResultSchema)));
+			const follow = marks.style.shown && approval === void 0 && !secret && target.name !== "" ? target.name : null;
+			const focused = yield* mutate("type", scriptCall("focus", into, replace, follow), approval).pipe(Effect.flatMap(decodeWith("type", FocusResultSchema)));
 			if ("error" in focused) return yield* editFailure("type", into, focused);
 			secret ||= focused.secret;
 		}
@@ -3480,14 +3457,14 @@ const scroll = (input) => {
 	const { mark, settle } = input;
 	return (scrollOptions = {}, style = plain) => {
 		const target = scrollOptions.at;
-		const valid = Number.isFinite(scrollOptions.dx ?? 0) && Number.isFinite(scrollOptions.dy ?? 0) ? Effect.void : failWith("scroll", new InvalidRequest({ detail: "scroll deltas must be finite" }));
+		const valid = Number.isFinite(scrollOptions.dx ?? 0) && Number.isFinite(scrollOptions.dy ?? 0) ? Effect.void : refuse("scroll", "scroll deltas must be finite");
 		return perform("scroll", {
 			target: target === void 0 ? void 0 : named(target),
 			options: {
 				dx: scrollOptions.dx,
 				dy: scrollOptions.dy
 			}
-		}, settings.actionTimeout, valid.pipe(Effect.andThen(preparePolicy("scroll", { target: typeof target === "string" ? target : void 0 }, target === void 0 ? [] : [target]))), (marks, approval) => Effect.gen(function* () {
+		}, settings.actionTimeout, valid.pipe(Effect.andThen(preparePolicy("scroll", { target: refOf(target) }, target === void 0 ? [] : [target]))), (marks, approval) => Effect.gen(function* () {
 			yield* valid;
 			const viewport = yield* viewportFor("scroll");
 			const middle = {
@@ -3978,6 +3955,9 @@ const make$8 = (options) => Effect.gen(function* () {
 				return current.phase !== "Stopped" && current.failure === void 0 && !isClosed();
 			};
 			if (current === void 0 || !resumable()) return;
+			pictures.track("picture restoration", options.restore(), failed(current));
+			yield* pictures.wait("picture restoration");
+			yield* healthy(current);
 			const viewport = yield* readViewport(options);
 			if (!resumable()) return;
 			sizes.restart(viewport);
@@ -4416,7 +4396,7 @@ const millisOf = (input) => Option.match(Duration.fromInput(input), {
 });
 const reuse = (page, bridge, viewport, capture) => (operation, options) => Effect.gen(function* () {
 	const maxAge = millisOf(options.maxAge ?? defaultMaxAge);
-	if (!(maxAge >= 0)) return yield* failWith(operation, new InvalidRequest({ detail: "maxAge must be a duration of zero or more" }));
+	if (!(maxAge >= 0)) return yield* refuse(operation, "maxAge must be a duration of zero or more");
 	const latest = yield* capture.latest;
 	const known = viewport.knownViewport();
 	const { activity } = page;
@@ -4441,6 +4421,11 @@ const make$7 = Effect.fnUntraced(function* (page, bridge, viewport) {
 		watch: bridge.currentDocument("screencast"),
 		frameHistory: settings.frameHistory,
 		viewport: Effect.suspend(() => viewport.viewportFor("screencast")),
+		restore: () => page.protocol.send("Page.captureScreenshot", {
+			format: "jpeg",
+			quality: 0,
+			optimizeForSpeed: true
+		}),
 		imageSize: jpegSize,
 		error
 	});
@@ -4492,7 +4477,7 @@ const make$7 = Effect.fnUntraced(function* (page, bridge, viewport) {
 	const zoom = (requested) => lane.read("zoom")(Effect.gen(function* () {
 		const region = yield* Schema.decodeEffect(Region)(requested).pipe(Effect.mapError((error) => undispatched("zoom", new InvalidRequest({ detail: error.message }))));
 		const size = viewport.knownViewport() ?? (yield* viewport.viewportFor("zoom"));
-		if (region.x + region.width > size.width || region.y + region.height > size.height) return yield* failWith("zoom", new InvalidRequest({ detail: "the crop must fit entirely within the viewport" }));
+		if (region.x + region.width > size.width || region.y + region.height > size.height) return yield* refuse("zoom", "the crop must fit entirely within the viewport");
 		const image = yield* picture("zoom", 80, region);
 		return new Zoom({
 			page: id,
@@ -4503,7 +4488,7 @@ const make$7 = Effect.fnUntraced(function* (page, bridge, viewport) {
 	const captureStats = (options = {}) => {
 		if (options.window === void 0) return capture.stats();
 		const millis = millisOf(options.window);
-		return millis > 0 && millis <= Duration.toMillis(countsKept) ? capture.stats(millis) : failWith("captureStats", new InvalidRequest({ detail: "window must be over zero and at most a minute" }));
+		return millis > 0 && millis <= Duration.toMillis(countsKept) ? capture.stats(millis) : refuse("captureStats", "window must be over zero and at most a minute");
 	};
 	return {
 		capture,
@@ -4564,7 +4549,7 @@ const make$6 = Effect.fnUntraced(function* (page, bridge) {
 				firstRef: yield* Ref.get(nextRef)
 			};
 			const result = yield* evaluate("snapshot", scriptCall("snapshot", request)).pipe(Effect.flatMap(decodeWith("snapshot", SnapshotResultSchema)));
-			if ("invalid" in result) return yield* failWith("snapshot", new InvalidRequest({ detail: result.invalid }));
+			if ("invalid" in result) return yield* refuse("snapshot", result.invalid);
 			const { text, truncated, url } = result.snapshot;
 			yield* counted(result.nextRef);
 			yield* Effect.annotateCurrentSpan({
@@ -4600,7 +4585,7 @@ const make$6 = Effect.fnUntraced(function* (page, bridge) {
 			maxChars: options.maxChars ?? 12e3,
 			unmask: options.unmask ?? false
 		};
-		return (scope !== "viewport" && !/^e\d+$/.test(scope) ? failWith("text", new InvalidRequest({ detail: `${scope} is neither "viewport" nor a ref such as e12` })) : texts(JSON.stringify(request), Effect.gen(function* () {
+		return (scope !== "viewport" && !/^e\d+$/.test(scope) ? refuse("text", `${scope} is neither "viewport" nor a ref such as e12`) : texts(JSON.stringify(request), Effect.gen(function* () {
 			const result = yield* evaluate("text", scriptCall("text", request)).pipe(Effect.flatMap(decodeWith("text", TextResultSchema)));
 			if (result === null) return yield* failWith("text", new StaleRef({ ref: scope }));
 			yield* Effect.annotateCurrentSpan({
@@ -4624,7 +4609,7 @@ const make$6 = Effect.fnUntraced(function* (page, bridge) {
 		};
 		const millis = Math.min(Duration.toMillis(timeout), Number.MAX_SAFE_INTEGER);
 		const unmet = () => failWith("waitFor", new Timeout({ millis }));
-		const look = evaluate("waitFor", scriptCall("waitUntil", request, millis)).pipe(Effect.flatMap(decodeWith("waitFor", ConditionResultSchema)), Effect.flatMap((result) => "invalid" in result ? failWith("waitFor", new InvalidRequest({ detail: result.invalid })) : result.met ? Effect.void : unmet()));
+		const look = evaluate("waitFor", scriptCall("waitUntil", request, millis)).pipe(Effect.flatMap(decodeWith("waitFor", ConditionResultSchema)), Effect.flatMap((result) => "invalid" in result ? refuse("waitFor", result.invalid) : result.met ? Effect.void : unmet()));
 		return lane.read("waitFor")(Effect.void).pipe(Effect.andThen(Effect.retry(look, { while: contextGone })), Effect.timeoutOrElse({
 			duration: timeout,
 			orElse: unmet
@@ -4652,6 +4637,51 @@ const make$6 = Effect.fnUntraced(function* (page, bridge) {
 	};
 });
 //#endregion
+//#region src/internal/pictures/motion.ts
+/**
+* Where a page's screen moves, from its screencast frames: each frame decoded and cut into
+* 16-pixel blocks, a block moving where a few of its pixels, sampled every other one, changed by
+* more than JPEG's noise in any color channel.
+* What moved among the frames before an input is the page's background, such as an idle
+* animation; foreground stillness ignores it.
+*
+* Frames are decoded with the JPEG decoder playwright-core bundles and exports as
+* `playwright-core/lib/utilsBundle`: effect-browser depends on nothing else, and the runtime has
+* no image decoder. That entry point has no types, so `utilsBundle.d.ts` declares what is used.
+*/
+const picture = (frame) => jpegjs.decode(frame.data, { useTArray: true });
+/** A sample changed where any color channel moved more than this, beyond JPEG's noise. */
+const noise = 32;
+/** The blocks where two pictures differ, by `row * columns + column`; -1 for different sizes. */
+const moved = (from, to) => {
+	if (from.width !== to.width || from.height !== to.height) return [-1];
+	const columns = Math.ceil(from.width / 16);
+	const counts = /* @__PURE__ */ new Map();
+	const differs = (at) => Math.abs((from.data[at] ?? 0) - (to.data[at] ?? 0)) > noise;
+	for (let y = 0; y < from.height; y += 2) for (let x = 0; x < from.width; x += 2) {
+		const at = (y * from.width + x) * 4;
+		const block = Math.floor(y / 16) * columns + Math.floor(x / 16);
+		if (differs(at) || differs(at + 1) || differs(at + 2)) counts.set(block, (counts.get(block) ?? 0) + 1);
+	}
+	return [...counts].flatMap(([block, count]) => count >= 3 ? [block] : []);
+};
+/** The blocks that moved from one picture to the next and their neighbours; none past a resize. */
+const background = (pictures) => {
+	const columns = Math.ceil((pictures[0]?.width ?? 0) / 16);
+	const around = (block) => [
+		-1,
+		0,
+		1
+	].flatMap((row) => [
+		-1,
+		0,
+		1
+	].filter((step) => block >= 0 && block % columns + step >= 0).filter((step) => block % columns + step < columns).map((step) => block + row * columns + step));
+	return new Set(pictures.flatMap((to, index) => moved(pictures[index - 1] ?? to, to).flatMap(around)));
+};
+/** Whether anything moved from one picture to another outside the background. */
+const stirs = (from, to, mask) => moved(from, to).some((block) => !mask.has(block));
+//#endregion
 //#region src/internal/reading/ready.ts
 /**
 * Waiting until a page is ready to be shown. The page's own evidence leads: one page-script call
@@ -4665,7 +4695,10 @@ const make$6 = Effect.fnUntraced(function* (page, bridge) {
 * its connection, and a frame that arrives first starts the spell again. Where the page's changes
 * are recorded, its evidence includes them: nothing in view may have changed for the spell, which a
 * DOM page's changes show better than its paint, and no stall on the way can hide. Content
-* stillness starts that record itself and ignores capture silence. Each new document starts a
+* stillness starts that record itself and ignores capture silence. Foreground stillness lets
+* frames keep coming but compares them, so that only motion outside what was moving before the
+* page's latest input counts; it still waits out unanswered acknowledgements while no frame
+* comes, and its last look follows the round trip too. Each new document starts a
 * new observation, while retries of destroyed script contexts share the caller's deadline.
 */
 const make$5 = (page, bridge, capture) => (options = {}) => {
@@ -4676,30 +4709,54 @@ const make$5 = (page, bridge, capture) => (options = {}) => {
 	}), Effect.flatMap(decodeWith("ready", ReadinessSchema)), Effect.tap((waiting) => Effect.annotateCurrentSpan({ waiting: waiting.join(",") })), Effect.filterOrElse((waiting) => waiting.length === 0, () => failWith("ready", new Timeout({ millis: Duration.toMillis(timeout) }))));
 	const quiet = (millis, until) => Effect.gen(function* () {
 		const running = yield* capture.active;
-		let { received } = yield* capture.stats();
+		const foreground = options.still === "foreground";
+		let counts = yield* capture.stats();
 		let stirred = running ? page.now() : Number.POSITIVE_INFINITY;
+		let reference;
+		const decoded = (frame) => Effect.try({
+			try: () => picture(frame),
+			catch: (error) => undispatched("ready", new Failed({ detail: `no picture: ${String(error)}` }))
+		});
+		const { inputAt } = page.activity;
+		const document = Option.getOrUndefined(yield* capture.latest)?.document;
+		const before = (foreground ? yield* capture.recent : []).filter((frame) => frame.hostTime < inputAt && frame.hostTime >= inputAt - 1500 && frame.document === document);
+		const sampled = before.filter((_, index) => index % Math.ceil(before.length / 8) === 0);
+		const mask = background(yield* Effect.forEach(sampled, decoded));
 		const look = Effect.gen(function* () {
 			const stats = yield* capture.stats();
-			if (!Option.exists(yield* capture.latest, capture.current) || stats.received !== received || stats.ackBacklog > 0) {
-				received = stats.received;
-				stirred = page.now();
+			const latest = Option.getOrUndefined(yield* capture.latest);
+			const arrived = stats.received !== counts.received;
+			const unseen = stats.accepted - counts.accepted;
+			counts = stats;
+			if (latest === void 0 || !capture.current(latest)) stirred = page.now();
+			else if (!foreground ? arrived || stats.ackBacklog > 0 : !arrived && stats.ackBacklog > 0) stirred = page.now();
+			else if (foreground && (unseen > 0 || reference === void 0)) {
+				const frames = (yield* capture.recent).slice(-Math.max(1, Math.min(8, unseen)));
+				if (unseen > frames.length) stirred = page.now();
+				for (const frame of frames) {
+					const seen = yield* decoded(frame);
+					if (reference === void 0 || stirs(reference, seen, mask)) {
+						reference = seen;
+						stirred = page.now();
+					}
+				}
 			}
 			return page.now() - stirred;
 		});
 		const spell = Effect.repeat(look, {
-			schedule: Schedule.spaced(Duration.millis(25)),
+			schedule: Schedule.fixed(Duration.millis(foreground ? 100 : 25)),
 			until: (still) => still >= millis
 		});
 		const capturing = running ? Effect.never : capture.stream().pipe(Stream.runDrain, Effect.andThen(Effect.never));
 		const still = Effect.gen(function* () {
 			for (;;) {
 				yield* spell;
-				const before = received;
+				const before = counts.received;
 				yield* Effect.all([settled(until), capture.sync], {
 					concurrency: 2,
 					discard: true
 				});
-				if ((yield* look) >= millis && received === before) return;
+				if ((yield* look) >= millis && (foreground || counts.received === before)) return;
 			}
 		});
 		return yield* Effect.raceFirst(capturing, still);
@@ -4798,7 +4855,7 @@ const make$3 = (page, read, frames) => ({ since, until, unmask }) => Effect.gen(
 		since,
 		until
 	}, page.now());
-	if (Option.isNone(asked)) return yield* failWith("window", new InvalidRequest({ detail: "a window's bounds must be finite, its reach not negative" }));
+	if (Option.isNone(asked)) return yield* refuse("window", "a window's bounds must be finite, its reach not negative");
 	const bounds = asked.value;
 	const changes = yield* Effect.result(read({
 		since: isWindow(since) ? since.changes ?? bounds.since : isFrame(since) ? since : bounds.since,
@@ -4887,7 +4944,7 @@ const make$2 = (page, perform, preparePolicy) => {
 			"about:",
 			"data:",
 			"file:"
-		].includes(parsed.protocol)) return failWith("navigate", new InvalidRequest({ detail: `"${redact(url)}" is not a URL` }));
+		].includes(parsed.protocol)) return refuse("navigate", `"${redact(url)}" is not a URL`);
 		return navigation("navigate", () => playwright.goto(parsed.href, {
 			waitUntil: "domcontentloaded",
 			timeout: 0
@@ -5039,4 +5096,4 @@ const make = Effect.fnUntraced(function* (options) {
 //#endregion
 export { performed as a, pause as i, make as n, viewOf as r, internalsOf as t };
 
-//# sourceMappingURL=page-ClEMFnBG.mjs.map
+//# sourceMappingURL=page-BKwfF6z-.mjs.map