@danielsimonjr/sciengjs 0.9.0 → 1.0.0

package/dist/tex/specials.d.ts

@@ -0,0 +1,32 @@
+/** The SVG unit of the specials of dvisvgm: the big point (72 bp = 72.27 pt). */
+export declare const SPECIAL_UNIT_PER_PT: number;
+/** The position of a special on the page, in SVG units, and the size of one TeX point in these units. */
+export interface SpecialPosition {
+    x: number;
+    y: number;
+    unit: number;
+}
+/** What a special gives to the page: SVG text, a box for the bounds, or nothing. */
+export interface SpecialResult {
+    /** SVG text for the page. */
+    svg?: string;
+    /** The box `[x0, y0, x1, y1]` that joins the bounds of the page. */
+    box?: number[];
+}
+/** The reader of the dvisvgm specials. */
+export interface Specials {
+    /** Turns one special into SVG text, a box or `null`. */
+    special(text: string, at: SpecialPosition): SpecialResult | null;
+    /** The first words of the specials that the reader did not handle, in order and without repeats. */
+    ignored(): string[];
+    /**
+     * Tells whether the page is inside a raw group with a `transform` attribute. A pgf picture moves its text
+     * with such a group, so the DVI position of a glyph there is not its place on the page.
+     */
+    transformed(): boolean;
+}
+/**
+ * Creates a reader for the `dvisvgm:raw`, `rawdef`, `rawset`, `endrawset`, `rawput` and `bbox` specials
+ * and for the `color push` and `color pop` specials. The reader keeps the named raw sets between calls.
+ */
+export declare function createSpecials(): Specials;

package/dist/tex/specials.js

@@ -0,0 +1,145 @@
+/** The SVG unit of the specials of dvisvgm: the big point (72 bp = 72.27 pt). */
+export const SPECIAL_UNIT_PER_PT = 72 / 72.27;
+const round4 = (v) => Math.round(v * 1e4) / 1e4;
+// The rounding removes float noise, so 10 stays "10".
+const fmt = (v) => String(round4(v));
+function fill(text, at) {
+    return text.replace(/\{\?x\}/g, fmt(at.x)).replace(/\{\?y\}/g, fmt(at.y)).replace(/\{\?nl\}/g, "\n");
+}
+function firstWord(text) {
+    return text.trim().split(/\s+/)[0];
+}
+/**
+ * Creates a reader for the `dvisvgm:raw`, `rawdef`, `rawset`, `endrawset`, `rawput` and `bbox` specials
+ * and for the `color push` and `color pop` specials. The reader keeps the named raw sets between calls.
+ */
+export function createSpecials() {
+    const sets = new Map();
+    let active = null;
+    const ignoredList = [];
+    // One entry for each open group on the page: true when the group has a transform attribute.
+    const groups = [];
+    function track(r) {
+        if (r?.svg === undefined)
+            return r;
+        for (const m of r.svg.matchAll(/<g(\s[^>]*)?>|<\/g>/g)) {
+            if (m[0] === "</g>")
+                groups.pop();
+            else
+                groups.push(/transform\s*=/.test(m[1] ?? ""));
+        }
+        return r;
+    }
+    function remember(word) {
+        if (word && !ignoredList.includes(word))
+            ignoredList.push(word);
+    }
+    // The numbers of dvisvgm:bbox are in TeX points.
+    function bbox(arg, at) {
+        const t = arg.trim();
+        const toks = t.length === 0 ? [] : t.split(/\s+/);
+        const head = toks[0];
+        if (head === "lock" || head === "unlock" || head === "fix" || head === "new")
+            return null;
+        if (toks.length < 2)
+            return null;
+        const w = Number(toks[0]);
+        const h = Number(toks[1]);
+        const d = toks.length > 2 ? Number(toks[2]) : 0;
+        if (![w, h, d].every(Number.isFinite))
+            return null;
+        // The box runs W wide from the point, H high above and D deep below it.
+        return { box: [round4(at.x), round4(at.y - h * at.unit), round4(at.x + w * at.unit), round4(at.y + d * at.unit)] };
+    }
+    function dvisvgm(rest, first, at) {
+        const m = rest.match(/^\s*(\S+)(?:\s([\s\S]*))?$/);
+        if (m === null) {
+            remember(first);
+            return null;
+        }
+        const cmd = m[1];
+        const arg = m[2] === undefined ? "" : m[2];
+        if (cmd === "raw") {
+            if (active !== null) {
+                // Inside a capture the text is stored unreplaced.
+                sets.set(active, sets.get(active) + arg);
+                return null;
+            }
+            return { svg: fill(arg, at) };
+        }
+        if (cmd === "rawdef")
+            return { svg: "<defs>" + fill(arg, at) + "</defs>" };
+        if (cmd === "rawset") {
+            const name = firstWord(arg);
+            if (name !== "" && active === null) {
+                active = name;
+                sets.set(name, "");
+            }
+            return null;
+        }
+        if (cmd === "endrawset") {
+            active = null;
+            return null;
+        }
+        if (cmd === "rawput") {
+            const name = firstWord(arg);
+            const stored = name === "" ? undefined : sets.get(name);
+            // A set that still captures is not ready for a put. The placeholders are replaced at the time of the put.
+            if (stored === undefined || name === active)
+                return null;
+            return { svg: fill(stored, at) };
+        }
+        if (cmd === "bbox")
+            return bbox(arg, at);
+        remember(first);
+        return null;
+    }
+    function color(words) {
+        if (words[1] === "pop")
+            return { svg: "</g>" };
+        if (words[1] !== "push") {
+            remember(words[0]);
+            return null;
+        }
+        const chan = (v) => Math.round(v * 255);
+        const model = words[2];
+        let rgb = null;
+        if (model === "rgb" && words.length >= 6) {
+            const v = words.slice(3, 6).map(Number);
+            if (v.every(Number.isFinite))
+                rgb = v.map(chan);
+        }
+        else if (model === "gray" && words.length >= 4) {
+            const v = Number(words[3]);
+            if (Number.isFinite(v))
+                rgb = [chan(v), chan(v), chan(v)];
+        }
+        else if (model === "cmyk" && words.length >= 7) {
+            const v = words.slice(3, 7).map(Number);
+            if (v.every(Number.isFinite)) {
+                const [c, m, y, k] = v;
+                rgb = [chan((1 - c) * (1 - k)), chan((1 - m) * (1 - k)), chan((1 - y) * (1 - k))];
+            }
+        }
+        if (rgb === null) {
+            remember(words[0]);
+            return null;
+        }
+        return { svg: '<g fill="rgb(' + rgb.join(",") + ')">' };
+    }
+    return {
+        special(text, at) {
+            const lead = text.match(/^\s*dvisvgm:/);
+            if (lead !== null)
+                return track(dvisvgm(text.slice(lead[0].length), text.trim().split(/\s+/)[0], at));
+            const words = text.trim().split(/\s+/);
+            if (words[0] === "color")
+                return track(color(words));
+            remember(words[0]);
+            return null;
+        },
+        ignored: () => ignoredList.slice(),
+        transformed: () => groups.some((g) => g),
+    };
+}
+//# sourceMappingURL=specials.js.map

