@danielsimonjr/sciengjs 0.3.2 → 0.5.0

package/dist/math/tex.js

@@ -0,0 +1,130 @@
+import { liteAdaptor } from "@mathjax/src/js/adaptors/liteAdaptor.js";
+import { RegisterHTMLHandler } from "@mathjax/src/js/handlers/html.js";
+import { mathjax } from "@mathjax/src/js/mathjax.js";
+import { TeX } from "@mathjax/src/js/input/tex.js";
+import { SVG } from "@mathjax/src/js/output/svg.js";
+import "@mathjax/src/js/input/tex/base/BaseConfiguration.js";
+import "@mathjax/src/js/input/tex/ams/AmsConfiguration.js";
+import "@mathjax/src/js/input/tex/boldsymbol/BoldsymbolConfiguration.js";
+import "@mathjax/src/js/input/tex/color/ColorConfiguration.js";
+import "@mathjax/src/js/input/tex/mhchem/MhchemConfiguration.js";
+import { RenderError } from "../errors.js";
+import { defineMhchemVariant, loadFontRanges } from "./font-ranges.js";
+/** The TeX packages that this build holds. Each one is imported above; no other package loads. */
+export const MATH_PACKAGES = ["base", "ams", "boldsymbol", "color", "mhchem"];
+/** Pixels per MathJax ex unit. MathJax reports sizes in ex; the SVG attributes state pixels. */
+const EX_PX = 8;
+/** Matches one `\require{...}` command and captures its package list. */
+const REQUIRE = /\\require\s*\{([^}]*)\}/g;
+/**
+ * Removes each `\require{...}` command from the source and returns the rest. The build loads every
+ * held package before the render and holds no require package, so a `\require` of held packages is a
+ * no-op. A `\require` of a package that this build does not hold rejects with E_UNSUPPORTED and names
+ * the package. MathJax never fetches a package.
+ */
+export function stripRequires(source) {
+    for (const match of source.matchAll(REQUIRE)) {
+        for (const raw of match[1].split(",")) {
+            const name = raw.trim();
+            if (name !== "" && !MATH_PACKAGES.includes(name)) {
+                throw new RenderError("E_UNSUPPORTED", `the math stage does not hold the package ${name}`);
+            }
+        }
+    }
+    return source.replace(REQUIRE, "");
+}
+/** The five named XML entities, by name. */
+const XML_ENTITIES = { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" };
+/** Decodes the numeric and the five named XML entities of a text. */
+function decodeXml(text) {
+    return text.replace(/&(?:#x([0-9A-Fa-f]+)|#(\d+)|(amp|lt|gt|quot|apos));/g, (whole, hex, dec, name) => {
+        if (hex !== undefined)
+            return String.fromCodePoint(parseInt(hex, 16));
+        if (dec !== undefined)
+            return String.fromCodePoint(parseInt(dec, 10));
+        return XML_ENTITIES[name] ?? whole;
+    });
+}
+/**
+ * Rejects an SVG that draws a character as system-font text. MathJax writes a `<text>` element with a
+ * `font-family` when the math font holds no glyph for a character. Such output depends on the fonts of
+ * the viewer, and the PNG stage has no font. The error names each such character and its code point.
+ */
+export function rejectFontFallback(svg) {
+    if (!svg.includes("<text") && !svg.includes("font-family"))
+        return;
+    const chars = new Set();
+    for (const match of svg.matchAll(/<text\b[^>]*>([^<]*)<\/text>/g)) {
+        for (const ch of decodeXml(match[1]))
+            chars.add(ch);
+    }
+    if (chars.size === 0) {
+        throw new RenderError("E_UNSUPPORTED", "the math svg uses a system font");
+    }
+    const names = [...chars].map((ch) => `${ch} (U+${ch.codePointAt(0).toString(16).toUpperCase().padStart(4, "0")})`);
+    throw new RenderError("E_UNSUPPORTED", `the math font holds no glyph for ${names.join(", ")}`);
+}
+/** Converts a MathJax size string such as "2.5ex" to pixels, rounded to 3 decimals. */
+export function exToPx(value) {
+    const match = /^(-?[\d.]+)ex$/.exec(value);
+    if (match === null) {
+        throw new RenderError("E_INTERNAL", `unexpected MathJax size: ${value}`);
+    }
+    return String(Math.round(Number(match[1]) * EX_PX * 1000) / 1000);
+}
+/**
+ * Keeps the `<svg>` element of a MathJax container and sets the standalone attributes:
+ * the SVG namespace, the sizes in px and the viewBox. Only the SVG element leaves this function,
+ * so the assistive MathML of the container is removed.
+ */
+export function standaloneSvg(container) {
+    const start = container.indexOf("<svg");
+    const end = container.lastIndexOf("</svg>");
+    if (start === -1 || end === -1) {
+        throw new RenderError("E_INTERNAL", "MathJax produced no svg element");
+    }
+    const element = container.slice(start, end + "</svg>".length);
+    const open = /^<svg([^>]*)>/.exec(element);
+    if (open === null) {
+        throw new RenderError("E_INTERNAL", "MathJax produced a malformed svg element");
+    }
+    const attrs = open[1];
+    const width = /\swidth="([^"]+)"/.exec(attrs)?.[1];
+    const height = /\sheight="([^"]+)"/.exec(attrs)?.[1];
+    const viewBox = /\sviewBox="([^"]+)"/.exec(attrs)?.[1];
+    if (width === undefined || height === undefined || viewBox === undefined) {
+        throw new RenderError("E_INTERNAL", "MathJax svg has no width, height or viewBox");
+    }
+    const head = `<svg xmlns="http://www.w3.org/2000/svg" width="${exToPx(width)}px" height="${exToPx(height)}px" viewBox="${viewBox}"`;
+    return head + element.slice(open[0].length - 1);
+}
+/**
+ * Renders LaTeX math to a standalone SVG with the glyphs as paths. The XML serializer escapes `<`, `>`,
+ * `&` and `"` in the attribute values, so the TeX source in the data-latex attributes keeps the SVG
+ * well-formed. Rejects with E_INPUT or E_UNSUPPORTED.
+ */
+export async function mathToSvg(source, options) {
+    const tex = stripRequires(source);
+    const adaptor = liteAdaptor();
+    RegisterHTMLHandler(adaptor);
+    let inputError;
+    const input = new TeX({
+        packages: [...MATH_PACKAGES],
+        formatError: (jax, err) => {
+            inputError ??= err.message;
+            return jax.formatError(err);
+        },
+    });
+    const output = new SVG({ fontCache: "none" });
+    loadFontRanges(output.font);
+    defineMhchemVariant(output.font);
+    const doc = mathjax.document("", { InputJax: input, OutputJax: output });
+    const node = doc.convert(tex, { display: options.display });
+    if (inputError !== undefined) {
+        throw new RenderError("E_INPUT", `TeX input error: ${inputError}`);
+    }
+    const svg = standaloneSvg(adaptor.serializeXML(node));
+    rejectFontFallback(svg);
+    return svg;
+}
+//# sourceMappingURL=tex.js.map

