@danielsimonjr/sciengjs 0.0.0-stage → 0.1.0

package/dist/graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import type { SciengConfig } from "./config.ts";
+import type { Capability, RenderRequest, RenderResult } from "./types.ts";
+export { RenderError, RENDER_ERROR_CODES, type RenderErrorCode } from "./errors.ts";
+export { loadConfig, type SciengConfig, type NetworkPolicy } from "./config.ts";
+export { INPUT_TYPES, OUTPUT_FORMATS, type InputType, type OutputFormat, type RenderOptions, type RenderRequest, type RenderResult, type RenderAsset, type Capability, } from "./types.ts";
+/** Renders one source to the requested format. Rejects with a RenderError. Never falls back to another format. */
+export declare function render(req: RenderRequest, config?: Partial<SciengConfig>): Promise<RenderResult>;
+/** Reports each supported pair, its stage and whether that stage is ready on this machine. */
+export declare function capabilities(config?: Partial<SciengConfig>): Promise<Capability[]>;

package/dist/index.js

@@ -0,0 +1,14 @@
+import { capabilitiesWithRegistry, renderWithRegistry } from "./core.js";
+import { DEFAULT_REGISTRY } from "./registry.js";
+export { RenderError, RENDER_ERROR_CODES } from "./errors.js";
+export { loadConfig } from "./config.js";
+export { INPUT_TYPES, OUTPUT_FORMATS, } from "./types.js";
+/** Renders one source to the requested format. Rejects with a RenderError. Never falls back to another format. */
+export function render(req, config) {
+    return renderWithRegistry(req, config ?? {}, DEFAULT_REGISTRY);
+}
+/** Reports each supported pair, its stage and whether that stage is ready on this machine. */
+export function capabilities(config) {
+    return capabilitiesWithRegistry(config ?? {}, DEFAULT_REGISTRY);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAIjD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAwB,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,UAAU,EAAyC,MAAM,aAAa,CAAC;AAChF,OAAO,EACL,WAAW,EACX,cAAc,GAQf,MAAM,YAAY,CAAC;AAEpB,kHAAkH;AAClH,MAAM,UAAU,MAAM,CAAC,GAAkB,EAAE,MAA8B;IACvE,OAAO,kBAAkB,CAAC,GAAG,EAAE,MAAM,IAAI,EAAE,EAAE,gBAAgB,CAAC,CAAC;AACjE,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,YAAY,CAAC,MAA8B;IACzD,OAAO,wBAAwB,CAAC,MAAM,IAAI,EAAE,EAAE,gBAAgB,CAAC,CAAC;AAClE,CAAC"}

package/dist/pairs.d.ts

@@ -0,0 +1,11 @@
+import type { InputType, OutputFormat } from "./types.ts";
+/** One (input, output) pair of the design, with the stage that renders it. */
+export interface PairSpec {
+    type: InputType;
+    format: OutputFormat;
+    stage: string;
+}
+/** The pairs of the design section "Scope". A pair missing here is unsupported. */
+export declare const PAIRS: readonly PairSpec[];
+/** Returns the pair of the table, or undefined when the design does not list it. */
+export declare function findPair(type: InputType, format: OutputFormat): PairSpec | undefined;

package/dist/pairs.js

@@ -0,0 +1,43 @@
+/** The pairs of the design section "Scope". A pair missing here is unsupported. */
+export const PAIRS = [
+    { type: "dot", format: "svg", stage: "graph" },
+    { type: "dot", format: "png", stage: "graph" },
+    { type: "dot", format: "pdf", stage: "browser" },
+    { type: "mermaid", format: "svg", stage: "browser" },
+    { type: "mermaid", format: "png", stage: "browser" },
+    { type: "mermaid", format: "pdf", stage: "browser" },
+    { type: "math", format: "svg", stage: "math" },
+    { type: "math", format: "png", stage: "math" },
+    { type: "math", format: "pdf", stage: "math" },
+    { type: "tikz", format: "svg", stage: "tex" },
+    { type: "tikz", format: "png", stage: "tex" },
+    { type: "tikz", format: "pdf", stage: "tex" },
+    { type: "plot", format: "svg", stage: "plot" },
+    { type: "plot", format: "png", stage: "plot" },
+    { type: "plot", format: "pdf", stage: "plot" },
+    { type: "plot", format: "html", stage: "plot" },
+    { type: "sysml", format: "svg", stage: "graph" },
+    { type: "sysml", format: "png", stage: "graph" },
+    { type: "sysml", format: "pdf", stage: "graph" },
+    { type: "step", format: "html", stage: "mesh" },
+    { type: "step", format: "png", stage: "browser" },
+    { type: "step", format: "glb", stage: "mesh" },
+    { type: "iges", format: "html", stage: "mesh" },
+    { type: "iges", format: "png", stage: "browser" },
+    { type: "iges", format: "glb", stage: "mesh" },
+    { type: "brep", format: "html", stage: "mesh" },
+    { type: "brep", format: "png", stage: "browser" },
+    { type: "brep", format: "glb", stage: "mesh" },
+    { type: "cad", format: "html", stage: "mesh" },
+    { type: "cad", format: "png", stage: "browser" },
+    { type: "cad", format: "glb", stage: "mesh" },
+    { type: "cad", format: "stl", stage: "mesh" },
+    { type: "html", format: "png", stage: "browser" },
+    { type: "html", format: "pdf", stage: "browser" },
+    { type: "html", format: "md", stage: "html" },
+];
+/** Returns the pair of the table, or undefined when the design does not list it. */
+export function findPair(type, format) {
+    return PAIRS.find((p) => p.type === type && p.format === format);
+}
+//# sourceMappingURL=pairs.js.map

package/dist/pairs.js.map

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

package/dist/raster/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The most megabytes of RGBA pixels that one PNG render accepts. Measured: a render holds about two
+ * copies of the pixel buffer (the pixmap and the PNG encoder input), so the peak is 2.0 times the pixels
+ * (8000 by 8000 pixels peak at 536 MB, 16000 by 16000 at 1999 MB). WASM memory ends at 4 GiB.
+ */
+export declare const MAX_PNG_PIXEL_MB = 1024;
+/** The options of one SVG to PNG render. */
+export interface SvgToPngOptions {
+    scale: number;
+    maxMemoryMb: number;
+    font?: Uint8Array;
+    /** Replaces the reader of the resvg WASM file. Tests use it to fail the first start. */
+    readWasm?: () => Uint8Array;
+}
+/** Renders an SVG to PNG bytes with resvg. The scale multiplies the SVG size. A pixel buffer over maxMemoryMb or over MAX_PNG_PIXEL_MB rejects with E_LIMIT. */
+export declare function svgToPng(svg: string, options: SvgToPngOptions): Promise<Uint8Array>;
+/** Tells whether the bytes start with a TrueType, OpenType or Apple TrueType font signature. A collection (ttcf) is not a single font. */
+export declare function isFontFile(bytes: Uint8Array): boolean;

package/dist/raster/index.js

@@ -0,0 +1,77 @@
+import { initWasm, Resvg } from "@resvg/resvg-wasm";
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { RenderError } from "../errors.js";
+/**
+ * The most megabytes of RGBA pixels that one PNG render accepts. Measured: a render holds about two
+ * copies of the pixel buffer (the pixmap and the PNG encoder input), so the peak is 2.0 times the pixels
+ * (8000 by 8000 pixels peak at 536 MB, 16000 by 16000 at 1999 MB). WASM memory ends at 4 GiB.
+ */
+export const MAX_PNG_PIXEL_MB = 1024;
+let wasmPromise;
+function defaultReadWasm() {
+    return readFileSync(createRequire(import.meta.url).resolve("@resvg/resvg-wasm/index_bg.wasm"));
+}
+// A failed start is not cached, so a later render can try again.
+function ensureWasm(readWasm) {
+    if (wasmPromise === undefined) {
+        const started = (async () => {
+            await initWasm(readWasm());
+        })();
+        wasmPromise = started;
+        started.catch(() => {
+            if (wasmPromise === started) {
+                wasmPromise = undefined;
+            }
+        });
+    }
+    return wasmPromise;
+}
+/** Renders an SVG to PNG bytes with resvg. The scale multiplies the SVG size. A pixel buffer over maxMemoryMb or over MAX_PNG_PIXEL_MB rejects with E_LIMIT. */
+export async function svgToPng(svg, options) {
+    await ensureWasm(options.readWasm ?? defaultReadWasm);
+    let resvg;
+    try {
+        resvg = new Resvg(svg, {
+            fitTo: { mode: "zoom", value: options.scale },
+            dpi: 72,
+            font: { loadSystemFonts: false, fontBuffers: options.font ? [options.font] : [] },
+        });
+    }
+    catch (err) {
+        throw new RenderError("E_INPUT", "resvg cannot read the SVG: " + (err instanceof Error ? err.message : String(err)));
+    }
+    try {
+        const limitMb = Math.min(options.maxMemoryMb, MAX_PNG_PIXEL_MB);
+        const limitBytes = limitMb * 1048576;
+        const needed = Math.ceil(resvg.width * options.scale) * Math.ceil(resvg.height * options.scale) * 4;
+        if (needed > limitBytes) {
+            throw new RenderError("E_LIMIT", "the PNG needs " + needed + " bytes of pixels; the limit is " + limitBytes + " bytes");
+        }
+        return resvg.render().asPng();
+    }
+    finally {
+        resvg.free();
+    }
+}
+/** Tells whether the bytes start with a TrueType, OpenType or Apple TrueType font signature. A collection (ttcf) is not a single font. */
+export function isFontFile(bytes) {
+    if (bytes.length < 4) {
+        return false;
+    }
+    const b0 = bytes[0];
+    const b1 = bytes[1];
+    const b2 = bytes[2];
+    const b3 = bytes[3];
+    if (b0 === 0x00 && b1 === 0x01 && b2 === 0x00 && b3 === 0x00) {
+        return true;
+    }
+    if (b0 === 0x4f && b1 === 0x54 && b2 === 0x54 && b3 === 0x4f) {
+        return true;
+    }
+    if (b0 === 0x74 && b1 === 0x72 && b2 === 0x75 && b3 === 0x65) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=index.js.map

package/dist/raster/index.js.map

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

package/dist/raster/warnings.d.ts

@@ -0,0 +1,12 @@
+/** Tells whether the font holds a glyph for a code point. */
+export type CoverageTest = (codePoint: number) => boolean;
+/**
+ * Reads the Unicode character map of a TrueType or OpenType font (formats 4 and 12).
+ * Returns undefined when the font has no readable map, so the caller skips the check.
+ */
+export declare function fontCovers(font: Uint8Array): CoverageTest | undefined;
+/**
+ * Lists what the raster font cannot draw in the text of an SVG. The font has one face, so bold and
+ * italic text draw in that face. A character without a glyph draws no pixel. Each kind gives one warning.
+ */
+export declare function rasterWarnings(svg: string, font: Uint8Array): string[];

package/dist/raster/warnings.js

@@ -0,0 +1,175 @@
+function tableOf(view, tag) {
+    if (view.byteLength < 12) {
+        return undefined;
+    }
+    const count = view.getUint16(4);
+    for (let i = 0; i < count; i++) {
+        const entry = 12 + i * 16;
+        if (entry + 16 > view.byteLength) {
+            return undefined;
+        }
+        let name = "";
+        for (let k = 0; k < 4; k++) {
+            name += String.fromCharCode(view.getUint8(entry + k));
+        }
+        if (name === tag) {
+            return { offset: view.getUint32(entry + 8), length: view.getUint32(entry + 12) };
+        }
+    }
+    return undefined;
+}
+function format4(view, start) {
+    const segments = view.getUint16(start + 6) / 2;
+    const ends = start + 14;
+    const starts = ends + segments * 2 + 2;
+    const deltas = starts + segments * 2;
+    const ranges = deltas + segments * 2;
+    return (cp) => {
+        if (cp > 0xffff) {
+            return false;
+        }
+        for (let s = 0; s < segments; s++) {
+            if (cp > view.getUint16(ends + s * 2)) {
+                continue;
+            }
+            const first = view.getUint16(starts + s * 2);
+            if (cp < first) {
+                return false;
+            }
+            const offset = view.getUint16(ranges + s * 2);
+            let glyph;
+            if (offset === 0) {
+                glyph = (cp + view.getUint16(deltas + s * 2)) & 0xffff;
+            }
+            else {
+                const at = ranges + s * 2 + offset + (cp - first) * 2;
+                if (at + 2 > view.byteLength) {
+                    return false;
+                }
+                glyph = view.getUint16(at);
+                if (glyph !== 0) {
+                    glyph = (glyph + view.getUint16(deltas + s * 2)) & 0xffff;
+                }
+            }
+            return glyph !== 0;
+        }
+        return false;
+    };
+}
+function format12(view, start) {
+    const groups = view.getUint32(start + 12);
+    return (cp) => {
+        for (let g = 0; g < groups; g++) {
+            const at = start + 16 + g * 12;
+            if (at + 12 > view.byteLength) {
+                return false;
+            }
+            if (cp >= view.getUint32(at) && cp <= view.getUint32(at + 4)) {
+                return true;
+            }
+        }
+        return false;
+    };
+}
+/**
+ * Reads the Unicode character map of a TrueType or OpenType font (formats 4 and 12).
+ * Returns undefined when the font has no readable map, so the caller skips the check.
+ */
+export function fontCovers(font) {
+    const view = new DataView(font.buffer, font.byteOffset, font.byteLength);
+    try {
+        const cmap = tableOf(view, "cmap");
+        if (cmap === undefined) {
+            return undefined;
+        }
+        const tests = [];
+        const count = view.getUint16(cmap.offset + 2);
+        for (let i = 0; i < count; i++) {
+            const record = cmap.offset + 4 + i * 8;
+            const platform = view.getUint16(record);
+            const encoding = view.getUint16(record + 2);
+            const unicode = platform === 0 || (platform === 3 && (encoding === 1 || encoding === 10));
+            if (!unicode) {
+                continue;
+            }
+            const sub = cmap.offset + view.getUint32(record + 4);
+            const format = view.getUint16(sub);
+            if (format === 4) {
+                tests.push(format4(view, sub));
+            }
+            else if (format === 12) {
+                tests.push(format12(view, sub));
+            }
+        }
+        if (tests.length === 0) {
+            return undefined;
+        }
+        return (cp) => tests.some((test) => test(cp));
+    }
+    catch {
+        return undefined;
+    }
+}
+// A named entity of SVG (amp, lt, gt, quot, apos) stands for an ASCII character, which the check skips. Only a numeric reference can name a character that the font lacks.
+function decodeEntities(text) {
+    return text.replace(/&#(x[0-9a-fA-F]+|[0-9]+);/g, (whole, body) => {
+        const value = body.startsWith("x") ? parseInt(body.slice(1), 16) : parseInt(body, 10);
+        return value <= 0x10ffff ? String.fromCodePoint(value) : whole;
+    });
+}
+function isBold(weight) {
+    const value = weight.trim().toLowerCase();
+    return value === "bold" || value === "bolder" || (/^[0-9]+$/.test(value) && Number(value) >= 600);
+}
+/** The code point text of an SVG fragment: the markup removed and the entities read. */
+function textOf(markup) {
+    return decodeEntities(markup.replace(/<[^>]*>/g, ""));
+}
+/**
+ * Lists what the raster font cannot draw in the text of an SVG. The font has one face, so bold and
+ * italic text draw in that face. A character without a glyph draws no pixel. Each kind gives one warning.
+ */
+export function rasterWarnings(svg, font) {
+    const covers = fontCovers(font);
+    let bold = 0;
+    let italic = 0;
+    const missing = new Set();
+    for (const match of svg.matchAll(/<(?:text|tspan)\b([^>]*)>/g)) {
+        const attributes = match[1];
+        const weight = /\sfont-weight="([^"]*)"/.exec(attributes);
+        if (weight !== null && isBold(weight[1])) {
+            bold++;
+        }
+        const style = /\sfont-style="([^"]*)"/.exec(attributes);
+        if (style !== null && (style[1] === "italic" || style[1] === "oblique")) {
+            italic++;
+        }
+    }
+    if (covers !== undefined) {
+        for (const match of svg.matchAll(/<text\b[^>]*>([\s\S]*?)<\/text>/g)) {
+            for (const ch of textOf(match[1])) {
+                const cp = ch.codePointAt(0);
+                if (cp > 0x20 && cp !== 0xa0 && !(cp >= 0x7f && cp < 0xa0) && !covers(cp)) {
+                    missing.add(cp);
+                }
+            }
+        }
+    }
+    const warnings = [];
+    if (covers === undefined && /<text\b/.test(svg)) {
+        warnings.push("the raster font has no readable character map, so the render cannot check which characters it draws");
+    }
+    if (bold > 0) {
+        warnings.push(`${bold} bold text element(s) draw in the one face of the raster font`);
+    }
+    if (italic > 0) {
+        warnings.push(`${italic} italic text element(s) draw in the one face of the raster font`);
+    }
+    if (missing.size > 0) {
+        const first = [...missing][0];
+        const code = "U+" + first.toString(16).toUpperCase().padStart(4, "0");
+        warnings.push(`${missing.size} character(s) have no glyph in the raster font and draw blank (first: ${code})`);
+    }
+    return warnings;
+}
+//# sourceMappingURL=warnings.js.map