package/dist/tex/specials.js.map

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

package/dist/tex/stage.d.ts

@@ -0,0 +1,34 @@
+import type { BackendSettings } from "../worker/protocol.ts";
+import { type BundleSettings } from "./bundles.ts";
+import { type TexEngine } from "./render.ts";
+import { TexTree } from "./vfs.ts";
+/** The loaded engine of the core bundle: the module, the format and the tree of the core files. */
+export interface LoadedCore {
+    engine: TexEngine;
+    format: {
+        name: string;
+        bytes: Uint8Array;
+    };
+    tree: TexTree;
+}
+/**
+ * Loads the core bundle once per process. The loaded value is reused while the pinned hash is the same. When the
+ * parent process gives the files in `settings.texCore`, the worker uses them, reads no bundle file and keeps no copy.
+ */
+export declare function loadCore(settings: BundleSettings & {
+    texCore?: ReadonlyMap<string, Uint8Array>;
+}): Promise<LoadedCore>;
+/**
+ * Makes a standalone document from a TikZ source. A source with a `\documentclass` is a document: the function only adds
+ * the class option `dvisvgm`, which selects the DVI driver of the format. Any other source is the body: the function
+ * adds the `standalone` class, one `\usepackage` line for each detected package that the format does not hold, and the
+ * `document` environment.
+ */
+export declare function wrapSource(source: string, packages: readonly string[]): string;
+/** What a tikz render gives: the SVG text and the warnings. */
+export interface TikzSvg {
+    svg: string;
+    warnings: string[];
+}
+/** Renders one tikz source to SVG: detects the bundles, loads them, wraps the source and runs the engine. */
+export declare function renderTikzSvg(source: string, options: Record<string, unknown>, settings: Pick<BackendSettings, "cacheDir" | "texBundleUrl" | "allowNetwork" | "timeoutMs" | "texCore">): Promise<TikzSvg>;

package/dist/tex/stage.js

