drawui-core 0.4.0 → 0.4.2

package/dist/index.d.cts

@@ -18,7 +18,7 @@ interface ShapeStyle {
     /** 描边色透明度（0-1），缺省为 1；与 strokeColor 叠加使用 */
     strokeOpacity?: number;
 }
-type ShapeType = 'rectangle' | 'rounded-rectangle' | 'circle' | 'ellipse' | 'diamond' | 'triangle' | 'hexagon' | 'parallelogram' | 'trapezoid' | 'pentagon' | 'octagon' | 'star' | 'cylinder' | 'cloud' | 'heart' | 'block-arrow-right' | 'block-arrow-left' | 'block-arrow-up' | 'block-arrow-down' | 'block-arrow-double' | 'right-triangle' | 'cross' | 'speech-rect' | 'speech-round' | 'cube' | 'sector' | 'delay' | 'predefined-process' | 'document' | 'stadium' | 'class-catalog' | 'chevron' | 'brace-left' | 'brace-right' | 'envelope' | 'checkbox' | 'sticky-note' | 'triangular-pyramid' | 'quadrangular-pyramid' | 'cuboid' | 'sphere' | 'ellipsoid' | 'pie' | 'hollow-pie' | 'uml-class' | 'uml-interface' | 'mind-map' | 'icon' | 'line' | 'arrow' | 'text' | 'draw';
+type ShapeType = 'rectangle' | 'rounded-rectangle' | 'circle' | 'ellipse' | 'diamond' | 'triangle' | 'hexagon' | 'parallelogram' | 'trapezoid' | 'pentagon' | 'octagon' | 'star' | 'cylinder' | 'cloud' | 'heart' | 'block-arrow-right' | 'block-arrow-left' | 'block-arrow-up' | 'block-arrow-down' | 'block-arrow-double' | 'right-triangle' | 'cross' | 'speech-rect' | 'speech-round' | 'cube' | 'sector' | 'delay' | 'predefined-process' | 'document' | 'stadium' | 'class-catalog' | 'chevron' | 'brace-left' | 'brace-right' | 'envelope' | 'checkbox' | 'sticky-note' | 'triangular-pyramid' | 'quadrangular-pyramid' | 'cuboid' | 'sphere' | 'ellipsoid' | 'pie' | 'hollow-pie' | 'uml-class' | 'uml-interface' | 'mind-map' | 'table' | 'icon' | 'line' | 'arrow' | 'text' | 'draw';
 interface BaseShape {
     id: string;
     type: ShapeType;
@@ -32,7 +32,20 @@ interface BaseShape {
     highlightColor?: string;
     /** 文字高亮背景透明度（0-1），缺省为 1 */
     highlightOpacity?: number;
+    /** 锁定：不可选中/拖动/缩放/删除（右键菜单可解锁） */
+    locked?: boolean;
+    /** 水平翻转（围绕自身中心镜像；文字/连线等不适用，见 isFlippableShapeType） */
+    flipX?: boolean;
+    /** 垂直翻转（围绕自身中心镜像） */
+    flipY?: boolean;
+    /**
+     * 分组 id：同一组的图形「同进同退」——点选任一成员即选中整组（一起拖动/删除/改变层级），
+     * 组锁定时整组都不可选中、不可拖动，等同于给多个图形绑了一把锁。
+     */
+    groupId?: string;
 }
+/** 该类型的图形是否支持水平/垂直翻转（右键菜单据此禁用） */
+declare function isFlippableShapeType(type: ShapeType): boolean;
 interface RectangleShape extends BaseShape {
     type: 'rectangle';
     width: number;
@@ -159,7 +172,7 @@ interface PathShape extends BaseShape {
     width: number;
     height: number;
 }
-type UmlVisibility = '+' | '-' | '#' | '~';
+type UmlVisibility = '+' | '-' | '#' | '~' | '';
 interface UmlAttribute {
     id: string;
     visibility: UmlVisibility;
@@ -330,8 +343,38 @@ interface MindMapShape extends BaseShape {
     height: number;
     root: MindMapNode;
 }
-type Shape = RectangleShape | RoundedRectangleShape | CircleShape | EllipseShape | DiamondShape | TriangleShape | HexagonShape | ParallelogramShape | TrapezoidShape | PentagonShape | OctagonShape | StarShape | CylinderShape | CloudShape | HeartShape | BlockArrowShape | StadiumShape | StickyNoteShape | IconShape | PathShape | UmlClassShape | UmlInterfaceShape | LineShape | ArrowShape | TextShape | DrawShape | MindMapShape;
-type ToolType = 'select' | 'hand' | 'rectangle' | 'rounded-rectangle' | 'circle' | 'ellipse' | 'diamond' | 'triangle' | 'hexagon' | 'parallelogram' | 'trapezoid' | 'pentagon' | 'octagon' | 'star' | 'cylinder' | 'cloud' | 'heart' | 'block-arrow-right' | 'block-arrow-left' | 'block-arrow-up' | 'block-arrow-down' | 'block-arrow-double' | 'right-triangle' | 'cross' | 'speech-rect' | 'speech-round' | 'cube' | 'sector' | 'delay' | 'predefined-process' | 'document' | 'stadium' | 'class-catalog' | 'chevron' | 'brace-left' | 'brace-right' | 'envelope' | 'checkbox' | 'sticky-note' | 'triangular-pyramid' | 'quadrangular-pyramid' | 'cuboid' | 'sphere' | 'ellipsoid' | 'pie' | 'hollow-pie' | 'uml-class' | 'uml-interface' | 'line' | 'arrow' | 'text' | 'draw' | 'pen' | 'highlighter' | 'eraser' | 'mind-map' | 'icon';
+/**
+ * 表格单元格：合并模型见 `table.ts` —— 只有合并区域的**左上角锚点**携带
+ * `rowSpan/colSpan`，区域内其余格子是被覆盖格（数据保持空 `{text:''}`，
+ * 渲染/命中时跳过，点击映射回锚点）。
+ */
+interface TableCell {
+    text: string;
+    textColor?: string;
+    fontSize?: number;
+    bold?: boolean;
+    /** 单元格底色（缺省透明，透出表格 style.fillColor） */
+    fillColor?: string;
+    align?: 'left' | 'center' | 'right';
+    rowSpan?: number;
+    colSpan?: number;
+}
+/**
+ * 表格：(x,y) 为中心 + width/height（与矩形一致），但宽高恒等于
+ * colWidths/rowHeights 之和（见 table.ts），行列结构由纯函数操作。
+ */
+interface TableShape extends BaseShape {
+    type: 'table';
+    /** 恒等于 colWidths / rowHeights 之和，写回时同步 */
+    width: number;
+    height: number;
+    colWidths: number[];
+    rowHeights: number[];
+    /** cells[row][col] */
+    cells: TableCell[][];
+}
+type Shape = RectangleShape | RoundedRectangleShape | CircleShape | EllipseShape | DiamondShape | TriangleShape | HexagonShape | ParallelogramShape | TrapezoidShape | PentagonShape | OctagonShape | StarShape | CylinderShape | CloudShape | HeartShape | BlockArrowShape | StadiumShape | StickyNoteShape | IconShape | PathShape | UmlClassShape | UmlInterfaceShape | LineShape | ArrowShape | TextShape | DrawShape | MindMapShape | TableShape;
+type ToolType = 'select' | 'hand' | 'rectangle' | 'rounded-rectangle' | 'circle' | 'ellipse' | 'diamond' | 'triangle' | 'hexagon' | 'parallelogram' | 'trapezoid' | 'pentagon' | 'octagon' | 'star' | 'cylinder' | 'cloud' | 'heart' | 'block-arrow-right' | 'block-arrow-left' | 'block-arrow-up' | 'block-arrow-down' | 'block-arrow-double' | 'right-triangle' | 'cross' | 'speech-rect' | 'speech-round' | 'cube' | 'sector' | 'delay' | 'predefined-process' | 'document' | 'stadium' | 'class-catalog' | 'chevron' | 'brace-left' | 'brace-right' | 'envelope' | 'checkbox' | 'sticky-note' | 'triangular-pyramid' | 'quadrangular-pyramid' | 'cuboid' | 'sphere' | 'ellipsoid' | 'pie' | 'hollow-pie' | 'uml-class' | 'uml-interface' | 'line' | 'arrow' | 'text' | 'draw' | 'pen' | 'highlighter' | 'eraser' | 'mind-map' | 'table' | 'icon';
 interface CameraState {
     x: number;
     y: number;
@@ -638,6 +681,40 @@ declare const zhCN: {
     readonly 'mindmap.expand': "展开";
     readonly 'mindmap.close': "关闭编辑";
     readonly 'mindmap.more': "更多设置";
+    readonly 'tool.table': "表格";
+    readonly 'toolbar.table': "表格";
+    readonly 'shape.table': "表格";
+    readonly 'table.insertRow': "插入行";
+    readonly 'table.deleteRow': "删除行";
+    readonly 'table.insertCol': "插入列";
+    readonly 'table.deleteCol': "删除列";
+    readonly 'table.merge': "合并单元格";
+    readonly 'table.split': "拆分单元格";
+    readonly 'table.insertRowAbove': "在上方插入行";
+    readonly 'table.insertRowBelow': "在下方插入行";
+    readonly 'table.insertColLeft': "在左侧插入列";
+    readonly 'table.insertColRight': "在右侧插入列";
+    readonly 'table.pickHint': "拖选行列数";
+    readonly 'ctx.copy': "复制";
+    readonly 'ctx.copyAsImage': "复制为图片";
+    readonly 'ctx.paste': "粘贴";
+    readonly 'ctx.duplicate': "创建副本";
+    readonly 'ctx.layer': "层级";
+    readonly 'ctx.bringToFront': "置于顶层";
+    readonly 'ctx.bringForward': "上移一层";
+    readonly 'ctx.sendBackward': "下移一层";
+    readonly 'ctx.sendToBack': "置于底层";
+    readonly 'ctx.copyStyle': "复制样式";
+    readonly 'ctx.pasteStyle': "粘贴样式";
+    readonly 'ctx.flipH': "水平翻转";
+    readonly 'ctx.flipV': "垂直翻转";
+    readonly 'ctx.rotate': "旋转";
+    readonly 'ctx.group': "成组";
+    readonly 'ctx.ungroup': "解组";
+    readonly 'ctx.lock': "锁定";
+    readonly 'ctx.unlock': "解锁";
+    readonly 'ctx.unlockGroup': "解锁本组";
+    readonly 'ctx.delete': "删除";
     readonly 'toolbar.icon': "图标";
     readonly 'icon.search': "搜索图标";
     readonly 'icon.empty': "没有匹配的图标";
@@ -754,6 +831,8 @@ declare class Editor {
     private mindMapEditingShapeId;
     private mindMapSelectedNode;
     private mindMapHoverNode;
+    private tableSelection;
+    private tableEditing;
     private renderScheduled;
     private pointerIsDown;
     private notifyScheduled;
@@ -771,6 +850,9 @@ declare class Editor {
     private stickyNoteColor;
     /** 连续插入图标时的错开计数（避免每次都叠在同一处） */
     private iconInsertSeq;
+    private clipboardShapes;
+    private pasteSeq;
+    private copiedStyle;
     constructor(canvas: HTMLCanvasElement, options?: EditorOptions);
     private setupEventListeners;
     /** 窗口失焦（切页签/alt-tab）：按下状态与一切瞬态预览都作废，避免"卡住" */
@@ -806,11 +888,55 @@ declare class Editor {
     private screenToPage;
     private addShape;
     private updateShape;
+    /**
+     * 表格尺寸变化时保持「左上角」不动：行高变化向下伸缩、列宽变化向右伸缩，
+     * 避免整表在画布上向两边跳。返回新的中心坐标（已按旋转角换算）。
+     */
+    private tableTopLeftAnchored;
+    /** 写回表格数据（cells/rowHeights/colWidths），并同步尺寸与中心（左上角不动） */
+    private writeTable;
+    /** 行高不够显示单元格文字时自动增高（只增不减） */
+    private autoGrowTableRows;
     private updateBoundArrows;
     private getBindingPosition;
     private deleteShape;
-    private selectShape;
-    private selectShapes;
+    /**
+     * 选中图形（additive=true 时切换选中态）；id 为空串清空选中。右键菜单/外部控制用。
+     * ⚠️ 组感知：点任一成员都会选中它所属的整组（同组的绑行为一致），additive 时整组一起加减。
+     */
+    selectShape(id: string, additive: boolean): void;
+    /** 整体替换选中集（右键菜单/外部控制用）；框选结果同样按组扩张 */
+    selectShapes(ids: string[]): void;
+    /** 某图形所在的整组 id 列表（不在组里就只有它自己） */
+    private getGroupMembers;
+    /** 选中集是否恰好是完整的一个组（返回 groupId，否则 null） */
+    getSelectedGroupId(): string | null;
+    /** 选中集里是否包含成组图形（用于右键菜单显示「解组」） */
+    hasSelectedGroup(): boolean;
+    /** 取某个组的所有成员 id（含锁定的成员） */
+    private groupMemberIds;
+    /**
+     * 成组：把选中图形绑成一个整体，并整组锁定（同飞书「组合后不再被选中」的观感，
+     * 用户想改动先解锁，解锁后整组仍同进同退：点任一成员 = 选中整组一起拖）。
+     * @returns 新建的 groupId；选中不足 2 个时返回 null
+     */
+    groupSelected(): string | null;
+    /**
+     * 解组：清掉这些图形的组标记并顺带解锁（整组一起解，即使只选中了组内一部分成员）。
+     * @returns 是否确实解掉了组
+     */
+    ungroupSelected(): boolean;
+    /** 解掉指定 gid 的组（内部统一入口，含 locked 清理） */
+    ungroupIds(groupIds: string[]): boolean;
+    /** 整组锁定/解锁（groupId 相同的图形一起改） */
+    setGroupLocked(groupId: string, locked: boolean): boolean;
+    /**
+     * 无视「组/锁定」直接选中一个图形（仅供右键菜单：右键命中锁定的组成员要能把整组选上，
+     * 否则用户没有任何入口把组解锁）。普通点选一律走 selectShape。
+     */
+    selectShapeRaw(id: string): void;
+    /** 选中集里任一成员所属的组 id（右键菜单「解锁本组」用） */
+    getGroupIdOfSelected(): string | null;
     private setBrushRect;
     /** 设置对齐参考线（由工具在拖拽过程中调用） */
     private setSnapGuides;
@@ -872,6 +998,51 @@ declare class Editor {
     }): void;
     /** 批量更新选中线条/箭头的连线类型 */
     updateConnectionType(connectionType: ConnectionType): void;
+    /** 获取选中的图形（按画布层级顺序，即 shapes 数组顺序） */
+    getSelectedShapes(): Shape[];
+    /** 是否正处于就地编辑（编辑文字/表格/思维导图节点） */
+    isEditing(): boolean;
+    /** 删除选中的图形（锁定的图形跳过），返回是否有删除 */
+    deleteSelected(): boolean;
+    /** 复制选中的图形到内部剪贴板（锁定的图形跳过） */
+    copySelected(): boolean;
+    /** 内部剪贴板里是否有可粘贴的内容 */
+    hasClipboard(): boolean;
+    /** 深拷贝一批图形并生成新 id、平移 offset（连线的世界坐标 points / 手工折点同步平移） */
+    private cloneWithOffset;
+    /** 粘贴内部剪贴板：副本阶梯偏移并选中，一步撤销 */
+    paste(): boolean;
+    /** 在原位创建选中图形的副本（偏移一点并选中副本），一步撤销 */
+    duplicateSelected(): boolean;
+    /** 把选中的图形导出为 PNG 并写入系统剪贴板（透明背景），返回是否成功 */
+    copySelectedAsImage(): Promise<boolean>;
+    /** 复制第一个选中图形的样式（边框/填充/文字色/字号） */
+    copyStyle(): boolean;
+    /** 是否已经复制过样式（右键菜单「粘贴样式」的可用条件） */
+    hasCopiedStyle(): boolean;
+    /** 把复制的样式粘贴到所有选中图形（一步撤销） */
+    pasteStyle(): boolean;
+    /**
+     * 水平/垂直翻转选中的图形（围绕各自中心镜像，toggle 语义）。
+     * 文字/连线/表格/UML/思维导图/便签不支持翻转（isFlippableShapeType），会被跳过。
+     */
+    flipSelected(axis: 'horizontal' | 'vertical'): boolean;
+    /** 选中图形旋转 90°（clockwise=false 为逆时针），一步撤销 */
+    rotateSelected90(clockwise?: boolean): boolean;
+    /** 锁定/解锁选中图形；锁定后自动取消选中（锁定图形不可选中） */
+    setSelectedShapesLocked(locked: boolean): boolean;
+    /** 锁定/解锁指定图形（右键锁定的图形时用它解锁，图形不必在选中集里） */
+    setShapeLocked(id: string, locked: boolean): boolean;
+    /** 某个图形是否被锁定 */
+    isShapeLocked(id: string): boolean;
+    /** 置于顶层：选中的图形整体移到最上面（保持它们之间的相对顺序） */
+    bringToFront(): boolean;
+    /** 置于底层：选中的图形整体移到最下面 */
+    sendToBack(): boolean;
+    /** 上移一层：每个选中图形与它上面相邻的非选中图形交换 */
+    bringForward(): boolean;
+    /** 下移一层：每个选中图形与它下面相邻的非选中图形交换 */
+    sendBackward(): boolean;
     /** 批量更新选中箭头的箭头类型 */
     updateArrowHeadType(arrowHead: ArrowHeadType): void;
     /**
@@ -969,6 +1140,107 @@ declare class Editor {
     deleteMindMapNode(shapeId: string, nodeId: string): void;
     /** 折叠/展开指定节点 */
     toggleMindMapCollapse(shapeId: string, nodeId: string): void;
+    /** 获取选中的表格（恰好选中一个时） */
+    getSelectedTable(): TableShape | null;
+    private getTableById;
+    /** 读取表格某格（只读引用，勿修改） */
+    getTableCell(shapeId: string, row: number, col: number): TableCell | null;
+    /** 页面坐标下的表格单元格命中（被覆盖格映射回锚点） */
+    getTableAtPoint(point: Vec2): {
+        shapeId: string;
+        row: number;
+        col: number;
+    } | null;
+    /** 屏幕坐标（画布左上角为原点）下的表格单元格命中 */
+    getTableAtScreenPoint(screenPoint: Vec2): {
+        shapeId: string;
+        row: number;
+        col: number;
+    } | null;
+    /**
+     * 拖拽框选用：把页面坐标解析成某表格内的行列；**超出表格时 clamp 到边缘行列**
+     * （拖到表格外 = 选中整行/整列）。指针不在该表格附近时也照样给出边缘格，不再返回 null。
+     */
+    getTableCellAtPointClamped(shapeId: string, point: Vec2): {
+        row: number;
+        col: number;
+    } | null;
+    /** 指针是否落在表格左上角的「拖动把手」上（只有它能移动整表） */
+    isTableMoveHandleHit(shapeId: string, point: Vec2): boolean;
+    /** 表格某格（缺省整表）在屏幕上的矩形（左上角 + 尺寸），用于就地编辑定位 */
+    getTableScreenRect(shapeId: string, row?: number, col?: number): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+    /** 当前单元格选区 */
+    getTableSelection(): {
+        shapeId: string;
+        anchor: {
+            row: number;
+            col: number;
+        };
+        focus: {
+            row: number;
+            col: number;
+        };
+    } | null;
+    /** 选中表格的一个单元格（extend=true 时从原锚点扩展选区到该格） */
+    selectTableCell(shapeId: string, row: number, col: number, extend?: boolean): void;
+    /** 当前正在编辑的单元格（null = 未在编辑） */
+    getTableEditing(): {
+        shapeId: string;
+        row: number;
+        col: number;
+    } | null;
+    /** 进入单元格编辑态（双击单元格触发） */
+    beginTableEdit(shapeId: string, row: number, col: number): void;
+    /** 退出单元格编辑态 */
+    exitTableEdit(): void;
+    /** 更新单元格内容/样式。commit=false 时只应用不写历史（就地编辑逐键调用）。 */
+    updateTableCell(shapeId: string, row: number, col: number, patch: Partial<TableCell>, commit?: boolean): void;
+    /** 往视口中心插入一张 rows×cols 的空表（工具栏「表格」面板用） */
+    insertTable(rows?: number, cols?: number): string | undefined;
+    /** 在指定行（缺省选区行）下方插入一行 */
+    insertTableRow(shapeId: string, at?: number): void;
+    /** 在指定列（缺省选区列）右侧插入一列 */
+    insertTableColumn(shapeId: string, at?: number): void;
+    /** 删除指定行（缺省选区行）；仅剩一行时不删 */
+    deleteTableRow(shapeId: string, at?: number): void;
+    /** 删除指定列（缺省选区列）；仅剩一列时不删 */
+    deleteTableColumn(shapeId: string, at?: number): void;
+    /**
+     * 当前选区覆盖的行列范围（clamp 后）；无选区或不属于该表时返回 null。
+     * ⚠️ 结果会**扩张到完整包住所有相交的合并区**（对齐飞书：选区永远吸附整块），
+     * 这样高亮、合并、拆分、删除行列看到的是同一个范围。
+     */
+    private getTableSelRange;
+    /**
+     * 相对当前选区插入一行：above = 选区首行之上，below = 选区末行之下。
+     * 插入后选区落到新行（沿用原列范围），便于连续向上/向下插入。
+     */
+    insertTableRowRelative(shapeId: string, position: 'above' | 'below'): void;
+    /** 相对当前选区插入一列：left = 选区首列之左，right = 选区末列之右。插入后选区落到新列 */
+    insertTableColumnRelative(shapeId: string, position: 'left' | 'right'): void;
+    /**
+     * 删除选区覆盖的全部行（一次历史记录）；至少保留一行，全选时不做任何事。
+     * 删除后选区收敛到删除位置所在行（同列范围）。
+     */
+    deleteTableRowsInSelection(shapeId: string): void;
+    /** 删除选区覆盖的全部列（一次历史记录）；至少保留一列 */
+    deleteTableColsInSelection(shapeId: string): void;
+    /** 行列删除后把选区/编辑格收敛到剩余范围内 */
+    private clampTableSelectionAfterDelete;
+    /** 合并当前选区（单格时无操作）。范围含已合并区时按扩张后的完整范围合并 */
+    mergeTableCells(shapeId?: string): void;
+    /**
+     * 拆分当前选区里的**所有**合并区（飞书式：选中合并区的任意部分即可整体还原）。
+     * 选区里没有合并区时无操作。
+     */
+    splitTableCells(shapeId?: string): void;
+    /** 拆分指定格所在的合并区域（保留旧入口：用于「就点这一格」的调用方） */
+    splitTableCell(shapeId?: string): void;
     /** 给指定 UML 类追加一条属性 */
     addUmlAttribute(shapeId: string): void;
     /** 给指定 UML（类图或接口）追加一条方法 */
@@ -1018,6 +1290,18 @@ declare class Editor {
     getCamera(): Camera;
     /** 指针是否处于按下状态（拖拽/画线/框选中） */
     isPointerDown(): boolean;
+    /**
+     * 该图形画在画布上的文字**是否没显示全**（被省略号截断）。
+     * UI 用它在「文字显示不全」时才弹出全文提示块 —— 显示得下就不打扰用户。
+     */
+    isShapeTextTruncated(shapeId: string): boolean;
+    /** UML 的某一行文字是否没显示全（提示块显示条件；字号/加粗按该行实际绘制用的值取） */
+    isUmlRowTextTruncated(row: {
+        shape: UmlClassShape | UmlInterfaceShape;
+        section: 'className' | 'attribute' | 'method';
+        rowIndex: number;
+        text: string;
+    }): boolean;
     /** 当前画布内容的包围盒（世界坐标，含留白），导出时用于确定画布尺寸与视口 */
     getContentBounds(padding?: number): {
         x: number;
@@ -1203,6 +1487,22 @@ declare class Renderer {
     private showGrid;
     /** 文本排版缓存：避免每帧对每个字符做 measureText */
     private textLayoutCache;
+    /** 当前表格单元格选区（由 Editor 每帧写入），用于在画布上画选区高亮 */
+    private tableSelection;
+    /** 写入表格单元格选区（null = 无） */
+    setTableSelection(sel: {
+        shapeId: string;
+        anchor: {
+            row: number;
+            col: number;
+        };
+        focus: {
+            row: number;
+            col: number;
+        };
+    } | null): void;
+    /** 当前悬停的图形 id（由每帧 render 写入），仅用于表格拖动把手等提示性绘制 */
+    private hoverShapeId;
     private static readonly TEXT_CACHE_LIMIT;
     constructor(canvas: HTMLCanvasElement, dpr?: number);
     resize(width: number, height: number): void;
@@ -1238,6 +1538,8 @@ declare class Renderer {
      */
     private drawGrid;
     private drawShape;
+    /** 表格左上角的六点拖动把手（尺寸恒定屏幕像素） */
+    private drawTableMoveHandle;
     private applyStyle;
     private drawRectangle;
     private drawRoundedRectangle;
@@ -1270,6 +1572,14 @@ declare class Renderer {
      */
     private drawIcon;
     private drawUmlClass;
+    /**
+     * 表格：整表背景 + 单元格底色 + 内部网格线（被合并区域跨过的边界段断开）
+     * + 外边框（跟随图形样式）+ 单元格文字（超出省略）。
+     */
+    private drawTable;
+    /** 画一条带缺口的网格线（gaps 为沿线区间，区间内不画） */
+    private drawSegmentsWithGaps;
+    private strokeGridSegment;
     /**
      * UML 接口：标题显示为 `<<${className}>>`，仅方法段，无属性段，只有一条分隔线。
      */
@@ -1389,12 +1699,23 @@ declare class Renderer {
     /**
      * 获取文本的显示行（换行 + 截断），结果按 shape/文本/尺寸缓存，
      * 避免每帧渲染都对文本逐字符 measureText。
+     * cacheKeyExtra：同一图形内不同字体（如表格单元格加粗/字号）要分开缓存时传入。
      */
     private getDisplayLines;
     private drawShapeText;
     private getTextBounds;
     private wrapLine;
     private truncateLine;
+    /**
+     * 画在画布上的文字是否被截断（有内容没显示全）。
+     * 与 drawShapeText / drawText 用**同一套** bounds 与换行规则，所以判定结果
+     * 和用户看到的一致：UI 上用它在「文字显示不全」时才弹出全文提示。
+     */
+    isShapeTextTruncated(shape: Shape): boolean;
+    /** 换行后的行数是否超过可见行数（超过 = 画的时候会截断并加省略号） */
+    private isTextTruncated;
+    /** UML 的某一行是否被省略号截断（与 drawUmlClass / drawUmlInterface 的 ellipsize 同规则） */
+    isUmlRowTextTruncated(shape: Shape, text: string, fontSize: number, bold?: boolean): boolean;
     /** 连接点句柄 → 外法向（页面坐标单位向量；规则见 docking.ts） */
     private static readonly HANDLE_NORMALS;
     /**
@@ -1449,6 +1770,16 @@ declare class Renderer {
     private drawArrowHeads;
     private drawText;
     private drawFreehand;
+    /**
+     * 锁定标记：图形右上角画一枚小挂锁（尺寸按屏幕像素恒定），
+     * 独立于选中态 —— 锁定的图形通常选不中，得靠这枚锁告诉用户「它为什么点不动」。
+     */
+    private drawLockBadge;
+    /**
+     * 组外框：选中集恰好是一个完整的组（且不止一个成员）时，给整组描一圈虚线，
+     * 提示「这些图形是绑在一起的」。整组锁定的成员画不到（成员不可选），不需要外框。
+     */
+    private drawGroupFrames;
     private drawSelectionOutline;
     private drawSelectionHandles;
     /**
@@ -1656,6 +1987,8 @@ interface ToolContext {
     } | null;
     /** 选中思维导图节点（不进入编辑态） */
     selectMindMapNode(shapeId: string, nodeId: string): void;
+    /** 选中表格单元格（extend = 从原锚点扩展）—— 表格内拖拽框选走这里 */
+    selectTableCell(shapeId: string, row: number, col: number, extend?: boolean): void;
 }
 declare abstract class Tool {
     abstract type: ToolType;
@@ -1685,6 +2018,8 @@ declare abstract class Tool {
 declare class SelectTool extends Tool {
     type: ToolType;
     private state;
+    /** 正在框选的表格 id（表格内拖拽框选单元格，拖到表外自动扩成整行/整列） */
+    private cellSelectShapeId;
     private translatingState;
     private resizingState;
     private generatingState;
@@ -1715,6 +2050,14 @@ declare class SelectTool extends Tool {
     /** 把生成点位打包成创建上下文（from 为源点，to 为目标落点） */
     private genContext;
     onPointerDown(point: Vec2, event: PointerEvent): void;
+    /**
+     * 命中「表格左上角拖动把手」的表格。把手画在表格包围盒之外、普通 hitTest 命中不到，
+     * 所以这里单独判定；落点上若有别的图形则不抢（避免盖住别人的点击）。
+     */
+    private findTableMoveHandleAt;
+    /** 记录「移动选中图形」的起始状态（按住拖动把手/图形本体都用这一份） */
+    private beginTranslating;
+    private captureTranslatingStart;
     onPointerMove(point: Vec2, event: PointerEvent): void;
     onPointerUp(point: Vec2, _event: PointerEvent): void;
     /**
@@ -1920,12 +2263,22 @@ declare function calcUmlClassSize(className: string, attributes: UmlAttribute[],
 };
 declare class ShapeTool extends Tool {
     type: ShapeType;
+    /** 按下点（页面坐标）；null = 未按下 */
+    private pressPoint;
+    /** 本次按下的图形 id（按下即生成默认尺寸，拖动只改它的大小） */
+    private draftId;
+    /** 是否已进入拖拽状态（超过阈值） */
+    private dragging;
     constructor(context: ToolContext, shapeType: ShapeType);
     onPointerDown(point: Vec2, _event: PointerEvent): void;
-    onPointerMove(_point: Vec2, _event: PointerEvent): void;
+    onPointerMove(point: Vec2, event: PointerEvent): void;
     onPointerUp(_point: Vec2, _event: PointerEvent): void;
-    onKeyDown(_event: KeyboardEvent): void;
+    onKeyDown(event: KeyboardEvent): void;
     onKeyUp(_event: KeyboardEvent): void;
+    /** 拖拽生成中 = 一次未结束的交互（指针丢失时编辑器会来收尾） */
+    hasTransientState(): boolean;
+    /** 丢事件自愈：保持图形当前尺寸落定（历史点在按下时已记），清掉拖拽状态 */
+    cancelTransient(): boolean;
     getCursor(point: Vec2): string | null;
 }
 
@@ -2046,4 +2399,169 @@ declare function countMindMapNodes(root: MindMapNode): number;
  */
 declare function layoutMindMap(root: MindMapNode): MindMapLayoutResult;
 
-export { type ArrowBinding, type ArrowHeadType, type ArrowShape, type ArrowStyle, ArrowTool, Camera, type CameraState, type CircleShape, type ConnectionType, DEFAULT_HIGHLIGHTER_COLOR, type DiamondShape, type DrawShape, type DrawuiTheme, type DrawuiThemeSelection, Editor, type EditorData, type EditorOptions, type EditorState, type EllipseShape, type ExportFormat, type ExportOptions, type FreehandMode, FreehandTool, type GenerationContext, HandTool, type HexagonShape, ICONS, ICON_CATEGORIES, ICON_CATEGORY_INK, ICON_DEFAULT_INK, ICON_DEFAULT_SIZE, ICON_GRID, type IconCategoryId, type IconDef, type IconLayer, type IconShape, LANGUAGES, type Language, type LineShape, LineTool, MINDMAP_COLORS, MINDMAP_FONT_SIZE, MINDMAP_MAX_WIDTH, MINDMAP_MIN_WIDTH, MINDMAP_NODE_HEIGHT, MIN_HANDLE_SEGMENT, MIN_JOG, Mat2d, type MessageKey, type MindMapLayoutResult, type MindMapNode, type MindMapNodePos, type MindMapShape, type OctagonShape, type ParallelogramShape, type PentagonShape, type Rect, type RectangleShape, Renderer, type RoundedRectangleShape, STICKY_FOLD_RATIO, STICKY_NOTE_COLORS, STICKY_NOTE_DEFAULT_COLOR, STICKY_TEXT_SCALE, type SegmentHandle, SelectTool, type Shape, type ShapeStyle, ShapeTool, type ShapeType, type SnapGuide, type StarShape, type StickyNoteShape, THEME, type TextShape, type ToolType, type TrapezoidShape, type TriangleShape, UML_FONT_SIZE, UML_HEADER_HEIGHT, UML_LINE_HEIGHT, UML_MIN_WIDTH, UML_PADDING_X, UML_PADDING_Y, type UiEvent, type UmlAttribute, type UmlClassShape, type UmlInterfaceShape, type UmlMethod, type UmlVisibility, Vec, type Vec2 as Vec2Type, calcUmlClassSize, cloneMindMapNode, collapseRoute, connectorSegmentHandles, countMindMapNodes, downloadBlob, exportToBlob, findMindMapNode, getContentBounds, getIcon, getLanguage, getMindMapNodeDepth, getMindMapParent, getTheme, hasIcon, hexToRgba, iconInk, iconsByCategory, isStubCorner, layoutMindMap, mindMapNodeColor, mindMapNodeSize, offsetConnectorSegment, pickSegmentHandle, pointToSegmentDistance, pruneStubBends, renderSVGString, renderToCanvas, routeToUserPoints, sameRoute, searchIcons, setLanguage, setTheme, shadeColor, subscribeLanguage, subscribeTheme, t };
+/**
+ * 表格的纯数据操作（唯一实现）：行列增删、合并/拆分、命中定位。
+ *
+ * 合并模型：**每个合并区域只有左上角格子是「锚点」**，锚点带 `rowSpan/colSpan`；
+ * 区域内其余格子是被覆盖格（渲染/命中时跳过，点击时映射回锚点）。
+ * 所有操作都返回新的 cells/rowHeights 数组（不可变），由 Editor 负责写回与历史。
+ */
+declare const TABLE_FONT_SIZE = 14;
+/** 单元格文字与边框的内边距 */
+declare const TABLE_CELL_PADDING_X = 10;
+/** 单元格文字与上下边框的内边距（多行时用） */
+declare const TABLE_CELL_PADDING_Y = 4;
+/** 单元格多行文字的行高倍率（与图形文字换行保持一致） */
+declare const TABLE_LINE_HEIGHT_RATIO = 1.3;
+/** 行高随内容自动增高的上限行数（再多就靠裁剪+省略号） */
+declare const TABLE_MAX_AUTO_LINES = 10;
+declare const TABLE_MIN_COL_WIDTH = 40;
+declare const TABLE_MIN_ROW_HEIGHT = 24;
+declare const TABLE_DEFAULT_COL_WIDTH = 140;
+declare const TABLE_DEFAULT_ROW_HEIGHT = 36;
+/** 默认首行（表头）底色与网格线颜色 */
+declare const TABLE_HEADER_FILL = "#f1f3f5";
+/** 把手尺寸（屏幕像素，需除以 zoom 换算成本地尺寸）：竖排的六点抓手 */
+declare const TABLE_MOVE_HANDLE_WIDTH = 18;
+declare const TABLE_MOVE_HANDLE_HEIGHT = 22;
+/** 把手与表格左边框的间距（屏幕像素）。
+ * ⚠️ 必须贴在表格**左侧外侧、顶部对齐**：
+ *  - 画在表格上方会被「单元格悬浮工具条」盖住（它正好在表格上方那一带）；
+ *  - 画在表格内侧会压住单元格第一行的文字。 */
+declare const TABLE_MOVE_HANDLE_GAP = 4;
+/** 页面坐标 → 表格本地坐标（原点 = 表格左上角；已抵消旋转） */
+declare function tableLocalPoint(t: TableShape, point: Vec2): Vec2;
+/** 本地坐标 → 页面坐标（tableLocalPoint 的逆运算） */
+declare function tablePagePoint(t: TableShape, local: Vec2): Vec2;
+/** 拖动把手的本地矩形（贴表格左边框外侧、顶部对齐，尺寸恒为屏幕像素） */
+declare function tableMoveHandleLocalRect(t: TableShape, zoom: number): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/** 指针是否落在拖动把手上（point 为页面坐标；tol 为额外容差，屏幕像素） */
+declare function hitTableMoveHandle(t: TableShape, point: Vec2, zoom: number, tol?: number): boolean;
+/** 指针是否落在表格内部（表格内拖拽 = 框选单元格，不移动整表） */
+declare function hitTableBody(t: TableShape, point: Vec2, tol?: number): boolean;
+/**
+ * 本地坐标 → 表格行列；**超出表格时 clamp 到边缘行列**（拖到表外 = 选中整行/整列）。
+ * 本地坐标恰好落在边界线时归到右侧/下方的格子。
+ */
+declare function tableCellAtLocalClamped(t: TableShape, local: Vec2): {
+    row: number;
+    col: number;
+};
+/** 选区（anchor→focus）在本地坐标下的合并矩形（用于画选区高亮） */
+declare function tableRangeLocalRect(t: TableShape, r1: number, c1: number, r2: number, c2: number): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+declare function tableTotalWidth(colWidths: number[]): number;
+declare function tableTotalHeight(rowHeights: number[]): number;
+/**
+ * 单元格内多行文字第一行的「基线中心」相对单元格顶部的偏移（画布/导出共用，保证一致）。
+ * - 文字整体放得下：垂直居中；
+ * - 放不下（行数超出可视行数被截断）：顶部对齐并留出 TABLE_CELL_PADDING_Y 内边距，
+ *   这样读者能看到文字开头而不是中间被裁的片段。
+ */
+declare function tableCellTextStartOffset(lineCount: number, lineHeight: number, cellHeight: number): number;
+/** 建一张空表；header=true 时首行为表头（加粗 + 浅灰底） */
+declare function createTableCells(rows: number, cols: number, header?: boolean): TableCell[][];
+/**
+ * 某格文字在给定宽度下需要几行（逐字符贪心折行 + 显式 \n），
+ * 与 Renderer.getDisplayLines / export.wrapText 的换行规则一致。
+ */
+declare function tableCellLineCount(text: string, fontSize: number, bold: boolean, maxWidth: number): number;
+/**
+ * 按内容把行高撑到够显示（只增不减，上限 TABLE_MAX_AUTO_LINES 行）。
+ * 无需变化时返回 null；否则返回新的 rowHeights。
+ * 合并单元格按其跨越行的总高度判断，缺口补在跨区最后一行。
+ */
+declare function tableGrowRowHeights(shape: TableShape): number[] | null;
+declare function cloneTableCells(cells: TableCell[][]): TableCell[][];
+declare function cloneTable(t: TableShape): TableShape;
+/** 覆盖矩阵：covered[r][c]=true 表示该格被某个合并锚点覆盖（不渲染/不命中） */
+declare function tableCoveredMap(cells: TableCell[][]): boolean[][];
+/** 先拆掉与目标矩形相交的所有已有合并区域，再合并成一个大格 */
+declare function tableMerge(cells: TableCell[][], r1: number, c1: number, r2: number, c2: number): TableCell[][];
+/** 拆分某格所在的合并区域（无合并时原样返回） */
+declare function tableSplit(cells: TableCell[][], r: number, c: number): TableCell[][];
+/** 若 (r,c) 属于某个合并区（含被覆盖格），返回该合并区的锚点行列；否则返回自身 */
+declare function tableAnchorAt(t: TableShape, r: number, c: number): {
+    row: number;
+    col: number;
+};
+/**
+ * 把选区扩张到「完整包住所有相交的合并区」（飞书式：选区永远吸附到整块）。
+ * 迭代到稳定，因为扩张后可能又碰到新的合并区。
+ */
+declare function tableExpandRangeToMerges(t: TableShape, r1: number, c1: number, r2: number, c2: number): {
+    r1: number;
+    c1: number;
+    r2: number;
+    c2: number;
+};
+/** 选区里是否含合并区（「拆分单元格」按钮的启用条件） */
+declare function tableRangeHasMerge(t: TableShape, r1: number, c1: number, r2: number, c2: number): boolean;
+/** 拆分选区里**所有**合并区（无合并时返回原 cells 引用） */
+declare function tableSplitRange(t: TableShape, r1: number, c1: number, r2: number, c2: number): TableCell[][];
+/**
+ * 在 at 行之前插入一个空行；穿过该行的合并区域自动加一行跨度。
+ * 新行的样式与行高沿用相邻行（上邻行；若上邻行是表头行则改用其下一行，
+ * 避免在表头下方插入时把表头样式复制成两行）。
+ */
+declare function tableInsertRow(cells: TableCell[][], rowHeights: number[], at: number): {
+    cells: TableCell[][];
+    rowHeights: number[];
+};
+/**
+ * 在 at 列之前插入一个空列；穿过该列的合并区域自动加一列跨度。
+ * 新列的样式与列宽沿用左邻列（在首列前插入则用原首列）。
+ */
+declare function tableInsertColumn(cells: TableCell[][], colWidths: number[], at: number): {
+    cells: TableCell[][];
+    colWidths: number[];
+};
+/** 删除第 at 行（仅剩一行时返回 null 表示不可删）；合并区域自动收缩/换锚点 */
+declare function tableDeleteRow(cells: TableCell[][], rowHeights: number[], at: number): {
+    cells: TableCell[][];
+    rowHeights: number[];
+} | null;
+/** 删除第 at 列（仅剩一列时返回 null 表示不可删）；合并区域自动收缩/换锚点 */
+declare function tableDeleteColumn(cells: TableCell[][], colWidths: number[], at: number): {
+    cells: TableCell[][];
+    colWidths: number[];
+} | null;
+/** 表格内某格（含合并跨度）相对表格左上角的矩形 */
+declare function tableCellLocalRect(t: TableShape, row: number, col: number): {
+    ox: number;
+    oy: number;
+    width: number;
+    height: number;
+};
+/**
+ * 表格内命中：返回该点的 (row, col)。
+ * 点落在合并区域的被覆盖格上时映射回锚点；不在表格内返回 null。
+ * lx/ly 为相对表格左上角的坐标。
+ */
+declare function tableRowAtPoint(t: TableShape, lx: number, ly: number): {
+    row: number;
+    col: number;
+} | null;
+
+/**
+ * UML 行文字的唯一来源（画布 / SVG 导出 / 尺寸计算 / 就地基共用）。
+ *
+ * 约定：**预设值是要给的**（新建的类/接口自带 `+ field: string`、`+ method(param): void`），
+ * 但整行就是一段普通文字，用户可以像改 input 一样把它删光（连 `+` 一起删）。
+ * 删空的行在画布上什么都不画（`''`），不会自己长回预设文字。
+ */
+/** 属性行：`+ name: type`；可见性被删掉就只剩 `name: type`；整行删空返回 '' */
+declare function umlAttrRowText(a: UmlAttribute): string;
+/** 方法行：`+ name(params): returnType`；同上 */
+declare function umlMethodRowText(m: UmlMethod): string;
+
+export { type ArrowBinding, type ArrowHeadType, type ArrowShape, type ArrowStyle, ArrowTool, Camera, type CameraState, type CircleShape, type ConnectionType, DEFAULT_HIGHLIGHTER_COLOR, type DiamondShape, type DrawShape, type DrawuiTheme, type DrawuiThemeSelection, Editor, type EditorData, type EditorOptions, type EditorState, type EllipseShape, type ExportFormat, type ExportOptions, type FreehandMode, FreehandTool, type GenerationContext, HandTool, type HexagonShape, ICONS, ICON_CATEGORIES, ICON_CATEGORY_INK, ICON_DEFAULT_INK, ICON_DEFAULT_SIZE, ICON_GRID, type IconCategoryId, type IconDef, type IconLayer, type IconShape, LANGUAGES, type Language, type LineShape, LineTool, MINDMAP_COLORS, MINDMAP_FONT_SIZE, MINDMAP_MAX_WIDTH, MINDMAP_MIN_WIDTH, MINDMAP_NODE_HEIGHT, MIN_HANDLE_SEGMENT, MIN_JOG, Mat2d, type MessageKey, type MindMapLayoutResult, type MindMapNode, type MindMapNodePos, type MindMapShape, type OctagonShape, type ParallelogramShape, type PentagonShape, type Rect, type RectangleShape, Renderer, type RoundedRectangleShape, STICKY_FOLD_RATIO, STICKY_NOTE_COLORS, STICKY_NOTE_DEFAULT_COLOR, STICKY_TEXT_SCALE, type SegmentHandle, SelectTool, type Shape, type ShapeStyle, ShapeTool, type ShapeType, type SnapGuide, type StarShape, type StickyNoteShape, TABLE_CELL_PADDING_X, TABLE_CELL_PADDING_Y, TABLE_DEFAULT_COL_WIDTH, TABLE_DEFAULT_ROW_HEIGHT, TABLE_FONT_SIZE, TABLE_HEADER_FILL, TABLE_LINE_HEIGHT_RATIO, TABLE_MAX_AUTO_LINES, TABLE_MIN_COL_WIDTH, TABLE_MIN_ROW_HEIGHT, TABLE_MOVE_HANDLE_GAP, TABLE_MOVE_HANDLE_HEIGHT, TABLE_MOVE_HANDLE_WIDTH, THEME, type TableCell, type TableShape, type TextShape, type ToolType, type TrapezoidShape, type TriangleShape, UML_FONT_SIZE, UML_HEADER_HEIGHT, UML_LINE_HEIGHT, UML_MIN_WIDTH, UML_PADDING_X, UML_PADDING_Y, type UiEvent, type UmlAttribute, type UmlClassShape, type UmlInterfaceShape, type UmlMethod, type UmlVisibility, Vec, type Vec2 as Vec2Type, calcUmlClassSize, cloneMindMapNode, cloneTable, cloneTableCells, collapseRoute, connectorSegmentHandles, countMindMapNodes, createTableCells, downloadBlob, exportToBlob, findMindMapNode, getContentBounds, getIcon, getLanguage, getMindMapNodeDepth, getMindMapParent, getTheme, hasIcon, hexToRgba, hitTableBody, hitTableMoveHandle, iconInk, iconsByCategory, isFlippableShapeType, isStubCorner, layoutMindMap, mindMapNodeColor, mindMapNodeSize, offsetConnectorSegment, pickSegmentHandle, pointToSegmentDistance, pruneStubBends, renderSVGString, renderToCanvas, routeToUserPoints, sameRoute, searchIcons, setLanguage, setTheme, shadeColor, subscribeLanguage, subscribeTheme, t, tableAnchorAt, tableCellAtLocalClamped, tableCellLineCount, tableCellLocalRect, tableCellTextStartOffset, tableCoveredMap, tableDeleteColumn, tableDeleteRow, tableExpandRangeToMerges, tableGrowRowHeights, tableInsertColumn, tableInsertRow, tableLocalPoint, tableMerge, tableMoveHandleLocalRect, tablePagePoint, tableRangeHasMerge, tableRangeLocalRect, tableRowAtPoint, tableSplit, tableSplitRange, tableTotalHeight, tableTotalWidth, umlAttrRowText, umlMethodRowText };