@ctzhian/tiptap 2.6.1 → 2.7.1

package/dist/extension/component/TableHandle/TableHandleMenu.js

@@ -1,14 +1,14 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function (_e) { function e(_x) { return _e.apply(this, arguments); } e.toString = function () { return _e.toString(); }; return e; }(function (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 (_e2) { function e(_x2) { return _e2.apply(this, arguments); } e.toString = function () { return _e2.toString(); }; return e; }(function (e) { didErr = true; err = e; }), f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+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 ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-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 _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); }
@@ -19,11 +19,11 @@ import { AlignBottomIcon, AlignCenterIcon, AlignJustifyIcon, AlignLeftIcon, Alig
 import { DeleteBack2LineIcon } from "../../../component/Icons/delete-back-2-line-icon";
 import { getThemeTextBgColor, getThemeTextColor } from "../../../contants/enums";
 import { Box, Divider, Typography, useTheme } from '@mui/material';
-import { addColumnAfter, addRowAfter, CellSelection, deleteCellSelection, TableMap } from '@tiptap/pm/tables';
+import { addColumnAfter, CellSelection, deleteCellSelection, TableMap } from '@tiptap/pm/tables';
 import React, { useCallback, useEffect, useMemo, useState } from 'react';
 import { MoreLineIcon } from "../../../component/Icons/more-line-icon";
 import Menu from "../../../component/Menu";
-import { getColumnCells, getIndexCoordinates, getRowCells, getTable, selectCellsByCoords } from "../../../util/table-utils";
+import { getColumnCells, getIndexCoordinates, getRowCells, getRowOriginCoords, getTable, getUniqueCellsWithRect, selectCellsByCoords } from "../../../util/table-utils";
 import { dragEnd } from "../../node/TableHandler/plugin";
 import "./TableHandleMenu.css";
 export var TableHandleMenu = function TableHandleMenu(_ref) {
@@ -40,30 +40,46 @@ export var TableHandleMenu = function TableHandleMenu(_ref) {
     _useState2 = _slicedToArray(_useState, 2),
     isDragging = _useState2[0],
     setIsDragging = _useState2[1];
+  var dedupeCells = useCallback(function (cells) {
+    var seen = new Set();
+    return cells.filter(function (cell) {
+      if (seen.has(cell.pos)) return false;
+      seen.add(cell.pos);
+      return true;
+    });
+  }, []);
   var selectRowOrColumn = useCallback(function () {
     if (!editor || !tableNode || typeof tablePos !== 'number' || typeof index !== 'number') return;
     try {
-      var _TableMap$get = TableMap.get(tableNode),
-        width = _TableMap$get.width,
-        height = _TableMap$get.height;
-      var start = orientation === 'row' ? {
-        row: index,
-        col: 0
-      } : {
-        row: 0,
-        col: index
-      };
-      var end = orientation === 'row' ? {
-        row: index,
-        col: width - 1
-      } : {
-        row: height - 1,
-        col: index
-      };
-      selectCellsByCoords(editor, tablePos, [start, end], {
-        mode: 'dispatch',
-        dispatch: editor.view.dispatch.bind(editor.view)
-      });
+      if (orientation === 'row') {
+        var coords = getRowOriginCoords({
+          editor: editor,
+          rowIndex: index,
+          tablePos: tablePos,
+          includeMerged: false
+        });
+        if (!coords) return;
+        selectCellsByCoords(editor, tablePos, coords, {
+          mode: 'dispatch',
+          dispatch: editor.view.dispatch.bind(editor.view)
+        });
+      } else {
+        var _TableMap$get = TableMap.get(tableNode),
+          width = _TableMap$get.width,
+          height = _TableMap$get.height;
+        var start = {
+          row: 0,
+          col: index
+        };
+        var end = {
+          row: height - 1,
+          col: index
+        };
+        selectCellsByCoords(editor, tablePos, [start, end], {
+          mode: 'dispatch',
+          dispatch: editor.view.dispatch.bind(editor.view)
+        });
+      }
     } catch (error) {
       console.warn('Failed to select row/column:', error);
     }
@@ -73,60 +89,106 @@ export var TableHandleMenu = function TableHandleMenu(_ref) {
       return false;
     }
     try {
-      var cells = orientation === 'row' ? getRowCells(editor, index, tablePos) : getColumnCells(editor, index, tablePos);
-      return cells.cells.length > 0 && cells.mergedCells.length === 0;
+      if (orientation === 'row') {
+        var rowCells = getRowCells(editor, index, tablePos);
+        return dedupeCells(rowCells.cells).length > 0;
+      }
+      var cells = getColumnCells(editor, index, tablePos);
+      return dedupeCells(cells.cells).length > 0 && cells.mergedCells.length === 0;
     } catch (_unused) {
       return false;
     }
-  }, [editor, index, orientation, tablePos, tableNode, editor === null || editor === void 0 ? void 0 : editor.state.doc]);
+  }, [dedupeCells, editor, index, orientation, tablePos, tableNode, editor === null || editor === void 0 ? void 0 : editor.state.doc]);
   var duplicateRowOrColumn = useCallback(function () {
     if (!editor || typeof index !== 'number' || typeof tablePos !== 'number' || !canDuplicate) {
       return;
     }
     try {
-      var originalCells = orientation === 'row' ? getRowCells(editor, index, tablePos) : getColumnCells(editor, index, tablePos);
-      if (originalCells.cells.length === 0) return;
-      selectRowOrColumn();
-      var addSuccess = false;
-      if (editor.state.selection instanceof CellSelection) {
-        addSuccess = orientation === 'row' ? editor.chain().focus().addRowAfter().run() : editor.chain().focus().addColumnAfter().run();
+      // 添加新行/列
+      if (orientation === 'row') {
+        selectRowOrColumn();
+        var added = editor.chain().focus().addRowAfter().run();
+        if (!added) return;
       } else {
-        var sourceCoords = getIndexCoordinates({
-          editor: editor,
-          index: index,
-          orientation: orientation,
-          tablePos: tablePos
-        });
-        if (!sourceCoords) return;
-        var stateWithCellSel = selectCellsByCoords(editor, tablePos, sourceCoords, {
-          mode: 'state'
-        });
-        if (!stateWithCellSel) return;
-        var dispatch = function dispatch(tr) {
-          return editor.view.dispatch(tr);
-        };
-        if (orientation === 'row') {
-          addSuccess = addRowAfter(stateWithCellSel, dispatch);
+        selectRowOrColumn();
+        var addSuccess = false;
+        if (editor.state.selection instanceof CellSelection) {
+          addSuccess = editor.chain().focus().addColumnAfter().run();
         } else {
+          var sourceCoords = getIndexCoordinates({
+            editor: editor,
+            index: index,
+            orientation: orientation,
+            tablePos: tablePos
+          });
+          if (!sourceCoords) return;
+          var stateWithCellSel = selectCellsByCoords(editor, tablePos, sourceCoords, {
+            mode: 'state'
+          });
+          if (!stateWithCellSel) return;
+          var dispatch = function dispatch(tr) {
+            return editor.view.dispatch(tr);
+          };
           addSuccess = addColumnAfter(stateWithCellSel, dispatch);
         }
+        if (!addSuccess) return;
       }
-      if (!addSuccess) return;
       var updatedTable = getTable(editor, tablePos);
       if (!updatedTable) return;
-      var newCells = orientation === 'row' ? getRowCells(editor, index + 1, updatedTable.pos) : getColumnCells(editor, index + 1, updatedTable.pos);
-      if (newCells.cells.length === 0) return;
+
+      // 获取新添加的行/列中的单元格
+      var newCells = orientation === 'row' ? dedupeCells(getRowCells(editor, index + 1, updatedTable.pos).cells) : dedupeCells(getColumnCells(editor, index + 1, updatedTable.pos).cells);
+
+      // 获取要复制的原始行/列中的单元格
+      var originalCells = orientation === 'row' ? dedupeCells(getRowCells(editor, index, tablePos).cells) : dedupeCells(getColumnCells(editor, index, tablePos).cells);
+      if (newCells.length === 0 || originalCells.length === 0) return;
       var state = editor.state,
         view = editor.view;
       var tr = state.tr;
-      var cellsToReplace = _toConsumableArray(newCells.cells).reverse();
-      var originalCellsReversed = _toConsumableArray(originalCells.cells).reverse();
+
+      // 处理合并单元格
+      var table = getTable(editor, tablePos);
+      var cellsToSkip = new Set(); // 记录要跳过的单元格位置
+
+      if (table && orientation === 'row') {
+        var cellsWithRect = getUniqueCellsWithRect(table);
+        cellsWithRect.forEach(function (cell) {
+          var _node$attrs$rowspan;
+          var pos = cell.pos,
+            node = cell.node,
+            rect = cell.rect;
+          var rowspan = (_node$attrs$rowspan = node.attrs.rowspan) !== null && _node$attrs$rowspan !== void 0 ? _node$attrs$rowspan : 1;
+          var colspan = rect.right - rect.left;
+          if (rowspan > 1 && rect.top === index) {
+            tr = tr.setNodeMarkup(pos, undefined, _objectSpread(_objectSpread({}, node.attrs), {}, {
+              rowspan: rowspan + 1
+            }), node.marks);
+          } else if (rowspan > 1 && rect.top < index && index < rect.bottom) {
+            // 记录被纵向合并覆盖的每一列，注意合并单元格可能横跨多列
+            for (var col = rect.left; col < rect.left + colspan; col++) {
+              cellsToSkip.add(col);
+            }
+          }
+        });
+      }
+
+      // 按列号建立映射，保证合并（横跨多列）时能精确匹配原始单元格
+      var originalCellByColumn = new Map();
+      originalCells.forEach(function (cell) {
+        originalCellByColumn.set(cell.column, cell);
+      });
+      var cellsToReplace = _toConsumableArray(newCells).reverse();
       cellsToReplace.forEach(function (newCell, reverseIndex) {
-        var originalCell = originalCellsReversed[reverseIndex];
+        var originalCell = originalCellByColumn.get(newCell.column);
         if (newCell.node && originalCell !== null && originalCell !== void 0 && originalCell.node) {
+          // 使用实际列索引判断是否需要跳过被合并覆盖的单元格，避免反向遍历导致错位
+          var shouldSkip = orientation === 'row' && cellsToSkip.has(newCell.column);
+          if (shouldSkip) {
+            return;
+          }
           var duplicatedCell = newCell.node.type.create(_objectSpread({}, originalCell.node.attrs), originalCell.node.content, originalCell.node.marks);
           var cellEnd = newCell.pos + newCell.node.nodeSize;
-          tr.replaceWith(newCell.pos, cellEnd, duplicatedCell);
+          tr = tr.replaceWith(newCell.pos, cellEnd, duplicatedCell);
         }
       });
       if (tr.docChanged) {
@@ -207,18 +269,25 @@ export var TableHandleMenu = function TableHandleMenu(_ref) {
         }
       }),
       onClick: function onClick() {
-        if (typeof index === 'number' && typeof tablePos === 'number') {
-          var cellCoord = orientation === 'row' ? {
-            row: index,
-            col: 0
-          } : {
-            row: 0,
-            col: index
-          };
-          selectCellsByCoords(editor, tablePos, [cellCoord], {
-            mode: 'dispatch',
-            dispatch: editor.view.dispatch.bind(editor.view)
-          });
+        if (editor && typeof index === 'number' && typeof tablePos === 'number') {
+          if (orientation === 'row') {
+            selectCellsByCoords(editor, tablePos, [{
+              row: index,
+              col: 0
+            }], {
+              mode: 'dispatch',
+              dispatch: editor.view.dispatch.bind(editor.view)
+            });
+          } else {
+            var cellCoord = {
+              row: 0,
+              col: index
+            };
+            selectCellsByCoords(editor, tablePos, [cellCoord], {
+              mode: 'dispatch',
+              dispatch: editor.view.dispatch.bind(editor.view)
+            });
+          }
         }
         if (orientation === 'row') {
           editor.chain().focus().addRowBefore().run();
@@ -239,18 +308,25 @@ export var TableHandleMenu = function TableHandleMenu(_ref) {
         }
       }),
       onClick: function onClick() {
-        if (typeof index === 'number' && typeof tablePos === 'number') {
-          var cellCoord = orientation === 'row' ? {
-            row: index,
-            col: 0
-          } : {
-            row: 0,
-            col: index
-          };
-          selectCellsByCoords(editor, tablePos, [cellCoord], {
-            mode: 'dispatch',
-            dispatch: editor.view.dispatch.bind(editor.view)
-          });
+        if (editor && typeof index === 'number' && typeof tablePos === 'number') {
+          if (orientation === 'row') {
+            selectCellsByCoords(editor, tablePos, [{
+              row: index,
+              col: 0
+            }], {
+              mode: 'dispatch',
+              dispatch: editor.view.dispatch.bind(editor.view)
+            });
+          } else {
+            var cellCoord = {
+              row: 0,
+              col: index
+            };
+            selectCellsByCoords(editor, tablePos, [cellCoord], {
+              mode: 'dispatch',
+              dispatch: editor.view.dispatch.bind(editor.view)
+            });
+          }
         }
         if (orientation === 'row') {
           editor.chain().focus().addRowAfter().run();

package/dist/extension/component/TableHandle/index.d.ts

@@ -13,15 +13,10 @@ export interface TableHandleButtonProps {
     dragStart?: (e: React.DragEvent) => void;
 }
 export interface TableHandleProps {
-    /**
-     * The Tiptap editor instance.
-     */
+    /** Tiptap 编辑器实例 */
     editor?: Editor | null;
 }
-/**
- * Main table handle component that manages the positioning and rendering
- * of table row/column handles, extend buttons, and context menus.
- */
+/** 负责行/列手柄、扩展按钮与菜单的定位与渲染 */
 export declare function TableHandle({ editor: providedEditor, }: TableHandleProps): React.JSX.Element | null;
 export declare namespace TableHandle {
     var displayName: string;

package/dist/extension/component/TableHandle/index.js

@@ -11,10 +11,7 @@ import { TableHandleAddButton } from "./TableHandleAddButton";
 import { TableHandleMenu } from "./TableHandleMenu";
 import { useTableHandlePositioning } from "./use-table-handle-positioning";
 import { useTableHandleState } from "./use-table-handle-state";
-/**
- * Main table handle component that manages the positioning and rendering
- * of table row/column handles, extend buttons, and context menus.
- */
+/** 负责行/列手柄、扩展按钮与菜单的定位与渲染 */
 export function TableHandle(_ref) {
   var providedEditor = _ref.editor;
   var editor = providedEditor;

package/dist/extension/component/TableHandle/use-table-handle-positioning.d.ts

@@ -9,17 +9,13 @@ type DraggingState = {
         height: number;
     };
 };
-/**
- * Hook for positioning individual table handles using Floating UI React
- */
+/** 基于 Floating UI 定位单个表格手柄的 Hook */
 export declare function useTableHandlePosition(orientation: Orientation, show: boolean, referencePosCell: DOMRect | null, referencePosTable: DOMRect | null, draggingState?: DraggingState): {
     isMounted: boolean;
     ref: (node: HTMLElement | null) => void;
     style: React.CSSProperties;
 };
-/**
- * Hook for managing positioning of all table handles (row, column, and cell)
- */
+/** 统一返回行、列、单元格手柄的位置数据 */
 export declare function useTableHandlePositioning(show: boolean, referencePosCell: DOMRect | null, referencePosTable: DOMRect | null, draggingState?: DraggingState): {
     rowHandle: {
         isMounted: boolean;

package/dist/extension/component/TableHandle/use-table-handle-positioning.js

@@ -7,46 +7,30 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 import { offset, size, useFloating, useTransitionStyles } from '@floating-ui/react';
 import { useEffect, useMemo } from 'react';
 import { clamp } from "../../../util/table-utils";
-/**
- * Creates a DOMRect for row handle positioning
- * Reference is positioned at table edge, aligned with cell
- */
+/** 创建行手柄的参考 DOMRect，贴边并与单元格对齐 */
 function makeRowRect(cell, table, dragging) {
-  if ((dragging === null || dragging === void 0 ? void 0 : dragging.draggedCellOrientation) === 'row') {
-    var _dragging$initialOffs;
-    // Apply the initial offset to maintain handle position
-    var adjustedY = dragging.mousePos + ((_dragging$initialOffs = dragging.initialOffset) !== null && _dragging$initialOffs !== void 0 ? _dragging$initialOffs : 0);
-    var clampedY = clamp(adjustedY, table.y, table.bottom - cell.height);
-    return new DOMRect(table.x, clampedY, table.width, cell.height);
-  }
-  return new DOMRect(table.x, cell.y, table.width, cell.height);
+  var _dragging$initialOffs;
+  var baseY = (dragging === null || dragging === void 0 ? void 0 : dragging.draggedCellOrientation) === 'row' ? clamp(dragging.mousePos + ((_dragging$initialOffs = dragging.initialOffset) !== null && _dragging$initialOffs !== void 0 ? _dragging$initialOffs : 0), table.y, table.bottom - cell.height) : cell.y;
+
+  // 行手柄沿整行宽度，高度保持单元格高度
+  return new DOMRect(table.x, baseY, table.width, cell.height);
 }
 
-/**
- * Creates a DOMRect for column handle positioning
- * Reference is positioned at table edge, aligned with cell
- */
+/** 创建列手柄的参考 DOMRect，贴边并与单元格对齐 */
 function makeColRect(cell, table, dragging) {
-  if ((dragging === null || dragging === void 0 ? void 0 : dragging.draggedCellOrientation) === 'col') {
-    var _dragging$initialOffs2;
-    // Apply the initial offset to maintain handle position
-    var adjustedX = dragging.mousePos + ((_dragging$initialOffs2 = dragging.initialOffset) !== null && _dragging$initialOffs2 !== void 0 ? _dragging$initialOffs2 : 0);
-    var clampedX = clamp(adjustedX, table.x, table.right - cell.width);
-    return new DOMRect(clampedX, table.y, cell.width, table.height);
-  }
-  return new DOMRect(cell.x, table.y, cell.width, table.height);
+  var _dragging$initialOffs2;
+  var baseX = (dragging === null || dragging === void 0 ? void 0 : dragging.draggedCellOrientation) === 'col' ? clamp(dragging.mousePos + ((_dragging$initialOffs2 = dragging.initialOffset) !== null && _dragging$initialOffs2 !== void 0 ? _dragging$initialOffs2 : 0), table.x, table.right - cell.width) : cell.x;
+
+  // 列手柄宽度保持单元格宽度，高度沿整列
+  return new DOMRect(baseX, table.y, cell.width, table.height);
 }
 
-/**
- * Creates a DOMRect for cell handle positioning
- */
+/** 创建单元格手柄的参考 DOMRect */
 function makeCellRect(cell) {
   return new DOMRect(cell.x, cell.y, cell.width, 0);
 }
 
-/**
- * Gets the placement configuration for different handle orientations
- */
+/** 根据手柄方向获取浮层位置 */
 function getPlacement(orientation) {
   switch (orientation) {
     case 'row':
@@ -59,9 +43,7 @@ function getPlacement(orientation) {
   }
 }
 
-/**
- * Gets the offset configuration for different handle orientations
- */
+/** 根据手柄方向获取偏移配置 */
 function getOffset(orientation) {
   switch (orientation) {
     case 'row':
@@ -77,9 +59,7 @@ function getOffset(orientation) {
   }
 }
 
-/**
- * Factory function to create DOMRect based on orientation
- */
+/** 按方向生成对应的参考 DOMRect */
 function rectFactory(orientation, cell, table, dragging) {
   switch (orientation) {
     case 'row':
@@ -92,9 +72,7 @@ function rectFactory(orientation, cell, table, dragging) {
   }
 }
 
-/**
- * Hook for positioning individual table handles using Floating UI React
- */
+/** 基于 Floating UI 定位单个表格手柄的 Hook */
 export function useTableHandlePosition(orientation, show, referencePosCell, referencePosTable, draggingState) {
   var placement = useMemo(function () {
     return getPlacement(orientation);
@@ -107,18 +85,18 @@ export function useTableHandlePosition(orientation, show, referencePosCell, refe
       placement: placement,
       middleware: [offset(offsetValue), size({
         apply: function apply(_ref) {
-          var _ref2, _referencePosCell$wid, _ref3, _referencePosCell$hei;
+          var _ref2, _referencePosTable$wi, _referencePosTable$wi2, _ref3, _referencePosTable$he, _referencePosTable$he2;
           var rects = _ref.rects,
             elements = _ref.elements;
           if (!elements.floating) return;
-          var refWidth = (_ref2 = orientation === 'col' ? (_referencePosCell$wid = referencePosCell === null || referencePosCell === void 0 ? void 0 : referencePosCell.width) !== null && _referencePosCell$wid !== void 0 ? _referencePosCell$wid : referencePosTable === null || referencePosTable === void 0 ? void 0 : referencePosTable.width : referencePosTable === null || referencePosTable === void 0 ? void 0 : referencePosTable.width) !== null && _ref2 !== void 0 ? _ref2 : rects.reference.width;
-          var refHeight = (_ref3 = orientation === 'row' ? (_referencePosCell$hei = referencePosCell === null || referencePosCell === void 0 ? void 0 : referencePosCell.height) !== null && _referencePosCell$hei !== void 0 ? _referencePosCell$hei : referencePosTable === null || referencePosTable === void 0 ? void 0 : referencePosTable.height : referencePosTable === null || referencePosTable === void 0 ? void 0 : referencePosTable.height) !== null && _ref3 !== void 0 ? _ref3 : rects.reference.height;
+          var refWidth = (_ref2 = orientation === 'col' ? (_referencePosTable$wi = referencePosTable === null || referencePosTable === void 0 ? void 0 : referencePosTable.width) !== null && _referencePosTable$wi !== void 0 ? _referencePosTable$wi : referencePosCell === null || referencePosCell === void 0 ? void 0 : referencePosCell.width : (_referencePosTable$wi2 = referencePosTable === null || referencePosTable === void 0 ? void 0 : referencePosTable.width) !== null && _referencePosTable$wi2 !== void 0 ? _referencePosTable$wi2 : referencePosCell === null || referencePosCell === void 0 ? void 0 : referencePosCell.width) !== null && _ref2 !== void 0 ? _ref2 : rects.reference.width;
+          var refHeight = (_ref3 = orientation === 'row' ? (_referencePosTable$he = referencePosTable === null || referencePosTable === void 0 ? void 0 : referencePosTable.height) !== null && _referencePosTable$he !== void 0 ? _referencePosTable$he : referencePosCell === null || referencePosCell === void 0 ? void 0 : referencePosCell.height : (_referencePosTable$he2 = referencePosTable === null || referencePosTable === void 0 ? void 0 : referencePosTable.height) !== null && _referencePosTable$he2 !== void 0 ? _referencePosTable$he2 : referencePosCell === null || referencePosCell === void 0 ? void 0 : referencePosCell.height) !== null && _ref3 !== void 0 ? _ref3 : rects.reference.height;
 
-          // Set CSS custom properties for styling
+          // 将尺寸写入 CSS 变量，便于样式使用
           elements.floating.style.setProperty('--table-handle-ref-width', "".concat(refWidth, "px"));
           elements.floating.style.setProperty('--table-handle-ref-height', "".concat(refHeight, "px"));
 
-          // Set the main size dimension based on orientation
+          // 主尺寸随方向切换，行取高度、列取宽度
           var mainSize = orientation === 'row' ? refHeight : refWidth;
           elements.floating.style.setProperty('--table-handle-available-size', "".concat(mainSize, "px"));
         }
@@ -132,26 +110,23 @@ export function useTableHandlePosition(orientation, show, referencePosCell, refe
     isMounted = _useTransitionStyles.isMounted,
     styles = _useTransitionStyles.styles;
 
-  // Provide a virtual reference rect to Floating UI
-  // Use a function that always returns the latest values to ensure autoUpdate works correctly
+  // 为 Floating UI 提供虚拟参考矩形；使用闭包拿最新值以保证 autoUpdate 生效
   useEffect(function () {
-    // Nothing to reference yet
+    // 尚无参考节点
     if (!referencePosCell || !referencePosTable) {
       refs.setReference(null);
       return;
     }
 
-    // Ignore cell handle while dragging (matches original behavior)
+    // 拖动时隐藏单元格手柄（保持与原行为一致）
     if (draggingState && orientation === 'cell') {
       refs.setReference(null);
       return;
     }
 
-    // Create a virtual element that always returns the latest rect values
-    // This ensures autoUpdate can detect changes when scrolling
+    // 创建返回最新矩形的虚拟元素，保证滚动时位置能自动更新
     refs.setReference({
       getBoundingClientRect: function getBoundingClientRect() {
-        // Always use the latest values from closure
         if (!referencePosCell || !referencePosTable) {
           return new DOMRect();
         }
@@ -160,7 +135,7 @@ export function useTableHandlePosition(orientation, show, referencePosCell, refe
     });
   }, [refs, orientation, referencePosCell, referencePosTable, draggingState]);
 
-  // Update position when reference positions change
+  // 参考位置变化时更新浮层
   useEffect(function () {
     if (!show || !referencePosCell || !referencePosTable) return;
     update();
@@ -176,9 +151,7 @@ export function useTableHandlePosition(orientation, show, referencePosCell, refe
   }, [isMounted, refs.setFloating, styles, floatingStyles]);
 }
 
-/**
- * Hook for managing positioning of all table handles (row, column, and cell)
- */
+/** 统一返回行、列、单元格手柄的位置数据 */
 export function useTableHandlePositioning(show, referencePosCell, referencePosTable, draggingState) {
   var rowHandle = useTableHandlePosition('row', show, referencePosCell, referencePosTable, draggingState);
   var colHandle = useTableHandlePosition('col', show, referencePosCell, referencePosTable, draggingState);

package/dist/extension/component/TableHandle/use-table-handle-state.d.ts

@@ -1,22 +1,13 @@
 import type { Editor } from '@tiptap/react';
 import type { TableHandlesState } from '../../node/TableHandler/plugin';
 export interface UseTableHandleStateConfig {
-    /**
-     * The Tiptap editor instance. If omitted, the hook will use
-     * the context/editor from `useTiptapEditor`.
-     */
+    /** Tiptap 编辑器实例；未传则使用外部上下文中的 editor */
     editor?: Editor | null;
-    /**
-     * Initial state of the table handles
-     */
+    /** 手柄的初始状态 */
     initialState?: TableHandlesState | null;
-    /**
-     * Only update state when specific fields change
-     */
+    /** 仅在特定字段变动时触发更新 */
     watchFields?: (keyof TableHandlesState)[];
-    /**
-     * Callback when state changes
-     */
+    /** 状态变更回调 */
     onStateChange?: (state: TableHandlesState | null) => void;
 }
 export declare function useTableHandleState(config?: UseTableHandleStateConfig): TableHandlesState | null;

package/dist/extension/component/TableHandle/use-table-handle-state.js

@@ -4,7 +4,7 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 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 _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; }
-import { useEffect, useState, useCallback, useRef } from 'react';
+import { useCallback, useEffect, useRef, useState } from 'react';
 export function useTableHandleState() {
   var config = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
   var providedEditor = config.editor,

package/dist/extension/component/UploadProgress/index.d.ts

@@ -7,6 +7,6 @@ export interface UploadProgressAttributes {
     tempId: string;
 }
 export declare const getFileIcon: (fileType: string) => React.JSX.Element;
-export declare const getFileTypeText: (fileType: string) => "视频" | "音频" | "图片" | "文件";
+export declare const getFileTypeText: (fileType: string) => "图片" | "视频" | "音频" | "文件";
 declare const UploadProgressView: React.FC<NodeViewProps>;
 export default UploadProgressView;

package/dist/extension/index.js

@@ -14,7 +14,7 @@ import StarterKit from '@tiptap/starter-kit';
 import { PLACEHOLDER } from "../contants/placeholder";
 import { AiWritingExtension, ImeComposition, SlashCommands, StructuredDiffExtension } from "./extension";
 import { CodeExtension } from "./mark/Code";
-import { AlertExtension, AudioExtension, BlockAttachmentExtension, BlockLinkExtension, CodeBlockLowlightExtension, CustomBlockMathExtension, CustomHorizontalRule, CustomInlineMathExtension, CustomSubscript, CustomSuperscript, DetailsContentExtension, DetailsExtension, DetailsSummaryExtension, EmojiExtension, FileHandlerExtension, FlipGridColumnExtension, FlipGridExtension, FlowExtension, IframeExtension, ImageExtension, Indent, InlineAttachmentExtension, InlineLinkExtension, InlineUploadProgressExtension, ListExtension, MentionExtension, TableExtension, TableOfContents, UploadProgressExtension, VerticalAlign, VideoExtension, YamlFormat, YoutubeExtension } from "./node";
+import { AlertExtension, AudioExtension, BlockAttachmentExtension, BlockLinkExtension, CodeBlockLowlightExtension, CustomBlockMathExtension, CustomHorizontalRule, CustomInlineMathExtension, CustomSubscript, CustomSuperscript, DetailsContentExtension, DetailsExtension, DetailsSummaryExtension, EmojiExtension, FileHandlerExtension, FlipGridColumnExtension, FlipGridExtension, FlowExtension, IframeExtension, ImageExtension, Indent, InlineAttachmentExtension, InlineLinkExtension, InlineUploadProgressExtension, ListExtension, MentionExtension, TableExtension, TableOfContentsExtension, UploadProgressExtension, VerticalAlign, VideoExtension, YamlFormat, YoutubeExtension } from "./node";
 export var getExtensions = function getExtensions(_ref) {
   var limit = _ref.limit,
     exclude = _ref.exclude,
@@ -52,7 +52,7 @@ export var getExtensions = function getExtensions(_ref) {
     onError: onError
   }), CustomInlineMathExtension({
     onError: onError
-  }), TableOfContents({
+  }), TableOfContentsExtension({
     onTocUpdate: onTocUpdate,
     tableOfContentsOptions: tableOfContentsOptions
   }), InlineLinkExtension, BlockLinkExtension, IframeExtension({