@ctzhian/tiptap 2.1.15 → 2.1.17

package/dist/EditorMarkdown/demo.js

@@ -13,7 +13,7 @@ import { Box } from '@mui/material';
 import React, { useCallback, useEffect, useState } from 'react';
 import "../index.css";
 var Reader = function Reader() {
-  var _useState = useState("本文用以记录 Gitlab 相关问题及解答\n\n![https://fuss10.elemecdn.com/e/5d/4a731a90594a4af544c0c25941171jpeg.jpeg](https://fuss10.elemecdn.com/e/5d/4a731a90594a4af544c0c25941171jpeg.jpeg)\n\n## 我在使用 `git@git.in.chaitin.net:ns/repo` 时可以访问仓库，但是 `https://git.in.chaitin.net/ns/repo` 无法访问\n\n问题通常出现 git clone 与其他依赖 git 进行的操作，如 `go get` 等，具体报错可能为 `Permission Denied`.\n\n在使用 curl 借助 `CI_JOB_TOKEN` 获取其他仓库 cicd job 产物或者 generic package 时，其具体报错为 `404 Not Found` 的问题.\n\n原因是在使用 `git@git.in.chaitin.net` 时，使用的是 ssh 协议，此时默认使用的是 `~/.ssh` 下的私钥进行认证你在 gitlab 中添加的 `SSH Keys`。而使用 `https://git.in.chaitin.net/ns/repo` 时，使用的是 http 协议，此时默认使用的是 `~/.netrc` 认证你在 gitlab 中申请的 `Access tokens`。部分软件如 `go get` 默认使用的便是 http 来拉取代码，因此需要额外配置。\n\n这里推荐两种解决方案:\n\n1. 配置 `~/.netrc` 文件(推荐)\n\n   在 ~/.netrc 文件中添加以下配置:\n\n   ```text\n   machine git.in.chaitin.net login git password <your access token>\n   ```\n\n   在 gitlab cicd job 中遇到拉取其他仓库时遇到权限问题可以使用本配置，比如可以在 job 的 `before_script` 阶段添加以下命令:\n\n   ```shell\n   echo \"machine git.in.chaitin.net login git password $CI_JOB_TOKEN\" >> ~/.netrc\n   ```\n\n   注意: 其中 `$CI_JOB_TOKEN` 是 job 运行期间生成的 token，其权限与 trigger 用户相同，详见 [CI Job Token](https://docs.gitlab.com/ci/jobs/ci_job_token/)。其 Token 权限由 `pipeline 触发者`权限以及`目标仓库权限`共同决定。因此被拉取的目标仓库也需要保证其 `Setting -> CI/CD -> Job token permissions` 配置正确，允许源仓库的 CI/CD 能够访问到该仓库，否则依然会出现如 `404 Not Found`, `403 Forbidden` 的权限问题。（如果你是 pipeline 触发者，可以手动在浏览器通过 gitlab api 访问目标仓库的 generic package 或者 job artifact 如果可以正常下载，说明是 `Job token permissions` 问题）\n\n2. 配置 `git url replace`\n\n   在 ~/.gitconfig 文件中添加以下配置:\n\n   ```ini\n   [url \"git@git.in.chaitin.net:\"]\n     insteadOf = https://git.in.chaitin.net/\n   ```\n\n   这个配置可以将所有 `https://git.in.chaitin.net/` 请求替换为 `git@git.in.chaitin.net:` 使用 ssh 来拉取代码仓库\n\n## 我在 clone gitlab 仓库时没问题，但是 lfs 遇到了 EOF 问题\n\nEOF 在大多数情况下由代理导致，如果代理不允许客户端访问某个网站，行为可能是提早结束连接，导致 `EOF` 错误。如\n\n> 在 ubunu 虚拟机里无法拉取 safeline-aliyun 项目里的 lfs 文件怎么处理？\n\n```bash\nroot@OPS-5108:~/proj/safeline-aliyun# git lfs fetch --all\nfetch: 34 object(s) found, done.\nfetch: Fetching all references...\nbatch response: Post https://git.in.chaitin.net/patronus/safeline-aliyun.git/info/lfs/objects/batch: EOF\nerror: failed to fetch some objects from 'https://git.in.chaitin.net/patronus/safeline-aliyun.git/info/lfs'\n```\n\n可以看到返回了 EOF 问题，经查代理未配置在 git config 中。从 `env` 中可以看到用户配置了 *_proxy 但其中发现 `no_proxy` 配置不正确:\n\n```shell\nroot@OPS-5108:~/proj/safeline-aliyun# env | grep pro\nno_proxy=localhost, 127.0.0.1, ::1\nPWD=/root/proj/safeline-aliyun\nftp_proxy=http://proxy.in.chaitin.net:8123\nhttps_proxy=http://proxy.in.chaitin.net:8123\nproxy=http://proxy.in.chaitin.net:8123\nhttp_proxy=http://proxy.in.chaitin.net:8123\nOLDPWD=/root/proj\n```\n\n需要按照 [代理配置](https://info.chaitin.net/colab-editor/page/%E7%A0%94%E5%8F%91%E4%BD%93%E7%B3%BB%2F%E7%A0%94%E5%8F%91%E6%94%AF%E6%8C%81%2F%E4%BB%A3%E7%90%86%E6%89%AB%E7%9B%B2) 进行正确配置后，重新执行操作，发现 EOF 问题被解决。\n\n## 我在访问公司内部服务时报错 `x509: certificate signed by unknown authority`\n\n公司部分内部服务采用自签名证书，导致客户端在访问这些服务时会遇到 `x509: certificate signed by unknown authority` 错误。为了确保客户端能够信任这些自签名证书，你需要配置信任自签名证书即 CA。\n\n以 debian 系系统举例:\n\n```shell\ncurl -o /usr/local/share/ca-certificates/chaitin_ca.crt -L https://chaitin-ops-public.cn-beijing.oss.aliyuncs.com/Chaitin_Ltd_Root_CA.pem\nupdate-ca-certificates\n```\n\n如果无法访问外网，可以尝试 `http://s3-ephemeral.in.chaitin.net/dev/Chaitin_Ltd_Root_CA.pem`\n\n其他系统 CA 证书安装请参考 [安装CA证书](https://info.chaitin.net/colab-editor/page/IT%E5%8A%9E%E5%85%AC/%E5%8A%9E%E5%85%AC%E7%BD%91%E7%BB%9C/windows%E7%94%A8%E6%88%B7/%E5%A4%87%E9%80%89%E6%96%B9%E6%A1%88%EF%BC%88Windows%EF%BC%89/%E8%AF%81%E4%B9%A6%E5%AE%89%E8%A3%85%28windows%29/%E9%95%BF%E4%BA%AD%E6%A0%B9%E8%AF%81%E4%B9%A6%E5%AE%89%E8%A3%85%28windows%29)\n"),
+  var _useState = useState("本文用以记录 Gitlab 相关问题及解答\n\n## 我在使用 `git@git.in.chaitin.net:ns/repo` 时可以访问仓库，但是 `https://git.in.chaitin.net/ns/repo` 无法访问\n\n问题通常出现 git clone 与其他依赖 git 进行的操作，如 `go get` 等，具体报错可能为 `Permission Denied`.\n\n在使用 curl 借助 `CI_JOB_TOKEN` 获取其他仓库 cicd job 产物或者 generic package 时，其具体报错为 `404 Not Found` 的问题.\n\n原因是在使用 `git@git.in.chaitin.net` 时，使用的是 ssh 协议，此时默认使用的是 `~/.ssh` 下的私钥进行认证你在 gitlab 中添加的 `SSH Keys`。而使用 `https://git.in.chaitin.net/ns/repo` 时，使用的是 http 协议，此时默认使用的是 `~/.netrc` 认证你在 gitlab 中申请的 `Access tokens`。部分软件如 `go get` 默认使用的便是 http 来拉取代码，因此需要额外配置。\n\n这里推荐两种解决方案:\n\n1. 配置 `~/.netrc` 文件(推荐)\n\n   在 ~/.netrc 文件中添加以下配置:\n\n   ```text\n   machine git.in.chaitin.net login git password <your access token>\n   ```\n\n   在 gitlab cicd job 中遇到拉取其他仓库时遇到权限问题可以使用本配置，比如可以在 job 的 `before_script` 阶段添加以下命令:\n\n   ```shell\n   echo \"machine git.in.chaitin.net login git password $CI_JOB_TOKEN\" >> ~/.netrc\n   ```\n\n   注意: 其中 `$CI_JOB_TOKEN` 是 job 运行期间生成的 token，其权限与 trigger 用户相同，详见 [CI Job Token](https://docs.gitlab.com/ci/jobs/ci_job_token/)。其 Token 权限由 `pipeline 触发者`权限以及`目标仓库权限`共同决定。因此被拉取的目标仓库也需要保证其 `Setting -> CI/CD -> Job token permissions` 配置正确，允许源仓库的 CI/CD 能够访问到该仓库，否则依然会出现如 `404 Not Found`, `403 Forbidden` 的权限问题。（如果你是 pipeline 触发者，可以手动在浏览器通过 gitlab api 访问目标仓库的 generic package 或者 job artifact 如果可以正常下载，说明是 `Job token permissions` 问题）\n\n2. 配置 `git url replace`\n\n   在 ~/.gitconfig 文件中添加以下配置:\n\n   ```ini\n   [url \"git@git.in.chaitin.net:\"]\n     insteadOf = https://git.in.chaitin.net/\n   ```\n\n   这个配置可以将所有 `https://git.in.chaitin.net/` 请求替换为 `git@git.in.chaitin.net:` 使用 ssh 来拉取代码仓库\n\n## 我在 clone gitlab 仓库时没问题，但是 lfs 遇到了 EOF 问题\n\nEOF 在大多数情况下由代理导致，如果代理不允许客户端访问某个网站，行为可能是提早结束连接，导致 `EOF` 错误。如\n\n> 在 ubunu 虚拟机里无法拉取 safeline-aliyun 项目里的 lfs 文件怎么处理？\n\n```bash\nroot@OPS-5108:~/proj/safeline-aliyun# git lfs fetch --all\nfetch: 34 object(s) found, done.\nfetch: Fetching all references...\nbatch response: Post https://git.in.chaitin.net/patronus/safeline-aliyun.git/info/lfs/objects/batch: EOF\nerror: failed to fetch some objects from 'https://git.in.chaitin.net/patronus/safeline-aliyun.git/info/lfs'\n```\n\n可以看到返回了 EOF 问题，经查代理未配置在 git config 中。从 `env` 中可以看到用户配置了 *_proxy 但其中发现 `no_proxy` 配置不正确:\n\n```shell\nroot@OPS-5108:~/proj/safeline-aliyun# env | grep pro\nno_proxy=localhost, 127.0.0.1, ::1\nPWD=/root/proj/safeline-aliyun\nftp_proxy=http://proxy.in.chaitin.net:8123\nhttps_proxy=http://proxy.in.chaitin.net:8123\nproxy=http://proxy.in.chaitin.net:8123\nhttp_proxy=http://proxy.in.chaitin.net:8123\nOLDPWD=/root/proj\n```\n\n需要按照 [代理配置](https://info.chaitin.net/colab-editor/page/%E7%A0%94%E5%8F%91%E4%BD%93%E7%B3%BB%2F%E7%A0%94%E5%8F%91%E6%94%AF%E6%8C%81%2F%E4%BB%A3%E7%90%86%E6%89%AB%E7%9B%B2) 进行正确配置后，重新执行操作，发现 EOF 问题被解决。\n\n## 我在访问公司内部服务时报错 `x509: certificate signed by unknown authority`\n\n公司部分内部服务采用自签名证书，导致客户端在访问这些服务时会遇到 `x509: certificate signed by unknown authority` 错误。为了确保客户端能够信任这些自签名证书，你需要配置信任自签名证书即 CA。\n\n以 debian 系系统举例:\n\n```shell\ncurl -o /usr/local/share/ca-certificates/chaitin_ca.crt -L https://chaitin-ops-public.cn-beijing.oss.aliyuncs.com/Chaitin_Ltd_Root_CA.pem\nupdate-ca-certificates\n```\n\n如果无法访问外网，可以尝试 `http://s3-ephemeral.in.chaitin.net/dev/Chaitin_Ltd_Root_CA.pem`\n\n其他系统 CA 证书安装请参考 [安装CA证书](https://info.chaitin.net/colab-editor/page/IT%E5%8A%9E%E5%85%AC/%E5%8A%9E%E5%85%AC%E7%BD%91%E7%BB%9C/windows%E7%94%A8%E6%88%B7/%E5%A4%87%E9%80%89%E6%96%B9%E6%A1%88%EF%BC%88Windows%EF%BC%89/%E8%AF%81%E4%B9%A6%E5%AE%89%E8%A3%85%28windows%29/%E9%95%BF%E4%BA%AD%E6%A0%B9%E8%AF%81%E4%B9%A6%E5%AE%89%E8%A3%85%28windows%29)\n"),
     _useState2 = _slicedToArray(_useState, 2),
     mdContent = _useState2[0],
     setMdContent = _useState2[1];

package/dist/extension/extension/StructuredDiff.d.ts

@@ -9,13 +9,7 @@ declare module '@tiptap/core' {
         };
     }
 }
