@ctzhian/tiptap 0.5.5 → 1.0.0

package/dist/util/decorations.js

@@ -0,0 +1,302 @@
+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 { Decoration, DecorationSet } from '@tiptap/pm/view';
+import { pathToPos } from "./structuredDiff";
+
+/**
+ * 创建插入内容的装饰
+ * @param {number} from - 开始位置
+ * @param {number} to - 结束位置
+ * @returns {Decoration} 装饰对象
+ */
+function createInsertDecoration(from, to) {
+  return Decoration.inline(from, to, {
+    class: 'diff-insert-highlight',
+    style: 'background-color: #d4edda; color: #28a745; padding: 2px 4px; border-radius: 3px; margin: 0 1px; border: 1px dashed #28a745;'
+  });
+}
+
+/**
+ * 创建修改内容的装饰
+ * @param {number} from - 开始位置
+ * @param {number} to - 结束位置
+ * @returns {Decoration} 装饰对象
+ */
+function createModifyDecoration(from, to) {
+  return Decoration.inline(from, to, {
+    class: 'diff-modify-highlight',
+    style: 'background-color: #fff3cd; color: #856404; padding: 2px 4px; border-radius: 3px; margin: 0 1px; border: 1px dashed #856404;'
+  });
+}
+
+/**
+ * 创建删除内容的widget装饰
+ * @param {number} pos - 插入位置
+ * @param {Object} deletedNode - 被删除的节点
+ * @returns {Decoration} widget装饰对象
+ */
+function createDeleteWidget(pos, deletedNode) {
+  var widget = document.createElement('span');
+  widget.className = 'diff-delete-widget';
+  widget.style.cssText = "\n    background-color: rgba(220, 53, 69, 0.1);\n    color: #dc3545;\n    text-decoration: line-through;\n    padding: 2px 4px;\n    border-radius: 3px;\n    margin: 0 1px;\n    border: 1px dashed #dc3545;\n    font-style: italic;\n  ";
+
+  // 提取删除内容的文本
+  var deletedText = extractTextFromNode(deletedNode);
+  widget.textContent = deletedText || '[已删除]';
+
+  // 添加工具提示
+  widget.title = "\u5220\u9664\u7684\u5185\u5BB9: ".concat(deletedText);
+  return Decoration.widget(pos, widget, {
+    side: 1
+  });
+}
+
+/**
+ * 从节点中提取文本内容
+ * @param {Object} node - ProseMirror节点
+ * @returns {string} 提取的文本
+ */
+function extractTextFromNode(node) {
+  if (!node) return '';
+  if (node.type === 'text') {
+    return node.text || '';
+  }
+  if (node.content && Array.isArray(node.content)) {
+    return node.content.map(function (child) {
+      return extractTextFromNode(child);
+    }).join('');
+  }
+  return '';
+}
+
+/**
+ * 根据差异数组创建装饰集合
+ * @param {Array} diffs - 差异数组
+ * @param {Object} doc - ProseMirror文档
+ * @returns {DecorationSet} 装饰集合
+ */
+export function createDecorationsFromDiffs(diffs, doc) {
+  var decorations = [];
+  diffs.forEach(function (diff) {
+    try {
+      var pos = pathToPos(diff.path, doc);
+      var pmNodeAtPath = getPMNodeAtPath(diff.path, doc);
+      switch (diff.type) {
+        case 'insert':
+          if (diff.textDiff) {
+            // 文本级别的插入
+            var base = adjustBaseForInline(pmNodeAtPath, pos);
+            var from = base + mapInlineOffsetToPM(pmNodeAtPath, diff.textDiff.offset);
+            var to = base + mapInlineOffsetToPM(pmNodeAtPath, diff.textDiff.offset + diff.textDiff.length);
+            decorations.push(createInsertDecoration(from, to));
+          } else if (diff.node) {
+            // 节点级别的插入
+            if (pmNodeAtPath) {
+              var _text;
+              if (pmNodeAtPath.isText && (((_text = pmNodeAtPath.text) === null || _text === void 0 ? void 0 : _text.length) || 0) > 0) {
+                var _text2;
+                var _from = pos;
+                var _to = pos + (((_text2 = pmNodeAtPath.text) === null || _text2 === void 0 ? void 0 : _text2.length) || 0);
+                decorations.push(createInsertDecoration(_from, _to));
+              } else {
+                var _from2 = pos;
+                var _to2 = pos + pmNodeAtPath.nodeSize;
+                decorations.push(Decoration.node(_from2, _to2, {
+                  class: 'diff-insert-highlight',
+                  style: 'background-color: rgba(40,167,69,0.12); border-radius: 3px; border: 1px dashed #28a745;'
+                }));
+              }
+            } else {
+              // 回退到基于 JSON 节点的估算
+              var nodeSize = getNodeSize(diff.node);
+              var _from3 = pos + 1;
+              var _to3 = pos + nodeSize - 1;
+              if (_to3 > _from3) {
+                decorations.push(createInsertDecoration(_from3, _to3));
+              }
+            }
+          }
+          break;
+        case 'delete':
+          if (diff.textDiff) {
+            // 文本级别的删除 - 使用widget显示
+            var _base = adjustBaseForInline(pmNodeAtPath, pos);
+            var widgetPos = _base + mapInlineOffsetToPM(pmNodeAtPath, diff.textDiff.offset);
+            decorations.push(createDeleteWidget(widgetPos, {
+              type: 'text',
+              text: diff.textDiff.text
+            }));
+          } else if (diff.node) {
+            // 节点级别的删除 - 使用widget显示
+            decorations.push(createDeleteWidget(pos, diff.node));
+          }
+          break;
+        case 'modify':
+          if (diff.attrChange) {
+            // 基于 marks 的区间高亮
+            if (diff.attrChange.key === 'marks' && typeof diff.attrChange.fromOffset === 'number' && typeof diff.attrChange.toOffset === 'number') {
+              var _base2 = adjustBaseForInline(pmNodeAtPath, pos);
+              var _from4 = _base2 + mapInlineOffsetToPM(pmNodeAtPath, diff.attrChange.fromOffset);
+              var _to4 = _base2 + mapInlineOffsetToPM(pmNodeAtPath, diff.attrChange.toOffset);
+              if (_to4 > _from4) {
+                decorations.push(createModifyDecoration(_from4, _to4));
+              }
+            } else if (diff.attrChange.key === 'marks' && pmNodeAtPath && pmNodeAtPath.isText) {
+              var textLength = pmNodeAtPath.text ? pmNodeAtPath.text.length : 0;
+              if (textLength > 0) {
+                var _base3 = adjustBaseForInline(pmNodeAtPath, pos);
+                decorations.push(createModifyDecoration(_base3, _base3 + textLength));
+              }
+            } else {
+              var _type;
+              // 其他属性修改 - 节点级高亮
+              var nodeName = (pmNodeAtPath === null || pmNodeAtPath === void 0 || (_type = pmNodeAtPath.type) === null || _type === void 0 ? void 0 : _type.name) || '';
+              var isDetailsFamily = nodeName === 'details' || nodeName === 'detailsSummary' || nodeName === 'detailsContent';
+              if (!isDetailsFamily) {
+                var _nodeSize = getPMNodeSizeAtPath(diff.path, doc);
+                var _from5 = pos;
+                var _to5 = pos + _nodeSize;
+                decorations.push(Decoration.node(_from5, _to5, {
+                  class: 'diff-modify-highlight',
+                  style: 'background-color: rgba(255,193,7,0.12); border-radius: 3px; border: 1px dashed #856404;'
+                }));
+              }
+            }
+          }
+          break;
+      }
+    } catch (error) {
+      console.warn('创建装饰时出错:', error, diff);
+    }
+  });
+  return DecorationSet.create(doc, decorations);
+}
+
+/**
+ * 获取指定路径节点的大小
+ * @param {Array} path - 节点路径
+ * @param {Object} doc - ProseMirror文档
+ * @returns {number} 节点大小
+ */
+function getNodeSizeAtPath(path, doc) {
+  var currentNode = doc;
+  var _iterator = _createForOfIteratorHelper(path),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var index = _step.value;
+      if (currentNode.content && currentNode.content[index]) {
+        currentNode = currentNode.content[index];
+      } else {
+        return 1; // 默认大小
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return getNodeSize(currentNode);
+}
+function getPMNodeAtPath(path, doc) {
+  var current = doc;
+  var _iterator2 = _createForOfIteratorHelper(path),
+    _step2;
+  try {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+      var _childCount;
+      var index = _step2.value;
+      if (!current) return null;
+      var childCount = (_childCount = current.childCount) !== null && _childCount !== void 0 ? _childCount : 0;
+      if (index >= childCount) return null;
+      current = current.child(index);
+    }
+  } catch (err) {
+    _iterator2.e(err);
+  } finally {
+    _iterator2.f();
+  }
+  return current;
+}
+function getPMNodeSizeAtPath(path, doc) {
+  var node = getPMNodeAtPath(path, doc);
+  return node ? node.nodeSize : 1;
+}
+
+// 对内联文本容器（paragraph/heading）的字符偏移，基于容器内容起点（跳过开标签）
+function adjustBaseForInline(pmNodeAtPath, absolutePos) {
+  if (!pmNodeAtPath) return absolutePos;
+  // 如果路径对应的是容器本身（非文本子节点），字符偏移应从内容起点计算
+  // 但此处无法直接判断路径是否止于容器。我们采用经验：
+  // - 若 pmNodeAtPath 不是 text，则偏移从 absolutePos + 1 开始（跳过开标签）
+  // - 若是 text，则 absolutePos 已指向文本起点
+  if (pmNodeAtPath.isText) return absolutePos;
+  return absolutePos + 1;
+}
+
+// 将“内联字符偏移”映射到 PM 位置（计入文本节点间的边界）
+function mapInlineOffsetToPM(pmNodeAtPath, inlineOffset) {
+  var _childCount2;
+  if (!pmNodeAtPath) return inlineOffset;
+  // 如果当前就是文本节点，offset 等同
+  if (pmNodeAtPath.isText) return inlineOffset;
+  // 若是段落/标题容器，则 inlineOffset 是按合并后的字符序列统计，需要遍历其子 text 节点求对应 PM 偏移
+  var remaining = inlineOffset;
+  var acc = 0;
+  var childCount = (_childCount2 = pmNodeAtPath.childCount) !== null && _childCount2 !== void 0 ? _childCount2 : 0;
+  for (var i = 0; i < childCount; i++) {
+    var _child$text;
+    var child = pmNodeAtPath.child(i);
+    var size = child.isText ? ((_child$text = child.text) === null || _child$text === void 0 ? void 0 : _child$text.length) || 0 : child.nodeSize; // 非文本节点视作整体
+    if (child.isText) {
+      if (remaining <= size) {
+        acc += remaining;
+        return acc;
+      }
+      acc += size;
+      remaining -= size;
+    } else {
+      // 跳过非文本节点的整体大小
+      acc += size;
+    }
+  }
+  // 超出则落在末尾
+  return acc;
+}
+
+/**
+ * 创建空的装饰集合
+ * @param {Object} doc - ProseMirror文档
+ * @returns {DecorationSet} 空装饰集合
+ */
+export function createEmptyDecorationSet(doc) {
+  return DecorationSet.create(doc, []);
+}
+
+/**
+ * 获取节点大小（包含子节点）
+ * @param {Object} node - ProseMirror节点
+ * @returns {number} 节点大小
+ */
+export function getNodeSize(node) {
+  if (node.type === 'text') {
+    return node.text ? node.text.length : 0;
+  }
+  var size = 2; // 开始和结束标记
+  if (node.content && Array.isArray(node.content)) {
+    var _iterator3 = _createForOfIteratorHelper(node.content),
+      _step3;
+    try {
+      for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+        var child = _step3.value;
+        size += getNodeSize(child);
+      }
+    } catch (err) {
+      _iterator3.e(err);
+    } finally {
+      _iterator3.f();
+    }
+  }
+  return size;
+}

package/dist/util/structuredDiff.d.ts

@@ -0,0 +1,59 @@
+import { Extensions } from '@tiptap/core';
+export interface TextDiff {
+    offset: number;
+    length: number;
+    text: string;
+    operation: number;
+}
+export interface AttrChange {
+    key: string;
+    oldValue: any;
+    newValue: any;
+    fromOffset?: number;
+    toOffset?: number;
+}
+export interface DiffItem {
+    type: 'insert' | 'delete' | 'modify';
+    path: number[];
+    node?: any;
+    textDiff?: TextDiff;
+    attrChange?: AttrChange;
+}
+export interface DocumentComparison {
+    oldDoc: any;
+    newDoc: any;
+    diffs: DiffItem[];
+    hasChanges: boolean;
+}
+export interface ProseMirrorNode {
+    type: string;
+    attrs?: Record<string, any>;
+    content?: ProseMirrorNode[];
+    text?: string;
+    marks?: Array<{
+        type: string;
+        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;