@@ -0,0 +1,102 @@
+import { RenderError } from "../errors.js";
+import { findBundle, loadBundleBytes, loadBundles, unpackBundle } from "./bundles.js";
+import { detectBundles } from "./detect.js";
+import { renderTex } from "./render.js";
+import { TexTree } from "./vfs.js";
+/** The packages that the format holds. A wrapped source does not load them again. */
+const FORMAT_PACKAGES = new Set(["tikz", "pgf", "xcolor", "circuitikz", "standalone"]);
+let loadedCore;
+/** The names in the core bundle that are the engine, not tree files. */
+const ENGINE_FILES = new Set(["engine.wasm", "engine.symbols.json", "tex.pool", "scieng.fmt"]);
+async function wasmModule(bytes) {
+    const api = globalThis.WebAssembly;
+    return api.compile(bytes);
+}
+/**
+ * Loads the core bundle once per process. The loaded value is reused while the pinned hash is the same. When the
+ * parent process gives the files in `settings.texCore`, the worker uses them, reads no bundle file and keeps no copy.
+ */
+export async function loadCore(settings) {
+    if (settings.texCore !== undefined)
+        return coreOf(settings.texCore);
+    const entry = findBundle("core");
+    if (loadedCore?.sha256 === entry.sha256)
+        return loadedCore.value;
+    const value = await coreOf(unpackBundle(await loadBundleBytes(entry, settings)));
+    loadedCore = { sha256: entry.sha256, value };
+    return value;
+}
+/** Builds the loaded core from the files of the core bundle. */
+async function coreOf(files) {
+    const need = (name) => {
+        const f = files.get(name);
+        if (f === undefined)
+            throw new RenderError("E_INTEGRITY", `the core TeX bundle has no file ${name}`);
+        return f;
+    };
+    const tree = new TexTree();
+    for (const [name, bytes] of files)
+        if (!ENGINE_FILES.has(name))
+            tree.add(name, bytes);
+    const value = {
+        engine: {
+            module: await wasmModule(need("engine.wasm")),
+            symbols: JSON.parse(new TextDecoder().decode(need("engine.symbols.json"))),
+            pool: need("tex.pool"),
+        },
+        format: { name: "scieng.fmt", bytes: need("scieng.fmt") },
+        tree,
+    };
+    return value;
+}
+/**
+ * Makes a standalone document from a TikZ source. A source with a `\documentclass` is a document: the function only adds
+ * the class option `dvisvgm`, which selects the DVI driver of the format. Any other source is the body: the function
+ * adds the `standalone` class, one `\usepackage` line for each detected package that the format does not hold, and the
+ * `document` environment.
+ */
+export function wrapSource(source, packages) {
+    if (/\\documentclass\b/.test(source)) {
+        return source.replace(/\\documentclass(?:\[([^\]]*)\])?/, (_m, opts) => {
+            const list = (opts ?? "").split(",").map((s) => s.trim()).filter((s) => s !== "");
+            return `\\documentclass[${[...new Set([...list, "dvisvgm"])].join(",")}]`;
+        });
+    }
+    const uses = packages.filter((p) => !FORMAT_PACKAGES.has(p)).map((p) => `\\usepackage{${p}}\n`);
+    return `\\documentclass[dvisvgm]{standalone}\n${uses.join("")}\\begin{document}\n${source}\n\\end{document}\n`;
+}
+/** Renders one tikz source to SVG: detects the bundles, loads them, wraps the source and runs the engine. */
+export async function renderTikzSvg(source, options, settings) {
+    const detected = detectBundles(source);
+    const bundleSettings = {
+        cacheDir: settings.cacheDir,
+        texBundleUrl: settings.texBundleUrl,
+        allowNetwork: settings.allowNetwork,
+        timeoutMs: settings.timeoutMs,
+    };
+    const base = await loadCore({ ...bundleSettings, ...(settings.texCore === undefined ? {} : { texCore: settings.texCore }) });
+    const extra = detected.bundles.filter((b) => b !== "core");
+    const tree = base.tree.fork();
+    for (const files of (await loadBundles(extra, bundleSettings)).values()) {
+        for (const [name, bytes] of files)
+            tree.add(name, bytes);
+    }
+    const margin = options.margin;
+    if (margin !== undefined && (typeof margin !== "number" || !Number.isFinite(margin) || margin < 0)) {
+        throw new RenderError("E_INPUT", "option margin must be a number that is zero or more");
+    }
+    const result = await renderTex({
+        engine: base.engine,
+        format: base.format,
+        tree,
+        source: wrapSource(source, detected.packages),
+        jobName: "job",
+        timeoutMs: settings.timeoutMs,
+        ...(margin === undefined ? {} : { margin }),
+    });
+    const warnings = [];
+    if (result.missing.length > 0)
+        warnings.push(`${result.missing.length} glyph(s) have no outline in the bundled fonts`);
+    return { svg: result.svg, warnings };
+}
+//# sourceMappingURL=stage.js.map

