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

package/dist/Supervisor-BtEG93gR.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Supervisor-BtEG93gR.mjs","names":["Lifecycle.GenerationState","Lifecycle.resolve","Lifecycle.start","Lifecycle.transition","Lifecycle.Settled","Lifecycle.Unconfirmed"],"sources":["../src/internal/supervisor/lifecycle.ts","../src/Supervisor.ts"],"sourcesContent":["/**\n * A supervisor's life as one state and one transition function, and the generation states it\n * publishes. The transition has no effects: `Supervisor.make` applies each input under one lock,\n * publishes the events in order and runs the commands, so the rules here are tested alone.\n */\nimport { Schema } from \"effect\";\n\nimport { DisconnectCause } from \"../../BrowserEvent.ts\";\n\n/** The provider confirmed that the generation's browser ended. */\nexport class Settled extends Schema.TaggedClass<Settled>()(\"Settled\", {}) {}\n\n/** The provider could not confirm the end by its deadline, so the browser may still run, and bill. */\nexport class Unconfirmed extends Schema.TaggedClass<Unconfirmed>()(\"Unconfirmed\", {\n  detail: Schema.String,\n}) {}\n\nexport const Released = Schema.Union([Settled, Unconfirmed]);\n\nexport type Released = typeof Released.Type;\n\n/** Opening, but not after a loss: the first generation, a rotation, or the one after `Down`. */\nexport class Opening extends Schema.TaggedClass<Opening>()(\"Opening\", {}) {}\n\n/** Opening after the generation before it was lost. */\nexport class Reopening extends Schema.TaggedClass<Reopening>()(\"Reopening\", {}) {}\n\n/** Open: `browser` gives this generation until the next one opens. */\nexport class Open extends Schema.TaggedClass<Open>()(\"Open\", {}) {}\n\n/** Lost: its connection dropped, or its provider ended its session, as `cause` says. */\nexport class Lost extends Schema.TaggedClass<Lost>()(\"Lost\", {\n  cause: DisconnectCause,\n}) {}\n\n/**\n * It never opened: its last try failed with `cause`, which the provider deems definite, or after\n * which the reopen schedule gave up.\n */\nexport class Down extends Schema.TaggedClass<Down>()(\"Down\", {\n  detail: Schema.String,\n  cause: Schema.Defect(),\n}) {}\n\n/** It ended. `released` says how its release went; one retired while opening has none. */\nexport class Closed extends Schema.TaggedClass<Closed>()(\"Closed\", {\n  released: Schema.optional(Released),\n}) {}\n\n/**\n * It was serving as the supervisor's scope closed, and was left running, not released: its scope\n * closed, and its provider runs it on, and bills, until something adopts and releases it.\n */\nexport class Kept extends Schema.TaggedClass<Kept>()(\"Kept\", {}) {}\n\nexport const GenerationState = Schema.Union([Opening, Reopening, Open, Lost, Down, Closed, Kept]);\n\nexport type GenerationState = typeof GenerationState.Type;\n\n/** A generation that opened: its number, and what the runtime keeps to serve and end it. */\nexport interface Live<A> {\n  readonly number: number;\n  readonly value: A;\n}\n\n/**\n * At most one generation opens and at most one serves. Both do while a rotation makes the next\n * before it breaks the current, and `Down` keeps serving one that a rotation failed to replace.\n */\nexport type State<A> =\n  | { readonly _tag: \"Opening\"; readonly number: number; readonly serving: Live<A> | undefined }\n  | { readonly _tag: \"Open\"; readonly serving: Live<A> }\n  | {\n      readonly _tag: \"Down\";\n      readonly number: number;\n      readonly detail: string;\n      readonly cause: unknown;\n      readonly serving: Live<A> | undefined;\n    }\n  | { readonly _tag: \"Retired\" };\n\nexport type Input<A> =\n  | { readonly _tag: \"Opened\"; readonly live: Live<A> }\n  /** The open of `number` failed for good. */\n  | {\n      readonly _tag: \"Failed\";\n      readonly number: number;\n      readonly detail: string;\n      readonly cause: unknown;\n    }\n  /** The open of `number` was stopped, as on retiring, before it opened. */\n  | { readonly _tag: \"Abandoned\"; readonly number: number }\n  | { readonly _tag: \"Lost\"; readonly number: number; readonly cause: DisconnectCause }\n  /** A caller asks for the next generation, or the rotation time of `due` came. */\n  | { readonly _tag: \"Rotate\"; readonly due?: number | undefined }\n  | { readonly _tag: \"Retire\" }\n  /** Stop as `Retire` does, but leave the serving generation running. */\n  | { readonly _tag: \"Keep\" }\n  | { readonly _tag: \"Released\"; readonly number: number; readonly released: Released };\n\nexport type Command<A> =\n  /** Open `number`, after the release of `after` has finished. */\n  | { readonly _tag: \"Open\"; readonly number: number; readonly after: number | undefined }\n  /** Watch a generation that opened for its loss and its rotation time. */\n  | { readonly _tag: \"Watch\"; readonly live: Live<A> }\n  | { readonly _tag: \"Release\"; readonly live: Live<A> }\n  /** Close its scope without asking its provider to release it. */\n  | { readonly _tag: \"Leave\"; readonly live: Live<A> };\n\nexport interface Step<A> {\n  readonly state: State<A>;\n  /** Generation numbers and their new states, to publish in this order. */\n  readonly events: ReadonlyArray<readonly [number, GenerationState]>;\n  readonly commands: ReadonlyArray<Command<A>>;\n  /** For `Rotate`, the generation to wait for, unless retired. */\n  readonly reply?: number | undefined;\n}\n\nexport const start = <A>(): Step<A> => ({\n  state: { _tag: \"Opening\", number: 1, serving: undefined },\n  events: [[1, new Opening()]],\n  commands: [{ _tag: \"Open\", number: 1, after: undefined }],\n});\n\nconst servingOf = <A>(state: State<A>) => (state._tag === \"Retired\" ? undefined : state.serving);\n\n/** The state after `input`, with the events to publish and the commands to run. */\nexport const transition = <A>(state: State<A>, input: Input<A>, exclusive: boolean): Step<A> => {\n  const release = (live: Live<A>): Command<A> => ({ _tag: \"Release\", live });\n  const stay: Step<A> = { state, events: [], commands: [] };\n\n  /**\n   * Open `number`, ending `current` now if it `ends`; exclusive generations open only once its\n   * release has finished. Otherwise `current` serves until the next one opens.\n   */\n  const next = (\n    number: number,\n    reopen: boolean,\n    current: Live<A> | undefined,\n    ends: boolean,\n  ): Step<A> => ({\n    state: { _tag: \"Opening\", number, serving: ends ? undefined : current },\n    events: [[number, reopen ? new Reopening() : new Opening()]],\n    commands: [\n      ...(ends && current !== undefined ? [release(current)] : []),\n      { _tag: \"Open\", number, after: ends && exclusive ? current?.number : undefined },\n    ],\n  });\n\n  switch (input._tag) {\n    case \"Opened\": {\n      const { live } = input;\n\n      // A generation nobody waits for any more, as after `Retire`, is released at once.\n      if (state._tag !== \"Opening\" || state.number !== live.number)\n        return { ...stay, commands: [release(live)] };\n\n      return {\n        state: { _tag: \"Open\", serving: live },\n        events: [[live.number, new Open()]],\n        commands: [\n          { _tag: \"Watch\", live },\n          ...(state.serving === undefined ? [] : [release(state.serving)]),\n        ],\n      };\n    }\n    case \"Failed\": {\n      const { number, detail, cause } = input;\n      const events = [[number, new Down({ detail, cause })] as const];\n\n      if (state._tag !== \"Opening\" || state.number !== input.number) return { ...stay, events };\n\n      return {\n        state: { _tag: \"Down\", number, detail, cause, serving: state.serving },\n        events,\n        commands: [],\n      };\n    }\n    case \"Abandoned\":\n      return { ...stay, events: [[input.number, new Closed({})]] };\n    case \"Released\":\n      return { ...stay, events: [[input.number, new Closed({ released: input.released })]] };\n    case \"Lost\": {\n      const lost = servingOf(state);\n\n      if (state._tag === \"Retired\" || lost?.number !== input.number) return stay;\n      const events = [[lost.number, new Lost({ cause: input.cause })] as const];\n\n      // A rotation already opening the next generation carries on without the lost one.\n      if (state._tag === \"Opening\")\n        return { state: { ...state, serving: undefined }, events, commands: [release(lost)] };\n\n      const reopened = next(\n        (state._tag === \"Open\" ? lost.number : state.number) + 1,\n        true,\n        lost,\n        true,\n      );\n\n      return { ...reopened, events: [...events, ...reopened.events] };\n    }\n    case \"Rotate\": {\n      if (state._tag === \"Retired\") return stay;\n      // A rotation time comes only for the generation still serving with nothing opening.\n      if (input.due !== undefined && (state._tag !== \"Open\" || state.serving.number !== input.due))\n        return stay;\n      if (state._tag === \"Opening\") return { ...stay, reply: state.number };\n      const number = (state._tag === \"Open\" ? state.serving.number : state.number) + 1;\n\n      return { ...next(number, false, state.serving, exclusive), reply: number };\n    }\n    case \"Retire\":\n    case \"Keep\": {\n      const current = servingOf(state);\n\n      if (state._tag === \"Retired\") return stay;\n      if (current === undefined) return { state: { _tag: \"Retired\" }, events: [], commands: [] };\n\n      return input._tag === \"Retire\"\n        ? { state: { _tag: \"Retired\" }, events: [], commands: [release(current)] }\n        : {\n            state: { _tag: \"Retired\" },\n            events: [[current.number, new Kept()]],\n            commands: [{ _tag: \"Leave\", live: current }],\n          };\n    }\n  }\n};\n\nexport type Resolution<A> =\n  | { readonly _tag: \"Serve\"; readonly live: Live<A> }\n  | {\n      readonly _tag: \"Unavailable\";\n      readonly reason: \"down\" | \"retired\";\n      readonly detail: string;\n      readonly cause?: unknown;\n    };\n\n/**\n * What a caller waiting for generation `target`, or for any when it is undefined, gets in\n * `state`; undefined while it should go on waiting.\n */\nexport const resolve = <A>(\n  state: State<A>,\n  target: number | undefined,\n): Resolution<A> | undefined => {\n  const serve = (live: Live<A>) => ({ _tag: \"Serve\" as const, live });\n\n  switch (state._tag) {\n    case \"Retired\":\n      return { _tag: \"Unavailable\", reason: \"retired\", detail: \"the supervisor was retired\" };\n    case \"Open\":\n      return target === undefined || state.serving.number >= target\n        ? serve(state.serving)\n        : undefined;\n    case \"Opening\":\n      return target === undefined && state.serving !== undefined ? serve(state.serving) : undefined;\n    case \"Down\":\n      if (target === undefined && state.serving !== undefined) return serve(state.serving);\n\n      return target === undefined || state.number >= target\n        ? { _tag: \"Unavailable\", reason: \"down\", detail: state.detail, cause: state.cause }\n        : undefined;\n  }\n};\n","/**\n * A browser kept open across losses and session ends, as a series of generations, each a new\n * browser from the same provider. Pages don't carry over from one generation to the next.\n *\n * `make` opens the first generation at once with the provider's `open`, in a scope of its own, so\n * a caller that stops waiting never interrupts a half-open browser. `browser` gives the current\n * generation; callers wait, bounded, and share one open. A loss is published at once and the next\n * generation opens on the `reopen` schedule, which also retries a failed open, unless the provider\n * deems its failure `definite`: that goes `Down` at once, with its cause. `rotate` opens the\n * next generation now, and so does the time `rotateBefore` ahead of a generation's `expiresAt`. A\n * rotation makes the next generation before it breaks the current one, unless generations are\n * `exclusive`, as sessions saving to one stored context must be: then the current one is released\n * first. `retire` stops reopening at once and releases what is open; the scope's close retires\n * too, unless the supervisor `keep`s: then it leaves the serving generation running, `Kept`. `states`\n * publishes each generation's changes, with the provider's release outcome last.\n *\n * Providers supply the specifics: `Browserbase.supervise` opens hosted sessions this way.\n *\n * @since 0.3.0\n */\nimport {\n  Cause,\n  Clock,\n  DateTime,\n  Duration,\n  Effect,\n  Exit,\n  Fiber,\n  FiberHandle,\n  FiberMap,\n  Option,\n  Predicate,\n  PubSub,\n  Schedule,\n  Schema,\n  Scope,\n  Stream,\n  SubscriptionRef,\n  type Take,\n} from \"effect\";\n\nimport type * as Browser from \"./Browser.ts\";\nimport * as Lifecycle from \"./internal/supervisor/lifecycle.ts\";\n\nexport {\n  Closed,\n  Down,\n  GenerationState,\n  Kept,\n  Lost,\n  Open,\n  Opening,\n  Released,\n  Reopening,\n  Settled,\n  Unconfirmed,\n} from \"./internal/supervisor/lifecycle.ts\";\n\n/** One change in a generation's life. `at` is wall-clock epoch milliseconds from the Effect `Clock`. */\nexport class Generation extends Schema.Class<Generation>(\"effect-browser/Generation\")({\n  number: Schema.Int.check(Schema.isGreaterThan(0)),\n  at: Schema.Finite,\n  state: Lifecycle.GenerationState,\n}) {}\n\n/**\n * No browser to give: none opened within `waitTimeout` (`opening`), the latest generation failed\n * to open (`down`, with what it failed with as `cause`), or the supervisor was retired.\n */\nexport class Unavailable extends Schema.TaggedError<Unavailable>()(\"Unavailable\", {\n  reason: Schema.Literals([\"opening\", \"down\", \"retired\"]),\n  detail: Schema.String,\n  cause: Schema.optional(Schema.Defect()),\n}) {\n  override get message() {\n    return `no browser: ${this.detail}`;\n  }\n}\n\n/** One generation, as a provider opened it in the scope the supervisor gave it. */\nexport interface Opened {\n  readonly browser: Browser.Service;\n  /**\n   * End the generation, and say whether the provider confirmed its end. The supervisor asks it\n   * before it closes the generation's scope; without it, closing the scope ends the generation,\n   * which counts as `Settled`.\n   */\n  readonly release?: Effect.Effect<Lifecycle.Released> | undefined;\n}\n\nexport interface Options<E, R> {\n  /** Opens one generation in the scope it is given. */\n  readonly open: Effect.Effect<Opened, E, R>;\n  /** When to try a failed open again. Defaults to exponential from 1 second, for 5 minutes. */\n  readonly reopen?: Schedule.Schedule<unknown, E> | undefined;\n  /**\n   * Failures no new try mends, such as a refused key: an open that fails so is `Down` at once.\n   * Defaults to none.\n   */\n  readonly definite?: ((error: E) => boolean) | undefined;\n  /**\n   * Rotate this long ahead of a generation's `expiresAt`, but no sooner than halfway through its\n   * life. Without it, a generation's end is a loss.\n   */\n  readonly rotateBefore?: Duration.Input | undefined;\n  /** Generations must not overlap: a rotation releases the current one before it opens the next. */\n  readonly exclusive?: boolean | undefined;\n  /**\n   * Closing the scope leaves the serving generation running, `Kept`: it closes the generation's\n   * scope but never asks `release`. For providers whose scope only disconnects, such as\n   * `Browserbase.supervise` with `keep`. `retire` still releases it.\n   */\n  readonly keep?: boolean | undefined;\n  /** How long `browser` and `rotate` wait for a generation to open. Defaults to 2 minutes. */\n  readonly waitTimeout?: Duration.Input | undefined;\n}\n\nexport interface Supervisor {\n  /** The current generation's browser, waiting up to `waitTimeout` while none is open. */\n  readonly browser: Effect.Effect<Browser.Service, Unavailable>;\n  /** Each generation's changes, in order. A new reader first gets the latest 64; ends on retiring. */\n  readonly states: Stream.Stream<Generation>;\n  /** Open the next generation now, or join the one opening, and wait for it. */\n  readonly rotate: Effect.Effect<Browser.Service, Unavailable>;\n  /** Stop opening at once, release every generation, and wait until each release has finished. */\n  readonly retire: Effect.Effect<void>;\n}\n\ninterface Held {\n  readonly opened: Opened;\n  readonly scope: Scope.Closeable;\n}\n\nconst retired = () => new Unavailable({ reason: \"retired\", detail: \"the supervisor was retired\" });\n\nconst describe = (cause: Cause.Cause<unknown>) => {\n  const error = Cause.squash(cause);\n\n  return Predicate.isError(error) ? error.message : String(error);\n};\n\n/**\n * Wait up to `waitTimeout` for generation `target`, or for any when it is undefined, as `state`\n * changes.\n */\nconst waitFor = <A extends { readonly opened: Opened }>(\n  state: SubscriptionRef.SubscriptionRef<Lifecycle.State<A>>,\n  waitTimeout: Duration.Duration,\n  target: number | undefined,\n) =>\n  SubscriptionRef.changes(state).pipe(\n    Stream.map((current) => Lifecycle.resolve(current, target)),\n    Stream.filter(Predicate.isNotUndefined),\n    Stream.runHead,\n    // The state's changes never end, so the first resolution always comes.\n    Effect.flatMap(\n      Option.match({\n        onNone: () => Effect.fail(retired()),\n        onSome: (resolution) =>\n          resolution._tag === \"Serve\"\n            ? Effect.succeed(resolution.live.value.opened.browser)\n            : Effect.fail(\n                new Unavailable({\n                  reason: resolution.reason,\n                  detail: resolution.detail,\n                  cause: resolution.cause,\n                }),\n              ),\n      }),\n    ),\n    Effect.timeoutOrElse({\n      duration: waitTimeout,\n      orElse: () =>\n        Effect.fail(\n          new Unavailable({\n            reason: \"opening\",\n            detail: `no generation opened within ${Duration.format(waitTimeout)}`,\n          }),\n        ),\n    }),\n  );\n\n/** Sleep until `before` ahead of `expiresAt`, but no sooner than halfway there from now. */\nconst untilRotation = (expiresAt: DateTime.Utc, before: Duration.Duration) =>\n  Clock.currentTimeMillis.pipe(\n    Effect.flatMap((now) => {\n      const left = DateTime.toEpochMillis(expiresAt) - now;\n\n      return Effect.sleep(Duration.millis(Math.max(left - Duration.toMillis(before), left / 2, 0)));\n    }),\n  );\n\n/** Supervise generations of a provider's browser for as long as the scope is open. */\nexport const make = Effect.fn(\"Supervisor.make\")(function* <E, R>(\n  options: Options<E, R>,\n): Effect.fn.Return<Supervisor, never, Scope.Scope | Exclude<R, Scope.Scope>> {\n  const clock = yield* Clock.Clock;\n  const context = yield* Effect.context<Exclude<R, Scope.Scope>>();\n  const own = yield* Scope.fork(yield* Effect.scope);\n  const exclusive = options.exclusive ?? false;\n  const definite = options.definite ?? (() => false);\n\n  const reopen: Schedule.Schedule<unknown, E> =\n    options.reopen ??\n    Schedule.exponential(\"1 second\").pipe(Schedule.upTo({ duration: Duration.minutes(5) }));\n\n  const rotateBefore =\n    options.rotateBefore === undefined ? undefined : Duration.fromInputUnsafe(options.rotateBefore);\n\n  const waitTimeout = Duration.fromInputUnsafe(options.waitTimeout ?? Duration.minutes(2));\n  const started = Lifecycle.start<Held>();\n  const state = yield* SubscriptionRef.make(started.state);\n  const events = yield* PubSub.unbounded<Take.Take<Generation>>({ replay: 64 });\n  const opening = yield* FiberHandle.make<unknown, never>();\n  const releases = yield* FiberMap.make<number, unknown, never>();\n  const runOpen = yield* FiberHandle.runtime(opening)();\n  const runRelease = yield* FiberMap.runtime(releases)();\n\n  // Each input changes the state under one lock, which also publishes its events and starts its\n  // work, so neither can be reordered against another input's.\n  const apply = (input: Lifecycle.Input<Held>): Effect.Effect<number | undefined> =>\n    SubscriptionRef.modifyEffect(state, (current) => {\n      const step = Lifecycle.transition(current, input, exclusive);\n\n      return Effect.as(perform(step), [step.reply, step.state] as const);\n    }).pipe(Effect.uninterruptible);\n\n  const perform = (step: Lifecycle.Step<Held>) =>\n    Effect.gen(function* () {\n      for (const [number, generation] of step.events)\n        PubSub.publishUnsafe(events, [\n          new Generation({ number, at: clock.currentTimeMillisUnsafe(), state: generation }),\n        ]);\n      for (const command of step.commands)\n        switch (command._tag) {\n          case \"Open\":\n            runOpen(openGeneration(command.number, command.after));\n            break;\n          case \"Watch\":\n            yield* Effect.forkIn(\n              Effect.provideContext(watch(command.live), context),\n              command.live.value.scope,\n            );\n            break;\n          case \"Release\":\n            runRelease(command.live.number, release(command.live));\n            break;\n          case \"Leave\":\n            runRelease(command.live.number, Scope.close(command.live.value.scope, Exit.void));\n        }\n    });\n\n  const openOnce = Effect.uninterruptibleMask((restore) =>\n    Effect.flatMap(Scope.fork(own), (scope) =>\n      restore(options.open.pipe(Scope.provide(scope), Effect.provideContext(context))).pipe(\n        Effect.onError((cause) => Scope.close(scope, Exit.failCause(cause))),\n        Effect.map((opened): Held => ({ opened, scope })),\n      ),\n    ),\n  );\n\n  // Retiring interrupts the open between tries or during one; the provider releases what an\n  // interrupted try had made, as its scope closes.\n  const openGeneration = (number: number, after: number | undefined) =>\n    Effect.uninterruptibleMask((restore) => {\n      const previous =\n        after === undefined\n          ? Effect.void\n          : FiberMap.get(releases, after).pipe(\n              Effect.flatMap(Option.match({ onNone: () => Effect.void, onSome: Fiber.await })),\n            );\n\n      const tries = Effect.retry(openOnce, {\n        schedule: reopen,\n        while: (error) => !definite(error),\n      });\n\n      return restore(previous.pipe(Effect.andThen(tries))).pipe(\n        Effect.exit,\n        Effect.flatMap((exit) => {\n          if (Exit.isSuccess(exit))\n            return apply({ _tag: \"Opened\", live: { number, value: exit.value } });\n\n          return Cause.hasInterruptsOnly(exit.cause)\n            ? apply({ _tag: \"Abandoned\", number })\n            : apply({\n                _tag: \"Failed\",\n                number,\n                detail: describe(exit.cause),\n                cause: Cause.squash(exit.cause),\n              });\n        }),\n      );\n    });\n\n  // A generation's own release loses its browser too, which the transition ignores.\n  const watch = (live: Lifecycle.Live<Held>) => {\n    const { browser } = live.value.opened;\n\n    const loss = browser.disconnected.pipe(\n      Effect.flatMap((cause) => apply({ _tag: \"Lost\", number: live.number, cause })),\n    );\n\n    const rotation =\n      browser.expiresAt === undefined || rotateBefore === undefined\n        ? Effect.void\n        : untilRotation(browser.expiresAt, rotateBefore).pipe(\n            Effect.andThen(apply({ _tag: \"Rotate\", due: live.number })),\n          );\n\n    return Effect.all([loss, rotation], { concurrency: 2, discard: true });\n  };\n\n  // The provider releases before the scope closes, so what the scope holds, such as a stored\n  // context's lease, goes only once the release has reported.\n  const release = (live: Lifecycle.Live<Held>) =>\n    (live.value.opened.release ?? Effect.succeed(new Lifecycle.Settled())).pipe(\n      Effect.catchCause((cause) =>\n        Effect.succeed(\n          new Lifecycle.Unconfirmed({ detail: `the release failed: ${describe(cause)}` }),\n        ),\n      ),\n      Effect.ensuring(Scope.close(live.value.scope, Exit.void)),\n      Effect.flatMap((released) => apply({ _tag: \"Released\", number: live.number, released })),\n    );\n\n  const end = yield* Effect.cached(PubSub.publish(events, Exit.void));\n\n  // Stop at once, end or leave what is open, and wait for every release.\n  const stop = (input: Lifecycle.Input<Held>) =>\n    apply(input).pipe(\n      Effect.andThen(FiberHandle.clear(opening)),\n      Effect.andThen(FiberMap.awaitEmpty(releases)),\n      Effect.andThen(end),\n      Effect.asVoid,\n    );\n\n  const retire = yield* Effect.cached(stop({ _tag: \"Retire\" }));\n\n  yield* Effect.addFinalizer(() => (options.keep === true ? stop({ _tag: \"Keep\" }) : retire));\n  yield* perform(started);\n\n  return {\n    browser: waitFor(state, waitTimeout, undefined),\n    states: Stream.fromPubSubTake(events),\n    rotate: apply({ _tag: \"Rotate\" }).pipe(\n      Effect.flatMap((target) =>\n        target === undefined ? Effect.fail(retired()) : waitFor(state, waitTimeout, target),\n      ),\n    ),\n    retire,\n  } satisfies Supervisor;\n});\n"],"mappings":"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"}

