rapier-math 1.0.2 → 1.1.1

package/docs/math-resources.json

@@ -0,0 +1,290 @@
+{
+  "bundle": "rapier-math-1.1.1.js",
+  "packageBundle": "dist/rapier-math.js",
+  "version": "1.1.1",
+  "license": "MIT AND LicenseRef-GUST-Font-License",
+  "bytes": 714051,
+  "gzipBytes": 442525,
+  "sha256": "050f4ebfb7c78beaefb01c9d6aa62192fd03757fc677134850bdb1f090033b81",
+  "sha384": "FnVbul5Kp18nd2S1SdMQlMPJtulZiY5ZqrRtJ8APYoP6reF9w0JRjF/qrmH9l9s0",
+  "sources": [
+    {
+      "file": "math/font.js",
+      "packageFile": "src/math/font.js",
+      "bytes": 558719,
+      "sha256": "1263135501cb049efb087975db43c0fa6d131e5deee4282d982995d4ab0884c4"
+    },
+    {
+      "file": "math/symbols.js",
+      "packageFile": "src/math/symbols.js",
+      "bytes": 8415,
+      "sha256": "80f485e8023afe3783d30c4616709e0a3b0ed0ba8a238bd818085cdd107f03ad"
+    },
+    {
+      "file": "math/parser.js",
+      "packageFile": "src/math/parser.js",
+      "bytes": 69355,
+      "sha256": "067594e1b1391a7c29b71ff51e0e812f16785e14a863dbc04069627760435633"
+    },
+    {
+      "file": "math/layout.js",
+      "packageFile": "src/math/layout.js",
+      "bytes": 37632,
+      "sha256": "84f0abeb24907f370754e30e5cf0576cb2346b941815494c9958892f3d1cc939"
+    },
+    {
+      "file": "math/fallbacks.js",
+      "packageFile": "src/math/fallbacks.js",
+      "bytes": 7953,
+      "sha256": "400c5771756d5a4d4cf431d471b33c280791ce4aa276a0fd2615d91ee88ae8ce"
+    },
+    {
+      "file": "math/responsive.js",
+      "packageFile": "src/math/responsive.js",
+      "bytes": 13566,
+      "sha256": "387e2952317ba8124bd7f56a71feb9555f3cb6081de687d79eb4c9e6cab4b6ed"
+    },
+    {
+      "file": "math/browser.js",
+      "packageFile": "src/math/browser.js",
+      "bytes": 10048,
+      "sha256": "5a9b1ee1b8c55a5560058b0fcfb5d6623f7de74e49bcb4281acdf7c97b235101"
+    },
+    {
+      "file": "math/api.js",
+      "packageFile": "src/math/api.js",
+      "bytes": 7245,
+      "sha256": "0ad779d91a760c5dd908caf8f037df8b6db82d69cefab42bd8b5493d68f30b4e"
+    }
+  ],
+  "recipe": [
+    {
+      "file": "math/build-font.py",
+      "packageFile": "src/math/build-font.py",
+      "bytes": 33369,
+      "sha256": "d54dba7b83d945da4bdeeac6a262c45d0b8f531c0801114451ac3f3d8dab9d35"
+    },
+    {
+      "file": "math/FONT-SOURCE.md",
+      "packageFile": "docs/font-source.md",
+      "bytes": 10357,
+      "sha256": "84ab319b1f9342fa08b421231965dd685063d8fd6bb8a071e1f1c186848dcdd9"
+    },
+    {
+      "file": "math/FONT-LICENSE.txt",
+      "packageFile": "src/math/FONT-LICENSE.txt",
+      "bytes": 21246,
+      "sha256": "91ded9a2a371cbeff028bfaf3bd3e97fddfb68af6f186aa261bfaff35baf800c"
+    },
+    {
+      "file": "math/package-verify.mjs",
+      "packageFile": "tests/verify.mjs",
+      "bytes": 2972,
+      "sha256": "bb28e7ea37021ea191bd858a18beb97bb8ca14b52015dfe1e49d7d07dea60b48"
+    },
+    {
+      "file": "tools/build-math.mjs",
+      "packageFile": "src/tools/build-math.mjs",
+      "bytes": 8668,
+      "sha256": "06c6d4f0d56de87b8869bf04433b7ff8cea6f7f19e4dc7ea6a2e21279f9cb50e"
+    },
+    {
+      "file": "math/LICENSE-MIT",
+      "packageFile": "src/math/LICENSE-MIT",
+      "bytes": 1071,
+      "sha256": "a3bc5d619ab9159f4eef2924e48dfb935556f4bc163f5ea61610b66a5915de70"
+    },
+    {
+      "file": "math/adoption-verify.mjs",
+      "packageFile": "tests/adoption.mjs",
+      "bytes": 8254,
+      "sha256": "15179557c7d1bdd76ae7a06956f8be65b375f7f187940e5227baa0d4930b3b63"
+    },
+    {
+      "file": "math/package-build.mjs",
+      "packageFile": "src/math/package-build.mjs",
+      "bytes": 989,
+      "sha256": "9cbe11960f0190375c3d086e731078aab5acaaf8a5a77f83f3395ff3ba0291de"
+    },
+    {
+      "file": "math/package-layout.mjs",
+      "packageFile": "src/math/package-layout.mjs",
+      "bytes": 681,
+      "sha256": "a8f5bfe84dde4745c7c6fbfffa7b80766d39ec1adf727c2de59be9596711b320"
+    },
+    {
+      "file": "math/package-check.mjs",
+      "packageFile": "tests/check.mjs",
+      "bytes": 7455,
+      "sha256": "4df4f81251c66473a2ea491072364c68761da7313fff36a19e82e3313220ce26"
+    },
+    {
+      "file": "math/package-readme.mjs",
+      "packageFile": "src/math/package-readme.mjs",
+      "bytes": 1853,
+      "sha256": "9408728370c81d463794ef67380c587748ed1b1633b56b1d1a2b33d9a95b3986"
+    },
+    {
+      "file": "math/README.md",
+      "packageFile": "docs/api.md",
+      "bytes": 14103,
+      "sha256": "83368017d04a50a3d13e6e2e070322a5eef4bf8f54f521bd7ff061e186afc3f5"
+    }
+  ],
+  "components": [
+    {
+      "name": "Latin Modern Math",
+      "version": "1.959",
+      "license": "LicenseRef-GUST-Font-License",
+      "source": "https://mirror.apps.cam.ac.uk/pub/tex-archive/fonts/lm-math/opentype/latinmodern-math.otf",
+      "sha256": "6075562b771f8b82f0c179e363389684f2dd09de30038269e2628e504bd7be0f"
+    }
+  ],
+  "font": {
+    "name": "Latin Modern Math",
+    "version": "1.959",
+    "license": "LicenseRef-GUST-Font-License",
+    "licenseName": "GUST Font License",
+    "source": "https://mirror.apps.cam.ac.uk/pub/tex-archive/fonts/lm-math/opentype/latinmodern-math.otf",
+    "sourceSha256": "6075562b771f8b82f0c179e363389684f2dd09de30038269e2628e504bd7be0f",
+    "copyright": "Copyright 2012--2014 for Latin Modern Math OTF by B. Jackowski, P. Strzelczyk and P. Pianowski (on behalf of TeX users groups). This work is released under the GUST Font License -- see http://tug.org/fonts/licenses/GUST-FONT-LICENSE.txt for details.",
+    "licenseSource": "https://mirror.apps.cam.ac.uk/pub/tex-archive/fonts/lm-math/doc/GUST-FONT-LICENSE.txt",
+    "licenseFile": "math/FONT-LICENSE.txt",
+    "licenseSha256": "91ded9a2a371cbeff028bfaf3bd3e97fddfb68af6f186aa261bfaff35baf800c",
+    "licenseBytes": 21246
+  },
+  "adoption": [
+    {
+      "file": "math/delimiters.mjs",
+      "packageFile": "dist/delimiters.mjs",
+      "bytes": 1945,
+      "sha256": "2847d23ba78534b32348d5e642ded601e4f6fd9c41e10d80c46955d440d24eba"
+    },
+    {
+      "file": "math/markdown-rules.mjs",
+      "packageFile": "dist/markdown-rules.mjs",
+      "bytes": 3255,
+      "sha256": "3c2c1660f669eac88fbee4259e83f9227ed651e2e4bb228a861c5a1d8518f6a7"
+    },
+    {
+      "file": "math/integration.mjs",
+      "packageFile": "dist/integration.mjs",
+      "bytes": 1493,
+      "sha256": "5bd61aa59e78cbab37219b9a569f3b5ad9c5a7723800abc7f3fe7af6b82ae7a6"
+    },
+    {
+      "file": "math/markdown-it.mjs",
+      "packageFile": "dist/markdown-it.mjs",
+      "bytes": 2113,
+      "sha256": "d57abc5dc3e5a31b6be4507b2f5c57df8431763b8d88feaadbf242cb09af6c9d"
+    },
+    {
+      "file": "math/rehype.mjs",
+      "packageFile": "dist/rehype.mjs",
+      "bytes": 2017,
+      "sha256": "7cc9c9d2e7c9b9667368cfc1a5a4f5f86d218b7c8a1acb8d2e12334d41e83bc8"
+    },
+    {
+      "file": "math/stream.mjs",
+      "packageFile": "dist/stream.mjs",
+      "bytes": 2530,
+      "sha256": "2b26a895e531906be931af6f9f3764297d1ff98bf56875e9df457f82938fc03d"
+    },
+    {
+      "file": "math/index.d.ts",
+      "packageFile": "dist/index.d.ts",
+      "bytes": 1698,
+      "sha256": "bc14a284cd5caffdf5bfe6825c49c360d313e693bbc0280aa924fd9fc594beb3"
+    },
+    {
+      "file": "math/classic.d.ts",
+      "packageFile": "dist/classic.d.ts",
+      "bytes": 123,
+      "sha256": "dfc82014f54ed7364171cb73cc8bc118aba4a5929349f762da82988977f1593d"
+    },
+    {
+      "file": "math/delimiters.d.ts",
+      "packageFile": "dist/delimiters.d.ts",
+      "bytes": 479,
+      "sha256": "db74cfb4fdd6d87e7f47a5de8ee3a4b78f409a4fe3cd2edeaa8e77660a489617"
+    },
+    {
+      "file": "math/integration.d.ts",
+      "packageFile": "dist/integration.d.ts",
+      "bytes": 370,
+      "sha256": "4b3c53b01b34de3b328ef609e65aa3aa530fabc3522238bde335cb8c839cdda3"
+    },
+    {
+      "file": "math/markdown-it.d.ts",
+      "packageFile": "dist/markdown-it.d.ts",
+      "bytes": 383,
+      "sha256": "bafce277328ba397bddbbb5101cc2545ba8b8c15830b47f2dc1f05af85de4b1d"
+    },
+    {
+      "file": "math/rehype.d.ts",
+      "packageFile": "dist/rehype.d.ts",
+      "bytes": 340,
+      "sha256": "8f6b230284e64fb483d1ed2c6ed9420958cf1d7e609f71aee62322cabe56339b"
+    },
+    {
+      "file": "math/stream.d.ts",
+      "packageFile": "dist/stream.d.ts",
+      "bytes": 630,
+      "sha256": "1b12bc176fdd243db75d247ff4dbb9b4787945167a033154a0d222ad68da4ff0"
+    },
+    {
+      "file": "math/examples/formula.mjs",
+      "packageFile": "examples/formula.mjs",
+      "bytes": 619,
+      "sha256": "43e3708d50737d1eac74f5132146838b58b733c5b0315b50d6eecd594ecb9e7d"
+    },
+    {
+      "file": "math/examples/markdown.mjs",
+      "packageFile": "examples/markdown.mjs",
+      "bytes": 375,
+      "sha256": "6dc4789538861d478f9afba403574b3f88928db4e9d4e4def88db87af8561641"
+    },
+    {
+      "file": "math/examples/stream.mjs",
+      "packageFile": "examples/stream.mjs",
+      "bytes": 841,
+      "sha256": "4b1feb25d38024a6f8531bb3353d0eea993628dcd1f97e736d42c9e076ec655b"
+    },
+    {
+      "file": "math/examples/unified.mjs",
+      "packageFile": "examples/unified.mjs",
+      "bytes": 1103,
+      "sha256": "9002f3f1f7cbbec2f8f9a4b3cdbde2f418fece7b8395e942441448b7f785ee9b"
+    },
+    {
+      "file": "math/examples/browser.html",
+      "packageFile": "examples/browser.html",
+      "bytes": 566,
+      "sha256": "c671541b4a3f1a4cb9e2b2ef2945778db825590f08a11ad48b768d132b5df96f"
+    },
+    {
+      "file": "math/examples/browser.mjs",
+      "packageFile": "examples/browser.mjs",
+      "bytes": 945,
+      "sha256": "569e66078bce60debc6aeb4d70efa3fdc67eabdf9b349822f1a7117a28311235"
+    },
+    {
+      "file": "math/examples/react.tsx",
+      "packageFile": "examples/react.tsx",
+      "bytes": 899,
+      "sha256": "bfcbeb5219ce776a9c33f841c0aad222be9b6ceddffe0eb89f344bed170e0765"
+    },
+    {
+      "file": "math/examples/worker.mjs",
+      "packageFile": "examples/worker.mjs",
+      "bytes": 370,
+      "sha256": "1e9de25f8b636d14d065b0d2b2febbeeed9600fc595a12c09f94ba58f3791de6"
+    },
+    {
+      "file": "math/examples/README.md",
+      "packageFile": "examples/README.md",
+      "bytes": 1858,
+      "sha256": "c462b51cae9435336debca87e7e6407400ff06df3126ac8aeb4becc091cd31bf"
+    }
+  ]
+}

