@danielsimonjr/sciengjs 0.2.0 → 0.3.0

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

@@ -0,0 +1,3 @@
+import type { BackendOutput, WorkerJob } from "../worker/protocol.ts";
+/** Renders html to pdf through Page.printToPDF in the headless browser. The worker calls this function. */
+export declare function render(request: WorkerJob["request"]): Promise<BackendOutput>;

package/dist/browser/backend-pdf.js

@@ -0,0 +1,15 @@
+import { blockedWarnings, browserPathOf, htmlSource, parsePdfOptions } from "./input.js";
+import { renderHtmlPage } from "./render.js";
+/** Renders html to pdf through Page.printToPDF in the headless browser. The worker calls this function. */
+export async function render(request) {
+    parsePdfOptions(request.options);
+    const browser = browserPathOf(request.settings.browser);
+    const out = await renderHtmlPage({
+        html: htmlSource(request.source),
+        format: "pdf",
+        browser,
+        timeoutMs: request.settings.timeoutMs,
+    });
+    return { bytes: out.bytes, warnings: blockedWarnings(out.blocked) };
+}
+//# sourceMappingURL=backend-pdf.js.map

package/dist/browser/backend-pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-pdf.js","sourceRoot":"","sources":["../../src/browser/backend-pdf.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,2GAA2G;AAC3G,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAA6B;IACxD,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC;QAC/B,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;QAChC,MAAM,EAAE,KAAK;QACb,OAAO;QACP,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAS;KACtC,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;AACtE,CAAC"}

package/dist/browser/backend-png.d.ts

@@ -0,0 +1,3 @@
+import type { BackendOutput, WorkerJob } from "../worker/protocol.ts";
+/** Renders html to png: a screenshot of the page in the headless browser. The worker calls this function. */
+export declare function render(request: WorkerJob["request"]): Promise<BackendOutput>;

package/dist/browser/backend-png.js

@@ -0,0 +1,18 @@
+import { blockedWarnings, browserPathOf, htmlSource, parsePngOptions } from "./input.js";
+import { renderHtmlPage } from "./render.js";
+/** Renders html to png: a screenshot of the page in the headless browser. The worker calls this function. */
+export async function render(request) {
+    const options = parsePngOptions(request.options);
+    const browser = browserPathOf(request.settings.browser);
+    const out = await renderHtmlPage({
+        html: htmlSource(request.source),
+        format: "png",
+        width: options.width,
+        height: options.height,
+        scale: options.scale,
+        browser,
+        timeoutMs: request.settings.timeoutMs,
+    });
+    return { bytes: out.bytes, warnings: blockedWarnings(out.blocked) };
+}
+//# sourceMappingURL=backend-png.js.map

package/dist/browser/backend-png.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-png.js","sourceRoot":"","sources":["../../src/browser/backend-png.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,6GAA6G;AAC7G,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAA6B;IACxD,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC;QAC/B,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;QAChC,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO;QACP,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAS;KACtC,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;AACtE,CAAC"}

package/dist/browser/cdp.d.ts

@@ -0,0 +1,37 @@
+/** The part of a WebSocket that the client uses. The global WebSocket of Node 22 and Bun meets it. */
+export interface CdpSocket {
+    send(text: string): void;
+    close(): void;
+    addEventListener(type: string, listener: (ev: {
+        data?: unknown;
+    }) => void): void;
+}
+/** One Chrome DevTools Protocol connection. It matches each reply to its request and routes each event. */
+export declare class CdpConnection {
+    private readonly socket;
+    private closed;
+    private nextId;
+    private readonly pending;
+    private readonly eventHandlers;
+    private deadline;
+    constructor(socket: CdpSocket);
+    /** Sets the default deadline (a Date.now() time) of each later request that names no deadline of its own. */
+    setDeadline(deadline: number | undefined): void;
+    /** The count of requests that wait for a reply. */
+    pendingCount(): number;
+    /**
+     * Sends one request. A request with no reply before its deadline rejects with E_TIMEOUT, and its pending entry
+     * is removed, so that a late reply is ignored.
+     */
+    send(method: string, params?: Record<string, unknown>, sessionId?: string, deadline?: number | undefined): Promise<unknown>;
+    on(method: string, sessionId: string | undefined, handler: (params: unknown) => void): void;
+    close(): void;
+    private handleMessageData;
+    private handleSocketClose;
+    private rejectAllPending;
+}
+/**
+ * Opens a DevTools socket and returns a connection on it. An error event, or a close before the open, rejects with
+ * E_STAGE_MISSING. No open before the deadline closes the socket and rejects with E_TIMEOUT.
+ */
+export declare function connectCdp(address: string, deadline: number, makeSocket?: (address: string) => CdpSocket): Promise<CdpConnection>;

