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

package/dist/BrowserEvent.d.mts

@@ -0,0 +1,2 @@
+import { C as TrackEvent, E as WheelScrolled, S as TextInserted, T as TrackPlanned, _ as PointerReleased, b as Subject, c as DisconnectCause, d as Navigated, f as PageClosed, g as PointerPressed, h as PageUntracked, i as BrowserEvent, l as Disconnected, m as PageOpened, n as ActionOptions, o as CursorChanged, p as PageLoaded, r as Box, s as DialogShown, t as Action, u as KeyChanged, v as RecordedEvent, w as TrackPerformed, x as SubjectContext, y as SessionEnding } from "./BrowserEvent-DzdNdvoh.mjs";
+export { Action, ActionOptions, Box, BrowserEvent, CursorChanged, DialogShown, DisconnectCause, Disconnected, KeyChanged, Navigated, PageClosed, PageLoaded, PageOpened, PageUntracked, PointerPressed, PointerReleased, RecordedEvent, SessionEnding, Subject, SubjectContext, TextInserted, TrackEvent, TrackPerformed, TrackPlanned, WheelScrolled };

package/dist/BrowserEvent.mjs

@@ -0,0 +1,295 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { Plan, Point } from "./Motion.mjs";
+import { Schema } from "effect";
+//#region src/BrowserEvent.ts
+/**
+* What happened in a browser, in order: pages and their documents, actions, pointer motion, and
+* the browser's own end.
+*
+* Every event carries `at`, host monotonic milliseconds from the owning browser’s Effect `Clock`.
+* This clock also stamps screencast frames’ `receivedAt` and moments, so wall-clock corrections
+* cannot disturb their order. Compare stamps only within the same browser clock, not across hosts.
+* A page is named by its CDP target id, which stays the same across reconnects, and every URL is
+* reported without its userinfo or known secret parameters.
+*
+* @since 0.3.0
+*/
+var BrowserEvent_exports = /* @__PURE__ */ __exportAll({
+	Action: () => Action,
+	ActionOptions: () => ActionOptions,
+	Box: () => Box,
+	BrowserEvent: () => BrowserEvent,
+	CursorChanged: () => CursorChanged,
+	DialogShown: () => DialogShown,
+	DisconnectCause: () => DisconnectCause,
+	Disconnected: () => Disconnected,
+	KeyChanged: () => KeyChanged,
+	Navigated: () => Navigated,
+	PageClosed: () => PageClosed,
+	PageLoaded: () => PageLoaded,
+	PageOpened: () => PageOpened,
+	PageUntracked: () => PageUntracked,
+	PointerPressed: () => PointerPressed,
+	PointerReleased: () => PointerReleased,
+	RecordedEvent: () => RecordedEvent,
+	SessionEnding: () => SessionEnding,
+	Subject: () => Subject,
+	SubjectContext: () => SubjectContext,
+	TextInserted: () => TextInserted,
+	TrackEvent: () => TrackEvent,
+	TrackPerformed: () => TrackPerformed,
+	TrackPlanned: () => TrackPlanned,
+	WheelScrolled: () => WheelScrolled
+});
+/** A page opened, and the page that opened it, as a link or `window.open` does, if one did. */
+var PageOpened = class extends Schema.TaggedClass()("PageOpened", {
+	at: Schema.Finite,
+	page: Schema.String,
+	url: Schema.String,
+	opener: Schema.optional(Schema.String)
+}) {};
+/**
+* The page closed (`page`), or crashed and was closed (`crashed`). A page lost with its browser
+* has no event of its own: `Disconnected` stands for all of them.
+*/
+var PageClosed = class extends Schema.TaggedClass()("PageClosed", {
+	at: Schema.Finite,
+	page: Schema.String,
+	cause: Schema.Literals(["page", "crashed"])
+}) {};
+/**
+* A tab the site opened that the library could not track, as its registration failed with
+* `detail`. A tab that closed as it opened has no event.
+*/
+var PageUntracked = class extends Schema.TaggedClass()("PageUntracked", {
+	at: Schema.Finite,
+	url: Schema.String,
+	detail: Schema.String
+}) {};
+/**
+* The page's main frame moved to `url`: into a new document, or within the current one
+* (`sameDocument`), as `pushState` and fragment links do. Frames carry the document they followed.
+*/
+var Navigated = class extends Schema.TaggedClass()("Navigated", {
+	at: Schema.Finite,
+	page: Schema.String,
+	url: Schema.String,
+	/**
+	* The page's documents counted from 0, the one it had when this browser began tracking it, one
+	* more for each new document. The count belongs to the page within one `Browser` and starts at
+	* 0 again on a new connection, so compare it only with the same page's in the same browser.
+	*/
+	document: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
+	sameDocument: Schema.Boolean
+}) {};
+/** The page's document finished parsing (`domcontentloaded`) or loading (`load`). */
+var PageLoaded = class extends Schema.TaggedClass()("PageLoaded", {
+	at: Schema.Finite,
+	page: Schema.String,
+	state: Schema.Literals(["domcontentloaded", "load"])
+}) {};
+/**
+* Why a browser was lost to its owner: its connection dropped (`connection`), its provider ended
+* its session, at or after the session's `expiresAt` (`session`), or its owner released it.
+*/
+const DisconnectCause = Schema.Literals([
+	"connection",
+	"session",
+	"released"
+]);
+/** The browser was lost to its owner, with every page in it. It happens once. */
+var Disconnected = class extends Schema.TaggedClass()("Disconnected", {
+	at: Schema.Finite,
+	cause: DisconnectCause
+}) {};
+/** The provider ends this browser's session at `expiresAt`, a wall-clock instant. */
+var SessionEnding = class extends Schema.TaggedClass()("SessionEnding", {
+	at: Schema.Finite,
+	expiresAt: Schema.DateTimeUtc
+}) {};
+/**
+* The words around a subject that say which one it is, each bound to it in the page rather than
+* read off nearby text later. In a table, `row` is the row's header or first cell with text and
+* `column` the header over it; elsewhere, `label` is the words just before it in its row, item,
+* group or block, at most 40 characters. `heading` is the nearest heading above it, left out for
+* what is pinned to the viewport. Row, column and heading are at most 60 characters.
+*/
+const SubjectContext = Schema.Struct({
+	row: Schema.optional(Schema.String),
+	column: Schema.optional(Schema.String),
+	label: Schema.optional(Schema.String),
+	heading: Schema.optional(Schema.String)
+});
+/**
+* What an input acted on, or what `Page.find` found, as the page named it then: its role (null
+* when it has none), its accessible name (empty when it has none), its lowercase tag and its
+* context. For a point, it is the control under the point, or else the element painted there.
+* Unlike a ref, it keeps its meaning after the page changes.
+*/
+var Subject = class extends Schema.Class("effect-browser/Subject")({
+	role: Schema.NullOr(Schema.String),
+	name: Schema.String,
+	tag: Schema.String,
+	context: SubjectContext
+}) {};
+const Button = Schema.Literals([
+	"left",
+	"right",
+	"middle"
+]);
+/** An element's box in viewport CSS pixels; it may lie partly or wholly outside the viewport. */
+const Box = Schema.Struct({
+	x: Schema.Finite,
+	y: Schema.Finite,
+	width: Schema.Finite,
+	height: Schema.Finite
+});
+/**
+* What else an action was asked, where it changes what the action does: a click's button, count
+* and hold, how `type` enters its text, how often and how long `press` holds its keys, how far
+* `scroll` moves, and the options `select` chose. Only a completed action records them.
+*/
+const ActionOptions = Schema.Struct({
+	button: Schema.optional(Button),
+	clickCount: Schema.optional(Schema.Finite),
+	holdMillis: Schema.optional(Schema.Finite),
+	replace: Schema.optional(Schema.Boolean),
+	submit: Schema.optional(Schema.Boolean),
+	times: Schema.optional(Schema.Finite),
+	dx: Schema.optional(Schema.Finite),
+	dy: Schema.optional(Schema.Finite),
+	values: Schema.optional(Schema.Array(Schema.String))
+});
+/**
+* One page operation ended, including one its caller interrupted (`error: "interrupted"`).
+* `target` is what the caller asked for: a ref, a point, a URL or keys, and `options` the rest.
+* `subject` is what an element or point action found there, and `to` where a drag ended; an
+* action that failed before finding its target has neither. Point actions carry the viewport
+* point they used. `correlation` is the id its caller gave it with `Page.correlate`, such as a
+* model's tool call id.
+*/
+var Action = class extends Schema.TaggedClass()("Action", {
+	at: Schema.Finite,
+	startedAt: Schema.Finite,
+	page: Schema.String,
+	name: Schema.String,
+	correlation: Schema.optional(Schema.String),
+	target: Schema.optional(Schema.String),
+	options: Schema.optional(ActionOptions),
+	subject: Schema.optional(Subject),
+	to: Schema.optional(Subject),
+	/** For an action at a point, the box of what it found there. */
+	box: Schema.optional(Box),
+	text: Schema.optional(Schema.String),
+	x: Schema.optional(Schema.Finite),
+	y: Schema.optional(Schema.Finite),
+	ok: Schema.Boolean,
+	dispatched: Schema.Boolean,
+	error: Schema.optional(Schema.String)
+}) {};
+const Sequence = Schema.Int.check(Schema.isGreaterThan(0));
+/** One whole glide, published before its first input. Offsets use the host monotonic clock. */
+var TrackPlanned = class extends Schema.TaggedClass()("TrackPlanned", {
+	at: Schema.Finite,
+	page: Schema.String,
+	from: Point,
+	samples: Plan
+}) {};
+/**
+* The submitted prefix of a glide. `plan` is its TrackPlanned envelope sequence; `dispatched`
+* counts samples. `complete` means every sample was submitted, not acknowledged by the browser.
+* The terminal point clips a canceled plan so a compositor never draws its unrealized future.
+*/
+var TrackPerformed = class extends Schema.TaggedClass()("TrackPerformed", {
+	at: Schema.Finite,
+	page: Schema.String,
+	plan: Sequence,
+	dispatched: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
+	x: Schema.Finite,
+	y: Schema.Finite,
+	complete: Schema.Boolean
+}) {};
+var PointerPressed = class extends Schema.TaggedClass()("PointerPressed", {
+	at: Schema.Finite,
+	page: Schema.String,
+	x: Schema.Finite,
+	y: Schema.Finite,
+	button: Button,
+	clickCount: Schema.Int.check(Schema.isGreaterThan(0))
+}) {};
+var PointerReleased = class extends Schema.TaggedClass()("PointerReleased", {
+	at: Schema.Finite,
+	page: Schema.String,
+	x: Schema.Finite,
+	y: Schema.Finite,
+	button: Button,
+	clickCount: Schema.Int.check(Schema.isGreaterThan(0))
+}) {};
+var WheelScrolled = class extends Schema.TaggedClass()("WheelScrolled", {
+	at: Schema.Finite,
+	page: Schema.String,
+	x: Schema.Finite,
+	y: Schema.Finite,
+	dx: Schema.Finite,
+	dy: Schema.Finite
+}) {};
+var KeyChanged = class extends Schema.TaggedClass()("KeyChanged", {
+	at: Schema.Finite,
+	page: Schema.String,
+	key: Schema.String,
+	phase: Schema.Literals(["down", "up"])
+}) {};
+/** Literal text insertion has no corresponding key events, including Unicode and newlines. */
+var TextInserted = class extends Schema.TaggedClass()("TextInserted", {
+	at: Schema.Finite,
+	page: Schema.String,
+	text: Schema.String
+}) {};
+/** The target's CSS cursor, obtained during target resolution without another browser call. */
+var CursorChanged = class extends Schema.TaggedClass()("CursorChanged", {
+	at: Schema.Finite,
+	page: Schema.String,
+	cursor: Schema.String
+}) {};
+const TrackEvent = Schema.Union([
+	TrackPlanned,
+	TrackPerformed,
+	PointerPressed,
+	PointerReleased,
+	WheelScrolled,
+	KeyChanged,
+	TextInserted,
+	CursorChanged
+]);
+/**
+* A JavaScript dialog appeared and was answered: an alert or a leave-page prompt accepted, a
+* confirm or a prompt dismissed, as if its Cancel were pressed.
+*/
+var DialogShown = class extends Schema.TaggedClass()("DialogShown", {
+	at: Schema.Finite,
+	page: Schema.String,
+	kind: Schema.String,
+	message: Schema.String,
+	answer: Schema.Literals(["accepted", "dismissed"])
+}) {};
+const BrowserEvent = Schema.Union([
+	PageOpened,
+	PageClosed,
+	PageUntracked,
+	Navigated,
+	PageLoaded,
+	Action,
+	...TrackEvent.members,
+	DialogShown,
+	Disconnected,
+	SessionEnding
+]);
+/** A position in the browser's one replayable event history. Sequences begin at one. */
+var RecordedEvent = class extends Schema.Class("effect-browser/RecordedEvent")({
+	sequence: Sequence,
+	event: BrowserEvent
+}) {};
+//#endregion
+export { Action, ActionOptions, Box, BrowserEvent, CursorChanged, DialogShown, DisconnectCause, Disconnected, KeyChanged, Navigated, PageClosed, PageLoaded, PageOpened, PageUntracked, PointerPressed, PointerReleased, RecordedEvent, SessionEnding, Subject, SubjectContext, TextInserted, TrackEvent, TrackPerformed, TrackPlanned, WheelScrolled, BrowserEvent_exports as t };
+
+//# sourceMappingURL=BrowserEvent.mjs.map

