@heojeongbo/wirestage 0.0.0-stage → 0.1.0

package/dist/widgets/stage/lib/page-host.js

@@ -0,0 +1,240 @@
+import { WirestageError } from "../../../shared/lib/errors/index.js";
+import { buildPageScript, commandRuntime, detachRuntime, flushRuntime, } from "./page-runtime.js";
+/** How to take a hook back out, where this Playwright can. */
+const remover = (handle) => handle?.dispose === undefined
+    ? undefined
+    : () => handle.dispose();
+/**
+ * Node half of the page host: one binding and one init script per context,
+ * carrying every registered module.
+ *
+ * Modules are sealed at the first attach. An init script cannot be amended
+ * after the fact, so a module registered later would silently be missing from
+ * pages of the contexts already attached; failing loudly is the better DX.
+ */
+export function createPageHost(deps) {
+    const modules = new Map();
+    const attachments = new Set();
+    const installed = new WeakMap();
+    const binding = `__wirestage_${deps.stage}`;
+    const { flushMs, timeoutMs } = deps;
+    let sealed = false;
+    /** Every frame of every open page: page hooks run in iframes too. */
+    const openFrames = (among, pageFilter) => {
+        const frames = [];
+        for (const attachment of among)
+            for (const page of attachment.context.pages())
+                if (!page.isClosed() &&
+                    (pageFilter === undefined || deps.pageId(page) === pageFilter))
+                    frames.push(...page.frames());
+        return frames;
+    };
+    /**
+     * `work`'s value, or undefined once `timeoutMs` have passed — with `late`
+     * logged, and the work left to finish on its own.
+     */
+    const inTime = async (work, late) => {
+        const waiting = new AbortController();
+        try {
+            return await Promise.race([
+                work.then((value) => ({ value })),
+                deps.clock.sleep(timeoutMs, waiting.signal).then(() => {
+                    deps.log.warn(late, { timeoutMs });
+                    return undefined;
+                }, 
+                // The work finished first.
+                () => undefined),
+            ]);
+        }
+        finally {
+            waiting.abort();
+        }
+    };
+    /**
+     * Evaluate in one frame, within the time a frame is given. A frame that
+     * is navigating or gone has nothing to say, which is not a failure.
+     */
+    const ask = async (frame, pageFunction, arg, what) => {
+        try {
+            return await inTime(frame.evaluate(pageFunction, arg), `a frame did not answer a ${what} in time and was passed over; what it recorded may be missing (is a dialog open?)`);
+        }
+        catch (error) {
+            deps.log.debug(`${what} skipped`, {}, error);
+            return undefined;
+        }
+    };
+    /**
+     * Take the binding or the init script back out, within the same time.
+     * Playwright's `dispose()` reaches every page of the context, and a page
+     * with a dialog open answers nothing until the dialog closes: a detach
+     * that waited for it would hang the test's teardown.
+     */
+    const release = async (remove, what) => {
+        try {
+            await inTime(remove(), `the page ${what} was not taken out in time; detaching goes on, and Playwright removes it once the page responds (is a dialog open?)`);
+        }
+        catch (error) {
+            // A context that closed first took it with it.
+            deps.log.debug("page hook already gone", {}, error);
+        }
+    };
+    const receive = (source, message, attachment) => {
+        if (message.type === "hello") {
+            const states = {};
+            for (const [id, module] of modules)
+                try {
+                    states[id] = module.state();
+                }
+                catch (error) {
+                    // One plugin's bug: its module starts without a state, every
+                    // other module with its own, and the log says whose it was.
+                    deps.log.error("page module failed to give its state", { module: id }, error);
+                }
+            return states;
+        }
+        const page = deps.pageId(source.page);
+        if (message.type === "failure") {
+            deps.log.error(`page module failed in its ${message.handler} handler`, { module: message.module, page }, message.error);
+            return undefined;
+        }
+        const byModule = new Map();
+        for (const { module, entry } of message.entries) {
+            const list = byModule.get(module) ?? [];
+            list.push(entry);
+            byModule.set(module, list);
+        }
+        for (const [id, entries] of byModule) {
+            const module = modules.get(id);
+            if (module === undefined)
+                continue;
+            try {
+                module.receive(entries, { page, context: attachment.id });
+            }
+            catch (error) {
+                deps.log.error("page module failed to receive entries", { module: id }, error);
+            }
+        }
+        return undefined;
+    };
+    const command = async (module, op, args, options = {}) => {
+        // No module, no runtime handler: a frame would have nothing to answer.
+        if (!modules.has(module))
+            return [];
+        const results = await Promise.all(openFrames(attachments, options.page).map((frame) => ask(frame, commandRuntime, { binding, module, op, args }, "command")));
+        const answers = [];
+        const failures = [];
+        for (const result of results) {
+            // No answer, or a frame the init script never ran in.
+            const outcome = result?.value;
+            if (outcome === undefined)
+                continue;
+            if ("error" in outcome)
+                failures.push(outcome.error);
+            else
+                answers.push(outcome.value);
+        }
+        if (failures.length > 0)
+            // Not "no frame answered": the module's own code failed in the page.
+            throw new WirestageError("INVALID_STATE", `page module "${module}" failed to run "${op}" in ${failures.length} frame(s): ${failures[0]}`, { details: { module, op, failures } });
+        return answers;
+    };
+    return {
+        register(module) {
+            if (sealed)
+                throw new WirestageError("INVALID_STATE", `page module "${module.id}" registered after the stage was attached; register every plugin before calling attach()`);
+            if (modules.has(module.id))
+                throw new WirestageError("INVALID_ARGUMENT", `page module "${module.id}" is already registered`);
+            try {
+                // Parsed the way the init script will use it. A source that is
+                // not an expression — a method, a bound or a native function —
+                // is a SyntaxError there that takes every module down with it,
+                // and nothing in Node would say so.
+                new Function(`return (${module.install.toString()});`);
+            }
+            catch (error) {
+                throw new WirestageError("INVALID_ARGUMENT", `page module "${module.id}" cannot run in the page: its install does not serialize to a function expression (${String(error)}); declare it with \`function\` or as an arrow function, not as an object method or a bound function`, { cause: error });
+            }
+            modules.set(module.id, module);
+        },
+        async attach(attachment) {
+            sealed = true;
+            attachments.add(attachment);
+            if (modules.size === 0)
+                return;
+            const before = installed.get(attachment.context);
+            if (before !== undefined) {
+                // Still in the context from an earlier attach this Playwright
+                // could not take back: point it at the new attachment.
+                before.current = attachment;
+                return;
+            }
+            const slot = { current: attachment };
+            installed.set(attachment.context, slot);
+            const installers = {};
+            for (const [id, module] of modules)
+                installers[id] = module.install;
+            try {
+                slot.removeBinding = remover((await attachment.context.exposeBinding(binding, (source, message) => slot.current === undefined
+                    ? undefined
+                    : receive(source, message, slot.current))));
+                slot.removeScript = remover((await attachment.context.addInitScript({
+                    content: buildPageScript({
+                        binding,
+                        flushMs,
+                        modules: [...modules].map(([id, m]) => ({
+                            id,
+                            config: m.config,
+                        })),
+                    }, installers),
+                })));
+            }
+            catch (error) {
+                installed.delete(attachment.context);
+                // A binding left behind would make the next attach fail with
+                // "already registered".
+                if (slot.removeBinding !== undefined)
+                    await release(slot.removeBinding, "binding");
+                throw error;
+            }
+        },
+        async detach(attachment) {
+            if (!attachments.delete(attachment))
+                return;
+            const slot = installed.get(attachment.context);
+            if (slot === undefined)
+                return;
+            const { removeBinding, removeScript } = slot;
+            // A Playwright that cannot take a binding or an init script back
+            // leaves them in the context, switched off; they serve it again if
+            // it is attached again.
+            const removable = removeBinding !== undefined && removeScript !== undefined;
+            if (removable) {
+                installed.delete(attachment.context);
+                // The init script first: a document that loaded while the open
+                // ones were being detached would start a runtime no detach
+                // reaches, and then lose its binding under it.
+                await release(removeScript, "init script");
+            }
+            // Undo the hooks in the documents that are open, and take what they
+            // still hold, while the binding is there to carry it.
+            await Promise.all(openFrames([attachment]).map((frame) => ask(frame, detachRuntime, binding, "detach")));
+            slot.current = undefined;
+            if (removable)
+                await release(removeBinding, "binding");
+        },
+        async sync() {
+            if (modules.size === 0)
+                return;
+            await Promise.all(openFrames(attachments).map((frame) => ask(frame, flushRuntime, binding, "flush")));
+        },
+        command,
+        async refresh(module) {
+            const target = modules.get(module);
+            if (target === undefined)
+                throw new WirestageError("INVALID_ARGUMENT", `no page module "${module}" is registered`);
+            await command(module, "__state", target.state());
+        },
+        pageId: deps.pageId,
+    };
+}
+//# sourceMappingURL=page-host.js.map