package/dist/browser/cdp.js

@@ -0,0 +1,161 @@
+import { RenderError } from "../errors.js";
+const SOCKET_CLOSED_MESSAGE = "the DevTools socket closed";
+function safeJsonParse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+function errorText(error) {
+    if (typeof error === "object" && error !== null) {
+        const message = error.message;
+        if (typeof message === "string") {
+            return message;
+        }
+    }
+    return JSON.stringify(error);
+}
+/** One Chrome DevTools Protocol connection. It matches each reply to its request and routes each event. */
+export class CdpConnection {
+    socket;
+    closed = false;
+    nextId = 1;
+    pending = new Map();
+    eventHandlers = [];
+    deadline;
+    constructor(socket) {
+        this.socket = socket;
+        socket.addEventListener("message", (ev) => {
+            this.handleMessageData(ev.data);
+        });
+        socket.addEventListener("close", () => {
+            this.handleSocketClose();
+        });
+    }
+    /** Sets the default deadline (a Date.now() time) of each later request that names no deadline of its own. */
+    setDeadline(deadline) {
+        this.deadline = deadline;
+    }
+    /** The count of requests that wait for a reply. */
+    pendingCount() {
+        return this.pending.size;
+    }
+    /**
+     * Sends one request. A request with no reply before its deadline rejects with E_TIMEOUT, and its pending entry
+     * is removed, so that a late reply is ignored.
+     */
+    send(method, params, sessionId, deadline = this.deadline) {
+        if (this.closed) {
+            return Promise.reject(new Error(SOCKET_CLOSED_MESSAGE));
+        }
+        const id = this.nextId++;
+        const payload = {
+            id,
+            method,
+            params: params ?? {},
+        };
+        if (sessionId !== undefined) {
+            payload.sessionId = sessionId;
+        }
+        return new Promise((resolve, reject) => {
+            const timer = deadline === undefined
+                ? undefined
+                : setTimeout(() => {
+                    this.pending.delete(id);
+                    reject(new RenderError("E_TIMEOUT", `the browser did not answer ${method} in time`));
+                }, Math.max(0, deadline - Date.now()));
+            this.pending.set(id, { resolve, reject, timer });
+            this.socket.send(JSON.stringify(payload));
+        });
+    }
+    on(method, sessionId, handler) {
+        this.eventHandlers.push({ method, sessionId, handler });
+    }
+    close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        this.rejectAllPending();
+        this.socket.close();
+    }
+    handleMessageData(data) {
+        if (typeof data !== "string") {
+            return;
+        }
+        const parsed = safeJsonParse(data);
+        if (parsed === null || typeof parsed !== "object") {
+            return;
+        }
+        const message = parsed;
+        if (typeof message.id === "number") {
+            const pending = this.pending.get(message.id);
+            if (pending === undefined) {
+                return;
+            }
+            this.pending.delete(message.id);
+            clearTimeout(pending.timer);
+            if (message.error !== undefined && message.error !== null) {
+                pending.reject(new Error(errorText(message.error)));
+            }
+            else {
+                pending.resolve(message.result);
+            }
+            return;
+        }
+        if (typeof message.method !== "string") {
+            return;
+        }
+        const eventSessionId = typeof message.sessionId === "string" ? message.sessionId : undefined;
+        for (const entry of this.eventHandlers) {
+            if (entry.method === message.method && entry.sessionId === eventSessionId) {
+                entry.handler(message.params);
+            }
+        }
+    }
+    handleSocketClose() {
+        this.closed = true;
+        this.rejectAllPending();
+    }
+    rejectAllPending() {
+        for (const pending of Array.from(this.pending.values())) {
+            clearTimeout(pending.timer);
+            pending.reject(new Error(SOCKET_CLOSED_MESSAGE));
+        }
+        this.pending.clear();
+    }
+}
+/** The WebSocket of the runtime as a CdpSocket. */
+function runtimeSocket(address) {
+    return new WebSocket(address);
+}
+/**
+ * Opens a DevTools socket and returns a connection on it. An error event, or a close before the open, rejects with
+ * E_STAGE_MISSING. No open before the deadline closes the socket and rejects with E_TIMEOUT.
+ */
+export function connectCdp(address, deadline, makeSocket = runtimeSocket) {
+    const socket = makeSocket(address);
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const settle = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            fn();
+        };
+        const timer = setTimeout(() => {
+            settle(() => {
+                socket.close();
+                reject(new RenderError("E_TIMEOUT", `the DevTools socket ${address} did not open in time`));
+            });
+        }, Math.max(0, deadline - Date.now()));
+        socket.addEventListener("open", () => settle(() => resolve(new CdpConnection(socket))));
+        const fail = () => settle(() => reject(new RenderError("E_STAGE_MISSING", `cannot open the DevTools socket ${address}`)));
+        socket.addEventListener("error", fail);
+        socket.addEventListener("close", fail);
+    });
+}
+//# sourceMappingURL=cdp.js.map