package/dist/tex/stage.js.map

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

package/dist/tex/tfm.d.ts

@@ -0,0 +1,15 @@
+/** The data of a TFM file that the DVI converter uses. */
+export interface Tfm {
+    /** The design size in points. */
+    designSize: number;
+    /** The checksum word of the font. */
+    checksum: number;
+    /** The width of each character that exists, in design-size units. */
+    widths: Map<number, number>;
+}
+/**
+ * Reads the character widths and the design size of a TFM file.
+ * The format is the one of `tftopl.web`. A width is a fix_word, which is a multiple of 2^-20.
+ * A header that does not fit the file, or a width index outside the table, throws an error.
+ */
+export declare function readTfm(bytes: Uint8Array): Tfm;

package/dist/tex/tfm.js

@@ -0,0 +1,33 @@
+/**
+ * Reads the character widths and the design size of a TFM file.
+ * The format is the one of `tftopl.web`. A width is a fix_word, which is a multiple of 2^-20.
+ * A header that does not fit the file, or a width index outside the table, throws an error.
+ */
+export function readTfm(bytes) {
+    const d = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    if (bytes.length < 24)
+        throw new Error("bad TFM header");
+    const half = (i) => d.getUint16(2 * i, false);
+    const lf = half(0);
+    const lh = half(1);
+    const bc = half(2);
+    const ec = half(3);
+    const nw = half(4);
+    if (lf * 4 > bytes.length || bc > ec + 1 || ec > 255)
+        throw new Error("bad TFM header");
+    const word = (i) => d.getUint32(4 * i, false);
+    const fix = (i) => d.getInt32(4 * i, false) / 2 ** 20;
+    const charBase = 6 + lh;
+    const widthBase = charBase + (ec - bc + 1);
+    const widths = new Map();
+    for (let c = bc; c <= ec; c++) {
+        const widthIndex = word(charBase + c - bc) >>> 24;
+        if (widthIndex === 0)
+            continue;
+        if (widthIndex >= nw)
+            throw new Error("bad width index");
+        widths.set(c, fix(widthBase + widthIndex));
+    }
+    return { designSize: fix(7), checksum: word(6), widths };
+}
+//# sourceMappingURL=tfm.js.map

package/dist/tex/tfm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tfm.js","sourceRoot":"","sources":["../../src/tex/tfm.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,KAAiB;IACvC,MAAM,CAAC,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACzE,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9D,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,IAAI,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACxF,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IACtE,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,CAAC;IACxB,MAAM,SAAS,GAAG,QAAQ,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;QAClD,IAAI,UAAU,KAAK,CAAC;YAAE,SAAS;QAC/B,IAAI,UAAU,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;AAC3D,CAAC"}

package/dist/tex/type1.d.ts

@@ -0,0 +1,32 @@
+/** The outline and the metrics of one glyph. */
+export interface Type1Glyph {
+    /** The glyph name. */
+    name: string;
+    /** The advance width in font units. */
+    advance: number;
+    /** The SVG path data, in font units with the y axis up. Empty for a glyph with no outline. */
+    d: string;
+    /** The box `[minX, minY, maxX, maxY]` of the outline and its control points. */
+    bbox: [number, number, number, number];
+}
+/** A Type 1 font after reading. */
+export interface Type1Font {
+    fontName: string;
+    fontBBox: number[];
+    fontMatrix: number[];
+    /** The glyph name of each character code. */
+    encoding: (string | undefined)[];
+    /** The glyph of a character code, or `null` when the code has no glyph. */
+    glyph(code: number): Type1Glyph | null;
+}
+/**
+ * Decrypts Type 1 data with the cipher of the font format: `c1 = 52845`, `c2 = 22719`.
+ * Use `r = 55665` for the eexec section and `r = 4330` for a charstring.
+ * The function drops the first `skip` plain bytes, which are the random lead bytes.
+ */
+export declare function decryptType1(b: Uint8Array, r: number, skip: number): Uint8Array;
+/**
+ * Reads a Type 1 font from the bytes of a PFB or PFA file. The function decrypts the private part at once.
+ * It runs the charstring of a glyph on the first request for it and keeps the result.
+ */
+export declare function readType1(pfb: Uint8Array): Type1Font;