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

package/dist/BrowserError.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserError.mjs","names":[],"sources":["../src/BrowserError.ts"],"sourcesContent":["/**\n * The one error every browser operation fails with.\n *\n * `reason` says what went wrong and `dispatched` says whether the action's own input (a press,\n * key, wheel, selection or hover, not the pointer travelling toward a press) or a navigation\n * reached the browser first. `consequence` says what that leaves: what was lost, and whether the\n * call can be repeated. `message` is a sentence for operators.\n *\n * @since 0.3.0\n */\nimport { Schema } from \"effect\";\n\nimport { DisconnectCause } from \"./BrowserEvent.ts\";\n\n/** The operation did not finish in time. */\nexport class Timeout extends Schema.TaggedError<Timeout>()(\"Timeout\", {\n  millis: Schema.Finite,\n}) {\n  override get message() {\n    return `timed out after ${this.millis} ms`;\n  }\n}\n\n/**\n * The operation waited its turn behind others on its page and was not given one in time, or was\n * asked to fail fast: the page may be well, only busy.\n */\nexport class Busy extends Schema.TaggedError<Busy>()(\"Busy\", {\n  waitedMillis: Schema.Finite,\n  /** The operations ahead of it: those holding the page and those asked before it. */\n  ahead: Schema.Int,\n}) {\n  override get message() {\n    const others = this.ahead === 1 ? \"operation\" : \"operations\";\n\n    return `the page was busy: it waited ${this.waitedMillis} ms behind ${this.ahead} other ${others}`;\n  }\n}\n\n/** Input is withheld by a scoped suspension; nothing was dispatched. */\nexport class Suspended extends Schema.TaggedError<Suspended>()(\"Suspended\", {}) {\n  override get message() {\n    return \"browser input is suspended\";\n  }\n}\n\n/** The browser has as many pages open as `maxPages` allows, and none closed in time. */\nexport class Limit extends Schema.TaggedError<Limit>()(\"Limit\", {\n  maxPages: Schema.Int,\n}) {\n  override get message() {\n    return `the browser already has ${this.maxPages} pages open, as many as it allows`;\n  }\n}\n\n/** A ref from an earlier snapshot no longer names an element on the page. */\nexport class StaleRef extends Schema.TaggedError<StaleRef>()(\"StaleRef\", {\n  ref: Schema.String,\n}) {\n  override get message() {\n    return `${this.ref} is not on the page any more`;\n  }\n}\n\n/** What the operation looked for is not on the page. */\nexport class NotFound extends Schema.TaggedError<NotFound>()(\"NotFound\", {\n  target: Schema.String,\n}) {\n  override get message() {\n    return `${this.target} was not found`;\n  }\n}\n\n/** The element exists but cannot take this input: covered, disabled, hidden or the wrong kind. */\nexport class NotActionable extends Schema.TaggedError<NotActionable>()(\"NotActionable\", {\n  detail: Schema.String,\n}) {\n  override get message() {\n    return this.detail;\n  }\n}\n\n/** A navigation failed, for example on a DNS error or a refused connection. */\nexport class NavigationFailed extends Schema.TaggedError<NavigationFailed>()(\"NavigationFailed\", {\n  url: Schema.String,\n  detail: Schema.String,\n}) {\n  override get message() {\n    return `could not load ${this.url}: ${this.detail}`;\n  }\n}\n\nconst closedBy = {\n  page: \"the page was closed\",\n  crashed: \"the page crashed\",\n  connection: \"the connection to the browser was lost\",\n  session: \"the browser's session ended\",\n  released: \"the browser was released\",\n};\n\n/**\n * The page is gone: it was closed (`page`) or crashed, or its browser was lost for one of the\n * browser's `DisconnectCause`s.\n */\nexport class Closed extends Schema.TaggedError<Closed>()(\"Closed\", {\n  cause: Schema.Literals([\"page\", \"crashed\", ...DisconnectCause.literals]),\n}) {\n  override get message() {\n    return closedBy[this.cause];\n  }\n}\n\n/** The request itself is invalid, such as a ref that is not a ref or a point off the screen. */\nexport class InvalidRequest extends Schema.TaggedError<InvalidRequest>()(\"InvalidRequest\", {\n  detail: Schema.String,\n}) {\n  override get message() {\n    return this.detail;\n  }\n}\n\n/** The input policy refused the action before any input was sent. */\nexport class PolicyDenied extends Schema.TaggedError<PolicyDenied>()(\"PolicyDenied\", {\n  detail: Schema.String,\n  /** What made the policy deny, such as the failure of the judge it asked. */\n  cause: Schema.optional(Schema.Defect()),\n}) {\n  override get message() {\n    return `the input policy denied this action: ${this.detail}`;\n  }\n}\n\n/** The input policy did not release its hold within its own bound. */\nexport class PolicyTimeout extends Schema.TaggedError<PolicyTimeout>()(\"PolicyTimeout\", {\n  millis: Schema.Finite,\n}) {\n  override get message() {\n    return `the input policy did not allow this action within ${this.millis} ms`;\n  }\n}\n\n/** The requested event cursor fell behind the browser's bounded replay history. */\nexport class EventHistoryExpired extends Schema.TaggedError<EventHistoryExpired>()(\n  \"EventHistoryExpired\",\n  {\n    after: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),\n    oldest: Schema.Int.check(Schema.isGreaterThan(0)),\n    latest: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),\n  },\n) {\n  override get message() {\n    return `event history after ${this.after} expired; retained sequences are ${this.oldest}–${this.latest}`;\n  }\n}\n\n/** The browser, the connection or the provider failed in a way the other reasons do not cover. */\nexport class Failed extends Schema.TaggedError<Failed>()(\"Failed\", {\n  detail: Schema.String,\n}) {\n  override get message() {\n    return this.detail;\n  }\n}\n\nexport const Reason = Schema.Union([\n  Timeout,\n  Busy,\n  Suspended,\n  Limit,\n  StaleRef,\n  NotFound,\n  NotActionable,\n  NavigationFailed,\n  Closed,\n  InvalidRequest,\n  PolicyDenied,\n  PolicyTimeout,\n  EventHistoryExpired,\n  Failed,\n]);\n\nexport type Reason = typeof Reason.Type;\n\nexport class BrowserError extends Schema.TaggedError<BrowserError>()(\"BrowserError\", {\n  operation: Schema.String,\n  reason: Reason,\n  dispatched: Schema.Boolean,\n}) {\n  override get message() {\n    return `${this.operation} failed${this.dispatched ? \" after it was sent\" : \"\"}: ${this.reason.message}`;\n  }\n}\n\n/**\n * What a failure leaves. `lost` is `\"page\"` when the page is gone and its browser stands, and\n * `\"session\"` when the browser is gone with its pages. `repeat` says whether the call can be made\n * again, on what still stands: `\"safe\"`, as nothing reached the browser; `\"check\"`, as it may have\n * taken effect, so look first, as an `Expect` attempt does; `\"pointless\"`, as it fails again unless\n * something changes, such as\n * a new ref; or `\"resume\"`, reading events again from a newer cursor.\n */\nexport interface Consequence {\n  readonly lost: \"nothing\" | \"page\" | \"session\";\n  readonly repeat: \"safe\" | \"check\" | \"pointless\" | \"resume\";\n}\n\n/** What `error` leaves, from its reason and whether it was dispatched alone. */\nexport const consequence = ({ reason, dispatched }: BrowserError): Consequence => {\n  const repeat = dispatched ? \"check\" : \"safe\";\n\n  switch (reason._tag) {\n    case \"Closed\":\n      return {\n        lost: reason.cause === \"page\" || reason.cause === \"crashed\" ? \"page\" : \"session\",\n        repeat,\n      };\n    case \"Busy\":\n    case \"Suspended\":\n    case \"Timeout\":\n    case \"Failed\":\n    case \"NavigationFailed\":\n      return { lost: \"nothing\", repeat };\n    case \"EventHistoryExpired\":\n      return { lost: \"nothing\", repeat: \"resume\" };\n    case \"StaleRef\":\n    case \"NotFound\":\n    case \"NotActionable\":\n    case \"InvalidRequest\":\n    case \"Limit\":\n    case \"PolicyDenied\":\n    case \"PolicyTimeout\":\n      return { lost: \"nothing\", repeat: \"pointless\" };\n  }\n};\n"],"mappings":"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"}

