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

package/lib/__tests__/input-imperative.test.js

@@ -0,0 +1,155 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _latexBridge = require("../latex-bridge");
+var _input = _interopRequireDefault(require("../mf/input"));
+/**
+ * The imperative surface that @pie-lib/math-toolbar drives
+ * (editor-and-pad.jsx: clear/command/keystroke/write/latex).
+ *
+ * These call the methods against a stub mathfield, because a real
+ * <math-field> needs a browser. What matters here is the *translation*:
+ * MathQuill-era arguments must become valid MathLive operations.
+ */
+var stubField = function stubField() {
+  var calls = {
+    insert: [],
+    executeCommand: [],
+    focus: 0
+  };
+  return {
+    calls: calls,
+    value: '',
+    getValue: function getValue() {
+      return '';
+    },
+    insert: function insert(v) {
+      calls.insert.push(v);
+    },
+    executeCommand: function executeCommand(v) {
+      calls.executeCommand.push(v);
+    },
+    focus: function focus() {
+      calls.focus++;
+    },
+    blur: function blur() {}
+  };
+};
+var withField = function withField() {
+  var input = new _input["default"]({});
+  var f = stubField();
+  input.mathField = f;
+  return {
+    input: input,
+    f: f
+  };
+};
+describe('Input imperative API (drives math-toolbar)', function () {
+  describe('keystroke', function () {
+    it('maps MathQuill keystroke names to MathLive selectors', function () {
+      var _withField = withField(),
+        input = _withField.input,
+        f = _withField.f;
+      input.keystroke('Left');
+      input.keystroke('Right');
+      input.keystroke('Backspace');
+      expect(f.calls.executeCommand).toEqual(['moveToPreviousChar', 'moveToNextChar', 'deleteBackward']);
+    });
+    it('passes an unknown value through as a selector', function () {
+      var _withField2 = withField(),
+        input = _withField2.input,
+        f = _withField2.f;
+      input.keystroke('deleteForward');
+      expect(f.calls.executeCommand).toEqual(['deleteForward']);
+    });
+    it('does not throw when the engine rejects the selector', function () {
+      var _withField3 = withField(),
+        input = _withField3.input;
+      input.mathField.executeCommand = function () {
+        throw new Error('unknown command');
+      };
+      expect(function () {
+        return input.keystroke('Nonsense');
+      }).not.toThrow();
+    });
+    it('covers every keystroke the keypad emits', function () {
+      // navigation.js / edit.js only produce these three
+      ['Left', 'Right', 'Backspace'].forEach(function (k) {
+        return expect(_latexBridge.KEYSTROKES[k]).toBeDefined();
+      });
+    });
+  });
+  describe('command', function () {
+    it('expands argument-taking commands into placeholders', function () {
+      var _withField4 = withField(),
+        input = _withField4.input,
+        f = _withField4.f;
+      input.command('\\frac');
+
+      // a bare \frac would give no editable slots
+      expect(f.calls.insert).toEqual(['\\frac{#?}{#?}']);
+    });
+    it('handles array commands', function () {
+      var _withField5 = withField(),
+        input = _withField5.input,
+        f = _withField5.f;
+      input.command(['\\log', '_']);
+      expect(f.calls.insert).toEqual(['\\log_{#?}']);
+    });
+    it('passes argument-less commands through', function () {
+      var _withField6 = withField(),
+        input = _withField6.input,
+        f = _withField6.f;
+      input.command('\\pi');
+      expect(f.calls.insert).toEqual(['\\pi']);
+    });
+    it('agrees with keyToAction', function () {
+      expect((0, _latexBridge.keyToAction)({
+        command: '\\sqrt'
+      }).value).toEqual('\\sqrt{#?}');
+    });
+  });
+  describe('safety before MathLive loads', function () {
+    it('every method is a no-op rather than a crash', function () {
+      var input = new _input["default"]({});
+
+      // mathField is undefined until loadMathLive() resolves
+      expect(input.latex()).toEqual('');
+      expect(input.clear()).toEqual('');
+      expect(input.command('\\frac')).toEqual('');
+      expect(input.keystroke('Left')).toEqual('');
+      expect(input.write('x')).toEqual('');
+      expect(function () {
+        return input.focus();
+      }).not.toThrow();
+      expect(function () {
+        return input.blur();
+      }).not.toThrow();
+      expect(function () {
+        return input.setLatex('x');
+      }).not.toThrow();
+      expect(input.element).toBeUndefined();
+    });
+  });
+  describe('mqCompat facade', function () {
+    // math-toolbar used to call this.input.mathField.latex(); external
+    // consumers may still do the same.
+    it('exposes latex() as a getter', function () {
+      var _withField7 = withField(),
+        input = _withField7.input;
+      input.mathField.getValue = function () {
+        return '\\frac{1}{2}';
+      };
+      expect(input.mqCompat.latex()).toEqual('\\frac{1}{2}');
+    });
+    it('exposes latex(v) as a setter and el()', function () {
+      var _withField8 = withField(),
+        input = _withField8.input,
+        f = _withField8.f;
+      input.mqCompat.latex('x+1');
+      expect(f.value).toEqual('x+1');
+      expect(input.mqCompat.el()).toBe(f);
+    });
+  });
+});
+//# sourceMappingURL=input-imperative.test.js.map

