@ctzhian/tiptap 2.6.1 → 2.7.1

package/dist/extension/node/TableHandler/plugin.js

@@ -1,6 +1,9 @@
 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 _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 _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; }
@@ -71,35 +74,40 @@ var TableHandleView = /*#__PURE__*/function () {
     _defineProperty(this, "mouseMoveHandler", function (event) {
       if (_this.menuFrozen || _this.mouseState === 'selecting') return;
       var target = event.target;
-      // If target is not in editor, don't process - this prevents state from being cleared
-      // when dragging outside the editor, which is the key to preventing errors
+      // 鼠标不在编辑器内时不处理，避免拖拽出界导致状态被清空
       if (!isHTMLElement(target) || !_this.editorView.dom.contains(target)) return;
 
-      // Check if mouse is over a table handle or extend button
+      // 判断是否悬停在手柄或扩展按钮上
       var isOverHandle = target.closest('.tiptap-table-handle-menu') !== null;
-      var isOverExtendButton = target.closest('.tiptap-table-extend-row-column-button') !== null;
+      var isOverExtendButton = target.closest('.tiptap-table-extend-row-column-button, .tiptap-table-add-button') !== null;
 
-      // If mouse is over handle/button, keep showing them (don't hide)
+      // 悬停其上时保持显示
       if (isOverHandle || isOverExtendButton) {
         return;
       }
 
-      // Check if mouse is near handle/button elements (within reasonable distance)
-      var handleElements = Array.from(_this.editorView.root.querySelectorAll('.tiptap-table-handle-menu, .tiptap-table-extend-row-column-button'));
+      // 检查鼠标是否在手柄或按钮附近，使用缓存优化性能
+      var handleRects = _this._getCachedHandleRects();
       var isNearHandle = false;
-      for (var _i = 0, _handleElements = handleElements; _i < _handleElements.length; _i++) {
-        var handleEl = _handleElements[_i];
-        if (!isHTMLElement(handleEl)) continue;
-        var rect = handleEl.getBoundingClientRect();
-        // Expand the rect by 10px on all sides for easier mouse movement
-        var expandedRect = new DOMRect(rect.left - 10, rect.top - 10, rect.width + 20, rect.height + 20);
-        if (event.clientX >= expandedRect.left && event.clientX <= expandedRect.right && event.clientY >= expandedRect.top && event.clientY <= expandedRect.bottom) {
-          isNearHandle = true;
-          break;
+      var _iterator = _createForOfIteratorHelper(handleRects),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var rect = _step.value;
+          // 周围扩展 10px 容错便于移动
+          var expandedRect = new DOMRect(rect.left - 10, rect.top - 10, rect.width + 20, rect.height + 20);
+          if (event.clientX >= expandedRect.left && event.clientX <= expandedRect.right && event.clientY >= expandedRect.top && event.clientY <= expandedRect.bottom) {
+            isNearHandle = true;
+            break;
+          }
         }
-      }
 
-      // If near handle, don't process further to avoid flickering
+        // 靠近手柄时不继续处理，避免闪烁
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
       if (isNearHandle) {
         return;
       }
@@ -114,7 +122,7 @@ var TableHandleView = /*#__PURE__*/function () {
       event.dataTransfer.dropEffect = 'move';
       hideElements('.prosemirror-dropcursor-block, .prosemirror-dropcursor-inline', _this.editorView.root);
 
-      // The mouse cursor coordinates, bounded to the table's bounding box.
+      // 将鼠标坐标限制在表格包围框内
       var _this$state$reference = _this.state.referencePosTable,
         tableLeft = _this$state$reference.left,
         tableRight = _this$state$reference.right,
@@ -125,7 +133,7 @@ var TableHandleView = /*#__PURE__*/function () {
         top: clamp(event.clientY, tableTop + 1, tableBottom - 1)
       };
 
-      // Gets the table cell element
+      // 获取所在位置的单元格元素
       var tableCellElements = _this.editorView.root.elementsFromPoint(boundedMouseCoords.left, boundedMouseCoords.top).filter(function (element) {
         return element.tagName === 'TD' || element.tagName === 'TH';
       });
@@ -141,19 +149,19 @@ var TableHandleView = /*#__PURE__*/function () {
       var rowIndex = cellPosition.rowIndex,
         colIndex = cellPosition.colIndex;
 
-      // Check what changed
+      // 判断被拖动的索引是否改变
       var oldIndex = _this.state.draggingState.draggedCellOrientation === 'row' ? _this.state.rowIndex : _this.state.colIndex;
       var newIndex = _this.state.draggingState.draggedCellOrientation === 'row' ? rowIndex : colIndex;
       var dispatchDecorationsTransaction = newIndex !== oldIndex;
       var mousePos = _this.state.draggingState.draggedCellOrientation === 'row' ? boundedMouseCoords.top : boundedMouseCoords.left;
 
-      // Check if anything needs updating
+      // 仅在单元格或鼠标位置变化时更新
       var cellChanged = _this.state.rowIndex !== rowIndex || _this.state.colIndex !== colIndex;
       var mousePosChanged = _this.state.draggingState.mousePos !== mousePos;
       if (cellChanged || mousePosChanged) {
         var _this$state$draggingS;
         var newCellRect = tableCellElement.getBoundingClientRect();
-        // Preserve original cell size during drag to prevent handle height changes
+        // 拖拽时保持初始单元格尺寸，避免手柄高度抖动
         var preservedCellRect = (_this$state$draggingS = _this.state.draggingState) !== null && _this$state$draggingS !== void 0 && _this$state$draggingS.originalCellSize ? new DOMRect(newCellRect.x, newCellRect.y, _this.state.draggingState.originalCellSize.width, _this.state.draggingState.originalCellSize.height) : newCellRect;
         _this.state = _objectSpread(_objectSpread({}, _this.state), {}, {
           rowIndex: rowIndex,
@@ -166,7 +174,7 @@ var TableHandleView = /*#__PURE__*/function () {
         _this.emitUpdate();
       }
 
-      // Dispatch decorations transaction if needed
+      // 如需刷新拖拽装饰则派发事务
       if (dispatchDecorationsTransaction) {
         _this.editor.view.dispatch(_this.editor.state.tr.setMeta(tableHandlePluginKey, true));
       }
@@ -198,8 +206,7 @@ var TableHandleView = /*#__PURE__*/function () {
       });
       if (!stateWithCellSel) return false;
 
-      // When mode is 'state', selectCellsByCoords returns EditorState
-      // Type assertion is safe here because we explicitly requested 'state' mode
+      // mode 为 state 时 selectCellsByCoords 返回 EditorState，这里的断言是安全的
       var editorState = stateWithCellSel;
       var dispatch = function dispatch(tr) {
         return _this.editor.view.dispatch(tr);
@@ -228,9 +235,9 @@ var TableHandleView = /*#__PURE__*/function () {
     });
     _defineProperty(this, "scrollHandler", function () {
       var _this$state2, _this$tableElement;
-      // When scrolling, update positions if handles are visible
+      // 滚动时若手柄可见则重新计算位置
       if ((_this$state2 = _this.state) !== null && _this$state2 !== void 0 && _this$state2.show && (_this$tableElement = _this.tableElement) !== null && _this$tableElement !== void 0 && _this$tableElement.isConnected) {
-        // Force update by recalculating positions
+        // 强制刷新定位
         _this.updatePositions();
       }
     });
@@ -245,18 +252,40 @@ var TableHandleView = /*#__PURE__*/function () {
     this.editorView.root.addEventListener('dragover', this.dragOverHandler);
     this.editorView.root.addEventListener('drop', this.dropHandler);
 
-    // Listen to scroll events to update handle positions when scrolling
+    // 监听滚动事件以更新手柄位置
     window.addEventListener('scroll', this.scrollHandler, true);
-    // Also listen to resize events
+    // 同时监听窗口尺寸变化
     window.addEventListener('resize', this.scrollHandler);
   }
   _createClass(TableHandleView, [{
+    key: "_getCachedHandleRects",
+    value:
+    // 获取缓存的手柄边界矩形，每100ms更新一次以提高性能
+    function _getCachedHandleRects() {
+      var _this$state3;
+      var now = Date.now();
+      if ((_this$state3 = this.state) !== null && _this$state3 !== void 0 && _this$state3._cachedHandleRects && this.state._cachedHandleRectsTime && now - this.state._cachedHandleRectsTime < 100) {
+        return this.state._cachedHandleRects;
+      }
+      var handleElements = Array.from(this.editorView.root.querySelectorAll('.tiptap-table-handle-menu, .tiptap-table-extend-row-column-button, .tiptap-table-add-button'));
+      var rects = handleElements.filter(isHTMLElement).map(function (el) {
+        return el.getBoundingClientRect();
+      });
+
+      // 更新缓存
+      if (this.state) {
+        this.state._cachedHandleRects = rects;
+        this.state._cachedHandleRectsTime = now;
+      }
+      return rects;
+    }
+  }, {
     key: "hideHandles",
     value: function hideHandles() {
-      var _this$state3;
-      if (!((_this$state3 = this.state) !== null && _this$state3 !== void 0 && _this$state3.show)) return;
+      var _this$state4;
+      if (!((_this$state4 = this.state) !== null && _this$state4 !== void 0 && _this$state4.show)) return;
 
-      // Don't hide handles during drag operations - preserve dragging state
+      // 拖拽进行中保持手柄显示，保留拖拽状态
       if (this.state.draggingState) return;
       this.state = _objectSpread(_objectSpread({}, this.state), {}, {
         show: false,
@@ -273,11 +302,11 @@ var TableHandleView = /*#__PURE__*/function () {
   }, {
     key: "_handleMouseMoveNow",
     value: function _handleMouseMoveNow(event) {
-      var _this$state4;
+      var _this$state5;
       var around = domCellAround(event.target);
 
-      // Hide handles while selecting inside a cell
-      if ((around === null || around === void 0 ? void 0 : around.type) === 'cell' && this.mouseState === 'down' && !((_this$state4 = this.state) !== null && _this$state4 !== void 0 && _this$state4.draggingState)) {
+      // 在单元格内拖拽选区时隐藏手柄
+      if ((around === null || around === void 0 ? void 0 : around.type) === 'cell' && this.mouseState === 'down' && !((_this$state5 = this.state) !== null && _this$state5 !== void 0 && _this$state5.draggingState)) {
         this.mouseState = 'selecting';
         this.hideHandles();
         return;
@@ -295,7 +324,7 @@ var TableHandleView = /*#__PURE__*/function () {
       });
       if (!coords) return;
 
-      // Find the table node at this position
+      // 基于坐标解析当前所在的表格节点
       var $pos = this.editor.view.state.doc.resolve(coords.pos);
       var blockInfo;
       for (var d = $pos.depth; d >= 0; d--) {
@@ -315,14 +344,14 @@ var TableHandleView = /*#__PURE__*/function () {
       var wrapper = safeClosest(around.domNode, '.tableWrapper');
       var widgetContainer = wrapper === null || wrapper === void 0 ? void 0 : wrapper.querySelector(':scope > .table-controls');
 
-      // Hovering around the table (outside cells)
+      // 悬停在表格外围（非单元格区域）
       if (around.type === 'wrapper') {
-        var _this$state5, _this$state6, _this$state7;
+        var _this$state6, _nearestRowIndex, _this$state7, _nearestCellRect, _this$state8;
         var below = event.clientY >= tableRect.bottom - 1 && event.clientY < tableRect.bottom + 20;
         var right = event.clientX >= tableRect.right - 1 && event.clientX < tableRect.right + 20;
         var cursorBeyondRightOrBottom = event.clientX > tableRect.right || event.clientY > tableRect.bottom;
 
-        // Calculate positions for extend buttons when hovering at edges
+        // 悬停在边缘时预先计算扩展按钮位置
         var referencePosLastRow;
         var referencePosLastCol;
         if (below || right) {
@@ -366,6 +395,25 @@ var TableHandleView = /*#__PURE__*/function () {
             }
           }
         }
+
+        // 尝试根据鼠标 Y 找到最近的行，并使用该行的首个单元格尺寸作为句柄参考，避免整行/整表尺寸
+        var nearestRowIndex;
+        var nearestCellRect;
+        if (!cursorBeyondRightOrBottom && tbody) {
+          var rows = Array.from(tbody.children);
+          var minDist = Number.POSITIVE_INFINITY;
+          rows.forEach(function (rowEl, idx) {
+            var rowRect = rowEl.getBoundingClientRect();
+            var dist = Math.abs(event.clientY - (rowRect.top + rowRect.height / 2));
+            if (dist < minDist) {
+              var _firstCell$getBoundin;
+              minDist = dist;
+              nearestRowIndex = idx;
+              var _firstCell = rowEl.children[0];
+              nearestCellRect = (_firstCell$getBoundin = _firstCell === null || _firstCell === void 0 ? void 0 : _firstCell.getBoundingClientRect()) !== null && _firstCell$getBoundin !== void 0 ? _firstCell$getBoundin : rowRect;
+            }
+          });
+        }
         this.state = _objectSpread(_objectSpread({}, this.state), {}, {
           show: true,
           showAddOrRemoveRowsButton: below,
@@ -376,47 +424,76 @@ var TableHandleView = /*#__PURE__*/function () {
           block: blockInfo.node,
           blockPos: blockInfo.pos,
           widgetContainer: widgetContainer,
-          colIndex: cursorBeyondRightOrBottom ? undefined : (_this$state5 = this.state) === null || _this$state5 === void 0 ? void 0 : _this$state5.colIndex,
-          rowIndex: cursorBeyondRightOrBottom ? undefined : (_this$state6 = this.state) === null || _this$state6 === void 0 ? void 0 : _this$state6.rowIndex,
-          referencePosCell: cursorBeyondRightOrBottom ? undefined : (_this$state7 = this.state) === null || _this$state7 === void 0 ? void 0 : _this$state7.referencePosCell
+          colIndex: cursorBeyondRightOrBottom ? undefined : (_this$state6 = this.state) === null || _this$state6 === void 0 ? void 0 : _this$state6.colIndex,
+          rowIndex: cursorBeyondRightOrBottom ? undefined : (_nearestRowIndex = nearestRowIndex) !== null && _nearestRowIndex !== void 0 ? _nearestRowIndex : (_this$state7 = this.state) === null || _this$state7 === void 0 ? void 0 : _this$state7.rowIndex,
+          referencePosCell: cursorBeyondRightOrBottom ? undefined : (_nearestCellRect = nearestCellRect) !== null && _nearestCellRect !== void 0 ? _nearestCellRect : (_this$state8 = this.state) === null || _this$state8 === void 0 ? void 0 : _this$state8.referencePosCell
         });
       } else {
-        var _blockInfo$node$conte3, _blockInfo$node$conte4, _this$state8;
-        // Hovering over a cell
+        var _blockInfo$node$conte3, _blockInfo$node$conte4, _this$state9;
+        // 悬停在单元格上
         var cellPosition = getCellIndicesFromDOM(around.domNode, blockInfo.node, this.editor);
         if (!cellPosition) return;
+        var tbodyEl = around.tbodyNode;
         var rowIndex = cellPosition.rowIndex,
           colIndex = cellPosition.colIndex;
+
+        // 如果单元格跨行，map 计算的 rowIndex 会指向起始行；这里用 DOM 行索引兜底，保证手柄定位在实际行
+        var trEl = safeClosest(around.domNode, 'tr');
+        if (tbodyEl && trEl) {
+          var domRowIndex = Array.from(tbodyEl.children).indexOf(trEl);
+          if (domRowIndex >= 0 && domRowIndex !== rowIndex) {
+            rowIndex = domRowIndex;
+          }
+        }
         var _cellRect = around.domNode.getBoundingClientRect();
+        var map = TableMap.get(blockInfo.node);
+        var cellIndex = rowIndex * map.width + colIndex;
+        var cellOffset = map.map[cellIndex];
+        var rect = cellOffset !== undefined ? map.findCell(cellOffset) : null;
+        var effectiveCellRect = _cellRect;
+
+        // 如果单元格跨行，按鼠标所在行拆分高度，句柄高度限定为单行高度
+        if (rect && rect.bottom - rect.top > 1) {
+          var span = rect.bottom - rect.top;
+          var unitHeight = _cellRect.height / span;
+          var clampedY = clamp(event.clientY, _cellRect.top, _cellRect.bottom);
+          var rowOffset = Math.min(span - 1, Math.max(0, Math.floor((clampedY - _cellRect.top) / unitHeight)));
+          var rowTop = _cellRect.top + unitHeight * rowOffset;
+          rowIndex = rect.top + rowOffset;
+          effectiveCellRect = new DOMRect(_cellRect.x, rowTop, _cellRect.width, unitHeight);
+        } else if (trEl) {
+          var trRect = trEl.getBoundingClientRect();
+          effectiveCellRect = new DOMRect(_cellRect.x, trRect.y, _cellRect.width, trRect.height);
+        }
         var _lastRowIndex = blockInfo.node.content.childCount - 1;
         var _lastColIndex = ((_blockInfo$node$conte3 = (_blockInfo$node$conte4 = blockInfo.node.content.firstChild) === null || _blockInfo$node$conte4 === void 0 ? void 0 : _blockInfo$node$conte4.content.childCount) !== null && _blockInfo$node$conte3 !== void 0 ? _blockInfo$node$conte3 : 0) - 1;
 
-        // Skip update if same cell
-        if ((_this$state8 = this.state) !== null && _this$state8 !== void 0 && _this$state8.show && this.tableId === blockInfo.node.attrs.id && this.state.rowIndex === rowIndex && this.state.colIndex === colIndex) {
+        // 与上次同一单元格则跳过
+        if ((_this$state9 = this.state) !== null && _this$state9 !== void 0 && _this$state9.show && this.tableId === blockInfo.node.attrs.id && this.state.rowIndex === rowIndex && this.state.colIndex === colIndex) {
           return;
         }
 
-        // Calculate positions for extend buttons
+        // 计算扩展按钮位置
         var _referencePosLastRow;
         var _referencePosLastCol;
         if (rowIndex === _lastRowIndex || colIndex === _lastColIndex) {
           var _this$tableElement3;
           var _tbody2 = (_this$tableElement3 = this.tableElement) === null || _this$tableElement3 === void 0 ? void 0 : _this$tableElement3.querySelector('tbody');
           if (_tbody2) {
-            // Get last row position
+            // 记录末行位置
             if (rowIndex === _lastRowIndex) {
               var _lastRow2 = _tbody2.children[_lastRowIndex];
               if (_lastRow2) {
                 _referencePosLastRow = _lastRow2.getBoundingClientRect();
               }
             }
-            // Get last column position
+            // 记录末列位置
             if (colIndex === _lastColIndex) {
-              // Find the rightmost column by checking all rows
+              // 在所有行里取最右侧单元格
               var _maxRight = 0;
               var _lastColRect = null;
-              for (var _i2 = 0; _i2 < _tbody2.children.length; _i2++) {
-                var _row = _tbody2.children[_i2];
+              for (var _i = 0; _i < _tbody2.children.length; _i++) {
+                var _row = _tbody2.children[_i];
                 if (_row && _row.children[_lastColIndex]) {
                   var _cell = _row.children[_lastColIndex];
                   var _cellRect2 = _cell.getBoundingClientRect();
@@ -427,13 +504,13 @@ var TableHandleView = /*#__PURE__*/function () {
                 }
               }
               if (_lastColRect) {
-                // Create a rect representing the entire last column
+                // 生成代表整列的矩形
                 var _firstRow = _tbody2.children[0];
                 var _lastRow3 = _tbody2.children[_lastRowIndex];
                 if (_firstRow && _lastRow3) {
-                  var _firstCell = _firstRow.children[_lastColIndex];
-                  if (_firstCell) {
-                    var _firstRect = _firstCell.getBoundingClientRect();
+                  var _firstCell2 = _firstRow.children[_lastColIndex];
+                  if (_firstCell2) {
+                    var _firstRect = _firstCell2.getBoundingClientRect();
                     _referencePosLastCol = new DOMRect(_lastColRect.right, _firstRect.top, 0, _lastRow3.getBoundingClientRect().bottom - _firstRect.top);
                   }
                 }
@@ -451,7 +528,7 @@ var TableHandleView = /*#__PURE__*/function () {
           block: blockInfo.node,
           blockPos: blockInfo.pos,
           draggingState: undefined,
-          referencePosCell: _cellRect,
+          referencePosCell: effectiveCellRect,
           colIndex: colIndex,
           rowIndex: rowIndex,
           widgetContainer: widgetContainer
@@ -463,12 +540,12 @@ var TableHandleView = /*#__PURE__*/function () {
   }, {
     key: "update",
     value: function update(view) {
-      var _this$state9, _this$tableElement4, _this$tableElement5;
+      var _this$state10, _this$tableElement4, _this$tableElement5;
       var pluginState = tableHandlePluginKey.getState(view.state);
       if (pluginState !== undefined && pluginState !== this.menuFrozen) {
         this.menuFrozen = pluginState;
       }
-      if (!((_this$state9 = this.state) !== null && _this$state9 !== void 0 && _this$state9.show)) return;
+      if (!((_this$state10 = this.state) !== null && _this$state10 !== void 0 && _this$state10.show)) return;
       if (!((_this$tableElement4 = this.tableElement) !== null && _this$tableElement4 !== void 0 && _this$tableElement4.isConnected)) {
         this.hideHandles();
         return;
@@ -479,7 +556,7 @@ var TableHandleView = /*#__PURE__*/function () {
         return;
       }
 
-      // Check if table changed
+      // 检查表格是否已变更
       var blockChanged = this.state.block !== tableInfo.node || this.state.blockPos !== tableInfo.pos;
       if (!tableInfo.node || tableInfo.node.type.name !== 'table' || !((_this$tableElement5 = this.tableElement) !== null && _this$tableElement5 !== void 0 && _this$tableElement5.isConnected)) {
         this.hideHandles();
@@ -489,11 +566,11 @@ var TableHandleView = /*#__PURE__*/function () {
         rowCount = _TableMap$get.height,
         colCount = _TableMap$get.width;
 
-      // Calculate new indices
+      // 计算新的行列索引
       var newRowIndex = this.state.rowIndex;
       var newColIndex = this.state.colIndex;
 
-      // Clamp indices if rows/columns were deleted
+      // 若删除了行/列则裁剪索引
       if (newRowIndex !== undefined && newRowIndex >= rowCount) {
         newRowIndex = rowCount ? rowCount - 1 : undefined;
       }
@@ -505,7 +582,7 @@ var TableHandleView = /*#__PURE__*/function () {
         throw new Error("Table block does not contain a 'tbody' HTML element. This should never happen.");
       }
 
-      // Calculate new reference positions
+      // 计算新的参考位置信息
       var newReferencePosCell = this.state.referencePosCell;
       if (newRowIndex !== undefined && newColIndex !== undefined) {
         var rowEl = tableBody.children[newRowIndex];
@@ -513,7 +590,7 @@ var TableHandleView = /*#__PURE__*/function () {
         if (cellEl) {
           var _this$state$draggingS2;
           var newCellRect = cellEl.getBoundingClientRect();
-          // Preserve original cell size during drag to prevent handle height changes
+          // 拖拽时保持最初的单元格尺寸，避免高度抖动
           if ((_this$state$draggingS2 = this.state.draggingState) !== null && _this$state$draggingS2 !== void 0 && _this$state$draggingS2.originalCellSize) {
             newReferencePosCell = new DOMRect(newCellRect.x, newCellRect.y, this.state.draggingState.originalCellSize.width, this.state.draggingState.originalCellSize.height);
           } else {
@@ -527,7 +604,7 @@ var TableHandleView = /*#__PURE__*/function () {
       }
       var newReferencePosTable = tableBody.getBoundingClientRect();
 
-      // Update last row/col positions if needed
+      // 如需显示扩展按钮则刷新末行末列位置
       var newReferencePosLastRow = this.state.referencePosLastRow;
       var newReferencePosLastCol = this.state.referencePosLastCol;
       if (this.state.showAddOrRemoveRowsButton || this.state.showAddOrRemoveColumnsButton) {
@@ -568,7 +645,7 @@ var TableHandleView = /*#__PURE__*/function () {
         }
       }
 
-      // Check if anything changed
+      // 若任一关键数据变化则推送更新
       var indicesChanged = newRowIndex !== this.state.rowIndex || newColIndex !== this.state.colIndex;
       var refPosChanged = newReferencePosCell !== this.state.referencePosCell || newReferencePosTable !== this.state.referencePosTable || newReferencePosLastRow !== this.state.referencePosLastRow || newReferencePosLastCol !== this.state.referencePosLastCol;
       if (blockChanged || indicesChanged || refPosChanged) {
@@ -588,15 +665,15 @@ var TableHandleView = /*#__PURE__*/function () {
   }, {
     key: "updatePositions",
     value: function updatePositions() {
-      var _this$state10, _this$tableElement6;
-      if (!((_this$state10 = this.state) !== null && _this$state10 !== void 0 && _this$state10.show) || !((_this$tableElement6 = this.tableElement) !== null && _this$tableElement6 !== void 0 && _this$tableElement6.isConnected)) return;
+      var _this$state11, _this$tableElement6;
+      if (!((_this$state11 = this.state) !== null && _this$state11 !== void 0 && _this$state11.show) || !((_this$tableElement6 = this.tableElement) !== null && _this$tableElement6 !== void 0 && _this$tableElement6.isConnected)) return;
       var tableInfo = getTableFromDOM(this.tableElement, this.editor);
       if (!tableInfo || tableInfo.node.type.name !== 'table') return;
       var tableBody = this.tableElement.querySelector('tbody');
       if (!tableBody) return;
       var newReferencePosTable = tableBody.getBoundingClientRect();
 
-      // Update cell position if we have row/col indices
+      // 若已有行列索引则同步单元格位置
       var newReferencePosCell = this.state.referencePosCell;
       if (this.state.rowIndex !== undefined && this.state.colIndex !== undefined) {
         var rowEl = tableBody.children[this.state.rowIndex];
@@ -604,7 +681,7 @@ var TableHandleView = /*#__PURE__*/function () {
         if (cellEl) {
           var _this$state$draggingS3;
           var newCellRect = cellEl.getBoundingClientRect();
-          // Preserve original cell size during drag
+          // 拖拽时保留初始尺寸
           if ((_this$state$draggingS3 = this.state.draggingState) !== null && _this$state$draggingS3 !== void 0 && _this$state$draggingS3.originalCellSize) {
             newReferencePosCell = new DOMRect(newCellRect.x, newCellRect.y, this.state.draggingState.originalCellSize.width, this.state.draggingState.originalCellSize.height);
           } else {
@@ -613,7 +690,7 @@ var TableHandleView = /*#__PURE__*/function () {
         }
       }
 
-      // Update last row/col positions if needed
+      // 如需显示扩展按钮则刷新末行末列位置
       var newReferencePosLastRow = this.state.referencePosLastRow;
       var newReferencePosLastCol = this.state.referencePosLastCol;
       if (this.state.showAddOrRemoveRowsButton || this.state.showAddOrRemoveColumnsButton) {
@@ -654,7 +731,7 @@ var TableHandleView = /*#__PURE__*/function () {
         }
       }
 
-      // Check if positions actually changed (compare individual properties)
+      // 对比具体属性，确认位置是否发生变化
       var refPosChanged = !newReferencePosCell || !this.state.referencePosCell || newReferencePosCell.x !== this.state.referencePosCell.x || newReferencePosCell.y !== this.state.referencePosCell.y || newReferencePosTable.x !== this.state.referencePosTable.x || newReferencePosTable.y !== this.state.referencePosTable.y || newReferencePosLastRow && this.state.referencePosLastRow && (newReferencePosLastRow.x !== this.state.referencePosLastRow.x || newReferencePosLastRow.y !== this.state.referencePosLastRow.y) || newReferencePosLastCol && this.state.referencePosLastCol && (newReferencePosLastCol.x !== this.state.referencePosLastCol.x || newReferencePosLastCol.y !== this.state.referencePosLastCol.y);
       if (refPosChanged) {
         this.state = _objectSpread(_objectSpread({}, this.state), {}, {
@@ -730,9 +807,7 @@ export function TableHandlePlugin(editor, emitUpdate) {
           });
         }
 
-        // Return empty decorations if:
-        // - original index is same as new index (no change)
-        // - editor is not defined for some reason
+        // 若无变更或 editor 不存在，直接返回已有装饰
         if (newIndex === originalIndex || !editor) {
           return DecorationSet.create(state.doc, decorations);
         }
@@ -744,9 +819,7 @@ export function TableHandlePlugin(editor, emitUpdate) {
               return;
             }
 
-            // Creates a decoration at the start or end of each cell,
-            // depending on whether the new index is before or after the
-            // original index.
+            // 根据拖动方向在单元格首尾插入装饰
             var decorationPos = cell.pos + (newIndex > originalIndex ? cellNode.nodeSize - 2 : 2);
             decorations.push(Decoration.widget(decorationPos, function () {
               var widget = document.createElement('div');
@@ -756,11 +829,7 @@ export function TableHandlePlugin(editor, emitUpdate) {
               widget.style.right = '0';
               widget.style.zIndex = '20';
               widget.style.pointerEvents = 'none';
-              // This is only necessary because the drop indicator's height
-              // is an even number of pixels, whereas the border between
-              // table cells is an odd number of pixels. So this makes the
-              // positioning slightly more consistent regardless of where
-              // the row is being dropped.
+              // 处理奇偶像素差，避免行插入指示线的视觉偏差
               if (newIndex > originalIndex) {
                 widget.style.bottom = '-1px';
               } else {
@@ -778,9 +847,7 @@ export function TableHandlePlugin(editor, emitUpdate) {
             if (!cellNode) {
               return;
             }
-            // Creates a decoration at the start or end of each cell,
-            // depending on whether the new index is before or after the
-            // original index.
+            // 根据拖动方向在单元格首尾插入装饰
             var decorationPos = cell.pos + (newIndex > originalIndex ? cellNode.nodeSize - 2 : 2);
             decorations.push(Decoration.widget(decorationPos, function () {
               var widget = document.createElement('div');
@@ -790,11 +857,7 @@ export function TableHandlePlugin(editor, emitUpdate) {
               widget.style.bottom = '0';
               widget.style.zIndex = '20';
               widget.style.pointerEvents = 'none';
-              // This is only necessary because the drop indicator's width
-              // is an even number of pixels, whereas the border between
-              // table cells is an odd number of pixels. So this makes the
-              // positioning slightly more consistent regardless of where
-              // the column is being dropped.
+              // 处理奇偶像素差，避免列插入指示线的视觉偏差
               if (newIndex > originalIndex) {
                 widget.style.right = '-1px';
               } else {
@@ -812,17 +875,15 @@ export function TableHandlePlugin(editor, emitUpdate) {
   });
 }
 
-/**
- * Shared drag start handler for table rows and columns
- */
+/** 行/列通用的拖拽起始处理 */
 var tableDragStart = function tableDragStart(orientation, event) {
   var _tableHandleView;
-  // If state doesn't exist, try to recover from DOM or data attributes
+  // 若状态不存在，尝试从 DOM 或 data 属性恢复
   if (!((_tableHandleView = tableHandleView) !== null && _tableHandleView !== void 0 && _tableHandleView.state)) {
     var _tableHandleView2, _tableHandleView3;
     var handleElement = event.currentTarget;
 
-    // Try to recover from data attributes first (set by React component)
+    // 优先使用组件写入的 data 属性恢复
     var dataIndex = handleElement.dataset.tableIndex;
     var dataTablePos = handleElement.dataset.tablePos;
     var dataTableId = handleElement.dataset.tableId;
@@ -830,7 +891,7 @@ var tableDragStart = function tableDragStart(orientation, event) {
       var _index = parseInt(dataIndex, 10);
       var _blockPos = parseInt(dataTablePos, 10);
       if (!isNaN(_index) && !isNaN(_blockPos)) {
-        // Try to find the table node
+        // 尝试找到对应表格节点
         var tableNode = tableHandleView.editor.state.doc.nodeAt(_blockPos);
         if (tableNode && isTableNode(tableNode)) {
           var tableWrapper = safeClosest(handleElement, '.tableWrapper');
@@ -838,7 +899,7 @@ var tableDragStart = function tableDragStart(orientation, event) {
           if (tbody) {
             var tableRect = tbody.getBoundingClientRect();
 
-            // Create minimal state for drag operation
+            // 构造最小拖拽状态
             var recoveredState = {
               show: true,
               showAddOrRemoveRowsButton: false,
@@ -857,18 +918,18 @@ var tableDragStart = function tableDragStart(orientation, event) {
       }
     }
 
-    // If still no state, try to recover from DOM
+    // 若仍无状态，再尝试基于 DOM 恢复
     if (!((_tableHandleView2 = tableHandleView) !== null && _tableHandleView2 !== void 0 && _tableHandleView2.state)) {
       var _tableWrapper = safeClosest(handleElement, '.tableWrapper');
       if (!_tableWrapper || !tableHandleView) {
-        // Can't recover - cancel drag silently
+        // 无法恢复则静默取消拖拽
         if (event.dataTransfer) {
           event.dataTransfer.effectAllowed = 'none';
         }
         return;
       }
 
-      // Try to recover table info from DOM
+      // 基于 DOM 获取表格信息
       var tableInfo = getTableFromDOM(_tableWrapper, tableHandleView.editor);
       if (!tableInfo) {
         if (event.dataTransfer) {
@@ -877,7 +938,7 @@ var tableDragStart = function tableDragStart(orientation, event) {
         return;
       }
 
-      // Recover basic state from DOM
+      // 构建基础状态
       var _tbody3 = _tableWrapper.querySelector('tbody');
       if (!_tbody3) {
         if (event.dataTransfer) {
@@ -886,13 +947,11 @@ var tableDragStart = function tableDragStart(orientation, event) {
         return;
       }
 
-      // Try to determine index from handle position
-      // This is a fallback - ideally state should exist
+      // 通过手柄位置估算索引（兜底方案）
       var _tableRect = _tbody3.getBoundingClientRect();
       var handleRect = handleElement.getBoundingClientRect();
 
-      // Approximate index based on handle position
-      // This is not perfect but better than throwing an error
+      // 通过坐标粗略推算索引，避免报错
       var approximateIndex = 0;
       if (orientation === 'row') {
         var rowHeight = _tableRect.height / tableInfo.node.content.childCount;
@@ -903,7 +962,7 @@ var tableDragStart = function tableDragStart(orientation, event) {
         approximateIndex = Math.floor((handleRect.left - _tableRect.left) / colWidth);
       }
 
-      // Create minimal state for drag operation
+      // 构造最小拖拽状态
       var _recoveredState = {
         show: true,
         showAddOrRemoveRowsButton: false,
@@ -919,7 +978,7 @@ var tableDragStart = function tableDragStart(orientation, event) {
       tableHandleView.state = _recoveredState;
     }
 
-    // Final check - if still no state, cancel drag
+    // 最终仍无状态则取消拖拽
     if (!((_tableHandleView3 = tableHandleView) !== null && _tableHandleView3 !== void 0 && _tableHandleView3.state)) {
       if (event.dataTransfer) {
         event.dataTransfer.effectAllowed = 'none';
@@ -932,7 +991,7 @@ var tableDragStart = function tableDragStart(orientation, event) {
     editor = _tableHandleView4.editor;
   var index = orientation === 'col' ? state.colIndex : state.rowIndex;
   if (index === undefined) {
-    // Can't determine index - cancel drag silently
+    // 无法确定索引，静默取消
     if (event.dataTransfer) {
       event.dataTransfer.effectAllowed = 'none';
     }
@@ -942,14 +1001,14 @@ var tableDragStart = function tableDragStart(orientation, event) {
     referencePosCell = state.referencePosCell;
   var mousePos = orientation === 'col' ? event.clientX : event.clientY;
 
-  // Clear cell selection to prevent table reference collapse
+  // 清除单元格选区，避免表格引用塌缩
   if (editor.state.selection instanceof CellSelection) {
     var safeSel = TextSelection.near(editor.state.doc.resolve(blockPos), 1);
     editor.view.dispatch(editor.state.tr.setSelection(safeSel));
   }
   var dragImage = createTableDragImage(editor, orientation, index, blockPos);
 
-  // Configure drag image
+  // 配置拖拽预览图
   if (event.dataTransfer) {
     var _handleRect = event.currentTarget.getBoundingClientRect();
     var offset = orientation === 'col' ? {
@@ -963,7 +1022,7 @@ var tableDragStart = function tableDragStart(orientation, event) {
     event.dataTransfer.setDragImage(dragImage, offset.x, offset.y);
   }
 
-  // Cleanup drag image
+  // 清理拖拽预览图
   var cleanup = function cleanup() {
     var _dragImage$parentNode;
     return (_dragImage$parentNode = dragImage.parentNode) === null || _dragImage$parentNode === void 0 ? void 0 : _dragImage$parentNode.removeChild(dragImage);
@@ -976,13 +1035,13 @@ var tableDragStart = function tableDragStart(orientation, event) {
   });
   var initialOffset = referencePosCell ? (orientation === 'col' ? referencePosCell.left : referencePosCell.top) - mousePos : 0;
 
-  // Save original cell size to preserve it during drag
+  // 记录原始单元格尺寸，拖拽中保持不变
   var originalCellSize = referencePosCell ? {
     width: referencePosCell.width,
     height: referencePosCell.height
   } : undefined;
 
-  // Update dragging state
+  // 写回拖拽状态
   tableHandleView.state = _objectSpread(_objectSpread({}, state), {}, {
     draggingState: {
       draggedCellOrientation: orientation,
@@ -996,27 +1055,21 @@ var tableDragStart = function tableDragStart(orientation, event) {
   editor.view.dispatch(editor.state.tr.setMeta(tableHandlePluginKey, true));
 };
 
-/**
- * Callback for column drag handle
- */
+/** 列拖拽句柄回调 */
 export var colDragStart = function colDragStart(event) {
   return tableDragStart('col', _objectSpread(_objectSpread({}, event), {}, {
     clientY: 0
   }));
 };
 
-/**
- * Callback for row drag handle
- */
+/** 行拖拽句柄回调 */
 export var rowDragStart = function rowDragStart(event) {
   return tableDragStart('row', _objectSpread(_objectSpread({}, event), {}, {
     clientX: 0
   }));
 };
 
-/**
- * Drag end cleanup
- */
+/** 拖拽结束后的清理 */
 export var dragEnd = function dragEnd() {
   if (!tableHandleView || tableHandleView.state === undefined) {
     return;