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

package/dist/context-w3NJPRLo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-w3NJPRLo.mjs","names":["make","Url.redactWithin","BrowserClock.monotonicMillis","Lane.make"],"sources":["../src/internal/input/replies.ts","../src/internal/pictures/clock.ts","../src/internal/page/context.ts"],"sourcesContent":["/**\n * Bounded input replies owned by the page, including after an action is interrupted.\n * Canceling a caller cannot cancel a protocol command already sent. The next action waits for\n * those replies, while a stopped run releases only held keys or buttons whose release was never submitted.\n */\nimport { Context, Data, Effect, type Scope } from \"effect\";\n\nimport { maximumSamples } from \"../../Motion.ts\";\n\nexport const capacity = 64;\n\nexport class InputFailure extends Data.TaggedError(\"InputFailure\")<{\n  readonly cause: unknown;\n}> {}\n\nexport interface Run {\n  /** A native call made by this operation: cancellation cannot cancel its actual reply. */\n  readonly track: <A>(reply: Promise<A>) => Promise<A>;\n  /** End ownership after the record and all this operation's native replies have settled. */\n  readonly afterIdle: (ended: () => void) => void;\n  /** Retain authority through scoped cleanup after the replies already submitted. */\n  readonly recover: (cleanup: Effect.Effect<void>, scope: Scope.Scope) => Effect.Effect<void>;\n  /** Reserve a complete stroke, including its releases, before sending its first event. */\n  readonly reserve: (commands: number) => Effect.Effect<void, InputFailure>;\n  /** Admit every sample before a motion starts its published clock; ordinary input stays bounded separately. */\n  readonly reserveMotion: (commands: number) => Effect.Effect<void, InputFailure>;\n  readonly send: (command: () => Promise<unknown>) => Effect.Effect<void, InputFailure>;\n  readonly down: (\n    key: string,\n    press: () => Promise<unknown>,\n    release: () => Promise<unknown>,\n  ) => Effect.Effect<void, InputFailure>;\n  readonly up: (key: string) => Effect.Effect<void, InputFailure>;\n  readonly drain: Effect.Effect<void, InputFailure>;\n  /** Stop future input and submit missing releases without waiting indefinitely for replies. */\n  readonly close: Effect.Effect<void>;\n}\n\n/** Native page calls join their operation's reply ownership, including script mutations. */\nexport const Current = Context.Reference<Run | undefined>(\"effect-browser/internal/input/Current\", {\n  defaultValue: () => undefined,\n});\n\nexport const make = () => {\n  const outstanding = new Set<Promise<void>>();\n\n  // A timed-out action keeps capacity until its real replies arrive. Waiting for them sends\n  // nothing, so cancellation here cannot leave a detached continuation that later types.\n  const idle = Effect.gen(function* () {\n    while (outstanding.size > 0) yield* Effect.promise(() => Promise.all(outstanding));\n  });\n\n  const begin = Effect.gen(function* () {\n    yield* idle;\n    const pending = new Set<Promise<void>>();\n    const held: Array<{ readonly key: string; readonly release: () => Promise<unknown> }> = [];\n    let failure: InputFailure | undefined;\n    let reserved = 0;\n    let closed = false;\n    const observed = new WeakMap<Promise<unknown>, { input: boolean }>();\n    const endings = new Set<() => void>();\n\n    const track = <A>(response: Promise<A>, input = false): Promise<A> => {\n      const existing = observed.get(response);\n\n      if (existing !== undefined) {\n        existing.input ||= input;\n\n        return response;\n      }\n      const entry = { input };\n\n      observed.set(response, entry);\n\n      const reply = response\n        .then(\n          () => undefined,\n          (cause: unknown) => {\n            if (entry.input) failure ??= new InputFailure({ cause });\n          },\n        )\n        .then(() => {\n          pending.delete(reply);\n          outstanding.delete(reply);\n          if (pending.size === 0) {\n            for (const end of endings) end();\n            endings.clear();\n          }\n        });\n\n      pending.add(reply);\n      outstanding.add(reply);\n\n      return response;\n    };\n\n    const requireOpen = Effect.suspend(() =>\n      closed\n        ? Effect.fail(new InputFailure({ cause: new Error(\"the input run has stopped\") }))\n        : Effect.void,\n    );\n\n    const requireSuccess = Effect.suspend(() =>\n      failure === undefined ? Effect.void : Effect.fail(failure),\n    );\n\n    const submit = (command: () => Promise<unknown>) => {\n      if (reserved < 1) throw new Error(\"input must reserve capacity before dispatch\");\n      reserved--;\n      try {\n        void track(command(), true);\n      } catch (cause) {\n        failure ??= new InputFailure({ cause });\n      }\n    };\n\n    const reserve = (commands: number, maximum: number, limit: number) =>\n      Effect.gen(function* () {\n        yield* requireOpen;\n        yield* requireSuccess;\n        if (!Number.isInteger(commands) || commands < 1 || commands > maximum)\n          return yield* Effect.die(new Error(\"invalid input reservation\"));\n        while (outstanding.size + reserved + commands > limit) {\n          yield* Effect.promise(() => Promise.race(outstanding));\n          yield* requireOpen;\n          yield* requireSuccess;\n        }\n        reserved += commands;\n      });\n\n    const run: Run = {\n      track,\n      afterIdle: (end) => {\n        if (pending.size === 0) end();\n        else endings.add(end);\n      },\n      recover: (cleanup, scope) =>\n        Effect.gen(function* () {\n          const replies = [...pending];\n          const done = Promise.withResolvers<void>();\n\n          // This reservation prevents a new action or suspension from overtaking cleanup.\n          void track(done.promise);\n          yield* Effect.promise(() => Promise.all(replies)).pipe(\n            Effect.andThen(cleanup),\n            Effect.ensuring(Effect.sync(() => done.resolve())),\n            Effect.provideService(Current, run),\n            Effect.interruptible,\n            Effect.forkIn(scope),\n          );\n        }),\n      reserve: (commands) => reserve(commands, capacity, capacity),\n      // A dense stroke cannot wait for replies midway without changing its published timing.\n      // Its finite reservation also leaves room for the ordinary pool's already-owned releases.\n      reserveMotion: (commands) => reserve(commands, maximumSamples, capacity + maximumSamples),\n      send: (command) =>\n        Effect.gen(function* () {\n          yield* requireOpen;\n          yield* requireSuccess;\n          yield* Effect.sync(() => submit(command));\n          yield* requireSuccess;\n        }),\n      down: (key, press, release) =>\n        Effect.gen(function* () {\n          yield* requireOpen;\n          yield* requireSuccess;\n          yield* Effect.sync(() => {\n            held.push({ key, release });\n            submit(press);\n          });\n          yield* requireSuccess;\n        }),\n      up: (key) =>\n        Effect.gen(function* () {\n          yield* requireOpen;\n          yield* Effect.sync(() => {\n            const index = held.findLastIndex((entry) => entry.key === key);\n            const entry = held[index];\n\n            if (entry === undefined) return;\n            // Submission owns the release, even if its reply fails. Retrying an uncertain\n            // release could run page handlers twice, so cleanup never sends it again.\n            held.splice(index, 1);\n            submit(entry.release);\n          });\n          yield* requireSuccess;\n        }),\n      drain: Effect.gen(function* () {\n        while (pending.size > 0) yield* Effect.promise(() => Promise.all(pending));\n        yield* requireSuccess;\n      }),\n      close: Effect.sync(() => {\n        if (closed) return;\n        closed = true;\n        for (const entry of held.toReversed()) submit(entry.release);\n        held.length = 0;\n        reserved = 0;\n      }),\n    };\n\n    return run;\n  });\n\n  /** `idle` lets an action wait, in its page's turn, for the page's earlier replies. */\n  return { idle, begin };\n};\n","/**\n * Host monotonic milliseconds and the browser's clock read on the owner's: estimates of their\n * offset from timed probes, how an estimate ages, and the mapping a browser's pages share.\n * `pictures.ts` takes the probes.\n */\nimport { type Clock, Duration, Effect, Option } from \"effect\";\n\n/** Read the captured owner's clock, including from native callbacks, without changing its origin. */\nexport const monotonicMillis = (clock: Clock.Clock): number =>\n  Number(clock.monotonicTimeNanosUnsafe()) / 1e6;\n\nexport interface Probe {\n  readonly hostStart: number;\n  readonly hostEnd: number;\n  readonly browserTime: number;\n}\n\nexport interface Estimate {\n  /** Browser epoch milliseconds minus the owner's host monotonic milliseconds. */\n  readonly offsetMillis: number;\n  /** Either transport direction can own the entire round trip; symmetry is not assumed. */\n  readonly uncertaintyMillis: number;\n  readonly roundTripMillis: number;\n  readonly sampledAt: number;\n}\n\n/** The fastest complete probe limits uncertainty without mistaking transit delay for clock offset. */\nexport const estimate = (probes: ReadonlyArray<Probe>): Option.Option<Estimate> => {\n  let best: Estimate | undefined;\n\n  for (const probe of probes) {\n    const roundTripMillis = probe.hostEnd - probe.hostStart;\n\n    if (\n      !Number.isFinite(probe.hostStart) ||\n      !Number.isFinite(probe.hostEnd) ||\n      !Number.isFinite(probe.browserTime) ||\n      !Number.isFinite(roundTripMillis) ||\n      roundTripMillis < 0\n    )\n      continue;\n    const sampledAt = probe.hostStart + roundTripMillis / 2;\n    const offsetMillis = probe.browserTime - sampledAt;\n\n    if (\n      !Number.isFinite(offsetMillis) ||\n      !Number.isFinite(probe.browserTime - probe.hostStart) ||\n      !Number.isFinite(probe.browserTime - probe.hostEnd)\n    )\n      continue;\n    if (best === undefined || roundTripMillis < best.roundTripMillis)\n      best = {\n        offsetMillis,\n        uncertaintyMillis: roundTripMillis / 2,\n        roundTripMillis,\n        sampledAt,\n      };\n  }\n\n  return Option.fromUndefinedOr(best);\n};\n\n// Two machines' clocks drift apart by up to about 100 parts per million, so an estimate says this\n// much less about the offset for each millisecond of its age.\nconst driftPerMillis = 1e-4;\n\n/** An estimate's uncertainty at `hostTime`, wider the further that is from when it was sampled. */\nexport const uncertaintyAt = (estimate: Estimate, hostTime: number): number =>\n  estimate.uncertaintyMillis + Math.abs(hostTime - estimate.sampledAt) * driftPerMillis;\n\n// Ten seconds widen an estimate by a millisecond, far less than a remote round trip, so it is\n// measured again no more often than this.\nconst renewAfter = Duration.seconds(10);\n\n/**\n * The browser's one epoch mapping, shared by its pages, input runs and capture generations. It is\n * measured on first need, by the first capture, never ahead of it.\n */\nexport interface Mapping {\n  /** The latest estimate, without measuring: input uses it, and never waits for one. */\n  readonly latest: () => Estimate | undefined;\n  /** The latest estimate, measured through `measure` only while the browser has none. */\n  readonly current: <E>(measure: Effect.Effect<Estimate, E>) => Effect.Effect<Estimate, E>;\n  /**\n   * Measure again once ten seconds have passed since the latest measurement began. A failed\n   * measurement keeps the estimate, which keeps widening with its age.\n   */\n  readonly renew: <E>(measure: Effect.Effect<Estimate, E>) => Effect.Effect<void>;\n}\n\n/**\n * Whether a new measurement should replace the current estimate. Each interval contains the true\n * offset, so overlapping intervals agree and the narrower one is kept, the current one widened by\n * its age: a probe delayed behind a busy page cannot widen every tab's stamps. A disjoint\n * measurement means the clocks moved (a wall clock step, or drift between a remote browser and\n * this host), so the newer evidence wins.\n */\nexport const supersedes = (next: Estimate, current: Estimate): boolean => {\n  const aged = uncertaintyAt(current, next.sampledAt);\n\n  return (\n    next.uncertaintyMillis <= aged ||\n    Math.abs(next.offsetMillis - current.offsetMillis) > next.uncertaintyMillis + aged\n  );\n};\n\n/**\n * Every renderer of a browser reads the same host wall clock, so the offset belongs to the\n * browser rather than a page. A busy page cannot fail work that an earlier estimate can serve.\n */\nexport const mapping = (now: () => number): Mapping => {\n  let latest: Estimate | undefined;\n  let measuredAt = Number.NEGATIVE_INFINITY;\n\n  // Called where a measurement is decided, so no other can be decided before this one begins.\n  const adopt = <E>(measure: Effect.Effect<Estimate, E>) => {\n    measuredAt = now();\n\n    return measure.pipe(\n      Effect.map((estimate) => {\n        if (latest === undefined || supersedes(estimate, latest)) latest = estimate;\n\n        return latest;\n      }),\n    );\n  };\n\n  return {\n    latest: () => latest,\n    current: (measure) =>\n      Effect.suspend(() => (latest === undefined ? adopt(measure) : Effect.succeed(latest))),\n    renew: (measure) =>\n      Effect.suspend(() =>\n        latest === undefined || now() - measuredAt < Duration.toMillis(renewAfter)\n          ? Effect.void\n          : Effect.ignore(adopt(measure)),\n      ),\n  };\n};\n\nexport const toHostTime = (calibration: Estimate, browserEpochMillis: number): number =>\n  browserEpochMillis - calibration.offsetMillis;\n\n/** CDP input timestamps use seconds, unlike browser frame timestamps and the owner's clock. */\nexport const toBrowserSeconds = (calibration: Estimate, hostMillis: number): number =>\n  (hostMillis + calibration.offsetMillis) / 1000;\n","/**\n * What a page's parts share: the browser state they act on, the page's own lane, pointer and\n * clock, and how they call the browser and report its failures. The assembly in `page.ts` builds\n * one context per page.\n */\nimport {\n  Clock,\n  Context,\n  Duration,\n  Effect,\n  Fiber,\n  MutableRef,\n  Option,\n  Schema,\n  type Scope,\n} from \"effect\";\nimport type { CDPSession, Page as PlaywrightPage } from \"playwright-core\";\n\nimport type { CaptureSource } from \"../../Browser.ts\";\nimport {\n  BrowserError,\n  Closed,\n  Failed,\n  InvalidRequest,\n  type Reason,\n  Timeout,\n} from \"../../BrowserError.ts\";\nimport type { BrowserEvent } from \"../../BrowserEvent.ts\";\nimport type { InputGuard, Point } from \"../../Page.ts\";\nimport type { Gate } from \"../input/gate.ts\";\nimport { Current } from \"../input/replies.ts\";\nimport * as BrowserClock from \"../pictures/clock.ts\";\nimport * as Lane from \"./lane.ts\";\nimport type { Openings } from \"./openings.ts\";\nimport * as Url from \"./url.ts\";\n\n/** Why a page is gone. */\nexport type ClosedCause = Closed[\"cause\"];\n\n/** What every page of a browser shares, from its options. */\nexport interface Settings {\n  readonly actionTimeout: Duration.Duration;\n  readonly policyTimeout: Duration.Duration;\n  readonly navigationTimeout: Duration.Duration;\n  /** How long screencast frames stay in `recentFrames`, measured back from the newest. */\n  readonly frameHistory: Duration.Duration;\n  readonly guard: InputGuard | undefined;\n}\n\nexport interface MakeOptions {\n  /** The page's CDP target id, which is also its main frame's id. */\n  readonly id: string;\n  /** The id of the browser's session, which its frames carry. */\n  readonly session: string;\n  /** This tracking connection, distinct from the provider session and capture socket. */\n  readonly connection: string;\n  /** The page's address when the browser began tracking it. */\n  readonly url: string;\n  readonly playwright: PlaywrightPage;\n  readonly cdp: CDPSession;\n  /** A call's reply, or a failure as for a closed page once the browser is lost first. */\n  readonly untilLost: <A>(reply: Promise<A>) => Promise<A>;\n  readonly settings: Settings;\n  readonly clock: Clock.Clock;\n  /** Browser-wide input authority; direct internal page fixtures need not provide one. */\n  readonly inputGate?: Gate | undefined;\n  /** The browser's epoch mapping: its first capture measures it, and later ones renew it. */\n  readonly mapping: BrowserClock.Mapping;\n  readonly publish: (event: BrowserEvent) => number;\n  /** This page's retained events, oldest first. */\n  readonly recentEvents: Effect.Effect<ReadonlyArray<BrowserEvent>>;\n  /** Registration of the actual popups this page's current input opened. */\n  readonly openings: Openings;\n  /** Succeeds once the page's own session holds focus emulation, which keeps it painting behind. */\n  readonly focused: Effect.Effect<void, BrowserError>;\n  /** Succeeds once the page's own session has the Page domain on, so it sees every later commit. */\n  readonly paging: (operation: string) => Effect.Effect<void, BrowserError>;\n  /** Why the page is gone, once it is: its browser's loss, else its own close or crash. */\n  readonly closedBy: () => ClosedCause;\n  /** Where the page's screencast runs, if not on its own session. */\n  readonly capture?: CaptureSource | undefined;\n}\n\nconst messageOf = (cause: unknown): string =>\n  cause instanceof Error ? cause.message : typeof cause === \"string\" ? cause : \"unknown error\";\n\nconst closedPattern =\n  /has been closed|Target closed|Session closed|browser has disconnected|Target page, context or browser/i;\n\n/**\n * Map a Playwright or protocol failure to a reason, `Closed` with `closed` as its cause for a page\n * or browser that is gone. A call that gives Playwright a timeout passes the same bound, so its\n * `Timeout` reports it; without one, Playwright's own message stays.\n */\nexport const reasonOf = (\n  cause: unknown,\n  timeoutMillis?: number,\n  closed: ClosedCause = \"connection\",\n): Reason => {\n  const message = messageOf(cause);\n\n  if (closedPattern.test(message)) return new Closed({ cause: closed });\n  if (cause instanceof Error && cause.name === \"TimeoutError\" && timeoutMillis !== undefined)\n    return new Timeout({ millis: timeoutMillis });\n  const line = message.split(\"\\n\")[0] ?? message;\n\n  return new Failed({ detail: Url.redactWithin(line.replace(/^[\\w.]+: /, \"\")) });\n};\n\n/**\n * One Playwright or protocol call, failing undispatched. A closed page says why it is gone as the\n * browser knows then: the library's own calls fail with the browser's loss, and Playwright fails\n * its calls on a dropped connection after reporting the context closed.\n */\nexport const call = <A>(\n  operation: string,\n  run: () => Promise<A>,\n  closedBy: () => ClosedCause,\n  timeoutMillis?: number,\n) =>\n  Effect.tryPromise({\n    try: run,\n    catch: (cause) => undispatched(operation, reasonOf(cause, timeoutMillis, closedBy())),\n  });\n\nexport const contextGone = (error: BrowserError) =>\n  error.reason._tag === \"Failed\" &&\n  /Cannot find context|Execution context was destroyed|__effectBrowser|Inspected target navigated/i.test(\n    error.reason.detail,\n  );\n\n/**\n * What a page operation spent on the page's own protocol session: its calls, the bytes of their\n * parameters and results, and how long at least one of them awaited its reply. An operation inside\n * another counts toward both.\n */\ninterface Cost {\n  readonly enclosing: Cost | undefined;\n  calls: number;\n  bytesOut: number;\n  bytesIn: number;\n  waitedMillis: number;\n  awaiting: number;\n  awaitingSince: number;\n}\n\n/** The cost of the page operation the current fiber runs, if any. */\nconst CurrentCost = Context.Reference<Cost | undefined>(\n  \"effect-browser/internal/page/CurrentCost\",\n  {\n    defaultValue: () => undefined,\n  },\n);\n\n/** Track the promise returned to the action, after tracing wraps it, so input counts once. */\nconst track = <A>(reply: Promise<A>) => Fiber.getCurrent()?.getRef(Current)?.track(reply) ?? reply;\n\n// A message's size on the wire, give or take its envelope.\nconst sizeOf = (value: unknown) =>\n  value === undefined ? 0 : Buffer.byteLength(JSON.stringify(value));\n\n/** A failure of `operation` before any of its input reached the browser. */\nexport const undispatched = (operation: string, reason: Reason) =>\n  new BrowserError({ operation, reason, dispatched: false });\n\nexport const failWith = (operation: string, reason: Reason) =>\n  Effect.fail(undispatched(operation, reason));\n\n/** Refuse a request to `operation` that could never succeed, before sending anything. */\nexport const refuse = (operation: string, detail: string) =>\n  failWith(operation, new InvalidRequest({ detail }));\n\nexport const decodeWith =\n  <A>(operation: string, schema: Schema.Codec<A, unknown>) =>\n  (value: unknown) =>\n    Schema.decodeUnknownEffect(schema)(value).pipe(\n      Effect.mapError((error) => undispatched(operation, new Failed({ detail: error.message }))),\n    );\n\nexport const make = (options: MakeOptions, scope: Scope.Scope) => {\n  const { id, clock } = options;\n  const now = () => BrowserClock.monotonicMillis(clock);\n  // Deadlines and pacing guard the page's lane, so page operations run on the owner's clock; a\n  // caller's clock, such as a TestClock, cannot stall or stretch them.\n  const owned = Effect.provideService(Clock.Clock, clock);\n\n  // This page's spans name it and report what the operation cost on the protocol. Fine-grained\n  // ones carry a level below the default Info, so an application keeps only the coarse ones by\n  // raising `Tracer.MinimumTraceLevel`.\n  const span =\n    (name: string, attributes: Record<string, unknown> = {}, level?: \"Debug\" | \"Trace\") =>\n    <A, E, R>(effect: Effect.Effect<A, E, R>) =>\n      Effect.gen(function* () {\n        const cost: Cost = {\n          enclosing: yield* CurrentCost,\n          calls: 0,\n          bytesOut: 0,\n          bytesIn: 0,\n          waitedMillis: 0,\n          awaiting: 0,\n          awaitingSince: 0,\n        };\n\n        return yield* effect.pipe(\n          Effect.provideService(CurrentCost, cost),\n          Effect.ensuring(\n            Effect.suspend(() =>\n              Effect.annotateCurrentSpan({\n                calls: cost.calls,\n                bytesOut: cost.bytesOut,\n                bytesIn: cost.bytesIn,\n                waitedMillis: Math.round(cost.waitedMillis * 10) / 10,\n              }),\n            ),\n          ),\n        );\n      }).pipe(\n        Effect.withSpan(\n          name,\n          { attributes: { page: id, ...attributes }, ...(level === undefined ? {} : { level }) },\n          { captureStackTrace: false },\n        ),\n      );\n\n  // Every call on the page's own protocol session, counted into the operation that sends it and\n  // the operations around that one. It is looked up when the call is sent, so input pipelined\n  // from inside an operation counts toward it too.\n  const send: CDPSession[\"send\"] = (method, params) => {\n    const cost = Fiber.getCurrent()?.getRef(CurrentCost);\n    const sentAt = now();\n    const bytesOut = sizeOf(params);\n\n    for (let each = cost; each !== undefined; each = each.enclosing) {\n      each.calls++;\n      each.bytesOut += bytesOut;\n      if (each.awaiting++ === 0) each.awaitingSince = sentAt;\n    }\n    const reply = options.untilLost(options.cdp.send(method, params));\n\n    if (cost === undefined) return track(reply);\n\n    const settle = (bytesIn: number) => {\n      const at = now();\n\n      for (let each: Cost | undefined = cost; each !== undefined; each = each.enclosing) {\n        each.bytesIn += bytesIn;\n        if (--each.awaiting === 0) each.waitedMillis += at - each.awaitingSince;\n      }\n    };\n\n    return track(\n      reply.then(\n        (result) => {\n          settle(sizeOf(result));\n\n          return result;\n        },\n        (cause: unknown) => {\n          settle(0);\n\n          return Promise.reject(cause);\n        },\n      ),\n    );\n  };\n\n  // Every protocol or Playwright call. Errors are undispatched here; `perform` marks them\n  // dispatched once input has gone out.\n  const native = <A>(operation: string, run: () => Promise<A>, timeoutMillis?: number) =>\n    call(operation, () => track(run()), options.closedBy, timeoutMillis);\n\n  /** Fail with `Timeout` once `duration` has passed, the action timeout unless another is given. */\n  const within =\n    (operation: string, duration: Duration.Input = options.settings.actionTimeout) =>\n    <A, E, R>(effect: Effect.Effect<A, E, R>) =>\n      Effect.timeoutOrElse(effect, {\n        duration,\n        orElse: () => failWith(operation, new Timeout({ millis: Duration.toMillis(duration) })),\n      });\n\n  // Stop a navigation whose bounded wait failed. The stop and original mutation keep their\n  // actual replies owned; this cleanup does not turn an unanswered acknowledgement into success.\n  const stopLoading = native(\"stopLoading\", () => send(\"Page.stopLoading\")).pipe(\n    within(\"stopLoading\", options.settings.navigationTimeout),\n    Effect.ignore,\n  );\n\n  // The latest submitted input or page change. A read that must follow it waits for the action in\n  // flight, so only paint from after its latest input is current. An action ends after its input\n  // was handled, so if that input changed the page, newer paint follows; a lost final paint is\n  // bounded by recency instead. Paint from before the current document began, when the page's own\n  // session saw the main frame commit it, shows a page the tab has left, so no read reuses it,\n  // whatever it asks.\n  const activity = { inputAt: 0, documentAt: Number.NEGATIVE_INFINITY };\n\n  const noteInput = () => {\n    activity.inputAt = Math.max(activity.inputAt, now());\n  };\n\n  const lane = Lane.make({\n    now,\n    actionTimeout: options.settings.actionTimeout,\n    documentAt: () => activity.documentAt,\n    gone: (operation) => undispatched(operation, new Closed({ cause: options.closedBy() })),\n    scope,\n    inputGate: options.inputGate,\n  });\n\n  // Where this page's latest move left its pointer, which is where its next plain glide starts and\n  // where a held button is released. Its lane orders the page's input, and Chromium keeps a\n  // pointer per page too.\n  const pointer = MutableRef.make(Option.none<Point>());\n\n  // Named, so that the declarations of what holds it need not spell out Playwright's protocol types.\n  const protocol: Pick<CDPSession, \"send\"> = { send };\n\n  return {\n    ...options,\n    lane,\n    pointer,\n    now,\n    scope,\n    owned,\n    span,\n    protocol,\n    native,\n    within,\n    stopLoading,\n    activity,\n    noteInput,\n  };\n};\n\nexport type PageContext = ReturnType<typeof make>;\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -3,13 +3,13 @@ import { a as BrowserEvent_d_exports } from "./BrowserEvent-dq6FRT8w.mjs";
 import { n as Change_d_exports } from "./Change-DqING3tr.mjs";
 import { i as Frame_d_exports } from "./Frame-DkNdjjjr.mjs";
 import { i as Snapshot_d_exports } from "./Snapshot-B34hZ4Jl.mjs";
