Implement component-based typing for the MathJax variable

components/bin/build

@@ -309,6 +309,7 @@ function processGlobal() {
   );
   makeDir('');
   fs.writeFileSync(path.join(LIB, COMPONENT + '.js'), lines.join('\n') + '\n');
+  fs.writeFileSync(path.join(LIB, COMPONENT + '.d.ts'), 'export {};\n');
 }
 
 /**

components/bin/pack

@@ -167,6 +167,14 @@ async function webpackLib(dir) {
         .concat(list.filter(a => a.slice(2, 4) !== './').sort())
         .join('\n')
     );
+    if (!config.noDTS) {
+      const dts = config.dist
+            ? path.resolve(dir, config.dist, path.basename(config.name) + '.d.ts')
+            : path.resolve(jsPath, '..', bundle, config.name + '.d.ts');
+      if (!fs.existsSync(dts)) {
+        fs.writeFileSync(dts, `export {}`);
+      }
+    }
   } catch (err) {
     console.error(err);
   }

components/json.d.cjs

@@ -0,0 +1,2 @@
+export function json(file: string): any;
+export function require(file: string): any;

components/json.d.cts

@@ -0,0 +1,2 @@
+export function json(file: string): any;
+export function require(file: string): any;

components/mjs/a11y/assistive-mml/assistive-mml.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/a11y/complexity/complexity.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/a11y/explorer/explorer.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/a11y/semantic-enrich/semantic-enrich.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/a11y/speech/speech.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/a11y/sre/sre.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/a11y/sre/worker/speech-worker.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/a11y/util.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/adaptors/jsdom/jsdom.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/adaptors/linkedom/linkedom.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/adaptors/liteDOM/liteDOM.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/core/core.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/core/locale.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/dependencies.d.ts

@@ -0,0 +1,12 @@
+export const dependencies: {
+  [component: string]: string[];
+};
+export const paths: {
+  [path: string]: string;
+};
+export const provides: {
+  [component: string]: string[];
+};
+export const compatibility: {
+  [component: string]: string;
+};

components/mjs/input/asciimath/asciimath.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/mml/entities/entities.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/mml/extensions/mml3/mml3.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/mml/init.d.ts

@@ -0,0 +1,2 @@
+import {MathML} from '@mathjax/src/mjs/input/mathml.js';
+export {MathML};

components/mjs/input/mml/mml.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex-base/tex-base.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extension.d.ts

@@ -0,0 +1 @@
+export function fontExtension(id: string, name: string, pkg?: string): void;

components/mjs/input/tex/extensions/action/action.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/ams/ams.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/amscd/amscd.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/autoload/autoload.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/bbm/bbm.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/bboldx/bboldx.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/bbox/bbox.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/begingroup/begingroup.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/boldsymbol/boldsymbol.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/braket/braket.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/bussproofs/bussproofs.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/cancel/cancel.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/cases/cases.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/centernot/centernot.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/color/color.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/colortbl/colortbl.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/colorv2/colorv2.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/configmacros/configmacros.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/dsfont/dsfont.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/empheq/empheq.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/enclose/enclose.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/extpfeil/extpfeil.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/fontsizev3/fontsizev3.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/gensymb/gensymb.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/html/html.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/mathtools/mathtools.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/mhchem/mhchem.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/newcommand/newcommand.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/noerrors/noerrors.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/noundefined/noundefined.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/physics/physics.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/require/require.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/setoptions/setoptions.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/tagformat/tagformat.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/texhtml/texhtml.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/textcomp/textcomp.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/textmacros/textmacros.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/unicode/unicode.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/units/units.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/upgreek/upgreek.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/extensions/verb/verb.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/input/tex/register.d.ts

@@ -0,0 +1 @@
+export function registerTex(packageList?: string[], tex?: boolean): void;

components/mjs/input/tex/tex.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/loader/loader.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/mml-chtml-nofont/mml-chtml-nofont.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/mml-chtml/mml-chtml.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/mml-svg-nofont/mml-svg-nofont.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/mml-svg/mml-svg.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/node-main/config.json

@@ -5,10 +5,13 @@
     "copy": [
       "node-main.mjs",
       "node-main.cjs",
-      "node-main-setup.cjs"
+      "node-main-setup.cjs",
+      "node-main.d.mts",
+      "node-main.d.cts"
     ]
   },
   "webpack": {
-    "name": "node-main"
+    "name": "node-main",
+    "noDTS": true
   }
 }

components/mjs/node-main/node-main.d.cts

@@ -0,0 +1,7 @@
+import { EMPTY } from '@mathjax/src/mjs/types/Types.js';
+import { COMPONENT_LIST } from '@mathjax/src/mjs/types/mjx.js';
+import { LITE_DOM, MATHJAX_CONFIG, MATHJAX_OBJECT } from '@mathjax/src/mjs/types/dom/lite.js';
+
+export function init<T extends COMPONENT_LIST<LITE_DOM> = EMPTY>(
+  config: MATHJAX_CONFIG<T | 'startup'>
+): Promise<MATHJAX_OBJECT<T | 'startup'>>;

components/mjs/node-main/node-main.d.mts

@@ -0,0 +1,7 @@
+import { EMPTY } from '@mathjax/src/mjs/types/Types.js';
+import { COMPONENT_LIST } from '@mathjax/src/mjs/types/mjx.js';
+import { LITE_DOM, MATHJAX_CONFIG, MATHJAX_OBJECT } from '@mathjax/src/mjs/types/dom/lite.js';
+
+export function init<T extends COMPONENT_LIST<LITE_DOM> = EMPTY>(
+  config: MATHJAX_CONFIG<T | 'startup'>
+): Promise<MATHJAX_OBJECT<T | 'startup'>>;

components/mjs/output/chtml/chtml.d.ts

@@ -0,0 +1 @@
+export function loadFont(startup: (ready: () => void) => Promise<void>, preload: boolean): Promise<void>;

components/mjs/output/chtml/chtml.js

@@ -9,4 +9,3 @@ OutputUtil.config('chtml', CHTML, fontName, DefaultFont);
 export function loadFont(startup, preload) {
   return OutputUtil.loadFont(startup, 'chtml', fontName, preload);
 }
-

components/mjs/output/svg/svg.d.ts

@@ -0,0 +1 @@
+export function loadFont(startup: (ready: () => void) => Promise<void>, preload: boolean): Promise<void>;

components/mjs/output/svg/svg.js

@@ -9,4 +9,3 @@ OutputUtil.config('svg', SVG, fontName, DefaultFont);
 export function loadFont(startup, preload) {
   return OutputUtil.loadFont(startup, 'svg', fontName, preload);
 }
-

components/mjs/output/util.d.ts

@@ -0,0 +1,35 @@
+import { OutputJax } from '@mathjax/src/mjs/core/OutputJax.js';
+import { Font } from '@mathjax/src/mjs/output/common/FontData.js';
+
+export function configFont(
+  font: string,
+  jax: string,
+  config: { fontPath?: string },
+  extension?: string,
+): string;
+
+export function configExtensions(
+  jax: string,
+  config: {
+    fontExtensions?: string[];
+    fontPath?: string;
+  },
+): string[];
+
+export const OutputUtil: {
+
+  config<N = any, T = any, D = any>(
+    jax: string,
+    jaxClass: OutputJax<N, T, D>,
+    defaultFont: Font,
+    fontClass: any,
+  ): void,
+
+  loadFont(
+    startup: (ready: () => void) => Promise<void>,
+    jax: string,
+    font: string,
+    preloaded?: boolean,
+  ): Promise<void>;
+
+};

components/mjs/require/config.json

@@ -4,7 +4,9 @@
     "from": "../..",
     "copy": [
       "require.mjs",
-      "json.cjs"
+      "require.d.mts",
+      "json.cjs",
+      "json.d.cts"
     ]
   }
 }

components/mjs/source.d.ts

@@ -0,0 +1,3 @@
+export const source: {
+  [component: string]: string;
+}

components/mjs/startup/hasown.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/startup/init.d.ts

@@ -0,0 +1 @@
+export function startup(ready: () => Promise<void>): Promise<void>;

components/mjs/startup/startup.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/tex-chtml-nofont/tex-chtml-nofont.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/tex-chtml/tex-chtml.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/tex-mml-chtml-nofont/tex-mml-chtml-nofont.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/tex-mml-chtml/tex-mml-chtml.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/tex-mml-svg-nofont/tex-mml-svg-nofont.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/tex-mml-svg/tex-mml-svg.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/tex-svg-nofont/tex-svg-nofont.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/tex-svg/tex-svg.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/ui/lazy/lazy.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/ui/menu/menu.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/ui/no-dark-mode/no-dark-mode.d.ts

@@ -0,0 +1 @@
+export {};

components/mjs/ui/safe/safe.d.ts

@@ -0,0 +1 @@
+export {};

testsuite/src/setupTex.ts

@@ -122,7 +122,7 @@ export function setupTex(
   Locale.setLocale();
   const html = new HTMLDocument('', adaptor, { InputJax: tex });
   convert = (expr: string, display: boolean) =>
-    toMathML(html.convert(expr, { display: display, end: STATE.CONVERT }));
+    toMathML(html.convert(expr, { display: display, end: STATE.CONVERT }) as MmlNode);
 }
 
 /**
@@ -235,7 +235,7 @@ export function setupTexWithOutput(
   const visitor = new SerializedMmlVisitor();
   const toMathML = (node: MmlNode) => visitor.visitTree(node);
   convert = (expr: string, display: boolean) =>
-    toMathML(html.convert(expr, { display: display, end: STATE.CONVERT }));
+    toMathML(html.convert(expr, { display: display, end: STATE.CONVERT }) as MmlNode);
 }
 
 /*********************************************************************/