@ctzhian/tiptap 1.5.2 → 1.5.4

package/dist/extension/node/Table.js

@@ -0,0 +1,283 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+// @ts-nocheck
+
+import { Extension } from '@tiptap/core';
+import { Table, TableCell, TableHeader, TableRow } from '@tiptap/extension-table';
+import { Plugin, TextSelection } from '@tiptap/pm/state';
+import { Decoration, DecorationSet } from '@tiptap/pm/view';
+import { createTableContextMenuPlugin } from "../component/Table";
+export var TableExtension = function TableExtension(_ref) {
+  var editable = _ref.editable;
+  return [Table.extend({
+    addCommands: function addCommands() {
+      var _this$parent;
+      return _objectSpread(_objectSpread({}, (_this$parent = this.parent) === null || _this$parent === void 0 ? void 0 : _this$parent.call(this)), {}, {
+        cancelSelection: function cancelSelection() {
+          return function (_ref2) {
+            var state = _ref2.state,
+              dispatch = _ref2.dispatch;
+            if (dispatch) {
+              var selection = state.selection;
+              var $from = selection.$from;
+
+              // 找到当前单元格的起始和结束位置
+              var cellStart = $from.pos;
+              var cellEnd = $from.pos;
+              var depth = $from.depth;
+
+              // 向上查找直到找到表格单元格
+              while (depth > 0) {
+                var node = $from.node(depth);
+                if (node.type.name === 'tableCell' || node.type.name === 'tableHeader') {
+                  cellStart = $from.start(depth);
+                  cellEnd = $from.end(depth);
+                  break;
+                }
+                depth--;
+              }
+
+              // 设置选区为单元格的最后位置（不选中文本）
+              var newSelection = TextSelection.create(state.doc, cellEnd - 1);
+              dispatch(state.tr.setSelection(newSelection));
+            }
+            return true;
+          };
+        }
+      });
+    },
+    addKeyboardShortcuts: function addKeyboardShortcuts() {
+      var _this = this;
+      return {
+        'Mod-9': function Mod9() {
+          return _this.editor.commands.insertTable({
+            rows: 3,
+            cols: 4,
+            withHeaderRow: true
+          });
+        }
+      };
+    },
+    renderHTML: function renderHTML(_ref3) {
+      var _this$parent2;
+      var node = _ref3.node,
+        HTMLAttributes = _ref3.HTMLAttributes;
+      var originalRender = (_this$parent2 = this.parent) === null || _this$parent2 === void 0 ? void 0 : _this$parent2.call(this, {
+        node: node,
+        HTMLAttributes: HTMLAttributes
+      });
+      var wrapper = ['div', {
+        class: 'tableWrapper'
+      }, originalRender];
+      return wrapper;
+    }
+  }).configure({
+    handleWidth: 5,
+    cellMinWidth: 100,
+    resizable: editable,
+    lastColumnResizable: editable,
+    allowTableNodeSelection: editable
+  }), TableHeader.configure({
+    HTMLAttributes: {
+      class: 'table-header'
+    }
+  }), TableRow.configure({
+    HTMLAttributes: {
+      class: 'table-row'
+    }
+  }), TableCell.extend({
+    addAttributes: function addAttributes() {
+      var _this$parent3;
+      return _objectSpread(_objectSpread({}, (_this$parent3 = this.parent) === null || _this$parent3 === void 0 ? void 0 : _this$parent3.call(this)), {}, {
+        bgcolor: {
+          default: 'transparent',
+          parseHTML: function parseHTML(element) {
+            return element.getAttribute('data-background-color') || element.style.backgroundColor;
+          },
+          renderHTML: function renderHTML(attributes) {
+            return {
+              'data-background-color': attributes.bgcolor,
+              style: "background-color: ".concat(attributes.bgcolor)
+            };
+          }
+        },
+        textAlign: {
+          default: null,
+          parseHTML: function parseHTML(element) {
+            return element.getAttribute('data-text-align') || element.style.textAlign;
+          },
+          renderHTML: function renderHTML(attributes) {
+            if (!attributes.textAlign) return {};
+            return {
+              style: "text-align: ".concat(attributes.textAlign),
+              'data-text-align': attributes.textAlign
+            };
+          }
+        },
+        fontSize: {
+          default: null,
+          parseHTML: function parseHTML(element) {
+            return element.getAttribute('data-font-size') || element.style.fontSize;
+          },
+          renderHTML: function renderHTML(attributes) {
+            if (!attributes.fontSize) return {};
+            return {
+              style: "font-size: ".concat(attributes.fontSize),
+              'data-font-size': attributes.fontSize
+            };
+          }
+        },
+        fontWeight: {
+          default: null,
+          parseHTML: function parseHTML(element) {
+            return element.getAttribute('data-font-weight') || element.style.fontWeight;
+          },
+          renderHTML: function renderHTML(attributes) {
+            if (!attributes.fontWeight) return {};
+            return {
+              style: "font-weight: ".concat(attributes.fontWeight),
+              'data-font-weight': attributes.fontWeight
+            };
+          }
+        }
+      });
+    },
+    addKeyboardShortcuts: function addKeyboardShortcuts() {
+      var _this2 = this;
+      return {
+        Tab: function Tab() {
+          if (_this2.editor.commands.goToNextCell()) {
+            return _this2.editor.chain().cancelSelection().run();
+          } else if (!_this2.editor.can().addRowAfter()) {
+            return false;
+          } else {
+            return _this2.editor.chain().addRowAfter().goToNextCell().cancelSelection().run();
+          }
+        },
+        'Shift-Tab': function ShiftTab() {
+          return _this2.editor.chain().goToPreviousCell().cancelSelection().run();
+        }
+      };
+    }
+  }),
+  // 表格右键菜单插件
+  Extension.create({
+    name: 'tableContextMenu',
+    addProseMirrorPlugins: function addProseMirrorPlugins() {
+      return editable ? [createTableContextMenuPlugin(this.editor)] : [];
+    }
+  }),
+  // 选中表格时为 table 添加聚焦样式类名
+  Extension.create({
+    name: 'tableActiveClass',
+    addProseMirrorPlugins: function addProseMirrorPlugins() {
+      if (!editable) return [];
+      return [new Plugin({
+        props: {
+          decorations: function decorations(state) {
+            var selection = state.selection,
+              doc = state.doc;
+            var $from = selection.$from;
+            // 如果当前不在表格内，移除装饰
+            // 通过向上寻找最近的 table 节点
+            for (var depth = $from.depth; depth > 0; depth--) {
+              var node = $from.node(depth);
+              if (node.type.name === 'table') {
+                var from = $from.before(depth);
+                var to = $from.after(depth);
+                var deco = Decoration.node(from, to, {
+                  class: 'table-focus'
+                });
+                return DecorationSet.create(doc, [deco]);
+              }
+            }
+            return null;
+          }
+        }
+      })];
+    }
+  }),
+  // Safari 中文输入 deleteCompositionText 修复
+  Extension.create({
+    name: 'safariCompositionDeleteFix',
+    addProseMirrorPlugins: function addProseMirrorPlugins() {
+      if (!editable) return [];
+      var ZERO_WIDTH_SPACE = "\u200B";
+      var isSafari = function () {
+        if (typeof navigator === 'undefined') return false;
+        var ua = navigator.userAgent;
+        var isAppleMobile = /iP(ad|hone|od)/.test(ua);
+        var isMacSafari = /Safari\//.test(ua) && !/Chrome\//.test(ua);
+        return isAppleMobile || isMacSafari;
+      }();
+      if (!isSafari) return [];
+
+      // 注意：这里不能使用上面从 ProseMirror 导入的 Node 类型，需判断 DOM 文本节点
+      var isTextNode = function isTextNode(node) {
+        return !!node && node.nodeType === 3;
+      };
+      return [new Plugin({
+        props: {
+          handleDOMEvents: {
+            beforeinput: function beforeinput(_view, event) {
+              // 仅处理 Safari 在中文合成结束后触发的删除合成文本行为
+              if (event.inputType !== 'deleteCompositionText') {
+                return false;
+              }
+              var selection = window.getSelection();
+              if (!selection || selection.rangeCount === 0) return false;
+              var range = selection.getRangeAt(0);
+              var startContainer = range.startContainer,
+                endContainer = range.endContainer,
+                startOffset = range.startOffset,
+                endOffset = range.endOffset;
+              if (isTextNode(startContainer) && startContainer === endContainer && startOffset === 0 && endOffset === startContainer.length) {
+                var _startContainer$paren;
+                (_startContainer$paren = startContainer.parentElement) === null || _startContainer$paren === void 0 || _startContainer$paren.insertBefore(document.createTextNode(ZERO_WIDTH_SPACE), startContainer);
+              }
+              // 让 ProseMirror 照常处理
+              return false;
+            },
+            input: function input(_view, event) {
+              if (event.inputType !== 'deleteCompositionText') {
+                return false;
+              }
+              var selection = window.getSelection();
+              if (!selection || selection.rangeCount === 0) return false;
+              var range = selection.getRangeAt(0);
+              var node = range.startContainer;
+              var parentEl = (node === null || node === void 0 ? void 0 : node.parentElement) || null;
+              if (!parentEl) return false;
+              var textNodes = Array.from(parentEl.childNodes).filter(isTextNode);
+              var _iterator = _createForOfIteratorHelper(textNodes),
+                _step;
+              try {
+                for (_iterator.s(); !(_step = _iterator.n()).done;) {
+                  var textNode = _step.value;
+                  if (textNode.textContent === ZERO_WIDTH_SPACE) {
+                    textNode.remove();
+                  } else if (textNode.textContent && textNode.textContent.includes(ZERO_WIDTH_SPACE)) {
+                    textNode.textContent = textNode.textContent.split(ZERO_WIDTH_SPACE).join('');
+                  }
+                }
+              } catch (err) {
+                _iterator.e(err);
+              } finally {
+                _iterator.f();
+              }
+              return false;
+            }
+          }
+        }
+      })];
+    }
+  })];
+};
+export default TableExtension;