package/dist/raster/warnings.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,13 @@
+/** One backend: the module that the worker loads for a (type, format) pair. */
+export interface BackendEntry {
+    /** The backend name that a result reports, for example "graph/viz". */
+    backend: string;
+    /** An absolute file URL of a module that exports `render`. */
+    moduleUrl: string;
+}
+/** Maps "type:format" to a backend. A key is missing when no backend is built in. */
+export type Registry = Record<string, BackendEntry>;
+/** The backends of this build. */
+export declare const DEFAULT_REGISTRY: Registry;
+/** Builds the registry key of a pair. */
+export declare function registryKey(type: string, format: string): string;

package/dist/registry.js

@@ -0,0 +1,17 @@
+import { extname } from "node:path";
+import { fileURLToPath } from "node:url";
+/** The URL of a backend module of this package. The extension follows the build: .ts from src, .js from dist. */
+function backendUrl(name) {
+    const extension = extname(fileURLToPath(import.meta.url));
+    return new URL(`./${name}${extension}`, import.meta.url).href;
+}
+/** The backends of this build. */
+export const DEFAULT_REGISTRY = {
+    "dot:svg": { backend: "graph/viz", moduleUrl: backendUrl("graph/backend-svg") },
+    "dot:png": { backend: "graph/viz+raster/resvg", moduleUrl: backendUrl("graph/backend-png") },
+};
+/** Builds the registry key of a pair. */
+export function registryKey(type, format) {
+    return `${type}:${format}`;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAazC,iHAAiH;AACjH,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,OAAO,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,SAAS,EAAE,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;AAChE,CAAC;AAED,kCAAkC;AAClC,MAAM,CAAC,MAAM,gBAAgB,GAAa;IACxC,SAAS,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,mBAAmB,CAAC,EAAE;IAC/E,SAAS,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,SAAS,EAAE,UAAU,CAAC,mBAAmB,CAAC,EAAE;CAC7F,CAAC;AAEF,yCAAyC;AACzC,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAAc;IACtD,OAAO,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC;AAC7B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,48 @@
+/** The input types of the design. */
+export declare const INPUT_TYPES: readonly ["dot", "mermaid", "math", "tikz", "plot", "sysml", "step", "iges", "brep", "cad", "html"];
+/** One input type of the design. */
+export type InputType = (typeof INPUT_TYPES)[number];
+/** The output formats of the design. */
+export declare const OUTPUT_FORMATS: readonly ["svg", "png", "pdf", "html", "md", "glb", "stl"];
+/** One output format of the design. */
+export type OutputFormat = (typeof OUTPUT_FORMATS)[number];
+/** Input types whose source is bytes, not text. */
+export declare const BINARY_INPUT_TYPES: readonly InputType[];
+/** Per-type options. Each increment types its own keys. I0 keeps the bag open. */
+export type RenderOptions = Record<string, unknown>;
+/** One render request. The source is text, or bytes for the binary input types. */
+export interface RenderRequest {
+    type: InputType;
+    /** Text for text formats, bytes for step, iges and brep. */
+    source: string | Uint8Array;
+    format: OutputFormat;
+    options?: RenderOptions;
+}
+/** One extracted asset, for example an image. */
+export interface RenderAsset {
+    name: string;
+    bytes: Uint8Array;
+    mime: string;
+}
+/** The result of one render. */
+export interface RenderResult {
+    bytes: Uint8Array;
+    mime: string;
+    /** The backend that rendered, for example "graph/viz". */
+    backend: string;
+    /** Each item names its source line when it has one. */
+    warnings: string[];
+    /** Extracted images, for example from an HTML to Markdown render. */
+    assets?: RenderAsset[];
+}
+/** One supported pair with its stage and its readiness. */
+export interface Capability {
+    type: InputType;
+    format: OutputFormat;
+    /** The stage that the pair needs. */
+    stage: string;
+    /** True when the stage is ready on this machine. */
+    ready: boolean;
+    /** Why the pair is not ready, when it is not. */
+    reason?: string;
+}

package/dist/types.js

@@ -0,0 +1,19 @@
+/** The input types of the design. */
+export const INPUT_TYPES = [
+    "dot",
+    "mermaid",
+    "math",
+    "tikz",
+    "plot",
+    "sysml",
+    "step",
+    "iges",
+    "brep",
+    "cad",
+    "html",
+];
+/** The output formats of the design. */
+export const OUTPUT_FORMATS = ["svg", "png", "pdf", "html", "md", "glb", "stl"];
+/** Input types whose source is bytes, not text. */
+export const BINARY_INPUT_TYPES = ["step", "iges", "brep"];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK;IACL,SAAS;IACT,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;CACE,CAAC;AAKX,wCAAwC;AACxC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAKzF,mDAAmD;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/dist/worker/entry.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/worker/entry.js

@@ -0,0 +1,38 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { parentPort, workerData } from "node:worker_threads";
+import { RenderError, RENDER_ERROR_CODES } from "../errors.js";
+/**
+ * The worker side of a render. The worker loads the backend module, runs one request and posts one message.
+ * A backend error that is a RenderError keeps its code. Any other error maps to E_INTERNAL.
+ */
+async function run(job) {
+    try {
+        const mod = (await import(__rewriteRelativeImportExtension(job.moduleUrl)));
+        if (typeof mod.render !== "function") {
+            throw new RenderError("E_INTERNAL", `backend module ${job.moduleUrl} exports no render function`);
+        }
+        const out = await mod.render(job.request);
+        return { ok: true, bytes: out.bytes, warnings: out.warnings ?? [] };
+    }
+    catch (err) {
+        if (err instanceof RenderError) {
+            return { ok: false, code: err.code, message: err.message, line: err.line, column: err.column };
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, code: "E_INTERNAL", message };
+    }
+}
+const job = workerData;
+const message = await run(job);
+if (!message.ok && !RENDER_ERROR_CODES.includes(message.code)) {
+    message.code = "E_INTERNAL";
+}
+parentPort?.postMessage(message);
+//# sourceMappingURL=entry.js.map

package/dist/worker/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../src/worker/entry.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAwB,MAAM,cAAc,CAAC;AAGrF;;;GAGG;AACH,KAAK,UAAU,GAAG,CAAC,GAAc;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,kCAAC,GAAG,CAAC,SAAS,EAAC,CAAuF,CAAC;QAChI,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACrC,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,kBAAkB,GAAG,CAAC,SAAS,6BAA6B,CAAC,CAAC;QACpG,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;IACtE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;YAC/B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;QACjG,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;IACpD,CAAC;AACH,CAAC;AAED,MAAM,GAAG,GAAG,UAAuB,CAAC;AACpC,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;AAC/B,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAE,kBAAwC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IACrF,OAAO,CAAC,IAAI,GAAG,YAAsC,CAAC;AACxD,CAAC;AACD,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC"}

package/dist/worker/protocol.d.ts

@@ -0,0 +1,37 @@
+import type { InputType, OutputFormat, RenderOptions } from "../types.ts";
+/** The configuration values that a backend reads. */
+export interface BackendSettings {
+    /** The memory limit of one render, in megabytes. */
+    maxMemoryMb: number;
+    /** The path of the raster font that replaces the bundled font, or undefined for the bundled font. */
+    rasterFont: string | undefined;
+}
+/** What the worker receives: one render request and the backend module that serves it. */
+export interface WorkerJob {
+    moduleUrl: string;
+    backend: string;
+    request: {
+        type: InputType;
+        format: OutputFormat;
+        source: string | Uint8Array;
+        options: RenderOptions;
+        settings: BackendSettings;
+    };
+}
+/** The value that a backend module returns from `render`. */
+export interface BackendOutput {
+    bytes: Uint8Array;
+    warnings?: string[];
+}
+/** The one message that a worker sends back. */
+export type WorkerMessage = {
+    ok: true;
+    bytes: Uint8Array;
+    warnings: string[];
+} | {
+    ok: false;
+    code: string;
+    message: string;
+    line?: number;
+    column?: number;
+};

package/dist/worker/protocol.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/worker/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/worker/protocol.ts"],"names":[],"mappings":""}

package/dist/worker/run.d.ts

@@ -0,0 +1,30 @@
+import { Worker } from "node:worker_threads";
+import type { BackendOutput, WorkerJob } from "./protocol.ts";
+/** The exit of one worker. The exit code is the code that `Worker.terminate` reports. */
+export interface WorkerExit {
+    exitCode: number;
+}
+/** The limits of one worker render. */
+export interface WorkerLimits {
+    /** The time limit of one render, in milliseconds. */
+    timeoutMs: number;
+    /**
+     * The heap limit of the worker, in megabytes. Node enforces it. Bun 1.4.4 accepts the option
+     * and does not enforce it, so the limit holds only under Node, the release runtime.
+     */
+    maxMemoryMb: number;
+    /** Called once the worker has exited, before the render settles. Tests use it to prove the exit. */
+    onWorkerExit?: (exit: WorkerExit) => void;
+    /** The longest wait for the worker to stop after the render settles, in milliseconds. */
+    terminateWaitMs?: number;
+    /** Creates the worker. Tests replace it with a double. */
+    createWorker?: (entry: URL, data: WorkerJob, maxMemoryMb: number) => Worker;
+}
+/**
+ * Runs one render in a fresh worker. The worker ends at the first of: its message, its error,
+ * its exit, or the time limit. The promise settles only after the worker has exited.
+ *
+ * A heap exhaustion (`ERR_WORKER_OUT_OF_MEMORY`) maps to `E_LIMIT`. The design lists the heap
+ * limit as a resource limit of a source. A crash of any other kind maps to `E_INTERNAL`.
+ */
+export declare function runInWorker(job: WorkerJob, limits: WorkerLimits): Promise<BackendOutput>;