package/lib/__tests__/input-imperative.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-imperative.test.js","names":["_latexBridge","require","_input","_interopRequireDefault","stubField","calls","insert","executeCommand","focus","value","getValue","v","push","blur","withField","input","Input","f","mathField","describe","it","_withField","keystroke","expect","toEqual","_withField2","_withField3","Error","not","toThrow","forEach","k","KEYSTROKES","toBeDefined","_withField4","command","_withField5","_withField6","keyToAction","latex","clear","write","setLatex","element","toBeUndefined","_withField7","mqCompat","_withField8","el","toBe"],"sources":["../../src/__tests__/input-imperative.test.jsx"],"sourcesContent":["import { KEYSTROKES, keyToAction } from '../latex-bridge';\nimport Input from '../mf/input';\n\n/**\n * The imperative surface that @pie-lib/math-toolbar drives\n * (editor-and-pad.jsx: clear/command/keystroke/write/latex).\n *\n * These call the methods against a stub mathfield, because a real\n * <math-field> needs a browser. What matters here is the *translation*:\n * MathQuill-era arguments must become valid MathLive operations.\n */\nconst stubField = () => {\n  const calls = { insert: [], executeCommand: [], focus: 0 };\n\n  return {\n    calls,\n    value: '',\n    getValue: () => '',\n    insert(v) {\n      calls.insert.push(v);\n    },\n    executeCommand(v) {\n      calls.executeCommand.push(v);\n    },\n    focus() {\n      calls.focus++;\n    },\n    blur() {},\n  };\n};\n\nconst withField = () => {\n  const input = new Input({});\n  const f = stubField();\n\n  input.mathField = f;\n\n  return { input, f };\n};\n\ndescribe('Input imperative API (drives math-toolbar)', () => {\n  describe('keystroke', () => {\n    it('maps MathQuill keystroke names to MathLive selectors', () => {\n      const { input, f } = withField();\n\n      input.keystroke('Left');\n      input.keystroke('Right');\n      input.keystroke('Backspace');\n\n      expect(f.calls.executeCommand).toEqual(['moveToPreviousChar', 'moveToNextChar', 'deleteBackward']);\n    });\n\n    it('passes an unknown value through as a selector', () => {\n      const { input, f } = withField();\n\n      input.keystroke('deleteForward');\n\n      expect(f.calls.executeCommand).toEqual(['deleteForward']);\n    });\n\n    it('does not throw when the engine rejects the selector', () => {\n      const { input } = withField();\n\n      input.mathField.executeCommand = () => {\n        throw new Error('unknown command');\n      };\n\n      expect(() => input.keystroke('Nonsense')).not.toThrow();\n    });\n\n    it('covers every keystroke the keypad emits', () => {\n      // navigation.js / edit.js only produce these three\n      ['Left', 'Right', 'Backspace'].forEach((k) => expect(KEYSTROKES[k]).toBeDefined());\n    });\n  });\n\n  describe('command', () => {\n    it('expands argument-taking commands into placeholders', () => {\n      const { input, f } = withField();\n\n      input.command('\\\\frac');\n\n      // a bare \\frac would give no editable slots\n      expect(f.calls.insert).toEqual(['\\\\frac{#?}{#?}']);\n    });\n\n    it('handles array commands', () => {\n      const { input, f } = withField();\n\n      input.command(['\\\\log', '_']);\n\n      expect(f.calls.insert).toEqual(['\\\\log_{#?}']);\n    });\n\n    it('passes argument-less commands through', () => {\n      const { input, f } = withField();\n\n      input.command('\\\\pi');\n\n      expect(f.calls.insert).toEqual(['\\\\pi']);\n    });\n\n    it('agrees with keyToAction', () => {\n      expect(keyToAction({ command: '\\\\sqrt' }).value).toEqual('\\\\sqrt{#?}');\n    });\n  });\n\n  describe('safety before MathLive loads', () => {\n    it('every method is a no-op rather than a crash', () => {\n      const input = new Input({});\n\n      // mathField is undefined until loadMathLive() resolves\n      expect(input.latex()).toEqual('');\n      expect(input.clear()).toEqual('');\n      expect(input.command('\\\\frac')).toEqual('');\n      expect(input.keystroke('Left')).toEqual('');\n      expect(input.write('x')).toEqual('');\n      expect(() => input.focus()).not.toThrow();\n      expect(() => input.blur()).not.toThrow();\n      expect(() => input.setLatex('x')).not.toThrow();\n      expect(input.element).toBeUndefined();\n    });\n  });\n\n  describe('mqCompat facade', () => {\n    // math-toolbar used to call this.input.mathField.latex(); external\n    // consumers may still do the same.\n    it('exposes latex() as a getter', () => {\n      const { input } = withField();\n\n      input.mathField.getValue = () => '\\\\frac{1}{2}';\n\n      expect(input.mqCompat.latex()).toEqual('\\\\frac{1}{2}');\n    });\n\n    it('exposes latex(v) as a setter and el()', () => {\n      const { input, f } = withField();\n\n      input.mqCompat.latex('x+1');\n      expect(f.value).toEqual('x+1');\n      expect(input.mqCompat.el()).toBe(f);\n    });\n  });\n});\n"],"mappings":"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","ignoreList":[]}

package/lib/mf/input.js

@@ -163,6 +163,56 @@ var Input = exports.Input = /*#__PURE__*/function (_React$Component) {
     function latex() {
       return this.mathField ? (0, _latexBridge.fromMathLive)(this.mathField.getValue('latex')) : '';
     }
+
+    /**
+     * The underlying `<math-field>` element, or undefined until MathLive has
+     * finished loading. Exposed for callers that need the real element.
+     *
+     * NOTE: this is NOT a MathQuill field. Code written against
+     * `@pie-lib/math-input` often did `input.mathField.latex()`; that shape is
+     * provided by `mqCompat` below, and `latex()` on this component is the
+     * supported replacement.
+     */
+  }, {
+    key: "element",
+    get: function get() {
+      return this.mathField;
+    }
+
+    /**
+     * MathQuill-shaped facade, so existing `input.mathField.latex()` /
+     * `.el()` call sites keep working instead of throwing. Only the members that
+     * consumers actually used are provided; MathQuill internals such as
+     * `__controller` have no MathLive equivalent and are deliberately absent.
+     */
+  }, {
+    key: "mqCompat",
+    get: function get() {
+      var _this2 = this;
+      return {
+        latex: function latex(v) {
+          return v === undefined ? _this2.latex() : (_this2.setLatex(v), v);
+        },
+        el: function el() {
+          return _this2.mathField;
+        },
+        focus: function focus() {
+          return _this2.focus();
+        },
+        blur: function blur() {
+          return _this2.blur();
+        }
+      };
+    }
+
+    /** Programmatically replace the content. */
+  }, {
+    key: "setLatex",
+    value: function setLatex(v) {
+      if (this.mathField) {
+        this.mathField.value = (0, _latexBridge.toMathLive)(v || '');
+      }
+    }
   }, {
     key: "clear",
     value: function clear() {
@@ -184,33 +234,52 @@ var Input = exports.Input = /*#__PURE__*/function (_React$Component) {
       this.mathField && this.mathField.focus();
     }
 
-    /** MathQuill `cmd()` equivalent. */
+    /**
+     * MathQuill `cmd()` equivalent.
+     *
+     * Callers pass MathQuill command names (`'\\frac'`, `'\\sqrt'`, `'^'`, or an
+     * array of them). Those must be expanded into latex with `#?` placeholders,
+     * otherwise inserting a bare `\frac` produces no editable slots.
+     */
   }, {
     key: "command",
     value: function command(v) {
-      var _this2 = this;
       log('command: ', v);
       if (!this.mathField) {
         return '';
       }
-      var values = Array.isArray(v) ? v : [v];
-      values.forEach(function (vv) {
-        return _this2.mathField.insert(vv, {
+      var action = (0, _latexBridge.keyToAction)({
+        command: v
+      });
+      if (action) {
+        this.mathField.insert(action.value, {
           focus: true
         });
-      });
+      }
       this.mathField.focus();
       return this.latex();
     }
 
-    /** MathQuill `keystroke()` equivalent - takes a MathLive selector. */
+    /**
+     * MathQuill `keystroke()` equivalent.
+     *
+     * Accepts MathQuill keystroke names (`'Left'`, `'Right'`, `'Backspace'`) as
+     * the keypad emits them, and passes anything else through as a MathLive
+     * selector.
+     */
   }, {
     key: "keystroke",
-    value: function keystroke(selector) {
+    value: function keystroke(v) {
+      log('keystroke: ', v);
       if (!this.mathField) {
         return '';
       }
-      this.mathField.executeCommand(selector);
+      var selector = _latexBridge.KEYSTROKES[v] || v;
+      try {
+        this.mathField.executeCommand(selector);
+      } catch (e) {
+        log('unknown keystroke/selector "%s": %s', v, e && e.message);
+      }
       this.mathField.focus();
       return this.latex();
     }

package/lib/mf/input.js.map

@@ -1 +1 @@
-{"version":3,"file":"input.js","names":["_react","_interopRequireDefault","require","_propTypes","_styles","_debug","_mathliveInstance","_latexBridge","_callSuper","t","o","e","_getPrototypeOf2","_possibleConstructorReturn2","_isNativeReflectConstruct","Reflect","construct","constructor","apply","Boolean","prototype","valueOf","call","log","debug","Holder","styled","display","width","Input","exports","_React$Component","props","_this","_classCallCheck2","_defineProperty2","onChange","mathField","latex","fromMathLive","getValue","lastEmitted","event","key","preventDefault","holderRef","React","createRef","undefined","_inherits2","_createClass2","value","_componentDidMount","_asyncToGenerator2","_regenerator","mark","_callee","_this$setState","ml","wrap","_context","prev","next","loadMathLive","sent","current","abrupt","MathfieldElement","macros","getMacros","toMathLive","readOnly","mathVirtualKeyboardPolicy","addEventListener","onInputEdit","appendChild","innerRef","setState","stop","componentDidMount","arguments","componentDidUpdate","prevProps","_this$props","componentWillUnmount","removeEventListener","remove","clear","blur","focus","command","v","_this2","values","Array","isArray","forEach","vv","insert","keystroke","selector","executeCommand","write","_this3","render","_this$props2","className","onFocus","onBlur","onClick","createElement","onKeyDown","ref","Component","PropTypes","string","func","bool","_default"],"sources":["../../src/mf/input.jsx"],"sourcesContent":["import React from 'react';\nimport PropTypes from 'prop-types';\nimport { styled } from '@mui/material/styles';\nimport debug from 'debug';\nimport { loadMathLive, getMacros } from '../mathlive-instance';\nimport { toMathLive, fromMathLive } from '../latex-bridge';\n\nconst log = debug('pie-lib:math-input-mathlive:input');\n\nconst Holder = styled('span')({\n  display: 'inline-block',\n  '& math-field': {\n    display: 'block',\n    width: '100%',\n  },\n  // MathLive ships its own virtual keyboard toggle; pie supplies its own keypad.\n  '& math-field::part(virtual-keyboard-toggle)': {\n    display: 'none',\n  },\n  '& math-field::part(menu-toggle)': {\n    display: 'none',\n  },\n});\n\n/**\n * Editable math field. Drop-in replacement for @pie-lib/math-input's `mq.Input`.\n *\n * Keeps the same imperative surface used by MathInput's keypad\n * (`write`, `command`, `keystroke`, `clear`, `focus`, `blur`) so callers do not\n * change, and the same `latex` / `onChange` props.\n */\nexport class Input extends React.Component {\n  static propTypes = {\n    className: PropTypes.string,\n    latex: PropTypes.string,\n    onChange: PropTypes.func,\n    onClick: PropTypes.func,\n    onFocus: PropTypes.func,\n    onBlur: PropTypes.func,\n    readOnly: PropTypes.bool,\n    innerRef: PropTypes.func,\n  };\n\n  constructor(props) {\n    super(props);\n    this.holderRef = React.createRef();\n    // Tracks the last latex we emitted, so prop echoes don't reset the cursor.\n    this.lastEmitted = undefined;\n  }\n\n  async componentDidMount() {\n    const ml = await loadMathLive();\n\n    if (!ml || !this.holderRef.current) {\n      return;\n    }\n\n    this.mathField = new ml.MathfieldElement({ macros: getMacros() });\n    this.mathField.value = toMathLive(this.props.latex || '');\n\n    if (this.props.readOnly) {\n      this.mathField.readOnly = true;\n    }\n\n    // pie drives input through its own keypad, so suppress MathLive's.\n    this.mathField.mathVirtualKeyboardPolicy = 'manual';\n\n    this.mathField.addEventListener('input', this.onInputEdit);\n    this.holderRef.current.appendChild(this.mathField);\n\n    if (this.props.innerRef) {\n      this.props.innerRef(this);\n    }\n\n    this.setState?.({});\n  }\n\n  componentDidUpdate(prevProps) {\n    if (!this.mathField) {\n      return;\n    }\n\n    const { latex, readOnly } = this.props;\n\n    if (readOnly !== prevProps.readOnly) {\n      this.mathField.readOnly = !!readOnly;\n    }\n\n    // Only push the prop back into the field when it genuinely differs from\n    // what the field already holds. This is the analogue of the old\n    // shouldComponentUpdate latex-equality guard and prevents cursor thrash.\n    if (latex !== undefined && latex !== null && latex !== this.lastEmitted) {\n      const next = toMathLive(latex);\n\n      if (next !== this.mathField.value) {\n        this.mathField.value = next;\n      }\n    }\n  }\n\n  componentWillUnmount() {\n    if (this.mathField) {\n      this.mathField.removeEventListener('input', this.onInputEdit);\n      this.mathField.remove();\n      this.mathField = undefined;\n    }\n\n    if (this.props.innerRef) {\n      this.props.innerRef(null);\n    }\n  }\n\n  onInputEdit = () => {\n    const { onChange } = this.props;\n\n    if (!this.mathField) {\n      return;\n    }\n\n    const latex = fromMathLive(this.mathField.getValue('latex'));\n\n    this.lastEmitted = latex;\n\n    if (onChange) {\n      onChange(latex);\n    }\n  };\n\n  /** Current latex, in stored (MathQuill-compatible) form. */\n  latex() {\n    return this.mathField ? fromMathLive(this.mathField.getValue('latex')) : '';\n  }\n\n  clear() {\n    if (this.mathField) {\n      this.mathField.value = '';\n    }\n\n    return '';\n  }\n\n  blur() {\n    log('blur mathfield');\n    this.mathField && this.mathField.blur();\n  }\n\n  focus() {\n    log('focus mathfield...');\n    this.mathField && this.mathField.focus();\n  }\n\n  /** MathQuill `cmd()` equivalent. */\n  command(v) {\n    log('command: ', v);\n\n    if (!this.mathField) {\n      return '';\n    }\n\n    const values = Array.isArray(v) ? v : [v];\n\n    values.forEach((vv) => this.mathField.insert(vv, { focus: true }));\n    this.mathField.focus();\n\n    return this.latex();\n  }\n\n  /** MathQuill `keystroke()` equivalent - takes a MathLive selector. */\n  keystroke(selector) {\n    if (!this.mathField) {\n      return '';\n    }\n\n    this.mathField.executeCommand(selector);\n    this.mathField.focus();\n\n    return this.latex();\n  }\n\n  /** MathQuill `write()` equivalent. Accepts an array, as `cmd()` did. */\n  write(v) {\n    log('write: ', v);\n\n    if (!this.mathField) {\n      return '';\n    }\n\n    const values = Array.isArray(v) ? v : [v];\n\n    values.forEach((vv) => this.mathField.insert(vv, { focus: true }));\n    this.mathField.focus();\n\n    return this.latex();\n  }\n\n  /**\n   * Enter must not insert a line break: math input is single-expression, and\n   * the MathQuill version swallowed charCode 13 for the same reason. Newlines\n   * are authored explicitly through the newLine embed, not the Enter key.\n   */\n  onKeyDown = (event) => {\n    if (event.key === 'Enter') {\n      event.preventDefault();\n    }\n  };\n\n  render() {\n    const { className, onFocus, onBlur, onClick } = this.props;\n\n    return (\n      <Holder\n        className={className}\n        onFocus={onFocus}\n        onBlur={onBlur}\n        onClick={onClick}\n        onKeyDown={this.onKeyDown}\n        ref={this.holderRef}\n      />\n    );\n  }\n}\n\nexport default Input;\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"input.js","names":["_react","_interopRequireDefault","require","_propTypes","_styles","_debug","_mathliveInstance","_latexBridge","_callSuper","t","o","e","_getPrototypeOf2","_possibleConstructorReturn2","_isNativeReflectConstruct","Reflect","construct","constructor","apply","Boolean","prototype","valueOf","call","log","debug","Holder","styled","display","width","Input","exports","_React$Component","props","_this","_classCallCheck2","_defineProperty2","onChange","mathField","latex","fromMathLive","getValue","lastEmitted","event","key","preventDefault","holderRef","React","createRef","undefined","_inherits2","_createClass2","value","_componentDidMount","_asyncToGenerator2","_regenerator","mark","_callee","_this$setState","ml","wrap","_context","prev","next","loadMathLive","sent","current","abrupt","MathfieldElement","macros","getMacros","toMathLive","readOnly","mathVirtualKeyboardPolicy","addEventListener","onInputEdit","appendChild","innerRef","setState","stop","componentDidMount","arguments","componentDidUpdate","prevProps","_this$props","componentWillUnmount","removeEventListener","remove","get","_this2","v","setLatex","el","focus","blur","clear","command","action","keyToAction","insert","keystroke","selector","KEYSTROKES","executeCommand","message","write","_this3","values","Array","isArray","forEach","vv","render","_this$props2","className","onFocus","onBlur","onClick","createElement","onKeyDown","ref","Component","PropTypes","string","func","bool","_default"],"sources":["../../src/mf/input.jsx"],"sourcesContent":["import React from 'react';\nimport PropTypes from 'prop-types';\nimport { styled } from '@mui/material/styles';\nimport debug from 'debug';\nimport { loadMathLive, getMacros } from '../mathlive-instance';\nimport { toMathLive, fromMathLive, keyToAction, KEYSTROKES } from '../latex-bridge';\n\nconst log = debug('pie-lib:math-input-mathlive:input');\n\nconst Holder = styled('span')({\n  display: 'inline-block',\n  '& math-field': {\n    display: 'block',\n    width: '100%',\n  },\n  // MathLive ships its own virtual keyboard toggle; pie supplies its own keypad.\n  '& math-field::part(virtual-keyboard-toggle)': {\n    display: 'none',\n  },\n  '& math-field::part(menu-toggle)': {\n    display: 'none',\n  },\n});\n\n/**\n * Editable math field. Drop-in replacement for @pie-lib/math-input's `mq.Input`.\n *\n * Keeps the same imperative surface used by MathInput's keypad\n * (`write`, `command`, `keystroke`, `clear`, `focus`, `blur`) so callers do not\n * change, and the same `latex` / `onChange` props.\n */\nexport class Input extends React.Component {\n  static propTypes = {\n    className: PropTypes.string,\n    latex: PropTypes.string,\n    onChange: PropTypes.func,\n    onClick: PropTypes.func,\n    onFocus: PropTypes.func,\n    onBlur: PropTypes.func,\n    readOnly: PropTypes.bool,\n    innerRef: PropTypes.func,\n  };\n\n  constructor(props) {\n    super(props);\n    this.holderRef = React.createRef();\n    // Tracks the last latex we emitted, so prop echoes don't reset the cursor.\n    this.lastEmitted = undefined;\n  }\n\n  async componentDidMount() {\n    const ml = await loadMathLive();\n\n    if (!ml || !this.holderRef.current) {\n      return;\n    }\n\n    this.mathField = new ml.MathfieldElement({ macros: getMacros() });\n    this.mathField.value = toMathLive(this.props.latex || '');\n\n    if (this.props.readOnly) {\n      this.mathField.readOnly = true;\n    }\n\n    // pie drives input through its own keypad, so suppress MathLive's.\n    this.mathField.mathVirtualKeyboardPolicy = 'manual';\n\n    this.mathField.addEventListener('input', this.onInputEdit);\n    this.holderRef.current.appendChild(this.mathField);\n\n    if (this.props.innerRef) {\n      this.props.innerRef(this);\n    }\n\n    this.setState?.({});\n  }\n\n  componentDidUpdate(prevProps) {\n    if (!this.mathField) {\n      return;\n    }\n\n    const { latex, readOnly } = this.props;\n\n    if (readOnly !== prevProps.readOnly) {\n      this.mathField.readOnly = !!readOnly;\n    }\n\n    // Only push the prop back into the field when it genuinely differs from\n    // what the field already holds. This is the analogue of the old\n    // shouldComponentUpdate latex-equality guard and prevents cursor thrash.\n    if (latex !== undefined && latex !== null && latex !== this.lastEmitted) {\n      const next = toMathLive(latex);\n\n      if (next !== this.mathField.value) {\n        this.mathField.value = next;\n      }\n    }\n  }\n\n  componentWillUnmount() {\n    if (this.mathField) {\n      this.mathField.removeEventListener('input', this.onInputEdit);\n      this.mathField.remove();\n      this.mathField = undefined;\n    }\n\n    if (this.props.innerRef) {\n      this.props.innerRef(null);\n    }\n  }\n\n  onInputEdit = () => {\n    const { onChange } = this.props;\n\n    if (!this.mathField) {\n      return;\n    }\n\n    const latex = fromMathLive(this.mathField.getValue('latex'));\n\n    this.lastEmitted = latex;\n\n    if (onChange) {\n      onChange(latex);\n    }\n  };\n\n  /** Current latex, in stored (MathQuill-compatible) form. */\n  latex() {\n    return this.mathField ? fromMathLive(this.mathField.getValue('latex')) : '';\n  }\n\n  /**\n   * The underlying `<math-field>` element, or undefined until MathLive has\n   * finished loading. Exposed for callers that need the real element.\n   *\n   * NOTE: this is NOT a MathQuill field. Code written against\n   * `@pie-lib/math-input` often did `input.mathField.latex()`; that shape is\n   * provided by `mqCompat` below, and `latex()` on this component is the\n   * supported replacement.\n   */\n  get element() {\n    return this.mathField;\n  }\n\n  /**\n   * MathQuill-shaped facade, so existing `input.mathField.latex()` /\n   * `.el()` call sites keep working instead of throwing. Only the members that\n   * consumers actually used are provided; MathQuill internals such as\n   * `__controller` have no MathLive equivalent and are deliberately absent.\n   */\n  get mqCompat() {\n    return {\n      latex: (v) => (v === undefined ? this.latex() : (this.setLatex(v), v)),\n      el: () => this.mathField,\n      focus: () => this.focus(),\n      blur: () => this.blur(),\n    };\n  }\n\n  /** Programmatically replace the content. */\n  setLatex(v) {\n    if (this.mathField) {\n      this.mathField.value = toMathLive(v || '');\n    }\n  }\n\n  clear() {\n    if (this.mathField) {\n      this.mathField.value = '';\n    }\n\n    return '';\n  }\n\n  blur() {\n    log('blur mathfield');\n    this.mathField && this.mathField.blur();\n  }\n\n  focus() {\n    log('focus mathfield...');\n    this.mathField && this.mathField.focus();\n  }\n\n  /**\n   * MathQuill `cmd()` equivalent.\n   *\n   * Callers pass MathQuill command names (`'\\\\frac'`, `'\\\\sqrt'`, `'^'`, or an\n   * array of them). Those must be expanded into latex with `#?` placeholders,\n   * otherwise inserting a bare `\\frac` produces no editable slots.\n   */\n  command(v) {\n    log('command: ', v);\n\n    if (!this.mathField) {\n      return '';\n    }\n\n    const action = keyToAction({ command: v });\n\n    if (action) {\n      this.mathField.insert(action.value, { focus: true });\n    }\n\n    this.mathField.focus();\n\n    return this.latex();\n  }\n\n  /**\n   * MathQuill `keystroke()` equivalent.\n   *\n   * Accepts MathQuill keystroke names (`'Left'`, `'Right'`, `'Backspace'`) as\n   * the keypad emits them, and passes anything else through as a MathLive\n   * selector.\n   */\n  keystroke(v) {\n    log('keystroke: ', v);\n\n    if (!this.mathField) {\n      return '';\n    }\n\n    const selector = KEYSTROKES[v] || v;\n\n    try {\n      this.mathField.executeCommand(selector);\n    } catch (e) {\n      log('unknown keystroke/selector \"%s\": %s', v, e && e.message);\n    }\n\n    this.mathField.focus();\n\n    return this.latex();\n  }\n\n  /** MathQuill `write()` equivalent. Accepts an array, as `cmd()` did. */\n  write(v) {\n    log('write: ', v);\n\n    if (!this.mathField) {\n      return '';\n    }\n\n    const values = Array.isArray(v) ? v : [v];\n\n    values.forEach((vv) => this.mathField.insert(vv, { focus: true }));\n    this.mathField.focus();\n\n    return this.latex();\n  }\n\n  /**\n   * Enter must not insert a line break: math input is single-expression, and\n   * the MathQuill version swallowed charCode 13 for the same reason. Newlines\n   * are authored explicitly through the newLine embed, not the Enter key.\n   */\n  onKeyDown = (event) => {\n    if (event.key === 'Enter') {\n      event.preventDefault();\n    }\n  };\n\n  render() {\n    const { className, onFocus, onBlur, onClick } = this.props;\n\n    return (\n      <Holder\n        className={className}\n        onFocus={onFocus}\n        onBlur={onBlur}\n        onClick={onClick}\n        onKeyDown={this.onKeyDown}\n        ref={this.holderRef}\n      />\n    );\n  }\n}\n\nexport default Input;\n"],"mappings":";;;;;;;;;;;;;;;AAAA,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,UAAA,GAAAF,sBAAA,CAAAC,OAAA;AACA,IAAAE,OAAA,GAAAF,OAAA;AACA,IAAAG,MAAA,GAAAJ,sBAAA,CAAAC,OAAA;AACA,IAAAI,iBAAA,GAAAJ,OAAA;AACA,IAAAK,YAAA,GAAAL,OAAA;AAAoF,SAAAM,WAAAC,CAAA,EAAAC,CAAA,EAAAC,CAAA,WAAAD,CAAA,OAAAE,gBAAA,aAAAF,CAAA,OAAAG,2BAAA,aAAAJ,CAAA,EAAAK,yBAAA,KAAAC,OAAA,CAAAC,SAAA,CAAAN,CAAA,EAAAC,CAAA,YAAAC,gBAAA,aAAAH,CAAA,EAAAQ,WAAA,IAAAP,CAAA,CAAAQ,KAAA,CAAAT,CAAA,EAAAE,CAAA;AAAA,SAAAG,0BAAA,cAAAL,CAAA,IAAAU,OAAA,CAAAC,SAAA,CAAAC,OAAA,CAAAC,IAAA,CAAAP,OAAA,CAAAC,SAAA,CAAAG,OAAA,iCAAAV,CAAA,aAAAK,yBAAA,YAAAA,0BAAA,aAAAL,CAAA;AAEpF,IAAMc,GAAG,GAAG,IAAAC,iBAAK,EAAC,mCAAmC,CAAC;AAEtD,IAAMC,MAAM,GAAG,IAAAC,cAAM,EAAC,MAAM,CAAC,CAAC;EAC5BC,OAAO,EAAE,cAAc;EACvB,cAAc,EAAE;IACdA,OAAO,EAAE,OAAO;IAChBC,KAAK,EAAE;EACT,CAAC;EACD;EACA,6CAA6C,EAAE;IAC7CD,OAAO,EAAE;EACX,CAAC;EACD,iCAAiC,EAAE;IACjCA,OAAO,EAAE;EACX;AACF,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AANA,IAOaE,KAAK,GAAAC,OAAA,CAAAD,KAAA,0BAAAE,gBAAA;EAYhB,SAAAF,MAAYG,KAAK,EAAE;IAAA,IAAAC,KAAA;IAAA,IAAAC,gBAAA,mBAAAL,KAAA;IACjBI,KAAA,GAAAzB,UAAA,OAAAqB,KAAA,GAAMG,KAAK;IAAE,IAAAG,gBAAA,aAAAF,KAAA,iBAoED,YAAM;MAClB,IAAQG,QAAQ,GAAKH,KAAA,CAAKD,KAAK,CAAvBI,QAAQ;MAEhB,IAAI,CAACH,KAAA,CAAKI,SAAS,EAAE;QACnB;MACF;MAEA,IAAMC,KAAK,GAAG,IAAAC,yBAAY,EAACN,KAAA,CAAKI,SAAS,CAACG,QAAQ,CAAC,OAAO,CAAC,CAAC;MAE5DP,KAAA,CAAKQ,WAAW,GAAGH,KAAK;MAExB,IAAIF,QAAQ,EAAE;QACZA,QAAQ,CAACE,KAAK,CAAC;MACjB;IACF,CAAC;IAgID;AACF;AACA;AACA;AACA;IAJE,IAAAH,gBAAA,aAAAF,KAAA,eAKY,UAACS,KAAK,EAAK;MACrB,IAAIA,KAAK,CAACC,GAAG,KAAK,OAAO,EAAE;QACzBD,KAAK,CAACE,cAAc,CAAC,CAAC;MACxB;IACF,CAAC;IA1NCX,KAAA,CAAKY,SAAS,gBAAGC,iBAAK,CAACC,SAAS,CAAC,CAAC;IAClC;IACAd,KAAA,CAAKQ,WAAW,GAAGO,SAAS;IAAC,OAAAf,KAAA;EAC/B;EAAC,IAAAgB,UAAA,aAAApB,KAAA,EAAAE,gBAAA;EAAA,WAAAmB,aAAA,aAAArB,KAAA;IAAAc,GAAA;IAAAQ,KAAA;MAAA,IAAAC,kBAAA,OAAAC,kBAAA,0BAAAC,YAAA,YAAAC,IAAA,CAED,SAAAC,QAAA;QAAA,IAAAC,cAAA;QAAA,IAAAC,EAAA;QAAA,OAAAJ,YAAA,YAAAK,IAAA,WAAAC,QAAA;UAAA,kBAAAA,QAAA,CAAAC,IAAA,GAAAD,QAAA,CAAAE,IAAA;YAAA;cAAAF,QAAA,CAAAE,IAAA;cAAA,OACmB,IAAAC,8BAAY,EAAC,CAAC;YAAA;cAAzBL,EAAE,GAAAE,QAAA,CAAAI,IAAA;cAAA,MAEJ,CAACN,EAAE,IAAI,CAAC,IAAI,CAACb,SAAS,CAACoB,OAAO;gBAAAL,QAAA,CAAAE,IAAA;gBAAA;cAAA;cAAA,OAAAF,QAAA,CAAAM,MAAA;YAAA;cAIlC,IAAI,CAAC7B,SAAS,GAAG,IAAIqB,EAAE,CAACS,gBAAgB,CAAC;gBAAEC,MAAM,EAAE,IAAAC,2BAAS,EAAC;cAAE,CAAC,CAAC;cACjE,IAAI,CAAChC,SAAS,CAACc,KAAK,GAAG,IAAAmB,uBAAU,EAAC,IAAI,CAACtC,KAAK,CAACM,KAAK,IAAI,EAAE,CAAC;cAEzD,IAAI,IAAI,CAACN,KAAK,CAACuC,QAAQ,EAAE;gBACvB,IAAI,CAAClC,SAAS,CAACkC,QAAQ,GAAG,IAAI;cAChC;;cAEA;cACA,IAAI,CAAClC,SAAS,CAACmC,yBAAyB,GAAG,QAAQ;cAEnD,IAAI,CAACnC,SAAS,CAACoC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAACC,WAAW,CAAC;cAC1D,IAAI,CAAC7B,SAAS,CAACoB,OAAO,CAACU,WAAW,CAAC,IAAI,CAACtC,SAAS,CAAC;cAElD,IAAI,IAAI,CAACL,KAAK,CAAC4C,QAAQ,EAAE;gBACvB,IAAI,CAAC5C,KAAK,CAAC4C,QAAQ,CAAC,IAAI,CAAC;cAC3B;cAEA,CAAAnB,cAAA,OAAI,CAACoB,QAAQ,cAAApB,cAAA,eAAbA,cAAA,CAAAnC,IAAA,KAAI,EAAY,CAAC,CAAC,CAAC;YAAC;YAAA;cAAA,OAAAsC,QAAA,CAAAkB,IAAA;UAAA;QAAA,GAAAtB,OAAA;MAAA,CACrB;MAAA,SAzBKuB,iBAAiBA,CAAA;QAAA,OAAA3B,kBAAA,CAAAlC,KAAA,OAAA8D,SAAA;MAAA;MAAA,OAAjBD,iBAAiB;IAAA;EAAA;IAAApC,GAAA;IAAAQ,KAAA,EA2BvB,SAAA8B,kBAAkBA,CAACC,SAAS,EAAE;MAC5B,IAAI,CAAC,IAAI,CAAC7C,SAAS,EAAE;QACnB;MACF;MAEA,IAAA8C,WAAA,GAA4B,IAAI,CAACnD,KAAK;QAA9BM,KAAK,GAAA6C,WAAA,CAAL7C,KAAK;QAAEiC,QAAQ,GAAAY,WAAA,CAARZ,QAAQ;MAEvB,IAAIA,QAAQ,KAAKW,SAAS,CAACX,QAAQ,EAAE;QACnC,IAAI,CAAClC,SAAS,CAACkC,QAAQ,GAAG,CAAC,CAACA,QAAQ;MACtC;;MAEA;MACA;MACA;MACA,IAAIjC,KAAK,KAAKU,SAAS,IAAIV,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAK,IAAI,CAACG,WAAW,EAAE;QACvE,IAAMqB,IAAI,GAAG,IAAAQ,uBAAU,EAAChC,KAAK,CAAC;QAE9B,IAAIwB,IAAI,KAAK,IAAI,CAACzB,SAAS,CAACc,KAAK,EAAE;UACjC,IAAI,CAACd,SAAS,CAACc,KAAK,GAAGW,IAAI;QAC7B;MACF;IACF;EAAC;IAAAnB,GAAA;IAAAQ,KAAA,EAED,SAAAiC,oBAAoBA,CAAA,EAAG;MACrB,IAAI,IAAI,CAAC/C,SAAS,EAAE;QAClB,IAAI,CAACA,SAAS,CAACgD,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAACX,WAAW,CAAC;QAC7D,IAAI,CAACrC,SAAS,CAACiD,MAAM,CAAC,CAAC;QACvB,IAAI,CAACjD,SAAS,GAAGW,SAAS;MAC5B;MAEA,IAAI,IAAI,CAAChB,KAAK,CAAC4C,QAAQ,EAAE;QACvB,IAAI,CAAC5C,KAAK,CAAC4C,QAAQ,CAAC,IAAI,CAAC;MAC3B;IACF;EAAC;IAAAjC,GAAA;IAAAQ,KAAA,EAkBD;IACA,SAAAb,KAAKA,CAAA,EAAG;MACN,OAAO,IAAI,CAACD,SAAS,GAAG,IAAAE,yBAAY,EAAC,IAAI,CAACF,SAAS,CAACG,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE;IAC7E;;IAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EARE;IAAAG,GAAA;IAAA4C,GAAA,EASA,SAAAA,IAAA,EAAc;MACZ,OAAO,IAAI,CAAClD,SAAS;IACvB;;IAEA;AACF;AACA;AACA;AACA;AACA;EALE;IAAAM,GAAA;IAAA4C,GAAA,EAMA,SAAAA,IAAA,EAAe;MAAA,IAAAC,MAAA;MACb,OAAO;QACLlD,KAAK,EAAE,SAAPA,KAAKA,CAAGmD,CAAC;UAAA,OAAMA,CAAC,KAAKzC,SAAS,GAAGwC,MAAI,CAAClD,KAAK,CAAC,CAAC,IAAIkD,MAAI,CAACE,QAAQ,CAACD,CAAC,CAAC,EAAEA,CAAC,CAAC;QAAA,CAAC;QACtEE,EAAE,EAAE,SAAJA,EAAEA,CAAA;UAAA,OAAQH,MAAI,CAACnD,SAAS;QAAA;QACxBuD,KAAK,EAAE,SAAPA,KAAKA,CAAA;UAAA,OAAQJ,MAAI,CAACI,KAAK,CAAC,CAAC;QAAA;QACzBC,IAAI,EAAE,SAANA,IAAIA,CAAA;UAAA,OAAQL,MAAI,CAACK,IAAI,CAAC,CAAC;QAAA;MACzB,CAAC;IACH;;IAEA;EAAA;IAAAlD,GAAA;IAAAQ,KAAA,EACA,SAAAuC,QAAQA,CAACD,CAAC,EAAE;MACV,IAAI,IAAI,CAACpD,SAAS,EAAE;QAClB,IAAI,CAACA,SAAS,CAACc,KAAK,GAAG,IAAAmB,uBAAU,EAACmB,CAAC,IAAI,EAAE,CAAC;MAC5C;IACF;EAAC;IAAA9C,GAAA;IAAAQ,KAAA,EAED,SAAA2C,KAAKA,CAAA,EAAG;MACN,IAAI,IAAI,CAACzD,SAAS,EAAE;QAClB,IAAI,CAACA,SAAS,CAACc,KAAK,GAAG,EAAE;MAC3B;MAEA,OAAO,EAAE;IACX;EAAC;IAAAR,GAAA;IAAAQ,KAAA,EAED,SAAA0C,IAAIA,CAAA,EAAG;MACLtE,GAAG,CAAC,gBAAgB,CAAC;MACrB,IAAI,CAACc,SAAS,IAAI,IAAI,CAACA,SAAS,CAACwD,IAAI,CAAC,CAAC;IACzC;EAAC;IAAAlD,GAAA;IAAAQ,KAAA,EAED,SAAAyC,KAAKA,CAAA,EAAG;MACNrE,GAAG,CAAC,oBAAoB,CAAC;MACzB,IAAI,CAACc,SAAS,IAAI,IAAI,CAACA,SAAS,CAACuD,KAAK,CAAC,CAAC;IAC1C;;IAEA;AACF;AACA;AACA;AACA;AACA;AACA;EANE;IAAAjD,GAAA;IAAAQ,KAAA,EAOA,SAAA4C,OAAOA,CAACN,CAAC,EAAE;MACTlE,GAAG,CAAC,WAAW,EAAEkE,CAAC,CAAC;MAEnB,IAAI,CAAC,IAAI,CAACpD,SAAS,EAAE;QACnB,OAAO,EAAE;MACX;MAEA,IAAM2D,MAAM,GAAG,IAAAC,wBAAW,EAAC;QAAEF,OAAO,EAAEN;MAAE,CAAC,CAAC;MAE1C,IAAIO,MAAM,EAAE;QACV,IAAI,CAAC3D,SAAS,CAAC6D,MAAM,CAACF,MAAM,CAAC7C,KAAK,EAAE;UAAEyC,KAAK,EAAE;QAAK,CAAC,CAAC;MACtD;MAEA,IAAI,CAACvD,SAAS,CAACuD,KAAK,CAAC,CAAC;MAEtB,OAAO,IAAI,CAACtD,KAAK,CAAC,CAAC;IACrB;;IAEA;AACF;AACA;AACA;AACA;AACA;AACA;EANE;IAAAK,GAAA;IAAAQ,KAAA,EAOA,SAAAgD,SAASA,CAACV,CAAC,EAAE;MACXlE,GAAG,CAAC,aAAa,EAAEkE,CAAC,CAAC;MAErB,IAAI,CAAC,IAAI,CAACpD,SAAS,EAAE;QACnB,OAAO,EAAE;MACX;MAEA,IAAM+D,QAAQ,GAAGC,uBAAU,CAACZ,CAAC,CAAC,IAAIA,CAAC;MAEnC,IAAI;QACF,IAAI,CAACpD,SAAS,CAACiE,cAAc,CAACF,QAAQ,CAAC;MACzC,CAAC,CAAC,OAAOzF,CAAC,EAAE;QACVY,GAAG,CAAC,qCAAqC,EAAEkE,CAAC,EAAE9E,CAAC,IAAIA,CAAC,CAAC4F,OAAO,CAAC;MAC/D;MAEA,IAAI,CAAClE,SAAS,CAACuD,KAAK,CAAC,CAAC;MAEtB,OAAO,IAAI,CAACtD,KAAK,CAAC,CAAC;IACrB;;IAEA;EAAA;IAAAK,GAAA;IAAAQ,KAAA,EACA,SAAAqD,KAAKA,CAACf,CAAC,EAAE;MAAA,IAAAgB,MAAA;MACPlF,GAAG,CAAC,SAAS,EAAEkE,CAAC,CAAC;MAEjB,IAAI,CAAC,IAAI,CAACpD,SAAS,EAAE;QACnB,OAAO,EAAE;MACX;MAEA,IAAMqE,MAAM,GAAGC,KAAK,CAACC,OAAO,CAACnB,CAAC,CAAC,GAAGA,CAAC,GAAG,CAACA,CAAC,CAAC;MAEzCiB,MAAM,CAACG,OAAO,CAAC,UAACC,EAAE;QAAA,OAAKL,MAAI,CAACpE,SAAS,CAAC6D,MAAM,CAACY,EAAE,EAAE;UAAElB,KAAK,EAAE;QAAK,CAAC,CAAC;MAAA,EAAC;MAClE,IAAI,CAACvD,SAAS,CAACuD,KAAK,CAAC,CAAC;MAEtB,OAAO,IAAI,CAACtD,KAAK,CAAC,CAAC;IACrB;EAAC;IAAAK,GAAA;IAAAQ,KAAA,EAaD,SAAA4D,MAAMA,CAAA,EAAG;MACP,IAAAC,YAAA,GAAgD,IAAI,CAAChF,KAAK;QAAlDiF,SAAS,GAAAD,YAAA,CAATC,SAAS;QAAEC,OAAO,GAAAF,YAAA,CAAPE,OAAO;QAAEC,MAAM,GAAAH,YAAA,CAANG,MAAM;QAAEC,OAAO,GAAAJ,YAAA,CAAPI,OAAO;MAE3C,oBACEpH,MAAA,YAAAqH,aAAA,CAAC5F,MAAM;QACLwF,SAAS,EAAEA,SAAU;QACrBC,OAAO,EAAEA,OAAQ;QACjBC,MAAM,EAAEA,MAAO;QACfC,OAAO,EAAEA,OAAQ;QACjBE,SAAS,EAAE,IAAI,CAACA,SAAU;QAC1BC,GAAG,EAAE,IAAI,CAAC1E;MAAU,CACrB,CAAC;IAEN;EAAC;AAAA,EAvPwBC,iBAAK,CAAC0E,SAAS;AAAA,IAAArF,gBAAA,aAA7BN,KAAK,eACG;EACjBoF,SAAS,EAAEQ,qBAAS,CAACC,MAAM;EAC3BpF,KAAK,EAAEmF,qBAAS,CAACC,MAAM;EACvBtF,QAAQ,EAAEqF,qBAAS,CAACE,IAAI;EACxBP,OAAO,EAAEK,qBAAS,CAACE,IAAI;EACvBT,OAAO,EAAEO,qBAAS,CAACE,IAAI;EACvBR,MAAM,EAAEM,qBAAS,CAACE,IAAI;EACtBpD,QAAQ,EAAEkD,qBAAS,CAACG,IAAI;EACxBhD,QAAQ,EAAE6C,qBAAS,CAACE;AACtB,CAAC;AAAA,IAAAE,QAAA,GAAA/F,OAAA,cAgPYD,KAAK","ignoreList":[]}

package/package.json

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

package/src/__tests__/input-imperative.test.jsx

@@ -0,0 +1,144 @@
+import { KEYSTROKES, keyToAction } from '../latex-bridge';
+import Input from '../mf/input';
+
+/**
+ * The imperative surface that @pie-lib/math-toolbar drives
+ * (editor-and-pad.jsx: clear/command/keystroke/write/latex).
+ *
+ * These call the methods against a stub mathfield, because a real
+ * <math-field> needs a browser. What matters here is the *translation*:
+ * MathQuill-era arguments must become valid MathLive operations.
+ */
+const stubField = () => {
+  const calls = { insert: [], executeCommand: [], focus: 0 };
+
+  return {
+    calls,
+    value: '',
+    getValue: () => '',
+    insert(v) {
+      calls.insert.push(v);
+    },
+    executeCommand(v) {
+      calls.executeCommand.push(v);
+    },
+    focus() {
+      calls.focus++;
+    },
+    blur() {},
+  };
+};
+
+const withField = () => {
+  const input = new Input({});
+  const f = stubField();
+
+  input.mathField = f;
+
+  return { input, f };
+};
+
+describe('Input imperative API (drives math-toolbar)', () => {
+  describe('keystroke', () => {
+    it('maps MathQuill keystroke names to MathLive selectors', () => {
+      const { input, f } = withField();
+
+      input.keystroke('Left');
+      input.keystroke('Right');
+      input.keystroke('Backspace');
+
+      expect(f.calls.executeCommand).toEqual(['moveToPreviousChar', 'moveToNextChar', 'deleteBackward']);
+    });
+
+    it('passes an unknown value through as a selector', () => {
+      const { input, f } = withField();
+
+      input.keystroke('deleteForward');
+
+      expect(f.calls.executeCommand).toEqual(['deleteForward']);
+    });
+
+    it('does not throw when the engine rejects the selector', () => {
+      const { input } = withField();
+
+      input.mathField.executeCommand = () => {
+        throw new Error('unknown command');
+      };
+
+      expect(() => input.keystroke('Nonsense')).not.toThrow();
+    });
+
+    it('covers every keystroke the keypad emits', () => {
+      // navigation.js / edit.js only produce these three
+      ['Left', 'Right', 'Backspace'].forEach((k) => expect(KEYSTROKES[k]).toBeDefined());
+    });
+  });
+
+  describe('command', () => {
+    it('expands argument-taking commands into placeholders', () => {
+      const { input, f } = withField();
+
+      input.command('\\frac');
+
+      // a bare \frac would give no editable slots
+      expect(f.calls.insert).toEqual(['\\frac{#?}{#?}']);
+    });
+
+    it('handles array commands', () => {
+      const { input, f } = withField();
+
+      input.command(['\\log', '_']);
+
+      expect(f.calls.insert).toEqual(['\\log_{#?}']);
+    });
+
+    it('passes argument-less commands through', () => {
+      const { input, f } = withField();
+
+      input.command('\\pi');
+
+      expect(f.calls.insert).toEqual(['\\pi']);
+    });
+
+    it('agrees with keyToAction', () => {
+      expect(keyToAction({ command: '\\sqrt' }).value).toEqual('\\sqrt{#?}');
+    });
+  });
+
+  describe('safety before MathLive loads', () => {
+    it('every method is a no-op rather than a crash', () => {
+      const input = new Input({});
+
+      // mathField is undefined until loadMathLive() resolves
+      expect(input.latex()).toEqual('');
+      expect(input.clear()).toEqual('');
+      expect(input.command('\\frac')).toEqual('');
+      expect(input.keystroke('Left')).toEqual('');
+      expect(input.write('x')).toEqual('');
+      expect(() => input.focus()).not.toThrow();
+      expect(() => input.blur()).not.toThrow();
+      expect(() => input.setLatex('x')).not.toThrow();
+      expect(input.element).toBeUndefined();
+    });
+  });
+
+  describe('mqCompat facade', () => {
+    // math-toolbar used to call this.input.mathField.latex(); external
+    // consumers may still do the same.
+    it('exposes latex() as a getter', () => {
+      const { input } = withField();
+
+      input.mathField.getValue = () => '\\frac{1}{2}';
+
+      expect(input.mqCompat.latex()).toEqual('\\frac{1}{2}');
+    });
+
+    it('exposes latex(v) as a setter and el()', () => {
+      const { input, f } = withField();
+
+      input.mqCompat.latex('x+1');
+      expect(f.value).toEqual('x+1');
+      expect(input.mqCompat.el()).toBe(f);
+    });
+  });
+});

package/src/mf/input.jsx

@@ -3,7 +3,7 @@ import PropTypes from 'prop-types';
 import { styled } from '@mui/material/styles';
 import debug from 'debug';
 import { loadMathLive, getMacros } from '../mathlive-instance';
-import { toMathLive, fromMathLive } from '../latex-bridge';
+import { toMathLive, fromMathLive, keyToAction, KEYSTROKES } from '../latex-bridge';
 
 const log = debug('pie-lib:math-input-mathlive:input');
 
@@ -131,6 +131,41 @@ export class Input extends React.Component {
     return this.mathField ? fromMathLive(this.mathField.getValue('latex')) : '';
   }
 
+  /**
+   * The underlying `<math-field>` element, or undefined until MathLive has
+   * finished loading. Exposed for callers that need the real element.
+   *
+   * NOTE: this is NOT a MathQuill field. Code written against
+   * `@pie-lib/math-input` often did `input.mathField.latex()`; that shape is
+   * provided by `mqCompat` below, and `latex()` on this component is the
+   * supported replacement.
+   */
+  get element() {
+    return this.mathField;
+  }
+
+  /**
+   * MathQuill-shaped facade, so existing `input.mathField.latex()` /
+   * `.el()` call sites keep working instead of throwing. Only the members that
+   * consumers actually used are provided; MathQuill internals such as
+   * `__controller` have no MathLive equivalent and are deliberately absent.
+   */
+  get mqCompat() {
+    return {
+      latex: (v) => (v === undefined ? this.latex() : (this.setLatex(v), v)),
+      el: () => this.mathField,
+      focus: () => this.focus(),
+      blur: () => this.blur(),
+    };
+  }
+
+  /** Programmatically replace the content. */
+  setLatex(v) {
+    if (this.mathField) {
+      this.mathField.value = toMathLive(v || '');
+    }
+  }
+
   clear() {
     if (this.mathField) {
       this.mathField.value = '';
@@ -149,7 +184,13 @@ export class Input extends React.Component {
     this.mathField && this.mathField.focus();
   }
 
-  /** MathQuill `cmd()` equivalent. */
+  /**
+   * MathQuill `cmd()` equivalent.
+   *
+   * Callers pass MathQuill command names (`'\\frac'`, `'\\sqrt'`, `'^'`, or an
+   * array of them). Those must be expanded into latex with `#?` placeholders,
+   * otherwise inserting a bare `\frac` produces no editable slots.
+   */
   command(v) {
     log('command: ', v);
 
@@ -157,21 +198,39 @@ export class Input extends React.Component {
       return '';
     }
 
-    const values = Array.isArray(v) ? v : [v];
+    const action = keyToAction({ command: v });
+
+    if (action) {
+      this.mathField.insert(action.value, { focus: true });
+    }
 
-    values.forEach((vv) => this.mathField.insert(vv, { focus: true }));
     this.mathField.focus();
 
     return this.latex();
   }
 
-  /** MathQuill `keystroke()` equivalent - takes a MathLive selector. */
-  keystroke(selector) {
+  /**
+   * MathQuill `keystroke()` equivalent.
+   *
+   * Accepts MathQuill keystroke names (`'Left'`, `'Right'`, `'Backspace'`) as
+   * the keypad emits them, and passes anything else through as a MathLive
+   * selector.
+   */
+  keystroke(v) {
+    log('keystroke: ', v);
+
     if (!this.mathField) {
       return '';
     }
 
-    this.mathField.executeCommand(selector);
+    const selector = KEYSTROKES[v] || v;
+
+    try {
+      this.mathField.executeCommand(selector);
+    } catch (e) {
+      log('unknown keystroke/selector "%s": %s', v, e && e.message);
+    }
+
     this.mathField.focus();
 
     return this.latex();