package/dist/extension/node/TableOfContents/index.d.ts

@@ -0,0 +1,9 @@
+import { Extension } from '@tiptap/core';
+import { TocList } from "../../../type";
+import type { TableOfContentsOptions, TableOfContentsStorage } from './type';
+export * from './type';
+export declare const TableOfContentsExtension: Extension<TableOfContentsOptions, TableOfContentsStorage>;
+export declare const TableOfContents: ({ onTocUpdate }: {
+    onTocUpdate?: ((toc: TocList) => void) | undefined;
+}) => Extension<TableOfContentsOptions, TableOfContentsStorage>;
+export default TableOfContents;

package/dist/extension/node/TableOfContents/index.js

@@ -0,0 +1,391 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { Extension } from '@tiptap/core';
+import { v4 as uuidv4 } from 'uuid';
+import { TableOfContentsPlugin } from "./plugin";
+import { getHeadlineLevel, getHierarchicalIndexes, getLinearIndexes } from "./utils";
+export * from "./type";
+
+// 全局组合状态管理，避免在 IME 组合期间触发 TOC 更新
+var globalCompositionState = false;
+var globalCompositionEndTimer = null;
+var globalInputTimer = null;
+var lastInputTime = 0;
+
+// 全局监听组合状态和输入事件
+if (typeof document !== 'undefined') {
+  document.addEventListener('compositionstart', function () {
+    globalCompositionState = true;
+  }, {
+    passive: true
+  });
+  document.addEventListener('compositionend', function () {
+    globalCompositionState = false;
+    // 组合结束后，延迟刷新所有 TOC 实例
+    if (globalCompositionEndTimer) {
+      clearTimeout(globalCompositionEndTimer);
+    }
+    globalCompositionEndTimer = setTimeout(function () {
+      // 这里会通过 editor 实例来触发刷新
+      // 具体实现在 onTransaction 中处理
+    }, 200);
+  }, {
+    passive: true
+  });
+
+  // 监听所有输入事件，记录最后输入时间
+  document.addEventListener('input', function () {
+    lastInputTime = Date.now();
+  }, {
+    passive: true
+  });
+  document.addEventListener('keydown', function () {
+    lastInputTime = Date.now();
+  }, {
+    passive: true
+  });
+}
+var addTocActiveStatesAndGetItems = function addTocActiveStatesAndGetItems(content, options) {
+  var editor = options.editor;
+  var headlines = [];
+  var scrolledOverIds = [];
+  var activeId = null;
+  if (editor.isDestroyed) {
+    return content;
+  }
+  editor.state.doc.descendants(function (node, pos) {
+    var _options$anchorTypes;
+    var isValidType = (_options$anchorTypes = options.anchorTypes) === null || _options$anchorTypes === void 0 ? void 0 : _options$anchorTypes.includes(node.type.name);
+    if (!isValidType) {
+      return;
+    }
+    headlines.push({
+      node: node,
+      pos: pos
+    });
+  });
+  headlines.forEach(function (headline) {
+    var domElement = editor.view.domAtPos(headline.pos + 1).node;
+    var scrolledOver = options.storage.scrollPosition >= domElement.offsetTop;
+    if (scrolledOver) {
+      activeId = headline.node.attrs.id;
+      scrolledOverIds.push(headline.node.attrs.id);
+    }
+  });
+  return content.map(function (heading) {
+    return _objectSpread(_objectSpread({}, heading), {}, {
+      isActive: heading.id === activeId,
+      isScrolledOver: scrolledOverIds.includes(heading.id)
+    });
+  });
+};
+var setTocData = function setTocData(options) {
+  var editor = options.editor,
+    onUpdate = options.onUpdate;
+  if (editor.isDestroyed) {
+    return;
+  }
+  var headlines = [];
+  var anchors = [];
+  var anchorEls = [];
+  editor.state.doc.descendants(function (node, pos) {
+    var _options$anchorTypes2;
+    var isValidType = (_options$anchorTypes2 = options.anchorTypes) === null || _options$anchorTypes2 === void 0 ? void 0 : _options$anchorTypes2.includes(node.type.name);
+    if (!isValidType) {
+      return;
+    }
+    headlines.push({
+      node: node,
+      pos: pos
+    });
+  });
+  headlines.forEach(function (headline, i) {
+    if (headline.node.textContent.length === 0) {
+      return;
+    }
+    var domElement = editor.view.domAtPos(headline.pos + 1).node;
+    var scrolledOver = options.storage.scrollPosition >= domElement.offsetTop;
+    anchorEls.push(domElement);
+    var originalLevel = headline.node.attrs.level;
+    var level = options.getLevelFn(headline, anchors);
+    var itemIndex = options.getIndexFn(headline, anchors, level);
+    anchors.push({
+      itemIndex: itemIndex,
+      id: headline.node.attrs.id || options.getId(headline.node.textContent),
+      originalLevel: originalLevel,
+      level: level,
+      textContent: headline.node.textContent,
+      pos: headline.pos,
+      editor: editor,
+      isActive: false,
+      isScrolledOver: scrolledOver,
+      node: headline.node,
+      dom: domElement
+    });
+  });
+
+  // 计算 active 和 scrolledOver 状态
+  anchors = addTocActiveStatesAndGetItems(anchors, {
+    editor: options.editor,
+    anchorTypes: options.anchorTypes,
+    storage: options.storage
+  });
+
+  // 更新存储
+  options.storage.anchors = anchorEls;
+  options.storage.content = anchors;
+
+  // 调用回调
+  if (onUpdate) {
+    var isInitialCreation = options.storage.content.length === 0;
+    onUpdate(anchors, isInitialCreation);
+  }
+};
+export var TableOfContentsExtension = Extension.create({
+  name: 'tableOfContents',
+  addStorage: function addStorage() {
+    return {
+      content: [],
+      anchors: [],
+      scrollHandler: function scrollHandler() {
+        return null;
+      },
+      scrollPosition: 0
+    };
+  },
+  addGlobalAttributes: function addGlobalAttributes() {
+    return [{
+      types: this.options.anchorTypes || ['heading'],
+      attributes: {
+        id: {
+          default: null,
+          renderHTML: function renderHTML(attributes) {
+            return {
+              id: attributes.id
+            };
+          },
+          parseHTML: function parseHTML(element) {
+            return element.id || null;
+          }
+        }
+      }
+    }];
+  },
+  addOptions: function addOptions() {
+    var defaultScrollParent = typeof window !== 'undefined' ? function () {
+      return window;
+    } : undefined;
+    return {
+      // eslint-disable-next-line
+      onUpdate: function onUpdate() {},
+      // eslint-disable-next-line
+      getId: function getId(_textContent) {
+        return uuidv4();
+      },
+      scrollParent: defaultScrollParent,
+      anchorTypes: ['heading']
+    };
+  },
+  addCommands: function addCommands() {
+    var _this = this;
+    return {
+      updateTableOfContents: function updateTableOfContents() {
+        return function (_ref) {
+          var dispatch = _ref.dispatch;
+          if (dispatch) {
+            var _this$options$onUpdat;
+            setTocData({
+              editor: _this.editor,
+              storage: _this.storage,
+              onUpdate: (_this$options$onUpdat = _this.options.onUpdate) === null || _this$options$onUpdat === void 0 ? void 0 : _this$options$onUpdat.bind(_this),
+              getIndexFn: _this.options.getIndex || getLinearIndexes,
+              getLevelFn: _this.options.getLevel || getHeadlineLevel,
+              anchorTypes: _this.options.anchorTypes,
+              getId: _this.options.getId || function (textContent) {
+                return uuidv4();
+              }
+            });
+          }
+          return true;
+        };
+      }
+    };
+  },
+  onTransaction: function onTransaction(_ref2) {
+    var _this2 = this;
+    var transaction = _ref2.transaction;
+    if (!transaction.docChanged) return;
+    var now = Date.now();
+    var timeSinceLastInput = now - lastInputTime;
+
+    // 组合期间完全不处理 TOC 更新，避免打断输入
+    if (globalCompositionState || this.editor.view.composing) {
+      return;
+    }
+
+    // 如果最近有输入（1秒内），延迟处理
+    if (timeSinceLastInput < 1000) {
+      if (globalInputTimer) {
+        clearTimeout(globalInputTimer);
+      }
+      globalInputTimer = setTimeout(function () {
+        // 再次检查组合状态
+        if (!globalCompositionState && !_this2.editor.view.composing) {
+          var _this2$options$onUpda;
+          setTocData({
+            editor: _this2.editor,
+            storage: _this2.storage,
+            onUpdate: (_this2$options$onUpda = _this2.options.onUpdate) === null || _this2$options$onUpda === void 0 ? void 0 : _this2$options$onUpda.bind(_this2),
+            getIndexFn: _this2.options.getIndex || getLinearIndexes,
+            getLevelFn: _this2.options.getLevel || getHeadlineLevel,
+            anchorTypes: _this2.options.anchorTypes,
+            getId: _this2.options.getId || function (textContent) {
+              return uuidv4();
+            }
+          });
+        }
+      }, 1000 - timeSinceLastInput + 200);
+      return;
+    }
+
+    // 非组合期间且无最近输入，使用 setTimeout 确保有足够延迟
+    setTimeout(function () {
+      // 再次检查，确保组合状态没有变化
+      if (!globalCompositionState && !_this2.editor.view.composing) {
+        var _this2$options$onUpda2;
+        setTocData({
+          editor: _this2.editor,
+          storage: _this2.storage,
+          onUpdate: (_this2$options$onUpda2 = _this2.options.onUpdate) === null || _this2$options$onUpda2 === void 0 ? void 0 : _this2$options$onUpda2.bind(_this2),
+          getIndexFn: _this2.options.getIndex || getLinearIndexes,
+          getLevelFn: _this2.options.getLevel || getHeadlineLevel,
+          anchorTypes: _this2.options.anchorTypes,
+          getId: _this2.options.getId || function (textContent) {
+            return uuidv4();
+          }
+        });
+      }
+    }, 100);
+  },
+  onCreate: function onCreate() {
+    var _this3 = this;
+    var tr = this.editor.state.tr;
+    var existingIds = [];
+    if (this.options.scrollParent && typeof this.options.scrollParent !== 'function') {
+      console.warn("[Tiptap Table of Contents Deprecation Notice]: The 'scrollParent' option must now be provided as a callback function that returns the 'scrollParent' element. The ability to pass this option directly will be deprecated in future releases.");
+    }
+
+    // 异步处理初始 ID 分配，避免与初始输入竞争
+    requestAnimationFrame(function () {
+      _this3.editor.state.doc.descendants(function (node, pos) {
+        var _this3$options$anchor;
+        var nodeId = node.attrs.id;
+        var isValidType = (_this3$options$anchor = _this3.options.anchorTypes) === null || _this3$options$anchor === void 0 ? void 0 : _this3$options$anchor.includes(node.type.name);
+        if (!isValidType || node.textContent.length === 0) {
+          return;
+        }
+        if (nodeId === null || nodeId === undefined || existingIds.includes(nodeId)) {
+          var id = '';
+          if (_this3.options.getId) {
+            id = _this3.options.getId(node.textContent);
+          } else {
+            id = uuidv4();
+          }
+          tr.setNodeMarkup(pos, undefined, _objectSpread(_objectSpread({}, node.attrs), {}, {
+            id: id
+          }));
+        }
+        existingIds.push(nodeId);
+      });
+      _this3.editor.view.dispatch(tr);
+
+      // 延迟初始化 TOC 数据
+      setTimeout(function () {
+        var _this3$options$onUpda;
+        setTocData({
+          editor: _this3.editor,
+          storage: _this3.storage,
+          onUpdate: (_this3$options$onUpda = _this3.options.onUpdate) === null || _this3$options$onUpda === void 0 ? void 0 : _this3$options$onUpda.bind(_this3),
+          getIndexFn: _this3.options.getIndex || getLinearIndexes,
+          getLevelFn: _this3.options.getLevel || getHeadlineLevel,
+          anchorTypes: _this3.options.anchorTypes,
+          getId: _this3.options.getId || function (textContent) {
+            return uuidv4();
+          }
+        });
+      }, 100);
+    });
+
+    // 防抖的 scroll handler，避免滚动期间频繁触发回调
+    var scrollTimer = null;
+    this.storage.scrollHandler = function () {
+      if (!_this3.options.scrollParent) {
+        return;
+      }
+      var scrollParent = typeof _this3.options.scrollParent === 'function' ? _this3.options.scrollParent() : _this3.options.scrollParent;
+      var scrollPosition = scrollParent instanceof HTMLElement ? scrollParent.scrollTop : scrollParent.scrollY;
+      _this3.storage.scrollPosition = scrollPosition || 0;
+      if (scrollTimer) clearTimeout(scrollTimer);
+      scrollTimer = setTimeout(function () {
+        var _this3$options$onUpda2, _this3$options;
+        var updatedItems = addTocActiveStatesAndGetItems(_this3.storage.content, {
+          editor: _this3.editor,
+          anchorTypes: _this3.options.anchorTypes,
+          storage: _this3.storage
+        });
+        _this3.storage.content = updatedItems;
+        // 调用 onUpdate 回调
+        (_this3$options$onUpda2 = (_this3$options = _this3.options).onUpdate) === null || _this3$options$onUpda2 === void 0 || _this3$options$onUpda2.call(_this3$options, updatedItems, false);
+      }, 100);
+    };
+
+    // 添加滚动监听
+    if (this.options.scrollParent) {
+      var scrollParent = typeof this.options.scrollParent === 'function' ? this.options.scrollParent() : this.options.scrollParent;
+      if (scrollParent) {
+        scrollParent.addEventListener('scroll', this.storage.scrollHandler);
+      }
+    }
+  },
+  onDestroy: function onDestroy() {
+    if (this.options.scrollParent) {
+      var scrollParent = typeof this.options.scrollParent === 'function' ? this.options.scrollParent() : this.options.scrollParent;
+      if (scrollParent) {
+        scrollParent.removeEventListener('scroll', this.storage.scrollHandler);
+      }
+    }
+  },
+  addProseMirrorPlugins: function addProseMirrorPlugins() {
+    return [TableOfContentsPlugin({
+      getId: this.options.getId,
+      anchorTypes: this.options.anchorTypes
+    })];
+  }
+});
+export var TableOfContents = function TableOfContents(_ref3) {
+  var onTocUpdate = _ref3.onTocUpdate;
+  return TableOfContentsExtension.configure({
+    getIndex: getHierarchicalIndexes,
+    onUpdate: function onUpdate(data) {
+      setTimeout(function () {
+        onTocUpdate === null || onTocUpdate === void 0 || onTocUpdate(data.map(function (content) {
+          return {
+            id: content.id,
+            isActive: content.isActive,
+            isScrolledOver: content.isScrolledOver,
+            itemIndex: content.itemIndex,
+            level: content.level,
+            originalLevel: content.originalLevel,
+            pos: content.pos,
+            textContent: content.textContent
+          };
+        }));
+      }, 0);
+    }
+  });
+};
+export default TableOfContents;

package/dist/extension/node/TableOfContents/plugin.d.ts

@@ -0,0 +1,6 @@
+import type { NodeType } from '@tiptap/pm/model';
+import { Plugin } from '@tiptap/pm/state';
+export declare const TableOfContentsPlugin: ({ getId, anchorTypes, }: {
+    getId?: ((textContent: string) => string) | undefined;
+    anchorTypes?: (string | NodeType)[] | undefined;
+}) => Plugin<any>;