@danielsimonjr/sciengjs 0.2.0 → 0.3.1

package/dist/browser/proxy.js

@@ -0,0 +1,64 @@
+import { once } from "node:events";
+import { createServer as createHttpServer } from "node:http";
+/**
+ * The host of an absolute URL, or of the authority of a CONNECT request ("host:port"). A value that is
+ * neither is recorded as it was sent, so that no attempt is lost.
+ */
+function hostOf(target) {
+    if (/^https?:\/\//i.test(target)) {
+        try {
+            return new URL(target).hostname;
+        }
+        catch {
+            // A URL that does not parse is recorded as it was sent. A throw here would crash the engine process.
+            return target;
+        }
+    }
+    const colon = target.lastIndexOf(":");
+    return colon > 0 ? target.slice(0, colon) : target;
+}
+const REFUSED = "HTTP/1.1 403 Forbidden\r\nConnection: close\r\nContent-Length: 0\r\n\r\n";
+/**
+ * Starts a proxy on 127.0.0.1 with an ephemeral port. It answers 403 to each request and to each CONNECT,
+ * and forwards nothing. The browser sends its connection attempts here, so the route off the host is closed.
+ */
+export async function startRefusingProxy() {
+    const log = [];
+    const sockets = new Set();
+    const server = createHttpServer((req, res) => {
+        log.push(hostOf(req.url ?? ""));
+        res.writeHead(403, { Connection: "close", "Content-Length": "0" });
+        res.end();
+    });
+    server.on("connection", (socket) => {
+        sockets.add(socket);
+        // The browser resets its connections while it closes. An unhandled error on a socket would end the process.
+        socket.on("error", () => { });
+        socket.on("close", () => sockets.delete(socket));
+    });
+    server.on("connect", (req, socket) => {
+        log.push(hostOf(req.url ?? ""));
+        socket.on("error", () => { });
+        socket.end(REFUSED);
+    });
+    server.listen(0, "127.0.0.1");
+    await once(server, "listening");
+    const address = server.address();
+    if (address === null || typeof address === "string") {
+        throw new Error("the refusing proxy has no TCP address");
+    }
+    return {
+        port: address.port,
+        attempts: () => [...log],
+        close: () => closeServer(server, sockets),
+    };
+}
+/** Ends every open connection, then closes the server. */
+function closeServer(server, sockets) {
+    for (const socket of sockets)
+        socket.destroy();
+    return new Promise((resolve, reject) => {
+        server.close((err) => (err ? reject(err) : resolve()));
+    });
+}
+//# sourceMappingURL=proxy.js.map

package/dist/browser/proxy.js.map

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

package/dist/browser/render.d.ts

@@ -0,0 +1,58 @@
+import { CdpConnection } from "./cdp.ts";
+/** The address of the page that the client loads. The client answers it from memory, so it names no host. */
+export declare const PAGE_URL = "http://sciengjs-page.invalid/";
+/** The output of the browser stage for a page. The svg format returns the SVG that the page reports. */
+export type HtmlFormat = "png" | "pdf" | "svg";
+/** A pinned file that the client fulfils for one exact URL, with its bytes read before the browser starts. */
+export interface PinnedBytes {
+    bytes: Uint8Array;
+    mime: string;
+}
+interface HtmlPageBase {
+    html: string;
+    /** Path of the browser executable. */
+    browser: string;
+    /** The time limit of the render, in milliseconds. */
+    timeoutMs: number;
+    /** Called with the profile folder of this render once the folder exists. A test uses it to find leaks. */
+    onProfile?: (profile: string) => void;
+    /** The exact pinned URLs that the client fulfils from memory. Every other request is refused. */
+    pinned?: ReadonlyMap<string, PinnedBytes>;
+    /**
+     * The page sets window.__sciengDone to {ok, svg} or {ok, message}. The capture waits for that value. A page
+     * that reports ok false rejects with E_INPUT. A png or pdf then draws the diagram in the element sciengjs-diagram.
+     */
+    awaitDone?: boolean;
+}
+/** One page to draw. A png has a size and a device scale. A pdf has neither. An svg needs awaitDone. */
+export type HtmlPageRequest = (HtmlPageBase & {
+    format: "png";
+    width: number;
+    height: number;
+    scale: number;
+}) | (HtmlPageBase & {
+    format: "pdf";
+}) | (HtmlPageBase & {
+    format: "svg";
+    awaitDone: true;
+});
+/** The bytes that the browser drew, and the requests that it asked for and the client refused. */
+export interface HtmlPageResult {
+    bytes: Uint8Array;
+    /** Each URL that the page asked for and the client refused, in order. */
+    blocked: string[];
+}
+/**
+ * Loads the page in a new target, refuses every request that is not the page, then captures it. Every request
+ * to the browser carries the deadline, and the whole capture runs under it. The load wait keys on the loader of
+ * the navigation, so a load event of an earlier document does not count.
+ */
+export declare function capturePage(cdp: CdpConnection, req: HtmlPageRequest, deadline: number): Promise<HtmlPageResult>;
+/**
+ * Draws one HTML page in a new headless browser and returns the bytes of a PNG or a PDF.
+ * The browser runs with a new profile, the forced flags and a refusing proxy. The browser sandbox stays on.
+ * The profile, the proxy and the browser are removed on every path before the function returns. One deadline
+ * covers the whole cleanup.
+ */
+export declare function renderHtmlPage(req: HtmlPageRequest): Promise<HtmlPageResult>;
+export {};