package/dist/browser/cdp.js.map

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

package/dist/browser/flags.d.ts

@@ -0,0 +1,10 @@
+/** The values that the forced flags need: the profile folder and the port of the refusing proxy. */
+export interface FlagInputs {
+    profileDir: string;
+    proxyPort: number;
+}
+/**
+ * The flags of every browser start. Each flag closes one route off the host. The client never adds
+ * `--no-sandbox`. The renderer keeps the Chrome sandbox on.
+ */
+export declare function forcedBrowserFlags(input: FlagInputs): string[];

package/dist/browser/flags.js

@@ -0,0 +1,33 @@
+/**
+ * The flags of every browser start. Each flag closes one route off the host. The client never adds
+ * `--no-sandbox`. The renderer keeps the Chrome sandbox on.
+ */
+export function forcedBrowserFlags(input) {
+    return [
+        "--headless=new",
+        // The DevTools port is an ephemeral loopback port. Another local process of the same user can reach it while the
+        // render runs. A pipe (--remote-debugging-pipe) closes that route, but it needs extra file descriptors and
+        // replaces the port file, so the client keeps the port. The port lives only for one render.
+        "--remote-debugging-port=0",
+        `--user-data-dir=${input.profileDir}`,
+        "--no-first-run",
+        "--no-default-browser-check",
+        "--disable-extensions",
+        "--do-not-de-elevate",
+        "--disable-breakpad",
+        "--disable-crash-reporter",
+        `--proxy-server=http://127.0.0.1:${input.proxyPort}`,
+        "--proxy-bypass-list=<-loopback>",
+        "--host-resolver-rules=MAP * ~NOTFOUND, EXCLUDE 127.0.0.1",
+        "--force-webrtc-ip-handling-policy=disable_non_proxied_udp",
+        // The browser makes no request of its own: no background service, no component update, no sync, no ping.
+        "--disable-background-networking",
+        "--disable-component-update",
+        "--disable-sync",
+        "--no-pings",
+        "--disable-component-extensions-with-background-pages",
+        // Linux containers often have a small /dev/shm. The browser then writes its shared memory to the temp folder.
+        "--disable-dev-shm-usage",
+    ];
+}
+//# sourceMappingURL=flags.js.map

package/dist/browser/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../src/browser/flags.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAClD,OAAO;QACL,gBAAgB;QAChB,iHAAiH;QACjH,2GAA2G;QAC3G,4FAA4F;QAC5F,2BAA2B;QAC3B,mBAAmB,KAAK,CAAC,UAAU,EAAE;QACrC,gBAAgB;QAChB,4BAA4B;QAC5B,sBAAsB;QACtB,qBAAqB;QACrB,oBAAoB;QACpB,0BAA0B;QAC1B,mCAAmC,KAAK,CAAC,SAAS,EAAE;QACpD,iCAAiC;QACjC,0DAA0D;QAC1D,2DAA2D;QAC3D,yGAAyG;QACzG,iCAAiC;QACjC,4BAA4B;QAC5B,gBAAgB;QAChB,YAAY;QACZ,sDAAsD;QACtD,8GAA8G;QAC9G,yBAAyB;KAC1B,CAAC;AACJ,CAAC"}

