effect-browser 0.2.0-beta.9 → 0.3.0-beta.10

package/dist/Cdp.d.mts

@@ -0,0 +1,32 @@
+import { t as BrowserError } from "./BrowserError-Coy7EW1N.mjs";
+import { Browser, CaptureSource, Options as Options$1, Service, t as Browser_d_exports } from "./Browser.mjs";
+import { DateTime, Effect, Layer, Redacted } from "effect";
+declare namespace Cdp_d_exports {
+  export { Options, layer, open };
+}
+export interface Options extends Options$1 {
+  /**
+   * `ws://`, `wss://` or `http://` DevTools endpoint. Often a credential, so it may be redacted;
+   * connect failures never include its userinfo, path or query.
+   */
+  readonly endpoint: string | Redacted.Redacted<string>;
+  readonly headers?: Readonly<Record<string, string>> | undefined;
+  /** Identifies the session in `Browser.id`. Defaults to `"cdp"`. */
+  readonly id?: string | undefined;
+  readonly provider?: string | undefined;
+  /** Bound on connecting. Defaults to 30 seconds. */
+  readonly connectTimeoutMillis?: number | undefined;
+  /** When the provider ends the session on its own, as a hosted session's timeout does. */
+  readonly expiresAt?: DateTime.Utc | undefined;
+  /**
+   * A connection apart from this one for the pages' screencasts, as a hosted provider supplies.
+   * Without one, each page's capture runs on its own session.
+   */
+  readonly capture?: CaptureSource | undefined;
+}
+/** Connect and open a `Browser` over the endpoint's first context. */
+export declare const open: (options: Options) => Effect.Effect<Service, BrowserError, import("effect/Scope").Scope>;
+export declare const layer: (options: Options) => Layer.Layer<Browser, BrowserError>;
+//#endregion
+export { Cdp_d_exports as t };
+//# sourceMappingURL=Cdp.d.mts.map

package/dist/Cdp.mjs

@@ -0,0 +1,61 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { Failed } from "./BrowserError.mjs";
+import { i as make, t as Browser } from "./Browser-S4kvpmqa.mjs";
+import { o as reasonOf, s as undispatched } from "./context-B6xr8nVi.mjs";
+import { r as quoted } from "./url-Cd04Okid.mjs";
+import { Effect, Layer, Redacted } from "effect";
+import { chromium } from "playwright-core";
+//#region src/Cdp.ts
+/**
+* A browser reached over the Chrome DevTools Protocol: a Chrome started with
+* `--remote-debugging-port`, or any provider that hands out a CDP WebSocket URL.
+*
+* Closing the scope disconnects. It does not close the remote browser; its owner does that.
+*
+* @since 0.3.0
+*/
+var Cdp_exports = /* @__PURE__ */ __exportAll({
+	layer: () => layer,
+	open: () => open
+});
+/**
+* Playwright can echo the endpoint, or a URL derived from it with its query, userinfo or path, in
+* a connect failure. Those parts are often the credential, so a URL keeps its scheme, host and
+* port, and any other echo of the endpoint is replaced.
+*/
+const withoutEndpoint = (endpoint, reason) => {
+	if (reason._tag !== "Failed") return reason;
+	const origins = reason.detail.replace(quoted, (url) => {
+		const parsed = URL.parse(url);
+		return parsed === null || parsed.host === "" ? "<url>" : `${parsed.protocol}//${parsed.host}`;
+	});
+	return new Failed({ detail: endpoint === "" ? origins : origins.replaceAll(endpoint, "<endpoint>") });
+};
+/** Connect and open a `Browser` over the endpoint's first context. */
+const open = Effect.fn("Cdp.open")(function* (options) {
+	const endpoint = Redacted.isRedacted(options.endpoint) ? Redacted.value(options.endpoint) : options.endpoint;
+	const timeout = options.connectTimeoutMillis ?? 3e4;
+	const failed = (cause, timeoutMillis) => undispatched("connect", withoutEndpoint(endpoint, reasonOf(cause, timeoutMillis)));
+	const connected = yield* Effect.acquireRelease(Effect.tryPromise({
+		try: () => chromium.connectOverCDP(endpoint, {
+			timeout,
+			...options.headers === void 0 ? {} : { headers: { ...options.headers } }
+		}),
+		catch: (cause) => failed(cause, timeout)
+	}).pipe(Effect.withSpan("Cdp.connect", {}, { captureStackTrace: false })), (browser) => Effect.tryPromise(() => browser.close()).pipe(Effect.ignore));
+	const context = connected.contexts()[0] ?? (yield* Effect.tryPromise({
+		try: () => connected.newContext(),
+		catch: (cause) => failed(cause)
+	}));
+	return yield* make(context, {
+		id: options.id ?? "cdp",
+		provider: options.provider ?? "cdp",
+		expiresAt: options.expiresAt,
+		capture: options.capture
+	}, options);
+});
+const layer = (options) => Layer.effect(Browser, open(options));
+//#endregion
+export { layer, open, Cdp_exports as t };
+
+//# sourceMappingURL=Cdp.mjs.map