package/dist/browser/render.js

@@ -0,0 +1,421 @@
+import { spawn, spawnSync } from "node:child_process";
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { RenderError } from "../errors.js";
+import { CdpConnection, connectCdp } from "./cdp.js";
+import { forcedBrowserFlags } from "./flags.js";
+import { MAX_DEVICE_PIXELS } from "./input.js";
+import { makeProfile, removeProfile } from "./profile.js";
+import { startRefusingProxy } from "./proxy.js";
+/** The address of the page that the client loads. The client answers it from memory, so it names no host. */
+export const PAGE_URL = "http://sciengjs-page.invalid/";
+/** The icon address of the page host. The client answers it locally, as the browser asks for it on its own. */
+const FAVICON_URL = "http://sciengjs-page.invalid/favicon.ico";
+/**
+ * The share of the render time that the page work may use. The rest is the budget for stopping the browser
+ * and removing the profile. The budget comes from the worker time limit, so the cleanup runs before the worker ends.
+ */
+const PAGE_SHARE = 0.8;
+const POLL_MS = 100;
+const PORT_FILE = "DevToolsActivePort";
+/** Codes of a read that Windows holds while the browser writes the port file. Such a read is polled again. */
+const HELD_READ_CODES = new Set(["EBUSY", "EPERM", "ENOENT"]);
+const IS_WINDOWS = process.platform === "win32";
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function watchChild(child, browser) {
+    const state = { browser, exited: false, code: null, signal: null };
+    child.once("error", (err) => {
+        state.error = err;
+    });
+    child.once("exit", (code, signal) => {
+        state.exited = true;
+        state.code = code;
+        state.signal = signal;
+    });
+    return state;
+}
+/** Waits for the DevTools port file. Returns the WebSocket address of the browser. */
+async function waitForBrowser(profile, state, deadline) {
+    const file = join(profile, PORT_FILE);
+    for (;;) {
+        if (state.error !== undefined) {
+            throw new RenderError("E_STAGE_MISSING", `cannot start the browser at ${state.browser}: ${state.error.message}`);
+        }
+        if (state.exited) {
+            throw new RenderError("E_STAGE_MISSING", `the browser exited with ${state.code ?? state.signal} before it published its DevTools port`);
+        }
+        if (existsSync(file)) {
+            try {
+                const lines = readFileSync(file, "utf8").split(/\r?\n/);
+                const port = Number(lines[0]);
+                if (Number.isInteger(port) && port > 0 && (lines[1] ?? "") !== "") {
+                    return `ws://127.0.0.1:${port}${lines[1]}`;
+                }
+            }
+            catch (err) {
+                if (!HELD_READ_CODES.has(err.code ?? ""))
+                    throw err;
+            }
+        }
+        if (Date.now() >= deadline) {
+            throw new RenderError("E_TIMEOUT", "the browser did not publish its DevTools port in time");
+        }
+        await sleep(POLL_MS);
+    }
+}
+/** Rejects when the promise does not settle before the deadline. */
+async function withDeadline(work, deadline, message) {
+    let timer;
+    const expired = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new RenderError("E_TIMEOUT", message)), Math.max(0, deadline - Date.now()));
+    });
+    try {
+        return await Promise.race([work, expired]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** The request interception of one page. It answers the page and the icon, and refuses every other request. */
+class Interceptor {
+    cdp;
+    html;
+    pinned;
+    blocked = [];
+    faults = [];
+    guarded = new Set();
+    sessions = new Map();
+    sessionWaiters = new Map();
+    constructor(cdp, html, pinned) {
+        this.cdp = cdp;
+        this.html = html;
+        this.pinned = pinned;
+    }
+    record = (err) => {
+        this.faults.push(err instanceof Error ? err : new Error(String(err)));
+    };
+    /**
+     * Intercepts every request of the session and auto-attaches its child targets (frames in another process,
+     * workers, pop-ups) paused, so that each child is guarded the same way before it runs. A dedicated worker has no
+     * Fetch domain: the session of its page intercepts its requests.
+     */
+    async guard(sessionId, type = "page") {
+        if (this.guarded.has(sessionId))
+            return;
+        this.guarded.add(sessionId);
+        const cdp = this.cdp;
+        cdp.on("Fetch.requestPaused", sessionId, (params) => this.paused(sessionId, params));
+        cdp.on("Target.attachedToTarget", sessionId, (params) => this.attached(params));
+        if (type !== "worker")
+            await cdp.send("Fetch.enable", { patterns: [{ urlPattern: "*" }] }, sessionId);
+        await cdp.send("Target.setAutoAttach", { autoAttach: true, waitForDebuggerOnStart: true, flatten: true }, sessionId);
+    }
+    /** Guards a new child target, then lets it run. A child that cannot be guarded fails the render. */
+    attached(params) {
+        const { sessionId, targetInfo } = params;
+        this.guard(sessionId, targetInfo.type)
+            .then(() => {
+            this.sessions.set(targetInfo.targetId, sessionId);
+            this.sessionWaiters.get(targetInfo.targetId)?.(sessionId);
+            return this.cdp.send("Runtime.runIfWaitingForDebugger", {}, sessionId);
+        })
+            .catch(this.record);
+    }
+    /** The session of a target, once the target is attached and guarded. */
+    sessionOf(targetId) {
+        const known = this.sessions.get(targetId);
+        if (known !== undefined)
+            return Promise.resolve(known);
+        return new Promise((resolve) => this.sessionWaiters.set(targetId, resolve));
+    }
+    paused(sessionId, params) {
+        const cdp = this.cdp;
+        const paused = params;
+        if (paused.request.url === FAVICON_URL) {
+            // The browser asks for an icon of the page host by itself. The client answers it with no content, so no
+            // request leaves the process and the icon is not counted as a request of the page.
+            cdp
+                .send("Fetch.fulfillRequest", { requestId: paused.requestId, responseCode: 204, responseHeaders: [], body: "" }, sessionId)
+                .catch(this.record);
+            return;
+        }
+        if (paused.request.url === PAGE_URL) {
+            cdp
+                .send("Fetch.fulfillRequest", {
+                requestId: paused.requestId,
+                responseCode: 200,
+                responseHeaders: [{ name: "Content-Type", value: "text/html; charset=utf-8" }],
+                body: Buffer.from(this.html, "utf8").toString("base64"),
+            }, sessionId)
+                .catch(this.record);
+            return;
+        }
+        const asset = this.pinned.get(paused.request.url);
+        if (asset !== undefined) {
+            // A pinned build is fulfilled from the bytes that the caller read from the engine package. No request leaves the process.
+            cdp
+                .send("Fetch.fulfillRequest", {
+                requestId: paused.requestId,
+                responseCode: 200,
+                responseHeaders: [{ name: "Content-Type", value: asset.mime }],
+                body: Buffer.from(asset.bytes).toString("base64"),
+            }, sessionId)
+                .catch(this.record);
+            return;
+        }
+        this.blocked.push(paused.request.url);
+        cdp.send("Fetch.failRequest", { requestId: paused.requestId, errorReason: "BlockedByClient" }, sessionId).catch(this.record);
+    }
+}
+/**
+ * Loads the page in a new target, refuses every request that is not the page, then captures it. Every request
+ * to the browser carries the deadline, and the whole capture runs under it. The load wait keys on the loader of
+ * the navigation, so a load event of an earlier document does not count.
+ */
+export async function capturePage(cdp, req, deadline) {
+    return withDeadline(capture(cdp, req), deadline, "the page did not load in time");
+}
+async function capture(cdp, req) {
+    const guard = new Interceptor(cdp, req.html, req.pinned ?? new Map());
+    // A new page that the page opens (window.open) is a new target of the browser. The browser-level auto-attach
+    // pauses it until it is guarded. A target of the browser itself (for example a built-in extension) is not a
+    // target of the page: the client lets it run, and the forced flags keep its connections on the proxy.
+    cdp.on("Target.attachedToTarget", undefined, (params) => {
+        const { sessionId, targetInfo } = params;
+        if (targetInfo.type === "page") {
+            guard.attached(params);
+        }
+        else {
+            cdp.send("Runtime.runIfWaitingForDebugger", {}, sessionId).catch(guard.record);
+        }
+    });
+    await cdp.send("Target.setAutoAttach", { autoAttach: true, waitForDebuggerOnStart: true, flatten: true });
+    const target = (await cdp.send("Target.createTarget", { url: "about:blank" }));
+    // The browser-level auto-attach attaches the new target and guards it. The client waits for that session.
+    const s = await guard.sessionOf(target.targetId);
+    const loads = new Set();
+    let onLoad;
+    cdp.on("Page.lifecycleEvent", s, (params) => {
+        const event = params;
+        if (event.name === "load") {
+            loads.add(event.loaderId);
+            onLoad?.();
+        }
+    });
+    await cdp.send("Page.enable", {}, s);
+    await cdp.send("Page.setLifecycleEventsEnabled", { enabled: true }, s);
+    if (req.format === "png" && req.awaitDone !== true) {
+        await cdp.send("Emulation.setDeviceMetricsOverride", { width: req.width, height: req.height, deviceScaleFactor: req.scale, mobile: false }, s);
+    }
+    const nav = (await cdp.send("Page.navigate", { url: PAGE_URL }, s));
+    if (nav.errorText !== undefined && nav.errorText !== "") {
+        throw new RenderError("E_INTERNAL", `the browser did not load the page: ${nav.errorText}`);
+    }
+    const loaderId = nav.loaderId ?? "";
+    // The load event can come before the reply of Page.navigate, so the seen loaders are checked first.
+    if (!loads.has(loaderId)) {
+        await new Promise((resolve) => {
+            onLoad = () => {
+                if (loads.has(loaderId))
+                    resolve();
+            };
+        });
+    }
+    let bytes;
+    if (req.awaitDone === true) {
+        const done = await awaitDoneReport(cdp, s);
+        // A page that cannot run the pinned build is a fault of the engine, not of the source.
+        if (!done.ok)
+            throw new RenderError(done.internal === true ? "E_INTERNAL" : "E_INPUT", done.message);
+        if (req.format === "svg") {
+            bytes = new TextEncoder().encode(done.svg);
+        }
+        else {
+            bytes = await drawDiagram(cdp, s, req);
+        }
+    }
+    else if (req.format === "pdf") {
+        await fitPageToDiagram(cdp, s);
+        bytes = await printPdf(cdp, s);
+    }
+    else if (req.format === "png") {
+        const data = (await cdp.send("Page.captureScreenshot", { format: "png", captureBeyondViewport: false }, s));
+        bytes = Buffer.from(data.data, "base64");
+    }
+    else {
+        throw new RenderError("E_INTERNAL", "the page format is not drawn by this stage");
+    }
+    if (guard.faults.length > 0) {
+        throw new RenderError("E_INTERNAL", `the browser rejected a page request: ${guard.faults[0]?.message ?? "unknown"}`);
+    }
+    return { bytes, blocked: guard.blocked };
+}
+/** Waits until the page sets window.__sciengDone. The wait is one promise that the browser resolves. */
+async function awaitDoneReport(cdp, s) {
+    const expression = "new Promise((resolve) => { const poll = () => (window.__sciengDone ? resolve(window.__sciengDone) : setTimeout(poll, 50)); poll(); })";
+    const reply = (await cdp.send("Runtime.evaluate", { expression, awaitPromise: true, returnByValue: true }, s));
+    const value = reply.result?.value;
+    if (reply.exceptionDetails !== undefined || value === undefined) {
+        throw new RenderError("E_INTERNAL", "the page did not report a result");
+    }
+    return value;
+}
+/** Reads the box of the first SVG of the diagram element, or undefined when the page has no diagram. */
+async function diagramBox(cdp, s) {
+    const expression = '(() => { const e = document.querySelector("#sciengjs-diagram svg"); if (!e) return null; const r = e.getBoundingClientRect(); ' +
+        "return { x: r.x, y: r.y, width: Math.ceil(r.width), height: Math.ceil(r.height) }; })()";
+    const reply = (await cdp.send("Runtime.evaluate", { expression, returnByValue: true }, s));
+    const box = reply.result?.value;
+    return box === null || box === undefined || box.width <= 0 || box.height <= 0 ? undefined : box;
+}
+/** Draws the diagram of a page that reports done: a png clipped to the diagram box. */
+async function drawDiagram(cdp, s, req) {
+    if (req.format === "svg")
+        throw new RenderError("E_INTERNAL", "an svg is not drawn from a box");
+    const box = await diagramBox(cdp, s);
+    if (box === undefined)
+        throw new RenderError("E_INPUT", "the diagram has no drawable size");
+    if (req.format === "pdf") {
+        await fitPageToDiagram(cdp, s);
+        return printPdf(cdp, s);
+    }
+    if (box.width * req.scale * (box.height * req.scale) > MAX_DEVICE_PIXELS) {
+        throw new RenderError("E_INPUT", `the png must not have more than ${MAX_DEVICE_PIXELS} device pixels`);
+    }
+    // The viewport takes the size of the diagram and the device scale of the request, so a wide diagram is not
+    // clipped and its pixel width is its CSS width times the scale.
+    await cdp.send("Emulation.setDeviceMetricsOverride", { width: Math.ceil(box.x + box.width), height: Math.ceil(box.y + box.height), deviceScaleFactor: req.scale, mobile: false }, s);
+    const fitted = (await diagramBox(cdp, s)) ?? box;
+    const data = (await cdp.send("Page.captureScreenshot", {
+        format: "png",
+        captureBeyondViewport: false,
+        clip: { x: fitted.x, y: fitted.y, width: fitted.width, height: fitted.height, scale: 1 },
+    }, s));
+    return Buffer.from(data.data, "base64");
+}
+/** Sets the pdf page size to the diagram box, so that the pdf holds one page of the diagram. A page with no diagram keeps its size. */
+async function fitPageToDiagram(cdp, s) {
+    const box = await diagramBox(cdp, s);
+    if (box === undefined)
+        return;
+    const css = `@page { size: ${box.width}px ${box.height}px; margin: 0 }`;
+    await cdp.send("Runtime.evaluate", { expression: `(() => { const st = document.createElement("style"); st.textContent = ${JSON.stringify(css)}; document.head.appendChild(st); })()` }, s);
+}
+async function printPdf(cdp, s) {
+    const data = (await cdp.send("Page.printToPDF", { printBackground: true, preferCSSPageSize: true }, s));
+    return Buffer.from(data.data, "base64");
+}
+function hasExited(child) {
+    return child.exitCode !== null || child.signalCode !== null;
+}
+/** Waits for the browser to exit. Returns false when it is still running at the deadline. */
+async function waitForExit(child, deadline) {
+    if (hasExited(child))
+        return true;
+    let timer;
+    const exited = new Promise((resolve) => {
+        child.once("exit", () => resolve(true));
+        timer = setTimeout(() => resolve(hasExited(child)), Math.max(0, deadline - Date.now()));
+    });
+    const result = await exited;
+    clearTimeout(timer);
+    return result;
+}
+/**
+ * Kills the browser and every process that it started. On POSIX the browser leads its own process group, so the
+ * group dies with one signal, also after the browser itself exited. On Windows `taskkill /T` walks the tree of a
+ * live process id. After the browser exited, Windows can give its id to an unrelated process, so the call is
+ * skipped then. A process that is already gone is not an error.
+ */
+function killTree(child) {
+    const pid = child.pid;
+    if (pid === undefined)
+        return;
+    if (IS_WINDOWS) {
+        if (hasExited(child))
+            return;
+        spawnSync("taskkill", ["/PID", String(pid), "/T", "/F"], { stdio: "ignore", windowsHide: true });
+        return;
+    }
+    try {
+        process.kill(-pid, "SIGKILL");
+    }
+    catch (err) {
+        if (err.code !== "ESRCH")
+            throw err;
+    }
+}
+/**
+ * Asks the browser to close, then waits for its exit. A browser still running at the deadline is killed with its
+ * process tree. The tree kill also runs after a clean close, so that no helper process stays.
+ */
+async function stopBrowser(cdp, child, deadline) {
+    if (cdp !== undefined) {
+        // The exit wait below decides whether the browser stopped. A failed close request is not an error by itself.
+        await cdp.send("Browser.close", {}, undefined, deadline).catch(() => undefined);
+        cdp.close();
+    }
+    const closed = await waitForExit(child, deadline);
+    killTree(child);
+    if (closed)
+        return;
+    // The kill is sure to end the process, but its exit event needs a moment. The wait gets a short floor.
+    if (!(await waitForExit(child, Math.max(deadline, Date.now() + 1000)))) {
+        throw new RenderError("E_INTERNAL", "the browser did not stop after it was killed");
+    }
+}
+/**
+ * Draws one HTML page in a new headless browser and returns the bytes of a PNG or a PDF.
+ * The browser runs with a new profile, the forced flags and a refusing proxy. The browser sandbox stays on.
+ * The profile, the proxy and the browser are removed on every path before the function returns. One deadline
+ * covers the whole cleanup.
+ */
+export async function renderHtmlPage(req) {
+    const pageBudgetMs = Math.floor(req.timeoutMs * PAGE_SHARE);
+    const cleanupBudgetMs = req.timeoutMs - pageBudgetMs;
+    const deadline = Date.now() + pageBudgetMs;
+    let proxy;
+    let profile;
+    let child;
+    let state;
+    let cdp;
+    try {
+        proxy = await startRefusingProxy();
+        profile = makeProfile();
+        req.onProfile?.(profile);
+        try {
+            child = spawn(req.browser, [...forcedBrowserFlags({ profileDir: profile, proxyPort: proxy.port }), "about:blank"], {
+                stdio: "ignore",
+                windowsHide: true,
+                // On POSIX the browser leads a new process group, so that the cleanup can kill the whole tree.
+                detached: !IS_WINDOWS,
+            });
+        }
+        catch (err) {
+            // Bun and Node on Windows throw at the spawn call for a file that cannot run.
+            throw new RenderError("E_STAGE_MISSING", `cannot start the browser at ${req.browser}: ${err.message}`);
+        }
+        state = watchChild(child, req.browser);
+        const address = await waitForBrowser(profile, state, deadline);
+        cdp = await connectCdp(address, deadline);
+        cdp.setDeadline(deadline);
+        return await capturePage(cdp, req, deadline);
+    }
+    finally {
+        const cleanupDeadline = Date.now() + cleanupBudgetMs;
+        try {
+            if (child !== undefined && state?.error === undefined)
+                await stopBrowser(cdp, child, cleanupDeadline);
+        }
+        finally {
+            try {
+                await proxy?.close();
+            }
+            finally {
+                if (profile !== undefined)
+                    await removeProfile(profile, cleanupDeadline);
+            }
+        }
+    }
+}
+//# sourceMappingURL=render.js.map

package/dist/browser/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/browser/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAqB,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAsB,MAAM,YAAY,CAAC;AAEpE,6GAA6G;AAC7G,MAAM,CAAC,MAAM,QAAQ,GAAG,+BAA+B,CAAC;AACxD,+GAA+G;AAC/G,MAAM,WAAW,GAAG,0CAA0C,CAAC;AAE/D;;;GAGG;AACH,MAAM,UAAU,GAAG,GAAG,CAAC;AACvB,MAAM,OAAO,GAAG,GAAG,CAAC;AACpB,MAAM,SAAS,GAAG,oBAAoB,CAAC;AACvC,8GAA8G;AAC9G,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC9D,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AA6DhD,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAE/F,SAAS,UAAU,CAAC,KAAmB,EAAE,OAAe;IACtD,MAAM,KAAK,GAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChF,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QAC1B,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC;IACpB,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;QAClC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QACpB,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QAClB,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;IACxB,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,sFAAsF;AACtF,KAAK,UAAU,cAAc,CAAC,OAAe,EAAE,KAAkB,EAAE,QAAgB;IACjF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACtC,SAAS,CAAC;QACR,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,WAAW,CAAC,iBAAiB,EAAE,+BAA+B,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACnH,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,WAAW,CACnB,iBAAiB,EACjB,2BAA2B,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,wCAAwC,CAC9F,CAAC;QACJ,CAAC;QACD,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACxD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC9B,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;oBAClE,OAAO,kBAAkB,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7C,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,eAAe,CAAC,GAAG,CAAE,GAA6B,CAAC,IAAI,IAAI,EAAE,CAAC;oBAAE,MAAM,GAAG,CAAC;YACjF,CAAC;QACH,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,WAAW,CAAC,WAAW,EAAE,uDAAuD,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,oEAAoE;AACpE,KAAK,UAAU,YAAY,CAAI,IAAgB,EAAE,QAAgB,EAAE,OAAe;IAChF,IAAI,KAAgD,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC9G,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7C,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,+GAA+G;AAC/G,MAAM,WAAW;IAQI,GAAG;IACH,IAAI;IACJ,MAAM;IAThB,OAAO,GAAa,EAAE,CAAC;IACvB,MAAM,GAAY,EAAE,CAAC;IACb,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5B,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IACrC,cAAc,GAAG,IAAI,GAAG,EAAuC,CAAC;IAEjF,YACmB,GAAkB,EAClB,IAAY,EACZ,MAAwC;mBAFxC,GAAG;oBACH,IAAI;sBACJ,MAAM;IACtB,CAAC;IAEJ,MAAM,GAAG,CAAC,GAAY,EAAQ,EAAE;QAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC,CAAC;IAEF;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,SAAiB,EAAE,IAAI,GAAG,MAAM;QAC1C,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO;QACxC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACrB,GAAG,CAAC,EAAE,CAAC,qBAAqB,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QACrF,GAAG,CAAC,EAAE,CAAC,yBAAyB,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAChF,IAAI,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACtG,MAAM,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;IACvH,CAAC;IAED,oGAAoG;IACpG,QAAQ,CAAC,MAAe;QACtB,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAA+E,CAAC;QAClH,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC;aACnC,IAAI,CAAC,GAAG,EAAE;YACT,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAClD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;QACzE,CAAC,CAAC;aACD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAED,wEAAwE;IACxE,SAAS,CAAC,QAAgB;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9E,CAAC;IAEO,MAAM,CAAC,SAAiB,EAAE,MAAe;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACrB,MAAM,MAAM,GAAG,MAAyD,CAAC;QACzE,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;YACvC,wGAAwG;YACxG,mFAAmF;YACnF,GAAG;iBACA,IAAI,CAAC,sBAAsB,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,EAAE,eAAe,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,CAAC;iBAC1H,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,GAAG;iBACA,IAAI,CACH,sBAAsB,EACtB;gBACE,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,YAAY,EAAE,GAAG;gBACjB,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC;gBAC9E,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;aACxD,EACD,SAAS,CACV;iBACA,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,0HAA0H;YAC1H,GAAG;iBACA,IAAI,CACH,sBAAsB,EACtB;gBACE,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,YAAY,EAAE,GAAG;gBACjB,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC9D,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;aAClD,EACD,SAAS,CACV;iBACA,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/H,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAkB,EAAE,GAAoB,EAAE,QAAgB;IAC1F,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,+BAA+B,CAAC,CAAC;AACpF,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,GAAkB,EAAE,GAAoB;IAC7D,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;IACtE,6GAA6G;IAC7G,4GAA4G;IAC5G,sGAAsG;IACtG,GAAG,CAAC,EAAE,CAAC,yBAAyB,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;QACtD,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAA6D,CAAC;QAChG,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC/B,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjF,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1G,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAyB,CAAC;IACvG,0GAA0G;IAC1G,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEjD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,IAAI,MAAgC,CAAC;IACrC,GAAG,CAAC,EAAE,CAAC,qBAAqB,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE;QAC1C,MAAM,KAAK,GAAG,MAA4C,CAAC;QAC3D,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC1B,MAAM,EAAE,EAAE,CAAC;QACb,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,GAAG,CAAC,IAAI,CAAC,gCAAgC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IACvE,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QACnD,MAAM,GAAG,CAAC,IAAI,CACZ,oCAAoC,EACpC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EACrF,CAAC,CACF,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAA8C,CAAC;IACjH,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,EAAE,EAAE,CAAC;QACxD,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,sCAAsC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;IACpC,oGAAoG;IACpG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,GAAG,GAAG,EAAE;gBACZ,IAAI,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;oBAAE,OAAO,EAAE,CAAC;YACrC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAiB,CAAC;IACtB,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC3C,uFAAuF;QACvF,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACrG,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACzB,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;SAAM,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAChC,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC/B,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACjC,CAAC;SAAM,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAqB,CAAC;QAChI,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,4CAA4C,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,wCAAwC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC;IACvH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;AAC3C,CAAC;AAED,wGAAwG;AACxG,KAAK,UAAU,eAAe,CAAC,GAAkB,EAAE,CAAS;IAC1D,MAAM,UAAU,GACd,uIAAuI,CAAC;IAC1I,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAG5G,CAAC;IACF,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC;IAClC,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAChE,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,kCAAkC,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wGAAwG;AACxG,KAAK,UAAU,UAAU,CAAC,GAAkB,EAAE,CAAS;IACrD,MAAM,UAAU,GACd,gIAAgI;QAChI,yFAAyF,CAAC;IAC5F,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAExF,CAAC;IACF,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC;IAChC,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;AAClG,CAAC;AAED,uFAAuF;AACvF,KAAK,UAAU,WAAW,CAAC,GAAkB,EAAE,CAAS,EAAE,GAAoB;IAC5E,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK;QAAE,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,gCAAgC,CAAC,CAAC;IAChG,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACrC,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,kCAAkC,CAAC,CAAC;IAC5F,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACzB,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC/B,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,iBAAiB,EAAE,CAAC;QACzE,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,mCAAmC,iBAAiB,gBAAgB,CAAC,CAAC;IACzG,CAAC;IACD,2GAA2G;IAC3G,gEAAgE;IAChE,MAAM,GAAG,CAAC,IAAI,CACZ,oCAAoC,EACpC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,iBAAiB,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAC3H,CAAC,CACF,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IACjD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAC1B,wBAAwB,EACxB;QACE,MAAM,EAAE,KAAK;QACb,qBAAqB,EAAE,KAAK;QAC5B,IAAI,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE;KACzF,EACD,CAAC,CACF,CAAqB,CAAC;IACvB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED,uIAAuI;AACvI,KAAK,UAAU,gBAAgB,CAAC,GAAkB,EAAE,CAAS;IAC3D,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACrC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO;IAC9B,MAAM,GAAG,GAAG,iBAAiB,GAAG,CAAC,KAAK,MAAM,GAAG,CAAC,MAAM,iBAAiB,CAAC;IACxE,MAAM,GAAG,CAAC,IAAI,CACZ,kBAAkB,EAClB,EAAE,UAAU,EAAE,yEAAyE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,uCAAuC,EAAE,EACnJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAkB,EAAE,CAAS;IACnD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAqB,CAAC;IAC5H,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,SAAS,CAAC,KAAmB;IACpC,OAAO,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED,6FAA6F;AAC7F,KAAK,UAAU,WAAW,CAAC,KAAmB,EAAE,QAAgB;IAC9D,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,KAAgD,CAAC;IACrD,MAAM,MAAM,GAAG,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QAC9C,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACxC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC;IAC5B,YAAY,CAAC,KAAK,CAAC,CAAC;IACpB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,KAAmB;IACnC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;IACtB,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO;IAC9B,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,SAAS,CAAC,KAAK,CAAC;YAAE,OAAO;QAC7B,SAAS,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACjG,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,OAAO;YAAE,MAAM,GAAG,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,WAAW,CAAC,GAA8B,EAAE,KAAmB,EAAE,QAAgB;IAC9F,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,6GAA6G;QAC7G,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAChF,GAAG,CAAC,KAAK,EAAE,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAClD,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChB,IAAI,MAAM;QAAE,OAAO;IACnB,uGAAuG;IACvG,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,8CAA8C,CAAC,CAAC;IACtF,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAoB;IACvD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,GAAG,UAAU,CAAC,CAAC;IAC5D,MAAM,eAAe,GAAG,GAAG,CAAC,SAAS,GAAG,YAAY,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;IAC3C,IAAI,KAAgC,CAAC;IACrC,IAAI,OAA2B,CAAC;IAChC,IAAI,KAA+B,CAAC;IACpC,IAAI,KAA8B,CAAC;IACnC,IAAI,GAA8B,CAAC;IACnC,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,kBAAkB,EAAE,CAAC;QACnC,OAAO,GAAG,WAAW,EAAE,CAAC;QACxB,GAAG,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC;QACzB,IAAI,CAAC;YACH,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,kBAAkB,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,aAAa,CAAC,EAAE;gBACjH,KAAK,EAAE,QAAQ;gBACf,WAAW,EAAE,IAAI;gBACjB,+FAA+F;gBAC/F,QAAQ,EAAE,CAAC,UAAU;aACtB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,8EAA8E;YAC9E,MAAM,IAAI,WAAW,CAAC,iBAAiB,EAAE,+BAA+B,GAAG,CAAC,OAAO,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACpH,CAAC;QACD,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC/D,GAAG,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC1C,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,MAAM,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;YAAS,CAAC;QACT,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe,CAAC;QACrD,IAAI,CAAC;YACH,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,EAAE,KAAK,KAAK,SAAS;gBAAE,MAAM,WAAW,CAAC,GAAG,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;QACxG,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC;gBACH,MAAM,KAAK,EAAE,KAAK,EAAE,CAAC;YACvB,CAAC;oBAAS,CAAC;gBACT,IAAI,OAAO,KAAK,SAAS;oBAAE,MAAM,aAAa,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/core.js

@@ -57,13 +57,19 @@ export async function renderWithRegistry(req, options, registry, configDeps) {
             format: req.format,
             source: req.source,
             options: (req.options ?? {}),
-            settings: { maxMemoryMb: cfg.maxMemoryMb, rasterFont: cfg.rasterFont, assetsUrl: cfg.assetsUrl },
+            settings: {
+                maxMemoryMb: cfg.maxMemoryMb,
+                rasterFont: cfg.rasterFont,
+                assetsUrl: cfg.assetsUrl,
+                browser: cfg.browser,
+                timeoutMs: cfg.timeoutMs,
+            },
         },
     }, { timeoutMs: cfg.timeoutMs, maxMemoryMb: cfg.maxMemoryMb });
     return {
         bytes: out.bytes,
         mime: MIME[req.format],
-        backend: entry.backend,
+        backend: out.backend ?? entry.backend,
         warnings: out.warnings ?? [],
     };
 }
