drawui-core 0.4.1 → 0.4.2

package/dist/index.d.cts

@@ -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;
@@ -682,6 +695,26 @@ declare const zhCN: {
     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': "没有匹配的图标";
@@ -817,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）：按下状态与一切瞬态预览都作废，避免"卡住" */
@@ -864,8 +900,43 @@ declare class Editor {
     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;
@@ -927,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;
     /**
@@ -1654,6 +1770,16 @@ declare class Renderer {
     private drawArrowHeads;
     private drawText;
     private drawFreehand;
+    /**
+     * 锁定标记：图形右上角画一枚小挂锁（尺寸按屏幕像素恒定），
+     * 独立于选中态 —— 锁定的图形通常选不中，得靠这枚锁告诉用户「它为什么点不动」。
+     */
+    private drawLockBadge;
+    /**
+     * 组外框：选中集恰好是一个完整的组（且不止一个成员）时，给整组描一圈虚线，
+     * 提示「这些图形是绑在一起的」。整组锁定的成员画不到（成员不可选），不需要外框。
+     */
+    private drawGroupFrames;
     private drawSelectionOutline;
     private drawSelectionHandles;
     /**
@@ -2137,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;
 }
 
@@ -2428,4 +2564,4 @@ 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 };
+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 };

package/dist/index.d.ts

@@ -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;
@@ -682,6 +695,26 @@ declare const zhCN: {
     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': "没有匹配的图标";
@@ -817,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）：按下状态与一切瞬态预览都作废，避免"卡住" */
@@ -864,8 +900,43 @@ declare class Editor {
     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;
@@ -927,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;
     /**
@@ -1654,6 +1770,16 @@ declare class Renderer {
     private drawArrowHeads;
     private drawText;
     private drawFreehand;
+    /**
+     * 锁定标记：图形右上角画一枚小挂锁（尺寸按屏幕像素恒定），
+     * 独立于选中态 —— 锁定的图形通常选不中，得靠这枚锁告诉用户「它为什么点不动」。
+     */
+    private drawLockBadge;
+    /**
+     * 组外框：选中集恰好是一个完整的组（且不止一个成员）时，给整组描一圈虚线，
+     * 提示「这些图形是绑在一起的」。整组锁定的成员画不到（成员不可选），不需要外框。
+     */
+    private drawGroupFrames;
     private drawSelectionOutline;
     private drawSelectionHandles;
     /**
@@ -2137,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;
 }
 
@@ -2428,4 +2564,4 @@ 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 };
+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 };