package/dist/browser/index.d.ts

@@ -0,0 +1,5 @@
+/** The Chrome DevTools Protocol client of the browser stage. It has no npm dependency. */
+export { CdpConnection, type CdpSocket } from "./cdp.ts";
+export { forcedBrowserFlags, type FlagInputs } from "./flags.ts";
+export { startRefusingProxy, type RefusingProxy } from "./proxy.ts";
+export { renderHtmlPage, type HtmlPageRequest, type HtmlPageResult, type HtmlFormat } from "./render.ts";

package/dist/browser/index.js

@@ -0,0 +1,6 @@
+/** The Chrome DevTools Protocol client of the browser stage. It has no npm dependency. */
+export { CdpConnection } from "./cdp.js";
+export { forcedBrowserFlags } from "./flags.js";
+export { startRefusingProxy } from "./proxy.js";
+export { renderHtmlPage } from "./render.js";
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,OAAO,EAAE,aAAa,EAAkB,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAmB,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAsB,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,cAAc,EAA8D,MAAM,aAAa,CAAC"}

package/dist/browser/input.d.ts

@@ -0,0 +1,38 @@
+/** The default page width of a png, in CSS pixels. */
+export declare const DEFAULT_WIDTH = 800;
+/** The default page height of a png, in CSS pixels. */
+export declare const DEFAULT_HEIGHT = 600;
+/** The default device scale of a png. */
+export declare const DEFAULT_SCALE = 1;
+/** The largest width or height of a png, in CSS pixels. */
+export declare const MAX_SIDE = 16384;
+/** The largest device scale of a png. */
+export declare const MAX_SCALE = 8;
+/** The largest count of device pixels of a png: (width * scale) * (height * scale). */
+export declare const MAX_DEVICE_PIXELS: number;
+/** The largest count of refused URLs that get one warning each. */
+export declare const MAX_BLOCKED_WARNINGS = 50;
+/** The largest count of URL characters in one warning. */
+export declare const MAX_WARNING_URL_CHARS = 200;
+/** The options of html to png. */
+export interface PngOptions {
+    width: number;
+    height: number;
+    scale: number;
+}
+/**
+ * Checks the options of html to png. An unknown key, a bad value, a side over MAX_SIDE, a scale over MAX_SCALE
+ * or a device pixel count over MAX_DEVICE_PIXELS rejects with E_INPUT.
+ */
+export declare function parsePngOptions(options: Record<string, unknown>): PngOptions;
+/** Checks the options of html to pdf. The pdf takes no option. */
+export declare function parsePdfOptions(options: Record<string, unknown>): void;
+/** The HTML text of a source. A source that is bytes rejects with E_INPUT. */
+export declare function htmlSource(source: string | Uint8Array): string;
+/** The browser path of the settings. A missing path rejects with E_STAGE_MISSING. */
+export declare function browserPathOf(browser: string | undefined): string;
+/**
+ * One warning for each request that the page made and the client refused, up to MAX_BLOCKED_WARNINGS. A URL is cut
+ * to MAX_WARNING_URL_CHARS and its control characters are escaped. One last warning counts the requests over the cap.
+ */
+export declare function blockedWarnings(blocked: readonly string[]): string[];

package/dist/browser/input.js

