effect-browser 0.2.0-beta.6 → 0.2.0-beta.8

package/dist/Testing.d.mts

@@ -1,7 +1,7 @@
 import { BrowserError, BrowserOperation, BrowserOutcome, BrowserReason, InitializationError } from "./Errors.mjs";
-import { a as BrowserPolicy, et as Viewport, n as AutomationOptions, nt as ViewportPoint } from "./BrowserData-DPh3Oaof.mjs";
-import { BrowserSession, OpenOptions } from "./Browser.mjs";
-import { r as BrowserBinding } from "./BrowserRuntime-BBAjpVFa.mjs";
+import { it as Viewport, o as BrowserPolicy, ot as ViewportPoint, r as AutomationOptions } from "./BrowserData-CPIIIHol.mjs";
+import { c as OpenOptions, i as BrowserSession } from "./Browser-n-bKgBNN.mjs";
+import { r as BrowserBinding } from "./BrowserRuntime-CFe9uUTv.mjs";
 import { Crypto, Effect, Layer, Option, Schema, Scope } from "effect";
 //#region src/internal/testing/Frame.d.ts
 /** A valid 64×48 baseline JPEG, the bytes a scripted capture frame carries by default. */
@@ -72,6 +72,18 @@ export declare const DocumentScript: Schema.Struct<{
   readonly url: Schema.NonEmptyString;
   readonly title: Schema.optionalKey<Schema.String>;
   readonly text: Schema.String;
+  /**
+   * Authored root-document geometry, not inferred layout. Readings carry this exact snapshot;
+   * use document.update to supply the next state after a scripted scroll or resize.
+   */
+  readonly documentScroll: Schema.optionalKey<Schema.Struct<{
+    readonly x: Schema.Finite;
+    readonly y: Schema.Finite;
+    readonly scrollWidth: Schema.Natural;
+    readonly scrollHeight: Schema.Natural;
+    readonly clientWidth: Schema.Natural;
+    readonly clientHeight: Schema.Natural;
+  }>>;
   readonly controls: Schema.optionalKey<Schema.$Array<Schema.Struct<{
     readonly id: Schema.NonEmptyString;
     readonly kind: Schema.Literals<readonly ["link", "button", "input", "select", "textarea", "other"]>;
@@ -124,6 +136,18 @@ export declare const Script: Schema.Struct<{
     readonly url: Schema.NonEmptyString;
     readonly title: Schema.optionalKey<Schema.String>;
     readonly text: Schema.String;
+    /**
+     * Authored root-document geometry, not inferred layout. Readings carry this exact snapshot;
+     * use document.update to supply the next state after a scripted scroll or resize.
+     */
+    readonly documentScroll: Schema.optionalKey<Schema.Struct<{
+      readonly x: Schema.Finite;
+      readonly y: Schema.Finite;
+      readonly scrollWidth: Schema.Natural;
+      readonly scrollHeight: Schema.Natural;
+      readonly clientWidth: Schema.Natural;
+      readonly clientHeight: Schema.Natural;
+    }>>;
     readonly controls: Schema.optionalKey<Schema.$Array<Schema.Struct<{
       readonly id: Schema.NonEmptyString;
       readonly kind: Schema.Literals<readonly ["link", "button", "input", "select", "textarea", "other"]>;
@@ -196,7 +220,7 @@ export declare class ScriptedCleanupResult extends ScriptedCleanupResult_base {}
  * The operations whose next call a test may script. `disconnect` is the owner's native teardown
  * of a connection: a `Fail` makes it fail and a `Hold` parks it, however long cleanup waits.
  */
-export declare const ScriptableOperation: Schema.Literals<("capture-stop" | "checkpoint" | "click" | "click-and-wait" | "close-page" | "control-facts" | "disconnect" | "download-action" | "file-chooser" | "fill" | "fill-form" | "hover" | "list-frames" | "list-pages" | "navigate" | "navigate-stop" | "new-page" | "observe" | "page-resume" | "page-suspend" | "pointer-move" | "press" | "read-text" | "resize" | "revalidate" | "screenshot" | "scroll" | "select-files" | "select-frame" | "select-option" | "select-page" | "type" | "wait" | "wheel")[]>;
+export declare const ScriptableOperation: Schema.Literals<("capture-stop" | "checkpoint" | "click" | "click-and-wait" | "close-page" | "control-facts" | "describe-page" | "disconnect" | "download-action" | "file-chooser" | "fill" | "fill-form" | "hover" | "list-frames" | "list-pages" | "navigate" | "navigate-stop" | "new-page" | "observe" | "page-resume" | "page-suspend" | "pointer-move" | "press" | "read-text" | "resize" | "resolve" | "revalidate" | "run" | "screenshot" | "scroll" | "select-files" | "select-option" | "select-page" | "settled" | "type" | "wait" | "wheel")[]>;
 export type ScriptableOperation = typeof ScriptableOperation.Type;
 /** A held native call: the test learns that it arrived, then decides when it may finish. */
 interface Gate {
@@ -337,13 +361,22 @@ export interface ScriptedBinding {
  * Open one scripted browser in the caller's Scope. The session is the real owner over a
  * scripted native engine: admission, budgets, staleness, dispatch evidence, capture, page holds
  * and typed callbacks are the production code paths. Only the page and its outcomes are scripted,
- * and the owner's ids and handoff tokens come from `sequentialCrypto`.
+ * and the owner's ids and handoff tokens use deterministic Crypto namespaced by this
+ * scripted reference, so independently opened sessions have distinct evidence domains.
  */
 export declare const open: <E = never, R = never>(script: {
   readonly documents: readonly {
     readonly url: string;
     readonly title?: string | undefined;
     readonly text: string;
+    readonly documentScroll?: {
+      readonly x: number;
+      readonly y: number;
+      readonly scrollWidth: number;
+      readonly scrollHeight: number;
+      readonly clientWidth: number;
+      readonly clientHeight: number;
+    } | undefined;
     readonly controls?: readonly {
       readonly id: string;
       readonly kind: "button" | "input" | "link" | "other" | "select" | "textarea";
@@ -381,7 +414,8 @@ export declare const open: <E = never, R = never>(script: {
 /**
  * The `Crypto` scripted browsers draw their ids and handoff tokens from. Its bytes count up from
  * one on each build, so every value is predictable; it is not random and computes no digest.
- * `open` uses it already. A provider Layer built over `binding` still requires a `Crypto`, and
+ * `open` uses the same counter with its original scripted-reference namespace. A provider
+ * Layer built over `binding` still requires a `Crypto`, and
  * this one keeps such a test free of a platform package.
  */
 export declare const sequentialCrypto: Layer.Layer<Crypto.Crypto>;
@@ -395,6 +429,14 @@ export declare const binding: (script: {
     readonly url: string;
     readonly title?: string | undefined;
     readonly text: string;
+    readonly documentScroll?: {
+      readonly x: number;
+      readonly y: number;
+      readonly scrollWidth: number;
+      readonly scrollHeight: number;
+      readonly clientWidth: number;
+      readonly clientHeight: number;
+    } | undefined;
     readonly controls?: readonly {
       readonly id: string;
       readonly kind: "button" | "input" | "link" | "other" | "select" | "textarea";