package/examples/README.md

@@ -0,0 +1,25 @@
+# Run the installed examples
+
+From a consumer directory, install `rapier-math`, then run
+`node node_modules/rapier-math/examples/formula.mjs`.
+
+For Markdown and streaming, also install `markdown-it` and run `markdown.mjs` or `stream.mjs`.
+For unified, install `unified remark-parse remark-math remark-rehype rehype-sanitize rehype-stringify hast-util-from-html`
+and run `unified.mjs`. The remark example uses remark's syntax; it does not recognize backslash delimiters.
+
+Serve the package directory over HTTP and open `examples/browser.html`. Its external module imports the
+installed ESM renderer, fits the output and releases observation before replacement and on page exit.
+Start `new Worker('./worker.mjs', {type: 'module'})` from this directory and post `{id, source}`.
+Use an id owned by the current message and ignore stale replies. Workers render SVG; they do not call `observe`.
+
+`react.tsx` is a small React 19/SSR component to copy into an existing TypeScript application. Install
+`react react-dom` and the development types `@types/react @types/react-dom`. No framework is required by the core.
+
+For streamed UTF-8, use `TextDecoderStream` or `decoder.decode(bytes, {stream: true})` and flush the decoder
+at EOF. Feed decoded strings into one stream per message. Append incoming chunks to a text node for immediate
+literal progress, and replace the whole preview when `write` returns a snapshot. Replace it with `finish()` at EOF.
+Do not concatenate transport data into HTML. On cancellation call `abort`; on replacement cancel the old producer
+before `reset`. A producer that still runs needs its own generation check before calling `write`.
+
+The examples retain the original source as the editable/copyable authority. Markdown hosts can normalize
+newlines or escapes in their syntax nodes; an HTML serialization is not an exact source archive.