@@ -0,0 +1,97 @@
+import { RenderError } from "../errors.js";
+/** The default page width of a png, in CSS pixels. */
+export const DEFAULT_WIDTH = 800;
+/** The default page height of a png, in CSS pixels. */
+export const DEFAULT_HEIGHT = 600;
+/** The default device scale of a png. */
+export const DEFAULT_SCALE = 1;
+/** The largest width or height of a png, in CSS pixels. */
+export const MAX_SIDE = 16384;
+/** The largest device scale of a png. */
+export const MAX_SCALE = 8;
+/** The largest count of device pixels of a png: (width * scale) * (height * scale). */
+export const MAX_DEVICE_PIXELS = 64 * 1024 * 1024;
+/** The largest count of refused URLs that get one warning each. */
+export const MAX_BLOCKED_WARNINGS = 50;
+/** The largest count of URL characters in one warning. */
+export const MAX_WARNING_URL_CHARS = 200;
+function rejectUnknownKeys(options, allowed, pair) {
+    for (const key of Object.keys(options)) {
+        if (!allowed.includes(key)) {
+            throw new RenderError("E_INPUT", `${pair} takes no option ${key}`);
+        }
+    }
+}
+function positiveInteger(options, key, fallback) {
+    if (!(key in options))
+        return fallback;
+    const value = options[key];
+    if (typeof value === "number" && Number.isInteger(value) && value > 0)
+        return value;
+    throw new RenderError("E_INPUT", `option ${key} must be a whole number greater than 0`);
+}
+function positiveNumber(options, key, fallback) {
+    if (!(key in options))
+        return fallback;
+    const value = options[key];
+    if (typeof value === "number" && Number.isFinite(value) && value > 0)
+        return value;
+    throw new RenderError("E_INPUT", `option ${key} must be a finite number greater than 0`);
+}
+/**
+ * Checks the options of html to png. An unknown key, a bad value, a side over MAX_SIDE, a scale over MAX_SCALE
+ * or a device pixel count over MAX_DEVICE_PIXELS rejects with E_INPUT.
+ */
+export function parsePngOptions(options) {
+    rejectUnknownKeys(options, ["width", "height", "scale"], "html to png");
+    const width = positiveInteger(options, "width", DEFAULT_WIDTH);
+    const height = positiveInteger(options, "height", DEFAULT_HEIGHT);
+    const scale = positiveNumber(options, "scale", DEFAULT_SCALE);
+    if (width > MAX_SIDE || height > MAX_SIDE) {
+        throw new RenderError("E_INPUT", `options width and height must not be more than ${MAX_SIDE}`);
+    }
+    if (scale > MAX_SCALE) {
+        throw new RenderError("E_INPUT", `option scale must not be more than ${MAX_SCALE}`);
+    }
+    if (width * scale * (height * scale) > MAX_DEVICE_PIXELS) {
+        throw new RenderError("E_INPUT", `the png must not have more than ${MAX_DEVICE_PIXELS} device pixels`);
+    }
+    return { width, height, scale };
+}
+/** Checks the options of html to pdf. The pdf takes no option. */
+export function parsePdfOptions(options) {
+    rejectUnknownKeys(options, [], "html to pdf");
+}
+/** The HTML text of a source. A source that is bytes rejects with E_INPUT. */
+export function htmlSource(source) {
+    if (typeof source !== "string") {
+        throw new RenderError("E_INPUT", "html takes text, not bytes");
+    }
+    return source;
+}
+/** The browser path of the settings. A missing path rejects with E_STAGE_MISSING. */
+export function browserPathOf(browser) {
+    if (browser === undefined || browser === "") {
+        throw new RenderError("E_STAGE_MISSING", "the browser stage needs SCIENG_BROWSER or the browser configuration key");
+    }
+    return browser;
+}
+/** Writes each control character, and U+2028 and U+2029, as a \uXXXX escape. */
+function escapeControls(text) {
+    return text.replace(/[\u0000-\u001f\u007f-\u009f\u2028\u2029]/g, (ch) => `\\u${ch.charCodeAt(0).toString(16).padStart(4, "0")}`);
+}
+/**
+ * One warning for each request that the page made and the client refused, up to MAX_BLOCKED_WARNINGS. A URL is cut
+ * to MAX_WARNING_URL_CHARS and its control characters are escaped. One last warning counts the requests over the cap.
+ */
+export function blockedWarnings(blocked) {
+    const warnings = blocked.slice(0, MAX_BLOCKED_WARNINGS).map((url) => {
+        const cut = url.length > MAX_WARNING_URL_CHARS ? `${url.slice(0, MAX_WARNING_URL_CHARS)}...` : url;
+        return `the page requested ${escapeControls(cut)}; the browser stage refused the request`;
+    });
+    if (blocked.length > MAX_BLOCKED_WARNINGS) {
+        warnings.push(`the browser stage refused ${blocked.length - MAX_BLOCKED_WARNINGS} more requests`);
+    }
+    return warnings;
+}
+//# sourceMappingURL=input.js.map

