@heojeongbo/wirestage 0.0.0-stage → 0.1.0

package/dist/widgets/stage/lib/http-router.js

@@ -0,0 +1,455 @@
+import { toBuffer, toBytes, utf8 } from "../../../shared/lib/bytes/index.js";
+import { WirestageError } from "../../../shared/lib/errors/index.js";
+import { compileUrlMatcher } from "../../../shared/lib/match/index.js";
+import { createResponseStream } from "./response-stream.js";
+/**
+ * Turns HTTP rules into ONE Playwright route per attached context and runs
+ * the chain itself: the newest rule that matches decides, and a `fallback`
+ * hands the request to the next.
+ *
+ * Running the chain here, rather than as one Playwright route per rule, is
+ * what makes a request one exchange however many rules see it: they share a
+ * view and a correlation id, `times` is claimed without an await between the
+ * check and the count, and a rule that passed a request on hears about the
+ * network's answer only when the network really gave one.
+ */
+export function createHttpRouter(deps) {
+    /** Active rules, oldest first. */
+    const entries = [];
+    const attachments = new Map();
+    const routes = new Map();
+    const pending = new WeakMap();
+    const localNetwork = new WeakMap();
+    /** Responses being read off the browser, on their way to the timeline. */
+    const settling = new Set();
+    /**
+     * Chromium's Local Network Access blocks a page whose address space it
+     * cannot place — every page a route fulfilled, and any remote origin — from
+     * reaching the loopback stream server. Granted once per context, the first
+     * time a stream needs it, and every stream waits for that one grant; a
+     * browser without the permission simply refuses it, and then needs none.
+     */
+    const allowLocalNetwork = (attachment) => {
+        let granting = localNetwork.get(attachment);
+        if (granting === undefined) {
+            granting = Promise.resolve()
+                .then(() => attachment.context.grantPermissions?.(["local-network-access"]))
+                .catch((error) => {
+                deps.log.debug("local-network-access not granted", {}, error);
+            });
+            localNetwork.set(attachment, granting);
+        }
+        return granting;
+    };
+    const createView = async (request, attachment, url) => {
+        let body;
+        let correlation;
+        const getBody = () => {
+            body ??= toBytes(request.postDataBuffer() ?? new Uint8Array(0));
+            return body;
+        };
+        let page;
+        try {
+            page = deps.pageId(request.frame().page());
+        }
+        catch {
+            // Service-worker requests have no frame.
+            page = undefined;
+        }
+        return {
+            get correlation() {
+                correlation ??= deps.correlation();
+                return correlation;
+            },
+            method: request.method(),
+            url,
+            headers: await request.allHeaders(),
+            page,
+            context: attachment.id,
+            resourceType: request.resourceType(),
+            body: getBody,
+            text: () => utf8(getBody()),
+            json: () => JSON.parse(utf8(getBody())),
+        };
+    };
+    const append = ({ view }, protocol, endpoint, frame) => deps.timeline.append({
+        ...frame,
+        protocol,
+        endpoint,
+        page: view.page,
+        context: view.context,
+        correlation: view.correlation,
+    });
+    /** End the exchange for every protocol that recorded its request. */
+    const close = (exchange, frame) => {
+        for (const [protocol, endpoint] of exchange.recorded)
+            append(exchange, protocol, endpoint, frame);
+    };
+    /**
+     * A rule's URL test, which is the caller's code when the rule was given a
+     * predicate. Playwright calls this for every request of the context, so
+     * one that throws would break them all: it counts as "no match" instead.
+     */
+    const wants = (entry, url) => {
+        try {
+            return entry.matchesUrl(url);
+        }
+        catch (error) {
+            deps.log.error("rule's URL matcher failed", { rule: entry.rule.label, url: url.href }, error);
+            return false;
+        }
+    };
+    /** The rule's name for the request; the path when it has none to give. */
+    const nameOf = ({ rule }, view) => {
+        try {
+            return rule.endpoint?.(view) ?? view.url.pathname;
+        }
+        catch {
+            // Reached only while reporting a rule that already failed.
+            return view.url.pathname;
+        }
+    };
+    const retire = (entry) => {
+        if (!entry.active)
+            return;
+        entry.active = false;
+        entries.splice(entries.indexOf(entry), 1);
+    };
+    /**
+     * Whether `entry` takes the request, and its decision if so. The checks
+     * and the count are one synchronous step: two requests in flight cannot
+     * both take the last of a rule's `times`.
+     */
+    const decide = async (entry, exchange) => {
+        const { rule } = entry;
+        const { view } = exchange;
+        if (!entry.active)
+            return undefined;
+        if (entry.methods !== undefined && !entry.methods.has(view.method))
+            return undefined;
+        if (rule.match !== undefined && !rule.match(view))
+            return undefined;
+        entry.hits += 1;
+        if (entry.remaining !== undefined && --entry.remaining === 0)
+            retire(entry);
+        if (rule.record !== false && !exchange.recorded.has(rule.protocol)) {
+            const endpoint = rule.endpoint?.(view) ?? view.url.pathname;
+            exchange.recorded.set(rule.protocol, endpoint);
+            append(exchange, rule.protocol, endpoint, {
+                kind: "request",
+                direction: "out",
+                source: "page",
+                data: () => view.body(),
+                meta: {
+                    method: view.method,
+                    url: view.url.href,
+                    headers: view.headers,
+                },
+            });
+        }
+        return rule.handle(view);
+    };
+    /** The request goes to the network: remember who wants to hear the answer. */
+    const track = (exchange) => {
+        if (exchange.recorded.size > 0 ||
+            exchange.passed.some(({ rule }) => rule.onPassthroughResponse !== undefined ||
+                rule.onPassthroughFailure !== undefined))
+            pending.set(exchange.request, exchange);
+    };
+    const execute = {
+        async fulfill(outcome, exchange) {
+            const status = outcome.status ?? 200;
+            const headers = { ...outcome.headers };
+            const body = outcome.body === undefined ? undefined : toBytes(outcome.body);
+            await exchange.route.fulfill(body === undefined
+                ? { status, headers }
+                : { status, headers, body: toBuffer(body) });
+            close(exchange, {
+                kind: "response",
+                direction: "in",
+                source: "stub",
+                ...(body === undefined ? {} : { data: body }),
+                meta: { status, headers },
+            });
+        },
+        async stream(outcome, exchange) {
+            const session = await deps.streams.open((request, response) => {
+                const stream = createResponseStream(request, response);
+                void stream.closed.then((end) => close(exchange, end === "cut"
+                    ? {
+                        kind: "fault",
+                        direction: "none",
+                        source: "stub",
+                        meta: { reason: "cut" },
+                    }
+                    : {
+                        kind: "lifecycle",
+                        direction: "none",
+                        // The page let go of it, or the stub ended it.
+                        source: end === "cancelled" ? "page" : "stub",
+                        meta: { event: "close", end },
+                    }));
+                return outcome.open(stream);
+            }, { secure: exchange.view.url.protocol === "https:" });
+            await allowLocalNetwork(exchange.attachment);
+            try {
+                await exchange.route.continue({ url: session.url });
+            }
+            catch (error) {
+                session.dispose();
+                throw error;
+            }
+        },
+        async continue(outcome, exchange, entry) {
+            exchange.passed.push(entry);
+            track(exchange);
+            await exchange.route.continue({
+                ...(outcome.url === undefined ? {} : { url: outcome.url }),
+                ...(outcome.method === undefined ? {} : { method: outcome.method }),
+                ...(outcome.headers === undefined
+                    ? {}
+                    : { headers: { ...outcome.headers } }),
+                ...(outcome.body === undefined
+                    ? {}
+                    : { postData: toBuffer(toBytes(outcome.body)) }),
+            });
+        },
+        async abort(outcome, exchange) {
+            const error = outcome.error ?? "failed";
+            await exchange.route.abort(error);
+            close(exchange, {
+                kind: "fault",
+                direction: "none",
+                source: "stub",
+                meta: { reason: "abort", error },
+            });
+        },
+    };
+    /**
+     * A throwing stub is a bug in the test, and a stream that cannot open is a
+     * setup problem. Either way answer 500 so the page sees an error instead of
+     * hanging, and say which rule failed — in the log AND in the body the app
+     * may display.
+     */
+    const fail = async (exchange, entry, error) => {
+        const { rule } = entry;
+        const message = error instanceof Error ? error.message : String(error);
+        // A request that outlived its context fails for that reason alone.
+        const level = attachments.has(exchange.attachment) ? "error" : "debug";
+        deps.log[level]("rule failed", { rule: rule.label, url: exchange.view.url.href }, error);
+        append(exchange, rule.protocol, nameOf(entry, exchange.view), {
+            kind: "fault",
+            direction: "none",
+            source: "stub",
+            meta: { reason: "rule-error", error: message },
+        });
+        await exchange.route
+            .fulfill({
+            status: 500,
+            headers: { "content-type": "text/plain; charset=utf-8" },
+            body: `wirestage: rule "${rule.label}" failed: ${message}`,
+        })
+            .catch((secondary) => {
+            // The route was already answered before the failure.
+            deps.log.debug("could not answer a failed rule", {}, secondary);
+        });
+    };
+    const dispatch = async (attachment, route, request) => {
+        const url = new URL(request.url());
+        // Newest first. A snapshot: a rule added while this request is being
+        // decided does not join its chain.
+        const chain = entries.filter((entry) => wants(entry, url)).reverse();
+        if (chain.length === 0)
+            return route.fallback();
+        const exchange = {
+            view: await createView(request, attachment, url),
+            attachment,
+            route,
+            request,
+            recorded: new Map(),
+            passed: [],
+        };
+        for (const entry of chain) {
+            try {
+                const outcome = await decide(entry, exchange);
+                if (outcome === undefined)
+                    continue;
+                if (outcome.type === "fallback") {
+                    exchange.passed.push(entry);
+                    continue;
+                }
+                // The table has an executor for every answer; the cast is only
+                // because TypeScript cannot tie `outcome` to its own key.
+                await execute[outcome.type](outcome, exchange, entry);
+            }
+            catch (error) {
+                await fail(exchange, entry, error);
+            }
+            return;
+        }
+        track(exchange);
+        await route.fallback();
+    };
+    const onRoute = async (attachment, route, request) => {
+        try {
+            await dispatch(attachment, route, request);
+        }
+        catch (error) {
+            // Reading the request or handing it on failed: the page or context
+            // closed under it. Never rejected to Playwright, where it would
+            // surface as an unhandled rejection in whichever test runs next.
+            const level = attachments.has(attachment) ? "warn" : "debug";
+            deps.log[level]("request abandoned", { url: request.url() }, error);
+        }
+    };
+    const ensureRoute = async (attachment) => {
+        let installing = routes.get(attachment);
+        if (installing === undefined) {
+            const installed = {
+                predicate: (url) => entries.some((entry) => wants(entry, url)),
+                handler: (route, request) => onRoute(attachment, route, request),
+            };
+            installing = attachment.context
+                .route(installed.predicate, installed.handler)
+                .then(() => installed);
+            routes.set(attachment, installing);
+            // A failed install must not be remembered as done.
+            installing.catch(() => routes.delete(attachment));
+        }
+        await installing;
+    };
+    /** One observer failing must not starve the others, nor the timeline. */
+    const notify = (entry, call) => {
+        try {
+            call(entry.rule);
+        }
+        catch (error) {
+            deps.log.error("passthrough observer failed", { rule: entry.rule.label }, error);
+        }
+    };
+    const onFinished = async (request) => {
+        const exchange = pending.get(request);
+        if (exchange === undefined)
+            return;
+        pending.delete(request);
+        try {
+            const response = await request.response();
+            if (response === null)
+                return;
+            const body = await response.body().then((buffer) => toBytes(buffer), () => undefined);
+            const passthrough = {
+                status: response.status(),
+                headers: response.headers(),
+                body,
+            };
+            close(exchange, {
+                kind: "response",
+                direction: "in",
+                source: "network",
+                ...(body === undefined ? {} : { data: body }),
+                meta: { status: passthrough.status, headers: passthrough.headers },
+            });
+            for (const entry of exchange.passed)
+                notify(entry, (rule) => rule.onPassthroughResponse?.(passthrough, exchange.view));
+        }
+        catch (error) {
+            deps.log.warn("could not read a passed-through response", { url: exchange.view.url.href }, error);
+        }
+    };
+    const onFailed = (request) => {
+        const exchange = pending.get(request);
+        if (exchange === undefined)
+            return;
+        pending.delete(request);
+        const error = request.failure()?.errorText;
+        close(exchange, {
+            kind: "fault",
+            direction: "none",
+            source: "network",
+            meta: { reason: "network", error },
+        });
+        for (const entry of exchange.passed)
+            notify(entry, (rule) => rule.onPassthroughFailure?.(error, exchange.view));
+    };
+    return {
+        async add(rule) {
+            if (rule.times !== undefined &&
+                (!Number.isInteger(rule.times) || rule.times < 1))
+                throw new WirestageError("INVALID_ARGUMENT", `rule "${rule.label}": times must be a positive integer, got ${rule.times}`);
+            const methods = rule.method === undefined
+                ? undefined
+                : new Set((typeof rule.method === "string"
+                    ? [rule.method]
+                    : rule.method).map((m) => m.toUpperCase()));
+            const entry = {
+                rule,
+                matchesUrl: compileUrlMatcher(rule.url),
+                methods,
+                remaining: rule.times,
+                hits: 0,
+                active: true,
+            };
+            entries.push(entry);
+            try {
+                await Promise.all([...attachments.keys()].map(ensureRoute));
+            }
+            catch (error) {
+                // Half-installed is worse than not installed: the caller got an
+                // error, so the rule must not answer anywhere.
+                retire(entry);
+                throw error;
+            }
+            return {
+                get hits() {
+                    return entry.hits;
+                },
+                get active() {
+                    return entry.active;
+                },
+                async remove() {
+                    retire(entry);
+                },
+            };
+        },
+        async attach(attachment) {
+            const own = {
+                finished: (request) => {
+                    const reading = onFinished(request).finally(() => settling.delete(reading));
+                    settling.add(reading);
+                },
+                failed: onFailed,
+            };
+            attachments.set(attachment, own);
+            attachment.context.on("requestfinished", own.finished);
+            attachment.context.on("requestfailed", own.failed);
+            // Routing turns the browser's HTTP cache off and puts every request
+            // through Playwright, so a stage with no rules installs nothing.
+            if (entries.length > 0)
+                await ensureRoute(attachment);
+        },
+        async detach(attachment) {
+            const own = attachments.get(attachment);
+            if (own === undefined)
+                return;
+            attachments.delete(attachment);
+            attachment.context.off("requestfinished", own.finished);
+            attachment.context.off("requestfailed", own.failed);
+            const installing = routes.get(attachment);
+            routes.delete(attachment);
+            if (installing === undefined)
+                return;
+            try {
+                const { predicate, handler } = await installing;
+                await attachment.context.unroute(predicate, handler);
+            }
+            catch (error) {
+                // A context that closed first has no route left to remove.
+                deps.log.debug("unroute failed", { context: attachment.id }, error);
+            }
+        },
+        async settle() {
+            await Promise.all(settling);
+        },
+    };
+}
+//# sourceMappingURL=http-router.js.map