package/dist/Cdp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cdp.mjs","names":["Url.quoted","Browser.make","Browser.Browser"],"sources":["../src/Cdp.ts"],"sourcesContent":["/**\n * A browser reached over the Chrome DevTools Protocol: a Chrome started with\n * `--remote-debugging-port`, or any provider that hands out a CDP WebSocket URL.\n *\n * Closing the scope disconnects. It does not close the remote browser; its owner does that.\n *\n * @since 0.3.0\n */\nimport { type DateTime, Effect, Layer, Redacted } from \"effect\";\nimport { chromium } from \"playwright-core\";\n\nimport * as Browser from \"./Browser.ts\";\nimport { type BrowserError, Failed, type Reason } from \"./BrowserError.ts\";\nimport { reasonOf, undispatched } from \"./internal/page/context.ts\";\nimport * as Url from \"./internal/page/url.ts\";\n\nexport interface Options extends Browser.Options {\n  /**\n   * `ws://`, `wss://` or `http://` DevTools endpoint. Often a credential, so it may be redacted;\n   * connect failures never include its userinfo, path or query.\n   */\n  readonly endpoint: string | Redacted.Redacted<string>;\n  readonly headers?: Readonly<Record<string, string>> | undefined;\n  /** Identifies the session in `Browser.id`. Defaults to `\"cdp\"`. */\n  readonly id?: string | undefined;\n  readonly provider?: string | undefined;\n  /** Bound on connecting. Defaults to 30 seconds. */\n  readonly connectTimeoutMillis?: number | undefined;\n  /** When the provider ends the session on its own, as a hosted session's timeout does. */\n  readonly expiresAt?: DateTime.Utc | undefined;\n  /**\n   * A connection apart from this one for the pages' screencasts, as a hosted provider supplies.\n   * Without one, each page's capture runs on its own session.\n   */\n  readonly capture?: Browser.CaptureSource | undefined;\n}\n\n/**\n * Playwright can echo the endpoint, or a URL derived from it with its query, userinfo or path, in\n * a connect failure. Those parts are often the credential, so a URL keeps its scheme, host and\n * port, and any other echo of the endpoint is replaced.\n */\nconst withoutEndpoint = (endpoint: string, reason: Reason): Reason => {\n  if (reason._tag !== \"Failed\") return reason;\n\n  const origins = reason.detail.replace(Url.quoted, (url) => {\n    const parsed = URL.parse(url);\n\n    return parsed === null || parsed.host === \"\" ? \"<url>\" : `${parsed.protocol}//${parsed.host}`;\n  });\n\n  return new Failed({\n    detail: endpoint === \"\" ? origins : origins.replaceAll(endpoint, \"<endpoint>\"),\n  });\n};\n\n/** Connect and open a `Browser` over the endpoint's first context. */\nexport const open = Effect.fn(\"Cdp.open\")(function* (options: Options) {\n  const endpoint = Redacted.isRedacted(options.endpoint)\n    ? Redacted.value(options.endpoint)\n    : options.endpoint;\n\n  const timeout = options.connectTimeoutMillis ?? 30_000;\n\n  const failed = (cause: unknown, timeoutMillis?: number) =>\n    undispatched(\"connect\", withoutEndpoint(endpoint, reasonOf(cause, timeoutMillis)));\n\n  // The endpoint is often a credential, so the connect span names no part of it.\n  const connected = yield* Effect.acquireRelease(\n    Effect.tryPromise({\n      try: () =>\n        chromium.connectOverCDP(endpoint, {\n          timeout,\n          ...(options.headers === undefined ? {} : { headers: { ...options.headers } }),\n        }),\n      catch: (cause) => failed(cause, timeout),\n    }).pipe(Effect.withSpan(\"Cdp.connect\", {}, { captureStackTrace: false })),\n    (browser) => Effect.tryPromise(() => browser.close()).pipe(Effect.ignore),\n  );\n\n  const context =\n    connected.contexts()[0] ??\n    (yield* Effect.tryPromise({\n      try: () => connected.newContext(),\n      catch: (cause) => failed(cause),\n    }));\n\n  return yield* Browser.make(\n    context,\n    {\n      id: options.id ?? \"cdp\",\n      provider: options.provider ?? \"cdp\",\n      expiresAt: options.expiresAt,\n      capture: options.capture,\n    },\n    options,\n  );\n});\n\nexport const layer = (options: Options): Layer.Layer<Browser.Browser, BrowserError> =>\n  Layer.effect(Browser.Browser, open(options));\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,MAAM,mBAAmB,UAAkB,WAA2B;CACpE,IAAI,OAAO,SAAS,UAAU,OAAO;CAErC,MAAM,UAAU,OAAO,OAAO,QAAQA,SAAa,QAAQ;EACzD,MAAM,SAAS,IAAI,MAAM,GAAG;EAE5B,OAAO,WAAW,QAAQ,OAAO,SAAS,KAAK,UAAU,GAAG,OAAO,SAAS,IAAI,OAAO;CACzF,CAAC;CAED,OAAO,IAAI,OAAO,EAChB,QAAQ,aAAa,KAAK,UAAU,QAAQ,WAAW,UAAU,YAAY,EAC/E,CAAC;AACH;;AAGA,MAAa,OAAO,OAAO,GAAG,UAAU,CAAC,CAAC,WAAW,SAAkB;CACrE,MAAM,WAAW,SAAS,WAAW,QAAQ,QAAQ,IACjD,SAAS,MAAM,QAAQ,QAAQ,IAC/B,QAAQ;CAEZ,MAAM,UAAU,QAAQ,wBAAwB;CAEhD,MAAM,UAAU,OAAgB,kBAC9B,aAAa,WAAW,gBAAgB,UAAU,SAAS,OAAO,aAAa,CAAC,CAAC;CAGnF,MAAM,YAAY,OAAO,OAAO,eAC9B,OAAO,WAAW;EAChB,WACE,SAAS,eAAe,UAAU;GAChC;GACA,GAAI,QAAQ,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,QAAQ,QAAQ,EAAE;EAC7E,CAAC;EACH,QAAQ,UAAU,OAAO,OAAO,OAAO;CACzC,CAAC,CAAC,CAAC,KAAK,OAAO,SAAS,eAAe,CAAC,GAAG,EAAE,mBAAmB,MAAM,CAAC,CAAC,IACvE,YAAY,OAAO,iBAAiB,QAAQ,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,MAAM,CAC1E;CAEA,MAAM,UACJ,UAAU,SAAS,CAAC,CAAC,OACpB,OAAO,OAAO,WAAW;EACxB,WAAW,UAAU,WAAW;EAChC,QAAQ,UAAU,OAAO,KAAK;CAChC,CAAC;CAEH,OAAO,OAAOC,KACZ,SACA;EACE,IAAI,QAAQ,MAAM;EAClB,UAAU,QAAQ,YAAY;EAC9B,WAAW,QAAQ;EACnB,SAAS,QAAQ;CACnB,GACA,OACF;AACF,CAAC;AAED,MAAa,SAAS,YACpB,MAAM,OAAOC,SAAiB,KAAK,OAAO,CAAC"}