package/examples/browser.html

@@ -0,0 +1,10 @@
+<!doctype html>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width">
+<meta http-equiv="Content-Security-Policy" content="default-src 'none'; script-src 'self'; style-src-attr 'unsafe-inline'; style-src-elem 'none'; worker-src 'self'; connect-src 'none'; base-uri 'none'">
+<title>Rapier Math example</title>
+<label>TeX <textarea id="source">\frac{-b\pm\sqrt{b^2-4ac}}{2a}</textarea></label>
+<button id="render" type="button">Render</button>
+<main id="equation"></main>
+<pre id="errors"></pre>
+<script type="module" src="./browser.mjs"></script>

package/examples/browser.mjs

@@ -0,0 +1,24 @@
+// SPDX-License-Identifier: MIT
+import {render, observe} from '../dist/index.mjs';
+const container = document.querySelector('#equation');
+const source = document.querySelector('#source');
+let stop = () => {};
+function update() {
+  stop();
+  try {
+    const result = render(source.value, {displayMode: true});
+    document.querySelector('#errors').textContent = JSON.stringify(result.errors);
+    if (result.errors.length) container.replaceChildren(document.createTextNode(source.value));
+    else {
+      // Only this renderer's freshly returned SVG reaches the HTML sink.
+      container.innerHTML = result.svg;
+      stop = observe(container);
+    }
+  } catch (error) {
+    container.replaceChildren(document.createTextNode(source.value));
+    document.querySelector('#errors').textContent = error.message;
+  }
+}
+document.querySelector('#render').addEventListener('click', update);
+window.addEventListener('pagehide', () => stop());
+update();