-import { GetExtensionsProps } from '../../type';
-export interface StructuredDiffOptions {
-    getExtensionConfig?: () => Omit<GetExtensionsProps, 'editable'> & {
-        editable: false;
-    };
-}
-export declare const StructuredDiffExtension: Extension<StructuredDiffOptions, any>;
+export declare const StructuredDiffExtension: Extension<any, any>;
 export { diffPluginKey };
 export declare function getDiffState(editor: Editor): {
     isActive: any;

package/dist/extension/extension/StructuredDiff.js

@@ -1,12 +1,4 @@
 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 _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
-function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-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 _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
-function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
-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 _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
 function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
@@ -17,7 +9,6 @@ import { Extension } from '@tiptap/core';
 import { Plugin, PluginKey } from '@tiptap/pm/state';
 import { createDecorationsFromDiffs, createEmptyDecorationSet } from "../../util/decorations";
 import { compareDocuments } from "../../util/structuredDiff";
-import { getExtensions } from "../index";
 var diffPluginKey = new PluginKey('structuredDiff');
 var DiffPluginState = /*#__PURE__*/function () {
   function DiffPluginState(decorations) {
@@ -53,40 +44,20 @@ var DiffPluginState = /*#__PURE__*/function () {
     }
   }], [{
     key: "init",
-    value: function init(_config, state) {
+    value: function init(config, state) {
       return new DiffPluginState(createEmptyDecorationSet(state.doc), [], false);
     }
   }]);
   return DiffPluginState;
 }();
