@pie-lib/math-input-mathlive 1.0.2 → 1.0.3

package/lib/__tests__/mathlive-instance.test.js

@@ -77,10 +77,43 @@ describe('mathlive-instance', function () {
     it('returns undefined without an element', function () {
       expect(instance.applyStaticMath(null, 'x')).toBeUndefined();
     });
-    it('returns undefined when MathLive has not loaded', function () {
+    it('defers (returns undefined) when MathLive has not loaded', function () {
       var el = document.createElement('div');
       expect(instance.applyStaticMath(el, 'x')).toBeUndefined();
     });
+    it('renders synchronously once MathLive is available', function () {
+      var el = document.createElement('div');
+      instance.__setMathLiveForTest({
+        convertLatexToMarkup: function convertLatexToMarkup(l) {
+          return "<span>".concat(l, "</span>");
+        }
+      });
+      expect(instance.applyStaticMath(el, '\\pi')).toBe(el);
+      expect(el.innerHTML).toEqual('<span>\\pi</span>');
+    });
+    it('falls back to the element textContent when no latex is passed', function () {
+      var el = document.createElement('div');
+      el.textContent = '\\theta';
+      instance.__setMathLiveForTest({
+        convertLatexToMarkup: function convertLatexToMarkup(l) {
+          return "<i>".concat(l, "</i>");
+        }
+      });
+      instance.applyStaticMath(el);
+      expect(el.innerHTML).toEqual('<i>\\theta</i>');
+    });
+    it('bridges stored latex (newLine embed) before rendering', function () {
+      var el = document.createElement('div');
+      instance.__setMathLiveForTest({
+        convertLatexToMarkup: function convertLatexToMarkup(l) {
+          return l;
+        }
+      });
+      instance.applyStaticMath(el, 'a\\embed{newLine}[]b');
+
+      // \embed{newLine}[] must become a multiline environment
+      expect(el.innerHTML).toContain('displaylines');
+    });
   });
   describe('configureFonts', function () {
     // MathLive's default fontsDirectory is the relative './fonts/', which it

package/lib/__tests__/mathlive-instance.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"mathlive-instance.test.js","names":["describe","instance","beforeEach","jest","resetModules","require","__resetEmbeds","it","registerEmbed","htmlString","latex","expect","registeredEmbeds","toEqual","getMacros","answerBlock","newLine","somethingCustom","mathliveLatex","custom","Error","not","toThrow","undefined","macros","parallelogram","toBeDefined","longdiv","napprox","applyStaticMath","toBeUndefined","el","document","createElement","_typeof2","configureFonts","toBe","MathfieldElement","__setMathLiveForTest","fontsDirectory","concat","baseURI","replace","startsWith","toBeNull","latexToMarkup"],"sources":["../../src/__tests__/mathlive-instance.test.js"],"sourcesContent":["describe('mathlive-instance', () => {\n  let instance;\n\n  beforeEach(() => {\n    jest.resetModules();\n    // eslint-disable-next-line global-require\n    instance = require('../mathlive-instance');\n    instance.__resetEmbeds();\n  });\n\n  describe('registerEmbed', () => {\n    it('registers a known embed and exposes it as a macro', () => {\n      instance.registerEmbed('answerBlock', () => ({\n        htmlString: '<div class=\"answerBlock\"></div>',\n        latex: () => '\\\\embed{answerBlock}[]',\n      }));\n\n      expect(instance.registeredEmbeds()).toEqual(['answerBlock']);\n      // The macro tags output with data-embed so CSS can target it, replacing\n      // MathQuill's htmlString hook.\n      expect(instance.getMacros().answerBlock).toEqual('\\\\htmlData{embed=answerBlock}{\\\\placeholder{}}');\n    });\n\n    it('registers newLine as a harmless macro (it is handled by latex-bridge)', () => {\n      instance.registerEmbed('newLine', () => ({ latex: () => '\\\\embed{newLine}[]' }));\n\n      expect(instance.getMacros().newLine).toEqual('\\\\htmlData{embed=newLine}{}');\n    });\n\n    it('falls back to a placeholder for an unknown embed', () => {\n      instance.registerEmbed('somethingCustom', () => ({ htmlString: '<b>x</b>' }));\n\n      expect(instance.getMacros().somethingCustom).toEqual('\\\\htmlData{embed=somethingCustom}{\\\\placeholder{}}');\n    });\n\n    it('honours an explicit mathliveLatex from the factory', () => {\n      instance.registerEmbed('custom', () => ({ mathliveLatex: '\\\\alpha' }));\n\n      expect(instance.getMacros().custom).toEqual('\\\\htmlData{embed=custom}{\\\\alpha}');\n    });\n\n    it('does not throw when the factory throws', () => {\n      expect(() =>\n        instance.registerEmbed('bad', () => {\n          throw new Error('boom');\n        }),\n      ).not.toThrow();\n\n      expect(instance.registeredEmbeds()).toEqual(['bad']);\n    });\n\n    it('ignores bad arguments', () => {\n      instance.registerEmbed(undefined, () => ({}));\n      instance.registerEmbed('noFactory', undefined);\n\n      expect(instance.registeredEmbeds()).toEqual([]);\n    });\n\n    it('always includes the pie macro set', () => {\n      const macros = instance.getMacros();\n\n      expect(macros.parallelogram).toBeDefined();\n      expect(macros.longdiv).toBeDefined();\n      expect(macros.napprox).toEqual('\\\\not\\\\approx');\n    });\n  });\n\n  describe('applyStaticMath', () => {\n    it('returns undefined without an element', () => {\n      expect(instance.applyStaticMath(null, 'x')).toBeUndefined();\n    });\n\n    it('returns undefined when MathLive has not loaded', () => {\n      const el = document.createElement('div');\n\n      expect(instance.applyStaticMath(el, 'x')).toBeUndefined();\n    });\n  });\n\n  describe('configureFonts', () => {\n    // MathLive's default fontsDirectory is the relative './fonts/', which it\n    // resolves against its own (empty, when bundled) script url and throws\n    // \"Invalid base URL\" from loadFonts. Paths must become absolute.\n    it('is exported and callable before MathLive loads', () => {\n      expect(typeof instance.configureFonts).toBe('function');\n      expect(() => instance.configureFonts('/mathlive-fonts')).not.toThrow();\n    });\n\n    it('accepts null to disable font loading', () => {\n      expect(() => instance.configureFonts(null)).not.toThrow();\n    });\n\n    it('applies an absolute url to an already-loaded MathfieldElement', () => {\n      const MathfieldElement = {};\n\n      // simulate a loaded instance\n      instance.__setMathLiveForTest({ MathfieldElement });\n      instance.configureFonts('/mathlive-fonts');\n\n      expect(MathfieldElement.fontsDirectory).toEqual(`${document.baseURI.replace(/\\/$/, '')}/mathlive-fonts`);\n      expect(MathfieldElement.fontsDirectory.startsWith('http')).toBe(true);\n    });\n\n    it('leaves a fully-qualified url untouched', () => {\n      const MathfieldElement = {};\n\n      instance.__setMathLiveForTest({ MathfieldElement });\n      instance.configureFonts('https://cdn.example.com/fonts');\n\n      expect(MathfieldElement.fontsDirectory).toEqual('https://cdn.example.com/fonts');\n    });\n\n    it('passes null through rather than resolving it', () => {\n      const MathfieldElement = {};\n\n      instance.__setMathLiveForTest({ MathfieldElement });\n      instance.configureFonts(null);\n\n      expect(MathfieldElement.fontsDirectory).toBeNull();\n    });\n  });\n\n  describe('latexToMarkup', () => {\n    it('returns empty string when MathLive is not loaded', () => {\n      expect(instance.latexToMarkup('\\\\pi')).toEqual('');\n    });\n\n    it('returns empty string for empty latex', () => {\n      expect(instance.latexToMarkup('')).toEqual('');\n    });\n  });\n});\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"mathlive-instance.test.js","names":["describe","instance","beforeEach","jest","resetModules","require","__resetEmbeds","it","registerEmbed","htmlString","latex","expect","registeredEmbeds","toEqual","getMacros","answerBlock","newLine","somethingCustom","mathliveLatex","custom","Error","not","toThrow","undefined","macros","parallelogram","toBeDefined","longdiv","napprox","applyStaticMath","toBeUndefined","el","document","createElement","__setMathLiveForTest","convertLatexToMarkup","l","concat","toBe","innerHTML","textContent","toContain","_typeof2","configureFonts","MathfieldElement","fontsDirectory","baseURI","replace","startsWith","toBeNull","latexToMarkup"],"sources":["../../src/__tests__/mathlive-instance.test.js"],"sourcesContent":["describe('mathlive-instance', () => {\n  let instance;\n\n  beforeEach(() => {\n    jest.resetModules();\n    // eslint-disable-next-line global-require\n    instance = require('../mathlive-instance');\n    instance.__resetEmbeds();\n  });\n\n  describe('registerEmbed', () => {\n    it('registers a known embed and exposes it as a macro', () => {\n      instance.registerEmbed('answerBlock', () => ({\n        htmlString: '<div class=\"answerBlock\"></div>',\n        latex: () => '\\\\embed{answerBlock}[]',\n      }));\n\n      expect(instance.registeredEmbeds()).toEqual(['answerBlock']);\n      // The macro tags output with data-embed so CSS can target it, replacing\n      // MathQuill's htmlString hook.\n      expect(instance.getMacros().answerBlock).toEqual('\\\\htmlData{embed=answerBlock}{\\\\placeholder{}}');\n    });\n\n    it('registers newLine as a harmless macro (it is handled by latex-bridge)', () => {\n      instance.registerEmbed('newLine', () => ({ latex: () => '\\\\embed{newLine}[]' }));\n\n      expect(instance.getMacros().newLine).toEqual('\\\\htmlData{embed=newLine}{}');\n    });\n\n    it('falls back to a placeholder for an unknown embed', () => {\n      instance.registerEmbed('somethingCustom', () => ({ htmlString: '<b>x</b>' }));\n\n      expect(instance.getMacros().somethingCustom).toEqual('\\\\htmlData{embed=somethingCustom}{\\\\placeholder{}}');\n    });\n\n    it('honours an explicit mathliveLatex from the factory', () => {\n      instance.registerEmbed('custom', () => ({ mathliveLatex: '\\\\alpha' }));\n\n      expect(instance.getMacros().custom).toEqual('\\\\htmlData{embed=custom}{\\\\alpha}');\n    });\n\n    it('does not throw when the factory throws', () => {\n      expect(() =>\n        instance.registerEmbed('bad', () => {\n          throw new Error('boom');\n        }),\n      ).not.toThrow();\n\n      expect(instance.registeredEmbeds()).toEqual(['bad']);\n    });\n\n    it('ignores bad arguments', () => {\n      instance.registerEmbed(undefined, () => ({}));\n      instance.registerEmbed('noFactory', undefined);\n\n      expect(instance.registeredEmbeds()).toEqual([]);\n    });\n\n    it('always includes the pie macro set', () => {\n      const macros = instance.getMacros();\n\n      expect(macros.parallelogram).toBeDefined();\n      expect(macros.longdiv).toBeDefined();\n      expect(macros.napprox).toEqual('\\\\not\\\\approx');\n    });\n  });\n\n  describe('applyStaticMath', () => {\n    it('returns undefined without an element', () => {\n      expect(instance.applyStaticMath(null, 'x')).toBeUndefined();\n    });\n\n    it('defers (returns undefined) when MathLive has not loaded', () => {\n      const el = document.createElement('div');\n\n      expect(instance.applyStaticMath(el, 'x')).toBeUndefined();\n    });\n\n    it('renders synchronously once MathLive is available', () => {\n      const el = document.createElement('div');\n\n      instance.__setMathLiveForTest({ convertLatexToMarkup: (l) => `<span>${l}</span>` });\n\n      expect(instance.applyStaticMath(el, '\\\\pi')).toBe(el);\n      expect(el.innerHTML).toEqual('<span>\\\\pi</span>');\n    });\n\n    it('falls back to the element textContent when no latex is passed', () => {\n      const el = document.createElement('div');\n\n      el.textContent = '\\\\theta';\n      instance.__setMathLiveForTest({ convertLatexToMarkup: (l) => `<i>${l}</i>` });\n      instance.applyStaticMath(el);\n\n      expect(el.innerHTML).toEqual('<i>\\\\theta</i>');\n    });\n\n    it('bridges stored latex (newLine embed) before rendering', () => {\n      const el = document.createElement('div');\n\n      instance.__setMathLiveForTest({ convertLatexToMarkup: (l) => l });\n      instance.applyStaticMath(el, 'a\\\\embed{newLine}[]b');\n\n      // \\embed{newLine}[] must become a multiline environment\n      expect(el.innerHTML).toContain('displaylines');\n    });\n  });\n\n  describe('configureFonts', () => {\n    // MathLive's default fontsDirectory is the relative './fonts/', which it\n    // resolves against its own (empty, when bundled) script url and throws\n    // \"Invalid base URL\" from loadFonts. Paths must become absolute.\n    it('is exported and callable before MathLive loads', () => {\n      expect(typeof instance.configureFonts).toBe('function');\n      expect(() => instance.configureFonts('/mathlive-fonts')).not.toThrow();\n    });\n\n    it('accepts null to disable font loading', () => {\n      expect(() => instance.configureFonts(null)).not.toThrow();\n    });\n\n    it('applies an absolute url to an already-loaded MathfieldElement', () => {\n      const MathfieldElement = {};\n\n      // simulate a loaded instance\n      instance.__setMathLiveForTest({ MathfieldElement });\n      instance.configureFonts('/mathlive-fonts');\n\n      expect(MathfieldElement.fontsDirectory).toEqual(`${document.baseURI.replace(/\\/$/, '')}/mathlive-fonts`);\n      expect(MathfieldElement.fontsDirectory.startsWith('http')).toBe(true);\n    });\n\n    it('leaves a fully-qualified url untouched', () => {\n      const MathfieldElement = {};\n\n      instance.__setMathLiveForTest({ MathfieldElement });\n      instance.configureFonts('https://cdn.example.com/fonts');\n\n      expect(MathfieldElement.fontsDirectory).toEqual('https://cdn.example.com/fonts');\n    });\n\n    it('passes null through rather than resolving it', () => {\n      const MathfieldElement = {};\n\n      instance.__setMathLiveForTest({ MathfieldElement });\n      instance.configureFonts(null);\n\n      expect(MathfieldElement.fontsDirectory).toBeNull();\n    });\n  });\n\n  describe('latexToMarkup', () => {\n    it('returns empty string when MathLive is not loaded', () => {\n      expect(instance.latexToMarkup('\\\\pi')).toEqual('');\n    });\n\n    it('returns empty string for empty latex', () => {\n      expect(instance.latexToMarkup('')).toEqual('');\n    });\n  });\n});\n"],"mappings":"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","ignoreList":[]}

package/lib/mathlive-instance.js

@@ -271,22 +271,36 @@ var __setMathLiveForTest = exports.__setMathLiveForTest = function __setMathLive
  * Render static math into an element. API-compatible with
  * @pie-lib/math-input's `applyStaticMath`.
  *
+ * Callers written against MathQuill invoke this synchronously from lifecycle
+ * methods, where MathLive (a dynamic import) may not have loaded yet. Rather
+ * than silently rendering nothing, this kicks off the load and re-applies once
+ * the engine is ready, so the element fills in on the next tick.
+ *
  * @param {HTMLElement} element
  * @param {string} [latex] assigned to the element before rendering
  * @param {object} [options] `{ macros }` overrides
- * @returns {HTMLElement|undefined} the element, for parity with the old return
+ * @returns {HTMLElement|undefined} the element, or undefined if deferred
  */
 function applyStaticMath(element, latex) {
   var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
   if (!element || typeof window === 'undefined') {
     return undefined;
   }
+
+  // Capture the source now: if we defer, the element's textContent may have
+  // been overwritten by the time MathLive is ready.
+  var source = latex === undefined || latex === null ? element.textContent : latex;
   var ml = getMathLive();
   if (!ml) {
-    log('applyStaticMath called before MathLive loaded - call loadMathLive() first');
+    log('applyStaticMath called before MathLive loaded - deferring until it is ready');
+    loadMathLive().then(function (loaded) {
+      // The element may have been unmounted while loading.
+      if (loaded && element.isConnected !== false) {
+        applyStaticMath(element, source, options);
+      }
+    });
     return undefined;
   }
-  var source = latex === undefined || latex === null ? element.textContent : latex;
   element.innerHTML = ml.convertLatexToMarkup((0, _latexBridge.toMathLive)(source), {
     macros: _objectSpread(_objectSpread({}, getMacros()), options.macros || {})
   });

package/lib/mathlive-instance.js.map

@@ -1 +1 @@
-{"version":3,"file":"mathlive-instance.js","names":["_debug","_interopRequireDefault","require","_latexBridge","ownKeys","e","r","t","Object","keys","getOwnPropertySymbols","o","filter","getOwnPropertyDescriptor","enumerable","push","apply","_objectSpread","arguments","length","forEach","_defineProperty2","getOwnPropertyDescriptors","defineProperties","defineProperty","_interopRequireWildcard","WeakMap","n","__esModule","i","f","__proto__","_typeof","has","get","set","_t2","hasOwnProperty","call","log","debug","mathlive","fontsDirectory","absoluteFontsDirectory","dir","test","URL","document","baseURI","href","message","configureFonts","exports","MathfieldElement","PIE_MACROS","parallelogram","overarc","napprox","nsim","ncong","nparallel","perpendicular","divide","degree","square","longdiv","abs","embeds","Map","KNOWN_EMBED_LATEX","newLine","answerBlock","loadMathLive","_ref","_asyncToGenerator2","_regenerator","mark","_callee","_t","wrap","_context","prev","next","window","abrupt","undefined","Promise","resolve","then","sent","stop","getMathLive","getMacros","out","_ref2","name","latex","concat","registerEmbed","factory","definition","prototype","mathliveLatex","registeredEmbeds","Array","from","__resetEmbeds","clear","__setMathLiveForTest","stub","applyStaticMath","element","options","ml","source","textContent","innerHTML","convertLatexToMarkup","toMathLive","macros","latexToMarkup"],"sources":["../src/mathlive-instance.js"],"sourcesContent":["import debug from 'debug';\nimport { NEWLINE_EMBED, toMathLive } from './latex-bridge';\n\nconst log = debug('pie-lib:math-input-mathlive:instance');\n\n/**\n * MathLive bootstrap + compatibility shims for @pie-lib/math-input's public API.\n *\n * MathLive is loaded lazily and only in the browser: the editor bundle is\n * ~227KB gzip and registers custom elements, so it must never run during SSR.\n */\n\nlet mathlive;\n\n/**\n * Where the KaTeX woff2 fonts are served from, as configured by the host app.\n * `undefined` means \"not configured\"; `null` means \"explicitly disabled\".\n */\nlet fontsDirectory;\n\n/**\n * Turn a fonts path into a fully-qualified URL.\n *\n * MathLive's default `fontsDirectory` is the relative `'./fonts/'`, which it\n * resolves against its own script URL. Under a bundler (webpack/Next) that\n * script URL is empty, so `new URL('./fonts/', '')` throws\n * \"Failed to construct 'URL': Invalid base URL\" from `loadFonts`.\n * Resolving against `document.baseURI` avoids that entirely and honours any\n * <base href> / asset prefix the host app uses.\n */\nconst absoluteFontsDirectory = (dir) => {\n  if (!dir) {\n    return dir;\n  }\n\n  // Already absolute (http://, https://, //cdn...) - MathLive handles these.\n  if (/^(?:[a-z+]+:)?\\/\\//i.test(dir)) {\n    return dir;\n  }\n\n  try {\n    return new URL(dir, document.baseURI).href;\n  } catch (e) {\n    log('could not resolve fontsDirectory \"%s\": %s', dir, e && e.message);\n    return null;\n  }\n};\n\n/**\n * Tell the package where the MathLive fonts are served from.\n *\n * Call before `loadMathLive()`. Accepts an absolute URL, a root-relative path\n * (`/mathlive-fonts`) or a relative one; pass `null` to skip font loading and\n * fall back to system fonts.\n *\n * The fonts ship inside the `mathlive` package (`node_modules/mathlive/fonts`)\n * and must be copied into whatever the host app serves statically.\n *\n * @param {string|null} dir\n */\nexport const configureFonts = (dir) => {\n  fontsDirectory = dir;\n\n  if (mathlive) {\n    mathlive.MathfieldElement.fontsDirectory = absoluteFontsDirectory(dir);\n  }\n};\n\n/**\n * Custom macros for the pie-specific commands that the MathQuill fork\n * understood but stock LaTeX does not.\n *\n * Kept deliberately in sync with the MathJax macros in\n * @pie-lib/math-rendering (`render-math.js`) so the same latex renders the same\n * way in the editor and in the static renderer.\n */\nexport const PIE_MACROS = {\n  parallelogram: '\\\\htmlData{pie-macro=parallelogram}{\\\\unicode{\"25B1}}',\n  overarc: '\\\\overparen{#1}',\n  napprox: '\\\\not\\\\approx',\n  nsim: '\\\\not\\\\sim',\n  ncong: '\\\\not\\\\cong',\n  nparallel: '\\\\not\\\\parallel',\n  perpendicular: '\\\\perp',\n  divide: '\\\\div',\n  degree: '^{\\\\circ}',\n  square: '\\\\unicode{\"25A1}',\n  longdiv: '\\\\htmlData{pie-macro=longdiv}{#1}',\n  abs: '\\\\left|#1\\\\right|',\n};\n\n/**\n * Registry for `registerEmbed`.\n *\n * MathLive has no embed plugin system, so an embed is expressed as a macro that\n * expands to real LaTeX. `\\htmlData{embed=<name>}` tags the rendered output so\n * consumers can target it with CSS exactly as they targeted the old\n * `htmlString` markup.\n *\n * Known embeds map to native constructs:\n *  - `newLine`    -> structural, handled by latex-bridge (`\\displaylines` + `\\\\`)\n *  - `answerBlock`-> `\\placeholder{}` (interactive, read via the prompts API)\n *\n * @type {Map<string, {factory: Function, latex: string}>}\n */\nconst embeds = new Map();\n\nconst KNOWN_EMBED_LATEX = {\n  // newLine is structural: it is translated by latex-bridge before it ever\n  // reaches MathLive, so the macro only needs to be harmless.\n  newLine: '',\n  answerBlock: '\\\\placeholder{}',\n};\n\n/**\n * Load MathLive. Resolves to undefined during SSR.\n * @returns {Promise<object|undefined>}\n */\nexport const loadMathLive = async () => {\n  if (typeof window === 'undefined') {\n    return undefined;\n  }\n\n  if (!mathlive) {\n    try {\n      mathlive = await import('mathlive');\n    } catch (e) {\n      // MathLive is browser-only and ships an ESM-conditional exports map, so\n      // the import can fail in test/SSR-ish runtimes. Fail soft: callers all\n      // handle a missing instance (static rendering falls back to raw latex).\n      log('MathLive could not be loaded: %s', e && e.message);\n      return undefined;\n    }\n\n    // Always replace MathLive's relative `'./fonts/'` default: it throws\n    // \"Invalid base URL\" when bundled. Either point at the host app's copy or\n    // disable font loading, both of which are safe.\n    if (fontsDirectory === undefined) {\n      log(\n        'no fontsDirectory configured - MathLive will use fallback fonts. ' +\n          'Call configureFonts(\"/path/to/fonts\") with a copy of node_modules/mathlive/fonts to enable them.',\n      );\n    }\n\n    mathlive.MathfieldElement.fontsDirectory =\n      fontsDirectory === undefined ? null : absoluteFontsDirectory(fontsDirectory);\n  }\n\n  return mathlive;\n};\n\n/**\n * Synchronous accessor for an already-loaded MathLive.\n * @returns {object|undefined}\n */\nexport const getMathLive = () => mathlive;\n\n/**\n * The macro dictionary to hand to a mathfield: pie macros plus anything\n * registered through `registerEmbed`.\n *\n * @returns {object}\n */\nexport const getMacros = () => {\n  const out = { ...PIE_MACROS };\n\n  embeds.forEach(({ latex }, name) => {\n    out[name] = `\\\\htmlData{embed=${name}}{${latex}}`;\n  });\n\n  return out;\n};\n\n/**\n * Register an embed. API-compatible with @pie-lib/math-input's `registerEmbed`\n * so existing callers do not change.\n *\n * MathQuill's factory returns `{ htmlString, text, latex }`. Only the\n * declarative parts survive: `latex` round-trips through a macro and the\n * styling hook becomes a `data-embed` attribute. Arbitrary DOM injection via\n * `htmlString` has no MathLive equivalent and is ignored.\n *\n * @param {string} name\n * @param {Function} factory\n */\nexport function registerEmbed(name, factory) {\n  if (!name || typeof factory !== 'function') {\n    return;\n  }\n\n  let definition = {};\n\n  try {\n    definition = factory() || {};\n  } catch (e) {\n    log('embed factory threw for \"%s\": %s', name, e.message);\n  }\n\n  const latex = Object.prototype.hasOwnProperty.call(KNOWN_EMBED_LATEX, name)\n    ? KNOWN_EMBED_LATEX[name]\n    : definition.mathliveLatex || '\\\\placeholder{}';\n\n  if (!Object.prototype.hasOwnProperty.call(KNOWN_EMBED_LATEX, name) && !definition.mathliveLatex) {\n    // Unknown third-party embed: degrade instead of throwing. `htmlString`\n    // cannot be reproduced, so it renders as an editable slot.\n    log(\n      'embed \"%s\" is not natively supported by MathLive; rendering as a placeholder. ' +\n        'Provide `mathliveLatex` in the factory result to control this.',\n      name,\n    );\n  }\n\n  embeds.set(name, { factory, latex });\n}\n\n/**\n * Embeds registered so far. Exposed for tests/diagnostics.\n * @returns {string[]}\n */\nexport const registeredEmbeds = () => Array.from(embeds.keys());\n\n/** Reset the embed registry. Test helper. */\nexport const __resetEmbeds = () => embeds.clear();\n\n/** Inject a stub MathLive instance. Test helper. */\nexport const __setMathLiveForTest = (stub) => {\n  mathlive = stub;\n};\n\n/**\n * Render static math into an element. API-compatible with\n * @pie-lib/math-input's `applyStaticMath`.\n *\n * @param {HTMLElement} element\n * @param {string} [latex] assigned to the element before rendering\n * @param {object} [options] `{ macros }` overrides\n * @returns {HTMLElement|undefined} the element, for parity with the old return\n */\nexport function applyStaticMath(element, latex, options = {}) {\n  if (!element || typeof window === 'undefined') {\n    return undefined;\n  }\n\n  const ml = getMathLive();\n\n  if (!ml) {\n    log('applyStaticMath called before MathLive loaded - call loadMathLive() first');\n    return undefined;\n  }\n\n  const source = latex === undefined || latex === null ? element.textContent : latex;\n\n  element.innerHTML = ml.convertLatexToMarkup(toMathLive(source), {\n    macros: { ...getMacros(), ...(options.macros || {}) },\n  });\n\n  return element;\n}\n\n/**\n * Convert latex to markup using the pie macro set. Used for keypad labels and\n * any read-only rendering that does not need a live mathfield.\n *\n * @param {string} latex\n * @param {object} [options]\n * @returns {string} HTML markup, or '' if MathLive is not loaded\n */\nexport function latexToMarkup(latex, options = {}) {\n  const ml = getMathLive();\n\n  if (!ml || !latex) {\n    return '';\n  }\n\n  try {\n    return ml.convertLatexToMarkup(toMathLive(latex), {\n      macros: { ...getMacros(), ...(options.macros || {}) },\n      ...options,\n    });\n  } catch (e) {\n    log('convertLatexToMarkup failed for \"%s\": %s', latex, e.message);\n    return '';\n  }\n}\n\nexport { NEWLINE_EMBED };\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"mathlive-instance.js","names":["_debug","_interopRequireDefault","require","_latexBridge","ownKeys","e","r","t","Object","keys","getOwnPropertySymbols","o","filter","getOwnPropertyDescriptor","enumerable","push","apply","_objectSpread","arguments","length","forEach","_defineProperty2","getOwnPropertyDescriptors","defineProperties","defineProperty","_interopRequireWildcard","WeakMap","n","__esModule","i","f","__proto__","_typeof","has","get","set","_t2","hasOwnProperty","call","log","debug","mathlive","fontsDirectory","absoluteFontsDirectory","dir","test","URL","document","baseURI","href","message","configureFonts","exports","MathfieldElement","PIE_MACROS","parallelogram","overarc","napprox","nsim","ncong","nparallel","perpendicular","divide","degree","square","longdiv","abs","embeds","Map","KNOWN_EMBED_LATEX","newLine","answerBlock","loadMathLive","_ref","_asyncToGenerator2","_regenerator","mark","_callee","_t","wrap","_context","prev","next","window","abrupt","undefined","Promise","resolve","then","sent","stop","getMathLive","getMacros","out","_ref2","name","latex","concat","registerEmbed","factory","definition","prototype","mathliveLatex","registeredEmbeds","Array","from","__resetEmbeds","clear","__setMathLiveForTest","stub","applyStaticMath","element","options","source","textContent","ml","loaded","isConnected","innerHTML","convertLatexToMarkup","toMathLive","macros","latexToMarkup"],"sources":["../src/mathlive-instance.js"],"sourcesContent":["import debug from 'debug';\nimport { NEWLINE_EMBED, toMathLive } from './latex-bridge';\n\nconst log = debug('pie-lib:math-input-mathlive:instance');\n\n/**\n * MathLive bootstrap + compatibility shims for @pie-lib/math-input's public API.\n *\n * MathLive is loaded lazily and only in the browser: the editor bundle is\n * ~227KB gzip and registers custom elements, so it must never run during SSR.\n */\n\nlet mathlive;\n\n/**\n * Where the KaTeX woff2 fonts are served from, as configured by the host app.\n * `undefined` means \"not configured\"; `null` means \"explicitly disabled\".\n */\nlet fontsDirectory;\n\n/**\n * Turn a fonts path into a fully-qualified URL.\n *\n * MathLive's default `fontsDirectory` is the relative `'./fonts/'`, which it\n * resolves against its own script URL. Under a bundler (webpack/Next) that\n * script URL is empty, so `new URL('./fonts/', '')` throws\n * \"Failed to construct 'URL': Invalid base URL\" from `loadFonts`.\n * Resolving against `document.baseURI` avoids that entirely and honours any\n * <base href> / asset prefix the host app uses.\n */\nconst absoluteFontsDirectory = (dir) => {\n  if (!dir) {\n    return dir;\n  }\n\n  // Already absolute (http://, https://, //cdn...) - MathLive handles these.\n  if (/^(?:[a-z+]+:)?\\/\\//i.test(dir)) {\n    return dir;\n  }\n\n  try {\n    return new URL(dir, document.baseURI).href;\n  } catch (e) {\n    log('could not resolve fontsDirectory \"%s\": %s', dir, e && e.message);\n    return null;\n  }\n};\n\n/**\n * Tell the package where the MathLive fonts are served from.\n *\n * Call before `loadMathLive()`. Accepts an absolute URL, a root-relative path\n * (`/mathlive-fonts`) or a relative one; pass `null` to skip font loading and\n * fall back to system fonts.\n *\n * The fonts ship inside the `mathlive` package (`node_modules/mathlive/fonts`)\n * and must be copied into whatever the host app serves statically.\n *\n * @param {string|null} dir\n */\nexport const configureFonts = (dir) => {\n  fontsDirectory = dir;\n\n  if (mathlive) {\n    mathlive.MathfieldElement.fontsDirectory = absoluteFontsDirectory(dir);\n  }\n};\n\n/**\n * Custom macros for the pie-specific commands that the MathQuill fork\n * understood but stock LaTeX does not.\n *\n * Kept deliberately in sync with the MathJax macros in\n * @pie-lib/math-rendering (`render-math.js`) so the same latex renders the same\n * way in the editor and in the static renderer.\n */\nexport const PIE_MACROS = {\n  parallelogram: '\\\\htmlData{pie-macro=parallelogram}{\\\\unicode{\"25B1}}',\n  overarc: '\\\\overparen{#1}',\n  napprox: '\\\\not\\\\approx',\n  nsim: '\\\\not\\\\sim',\n  ncong: '\\\\not\\\\cong',\n  nparallel: '\\\\not\\\\parallel',\n  perpendicular: '\\\\perp',\n  divide: '\\\\div',\n  degree: '^{\\\\circ}',\n  square: '\\\\unicode{\"25A1}',\n  longdiv: '\\\\htmlData{pie-macro=longdiv}{#1}',\n  abs: '\\\\left|#1\\\\right|',\n};\n\n/**\n * Registry for `registerEmbed`.\n *\n * MathLive has no embed plugin system, so an embed is expressed as a macro that\n * expands to real LaTeX. `\\htmlData{embed=<name>}` tags the rendered output so\n * consumers can target it with CSS exactly as they targeted the old\n * `htmlString` markup.\n *\n * Known embeds map to native constructs:\n *  - `newLine`    -> structural, handled by latex-bridge (`\\displaylines` + `\\\\`)\n *  - `answerBlock`-> `\\placeholder{}` (interactive, read via the prompts API)\n *\n * @type {Map<string, {factory: Function, latex: string}>}\n */\nconst embeds = new Map();\n\nconst KNOWN_EMBED_LATEX = {\n  // newLine is structural: it is translated by latex-bridge before it ever\n  // reaches MathLive, so the macro only needs to be harmless.\n  newLine: '',\n  answerBlock: '\\\\placeholder{}',\n};\n\n/**\n * Load MathLive. Resolves to undefined during SSR.\n * @returns {Promise<object|undefined>}\n */\nexport const loadMathLive = async () => {\n  if (typeof window === 'undefined') {\n    return undefined;\n  }\n\n  if (!mathlive) {\n    try {\n      mathlive = await import('mathlive');\n    } catch (e) {\n      // MathLive is browser-only and ships an ESM-conditional exports map, so\n      // the import can fail in test/SSR-ish runtimes. Fail soft: callers all\n      // handle a missing instance (static rendering falls back to raw latex).\n      log('MathLive could not be loaded: %s', e && e.message);\n      return undefined;\n    }\n\n    // Always replace MathLive's relative `'./fonts/'` default: it throws\n    // \"Invalid base URL\" when bundled. Either point at the host app's copy or\n    // disable font loading, both of which are safe.\n    if (fontsDirectory === undefined) {\n      log(\n        'no fontsDirectory configured - MathLive will use fallback fonts. ' +\n          'Call configureFonts(\"/path/to/fonts\") with a copy of node_modules/mathlive/fonts to enable them.',\n      );\n    }\n\n    mathlive.MathfieldElement.fontsDirectory =\n      fontsDirectory === undefined ? null : absoluteFontsDirectory(fontsDirectory);\n  }\n\n  return mathlive;\n};\n\n/**\n * Synchronous accessor for an already-loaded MathLive.\n * @returns {object|undefined}\n */\nexport const getMathLive = () => mathlive;\n\n/**\n * The macro dictionary to hand to a mathfield: pie macros plus anything\n * registered through `registerEmbed`.\n *\n * @returns {object}\n */\nexport const getMacros = () => {\n  const out = { ...PIE_MACROS };\n\n  embeds.forEach(({ latex }, name) => {\n    out[name] = `\\\\htmlData{embed=${name}}{${latex}}`;\n  });\n\n  return out;\n};\n\n/**\n * Register an embed. API-compatible with @pie-lib/math-input's `registerEmbed`\n * so existing callers do not change.\n *\n * MathQuill's factory returns `{ htmlString, text, latex }`. Only the\n * declarative parts survive: `latex` round-trips through a macro and the\n * styling hook becomes a `data-embed` attribute. Arbitrary DOM injection via\n * `htmlString` has no MathLive equivalent and is ignored.\n *\n * @param {string} name\n * @param {Function} factory\n */\nexport function registerEmbed(name, factory) {\n  if (!name || typeof factory !== 'function') {\n    return;\n  }\n\n  let definition = {};\n\n  try {\n    definition = factory() || {};\n  } catch (e) {\n    log('embed factory threw for \"%s\": %s', name, e.message);\n  }\n\n  const latex = Object.prototype.hasOwnProperty.call(KNOWN_EMBED_LATEX, name)\n    ? KNOWN_EMBED_LATEX[name]\n    : definition.mathliveLatex || '\\\\placeholder{}';\n\n  if (!Object.prototype.hasOwnProperty.call(KNOWN_EMBED_LATEX, name) && !definition.mathliveLatex) {\n    // Unknown third-party embed: degrade instead of throwing. `htmlString`\n    // cannot be reproduced, so it renders as an editable slot.\n    log(\n      'embed \"%s\" is not natively supported by MathLive; rendering as a placeholder. ' +\n        'Provide `mathliveLatex` in the factory result to control this.',\n      name,\n    );\n  }\n\n  embeds.set(name, { factory, latex });\n}\n\n/**\n * Embeds registered so far. Exposed for tests/diagnostics.\n * @returns {string[]}\n */\nexport const registeredEmbeds = () => Array.from(embeds.keys());\n\n/** Reset the embed registry. Test helper. */\nexport const __resetEmbeds = () => embeds.clear();\n\n/** Inject a stub MathLive instance. Test helper. */\nexport const __setMathLiveForTest = (stub) => {\n  mathlive = stub;\n};\n\n/**\n * Render static math into an element. API-compatible with\n * @pie-lib/math-input's `applyStaticMath`.\n *\n * Callers written against MathQuill invoke this synchronously from lifecycle\n * methods, where MathLive (a dynamic import) may not have loaded yet. Rather\n * than silently rendering nothing, this kicks off the load and re-applies once\n * the engine is ready, so the element fills in on the next tick.\n *\n * @param {HTMLElement} element\n * @param {string} [latex] assigned to the element before rendering\n * @param {object} [options] `{ macros }` overrides\n * @returns {HTMLElement|undefined} the element, or undefined if deferred\n */\nexport function applyStaticMath(element, latex, options = {}) {\n  if (!element || typeof window === 'undefined') {\n    return undefined;\n  }\n\n  // Capture the source now: if we defer, the element's textContent may have\n  // been overwritten by the time MathLive is ready.\n  const source = latex === undefined || latex === null ? element.textContent : latex;\n  const ml = getMathLive();\n\n  if (!ml) {\n    log('applyStaticMath called before MathLive loaded - deferring until it is ready');\n\n    loadMathLive().then((loaded) => {\n      // The element may have been unmounted while loading.\n      if (loaded && element.isConnected !== false) {\n        applyStaticMath(element, source, options);\n      }\n    });\n\n    return undefined;\n  }\n\n  element.innerHTML = ml.convertLatexToMarkup(toMathLive(source), {\n    macros: { ...getMacros(), ...(options.macros || {}) },\n  });\n\n  return element;\n}\n\n/**\n * Convert latex to markup using the pie macro set. Used for keypad labels and\n * any read-only rendering that does not need a live mathfield.\n *\n * @param {string} latex\n * @param {object} [options]\n * @returns {string} HTML markup, or '' if MathLive is not loaded\n */\nexport function latexToMarkup(latex, options = {}) {\n  const ml = getMathLive();\n\n  if (!ml || !latex) {\n    return '';\n  }\n\n  try {\n    return ml.convertLatexToMarkup(toMathLive(latex), {\n      macros: { ...getMacros(), ...(options.macros || {}) },\n      ...options,\n    });\n  } catch (e) {\n    log('convertLatexToMarkup failed for \"%s\": %s', latex, e.message);\n    return '';\n  }\n}\n\nexport { NEWLINE_EMBED };\n"],"mappings":"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","ignoreList":[]}

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "MathLive-based math input (drop-in alternative to @pie-lib/math-input)",
   "main": "lib/index.js",
   "module": "src/index.jsx",

package/src/__tests__/mathlive-instance.test.js

@@ -70,11 +70,40 @@ describe('mathlive-instance', () => {
       expect(instance.applyStaticMath(null, 'x')).toBeUndefined();
     });
 
-    it('returns undefined when MathLive has not loaded', () => {
+    it('defers (returns undefined) when MathLive has not loaded', () => {
       const el = document.createElement('div');
 
       expect(instance.applyStaticMath(el, 'x')).toBeUndefined();
     });
+
+    it('renders synchronously once MathLive is available', () => {
+      const el = document.createElement('div');
+
+      instance.__setMathLiveForTest({ convertLatexToMarkup: (l) => `<span>${l}</span>` });
+
+      expect(instance.applyStaticMath(el, '\\pi')).toBe(el);
+      expect(el.innerHTML).toEqual('<span>\\pi</span>');
+    });
+
+    it('falls back to the element textContent when no latex is passed', () => {
+      const el = document.createElement('div');
+
+      el.textContent = '\\theta';
+      instance.__setMathLiveForTest({ convertLatexToMarkup: (l) => `<i>${l}</i>` });
+      instance.applyStaticMath(el);
+
+      expect(el.innerHTML).toEqual('<i>\\theta</i>');
+    });
+
+    it('bridges stored latex (newLine embed) before rendering', () => {
+      const el = document.createElement('div');
+
+      instance.__setMathLiveForTest({ convertLatexToMarkup: (l) => l });
+      instance.applyStaticMath(el, 'a\\embed{newLine}[]b');
+
+      // \embed{newLine}[] must become a multiline environment
+      expect(el.innerHTML).toContain('displaylines');
+    });
   });
 
   describe('configureFonts', () => {

package/src/mathlive-instance.js

@@ -231,25 +231,39 @@ export const __setMathLiveForTest = (stub) => {
  * Render static math into an element. API-compatible with
  * @pie-lib/math-input's `applyStaticMath`.
  *
+ * Callers written against MathQuill invoke this synchronously from lifecycle
+ * methods, where MathLive (a dynamic import) may not have loaded yet. Rather
+ * than silently rendering nothing, this kicks off the load and re-applies once
+ * the engine is ready, so the element fills in on the next tick.
+ *
  * @param {HTMLElement} element
  * @param {string} [latex] assigned to the element before rendering
  * @param {object} [options] `{ macros }` overrides
- * @returns {HTMLElement|undefined} the element, for parity with the old return
+ * @returns {HTMLElement|undefined} the element, or undefined if deferred
  */
 export function applyStaticMath(element, latex, options = {}) {
   if (!element || typeof window === 'undefined') {
     return undefined;
   }
 
+  // Capture the source now: if we defer, the element's textContent may have
+  // been overwritten by the time MathLive is ready.
+  const source = latex === undefined || latex === null ? element.textContent : latex;
   const ml = getMathLive();
 
   if (!ml) {
-    log('applyStaticMath called before MathLive loaded - call loadMathLive() first');
+    log('applyStaticMath called before MathLive loaded - deferring until it is ready');
+
+    loadMathLive().then((loaded) => {
+      // The element may have been unmounted while loading.
+      if (loaded && element.isConnected !== false) {
+        applyStaticMath(element, source, options);
+      }
+    });
+
     return undefined;
   }
 
-  const source = latex === undefined || latex === null ? element.textContent : latex;
-
   element.innerHTML = ml.convertLatexToMarkup(toMathLive(source), {
     macros: { ...getMacros(), ...(options.macros || {}) },
   });