@vmz/plugin-mathjax 0.3.4 → 0.3.6

package/README.md

@@ -1,34 +1,34 @@
-# @vmz/plugin-mathjax
-
-## Broad TeX support when mathematics is the product
-
-`@vmz/plugin-mathjax` connects MathJax to VMZ for applications whose mathematical content needs deeper TeX coverage,
-richer notation, or compatibility with existing scholarly material.
-
-Peer dependency: `@mathjax/src` **v4+** (replaces deprecated `mathjax-full`).
-
-## The tradeoff
-
-MathJax is the capability-first choice. It can handle cases that a lightweight typesetter may not, but it carries a
-higher cost than KaTeX. For a documentation-heavy or formula-intensive product, that trade can be exactly right. For
-common formulas on performance-sensitive pages, `@vmz/plugin-katex` is usually the better default.
-
-VMZ keeps that choice explicit. The formula engine changes the presentation capability, not the application's state,
-server, route, or deployment semantics. SSR and progressive interaction remain part of the VMZ application plan.
-
-Think of MathJax as the right specialist tool when formula fidelity is worth a heavier delivery budget. 📐
-
-## Where it earns its weight
-
-- Scholarly material imported from established TeX sources.
-- Products where advanced notation is central to the experience.
-- Documentation that cannot accept a smaller supported syntax surface.
-- Mathematical publishing that depends on the broader MathJax ecosystem.
-
-| Product priority                               | Better starting point |
-|------------------------------------------------|-----------------------|
-| Fast common formulas and compact delivery      | KaTeX                 |
-| Broad TeX compatibility and specialist content | MathJax               |
-
-The choice remains local to mathematical presentation. It does not force a different VMZ routing, state, testing, or
-deployment model.
+# @vmz/plugin-mathjax
+
+## Broad TeX support when mathematics is the product
+
+`@vmz/plugin-mathjax` connects MathJax to VMZ for applications whose mathematical content needs deeper TeX coverage,
+richer notation, or compatibility with existing scholarly material.
+
+Peer dependency: `@mathjax/src` **v4+** (replaces deprecated `mathjax-full`).
+
+## The tradeoff
+
+MathJax is the capability-first choice. It can handle cases that a lightweight typesetter may not, but it carries a
+higher cost than KaTeX. For a documentation-heavy or formula-intensive product, that trade can be exactly right. For
+common formulas on performance-sensitive pages, `@vmz/plugin-katex` is usually the better default.
+
+VMZ keeps that choice explicit. The formula engine changes the presentation capability, not the application's state,
+server, route, or deployment semantics. SSR and progressive interaction remain part of the VMZ application plan.
+
+Think of MathJax as the right specialist tool when formula fidelity is worth a heavier delivery budget. 📐
+
+## Where it earns its weight
+
+- Scholarly material imported from established TeX sources.
+- Products where advanced notation is central to the experience.
+- Documentation that cannot accept a smaller supported syntax surface.
+- Mathematical publishing that depends on the broader MathJax ecosystem.
+
+| Product priority                               | Better starting point |
+|------------------------------------------------|-----------------------|
+| Fast common formulas and compact delivery      | KaTeX                 |
+| Broad TeX compatibility and specialist content | MathJax               |
+
+The choice remains local to mathematical presentation. It does not force a different VMZ routing, state, testing, or
+deployment model.

package/package.json

@@ -1,6 +1,6 @@
 {
   "dependencies": {
-    "@vmz/plugin": "0.3.4"
+    "@vmz/plugin": "0.3.6"
   },
   "description": "VMZ MathJax adapter - <Mathjax> + math engine",
   "devDependencies": {
@@ -43,5 +43,5 @@
   },
   "type": "module",
   "types": "./vmz.plugin.ts",
-  "version": "0.3.4"
+  "version": "0.3.6"
 }

package/runtime.ts