package/examples/formula.mjs

@@ -0,0 +1,12 @@
+// SPDX-License-Identifier: MIT
+import {render, renderToString} from 'rapier-math';
+
+// Works in Node/SSR: the result needs no browser JavaScript or remote font.
+const source = String.raw`\frac{-b\pm\sqrt{b^2-4ac}}{2a}`;
+const result = render(source, {displayMode: true});
+if (result.errors.length) throw new Error(JSON.stringify(result.errors));
+console.log(result.svg);
+console.log(renderToString('E=mc^2'));
+const failure = render(String.raw`\unsupported{x}`);
+console.error({source: String.raw`\unsupported{x}`, errors: failure.errors});
+// Retain the original source for editing/copying, even if admission throws.

package/examples/markdown.mjs

@@ -0,0 +1,9 @@
+// SPDX-License-Identifier: MIT
+import MarkdownIt from 'markdown-it';
+import rapierMath from 'rapier-math/markdown-it';
+
+export const md = new MarkdownIt({html: false}).use(rapierMath);
+const source = 'It costs $5 and $10. Code: `$$x$$`. Math: \\(x^2\\).\n\n$$\\frac{1}{2}$$\n';
+const env = {};
+console.log(md.render(source, env));
+console.error(env.rapierMathErrors || []);