package/dist/browser/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/browser/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AACjC,uDAAuD;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,yCAAyC;AACzC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,2DAA2D;AAC3D,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAC;AAC9B,yCAAyC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAC3B,uFAAuF;AACvF,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAClD,mEAAmE;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AASzC,SAAS,iBAAiB,CAAC,OAAgC,EAAE,OAA0B,EAAE,IAAY;IACnG,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,GAAG,IAAI,oBAAoB,GAAG,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,OAAgC,EAAE,GAAW,EAAE,QAAgB;IACtF,IAAI,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC;QAAE,OAAO,QAAQ,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACpF,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,UAAU,GAAG,wCAAwC,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,cAAc,CAAC,OAAgC,EAAE,GAAW,EAAE,QAAgB;IACrF,IAAI,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC;QAAE,OAAO,QAAQ,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACnF,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,UAAU,GAAG,yCAAyC,CAAC,CAAC;AAC3F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgC;IAC9D,iBAAiB,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAC9D,IAAI,KAAK,GAAG,QAAQ,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,kDAAkD,QAAQ,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,sCAAsC,SAAS,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,KAAK,GAAG,KAAK,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,iBAAiB,EAAE,CAAC;QACzD,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,mCAAmC,iBAAiB,gBAAgB,CAAC,CAAC;IACzG,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAClC,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,OAAgC;IAC9D,iBAAiB,CAAC,OAAO,EAAE,EAAE,EAAE,aAAa,CAAC,CAAC;AAChD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,MAA2B;IACpD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,4BAA4B,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,OAA2B;IACvD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,WAAW,CAAC,iBAAiB,EAAE,yEAAyE,CAAC,CAAC;IACtH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,OAAO,CAAC,2CAA2C,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AACnI,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAA0B;IACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAClE,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,GAAG,qBAAqB,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;QACnG,OAAO,sBAAsB,cAAc,CAAC,GAAG,CAAC,yCAAyC,CAAC;IAC5F,CAAC,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,6BAA6B,OAAO,CAAC,MAAM,GAAG,oBAAoB,gBAAgB,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/browser/page.d.ts

@@ -0,0 +1,10 @@
+/** Writes a value as a JavaScript literal that cannot end a script element or break a line. */
+export declare function scriptJson(text: string): string;
+/** A page that shows one SVG document. The SVG text comes from the engine, not from the caller. */
+export declare function svgPageHtml(svg: string): string;
+/**
+ * A page that loads the pinned Mermaid build and renders one source. The result is stored in window.__sciengDone:
+ * `{ok: true, svg}` after the SVG is shown, `{ok: false, message}` when Mermaid rejects the source, or
+ * `{ok: false, internal: true, message}` when the pinned build did not load.
+ */
+export declare function mermaidPageHtml(source: string, cdnUrl: string): string;

package/dist/browser/page.js