@@ -75,6 +81,8 @@ export async function capabilitiesWithRegistry(options, registry, configDeps) {
         const browserReady = pair.stage !== "browser" || cfg.browser !== undefined;
         const ready = registered && browserReady;
         const cap = { type: pair.type, format: pair.format, stage: pair.stage, ready };
+        if (pair.note !== undefined)
+            cap.note = pair.note;
         if (!registered)
             cap.reason = "no backend is built in this release";
         else if (!browserReady)

package/dist/core.js.map

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

package/dist/graph/backend-pdf.d.ts

@@ -0,0 +1,3 @@
+import type { BackendOutput, WorkerJob } from "../worker/protocol.ts";
+/** Renders dot to pdf: the SVG of the graph, then the pdf of that SVG in the browser stage. The backend takes no options. */
+export declare function render(request: WorkerJob["request"]): Promise<BackendOutput>;

package/dist/graph/backend-pdf.js

@@ -0,0 +1,14 @@
+import { RenderError } from "../errors.js";
+import { drawSvgToPdf } from "../mermaid/browser.js";
+import { dotSourceText, dotToSvg } from "./dot.js";
+/** Renders dot to pdf: the SVG of the graph, then the pdf of that SVG in the browser stage. The backend takes no options. */
+export async function render(request) {
+    const names = Object.keys(request.options ?? {});
+    if (names.length > 0) {
+        throw new RenderError("E_INPUT", `dot to pdf takes no options; got ${names.join(", ")}`);
+    }
+    const dot = await dotToSvg(dotSourceText(request.source));
+    const draw = await drawSvgToPdf(dot.svg, request.settings);
+    return { bytes: draw.bytes, warnings: [...dot.warnings, ...draw.warnings], backend: "graph/viz+browser/chromium" };
+}
+//# sourceMappingURL=backend-pdf.js.map