package/dist/Change-DNvztNLu.mjs

@@ -0,0 +1,138 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { Subject } from "./BrowserEvent.mjs";
+import { Schema } from "effect";
+//#region src/internal/timeline/words.ts
+const quoted = (value) => JSON.stringify(value ?? "");
+/** A subject in words, such as `button "Play"`; one without a name says where it was. */
+const named = (subject, point) => {
+	const kind = subject.role ?? subject.tag;
+	if (subject.name !== "") return `${kind} ${JSON.stringify(subject.name)}`;
+	return point === void 0 ? kind : `${kind} at ${point}`;
+};
+/** A change's context in words: `row "Ether", column "1h"` or `beside "Price", under "Bitcoin"`. */
+const where = ({ row, column, label, heading }, grouped = false) => {
+	const parts = [
+		row === void 0 ? "" : `row ${quoted(row)}`,
+		column === void 0 || grouped ? "" : `column ${quoted(column)}`,
+		label === void 0 ? "" : `beside ${quoted(label)}`,
+		heading === void 0 || grouped ? "" : `under ${quoted(heading)}`
+	].filter((part) => part !== "");
+	return parts.length === 0 ? "" : ` (${parts.join(", ")})`;
+};
+/** A change in words, such as `"$61,240" became "$62,010" (row "Bitcoin", column "Price")`. */
+const describe$1 = (change, grouped = false) => {
+	const { subject, before, after, count, lowest, highest } = change;
+	const context = where(subject.context, grouped);
+	const range = lowest === void 0 || highest === void 0 ? "" : `, from ${lowest} to ${highest}`;
+	const times = count > 1 ? ` (it changed ${count} times${range})` : "";
+	switch (change.kind) {
+		case "title": return `the title ${before === void 0 ? "now reads" : `${quoted(before)} became`} ${quoted(after)}`;
+		case "value": {
+			const field = named(subject, void 0);
+			if (after === "checked" || after === "not checked") return `${field} is now ${after}`;
+			if (after === void 0 || after === "") return `${field} was cleared`;
+			return after === "••••" || before === void 0 || before === "" ? `${field} was ${after === "••••" ? "edited" : `set to ${quoted(after)}`}` : `${field} changed from ${quoted(before)} to ${quoted(after)}`;
+		}
+		case "appeared": return `${quoted(after)} appeared${context}`;
+		case "disappeared": return `${quoted(before)} disappeared${context}`;
+		case "brief": return `${quoted(after)} appeared and went away again${context}`;
+		case "text": return before === void 0 ? `now reads ${quoted(after)}${context}${times}` : `${quoted(before)} became ${quoted(after)}${context}${times}`;
+	}
+};
+//#endregion
+//#region src/Change.ts
+/**
+* What visibly changed on a page over a window, element by element: text that changed, appeared,
+* disappeared or came and went, a field's value, and the document's title. A change says what was
+* shown at the window's start and at its end, how often it changed between, where it is on the
+* page, and the input it followed, where it was that input's doing.
+*
+* `Page.changes` reads it. A page records once something reads its changes: from then, and from the
+* start of each later document once it is parsed, until nobody has read it for two minutes. A page
+* nobody reads records nothing. The record keeps 256 elements, each with its last 32 changes, for a
+* minute; an element that keeps changing gives way before news, and what gives way is counted in
+* `dropped`, with `from` moved past it. A change is told when it was in view as the page rendered
+* it, its style showing it, so one scrolled away later is still told, and something removed or
+* hidden only if it was in view before. What the record cannot see: pictures, a canvas, frames,
+* shadow roots and SVG; a value a script sets; and a class that reveals an element the record has
+* not seen before, such as a toast already on the page, though its later changes are seen.
+*
+* @since 0.3.0
+*/
+var Change_exports = /* @__PURE__ */ __exportAll({
+	Change: () => Change,
+	Changes: () => Changes,
+	Kind: () => Kind,
+	describe: () => describe
+});
+/**
+* `text` changed; `appeared` and `disappeared`, whether added or removed or shown or hidden;
+* `brief`, appeared and gone again by the window's end; `value`, a field's; `title`, the document's.
+*/
+const Kind = Schema.Literals([
+	"text",
+	"appeared",
+	"disappeared",
+	"brief",
+	"value",
+	"title"
+]);
+var Change = class extends Schema.Class("effect-browser/Change")({
+	kind: Kind,
+	/**
+	* What changed, as the page names it now, or where it was for what went. Its own words are what
+	* changed, so its name is empty unless something else names it, as a field's label does.
+	*/
+	subject: Subject,
+	/** When it first changed in the window, in host monotonic milliseconds on the browser's clock. */
+	startedAt: Schema.Finite,
+	/** When it last changed in the window. */
+	at: Schema.Finite,
+	/**
+	* What it showed at the window's start; absent for what appeared and where the record let that go.
+	* What disappeared says what it showed as it went. A field's value reads `••••` unless unmasked.
+	*/
+	before: Schema.optional(Schema.String),
+	/** What it showed at the window's end; absent for what disappeared. What came and went says what it showed. */
+	after: Schema.optional(Schema.String),
+	/** How many times what it showed changed in the window. */
+	count: Schema.Int.check(Schema.isGreaterThan(0)),
+	/** For a number that changed more than once, its lowest and highest, as shown. */
+	lowest: Schema.optional(Schema.String),
+	highest: Schema.optional(Schema.String),
+	/** When it last changed before the window, as far back as the record keeps: in flux, not news. */
+	earlier: Schema.optional(Schema.Finite),
+	/**
+	* When the trusted input it followed reached the page, where it was that input's doing. It was not
+	* in flux: in the 10 s before the input it had not changed, and nothing had come into or left what
+	* it sits in, so a ticker's tick or a feed's line is not. Then it changed within 3 s inside what
+	* the input acted on or its row, form, dialog or controlled element; or, elsewhere, within 500 ms
+	* of an input on a page where nothing had changed in the 2 s before, as a menu a portal puts at
+	* the end of the page does. What holds the input's target, as a menu holds its item, does not
+	* count against it. The page's `Action` that sent it holds that time.
+	*/
+	cause: Schema.optional(Schema.Finite)
+}) {};
+var Changes = class extends Schema.Class("effect-browser/Changes")({
+	/** The page's document these changes belong to, as `Navigated` counts them. */
+	document: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
+	/** Where the record is whole: before it, changes may be missing. */
+	from: Schema.Finite,
+	/** Where the window ends: its `until`, or when the page was read. */
+	until: Schema.Finite,
+	/**
+	* Where the window ends on the page's own clock. Give these changes as the next read's `since` and
+	* the two windows meet exactly, whatever the clock mapping does meanwhile.
+	*/
+	cursor: Schema.Finite,
+	/** Changes in the window the record let go, at least; 0 when it kept them all. */
+	dropped: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
+	/** Oldest first, by when each began to change. */
+	changes: Schema.Array(Change)
+}) {};
+/** A change in words for a model, such as `"$61,240" became "$62,010" (row "Bitcoin", column "Price")`. */
+const describe = (change) => describe$1(change);
+//#endregion
+export { describe as a, quoted as c, Kind as i, where as l, Change_exports as n, describe$1 as o, Changes as r, named as s, Change as t };
+
+//# sourceMappingURL=Change-DNvztNLu.mjs.map

