@tiptap/extension-mathematics 3.0.0-beta.17 → 3.0.0-beta.19

package/dist/index.cjs

@@ -32,9 +32,11 @@ var index_exports = {};
 __export(index_exports, {
   BlockMath: () => BlockMath,
   InlineMath: () => InlineMath,
-  Math: () => Math2,
   Mathematics: () => Mathematics,
-  default: () => index_default
+  createMathMigrateTransaction: () => createMathMigrateTransaction,
+  default: () => index_default,
+  mathMigrationRegex: () => mathMigrationRegex,
+  migrateMathStrings: () => migrateMathStrings
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -50,7 +52,8 @@ var BlockMath = import_core.Node.create({
   atom: true,
   addOptions() {
     return {
-      onClick: void 0
+      onClick: void 0,
+      katexOptions: void 0
     };
   },
   addAttributes() {
@@ -68,14 +71,17 @@ var BlockMath = import_core.Node.create({
   },
   addCommands() {
     return {
-      setBlockMath: (options) => ({ commands, editor }) => {
+      insertBlockMath: (options) => ({ commands, editor }) => {
         const { latex, pos } = options;
+        if (!latex) {
+          return false;
+        }
         return commands.insertContentAt(pos != null ? pos : editor.state.selection.from, {
           type: this.name,
           attrs: { latex }
         });
       },
-      unsetBlockMath: (options) => ({ editor, tr }) => {
+      deleteBlockMath: (options) => ({ editor, tr }) => {
         var _a;
         const pos = (_a = options == null ? void 0 : options.pos) != null ? _a : editor.state.selection.$from.pos;
         const node = editor.state.doc.nodeAt(pos);
@@ -128,17 +134,21 @@ var BlockMath = import_core.Node.create({
     ];
   },
   addNodeView() {
+    const { katexOptions } = this.options;
     return ({ node, getPos }) => {
       const wrapper = document.createElement("div");
       const innerWrapper = document.createElement("div");
-      wrapper.className = "Tiptap-mathematics-render Tiptap-mathematics-render--editable";
+      wrapper.className = "tiptap-mathematics-render";
+      if (this.editor.isEditable) {
+        wrapper.classList.add("tiptap-mathematics-render--editable");
+      }
       innerWrapper.className = "block-math-inner";
       wrapper.dataset.type = "block-math";
       wrapper.setAttribute("data-latex", node.attrs.latex);
       wrapper.appendChild(innerWrapper);
       function renderMath() {
         try {
-          import_katex.default.render(node.attrs.latex, innerWrapper);
+          import_katex.default.render(node.attrs.latex, innerWrapper, katexOptions);
           wrapper.classList.remove("block-math-error");
         } catch {
           wrapper.textContent = node.attrs.latex;
@@ -180,7 +190,8 @@ var InlineMath = import_core2.Node.create({
   atom: true,
   addOptions() {
     return {
-      onClick: void 0
+      onClick: void 0,
+      katexOptions: void 0
     };
   },
   addAttributes() {
@@ -198,17 +209,17 @@ var InlineMath = import_core2.Node.create({
   },
   addCommands() {
     return {
-      setInlineMath: (options) => ({ editor, tr }) => {
+      insertInlineMath: (options) => ({ editor, tr }) => {
         var _a;
-        const latex = options == null ? void 0 : options.latex;
-        const pos = (_a = options == null ? void 0 : options.pos) != null ? _a : editor.state.selection.$from.pos;
+        const latex = options.latex;
+        const from = (_a = options == null ? void 0 : options.pos) != null ? _a : editor.state.selection.from;
         if (!latex) {
           return false;
         }
-        tr.replaceWith(pos, pos, this.type.create({ latex }));
+        tr.replaceWith(from, from, this.type.create({ latex }));
         return true;
       },
-      unsetInlineMath: (options) => ({ editor, tr }) => {
+      deleteInlineMath: (options) => ({ editor, tr }) => {
         var _a;
         const pos = (_a = options == null ? void 0 : options.pos) != null ? _a : editor.state.selection.$from.pos;
         const node = editor.state.doc.nodeAt(pos);
@@ -258,14 +269,18 @@ var InlineMath = import_core2.Node.create({
     ];
   },
   addNodeView() {
+    const { katexOptions } = this.options;
     return ({ node, getPos }) => {
       const wrapper = document.createElement("span");
-      wrapper.className = "Tiptap-mathematics-render Tiptap-mathematics-render--editable";
+      wrapper.className = "tiptap-mathematics-render";
+      if (this.editor.isEditable) {
+        wrapper.classList.add("tiptap-mathematics-render--editable");
+      }
       wrapper.dataset.type = "inline-math";
       wrapper.setAttribute("data-latex", node.attrs.latex);
       function renderMath() {
         try {
-          import_katex2.default.render(node.attrs.latex, wrapper);
+          import_katex2.default.render(node.attrs.latex, wrapper, katexOptions);
           wrapper.classList.remove("inline-math-error");
         } catch {
           wrapper.textContent = node.attrs.latex;
@@ -298,7 +313,7 @@ var InlineMath = import_core2.Node.create({
 });
 
 // src/mathematics.ts
-var Math2 = import_core3.Extension.create({
+var Mathematics = import_core3.Extension.create({
   name: "Mathematics",
   addOptions() {
     return {
@@ -308,18 +323,60 @@ var Math2 = import_core3.Extension.create({
     };
   },
   addExtensions() {
-    return [BlockMath.configure(this.options.blockOptions), InlineMath.configure(this.options.inlineOptions)];
+    return [
+      BlockMath.configure({ ...this.options.blockOptions, katexOptions: this.options.katexOptions }),
+      InlineMath.configure({ ...this.options.inlineOptions, katexOptions: this.options.katexOptions })
+    ];
   }
 });
-var Mathematics = Math2;
+
+// src/utils.ts
+var mathMigrationRegex = /(?<!\d)\$(?!\$)(?:[^$\n]|\\\$)*?(?<!\\)\$(?!\d)/g;
+function createMathMigrateTransaction(editor, tr, regex = mathMigrationRegex) {
+  tr.doc.descendants((node, pos) => {
+    if (!node.isText || !node.text || !node.text.includes("$")) {
+      return;
+    }
+    const { text } = node;
+    const match = node.text.match(regex);
+    if (!match) {
+      return;
+    }
+    match.forEach((mathMatch) => {
+      const start = text.indexOf(mathMatch);
+      const end = start + mathMatch.length;
+      const from = tr.mapping.map(pos + start);
+      const $from = tr.doc.resolve(from);
+      const parent = $from.parent;
+      const index = $from.index();
+      const { inlineMath } = editor.schema.nodes;
+      if (!parent.canReplaceWith(index, index + 1, inlineMath)) {
+        return;
+      }
+      tr.replaceWith(
+        tr.mapping.map(pos + start),
+        tr.mapping.map(pos + end),
+        inlineMath.create({ latex: mathMatch.slice(1, -1) })
+      );
+    });
+  });
+  tr.setMeta("addToHistory", false);
+  return tr;
+}
+function migrateMathStrings(editor, regex = mathMigrationRegex) {
+  const tr = createMathMigrateTransaction(editor, editor.state.tr, regex);
+  editor.view.dispatch(tr);
+}
 
 // src/index.ts
-var index_default = Math2;
+var index_default = Mathematics;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BlockMath,
   InlineMath,
-  Math,
-  Mathematics
+  Mathematics,
+  createMathMigrateTransaction,
+  mathMigrationRegex,
+  migrateMathStrings
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/mathematics.ts","../src/extensions/BlockMath.ts","../src/extensions/InlineMath.ts"],"sourcesContent":["import { Math } from './mathematics.js'\n\nexport * from './extensions/index.js'\nexport * from './mathematics.js'\nexport * from './types.js'\n\nexport default Math\n","import { Extension } from '@tiptap/core'\n\nimport { BlockMath, InlineMath } from './extensions/index.js'\nimport type { MathematicsOptions } from './types.js'\n\nexport const Math = Extension.create<MathematicsOptions>({\n  name: 'Mathematics',\n\n  addOptions() {\n    return {\n      inlineOptions: undefined,\n      blockOptions: undefined,\n      katexOptions: undefined,\n    }\n  },\n\n  addExtensions() {\n    return [BlockMath.configure(this.options.blockOptions), InlineMath.configure(this.options.inlineOptions)]\n  },\n})\n\nexport const Mathematics = Math\n\nexport default Math\n","import { InputRule, mergeAttributes, Node } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport katex from 'katex'\n\nexport type BlockMathOptions = {\n  onClick?: (node: PMNode, pos: number) => void\n}\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    blockMath: {\n      /**\n       * Set block math node with LaTeX string.\n       * @param options - Options for setting block math.\n       * @returns ReturnType\n       */\n      setBlockMath: (options: { latex: string; pos?: number }) => ReturnType\n\n      /**\n       * Unset block math node.\n       * @returns ReturnType\n       */\n      unsetBlockMath: (options?: { pos?: number }) => ReturnType\n\n      /**\n       * Update block math node with optional LaTeX string.\n       * @param options - Options for updating block math.\n       * @returns ReturnType\n       */\n      updateBlockMath: (options?: { latex?: string; pos?: number }) => ReturnType\n    }\n  }\n}\n\n/**\n * BlockMath is a Tiptap extension for rendering block mathematical expressions using KaTeX.\n * It allows users to insert LaTeX formatted math expressions block within text.\n * It supports rendering, input rules for LaTeX syntax, and click handling for interaction.\n *\n * @example\n * ```javascript\n * import { BlockMath } from 'your-extension-path'\n * import { Editor } from '@tiptap/core'\n *\n * const editor = new Editor({\n *   extensions: [\n *     BlockMath.configure({\n *       onClick: (node, pos) => {\n *         console.log('Block math clicked:', node.attrs.latex, 'at position:', pos)\n *       },\n *     }),\n *   ],\n * })\n */\nexport const BlockMath = Node.create({\n  name: 'blockMath',\n\n  group: 'block',\n\n  atom: true,\n\n  addOptions() {\n    return {\n      onClick: undefined,\n    }\n  },\n\n  addAttributes() {\n    return {\n      latex: {\n        default: '',\n        parseHTML: element => element.getAttribute('data-latex'),\n        renderHTML: attributes => {\n          return {\n            'data-latex': attributes.latex,\n          }\n        },\n      },\n    }\n  },\n\n  addCommands() {\n    return {\n      setBlockMath:\n        options =>\n        ({ commands, editor }) => {\n          const { latex, pos } = options\n          return commands.insertContentAt(pos ?? editor.state.selection.from, {\n            type: this.name,\n            attrs: { latex },\n          })\n        },\n\n      unsetBlockMath:\n        options =>\n        ({ editor, tr }) => {\n          const pos = options?.pos ?? editor.state.selection.$from.pos\n          const node = editor.state.doc.nodeAt(pos)\n\n          if (!node || node.type.name !== this.name) {\n            return false\n          }\n\n          tr.delete(pos, pos + node.nodeSize)\n          return true\n        },\n\n      updateBlockMath:\n        options =>\n        ({ editor, tr }) => {\n          const latex = options?.latex\n          let pos = options?.pos\n\n          if (pos === undefined) {\n            pos = editor.state.selection.$from.pos\n          }\n\n          const node = editor.state.doc.nodeAt(pos)\n\n          if (!node || node.type.name !== this.name) {\n            return false\n          }\n\n          tr.setNodeMarkup(pos, this.type, {\n            ...node.attrs,\n            latex: latex || node.attrs.latex,\n          })\n\n          return true\n        },\n    }\n  },\n\n  parseHTML() {\n    return [\n      {\n        tag: 'div[data-type=\"block-math\"]',\n      },\n    ]\n  },\n\n  renderHTML({ HTMLAttributes }) {\n    return ['div', mergeAttributes(HTMLAttributes, { 'data-type': 'block-math' })]\n  },\n\n  addInputRules() {\n    return [\n      new InputRule({\n        find: /^\\$\\$\\$([^$]+)\\$\\$\\$$/,\n        handler: ({ state, range, match }) => {\n          const [, latex] = match\n          const { tr } = state\n          const start = range.from\n          const end = range.to\n\n          tr.replaceWith(start, end, this.type.create({ latex }))\n        },\n      }),\n    ]\n  },\n\n  addNodeView() {\n    return ({ node, getPos }) => {\n      const wrapper = document.createElement('div')\n      const innerWrapper = document.createElement('div')\n      wrapper.className = 'Tiptap-mathematics-render Tiptap-mathematics-render--editable'\n      innerWrapper.className = 'block-math-inner'\n      wrapper.dataset.type = 'block-math'\n      wrapper.setAttribute('data-latex', node.attrs.latex)\n      wrapper.appendChild(innerWrapper)\n\n      function renderMath() {\n        try {\n          katex.render(node.attrs.latex, innerWrapper)\n          wrapper.classList.remove('block-math-error')\n        } catch {\n          wrapper.textContent = node.attrs.latex\n          wrapper.classList.add('block-math-error')\n        }\n      }\n\n      const handleClick = (event: MouseEvent) => {\n        event.preventDefault()\n        event.stopPropagation()\n        const pos = getPos()\n\n        if (pos == null) {\n          return\n        }\n\n        if (this.options.onClick) {\n          this.options.onClick(node, pos)\n        }\n      }\n\n      if (this.options.onClick) {\n        wrapper.addEventListener('click', handleClick)\n      }\n\n      renderMath()\n\n      return {\n        dom: wrapper,\n        destroy() {\n          wrapper.removeEventListener('click', handleClick)\n        },\n      }\n    }\n  },\n})\n","import { InputRule, mergeAttributes, Node } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport katex from 'katex'\n\nexport type InlineMathOptions = {\n  onClick?: (node: PMNode, pos: number) => void\n}\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    inlineMath: {\n      /**\n       * Set inline math node with LaTeX string.\n       * @param options - Options for setting inline math.\n       * @returns ReturnType\n       */\n      setInlineMath: (options: { latex: string; pos?: number }) => ReturnType\n\n      /**\n       * Unset inline math node.\n       * @returns ReturnType\n       */\n      unsetInlineMath: (options?: { pos?: number }) => ReturnType\n\n      /**\n       * Update inline math node with optional LaTeX string.\n       * @param options - Options for updating inline math.\n       * @returns ReturnType\n       */\n      updateInlineMath: (options?: { latex?: string; pos?: number }) => ReturnType\n    }\n  }\n}\n\n/**\n * InlineMath is a Tiptap extension for rendering inline mathematical expressions using KaTeX.\n * It allows users to insert LaTeX formatted math expressions inline within text.\n * It supports rendering, input rules for LaTeX syntax, and click handling for interaction.\n *\n * @example\n * ```javascript\n * import { InlineMath } from 'your-extension-path'\n * import { Editor } from '@tiptap/core'\n *\n * const editor = new Editor({\n *   extensions: [\n *     InlineMath.configure({\n *       onClick: (node, pos) => {\n *         console.log('Inline math clicked:', node.attrs.latex, 'at position:', pos)\n *       },\n *     }),\n *   ],\n * })\n */\nexport const InlineMath = Node.create<InlineMathOptions>({\n  name: 'inlineMath',\n\n  group: 'inline',\n\n  inline: true,\n\n  atom: true,\n\n  addOptions() {\n    return {\n      onClick: undefined,\n    }\n  },\n\n  addAttributes() {\n    return {\n      latex: {\n        default: '',\n        parseHTML: element => element.getAttribute('data-latex'),\n        renderHTML: attributes => {\n          return {\n            'data-latex': attributes.latex,\n          }\n        },\n      },\n    }\n  },\n\n  addCommands() {\n    return {\n      setInlineMath:\n        options =>\n        ({ editor, tr }) => {\n          const latex = options?.latex\n          const pos = options?.pos ?? editor.state.selection.$from.pos\n\n          if (!latex) {\n            return false\n          }\n\n          tr.replaceWith(pos, pos, this.type.create({ latex }))\n          return true\n        },\n\n      unsetInlineMath:\n        options =>\n        ({ editor, tr }) => {\n          const pos = options?.pos ?? editor.state.selection.$from.pos\n          const node = editor.state.doc.nodeAt(pos)\n\n          if (!node || node.type.name !== this.name) {\n            return false\n          }\n\n          tr.delete(pos, pos + node.nodeSize)\n          return true\n        },\n\n      updateInlineMath:\n        options =>\n        ({ editor, tr }) => {\n          const latex = options?.latex\n          let pos = options?.pos\n\n          if (pos === undefined) {\n            pos = editor.state.selection.$from.pos\n          }\n\n          const node = editor.state.doc.nodeAt(pos)\n\n          if (!node || node.type.name !== this.name) {\n            return false\n          }\n\n          tr.setNodeMarkup(pos, this.type, { ...node.attrs, latex })\n\n          return true\n        },\n    }\n  },\n\n  parseHTML() {\n    return [\n      {\n        tag: 'span[data-type=\"inline-math\"]',\n      },\n    ]\n  },\n\n  renderHTML({ HTMLAttributes }) {\n    return ['span', mergeAttributes(HTMLAttributes, { 'data-type': 'inline-math' })]\n  },\n\n  addInputRules() {\n    return [\n      new InputRule({\n        find: /(?<!\\$)\\$\\$([^$\\n]+)\\$\\$(?!\\$)$/,\n        handler: ({ state, range, match }) => {\n          const [, latex] = match\n          const { tr } = state\n          const start = range.from\n          const end = range.to\n\n          tr.replaceWith(start, end, this.type.create({ latex }))\n        },\n      }),\n    ]\n  },\n\n  addNodeView() {\n    return ({ node, getPos }) => {\n      const wrapper = document.createElement('span')\n      wrapper.className = 'Tiptap-mathematics-render Tiptap-mathematics-render--editable'\n      wrapper.dataset.type = 'inline-math'\n      wrapper.setAttribute('data-latex', node.attrs.latex)\n\n      function renderMath() {\n        try {\n          katex.render(node.attrs.latex, wrapper)\n          wrapper.classList.remove('inline-math-error')\n        } catch {\n          wrapper.textContent = node.attrs.latex\n          wrapper.classList.add('inline-math-error')\n        }\n      }\n\n      const handleClick = (event: MouseEvent) => {\n        event.preventDefault()\n        event.stopPropagation()\n        const pos = getPos()\n\n        if (pos == null) {\n          return\n        }\n\n        if (this.options.onClick) {\n          this.options.onClick(node, pos)\n        }\n      }\n\n      if (this.options.onClick) {\n        wrapper.addEventListener('click', handleClick)\n      }\n\n      renderMath()\n\n      return {\n        dom: wrapper,\n        destroy() {\n          wrapper.removeEventListener('click', handleClick)\n        },\n      }\n    }\n  },\n})\n"],"mappings":"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","names":["Math","import_core","katex","import_core","import_katex","katex","Math","Math"]}
+{"version":3,"sources":["../src/index.ts","../src/mathematics.ts","../src/extensions/BlockMath.ts","../src/extensions/InlineMath.ts","../src/utils.ts"],"sourcesContent":["import { Mathematics } from './mathematics.js'\n\nexport * from './extensions/index.js'\nexport * from './mathematics.js'\nexport * from './types.js'\nexport * from './utils.js'\n\nexport default Mathematics\n","import { Extension } from '@tiptap/core'\n\nimport { BlockMath, InlineMath } from './extensions/index.js'\nimport type { MathematicsOptions } from './types.js'\n\n/**\n * Mathematics extension for Tiptap that provides both inline and block math support using KaTeX.\n * This extension combines the InlineMath and BlockMath extensions to provide a complete\n * mathematical expression solution for rich text editing. It supports LaTeX syntax,\n * custom rendering options, and interactive math nodes.\n *\n * @example\n * ```typescript\n * import { Editor } from '@tiptap/core'\n * import { Mathematics } from '@tiptap/extension-mathematics'\n * import { migrateMathStrings } from '@tiptap/extension-mathematics/utils'\n *\n * const editor = new Editor({\n *   extensions: [\n *     Mathematics.configure({\n *       inlineOptions: {\n *         onClick: (node, pos) => {\n *           console.log('Inline math clicked:', node.attrs.latex)\n *         }\n *       },\n *       blockOptions: {\n *         onClick: (node, pos) => {\n *           console.log('Block math clicked:', node.attrs.latex)\n *         }\n *       },\n *       katexOptions: {\n *         displayMode: false,\n *         throwOnError: false,\n *         macros: {\n *           '\\\\RR': '\\\\mathbb{R}',\n *           '\\\\ZZ': '\\\\mathbb{Z}'\n *         }\n *       }\n *     })\n *   ],\n *   content: `\n *     <p>Inline math: $E = mc^2$</p>\n *     <div data-type=\"block-math\" data-latex=\"\\\\sum_{i=1}^{n} x_i = X\"></div>\n *   `,\n *   onCreate({ editor }) {\n *     // Optional: Migrate existing math strings to math nodes\n *     migrateMathStrings(editor)\n *   }\n * })\n * ```\n */\nexport const Mathematics = Extension.create<MathematicsOptions>({\n  name: 'Mathematics',\n\n  addOptions() {\n    return {\n      inlineOptions: undefined,\n      blockOptions: undefined,\n      katexOptions: undefined,\n    }\n  },\n\n  addExtensions() {\n    return [\n      BlockMath.configure({ ...this.options.blockOptions, katexOptions: this.options.katexOptions }),\n      InlineMath.configure({ ...this.options.inlineOptions, katexOptions: this.options.katexOptions }),\n    ]\n  },\n})\n\nexport default Mathematics\n","import { InputRule, mergeAttributes, Node } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport katex, { type KatexOptions } from 'katex'\n\n/**\n * Configuration options for the BlockMath extension.\n */\nexport type BlockMathOptions = {\n  /**\n   * KaTeX specific options\n   * @see https://katex.org/docs/options.html\n   * @example\n   * ```ts\n   * katexOptions: {\n   *   displayMode: true,\n   *   throwOnError: false,\n   * },\n   */\n  katexOptions?: KatexOptions\n\n  /**\n   * Optional click handler for block math nodes.\n   * Called when a user clicks on a block math expression in the editor.\n   *\n   * @param node - The ProseMirror node representing the block math element\n   * @param pos - The position of the node within the document\n   * @example\n   * ```ts\n   * onClick: (node, pos) => {\n   *   console.log('Block math clicked:', node.attrs.latex, 'at position:', pos)\n   * },\n   * ```\n   */\n  onClick?: (node: PMNode, pos: number) => void\n}\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    insertBlockMath: {\n      /**\n       * Inserts a math block node with LaTeX string.\n       * @param options - Options for inserting block math.\n       * @returns ReturnType\n       */\n      insertBlockMath: (options: { latex: string; pos?: number }) => ReturnType\n\n      /**\n       * Deletes a block math node.\n       * @returns ReturnType\n       */\n      deleteBlockMath: (options?: { pos?: number }) => ReturnType\n\n      /**\n       * Update block math node with optional LaTeX string.\n       * @param options - Options for updating block math.\n       * @returns ReturnType\n       */\n      updateBlockMath: (options?: { latex: string; pos?: number }) => ReturnType\n    }\n  }\n}\n\n/**\n * BlockMath is a Tiptap extension for rendering block mathematical expressions using KaTeX.\n * It allows users to insert LaTeX formatted math expressions block within text.\n * It supports rendering, input rules for LaTeX syntax, and click handling for interaction.\n *\n * @example\n * ```javascript\n * import { BlockMath } from '@tiptap/extension-mathematics'\n * import { Editor } from '@tiptap/core'\n *\n * const editor = new Editor({\n *   extensions: [\n *     BlockMath.configure({\n *       onClick: (node, pos) => {\n *         console.log('Block math clicked:', node.attrs.latex, 'at position:', pos)\n *       },\n *     }),\n *   ],\n * })\n */\nexport const BlockMath = Node.create<BlockMathOptions>({\n  name: 'blockMath',\n\n  group: 'block',\n\n  atom: true,\n\n  addOptions() {\n    return {\n      onClick: undefined,\n      katexOptions: undefined,\n    }\n  },\n\n  addAttributes() {\n    return {\n      latex: {\n        default: '',\n        parseHTML: element => element.getAttribute('data-latex'),\n        renderHTML: attributes => {\n          return {\n            'data-latex': attributes.latex,\n          }\n        },\n      },\n    }\n  },\n\n  addCommands() {\n    return {\n      insertBlockMath:\n        options =>\n        ({ commands, editor }) => {\n          const { latex, pos } = options\n\n          if (!latex) {\n            return false\n          }\n\n          return commands.insertContentAt(pos ?? editor.state.selection.from, {\n            type: this.name,\n            attrs: { latex },\n          })\n        },\n\n      deleteBlockMath:\n        options =>\n        ({ editor, tr }) => {\n          const pos = options?.pos ?? editor.state.selection.$from.pos\n          const node = editor.state.doc.nodeAt(pos)\n\n          if (!node || node.type.name !== this.name) {\n            return false\n          }\n\n          tr.delete(pos, pos + node.nodeSize)\n          return true\n        },\n\n      updateBlockMath:\n        options =>\n        ({ editor, tr }) => {\n          const latex = options?.latex\n          let pos = options?.pos\n\n          if (pos === undefined) {\n            pos = editor.state.selection.$from.pos\n          }\n\n          const node = editor.state.doc.nodeAt(pos)\n\n          if (!node || node.type.name !== this.name) {\n            return false\n          }\n\n          tr.setNodeMarkup(pos, this.type, {\n            ...node.attrs,\n            latex: latex || node.attrs.latex,\n          })\n\n          return true\n        },\n    }\n  },\n\n  parseHTML() {\n    return [\n      {\n        tag: 'div[data-type=\"block-math\"]',\n      },\n    ]\n  },\n\n  renderHTML({ HTMLAttributes }) {\n    return ['div', mergeAttributes(HTMLAttributes, { 'data-type': 'block-math' })]\n  },\n\n  addInputRules() {\n    return [\n      new InputRule({\n        find: /^\\$\\$\\$([^$]+)\\$\\$\\$$/,\n        handler: ({ state, range, match }) => {\n          const [, latex] = match\n          const { tr } = state\n          const start = range.from\n          const end = range.to\n\n          tr.replaceWith(start, end, this.type.create({ latex }))\n        },\n      }),\n    ]\n  },\n\n  addNodeView() {\n    const { katexOptions } = this.options\n\n    return ({ node, getPos }) => {\n      const wrapper = document.createElement('div')\n      const innerWrapper = document.createElement('div')\n      wrapper.className = 'tiptap-mathematics-render'\n\n      if (this.editor.isEditable) {\n        wrapper.classList.add('tiptap-mathematics-render--editable')\n      }\n\n      innerWrapper.className = 'block-math-inner'\n      wrapper.dataset.type = 'block-math'\n      wrapper.setAttribute('data-latex', node.attrs.latex)\n      wrapper.appendChild(innerWrapper)\n\n      function renderMath() {\n        try {\n          katex.render(node.attrs.latex, innerWrapper, katexOptions)\n          wrapper.classList.remove('block-math-error')\n        } catch {\n          wrapper.textContent = node.attrs.latex\n          wrapper.classList.add('block-math-error')\n        }\n      }\n\n      const handleClick = (event: MouseEvent) => {\n        event.preventDefault()\n        event.stopPropagation()\n        const pos = getPos()\n\n        if (pos == null) {\n          return\n        }\n\n        if (this.options.onClick) {\n          this.options.onClick(node, pos)\n        }\n      }\n\n      if (this.options.onClick) {\n        wrapper.addEventListener('click', handleClick)\n      }\n\n      renderMath()\n\n      return {\n        dom: wrapper,\n        destroy() {\n          wrapper.removeEventListener('click', handleClick)\n        },\n      }\n    }\n  },\n})\n","import { InputRule, mergeAttributes, Node } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport katex, { type KatexOptions } from 'katex'\n\n/**\n * Configuration options for the InlineMath extension.\n */\nexport type InlineMathOptions = {\n  /**\n   * KaTeX specific options\n   * @see https://katex.org/docs/options.html\n   * @example\n   * ```ts\n   * katexOptions: {\n   *   displayMode: false,\n   *   throwOnError: false,\n   *   macros: {\n   *     '\\\\RR': '\\\\mathbb{R}',\n   *     '\\\\ZZ': '\\\\mathbb{Z}'\n   *   }\n   * }\n   * ```\n   */\n  katexOptions?: KatexOptions\n\n  /**\n   * Optional click handler for inline math nodes.\n   * Called when a user clicks on an inline math expression in the editor.\n   *\n   * @param node - The ProseMirror node representing the inline math element\n   * @param pos - The position of the node within the document\n   * @example\n   * ```ts\n   * onClick: (node, pos) => {\n   *   console.log('Inline math clicked:', node.attrs.latex, 'at position:', pos)\n   * }\n   * ```\n   */\n  onClick?: (node: PMNode, pos: number) => void\n}\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    inlineMath: {\n      /**\n       * Insert a inline math node with LaTeX string.\n       * @param options - Options for inserting inline math.\n       * @returns ReturnType\n       */\n      insertInlineMath: (options: { latex: string; pos?: number }) => ReturnType\n\n      /**\n       * Delete an inline math node.\n       * @returns ReturnType\n       */\n      deleteInlineMath: (options?: { pos?: number }) => ReturnType\n\n      /**\n       * Update inline math node with optional LaTeX string.\n       * @param options - Options for updating inline math.\n       * @returns ReturnType\n       */\n      updateInlineMath: (options?: { latex?: string; pos?: number }) => ReturnType\n    }\n  }\n}\n\n/**\n * InlineMath is a Tiptap extension for rendering inline mathematical expressions using KaTeX.\n * It allows users to insert LaTeX formatted math expressions inline within text.\n * It supports rendering, input rules for LaTeX syntax, and click handling for interaction.\n *\n * @example\n * ```javascript\n * import { InlineMath } from '@tiptap/extension-mathematics'\n * import { Editor } from '@tiptap/core'\n *\n * const editor = new Editor({\n *   extensions: [\n *     InlineMath.configure({\n *       onClick: (node, pos) => {\n *         console.log('Inline math clicked:', node.attrs.latex, 'at position:', pos)\n *       },\n *     }),\n *   ],\n * })\n */\nexport const InlineMath = Node.create<InlineMathOptions>({\n  name: 'inlineMath',\n\n  group: 'inline',\n\n  inline: true,\n\n  atom: true,\n\n  addOptions() {\n    return {\n      onClick: undefined,\n      katexOptions: undefined,\n    }\n  },\n\n  addAttributes() {\n    return {\n      latex: {\n        default: '',\n        parseHTML: element => element.getAttribute('data-latex'),\n        renderHTML: attributes => {\n          return {\n            'data-latex': attributes.latex,\n          }\n        },\n      },\n    }\n  },\n\n  addCommands() {\n    return {\n      insertInlineMath:\n        options =>\n        ({ editor, tr }) => {\n          const latex = options.latex\n\n          const from = options?.pos ?? editor.state.selection.from\n\n          if (!latex) {\n            return false\n          }\n\n          tr.replaceWith(from, from, this.type.create({ latex }))\n          return true\n        },\n\n      deleteInlineMath:\n        options =>\n        ({ editor, tr }) => {\n          const pos = options?.pos ?? editor.state.selection.$from.pos\n          const node = editor.state.doc.nodeAt(pos)\n\n          if (!node || node.type.name !== this.name) {\n            return false\n          }\n\n          tr.delete(pos, pos + node.nodeSize)\n          return true\n        },\n\n      updateInlineMath:\n        options =>\n        ({ editor, tr }) => {\n          const latex = options?.latex\n          let pos = options?.pos\n\n          if (pos === undefined) {\n            pos = editor.state.selection.$from.pos\n          }\n\n          const node = editor.state.doc.nodeAt(pos)\n\n          if (!node || node.type.name !== this.name) {\n            return false\n          }\n\n          tr.setNodeMarkup(pos, this.type, { ...node.attrs, latex })\n\n          return true\n        },\n    }\n  },\n\n  parseHTML() {\n    return [\n      {\n        tag: 'span[data-type=\"inline-math\"]',\n      },\n    ]\n  },\n\n  renderHTML({ HTMLAttributes }) {\n    return ['span', mergeAttributes(HTMLAttributes, { 'data-type': 'inline-math' })]\n  },\n\n  addInputRules() {\n    return [\n      new InputRule({\n        find: /(?<!\\$)\\$\\$([^$\\n]+)\\$\\$(?!\\$)$/,\n        handler: ({ state, range, match }) => {\n          const [, latex] = match\n          const { tr } = state\n          const start = range.from\n          const end = range.to\n\n          tr.replaceWith(start, end, this.type.create({ latex }))\n        },\n      }),\n    ]\n  },\n\n  addNodeView() {\n    const { katexOptions } = this.options\n\n    return ({ node, getPos }) => {\n      const wrapper = document.createElement('span')\n      wrapper.className = 'tiptap-mathematics-render'\n\n      if (this.editor.isEditable) {\n        wrapper.classList.add('tiptap-mathematics-render--editable')\n      }\n\n      wrapper.dataset.type = 'inline-math'\n      wrapper.setAttribute('data-latex', node.attrs.latex)\n\n      function renderMath() {\n        try {\n          katex.render(node.attrs.latex, wrapper, katexOptions)\n          wrapper.classList.remove('inline-math-error')\n        } catch {\n          wrapper.textContent = node.attrs.latex\n          wrapper.classList.add('inline-math-error')\n        }\n      }\n\n      const handleClick = (event: MouseEvent) => {\n        event.preventDefault()\n        event.stopPropagation()\n        const pos = getPos()\n\n        if (pos == null) {\n          return\n        }\n\n        if (this.options.onClick) {\n          this.options.onClick(node, pos)\n        }\n      }\n\n      if (this.options.onClick) {\n        wrapper.addEventListener('click', handleClick)\n      }\n\n      renderMath()\n\n      return {\n        dom: wrapper,\n        destroy() {\n          wrapper.removeEventListener('click', handleClick)\n        },\n      }\n    }\n  },\n})\n","import type { Editor } from '@tiptap/core'\nimport type { Transaction } from '@tiptap/pm/state'\n\n/**\n * Regular expression to match LaTeX math strings wrapped in single dollar signs.\n * This should not catch dollar signs which are not part of a math expression,\n * like those used for currency or other purposes.\n * It ensures that the dollar signs are not preceded or followed by digits,\n * allowing for proper identification of inline math expressions.\n *\n * - `$x^2 + y^2 = z^2$` will match\n * - `This is $inline math$ in text.` will match\n * - `This is $100$ dollars.` will not match (as it is not a math expression)\n * - `This is $x^2 + y^2 = z^2$ and $100$ dollars.` will match both math expressions\n */\nexport const mathMigrationRegex = /(?<!\\d)\\$(?!\\$)(?:[^$\\n]|\\\\\\$)*?(?<!\\\\)\\$(?!\\d)/g\n\n/**\n * Creates a transaction that migrates existing math strings in the document to new math nodes.\n * This function traverses the document and replaces LaTeX math syntax (wrapped in single dollar signs)\n * with proper inline math nodes, preserving the mathematical content.\n *\n * @param editor - The editor instance containing the schema and configuration\n * @param tr - The transaction to modify with the migration operations\n * @returns The modified transaction with math string replacements\n *\n * @example\n * ```typescript\n * const editor = new Editor({ ... })\n * const tr = editor.state.tr\n * const updatedTr = createMathMigrateTransaction(editor, tr)\n * editor.view.dispatch(updatedTr)\n * ```\n */\nexport function createMathMigrateTransaction(editor: Editor, tr: Transaction, regex: RegExp = mathMigrationRegex) {\n  // we traverse the document and replace all math nodes with the new math nodes\n  tr.doc.descendants((node, pos) => {\n    if (!node.isText || !node.text || !node.text.includes('$')) {\n      return\n    }\n\n    const { text } = node\n\n    const match = node.text.match(regex)\n    if (!match) {\n      return\n    }\n\n    match.forEach(mathMatch => {\n      const start = text.indexOf(mathMatch)\n      const end = start + mathMatch.length\n\n      const from = tr.mapping.map(pos + start)\n\n      const $from = tr.doc.resolve(from)\n      const parent = $from.parent\n      const index = $from.index()\n\n      const { inlineMath } = editor.schema.nodes\n\n      if (!parent.canReplaceWith(index, index + 1, inlineMath)) {\n        return\n      }\n\n      // Replace the math syntax with a new math node\n      tr.replaceWith(\n        tr.mapping.map(pos + start),\n        tr.mapping.map(pos + end),\n        inlineMath.create({ latex: mathMatch.slice(1, -1) }),\n      )\n    })\n  })\n\n  // don't add to history\n  tr.setMeta('addToHistory', false)\n  return tr\n}\n\n/**\n * Migrates existing math strings in the editor document to math nodes.\n * This function creates and dispatches a transaction that converts LaTeX math syntax\n * (text wrapped in single dollar signs) into proper inline math nodes. The migration\n * happens immediately and is not added to the editor's history.\n *\n * @param editor - The editor instance to perform the migration on\n *\n * @example\n * ```typescript\n * const editor = new Editor({\n *   extensions: [Mathematics],\n *   content: 'This is inline math: $x^2 + y^2 = z^2$ in text.'\n * })\n *\n * // Math strings will be automatically migrated to math nodes\n * migrateMathStrings(editor)\n * ```\n */\nexport function migrateMathStrings(editor: Editor, regex: RegExp = mathMigrationRegex) {\n  const tr = createMathMigrateTransaction(editor, editor.state.tr, regex)\n  editor.view.dispatch(tr)\n}\n"],"mappings":"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","names":["import_core","katex","import_core","import_katex","katex"]}

package/dist/index.d.cts

@@ -1,27 +1,55 @@
 import { Node as Node$1, Editor, Extension } from '@tiptap/core';
 import { KatexOptions } from 'katex';
 import { Node } from '@tiptap/pm/model';
+import { Transaction } from '@tiptap/pm/state';
 
+/**
+ * Configuration options for the BlockMath extension.
+ */
 type BlockMathOptions = {
+    /**
+     * KaTeX specific options
+     * @see https://katex.org/docs/options.html
+     * @example
+     * ```ts
+     * katexOptions: {
+     *   displayMode: true,
+     *   throwOnError: false,
+     * },
+     */
+    katexOptions?: KatexOptions;
+    /**
+     * Optional click handler for block math nodes.
+     * Called when a user clicks on a block math expression in the editor.
+     *
+     * @param node - The ProseMirror node representing the block math element
+     * @param pos - The position of the node within the document
+     * @example
+     * ```ts
+     * onClick: (node, pos) => {
+     *   console.log('Block math clicked:', node.attrs.latex, 'at position:', pos)
+     * },
+     * ```
+     */
     onClick?: (node: Node, pos: number) => void;
 };
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
-        blockMath: {
+        insertBlockMath: {
             /**
-             * Set block math node with LaTeX string.
-             * @param options - Options for setting block math.
+             * Inserts a math block node with LaTeX string.
+             * @param options - Options for inserting block math.
              * @returns ReturnType
              */
-            setBlockMath: (options: {
+            insertBlockMath: (options: {
                 latex: string;
                 pos?: number;
             }) => ReturnType;
             /**
-             * Unset block math node.
+             * Deletes a block math node.
              * @returns ReturnType
              */
-            unsetBlockMath: (options?: {
+            deleteBlockMath: (options?: {
                 pos?: number;
             }) => ReturnType;
             /**
@@ -30,7 +58,7 @@ declare module '@tiptap/core' {
              * @returns ReturnType
              */
             updateBlockMath: (options?: {
-                latex?: string;
+                latex: string;
                 pos?: number;
             }) => ReturnType;
         };
@@ -43,7 +71,7 @@ declare module '@tiptap/core' {
  *
  * @example
  * ```javascript
- * import { BlockMath } from 'your-extension-path'
+ * import { BlockMath } from '@tiptap/extension-mathematics'
  * import { Editor } from '@tiptap/core'
  *
  * const editor = new Editor({
@@ -56,28 +84,60 @@ declare module '@tiptap/core' {
  *   ],
  * })
  */
-declare const BlockMath: Node$1<any, any>;
+declare const BlockMath: Node$1<BlockMathOptions, any>;
 
+/**
+ * Configuration options for the InlineMath extension.
+ */
 type InlineMathOptions = {
+    /**
+     * KaTeX specific options
+     * @see https://katex.org/docs/options.html
+     * @example
+     * ```ts
+     * katexOptions: {
+     *   displayMode: false,
+     *   throwOnError: false,
+     *   macros: {
+     *     '\\RR': '\\mathbb{R}',
+     *     '\\ZZ': '\\mathbb{Z}'
+     *   }
+     * }
+     * ```
+     */
+    katexOptions?: KatexOptions;
+    /**
+     * Optional click handler for inline math nodes.
+     * Called when a user clicks on an inline math expression in the editor.
+     *
+     * @param node - The ProseMirror node representing the inline math element
+     * @param pos - The position of the node within the document
+     * @example
+     * ```ts
+     * onClick: (node, pos) => {
+     *   console.log('Inline math clicked:', node.attrs.latex, 'at position:', pos)
+     * }
+     * ```
+     */
     onClick?: (node: Node, pos: number) => void;
 };
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
         inlineMath: {
             /**
-             * Set inline math node with LaTeX string.
-             * @param options - Options for setting inline math.
+             * Insert a inline math node with LaTeX string.
+             * @param options - Options for inserting inline math.
              * @returns ReturnType
              */
-            setInlineMath: (options: {
+            insertInlineMath: (options: {
                 latex: string;
                 pos?: number;
             }) => ReturnType;
             /**
-             * Unset inline math node.
+             * Delete an inline math node.
              * @returns ReturnType
              */
-            unsetInlineMath: (options?: {
+            deleteInlineMath: (options?: {
                 pos?: number;
             }) => ReturnType;
             /**
@@ -99,7 +159,7 @@ declare module '@tiptap/core' {
  *
  * @example
  * ```javascript
- * import { InlineMath } from 'your-extension-path'
+ * import { InlineMath } from '@tiptap/extension-mathematics'
  * import { Editor } from '@tiptap/core'
  *
  * const editor = new Editor({
@@ -114,16 +174,125 @@ declare module '@tiptap/core' {
  */
 declare const InlineMath: Node$1<InlineMathOptions, any>;
 
+/**
+ * Configuration options for the Mathematics extension.
+ * This type defines the available customization options for both inline and block math rendering.
+ */
 type MathematicsOptions = {
-    inlineOptions?: InlineMathOptions;
-    blockOptions?: BlockMathOptions;
+    /** Configuration options specific to inline math nodes */
+    inlineOptions?: Omit<InlineMathOptions, 'katexOptions'>;
+    /** Configuration options specific to block math nodes */
+    blockOptions?: Omit<BlockMathOptions, 'katexOptions'>;
+    /** KaTeX-specific rendering options passed to the KaTeX library */
     katexOptions?: KatexOptions;
 };
+/**
+ * Extended mathematics options that include an editor instance.
+ * This type combines the base mathematics options with an editor reference,
+ * typically used internally by the extension for operations that require editor access.
+ */
 type MathematicsOptionsWithEditor = MathematicsOptions & {
     editor: Editor;
 };
 
-declare const Math: Extension<MathematicsOptions, any>;
+/**
+ * Mathematics extension for Tiptap that provides both inline and block math support using KaTeX.
+ * This extension combines the InlineMath and BlockMath extensions to provide a complete
+ * mathematical expression solution for rich text editing. It supports LaTeX syntax,
+ * custom rendering options, and interactive math nodes.
+ *
+ * @example
+ * ```typescript
+ * import { Editor } from '@tiptap/core'
+ * import { Mathematics } from '@tiptap/extension-mathematics'
+ * import { migrateMathStrings } from '@tiptap/extension-mathematics/utils'
+ *
+ * const editor = new Editor({
+ *   extensions: [
+ *     Mathematics.configure({
+ *       inlineOptions: {
+ *         onClick: (node, pos) => {
+ *           console.log('Inline math clicked:', node.attrs.latex)
+ *         }
+ *       },
+ *       blockOptions: {
+ *         onClick: (node, pos) => {
+ *           console.log('Block math clicked:', node.attrs.latex)
+ *         }
+ *       },
+ *       katexOptions: {
+ *         displayMode: false,
+ *         throwOnError: false,
+ *         macros: {
+ *           '\\RR': '\\mathbb{R}',
+ *           '\\ZZ': '\\mathbb{Z}'
+ *         }
+ *       }
+ *     })
+ *   ],
+ *   content: `
+ *     <p>Inline math: $E = mc^2$</p>
+ *     <div data-type="block-math" data-latex="\\sum_{i=1}^{n} x_i = X"></div>
+ *   `,
+ *   onCreate({ editor }) {
+ *     // Optional: Migrate existing math strings to math nodes
+ *     migrateMathStrings(editor)
+ *   }
+ * })
+ * ```
+ */
 declare const Mathematics: Extension<MathematicsOptions, any>;
 
-export { BlockMath, type BlockMathOptions, InlineMath, type InlineMathOptions, Math, Mathematics, type MathematicsOptions, type MathematicsOptionsWithEditor, Math as default };
+/**
+ * Regular expression to match LaTeX math strings wrapped in single dollar signs.
+ * This should not catch dollar signs which are not part of a math expression,
+ * like those used for currency or other purposes.
+ * It ensures that the dollar signs are not preceded or followed by digits,
+ * allowing for proper identification of inline math expressions.
+ *
+ * - `$x^2 + y^2 = z^2$` will match
+ * - `This is $inline math$ in text.` will match
+ * - `This is $100$ dollars.` will not match (as it is not a math expression)
+ * - `This is $x^2 + y^2 = z^2$ and $100$ dollars.` will match both math expressions
+ */
+declare const mathMigrationRegex: RegExp;
+/**
+ * Creates a transaction that migrates existing math strings in the document to new math nodes.
+ * This function traverses the document and replaces LaTeX math syntax (wrapped in single dollar signs)
+ * with proper inline math nodes, preserving the mathematical content.
+ *
+ * @param editor - The editor instance containing the schema and configuration
+ * @param tr - The transaction to modify with the migration operations
+ * @returns The modified transaction with math string replacements
+ *
+ * @example
+ * ```typescript
+ * const editor = new Editor({ ... })
+ * const tr = editor.state.tr
+ * const updatedTr = createMathMigrateTransaction(editor, tr)
+ * editor.view.dispatch(updatedTr)
+ * ```
+ */
+declare function createMathMigrateTransaction(editor: Editor, tr: Transaction, regex?: RegExp): Transaction;
+/**
+ * Migrates existing math strings in the editor document to math nodes.
+ * This function creates and dispatches a transaction that converts LaTeX math syntax
+ * (text wrapped in single dollar signs) into proper inline math nodes. The migration
+ * happens immediately and is not added to the editor's history.
+ *
+ * @param editor - The editor instance to perform the migration on
+ *
+ * @example
+ * ```typescript
+ * const editor = new Editor({
+ *   extensions: [Mathematics],
+ *   content: 'This is inline math: $x^2 + y^2 = z^2$ in text.'
+ * })
+ *
+ * // Math strings will be automatically migrated to math nodes
+ * migrateMathStrings(editor)
+ * ```
+ */
+declare function migrateMathStrings(editor: Editor, regex?: RegExp): void;
+
+export { BlockMath, type BlockMathOptions, InlineMath, type InlineMathOptions, Mathematics, type MathematicsOptions, type MathematicsOptionsWithEditor, createMathMigrateTransaction, Mathematics as default, mathMigrationRegex, migrateMathStrings };