package/dist/BrowserEvent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserEvent.mjs","names":["Motion.Point","Motion.Plan"],"sources":["../src/BrowserEvent.ts"],"sourcesContent":["/**\n * What happened in a browser, in order: pages and their documents, actions, pointer motion, and\n * the browser's own end.\n *\n * Every event carries `at`, host monotonic milliseconds from the owning browser’s Effect `Clock`.\n * This clock also stamps screencast frames’ `receivedAt` and moments, so wall-clock corrections\n * cannot disturb their order. Compare stamps only within the same browser clock, not across hosts.\n * A page is named by its CDP target id, which stays the same across reconnects, and every URL is\n * reported without its userinfo or known secret parameters.\n *\n * @since 0.3.0\n */\nimport { Schema } from \"effect\";\n\nimport * as Motion from \"./Motion.ts\";\n\n/** A page opened, and the page that opened it, as a link or `window.open` does, if one did. */\nexport class PageOpened extends Schema.TaggedClass<PageOpened>()(\"PageOpened\", {\n  at: Schema.Finite,\n  page: Schema.String,\n  url: Schema.String,\n  opener: Schema.optional(Schema.String),\n}) {}\n\n/**\n * The page closed (`page`), or crashed and was closed (`crashed`). A page lost with its browser\n * has no event of its own: `Disconnected` stands for all of them.\n */\nexport class PageClosed extends Schema.TaggedClass<PageClosed>()(\"PageClosed\", {\n  at: Schema.Finite,\n  page: Schema.String,\n  cause: Schema.Literals([\"page\", \"crashed\"]),\n}) {}\n\n/**\n * A tab the site opened that the library could not track, as its registration failed with\n * `detail`. A tab that closed as it opened has no event.\n */\nexport class PageUntracked extends Schema.TaggedClass<PageUntracked>()(\"PageUntracked\", {\n  at: Schema.Finite,\n  url: Schema.String,\n  detail: Schema.String,\n}) {}\n\n/**\n * The page's main frame moved to `url`: into a new document, or within the current one\n * (`sameDocument`), as `pushState` and fragment links do. Frames carry the document they followed.\n */\nexport class Navigated extends Schema.TaggedClass<Navigated>()(\"Navigated\", {\n  at: Schema.Finite,\n  page: Schema.String,\n  url: Schema.String,\n  /**\n   * The page's documents counted from 0, the one it had when this browser began tracking it, one\n   * more for each new document. The count belongs to the page within one `Browser` and starts at\n   * 0 again on a new connection, so compare it only with the same page's in the same browser.\n   */\n  document: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),\n  sameDocument: Schema.Boolean,\n}) {}\n\n/** The page's document finished parsing (`domcontentloaded`) or loading (`load`). */\nexport class PageLoaded extends Schema.TaggedClass<PageLoaded>()(\"PageLoaded\", {\n  at: Schema.Finite,\n  page: Schema.String,\n  state: Schema.Literals([\"domcontentloaded\", \"load\"]),\n}) {}\n\n/**\n * Why a browser was lost to its owner: its connection dropped (`connection`), its provider ended\n * its session, at or after the session's `expiresAt` (`session`), or its owner released it.\n */\nexport const DisconnectCause = Schema.Literals([\"connection\", \"session\", \"released\"]);\n\nexport type DisconnectCause = typeof DisconnectCause.Type;\n\n/** The browser was lost to its owner, with every page in it. It happens once. */\nexport class Disconnected extends Schema.TaggedClass<Disconnected>()(\"Disconnected\", {\n  at: Schema.Finite,\n  cause: DisconnectCause,\n}) {}\n\n/** The provider ends this browser's session at `expiresAt`, a wall-clock instant. */\nexport class SessionEnding extends Schema.TaggedClass<SessionEnding>()(\"SessionEnding\", {\n  at: Schema.Finite,\n  expiresAt: Schema.DateTimeUtc,\n}) {}\n\n/**\n * The words around a subject that say which one it is, each bound to it in the page rather than\n * read off nearby text later. In a table, `row` is the row's header or first cell with text and\n * `column` the header over it; elsewhere, `label` is the words just before it in its row, item,\n * group or block, at most 40 characters. `heading` is the nearest heading above it, left out for\n * what is pinned to the viewport. Row, column and heading are at most 60 characters.\n */\nexport const SubjectContext = Schema.Struct({\n  row: Schema.optional(Schema.String),\n  column: Schema.optional(Schema.String),\n  label: Schema.optional(Schema.String),\n  heading: Schema.optional(Schema.String),\n});\n\nexport type SubjectContext = typeof SubjectContext.Type;\n\n/**\n * What an input acted on, or what `Page.find` found, as the page named it then: its role (null\n * when it has none), its accessible name (empty when it has none), its lowercase tag and its\n * context. For a point, it is the control under the point, or else the element painted there.\n * Unlike a ref, it keeps its meaning after the page changes.\n */\nexport class Subject extends Schema.Class<Subject>(\"effect-browser/Subject\")({\n  role: Schema.NullOr(Schema.String),\n  name: Schema.String,\n  tag: Schema.String,\n  context: SubjectContext,\n}) {}\n\nconst Button = Schema.Literals([\"left\", \"right\", \"middle\"]);\n\n/** An element's box in viewport CSS pixels; it may lie partly or wholly outside the viewport. */\nexport const Box = Schema.Struct({\n  x: Schema.Finite,\n  y: Schema.Finite,\n  width: Schema.Finite,\n  height: Schema.Finite,\n});\n\nexport type Box = typeof Box.Type;\n\n/**\n * What else an action was asked, where it changes what the action does: a click's button, count\n * and hold, how `type` enters its text, how often and how long `press` holds its keys, how far\n * `scroll` moves, and the options `select` chose. Only a completed action records them.\n */\nexport const ActionOptions = Schema.Struct({\n  button: Schema.optional(Button),\n  clickCount: Schema.optional(Schema.Finite),\n  holdMillis: Schema.optional(Schema.Finite),\n  replace: Schema.optional(Schema.Boolean),\n  submit: Schema.optional(Schema.Boolean),\n  times: Schema.optional(Schema.Finite),\n  dx: Schema.optional(Schema.Finite),\n  dy: Schema.optional(Schema.Finite),\n  values: Schema.optional(Schema.Array(Schema.String)),\n});\n\nexport type ActionOptions = typeof ActionOptions.Type;\n\n/**\n * One page operation ended, including one its caller interrupted (`error: \"interrupted\"`).\n * `target` is what the caller asked for: a ref, a point, a URL or keys, and `options` the rest.\n * `subject` is what an element or point action found there, and `to` where a drag ended; an\n * action that failed before finding its target has neither. Point actions carry the viewport\n * point they used. `correlation` is the id its caller gave it with `Page.correlate`, such as a\n * model's tool call id.\n */\nexport class Action extends Schema.TaggedClass<Action>()(\"Action\", {\n  at: Schema.Finite,\n  startedAt: Schema.Finite,\n  page: Schema.String,\n  name: Schema.String,\n  correlation: Schema.optional(Schema.String),\n  target: Schema.optional(Schema.String),\n  options: Schema.optional(ActionOptions),\n  subject: Schema.optional(Subject),\n  to: Schema.optional(Subject),\n  /** For an action at a point, the box of what it found there. */\n  box: Schema.optional(Box),\n  text: Schema.optional(Schema.String),\n  x: Schema.optional(Schema.Finite),\n  y: Schema.optional(Schema.Finite),\n  ok: Schema.Boolean,\n  dispatched: Schema.Boolean,\n  error: Schema.optional(Schema.String),\n}) {}\n\nconst Sequence = Schema.Int.check(Schema.isGreaterThan(0));\n\n/** One whole glide, published before its first input. Offsets use the host monotonic clock. */\nexport class TrackPlanned extends Schema.TaggedClass<TrackPlanned>()(\"TrackPlanned\", {\n  at: Schema.Finite,\n  page: Schema.String,\n  from: Motion.Point,\n  samples: Motion.Plan,\n}) {}\n\n/**\n * The submitted prefix of a glide. `plan` is its TrackPlanned envelope sequence; `dispatched`\n * counts samples. `complete` means every sample was submitted, not acknowledged by the browser.\n * The terminal point clips a canceled plan so a compositor never draws its unrealized future.\n */\nexport class TrackPerformed extends Schema.TaggedClass<TrackPerformed>()(\"TrackPerformed\", {\n  at: Schema.Finite,\n  page: Schema.String,\n  plan: Sequence,\n  dispatched: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),\n  x: Schema.Finite,\n  y: Schema.Finite,\n  complete: Schema.Boolean,\n}) {}\n\nexport class PointerPressed extends Schema.TaggedClass<PointerPressed>()(\"PointerPressed\", {\n  at: Schema.Finite,\n  page: Schema.String,\n  x: Schema.Finite,\n  y: Schema.Finite,\n  button: Button,\n  clickCount: Schema.Int.check(Schema.isGreaterThan(0)),\n}) {}\n\nexport class PointerReleased extends Schema.TaggedClass<PointerReleased>()(\"PointerReleased\", {\n  at: Schema.Finite,\n  page: Schema.String,\n  x: Schema.Finite,\n  y: Schema.Finite,\n  button: Button,\n  clickCount: Schema.Int.check(Schema.isGreaterThan(0)),\n}) {}\n\nexport class WheelScrolled extends Schema.TaggedClass<WheelScrolled>()(\"WheelScrolled\", {\n  at: Schema.Finite,\n  page: Schema.String,\n  x: Schema.Finite,\n  y: Schema.Finite,\n  dx: Schema.Finite,\n  dy: Schema.Finite,\n}) {}\n\nexport class KeyChanged extends Schema.TaggedClass<KeyChanged>()(\"KeyChanged\", {\n  at: Schema.Finite,\n  page: Schema.String,\n  key: Schema.String,\n  phase: Schema.Literals([\"down\", \"up\"]),\n}) {}\n\n/** Literal text insertion has no corresponding key events, including Unicode and newlines. */\nexport class TextInserted extends Schema.TaggedClass<TextInserted>()(\"TextInserted\", {\n  at: Schema.Finite,\n  page: Schema.String,\n  text: Schema.String,\n}) {}\n\n/** The target's CSS cursor, obtained during target resolution without another browser call. */\nexport class CursorChanged extends Schema.TaggedClass<CursorChanged>()(\"CursorChanged\", {\n  at: Schema.Finite,\n  page: Schema.String,\n  cursor: Schema.String,\n}) {}\n\nexport const TrackEvent = Schema.Union([\n  TrackPlanned,\n  TrackPerformed,\n  PointerPressed,\n  PointerReleased,\n  WheelScrolled,\n  KeyChanged,\n  TextInserted,\n  CursorChanged,\n]);\n\nexport type TrackEvent = typeof TrackEvent.Type;\n\n/**\n * A JavaScript dialog appeared and was answered: an alert or a leave-page prompt accepted, a\n * confirm or a prompt dismissed, as if its Cancel were pressed.\n */\nexport class DialogShown extends Schema.TaggedClass<DialogShown>()(\"DialogShown\", {\n  at: Schema.Finite,\n  page: Schema.String,\n  kind: Schema.String,\n  message: Schema.String,\n  answer: Schema.Literals([\"accepted\", \"dismissed\"]),\n}) {}\n\nexport const BrowserEvent = Schema.Union([\n  PageOpened,\n  PageClosed,\n  PageUntracked,\n  Navigated,\n  PageLoaded,\n  Action,\n  ...TrackEvent.members,\n  DialogShown,\n  Disconnected,\n  SessionEnding,\n]);\n\nexport type BrowserEvent = typeof BrowserEvent.Type;\n\n/** A position in the browser's one replayable event history. Sequences begin at one. */\nexport class RecordedEvent extends Schema.Class<RecordedEvent>(\"effect-browser/RecordedEvent\")({\n  sequence: Sequence,\n  event: BrowserEvent,\n}) {}\n"],"mappings":"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"}