-function getExtensionsForParsing(editor, getExtensionConfig) {
-  if (getExtensionConfig) {
-    var config = getExtensionConfig();
-    if (config) {
-      var exclude = [].concat(_toConsumableArray(config.exclude || []), ['structuredDiff']);
-      return getExtensions(_objectSpread(_objectSpread({}, config), {}, {
-        exclude: exclude,
-        editable: false
-      }));
-    }
-  }
-  return editor.extensionManager.extensions.filter(function (ext) {
-    return ext.name !== 'structuredDiff';
-  });
-}
 export var StructuredDiffExtension = Extension.create({
   name: 'structuredDiff',
-  addOptions: function addOptions() {
-    return {
-      getExtensionConfig: undefined
-    };
-  },
   addProseMirrorPlugins: function addProseMirrorPlugins() {
     return [new Plugin({
       key: diffPluginKey,
       state: {
         init: DiffPluginState.init,
-        apply: DiffPluginState.prototype.apply.bind(DiffPluginState.prototype)
+        apply: DiffPluginState.prototype.apply
       },
       props: {
         decorations: function decorations(state) {
@@ -97,7 +68,6 @@ export var StructuredDiffExtension = Extension.create({
     })];
   },
   addCommands: function addCommands() {
-    var _this = this;
     return {
       showStructuredDiff: function showStructuredDiff(oldHtml, newHtml) {
         return function (_ref) {
@@ -106,8 +76,8 @@ export var StructuredDiffExtension = Extension.create({
             dispatch = _ref.dispatch,
             editor = _ref.editor;
           try {
-            var extensionsForParsing = getExtensionsForParsing(editor, _this.options.getExtensionConfig);
-            var comparison = compareDocuments(oldHtml, newHtml, extensionsForParsing);
+            var extensions = editor.extensionManager.extensions;
+            var comparison = compareDocuments(oldHtml, newHtml, extensions);
             if (!comparison.hasChanges) {
               return false;
             }

package/dist/extension/index.js

@@ -150,26 +150,7 @@ export var getExtensions = function getExtensions(_ref) {
   } else {
     // 只读模式
     if (!(exclude !== null && exclude !== void 0 && exclude.includes('structuredDiff'))) {
-      defaultExtensions.push(StructuredDiffExtension.configure({
-        getExtensionConfig: function getExtensionConfig() {
-          return {
-            contentType: contentType,
-            limit: limit,
-            exclude: [].concat(_toConsumableArray(exclude || []), ['structuredDiff']),
-            extensions: extensionsProps,
-            youtube: youtube,
-            editable: false,
-            mentionItems: mentionItems,
-            onMentionFilter: onMentionFilter,
-            onUpload: onUpload,
-            onError: onError,
-            onTocUpdate: onTocUpdate,
-            onAiWritingGetSuggestion: onAiWritingGetSuggestion,
-            onValidateUrl: onValidateUrl,
-            placeholder: _placeholder
-          };
-        }
-      }));
+      defaultExtensions.push(StructuredDiffExtension);
     }
   }
   if (!(exclude !== null && exclude !== void 0 && exclude.includes('mention')) && (mentionItems && mentionItems.length > 0 || onMentionFilter)) {

package/dist/util/structuredDiff.d.ts

@@ -35,6 +35,25 @@ export interface ProseMirrorNode {
         attrs?: Record<string, any>;
     }>;
 }
+/**
+ * 将HTML转换为ProseMirror文档结构
+ * @param {string} html - HTML字符串
+ * @param {Array} extensions - Tiptap扩展数组
+ * @returns {Object} ProseMirror文档对象
+ */
 export declare function parseHtmlToDoc(html: string, extensions: Extensions): any;
+/**
+ * 对比两个HTML文档并生成结构化差异
+ * @param {string} oldHtml - 旧HTML
+ * @param {string} newHtml - 新HTML
+ * @param {Array} extensions - Tiptap扩展数组
+ * @returns {Object} 包含差异信息的对象
+ */
 export declare function compareDocuments(oldHtml: string, newHtml: string, extensions: Extensions): DocumentComparison;
+/**
+ * 将路径转换为ProseMirror位置
+ * @param {Array} path - 节点路径
+ * @param {Object} doc - ProseMirror文档
+ * @returns {number} 文档位置
+ */
 export declare function pathToPos(path: number[], doc: any): number;

package/dist/util/structuredDiff.js

@@ -1,30 +1,30 @@
-function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
-function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
-function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
 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; }
 import { generateJSON } from '@tiptap/html';
 import DiffMatchPatch from 'diff-match-patch';
+
+// 创建diff-match-patch实例
 var dmp = new DiffMatchPatch();
+
+// 类型定义
+
+/**
+ * 将HTML转换为ProseMirror文档结构
+ * @param {string} html - HTML字符串
+ * @param {Array} extensions - Tiptap扩展数组
+ * @returns {Object} ProseMirror文档对象
+ */
 export function parseHtmlToDoc(html, extensions) {
-  try {
-    if (!html || typeof html !== 'string') {
-      throw new Error('HTML 内容无效');
-    }
-    if (!extensions || extensions.length === 0) {
-      throw new Error('扩展数组不能为空');
-    }
-    return generateJSON(html, extensions);
-  } catch (error) {
-    console.error('解析 HTML 到文档结构时出错:', error);
-    throw error;
-  }
+  return generateJSON(html, extensions);
 }
 function haveSameMarks(a, b) {
   var arrA = a || [];
@@ -48,6 +48,191 @@ function haveSameMarks(a, b) {
   }
   return true;
 }
+
+/**
+ * 对比两个ProseMirror文档节点
+ * @param {Object} nodeA - 旧文档节点
+ * @param {Object} nodeB - 新文档节点
+ * @param {Array} path - 当前节点路径
+ * @returns {Array} 差异数组
+ */
+function compareNodes(nodeA, nodeB) {
+  var path = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
+  var diffs = [];
+
+  // 如果节点类型不同，标记整个节点为变更
+  if ((nodeA === null || nodeA === void 0 ? void 0 : nodeA.type) !== (nodeB === null || nodeB === void 0 ? void 0 : nodeB.type)) {
+    if (nodeA) {
+      diffs.push({
+        type: 'delete',
+        path: _toConsumableArray(path),
+        node: nodeA
+      });
+    }
+    if (nodeB) {
+      diffs.push({
+        type: 'insert',
+        path: _toConsumableArray(path),
+        node: nodeB
+      });
+    }
+    return diffs;
+  }
+
+  // 如果是文本节点，进行文本级别的diff
+  if ((nodeA === null || nodeA === void 0 ? void 0 : nodeA.type) === 'text' && (nodeB === null || nodeB === void 0 ? void 0 : nodeB.type) === 'text') {
+    if (nodeA.text !== nodeB.text) {
+      // 计算文本差异
+      var textDiffs = dmp.diff_main(nodeA.text || '', nodeB.text || '');
+      dmp.diff_cleanupSemantic(textDiffs);
+
+      // 检查是否有文本差异
+      // if (textDiffs.length > 1) {
+      //   console.log('发现文本差异:', { oldText: nodeA.text, newText: nodeB.text, path });
+      // }
+
+      var textOffset = 0; // offset in the NEW text node
+
+      textDiffs.forEach(function (_ref) {
+        var _ref2 = _slicedToArray(_ref, 2),
+          operation = _ref2[0],
+          text = _ref2[1];
+        if (operation === -1) {
+          // Delete
+          // The widget should be placed at the current position in the new text.
+          var diffItem = {
+            type: 'delete',
+            path: _toConsumableArray(path),
+            textDiff: {
+              offset: textOffset,
+              length: text.length,
+              text: text,
+              operation: operation
+            }
+          };
+          diffs.push(diffItem);
+          // DO NOT advance textOffset
+        } else if (operation === 1) {
+          // Insert
+          var _diffItem = {
+            type: 'insert',
+            path: _toConsumableArray(path),
+            textDiff: {
+              offset: textOffset,
+              length: text.length,
+              text: text,
+              operation: operation
+            }
+          };
+          diffs.push(_diffItem);
+          textOffset += text.length; // DO advance textOffset
+        } else {
+          // Equal
+          textOffset += text.length; // DO advance textOffset
+        }
+      });
+    }
+    // 文本相等或不相等时都可检查 marks 差异（粗粒度：节点级）
+    if (!haveSameMarks(nodeA.marks, nodeB.marks)) {
+      diffs.push({
+        type: 'modify',
+        path: _toConsumableArray(path),
+        attrChange: {
+          key: 'marks',
+          oldValue: nodeA.marks || [],
+          newValue: nodeB.marks || []
+        }
+      });
+    }
+    return diffs;
+  }
+
+  // 优先：段落/标题等内联容器执行字符级 diff 和 marks 区间对比
+  if (nodeA && nodeB && isInlineContainer(nodeA) && isInlineContainer(nodeB)) {
+    // 文本与 marks 的字符级 diff
+    diffs.push.apply(diffs, _toConsumableArray(compareInlineContainer(nodeA, nodeB, path)));
+    // 非文本内联节点（如行内数学、行内公式等）的结构化对比
+    diffs.push.apply(diffs, _toConsumableArray(compareInlineContainerChildren(nodeA, nodeB, path)));
+    return diffs;
+  }
+
+  // 对比节点属性
+  var attrsA = (nodeA === null || nodeA === void 0 ? void 0 : nodeA.attrs) || {};
+  var attrsB = (nodeB === null || nodeB === void 0 ? void 0 : nodeB.attrs) || {};
+  var allAttrKeys = new Set([].concat(_toConsumableArray(Object.keys(attrsA)), _toConsumableArray(Object.keys(attrsB))));
+  for (var _i = 0, _Array$from = Array.from(allAttrKeys); _i < _Array$from.length; _i++) {
+    var key = _Array$from[_i];
+    if (attrsA[key] !== attrsB[key]) {
+      diffs.push({
+        type: 'modify',
+        path: _toConsumableArray(path),
+        attrChange: {
+          key: key,
+          oldValue: attrsA[key],
+          newValue: attrsB[key]
+        }
+      });
+    }
+  }
+
+  // 使用 LCS 对齐子节点，减少错配
+  var contentA = (nodeA === null || nodeA === void 0 ? void 0 : nodeA.content) || [];
+  var contentB = (nodeB === null || nodeB === void 0 ? void 0 : nodeB.content) || [];
+  var pairs = lcsAlign(contentA, contentB, nodesEqualForAlign);
+  var ai = 0;
+  var bi = 0;
+  for (var _i2 = 0, _pairs = pairs; _i2 < _pairs.length; _i2++) {
+    var _pairs$_i = _slicedToArray(_pairs[_i2], 2),
+      i = _pairs$_i[0],
+      j = _pairs$_i[1];
+    // 先处理 A 中未匹配（删除），以 B 的当前位置作为锚点
+    while (ai < i) {
+      var delNode = contentA[ai];
+      diffs.push({
+        type: 'delete',
+        path: [].concat(_toConsumableArray(path), [bi]),
+        node: delNode
+      });
+      ai++;
+    }
+    // 再处理 B 中未匹配（插入）
+    while (bi < j) {
+      var insNode = contentB[bi];
+      diffs.push({
+        type: 'insert',
+        path: [].concat(_toConsumableArray(path), [bi]),
+        node: insNode
+      });
+      bi++;
+    }
+    // 匹配上的成对递归，路径以新文档索引为准
+    var childA = contentA[i];
+    var childB = contentB[j];
+    diffs.push.apply(diffs, _toConsumableArray(compareNodes(childA, childB, [].concat(_toConsumableArray(path), [j]))));
+    ai = i + 1;
+    bi = j + 1;
+  }
+  // 处理尾部剩余未匹配项
+  while (ai < contentA.length) {
+    var _delNode = contentA[ai];
+    diffs.push({
+      type: 'delete',
+      path: [].concat(_toConsumableArray(path), [bi]),
+      node: _delNode
+    });
+    ai++;
+  }
+  while (bi < contentB.length) {
+    var _insNode = contentB[bi];
+    diffs.push({
+      type: 'insert',
+      path: [].concat(_toConsumableArray(path), [bi]),
+      node: _insNode
+    });
+    bi++;
+  }
+  return diffs;
+}
 function isInlineContainer(node) {
   return node.type === 'paragraph' || node.type === 'heading';
 }
@@ -90,12 +275,13 @@ function compareInlineContainer(nodeA, nodeB, path) {
   dmp.diff_cleanupSemantic(blocks);
   var oldOffset = 0;
   var newOffset = 0;
-  for (var _i = 0, _arr = blocks; _i < _arr.length; _i++) {
-    var _arr$_i = _slicedToArray(_arr[_i], 2),
+  for (var _i3 = 0, _arr = blocks; _i3 < _arr.length; _i3++) {
+    var _arr$_i = _slicedToArray(_arr[_i3], 2),
       operation = _arr$_i[0],
       text = _arr$_i[1];
     var len = text.length;
     if (operation === -1) {
+      // 删除：在新文本当前位置放置删除widget
       diffs.push({
         type: 'delete',
         path: _toConsumableArray(path),
@@ -108,6 +294,7 @@ function compareInlineContainer(nodeA, nodeB, path) {
       });
       oldOffset += len;
     } else if (operation === 1) {
+      // 插入：直接在新文本当前位置标注
       diffs.push({
         type: 'insert',
         path: _toConsumableArray(path),
@@ -120,6 +307,7 @@ function compareInlineContainer(nodeA, nodeB, path) {
       });
       newOffset += len;
     } else {
+      // 相等：检测 marks 差异并生成区间级 modify
       var runStart = null;
       for (var i = 0; i < len; i++) {
         var oldIdx = oldOffset + i;
@@ -143,16 +331,16 @@ function compareInlineContainer(nodeA, nodeB, path) {
         }
       }
       if (runStart !== null) {
-        var _i2 = len;
+        var _i4 = len;
         diffs.push({
           type: 'modify',
           path: _toConsumableArray(path),
           attrChange: {
             key: 'marks',
-            oldValue: oldMarks.slice(oldOffset + runStart, oldOffset + _i2),
-            newValue: newMarks.slice(newOffset + runStart, newOffset + _i2),
+            oldValue: oldMarks.slice(oldOffset + runStart, oldOffset + _i4),
+            newValue: newMarks.slice(newOffset + runStart, newOffset + _i4),
             fromOffset: newOffset + runStart,
-            toOffset: newOffset + _i2
+            toOffset: newOffset + _i4
           }
         });
       }
@@ -162,6 +350,31 @@ function compareInlineContainer(nodeA, nodeB, path) {
   }
   return diffs;
 }
+function nodesEqualForAlign(a, b) {
+  if (!a || !b) return false;
+  if (a.type !== b.type) return false;
+  // 对部分结构节点使用关键属性辅助匹配
+  if (a.type === 'heading') {
+    var _a$attrs$level, _a$attrs, _b$attrs$level, _b$attrs;
+    return ((_a$attrs$level = (_a$attrs = a.attrs) === null || _a$attrs === void 0 ? void 0 : _a$attrs.level) !== null && _a$attrs$level !== void 0 ? _a$attrs$level : null) === ((_b$attrs$level = (_b$attrs = b.attrs) === null || _b$attrs === void 0 ? void 0 : _b$attrs.level) !== null && _b$attrs$level !== void 0 ? _b$attrs$level : null);
+  }
+  if (a.type === 'codeBlock' || a.type === 'code_block') {
+    var _ref3, _a$attrs$language, _a$attrs2, _a$attrs3, _ref4, _b$attrs$language, _b$attrs2, _b$attrs3;
+    var langA = (_ref3 = (_a$attrs$language = (_a$attrs2 = a.attrs) === null || _a$attrs2 === void 0 ? void 0 : _a$attrs2.language) !== null && _a$attrs$language !== void 0 ? _a$attrs$language : (_a$attrs3 = a.attrs) === null || _a$attrs3 === void 0 ? void 0 : _a$attrs3.lang) !== null && _ref3 !== void 0 ? _ref3 : null;
+    var langB = (_ref4 = (_b$attrs$language = (_b$attrs2 = b.attrs) === null || _b$attrs2 === void 0 ? void 0 : _b$attrs2.language) !== null && _b$attrs$language !== void 0 ? _b$attrs$language : (_b$attrs3 = b.attrs) === null || _b$attrs3 === void 0 ? void 0 : _b$attrs3.lang) !== null && _ref4 !== void 0 ? _ref4 : null;
+    return langA === langB;
+  }
+  if (a.type === 'table_cell' || a.type === 'tableHeader' || a.type === 'table_header') {
+    var _a$attrs$colspan, _a$attrs4, _b$attrs$colspan, _b$attrs4, _a$attrs$rowspan, _a$attrs5, _b$attrs$rowspan, _b$attrs5;
+    var colspanA = (_a$attrs$colspan = (_a$attrs4 = a.attrs) === null || _a$attrs4 === void 0 ? void 0 : _a$attrs4.colspan) !== null && _a$attrs$colspan !== void 0 ? _a$attrs$colspan : 1;
+    var colspanB = (_b$attrs$colspan = (_b$attrs4 = b.attrs) === null || _b$attrs4 === void 0 ? void 0 : _b$attrs4.colspan) !== null && _b$attrs$colspan !== void 0 ? _b$attrs$colspan : 1;
+    var rowspanA = (_a$attrs$rowspan = (_a$attrs5 = a.attrs) === null || _a$attrs5 === void 0 ? void 0 : _a$attrs5.rowspan) !== null && _a$attrs$rowspan !== void 0 ? _a$attrs$rowspan : 1;
+    var rowspanB = (_b$attrs$rowspan = (_b$attrs5 = b.attrs) === null || _b$attrs5 === void 0 ? void 0 : _b$attrs5.rowspan) !== null && _b$attrs$rowspan !== void 0 ? _b$attrs$rowspan : 1;
+    return colspanA === colspanB && rowspanA === rowspanB;
+  }
+  // 默认仅按类型
+  return true;
+}
 function compareInlineContainerChildren(nodeA, nodeB, path) {
   var diffs = [];
   var aList = (nodeA.content || []).map(function (n, idx) {
@@ -182,15 +395,17 @@ function compareInlineContainerChildren(nodeA, nodeB, path) {
   });
   var equals = function equals(x, y) {
     if (!x || !y) return false;
+    // 仅按类型对齐，属性差异作为 modify 处理
     return x.n.type === y.n.type;
   };
   var pairs = lcsAlign(aList, bList, equals);
   var ai = 0,
     bi = 0;
-  for (var _i3 = 0, _pairs = pairs; _i3 < _pairs.length; _i3++) {
-    var _pairs$_i = _slicedToArray(_pairs[_i3], 2),
-      i = _pairs$_i[0],
-      j = _pairs$_i[1];
+  for (var _i5 = 0, _pairs2 = pairs; _i5 < _pairs2.length; _i5++) {
+    var _pairs2$_i = _slicedToArray(_pairs2[_i5], 2),
+      i = _pairs2$_i[0],
+      j = _pairs2$_i[1];
+    // 删除：使用新文档当前位置作为锚点路径
     while (ai < i) {
       var del = aList[ai];
       var anchorIdx = bi < bList.length ? bList[bi].idx : nodeB.content ? nodeB.content.length : 0;
@@ -201,6 +416,7 @@ function compareInlineContainerChildren(nodeA, nodeB, path) {
       });
       ai++;
     }
+    // 插入：直接使用新文档该节点的实际索引
     while (bi < j) {
       var ins = bList[bi];
       diffs.push({
@@ -210,6 +426,7 @@ function compareInlineContainerChildren(nodeA, nodeB, path) {
       });
       bi++;
     }
+    // modify：同类型节点进行属性对比，路径指向新文档该内联节点索引
     var aItem = aList[i];
     var bItem = bList[j];
     if (aItem && bItem) {
@@ -230,6 +447,8 @@ function compareInlineContainerChildren(nodeA, nodeB, path) {
     ai = i + 1;
     bi = j + 1;
   }
+
+  // 尾部删除
   while (ai < aList.length) {
     var _del = aList[ai++];
     var _anchorIdx = bi < bList.length ? bList[bi].idx : nodeB.content ? nodeB.content.length : 0;
@@ -239,6 +458,7 @@ function compareInlineContainerChildren(nodeA, nodeB, path) {
       node: _del.n
     });
   }
+  // 尾部插入
   while (bi < bList.length) {
     var _ins = bList[bi++];
     diffs.push({
@@ -249,29 +469,6 @@ function compareInlineContainerChildren(nodeA, nodeB, path) {
   }
   return diffs;
 }
-function nodesEqualForAlign(a, b) {
-  if (!a || !b) return false;
-  if (a.type !== b.type) return false;
-  if (a.type === 'heading') {
-    var _a$attrs$level, _a$attrs, _b$attrs$level, _b$attrs;
-    return ((_a$attrs$level = (_a$attrs = a.attrs) === null || _a$attrs === void 0 ? void 0 : _a$attrs.level) !== null && _a$attrs$level !== void 0 ? _a$attrs$level : null) === ((_b$attrs$level = (_b$attrs = b.attrs) === null || _b$attrs === void 0 ? void 0 : _b$attrs.level) !== null && _b$attrs$level !== void 0 ? _b$attrs$level : null);
-  }
-  if (a.type === 'codeBlock' || a.type === 'code_block') {
-    var _ref, _a$attrs$language, _a$attrs2, _a$attrs3, _ref2, _b$attrs$language, _b$attrs2, _b$attrs3;
-    var langA = (_ref = (_a$attrs$language = (_a$attrs2 = a.attrs) === null || _a$attrs2 === void 0 ? void 0 : _a$attrs2.language) !== null && _a$attrs$language !== void 0 ? _a$attrs$language : (_a$attrs3 = a.attrs) === null || _a$attrs3 === void 0 ? void 0 : _a$attrs3.lang) !== null && _ref !== void 0 ? _ref : null;
-    var langB = (_ref2 = (_b$attrs$language = (_b$attrs2 = b.attrs) === null || _b$attrs2 === void 0 ? void 0 : _b$attrs2.language) !== null && _b$attrs$language !== void 0 ? _b$attrs$language : (_b$attrs3 = b.attrs) === null || _b$attrs3 === void 0 ? void 0 : _b$attrs3.lang) !== null && _ref2 !== void 0 ? _ref2 : null;
-    return langA === langB;
-  }
-  if (a.type === 'table_cell' || a.type === 'tableHeader' || a.type === 'table_header') {
-    var _a$attrs$colspan, _a$attrs4, _b$attrs$colspan, _b$attrs4, _a$attrs$rowspan, _a$attrs5, _b$attrs$rowspan, _b$attrs5;
-    var colspanA = (_a$attrs$colspan = (_a$attrs4 = a.attrs) === null || _a$attrs4 === void 0 ? void 0 : _a$attrs4.colspan) !== null && _a$attrs$colspan !== void 0 ? _a$attrs$colspan : 1;
-    var colspanB = (_b$attrs$colspan = (_b$attrs4 = b.attrs) === null || _b$attrs4 === void 0 ? void 0 : _b$attrs4.colspan) !== null && _b$attrs$colspan !== void 0 ? _b$attrs$colspan : 1;
-    var rowspanA = (_a$attrs$rowspan = (_a$attrs5 = a.attrs) === null || _a$attrs5 === void 0 ? void 0 : _a$attrs5.rowspan) !== null && _a$attrs$rowspan !== void 0 ? _a$attrs$rowspan : 1;
-    var rowspanB = (_b$attrs$rowspan = (_b$attrs5 = b.attrs) === null || _b$attrs5 === void 0 ? void 0 : _b$attrs5.rowspan) !== null && _b$attrs$rowspan !== void 0 ? _b$attrs$rowspan : 1;
-    return colspanA === colspanB && rowspanA === rowspanB;
-  }
-  return true;
-}
 function lcsAlign(a, b, equals) {
   var n = a.length;
   var m = b.length;
@@ -280,9 +477,9 @@ function lcsAlign(a, b, equals) {
   }, function () {
     return Array(m + 1).fill(0);
   });
-  for (var _i4 = n - 1; _i4 >= 0; _i4--) {
+  for (var _i6 = n - 1; _i6 >= 0; _i6--) {
     for (var _j = m - 1; _j >= 0; _j--) {
-      dp[_i4][_j] = equals(a[_i4], b[_j]) ? 1 + dp[_i4 + 1][_j + 1] : Math.max(dp[_i4 + 1][_j], dp[_i4][_j + 1]);
+      dp[_i6][_j] = equals(a[_i6], b[_j]) ? 1 + dp[_i6 + 1][_j + 1] : Math.max(dp[_i6 + 1][_j], dp[_i6][_j + 1]);
     }
   }
   var pairs = [];
@@ -301,212 +498,51 @@ function lcsAlign(a, b, equals) {
   }
   return pairs;
 }
-function compareNodes(nodeA, nodeB) {
-  var path = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
-  var diffs = [];
-  if ((nodeA === null || nodeA === void 0 ? void 0 : nodeA.type) !== (nodeB === null || nodeB === void 0 ? void 0 : nodeB.type)) {
-    if (nodeA) {
-      diffs.push({
-        type: 'delete',
-        path: _toConsumableArray(path),
-        node: nodeA
-      });
-    }
-    if (nodeB) {
-      diffs.push({
-        type: 'insert',
-        path: _toConsumableArray(path),
-        node: nodeB
-      });
-    }
-    return diffs;
-  }
-  if ((nodeA === null || nodeA === void 0 ? void 0 : nodeA.type) === 'text' && (nodeB === null || nodeB === void 0 ? void 0 : nodeB.type) === 'text') {
-    if (nodeA.text !== nodeB.text) {
-      var textDiffs = dmp.diff_main(nodeA.text || '', nodeB.text || '');
-      dmp.diff_cleanupSemantic(textDiffs);
-      var textOffset = 0;
-      textDiffs.forEach(function (_ref3) {
-        var _ref4 = _slicedToArray(_ref3, 2),
-          operation = _ref4[0],
-          text = _ref4[1];
-        if (operation === -1) {
-          var diffItem = {
-            type: 'delete',
-            path: _toConsumableArray(path),
-            textDiff: {
-              offset: textOffset,
-              length: text.length,
-              text: text,
-              operation: operation
-            }
-          };
-          diffs.push(diffItem);
-        } else if (operation === 1) {
-          var _diffItem = {
-            type: 'insert',
-            path: _toConsumableArray(path),
-            textDiff: {
-              offset: textOffset,
-              length: text.length,
-              text: text,
-              operation: operation
-            }
-          };
-          diffs.push(_diffItem);
-          textOffset += text.length;
-        } else {
-          textOffset += text.length;
-        }
-      });
-    }
-    if (!haveSameMarks(nodeA.marks, nodeB.marks)) {
-      diffs.push({
-        type: 'modify',
-        path: _toConsumableArray(path),
-        attrChange: {
-          key: 'marks',
-          oldValue: nodeA.marks || [],
-          newValue: nodeB.marks || []
-        }
-      });
-    }
-    return diffs;
-  }
-  if (nodeA && nodeB && isInlineContainer(nodeA) && isInlineContainer(nodeB)) {
-    diffs.push.apply(diffs, _toConsumableArray(compareInlineContainer(nodeA, nodeB, path)));
-    diffs.push.apply(diffs, _toConsumableArray(compareInlineContainerChildren(nodeA, nodeB, path)));
-    return diffs;
-  }
-  var attrsA = (nodeA === null || nodeA === void 0 ? void 0 : nodeA.attrs) || {};
-  var attrsB = (nodeB === null || nodeB === void 0 ? void 0 : nodeB.attrs) || {};
-  var allAttrKeys = new Set([].concat(_toConsumableArray(Object.keys(attrsA)), _toConsumableArray(Object.keys(attrsB))));
-  for (var _i5 = 0, _Array$from = Array.from(allAttrKeys); _i5 < _Array$from.length; _i5++) {
-    var key = _Array$from[_i5];
-    if (attrsA[key] !== attrsB[key]) {
-      diffs.push({
-        type: 'modify',
-        path: _toConsumableArray(path),
-        attrChange: {
-          key: key,
-          oldValue: attrsA[key],
-          newValue: attrsB[key]
-        }
-      });
-    }
-  }
-  var contentA = (nodeA === null || nodeA === void 0 ? void 0 : nodeA.content) || [];
-  var contentB = (nodeB === null || nodeB === void 0 ? void 0 : nodeB.content) || [];
-  var pairs = lcsAlign(contentA, contentB, nodesEqualForAlign);
-  var ai = 0;
-  var bi = 0;
-  var _iterator3 = _createForOfIteratorHelper(pairs),
-    _step3;
-  try {
-    for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
-      var _step3$value = _slicedToArray(_step3.value, 2),
-        i = _step3$value[0],
-        j = _step3$value[1];
-      while (ai < i) {
-        var _delNode = contentA[ai];
-        diffs.push({
-          type: 'delete',
-          path: [].concat(_toConsumableArray(path), [bi]),
-          node: _delNode
-        });
-        ai++;
-      }
-      while (bi < j) {
-        var _insNode = contentB[bi];
-        diffs.push({
-          type: 'insert',
-          path: [].concat(_toConsumableArray(path), [bi]),
-          node: _insNode
-        });
-        bi++;
-      }
-      var childA = contentA[i];
-      var childB = contentB[j];
-      diffs.push.apply(diffs, _toConsumableArray(compareNodes(childA, childB, [].concat(_toConsumableArray(path), [j]))));
-      ai = i + 1;
-      bi = j + 1;
-    }
-  } catch (err) {
-    _iterator3.e(err);
-  } finally {
-    _iterator3.f();
-  }
-  while (ai < contentA.length) {
-    var delNode = contentA[ai];
-    diffs.push({
-      type: 'delete',
-      path: [].concat(_toConsumableArray(path), [bi]),
-      node: delNode
-    });
-    ai++;
-  }
-  while (bi < contentB.length) {
-    var insNode = contentB[bi];
-    diffs.push({
-      type: 'insert',
-      path: [].concat(_toConsumableArray(path), [bi]),
-      node: insNode
-    });
-    bi++;
-  }
-  return diffs;
-}
+
+/**
+ * 对比两个HTML文档并生成结构化差异
+ * @param {string} oldHtml - 旧HTML
+ * @param {string} newHtml - 新HTML
+ * @param {Array} extensions - Tiptap扩展数组
+ * @returns {Object} 包含差异信息的对象
+ */
 export function compareDocuments(oldHtml, newHtml, extensions) {
-  try {
-    var docA = parseHtmlToDoc(oldHtml, extensions);
-    var docB = parseHtmlToDoc(newHtml, extensions);
-    var diffs = compareNodes(docA, docB);
-    return {
-      oldDoc: docA,
-      newDoc: docB,
-      diffs: diffs,
-      hasChanges: diffs.length > 0
-    };
-  } catch (error) {
-    console.error('对比文档时出错:', error);
-    return {
-      oldDoc: null,
-      newDoc: null,
-      diffs: [],
-      hasChanges: false
-    };
-  }
+  var docA = parseHtmlToDoc(oldHtml, extensions);
+  var docB = parseHtmlToDoc(newHtml, extensions);
+  var diffs = compareNodes(docA, docB);
+  return {
+    oldDoc: docA,
+    newDoc: docB,
+    diffs: diffs,
+    hasChanges: diffs.length > 0
+  };
 }
+
+/**
+ * 将路径转换为ProseMirror位置
+ * @param {Array} path - 节点路径
+ * @param {Object} doc - ProseMirror文档
+ * @returns {number} 文档位置
+ */
 export function pathToPos(path, doc) {
-  if (!path || path.length === 0) {
-    return 0;
-  }
-  if (!doc) {
-    throw new Error('文档节点不能为空');
-  }
   var pos = 0;
   var current = doc;
   for (var i = 0; i < path.length; i++) {
-    var _current$type, _current$childCount;
+    var _current$childCount;
     var index = path[i];
-    var contentStartOffset = ((_current$type = current.type) === null || _current$type === void 0 ? void 0 : _current$type.name) === 'doc' ? 0 : 1;
+    var contentStartOffset = current.type.name === 'doc' ? 0 : 1;
     var resolvedPos = pos + contentStartOffset;
     var childCount = (_current$childCount = current.childCount) !== null && _current$childCount !== void 0 ? _current$childCount : 0;
     var effectiveIndex = Math.min(index, childCount);
     for (var j = 0; j < effectiveIndex; j++) {
       var child = current.child(j);
-      if (!child) {
-        break;
-      }
       resolvedPos += child.nodeSize;
     }
     pos = resolvedPos;
     if (index < childCount) {
       current = current.child(index);
-      if (!current) {
-        break;
-      }
     } else {
+      // Path points past the end in this doc (likely a deletion). Stop descending
       break;
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ctzhian/tiptap",
-  "version": "2.1.15",
+  "version": "2.1.17",
   "description": "基于 Tiptap 二次开发的编辑器组件",
   "main": "dist/index.js",
   "module": "dist/index.js",