From 8206e86f11c16b8f8304ef37af5c54fb45fd8e23 Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 20:27:57 +0000
Subject: [PATCH 01/22] Use top-level static MathJax import in LaTeX webview

Replace deferred dynamic imports with a build-time side-effect import of
mathjax/tex-svg.js (peer dependency of @prosemark/latex) so Vite fully
bundles MathJax into webview.js before the webview loads.

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .changeset/latex-static-mathjax-import.md     |  5 +++
 .../latex-integration/src/webview/main.ts     | 35 +++++++++++--------
 2 files changed, 26 insertions(+), 14 deletions(-)
 create mode 100644 .changeset/latex-static-mathjax-import.md

diff --git a/.changeset/latex-static-mathjax-import.md b/.changeset/latex-static-mathjax-import.md
new file mode 100644
index 00000000..9082c9d1
--- /dev/null
+++ b/.changeset/latex-static-mathjax-import.md
@@ -0,0 +1,5 @@
+---
+'vscode-prosemark-latex-integration': patch
+---
+
+Load MathJax via a top-level static `import 'mathjax/tex-svg.js'` (peer dependency of `@prosemark/latex`) so Vite fully bundles it into the webview instead of deferring a dynamic import at setup time.
diff --git a/apps/vscode-extensions/latex-integration/src/webview/main.ts b/apps/vscode-extensions/latex-integration/src/webview/main.ts
index 2417e67d..25f2f2b3 100644
--- a/apps/vscode-extensions/latex-integration/src/webview/main.ts
+++ b/apps/vscode-extensions/latex-integration/src/webview/main.ts
@@ -7,38 +7,45 @@ import type {
   CallbackFromProcMap,
   WebviewVSCodeApiWithPostMessage,
 } from '@prosemark/vscode-extension-integrator/types';
+import {
+  latexMarkdownEditorExtensions,
+  latexMarkdownSyntaxTheme,
+} from '@prosemark/latex';
 
 import './style.css';
 