package/dist/widgets/stage/lib/page-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-host.js","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/page-host.ts"],"names":[],"mappings":"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"}

package/dist/widgets/stage/lib/page-runtime.d.ts

@@ -0,0 +1,93 @@
+/**
+ * The page half of the page host. Everything in this file that is exported as
+ * a function runs INSIDE the page: it is serialized with `toString()`, so it is
+ * self-contained — no imports, no references to module scope.
+ */
+export interface PageRuntimeInit {
+    /** The binding Node exposed; also the runtime's key in `__wirestage`. */
+    readonly binding: string;
+    /** How long entries may wait for company before the batch is flushed. */
+    readonly flushMs: number;
+    readonly modules: readonly {
+        readonly id: string;
+        readonly config: unknown;
+    }[];
+}
+/** Messages the runtime sends through the binding. */
+export type RuntimeMessage = {
+    readonly type: "hello";
+} | {
+    readonly type: "entries";
+    readonly entries: readonly {
+        readonly module: string;
+        readonly entry: unknown;
+    }[];
+} | {
+    /** A module's own handler threw, with no call to reject: Node logs it. */
+    readonly type: "failure";
+    readonly module: string;
+    /** `install`, `onState` or `onDetach`. */
+    readonly handler: string;
+    readonly error: string;
+};
+/** What the runtime publishes on `globalThis.__wirestage[binding]`. */
+export interface RuntimeHandle {
+    flush(): Promise<unknown>;
+    command(module: string, op: string, args: unknown): unknown;
+    /** Undo every module's hooks, send what is still held, and step aside. */
+    detach(): Promise<unknown>;
+}
+/** A command's answer, or why its handler failed. */
+export type CommandResult = {
+    readonly value: unknown;
+} | {
+    readonly error: string;
+};
+type Installer = (env: unknown) => void;
+/**
+ * Install every module, batch what they emit, and answer Node's flushes and
+ * commands.
+ *
+ * Batching is what keeps a 60 Hz channel cheap: one binding call per flush
+ * window instead of one per message. The first entry after a quiet spell is
+ * not held back, though — it leaves at once, so it reaches Node ahead of a
+ * request the page makes right after it and the two land on the timeline in
+ * the order they happened.
+ *
+ * `flush()` returns the binding's promise, so a Node-side `evaluate(flush)`
+ * resolves only after Node has appended the entries: a read that flushes
+ * first sees everything the page recorded before it.
+ *
+ * Nothing the runtime does throws into the page's own code: a module whose
+ * handler throws is reported to Node, and a binding that has been taken away
+ * makes the runtime step aside.
+ */
+export declare function pageRuntime(scope: Record<string, unknown>, init: PageRuntimeInit, installers: Record<string, Installer>): void;
+/** Flush one frame's runtime. Runs in the page via `frame.evaluate`. */
+export declare function flushRuntime(binding: string): Promise<unknown> | undefined;
+/** Detach one frame's runtime. Runs in the page via `frame.evaluate`. */
+export declare function detachRuntime(binding: string): Promise<unknown> | undefined;
+/**
+ * Run one command in one frame's runtime. Runs in the page via
+ * `frame.evaluate`. Undefined when the frame has no runtime (a document the
+ * init script never ran in); otherwise the handler's answer, or its failure
+ * as text — an exception would cross back to Node as a rejected evaluate,
+ * indistinguishable from a frame that went away.
+ */
+export declare function commandRuntime(arg: {
+    readonly binding: string;
+    readonly module: string;
+    readonly op: string;
+    readonly args: unknown;
+}): Promise<CommandResult> | undefined;
+/**
+ * The init script: the runtime, then every installer, then the call.
+ *
+ * Wrapped in a scope that defines `__name`: esbuild's `keepNames` (on by
+ * default in tsx) rewrites `const f = () => {}` into `__name(() => {}, "f")`,
+ * so code serialized from a tsx-run process calls a helper the page does not
+ * have, and the whole runtime dies with "__name is not defined".
+ */
+export declare function buildPageScript(init: PageRuntimeInit, installers: Readonly<Record<string, Installer>>): string;
+export {};
+//# sourceMappingURL=page-runtime.d.ts.map