-import { N as Moment_d_exports, d as Page_d_exports } from "./Page-jHmSJeOS.mjs";
+import { N as Moment_d_exports, d as Page_d_exports } from "./Page-ku6j5t-v.mjs";
 import { t as Motion_d_exports } from "./Motion-DND6I-64.mjs";
 import { t as Browser_d_exports } from "./Browser.mjs";
 import { t as Cdp_d_exports } from "./Cdp.mjs";
 import { t as Chromium_d_exports } from "./Chromium.mjs";
 import { t as Expect_d_exports } from "./Expect.mjs";
-import { r as Plan_d_exports } from "./Plan-DLtRksuu.mjs";
+import { r as Plan_d_exports } from "./Plan-DJ4hEEna.mjs";
 import { t as Policy_d_exports } from "./Policy.mjs";
 import { t as Presentation_d_exports } from "./Presentation.mjs";
 import { t as Stage_d_exports } from "./Stage.mjs";

package/dist/index.mjs

@@ -1,18 +1,18 @@
 import { t as Motion_exports } from "./Motion.mjs";
 import { t as BrowserEvent_exports } from "./BrowserEvent.mjs";
 import { t as BrowserError_exports } from "./BrowserError.mjs";
-import { n as Browser_exports } from "./Browser-DRPthkNO.mjs";
+import { n as Browser_exports } from "./Browser-BwCldIff.mjs";
 import { t as Frame_exports } from "./Frame.mjs";