package/dist/Supervisor-Im6-wbg5.d.mts

@@ -0,0 +1,230 @@
+import { c as DisconnectCause } from "./BrowserEvent-DzdNdvoh.mjs";
+import { Service, t as Browser_d_exports } from "./Browser.mjs";
+import { Cause, Duration, Effect, Schedule, Schema, Scope, Stream } from "effect";
+declare namespace lifecycle_d_exports {
+  export { Closed, Command, Down, GenerationState, Input, Kept, Live, Lost, Open, Opening, Released, Reopening, Resolution, Settled, State, Step, Unconfirmed, resolve, start, transition };
+}
+declare const Settled_base: Schema.Class<Settled, Schema.TaggedStruct<"Settled", {}>, {}>;
+/** The provider confirmed that the generation's browser ended. */
+declare class Settled extends Settled_base {}
+declare const Unconfirmed_base: Schema.Class<Unconfirmed, Schema.TaggedStruct<"Unconfirmed", {
+  readonly detail: Schema.String;
+}>, {}>;
+/** The provider could not confirm the end by its deadline, so the browser may still run, and bill. */
+declare class Unconfirmed extends Unconfirmed_base {}
+declare const Released: Schema.Union<readonly [typeof Settled, typeof Unconfirmed]>;
+type Released = typeof Released.Type;
+declare const Opening_base: Schema.Class<Opening, Schema.TaggedStruct<"Opening", {}>, {}>;
+/** Opening, but not after a loss: the first generation, a rotation, or the one after `Down`. */
+declare class Opening extends Opening_base {}
+declare const Reopening_base: Schema.Class<Reopening, Schema.TaggedStruct<"Reopening", {}>, {}>;
+/** Opening after the generation before it was lost. */
+declare class Reopening extends Reopening_base {}
+declare const Open_base: Schema.Class<Open, Schema.TaggedStruct<"Open", {}>, {}>;
+/** Open: `browser` gives this generation until the next one opens. */
+declare class Open extends Open_base {}
+declare const Lost_base: Schema.Class<Lost, Schema.TaggedStruct<"Lost", {
+  readonly cause: Schema.Literals<readonly ["connection", "session", "released"]>;
+}>, {}>;
+/** Lost: its connection dropped, or its provider ended its session, as `cause` says. */
+declare class Lost extends Lost_base {}
+declare const Down_base: Schema.Class<Down, Schema.TaggedStruct<"Down", {
+  readonly detail: Schema.String;
+  readonly cause: Schema.Defect;
+}>, {}>;
+/**
+ * It never opened: its last try failed with `cause`, which the provider deems definite, or after
+ * which the reopen schedule gave up.
+ */
+declare class Down extends Down_base {}
+declare const Closed_base: Schema.Class<Closed, Schema.TaggedStruct<"Closed", {
+  readonly released: Schema.optional<Schema.Union<readonly [typeof Settled, typeof Unconfirmed]>>;
+}>, {}>;
+/** It ended. `released` says how its release went; one retired while opening has none. */
+declare class Closed extends Closed_base {}
+declare const Kept_base: Schema.Class<Kept, Schema.TaggedStruct<"Kept", {}>, {}>;
+/**
+ * It was serving as the supervisor's scope closed, and was left running, not released: its scope
+ * closed, and its provider runs it on, and bills, until something adopts and releases it.
+ */
+declare class Kept extends Kept_base {}
+declare const GenerationState: Schema.Union<readonly [typeof Opening, typeof Reopening, typeof Open, typeof Lost, typeof Down, typeof Closed, typeof Kept]>;
+type GenerationState = typeof GenerationState.Type;
+/** A generation that opened: its number, and what the runtime keeps to serve and end it. */
+interface Live<A> {
+  readonly number: number;
+  readonly value: A;
+}
+/**
+ * At most one generation opens and at most one serves. Both do while a rotation makes the next
+ * before it breaks the current, and `Down` keeps serving one that a rotation failed to replace.
+ */
+type State<A> = {
+  readonly _tag: "Opening";
+  readonly number: number;
+  readonly serving: Live<A> | undefined;
+} | {
+  readonly _tag: "Open";
+  readonly serving: Live<A>;
+} | {
+  readonly _tag: "Down";
+  readonly number: number;
+  readonly detail: string;
+  readonly cause: unknown;
+  readonly serving: Live<A> | undefined;
+} | {
+  readonly _tag: "Retired";
+};
+type Input<A> = {
+  readonly _tag: "Opened";
+  readonly live: Live<A>;
+} |
+/** The open of `number` failed for good. */
+{
+  readonly _tag: "Failed";
+  readonly number: number;
+  readonly detail: string;
+  readonly cause: unknown;
+} |
+/** The open of `number` was stopped, as on retiring, before it opened. */
+{
+  readonly _tag: "Abandoned";
+  readonly number: number;
+} | {
+  readonly _tag: "Lost";
+  readonly number: number;
+  readonly cause: DisconnectCause;
+} |
+/** A caller asks for the next generation, or the rotation time of `due` came. */
+{
+  readonly _tag: "Rotate";
+  readonly due?: number | undefined;
+} | {
+  readonly _tag: "Retire";
+} |
+/** Stop as `Retire` does, but leave the serving generation running. */
+{
+  readonly _tag: "Keep";
+} | {
+  readonly _tag: "Released";
+  readonly number: number;
+  readonly released: Released;
+};
+type Command<A> =
+/** Open `number`, after the release of `after` has finished. */
+{
+  readonly _tag: "Open";
+  readonly number: number;
+  readonly after: number | undefined;
+} |
+/** Watch a generation that opened for its loss and its rotation time. */
+{
+  readonly _tag: "Watch";
+  readonly live: Live<A>;
+} | {
+  readonly _tag: "Release";
+  readonly live: Live<A>;
+} |
+/** Close its scope without asking its provider to release it. */
+{
+  readonly _tag: "Leave";
+  readonly live: Live<A>;
+};
+interface Step<A> {
+  readonly state: State<A>;
+  /** Generation numbers and their new states, to publish in this order. */
+  readonly events: ReadonlyArray<readonly [number, GenerationState]>;
+  readonly commands: ReadonlyArray<Command<A>>;
+  /** For `Rotate`, the generation to wait for, unless retired. */
+  readonly reply?: number | undefined;
+}
+declare const start: <A>() => Step<A>;
+/** The state after `input`, with the events to publish and the commands to run. */
+declare const transition: <A>(state: State<A>, input: Input<A>, exclusive: boolean) => Step<A>;
+type Resolution<A> = {
+  readonly _tag: "Serve";
+  readonly live: Live<A>;
+} | {
+  readonly _tag: "Unavailable";
+  readonly reason: "down" | "retired";
+  readonly detail: string;
+  readonly cause?: unknown;
+};
+/**
+ * What a caller waiting for generation `target`, or for any when it is undefined, gets in
+ * `state`; undefined while it should go on waiting.
+ */
+declare const resolve: <A>(state: State<A>, target: number | undefined) => Resolution<A> | undefined;
+declare namespace Supervisor_d_exports {
+  export { Closed, Down, Generation, GenerationState, Kept, Lost, Open, Opened, Opening, Options, Released, Reopening, Settled, Supervisor, Unavailable, Unconfirmed, make };
+}
+declare const Generation_base: Schema.Class<Generation, Schema.Struct<{
+  readonly number: Schema.Int;
+  readonly at: Schema.Finite;
+  readonly state: Schema.Union<readonly [typeof Opening, typeof Reopening, typeof Open, typeof Lost, typeof Down, typeof Closed, typeof Kept]>;
+}>, {}>;
+/** One change in a generation's life. `at` is wall-clock epoch milliseconds from the Effect `Clock`. */
+declare class Generation extends Generation_base {}
+declare const Unavailable_base: Schema.Class<Unavailable, Schema.TaggedStruct<"Unavailable", {
+  readonly reason: Schema.Literals<readonly ["opening", "down", "retired"]>;
+  readonly detail: Schema.String;
+  readonly cause: Schema.optional<Schema.Defect>;
+}>, Cause.YieldableError>;
+/**
+ * No browser to give: none opened within `waitTimeout` (`opening`), the latest generation failed
+ * to open (`down`, with what it failed with as `cause`), or the supervisor was retired.
+ */
+declare class Unavailable extends Unavailable_base {
+  get message(): string;
+}
+/** One generation, as a provider opened it in the scope the supervisor gave it. */
+interface Opened {
+  readonly browser: Service;
+  /**
+   * End the generation, and say whether the provider confirmed its end. The supervisor asks it
+   * before it closes the generation's scope; without it, closing the scope ends the generation,
+   * which counts as `Settled`.
+   */
+  readonly release?: Effect.Effect<Released> | undefined;
+}
+interface Options<E, R> {
+  /** Opens one generation in the scope it is given. */
+  readonly open: Effect.Effect<Opened, E, R>;
+  /** When to try a failed open again. Defaults to exponential from 1 second, for 5 minutes. */
+  readonly reopen?: Schedule.Schedule<unknown, E> | undefined;
+  /**
+   * Failures no new try mends, such as a refused key: an open that fails so is `Down` at once.
+   * Defaults to none.
+   */
+  readonly definite?: ((error: E) => boolean) | undefined;
+  /**
+   * Rotate this long ahead of a generation's `expiresAt`, but no sooner than halfway through its
+   * life. Without it, a generation's end is a loss.
+   */
+  readonly rotateBefore?: Duration.Input | undefined;
+  /** Generations must not overlap: a rotation releases the current one before it opens the next. */
+  readonly exclusive?: boolean | undefined;
+  /**
+   * Closing the scope leaves the serving generation running, `Kept`: it closes the generation's
+   * scope but never asks `release`. For providers whose scope only disconnects, such as
+   * `Browserbase.supervise` with `keep`. `retire` still releases it.
+   */
+  readonly keep?: boolean | undefined;
+  /** How long `browser` and `rotate` wait for a generation to open. Defaults to 2 minutes. */
+  readonly waitTimeout?: Duration.Input | undefined;
+}
+interface Supervisor {
+  /** The current generation's browser, waiting up to `waitTimeout` while none is open. */
+  readonly browser: Effect.Effect<Service, Unavailable>;
+  /** Each generation's changes, in order. A new reader first gets the latest 64; ends on retiring. */
+  readonly states: Stream.Stream<Generation>;
+  /** Open the next generation now, or join the one opening, and wait for it. */
+  readonly rotate: Effect.Effect<Service, Unavailable>;
+  /** Stop opening at once, release every generation, and wait until each release has finished. */
+  readonly retire: Effect.Effect<void>;
+}
+/** Supervise generations of a provider's browser for as long as the scope is open. */
+declare const make: <E, R>(options: Options<E, R>) => Effect.Effect<Supervisor, never, Scope.Scope | Exclude<R, Scope.Scope>>;
+//#endregion
+export { Settled as _, Supervisor_d_exports as a, Closed as c, Kept as d, Lost as f, Reopening as g, Released as h, Supervisor as i, Down as l, Opening as m, Opened as n, Unavailable as o, Open as p, Options as r, make as s, Generation as t, GenerationState as u, Unconfirmed as v };
+//# sourceMappingURL=Supervisor-Im6-wbg5.d.mts.map