package/dist/math/tex.js.map

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

package/dist/plot/backend-html.d.ts

@@ -0,0 +1,3 @@
+import type { BackendOutput, WorkerJob } from "../worker/protocol.ts";
+/** Renders plot to html: one standalone page that loads the pinned Plotly build and draws the figure. The page title is the figure title, or "plot". */
+export declare function render(request: WorkerJob["request"]): Promise<BackendOutput>;

package/dist/plot/backend-html.js

@@ -0,0 +1,13 @@
+import { plotlyPageHtml } from "../browser/page.js";
+import { PLOTLY_CDN_URL, PLOTLY_SRI } from "../browser/pinned.js";
+import { readPlotOptions } from "./backend-svg.js";
+import { readPlotFigure } from "./reader.js";
+/** Renders plot to html: one standalone page that loads the pinned Plotly build and draws the figure. The page title is the figure title, or "plot". */
+export async function render(request) {
+    const { lenient } = readPlotOptions(request.options, ["lenient"]);
+    const { figure, warnings } = readPlotFigure(String(request.source), { lenient });
+    const title = figure.layout.title?.text;
+    const html = plotlyPageHtml(figure, PLOTLY_CDN_URL, PLOTLY_SRI, typeof title === "string" && title !== "" ? title : "plot");
+    return { bytes: new TextEncoder().encode(html), warnings };
+}
+//# sourceMappingURL=backend-html.js.map