-import { a as Page_exports } from "./Page-C_VkBVwI.mjs";
+import { a as Page_exports } from "./Page-CfB6Zn1p.mjs";
 import { t as Snapshot_exports } from "./Snapshot.mjs";
 import { n as Change_exports } from "./Change-DNvztNLu.mjs";
 import { t as Moment_exports } from "./Moment.mjs";
 import { t as Cdp_exports } from "./Cdp.mjs";
 import { t as Chromium_exports } from "./Chromium.mjs";
 import { t as Expect_exports } from "./Expect.mjs";
-import { r as Plan_exports } from "./Plan-X-JkACAB.mjs";
+import { r as Plan_exports } from "./Plan-C-d5QYS8.mjs";
 import { t as Policy_exports } from "./Policy.mjs";
 import { t as Presentation_exports } from "./Presentation.mjs";
 import { t as Stage_exports } from "./Stage.mjs";
-import { i as Supervisor_exports } from "./Supervisor-BgWP8o9t.mjs";
+import { i as Supervisor_exports } from "./Supervisor-2mPjIYYs.mjs";
 export { Browser_exports as Browser, BrowserError_exports as BrowserError, BrowserEvent_exports as BrowserEvent, Cdp_exports as Cdp, Change_exports as Change, Chromium_exports as Chromium, Expect_exports as Expect, Frame_exports as Frame, Moment_exports as Moment, Motion_exports as Motion, Page_exports as Page, Plan_exports as Plan, Policy_exports as Policy, Presentation_exports as Presentation, Snapshot_exports as Snapshot, Stage_exports as Stage, Supervisor_exports as Supervisor };