+// Peer dependency of @prosemark/latex; bundled into webview.js by Vite at build time.
+import 'mathjax/tex-svg.js';
+
+const latexExtensions = [
+  ...latexMarkdownSyntaxTheme,
+  ...latexMarkdownEditorExtensions({
+    mathJaxLoadMode: 'static-import',
+    output: 'svg',
+  }),
+];
+
 let latexSetupDone = false;
 
 const procs: WebviewProcMap = {
-  setup: async () => {
+  setup: () => {
     const view = window.proseMark?.view;
     if (!view) {
       console.warn('[ProseMark] latex-integration setup: no view');
-      return;
+      return Promise.resolve();
     }
     if (latexSetupDone) {
-      return;
+      return Promise.resolve();
     }
+    latexSetupDone = true;
 
     try {
-      // Bundle MathJax tex-svg into webview.js (Vite resolves `mathjax/...` from npm).
-      await import('mathjax/tex-svg.js');
-      const latex = await import('@prosemark/latex');
-      appendToExtraCodeMirrorExtensions(view, [
-        ...latex.latexMarkdownSyntaxTheme,
-        ...latex.latexMarkdownEditorExtensions({
-          mathJaxLoadMode: 'static-import',
-          output: 'svg',
-        }),
-      ]);
-      latexSetupDone = true;
+      appendToExtraCodeMirrorExtensions(view, latexExtensions);
     } catch (err: unknown) {
       console.error('[ProseMark] latex-integration setup failed', err);
       throw err;
     }
+    return Promise.resolve();
   },
 };
 

From c6b2d22adda9873278986e17f10c17af0d6fae25 Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 20:30:45 +0000
Subject: [PATCH 02/22] Keep latex setup handler async for readability

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .../latex-integration/src/webview/main.ts                  | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/apps/vscode-extensions/latex-integration/src/webview/main.ts b/apps/vscode-extensions/latex-integration/src/webview/main.ts
index 25f2f2b3..9b7d46b5 100644
--- a/apps/vscode-extensions/latex-integration/src/webview/main.ts
+++ b/apps/vscode-extensions/latex-integration/src/webview/main.ts
@@ -28,14 +28,14 @@ const latexExtensions = [
 let latexSetupDone = false;
 
 const procs: WebviewProcMap = {
-  setup: () => {
+  setup: async () => {
     const view = window.proseMark?.view;
     if (!view) {
       console.warn('[ProseMark] latex-integration setup: no view');
-      return Promise.resolve();
+      return;
     }
     if (latexSetupDone) {
-      return Promise.resolve();
+      return;
     }
     latexSetupDone = true;
 
@@ -45,7 +45,6 @@ const procs: WebviewProcMap = {
       console.error('[ProseMark] latex-integration setup failed', err);
       throw err;
     }
-    return Promise.resolve();
   },
 };
 

From bb2a8070f95d9eb70d27e37ad5f200596fd8189f Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 20:37:55 +0000
Subject: [PATCH 03/22] Disable MathJax a11y speech worker in VS Code webview

The tex-svg combined component loads sre/speech-worker.js at runtime, but
Vite only emits webview.js. Turn off speech/enrichment for editor preview.

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .changeset/latex-static-mathjax-import.md     |  2 +-
 .../src/webview/disable-mathjax-a11y.ts       | 41 +++++++++++++++++++
 .../latex-integration/src/webview/main.ts     |  4 ++
 .../src/webview/mathjax-preload.ts            | 23 +++++++++++
 4 files changed, 69 insertions(+), 1 deletion(-)
 create mode 100644 apps/vscode-extensions/latex-integration/src/webview/disable-mathjax-a11y.ts
 create mode 100644 apps/vscode-extensions/latex-integration/src/webview/mathjax-preload.ts

diff --git a/.changeset/latex-static-mathjax-import.md b/.changeset/latex-static-mathjax-import.md
index 9082c9d1..3cc0a8bb 100644
--- a/.changeset/latex-static-mathjax-import.md
+++ b/.changeset/latex-static-mathjax-import.md
@@ -2,4 +2,4 @@
 'vscode-prosemark-latex-integration': patch
 ---
 
-Load MathJax via a top-level static `import 'mathjax/tex-svg.js'` (peer dependency of `@prosemark/latex`) so Vite fully bundles it into the webview instead of deferring a dynamic import at setup time.
+Load MathJax via a top-level static `import 'mathjax/tex-svg.js'` (peer dependency of `@prosemark/latex`) so Vite fully bundles it into the webview instead of deferring a dynamic import at setup time. Disable MathJax a11y speech/enrichment so the combined `tex-svg` component does not try to load the separate `sre/speech-worker.js` file (not copied into the VS Code webview bundle).
diff --git a/apps/vscode-extensions/latex-integration/src/webview/disable-mathjax-a11y.ts b/apps/vscode-extensions/latex-integration/src/webview/disable-mathjax-a11y.ts
new file mode 100644
index 00000000..26af292e
--- /dev/null
+++ b/apps/vscode-extensions/latex-integration/src/webview/disable-mathjax-a11y.ts
@@ -0,0 +1,41 @@
+interface MathJaxStartupDocument {
+  options: {
+    enableSpeech?: boolean;
+    enableBraille?: boolean;
+    enableEnrichment?: boolean;
+  };
+}
+
+interface MathJaxWithStartup {
+  startup?: {
+    promise?: Promise<void>;
+    document?: MathJaxStartupDocument;
+  };
+  config?: {
+    options?: {
+      enableSpeech?: boolean;
+      enableBraille?: boolean;
+      enableEnrichment?: boolean;
+    };
+  };
+}
+
+/** Ensure speech worker is not requested before math widgets render. */
+export async function disableMathJaxA11y(): Promise<void> {
+  const mj = window.MathJax as MathJaxWithStartup | undefined;
+  await mj?.startup?.promise;
+
+  const options = mj?.config?.options;
+  if (options) {
+    options.enableSpeech = false;
+    options.enableBraille = false;
+    options.enableEnrichment = false;
+  }
+
+  const docOptions = mj?.startup?.document?.options;
+  if (docOptions) {
+    docOptions.enableSpeech = false;
+    docOptions.enableBraille = false;
+    docOptions.enableEnrichment = false;
+  }
+}
diff --git a/apps/vscode-extensions/latex-integration/src/webview/main.ts b/apps/vscode-extensions/latex-integration/src/webview/main.ts
index 9b7d46b5..8eea8d1e 100644
--- a/apps/vscode-extensions/latex-integration/src/webview/main.ts
+++ b/apps/vscode-extensions/latex-integration/src/webview/main.ts
@@ -12,11 +12,14 @@ import {
   latexMarkdownSyntaxTheme,
 } from '@prosemark/latex';
 
+import './mathjax-preload';
 import './style.css';
 
 // Peer dependency of @prosemark/latex; bundled into webview.js by Vite at build time.
 import 'mathjax/tex-svg.js';
 
+import { disableMathJaxA11y } from './disable-mathjax-a11y';
+
 const latexExtensions = [
   ...latexMarkdownSyntaxTheme,
   ...latexMarkdownEditorExtensions({
@@ -40,6 +43,7 @@ const procs: WebviewProcMap = {
     latexSetupDone = true;
 
     try {
+      await disableMathJaxA11y();
       appendToExtraCodeMirrorExtensions(view, latexExtensions);
     } catch (err: unknown) {
       console.error('[ProseMark] latex-integration setup failed', err);
diff --git a/apps/vscode-extensions/latex-integration/src/webview/mathjax-preload.ts b/apps/vscode-extensions/latex-integration/src/webview/mathjax-preload.ts
new file mode 100644
index 00000000..7b979a56
--- /dev/null
+++ b/apps/vscode-extensions/latex-integration/src/webview/mathjax-preload.ts
@@ -0,0 +1,23 @@
+/**
+ * MathJax reads `window.MathJax` when `tex-svg.js` loads. This module must be
+ * imported before `mathjax/tex-svg.js` so startup options are in place first.
+ *
+ * The combined `tex-svg` component includes a11y/speech and tries to load
+ * `sre/speech-worker.js` as a separate web worker at runtime. VS Code webviews
+ * only ship `webview.js`, so we disable speech/enrichment for editor preview.
+ */
+window.MathJax = {
+  options: {
+    skipStartupTypeset: true,
+    enableSpeech: false,
+    enableBraille: false,
+    enableEnrichment: false,
+    menuOptions: {
+      settings: {
+        enrich: false,
+        speech: false,
+        braille: false,
+      },
+    },
+  },
+};

From 3e347035e03dd5252f3d26f04d8b6da3261c3a5c Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 20:41:52 +0000
Subject: [PATCH 04/22] Copy MathJax sre assets into webview dist via Vite
 plugin

The tex-svg bundle loads sre/speech-worker.js at runtime as a web worker.
Vite inlines the main IIFE but cannot bundle workers loaded via importScripts,
so copy mathjax/sre/ next to webview.js after each build.

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .changeset/latex-static-mathjax-import.md     |  2 +-
 .../latex-integration/README.md               |  2 +-
 .../src/webview/disable-mathjax-a11y.ts       | 41 -------------------
 .../latex-integration/src/webview/main.ts     |  6 +--
 .../src/webview/mathjax-preload.ts            | 14 -------
 .../vite-plugin-mathjax-sre.ts                | 32 +++++++++++++++
 .../latex-integration/vite.config.ts          |  9 +++-
 7 files changed, 45 insertions(+), 61 deletions(-)
 delete mode 100644 apps/vscode-extensions/latex-integration/src/webview/disable-mathjax-a11y.ts
 create mode 100644 apps/vscode-extensions/latex-integration/vite-plugin-mathjax-sre.ts

diff --git a/.changeset/latex-static-mathjax-import.md b/.changeset/latex-static-mathjax-import.md
index 3cc0a8bb..a957fedb 100644
--- a/.changeset/latex-static-mathjax-import.md
+++ b/.changeset/latex-static-mathjax-import.md
@@ -2,4 +2,4 @@
 'vscode-prosemark-latex-integration': patch
 ---
 
-Load MathJax via a top-level static `import 'mathjax/tex-svg.js'` (peer dependency of `@prosemark/latex`) so Vite fully bundles it into the webview instead of deferring a dynamic import at setup time. Disable MathJax a11y speech/enrichment so the combined `tex-svg` component does not try to load the separate `sre/speech-worker.js` file (not copied into the VS Code webview bundle).
+Load MathJax via a top-level static `import 'mathjax/tex-svg.js'` (peer dependency of `@prosemark/latex`) so Vite fully bundles it into the webview instead of deferring a dynamic import at setup time. Copy `mathjax/sre/` into `dist/webview/sre/` at build time so the combined `tex-svg` component can load its speech web worker at runtime.
diff --git a/apps/vscode-extensions/latex-integration/README.md b/apps/vscode-extensions/latex-integration/README.md
index 158a443b..cff133f0 100644
--- a/apps/vscode-extensions/latex-integration/README.md
+++ b/apps/vscode-extensions/latex-integration/README.md
@@ -24,4 +24,4 @@ Please report bugs on the [GitHub issues page](https://github.com/jsimonrichard/
 
 ## Developing this extension
 
-After `bun install`, run `bun run build`. **Vite** produces `dist/webview/webview.js` with MathJax SVG output inlined into that bundle (see `src/webview/main.ts`). Bump the **`mathjax`** dependency when you want a different MathJax version.
+After `bun install`, run `bun run build`. **Vite** produces `dist/webview/webview.js` with MathJax SVG output inlined into that bundle (see `src/webview/main.ts`), and copies `mathjax/sre/` (speech worker + mathmaps) into `dist/webview/sre/` for MathJax a11y. Bump the **`mathjax`** dependency when you want a different MathJax version.
diff --git a/apps/vscode-extensions/latex-integration/src/webview/disable-mathjax-a11y.ts b/apps/vscode-extensions/latex-integration/src/webview/disable-mathjax-a11y.ts
deleted file mode 100644
index 26af292e..00000000
--- a/apps/vscode-extensions/latex-integration/src/webview/disable-mathjax-a11y.ts
+++ /dev/null
@@ -1,41 +0,0 @@
-interface MathJaxStartupDocument {
-  options: {
-    enableSpeech?: boolean;
-    enableBraille?: boolean;
-    enableEnrichment?: boolean;
-  };
-}
-
-interface MathJaxWithStartup {
-  startup?: {
-    promise?: Promise<void>;
-    document?: MathJaxStartupDocument;
-  };
-  config?: {
-    options?: {
-      enableSpeech?: boolean;
-      enableBraille?: boolean;
-      enableEnrichment?: boolean;
-    };
-  };
-}
-
-/** Ensure speech worker is not requested before math widgets render. */
-export async function disableMathJaxA11y(): Promise<void> {
-  const mj = window.MathJax as MathJaxWithStartup | undefined;
-  await mj?.startup?.promise;
-
-  const options = mj?.config?.options;
-  if (options) {
-    options.enableSpeech = false;
-    options.enableBraille = false;
-    options.enableEnrichment = false;
-  }
-
-  const docOptions = mj?.startup?.document?.options;
-  if (docOptions) {
-    docOptions.enableSpeech = false;
-    docOptions.enableBraille = false;
-    docOptions.enableEnrichment = false;
-  }
-}
diff --git a/apps/vscode-extensions/latex-integration/src/webview/main.ts b/apps/vscode-extensions/latex-integration/src/webview/main.ts
index 8eea8d1e..d1689b2d 100644
--- a/apps/vscode-extensions/latex-integration/src/webview/main.ts
+++ b/apps/vscode-extensions/latex-integration/src/webview/main.ts
@@ -18,8 +18,6 @@ import './style.css';
 // Peer dependency of @prosemark/latex; bundled into webview.js by Vite at build time.
 import 'mathjax/tex-svg.js';
 
-import { disableMathJaxA11y } from './disable-mathjax-a11y';
-
 const latexExtensions = [
   ...latexMarkdownSyntaxTheme,
   ...latexMarkdownEditorExtensions({
@@ -43,7 +41,9 @@ const procs: WebviewProcMap = {
     latexSetupDone = true;
 
     try {
-      await disableMathJaxA11y();
+      await (
+        window.MathJax as { startup?: { promise?: Promise<void> } } | undefined
+      )?.startup?.promise;
       appendToExtraCodeMirrorExtensions(view, latexExtensions);
     } catch (err: unknown) {
       console.error('[ProseMark] latex-integration setup failed', err);
diff --git a/apps/vscode-extensions/latex-integration/src/webview/mathjax-preload.ts b/apps/vscode-extensions/latex-integration/src/webview/mathjax-preload.ts
index 7b979a56..2de5cefc 100644
--- a/apps/vscode-extensions/latex-integration/src/webview/mathjax-preload.ts
+++ b/apps/vscode-extensions/latex-integration/src/webview/mathjax-preload.ts
@@ -1,23 +1,9 @@
 /**
  * MathJax reads `window.MathJax` when `tex-svg.js` loads. This module must be
  * imported before `mathjax/tex-svg.js` so startup options are in place first.
- *
- * The combined `tex-svg` component includes a11y/speech and tries to load
- * `sre/speech-worker.js` as a separate web worker at runtime. VS Code webviews
- * only ship `webview.js`, so we disable speech/enrichment for editor preview.
  */
 window.MathJax = {
   options: {
     skipStartupTypeset: true,
-    enableSpeech: false,
-    enableBraille: false,
-    enableEnrichment: false,
-    menuOptions: {
-      settings: {
-        enrich: false,
-        speech: false,
-        braille: false,
-      },
-    },
   },
 };
diff --git a/apps/vscode-extensions/latex-integration/vite-plugin-mathjax-sre.ts b/apps/vscode-extensions/latex-integration/vite-plugin-mathjax-sre.ts
new file mode 100644
index 00000000..024e35f4
--- /dev/null
+++ b/apps/vscode-extensions/latex-integration/vite-plugin-mathjax-sre.ts
@@ -0,0 +1,32 @@
+import { cpSync, existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { resolve } from 'node:path';
+import type { Plugin } from 'vite';
+
+const require = createRequire(import.meta.url);
+
+/**
+ * MathJax `tex-svg` loads `sre/speech-worker.js` at runtime via `importScripts`
+ * inside a web worker. Vite inlines the main bundle but not that file, so copy
+ * the npm package's `sre/` tree next to `webview.js` after each build.
+ */
+export function copyMathjaxSreAssets(outDir: string): Plugin {
+  return {
+    name: 'copy-mathjax-sre',
+    closeBundle() {
+      const mathjaxRoot = resolve(
+        require.resolve('mathjax/package.json'),
+        '..',
+      );
+      const sreSrc = resolve(mathjaxRoot, 'sre');
+      if (!existsSync(sreSrc)) {
+        throw new Error(
+          `MathJax sre directory not found at ${sreSrc}. Is the mathjax package installed?`,
+        );
+      }
+
+      const sreDest = resolve(outDir, 'sre');
+      cpSync(sreSrc, sreDest, { recursive: true });
+    },
+  };
+}
diff --git a/apps/vscode-extensions/latex-integration/vite.config.ts b/apps/vscode-extensions/latex-integration/vite.config.ts
index 2f7b1d65..5f651b58 100644
--- a/apps/vscode-extensions/latex-integration/vite.config.ts
+++ b/apps/vscode-extensions/latex-integration/vite.config.ts
@@ -2,8 +2,15 @@ import { defineConfig } from 'vite';
 import { resolve } from 'node:path';
 import proseMarkVSCodeExtensionIntegratorPlugin from '@prosemark/vscode-extension-integrator/rolldown-plugin';
 
+import { copyMathjaxSreAssets } from './vite-plugin-mathjax-sre';
+
+const webviewOutDir = resolve(__dirname, 'dist/webview');
+
 export default defineConfig({
-  plugins: [proseMarkVSCodeExtensionIntegratorPlugin()],
+  plugins: [
+    proseMarkVSCodeExtensionIntegratorPlugin(),
+    copyMathjaxSreAssets(webviewOutDir),
+  ],
   build: {
     outDir: 'dist/webview',
     target: 'es2022',

From 238302fb0707b61f06043dc6148ffacb08bcd076 Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 20:55:30 +0000
Subject: [PATCH 05/22] Add @prosemark/latex vite-plugin-mathjax and self-host
 MathJax

Export copyMathJaxAssets from @prosemark/latex/vite-plugin-mathjax with a
configurable copy list (default tex-svg.js + sre). The LaTeX VS Code webview
loads MathJax via url-import from dist/webview/mathjax/ instead of bundling
tex-svg into webview.js (~48 KB vs ~1.8 MB).

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .changeset/latex-static-mathjax-import.md     |   5 -
 .changeset/latex-vite-mathjax-plugin.md       |   6 +
 .../latex-integration/README.md               |   2 +-
 .../latex-integration/src/global.d.ts         |   2 -
 .../latex-integration/src/webview/main.ts     |  29 ++--
 .../src/webview/mathjax-preload.ts            |   9 --
 .../vite-plugin-mathjax-sre.ts                |  32 ----
 .../{vite.config.ts => vite.config.mts}       |  11 +-
 bun.lock                                      | 149 +++++-------------
 packages/latex/lib/main.ts                    |  42 +++++
 packages/latex/lib/vite-plugin-mathjax.ts     |  60 +++++++
 packages/latex/package.json                   |  13 +-
 .../latex/tests/mathjax-load-modes.test.ts    |  10 ++
 packages/latex/tsdown.config.ts               |  17 +-
 14 files changed, 203 insertions(+), 184 deletions(-)
 delete mode 100644 .changeset/latex-static-mathjax-import.md
 create mode 100644 .changeset/latex-vite-mathjax-plugin.md
 delete mode 100644 apps/vscode-extensions/latex-integration/src/webview/mathjax-preload.ts
 delete mode 100644 apps/vscode-extensions/latex-integration/vite-plugin-mathjax-sre.ts
 rename apps/vscode-extensions/latex-integration/{vite.config.ts => vite.config.mts} (74%)
 create mode 100644 packages/latex/lib/vite-plugin-mathjax.ts

diff --git a/.changeset/latex-static-mathjax-import.md b/.changeset/latex-static-mathjax-import.md
deleted file mode 100644
index a957fedb..00000000
--- a/.changeset/latex-static-mathjax-import.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-'vscode-prosemark-latex-integration': patch
----
-
-Load MathJax via a top-level static `import 'mathjax/tex-svg.js'` (peer dependency of `@prosemark/latex`) so Vite fully bundles it into the webview instead of deferring a dynamic import at setup time. Copy `mathjax/sre/` into `dist/webview/sre/` at build time so the combined `tex-svg` component can load its speech web worker at runtime.
diff --git a/.changeset/latex-vite-mathjax-plugin.md b/.changeset/latex-vite-mathjax-plugin.md
new file mode 100644
index 00000000..c6ac67c8
--- /dev/null
+++ b/.changeset/latex-vite-mathjax-plugin.md
@@ -0,0 +1,6 @@
+---
+'@prosemark/latex': minor
+'vscode-prosemark-latex-integration': patch
+---
+
+Add `@prosemark/latex/vite-plugin-mathjax` to copy configurable paths from the `mathjax` npm package into a Vite build output, export `mathJaxPackageUrlFromWebviewScript`, and switch the LaTeX VS Code webview to self-hosted `url-import` (`tex-svg.js` + `sre` under `dist/webview/mathjax/`).
diff --git a/apps/vscode-extensions/latex-integration/README.md b/apps/vscode-extensions/latex-integration/README.md
index cff133f0..47ee7603 100644
--- a/apps/vscode-extensions/latex-integration/README.md
+++ b/apps/vscode-extensions/latex-integration/README.md
@@ -24,4 +24,4 @@ Please report bugs on the [GitHub issues page](https://github.com/jsimonrichard/
 
 ## Developing this extension
 
-After `bun install`, run `bun run build`. **Vite** produces `dist/webview/webview.js` with MathJax SVG output inlined into that bundle (see `src/webview/main.ts`), and copies `mathjax/sre/` (speech worker + mathmaps) into `dist/webview/sre/` for MathJax a11y. Bump the **`mathjax`** dependency when you want a different MathJax version.
+After `bun install`, run `bun run build`. **Vite** produces `dist/webview/webview.js` and copies `tex-svg.js` plus `sre/` from the **`mathjax`** npm package into `dist/webview/mathjax/` via `@prosemark/latex/vite-plugin-mathjax`. The webview loads MathJax with `url-import` from that folder. Bump the **`mathjax`** dependency when you want a different MathJax version.
diff --git a/apps/vscode-extensions/latex-integration/src/global.d.ts b/apps/vscode-extensions/latex-integration/src/global.d.ts
index c0a40625..35306c6f 100644
--- a/apps/vscode-extensions/latex-integration/src/global.d.ts
+++ b/apps/vscode-extensions/latex-integration/src/global.d.ts
@@ -1,3 +1 @@
 declare module '*.css';
-
-declare module 'mathjax/tex-svg.js';
diff --git a/apps/vscode-extensions/latex-integration/src/webview/main.ts b/apps/vscode-extensions/latex-integration/src/webview/main.ts
index d1689b2d..b8691dff 100644
--- a/apps/vscode-extensions/latex-integration/src/webview/main.ts
+++ b/apps/vscode-extensions/latex-integration/src/webview/main.ts
@@ -10,26 +10,15 @@ import type {
 import {
   latexMarkdownEditorExtensions,
   latexMarkdownSyntaxTheme,
+  mathJaxPackageUrlFromWebviewScript,
 } from '@prosemark/latex';
 
-import './mathjax-preload';
 import './style.css';
 
-// Peer dependency of @prosemark/latex; bundled into webview.js by Vite at build time.
-import 'mathjax/tex-svg.js';
-
-const latexExtensions = [
-  ...latexMarkdownSyntaxTheme,
-  ...latexMarkdownEditorExtensions({
-    mathJaxLoadMode: 'static-import',
-    output: 'svg',
-  }),
-];
-
 let latexSetupDone = false;
 
 const procs: WebviewProcMap = {
-  setup: async () => {
+  setup: () => {
     const view = window.proseMark?.view;
     if (!view) {
       console.warn('[ProseMark] latex-integration setup: no view');
@@ -41,14 +30,20 @@ const procs: WebviewProcMap = {
     latexSetupDone = true;
 
     try {
-      await (
-        window.MathJax as { startup?: { promise?: Promise<void> } } | undefined
-      )?.startup?.promise;
-      appendToExtraCodeMirrorExtensions(view, latexExtensions);
+      const mathJaxPackageUrl = mathJaxPackageUrlFromWebviewScript();
+      appendToExtraCodeMirrorExtensions(view, [
+        ...latexMarkdownSyntaxTheme,
+        ...latexMarkdownEditorExtensions({
+          mathJaxLoadMode: 'url-import',
+          mathJaxPackageUrl,
+          output: 'svg',
+        }),
+      ]);
     } catch (err: unknown) {
       console.error('[ProseMark] latex-integration setup failed', err);
       throw err;
     }
+    return Promise.resolve();
   },
 };
 
diff --git a/apps/vscode-extensions/latex-integration/src/webview/mathjax-preload.ts b/apps/vscode-extensions/latex-integration/src/webview/mathjax-preload.ts
deleted file mode 100644
index 2de5cefc..00000000
--- a/apps/vscode-extensions/latex-integration/src/webview/mathjax-preload.ts
+++ /dev/null
@@ -1,9 +0,0 @@
-/**
- * MathJax reads `window.MathJax` when `tex-svg.js` loads. This module must be
- * imported before `mathjax/tex-svg.js` so startup options are in place first.
- */
-window.MathJax = {
-  options: {
-    skipStartupTypeset: true,
-  },
-};
diff --git a/apps/vscode-extensions/latex-integration/vite-plugin-mathjax-sre.ts b/apps/vscode-extensions/latex-integration/vite-plugin-mathjax-sre.ts
deleted file mode 100644
index 024e35f4..00000000
--- a/apps/vscode-extensions/latex-integration/vite-plugin-mathjax-sre.ts
+++ /dev/null
@@ -1,32 +0,0 @@
-import { cpSync, existsSync } from 'node:fs';
-import { createRequire } from 'node:module';
-import { resolve } from 'node:path';
-import type { Plugin } from 'vite';
-
-const require = createRequire(import.meta.url);
-
-/**
- * MathJax `tex-svg` loads `sre/speech-worker.js` at runtime via `importScripts`
- * inside a web worker. Vite inlines the main bundle but not that file, so copy
- * the npm package's `sre/` tree next to `webview.js` after each build.
- */
-export function copyMathjaxSreAssets(outDir: string): Plugin {
-  return {
-    name: 'copy-mathjax-sre',
-    closeBundle() {
-      const mathjaxRoot = resolve(
-        require.resolve('mathjax/package.json'),
-        '..',
-      );
-      const sreSrc = resolve(mathjaxRoot, 'sre');
-      if (!existsSync(sreSrc)) {
-        throw new Error(
-          `MathJax sre directory not found at ${sreSrc}. Is the mathjax package installed?`,
-        );
-      }
-
-      const sreDest = resolve(outDir, 'sre');
-      cpSync(sreSrc, sreDest, { recursive: true });
-    },
-  };
-}
diff --git a/apps/vscode-extensions/latex-integration/vite.config.ts b/apps/vscode-extensions/latex-integration/vite.config.mts
similarity index 74%
rename from apps/vscode-extensions/latex-integration/vite.config.ts
rename to apps/vscode-extensions/latex-integration/vite.config.mts
index 5f651b58..5b7f79b1 100644
--- a/apps/vscode-extensions/latex-integration/vite.config.ts
+++ b/apps/vscode-extensions/latex-integration/vite.config.mts
@@ -1,15 +1,20 @@
 import { defineConfig } from 'vite';
 import { resolve } from 'node:path';
 import proseMarkVSCodeExtensionIntegratorPlugin from '@prosemark/vscode-extension-integrator/rolldown-plugin';
-
-import { copyMathjaxSreAssets } from './vite-plugin-mathjax-sre';
+import {
+  copyMathJaxAssets,
+  MATHJAX_TEX_SVG_COPY_ENTRIES,
+} from '@prosemark/latex/vite-plugin-mathjax';
 
 const webviewOutDir = resolve(__dirname, 'dist/webview');
 
 export default defineConfig({
   plugins: [
     proseMarkVSCodeExtensionIntegratorPlugin(),
-    copyMathjaxSreAssets(webviewOutDir),
+    copyMathJaxAssets({
+      outDir: webviewOutDir,
+      copy: MATHJAX_TEX_SVG_COPY_ENTRIES,
+    }),
   ],
   build: {
     outDir: 'dist/webview',
diff --git a/bun.lock b/bun.lock
index 60ff80c7..3912aa6b 100644
--- a/bun.lock
+++ b/bun.lock
@@ -261,12 +261,15 @@
         "tsdown": "^0.15.6",
         "typescript": "^5.9.3",
         "typescript-eslint": "^8.50.0",
+        "vite": "^8.0.5",
       },
       "peerDependencies": {
         "mathjax": "^4.0.0",
+        "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0",
       },
       "optionalPeers": [
         "mathjax",
+        "vite",
       ],
     },
     "packages/paste-rich-text": {
@@ -2423,7 +2426,7 @@
 
     "vfile-message": ["vfile-message@4.0.3", "", { "dependencies": { "@types/unist": "^3.0.0", "unist-util-stringify-position": "^4.0.0" } }, "sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw=="],
 
-    "vite": ["vite@5.4.21", "", { "dependencies": { "esbuild": "^0.21.3", "postcss": "^8.4.43", "rollup": "^4.20.0" }, "optionalDependencies": { "fsevents": "~2.3.3" }, "peerDependencies": { "@types/node": "^18.0.0 || >=20.0.0", "less": "*", "lightningcss": "^1.21.0", "sass": "*", "sass-embedded": "*", "stylus": "*", "sugarss": "*", "terser": "^5.4.0" }, "optionalPeers": ["@types/node", "less", "lightningcss", "sass", "sass-embedded", "stylus", "sugarss", "terser"], "bin": { "vite": "bin/vite.js" } }, "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw=="],
+    "vite": ["vite@8.0.14", "", { "dependencies": { "lightningcss": "^1.32.0", "picomatch": "^4.0.4", "postcss": "^8.5.15", "rolldown": "1.0.2", "tinyglobby": "^0.2.16" }, "optionalDependencies": { "fsevents": "~2.3.3" }, "peerDependencies": { "@types/node": "^20.19.0 || >=22.12.0", "@vitejs/devtools": "^0.1.18", "esbuild": "^0.27.0 || ^0.28.0", "jiti": ">=1.21.0", "less": "^4.0.0", "sass": "^1.70.0", "sass-embedded": "^1.70.0", "stylus": ">=0.54.8", "sugarss": "^5.0.0", "terser": "^5.16.0", "tsx": "^4.8.1", "yaml": "^2.4.2" }, "optionalPeers": ["@types/node", "@vitejs/devtools", "esbuild", "jiti", "less", "sass", "sass-embedded", "stylus", "sugarss", "terser", "tsx", "yaml"], "bin": { "vite": "bin/vite.js" } }, "sha512-s4BJJ+5y1pYL6Otw51FHhVJQhPnuRinKig64g/1+EUNaJsd3gCKdD31IPFvswUgW9/60QT9oFHbZHbQK5imcxw=="],
 
     "vitefu": ["vitefu@1.1.3", "", { "peerDependencies": { "vite": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0" }, "optionalPeers": ["vite"] }, "sha512-ub4okH7Z5KLjb6hDyjqrGXqWtWvoYdU3IGm/NorpgHncKoLTCfRIbvlhBm7r0YstIaQRYlp4yEbFqDcKSzXSSg=="],
 
@@ -2619,6 +2622,10 @@
 
     "csso/css-tree": ["css-tree@2.2.1", "", { "dependencies": { "mdn-data": "2.0.28", "source-map-js": "^1.0.1" } }, "sha512-OA0mILzGc1kCOCSJerOeqDxDQ4HOh+G8NbOJFOTgOCzpw7fCBubk0fEyxp8AgOL/jvLgYA/uV0cMbe43ElF1JA=="],
 
+    "debug-vsc-extn-in-web/vite": ["vite@5.4.21", "", { "dependencies": { "esbuild": "^0.21.3", "postcss": "^8.4.43", "rollup": "^4.20.0" }, "optionalDependencies": { "fsevents": "~2.3.3" }, "peerDependencies": { "@types/node": "^18.0.0 || >=20.0.0", "less": "*", "lightningcss": "^1.21.0", "sass": "*", "sass-embedded": "*", "stylus": "*", "sugarss": "*", "terser": "^5.4.0" }, "optionalPeers": ["@types/node", "less", "lightningcss", "sass", "sass-embedded", "stylus", "sugarss", "terser"], "bin": { "vite": "bin/vite.js" } }, "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw=="],
+
+    "demo/vite": ["vite@5.4.21", "", { "dependencies": { "esbuild": "^0.21.3", "postcss": "^8.4.43", "rollup": "^4.20.0" }, "optionalDependencies": { "fsevents": "~2.3.3" }, "peerDependencies": { "@types/node": "^18.0.0 || >=20.0.0", "less": "*", "lightningcss": "^1.21.0", "sass": "*", "sass-embedded": "*", "stylus": "*", "sugarss": "*", "terser": "^5.4.0" }, "optionalPeers": ["@types/node", "less", "lightningcss", "sass", "sass-embedded", "stylus", "sugarss", "terser"], "bin": { "vite": "bin/vite.js" } }, "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw=="],
+
     "dir-glob/path-type": ["path-type@4.0.0", "", {}, "sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw=="],
 
     "encoding-sniffer/iconv-lite": ["iconv-lite@0.6.3", "", { "dependencies": { "safer-buffer": ">= 2.1.2 < 3.0.0" } }, "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw=="],
@@ -2709,16 +2716,12 @@
 
     "unstorage/chokidar": ["chokidar@5.0.0", "", { "dependencies": { "readdirp": "^5.0.0" } }, "sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw=="],
 
-    "vscode-prosemark/tsdown": ["tsdown@0.14.2", "", { "dependencies": { "ansis": "^4.1.0", "cac": "^6.7.14", "chokidar": "^4.0.3", "debug": "^4.4.1", "diff": "^8.0.2", "empathic": "^2.0.0", "hookable": "^5.5.3", "rolldown": "latest", "rolldown-plugin-dts": "^0.15.8", "semver": "^7.7.2", "tinyexec": "^1.0.1", "tinyglobby": "^0.2.14", "tree-kill": "^1.2.2", "unconfig": "^7.3.3" }, "peerDependencies": { "@arethetypeswrong/core": "^0.18.1", "publint": "^0.3.0", "typescript": "^5.0.0", "unplugin-lightningcss": "^0.4.0", "unplugin-unused": "^0.5.0" }, "optionalPeers": ["@arethetypeswrong/core", "publint", "typescript", "unplugin-lightningcss", "unplugin-unused"], "bin": { "tsdown": "dist/run.mjs" } }, "sha512-6ThtxVZoTlR5YJov5rYvH8N1+/S/rD/pGfehdCLGznGgbxz+73EASV1tsIIZkLw2n+SXcERqHhcB/OkyxdKv3A=="],
+    "vite/rolldown": ["rolldown@1.0.2", "", { "dependencies": { "@oxc-project/types": "=0.132.0", "@rolldown/pluginutils": "^1.0.0" }, "optionalDependencies": { "@rolldown/binding-android-arm64": "1.0.2", "@rolldown/binding-darwin-arm64": "1.0.2", "@rolldown/binding-darwin-x64": "1.0.2", "@rolldown/binding-freebsd-x64": "1.0.2", "@rolldown/binding-linux-arm-gnueabihf": "1.0.2", "@rolldown/binding-linux-arm64-gnu": "1.0.2", "@rolldown/binding-linux-arm64-musl": "1.0.2", "@rolldown/binding-linux-ppc64-gnu": "1.0.2", "@rolldown/binding-linux-s390x-gnu": "1.0.2", "@rolldown/binding-linux-x64-gnu": "1.0.2", "@rolldown/binding-linux-x64-musl": "1.0.2", "@rolldown/binding-openharmony-arm64": "1.0.2", "@rolldown/binding-wasm32-wasi": "1.0.2", "@rolldown/binding-win32-arm64-msvc": "1.0.2", "@rolldown/binding-win32-x64-msvc": "1.0.2" }, "bin": { "rolldown": "./bin/cli.mjs" } }, "sha512-oZx5zVDtVB44AW3eaifgDml1gWRDZGvjcfdxonE4swNPG98PrrXjaO/KrnUjzlMnztCCRVlUueA1kCXhARGk6g=="],
 
-    "vscode-prosemark/vite": ["vite@8.0.14", "", { "dependencies": { "lightningcss": "^1.32.0", "picomatch": "^4.0.4", "postcss": "^8.5.15", "rolldown": "1.0.2", "tinyglobby": "^0.2.16" }, "optionalDependencies": { "fsevents": "~2.3.3" }, "peerDependencies": { "@types/node": "^20.19.0 || >=22.12.0", "@vitejs/devtools": "^0.1.18", "esbuild": "^0.27.0 || ^0.28.0", "jiti": ">=1.21.0", "less": "^4.0.0", "sass": "^1.70.0", "sass-embedded": "^1.70.0", "stylus": ">=0.54.8", "sugarss": "^5.0.0", "terser": "^5.16.0", "tsx": "^4.8.1", "yaml": "^2.4.2" }, "optionalPeers": ["@types/node", "@vitejs/devtools", "esbuild", "jiti", "less", "sass", "sass-embedded", "stylus", "sugarss", "terser", "tsx", "yaml"], "bin": { "vite": "bin/vite.js" } }, "sha512-s4BJJ+5y1pYL6Otw51FHhVJQhPnuRinKig64g/1+EUNaJsd3gCKdD31IPFvswUgW9/60QT9oFHbZHbQK5imcxw=="],
+    "vscode-prosemark/tsdown": ["tsdown@0.14.2", "", { "dependencies": { "ansis": "^4.1.0", "cac": "^6.7.14", "chokidar": "^4.0.3", "debug": "^4.4.1", "diff": "^8.0.2", "empathic": "^2.0.0", "hookable": "^5.5.3", "rolldown": "latest", "rolldown-plugin-dts": "^0.15.8", "semver": "^7.7.2", "tinyexec": "^1.0.1", "tinyglobby": "^0.2.14", "tree-kill": "^1.2.2", "unconfig": "^7.3.3" }, "peerDependencies": { "@arethetypeswrong/core": "^0.18.1", "publint": "^0.3.0", "typescript": "^5.0.0", "unplugin-lightningcss": "^0.4.0", "unplugin-unused": "^0.5.0" }, "optionalPeers": ["@arethetypeswrong/core", "publint", "typescript", "unplugin-lightningcss", "unplugin-unused"], "bin": { "tsdown": "dist/run.mjs" } }, "sha512-6ThtxVZoTlR5YJov5rYvH8N1+/S/rD/pGfehdCLGznGgbxz+73EASV1tsIIZkLw2n+SXcERqHhcB/OkyxdKv3A=="],
 
     "vscode-prosemark-cspell-integration/tsdown": ["tsdown@0.14.2", "", { "dependencies": { "ansis": "^4.1.0", "cac": "^6.7.14", "chokidar": "^4.0.3", "debug": "^4.4.1", "diff": "^8.0.2", "empathic": "^2.0.0", "hookable": "^5.5.3", "rolldown": "latest", "rolldown-plugin-dts": "^0.15.8", "semver": "^7.7.2", "tinyexec": "^1.0.1", "tinyglobby": "^0.2.14", "tree-kill": "^1.2.2", "unconfig": "^7.3.3" }, "peerDependencies": { "@arethetypeswrong/core": "^0.18.1", "publint": "^0.3.0", "typescript": "^5.0.0", "unplugin-lightningcss": "^0.4.0", "unplugin-unused": "^0.5.0" }, "optionalPeers": ["@arethetypeswrong/core", "publint", "typescript", "unplugin-lightningcss", "unplugin-unused"], "bin": { "tsdown": "dist/run.mjs" } }, "sha512-6ThtxVZoTlR5YJov5rYvH8N1+/S/rD/pGfehdCLGznGgbxz+73EASV1tsIIZkLw2n+SXcERqHhcB/OkyxdKv3A=="],
 
-    "vscode-prosemark-cspell-integration/vite": ["vite@8.0.14", "", { "dependencies": { "lightningcss": "^1.32.0", "picomatch": "^4.0.4", "postcss": "^8.5.15", "rolldown": "1.0.2", "tinyglobby": "^0.2.16" }, "optionalDependencies": { "fsevents": "~2.3.3" }, "peerDependencies": { "@types/node": "^20.19.0 || >=22.12.0", "@vitejs/devtools": "^0.1.18", "esbuild": "^0.27.0 || ^0.28.0", "jiti": ">=1.21.0", "less": "^4.0.0", "sass": "^1.70.0", "sass-embedded": "^1.70.0", "stylus": ">=0.54.8", "sugarss": "^5.0.0", "terser": "^5.16.0", "tsx": "^4.8.1", "yaml": "^2.4.2" }, "optionalPeers": ["@types/node", "@vitejs/devtools", "esbuild", "jiti", "less", "sass", "sass-embedded", "stylus", "sugarss", "terser", "tsx", "yaml"], "bin": { "vite": "bin/vite.js" } }, "sha512-s4BJJ+5y1pYL6Otw51FHhVJQhPnuRinKig64g/1+EUNaJsd3gCKdD31IPFvswUgW9/60QT9oFHbZHbQK5imcxw=="],
-
-    "vscode-prosemark-latex-integration/vite": ["vite@8.0.14", "", { "dependencies": { "lightningcss": "^1.32.0", "picomatch": "^4.0.4", "postcss": "^8.5.15", "rolldown": "1.0.2", "tinyglobby": "^0.2.16" }, "optionalDependencies": { "fsevents": "~2.3.3" }, "peerDependencies": { "@types/node": "^20.19.0 || >=22.12.0", "@vitejs/devtools": "^0.1.18", "esbuild": "^0.27.0 || ^0.28.0", "jiti": ">=1.21.0", "less": "^4.0.0", "sass": "^1.70.0", "sass-embedded": "^1.70.0", "stylus": ">=0.54.8", "sugarss": "^5.0.0", "terser": "^5.16.0", "tsx": "^4.8.1", "yaml": "^2.4.2" }, "optionalPeers": ["@types/node", "@vitejs/devtools", "esbuild", "jiti", "less", "sass", "sass-embedded", "stylus", "sugarss", "terser", "tsx", "yaml"], "bin": { "vite": "bin/vite.js" } }, "sha512-s4BJJ+5y1pYL6Otw51FHhVJQhPnuRinKig64g/1+EUNaJsd3gCKdD31IPFvswUgW9/60QT9oFHbZHbQK5imcxw=="],
-
     "whatwg-encoding/iconv-lite": ["iconv-lite@0.6.3", "", { "dependencies": { "safer-buffer": ">= 2.1.2 < 3.0.0" } }, "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw=="],
 
     "widest-line/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
@@ -2889,15 +2892,41 @@
 
     "unstorage/chokidar/readdirp": ["readdirp@5.0.0", "", {}, "sha512-9u/XQ1pvrQtYyMpZe7DXKv2p5CNvyVwzUB6uhLAnQwHMSgKMBR62lc7AHljaeteeHXn11XTAaLLUVZYVZyuRBQ=="],
 
-    "vscode-prosemark-cspell-integration/tsdown/rolldown-plugin-dts": ["rolldown-plugin-dts@0.15.10", "", { "dependencies": { "@babel/generator": "^7.28.3", "@babel/parser": "^7.28.3", "@babel/types": "^7.28.2", "ast-kit": "^2.1.2", "birpc": "^2.5.0", "debug": "^4.4.1", "dts-resolver": "^2.1.2", "get-tsconfig": "^4.10.1" }, "peerDependencies": { "@typescript/native-preview": ">=7.0.0-dev.20250601.1", "rolldown": "^1.0.0-beta.9", "typescript": "^5.0.0", "vue-tsc": "~3.0.3" }, "optionalPeers": ["@typescript/native-preview", "typescript", "vue-tsc"] }, "sha512-8cPVAVQUo9tYAoEpc3jFV9RxSil13hrRRg8cHC9gLXxRMNtWPc1LNMSDXzjyD+5Vny49sDZH77JlXp/vlc4I3g=="],
+    "vite/rolldown/@oxc-project/types": ["@oxc-project/types@0.132.0", "", {}, "sha512-FESMOxil5Se014ui/Eq8fT5uHJo6nIRwH0PfJrZJXs6Gek3ZVFOrpUv3YIZT20m+extU98Hg1Ym72U58rlsxUQ=="],
 
-    "vscode-prosemark-cspell-integration/vite/rolldown": ["rolldown@1.0.2", "", { "dependencies": { "@oxc-project/types": "=0.132.0", "@rolldown/pluginutils": "^1.0.0" }, "optionalDependencies": { "@rolldown/binding-android-arm64": "1.0.2", "@rolldown/binding-darwin-arm64": "1.0.2", "@rolldown/binding-darwin-x64": "1.0.2", "@rolldown/binding-freebsd-x64": "1.0.2", "@rolldown/binding-linux-arm-gnueabihf": "1.0.2", "@rolldown/binding-linux-arm64-gnu": "1.0.2", "@rolldown/binding-linux-arm64-musl": "1.0.2", "@rolldown/binding-linux-ppc64-gnu": "1.0.2", "@rolldown/binding-linux-s390x-gnu": "1.0.2", "@rolldown/binding-linux-x64-gnu": "1.0.2", "@rolldown/binding-linux-x64-musl": "1.0.2", "@rolldown/binding-openharmony-arm64": "1.0.2", "@rolldown/binding-wasm32-wasi": "1.0.2", "@rolldown/binding-win32-arm64-msvc": "1.0.2", "@rolldown/binding-win32-x64-msvc": "1.0.2" }, "bin": { "rolldown": "./bin/cli.mjs" } }, "sha512-oZx5zVDtVB44AW3eaifgDml1gWRDZGvjcfdxonE4swNPG98PrrXjaO/KrnUjzlMnztCCRVlUueA1kCXhARGk6g=="],
+    "vite/rolldown/@rolldown/binding-android-arm64": ["@rolldown/binding-android-arm64@1.0.2", "", { "os": "android", "cpu": "arm64" }, "sha512-ZS4D1JPGn/MYQN/SYDWftIE/nVsM8j/AFOYEzAoOE2O3NktQOZru+/vYXGbR/qtdLdIfGCP0lcoJiYVzsEz+iQ=="],
 
-    "vscode-prosemark-latex-integration/vite/rolldown": ["rolldown@1.0.2", "", { "dependencies": { "@oxc-project/types": "=0.132.0", "@rolldown/pluginutils": "^1.0.0" }, "optionalDependencies": { "@rolldown/binding-android-arm64": "1.0.2", "@rolldown/binding-darwin-arm64": "1.0.2", "@rolldown/binding-darwin-x64": "1.0.2", "@rolldown/binding-freebsd-x64": "1.0.2", "@rolldown/binding-linux-arm-gnueabihf": "1.0.2", "@rolldown/binding-linux-arm64-gnu": "1.0.2", "@rolldown/binding-linux-arm64-musl": "1.0.2", "@rolldown/binding-linux-ppc64-gnu": "1.0.2", "@rolldown/binding-linux-s390x-gnu": "1.0.2", "@rolldown/binding-linux-x64-gnu": "1.0.2", "@rolldown/binding-linux-x64-musl": "1.0.2", "@rolldown/binding-openharmony-arm64": "1.0.2", "@rolldown/binding-wasm32-wasi": "1.0.2", "@rolldown/binding-win32-arm64-msvc": "1.0.2", "@rolldown/binding-win32-x64-msvc": "1.0.2" }, "bin": { "rolldown": "./bin/cli.mjs" } }, "sha512-oZx5zVDtVB44AW3eaifgDml1gWRDZGvjcfdxonE4swNPG98PrrXjaO/KrnUjzlMnztCCRVlUueA1kCXhARGk6g=="],
+    "vite/rolldown/@rolldown/binding-darwin-arm64": ["@rolldown/binding-darwin-arm64@1.0.2", "", { "os": "darwin", "cpu": "arm64" }, "sha512-vdFA9+C/rekyGce7WqHs/xoT0ioZEWaOFyZLIV1mEeNFaFDUQrPIo8Vs2GvJ6eetb3rzDUtUBgzto3ExpXJB3w=="],
 
-    "vscode-prosemark/tsdown/rolldown-plugin-dts": ["rolldown-plugin-dts@0.15.10", "", { "dependencies": { "@babel/generator": "^7.28.3", "@babel/parser": "^7.28.3", "@babel/types": "^7.28.2", "ast-kit": "^2.1.2", "birpc": "^2.5.0", "debug": "^4.4.1", "dts-resolver": "^2.1.2", "get-tsconfig": "^4.10.1" }, "peerDependencies": { "@typescript/native-preview": ">=7.0.0-dev.20250601.1", "rolldown": "^1.0.0-beta.9", "typescript": "^5.0.0", "vue-tsc": "~3.0.3" }, "optionalPeers": ["@typescript/native-preview", "typescript", "vue-tsc"] }, "sha512-8cPVAVQUo9tYAoEpc3jFV9RxSil13hrRRg8cHC9gLXxRMNtWPc1LNMSDXzjyD+5Vny49sDZH77JlXp/vlc4I3g=="],
+    "vite/rolldown/@rolldown/binding-darwin-x64": ["@rolldown/binding-darwin-x64@1.0.2", "", { "os": "darwin", "cpu": "x64" }, "sha512-BewSOwTHazv77DTYiAZXSqqKZ4KP/KonFisDMVU7PImxoWfB2aepnPhd2E4SWz3zDzYgDNbs6jBmTdgNnF02GA=="],
+
+    "vite/rolldown/@rolldown/binding-freebsd-x64": ["@rolldown/binding-freebsd-x64@1.0.2", "", { "os": "freebsd", "cpu": "x64" }, "sha512-m41o7M0YWtUdqk61Tb+jnKb2rN++iRdIASlExkUoKfIAH30DOHCB8fVLzSUpbWHHU8esmEioY62PxzexE8MBuA=="],
+
+    "vite/rolldown/@rolldown/binding-linux-arm-gnueabihf": ["@rolldown/binding-linux-arm-gnueabihf@1.0.2", "", { "os": "linux", "cpu": "arm" }, "sha512-jcojB9H7W/jS29pMKWAK1N+fU99vXodHDTatS3b3y/XSOCiHo0kkA74pL3jJmkoQtYpOCxDvaKs1fo2Ij/1X5w=="],
+
+    "vite/rolldown/@rolldown/binding-linux-arm64-gnu": ["@rolldown/binding-linux-arm64-gnu@1.0.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-1jn6qDU5iiOgFgygDzKUuKP0maTi0/f1+sBLgvij/76C77Nm3ts6ufz9Bjg5q5dduxiUIxtq86JIoBvo1xQ4Ig=="],
+
+    "vite/rolldown/@rolldown/binding-linux-arm64-musl": ["@rolldown/binding-linux-arm64-musl@1.0.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-QVLO/czFMdoMFSqlX3bcswcJNm/23r+qoa/jgtmFc/qEp6/jXmIkDjF/XIo8dPfGaiwy1xfQn8o77L79GeXFgw=="],
+
+    "vite/rolldown/@rolldown/binding-linux-ppc64-gnu": ["@rolldown/binding-linux-ppc64-gnu@1.0.2", "", { "os": "linux", "cpu": "ppc64" }, "sha512-hgO5Abm0w5UL6FEa2iFnZqo2KlK7TQ5QhV5x09hujBf7t5KzHQ1VmfPuTpqRy/rNlSxua3eWH374xxiVrP+lcA=="],
+
+    "vite/rolldown/@rolldown/binding-linux-s390x-gnu": ["@rolldown/binding-linux-s390x-gnu@1.0.2", "", { "os": "linux", "cpu": "s390x" }, "sha512-fy8rXxuYEu602abC8MUNaPjYLIFzReOaEIEMKMUa0rFEUxNpVXhs15KSSQ4qlqSaM7B6rcj9rDZgADh/IGDzLQ=="],
+
+    "vite/rolldown/@rolldown/binding-linux-x64-gnu": ["@rolldown/binding-linux-x64-gnu@1.0.2", "", { "os": "linux", "cpu": "x64" }, "sha512-0+bOkiQ779+r1WpoHOWHqncvyySci0vKph+myNDYb+im6meJAzHQXay6oEgnkHuUGouM1LKTZwqKpBow6Kj7CQ=="],
+
+    "vite/rolldown/@rolldown/binding-linux-x64-musl": ["@rolldown/binding-linux-x64-musl@1.0.2", "", { "os": "linux", "cpu": "x64" }, "sha512-mjSkrzZK5Qsl0a9d1JgILOiuZOSDTVdKENcSXBoqbzSrspLR/4/IRVDo5wd2GgZjNss/viBFJdeq+j7qH2nypw=="],
+
+    "vite/rolldown/@rolldown/binding-openharmony-arm64": ["@rolldown/binding-openharmony-arm64@1.0.2", "", { "os": "none", "cpu": "arm64" }, "sha512-1v5vHasdfQAZoEHakBV72LIFAC9JjnymsiKxp+GEr/ma3+NJCPSaYK+qavInOovJkgwFrs7GccX2d6IgDA3Z5w=="],
 
-    "vscode-prosemark/vite/rolldown": ["rolldown@1.0.2", "", { "dependencies": { "@oxc-project/types": "=0.132.0", "@rolldown/pluginutils": "^1.0.0" }, "optionalDependencies": { "@rolldown/binding-android-arm64": "1.0.2", "@rolldown/binding-darwin-arm64": "1.0.2", "@rolldown/binding-darwin-x64": "1.0.2", "@rolldown/binding-freebsd-x64": "1.0.2", "@rolldown/binding-linux-arm-gnueabihf": "1.0.2", "@rolldown/binding-linux-arm64-gnu": "1.0.2", "@rolldown/binding-linux-arm64-musl": "1.0.2", "@rolldown/binding-linux-ppc64-gnu": "1.0.2", "@rolldown/binding-linux-s390x-gnu": "1.0.2", "@rolldown/binding-linux-x64-gnu": "1.0.2", "@rolldown/binding-linux-x64-musl": "1.0.2", "@rolldown/binding-openharmony-arm64": "1.0.2", "@rolldown/binding-wasm32-wasi": "1.0.2", "@rolldown/binding-win32-arm64-msvc": "1.0.2", "@rolldown/binding-win32-x64-msvc": "1.0.2" }, "bin": { "rolldown": "./bin/cli.mjs" } }, "sha512-oZx5zVDtVB44AW3eaifgDml1gWRDZGvjcfdxonE4swNPG98PrrXjaO/KrnUjzlMnztCCRVlUueA1kCXhARGk6g=="],
+    "vite/rolldown/@rolldown/binding-wasm32-wasi": ["@rolldown/binding-wasm32-wasi@1.0.2", "", { "dependencies": { "@emnapi/core": "1.10.0", "@emnapi/runtime": "1.10.0", "@napi-rs/wasm-runtime": "^1.1.4" }, "cpu": "none" }, "sha512-mb1VobWn6NheziTk5/WEaR6AKVbrwT5sOi6C7zk3gy/pD1qtJfU1j4PgTo2NJnOtbL9Dl3Aeei8w9jJ7qC2jZQ=="],
+
+    "vite/rolldown/@rolldown/binding-win32-arm64-msvc": ["@rolldown/binding-win32-arm64-msvc@1.0.2", "", { "os": "win32", "cpu": "arm64" }, "sha512-SqKonF56vA/L2yHwHYcEp2P34URpOZ7d1fS635cTkpDnUtEGdUbhI6NzsPdqeSWvAAeGDrxjWjNmibDIdFf9/A=="],
+
+    "vite/rolldown/@rolldown/binding-win32-x64-msvc": ["@rolldown/binding-win32-x64-msvc@1.0.2", "", { "os": "win32", "cpu": "x64" }, "sha512-v7qRI7gXLRINcOGXt+7YmAZ6iFuyZVMIoXAxhd8oP+DR9dLfL9GfNIx7PLMxmhZdvq8waUJBQiWN9EKNy+TRBQ=="],
+
+    "vscode-prosemark-cspell-integration/tsdown/rolldown-plugin-dts": ["rolldown-plugin-dts@0.15.10", "", { "dependencies": { "@babel/generator": "^7.28.3", "@babel/parser": "^7.28.3", "@babel/types": "^7.28.2", "ast-kit": "^2.1.2", "birpc": "^2.5.0", "debug": "^4.4.1", "dts-resolver": "^2.1.2", "get-tsconfig": "^4.10.1" }, "peerDependencies": { "@typescript/native-preview": ">=7.0.0-dev.20250601.1", "rolldown": "^1.0.0-beta.9", "typescript": "^5.0.0", "vue-tsc": "~3.0.3" }, "optionalPeers": ["@typescript/native-preview", "typescript", "vue-tsc"] }, "sha512-8cPVAVQUo9tYAoEpc3jFV9RxSil13hrRRg8cHC9gLXxRMNtWPc1LNMSDXzjyD+5Vny49sDZH77JlXp/vlc4I3g=="],
+
+    "vscode-prosemark/tsdown/rolldown-plugin-dts": ["rolldown-plugin-dts@0.15.10", "", { "dependencies": { "@babel/generator": "^7.28.3", "@babel/parser": "^7.28.3", "@babel/types": "^7.28.2", "ast-kit": "^2.1.2", "birpc": "^2.5.0", "debug": "^4.4.1", "dts-resolver": "^2.1.2", "get-tsconfig": "^4.10.1" }, "peerDependencies": { "@typescript/native-preview": ">=7.0.0-dev.20250601.1", "rolldown": "^1.0.0-beta.9", "typescript": "^5.0.0", "vue-tsc": "~3.0.3" }, "optionalPeers": ["@typescript/native-preview", "typescript", "vue-tsc"] }, "sha512-8cPVAVQUo9tYAoEpc3jFV9RxSil13hrRRg8cHC9gLXxRMNtWPc1LNMSDXzjyD+5Vny49sDZH77JlXp/vlc4I3g=="],
 
     "widest-line/string-width/emoji-regex": ["emoji-regex@10.6.0", "", {}, "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A=="],
 
@@ -2973,102 +3002,6 @@
 
     "typedoc/minimatch/brace-expansion/balanced-match": ["balanced-match@4.0.4", "", {}, "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA=="],
 
-    "vscode-prosemark-cspell-integration/vite/rolldown/@oxc-project/types": ["@oxc-project/types@0.132.0", "", {}, "sha512-FESMOxil5Se014ui/Eq8fT5uHJo6nIRwH0PfJrZJXs6Gek3ZVFOrpUv3YIZT20m+extU98Hg1Ym72U58rlsxUQ=="],
-
-    "vscode-prosemark-cspell-integration/vite/rolldown/@rolldown/binding-android-arm64": ["@rolldown/binding-android-arm64@1.0.2", "", { "os": "android", "cpu": "arm64" }, "sha512-ZS4D1JPGn/MYQN/SYDWftIE/nVsM8j/AFOYEzAoOE2O3NktQOZru+/vYXGbR/qtdLdIfGCP0lcoJiYVzsEz+iQ=="],
-
-    "vscode-prosemark-cspell-integration/vite/rolldown/@rolldown/binding-darwin-arm64": ["@rolldown/binding-darwin-arm64@1.0.2", "", { "os": "darwin", "cpu": "arm64" }, "sha512-vdFA9+C/rekyGce7WqHs/xoT0ioZEWaOFyZLIV1mEeNFaFDUQrPIo8Vs2GvJ6eetb3rzDUtUBgzto3ExpXJB3w=="],
-
-    "vscode-prosemark-cspell-integration/vite/rolldown/@rolldown/binding-darwin-x64": ["@rolldown/binding-darwin-x64@1.0.2", "", { "os": "darwin", "cpu": "x64" }, "sha512-BewSOwTHazv77DTYiAZXSqqKZ4KP/KonFisDMVU7PImxoWfB2aepnPhd2E4SWz3zDzYgDNbs6jBmTdgNnF02GA=="],
-
-    "vscode-prosemark-cspell-integration/vite/rolldown/@rolldown/binding-freebsd-x64": ["@rolldown/binding-freebsd-x64@1.0.2", "", { "os": "freebsd", "cpu": "x64" }, "sha512-m41o7M0YWtUdqk61Tb+jnKb2rN++iRdIASlExkUoKfIAH30DOHCB8fVLzSUpbWHHU8esmEioY62PxzexE8MBuA=="],
-
-    "vscode-prosemark-cspell-integration/vite/rolldown/@rolldown/binding-linux-arm-gnueabihf": ["@rolldown/binding-linux-arm-gnueabihf@1.0.2", "", { "os": "linux", "cpu": "arm" }, "sha512-jcojB9H7W/jS29pMKWAK1N+fU99vXodHDTatS3b3y/XSOCiHo0kkA74pL3jJmkoQtYpOCxDvaKs1fo2Ij/1X5w=="],
-
-    "vscode-prosemark-cspell-integration/vite/rolldown/@rolldown/binding-linux-arm64-gnu": ["@rolldown/binding-linux-arm64-gnu@1.0.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-1jn6qDU5iiOgFgygDzKUuKP0maTi0/f1+sBLgvij/76C77Nm3ts6ufz9Bjg5q5dduxiUIxtq86JIoBvo1xQ4Ig=="],
-
-    "vscode-prosemark-cspell-integration/vite/rolldown/@rolldown/binding-linux-arm64-musl": ["@rolldown/binding-linux-arm64-musl@1.0.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-QVLO/czFMdoMFSqlX3bcswcJNm/23r+qoa/jgtmFc/qEp6/jXmIkDjF/XIo8dPfGaiwy1xfQn8o77L79GeXFgw=="],
-
-    "vscode-prosemark-cspell-integration/vite/rolldown/@rolldown/binding-linux-ppc64-gnu": ["@rolldown/binding-linux-ppc64-gnu@1.0.2", "", { "os": "linux", "cpu": "ppc64" }, "sha512-hgO5Abm0w5UL6FEa2iFnZqo2KlK7TQ5QhV5x09hujBf7t5KzHQ1VmfPuTpqRy/rNlSxua3eWH374xxiVrP+lcA=="],
-
-    "vscode-prosemark-cspell-integration/vite/rolldown/@rolldown/binding-linux-s390x-gnu": ["@rolldown/binding-linux-s390x-gnu@1.0.2", "", { "os": "linux", "cpu": "s390x" }, "sha512-fy8rXxuYEu602abC8MUNaPjYLIFzReOaEIEMKMUa0rFEUxNpVXhs15KSSQ4qlqSaM7B6rcj9rDZgADh/IGDzLQ=="],
-
-    "vscode-prosemark-cspell-integration/vite/rolldown/@rolldown/binding-linux-x64-gnu": ["@rolldown/binding-linux-x64-gnu@1.0.2", "", { "os": "linux", "cpu": "x64" }, "sha512-0+bOkiQ779+r1WpoHOWHqncvyySci0vKph+myNDYb+im6meJAzHQXay6oEgnkHuUGouM1LKTZwqKpBow6Kj7CQ=="],
-
-    "vscode-prosemark-cspell-integration/vite/rolldown/@rolldown/binding-linux-x64-musl": ["@rolldown/binding-linux-x64-musl@1.0.2", "", { "os": "linux", "cpu": "x64" }, "sha512-mjSkrzZK5Qsl0a9d1JgILOiuZOSDTVdKENcSXBoqbzSrspLR/4/IRVDo5wd2GgZjNss/viBFJdeq+j7qH2nypw=="],
-
-    "vscode-prosemark-cspell-integration/vite/rolldown/@rolldown/binding-openharmony-arm64": ["@rolldown/binding-openharmony-arm64@1.0.2", "", { "os": "none", "cpu": "arm64" }, "sha512-1v5vHasdfQAZoEHakBV72LIFAC9JjnymsiKxp+GEr/ma3+NJCPSaYK+qavInOovJkgwFrs7GccX2d6IgDA3Z5w=="],
-
-    "vscode-prosemark-cspell-integration/vite/rolldown/@rolldown/binding-wasm32-wasi": ["@rolldown/binding-wasm32-wasi@1.0.2", "", { "dependencies": { "@emnapi/core": "1.10.0", "@emnapi/runtime": "1.10.0", "@napi-rs/wasm-runtime": "^1.1.4" }, "cpu": "none" }, "sha512-mb1VobWn6NheziTk5/WEaR6AKVbrwT5sOi6C7zk3gy/pD1qtJfU1j4PgTo2NJnOtbL9Dl3Aeei8w9jJ7qC2jZQ=="],
-
-    "vscode-prosemark-cspell-integration/vite/rolldown/@rolldown/binding-win32-arm64-msvc": ["@rolldown/binding-win32-arm64-msvc@1.0.2", "", { "os": "win32", "cpu": "arm64" }, "sha512-SqKonF56vA/L2yHwHYcEp2P34URpOZ7d1fS635cTkpDnUtEGdUbhI6NzsPdqeSWvAAeGDrxjWjNmibDIdFf9/A=="],
-
-    "vscode-prosemark-cspell-integration/vite/rolldown/@rolldown/binding-win32-x64-msvc": ["@rolldown/binding-win32-x64-msvc@1.0.2", "", { "os": "win32", "cpu": "x64" }, "sha512-v7qRI7gXLRINcOGXt+7YmAZ6iFuyZVMIoXAxhd8oP+DR9dLfL9GfNIx7PLMxmhZdvq8waUJBQiWN9EKNy+TRBQ=="],
-
-    "vscode-prosemark-latex-integration/vite/rolldown/@oxc-project/types": ["@oxc-project/types@0.132.0", "", {}, "sha512-FESMOxil5Se014ui/Eq8fT5uHJo6nIRwH0PfJrZJXs6Gek3ZVFOrpUv3YIZT20m+extU98Hg1Ym72U58rlsxUQ=="],
-
-    "vscode-prosemark-latex-integration/vite/rolldown/@rolldown/binding-android-arm64": ["@rolldown/binding-android-arm64@1.0.2", "", { "os": "android", "cpu": "arm64" }, "sha512-ZS4D1JPGn/MYQN/SYDWftIE/nVsM8j/AFOYEzAoOE2O3NktQOZru+/vYXGbR/qtdLdIfGCP0lcoJiYVzsEz+iQ=="],
-
-    "vscode-prosemark-latex-integration/vite/rolldown/@rolldown/binding-darwin-arm64": ["@rolldown/binding-darwin-arm64@1.0.2", "", { "os": "darwin", "cpu": "arm64" }, "sha512-vdFA9+C/rekyGce7WqHs/xoT0ioZEWaOFyZLIV1mEeNFaFDUQrPIo8Vs2GvJ6eetb3rzDUtUBgzto3ExpXJB3w=="],
-
-    "vscode-prosemark-latex-integration/vite/rolldown/@rolldown/binding-darwin-x64": ["@rolldown/binding-darwin-x64@1.0.2", "", { "os": "darwin", "cpu": "x64" }, "sha512-BewSOwTHazv77DTYiAZXSqqKZ4KP/KonFisDMVU7PImxoWfB2aepnPhd2E4SWz3zDzYgDNbs6jBmTdgNnF02GA=="],
-
-    "vscode-prosemark-latex-integration/vite/rolldown/@rolldown/binding-freebsd-x64": ["@rolldown/binding-freebsd-x64@1.0.2", "", { "os": "freebsd", "cpu": "x64" }, "sha512-m41o7M0YWtUdqk61Tb+jnKb2rN++iRdIASlExkUoKfIAH30DOHCB8fVLzSUpbWHHU8esmEioY62PxzexE8MBuA=="],
-
-    "vscode-prosemark-latex-integration/vite/rolldown/@rolldown/binding-linux-arm-gnueabihf": ["@rolldown/binding-linux-arm-gnueabihf@1.0.2", "", { "os": "linux", "cpu": "arm" }, "sha512-jcojB9H7W/jS29pMKWAK1N+fU99vXodHDTatS3b3y/XSOCiHo0kkA74pL3jJmkoQtYpOCxDvaKs1fo2Ij/1X5w=="],
-
-    "vscode-prosemark-latex-integration/vite/rolldown/@rolldown/binding-linux-arm64-gnu": ["@rolldown/binding-linux-arm64-gnu@1.0.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-1jn6qDU5iiOgFgygDzKUuKP0maTi0/f1+sBLgvij/76C77Nm3ts6ufz9Bjg5q5dduxiUIxtq86JIoBvo1xQ4Ig=="],
-
-    "vscode-prosemark-latex-integration/vite/rolldown/@rolldown/binding-linux-arm64-musl": ["@rolldown/binding-linux-arm64-musl@1.0.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-QVLO/czFMdoMFSqlX3bcswcJNm/23r+qoa/jgtmFc/qEp6/jXmIkDjF/XIo8dPfGaiwy1xfQn8o77L79GeXFgw=="],
-
-    "vscode-prosemark-latex-integration/vite/rolldown/@rolldown/binding-linux-ppc64-gnu": ["@rolldown/binding-linux-ppc64-gnu@1.0.2", "", { "os": "linux", "cpu": "ppc64" }, "sha512-hgO5Abm0w5UL6FEa2iFnZqo2KlK7TQ5QhV5x09hujBf7t5KzHQ1VmfPuTpqRy/rNlSxua3eWH374xxiVrP+lcA=="],
-
-    "vscode-prosemark-latex-integration/vite/rolldown/@rolldown/binding-linux-s390x-gnu": ["@rolldown/binding-linux-s390x-gnu@1.0.2", "", { "os": "linux", "cpu": "s390x" }, "sha512-fy8rXxuYEu602abC8MUNaPjYLIFzReOaEIEMKMUa0rFEUxNpVXhs15KSSQ4qlqSaM7B6rcj9rDZgADh/IGDzLQ=="],
-
-    "vscode-prosemark-latex-integration/vite/rolldown/@rolldown/binding-linux-x64-gnu": ["@rolldown/binding-linux-x64-gnu@1.0.2", "", { "os": "linux", "cpu": "x64" }, "sha512-0+bOkiQ779+r1WpoHOWHqncvyySci0vKph+myNDYb+im6meJAzHQXay6oEgnkHuUGouM1LKTZwqKpBow6Kj7CQ=="],
-
-    "vscode-prosemark-latex-integration/vite/rolldown/@rolldown/binding-linux-x64-musl": ["@rolldown/binding-linux-x64-musl@1.0.2", "", { "os": "linux", "cpu": "x64" }, "sha512-mjSkrzZK5Qsl0a9d1JgILOiuZOSDTVdKENcSXBoqbzSrspLR/4/IRVDo5wd2GgZjNss/viBFJdeq+j7qH2nypw=="],
-
-    "vscode-prosemark-latex-integration/vite/rolldown/@rolldown/binding-openharmony-arm64": ["@rolldown/binding-openharmony-arm64@1.0.2", "", { "os": "none", "cpu": "arm64" }, "sha512-1v5vHasdfQAZoEHakBV72LIFAC9JjnymsiKxp+GEr/ma3+NJCPSaYK+qavInOovJkgwFrs7GccX2d6IgDA3Z5w=="],
-
-    "vscode-prosemark-latex-integration/vite/rolldown/@rolldown/binding-wasm32-wasi": ["@rolldown/binding-wasm32-wasi@1.0.2", "", { "dependencies": { "@emnapi/core": "1.10.0", "@emnapi/runtime": "1.10.0", "@napi-rs/wasm-runtime": "^1.1.4" }, "cpu": "none" }, "sha512-mb1VobWn6NheziTk5/WEaR6AKVbrwT5sOi6C7zk3gy/pD1qtJfU1j4PgTo2NJnOtbL9Dl3Aeei8w9jJ7qC2jZQ=="],
-
-    "vscode-prosemark-latex-integration/vite/rolldown/@rolldown/binding-win32-arm64-msvc": ["@rolldown/binding-win32-arm64-msvc@1.0.2", "", { "os": "win32", "cpu": "arm64" }, "sha512-SqKonF56vA/L2yHwHYcEp2P34URpOZ7d1fS635cTkpDnUtEGdUbhI6NzsPdqeSWvAAeGDrxjWjNmibDIdFf9/A=="],
-
-    "vscode-prosemark-latex-integration/vite/rolldown/@rolldown/binding-win32-x64-msvc": ["@rolldown/binding-win32-x64-msvc@1.0.2", "", { "os": "win32", "cpu": "x64" }, "sha512-v7qRI7gXLRINcOGXt+7YmAZ6iFuyZVMIoXAxhd8oP+DR9dLfL9GfNIx7PLMxmhZdvq8waUJBQiWN9EKNy+TRBQ=="],
-
-    "vscode-prosemark/vite/rolldown/@oxc-project/types": ["@oxc-project/types@0.132.0", "", {}, "sha512-FESMOxil5Se014ui/Eq8fT5uHJo6nIRwH0PfJrZJXs6Gek3ZVFOrpUv3YIZT20m+extU98Hg1Ym72U58rlsxUQ=="],
-
-    "vscode-prosemark/vite/rolldown/@rolldown/binding-android-arm64": ["@rolldown/binding-android-arm64@1.0.2", "", { "os": "android", "cpu": "arm64" }, "sha512-ZS4D1JPGn/MYQN/SYDWftIE/nVsM8j/AFOYEzAoOE2O3NktQOZru+/vYXGbR/qtdLdIfGCP0lcoJiYVzsEz+iQ=="],
-
-    "vscode-prosemark/vite/rolldown/@rolldown/binding-darwin-arm64": ["@rolldown/binding-darwin-arm64@1.0.2", "", { "os": "darwin", "cpu": "arm64" }, "sha512-vdFA9+C/rekyGce7WqHs/xoT0ioZEWaOFyZLIV1mEeNFaFDUQrPIo8Vs2GvJ6eetb3rzDUtUBgzto3ExpXJB3w=="],
-
-    "vscode-prosemark/vite/rolldown/@rolldown/binding-darwin-x64": ["@rolldown/binding-darwin-x64@1.0.2", "", { "os": "darwin", "cpu": "x64" }, "sha512-BewSOwTHazv77DTYiAZXSqqKZ4KP/KonFisDMVU7PImxoWfB2aepnPhd2E4SWz3zDzYgDNbs6jBmTdgNnF02GA=="],
-
-    "vscode-prosemark/vite/rolldown/@rolldown/binding-freebsd-x64": ["@rolldown/binding-freebsd-x64@1.0.2", "", { "os": "freebsd", "cpu": "x64" }, "sha512-m41o7M0YWtUdqk61Tb+jnKb2rN++iRdIASlExkUoKfIAH30DOHCB8fVLzSUpbWHHU8esmEioY62PxzexE8MBuA=="],
-
-    "vscode-prosemark/vite/rolldown/@rolldown/binding-linux-arm-gnueabihf": ["@rolldown/binding-linux-arm-gnueabihf@1.0.2", "", { "os": "linux", "cpu": "arm" }, "sha512-jcojB9H7W/jS29pMKWAK1N+fU99vXodHDTatS3b3y/XSOCiHo0kkA74pL3jJmkoQtYpOCxDvaKs1fo2Ij/1X5w=="],
-
-    "vscode-prosemark/vite/rolldown/@rolldown/binding-linux-arm64-gnu": ["@rolldown/binding-linux-arm64-gnu@1.0.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-1jn6qDU5iiOgFgygDzKUuKP0maTi0/f1+sBLgvij/76C77Nm3ts6ufz9Bjg5q5dduxiUIxtq86JIoBvo1xQ4Ig=="],
-
-    "vscode-prosemark/vite/rolldown/@rolldown/binding-linux-arm64-musl": ["@rolldown/binding-linux-arm64-musl@1.0.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-QVLO/czFMdoMFSqlX3bcswcJNm/23r+qoa/jgtmFc/qEp6/jXmIkDjF/XIo8dPfGaiwy1xfQn8o77L79GeXFgw=="],
-
-    "vscode-prosemark/vite/rolldown/@rolldown/binding-linux-ppc64-gnu": ["@rolldown/binding-linux-ppc64-gnu@1.0.2", "", { "os": "linux", "cpu": "ppc64" }, "sha512-hgO5Abm0w5UL6FEa2iFnZqo2KlK7TQ5QhV5x09hujBf7t5KzHQ1VmfPuTpqRy/rNlSxua3eWH374xxiVrP+lcA=="],
-
-    "vscode-prosemark/vite/rolldown/@rolldown/binding-linux-s390x-gnu": ["@rolldown/binding-linux-s390x-gnu@1.0.2", "", { "os": "linux", "cpu": "s390x" }, "sha512-fy8rXxuYEu602abC8MUNaPjYLIFzReOaEIEMKMUa0rFEUxNpVXhs15KSSQ4qlqSaM7B6rcj9rDZgADh/IGDzLQ=="],
-
-    "vscode-prosemark/vite/rolldown/@rolldown/binding-linux-x64-gnu": ["@rolldown/binding-linux-x64-gnu@1.0.2", "", { "os": "linux", "cpu": "x64" }, "sha512-0+bOkiQ779+r1WpoHOWHqncvyySci0vKph+myNDYb+im6meJAzHQXay6oEgnkHuUGouM1LKTZwqKpBow6Kj7CQ=="],
-
-    "vscode-prosemark/vite/rolldown/@rolldown/binding-linux-x64-musl": ["@rolldown/binding-linux-x64-musl@1.0.2", "", { "os": "linux", "cpu": "x64" }, "sha512-mjSkrzZK5Qsl0a9d1JgILOiuZOSDTVdKENcSXBoqbzSrspLR/4/IRVDo5wd2GgZjNss/viBFJdeq+j7qH2nypw=="],
-
-    "vscode-prosemark/vite/rolldown/@rolldown/binding-openharmony-arm64": ["@rolldown/binding-openharmony-arm64@1.0.2", "", { "os": "none", "cpu": "arm64" }, "sha512-1v5vHasdfQAZoEHakBV72LIFAC9JjnymsiKxp+GEr/ma3+NJCPSaYK+qavInOovJkgwFrs7GccX2d6IgDA3Z5w=="],
-
-    "vscode-prosemark/vite/rolldown/@rolldown/binding-wasm32-wasi": ["@rolldown/binding-wasm32-wasi@1.0.2", "", { "dependencies": { "@emnapi/core": "1.10.0", "@emnapi/runtime": "1.10.0", "@napi-rs/wasm-runtime": "^1.1.4" }, "cpu": "none" }, "sha512-mb1VobWn6NheziTk5/WEaR6AKVbrwT5sOi6C7zk3gy/pD1qtJfU1j4PgTo2NJnOtbL9Dl3Aeei8w9jJ7qC2jZQ=="],
-
-    "vscode-prosemark/vite/rolldown/@rolldown/binding-win32-arm64-msvc": ["@rolldown/binding-win32-arm64-msvc@1.0.2", "", { "os": "win32", "cpu": "arm64" }, "sha512-SqKonF56vA/L2yHwHYcEp2P34URpOZ7d1fS635cTkpDnUtEGdUbhI6NzsPdqeSWvAAeGDrxjWjNmibDIdFf9/A=="],
-
-    "vscode-prosemark/vite/rolldown/@rolldown/binding-win32-x64-msvc": ["@rolldown/binding-win32-x64-msvc@1.0.2", "", { "os": "win32", "cpu": "x64" }, "sha512-v7qRI7gXLRINcOGXt+7YmAZ6iFuyZVMIoXAxhd8oP+DR9dLfL9GfNIx7PLMxmhZdvq8waUJBQiWN9EKNy+TRBQ=="],
-
     "widest-line/string-width/strip-ansi/ansi-regex": ["ansi-regex@6.2.2", "", {}, "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg=="],
 
     "@manypkg/find-root/find-up/locate-path/p-locate/p-limit": ["p-limit@2.3.0", "", { "dependencies": { "p-try": "^2.0.0" } }, "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w=="],
diff --git a/packages/latex/lib/main.ts b/packages/latex/lib/main.ts
index 0487746c..457e666f 100644
--- a/packages/latex/lib/main.ts
+++ b/packages/latex/lib/main.ts
@@ -141,6 +141,48 @@ export function preconfigureMathJaxLoader(packageUrl: string): void {
   };
 }
 
+export interface MathJaxPackageUrlFromWebviewScriptOptions {
+  /**
+   * Folder name next to the webview script that contains copied MathJax files.
+   * @default 'mathjax'
+   */
+  mathjaxDir?: string;
+  /**
+   * Script element whose `src` is the base URL. When omitted, uses the last
+   * `<script src>` in the document (typical for a companion webview bundle).
+   */
+  script?: HTMLScriptElement | null;
+}
+
+/**
+ * Resolve a self-hosted MathJax package root URL for {@link mathJaxLoadMode}
+ * `url-import` (e.g. VS Code webviews that copy `mathjax/` next to `webview.js`).
+ */
+export function mathJaxPackageUrlFromWebviewScript(
+  options: MathJaxPackageUrlFromWebviewScriptOptions = {},
+): string {
+  if (typeof document === 'undefined') {
+    throw new Error(
+      'mathJaxPackageUrlFromWebviewScript requires a browser environment (document).',
+    );
+  }
+
+  const { mathjaxDir = 'mathjax', script } = options;
+  const baseScript =
+    script ??
+    [...document.getElementsByTagName('script')]
+      .reverse()
+      .find((el): el is HTMLScriptElement => !!el.src);
+
+  if (!baseScript?.src) {
+    throw new Error(
+      'mathJaxPackageUrlFromWebviewScript: could not find a script src to resolve against',
+    );
+  }
+
+  return new URL(mathjaxDir, baseScript.src).href.replace(/\/$/, '');
+}
+
 async function awaitMathJaxStartupPromise(): Promise<void> {
   const mj = window.MathJax as MathJaxReady | undefined;
   const ready = mj?.startup.promise;
diff --git a/packages/latex/lib/vite-plugin-mathjax.ts b/packages/latex/lib/vite-plugin-mathjax.ts
new file mode 100644
index 00000000..8f0944b6
--- /dev/null
+++ b/packages/latex/lib/vite-plugin-mathjax.ts
@@ -0,0 +1,60 @@
+import { cpSync, existsSync, mkdirSync, statSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, resolve } from 'node:path';
+import type { Plugin } from 'vite';
+
+const require = createRequire(import.meta.url);
+
+/** Default copy set for self-hosted `tex-svg` + speech worker (VS Code webviews, static apps). */
+export const MATHJAX_TEX_SVG_COPY_ENTRIES = ['tex-svg.js', 'sre'] as const;
+
+export interface CopyMathJaxAssetsOptions {
+  /** Directory Vite writes bundles to (e.g. `dist/webview`). */
+  outDir: string;
+  /**
+   * Folder under `outDir` where MathJax files are placed.
+   * @default 'mathjax'
+   */
+  destDir?: string;
+  /**
+   * Paths relative to the `mathjax` npm package root (files or directories).
+   * Each entry is copied to `{outDir}/{destDir}/{entry}`.
+   */
+  copy: readonly string[];
+}
+
+/** Absolute path to the installed `mathjax` package root. */
+export const resolveMathJaxPackageRoot = (): string =>
+  resolve(require.resolve('mathjax/package.json'), '..');
+
+const copyPath = (src: string, dest: string): void => {
+  if (!existsSync(src)) {
+    throw new Error(`MathJax copy source not found: ${src}`);
+  }
+  mkdirSync(dirname(dest), { recursive: true });
+  if (statSync(src).isDirectory()) {
+    cpSync(src, dest, { recursive: true });
+  } else {
+    cpSync(src, dest);
+  }
+};
+
+/**
+ * Vite plugin: copy selected files/directories from the `mathjax` npm package
+ * into your build output (for self-hosted {@link mathJaxLoadMode} `url-import`).
+ */
+export function copyMathJaxAssets(options: CopyMathJaxAssetsOptions): Plugin {
+  const { outDir, destDir = 'mathjax', copy } = options;
+
+  return {
+    name: '@prosemark/latex/copy-mathjax-assets',
+    closeBundle() {
+      const mathjaxRoot = resolveMathJaxPackageRoot();
+      const destRoot = resolve(outDir, destDir);
+
+      for (const entry of copy) {
+        copyPath(resolve(mathjaxRoot, entry), resolve(destRoot, entry));
+      }
+    },
+  };
+}
diff --git a/packages/latex/package.json b/packages/latex/package.json
index 6ef41c38..7080dfba 100644
--- a/packages/latex/package.json
+++ b/packages/latex/package.json
@@ -24,6 +24,10 @@
     ".": {
       "types": "./dist/main.d.ts",
       "import": "./dist/main.js"
+    },
+    "./vite-plugin-mathjax": {
+      "types": "./dist/vite-plugin-mathjax.d.ts",
+      "import": "./dist/vite-plugin-mathjax.js"
     }
   },
   "main": "./dist/main.js",
@@ -48,11 +52,15 @@
     "@prosemark/core": "workspace:*"
   },
   "peerDependencies": {
-    "mathjax": "^4.0.0"
+    "mathjax": "^4.0.0",
+    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"
   },
   "peerDependenciesMeta": {
     "mathjax": {
       "optional": true
+    },
+    "vite": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -62,6 +70,7 @@
     "eslint": "^9.39.2",
     "tsdown": "^0.15.6",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.50.0"
+    "typescript-eslint": "^8.50.0",
+    "vite": "^8.0.5"
   }
 }
diff --git a/packages/latex/tests/mathjax-load-modes.test.ts b/packages/latex/tests/mathjax-load-modes.test.ts
index 45a8c98c..1a5155ec 100644
--- a/packages/latex/tests/mathjax-load-modes.test.ts
+++ b/packages/latex/tests/mathjax-load-modes.test.ts
@@ -1,6 +1,7 @@
 /// <reference types="bun" />
 import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
 import {
+  mathJaxPackageUrlFromWebviewScript,
   preconfigureMathJaxLoader,
   resetLatexMathJaxStateForTests,
 } from '../lib/main.ts';
@@ -27,6 +28,15 @@ afterEach(() => {
 });
 
 describe('MathJax load helpers', () => {
+  test('mathJaxPackageUrlFromWebviewScript resolves sibling mathjax dir', () => {
+    const script = {
+      src: 'https://example.test/dist/webview/webview.js',
+    } as HTMLScriptElement;
+    expect(mathJaxPackageUrlFromWebviewScript({ script })).toBe(
+      'https://example.test/dist/webview/mathjax',
+    );
+  });
+
   test('preconfigureMathJaxLoader sets loader paths', () => {
     preconfigureMathJaxLoader('https://example.test/mj');
     expect(
diff --git a/packages/latex/tsdown.config.ts b/packages/latex/tsdown.config.ts
index b73fe75e..953b0cc3 100644
--- a/packages/latex/tsdown.config.ts
+++ b/packages/latex/tsdown.config.ts
@@ -1,7 +1,14 @@
 import { defineConfig } from 'tsdown';
 
-export default defineConfig({
-  entry: 'lib/main.ts',
-  dts: true,
-  sourcemap: true,
-});
+export default defineConfig([
+  {
+    entry: 'lib/main.ts',
+    dts: true,
+    sourcemap: true,
+  },
+  {
+    entry: 'lib/vite-plugin-mathjax.ts',
+    dts: true,
+    sourcemap: true,
+  },
+]);

From 4e13e204aa50e105717c91bf9492cb88e173077a Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 20:58:52 +0000
Subject: [PATCH 06/22] Keep latex setup handler async

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 apps/vscode-extensions/latex-integration/src/webview/main.ts | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/apps/vscode-extensions/latex-integration/src/webview/main.ts b/apps/vscode-extensions/latex-integration/src/webview/main.ts
index b8691dff..96ceac9c 100644
--- a/apps/vscode-extensions/latex-integration/src/webview/main.ts
+++ b/apps/vscode-extensions/latex-integration/src/webview/main.ts
@@ -18,7 +18,8 @@ import './style.css';
 let latexSetupDone = false;
 
 const procs: WebviewProcMap = {
-  setup: () => {
+  // eslint-disable-next-line @typescript-eslint/require-await -- async setup matches other integrations
+  setup: async () => {
     const view = window.proseMark?.view;
     if (!view) {
       console.warn('[ProseMark] latex-integration setup: no view');
@@ -43,7 +44,6 @@ const procs: WebviewProcMap = {
       console.error('[ProseMark] latex-integration setup failed', err);
       throw err;
     }
-    return Promise.resolve();
   },
 };
 

From 0a54f8a8c74e9d91ff70e7a9161018733bd74d88 Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 21:04:08 +0000
Subject: [PATCH 07/22] Fix MathJax URL resolution when multiple webview
 scripts load

mathJaxPackageUrlFromWebviewScript used the last script tag, which was
cspell-integration's webview.js when both companions are installed.
Add scriptSrcIncludes and use latex-integration in the LaTeX webview.

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .changeset/latex-vite-mathjax-plugin.md       |  2 +-
 .../latex-integration/src/webview/main.ts     |  4 ++-
 packages/latex/lib/main.ts                    | 33 ++++++++++++++-----
 .../latex/tests/mathjax-load-modes.test.ts    | 21 ++++++++++++
 4 files changed, 49 insertions(+), 11 deletions(-)

diff --git a/.changeset/latex-vite-mathjax-plugin.md b/.changeset/latex-vite-mathjax-plugin.md
index c6ac67c8..17d5cdc1 100644
--- a/.changeset/latex-vite-mathjax-plugin.md
+++ b/.changeset/latex-vite-mathjax-plugin.md
@@ -3,4 +3,4 @@
 'vscode-prosemark-latex-integration': patch
 ---
 
-Add `@prosemark/latex/vite-plugin-mathjax` to copy configurable paths from the `mathjax` npm package into a Vite build output, export `mathJaxPackageUrlFromWebviewScript`, and switch the LaTeX VS Code webview to self-hosted `url-import` (`tex-svg.js` + `sre` under `dist/webview/mathjax/`).
+Add `@prosemark/latex/vite-plugin-mathjax` to copy configurable paths from the `mathjax` npm package into a Vite build output, export `mathJaxPackageUrlFromWebviewScript` (with `scriptSrcIncludes` for multi-script VS Code webviews), and switch the LaTeX VS Code webview to self-hosted `url-import` (`tex-svg.js` + `sre` under `dist/webview/mathjax/`).
diff --git a/apps/vscode-extensions/latex-integration/src/webview/main.ts b/apps/vscode-extensions/latex-integration/src/webview/main.ts
index 96ceac9c..1f4c2c95 100644
--- a/apps/vscode-extensions/latex-integration/src/webview/main.ts
+++ b/apps/vscode-extensions/latex-integration/src/webview/main.ts
@@ -31,7 +31,9 @@ const procs: WebviewProcMap = {
     latexSetupDone = true;
 
     try {
-      const mathJaxPackageUrl = mathJaxPackageUrlFromWebviewScript();
+      const mathJaxPackageUrl = mathJaxPackageUrlFromWebviewScript({
+        scriptSrcIncludes: 'latex-integration',
+      });
       appendToExtraCodeMirrorExtensions(view, [
         ...latexMarkdownSyntaxTheme,
         ...latexMarkdownEditorExtensions({
diff --git a/packages/latex/lib/main.ts b/packages/latex/lib/main.ts
index 457e666f..04ad65ff 100644
--- a/packages/latex/lib/main.ts
+++ b/packages/latex/lib/main.ts
@@ -148,10 +148,16 @@ export interface MathJaxPackageUrlFromWebviewScriptOptions {
    */
   mathjaxDir?: string;
   /**
-   * Script element whose `src` is the base URL. When omitted, uses the last
-   * `<script src>` in the document (typical for a companion webview bundle).
+   * Script element whose `src` is the base URL. When omitted, see
+   * {@link scriptSrcIncludes} or the last `<script src>` fallback.
    */
   script?: HTMLScriptElement | null;
+  /**
+   * When {@link script} is omitted: use the last `<script src>` whose URL
+   * contains this substring (e.g. your companion extension id). Prefer this in
+   * VS Code webviews where multiple `webview.js` bundles are loaded.
+   */
+  scriptSrcIncludes?: string;
 }
 
 /**
@@ -167,16 +173,25 @@ export function mathJaxPackageUrlFromWebviewScript(
     );
   }
 
-  const { mathjaxDir = 'mathjax', script } = options;
-  const baseScript =
-    script ??
-    [...document.getElementsByTagName('script')]
-      .reverse()
-      .find((el): el is HTMLScriptElement => !!el.src);
+  const { mathjaxDir = 'mathjax', script, scriptSrcIncludes } = options;
+
+  let baseScript: HTMLScriptElement | null | undefined = script;
+  if (!baseScript) {
+    const scripts = [...document.getElementsByTagName('script')].filter(
+      (el): el is HTMLScriptElement => !!el.src,
+    );
+    baseScript = scriptSrcIncludes
+      ? ([...scripts]
+          .reverse()
+          .find((el) => el.src.includes(scriptSrcIncludes)) ?? null)
+      : (scripts.at(-1) ?? null);
+  }
 
   if (!baseScript?.src) {
     throw new Error(
-      'mathJaxPackageUrlFromWebviewScript: could not find a script src to resolve against',
+      scriptSrcIncludes
+        ? `mathJaxPackageUrlFromWebviewScript: no script src includes ${JSON.stringify(scriptSrcIncludes)}`
+        : 'mathJaxPackageUrlFromWebviewScript: could not find a script src to resolve against',
     );
   }
 
diff --git a/packages/latex/tests/mathjax-load-modes.test.ts b/packages/latex/tests/mathjax-load-modes.test.ts
index 1a5155ec..5190fcc7 100644
--- a/packages/latex/tests/mathjax-load-modes.test.ts
+++ b/packages/latex/tests/mathjax-load-modes.test.ts
@@ -37,6 +37,27 @@ describe('MathJax load helpers', () => {
     );
   });
 
+  test('mathJaxPackageUrlFromWebviewScript picks script by src substring', () => {
+    const g = globalThis as unknown as {
+      document: { getElementsByTagName: () => HTMLScriptElement[] };
+    };
+    g.document = {
+      getElementsByTagName: () => [
+        {
+          src: 'https://example.test/cspell-integration/webview.js',
+        } as HTMLScriptElement,
+        {
+          src: 'https://example.test/latex-integration/webview.js',
+        } as HTMLScriptElement,
+      ],
+    };
+    expect(
+      mathJaxPackageUrlFromWebviewScript({
+        scriptSrcIncludes: 'latex-integration',
+      }),
+    ).toBe('https://example.test/latex-integration/mathjax');
+  });
+
   test('preconfigureMathJaxLoader sets loader paths', () => {
     preconfigureMathJaxLoader('https://example.test/mj');
     expect(

From b609e10aa07fb96f07a8402bbb1a5a3c735eba2e Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 21:09:48 +0000
Subject: [PATCH 08/22] Pass MathJax package URL from extension host via
 asWebviewUri

Extend SubExtensionCallback with the webview instance so sub-extensions
can resolve local resource URLs with webview.asWebviewUri instead of
reverse-engineering script tags in the webview.

The LaTeX integration now passes mathJaxPackageUrl into setup from the
extension host, removing the scriptSrcIncludes workaround.

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .changeset/latex-vite-mathjax-plugin.md       |  3 ++-
 .../core/src/sub-extensions/core.ts           |  2 +-
 .../word-count-status-bar-item.ts             |  2 +-
 .../cspell-integration/src/sub-extension.ts   |  2 +-
 .../latex-integration/src/common.ts           |  6 +++++-
 .../latex-integration/src/sub-extension.ts    | 20 +++++++++++++++++--
 .../latex-integration/src/webview/main.ts     |  6 +-----
 .../vscode-extension-integrator/lib/main.ts   |  1 +
 .../vscode-extension-integrator/lib/types.ts  |  1 +
 9 files changed, 31 insertions(+), 12 deletions(-)

diff --git a/.changeset/latex-vite-mathjax-plugin.md b/.changeset/latex-vite-mathjax-plugin.md
index 17d5cdc1..c6853d8d 100644
--- a/.changeset/latex-vite-mathjax-plugin.md
+++ b/.changeset/latex-vite-mathjax-plugin.md
@@ -1,6 +1,7 @@
 ---
 '@prosemark/latex': minor
+'@prosemark/vscode-extension-integrator': minor
 'vscode-prosemark-latex-integration': patch
 ---
 
-Add `@prosemark/latex/vite-plugin-mathjax` to copy configurable paths from the `mathjax` npm package into a Vite build output, export `mathJaxPackageUrlFromWebviewScript` (with `scriptSrcIncludes` for multi-script VS Code webviews), and switch the LaTeX VS Code webview to self-hosted `url-import` (`tex-svg.js` + `sre` under `dist/webview/mathjax/`).
+Add `@prosemark/latex/vite-plugin-mathjax` to copy configurable paths from the `mathjax` npm package into a Vite build output, pass `webview` into sub-extension callbacks, and switch the LaTeX VS Code webview to self-hosted `url-import` with the MathJax package URL from `webview.asWebviewUri` (`tex-svg.js` + `sre` under `dist/webview/mathjax/`).
diff --git a/apps/vscode-extensions/core/src/sub-extensions/core.ts b/apps/vscode-extensions/core/src/sub-extensions/core.ts
index 8abf0f0f..9a327f3c 100644
--- a/apps/vscode-extensions/core/src/sub-extensions/core.ts
+++ b/apps/vscode-extensions/core/src/sub-extensions/core.ts
@@ -249,7 +249,7 @@ export class Core implements SubExtension<
 export function createCore(
   extensionUri: vscode.Uri,
 ): SubExtensionCallback<typeof extId, unknown, unknown> {
-  return (document, callProcAndForget, _callProcWithReturnValue) => {
+  return (document, callProcAndForget, _callProcWithReturnValue, _webview) => {
     return new Core(extensionUri, document, callProcAndForget);
   };
 }
diff --git a/apps/vscode-extensions/core/src/sub-extensions/word-count-status-bar-item.ts b/apps/vscode-extensions/core/src/sub-extensions/word-count-status-bar-item.ts
index 5de75895..79d05c12 100644
--- a/apps/vscode-extensions/core/src/sub-extensions/word-count-status-bar-item.ts
+++ b/apps/vscode-extensions/core/src/sub-extensions/word-count-status-bar-item.ts
@@ -67,7 +67,7 @@ export const createWordCountStatusBarItem: SubExtensionCallback<
   typeof extId,
   Record<string, never>,
   WordCountVSCodeProcs
-> = (document) => {
+> = (document, _callProcAndForget, _callProcWithReturnValue, _webview) => {
   return new WordCountStatusBarItem(document);
 };
 
diff --git a/apps/vscode-extensions/cspell-integration/src/sub-extension.ts b/apps/vscode-extensions/cspell-integration/src/sub-extension.ts
index 4e328cb9..acdda64b 100644
--- a/apps/vscode-extensions/cspell-integration/src/sub-extension.ts
+++ b/apps/vscode-extensions/cspell-integration/src/sub-extension.ts
@@ -151,7 +151,7 @@ export function createCSpellIntegration(
   extensionUri: vscode.Uri,
   cSpellApi: CSpell.ExtensionApi,
 ): SubExtensionCallback<typeof extId, WebviewProcMap, VSCodeExtensionProcMap> {
-  return (document, callProcAndForget, callProcWithReturnValue) => {
+  return (document, callProcAndForget, callProcWithReturnValue, _webview) => {
     return new CSpellIntegration(
       extensionUri,
       cSpellApi,
diff --git a/apps/vscode-extensions/latex-integration/src/common.ts b/apps/vscode-extensions/latex-integration/src/common.ts
index 9316c285..7ca9d578 100644
--- a/apps/vscode-extensions/latex-integration/src/common.ts
+++ b/apps/vscode-extensions/latex-integration/src/common.ts
@@ -1,6 +1,10 @@
 /** VS Code extension host: no procedures exposed to the webview for LaTeX. */
 export type VSCodeExtensionProcMap = Record<string, never>;
 
+export interface LatexSetupConfig {
+  mathJaxPackageUrl: string;
+}
+
 export interface WebviewProcMap {
-  setup: () => Promise<void>;
+  setup: (config: LatexSetupConfig) => Promise<void>;
 }
diff --git a/apps/vscode-extensions/latex-integration/src/sub-extension.ts b/apps/vscode-extensions/latex-integration/src/sub-extension.ts
index b19142c2..34f77496 100644
--- a/apps/vscode-extensions/latex-integration/src/sub-extension.ts
+++ b/apps/vscode-extensions/latex-integration/src/sub-extension.ts
@@ -14,15 +14,18 @@ export class LatexIntegration implements SubExtension<
   VSCodeExtensionProcMap
 > {
   #extensionUri: vscode.Uri;
+  #webview: vscode.Webview;
   #callProcWithReturnValue: CallProcWithReturnValue<WebviewProcMap>;
 
   constructor(
     extensionUri: vscode.Uri,
+    webview: vscode.Webview,
     _document: vscode.TextDocument,
     _callProcAndForget: CallProc<WebviewProcMap>,
     callProcWithReturnValue: CallProcWithReturnValue<WebviewProcMap>,
   ) {
     this.#extensionUri = extensionUri;
+    this.#webview = webview;
     this.#callProcWithReturnValue = callProcWithReturnValue;
   }
 
@@ -52,8 +55,20 @@ export class LatexIntegration implements SubExtension<
     return [this.#extensionUri];
   }
 
+  #getMathJaxPackageUrl(): string {
+    const mathJaxUri = vscode.Uri.joinPath(
+      this.#extensionUri,
+      'dist',
+      'webview',
+      'mathjax',
+    );
+    return this.#webview.asWebviewUri(mathJaxUri).toString().replace(/\/$/, '');
+  }
+
   onReady(): void {
-    void this.#callProcWithReturnValue('setup').catch((e: unknown) => {
+    void this.#callProcWithReturnValue('setup', {
+      mathJaxPackageUrl: this.#getMathJaxPackageUrl(),
+    }).catch((e: unknown) => {
       console.error(e);
     });
   }
@@ -64,9 +79,10 @@ export class LatexIntegration implements SubExtension<
 export function createLatexIntegration(
   extensionUri: vscode.Uri,
 ): SubExtensionCallback<typeof extId, WebviewProcMap, VSCodeExtensionProcMap> {
-  return (document, callProcAndForget, callProcWithReturnValue) => {
+  return (document, callProcAndForget, callProcWithReturnValue, webview) => {
     return new LatexIntegration(
       extensionUri,
+      webview,
       document,
       callProcAndForget,
       callProcWithReturnValue,
diff --git a/apps/vscode-extensions/latex-integration/src/webview/main.ts b/apps/vscode-extensions/latex-integration/src/webview/main.ts
index 1f4c2c95..212c5f14 100644
--- a/apps/vscode-extensions/latex-integration/src/webview/main.ts
+++ b/apps/vscode-extensions/latex-integration/src/webview/main.ts
@@ -10,7 +10,6 @@ import type {
 import {
   latexMarkdownEditorExtensions,
   latexMarkdownSyntaxTheme,
-  mathJaxPackageUrlFromWebviewScript,
 } from '@prosemark/latex';
 
 import './style.css';
@@ -19,7 +18,7 @@ let latexSetupDone = false;
 
 const procs: WebviewProcMap = {
   // eslint-disable-next-line @typescript-eslint/require-await -- async setup matches other integrations
-  setup: async () => {
+  setup: async ({ mathJaxPackageUrl }) => {
     const view = window.proseMark?.view;
     if (!view) {
       console.warn('[ProseMark] latex-integration setup: no view');
@@ -31,9 +30,6 @@ const procs: WebviewProcMap = {
     latexSetupDone = true;
 
     try {
-      const mathJaxPackageUrl = mathJaxPackageUrlFromWebviewScript({
-        scriptSrcIncludes: 'latex-integration',
-      });
       appendToExtraCodeMirrorExtensions(view, [
         ...latexMarkdownSyntaxTheme,
         ...latexMarkdownEditorExtensions({
diff --git a/packages/vscode-extension-integrator/lib/main.ts b/packages/vscode-extension-integrator/lib/main.ts
index 744bad6d..ca8ad32f 100644
--- a/packages/vscode-extension-integrator/lib/main.ts
+++ b/packages/vscode-extension-integrator/lib/main.ts
@@ -114,6 +114,7 @@ export class SubExtensionManager {
         document,
         this.#callProcAndForget(key),
         this.#callProcWithReturnValue(key),
+        this.#webview,
       );
     }
 
diff --git a/packages/vscode-extension-integrator/lib/types.ts b/packages/vscode-extension-integrator/lib/types.ts
index d8f6c62b..3d5bcdcc 100644
--- a/packages/vscode-extension-integrator/lib/types.ts
+++ b/packages/vscode-extension-integrator/lib/types.ts
@@ -199,6 +199,7 @@ export type SubExtensionCallback<ExtId extends string, WebviewPM, VSCodePM> = (
   document: vscode.TextDocument,
   callProcAndForget: CallProc<WebviewPM>,
   callProcWithReturnValue: CallProcWithReturnValue<WebviewPM>,
+  webview: vscode.Webview,
 ) => SubExtension<ExtId, VSCodePM>;
 
 export interface ProseMarkExtensionApi {

From 8b26bc69acb7595cceeb5112b55d0fba1bc2028f Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 21:10:41 +0000
Subject: [PATCH 09/22] Remove mathJaxPackageUrlFromWebviewScript from
 @prosemark/latex

VS Code integrations should pass mathJaxPackageUrl from the extension
host via webview.asWebviewUri; script-tag discovery is no longer needed.

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 packages/latex/lib/main.ts                    | 57 -------------------
 .../latex/tests/mathjax-load-modes.test.ts    | 31 ----------
 2 files changed, 88 deletions(-)

diff --git a/packages/latex/lib/main.ts b/packages/latex/lib/main.ts
index 04ad65ff..0487746c 100644
--- a/packages/latex/lib/main.ts
+++ b/packages/latex/lib/main.ts
@@ -141,63 +141,6 @@ export function preconfigureMathJaxLoader(packageUrl: string): void {
   };
 }
 
-export interface MathJaxPackageUrlFromWebviewScriptOptions {
-  /**
-   * Folder name next to the webview script that contains copied MathJax files.
-   * @default 'mathjax'
-   */
-  mathjaxDir?: string;
-  /**
-   * Script element whose `src` is the base URL. When omitted, see
-   * {@link scriptSrcIncludes} or the last `<script src>` fallback.
-   */
-  script?: HTMLScriptElement | null;
-  /**
-   * When {@link script} is omitted: use the last `<script src>` whose URL
-   * contains this substring (e.g. your companion extension id). Prefer this in
-   * VS Code webviews where multiple `webview.js` bundles are loaded.
-   */
-  scriptSrcIncludes?: string;
-}
-
-/**
- * Resolve a self-hosted MathJax package root URL for {@link mathJaxLoadMode}
- * `url-import` (e.g. VS Code webviews that copy `mathjax/` next to `webview.js`).
- */
-export function mathJaxPackageUrlFromWebviewScript(
-  options: MathJaxPackageUrlFromWebviewScriptOptions = {},
-): string {
-  if (typeof document === 'undefined') {
-    throw new Error(
-      'mathJaxPackageUrlFromWebviewScript requires a browser environment (document).',
-    );
-  }
-
-  const { mathjaxDir = 'mathjax', script, scriptSrcIncludes } = options;
-
-  let baseScript: HTMLScriptElement | null | undefined = script;
-  if (!baseScript) {
-    const scripts = [...document.getElementsByTagName('script')].filter(
-      (el): el is HTMLScriptElement => !!el.src,
-    );
-    baseScript = scriptSrcIncludes
-      ? ([...scripts]
-          .reverse()
-          .find((el) => el.src.includes(scriptSrcIncludes)) ?? null)
-      : (scripts.at(-1) ?? null);
-  }
-
-  if (!baseScript?.src) {
-    throw new Error(
-      scriptSrcIncludes
-        ? `mathJaxPackageUrlFromWebviewScript: no script src includes ${JSON.stringify(scriptSrcIncludes)}`
-        : 'mathJaxPackageUrlFromWebviewScript: could not find a script src to resolve against',
-    );
-  }
-
-  return new URL(mathjaxDir, baseScript.src).href.replace(/\/$/, '');
-}
-
 async function awaitMathJaxStartupPromise(): Promise<void> {
   const mj = window.MathJax as MathJaxReady | undefined;
   const ready = mj?.startup.promise;
diff --git a/packages/latex/tests/mathjax-load-modes.test.ts b/packages/latex/tests/mathjax-load-modes.test.ts
index 5190fcc7..45a8c98c 100644
--- a/packages/latex/tests/mathjax-load-modes.test.ts
+++ b/packages/latex/tests/mathjax-load-modes.test.ts
@@ -1,7 +1,6 @@
 /// <reference types="bun" />
 import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
 import {
-  mathJaxPackageUrlFromWebviewScript,
   preconfigureMathJaxLoader,
   resetLatexMathJaxStateForTests,
 } from '../lib/main.ts';
@@ -28,36 +27,6 @@ afterEach(() => {
 });
 
 describe('MathJax load helpers', () => {
-  test('mathJaxPackageUrlFromWebviewScript resolves sibling mathjax dir', () => {
-    const script = {
-      src: 'https://example.test/dist/webview/webview.js',
-    } as HTMLScriptElement;
-    expect(mathJaxPackageUrlFromWebviewScript({ script })).toBe(
-      'https://example.test/dist/webview/mathjax',
-    );
-  });
-
-  test('mathJaxPackageUrlFromWebviewScript picks script by src substring', () => {
-    const g = globalThis as unknown as {
-      document: { getElementsByTagName: () => HTMLScriptElement[] };
-    };
-    g.document = {
-      getElementsByTagName: () => [
-        {
-          src: 'https://example.test/cspell-integration/webview.js',
-        } as HTMLScriptElement,
-        {
-          src: 'https://example.test/latex-integration/webview.js',
-        } as HTMLScriptElement,
-      ],
-    };
-    expect(
-      mathJaxPackageUrlFromWebviewScript({
-        scriptSrcIncludes: 'latex-integration',
-      }),
-    ).toBe('https://example.test/latex-integration/mathjax');
-  });
-
   test('preconfigureMathJaxLoader sets loader paths', () => {
     preconfigureMathJaxLoader('https://example.test/mj');
     expect(

From 36a184aa00b53d8fa0dd106610e02dbe67b876ad Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 21:12:26 +0000
Subject: [PATCH 10/22] Pass SubExtensionCallback context as a single object

Sub-extension factories now receive { document, callProcAndForget,
callProcWithReturnValue, webview } so each integration can destructure
only what it needs without breaking when new fields are added.

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .changeset/latex-vite-mathjax-plugin.md              |  2 +-
 .../core/src/sub-extensions/core.ts                  |  2 +-
 .../src/sub-extensions/word-count-status-bar-item.ts |  2 +-
 .../cspell-integration/src/sub-extension.ts          |  2 +-
 .../latex-integration/src/sub-extension.ts           |  7 ++++++-
 packages/vscode-extension-integrator/README.md       | 12 ++++++------
 packages/vscode-extension-integrator/lib/main.ts     | 10 +++++-----
 packages/vscode-extension-integrator/lib/types.ts    | 12 ++++++++----
 8 files changed, 29 insertions(+), 20 deletions(-)

diff --git a/.changeset/latex-vite-mathjax-plugin.md b/.changeset/latex-vite-mathjax-plugin.md
index c6853d8d..8f4e2f71 100644
--- a/.changeset/latex-vite-mathjax-plugin.md
+++ b/.changeset/latex-vite-mathjax-plugin.md
@@ -4,4 +4,4 @@
 'vscode-prosemark-latex-integration': patch
 ---
 
-Add `@prosemark/latex/vite-plugin-mathjax` to copy configurable paths from the `mathjax` npm package into a Vite build output, pass `webview` into sub-extension callbacks, and switch the LaTeX VS Code webview to self-hosted `url-import` with the MathJax package URL from `webview.asWebviewUri` (`tex-svg.js` + `sre` under `dist/webview/mathjax/`).
+Add `@prosemark/latex/vite-plugin-mathjax` to copy configurable paths from the `mathjax` npm package into a Vite build output, pass sub-extension callback context as a single object (including `webview`), and switch the LaTeX VS Code webview to self-hosted `url-import` with the MathJax package URL from `webview.asWebviewUri` (`tex-svg.js` + `sre` under `dist/webview/mathjax/`).
diff --git a/apps/vscode-extensions/core/src/sub-extensions/core.ts b/apps/vscode-extensions/core/src/sub-extensions/core.ts
index 9a327f3c..4bcc5bc2 100644
--- a/apps/vscode-extensions/core/src/sub-extensions/core.ts
+++ b/apps/vscode-extensions/core/src/sub-extensions/core.ts
@@ -249,7 +249,7 @@ export class Core implements SubExtension<
 export function createCore(
   extensionUri: vscode.Uri,
 ): SubExtensionCallback<typeof extId, unknown, unknown> {
-  return (document, callProcAndForget, _callProcWithReturnValue, _webview) => {
+  return ({ document, callProcAndForget }) => {
     return new Core(extensionUri, document, callProcAndForget);
   };
 }
diff --git a/apps/vscode-extensions/core/src/sub-extensions/word-count-status-bar-item.ts b/apps/vscode-extensions/core/src/sub-extensions/word-count-status-bar-item.ts
index 79d05c12..e8272973 100644
--- a/apps/vscode-extensions/core/src/sub-extensions/word-count-status-bar-item.ts
+++ b/apps/vscode-extensions/core/src/sub-extensions/word-count-status-bar-item.ts
@@ -67,7 +67,7 @@ export const createWordCountStatusBarItem: SubExtensionCallback<
   typeof extId,
   Record<string, never>,
   WordCountVSCodeProcs
-> = (document, _callProcAndForget, _callProcWithReturnValue, _webview) => {
+> = ({ document }) => {
   return new WordCountStatusBarItem(document);
 };
 
diff --git a/apps/vscode-extensions/cspell-integration/src/sub-extension.ts b/apps/vscode-extensions/cspell-integration/src/sub-extension.ts
index acdda64b..81d8cba0 100644
--- a/apps/vscode-extensions/cspell-integration/src/sub-extension.ts
+++ b/apps/vscode-extensions/cspell-integration/src/sub-extension.ts
@@ -151,7 +151,7 @@ export function createCSpellIntegration(
   extensionUri: vscode.Uri,
   cSpellApi: CSpell.ExtensionApi,
 ): SubExtensionCallback<typeof extId, WebviewProcMap, VSCodeExtensionProcMap> {
-  return (document, callProcAndForget, callProcWithReturnValue, _webview) => {
+  return ({ document, callProcAndForget, callProcWithReturnValue }) => {
     return new CSpellIntegration(
       extensionUri,
       cSpellApi,
diff --git a/apps/vscode-extensions/latex-integration/src/sub-extension.ts b/apps/vscode-extensions/latex-integration/src/sub-extension.ts
index 34f77496..9da276a8 100644
--- a/apps/vscode-extensions/latex-integration/src/sub-extension.ts
+++ b/apps/vscode-extensions/latex-integration/src/sub-extension.ts
@@ -79,7 +79,12 @@ export class LatexIntegration implements SubExtension<
 export function createLatexIntegration(
   extensionUri: vscode.Uri,
 ): SubExtensionCallback<typeof extId, WebviewProcMap, VSCodeExtensionProcMap> {
-  return (document, callProcAndForget, callProcWithReturnValue, webview) => {
+  return ({
+    document,
+    callProcAndForget,
+    callProcWithReturnValue,
+    webview,
+  }) => {
     return new LatexIntegration(
       extensionUri,
       webview,
diff --git a/packages/vscode-extension-integrator/README.md b/packages/vscode-extension-integrator/README.md
index d3a34290..c9ed26cd 100644
--- a/packages/vscode-extension-integrator/README.md
+++ b/packages/vscode-extension-integrator/README.md
@@ -6,12 +6,12 @@ Published on npm: [`@prosemark/vscode-extension-integrator`](https://www.npmjs.c
 
 ## Subpath exports
 
-| Import                                                   | Purpose                                                                 |
-| -------------------------------------------------------- | ----------------------------------------------------------------------- |
-| `@prosemark/vscode-extension-integrator`                 | `SubExtensionManager`, `SubExtensionCallbackManager` (extension host)   |
-| `@prosemark/vscode-extension-integrator/webview`         | Webview message handlers, `appendToExtraCodeMirrorExtensions`           |
-| `@prosemark/vscode-extension-integrator/types`           | `ProseMarkExtensionApi`, `SubExtensionCallback`, proc maps, `Change`, … |
-| `@prosemark/vscode-extension-integrator/rolldown-plugin` | Rolldown/Vite plugin for webview bundles                                |
+| Import                                                   | Purpose                                                                                                |
+| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| `@prosemark/vscode-extension-integrator`                 | `SubExtensionManager`, `SubExtensionCallbackManager` (extension host)                                  |
+| `@prosemark/vscode-extension-integrator/webview`         | Webview message handlers, `appendToExtraCodeMirrorExtensions`                                          |
+| `@prosemark/vscode-extension-integrator/types`           | `ProseMarkExtensionApi`, `SubExtensionCallback`, `SubExtensionCallbackContext`, proc maps, `Change`, … |
+| `@prosemark/vscode-extension-integrator/rolldown-plugin` | Rolldown/Vite plugin for webview bundles                                                               |
 
 ## Architecture
 
diff --git a/packages/vscode-extension-integrator/lib/main.ts b/packages/vscode-extension-integrator/lib/main.ts
index ca8ad32f..069d349f 100644
--- a/packages/vscode-extension-integrator/lib/main.ts
+++ b/packages/vscode-extension-integrator/lib/main.ts
@@ -110,12 +110,12 @@ export class SubExtensionManager {
 
     const extensions: Record<string, UnknownSubExtension> = {};
     for (const [key, callback] of Object.entries(subExtensionCallbacks)) {
-      extensions[key] = callback(
+      extensions[key] = callback({
         document,
-        this.#callProcAndForget(key),
-        this.#callProcWithReturnValue(key),
-        this.#webview,
-      );
+        callProcAndForget: this.#callProcAndForget(key),
+        callProcWithReturnValue: this.#callProcWithReturnValue(key),
+        webview: this.#webview,
+      });
     }
 
     this.#subExtensions = extensions;
diff --git a/packages/vscode-extension-integrator/lib/types.ts b/packages/vscode-extension-integrator/lib/types.ts
index 3d5bcdcc..6192df08 100644
--- a/packages/vscode-extension-integrator/lib/types.ts
+++ b/packages/vscode-extension-integrator/lib/types.ts
@@ -195,11 +195,15 @@ export interface SubExtension<ExtId extends string, VSCodePM> {
 
 export type UnknownSubExtension = SubExtension<string, unknown>;
 
+export interface SubExtensionCallbackContext<WebviewPM> {
+  document: vscode.TextDocument;
+  callProcAndForget: CallProc<WebviewPM>;
+  callProcWithReturnValue: CallProcWithReturnValue<WebviewPM>;
+  webview: vscode.Webview;
+}
+
 export type SubExtensionCallback<ExtId extends string, WebviewPM, VSCodePM> = (
-  document: vscode.TextDocument,
-  callProcAndForget: CallProc<WebviewPM>,
-  callProcWithReturnValue: CallProcWithReturnValue<WebviewPM>,
-  webview: vscode.Webview,
+  ctx: SubExtensionCallbackContext<WebviewPM>,
 ) => SubExtension<ExtId, VSCodePM>;
 
 export interface ProseMarkExtensionApi {

From 43e9216ce84bc23006147f4762f22c18d4b7bb25 Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 21:28:05 +0000
Subject: [PATCH 11/22] Document MathJax a11y/speech worker options for
 static-import

Explain that tex-svg loads sre/speech-worker.js separately, and that
static-import setups must either disable a11y or copy and serve sre/.

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .../src/content/docs/guides/latex-math.md     | 19 ++++++++++++
 .../latex-integration/README.md               | 29 +++++++++++++++++++
 packages/latex/README.md                      | 19 ++++++++++++
 3 files changed, 67 insertions(+)

diff --git a/apps/docs/src/content/docs/guides/latex-math.md b/apps/docs/src/content/docs/guides/latex-math.md
index c7307f63..a836c308 100644
--- a/apps/docs/src/content/docs/guides/latex-math.md
+++ b/apps/docs/src/content/docs/guides/latex-math.md
@@ -113,6 +113,25 @@ import 'mathjax/tex-svg.js';
 }),
 ```
 
+**Accessibility / speech worker:** the combined startup bundle includes MathJax a11y support and loads **`sre/speech-worker.js` as a web worker** at runtime. Your bundler typically only ships the main JS file, so the worker is missing unless you also copy `sre/` and configure MathJax’s loader paths, or use **`url-import`** with a self-hosted `mathjax/` folder (see [`@prosemark/latex/vite-plugin-mathjax`](https://www.npmjs.com/package/@prosemark/latex) on npm).
+
+For editor-style preview where speech is not needed, disable a11y by configuring `window.MathJax` **before** importing MathJax:
+
+```javascript
+window.MathJax = {
+  options: {
+    skipStartupTypeset: true,
+    enableSpeech: false,
+    enableBraille: false,
+    enableEnrichment: false,
+    menuOptions: {
+      settings: { enrich: false, speech: false, braille: false },
+    },
+  },
+};
+import 'mathjax/tex-svg.js';
+```
+
 Use one load mode per page (`url-import` or `static-import`, not both).
 
 ## Block vs inline
diff --git a/apps/vscode-extensions/latex-integration/README.md b/apps/vscode-extensions/latex-integration/README.md
index 47ee7603..4155c985 100644
--- a/apps/vscode-extensions/latex-integration/README.md
+++ b/apps/vscode-extensions/latex-integration/README.md
@@ -25,3 +25,32 @@ Please report bugs on the [GitHub issues page](https://github.com/jsimonrichard/
 ## Developing this extension
 
 After `bun install`, run `bun run build`. **Vite** produces `dist/webview/webview.js` and copies `tex-svg.js` plus `sre/` from the **`mathjax`** npm package into `dist/webview/mathjax/` via `@prosemark/latex/vite-plugin-mathjax`. The webview loads MathJax with `url-import` from that folder. Bump the **`mathjax`** dependency when you want a different MathJax version.
+
+### MathJax load modes
+
+This extension uses **`url-import`**: the extension host passes a webview URL for `dist/webview/mathjax/`, and the webview dynamically imports `tex-svg.js` from there. That keeps `webview.js` small and lets MathJax load `sre/speech-worker.js` as a separate file (copied by the Vite plugin).
+
+If you switch to **`static-import`** (`import 'mathjax/tex-svg.js'` bundled into `webview.js`), note that the combined `tex-svg` startup includes MathJax **a11y** support. It tries to load **`sre/speech-worker.js` as a web worker** at runtime. A bundler usually only emits your main bundle, so the worker is missing unless you handle it explicitly.
+
+Pick one approach:
+
+1. **Disable a11y** (simplest for editor preview) — set options on `window.MathJax` **before** the static import:
+
+   ```ts
+   window.MathJax = {
+     options: {
+       skipStartupTypeset: true,
+       enableSpeech: false,
+       enableBraille: false,
+       enableEnrichment: false,
+       menuOptions: {
+         settings: { enrich: false, speech: false, braille: false },
+       },
+     },
+   };
+   import 'mathjax/tex-svg.js';
+   ```
+
+2. **Keep a11y** — copy `sre/` from the `mathjax` npm package next to where `tex-svg.js` is served, and point MathJax at that root (for example with `preconfigureMathJaxLoader` and `loader.paths.mathjax`, or `@prosemark/latex/vite-plugin-mathjax` with `url-import`). The worker cannot be inlined into an IIFE the way the main startup script can.
+
+The shipped extension uses **url-import + copied `sre/`** so math renders without bundling ~1.8 MB of MathJax into `webview.js`.
diff --git a/packages/latex/README.md b/packages/latex/README.md
index 857d83b2..e237cbef 100644
--- a/packages/latex/README.md
+++ b/packages/latex/README.md
@@ -60,6 +60,25 @@ latexMarkdownEditorExtensions({
 });
 ```
 
+**Accessibility / speech worker:** the combined `tex-svg.js` / `tex-chtml.js` startup includes MathJax a11y extensions. At runtime it loads **`sre/speech-worker.js` as a separate web worker**. Bundlers usually only emit your main bundle, so the worker is missing unless you copy `sre/` from the `mathjax` package and configure `loader.paths.mathjax`, or use **`url-import`** with `@prosemark/latex/vite-plugin-mathjax` instead.
+
+If you do not need speech/enrichment (typical for editor preview), disable a11y by setting `window.MathJax.options` **before** the static import:
+
+```ts
+window.MathJax = {
+  options: {
+    skipStartupTypeset: true,
+    enableSpeech: false,
+    enableBraille: false,
+    enableEnrichment: false,
+    menuOptions: {
+      settings: { enrich: false, speech: false, braille: false },
+    },
+  },
+};
+import 'mathjax/tex-svg.js';
+```
+
 **Note:** `@prosemark/latex` does not read `node_modules` at runtime for `url-import`. Serving a copied tree under `public/` (or similar) is enough for self-hosting. You still need the **parser** section above so `Math` nodes exist.
 
 ## Usage

From cf1e3a6672eb3db195ac80406c5d0b27763516d0 Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 22:05:18 +0000
Subject: [PATCH 12/22] Fix strict lint issues in latex package and extension

Use a type guard for the webview vscode API instead of an unsafe cast,
tighten the MathJax loader test helper, and include vite.config.mts in
eslint file patterns.

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .../latex-integration/eslint.config.ts        |  7 ++++-
 .../latex-integration/src/webview/main.ts     | 29 ++++++++++++++-----
 packages/latex/eslint.config.ts               |  2 +-
 .../latex/tests/mathjax-load-modes.test.ts    | 20 ++++++++-----
 4 files changed, 42 insertions(+), 16 deletions(-)

diff --git a/apps/vscode-extensions/latex-integration/eslint.config.ts b/apps/vscode-extensions/latex-integration/eslint.config.ts
index a4adf00a..2ad605db 100644
--- a/apps/vscode-extensions/latex-integration/eslint.config.ts
+++ b/apps/vscode-extensions/latex-integration/eslint.config.ts
@@ -5,7 +5,12 @@ export default defineConfig([
   ...baseConfig,
   globalIgnores(['out/']),
   {
-    files: ['**/*.ts', 'tsdown.config.mts', '.vscode-test.mjs'],
+    files: [
+      '**/*.ts',
+      'tsdown.config.mts',
+      'vite.config.mts',
+      '.vscode-test.mjs',
+    ],
     languageOptions: {
       parserOptions: {
         tsconfigRootDir: import.meta.dirname,
diff --git a/apps/vscode-extensions/latex-integration/src/webview/main.ts b/apps/vscode-extensions/latex-integration/src/webview/main.ts
index 212c5f14..23a4df43 100644
--- a/apps/vscode-extensions/latex-integration/src/webview/main.ts
+++ b/apps/vscode-extensions/latex-integration/src/webview/main.ts
@@ -14,6 +14,22 @@ import {
 
 import './style.css';
 
+type LatexWebviewVscodeApi = WebviewVSCodeApiWithPostMessage<
+  CallbackFromProcMap<'latex-integration', WebviewProcMap>
+>;
+
+const isLatexWebviewVscodeApi = (
+  value: unknown,
+): value is LatexWebviewVscodeApi => {
+  if (typeof value !== 'object' || value === null) {
+    return false;
+  }
+  if (!('postMessage' in value)) {
+    return false;
+  }
+  return typeof value.postMessage === 'function';
+};
+
 let latexSetupDone = false;
 
 const procs: WebviewProcMap = {
@@ -45,10 +61,9 @@ const procs: WebviewProcMap = {
   },
 };
 
-registerWebviewMessageHandler(
-  'latex-integration',
-  procs,
-  window.proseMark?.vscode as WebviewVSCodeApiWithPostMessage<
-    CallbackFromProcMap<'latex-integration', WebviewProcMap>
-  >,
-);
+const vscodeApi = window.proseMark?.vscode;
+if (isLatexWebviewVscodeApi(vscodeApi)) {
+  registerWebviewMessageHandler('latex-integration', procs, vscodeApi);
+} else {
+  console.error('[ProseMark] latex-integration: vscode API is not available');
+}
diff --git a/packages/latex/eslint.config.ts b/packages/latex/eslint.config.ts
index a76972d8..480ad335 100644
--- a/packages/latex/eslint.config.ts
+++ b/packages/latex/eslint.config.ts
@@ -5,7 +5,7 @@ import { defineConfig } from 'eslint/config';
 export default defineConfig([
   ...baseConfig,
   {
-    files: ['**/*.ts'],
+    files: ['**/*.ts', '**/*.mts'],
     languageOptions: {
       parserOptions: {
         tsconfigRootDir: import.meta.dirname,
diff --git a/packages/latex/tests/mathjax-load-modes.test.ts b/packages/latex/tests/mathjax-load-modes.test.ts
index 45a8c98c..b50404e7 100644
--- a/packages/latex/tests/mathjax-load-modes.test.ts
+++ b/packages/latex/tests/mathjax-load-modes.test.ts
@@ -5,6 +5,18 @@ import {
   resetLatexMathJaxStateForTests,
 } from '../lib/main.ts';
 
+function getConfiguredMathJaxPackageUrl(): string {
+  const mathJaxPackageUrl = (
+    globalThis as typeof globalThis & {
+      MathJax?: { loader?: { paths?: { mathjax?: string } } };
+    }
+  ).MathJax?.loader?.paths?.mathjax;
+  if (typeof mathJaxPackageUrl !== 'string') {
+    throw new Error('expected MathJax loader.paths.mathjax on globalThis');
+  }
+  return mathJaxPackageUrl;
+}
+
 function installBrowserGlobals(): void {
   const g = globalThis as unknown as {
     window: typeof globalThis;
@@ -29,12 +41,6 @@ afterEach(() => {
 describe('MathJax load helpers', () => {
   test('preconfigureMathJaxLoader sets loader paths', () => {
     preconfigureMathJaxLoader('https://example.test/mj');
-    expect(
-      (
-        globalThis as unknown as {
-          MathJax: { loader: { paths: { mathjax: string } } };
-        }
-      ).MathJax.loader.paths.mathjax,
-    ).toBe('https://example.test/mj');
+    expect(getConfiguredMathJaxPackageUrl()).toBe('https://example.test/mj');
   });
 });

From 587e185020c7ec5eb45e6ebd626fbb0c59513273 Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 22:40:36 +0000
Subject: [PATCH 13/22] Fix MathJax 4 config: use startup.typeset instead of
 skipStartupTypeset

MathJax 4 removed skipStartupTypeset; use startup.typeset: false to skip
automatic page typesetting. Update @prosemark/latex preconfiguration, docs,
and tests accordingly.

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .changeset/latex-vite-mathjax-plugin.md            |  2 +-
 apps/docs/src/content/docs/guides/latex-math.md    |  6 ++++--
 apps/vscode-extensions/latex-integration/README.md |  4 +++-
 packages/latex/README.md                           |  6 ++++--
 packages/latex/lib/main.ts                         | 12 ++++++------
 packages/latex/tests/mathjax-load-modes.test.ts    |  7 +++++++
 6 files changed, 25 insertions(+), 12 deletions(-)

diff --git a/.changeset/latex-vite-mathjax-plugin.md b/.changeset/latex-vite-mathjax-plugin.md
index 8f4e2f71..50a4f3fb 100644
--- a/.changeset/latex-vite-mathjax-plugin.md
+++ b/.changeset/latex-vite-mathjax-plugin.md
@@ -4,4 +4,4 @@
 'vscode-prosemark-latex-integration': patch
 ---
 
-Add `@prosemark/latex/vite-plugin-mathjax` to copy configurable paths from the `mathjax` npm package into a Vite build output, pass sub-extension callback context as a single object (including `webview`), and switch the LaTeX VS Code webview to self-hosted `url-import` with the MathJax package URL from `webview.asWebviewUri` (`tex-svg.js` + `sre` under `dist/webview/mathjax/`).
+Add `@prosemark/latex/vite-plugin-mathjax` to copy configurable paths from the `mathjax` npm package into a Vite build output, pass sub-extension callback context as a single object (including `webview`), and switch the LaTeX VS Code webview to self-hosted `url-import` with the MathJax package URL from `webview.asWebviewUri` (`tex-svg.js` + `sre` under `dist/webview/mathjax/`). Use MathJax 4's `startup.typeset: false` instead of the removed `skipStartupTypeset` option in code and documentation.
diff --git a/apps/docs/src/content/docs/guides/latex-math.md b/apps/docs/src/content/docs/guides/latex-math.md
index a836c308..c21d46c8 100644
--- a/apps/docs/src/content/docs/guides/latex-math.md
+++ b/apps/docs/src/content/docs/guides/latex-math.md
@@ -76,7 +76,7 @@ If you assemble markdown extensions yourself (without `prosemarkMarkdownSyntaxEx
 
 ## How MathJax is loaded
 
-In **`url-import`** mode (the default), this package sets `window.MathJax` with `skipStartupTypeset: true` and loader paths, then dynamically imports the startup bundle. Do not set conflicting `tex` / `svg` / `chtml` options on `window.MathJax` yourself before that runs.
+In **`url-import`** mode (the default), this package sets `window.MathJax` with `startup.typeset: false` and loader paths, then dynamically imports the startup bundle. Do not set conflicting `tex` / `svg` / `chtml` options on `window.MathJax` yourself before that runs.
 
 ### Runtime URL — `mathJaxLoadMode: 'url-import'` (default)
 
@@ -119,8 +119,10 @@ For editor-style preview where speech is not needed, disable a11y by configuring
 
 ```javascript
 window.MathJax = {
+  startup: {
+    typeset: false,
+  },
   options: {
-    skipStartupTypeset: true,
     enableSpeech: false,
     enableBraille: false,
     enableEnrichment: false,
diff --git a/apps/vscode-extensions/latex-integration/README.md b/apps/vscode-extensions/latex-integration/README.md
index 4155c985..5c5bb728 100644
--- a/apps/vscode-extensions/latex-integration/README.md
+++ b/apps/vscode-extensions/latex-integration/README.md
@@ -38,8 +38,10 @@ Pick one approach:
 
    ```ts
    window.MathJax = {
+     startup: {
+       typeset: false,
+     },
      options: {
-       skipStartupTypeset: true,
        enableSpeech: false,
        enableBraille: false,
        enableEnrichment: false,
diff --git a/packages/latex/README.md b/packages/latex/README.md
index e237cbef..7949d674 100644
--- a/packages/latex/README.md
+++ b/packages/latex/README.md
@@ -25,7 +25,7 @@ Optionally add **`mathjax`** if you want to self-host it from npm (see below). I
 
 MathJax is **not** bundled into `@prosemark/latex`. See **How to load MathJax** below for **`url-import`** (default) vs **`static-import`**.
 
-Before the dynamic import runs in **`url-import`** mode, this package sets `window.MathJax = { options: { skipStartupTypeset: true }, loader: { paths: { … } } }`. MathJax’s startup must own the full `tex` / `svg` / `chtml` configuration.
+Before the dynamic import runs in **`url-import`** mode, this package sets `window.MathJax = { startup: { typeset: false }, loader: { paths: { … } } }`. MathJax’s startup must own the full `tex` / `svg` / `chtml` configuration.
 
 ### How to load MathJax
 
@@ -66,8 +66,10 @@ If you do not need speech/enrichment (typical for editor preview), disable a11y
 
 ```ts
 window.MathJax = {
+  startup: {
+    typeset: false,
+  },
   options: {
-    skipStartupTypeset: true,
     enableSpeech: false,
     enableBraille: false,
     enableEnrichment: false,
diff --git a/packages/latex/lib/main.ts b/packages/latex/lib/main.ts
index 0487746c..0c320b37 100644
--- a/packages/latex/lib/main.ts
+++ b/packages/latex/lib/main.ts
@@ -97,11 +97,11 @@ interface MathJaxReady {
 }
 
 interface MathJaxConfig {
-  options?: { skipStartupTypeset?: boolean };
+  startup?: { typeset?: boolean };
   loader?: { paths?: Record<string, string> };
+  options?: Record<string, unknown>;
   tex?: Record<string, unknown>;
   svg?: Record<string, unknown>;
-  startup?: Record<string, unknown>;
 }
 
 declare global {
@@ -130,8 +130,8 @@ export function preconfigureMathJaxLoader(packageUrl: string): void {
     );
   }
   window.MathJax = {
-    options: {
-      skipStartupTypeset: true,
+    startup: {
+      typeset: false,
     },
     loader: {
       paths: {
@@ -213,8 +213,8 @@ const ensureMathJax = (
     // modules from the app origin (`/input/...`, etc.) and `tex2svgPromise`
     // never resolves. Point `mathjax` at the published package tree instead.
     window.MathJax = {
-      options: {
-        skipStartupTypeset: true,
+      startup: {
+        typeset: false,
       },
       loader: {
         paths: {
diff --git a/packages/latex/tests/mathjax-load-modes.test.ts b/packages/latex/tests/mathjax-load-modes.test.ts
index b50404e7..b5892bb5 100644
--- a/packages/latex/tests/mathjax-load-modes.test.ts
+++ b/packages/latex/tests/mathjax-load-modes.test.ts
@@ -42,5 +42,12 @@ describe('MathJax load helpers', () => {
   test('preconfigureMathJaxLoader sets loader paths', () => {
     preconfigureMathJaxLoader('https://example.test/mj');
     expect(getConfiguredMathJaxPackageUrl()).toBe('https://example.test/mj');
+    expect(
+      (
+        globalThis as typeof globalThis & {
+          MathJax?: { startup?: { typeset?: boolean } };
+        }
+      ).MathJax?.startup?.typeset,
+    ).toBe(false);
   });
 });

From 3893b8e3b45b6cd6fb4cde54e323b49804c2bebd Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 22:42:25 +0000
Subject: [PATCH 14/22] Revert vite.config.mts in latex-integration eslint
 files list

vite.config.mts is git-tracked source, but sibling VS Code extensions do not
list their vite configs in eslint.config.ts and lint passes without it.

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 apps/vscode-extensions/latex-integration/eslint.config.ts | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/apps/vscode-extensions/latex-integration/eslint.config.ts b/apps/vscode-extensions/latex-integration/eslint.config.ts
index 2ad605db..a4adf00a 100644
--- a/apps/vscode-extensions/latex-integration/eslint.config.ts
+++ b/apps/vscode-extensions/latex-integration/eslint.config.ts
@@ -5,12 +5,7 @@ export default defineConfig([
   ...baseConfig,
   globalIgnores(['out/']),
   {
-    files: [
-      '**/*.ts',
-      'tsdown.config.mts',
-      'vite.config.mts',
-      '.vscode-test.mjs',
-    ],
+    files: ['**/*.ts', 'tsdown.config.mts', '.vscode-test.mjs'],
     languageOptions: {
       parserOptions: {
         tsconfigRootDir: import.meta.dirname,

From 8eeaec226deed53ca89e702ab3c2fc4f1670fef9 Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 22:59:32 +0000
Subject: [PATCH 15/22] Docs: drop unsupported claim that editor preview
 typically skips a11y

The VS Code extension keeps speech support via url-import and copied sre/.
Frame disabling a11y as a static-import tradeoff, not a preview default.

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 apps/docs/src/content/docs/guides/latex-math.md    | 2 +-
 apps/vscode-extensions/latex-integration/README.md | 2 +-
 packages/latex/README.md                           | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/apps/docs/src/content/docs/guides/latex-math.md b/apps/docs/src/content/docs/guides/latex-math.md
index c21d46c8..85317e06 100644
--- a/apps/docs/src/content/docs/guides/latex-math.md
+++ b/apps/docs/src/content/docs/guides/latex-math.md
@@ -115,7 +115,7 @@ import 'mathjax/tex-svg.js';
 
 **Accessibility / speech worker:** the combined startup bundle includes MathJax a11y support and loads **`sre/speech-worker.js` as a web worker** at runtime. Your bundler typically only ships the main JS file, so the worker is missing unless you also copy `sre/` and configure MathJax’s loader paths, or use **`url-import`** with a self-hosted `mathjax/` folder (see [`@prosemark/latex/vite-plugin-mathjax`](https://www.npmjs.com/package/@prosemark/latex) on npm).
 
-For editor-style preview where speech is not needed, disable a11y by configuring `window.MathJax` **before** importing MathJax:
+If you do not need speech or enrichment and want to avoid shipping the `sre/` worker, configure `window.MathJax` **before** importing MathJax:
 
 ```javascript
 window.MathJax = {
diff --git a/apps/vscode-extensions/latex-integration/README.md b/apps/vscode-extensions/latex-integration/README.md
index 5c5bb728..1540e464 100644
--- a/apps/vscode-extensions/latex-integration/README.md
+++ b/apps/vscode-extensions/latex-integration/README.md
@@ -34,7 +34,7 @@ If you switch to **`static-import`** (`import 'mathjax/tex-svg.js'` bundled into
 
 Pick one approach:
 
-1. **Disable a11y** (simplest for editor preview) — set options on `window.MathJax` **before** the static import:
+1. **Disable a11y** (simplest with `static-import` when you are not copying `sre/`) — set options on `window.MathJax` **before** the static import:
 
    ```ts
    window.MathJax = {
diff --git a/packages/latex/README.md b/packages/latex/README.md
index 7949d674..471a77f3 100644
--- a/packages/latex/README.md
+++ b/packages/latex/README.md
@@ -62,7 +62,7 @@ latexMarkdownEditorExtensions({
 
 **Accessibility / speech worker:** the combined `tex-svg.js` / `tex-chtml.js` startup includes MathJax a11y extensions. At runtime it loads **`sre/speech-worker.js` as a separate web worker**. Bundlers usually only emit your main bundle, so the worker is missing unless you copy `sre/` from the `mathjax` package and configure `loader.paths.mathjax`, or use **`url-import`** with `@prosemark/latex/vite-plugin-mathjax` instead.
 
-If you do not need speech/enrichment (typical for editor preview), disable a11y by setting `window.MathJax.options` **before** the static import:
+If you do not need speech or enrichment and want to avoid shipping the `sre/` worker, disable a11y by setting `window.MathJax.options` **before** the static import:
 
 ```ts
 window.MathJax = {

From d2a90dccc122a648d710f9f9cd0f5c34921c8e68 Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 23:04:00 +0000
Subject: [PATCH 16/22] Changeset: use patch bumps while packages are 0.x

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .changeset/latex-vite-mathjax-plugin.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.changeset/latex-vite-mathjax-plugin.md b/.changeset/latex-vite-mathjax-plugin.md
index 50a4f3fb..5e82281d 100644
--- a/.changeset/latex-vite-mathjax-plugin.md
+++ b/.changeset/latex-vite-mathjax-plugin.md
@@ -1,6 +1,6 @@
 ---
-'@prosemark/latex': minor
-'@prosemark/vscode-extension-integrator': minor
+'@prosemark/latex': patch
+'@prosemark/vscode-extension-integrator': patch
 'vscode-prosemark-latex-integration': patch
 ---
 

From ae2b94661fef24962190b4307f56719e8306b288 Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 23:08:48 +0000
Subject: [PATCH 17/22] Changeset: drop startup.typeset note (introduced in
 this PR)

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .changeset/latex-vite-mathjax-plugin.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.changeset/latex-vite-mathjax-plugin.md b/.changeset/latex-vite-mathjax-plugin.md
index 5e82281d..bf8bf37c 100644
--- a/.changeset/latex-vite-mathjax-plugin.md
+++ b/.changeset/latex-vite-mathjax-plugin.md
@@ -4,4 +4,4 @@
 'vscode-prosemark-latex-integration': patch
 ---
 
-Add `@prosemark/latex/vite-plugin-mathjax` to copy configurable paths from the `mathjax` npm package into a Vite build output, pass sub-extension callback context as a single object (including `webview`), and switch the LaTeX VS Code webview to self-hosted `url-import` with the MathJax package URL from `webview.asWebviewUri` (`tex-svg.js` + `sre` under `dist/webview/mathjax/`). Use MathJax 4's `startup.typeset: false` instead of the removed `skipStartupTypeset` option in code and documentation.
+Add `@prosemark/latex/vite-plugin-mathjax` to copy configurable paths from the `mathjax` npm package into a Vite build output, pass sub-extension callback context as a single object (including `webview`), and switch the LaTeX VS Code webview to self-hosted `url-import` with the MathJax package URL from `webview.asWebviewUri` (`tex-svg.js` + `sre` under `dist/webview/mathjax/`).

From 9e2b1ce24bd8eb22176321eb349abc7e8edb391c Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 23:11:49 +0000
Subject: [PATCH 18/22] Changeset: document pre-0.0.2 VS Code math rendering
 regression

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .changeset/latex-vite-mathjax-plugin.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/.changeset/latex-vite-mathjax-plugin.md b/.changeset/latex-vite-mathjax-plugin.md
index bf8bf37c..91cdf424 100644
--- a/.changeset/latex-vite-mathjax-plugin.md
+++ b/.changeset/latex-vite-mathjax-plugin.md
@@ -4,4 +4,8 @@
 'vscode-prosemark-latex-integration': patch
 ---
 
-Add `@prosemark/latex/vite-plugin-mathjax` to copy configurable paths from the `mathjax` npm package into a Vite build output, pass sub-extension callback context as a single object (including `webview`), and switch the LaTeX VS Code webview to self-hosted `url-import` with the MathJax package URL from `webview.asWebviewUri` (`tex-svg.js` + `sre` under `dist/webview/mathjax/`).
+Fix LaTeX math failing to render in the VS Code webview after 0.0.2 bundled MathJax `tex-svg.js` into `webview.js`: MathJax 4's startup loads `sre/speech-worker.js` as a separate web worker, which the bundler did not ship.
+
+- **vscode-prosemark-latex-integration**: self-host MathJax with `url-import` (`tex-svg.js` + `sre/` under `dist/webview/mathjax/`) and pass the package URL from the extension host via `webview.asWebviewUri`.
+- **@prosemark/latex**: add `@prosemark/latex/vite-plugin-mathjax` to copy configurable paths from the `mathjax` npm package into a Vite build output.
+- **@prosemark/vscode-extension-integrator**: pass sub-extension callback context as a single object (including `webview`).

From dbd0dc9a8c068f7cc47ab5db7b60db9c255c6eba Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 23:20:03 +0000
Subject: [PATCH 19/22] Changeset: split per package and fix VS Code regression
 wording

Describe the 0.0.2 bug as math failing when MathJax was bundled into
the extension; drop the speech-worker cause (introduced in this PR).

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .changeset/integrator-sub-extension-context.md |  5 +++++
 .changeset/latex-vite-mathjax-plugin.md        | 11 -----------
 .changeset/latex-vite-plugin-mathjax.md        |  5 +++++
 .changeset/vscode-latex-mathjax-url-import.md  |  5 +++++
 4 files changed, 15 insertions(+), 11 deletions(-)
 create mode 100644 .changeset/integrator-sub-extension-context.md
 delete mode 100644 .changeset/latex-vite-mathjax-plugin.md
 create mode 100644 .changeset/latex-vite-plugin-mathjax.md
 create mode 100644 .changeset/vscode-latex-mathjax-url-import.md

diff --git a/.changeset/integrator-sub-extension-context.md b/.changeset/integrator-sub-extension-context.md
new file mode 100644
index 00000000..1099f4d3
--- /dev/null
+++ b/.changeset/integrator-sub-extension-context.md
@@ -0,0 +1,5 @@
+---
+'@prosemark/vscode-extension-integrator': patch
+---
+
+Pass sub-extension callback context as a single object (including `webview`) so companion extensions can resolve webview resource URLs.
diff --git a/.changeset/latex-vite-mathjax-plugin.md b/.changeset/latex-vite-mathjax-plugin.md
deleted file mode 100644
index 91cdf424..00000000
--- a/.changeset/latex-vite-mathjax-plugin.md
+++ /dev/null
@@ -1,11 +0,0 @@
----
-'@prosemark/latex': patch
-'@prosemark/vscode-extension-integrator': patch
-'vscode-prosemark-latex-integration': patch
----
-
-Fix LaTeX math failing to render in the VS Code webview after 0.0.2 bundled MathJax `tex-svg.js` into `webview.js`: MathJax 4's startup loads `sre/speech-worker.js` as a separate web worker, which the bundler did not ship.
-
-- **vscode-prosemark-latex-integration**: self-host MathJax with `url-import` (`tex-svg.js` + `sre/` under `dist/webview/mathjax/`) and pass the package URL from the extension host via `webview.asWebviewUri`.
-- **@prosemark/latex**: add `@prosemark/latex/vite-plugin-mathjax` to copy configurable paths from the `mathjax` npm package into a Vite build output.
-- **@prosemark/vscode-extension-integrator**: pass sub-extension callback context as a single object (including `webview`).
diff --git a/.changeset/latex-vite-plugin-mathjax.md b/.changeset/latex-vite-plugin-mathjax.md
new file mode 100644
index 00000000..17fc9bcb
--- /dev/null
+++ b/.changeset/latex-vite-plugin-mathjax.md
@@ -0,0 +1,5 @@
+---
+'@prosemark/latex': patch
+---
+
+Add `@prosemark/latex/vite-plugin-mathjax` to copy configurable paths from the `mathjax` npm package into a Vite build output.
diff --git a/.changeset/vscode-latex-mathjax-url-import.md b/.changeset/vscode-latex-mathjax-url-import.md
new file mode 100644
index 00000000..1ac60091
--- /dev/null
+++ b/.changeset/vscode-latex-mathjax-url-import.md
@@ -0,0 +1,5 @@
+---
+vscode-prosemark-latex-integration: patch
+---
+
+Fix LaTeX math failing to render in the VS Code webview caused by bundling MathJax into the extension in 0.0.2. Load MathJax from a self-hosted `mathjax/` folder with `url-import` and pass the package URL from the extension host via `webview.asWebviewUri`.

From 6268c1f3da482fd3e60fb2b0aea349bdc80dbab3 Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 23:23:03 +0000
Subject: [PATCH 20/22] Changeset: describe VS Code math bug as blocked CDN
 access

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .changeset/vscode-latex-mathjax-url-import.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.changeset/vscode-latex-mathjax-url-import.md b/.changeset/vscode-latex-mathjax-url-import.md
index 1ac60091..92969171 100644
--- a/.changeset/vscode-latex-mathjax-url-import.md
+++ b/.changeset/vscode-latex-mathjax-url-import.md
@@ -2,4 +2,4 @@
 vscode-prosemark-latex-integration: patch
 ---
 
-Fix LaTeX math failing to render in the VS Code webview caused by bundling MathJax into the extension in 0.0.2. Load MathJax from a self-hosted `mathjax/` folder with `url-import` and pass the package URL from the extension host via `webview.asWebviewUri`.
+Fix LaTeX math failing to render in the VS Code webview when MathJax was loaded from a CDN without explicitly listing it in the extension's `package.json` settings. Self-host MathJax with `url-import` (`tex-svg.js` and `sre/` under `dist/webview/mathjax/`) and pass the package URL from the extension host via `webview.asWebviewUri`.

From 8d9b2d264a9d2236876eb0e8dceeece2adce7d6c Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 23:23:16 +0000
Subject: [PATCH 21/22] Changeset: emphasize webview in integrator callback
 context

Co-authored-by: J. Simon Richard <jsimonrichard@gmail.com>
---
 .changeset/integrator-sub-extension-context.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.changeset/integrator-sub-extension-context.md b/.changeset/integrator-sub-extension-context.md
index 1099f4d3..d2ce6a8e 100644
--- a/.changeset/integrator-sub-extension-context.md
+++ b/.changeset/integrator-sub-extension-context.md
@@ -2,4 +2,4 @@
 '@prosemark/vscode-extension-integrator': patch
 ---
 
-Pass sub-extension callback context as a single object (including `webview`) so companion extensions can resolve webview resource URLs.
+Pass sub-extension callback context as a single object including `webview`, so companion extensions can resolve webview resource URLs.

From 8e545e6aa9ff9e3113754ef07cb827a9365492a1 Mon Sep 17 00:00:00 2001
From: "J. Simon Richard" <jsimonrichard@gmail.com>
Date: Sat, 6 Jun 2026 19:31:09 -0400
Subject: [PATCH 22/22] Fix LaTeX math rendering in VS Code webview

Self-host MathJax in the extension to resolve rendering issues.
---
 .changeset/vscode-latex-mathjax-url-import.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.changeset/vscode-latex-mathjax-url-import.md b/.changeset/vscode-latex-mathjax-url-import.md
index 92969171..be0278e5 100644
--- a/.changeset/vscode-latex-mathjax-url-import.md
+++ b/.changeset/vscode-latex-mathjax-url-import.md
@@ -2,4 +2,4 @@
 vscode-prosemark-latex-integration: patch
 ---
 
-Fix LaTeX math failing to render in the VS Code webview when MathJax was loaded from a CDN without explicitly listing it in the extension's `package.json` settings. Self-host MathJax with `url-import` (`tex-svg.js` and `sre/` under `dist/webview/mathjax/`) and pass the package URL from the extension host via `webview.asWebviewUri`.
+Fix LaTeX math rendering issue in the VS Code extension webview by self-hosting MathJax inside the extension instead of using a CDN.