package/dist/Cdp.d.mts

@@ -0,0 +1,32 @@
+import { t as BrowserError } from "./BrowserError-DXXIA6Rk.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 { r as quoted } from "./url-CcL0K7S0.mjs";
+import { o as reasonOf, s as undispatched } from "./context-DAYjATgC.mjs";
+import { r as make, t as Browser } from "./Browser-B5AV7zPS.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":";;;;AAOA,MAAa,UAAU,UAA8B,KAAK,UAAU,SAAS,EAAE;;AAG/E,MAAa,SAAS,SAAkB,UAA8B;CACpE,MAAM,OAAO,QAAQ,QAAQ,QAAQ;CAErC,IAAI,QAAQ,SAAS,IAAI,OAAO,GAAG,KAAK,GAAG,KAAK,UAAU,QAAQ,IAAI;CAEtE,OAAO,UAAU,KAAA,IAAY,OAAO,GAAG,KAAK,MAAM;AACpD;;AAGA,MAAa,SAAS,EAAE,KAAK,QAAQ,OAAO,WAA2B,UAAU,UAAU;CACzF,MAAM,QAAQ;EACZ,QAAQ,KAAA,IAAY,KAAK,OAAO,OAAO,GAAG;EAC1C,WAAW,KAAA,KAAa,UAAU,KAAK,UAAU,OAAO,MAAM;EAC9D,UAAU,KAAA,IAAY,KAAK,UAAU,OAAO,KAAK;EACjD,YAAY,KAAA,KAAa,UAAU,KAAK,SAAS,OAAO,OAAO;CACjE,CAAC,CAAC,QAAQ,SAAS,SAAS,EAAE;CAE9B,OAAO,MAAM,WAAW,IAAI,KAAK,KAAK,MAAM,KAAK,IAAI,EAAE;AACzD;;AAGA,MAAaA,cAAY,QAAgB,UAAU,UAAkB;CACnE,MAAM,EAAE,SAAS,QAAQ,OAAO,OAAO,QAAQ,YAAY;CAC3D,MAAM,UAAU,MAAM,QAAQ,SAAS,OAAO;CAE9C,MAAM,QACJ,WAAW,KAAA,KAAa,YAAY,KAAA,IAAY,KAAK,UAAU,OAAO,MAAM;CAE9E,MAAM,QAAQ,QAAQ,IAAI,gBAAgB,MAAM,QAAQ,MAAM,KAAK;CAEnE,QAAQ,OAAO,MAAf;EACE,KAAK,SACH,OAAO,aAAa,WAAW,KAAA,IAAY,cAAc,GAAG,OAAO,MAAM,EAAE,SAAS,GAAG,OAAO,KAAK;EACrG,KAAK,SAAS;GACZ,MAAM,QAAQ,MAAM,SAAS,KAAA,CAAS;GAEtC,IAAI,UAAU,aAAa,UAAU,eAAe,OAAO,GAAG,MAAM,UAAU;GAC9E,IAAI,UAAU,KAAA,KAAa,UAAU,IAAI,OAAO,GAAG,MAAM;GAEzD,OAAO,UAAU,UAAU,WAAW,KAAA,KAAa,WAAW,KAC1D,GAAG,MAAM,OAAO,UAAU,SAAS,WAAW,UAAU,OAAO,KAAK,QACpE,GAAG,MAAM,gBAAgB,OAAO,MAAM,EAAE,MAAM,OAAO,KAAK;EAChE;EACA,KAAK,YACH,OAAO,GAAG,OAAO,KAAK,EAAE,WAAW;EACrC,KAAK,eACH,OAAO,GAAG,OAAO,MAAM,EAAE,cAAc;EACzC,KAAK,SACH,OAAO,GAAG,OAAO,KAAK,EAAE,+BAA+B;EACzD,KAAK,QACH,OAAO,WAAW,KAAA,IACd,aAAa,OAAO,KAAK,IAAI,UAAU,UACvC,GAAG,OAAO,MAAM,EAAE,UAAU,OAAO,KAAK,IAAI,UAAU;CAC9D;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACrCA,MAAa,OAAO,OAAO,SAAS;CAAC;CAAQ;CAAY;CAAe;CAAS;CAAS;AAAO,CAAC;AAIlG,IAAa,SAAb,cAA4B,OAAO,MAAc,uBAAuB,CAAC,CAAC;CACxE,MAAM;;;;;CAKN,SAAS;;CAET,WAAW,OAAO;;CAElB,IAAI,OAAO;;;;;CAKX,QAAQ,OAAO,SAAS,OAAO,MAAM;;CAErC,OAAO,OAAO,SAAS,OAAO,MAAM;;CAEpC,OAAO,OAAO,IAAI,MAAM,OAAO,cAAc,CAAC,CAAC;;CAE/C,QAAQ,OAAO,SAAS,OAAO,MAAM;CACrC,SAAS,OAAO,SAAS,OAAO,MAAM;;CAEtC,SAAS,OAAO,SAAS,OAAO,MAAM;;;;;;;;;;CAUtC,OAAO,OAAO,SAAS,OAAO,MAAM;AACtC,CAAC,CAAC,CAAC,CAAC;AAEJ,IAAa,UAAb,cAA6B,OAAO,MAAe,wBAAwB,CAAC,CAAC;;CAE3E,UAAU,OAAO,IAAI,MAAM,OAAO,uBAAuB,CAAC,CAAC;;CAE3D,MAAM,OAAO;;CAEb,OAAO,OAAO;;;;;CAKd,QAAQ,OAAO;;CAEf,SAAS,OAAO,IAAI,MAAM,OAAO,uBAAuB,CAAC,CAAC;;CAE1D,SAAS,OAAO,MAAM,MAAM;AAC9B,CAAC,CAAC,CAAC,CAAC;;AAGJ,MAAa,YAAY,WAA2BC,WAAe,MAAM"}