@pattern-js/runtime-node 0.2.0

package/dist/worker-pool.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @pattern-js/runtime-node — worker-thread pool transport (§4, §8).
+ *
+ * A `RunTransport` that dispatches each run to a `node:worker_threads` worker,
+ * so a run executes off the host event loop (the workflow is the unit of
+ * isolation, §1). Streamed out-gate results are reconstructed on the host;
+ * cancellation crosses the seam. It is a drop-in for `InProcessTransport` — the
+ * scheduler never knows the difference — and the same interface later allows a
+ * queue + remote workers (distribution).
+ *
+ * Workers register the base op catalog plus any `mods` passed in options (each
+ * a module specifier the worker `import()`s and `engine.use()`s), so workflows
+ * using mod-contributed ops can run on the pool too. A crashed worker rejects
+ * its in-flight runs and is respawned in place.
+ */
+import type { RunHandle, RunRequest, RunTransport, TraceEvent } from "@pattern-js/core";
+export interface WorkerPoolOptions {
+    /** Number of workers (default: available parallelism − 1, min 1). */
+    size?: number;
+    /**
+     * Mod module specifiers each worker loads at startup (same resolution as
+     * `loadMods`: bare npm/workspace specifiers, or absolute paths/file URLs).
+     * Without this, workers have only the base op catalog and a workflow using a
+     * mod-contributed op fails with "unknown op".
+     */
+    mods?: string[];
+    /**
+     * Receive each offloaded run's trace lifecycle (run start/spans/ready/end),
+     * tagged with the worker that ran it — wire it to the host `engine.ingestTrace`
+     * so offloaded runs appear in the Runs view like inline ones. Omit to drop
+     * worker traces (the runs still execute fine).
+     */
+    onTrace?: (evt: TraceEvent) => void;
+}
+export declare class WorkerPoolTransport implements RunTransport {
+    private workers;
+    private rr;
+    private closed;
+    private readonly mods;
+    private readonly onTrace?;
+    constructor(opts?: WorkerPoolOptions);
+    private spawn;
+    /** Replace a crashed worker so the pool keeps its capacity. */
+    private respawn;
+    describe(): Record<string, unknown>;
+    dispatch(req: RunRequest): RunHandle;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=worker-pool.d.ts.map

package/dist/worker-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-pool.d.ts","sourceRoot":"","sources":["../src/worker-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAa,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAyInG,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;CACrC;AAED,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,EAAE,CAAK;IACf,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA4B;gBAEzC,IAAI,GAAE,iBAAsB;IAOxC,OAAO,CAAC,KAAK;IAIb,+DAA+D;IAC/D,OAAO,CAAC,OAAO;IAOf,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IASnC,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS;IAsB9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B"}

package/dist/worker-pool.js

@@ -0,0 +1,203 @@
+/**
+ * @pattern-js/runtime-node — worker-thread pool transport (§4, §8).
+ *
+ * A `RunTransport` that dispatches each run to a `node:worker_threads` worker,
+ * so a run executes off the host event loop (the workflow is the unit of
+ * isolation, §1). Streamed out-gate results are reconstructed on the host;
+ * cancellation crosses the seam. It is a drop-in for `InProcessTransport` — the
+ * scheduler never knows the difference — and the same interface later allows a
+ * queue + remote workers (distribution).
+ *
+ * Workers register the base op catalog plus any `mods` passed in options (each
+ * a module specifier the worker `import()`s and `engine.use()`s), so workflows
+ * using mod-contributed ops can run on the pool too. A crashed worker rejects
+ * its in-flight runs and is respawned in place.
+ */
+import { Worker } from "node:worker_threads";
+import { availableParallelism } from "node:os";
+const WORKER_URL = new URL("./worker/entry.js", import.meta.url);
+class WorkerWrapper {
+    onTrace;
+    worker;
+    pending = new Map();
+    inflight = 0;
+    constructor(mods, onFatal, onTrace) {
+        this.onTrace = onTrace;
+        this.worker = new Worker(WORKER_URL, { workerData: { mods } });
+        this.worker.on("message", (msg) => this.onMessage(msg));
+        this.worker.on("error", (err) => {
+            // The thread is dead: fail every in-flight run and hand the slot back to
+            // the pool for a respawn. Resetting `inflight` matters — a leaked count
+            // would silently remove this slot from least-inflight selection forever.
+            for (const p of this.pending.values())
+                if (!p.settled)
+                    p.reject(err);
+            this.pending.clear();
+            this.inflight = 0;
+            onFatal(this, err);
+        });
+    }
+    onMessage(msg) {
+        // Trace events carry their own runId (inside the event) and aren't tied to a
+        // pending entry — handle them before the pending-lookup guard. Tag which
+        // worker ran it so the Runs view can show "ran on worker N".
+        if (msg.type === "trace") {
+            this.tagAndForward(msg.event);
+            return;
+        }
+        const p = this.pending.get(msg.id ?? msg.runId);
+        if (!p)
+            return;
+        switch (msg.type) {
+            case "result": {
+                const outputs = {};
+                for (const [nodeId, payload] of Object.entries(msg.outputs)) {
+                    const sp = {};
+                    for (const [k, v] of Object.entries(payload)) {
+                        if (v && typeof v === "object" && "__patternStream" in v) {
+                            const streamId = v.__patternStream;
+                            sp[k] = new ReadableStream({
+                                start: (controller) => p.controllers.set(streamId, controller),
+                            });
+                        }
+                        else {
+                            sp[k] = v;
+                        }
+                    }
+                    outputs[nodeId] = sp;
+                }
+                p.settled = true;
+                p.resolve({
+                    runId: msg.id,
+                    status: msg.status,
+                    outputs,
+                    error: msg.error ? Object.assign(new Error(msg.error.message), { name: msg.error.name }) : undefined,
+                });
+                break;
+            }
+            case "chunk":
+                p.controllers.get(msg.streamId)?.enqueue(msg.value);
+                break;
+            case "streamEnd":
+                try {
+                    p.controllers.get(msg.streamId)?.close();
+                }
+                catch {
+                    /* ignore */
+                }
+                p.controllers.delete(msg.streamId);
+                break;
+            case "streamError":
+                try {
+                    p.controllers.get(msg.streamId)?.error(new Error(msg.error?.message ?? "stream error"));
+                }
+                catch {
+                    /* ignore */
+                }
+                p.controllers.delete(msg.streamId);
+                break;
+            case "done":
+                this.pending.delete(msg.id);
+                this.inflight = Math.max(0, this.inflight - 1);
+                break;
+        }
+    }
+    /** Stamp the worker's identity onto a forwarded trace event, then hand it up. */
+    tagAndForward(evt) {
+        if (!this.onTrace)
+            return;
+        const executor = `worker:${this.worker.threadId}`;
+        if (evt.kind === "spanEnd") {
+            evt.span.attributes = { ...evt.span.attributes, executor };
+        }
+        else if (evt.kind === "runStart") {
+            evt.run.executor = executor;
+        }
+        this.onTrace(evt);
+    }
+    run(req, runId) {
+        this.inflight++;
+        return new Promise((resolve, reject) => {
+            this.pending.set(runId, { resolve, reject, controllers: new Map(), settled: false });
+            this.worker.postMessage({
+                type: "run",
+                id: runId,
+                workflow: req.workflow,
+                triggerNodeId: req.triggerNodeId,
+                input: req.input,
+                principal: req.principal,
+                params: req.params,
+                sampleIo: req.sampleIo,
+                hookDepth: req.hookDepth,
+                parent: req.parent,
+            });
+        });
+    }
+    abort(runId) {
+        this.worker.postMessage({ type: "abort", id: runId });
+    }
+    terminate() {
+        return this.worker.terminate();
+    }
+}
+export class WorkerPoolTransport {
+    workers;
+    rr = 0;
+    closed = false;
+    mods;
+    onTrace;
+    constructor(opts = {}) {
+        const size = Math.max(1, opts.size ?? availableParallelism() - 1);
+        this.mods = opts.mods ?? [];
+        this.onTrace = opts.onTrace;
+        this.workers = Array.from({ length: size }, () => this.spawn());
+    }
+    spawn() {
+        return new WorkerWrapper(this.mods, (dead) => this.respawn(dead), this.onTrace);
+    }
+    /** Replace a crashed worker so the pool keeps its capacity. */
+    respawn(dead) {
+        void dead.terminate().catch(() => { });
+        if (this.closed)
+            return;
+        const i = this.workers.indexOf(dead);
+        if (i >= 0)
+            this.workers[i] = this.spawn();
+    }
+    describe() {
+        return {
+            kind: "worker-pool",
+            size: this.workers.length,
+            inflight: this.workers.map((w) => w.inflight),
+            threadIds: this.workers.map((w) => w.worker.threadId),
+        };
+    }
+    dispatch(req) {
+        if (this.closed || this.workers.length === 0) {
+            throw new Error("WorkerPoolTransport is closed");
+        }
+        // Least-inflight selection; the rotating scan start breaks ties fairly.
+        const n = this.workers.length;
+        let worker = this.workers[this.rr % n];
+        for (let i = 1; i < n; i++) {
+            const w = this.workers[(this.rr + i) % n];
+            if (w.inflight < worker.inflight)
+                worker = w;
+        }
+        this.rr = (this.rr + 1) % n;
+        const runId = req.runId ?? crypto.randomUUID();
+        const result = worker.run(req, runId);
+        return {
+            runId,
+            result,
+            abort: () => worker.abort(runId),
+        };
+    }
+    async close() {
+        this.closed = true;
+        const workers = this.workers;
+        this.workers = [];
+        await Promise.all(workers.map((w) => w.terminate()));
+    }
+}
+//# sourceMappingURL=worker-pool.js.map

package/dist/worker-pool.js.map

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

package/dist/ws-registry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @pattern-js/runtime-node — connection registry bound to live WebSocket sockets (§7).
+ *
+ * Implements core's `ConnectionRegistry` interface. Connections are host-local
+ * (like a socket), so this registry is the one place that knows about sockets;
+ * `core.ws.*` ops and the `boundary.ws.send` out-gate route through the interface
+ * and stay socket-agnostic — a pub/sub backplane could replace this for
+ * distribution without touching any workflow.
+ */
+import type { WebSocket } from "ws";
+import type { ConnectionRef, ConnectionRegistry, Principal } from "@pattern-js/core";
+export declare class NodeConnectionRegistry implements ConnectionRegistry {
+    private sockets;
+    private rooms;
+    private principals;
+    /** Register a freshly-opened socket; returns its connection ref. */
+    add(socket: WebSocket, id?: string, principal?: Principal): ConnectionRef;
+    remove(id: string): void;
+    /** The principal resolved at upgrade time, fixed for the connection's life (§9). */
+    principalOf(id: string): Principal | undefined;
+    get(id: string): WebSocket | undefined;
+    /** Ids of every live connection (observability; tests). */
+    ids(): string[];
+    send(connection: ConnectionRef | string, data: unknown): Promise<void>;
+    sendStream(connection: ConnectionRef | string, data: ReadableStream<unknown>): Promise<void>;
+    broadcast(room: string, data: unknown): Promise<void>;
+    join(connection: ConnectionRef | string, room: string): Promise<void>;
+    leave(connection: ConnectionRef | string, room: string): Promise<void>;
+    close(connection: ConnectionRef | string, code?: number, reason?: string): Promise<void>;
+    /** Members of a room (inspection/testing). */
+    members(room: string): string[];
+    /**
+     * Close every member of a room (§9: session revocation closes the session's
+     * sockets via the `session:{id}` room). Copies the member list first — close
+     * mutates room membership.
+     */
+    closeRoom(room: string, code?: number, reason?: string): Promise<void>;
+}
+//# sourceMappingURL=ws-registry.d.ts.map

package/dist/ws-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-registry.d.ts","sourceRoot":"","sources":["../src/ws-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAUrF,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,UAAU,CAAgC;IAElD,oEAAoE;IACpE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,GAAE,MAA4B,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,aAAa;IAM9F,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMxB,oFAAoF;IACpF,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI9C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAItC,2DAA2D;IAC3D,GAAG,IAAI,MAAM,EAAE;IAIT,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE,UAAU,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5F,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrE,KAAK,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE,KAAK,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9F,8CAA8C;IAC9C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAI/B;;;;OAIG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7E"}

package/dist/ws-registry.js

@@ -0,0 +1,99 @@
+/**
+ * @pattern-js/runtime-node — connection registry bound to live WebSocket sockets (§7).
+ *
+ * Implements core's `ConnectionRegistry` interface. Connections are host-local
+ * (like a socket), so this registry is the one place that knows about sockets;
+ * `core.ws.*` ops and the `boundary.ws.send` out-gate route through the interface
+ * and stay socket-agnostic — a pub/sub backplane could replace this for
+ * distribution without touching any workflow.
+ */
+const idOf = (c) => (typeof c === "string" ? c : c.id);
+function encode(data) {
+    if (typeof data === "string")
+        return data;
+    if (data instanceof Uint8Array)
+        return data;
+    return JSON.stringify(data);
+}
+export class NodeConnectionRegistry {
+    sockets = new Map();
+    rooms = new Map();
+    principals = new Map();
+    /** Register a freshly-opened socket; returns its connection ref. */
+    add(socket, id = crypto.randomUUID(), principal) {
+        this.sockets.set(id, socket);
+        if (principal)
+            this.principals.set(id, principal);
+        return { id };
+    }
+    remove(id) {
+        this.sockets.delete(id);
+        this.principals.delete(id);
+        for (const set of this.rooms.values())
+            set.delete(id);
+    }
+    /** The principal resolved at upgrade time, fixed for the connection's life (§9). */
+    principalOf(id) {
+        return this.principals.get(id);
+    }
+    get(id) {
+        return this.sockets.get(id);
+    }
+    /** Ids of every live connection (observability; tests). */
+    ids() {
+        return [...this.sockets.keys()];
+    }
+    async send(connection, data) {
+        this.sockets.get(idOf(connection))?.send(encode(data));
+    }
+    async sendStream(connection, data) {
+        const socket = this.sockets.get(idOf(connection));
+        if (!socket)
+            return;
+        const reader = data.getReader();
+        try {
+            for (;;) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                socket.send(encode(value));
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    async broadcast(room, data) {
+        const encoded = encode(data);
+        for (const id of this.rooms.get(room) ?? [])
+            this.sockets.get(id)?.send(encoded);
+    }
+    async join(connection, room) {
+        let set = this.rooms.get(room);
+        if (!set)
+            this.rooms.set(room, (set = new Set()));
+        set.add(idOf(connection));
+    }
+    async leave(connection, room) {
+        this.rooms.get(room)?.delete(idOf(connection));
+    }
+    async close(connection, code, reason) {
+        const id = idOf(connection);
+        this.sockets.get(id)?.close(code, reason);
+        this.remove(id);
+    }
+    /** Members of a room (inspection/testing). */
+    members(room) {
+        return [...(this.rooms.get(room) ?? [])];
+    }
+    /**
+     * Close every member of a room (§9: session revocation closes the session's
+     * sockets via the `session:{id}` room). Copies the member list first — close
+     * mutates room membership.
+     */
+    async closeRoom(room, code, reason) {
+        for (const id of this.members(room))
+            await this.close(id, code, reason);
+    }
+}
+//# sourceMappingURL=ws-registry.js.map

package/dist/ws-registry.js.map

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

package/dist/ws.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @pattern-js/runtime-node — WebSocket host (§7, §9).
+ *
+ * Node has no built-in WS *server*, so this host uses `ws` on the HTTP upgrade
+ * (an adapter-level dependency; core stays clean). It fires a run **per inbound
+ * message** through `boundary.ws.message`, plus optional `boundary.ws.open` /
+ * `boundary.ws.close` lifecycle workflows, and sends `boundary.ws.send` results
+ * back on the originating connection.
+ *
+ * Auth (§9) happens **at upgrade time**: the provider chain resolves a principal
+ * from the upgrade request's headers (same cookie the HTTP host sees), every
+ * bound trigger's `requireAuth` is enforced *before* the socket is accepted
+ * (raw 401 + destroy on failure), and the principal is fixed to the connection
+ * for its lifetime — open/message/close runs all execute as it and see it on
+ * their `user` port. Authenticated connections auto-join the `user:{id}` and
+ * `session:{sessionId}` rooms, so "message all of this user's devices" is a
+ * broadcast and session revocation is a `closeRoom`.
+ */
+import type { Server } from "node:http";
+import { WebSocketServer } from "ws";
+import { type Engine, type Workflow } from "@pattern-js/core";
+import { NodeConnectionRegistry } from "./ws-registry.js";
+export interface WsBinding {
+    workflow: Workflow | string;
+    trigger?: string;
+}
+export interface WsHostOptions {
+    /** Run per inbound message (boundary.ws.message). */
+    onMessage?: WsBinding;
+    /** Run on connection open (boundary.ws.open). */
+    onOpen?: WsBinding;
+    /** Run on connection close (boundary.ws.close). */
+    onClose?: WsBinding;
+    /** Restrict to a path (e.g. "/ws"). */
+    path?: string;
+}
+export declare class WsHost {
+    private readonly engine;
+    private readonly opts;
+    readonly wss: WebSocketServer;
+    readonly connections: NodeConnectionRegistry;
+    constructor(engine: Engine, opts: WsHostOptions, connections?: NodeConnectionRegistry);
+    /** Attach to an HTTP server's upgrade event. */
+    attach(server: Server): this;
+    /** Resolve a principal from the upgrade request via the provider chain (§9). */
+    private authenticate;
+    /**
+     * Enforce every bound trigger's `requireAuth` (§9). One socket serves all
+     * three lifecycle triggers, so the connection must satisfy the union of
+     * their requirements — a protected message handler protects the upgrade.
+     */
+    private deniedReason;
+    /** Explicit binding (when configured) or auto mode is on for this host. */
+    private get auto();
+    /**
+     * Bindings to enforce/fire for a trigger op. Explicit options win; auto mode
+     * resolves LIVE from the workflow registry (workflows deployed from the
+     * admin bind without a restart, mirroring HttpHost's declarative routing).
+     * Auth enforces ALL matching workflows' requirements; firing uses the first
+     * (one socket, no path dispatch — multi-handler WS is an explicit-options
+     * setup).
+     */
+    private resolved;
+    private bindingFor;
+    private onConnection;
+    private resolve;
+    private fire;
+    private fireAndSend;
+}
+/** Create a WS host (attach it to an HTTP server with `.attach(server)`). */
+export declare function createWsHost(engine: Engine, opts: WsHostOptions, connections?: NodeConnectionRegistry): WsHost;
+//# sourceMappingURL=ws.d.ts.map

package/dist/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,eAAe,EAAkB,MAAM,IAAI,CAAC;AACrD,OAAO,EAIL,KAAK,MAAM,EAGX,KAAK,QAAQ,EACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,iDAAiD;IACjD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,qBAAa,MAAM;IAKf,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IALvB,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;gBAG1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,aAAa,EACpC,WAAW,CAAC,EAAE,sBAAsB;IAYtC,gDAAgD;IAChD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IA+B5B,gFAAgF;YAClE,YAAY;IAS1B;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAcpB,2EAA2E;IAC3E,OAAO,KAAK,IAAI,GAEf;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;IAoBhB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,YAAY;IA0CpB,OAAO,CAAC,OAAO;YASD,IAAI;YAWJ,WAAW;CAoC1B;AAsBD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAE9G"}