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>

Author: cursoragent

.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).

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;
+  }
+}

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);

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,
+      },
+    },
+  },
+};