package/dist/plot/backend-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-html.js","sourceRoot":"","sources":["../../src/plot/backend-html.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,wJAAwJ;AACxJ,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAA6B;IACxD,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAClE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACjF,MAAM,KAAK,GAAI,MAAM,CAAC,MAAM,CAAC,KAAwC,EAAE,IAAI,CAAC;IAC5E,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5H,OAAO,EAAE,KAAK,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;AAC7D,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { BackendOutput, WorkerJob } from "../worker/protocol.ts";
+/** Renders plot to png: the SVG of the figure, then the PNG of that SVG at the option scale. */
+export declare function render(request: WorkerJob["request"]): Promise<BackendOutput>;

package/dist/plot/backend-png.js

@@ -0,0 +1,12 @@
+import { readScale, svgDocumentToPng } from "../graph/backend-png.js";
+import { plotToSvg } from "./plotter.js";
+import { readPlotOptions } from "./backend-svg.js";
+/** Renders plot to png: the SVG of the figure, then the PNG of that SVG at the option scale. */
+export async function render(request) {
+    const { lenient } = readPlotOptions(request.options, ["lenient", "scale"]);
+    const scale = readScale(request.options);
+    const result = plotToSvg(String(request.source), { lenient });
+    const png = await svgDocumentToPng(result.svg, request, scale);
+    return { bytes: png.bytes, warnings: [...result.warnings, ...(png.warnings ?? [])] };
+}
+//# sourceMappingURL=backend-png.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backend-png.js","sourceRoot":"","sources":["../../src/plot/backend-png.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAA6B;IACxD,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/D,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;AACvF,CAAC"}

package/dist/plot/backend-svg.d.ts

@@ -0,0 +1,7 @@
+import type { BackendOutput, WorkerJob } from "../worker/protocol.ts";
+/** Reads the plot options. The only key is lenient, a boolean. Any other key rejects with E_INPUT. */
+export declare function readPlotOptions(options: Record<string, unknown>, allowed: readonly string[]): {
+    lenient: boolean;
+};
+/** Renders plot to svg. The options are lenient only. */
+export declare function render(request: WorkerJob["request"]): Promise<BackendOutput>;

package/dist/plot/backend-svg.js

@@ -0,0 +1,21 @@
+import { RenderError } from "../errors.js";
+import { plotToSvg } from "./plotter.js";
+/** Reads the plot options. The only key is lenient, a boolean. Any other key rejects with E_INPUT. */
+export function readPlotOptions(options, allowed) {
+    for (const key of Object.keys(options)) {
+        if (!allowed.includes(key))
+            throw new RenderError("E_INPUT", "plot takes no option " + key);
+    }
+    const lenient = options.lenient;
+    if (lenient !== undefined && typeof lenient !== "boolean") {
+        throw new RenderError("E_INPUT", "option lenient must be true or false");
+    }
+    return { lenient: lenient === true };
+}
+/** Renders plot to svg. The options are lenient only. */
+export async function render(request) {
+    const { lenient } = readPlotOptions(request.options, ["lenient"]);
+    const result = plotToSvg(String(request.source), { lenient });
+    return { bytes: new TextEncoder().encode(result.svg), warnings: result.warnings };
+}
+//# sourceMappingURL=backend-svg.js.map

package/dist/plot/backend-svg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-svg.js","sourceRoot":"","sources":["../../src/plot/backend-svg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,sGAAsG;AACtG,MAAM,UAAU,eAAe,CAAC,OAAgC,EAAE,OAA0B;IAC1F,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,uBAAuB,GAAG,GAAG,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1D,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,sCAAsC,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;AACvC,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAA6B;IACxD,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9D,OAAO,EAAE,KAAK,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;AACpF,CAAC"}

package/dist/plot/control.d.ts

