@vmz/plugin-mathjax 0.0.2 → 0.0.4

package/README.md

@@ -5,6 +5,8 @@
 `@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
@@ -23,9 +25,10 @@ Think of MathJax as the right specialist tool when formula fidelity is worth a h
 - 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 |
+| 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.
+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 @@
 {
   "name": "@vmz/plugin-mathjax",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "type": "module",
   "description": "VMZ MathJax adapter - <Mathjax> + math engine",
   "license": "MIT",
@@ -17,10 +17,15 @@
     }
   },
   "dependencies": {
-    "@vmz/plugin": "0.0.2"
+    "@vmz/plugin": "0.0.4"
   },
   "peerDependencies": {
-    "mathjax-full": ">=3"
+    "@mathjax/src": ">=4"
+  },
+  "peerDependenciesMeta": {
+    "@mathjax/src": {
+      "optional": false
+    }
   },
   "keywords": [
     "vmz",

package/runtime.ts

@@ -1,5 +1,5 @@
 /**
- * MathJax TeX → HTML/SVG helper.
+ * MathJax TeX -> SVG helper (MathJax v4 / `@mathjax/src`).
  * Prefer KaTeX for common docs; MathJax for heavier TeX coverage.
  */
 
@@ -7,21 +7,36 @@ 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-full/js/mathjax.js');
-    const { TeX } = await import('mathjax-full/js/input/tex.js');
-    const { SVG } = await import('mathjax-full/js/output/svg.js');
-    const { liteAdaptor } = await import('mathjax-full/js/adaptors/liteAdaptor.js');
-    const { RegisterHTMLHandler } = await import('mathjax-full/js/handlers/html.js');
-    const adaptor = liteAdaptor();
+
+    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' }),
+        OutputJax: new SVG({ fontCache: 'none', exFactor: EX / EM }),
     });
+
     tex2svg = (tex, display) => {
-        const node = html.convert(tex ?? '', { display: !!display });
+        const node = html.convert(tex ?? '', {
+            display: !!display,
+            em: EM,
+            ex: EX,
+            containerWidth: 80 * EM,
+        });
         return adaptor.outerHTML(node);
     };
     return tex2svg;