drawui-core 0.3.6 → 0.4.1

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' | 'triangular-pyramid' | 'quadrangular-pyramid' | 'cuboid' | 'sphere' | 'ellipsoid' | 'pie' | 'hollow-pie' | 'uml-class' | 'uml-interface' | 'mind-map' | '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;
@@ -123,6 +123,32 @@ interface StadiumShape extends BaseShape {
     width: number;
     height: number;
 }
+/**
+ * 便签纸：矩形纸面 + 右下角折角（dog-ear）。
+ *
+ * 折角的观感来自两部分：**纸面缺掉一角** + **折回来的一块纸背**（同色系略深），
+ * 轮廓与折角三角定义在 `shapePaths.ts`，折角色板与文字避让在 `stickyNote.ts`。
+ * 折角大小按 `STICKY_FOLD_RATIO` 随尺寸自动缩放，因此不需要额外的尺寸字段。
+ */
+interface StickyNoteShape extends BaseShape {
+    type: 'sticky-note';
+    width: number;
+    height: number;
+}
+/**
+ * 矢量图标：把内置图标库（`icons.ts`）里的一个图标放到画布上。
+ *
+ * 尺寸模型与矩形一致（以 (x,y) 为中心 + width/height），图标在 24×24 网格里作画后等比缩放；
+ * 颜色：线稿图层跟随 `style.fillColor`（样式面板里的「填充」就是图标颜色），
+ * 少数带固有配色的图层（如数字徽标的圆底）保持自己的颜色。
+ */
+interface IconShape extends BaseShape {
+    type: 'icon';
+    /** 图标库里的 id，见 `ICONS` / `getIcon` */
+    iconId: string;
+    width: number;
+    height: number;
+}
 /**
  * 「矩形区域 + 归一化轮廓」类图形（对话框 / 立方体 / 流程图符号等）。
  * 尺寸模型与矩形完全一致（以 (x,y) 为中心 + width/height），差异只在轮廓，
@@ -133,7 +159,7 @@ interface PathShape extends BaseShape {
     width: number;
     height: number;
 }
-type UmlVisibility = '+' | '-' | '#' | '~';
+type UmlVisibility = '+' | '-' | '#' | '~' | '';
 interface UmlAttribute {
     id: string;
     visibility: UmlVisibility;
@@ -178,6 +204,11 @@ interface LineShape extends BaseShape {
     connectionType?: ConnectionType;
     /** 用户手工调节过的中间折点（世界坐标），见 ArrowShape.userPoints */
     userPoints?: Vec2[];
+    /** userPoints 的参照端点（见 ArrowShape.userPointsRef） */
+    userPointsRef?: {
+        start: Vec2;
+        end: Vec2;
+    };
 }
 type ConnectionType = 'straight' | 'polyline' | 'orthogonal' | 'curve';
 /** 生成点位创建上下文：from 为源点(生成点位)，to 为目标落点 */