package/dist/Supervisor.d.mts

@@ -0,0 +1,2 @@
+import { _ as Settled, c as Closed, d as Kept, f as Lost, g as Reopening, h as Released, i as Supervisor, l as Down, m as Opening, n as Opened, o as Unavailable, p as Open, r as Options, s as make, t as Generation, u as GenerationState, v as Unconfirmed } from "./Supervisor-Im6-wbg5.mjs";
+export { Closed, Down, Generation, GenerationState, Kept, Lost, Open, Opened, Opening, Options, Released, Reopening, Settled, Supervisor, Unavailable, Unconfirmed, make };

package/dist/Supervisor.mjs

@@ -0,0 +1,2 @@
+import { a as Closed, c as Kept, d as Opening, f as Released, h as Unconfirmed, i as make, l as Lost, m as Settled, o as Down, p as Reopening, r as Unavailable, s as GenerationState, t as Generation, u as Open } from "./Supervisor-BtEG93gR.mjs";
+export { Closed, Down, Generation, GenerationState, Kept, Lost, Open, Opening, Released, Reopening, Settled, Unavailable, Unconfirmed, make };

package/dist/context-DAYjATgC.mjs

@@ -0,0 +1,137 @@
+import { BrowserError, Closed, Failed, Timeout } from "./BrowserError.mjs";
+import { a as redactWithin, l as make$1 } from "./url-CcL0K7S0.mjs";
+import { Clock, Context, Duration, Effect, Fiber, MutableRef, Option, Schema } from "effect";
+//#region src/internal/page/context.ts
+/**
+* What a page's parts share: the browser state they act on, the page's own lane, pointer and
+* clock, and how they call the browser and report its failures. The assembly in `page.ts` builds
+* one context per page.
+*/
+const messageOf = (cause) => cause instanceof Error ? cause.message : typeof cause === "string" ? cause : "unknown error";
+const closedPattern = /has been closed|Target closed|Session closed|browser has disconnected|Target page, context or browser/i;
+/**
+* Map a Playwright or protocol failure to a reason, `Closed` with `closed` as its cause for a page
+* or browser that is gone. A call that gives Playwright a timeout passes the same bound, so its
+* `Timeout` reports it; without one, Playwright's own message stays.
+*/
+const reasonOf = (cause, timeoutMillis, closed = "connection") => {
+	const message = messageOf(cause);
+	if (closedPattern.test(message)) return new Closed({ cause: closed });
+	if (cause instanceof Error && cause.name === "TimeoutError" && timeoutMillis !== void 0) return new Timeout({ millis: timeoutMillis });
+	const line = message.split("\n")[0] ?? message;
+	return new Failed({ detail: redactWithin(line.replace(/^[\w.]+: /, "")) });
+};
+/**
+* One Playwright or protocol call, failing undispatched. A closed page says why it is gone as the
+* browser knows then: the library's own calls fail with the browser's loss, and Playwright fails
+* its calls on a dropped connection after reporting the context closed.
+*/
+const call = (operation, run, closedBy, timeoutMillis) => Effect.tryPromise({
+	try: run,
+	catch: (cause) => undispatched(operation, reasonOf(cause, timeoutMillis, closedBy()))
+});
+const contextGone = (error) => error.reason._tag === "Failed" && /Cannot find context|Execution context was destroyed|__effectBrowser|Inspected target navigated/i.test(error.reason.detail);
+/** The cost of the page operation the current fiber runs, if any. */
+const CurrentCost = Context.Reference("effect-browser/internal/page/CurrentCost", { defaultValue: () => void 0 });
+const sizeOf = (value) => value === void 0 ? 0 : Buffer.byteLength(JSON.stringify(value));
+/** A failure of `operation` before any of its input reached the browser. */
+const undispatched = (operation, reason) => new BrowserError({
+	operation,
+	reason,
+	dispatched: false
+});
+const failWith = (operation, reason) => Effect.fail(undispatched(operation, reason));
+const decodeWith = (operation, schema) => (value) => Schema.decodeUnknownEffect(schema)(value).pipe(Effect.mapError((error) => undispatched(operation, new Failed({ detail: error.message }))));
+const make = (options, scope) => {
+	const { id, clock } = options;
+	const now = () => Number(clock.monotonicTimeNanosUnsafe()) / 1e6;
+	const owned = Effect.provideService(Clock.Clock, clock);
+	const span = (name, attributes = {}, level) => (effect) => Effect.gen(function* () {
+		const cost = {
+			enclosing: yield* CurrentCost,
+			calls: 0,
+			bytesOut: 0,
+			bytesIn: 0,
+			waitedMillis: 0,
+			awaiting: 0,
+			awaitingSince: 0
+		};
+		return yield* effect.pipe(Effect.provideService(CurrentCost, cost), Effect.ensuring(Effect.suspend(() => Effect.annotateCurrentSpan({
+			calls: cost.calls,
+			bytesOut: cost.bytesOut,
+			bytesIn: cost.bytesIn,
+			waitedMillis: Math.round(cost.waitedMillis * 10) / 10
+		}))));
+	}).pipe(Effect.withSpan(name, {
+		attributes: {
+			page: id,
+			...attributes
+		},
+		...level === void 0 ? {} : { level }
+	}, { captureStackTrace: false }));
+	const send = (method, params) => {
+		const cost = Fiber.getCurrent()?.getRef(CurrentCost);
+		const sentAt = now();
+		const bytesOut = sizeOf(params);
+		for (let each = cost; each !== void 0; each = each.enclosing) {
+			each.calls++;
+			each.bytesOut += bytesOut;
+			if (each.awaiting++ === 0) each.awaitingSince = sentAt;
+		}
+		const reply = options.untilLost(options.cdp.send(method, params));
+		if (cost === void 0) return reply;
+		const settle = (bytesIn) => {
+			const at = now();
+			for (let each = cost; each !== void 0; each = each.enclosing) {
+				each.bytesIn += bytesIn;
+				if (--each.awaiting === 0) each.waitedMillis += at - each.awaitingSince;
+			}
+		};
+		return reply.then((result) => {
+			settle(sizeOf(result));
+			return result;
+		}, (cause) => {
+			settle(0);
+			return Promise.reject(cause);
+		});
+	};
+	const native = (operation, run, timeoutMillis) => call(operation, run, options.closedBy, timeoutMillis);
+	/** Fail with `Timeout` once `duration` has passed, the action timeout unless another is given. */
+	const within = (operation, duration = options.settings.actionTimeout) => (effect) => Effect.timeoutOrElse(effect, {
+		duration,
+		orElse: () => failWith(operation, new Timeout({ millis: Duration.toMillis(duration) }))
+	});
+	const activity = {
+		inputAt: 0,
+		documentAt: Number.NEGATIVE_INFINITY
+	};
+	const noteInput = () => {
+		activity.inputAt = Math.max(activity.inputAt, now());
+	};
+	const lane = make$1({
+		now,
+		actionTimeout: options.settings.actionTimeout,
+		documentAt: () => activity.documentAt,
+		gone: (operation) => undispatched(operation, new Closed({ cause: options.closedBy() })),
+		scope
+	});
+	const pointer = MutableRef.make(Option.none());
+	const protocol = { send };
+	return {
+		...options,
+		lane,
+		pointer,
+		now,
+		owned,
+		span,
+		protocol,
+		native,
+		within,
+		activity,
+		noteInput
+	};
+};
+//#endregion
+export { make as a, failWith as i, contextGone as n, reasonOf as o, decodeWith as r, undispatched as s, call as t };
+
+//# sourceMappingURL=context-DAYjATgC.mjs.map