package/dist/widgets/stage/lib/http-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-router.js","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/http-router.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AA2E5D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAoB;IACpD,kCAAkC;IAClC,MAAM,OAAO,GAAY,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC1D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuC,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAyB,CAAC;IACrD,MAAM,YAAY,GAAG,IAAI,OAAO,EAAkC,CAAC;IACnE,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAiB,CAAC;IAE1C;;;;;;OAMG;IACH,MAAM,iBAAiB,GAAG,CAAC,UAA2B,EAAiB,EAAE;QACxE,IAAI,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC5B,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE;iBAC1B,IAAI,CAAC,GAAG,EAAE,CACV,UAAU,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAC/D;iBACA,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACzB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;YAC/D,CAAC,CAAC,CAAC;YACJ,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,QAAQ,CAAC;IACjB,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,KAAK,EACvB,OAAoB,EACpB,UAA2B,EAC3B,GAAQ,EACmB,EAAE;QAC7B,IAAI,IAA4B,CAAC;QACjC,IAAI,WAA+B,CAAC;QACpC,MAAM,OAAO,GAAG,GAAG,EAAE;YACpB,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;YAChE,OAAO,IAAI,CAAC;QACb,CAAC,CAAC;QACF,IAAI,IAAwB,CAAC;QAC7B,IAAI,CAAC;YACJ,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACR,yCAAyC;YACzC,IAAI,GAAG,SAAS,CAAC;QAClB,CAAC;QACD,OAAO;YACN,IAAI,WAAW;gBACd,WAAW,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;gBACnC,OAAO,WAAW,CAAC;YACpB,CAAC;YACD,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;YACxB,GAAG;YACH,OAAO,EAAE,MAAM,OAAO,CAAC,UAAU,EAAE;YACnC,IAAI;YACJ,OAAO,EAAE,UAAU,CAAC,EAAE;YACtB,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE;YACpC,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3B,IAAI,EAAE,GAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAM;SAC/C,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CACd,EAAE,IAAI,EAAY,EAClB,QAAgB,EAChB,QAAgB,EAChB,KAAc,EACb,EAAE,CACH,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QACpB,GAAG,KAAK;QACR,QAAQ;QACR,QAAQ;QACR,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW,EAAE,IAAI,CAAC,WAAW;KAC7B,CAAC,CAAC;IAEJ,qEAAqE;IACrE,MAAM,KAAK,GAAG,CAAC,QAAkB,EAAE,KAAc,EAAE,EAAE;QACpD,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ;YACnD,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC,CAAC;IAEF;;;;OAIG;IACH,MAAM,KAAK,GAAG,CAAC,KAAY,EAAE,GAAQ,EAAW,EAAE;QACjD,IAAI,CAAC;YACJ,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,KAAK,CACb,2BAA2B,EAC3B,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,EACzC,KAAK,CACL,CAAC;YACF,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC,CAAC;IAEF,0EAA0E;IAC1E,MAAM,MAAM,GAAG,CAAC,EAAE,IAAI,EAAS,EAAE,IAAqB,EAAU,EAAE;QACjE,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACR,2DAA2D;YAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC1B,CAAC;IACF,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,KAAY,EAAE,EAAE;QAC/B,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO;QAC1B,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC;IAEF;;;;OAIG;IACH,MAAM,MAAM,GAAG,KAAK,EACnB,KAAY,EACZ,QAAkB,EACiB,EAAE;QACrC,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACpC,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;YACjE,OAAO,SAAS,CAAC;QAClB,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QACpE,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;QAChB,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,KAAK,CAAC,SAAS,KAAK,CAAC;YAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC5D,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC/C,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE;gBACzC,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE,KAAK;gBAChB,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE;gBACvB,IAAI,EAAE;oBACL,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;oBAClB,OAAO,EAAE,IAAI,CAAC,OAAO;iBACrB;aACD,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC;IAEF,8EAA8E;IAC9E,MAAM,KAAK,GAAG,CAAC,QAAkB,EAAE,EAAE;QACpC,IACC,QAAQ,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC;YAC1B,QAAQ,CAAC,MAAM,CAAC,IAAI,CACnB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CACZ,IAAI,CAAC,qBAAqB,KAAK,SAAS;gBACxC,IAAI,CAAC,oBAAoB,KAAK,SAAS,CACxC;YAED,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC,CAAC;IAEF,MAAM,OAAO,GAAc;QAC1B,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ;YAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC;YACrC,MAAM,OAAO,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;YACvC,MAAM,IAAI,GACT,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAChE,MAAM,QAAQ,CAAC,KAAK,CAAC,OAAO,CAC3B,IAAI,KAAK,SAAS;gBACjB,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE;gBACrB,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAC5C,CAAC;YACF,KAAK,CAAC,QAAQ,EAAE;gBACf,IAAI,EAAE,UAAU;gBAChB,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,MAAM;gBACd,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBAC7C,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;aACzB,CAAC,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ;YAC7B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CACtC,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;gBACrB,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBACvD,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAC/B,KAAK,CACJ,QAAQ,EACR,GAAG,KAAK,KAAK;oBACZ,CAAC,CAAC;wBACA,IAAI,EAAE,OAAO;wBACb,SAAS,EAAE,MAAM;wBACjB,MAAM,EAAE,MAAM;wBACd,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;qBACvB;oBACF,CAAC,CAAC;wBACA,IAAI,EAAE,WAAW;wBACjB,SAAS,EAAE,MAAM;wBACjB,+CAA+C;wBAC/C,MAAM,EAAE,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;wBAC7C,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE;qBAC7B,CACH,CACD,CAAC;gBACF,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC,EACD,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CACnD,CAAC;YACF,MAAM,iBAAiB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC7C,IAAI,CAAC;gBACJ,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACrD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,OAAO,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM,KAAK,CAAC;YACb,CAAC;QACF,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK;YACtC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,KAAK,CAAC,QAAQ,CAAC,CAAC;YAChB,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC;gBAC7B,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;gBAC1D,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnE,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS;oBAChC,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;gBACvC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS;oBAC7B,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;aACjD,CAAC,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ;YAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC;YACxC,MAAM,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAClC,KAAK,CAAC,QAAQ,EAAE;gBACf,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,MAAM;gBACjB,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;aAChC,CAAC,CAAC;QACJ,CAAC;KACD,CAAC;IAEF;;;;;OAKG;IACH,MAAM,IAAI,GAAG,KAAK,EAAE,QAAkB,EAAE,KAAY,EAAE,KAAc,EAAE,EAAE;QACvE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;QACvB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,mEAAmE;QACnE,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QACvE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CACd,aAAa,EACb,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EACjD,KAAK,CACL,CAAC;QACF,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE;YAC7D,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE;SAC9C,CAAC,CAAC;QACH,MAAM,QAAQ,CAAC,KAAK;aAClB,OAAO,CAAC;YACR,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,EAAE,cAAc,EAAE,2BAA2B,EAAE;YACxD,IAAI,EAAE,oBAAoB,IAAI,CAAC,KAAK,aAAa,OAAO,EAAE;SAC1D,CAAC;aACD,KAAK,CAAC,CAAC,SAAkB,EAAE,EAAE;YAC7B,qDAAqD;YACrD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,KAAK,EACrB,UAA2B,EAC3B,KAAgB,EAChB,OAAoB,EACJ,EAAE;QAClB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACnC,qEAAqE;QACrE,mCAAmC;QACnC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACrE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QAChD,MAAM,QAAQ,GAAa;YAC1B,IAAI,EAAE,MAAM,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC;YAChD,UAAU;YACV,KAAK;YACL,OAAO;YACP,QAAQ,EAAE,IAAI,GAAG,EAAE;YACnB,MAAM,EAAE,EAAE;SACV,CAAC;QACF,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACJ,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;gBAC9C,IAAI,OAAO,KAAK,SAAS;oBAAE,SAAS;gBACpC,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBACjC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAC5B,SAAS;gBACV,CAAC;gBACD,+DAA+D;gBAC/D,0DAA0D;gBAC1D,MAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAA+B,CACzD,OAAgB,EAChB,QAAQ,EACR,KAAK,CACL,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACpC,CAAC;YACD,OAAO;QACR,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChB,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,EACpB,UAA2B,EAC3B,KAAgB,EAChB,OAAoB,EACJ,EAAE;QAClB,IAAI,CAAC;YACJ,MAAM,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,mEAAmE;YACnE,gEAAgE;YAChE,iEAAiE;YACjE,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC7D,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,mBAAmB,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QACrE,CAAC;IACF,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,KAAK,EAAE,UAA2B,EAAiB,EAAE;QACxE,IAAI,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAc;gBAC5B,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC9D,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC;aAChE,CAAC;YACF,UAAU,GAAG,UAAU,CAAC,OAAO;iBAC7B,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC;iBAC7C,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YACnC,mDAAmD;YACnD,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,UAAU,CAAC;IAClB,CAAC,CAAC;IAEF,yEAAyE;IACzE,MAAM,MAAM,GAAG,CAAC,KAAY,EAAE,IAA8B,EAAE,EAAE;QAC/D,IAAI,CAAC;YACJ,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,KAAK,CACb,6BAA6B,EAC7B,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAC1B,KAAK,CACL,CAAC;QACH,CAAC;IACF,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,KAAK,EAAE,OAAoB,EAAE,EAAE;QACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO;QACnC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC1C,IAAI,QAAQ,KAAK,IAAI;gBAAE,OAAO;YAC9B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,CACtC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAC3B,GAAG,EAAE,CAAC,SAAS,CACf,CAAC;YACF,MAAM,WAAW,GAAwB;gBACxC,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE;gBACzB,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE;gBAC3B,IAAI;aACJ,CAAC;YACF,KAAK,CAAC,QAAQ,EAAE;gBACf,IAAI,EAAE,UAAU;gBAChB,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,SAAS;gBACjB,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBAC7C,IAAI,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,EAAE;aAClE,CAAC,CAAC;YACH,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM;gBAClC,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CACtB,IAAI,CAAC,qBAAqB,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,CACxD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,IAAI,CACZ,0CAA0C,EAC1C,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAC/B,KAAK,CACL,CAAC;QACH,CAAC;IACF,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,OAAoB,EAAE,EAAE;QACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO;QACnC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC;QAC3C,KAAK,CAAC,QAAQ,EAAE;YACf,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE;SAClC,CAAC,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM;YAClC,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CACtB,IAAI,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,CACjD,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO;QACN,KAAK,CAAC,GAAG,CAAC,IAAI;YACb,IACC,IAAI,CAAC,KAAK,KAAK,SAAS;gBACxB,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;gBAEjD,MAAM,IAAI,cAAc,CACvB,kBAAkB,EAClB,SAAS,IAAI,CAAC,KAAK,4CAA4C,IAAI,CAAC,KAAK,EAAE,CAC3E,CAAC;YACH,MAAM,OAAO,GACZ,IAAI,CAAC,MAAM,KAAK,SAAS;gBACxB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,IAAI,GAAG,CACP,CAAC,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;oBAC/B,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;oBACf,CAAC,CAAC,IAAI,CAAC,MAAM,CACb,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAC7B,CAAC;YACL,MAAM,KAAK,GAAU;gBACpB,IAAI;gBACJ,UAAU,EAAE,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC;gBACvC,OAAO;gBACP,SAAS,EAAE,IAAI,CAAC,KAAK;gBACrB,IAAI,EAAE,CAAC;gBACP,MAAM,EAAE,IAAI;aACZ,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,CAAC;gBACJ,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;YAC7D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,gEAAgE;gBAChE,+CAA+C;gBAC/C,MAAM,CAAC,KAAK,CAAC,CAAC;gBACd,MAAM,KAAK,CAAC;YACb,CAAC;YACD,OAAO;gBACN,IAAI,IAAI;oBACP,OAAO,KAAK,CAAC,IAAI,CAAC;gBACnB,CAAC;gBACD,IAAI,MAAM;oBACT,OAAO,KAAK,CAAC,MAAM,CAAC;gBACrB,CAAC;gBACD,KAAK,CAAC,MAAM;oBACX,MAAM,CAAC,KAAK,CAAC,CAAC;gBACf,CAAC;aACD,CAAC;QACH,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,UAAU;YACtB,MAAM,GAAG,GAAc;gBACtB,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE;oBACrB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAChD,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CACxB,CAAC;oBACF,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACvB,CAAC;gBACD,MAAM,EAAE,QAAQ;aAChB,CAAC;YACF,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YACjC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,iBAAiB,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;YACvD,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YACnD,oEAAoE;YACpE,iEAAiE;YACjE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;QACvD,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,UAAU;YACtB,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACxC,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO;YAC9B,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC/B,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxD,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YACpD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC1B,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO;YACrC,IAAI,CAAC;gBACJ,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,MAAM,UAAU,CAAC;gBAChD,MAAM,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACtD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,2DAA2D;gBAC3D,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;YACrE,CAAC;QACF,CAAC;QACD,KAAK,CAAC,MAAM;YACX,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;KACD,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,36 @@
+import type { PageHost } from "../../../entities/plugin/index.js";
+import type { PagePort } from "../../../shared/api/playwright/index.js";
+import type { Clock } from "../../../shared/lib/clock/index.js";
+import type { ScopedLogger } from "../../../shared/lib/logger/index.js";
+import type { AttachedContext } from "./attached-context.js";
+export interface PageHostDeps {
+    readonly stage: string;
+    readonly log: ScopedLogger;
+    readonly clock: Clock;
+    readonly pageId: (page: PagePort) => string;
+    /** How long entries may wait for company before a batch leaves. */
+    readonly flushMs: number;
+    /**
+     * How long a frame may take to answer a flush or a command, and Playwright
+     * to take the binding or the init script out at detach. Whatever takes
+     * longer is passed over, not waited for: a page stuck behind an open
+     * dialog must not stall every read of the timeline, nor the teardown.
+     */
+    readonly timeoutMs: number;
+}
+export interface PageHostEngine extends PageHost {
+    attach(attachment: AttachedContext): Promise<void>;
+    detach(attachment: AttachedContext): Promise<void>;
+    /** Flush every open frame's buffer into the modules, then return. */
+    sync(): Promise<void>;
+}
+/**
+ * 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 declare function createPageHost(deps: PageHostDeps): PageHostEngine;
+//# sourceMappingURL=page-host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"page-host.d.ts","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/page-host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,QAAQ,EAER,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAIX,QAAQ,EACR,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oCAAoC,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAU7D,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,MAAM,CAAC;IAC5C,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC/C,MAAM,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,qEAAqE;IACrE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAuBD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CA0SjE"}