@@ -252,6 +283,16 @@ interface ArrowShape extends BaseShape {
      * 两端依旧跟随绑定（拖动图形后两端自动跟上，中间保持用户摆好的位置）。
      */
     userPoints?: Vec2[];
+    /**
+     * `userPoints` 的参照端点：写下这些折点那一刻，两端实际停在哪里（世界坐标）。
+     * 图形移动时按它把折点一起平移（见 connectorEdit.followEndpoints）——
+     * 否则端点移了几像素、折点没动，走线会在端点旁多出一个 2~3px 的小台阶
+     * （肉眼就是「一条线变成两条贴着的线」）。
+     */
+    userPointsRef?: {
+        start: Vec2;
+        end: Vec2;
+    };
 }
 interface TextShape extends BaseShape {
     type: 'text';
@@ -289,8 +330,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 | 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' | 'triangular-pyramid' | 'quadrangular-pyramid' | 'cuboid' | 'sphere' | 'ellipsoid' | 'pie' | 'hollow-pie' | 'uml-class' | 'uml-interface' | 'line' | 'arrow' | 'text' | 'draw' | 'pen' | 'highlighter' | 'eraser' | 'mind-map';
+/**
+ * 表格单元格：合并模型见 `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;
@@ -456,6 +527,8 @@ declare const zhCN: {
     readonly 'tool.class-catalog': "类目";
     readonly 'tool.envelope': "信封";
     readonly 'tool.checkbox': "复选框";
+    readonly 'tool.sticky-note': "便签";
+    readonly 'shape.sticky-note': "便签";
     readonly 'tool.triangular-pyramid': "三棱锥";
     readonly 'tool.quadrangular-pyramid': "四棱锥";
     readonly 'tool.cuboid': "长方体";
@@ -572,6 +645,10 @@ declare const zhCN: {
     readonly 'toolbar.export.png': "PNG 图片";
     readonly 'toolbar.export.svg': "SVG 矢量图";
     readonly 'toolbar.export.pdf': "PDF 文档";
+    readonly 'toolbar.export.data': "导出数据";
+    readonly 'toolbar.import.data': "导入数据";
+    readonly 'import.success': "导入成功，已恢复 {n} 个图形";
+    readonly 'import.fail': "导入失败，文件格式不正确";
     readonly 'shape.mind-map': "思维导图";
     readonly 'mindmap.defaultRoot': "中心主题";
     readonly 'mindmap.defaultBranch': "分支主题";
@@ -591,6 +668,46 @@ 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 'toolbar.icon': "图标";
+    readonly 'icon.search': "搜索图标";
+    readonly 'icon.empty': "没有匹配的图标";
+    readonly 'icon.recent': "最近使用";
+    readonly 'iconCat.status': "状态标记";
+    readonly 'iconCat.number': "数字徽标";
+    readonly 'iconCat.tech': "云与技术";
+    readonly 'iconCat.chart': "数据图表";
+    readonly 'iconCat.office': "办公文档";
+    readonly 'iconCat.media': "媒体协作";
+    readonly 'iconCat.arrow': "箭头方向";
+    readonly 'iconCat.misc': "常用";
+    readonly 'iconCat.emoji': "表情";
+    readonly 'iconCat.device': "电脑设备";
+    readonly 'iconCat.weather': "天气";
+    readonly 'iconCat.transport': "交通";
+    readonly 'iconCat.nature': "自然";
+    readonly 'iconCat.building': "建筑";
+    readonly 'iconCat.medical': "医疗";
+    readonly 'iconCat.shopping': "购物";
+    readonly 'iconCat.science': "科学";
+    readonly 'iconCat.animal': "动物";
+    readonly 'iconCat.time': "时间";
+    readonly 'iconCat.edit': "编辑";
+    readonly 'iconCat.food': "食物";
+    readonly 'iconCat.communication': "通讯";
 };
 type MessageKey = keyof typeof zhCN;
 type LanguageListener = () => void;
@@ -681,6 +798,8 @@ declare class Editor {
     private mindMapEditingShapeId;
     private mindMapSelectedNode;
     private mindMapHoverNode;
+    private tableSelection;
+    private tableEditing;
     private renderScheduled;
     private pointerIsDown;
     private notifyScheduled;
@@ -691,6 +810,13 @@ declare class Editor {
      * 只影响之后创建的箭头；改选中箭头的样式走 updateArrowStyle。
      */
     private arrowStyle;
+    /**
+     * 新建便签的纸面色（工具栏「便签」面板里选的）。
+     * 同样「只影响之后创建的便签」；改选中便签的颜色走 updateSelectedShapesStyle。
+     */
+    private stickyNoteColor;
+    /** 连续插入图标时的错开计数（避免每次都叠在同一处） */
+    private iconInsertSeq;
     constructor(canvas: HTMLCanvasElement, options?: EditorOptions);
     private setupEventListeners;
     /** 窗口失焦（切页签/alt-tab）：按下状态与一切瞬态预览都作废，避免"卡住" */
@@ -726,6 +852,15 @@ declare class Editor {
     private screenToPage;
     private addShape;
     private updateShape;
+    /**
+     * 表格尺寸变化时保持「左上角」不动：行高变化向下伸缩、列宽变化向右伸缩，
+     * 避免整表在画布上向两边跳。返回新的中心坐标（已按旋转角换算）。
+     */
+    private tableTopLeftAnchored;
+    /** 写回表格数据（cells/rowHeights/colWidths），并同步尺寸与中心（左上角不动） */
+    private writeTable;
+    /** 行高不够显示单元格文字时自动增高（只增不减） */
+    private autoGrowTableRows;
     private updateBoundArrows;
     private getBindingPosition;
     private deleteShape;
@@ -746,6 +881,11 @@ declare class Editor {
      * 交给工具层做线段手柄的命中与拖动 —— 用的是渲染器同一套计算，保证「看到哪就能拖哪」。
      */
     private getConnectorRoute;
+    /**
+     * 忽略手工折点的「自动走线」。拖线段松手时用它判断用户是不是又拖回了原来的线
+     * （等价 → 清掉 userPoints，连线恢复成完全自动）。
+     */
+    private getAutoConnectorRoute;
     /**
      * 清掉所有「瞬态」的交互可视化状态：连线预览、目标高亮、对齐参考线、框选、悬停锚点。
      * 这些状态只在一次交互过程中有效 —— 只要交互结束（或事件丢失）就必须清空，
@@ -798,6 +938,20 @@ declare class Editor {
     getArrowStyle(): ArrowStyle;
     /** 修改「新建箭头」的默认样式：只影响之后画出来的箭头 */
     setArrowStyle(updates: Partial<ArrowStyle>): void;
+    /** 读取「新建便签」的纸面色（工具栏「便签」面板用） */
+    getStickyNoteColor(): string;
+    /**
+     * 往画布插入一个内置图标（工具栏「图标」面板用）。
+     *
+     * - 落在**视口中心**；连续插入会依次错开一点，避免全叠在一起；
+     * - 插入后自动选中并切回选择工具，方便立刻拖动 / 缩放；
+     * - 计入撤销历史；图标 id 不存在时返回 undefined（不做任何事）。
+     */
+    insertIcon(iconId: string, size?: number): string | undefined;
+    /** 视口中心（世界坐标）：插入类操作（图标）的默认落点 */
+    private viewportCenter;
+    /** 修改「新建便签」的纸面色：只影响之后创建的便签；非法色值会被忽略 */
+    setStickyNoteColor(color: string): void;
     /** 批量更新选中箭头的虚线样式 */
     updateArrowDashed(dashed: boolean): void;
     /** 更新 UML 类图的类名、属性、方法，自动重算尺寸 */
@@ -870,6 +1024,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（类图或接口）追加一条方法 */
@@ -919,6 +1174,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;
@@ -975,8 +1242,15 @@ declare class Editor {
     saveToStorage(): boolean;
     loadFromStorage(): boolean;
     clearStorage(): void;
+    /**
+     * 导出完整文档数据为 JSON 字符串（图形 + 相机 + 版本号），
+     * 供「导出数据 → 下次导入」保存/恢复继续绘图。
+     */
     exportJSON(): string;
+    /** 从 JSON 字符串恢复完整文档数据；兼容旧版只含 shapes 的格式，返回是否成功 */
     importJSON(json: string): boolean;
+    /** 导出完整数据并触发浏览器下载 .json 文件 */
+    downloadJSON(fileName?: string): void;
     getEditingShapeId(): string | null;
     canEditShape(shape: Shape): boolean;
     enterEditing(shapeId: string): void;
@@ -1051,8 +1325,12 @@ declare function pickSegmentHandle(route: Vec2[], point: Vec2, handleRadius?: nu
  *
  * 传入的 route 应当始终是「按下时的那条走线」，每次移动都从它重新算 —— 因为拖首/末段
  * 会插入折点、段序号会变，从原始走线重算才能得到稳定（不漂移）的结果。
+ *
+ * `extraLevels`：额外的磁吸线（除相邻段之外）。拖动时把「按下那一刻本段所在的水平线」
+ * 和「自动走线的同名水平线」传进来 —— 于是「往回拖到原来那条线」会精准落在线上，
+ * 松手即可判定为「没改过」并合并回自动走线（飞书手感）。
  */
-declare function offsetConnectorSegment(route: Vec2[], index: number, delta: number): Vec2[];
+declare function offsetConnectorSegment(route: Vec2[], index: number, delta: number, extraLevels?: number[]): Vec2[];
 /**
  * 去掉连续重复点与共线冗余点，精简冗余拐点。
  * （唯一实现：Renderer.collapseLinePoints 与交互层写回前都调它 —— 别再各写一份）
@@ -1060,6 +1338,24 @@ declare function offsetConnectorSegment(route: Vec2[], index: number, delta: num
 declare function collapseRoute(pts: Vec2[]): Vec2[];
 /** 走线 → 可写回 shape 的中间折点（去掉两端） */
 declare function routeToUserPoints(route: Vec2[]): Vec2[];
+/** 两条走线是否几何等价（点数相同、逐点重合）——「拖回原来的线」＝没改过 */
+declare function sameRoute(a: Vec2[], b: Vec2[], tol?: number): boolean;
+/**
+ * 端点旁的出/入桩拐角：距端点不超过一个桩长（≈24px），且与端点同轴（只差一个轴向坐标）。
+ * 自动走线的第一个 / 最后一个中间折点就是它 —— 每次渲染都会由桩重新算出来。
+ */
+declare function isStubCorner(end: Vec2, p: Vec2, lead?: number, tol?: number): boolean;
+/**
+ * 丢掉「其实属于自动走线」的手工折点 —— 两端出/入桩的拐角。
+ *
+ * 拖线段时是把当时的整条走线（含自动生成的 24px 桩拐角）写成手工折点的；
+ * 这些拐角一旦被冻进 `userPoints`，之后再移动两端图形时，桩会按新位置重新生成，
+ * 与冻结点错开 → 端点旁多出一次折返（视觉上就是「端点上长了个小钩子」/「变成两条线」）。
+ * 它们每次都会被自动走线重新生成，所以直接丢掉是等价的（画布与导出都靠桩补回来）。
+ *
+ * @param autoRoute 忽略手工折点后的自动走线（世界坐标）
+ */
+declare function pruneStubBends(userPoints: Vec2[], autoRoute: Vec2[], lead?: number, tol?: number): Vec2[];
 
 interface SnapGuide {
     type: 'horizontal' | 'vertical';
@@ -1075,6 +1371,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;
@@ -1110,6 +1422,8 @@ declare class Renderer {
      */
     private drawGrid;
     private drawShape;
+    /** 表格左上角的六点拖动把手（尺寸恒定屏幕像素） */
+    private drawTableMoveHandle;
     private applyStyle;
     private drawRectangle;
     private drawRoundedRectangle;
@@ -1132,7 +1446,24 @@ declare class Renderer {
     private drawPathShape;
     /** 把归一化路径命令展开到 canvas 当前路径 */
     private tracePath;
+    /**
+     * 矢量图标：把 24×24 网格里的图层等比缩放到图形的 width/height 后绘制。
+     *
+     * - 颜色：线稿图层的 `'ink'` 取图形自身的 fillColor（样式面板改「填充」即换图标颜色），
+     *   写死 hex 的图层（数字徽标的圆底）保持自己的配色；
+     * - 线宽用「网格单位」而不是屏幕单位，所以图标放大时线条跟着变粗，像字体图标那样；
+     * - 用 `Path2D` 直接吃 SVG path 字符串，与 SVG 导出共用同一份路径数据（含圆弧，无需自己解析）。
+     */
+    private drawIcon;
     private drawUmlClass;
+    /**
+     * 表格：整表背景 + 单元格底色 + 内部网格线（被合并区域跨过的边界段断开）
+     * + 外边框（跟随图形样式）+ 单元格文字（超出省略）。
+     */
+    private drawTable;
+    /** 画一条带缺口的网格线（gaps 为沿线区间，区间内不画） */
+    private drawSegmentsWithGaps;
+    private strokeGridSegment;
     /**
      * UML 接口：标题显示为 `<<${className}>>`，仅方法段，无属性段，只有一条分隔线。
      */
@@ -1153,21 +1484,35 @@ declare class Renderer {
     /**
      * 把连线两端解析成世界坐标折点 + 停靠法向（绑定落点、auto 重选、未绑定端点的轮廓吸附）。
      * 绘制与 getConnectorRoute 共用这一份，避免两处规则漂移。
+     *
+     * fromBox/toBox：两端**绑定图形**的包围盒（已转成与 points 相同的本地坐标，
+     * 即相对 shape.x/y）。供正交路由做「总线避开两端图形内部」的避让（见 docking.orthogonalRoute）。
+     * 只取绑定端：未绑定（悬空）端的画布/导出本来就不完全对齐，本轮避让不扩大战场。
      */
     private resolveConnectorEnds;
+    /** 绑定图形的包围盒，转成连线本地点坐标系（相对 shape.x/y，供 orthogonalRoute 避让用） */
+    private localDockBox;
     /**
      * 用户手工调过折点的连线：走线 = 起点 → 用户折点… → 终点（两端仍跟随绑定/端点）。
      *
      * ⚠️ 两端要先做和「两端点」时同样的近似对齐：用户是照着**对齐后**的那条线拖的手柄，
      * 折点坐标是相对对齐后的轴线算出来的；若这里用未对齐的原始端点接上，就会在两端各
      * 留下几像素的斜边（画布与导出还会各画各的）。对齐后手工折点与端点严格同轴。
+     *
+     * 折点还要先「跟着两端移动」+「拉回端点轴线」（resolveUserPoints）：图形移动后若折点留在
+     * 原地，端点旁会多出 2~3px 的小台阶 —— 肉眼就是「一条线变成两条贴着的线」。
      */
     private withUserPoints;
     /**
      * 连线当前的真实走线（**世界坐标**折点）。
      * 手柄命中、手柄拖动都用它 —— 与绘制同一套计算，所以「看到手柄在哪，点它就一定命中」。
+     *
+     * `options.ignoreUserPoints`：把手工艺折点当作不存在，算出「纯自动」的那条走线。
+     * 拖线段松手时用它判断用户是不是又拖回了原来的线（等价 → 清掉手工状态）。
      */
-    getConnectorRoute(shape: Shape, shapeMap: Map<string, Shape>): Vec2[];
+    getConnectorRoute(shape: Shape, shapeMap: Map<string, Shape>, options?: {
+        ignoreUserPoints?: boolean;
+    }): Vec2[];
     /**
      * 选中连线时：在每段（够长的）线段中点画一个可拖动的小手柄（飞书式「拖线段调位置」）。
      * 拖动交互在 SelectTool 的 'dragging-segment' 状态里。
@@ -1223,27 +1568,12 @@ declare class Renderer {
     private drawSharpPolyline;
     /** 绘制对齐参考线（飞书风格：浅蓝色虚线） */
     private drawSnapGuides;
-    /** 折线：与orthogonal使用相同的H-V-H路由，差异仅在渲染（sharp vs rounded）。dock 法向在首/末段加一段垂直出线桩，垂直脱离图形边缘。 */
-    private generatePolylinePoints;
     /**
-     * 把折线末段掰到期望轴向（'H' 水平收尾 / 'V' 垂直收尾）。
-     * 保证箭头始终沿接入边法向插入（或沿出线方向收尾）。
+     * 折线：与 orthogonal 使用相同的 H-V-H 路由，差异仅在渲染（sharp vs rounded）。
+     * 实现已抽到 connectorRoute.polylineRoutePoints —— 与**导出**共用同一份，
+     * 从构造上保证「画布画出来的 == 导出的」。
      */
-    private ensureFinalAxis;
-    /** 去除连续重合点与共线点，精简冗余拐点（唯一实现见 connectorEdit.collapseRoute） */
-    private collapseLinePoints;
-    /**
-     * 计算单段直角路由：最简单的正交折线（H-V-H / V-H-V / L 拐角）
-     * —— **刻意不做避障**，允许从其它图形上穿过去。
-     *
-     * 为什么不做避障（2026-09-22 决定，对齐飞书）：绕行会让路径在拖动时反复改形
-     * （3 段 ↔ 6 段拐点来回跳），观感就是「绕来绕去」；而「挡路/重叠时直接穿过去、
-     * 端点不挪窝、永远横平竖直」更可预期也更好读。实测绕行只在约 6% 的布局下触发，
-     * 但它带来的「画布 ≠ 导出」与拖拽跳变是所有场景都在承受的。
-     *
-     * 规则与 export.dockRoutePoints 完全一致 → 画布所见即导出所得。
-     */
-    private computeOrthogonalRoute;
+    private generatePolylinePoints;
     /**
      * 曲线：用三次贝塞尔拼接出平滑曲线（离散化采样）。
      * 端点若停靠在图形上（dock.fromN/toN），控制点沿法向伸出，使曲线垂直脱离 / 垂直接入
@@ -1253,12 +1583,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;
     /**
@@ -1341,6 +1682,112 @@ declare const Vec: {
     equals(a: Vec2, b: Vec2): boolean;
 };
 
+/**
+ * 便签纸专属常量与派生逻辑。
+ *
+ * 只放「一个来源、多处消费」的东西：色板、折角比例、折角配色、文字避让。
+ * 几何轮廓本身在 `shapePaths.ts`（canvas 与 SVG 导出共用），这里不重复定义路径。
+ */
+/**
+ * 便签纸色板：12 色（3 列 × 4 行，按色相排布）。
+ * 这是**自有一套**的便签配色（比飞书那套更饱和一点，区分度更高），
+ * 工具栏「便签」面板与样式面板的便签填充色板共用这一份，保证「面板里选什么、后面就是什么」。
+ */
+declare const STICKY_NOTE_COLORS: string[];
+/** 新建便签的默认纸面色 */
+declare const STICKY_NOTE_DEFAULT_COLOR: string;
+/**
+ * 折角在归一化坐标（0..1）下占的比例：横向占 `STICKY_FOLD_RATIO × width`、
+ * 纵向占 `STICKY_FOLD_RATIO × height`。几何与文字避让共用这一个系数，避免两边对不上。
+ */
+declare const STICKY_FOLD_RATIO = 0.2;
+/**
+ * 便签文字的可用区域缩放：常规内边距 0.85 再让掉半个折角，
+ * 保证文字块右下角落在折角斜边之内（不再是 0.85，否则会压到折角上）。
+ */
+declare const STICKY_TEXT_SCALE: number;
+
+/**
+ * 内置矢量图标库。
+ *
+ * 设计约定：
+ * - 每个图标都在 **24×24 的网格**里作画（和工具栏图标同一套坐标习惯），
+ *   渲染时按图形的 width/height 等比缩放，所以放到多大都不糊、导出 SVG 是纯矢量；
+ * - 默认是**线稿风格**（`fill: 'none'` + 描边），这套风格是我们自己的标识，与飞书的实心多彩图标明显不同；
+ * - 颜色用「角色」表达：`'ink'` = 跟随图形自身的颜色（样式面板里改「填充」即换色），
+ *   写具体 hex 的图层则是图标固有配色（如数字徽标的圆底）；
+ * - 本文件是**手绘线稿图标**（`status/number/emoji/device/tech/chart/office/media/arrow/misc`），
+ *   另有 `icons-vendor.ts` 中的图标来自 **Lucide Icons（ISC 协议）**，仅把其真实 SVG 路径
+ *   归一化到 24×24 网格并套用同一套渲染，未改动图形语义——用以补充更多分类（天气/交通等）。
+ */
+/** 图标分类（labelKey 到 i18n 取多语言文案） */
+declare const ICON_CATEGORIES: {
+    id: IconCategoryId;
+    labelKey: MessageKey;
+}[];
+type IconCategoryId = 'status' | 'number' | 'emoji' | 'device' | 'tech' | 'chart' | 'office' | 'media' | 'arrow' | 'misc' | 'weather' | 'transport' | 'nature' | 'building' | 'medical' | 'shopping' | 'science' | 'animal' | 'time' | 'edit' | 'food' | 'communication';
+interface IconLayer {
+    /** 24×24 网格内的路径（语法同 SVG path，统一大写指令） */
+    d: string;
+    /** 填充：`'ink'`（跟随图形颜色，默认）/ `'none'`（线稿）/ 具体 hex */
+    fill?: string;
+    /** 描边：`'ink'`（默认）/ `'none'` / 具体 hex */
+    stroke?: string;
+    /** 线宽（24 网格单位），缺省 1.8；线稿图标建议 1.7~1.9 */
+    w?: number;
+}
+interface IconDef {
+    id: string;
+    cat: IconCategoryId;
+    /** 中文名（同时作为搜索词） */
+    zh: string;
+    /** 英文名（同时作为搜索词） */
+    en: string;
+    /** 额外搜索词（中英混排，空格分隔） */
+    kw?: string;
+    layers: IconLayer[];
+    /**
+     * 这个图标自己的默认「墨色」，优先于所属分类的主色（见 iconInk）。
+     * 全彩图标（表情贴纸）把它设成主色调（脸的黄），作为宿主的兜底色 ——
+     * 它的图层都写死了 hex，颜色是图形语义，不跟着样式面板的「填充」走。
+     */
+    ink?: string;
+    /** 圆底色（数字徽标用）：画一个整圆垫底 */
+    disc?: string;
+    /** 中心文字（数字徽标用） */
+    label?: {
+        text: string;
+        color: string;
+        size?: number;
+    };
+}
+declare const ICONS: IconDef[];
+declare function getIcon(id: string): IconDef | undefined;
+/** 存在该 id 的图标（写入图形/读文档时校验，避免引用到不存在的图标） */
+declare function hasIcon(id: string): boolean;
+declare function iconsByCategory(cat: IconCategoryId): IconDef[];
+/**
+ * 搜索图标：忽略大小写，匹配中/英文名与关键词。
+ * 空查询返回全部；多个词按「全部命中」处理（先按名称命中排序，名称命中优先）。
+ */
+declare function searchIcons(query: string): IconDef[];
+/** 图标图形的默认边长（页面单位） */
+declare const ICON_DEFAULT_SIZE = 48;
+/** 图标作画网格边长（所有图标路径都在 0..ICON_GRID 的坐标里） */
+declare const ICON_GRID = 24;
+/** 图标「墨色」的默认值：线稿图层与单色图标跟随图形颜色（style.fillColor） */
+declare const ICON_DEFAULT_INK = "#3b82f6";
+/**
+ * 每个分类的默认墨色。
+ *
+ * 我们的图标是单色线稿（不是飞书那种实心多彩贴纸），全用一个蓝会显得很单调；
+ * 这里给每个分类配一个主色 —— 面板预览与「插入到画布」都用它，预览与落笔所见即所得；
+ * 插入后仍可在样式面板里改色（换肤不受影响）。
+ */
+declare const ICON_CATEGORY_INK: Record<IconCategoryId, string>;
+/** 取某个图标的默认墨色：图标自带 ink 优先（全彩贴纸），否则用分类主色，最后退回全局默认 */
+declare function iconInk(icon: IconDef): string;
+
 interface ToolContext {
     addShape(shape: Shape): void;
     updateShape(id: string, updates: Partial<Shape>): void;
@@ -1378,6 +1825,12 @@ interface ToolContext {
     setHoverConnector(id: string | null): void;
     /** 某条连线当前的真实走线（世界坐标折点）：线段手柄的命中/拖动用它，与画布绘制同一套计算 */
     getConnectorRoute(shapeId: string): Vec2[];
+    /**
+     * 忽略手工折点后的「自动走线」（世界坐标折点）。
+     * 用于拖线段松手时判断「是不是又拖回原来的线了」—— 等价则把手工艺状态清掉，
+     * 让连线恢复成完全自动（之后再移动图形仍是一条干净的线）。
+     */
+    getAutoConnectorRoute(shapeId: string): Vec2[];
     /** 新建连线的线条样式（颜色/粗细），与最终创建的连线保持一致 */
     getLineStyle(): ShapeStyle;
     /** 拖动到空白处：创建一条浮动线条并弹出"选择新图形"菜单 */
@@ -1399,6 +1852,8 @@ interface ToolContext {
     updateConnectionType(connectionType: ConnectionType): void;
     /** 新建箭头的默认样式（工具栏「箭头」下拉里选的） */
     getArrowStyle(): ArrowStyle;
+    /** 新建便签的纸面色（工具栏「便签」面板里选的） */
+    getStickyNoteColor(): string;
     /** 光标语义命中：思维导图节点框或折叠标记内才命中（节点间空档不命中） */
     getMindMapCursorHitAtPoint(point: Vec2): {
         shapeId: string;
@@ -1406,6 +1861,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;
@@ -1435,6 +1892,8 @@ declare abstract class Tool {
 declare class SelectTool extends Tool {
     type: ToolType;
     private state;
+    /** 正在框选的表格 id（表格内拖拽框选单元格，拖到表外自动扩成整行/整列） */
+    private cellSelectShapeId;
     private translatingState;
     private resizingState;
     private generatingState;
@@ -1465,6 +1924,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;
     /**
@@ -1483,6 +1950,14 @@ declare class SelectTool extends Tool {
      * 这样在选中连线上任意位置按下都能拖到最近那一段，也就不会误触发「拖整条线 / 从锚点拉新线」。
      */
     private hitConnectorSegmentHandle;
+    /**
+     * 拖线段时的磁吸上下文：
+     * - extraLevels =「按下那一刻本段所在的那条线」+「自动走线里同轴的各条线」。
+     *   前者是橡皮筋（往回拖到原位就精准落回去），后者是「拖到自动走线那条线」——
+     *   落在自动走线的线上时，松手就会被判定为「没改过」而合并回自动走线（飞书手感）。
+     * - autoRoute = 忽略手工折点的自动走线，松手时用来做等价判断。
+     */
+    private segmentSnapContext;
     /** 拖线段时的光标：水平段能上下拖 → 上下箭头；垂直段能左右拖 → 左右箭头 */
     private segmentCursor;
     /** 拖动线段：把这一段沿垂直方向平移（相邻段自然伸缩），两端端点永不移动 */
@@ -1493,8 +1968,17 @@ declare class SelectTool extends Tool {
      * - 自由连线（无绑定）整条走线就是它自己的 `points`。
      * 先把走线里的重复点/共线冗余点去掉：**如果去掉后就是一条直线（≤2 点），把 userPoints 清空**，
      * 交还给自动路由 —— 这样「往基线拖、把浅台阶抹平」之后，连线是真的恢复原样，而不是留着一堆零高度折点。
+     *
+     * 另外还要丢掉「其实属于自动走线的折点」（两端出/入桩的拐角，见 pruneStubBends）：
+     * 它们是自动生成的，冻进 userPoints 后会让之后移动图形时端点旁长出小钩子。
      */
     private writeConnectorRoute;
+    /**
+     * 拖线段松手：如果又拖回了「自动走线」那条线上（逐点等价），就把手工状态清掉 ——
+     * 连线恢复成完全自动，之后拖动两端图形仍是一条干净的线（不会残留成两条线 / 小钩子）。
+     * 这就是飞书的「拖回一条线松手即合并」。
+     */
+    private finishSegmentDrag;
     hasTransientState(): boolean;
     /**
      * 取消一切瞬态交互（拖拽/生成/框选/旋转/连线端点拖拽）并清掉画布上的瞬态预览。
@@ -1576,7 +2060,13 @@ declare class SelectTool extends Tool {
     private findShapeNearPoint;
     private pointToRectDistance;
     private static readonly SNAP_THRESHOLD;
+    /**
+     * 连接点吸附半径：**靠近即可**，不再要求精准按在点位上（用户反馈：差一点就「跑走」）。
+     * 连接点优先于精确锚点 —— 这是飞书式的主交互。
+     */
     private static readonly HANDLE_SNAP_DISTANCE;
+    /** 贴边判定：离轮廓这么近视为「贴着这条边松手」→ 吸附到该边中点的连接点 */
+    private static readonly ON_EDGE_SNAP;
     private static readonly ANCHOR_EPS;
     /**
      * 拖拽箭头端点时计算辅助线（与 ArrowTool 规则一致）：
@@ -1585,8 +2075,14 @@ declare class SelectTool extends Tool {
      */
     private computeSnapGuidesForArrow;
     /**
-     * 在 point 附近找可吸附的图形，并返回 binding（精确或非精确）。
-     * 优先级：最近的 handle 吸附（非精确） > 最近的边缘点（精确 normalizedAnchor）
+     * 在 point 附近找可吸附的图形，并返回 binding（连接点或精确锚点）。
+     * 优先级（对齐飞书「靠近连接点即可」）：
+     *  1. 任意图形的连接点（四边中点）40px 内 → 直接吸附该连接点（不受下方候选窗限制）；
+     *  2. 贴着轮廓松手（≤12px）→ 吸附到**这条边中点的连接点**，不落在松手处 ——
+     *     沿某条边方向接近并松手（如贴着顶边从右往左），预期就是那个点位，
+     *     而不是松手位置的精确锚点（用户反馈：松手后点位「跑走」）；
+     *  3. 离轮廓 12~32px 的悬空带 → 精确锚点（保留「连到边上指定位置」的能力）；
+     *  4. 指针落在图形内部 → 按落点相对目标中心的方向选最近的边。
      */
     private findBindingNearPoint;
     private getPageBounds;
@@ -1767,4 +2263,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, 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, type SegmentHandle, SelectTool, type Shape, type ShapeStyle, ShapeTool, type ShapeType, type SnapGuide, type StarShape, 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, getLanguage, getMindMapNodeDepth, getMindMapParent, getTheme, hexToRgba, layoutMindMap, mindMapNodeColor, mindMapNodeSize, offsetConnectorSegment, pickSegmentHandle, pointToSegmentDistance, renderSVGString, renderToCanvas, routeToUserPoints, 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, 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 };