package/dist/BrowserEvent-BRu2juEz.d.mts

@@ -0,0 +1,279 @@
+import { Schema } from "effect";
+declare namespace BrowserEvent_d_exports {
+  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 };
+}
+declare const PageOpened_base: Schema.Class<PageOpened, Schema.TaggedStruct<"PageOpened", {
+  readonly at: Schema.Finite;
+  readonly page: Schema.String;
+  readonly url: Schema.String;
+  readonly opener: Schema.optional<Schema.String>;
+}>, {}>;
+/** A page opened, and the page that opened it, as a link or `window.open` does, if one did. */
+declare class PageOpened extends PageOpened_base {}
+declare const PageClosed_base: Schema.Class<PageClosed, Schema.TaggedStruct<"PageClosed", {
+  readonly at: Schema.Finite;
+  readonly page: Schema.String;
+  readonly cause: Schema.Literals<readonly ["page", "crashed"]>;
+}>, {}>;
+/**
+ * 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.
+ */
+declare class PageClosed extends PageClosed_base {}
+declare const PageUntracked_base: Schema.Class<PageUntracked, Schema.TaggedStruct<"PageUntracked", {
+  readonly at: Schema.Finite;
+  readonly url: Schema.String;
+  readonly detail: Schema.String;
+}>, {}>;
+/**
+ * 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.
+ */
+declare class PageUntracked extends PageUntracked_base {}
+declare const Navigated_base: Schema.Class<Navigated, Schema.TaggedStruct<"Navigated", {
+  readonly at: Schema.Finite;
+  readonly page: Schema.String;
+  readonly 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.
+   */
+  readonly document: Schema.Int;
+  readonly sameDocument: Schema.Boolean;
+}>, {}>;
+/**
+ * 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.
+ */
+declare class Navigated extends Navigated_base {}
+declare const PageLoaded_base: Schema.Class<PageLoaded, Schema.TaggedStruct<"PageLoaded", {
+  readonly at: Schema.Finite;
+  readonly page: Schema.String;
+  readonly state: Schema.Literals<readonly ["domcontentloaded", "load"]>;
+}>, {}>;
+/** The page's document finished parsing (`domcontentloaded`) or loading (`load`). */
+declare class PageLoaded extends PageLoaded_base {}
+/**
+ * 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.
+ */
+declare const DisconnectCause: Schema.Literals<readonly ["connection", "session", "released"]>;
+type DisconnectCause = typeof DisconnectCause.Type;
+declare const Disconnected_base: Schema.Class<Disconnected, Schema.TaggedStruct<"Disconnected", {
+  readonly at: Schema.Finite;
+  readonly cause: Schema.Literals<readonly ["connection", "session", "released"]>;
+}>, {}>;
+/** The browser was lost to its owner, with every page in it. It happens once. */
+declare class Disconnected extends Disconnected_base {}
+declare const SessionEnding_base: Schema.Class<SessionEnding, Schema.TaggedStruct<"SessionEnding", {
+  readonly at: Schema.Finite;
+  readonly expiresAt: Schema.DateTimeUtc;
+}>, {}>;
+/** The provider ends this browser's session at `expiresAt`, a wall-clock instant. */
+declare class SessionEnding extends SessionEnding_base {}
+/**
+ * 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.
+ */
+declare const SubjectContext: Schema.Struct<{
+  readonly row: Schema.optional<Schema.String>;
+  readonly column: Schema.optional<Schema.String>;
+  readonly label: Schema.optional<Schema.String>;
+  readonly heading: Schema.optional<Schema.String>;
+}>;
+type SubjectContext = typeof SubjectContext.Type;
+declare const Subject_base: Schema.Class<Subject, Schema.Struct<{
+  readonly role: Schema.NullOr<Schema.String>;
+  readonly name: Schema.String;
+  readonly tag: Schema.String;
+  readonly context: Schema.Struct<{
+    readonly row: Schema.optional<Schema.String>;
+    readonly column: Schema.optional<Schema.String>;
+    readonly label: Schema.optional<Schema.String>;
+    readonly 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.
+ */
+declare class Subject extends Subject_base {}
+/** An element's box in viewport CSS pixels; it may lie partly or wholly outside the viewport. */
+declare const Box: Schema.Struct<{
+  readonly x: Schema.Finite;
+  readonly y: Schema.Finite;
+  readonly width: Schema.Finite;
+  readonly height: Schema.Finite;
+}>;
+type Box = typeof Box.Type;
+/**
+ * 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.
+ */
+declare const ActionOptions: Schema.Struct<{
+  readonly button: Schema.optional<Schema.Literals<readonly ["left", "right", "middle"]>>;
+  readonly clickCount: Schema.optional<Schema.Finite>;
+  readonly holdMillis: Schema.optional<Schema.Finite>;
+  readonly replace: Schema.optional<Schema.Boolean>;
+  readonly submit: Schema.optional<Schema.Boolean>;
+  readonly times: Schema.optional<Schema.Finite>;
+  readonly dx: Schema.optional<Schema.Finite>;
+  readonly dy: Schema.optional<Schema.Finite>;
+  readonly values: Schema.optional<Schema.$Array<Schema.String>>;
+}>;
+type ActionOptions = typeof ActionOptions.Type;
+declare const Action_base: Schema.Class<Action, Schema.TaggedStruct<"Action", {
+  readonly at: Schema.Finite;
+  readonly startedAt: Schema.Finite;
+  readonly page: Schema.String;
+  readonly name: Schema.String;
+  /** The address when the action ended; absent in events recorded by older releases. */
+  readonly url: Schema.optional<Schema.String>;
+  readonly correlation: Schema.optional<Schema.String>;
+  readonly target: Schema.optional<Schema.String>;
+  readonly options: Schema.optional<Schema.Struct<{
+    readonly button: Schema.optional<Schema.Literals<readonly ["left", "right", "middle"]>>;
+    readonly clickCount: Schema.optional<Schema.Finite>;
+    readonly holdMillis: Schema.optional<Schema.Finite>;
+    readonly replace: Schema.optional<Schema.Boolean>;
+    readonly submit: Schema.optional<Schema.Boolean>;
+    readonly times: Schema.optional<Schema.Finite>;
+    readonly dx: Schema.optional<Schema.Finite>;
+    readonly dy: Schema.optional<Schema.Finite>;
+    readonly values: Schema.optional<Schema.$Array<Schema.String>>;
+  }>>;
+  readonly subject: Schema.optional<typeof Subject>;
+  readonly to: Schema.optional<typeof Subject>;
+  /** For an action at a point, the box of what it found there. */
+  readonly box: Schema.optional<Schema.Struct<{
+    readonly x: Schema.Finite;
+    readonly y: Schema.Finite;
+    readonly width: Schema.Finite;
+    readonly height: Schema.Finite;
+  }>>;
+  readonly text: Schema.optional<Schema.String>;
+  readonly x: Schema.optional<Schema.Finite>;
+  readonly y: Schema.optional<Schema.Finite>;
+  readonly ok: Schema.Boolean;
+  readonly dispatched: Schema.Boolean;
+  readonly error: Schema.optional<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.
+ */
+declare class Action extends Action_base {}
+declare const TrackPlanned_base: Schema.Class<TrackPlanned, Schema.TaggedStruct<"TrackPlanned", {
+  readonly at: Schema.Finite;
+  readonly page: Schema.String;
+  readonly from: Schema.Struct<{
+    readonly x: Schema.Finite;
+    readonly y: Schema.Finite;
+  }>;
+  readonly samples: Schema.$Array<Schema.Struct<{
+    readonly x: Schema.Finite;
+    readonly y: Schema.Finite;
+    readonly afterMillis: Schema.Finite;
+  }>>;
+}>, {}>;
+/** One whole glide, published before its first input. Offsets use the host monotonic clock. */
+declare class TrackPlanned extends TrackPlanned_base {}
+declare const TrackPerformed_base: Schema.Class<TrackPerformed, Schema.TaggedStruct<"TrackPerformed", {
+  readonly at: Schema.Finite;
+  readonly page: Schema.String;
+  readonly plan: Schema.Int;
+  readonly dispatched: Schema.Int;
+  readonly x: Schema.Finite;
+  readonly y: Schema.Finite;
+  readonly complete: Schema.Boolean;
+}>, {}>;
+/**
+ * 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.
+ */
+declare class TrackPerformed extends TrackPerformed_base {}
+declare const PointerPressed_base: Schema.Class<PointerPressed, Schema.TaggedStruct<"PointerPressed", {
+  readonly at: Schema.Finite;
+  readonly page: Schema.String;
+  readonly x: Schema.Finite;
+  readonly y: Schema.Finite;
+  readonly button: Schema.Literals<readonly ["left", "right", "middle"]>;
+  readonly clickCount: Schema.Int;
+}>, {}>;
+declare class PointerPressed extends PointerPressed_base {}
+declare const PointerReleased_base: Schema.Class<PointerReleased, Schema.TaggedStruct<"PointerReleased", {
+  readonly at: Schema.Finite;
+  readonly page: Schema.String;
+  readonly x: Schema.Finite;
+  readonly y: Schema.Finite;
+  readonly button: Schema.Literals<readonly ["left", "right", "middle"]>;
+  readonly clickCount: Schema.Int;
+}>, {}>;
+declare class PointerReleased extends PointerReleased_base {}
+declare const WheelScrolled_base: Schema.Class<WheelScrolled, Schema.TaggedStruct<"WheelScrolled", {
+  readonly at: Schema.Finite;
+  readonly page: Schema.String;
+  readonly x: Schema.Finite;
+  readonly y: Schema.Finite;
+  readonly dx: Schema.Finite;
+  readonly dy: Schema.Finite;
+}>, {}>;
+declare class WheelScrolled extends WheelScrolled_base {}
+declare const KeyChanged_base: Schema.Class<KeyChanged, Schema.TaggedStruct<"KeyChanged", {
+  readonly at: Schema.Finite;
+  readonly page: Schema.String;
+  readonly key: Schema.String;
+  readonly phase: Schema.Literals<readonly ["down", "up"]>;
+}>, {}>;
+declare class KeyChanged extends KeyChanged_base {}
+declare const TextInserted_base: Schema.Class<TextInserted, Schema.TaggedStruct<"TextInserted", {
+  readonly at: Schema.Finite;
+  readonly page: Schema.String;
+  readonly text: Schema.String;
+}>, {}>;
+/** Literal text insertion has no corresponding key events, including Unicode and newlines. */
+declare class TextInserted extends TextInserted_base {}
+declare const CursorChanged_base: Schema.Class<CursorChanged, Schema.TaggedStruct<"CursorChanged", {
+  readonly at: Schema.Finite;
+  readonly page: Schema.String;
+  readonly cursor: Schema.String;
+}>, {}>;
+/** The target's CSS cursor, obtained during target resolution without another browser call. */
+declare class CursorChanged extends CursorChanged_base {}
+declare const TrackEvent: Schema.Union<readonly [typeof TrackPlanned, typeof TrackPerformed, typeof PointerPressed, typeof PointerReleased, typeof WheelScrolled, typeof KeyChanged, typeof TextInserted, typeof CursorChanged]>;
+type TrackEvent = typeof TrackEvent.Type;
+declare const DialogShown_base: Schema.Class<DialogShown, Schema.TaggedStruct<"DialogShown", {
+  readonly at: Schema.Finite;
+  readonly page: Schema.String;
+  readonly kind: Schema.String;
+  readonly message: Schema.String;
+  readonly answer: Schema.Literals<readonly ["accepted", "dismissed"]>;
+}>, {}>;
+/**
+ * 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.
+ */
+declare class DialogShown extends DialogShown_base {}
+declare const BrowserEvent: Schema.Union<readonly [typeof PageOpened, typeof PageClosed, typeof PageUntracked, typeof Navigated, typeof PageLoaded, typeof Action, typeof TrackPlanned, typeof TrackPerformed, typeof PointerPressed, typeof PointerReleased, typeof WheelScrolled, typeof KeyChanged, typeof TextInserted, typeof CursorChanged, typeof DialogShown, typeof Disconnected, typeof SessionEnding]>;
+type BrowserEvent = typeof BrowserEvent.Type;
+declare const RecordedEvent_base: Schema.Class<RecordedEvent, Schema.Struct<{
+  readonly sequence: Schema.Int;
+  readonly event: Schema.Union<readonly [typeof PageOpened, typeof PageClosed, typeof PageUntracked, typeof Navigated, typeof PageLoaded, typeof Action, typeof TrackPlanned, typeof TrackPerformed, typeof PointerPressed, typeof PointerReleased, typeof WheelScrolled, typeof KeyChanged, typeof TextInserted, typeof CursorChanged, typeof DialogShown, typeof Disconnected, typeof SessionEnding]>;
+}>, {}>;
+/** A position in the browser's one replayable event history. Sequences begin at one. */
+declare class RecordedEvent extends RecordedEvent_base {}
+//#endregion
+export { TrackEvent as C, WheelScrolled as E, TextInserted as S, TrackPlanned as T, PointerReleased as _, BrowserEvent_d_exports as a, Subject as b, DisconnectCause as c, Navigated as d, PageClosed as f, PointerPressed as g, PageUntracked as h, BrowserEvent as i, Disconnected as l, PageOpened as m, ActionOptions as n, CursorChanged as o, PageLoaded as p, Box as r, DialogShown as s, Action as t, KeyChanged as u, RecordedEvent as v, TrackPerformed as w, SubjectContext as x, SessionEnding as y };
+//# sourceMappingURL=BrowserEvent-BRu2juEz.d.mts.map

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-BRu2juEz.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,297 @@
+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,
+	/** The address when the action ended; absent in events recorded by older releases. */
+	url: Schema.optional(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  /** The address when the action ended; absent in events recorded by older releases. */\n  url: Schema.optional(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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"}