package/examples/react.tsx

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: MIT
+import {useEffect, useMemo, useRef} from 'react';
+import {render, observe} from 'rapier-math';
+
+export function Equation({source, displayMode = false}: {source: string; displayMode?: boolean}) {
+  const ref = useRef<HTMLSpanElement>(null);
+  const result = useMemo(() => {
+    try { return render(source, {displayMode}); }
+    catch { return null; }
+  }, [source, displayMode]);
+  const svg = result && result.errors.length === 0 ? result.svg : null;
+  useEffect(() => {
+    if (ref.current && svg) return observe(ref.current);
+  }, [svg]); // Cleanup runs before replacement setup and on unmount.
+  if (!svg) return <code>{source}</code>;
+  // The server and initial client render use identical source/options. Fit only
+  // after hydration; never pass authored HTML to dangerouslySetInnerHTML.
+  return <span ref={ref} dangerouslySetInnerHTML={{__html: svg}} />;
+}

package/examples/stream.mjs

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: MIT
+import MarkdownIt from 'markdown-it';
+import rapierMath from 'rapier-math/markdown-it';
+import {createMarkdownStream} from 'rapier-math/stream';
+
+const md = new MarkdownIt({html: false}).use(rapierMath);
+const stream = createMarkdownStream(source => md.render(source, {}), {previewEvery: 16});
+for (const chunk of ['The answer is \\(', '\\frac{1}', '{2}', '\\)', '. Code: `$$x$$`.']) {
+  const preview = stream.write(chunk);
+  if (preview) console.log({phase: 'preview', ...preview});
+}
+const final = stream.finish();
+console.log({phase: 'complete', ...final});
+if (final.html !== md.render(final.source, {})) throw new Error('Batch mismatch');
+
+// One stream per message. On replacement: cancel its transport, reset, write.
+stream.reset();
+stream.write('Replacement \\(y\\).');
+console.log(stream.finish());