@@ -0,0 +1,93 @@
+/** A transfer function G(s) = num(s) / den(s). Coefficients are in descending powers of s. */
+export interface TransferFunction {
+    num: number[];
+    den: number[];
+}
+/** A complex number. */
+export interface Complex {
+    re: number;
+    im: number;
+}
+/** The Plotly subset that the plotter reads. */
+export interface ControlFigure {
+    data: Array<Record<string, unknown>>;
+    layout: Record<string, unknown>;
+}
+/** A figure plus the numbers that the analysis derived from the same model. */
+export interface ControlResult<N> {
+    figure: ControlFigure;
+    numbers: N;
+}
+/** Options for the frequency helpers: the grid from wMin to wMax, in rad/s, with points samples. */
+export interface FrequencyOptions {
+    wMin?: number;
+    wMax?: number;
+    points?: number;
+}
+/** Options for the time helpers: the end time tEnd and the number of points. */
+export interface TimeOptions {
+    tEnd?: number;
+    points?: number;
+}
+/** Options for rootLocus: the largest gain kMax and the number of points. */
+export interface RootLocusOptions {
+    kMax?: number;
+    points?: number;
+}
+/** Key values of a Bode plot: crossover frequencies in rad/s, margins in degrees. A null value means none was found. */
+export interface BodeNumbers {
+    gainCrossover: number | null;
+    phaseCrossover: number | null;
+    gainMargin: number | null;
+    phaseMargin: number | null;
+}
+/**
+ * Key values of a step response: final value, rise and settling times, overshoot in percent, and peak time.
+ * The peak and the overshoot are measured in the direction of the final value. A system with a pole on or
+ * right of the imaginary axis has no final value, so every number is null. A response with no peak before
+ * the end of the time grid has a null peak time and an overshoot of 0.
+ */
+export interface StepNumbers {
+    finalValue: number | null;
+    riseTime: number | null;
+    settlingTime: number | null;
+    overshoot: number | null;
+    peakTime: number | null;
+}
+/** Key values of an impulse response: the peak value and the time of the peak. */
+export interface ImpulseNumbers {
+    peak: number;
+    peakTime: number;
+}
+/** The poles and the zeros of a transfer function, as complex numbers. */
+export interface PoleZeroNumbers {
+    poles: Complex[];
+    zeros: Complex[];
+}
+/** The least distance from the Nyquist curve to the point -1. */
+export interface NyquistNumbers {
+    minDistanceToMinusOne: number;
+}
+/** The breakaway points of the root locus, each with its gain k. */
+export interface RootLocusNumbers {
+    breakawayPoints: Array<{
+        re: number;
+        k: number;
+    }>;
+}
+/** Validates a transfer function. Rejects with E_INPUT: empty, non-finite, leading-zero den, or improper. */
+export declare function checkTransferFunction(input: unknown): TransferFunction;
+/** The roots of a polynomial with descending coefficients. Each trailing zero coefficient gives an exact root at 0; Durand-Kerner finds the others. No convergence rejects with E_INPUT. */
+export declare function polynomialRoots(coeffs: number[]): Complex[];
+/** Bode plot. Crossovers and margins are null where no crossing exists. */
+export declare function bode(input: unknown, options?: FrequencyOptions): ControlResult<BodeNumbers>;
+/** Step response by exact zero-order-hold simulation. finalValue is the DC gain, null for a system that is not stable. */
+export declare function step(input: unknown, options?: TimeOptions): ControlResult<StepNumbers>;
+/** Impulse response of the strictly proper part, C e^(At) B for t > 0. A direct feedthrough term is not plotted. */
+export declare function impulse(input: unknown, options?: TimeOptions): ControlResult<ImpulseNumbers>;
+/** Pole-zero map: poles as crosses, zeros as circles. */
+export declare function poleZero(input: unknown): ControlResult<PoleZeroNumbers>;
+/** Nyquist plot of G(j omega) for negative and positive frequencies, with the critical point -1. */
+export declare function nyquist(input: unknown, options?: FrequencyOptions): ControlResult<NyquistNumbers>;
+/** Root locus of den + K num = 0 for K from 0 to kMax, with breakaway points on the real axis. */
+export declare function rootLocus(input: unknown, options?: RootLocusOptions): ControlResult<RootLocusNumbers>;