package/dist/Change-DNvztNLu.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Change-DNvztNLu.mjs","names":["describe","Words.describe"],"sources":["../src/internal/timeline/words.ts","../src/Change.ts"],"sourcesContent":["/**\n * What changed on a page, in words for a model: a change with where it is, and what it is. A moment\n * tells its changes this way, and a tool's receipt the changes its action caused.\n */\nimport type { Subject, SubjectContext } from \"../../BrowserEvent.ts\";\nimport type { Change } from \"../../Change.ts\";\n\nexport const quoted = (value: string | undefined) => JSON.stringify(value ?? \"\");\n\n/** A subject in words, such as `button \"Play\"`; one without a name says where it was. */\nexport const named = (subject: Subject, point: string | undefined) => {\n  const kind = subject.role ?? subject.tag;\n\n  if (subject.name !== \"\") return `${kind} ${JSON.stringify(subject.name)}`;\n\n  return point === undefined ? kind : `${kind} at ${point}`;\n};\n\n/** A change's context in words: `row \"Ether\", column \"1h\"` or `beside \"Price\", under \"Bitcoin\"`. */\nexport const where = ({ row, column, label, heading }: SubjectContext, grouped = false) => {\n  const parts = [\n    row === undefined ? \"\" : `row ${quoted(row)}`,\n    column === undefined || grouped ? \"\" : `column ${quoted(column)}`,\n    label === undefined ? \"\" : `beside ${quoted(label)}`,\n    heading === undefined || grouped ? \"\" : `under ${quoted(heading)}`,\n  ].filter((part) => part !== \"\");\n\n  return parts.length === 0 ? \"\" : ` (${parts.join(\", \")})`;\n};\n\n/** A change in words, such as `\"$61,240\" became \"$62,010\" (row \"Bitcoin\", column \"Price\")`. */\nexport const describe = (change: Change, grouped = false): string => {\n  const { subject, before, after, count, lowest, highest } = change;\n  const context = where(subject.context, grouped);\n\n  const range =\n    lowest === undefined || highest === undefined ? \"\" : `, from ${lowest} to ${highest}`;\n\n  const times = count > 1 ? ` (it changed ${count} times${range})` : \"\";\n\n  switch (change.kind) {\n    case \"title\":\n      return `the title ${before === undefined ? \"now reads\" : `${quoted(before)} became`} ${quoted(after)}`;\n    case \"value\": {\n      const field = named(subject, undefined);\n\n      if (after === \"checked\" || after === \"not checked\") return `${field} is now ${after}`;\n      if (after === undefined || after === \"\") return `${field} was cleared`;\n\n      return after === \"••••\" || before === undefined || before === \"\"\n        ? `${field} was ${after === \"••••\" ? \"edited\" : `set to ${quoted(after)}`}`\n        : `${field} changed from ${quoted(before)} to ${quoted(after)}`;\n    }\n    case \"appeared\":\n      return `${quoted(after)} appeared${context}`;\n    case \"disappeared\":\n      return `${quoted(before)} disappeared${context}`;\n    case \"brief\":\n      return `${quoted(after)} appeared and went away again${context}`;\n    case \"text\":\n      return before === undefined\n        ? `now reads ${quoted(after)}${context}${times}`\n        : `${quoted(before)} became ${quoted(after)}${context}${times}`;\n  }\n};\n","/**\n * What visibly changed on a page over a window, element by element: text that changed, appeared,\n * disappeared or came and went, a field's value, and the document's title. A change says what was\n * shown at the window's start and at its end, how often it changed between, where it is on the\n * page, and the input it followed, where it was that input's doing.\n *\n * `Page.changes` reads it. A page records once something reads its changes: from then, and from the\n * start of each later document once it is parsed, until nobody has read it for two minutes. A page\n * nobody reads records nothing. The record keeps 256 elements, each with its last 32 changes, for a\n * minute; an element that keeps changing gives way before news, and what gives way is counted in\n * `dropped`, with `from` moved past it. A change is told when it was in view as the page rendered\n * it, its style showing it, so one scrolled away later is still told, and something removed or\n * hidden only if it was in view before. What the record cannot see: pictures, a canvas, frames,\n * shadow roots and SVG; a value a script sets; and a class that reveals an element the record has\n * not seen before, such as a toast already on the page, though its later changes are seen.\n *\n * @since 0.3.0\n */\nimport { Schema } from \"effect\";\n\nimport { Subject } from \"./BrowserEvent.ts\";\nimport * as Words from \"./internal/timeline/words.ts\";\n\n/**\n * `text` changed; `appeared` and `disappeared`, whether added or removed or shown or hidden;\n * `brief`, appeared and gone again by the window's end; `value`, a field's; `title`, the document's.\n */\nexport const Kind = Schema.Literals([\"text\", \"appeared\", \"disappeared\", \"brief\", \"value\", \"title\"]);\n\nexport type Kind = typeof Kind.Type;\n\nexport class Change extends Schema.Class<Change>(\"effect-browser/Change\")({\n  kind: Kind,\n  /**\n   * What changed, as the page names it now, or where it was for what went. Its own words are what\n   * changed, so its name is empty unless something else names it, as a field's label does.\n   */\n  subject: Subject,\n  /** When it first changed in the window, in host monotonic milliseconds on the browser's clock. */\n  startedAt: Schema.Finite,\n  /** When it last changed in the window. */\n  at: Schema.Finite,\n  /**\n   * What it showed at the window's start; absent for what appeared and where the record let that go.\n   * What disappeared says what it showed as it went. A field's value reads `••••` unless unmasked.\n   */\n  before: Schema.optional(Schema.String),\n  /** What it showed at the window's end; absent for what disappeared. What came and went says what it showed. */\n  after: Schema.optional(Schema.String),\n  /** How many times what it showed changed in the window. */\n  count: Schema.Int.check(Schema.isGreaterThan(0)),\n  /** For a number that changed more than once, its lowest and highest, as shown. */\n  lowest: Schema.optional(Schema.String),\n  highest: Schema.optional(Schema.String),\n  /** When it last changed before the window, as far back as the record keeps: in flux, not news. */\n  earlier: Schema.optional(Schema.Finite),\n  /**\n   * When the trusted input it followed reached the page, where it was that input's doing. It was not\n   * in flux: in the 10 s before the input it had not changed, and nothing had come into or left what\n   * it sits in, so a ticker's tick or a feed's line is not. Then it changed within 3 s inside what\n   * the input acted on or its row, form, dialog or controlled element; or, elsewhere, within 500 ms\n   * of an input on a page where nothing had changed in the 2 s before, as a menu a portal puts at\n   * the end of the page does. What holds the input's target, as a menu holds its item, does not\n   * count against it. The page's `Action` that sent it holds that time.\n   */\n  cause: Schema.optional(Schema.Finite),\n}) {}\n\nexport class Changes extends Schema.Class<Changes>(\"effect-browser/Changes\")({\n  /** The page's document these changes belong to, as `Navigated` counts them. */\n  document: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),\n  /** Where the record is whole: before it, changes may be missing. */\n  from: Schema.Finite,\n  /** Where the window ends: its `until`, or when the page was read. */\n  until: Schema.Finite,\n  /**\n   * Where the window ends on the page's own clock. Give these changes as the next read's `since` and\n   * the two windows meet exactly, whatever the clock mapping does meanwhile.\n   */\n  cursor: Schema.Finite,\n  /** Changes in the window the record let go, at least; 0 when it kept them all. */\n  dropped: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),\n  /** Oldest first, by when each began to change. */\n  changes: Schema.Array(Change),\n}) {}\n\n/** A change in words for a model, such as `\"$61,240\" became \"$62,010\" (row \"Bitcoin\", column \"Price\")`. */\nexport const describe = (change: Change): string => Words.describe(change);\n"],"mappings":"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"}