package/dist/widgets/stage/lib/page-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-runtime.d.ts","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/page-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS;QAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;KACzB,EAAE,CAAC;CACJ;AAED,sDAAsD;AACtD,MAAM,MAAM,cAAc,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IACA,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS;QAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;KACxB,EAAE,CAAC;CACH,GACD;IACA,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACtB,CAAC;AAEL,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC7B,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5D,0EAA0E;IAC1E,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3B;AAED,qDAAqD;AACrD,MAAM,MAAM,aAAa,GACtB;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9B,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;AAExC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACnC,IAAI,CAoLN;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CAK1E;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CAK3E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACvB,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,CAYrC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,GAC7C,MAAM,CAKR"}

package/dist/widgets/stage/lib/page-runtime.js

@@ -0,0 +1,247 @@
+/**
+ * The page half of the page host. Everything in this file that is exported as
+ * a function runs INSIDE the page: it is serialized with `toString()`, so it is
+ * self-contained — no imports, no references to module scope.
+ */
+/**
+ * Install every module, batch what they emit, and answer Node's flushes and
+ * commands.
+ *
+ * Batching is what keeps a 60 Hz channel cheap: one binding call per flush
+ * window instead of one per message. The first entry after a quiet spell is
+ * not held back, though — it leaves at once, so it reaches Node ahead of a
+ * request the page makes right after it and the two land on the timeline in
+ * the order they happened.
+ *
+ * `flush()` returns the binding's promise, so a Node-side `evaluate(flush)`
+ * resolves only after Node has appended the entries: a read that flushes
+ * first sees everything the page recorded before it.
+ *
+ * Nothing the runtime does throws into the page's own code: a module whose
+ * handler throws is reported to Node, and a binding that has been taken away
+ * makes the runtime step aside.
+ */
+export function pageRuntime(scope, init, installers) {
+    scope["__wirestage"] ??= {};
+    const root = scope["__wirestage"];
+    const bind = scope[init.binding];
+    // Init scripts run again in every frame and on every navigation; a second
+    // run in the same realm would double every entry.
+    if (root[init.binding] !== undefined || typeof bind !== "function")
+        return;
+    const send = bind;
+    const queue = [];
+    /** Set once the runtime steps aside: a module still emitting talks to nobody. */
+    let detached = false;
+    let timer;
+    /** When the last batch left; far enough back that the first entry is not held. */
+    let sentAt = Number.NEGATIVE_INFINITY;
+    const commands = new Map();
+    const stateHandlers = new Map();
+    const detachHandlers = [];
+    const now = () => performance.timeOrigin + performance.now();
+    /** Undo every module's hooks, newest first: stacked hooks come off in order. */
+    const unhook = () => {
+        for (const { module, undo } of detachHandlers.splice(0).reverse()) {
+            try {
+                undo();
+            }
+            catch (error) {
+                // One module failing to undo must not keep the rest hooked.
+                report(module, "onDetach", error);
+            }
+        }
+        delete root[init.binding];
+    };
+    /**
+     * Send through the binding. Playwright's throws, synchronously, once it
+     * has been removed — in a document the stage's detach did not reach, one
+     * that loaded while the stage was detaching. Thrown on from `emit`, that
+     * would fail the app's own call (`RTCDataChannel.send()`) or surface as a
+     * page error; nothing the runtime holds can reach Node any more, so it
+     * steps aside instead, putting back what the modules wrapped.
+     */
+    const post = (message) => {
+        try {
+            return send(message);
+        }
+        catch {
+            detached = true;
+            queue.length = 0;
+            unhook();
+            return Promise.resolve(undefined);
+        }
+    };
+    /** Tell Node a module's handler threw, so it is logged against the module. */
+    const report = (module, handler, error) => {
+        // Stepping aside for want of a binding: there is nobody left to tell.
+        if (detached)
+            return;
+        post({ type: "failure", module, handler, error: String(error) }).catch(() => { });
+    };
+    const flush = () => {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+            timer = undefined;
+        }
+        if (queue.length === 0)
+            return Promise.resolve(undefined);
+        sentAt = now();
+        return post({ type: "entries", entries: queue.splice(0, queue.length) });
+    };
+    const schedule = () => {
+        const wait = sentAt + init.flushMs - now();
+        if (wait <= 0) {
+            flush().catch(() => { });
+            return;
+        }
+        timer ??= setTimeout(() => {
+            timer = undefined;
+            flush().catch(() => { });
+        }, wait);
+    };
+    const encode = (bytes) => {
+        let binary = "";
+        // Chunked: spreading a large array into fromCharCode overflows the stack.
+        for (let i = 0; i < bytes.length; i += 0x8000)
+            binary += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
+        return btoa(binary);
+    };
+    const decode = (text) => {
+        const binary = atob(text);
+        const out = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++)
+            out[i] = binary.charCodeAt(i);
+        return out;
+    };
+    /** Run each of a module's state handlers, whatever the others do; return what threw. */
+    const applyState = (module, state) => {
+        const failures = [];
+        for (const handler of stateHandlers.get(module) ?? [])
+            try {
+                handler(state);
+            }
+            catch (error) {
+                failures.push(error);
+            }
+        return failures;
+    };
+    for (const module of init.modules) {
+        const install = installers[module.id];
+        if (install === undefined)
+            continue;
+        const emit = (entry) => {
+            if (detached)
+                return;
+            queue.push({ module: module.id, entry });
+            schedule();
+        };
+        try {
+            install({
+                window: scope,
+                config: module.config,
+                emit,
+                now,
+                encode,
+                decode,
+                onCommand: (op, handler) => {
+                    commands.set(`${module.id}\u0000${op}`, handler);
+                },
+                onState: (handler) => {
+                    const list = stateHandlers.get(module.id) ?? [];
+                    list.push(handler);
+                    stateHandlers.set(module.id, list);
+                },
+                onDetach: (handler) => {
+                    detachHandlers.push({ module: module.id, undo: handler });
+                },
+            });
+        }
+        catch (error) {
+            // A broken module must not take the page down with it: an entry puts
+            // the failure on its timeline, and Node logs it against the module.
+            emit({ type: "error", at: now(), text: String(error) });
+            report(module.id, "install", error);
+        }
+    }
+    const handle = {
+        flush,
+        command(module, op, args) {
+            if (op === "__state") {
+                // Every handler gets the state; the command still fails when one
+                // threw, so the `refresh()` that sent it says which module broke.
+                const failures = applyState(module, args);
+                if (failures.length > 0)
+                    throw failures[0];
+                return true;
+            }
+            const handler = commands.get(`${module}\u0000${op}`);
+            return handler === undefined ? undefined : handler(args);
+        },
+        detach() {
+            unhook();
+            // After the undos: what they emit still leaves with the last flush.
+            detached = true;
+            return flush();
+        },
+    };
+    root[init.binding] = handle;
+    // Chromium loses a binding call made from `pagehide` when the main frame
+    // navigates — the document is gone before Node hears of it — while one
+    // made from `beforeunload` still arrives. `pagehide` stays for the ways
+    // out that fire no `beforeunload`: a page closed, an iframe removed.
+    for (const type of ["beforeunload", "pagehide"])
+        scope.addEventListener(type, () => {
+            flush().catch(() => { });
+        });
+    post({ type: "hello" }).then((states) => {
+        const byModule = (states ?? {});
+        for (const module of stateHandlers.keys())
+            if (byModule[module] !== undefined)
+                // No call to fail: Node hears of each failure, and the
+                // modules after this one still get their state.
+                for (const error of applyState(module, byModule[module]))
+                    report(module, "onState", error);
+    }, () => { });
+}
+/** Flush one frame's runtime. Runs in the page via `frame.evaluate`. */
+export function flushRuntime(binding) {
+    const root = globalThis["__wirestage"];
+    return root?.[binding]?.flush();
+}
+/** Detach one frame's runtime. Runs in the page via `frame.evaluate`. */
+export function detachRuntime(binding) {
+    const root = globalThis["__wirestage"];
+    return root?.[binding]?.detach();
+}
+/**
+ * Run one command in one frame's runtime. Runs in the page via
+ * `frame.evaluate`. Undefined when the frame has no runtime (a document the
+ * init script never ran in); otherwise the handler's answer, or its failure
+ * as text — an exception would cross back to Node as a rejected evaluate,
+ * indistinguishable from a frame that went away.
+ */
+export function commandRuntime(arg) {
+    const root = globalThis["__wirestage"];
+    const handle = root?.[arg.binding];
+    if (handle === undefined)
+        return undefined;
+    return Promise.resolve()
+        .then(() => handle.command(arg.module, arg.op, arg.args))
+        .then((value) => ({ value }), (error) => ({ error: String(error) }));
+}
+/**
+ * The init script: the runtime, then every installer, then the call.
+ *
+ * Wrapped in a scope that defines `__name`: esbuild's `keepNames` (on by
+ * default in tsx) rewrites `const f = () => {}` into `__name(() => {}, "f")`,
+ * so code serialized from a tsx-run process calls a helper the page does not
+ * have, and the whole runtime dies with "__name is not defined".
+ */
+export function buildPageScript(init, installers) {
+    const list = Object.entries(installers)
+        .map(([id, install]) => `${JSON.stringify(id)}: (${install.toString()})`)
+        .join(",\n");
+    return `(() => {\nconst __name = (target) => target;\n(${pageRuntime.toString()})(globalThis, ${JSON.stringify(init)}, {\n${list}\n});\n})();`;
+}
+//# sourceMappingURL=page-runtime.js.map