@@ -1,56 +1,56 @@
-/**
- * MathJax TeX -> SVG helper (MathJax v4 / `@mathjax/src`).
- * Prefer KaTeX for common docs; MathJax for heavier TeX coverage.
- */
-
-type TexConvert = (tex: string, display: boolean) => string;
-
-let tex2svg: TexConvert | null = null;
-
-const EM = 16;
-const EX = 8;
-
-async function getConvert(): Promise<TexConvert> {
-    if (tex2svg) return tex2svg;
-
-    const { mathjax } = await import('@mathjax/src/js/mathjax.js');
-    const { TeX } = await import('@mathjax/src/js/input/tex.js');
-    const { SVG } = await import('@mathjax/src/js/output/svg.js');
-    const { liteAdaptor } = await import('@mathjax/src/js/adaptors/liteAdaptor.js');
-    const { RegisterHTMLHandler } = await import('@mathjax/src/js/handlers/html.js');
-    await import('@mathjax/src/js/util/asyncLoad/esm.js');
-    await import('@mathjax/src/js/input/tex/base/BaseConfiguration.js');
-    await import('@mathjax/src/js/input/tex/ams/AmsConfiguration.js');
-
-    const adaptor = liteAdaptor({ fontSize: EM });
-    RegisterHTMLHandler(adaptor);
-
-    const html = mathjax.document('', {
-        InputJax: new TeX({ packages: ['base', 'ams'] }),
-        OutputJax: new SVG({ fontCache: 'none', exFactor: EX / EM }),
-    });
-
-    tex2svg = (tex, display) => {
-        const node = html.convert(tex ?? '', {
-            display: !!display,
-            em: EM,
-            ex: EX,
-            containerWidth: 80 * EM,
-        });
-        return adaptor.outerHTML(node);
-    };
-    return tex2svg;
-}
-
-export async function renderMathjax(tex: string, display = false): Promise<string> {
-    const convert = await getConvert();
-    return convert(tex, display);
-}
-
-export function renderMathjaxFallback(tex: string): string {
-    const escaped = String(tex ?? '')
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;');
-    return `<span class="mathjax-fallback">${escaped}</span>`;
-}
+/**
+ * MathJax TeX -> SVG helper (MathJax v4 / `@mathjax/src`).
+ * Prefer KaTeX for common docs; MathJax for heavier TeX coverage.
+ */
+
+type TexConvert = (tex: string, display: boolean) => string;
+
+let tex2svg: TexConvert | null = null;
+
+const EM = 16;
+const EX = 8;
+
+async function getConvert(): Promise<TexConvert> {
+    if (tex2svg) return tex2svg;
+
+    const { mathjax } = await import('@mathjax/src/js/mathjax.js');
+    const { TeX } = await import('@mathjax/src/js/input/tex.js');
+    const { SVG } = await import('@mathjax/src/js/output/svg.js');
+    const { liteAdaptor } = await import('@mathjax/src/js/adaptors/liteAdaptor.js');
+    const { RegisterHTMLHandler } = await import('@mathjax/src/js/handlers/html.js');
+    await import('@mathjax/src/js/util/asyncLoad/esm.js');
+    await import('@mathjax/src/js/input/tex/base/BaseConfiguration.js');
+    await import('@mathjax/src/js/input/tex/ams/AmsConfiguration.js');
+
+    const adaptor = liteAdaptor({ fontSize: EM });
+    RegisterHTMLHandler(adaptor);
+
+    const html = mathjax.document('', {
+        InputJax: new TeX({ packages: ['base', 'ams'] }),
+        OutputJax: new SVG({ fontCache: 'none', exFactor: EX / EM }),
+    });
+
+    tex2svg = (tex, display) => {
+        const node = html.convert(tex ?? '', {
+            display: !!display,
+            em: EM,
+            ex: EX,
+            containerWidth: 80 * EM,
+        });
+        return adaptor.outerHTML(node);
+    };
+    return tex2svg;
+}
+
+export async function renderMathjax(tex: string, display = false): Promise<string> {
+    const convert = await getConvert();
+    return convert(tex, display);
+}
+
+export function renderMathjaxFallback(tex: string): string {
+    const escaped = String(tex ?? '')
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+    return `<span class="mathjax-fallback">${escaped}</span>`;
+}