package/dist/Change-iMlcuzVD.d.mts

@@ -0,0 +1,71 @@
+import { b as Subject } from "./BrowserEvent-BRu2juEz.mjs";
+import { Schema } from "effect";
+declare namespace Change_d_exports {
+  export { Change, Changes, Kind, describe };
+}
+/**
+ * `text` changed; `appeared` and `disappeared`, whether added or removed or shown or hidden;
+ * `brief`, appeared and gone again by the window's end; `value`, a field's; `title`, the document's.
+ */
+declare const Kind: Schema.Literals<readonly ["text", "appeared", "disappeared", "brief", "value", "title"]>;
+type Kind = typeof Kind.Type;
+declare const Change_base: Schema.Class<Change, Schema.Struct<{
+  readonly kind: Schema.Literals<readonly ["text", "appeared", "disappeared", "brief", "value", "title"]>;
+  /**
+   * What changed, as the page names it now, or where it was for what went. Its own words are what
+   * changed, so its name is empty unless something else names it, as a field's label does.
+   */
+  readonly subject: typeof Subject;
+  /** When it first changed in the window, in host monotonic milliseconds on the browser's clock. */
+  readonly startedAt: Schema.Finite;
+  /** When it last changed in the window. */
+  readonly at: Schema.Finite;
+  /**
+   * What it showed at the window's start; absent for what appeared and where the record let that go.
+   * What disappeared says what it showed as it went. A field's value reads `••••` unless unmasked.
+   */
+  readonly before: Schema.optional<Schema.String>;
+  /** What it showed at the window's end; absent for what disappeared. What came and went says what it showed. */
+  readonly after: Schema.optional<Schema.String>;
+  /** How many times what it showed changed in the window. */
+  readonly count: Schema.Int;
+  /** For a number that changed more than once, its lowest and highest, as shown. */
+  readonly lowest: Schema.optional<Schema.String>;
+  readonly highest: Schema.optional<Schema.String>;
+  /** When it last changed before the window, as far back as the record keeps: in flux, not news. */
+  readonly earlier: Schema.optional<Schema.Finite>;
+  /**
+   * When the trusted input it followed reached the page, where it was that input's doing. It was not
+   * in flux: in the 10 s before the input it had not changed, and nothing had come into or left what
+   * it sits in, so a ticker's tick or a feed's line is not. Then it changed within 3 s inside what
+   * the input acted on or its row, form, dialog or controlled element; or, elsewhere, within 500 ms
+   * of an input on a page where nothing had changed in the 2 s before, as a menu a portal puts at
+   * the end of the page does. What holds the input's target, as a menu holds its item, does not
+   * count against it. The page's `Action` that sent it holds that time.
+   */
+  readonly cause: Schema.optional<Schema.Finite>;
+}>, {}>;
+declare class Change extends Change_base {}
+declare const Changes_base: Schema.Class<Changes, Schema.Struct<{
+  /** The page's document these changes belong to, as `Navigated` counts them. */
+  readonly document: Schema.Int;
+  /** Where the record is whole: before it, changes may be missing. */
+  readonly from: Schema.Finite;
+  /** Where the window ends: its `until`, or when the page was read. */
+  readonly until: Schema.Finite;
+  /**
+   * Where the window ends on the page's own clock. Give these changes as the next read's `since` and
+   * the two windows meet exactly, whatever the clock mapping does meanwhile.
+   */
+  readonly cursor: Schema.Finite;
+  /** Changes in the window the record let go, at least; 0 when it kept them all. */
+  readonly dropped: Schema.Int;
+  /** Oldest first, by when each began to change. */
+  readonly changes: Schema.$Array<typeof Change>;
+}>, {}>;
+declare class Changes extends Changes_base {}
+/** A change in words for a model, such as `"$61,240" became "$62,010" (row "Bitcoin", column "Price")`. */
+declare const describe: (change: Change) => string;
+//#endregion
+export { describe as a, Kind as i, Change_d_exports as n, Changes as r, Change as t };
+//# sourceMappingURL=Change-iMlcuzVD.d.mts.map