package/dist/context-DAYjATgC.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-DAYjATgC.mjs","names":["Url.redactWithin","Lane.make"],"sources":["../src/internal/page/context.ts"],"sourcesContent":["/**\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 { BrowserError, Closed, Failed, type Reason, Timeout } from \"../../BrowserError.ts\";\nimport type { BrowserEvent } from \"../../BrowserEvent.ts\";\nimport type { InputGuard, Point } from \"../../Page.ts\";\nimport type * 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  /** 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  /** 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// 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\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 = () => Number(clock.monotonicTimeNanosUnsafe()) / 1e6;\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 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 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  // 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, 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  // 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  });\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    owned,\n    span,\n    protocol,\n    native,\n    within,\n    activity,\n    noteInput,\n  };\n};\n\nexport type PageContext = ReturnType<typeof make>;\n"],"mappings":";;;;;;;;;AAsEA,MAAM,aAAa,UACjB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,UAAU,WAAW,QAAQ;AAE/E,MAAM,gBACJ;;;;;;AAOF,MAAa,YACX,OACA,eACA,SAAsB,iBACX;CACX,MAAM,UAAU,UAAU,KAAK;CAE/B,IAAI,cAAc,KAAK,OAAO,GAAG,OAAO,IAAI,OAAO,EAAE,OAAO,OAAO,CAAC;CACpE,IAAI,iBAAiB,SAAS,MAAM,SAAS,kBAAkB,kBAAkB,KAAA,GAC/E,OAAO,IAAI,QAAQ,EAAE,QAAQ,cAAc,CAAC;CAC9C,MAAM,OAAO,QAAQ,MAAM,IAAI,CAAC,CAAC,MAAM;CAEvC,OAAO,IAAI,OAAO,EAAE,QAAQA,aAAiB,KAAK,QAAQ,aAAa,EAAE,CAAC,EAAE,CAAC;AAC/E;;;;;;AAOA,MAAa,QACX,WACA,KACA,UACA,kBAEA,OAAO,WAAW;CAChB,KAAK;CACL,QAAQ,UAAU,aAAa,WAAW,SAAS,OAAO,eAAe,SAAS,CAAC,CAAC;AACtF,CAAC;AAEH,MAAa,eAAe,UAC1B,MAAM,OAAO,SAAS,YACtB,kGAAkG,KAChG,MAAM,OAAO,MACf;;AAkBF,MAAM,cAAc,QAAQ,UAC1B,4CACA,EACE,oBAAoB,KAAA,EACtB,CACF;AAGA,MAAM,UAAU,UACd,UAAU,KAAA,IAAY,IAAI,OAAO,WAAW,KAAK,UAAU,KAAK,CAAC;;AAGnE,MAAa,gBAAgB,WAAmB,WAC9C,IAAI,aAAa;CAAE;CAAW;CAAQ,YAAY;AAAM,CAAC;AAE3D,MAAa,YAAY,WAAmB,WAC1C,OAAO,KAAK,aAAa,WAAW,MAAM,CAAC;AAE7C,MAAa,cACP,WAAmB,YACtB,UACC,OAAO,oBAAoB,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KACxC,OAAO,UAAU,UAAU,aAAa,WAAW,IAAI,OAAO,EAAE,QAAQ,MAAM,QAAQ,CAAC,CAAC,CAAC,CAC3F;AAEJ,MAAa,QAAQ,SAAsB,UAAuB;CAChE,MAAM,EAAE,IAAI,UAAU;CACtB,MAAM,YAAY,OAAO,MAAM,yBAAyB,CAAC,IAAI;CAG7D,MAAM,QAAQ,OAAO,eAAe,MAAM,OAAO,KAAK;CAKtD,MAAM,QACH,MAAc,aAAsC,CAAC,GAAG,WAC/C,WACR,OAAO,IAAI,aAAa;EACtB,MAAM,OAAa;GACjB,WAAW,OAAO;GAClB,OAAO;GACP,UAAU;GACV,SAAS;GACT,cAAc;GACd,UAAU;GACV,eAAe;EACjB;EAEA,OAAO,OAAO,OAAO,KACnB,OAAO,eAAe,aAAa,IAAI,GACvC,OAAO,SACL,OAAO,cACL,OAAO,oBAAoB;GACzB,OAAO,KAAK;GACZ,UAAU,KAAK;GACf,SAAS,KAAK;GACd,cAAc,KAAK,MAAM,KAAK,eAAe,EAAE,IAAI;EACrD,CAAC,CACH,CACF,CACF;CACF,CAAC,CAAC,CAAC,KACD,OAAO,SACL,MACA;EAAE,YAAY;GAAE,MAAM;GAAI,GAAG;EAAW;EAAG,GAAI,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM;CAAG,GACrF,EAAE,mBAAmB,MAAM,CAC7B,CACF;CAKJ,MAAM,QAA4B,QAAQ,WAAW;EACnD,MAAM,OAAO,MAAM,WAAW,CAAC,EAAE,OAAO,WAAW;EACnD,MAAM,SAAS,IAAI;EACnB,MAAM,WAAW,OAAO,MAAM;EAE9B,KAAK,IAAI,OAAO,MAAM,SAAS,KAAA,GAAW,OAAO,KAAK,WAAW;GAC/D,KAAK;GACL,KAAK,YAAY;GACjB,IAAI,KAAK,eAAe,GAAG,KAAK,gBAAgB;EAClD;EACA,MAAM,QAAQ,QAAQ,UAAU,QAAQ,IAAI,KAAK,QAAQ,MAAM,CAAC;EAEhE,IAAI,SAAS,KAAA,GAAW,OAAO;EAE/B,MAAM,UAAU,YAAoB;GAClC,MAAM,KAAK,IAAI;GAEf,KAAK,IAAI,OAAyB,MAAM,SAAS,KAAA,GAAW,OAAO,KAAK,WAAW;IACjF,KAAK,WAAW;IAChB,IAAI,EAAE,KAAK,aAAa,GAAG,KAAK,gBAAgB,KAAK,KAAK;GAC5D;EACF;EAEA,OAAO,MAAM,MACV,WAAW;GACV,OAAO,OAAO,MAAM,CAAC;GAErB,OAAO;EACT,IACC,UAAmB;GAClB,OAAO,CAAC;GAER,OAAO,QAAQ,OAAO,KAAK;EAC7B,CACF;CACF;CAIA,MAAM,UAAa,WAAmB,KAAuB,kBAC3D,KAAK,WAAW,KAAK,QAAQ,UAAU,aAAa;;CAGtD,MAAM,UACH,WAAmB,WAA2B,QAAQ,SAAS,mBACtD,WACR,OAAO,cAAc,QAAQ;EAC3B;EACA,cAAc,SAAS,WAAW,IAAI,QAAQ,EAAE,QAAQ,SAAS,SAAS,QAAQ,EAAE,CAAC,CAAC;CACxF,CAAC;CAQL,MAAM,WAAW;EAAE,SAAS;EAAG,YAAY,OAAO;CAAkB;CAEpE,MAAM,kBAAkB;EACtB,SAAS,UAAU,KAAK,IAAI,SAAS,SAAS,IAAI,CAAC;CACrD;CAEA,MAAM,OAAOC,OAAU;EACrB;EACA,eAAe,QAAQ,SAAS;EAChC,kBAAkB,SAAS;EAC3B,OAAO,cAAc,aAAa,WAAW,IAAI,OAAO,EAAE,OAAO,QAAQ,SAAS,EAAE,CAAC,CAAC;EACtF;CACF,CAAC;CAKD,MAAM,UAAU,WAAW,KAAK,OAAO,KAAY,CAAC;CAGpD,MAAM,WAAqC,EAAE,KAAK;CAElD,OAAO;EACL,GAAG;EACH;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}

package/dist/index.d.mts

@@ -1,14 +1,17 @@
-import * as Bootstrap from "./Bootstrap.mjs";
-import * as Browser from "./Browser.mjs";
-import * as BrowserData from "./BrowserData.mjs";
-import * as BrowserRuntime from "./BrowserRuntime.mjs";
-import * as Capture from "./Capture.mjs";
-import * as CaptureData from "./CaptureData.mjs";
-import * as Errors from "./Errors.mjs";
-import * as PageControl from "./PageControl.mjs";
-import * as Plan from "./Plan.mjs";
-import * as PlanData from "./PlanData.mjs";
-import * as Timeline from "./Timeline.mjs";
-import * as TimelineData from "./TimelineData.mjs";
-export { Bootstrap, Browser, BrowserData, BrowserRuntime, Capture, CaptureData, Errors, PageControl, Plan, PlanData, Timeline, TimelineData };
-export {};
+import { n as BrowserError_d_exports } from "./BrowserError-DXXIA6Rk.mjs";
+import { a as BrowserEvent_d_exports } from "./BrowserEvent-DzdNdvoh.mjs";
+import { n as Change_d_exports } from "./Change-DVP2IJWm.mjs";
+import { i as Frame_d_exports } from "./Frame-BERmf_gM.mjs";
+import { i as Snapshot_d_exports } from "./Snapshot-B34hZ4Jl.mjs";
+import { N as Moment_d_exports, d as Page_d_exports } from "./Page-DYTdVhYa.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 { t as Motion_d_exports } from "./Motion.mjs";
+import { n as Plan_d_exports } from "./Plan-CNNOU1Tx.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";
+import { a as Supervisor_d_exports } from "./Supervisor-Im6-wbg5.mjs";
+export { Browser_d_exports as Browser, BrowserError_d_exports as BrowserError, BrowserEvent_d_exports as BrowserEvent, Cdp_d_exports as Cdp, Change_d_exports as Change, Chromium_d_exports as Chromium, Expect_d_exports as Expect, Frame_d_exports as Frame, Moment_d_exports as Moment, Motion_d_exports as Motion, Page_d_exports as Page, Plan_d_exports as Plan, Policy_d_exports as Policy, Presentation_d_exports as Presentation, Snapshot_d_exports as Snapshot, Stage_d_exports as Stage, Supervisor_d_exports as Supervisor };

package/dist/index.mjs

@@ -1,13 +1,18 @@
-import * as Bootstrap from "./Bootstrap.mjs";
-import * as Browser from "./Browser.mjs";
-import * as BrowserData from "./BrowserData.mjs";
-import * as BrowserRuntime from "./BrowserRuntime.mjs";
-import * as Capture from "./Capture.mjs";
-import * as CaptureData from "./CaptureData.mjs";
-import * as Errors from "./Errors.mjs";
-import * as PageControl from "./PageControl.mjs";
-import * as Plan from "./Plan.mjs";
-import * as PlanData from "./PlanData.mjs";
-import * as Timeline from "./Timeline.mjs";
-import * as TimelineData from "./TimelineData.mjs";
-export { Bootstrap, Browser, BrowserData, BrowserRuntime, Capture, CaptureData, Errors, PageControl, Plan, PlanData, Timeline, TimelineData };
+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-B5AV7zPS.mjs";
+import { t as Frame_exports } from "./Frame.mjs";
+import { a as Page_exports } from "./Page-D4281dIi.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 { n as Plan_exports } from "./Plan-5MdsRzE5.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 { n as Supervisor_exports } from "./Supervisor-BtEG93gR.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 };

package/dist/match.inpage-xOe9LNO0.mjs

@@ -0,0 +1,48 @@
+//#region src/internal/reading/match.inpage.ts
+const match = () => {
+	/**
+	* How names, text and context compare: one Unicode form, without invisible format characters,
+	* spaces collapsed, and case folded upper first, so that "ß" and "SS" read the same.
+	*/
+	const normalize = (value) => value.normalize("NFKC").replace(/\p{Cf}/gu, "").replace(/\s+/g, " ").trim().toUpperCase().toLowerCase();
+	/** A string that reads the same, or, unless `whole`, appears within; or a pattern found within. */
+	const rule = (wanted, whole) => {
+		if (typeof wanted !== "string") {
+			const found = new RegExp(wanted.source, wanted.flags.replace(/[gy]/g, ""));
+			return (value) => found.test(value.replace(/\s+/g, " ").trim());
+		}
+		const target = normalize(wanted);
+		return whole ? (value) => normalize(value) === target : (value) => normalize(value).includes(target);
+	};
+	/** Whether a value's words appear, whole and in order, among a text's: "BTC" not in "WBTC". */
+	const holds = (text, value) => ` ${normalize(text)} `.includes(` ${normalize(value)} `);
+	/** Whether a candidate meets every rule a query gives; a rule left out always holds. */
+	const compile = (request) => {
+		const role = request.role === null ? null : normalize(request.role);
+		const name = request.name === null ? null : rule(request.name, true);
+		const text = request.text === null ? null : rule(request.text, false);
+		const { near } = request;
+		return (candidate) => {
+			if (role !== null && normalize(candidate.role ?? "") !== role) return false;
+			if (text !== null && !text(candidate.text())) return false;
+			if (name !== null && !name(candidate.name())) return false;
+			if (near === null) return true;
+			const { row, column, label, heading } = candidate.context();
+			return [
+				row,
+				column,
+				label,
+				heading
+			].some((value) => value !== void 0 && holds(value, near));
+		};
+	};
+	return {
+		compile,
+		holds,
+		normalize
+	};
+};
+//#endregion
+export { match as t };
+
+//# sourceMappingURL=match.inpage-xOe9LNO0.mjs.map