package/examples/unified.mjs

@@ -0,0 +1,26 @@
+// SPDX-License-Identifier: MIT
+import {unified} from 'unified';
+import remarkParse from 'remark-parse';
+import remarkMath from 'remark-math';
+import remarkRehype from 'remark-rehype';
+import rehypeSanitize, {defaultSchema} from 'rehype-sanitize';
+import rehypeRapierMath from 'rapier-math/rehype';
+import rehypeStringify from 'rehype-stringify';
+import {pathToFileURL} from 'node:url';
+
+export const processor = unified().use(remarkParse)
+  .use(remarkMath, {singleDollarTextMath: false}).use(remarkRehype)
+  .use(rehypeSanitize, {
+    ...defaultSchema,
+    attributes: {...defaultSchema.attributes, code: [
+      ...(defaultSchema.attributes.code || []).filter(rule => !(Array.isArray(rule) && rule[0] === 'className')),
+      ['className', 'language-math', 'math-inline', 'math-display'],
+    ]},
+  })
+  .use(rehypeRapierMath).use(rehypeStringify);
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  const file = await processor.process('Price $5. Code `$$x$$`. Math $$x^2$$.\n\n$$\n\\frac{1}{2}\n$$');
+  console.log(String(file));
+  console.error(file.messages);
+}

package/examples/worker.mjs

@@ -0,0 +1,7 @@
+// SPDX-License-Identifier: MIT
+import {render} from '../dist/index.mjs';
+self.onmessage = ({data: {id, source}}) => {
+  try { self.postMessage({id, source, result: render(source)}); }
+  catch (error) { self.postMessage({id, source, error: {code: error.code, message: error.message}}); }
+};
+// Keep a request id per message; install a reply only if it is still current.

package/package.json

@@ -1,29 +1,72 @@
 {
   "name": "rapier-math",
-  "version": "1.0.2",
-  "description": "Self-contained TeX-to-SVG math renderer with Latin Modern outlines.",
+  "version": "1.1.1",
+  "description": "Self-contained offline LaTeX-to-SVG rendering with Latin Modern outlines, optional Markdown integrations and streaming helpers.",
   "type": "module",
-  "main": "./index.mjs",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "sideEffects": [
+    "./dist/rapier-math.js"
+  ],
   "exports": {
-    ".": "./index.mjs",
-    "./rapier-math-1.0.2.js": "./rapier-math-1.0.2.js",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.mjs"
+    },
+    "./delimiters": {
+      "types": "./dist/delimiters.d.ts",
+      "default": "./dist/delimiters.mjs"
+    },
+    "./markdown-it": {
+      "types": "./dist/markdown-it.d.ts",
+      "default": "./dist/markdown-it.mjs"
+    },
+    "./rehype": {
+      "types": "./dist/rehype.d.ts",
+      "default": "./dist/rehype.mjs"
+    },
+    "./stream": {
+      "types": "./dist/stream.d.ts",
+      "default": "./dist/stream.mjs"
+    },
+    "./classic": {
+      "types": "./dist/classic.d.ts",
+      "default": "./dist/rapier-math.js"
+    },
     "./package.json": "./package.json"
   },
+  "peerDependencies": {
+    "markdown-it": "^14.1.0 || ^15.0.0",
+    "@types/markdown-it": "^14.1.0",
+    "hast-util-from-html": "^2.0.0",
+    "@types/hast": "^3.0.0",
+    "vfile": "^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "markdown-it": {
+      "optional": true
+    },
+    "@types/markdown-it": {
+      "optional": true
+    },
+    "hast-util-from-html": {
+      "optional": true
+    },
+    "@types/hast": {
+      "optional": true
+    },
+    "vfile": {
+      "optional": true
+    }
+  },
   "files": [
-    "index.mjs",
-    "rapier-math-1.0.2.js",
+    "dist",
+    "src",
+    "docs",
+    "examples",
+    "tests",
     "LICENSE",
-    "LICENSE-MIT",
-    "math-LICENSE.txt",
-    "math-font-LICENSE.txt",
-    "math-components.json",
-    "README.md",
-    "verify.mjs",
-    "check.mjs",
-    "src/math",
-    "src/tools/build-math.mjs",
-    "src/shell/math-resources.json",
-    "src/package.json"
+    "README.md"
   ],
   "license": "SEE LICENSE IN LICENSE",
   "author": "Jack Skipworth",