@@ -0,0 +1,33 @@
+const PAGE_STYLE = "html,body{margin:0;background:#fff}";
+/** Writes a value as a JavaScript literal that cannot end a script element or break a line. */
+export function scriptJson(text) {
+    return JSON.stringify(text).replace(/[<>&\u2028\u2029]/g, (ch) => "\\u" + ch.charCodeAt(0).toString(16).padStart(4, "0"));
+}
+/** A page that shows one SVG document. The SVG text comes from the engine, not from the caller. */
+export function svgPageHtml(svg) {
+    return `<!DOCTYPE html><html><head><meta charset="utf-8"><style>${PAGE_STYLE}</style></head><body><div id="sciengjs-diagram">${svg}</div></body></html>`;
+}
+/**
+ * A page that loads the pinned Mermaid build and renders one source. The result is stored in window.__sciengDone:
+ * `{ok: true, svg}` after the SVG is shown, `{ok: false, message}` when Mermaid rejects the source, or
+ * `{ok: false, internal: true, message}` when the pinned build did not load.
+ */
+export function mermaidPageHtml(source, cdnUrl) {
+    const render = 'if (typeof mermaid === "undefined") { window.__sciengDone = { ok: false, internal: true, message: "the pinned Mermaid build did not load" }; return; } ' +
+        'try { mermaid.initialize({ startOnLoad: false, securityLevel: "strict" }); ' +
+        `const { svg } = await mermaid.render("sciengjs-render", ${scriptJson(source)}); ` +
+        'const host = document.getElementById("sciengjs-diagram"); host.innerHTML = svg; ' +
+        // The diagram gets the explicit size of its viewBox, so that the svg and the screenshot do not follow the page width.
+        'const el = host.querySelector("svg"); const vb = el && el.viewBox && el.viewBox.baseVal; ' +
+        "if (vb && vb.width > 0 && vb.height > 0) { " +
+        'el.setAttribute("width", String(Math.ceil(vb.width))); el.setAttribute("height", String(Math.ceil(vb.height))); ' +
+        'el.style.removeProperty("max-width"); } ' +
+        "const out = el ? new XMLSerializer().serializeToString(el) : svg; " +
+        "window.__sciengDone = { ok: true, svg: out }; " +
+        "} catch (err) { window.__sciengDone = { ok: false, message: String((err && err.message) || err) }; }";
+    return (`<!DOCTYPE html><html><head><meta charset="utf-8"><style>${PAGE_STYLE}</style></head><body>` +
+        '<div id="sciengjs-diagram"></div>' +
+        `<script src="${cdnUrl}"></script>` +
+        `<script>(async () => { ${render} })();</script></body></html>`);
+}
+//# sourceMappingURL=page.js.map

package/dist/browser/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/browser/page.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,qCAAqC,CAAC;AAEzD,+FAA+F;AAC/F,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CACjC,oBAAoB,EACpB,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAC/D,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,2DAA2D,UAAU,mDAAmD,GAAG,sBAAsB,CAAC;AAC3J,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,MAAc;IAC5D,MAAM,MAAM,GACV,yJAAyJ;QACzJ,6EAA6E;QAC7E,2DAA2D,UAAU,CAAC,MAAM,CAAC,KAAK;QAClF,kFAAkF;QAClF,sHAAsH;QACtH,2FAA2F;QAC3F,6CAA6C;QAC7C,kHAAkH;QAClH,0CAA0C;QAC1C,oEAAoE;QACpE,gDAAgD;QAChD,sGAAsG,CAAC;IACzG,OAAO,CACL,2DAA2D,UAAU,uBAAuB;QAC5F,mCAAmC;QACnC,gBAAgB,MAAM,aAAa;QACnC,0BAA0B,MAAM,+BAA+B,CAChE,CAAC;AACJ,CAAC"}

package/dist/browser/pinned.d.ts

@@ -0,0 +1,16 @@
+/** The pinned Mermaid version. It equals the exact devDependency of the repository. */
+export declare const MERMAID_VERSION = "11.17.2";
+/** The SHA-256 of the pinned Mermaid build. The client refuses a local copy with other bytes. */
+export declare const MERMAID_SHA256 = "581ed7d74bd9048d0e3a91363927d72ef22942d7722546b27f7cc29e35390eb8";
+/** The file of the pinned Mermaid build inside the assets folder. The build copies it there. */
+export declare const MERMAID_FILE = "mermaid.min.js";
+/** The address that a page names for the pinned Mermaid build. The client answers it from the assets folder. */
+export declare const MERMAID_CDN_URL = "https://cdn.jsdelivr.net/npm/mermaid@11.17.2/dist/mermaid.min.js";
+/** One pinned build that a page may name. The client fulfils its exact URL from the local file. */
+export interface PinnedAsset {
+    url: string;
+    file: string;
+    mime: string;
+}
+/** The pinned builds of the engine. Each entry names the URL of the CDN and the local file. */
+export declare const PINNED_ASSETS: readonly PinnedAsset[];

package/dist/browser/pinned.js

