@ctzhian/tiptap 2.13.7-beta.0 → 3.0.0

package/dist/editor-core/extensions/node/TableOfContents/index.js

@@ -0,0 +1,449 @@
+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); }
+/* eslint-disable @typescript-eslint/no-unused-vars */
+
+import { Extension } from '@tiptap/core';
+import { v4 as uuidv4 } from 'uuid';
+import { TableOfContentsPlugin } from "./plugin";
+import { getHeadlineLevel, getHierarchicalIndexes, getLinearIndexes } from "./util";
+export * from "./types";
+
+// 全局组合状态管理，避免在 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) {
+    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,
+    tableOfContentsOptions = _ref3.tableOfContentsOptions;
+  return TableOfContentsExtension.configure(_objectSpread(_objectSpread({
+    getIndex: getHierarchicalIndexes
+  }, tableOfContentsOptions || {}), {}, {
+    onUpdate: function onUpdate(data, isCreate) {
+      var _tableOfContentsOptio;
+      tableOfContentsOptions === null || tableOfContentsOptions === void 0 || (_tableOfContentsOptio = tableOfContentsOptions.onUpdate) === null || _tableOfContentsOptio === void 0 || _tableOfContentsOptio.call(tableOfContentsOptions, data, isCreate);
+      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;
+
+// import { TocList } from '../../../../types'
+// import { getHierarchicalIndexes, TableOfContents, TableOfContentsOptions } from '@tiptap/extension-table-of-contents'
+// import { Plugin, PluginKey } from '@tiptap/pm/state'
+
+// interface Props {
+//   onTocUpdate?: (toc: TocList) => void
+//   tableOfContentsOptions?: TableOfContentsOptions
+// }
+
+// export const TableOfContentsExtension = ({ onTocUpdate, tableOfContentsOptions }: Props) => TableOfContents.extend({
+//   addProseMirrorPlugins() {
+//     const imeCompositionPluginKey = new PluginKey('imeComposition')
+
+//     return [
+//       new Plugin({
+//         key: new PluginKey('tableOfContentImeFix'),
+//         appendTransaction(transactions, _oldState, newState) {
+//           if (transactions.some(tr => tr.getMeta('composition'))) {
+//             return null
+//           }
+//           const imePluginState = imeCompositionPluginKey.getState(newState) as { isComposing?: boolean } | null
+//           if (imePluginState?.isComposing) {
+//             return null
+//           }
+//           return null
+//         },
+//       }),
+//     ]
+//   }
+// }).configure({
+//   getIndex: getHierarchicalIndexes,
+//   ...(tableOfContentsOptions || {}),
+//   onUpdate(data, isCreate) {
+//     // 先调用用户传入的 onUpdate 回调（如果存在）
+//     tableOfContentsOptions?.onUpdate?.(data, isCreate)
+
+//     // 然后调用我们的 onTocUpdate 回调
+//     setTimeout(() => {
+//       onTocUpdate?.(data.map(content => ({
+//         id: content.id,
+//         isActive: content.isActive,
+//         isScrolledOver: content.isScrolledOver,
+//         itemIndex: content.itemIndex,
+//         level: content.level,
+//         originalLevel: content.originalLevel,
+//         pos: content.pos,
+//         textContent: content.textContent,
+//       })))
+//     }, 60)
+//   }
+// })

package/dist/editor-core/extensions/node/TableOfContents/plugin.js

@@ -0,0 +1,57 @@
+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 { Plugin, PluginKey } from '@tiptap/pm/state';
+import { v4 as uuidv4 } from 'uuid';
+import { hasImeCompositionMeta } from "../../extension/ime-shared";
+export var TableOfContentsPlugin = function TableOfContentsPlugin(_ref) {
+  var getId = _ref.getId,
+    _ref$anchorTypes = _ref.anchorTypes,
+    anchorTypes = _ref$anchorTypes === void 0 ? ['heading'] : _ref$anchorTypes;
+  return new Plugin({
+    key: new PluginKey('tableOfContent'),
+    appendTransaction: function appendTransaction(transactions, oldState, newState) {
+      var _view;
+      // 若处于组合输入，完全避免在此事务中写入 id，交由扩展层异步生成
+      if ((_view = newState.view) !== null && _view !== void 0 && _view.composing || typeof document !== 'undefined' && document.composing || typeof window !== 'undefined' && window.compositionState) {
+        return null;
+      }
+
+      // 检查是否有任何事务包含组合相关的变化
+      var hasCompositionChanges = transactions.some(hasImeCompositionMeta);
+      if (hasCompositionChanges) {
+        return null;
+      }
+      var tr = newState.tr;
+      var modified = false;
+      if (transactions.some(function (transaction) {
+        return transaction.docChanged;
+      }) && !oldState.doc.eq(newState.doc)) {
+        var existingIds = [];
+        newState.doc.descendants(function (node, pos) {
+          var nodeId = node.attrs.id;
+          if (!anchorTypes.includes(node.type.name) || node.textContent.length === 0) {
+            return;
+          }
+          if (nodeId === null || nodeId === undefined || existingIds.includes(nodeId)) {
+            var id = '';
+            if (getId) {
+              id = getId(node.textContent);
+            } else {
+              id = uuidv4();
+            }
+            tr.setNodeMarkup(pos, undefined, _objectSpread(_objectSpread({}, node.attrs), {}, {
+              id: id
+            }));
+            modified = true;
+          }
+          existingIds.push(nodeId);
+        });
+      }
+      return modified ? tr : null;
+    }
+  });
+};

package/dist/editor-core/extensions/node/Video.d.ts

@@ -0,0 +1,26 @@
+import { EditorFnProps } from '../../../types';
+import { Node } from '@tiptap/core';
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        video: {
+            /**
+             * Insert a video
+             */
+            setVideo: (options: {
+                src: string;
+                width?: number;
+                align?: 'left' | 'center' | 'right';
+                controls?: boolean;
+                autoplay?: boolean;
+                loop?: boolean;
+                muted?: boolean;
+                poster?: string;
+            }) => ReturnType;
+        };
+    }
+}
+export type VideoExtensionProps = EditorFnProps & {
+    baseUrl: string;
+};
+export declare const VideoExtension: (props: VideoExtensionProps) => Node<any, any>;
+export default VideoExtension;