@@ -41,6 +84,12 @@
     "latex",
     "svg",
     "typesetting",
-    "latin-modern"
+    "latin-modern",
+    "markdown",
+    "markdown-it",
+    "rehype",
+    "unified",
+    "offline",
+    "math-rendering"
   ]
 }

package/src/math/api.js

@@ -7,23 +7,27 @@ function mathSvg(box,source,error,utf16,options={}) {
   const opacity=options.screen?.dark ? .94 : 1;
   if (![width,height,depth,left,...viewBox].every(Number.isFinite)) throw new Error('Mathematical dimensions are not finite');
   const escapedSource=mathEscape(source);
-  const svg='<svg xmlns="http://www.w3.org/2000/svg" role="img" aria-label="'+escapedSource+'"'+
+  // A group exposes authored links to accessibility APIs; an image would hide them.
+  const svg='<svg xmlns="http://www.w3.org/2000/svg" role="'+(box.svg.includes('<a ')?'group':'img')+'" aria-label="'+escapedSource+'"'+
     ' data-rapier-math="'+(options.displayMode?'display':'inline')+'" data-math-lines="'+(box.lines || 1)+'"'+
     ' data-math-natural-width="'+mathNumber(options.naturalWidth ?? width)+'"'+
     (options.screen?' data-math-screen="'+mathNumber(options.screen.fontSize)+'|'+mathNumber(options.screen.pixelRatio)+'|'+options.screen.dark+'"':'')+
     (options.maxWidth?' data-math-max-width="'+mathNumber(options.maxWidth)+'"':'')+
     (utf16?' data-tex-utf16="'+utf16+'"':'')+
+    (error?.sourceOmitted?' data-math-source-omitted="true"':'')+
     (error?' data-math-error="'+mathEscape(error.code)+'"':'')+' width="'+mathNumber(width)+'em" height="'+mathNumber(height+depth)+'em"'+
     ' viewBox="'+viewBox.map(mathNumber).join(' ')+'"'+
     ' style="font-size:'+mathNumber(mathFontRatio)+'em;max-width:100%;height:auto;vertical-align:-'+mathNumber(depth)+'em;'+
     'fill-opacity:'+opacity+';stroke-opacity:'+opacity+'" fill="currentColor">'+
     '<title>'+escapedSource+'</title>'+(error?'<desc>'+mathEscape(error.message)+'</desc>':'')+
     '<g transform="scale(1000)">'+box.svg+'</g></svg>';
+  if(svg.length>24*1024*1024)throw Object.assign(new Error('The complete formula markup exceeds its output budget.'),{code:'resource-limit'});
   return {svg,width,height,depth,lines:box.lines || 1,fitted:!!box.fitted,errors:error?[error]:[]};
 }
 
 function mathSourceAlternative(source) {
-  let alternative='',first=-1,kept=0;
+  const alternatives=[],parts=[];
+  let first=-1,kept=0;
   for(let i=0;i<source.length;i++) {
     const code=source.charCodeAt(i);
     if(code>=0xd800 && code<=0xdbff && i+1<source.length) {
@@ -32,19 +36,32 @@ function mathSourceAlternative(source) {
     }
     if((code>=0x20 && code<=0xd7ff) || (code>=0xe000 && code<=0xfffd) || code===9 || code===10 || code===13)continue;
     if(first<0)first=i;
-    alternative+=source.slice(kept,i)+'\\u'+code.toString(16).toUpperCase().padStart(4,'0');kept=i+1;
+    if(i>kept)parts.push(source.slice(kept,i));
+    parts.push('\\u'+code.toString(16).toUpperCase().padStart(4,'0'));kept=i+1;
+    // Flatten small batches instead of retaining one rope node per bad code unit.
+    if(parts.length>=1024) {alternatives.push(parts.join(''));parts.length=0;}
   }
   if(first<0)return {alternative:source};
-  alternative+=source.slice(kept);
+  parts.push(source.slice(kept));alternatives.push(parts.join(''));
   // Only malformed XML text needs a separate carrier; each four hex digits keep one original code unit.
-  let utf16='';
-  for(let i=0;i<source.length;i++)utf16+=source.charCodeAt(i).toString(16).padStart(4,'0');
-  return {alternative,utf16,error:{code:'invalid-source-character',offset:first,
+  const encoded=[];parts.length=0;
+  for(let i=0;i<source.length;i++) {
+    parts.push(source.charCodeAt(i).toString(16).padStart(4,'0'));
+    if(parts.length===1024) {encoded.push(parts.join(''));parts.length=0;}
+  }
+  encoded.push(parts.join(''));
+  return {alternative:alternatives.join(''),utf16:encoded.join(''),error:{code:'invalid-source-character',offset:first,
     message:'A source character cannot be embedded in SVG. The text alternative shows Unicode escapes; data-tex-utf16 keeps the original source.'}};
 }
 
 function renderMath(source,options={}) {
-  const text=String(source ?? ''),safe=mathSourceAlternative(text),context={size:1,level:0,variant:'normal',cramped:false,display:!!options?.displayMode,cache:new WeakMap(),budget:{nodes:0,outlineBytes:0}};
+  const text=String(source ?? '');
+  // Reject before scanning, escaping or parsing. Keep the diagnostic-return
+  // contract, but explicitly omit refused source instead of expanding it.
+  const safe=text.length>1000000?{alternative:'Formula source omitted: source limit exceeded.',error:{
+    code:'resource-limit',offset:0,sourceOmitted:true,
+    message:'This formula is too long to render safely. Its source was not embedded; retain the original input.'
+  }}:mathSourceAlternative(text),context={size:1,level:0,variant:'normal',cramped:false,display:!!options?.displayMode,cache:new WeakMap(),budget:{nodes:0,outlineBytes:0}};
   try {
     if(safe.error)throw safe.error;
     if(options?.screen!==undefined) {
@@ -61,11 +78,16 @@ function renderMath(source,options={}) {
     return mathSvg(box,safe.alternative,undefined,undefined,{displayMode:context.display,maxWidth,naturalWidth:mathInkWidth(natural)+.05,screen:context.screen});
   }
   catch (cause) {
-    const error={code:cause.code || 'invalid-tex',message:String(cause.message || cause),offset:Number.isFinite(cause.offset)?cause.offset:0};
-    if(cause.command)error.command=cause.command;
+    const message=String(cause.message || cause);
+    const error={code:cause.code || 'invalid-tex',message:message.length>1024?message.slice(0,1024).replace(/[\ud800-\udbff]$/,'')+'…':message,offset:Number.isFinite(cause.offset)?cause.offset:0};
+    if(message.length>1024)error.messageTruncated=true;
+    if(cause.sourceOmitted)error.sourceOmitted=true;
+    if(cause.command) {
+      error.command=String(cause.command).slice(0,128);
+      if(cause.command.length>128)error.commandTruncated=true;
+    }
     // A diagnostic is visible, but remains distinct from a successfully typeset formula.
-    // A hostile command can have a very long name. Keep its full diagnostic in desc/errors,
-    // while the visible notice stays finite and can render after the formula exhausted its budget.
+    // Diagnostics have an explicit bound. Exact input stays in the source alternative.
     const label=error.message.length>240?'This formula could not be rendered. The complete diagnostic is in its text description.':error.message.replace(/[^\x20-\x7e]/g,'?');
     const diagnostic={...context,variant:'roman',size:0.8,budget:{nodes:0,outlineBytes:0}};
     try {
@@ -78,7 +100,7 @@ function renderMath(source,options={}) {
 }
 
 globalThis.RapierMath=Object.freeze({
-  version:'1.0.2',
+  version:'1.1.1',
   parse:parseMathTex,
   render:renderMath,
   fit:mathFit,