package/dist/match.inpage-xOe9LNO0.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.inpage-xOe9LNO0.mjs","names":[],"sources":["../src/internal/reading/match.inpage.ts"],"sourcesContent":["/**\n * In the page: the rules `find` matches by. It touches no DOM, so it also runs outside a page.\n *\n * - A role matches when it is the same token, ignoring case and the space around it.\n * - A name given as a string matches when the two read the same once their spaces are collapsed,\n *   their case folded and their characters given one Unicode form; a pattern matches when it\n *   finds itself in the name.\n * - Text matches when it appears, read the same way, in the element's text.\n * - `near` matches when its words appear, whole and in order, in any of the element's context:\n *   its row, column, label or heading. Replay chooses among candidates by the same rule.\n */\nimport type { SubjectContext } from \"../../BrowserEvent.ts\";\n\n/** A string, or a pattern sent to the page as its source and flags. */\nexport type Wanted = string | { readonly source: string; readonly flags: string };\n\nexport interface FindRequest {\n  readonly role: string | null;\n  readonly name: Wanted | null;\n  readonly text: Wanted | null;\n  readonly near: string | null;\n  readonly at: { readonly x: number; readonly y: number } | null;\n  readonly scope: \"viewport\" | \"document\";\n  readonly firstRef: number;\n}\n\n/** What a query is matched against, read only when a rule needs it. */\nexport interface Candidate {\n  readonly role: string | null;\n  readonly name: () => string;\n  readonly text: () => string;\n  readonly context: () => SubjectContext;\n}\n\nexport const match = () => {\n  /**\n   * How names, text and context compare: one Unicode form, without invisible format characters,\n   * spaces collapsed, and case folded upper first, so that \"ß\" and \"SS\" read the same.\n   */\n  const normalize = (value: string): string =>\n    value\n      .normalize(\"NFKC\")\n      .replace(/\\p{Cf}/gu, \"\")\n      .replace(/\\s+/g, \" \")\n      .trim()\n      .toUpperCase()\n      .toLowerCase();\n\n  /** A string that reads the same, or, unless `whole`, appears within; or a pattern found within. */\n  const rule = (wanted: Wanted, whole: boolean) => {\n    if (typeof wanted !== \"string\") {\n      // `g` and `y` keep a position from one test to the next, so one pattern would answer\n      // differently for each element. A pattern is tried on the text as the page shows it.\n      const found = new RegExp(wanted.source, wanted.flags.replace(/[gy]/g, \"\"));\n\n      return (value: string) => found.test(value.replace(/\\s+/g, \" \").trim());\n    }\n    const target = normalize(wanted);\n\n    return whole\n      ? (value: string) => normalize(value) === target\n      : (value: string) => normalize(value).includes(target);\n  };\n\n  /** Whether a value's words appear, whole and in order, among a text's: \"BTC\" not in \"WBTC\". */\n  const holds = (text: string, value: string) =>\n    ` ${normalize(text)} `.includes(` ${normalize(value)} `);\n\n  /** Whether a candidate meets every rule a query gives; a rule left out always holds. */\n  const compile = (request: Pick<FindRequest, \"role\" | \"name\" | \"text\" | \"near\">) => {\n    const role = request.role === null ? null : normalize(request.role);\n    const name = request.name === null ? null : rule(request.name, true);\n    const text = request.text === null ? null : rule(request.text, false);\n    const { near } = request;\n\n    return (candidate: Candidate): boolean => {\n      if (role !== null && normalize(candidate.role ?? \"\") !== role) return false;\n      if (text !== null && !text(candidate.text())) return false;\n      if (name !== null && !name(candidate.name())) return false;\n      if (near === null) return true;\n      const { row, column, label, heading } = candidate.context();\n\n      return [row, column, label, heading].some(\n        (value) => value !== undefined && holds(value, near),\n      );\n    };\n  };\n\n  return { compile, holds, normalize };\n};\n\nexport type Match = ReturnType<typeof match>;\n"],"mappings":";AAkCA,MAAa,cAAc;;;;;CAKzB,MAAM,aAAa,UACjB,MACG,UAAU,MAAM,CAAC,CACjB,QAAQ,YAAY,EAAE,CAAC,CACvB,QAAQ,QAAQ,GAAG,CAAC,CACpB,KAAK,CAAC,CACN,YAAY,CAAC,CACb,YAAY;;CAGjB,MAAM,QAAQ,QAAgB,UAAmB;EAC/C,IAAI,OAAO,WAAW,UAAU;GAG9B,MAAM,QAAQ,IAAI,OAAO,OAAO,QAAQ,OAAO,MAAM,QAAQ,SAAS,EAAE,CAAC;GAEzE,QAAQ,UAAkB,MAAM,KAAK,MAAM,QAAQ,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC;EACxE;EACA,MAAM,SAAS,UAAU,MAAM;EAE/B,OAAO,SACF,UAAkB,UAAU,KAAK,MAAM,UACvC,UAAkB,UAAU,KAAK,CAAC,CAAC,SAAS,MAAM;CACzD;;CAGA,MAAM,SAAS,MAAc,UAC3B,IAAI,UAAU,IAAI,EAAE,GAAG,SAAS,IAAI,UAAU,KAAK,EAAE,EAAE;;CAGzD,MAAM,WAAW,YAAkE;EACjF,MAAM,OAAO,QAAQ,SAAS,OAAO,OAAO,UAAU,QAAQ,IAAI;EAClE,MAAM,OAAO,QAAQ,SAAS,OAAO,OAAO,KAAK,QAAQ,MAAM,IAAI;EACnE,MAAM,OAAO,QAAQ,SAAS,OAAO,OAAO,KAAK,QAAQ,MAAM,KAAK;EACpE,MAAM,EAAE,SAAS;EAEjB,QAAQ,cAAkC;GACxC,IAAI,SAAS,QAAQ,UAAU,UAAU,QAAQ,EAAE,MAAM,MAAM,OAAO;GACtE,IAAI,SAAS,QAAQ,CAAC,KAAK,UAAU,KAAK,CAAC,GAAG,OAAO;GACrD,IAAI,SAAS,QAAQ,CAAC,KAAK,UAAU,KAAK,CAAC,GAAG,OAAO;GACrD,IAAI,SAAS,MAAM,OAAO;GAC1B,MAAM,EAAE,KAAK,QAAQ,OAAO,YAAY,UAAU,QAAQ;GAE1D,OAAO;IAAC;IAAK;IAAQ;IAAO;GAAO,CAAC,CAAC,MAClC,UAAU,UAAU,KAAA,KAAa,MAAM,OAAO,IAAI,CACrD;EACF;CACF;CAEA,OAAO;EAAE;EAAS;EAAO;CAAU;AACrC"}