package/dist/Change.d.mts

@@ -0,0 +1,2 @@
+import { a as describe, i as Kind, r as Changes, t as Change } from "./Change-iMlcuzVD.mjs";
+export { Change, Changes, Kind, describe };

package/dist/Change.mjs

@@ -0,0 +1,2 @@
+import { a as describe, i as Kind, r as Changes, t as Change } from "./Change-DNvztNLu.mjs";
+export { Change, Changes, Kind, describe };

package/dist/Chromium.d.mts

@@ -1,85 +1,33 @@
-import { BrowserError, InitializationError } from "./Errors.mjs";
-import { it as Viewport, o as BrowserPolicy, r as AutomationOptions } from "./BrowserData-CPIIIHol.mjs";
-import { c as OpenOptions, i as BrowserSession } from "./Browser-BF9_sORP.mjs";
-import { Context, Crypto, Effect, Layer, Option, Redacted, Schema, Scope } from "effect";
-//#region src/internal/chromium/Data.d.ts
-declare const ChromiumReference_base: Schema.Class<ChromiumReference, Schema.Struct<{
-  readonly provider: Schema.Literal<"chromium">;
-  readonly id: Schema.NonEmptyString;
-}>, {}>;
-/** Identifies this Chromium ownership lifetime, not a reusable endpoint. */
-export declare class ChromiumReference extends ChromiumReference_base {}
-declare const ChromiumCleanupIssue_base: Schema.Class<ChromiumCleanupIssue, Schema.Struct<{
-  readonly step: Schema.Literals<readonly ["fence", "capture", "initialization", "disconnect", "terminate", "profile"]>;
-  readonly reason: Schema.Literals<readonly ["timeout", "failed", "interrupted"]>;
-}>, {}>;
-export declare class ChromiumCleanupIssue extends ChromiumCleanupIssue_base {}
-declare const ChromiumCleanupResult_base: Schema.Class<ChromiumCleanupResult, Schema.Struct<{
-  readonly reference: typeof ChromiumReference;
-  readonly ownership: Schema.Literals<readonly ["owned", "borrowed"]>;
-  readonly connection: Schema.Literals<readonly ["closed", "failed", "not-connected", "pending"]>;
-  readonly process: Schema.Literals<readonly ["terminated", "unknown", "not-owned"]>;
-  readonly issues: Schema.$Array<typeof ChromiumCleanupIssue>;
-}>, {}>;
-/** Connection teardown and observed process exit are separate facts; no provider status exists. */
-export declare class ChromiumCleanupResult extends ChromiumCleanupResult_base {}
-export declare const ChromiumLaunch: Schema.Struct<{
-  readonly executablePath: Schema.optionalKey<Schema.NonEmptyString>;
-  readonly headless: Schema.optionalKey<Schema.Boolean>;
-  /** Enabled by default; a trusted host must explicitly choose a sandbox exception. */
-  readonly chromiumSandbox: Schema.optionalKey<Schema.Boolean>;
-  readonly args: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
-  readonly proxy: Schema.optionalKey<Schema.Struct<{
-    readonly server: Schema.NonEmptyString;
-    readonly bypass: Schema.optionalKey<Schema.NonEmptyString>;
-  }>>;
-  readonly startupTimeoutMillis: Schema.optionalKey<Schema.Int>;
-}>;
-export type ChromiumLaunch = typeof ChromiumLaunch.Type;
-//#endregion
-//#region src/Chromium.d.ts
-/** Host-only process configuration. Building this layer neither loads Playwright nor starts Chromium. */
-export interface ChromiumOptions extends AutomationOptions {
-  readonly launch?: ChromiumLaunch;
-  readonly viewport?: Viewport;
-  readonly onCleanup?: (result: ChromiumCleanupResult) => Effect.Effect<void>;
-}
-/** An owned or borrowed Chromium lifetime with one modeled browser connection. */
-export interface ChromiumSession<E = never> extends BrowserSession<E> {
-  readonly reference: ChromiumReference;
-  readonly closeChecked: Effect.Effect<ChromiumCleanupResult, BrowserError>;
-  readonly close: Effect.Effect<ChromiumCleanupResult>;
-  readonly cleanupResult: Effect.Effect<Option.Option<ChromiumCleanupResult>>;
-}
-export interface ChromiumAcquisition<E = never> {
-  readonly reference: ChromiumReference;
-  readonly failure: Effect.Effect<never, E | InitializationError>;
-  readonly connect: Effect.Effect<ChromiumSession<E>, BrowserError | InitializationError | E>;
-  readonly close: Effect.Effect<ChromiumCleanupResult>;
-}
-export interface ChromiumAttachRequest<E = never, R = never> extends OpenOptions<E, R> {
-  readonly policy: BrowserPolicy;
-  /** Resolve this exact target; without it, multiple open pages are an ambiguity error. */
-  readonly target?: {
-    readonly targetId: string;
-  };
+import { t as BrowserError } from "./BrowserError-Coy7EW1N.mjs";
+import { Browser, Options as Options$1, Service, t as Browser_d_exports } from "./Browser.mjs";
+import { Effect, Layer } from "effect";
+declare namespace Chromium_d_exports {
+  export { Options, layer, open };
 }
-declare const Chromium_base: Context.ServiceClass<Chromium, "effect-browser/Chromium", {
-  readonly acquire: <E = never, R = never>(policy: BrowserPolicy, request?: OpenOptions<E, R>) => Effect.Effect<ChromiumAcquisition<E>, BrowserError, Scope.Scope | Exclude<R, Scope.Scope>>;
-  readonly launch: <E = never, R = never>(policy: BrowserPolicy, request?: OpenOptions<E, R>) => Effect.Effect<ChromiumSession<E>, BrowserError | InitializationError | E, Scope.Scope | Exclude<R, Scope.Scope>>;
-  /** A concrete loopback ws://.../devtools/browser/... endpoint; this scope owns only its connection. */
-  readonly attach: <E = never, R = never>(endpoint: Redacted.Redacted<string>, request: ChromiumAttachRequest<E, R>) => Effect.Effect<ChromiumSession<E>, BrowserError | InitializationError | E, Scope.Scope | Exclude<R, Scope.Scope>>;
-}>;
-export declare class Chromium extends Chromium_base {
-  /** Launch through the configured service; compose with Browser.scoped for supervised ownership. */
-  static launch<E = never, R = never>(policy: BrowserPolicy, request?: OpenOptions<E, R>): Effect.Effect<ChromiumSession<E>, E | BrowserError | InitializationError, Chromium | Scope.Scope | Exclude<R, Scope.Scope>>;
-  /** Acquire the process lifetime before connecting, using the caller's scope. */
-  static acquire<E = never, R = never>(policy: BrowserPolicy, request?: OpenOptions<E, R>): Effect.Effect<ChromiumAcquisition<E>, BrowserError, Chromium | Scope.Scope | Exclude<R, Scope.Scope>>;
-  /** Borrow a concrete loopback endpoint; cleanup never terminates its external process. */
-  static attach<E = never, R = never>(endpoint: Redacted.Redacted<string>, request: ChromiumAttachRequest<E, R>): Effect.Effect<ChromiumSession<E>, E | BrowserError | InitializationError, Chromium | Scope.Scope | Exclude<R, Scope.Scope>>;
-  /** Chromium references, connection ids and handoff tokens come from the required `Crypto`. */
-  static layer(options?: ChromiumOptions): Layer.Layer<Chromium, BrowserError, Crypto.Crypto>;
+export interface Options extends Options$1 {
+  /** Defaults to true. */
+  readonly headless?: boolean | undefined;
+  /**
+   * Run Chromium's sandbox. Defaults to false, as in Playwright, so an exploit in a page's renderer
+   * runs with this process's privileges. Hosts that don't allow unprivileged user namespaces, such
+   * as many containers and Ubuntu 23.10 or later by default, can't start the sandbox; opening then
+   * fails and says so.
+   */
+  readonly sandbox?: boolean | undefined;
+  /** Defaults to 1280x720 CSS pixels at a device scale factor of 1. */
+  readonly viewport?: {
+    readonly width: number;
+    readonly height: number;
+  } | undefined;
+  readonly executablePath?: string | undefined;
+  readonly args?: ReadonlyArray<string> | undefined;
+  readonly userAgent?: string | undefined;
+  readonly locale?: string | undefined;
 }
+/** Launch Chromium and open a `Browser` over a fresh context. */
+export declare const open: (options?: Options | undefined) => Effect.Effect<Service, BrowserError, import("effect/Scope").Scope>;
+/** A `Browser` Layer that launches Chromium when built and closes it when released. */
+export declare const layer: (options?: Options) => Layer.Layer<Browser, BrowserError>;
 //#endregion
-export {};
+export { Chromium_d_exports as t };
 //# sourceMappingURL=Chromium.d.mts.map