package/dist/widgets/stage/lib/page-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-runtime.js","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/page-runtime.ts"],"names":[],"mappings":"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"}

package/dist/widgets/stage/lib/reads.d.ts

@@ -0,0 +1,21 @@
+import type { Timeline } from "../../../entities/frame/index.js";
+import type { Clock } from "../../../shared/lib/clock/index.js";
+import type { StageCore } from "../model/stage.js";
+export interface ReadsDeps {
+    readonly timeline: Timeline;
+    readonly clock: Clock;
+    /** Flush every page buffer into the timeline. */
+    readonly sync: () => Promise<void>;
+    /** Defaults for `waitFor`, in milliseconds. */
+    readonly wait: {
+        readonly timeout: number;
+        readonly interval: number;
+    };
+}
+export type StageReads = Pick<StageCore, "frames" | "drain" | "mark" | "since" | "between" | "waitFor" | "report">;
+/**
+ * The stage's reads of its timeline. Every one flushes the page buffers
+ * first: that flush is what makes arrival order the order things happened in.
+ */
+export declare function createReads(deps: ReadsDeps): StageReads;
+//# sourceMappingURL=reads.d.ts.map

package/dist/widgets/stage/lib/reads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reads.d.ts","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/reads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGX,QAAQ,EACR,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oCAAoC,CAAC;AAEhE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AASD,MAAM,MAAM,UAAU,GAAG,IAAI,CAC5B,SAAS,EACT,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CACxE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAmFvD"}