@@ -0,0 +1,13 @@
+/** The pinned Mermaid version. It equals the exact devDependency of the repository. */
+export const MERMAID_VERSION = "11.17.2";
+/** The SHA-256 of the pinned Mermaid build. The client refuses a local copy with other bytes. */
+export const MERMAID_SHA256 = "581ed7d74bd9048d0e3a91363927d72ef22942d7722546b27f7cc29e35390eb8";
+/** The file of the pinned Mermaid build inside the assets folder. The build copies it there. */
+export const MERMAID_FILE = "mermaid.min.js";
+/** The address that a page names for the pinned Mermaid build. The client answers it from the assets folder. */
+export const MERMAID_CDN_URL = `https://cdn.jsdelivr.net/npm/mermaid@${MERMAID_VERSION}/dist/mermaid.min.js`;
+/** The pinned builds of the engine. Each entry names the URL of the CDN and the local file. */
+export const PINNED_ASSETS = [
+    { url: MERMAID_CDN_URL, file: MERMAID_FILE, mime: "application/javascript" },
+];
+//# sourceMappingURL=pinned.js.map

package/dist/browser/pinned.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinned.js","sourceRoot":"","sources":["../../src/browser/pinned.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC;AACzC,iGAAiG;AACjG,MAAM,CAAC,MAAM,cAAc,GAAG,kEAAkE,CAAC;AACjG,gGAAgG;AAChG,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAC7C,gHAAgH;AAChH,MAAM,CAAC,MAAM,eAAe,GAAG,wCAAwC,eAAe,sBAAsB,CAAC;AAS7G,+FAA+F;AAC/F,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,wBAAwB,EAAE;CAC7E,CAAC"}

package/dist/browser/profile.d.ts

@@ -0,0 +1,9 @@
+/** The prefix of every profile folder that a render creates. A test looks for it to find leaks. */
+export declare const PROFILE_PREFIX = "sciengjs-browser-";
+/** Creates a new empty profile folder in the temporary folder of the system. */
+export declare function makeProfile(): string;
+/**
+ * Removes the profile. A held file is retried until the deadline, a Date.now() time. Any other error, or a deadline with the
+ * folder still held, rejects with E_INTERNAL, so that a leak is never reported as clean.
+ */
+export declare function removeProfile(profile: string, deadline: number): Promise<void>;

package/dist/browser/profile.js

@@ -0,0 +1,33 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { RenderError } from "../errors.js";
+/** The prefix of every profile folder that a render creates. A test looks for it to find leaks. */
+export const PROFILE_PREFIX = "sciengjs-browser-";
+/** The codes that Windows gives while the browser still holds a file of the profile. */
+const HOLD_CODES = new Set(["EBUSY", "EPERM", "ENOTEMPTY"]);
+const RETRY_MS = 250;
+/** Creates a new empty profile folder in the temporary folder of the system. */
+export function makeProfile() {
+    return mkdtempSync(join(tmpdir(), PROFILE_PREFIX));
+}
+/**
+ * Removes the profile. A held file is retried until the deadline, a Date.now() time. Any other error, or a deadline with the
+ * folder still held, rejects with E_INTERNAL, so that a leak is never reported as clean.
+ */
+export async function removeProfile(profile, deadline) {
+    for (;;) {
+        try {
+            rmSync(profile, { recursive: true, force: true });
+            return;
+        }
+        catch (err) {
+            const code = err.code;
+            if (code === undefined || !HOLD_CODES.has(code) || Date.now() >= deadline) {
+                throw new RenderError("E_INTERNAL", `cannot remove the browser profile ${profile}: ${err.message}`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, RETRY_MS));
+        }
+    }
+}
+//# sourceMappingURL=profile.js.map

package/dist/browser/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/browser/profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,mGAAmG;AACnG,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAElD,wFAAwF;AACxF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;AAC5D,MAAM,QAAQ,GAAG,GAAG,CAAC;AAErB,gFAAgF;AAChF,MAAM,UAAU,WAAW;IACzB,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe,EAAE,QAAgB;IACnE,SAAS,CAAC;QACR,IAAI,CAAC;YACH,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;YACjD,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC1E,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,qCAAqC,OAAO,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACjH,CAAC;YACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/browser/proxy.d.ts

@@ -0,0 +1,14 @@
+/** A proxy that refuses every request and records the host of each attempt. */
+export interface RefusingProxy {
+    /** The loopback port of the proxy. */
+    port: number;
+    /** The host name of each attempt, in order. */
+    attempts(): string[];
+    /** Stops the proxy. Resolves once no connection is open. */
+    close(): Promise<void>;
+}
+/**
+ * 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 declare function startRefusingProxy(): Promise<RefusingProxy>;