Merge pull request #738 from mathjax/extension-versions

Add versions to component files and check them when loaded

Author: dpvc

components/bin/build

@@ -30,7 +30,7 @@ const path = require('path');
 /**
  * The amount of space for each level of indentation
  */
-const INDENT = '    ';
+const INDENT = '  ';
 
 /**
  * The pattern to use when looking for explort commands to process
@@ -51,17 +51,28 @@ const mjGlobal = path.join('..', mjPath, 'components', 'global.js');
  */
 const config = JSON.parse(fs.readFileSync(process.argv[2] || 'build.json'));
 
+function getType() {
+  const component = config.component || 'part';
+  if (component.match(/\/(svg|chtml|common)\/fonts\//)) return RegExp.$1 + '-font';
+  if (component.match(/\/(mathml|tex)\/.+\//)) return RegExp.$1 + '-extension';
+  if (component.match(/^(.+)\//)) return RegExp.$1;
+  return component;
+}
+
 /**
  * Extract the configuration values
  */
 const COMPONENT = path.basename(config.component || 'part');                // name of the component
+const ID = config.id || config.component || 'part';                         // the ID of the component
 const TARGETS = config.targets || [];                                       // the files to include in the component
 const EXCLUDE = new Map((config.exclude || []).map(name => [name, true]));  // files to exclude from the component
 const EXCLUDESUBDIRS = config.excludeSubdirs === 'true';                    // exclude subdirectories or not
 const JS = config.js || config.mathjax || mjPath;                           // path to the compiled .js files
 const LIB = config.lib || './lib';                                          // path to the lib directory to create
-const GLOBAL = config.global || mjGlobal;                                   // path to the global.js file
 const TS = config.ts || JS.replace(/js$/, 'ts');                            // path to the .ts files
+const GLOBAL = config.global || mjGlobal;                                   // path to the global.js file
+const VERSION = config.version || mjGlobal.replace(/global/, 'version');    // path to the version.js file
+const TYPE = config.type || getType();                                      // the module type
 
 /**
  * The list of files that need to be added to the lib directory
@@ -222,6 +233,7 @@ function processGlobal() {
   console.info('  ' + COMPONENT + '.ts');
   const lines = [
     `import {combineWithMathJax} from '${GLOBAL}';`,
+    `import {VERSION} from '${VERSION}';`,
     '',
   ];
   const packages = [];
@@ -230,9 +242,17 @@ function processGlobal() {
     const dir = path.dirname(PACKAGE[0]).split(path.sep)[0];
     packages.push(processPackage(lines, INDENT, dir));
   }
-  lines.push('', `combineWithMathJax({_: {`);
-  lines.push(INDENT + packages.join(',\n' + INDENT));
-  lines.push('}});');
+  const name = (ID.match(/[^a-zA-Z0-9_]/) ? `"${ID}"` : ID);
+  lines.push(
+    '',
+    'if (MathJax.loader) {',
+      INDENT + `MathJax.loader.checkVersion('${ID}', VERSION, '${TYPE}');`,
+    '}',
+    '',
+    `combineWithMathJax({_: {`,
+      INDENT + packages.join(',\n' + INDENT),
+    '}});'
+  );
   fs.writeFileSync(path.join(LIB, COMPONENT + '.js'), lines.join('\n') + '\n');
 }
 

components/src/input/mml/build.json

@@ -1,5 +1,5 @@
 {
-  "component": "inpu/mml",
+  "component": "input/mml",
   "targets": [
     "input/mathml.ts",
     "input/mathml"

components/src/input/mml/extensions/mml3/build.json

@@ -1,4 +1,5 @@
 {
+  "id": "[mml]/mml3",
   "component": "input/mml/extensions/mml3",
   "targets": ["input/mathml/mml3"]
 }

components/src/input/tex/extensions/action/build.json

@@ -1,4 +1,5 @@
 {
+  "id": "[tex]/action",
   "component": "input/tex/extensions/action",
   "targets": ["input/tex/action"]
 }

components/src/input/tex/extensions/all-packages/build.json

@@ -1,4 +1,5 @@
 {
+  "id": "[tex]/all-packages",
   "component": "input/tex/extensions/all-packages",
   "targets": [
     "input/tex/AllPackages.ts",

components/src/input/tex/extensions/ams/build.json

@@ -1,4 +1,5 @@
 {
+  "id": "[tex]/ams",
   "component": "input/tex/extensions/ams",
   "targets": ["input/tex/ams"]
 }

components/src/input/tex/extensions/amscd/build.json

@@ -1,4 +1,5 @@
 {
+  "id": "[tex]/amscd",
   "component": "input/tex/extensions/amscd",
   "targets": ["input/tex/amscd"]
 }

components/src/input/tex/extensions/autoload/build.json

@@ -1,4 +1,5 @@
 {
+  "id": "[tex]/autoload",
   "component": "input/tex/extensions/autoload",
   "targets": ["input/tex/autoload"]
 }

components/src/input/tex/extensions/bbox/build.json

@@ -1,4 +1,5 @@
 {
+  "id": "[tex]/bbox",
   "component": "input/tex/extensions/bbox",
   "targets": ["input/tex/bbox"]
 }

components/src/input/tex/extensions/boldsymbol/build.json

@@ -1,4 +1,5 @@
 {
+  "id": "[tex]/boldsymbol",
   "component": "input/tex/extensions/boldsymbol",
   "targets": ["input/tex/boldsymbol"]
 }