drawui-core 0.5.0 → 0.5.2

package/dist/index.d.cts

@@ -254,6 +254,11 @@ interface GenerationPreview {
     to: Vec2;
     /** 待放置图形的类型；不提供（指向已有图形）时只画线条 */
     type?: ShapeType;
+    /** 待放置图形的尺寸（同型生成时沿用源图形尺寸，虚框必须按它画才与最终一致） */
+    size?: {
+        width: number;
+        height: number;
+    };
     /** 源图形 id 与出线边：预览走与最终创建相同的「出线边同轴接入」路由 */
     sourceShapeId?: string;
     sourceEdge?: 'n' | 'e' | 's' | 'w';
@@ -340,6 +345,7 @@ interface DrawShape extends BaseShape {
     points: Vec2[];
 }
 /** 思维导图节点：可带子节点；颜色/图标/属性说明均可手动覆盖，默认取层级色 */
+type MindMapDirection = 'right' | 'left' | 'up' | 'down';
 interface MindMapNode {
     id: string;
     text: string;
@@ -353,6 +359,13 @@ interface MindMapNode {
     noteColor?: string;
     collapsed?: boolean;
     children?: MindMapNode[];
+    /** 该节点相对于父节点的生长方向；根节点无方向，子节点继承父方向（缺省为 right） */
+    direction?: MindMapDirection;
+    /** 手动拖拽产生的偏移（导图局部坐标，相对自动布局位置）；拖拽节点时连子树一起平移 */
+    offset?: {
+        dx: number;
+        dy: number;
+    };
 }
 interface MindMapShape extends BaseShape {
     type: 'mind-map';
@@ -554,6 +567,17 @@ declare function getTheme(): DrawuiTheme;
 declare function hexToRgba(hex: string, alpha: number): string;
 /** 颜色变暗/变亮：percent 负数变暗、正数变亮 */
 declare function shadeColor(hex: string, percent: number): string;
+/** 页面主题（画布背景 + UI 色调），与 react 层 theme.less 的 data-theme 一一对应 */
+type PageTheme = 'light' | 'warm' | 'gray' | 'purple' | 'green' | 'eye-care';
+/** 页面主题在 core 层需要覆盖的颜色 */
+interface PageThemePreset {
+    /** 网格线颜色 */
+    grid: string;
+}
+/** 页面主题预设：网格颜色随背景深浅调整，保证可见但不突兀 */
+declare const PAGE_THEMES: Record<PageTheme, PageThemePreset>;
+/** 默认页面主题 */
+declare const DEFAULT_PAGE_THEME: PageTheme;
 
 /**
  * 国际化：框架无关的轻量字典 + 语言切换。
@@ -745,6 +769,10 @@ declare const zhCN: {
     readonly 'mindmap.expand': "展开";
     readonly 'mindmap.close': "关闭编辑";
     readonly 'mindmap.more': "更多设置";
+    readonly 'mindmap.level': "层级";
+    readonly 'mindmap.promote1': "升一级";
+    readonly 'mindmap.promote2': "升两级";
+    readonly 'mindmap.promoteDisabled': "已至顶层";
     readonly 'tool.table': "表格";
     readonly 'toolbar.table': "表格";
     readonly 'shape.table': "表格";
@@ -781,6 +809,14 @@ declare const zhCN: {
     readonly 'ctx.delete': "删除";
     readonly 'toolbar.icon': "图标";
     readonly 'toolbar.image': "图片";
+    readonly 'toolbar.more': "更多";
+    readonly 'toolbar.pageTheme': "页面主题";
+    readonly 'pageTheme.light': "默认";
+    readonly 'pageTheme.warm': "暖黄";
+    readonly 'pageTheme.gray': "浅灰";
+    readonly 'pageTheme.purple': "浅紫";
+    readonly 'pageTheme.green': "浅绿";
+    readonly 'pageTheme.eye-care': "护眼";
     readonly 'tool.image': "图片";
     readonly 'image.uploadFailed': "图片上传失败";
     readonly 'image.insertFailed': "图片插入失败";
@@ -846,6 +882,118 @@ declare function exportToBlob(shapes: Shape[], format: ExportFormat, opts?: Expo
 /** 浏览器端触发下载 */
 declare function downloadBlob(blob: Blob, fileName: string): void;
 
+/** 不同层级节点的默认颜色，超过 6 层后循环复用 */
+declare const MINDMAP_COLORS: string[];
+declare const MINDMAP_FONT_SIZE = 14;
+declare const MINDMAP_NODE_HEIGHT = 40;
+declare const MINDMAP_MIN_WIDTH = 80;
+declare const MINDMAP_MAX_WIDTH = 240;
+/** 节点上「+」快捷按钮的圆钮半径（页面单位，随缩放一起放大，与折叠标记一致） */
+declare const MINDMAP_HANDLE_RADIUS = 9;
+/** 「+」圆钮的命中半径（比视觉半径大一点，好点中） */
+declare const MINDMAP_HANDLE_HIT_RADIUS = 12;
+declare const MINDMAP_DIRECTIONS: MindMapDirection[];
+type MindMapHandleKind = 'child' | 'sibling';
+interface MindMapHandlePos {
+    kind: MindMapHandleKind;
+    /** 该加号对应的子节点生长方向（根节点 child 加号有效；非根节点 child 与节点自身方向一致） */
+    direction: MindMapDirection;
+    /** 导图局部坐标（与 layoutMindMap 的 positions 同系，相对导图中心） */
+    x: number;
+    /** 导图局部坐标 */
+    y: number;
+}
+interface MindMapNodePos {
+    x: number;
+    y: number;
+    depth: number;
+    width: number;
+    height: number;
+    /** 该节点在布局中的有效生长方向 */
+    direction: MindMapDirection;
+}
+interface MindMapLayoutResult {
+    positions: Map<string, MindMapNodePos>;
+    width: number;
+    height: number;
+}
+declare function isHorizontalDirection(d: MindMapDirection): boolean;
+/** 子节点的有效方向：自己显式设置优先，否则继承父方向 */
+declare function effectiveDirection(node: MindMapNode, parentDir?: MindMapDirection): MindMapDirection;
+/** 节点颜色：手动设置优先，否则按层级取默认色 */
+declare function mindMapNodeColor(node: MindMapNode, depth: number): string;
+/** 节点框尺寸：由文本长度决定（CJK 按全宽估算），图标占位额外加宽 */
+declare function mindMapNodeSize(node: MindMapNode): {
+    width: number;
+    height: number;
+};
+/** 深拷贝节点树（撤销/重做快照用） */
+declare function cloneMindMapNode(node: MindMapNode): MindMapNode;
+declare function findMindMapNode(root: MindMapNode, nodeId: string): MindMapNode | null;
+declare function getMindMapNodeDepth(root: MindMapNode, nodeId: string): number;
+declare function getMindMapParent(root: MindMapNode, nodeId: string): MindMapNode | null;
+declare function countMindMapNodes(root: MindMapNode): number;
+/**
+ * 四方向树布局：根节点在中心，子节点可向 right/left/up/down 四个方向展开。
+ * 每个子节点继承所在分支的方向；同方向节点按顺序垂直/水平排列。
+ * 返回以内容包围盒中心为原点的局部坐标（shape.x/y 即该中心）。
+ */
+declare function layoutMindMap(root: MindMapNode): MindMapLayoutResult;
+/**
+ * 活动节点上的「+」快捷按钮位置（导图局部坐标；绘制与命中检测共用这一份规则）。
+ *
+ * - 根节点：四个方向各一个 child 加号；
+ * - 非根节点：一个 child 加号（沿自身生长方向），一个 sibling 加号（水平节点在下方、垂直节点在右方）。
+ */
+declare function mindMapNodeHandles(root: MindMapNode, nodeId: string): MindMapHandlePos[];
+/**
+ * 在一份**已算好的布局**上找「+」按钮（局部坐标）：整棵树只走一遍，
+ * 避免「每个节点各算一次布局」的 O(N²)。命中检测走这个，绘制走 mindMapNodeHandles。
+ */
+declare function mindMapHandleAtLocalPoint(root: MindMapNode, positions: Map<string, MindMapNodePos>, lx: number, ly: number): {
+    nodeId: string;
+    kind: MindMapHandleKind;
+    direction: MindMapDirection;
+} | null;
+/**
+ * 获取节点在父节点同方向兄弟列表中的信息。
+ * 根节点的子节点按 direction 分组；普通节点的子节点全部继承父方向。
+ */
+declare function getMindMapNodeSiblings(root: MindMapNode, nodeId: string): {
+    parent: MindMapNode;
+    siblings: MindMapNode[];
+    index: number;
+    direction: MindMapDirection;
+} | null;
+/**
+ * 将指定节点在其同方向兄弟列表中移动到新的索引位置。
+ * newIndex 是相对于同 direction siblings 的索引。
+ */
+declare function reorderMindMapNodeInTree(root: MindMapNode, nodeId: string, newIndex: number): MindMapNode;
+/**
+ * 把节点「升级」levels 层：把 node 重新挂到它第 levels 层祖先之下，并紧挨着
+ * 它原来的直接祖先（即第 levels 层祖先的子节点）之后。
+ *
+ * - 升 1 层：node 成为「父节点的兄弟」（新父 = 祖父）；
+ * - 升 2 层：node 成为「祖父节点的兄弟」（新父 = 曾祖父）；
+ * - ……依此类推。
+ *
+ * 节点自身的子树（children）整体跟着一起上移，不会被拆散。
+ * 可行性由调用方判断：node 的 depth 必须 ≥ levels + 1（至少要有一个「新父」）。
+ * 不满足条件时原样返回 root（不改动）。
+ */
+declare function promoteMindMapNodeInTree(root: MindMapNode, nodeId: string, levels: number): MindMapNode;
+/**
+ * 把节点「转移」到另一个父节点下，落在同方向兄弟组的 insertIndex 处。
+ * 用于拖拽换层级：把节点拖到某个节点上 → 成为该节点的兄弟。
+ *
+ * - 子树整体跟随，不被拆散；
+ * - 目标父节点落在被移动节点自身子树内（或就是它自己）时，原样返回，避免把树拆坏；
+ * - 目标父节点是根节点时，把节点 direction 设为目标兄弟组的方向（否则会被分到错误方向组）；
+ *   目标是普通节点时清掉显式 direction，改为跟随新父节点的方向。
+ */
+declare function moveMindMapNodeInTree(root: MindMapNode, nodeId: string, targetParentId: string, direction: MindMapDirection, insertIndex: number): MindMapNode;
+
 type Listener$1 = () => void;
 type NotificationListener = (message: string) => void;
 /** 核心 → React 的 UI 指令事件 */
@@ -861,6 +1009,11 @@ type UiEvent = {
  | {
     kind: 'imageError';
     message: string;
+}
+/** 正在拖拽/调整图形（移动/缩放/旋转/拖连线端点或线段/从锚点拉新连线）：React 侧据此临时隐藏顶栏工具条 */
+ | {
+    kind: 'drag';
+    active: boolean;
 };
 /** Editor 构造选项：主题色 / 语言 / 初始数据 / 本地持久化开关 */
 interface EditorOptions {
@@ -895,6 +1048,8 @@ declare class Editor {
     private isPanning;
     private panStart;
     private dragStartPositions;
+    /** 是否正处于「拖拽/调整图形」交互中：通过 UiEvent 'drag' 通知 React 临时隐藏顶栏工具条 */
+    private interactionDragging;
     private lastClickTime;
     private lastClickShapeId;
     private editingShapeId;
@@ -915,6 +1070,27 @@ declare class Editor {
     private mindMapEditingShapeId;
     private mindMapSelectedNode;
     private mindMapHoverNode;
+    /** 按下的节点「+」快捷按钮（抬手时若仍在同一按钮上才新建节点） */
+    private pendingMindMapHandle;
+    /**
+     * 按在某个思维导图节点上的拖拽候选：移动超过阈值即开始「同方向重排序」。
+     * 新交互下节点位置由布局决定，拖拽只改变同 direction 兄弟的排列顺序。
+     */
+    private mindMapNodeDragCandidate;
+    /** 是否已进入「拖动节点」状态（超过阈值后才算，避免单击误触发） */
+    private isNodeDragging;
+    /**
+     * 重排序时的目标插入索引（相对于同 direction siblings）；null 表示未确定。
+     * siblingIds 已按 cross 坐标排好序，方便 Renderer 直接画插入指示线。
+     */
+    private mindMapReorderTarget;
+    /**
+     * 拖拽「换层级」计划。两种落点：
+     * - `sibling`：拖到目标节点的**外侧**（框外 48px 内）→ 成为该节点的同方向兄弟（targetParent = 目标节点的父节点）；
+     * - `child`：拖到目标节点的**框内** → 成为该节点的子节点（targetParent = 目标节点自身）。
+     * 与 mindMapReorderTarget 的区别：那个是「同父级内重排序」，这个是「换父级（换层级）」。
+     */
+    private mindMapReparentPlan;
     private tableSelection;
     private tableEditing;
     private renderScheduled;
@@ -1072,7 +1248,7 @@ declare class Editor {
     /**
      * 创建"新图形 + 连线"：在 to 处放置指定类型图形；若提供了 existingArrowId，
      * 则把那条（已存在的浮动）线条末端接到新图形，否则新建一条连线。
-     * 新图形样式继承源图形（若有）。
+     * 新图形样式继承源图形（若有），**同型时尺寸也继承**（见 sourceSize）。
      */
     createGeneratedConnection(context: GenerationContext, options: {
         type: ShapeType;
@@ -1082,6 +1258,8 @@ declare class Editor {
     connectToExisting(context: GenerationContext, targetShapeId: string, binding?: ArrowBinding): void;
     subscribeUi(listener: (payload: UiEvent) => void): () => boolean;
     private emitUi;
+    /** 同步「是否正在拖拽图形」状态：仅在实际变化时发出 UiEvent，避免每帧轰炸订阅者 */
+    private setInteractionDragging;
     /** 批量更新选中图形的样式（边框色、填充色等），提交历史记录 */
     updateSelectedShapesStyle(updates: Partial<ShapeStyle>): void;
     /** 批量更新选中图形的文字颜色/高亮背景色/高亮透明度，提交历史记录 */
@@ -1223,6 +1401,19 @@ declare class Editor {
     getSelectedUml(): UmlClassShape | UmlInterfaceShape | null;
     /** 按 id 查找 UML（类图或接口） */
     private getUmlById;
+    /** 页面坐标 → 思维导图局部坐标（逆旋转 + 平移） */
+    private pageToMindMapLocal;
+    /** 计算拖拽节点时，在其同方向兄弟列表中的目标插入索引 */
+    private calcMindMapReorderTarget;
+    /**
+     * 结构变化后补偿导图中心的位移，让**根节点在屏幕上不动**。
+     *
+     * 背景：`layoutMindMap` 末尾会把包围盒中心对齐到导图中心，所以树一变宽/变高，
+     * 所有节点都会整体平移 —— 换层级/增删节点时看起来就是「整张图跳了一下」。
+     * 这里按根节点在旧/新布局中的局部坐标差反向平移导图中心，于是只有受影响的
+     * 子树重排，画面不会整体滑走（XMind 等也是这样，居中主题是视觉锚点）。
+     */
+    private anchorMindMapAtRoot;
     /** 获取选中的思维导图（恰好选中一个时） */
     getSelectedMindMap(): MindMapShape | null;
     /** 页面坐标下的思维导图节点命中：返回所在导图与节点 id */
@@ -1235,7 +1426,28 @@ declare class Editor {
         shapeId: string;
         nodeId: string;
     } | null;
-    /** 光标语义命中：仅节点框或折叠/展开标记内才命中（节点间空档不命中，避免空白处误显小手） */
+    /** 精确节点框命中：仅当页面坐标落在某个节点框内才返回该节点，导图空白/间隙返回 null
+     *  （区别于 getMindMapNodeAtPoint 的「落在包围盒内就回退根节点」，用于节点拖拽判定） */
+    getMindMapNodeBoxAtPoint(point: Vec2): {
+        shapeId: string;
+        nodeId: string;
+    } | null;
+    /**
+     * 导图局部坐标下命中「某个节点框」的节点 id（拖拽换层级用）。
+     * 排除 excludeNodeId 及其整棵子树 —— 否则会出现「把节点拖进自己的子树」这种非法落点。
+     */
+    private hitMindMapNodeBox;
+    /**
+     * 「成为子节点」落点：目标节点 targetId 的子节点组信息。
+     * - `direction`：该组子节点的生长方向（目标非根 = 布局算出的目标方向；目标是根 = 取 cross 上离指针最近的方向组）；
+     * - `childIds`：已有的同方向子节点 id（为空表示新节点会成为第一个孩子）。
+     */
+    private mindMapChildGroup;
+    /** 按 cross 坐标给同方向兄弟排序（Renderer 画落点占位框时要求同源顺序） */
+    private mindMapSortByCross;
+    /** 落点指示只在「真的变了」时更新（避免每帧 scheduleRender 抖动） */
+    private setReorderIndicator;
+    /** 光标语义命中：仅节点框（含「+」快捷按钮、折叠/展开标记）内才命中，节点间空档不命中 */
     getMindMapCursorHitAtPoint(point: Vec2): {
         shapeId: string;
         nodeId: string;
@@ -1263,21 +1475,61 @@ declare class Editor {
         shapeId: string;
         nodeId: string;
     } | null;
+    /** 页面坐标下「+」快捷新建按钮的命中检测（子节点 / 同级节点） */
+    getMindMapHandleAtPoint(point: Vec2): {
+        shapeId: string;
+        nodeId: string;
+        kind: MindMapHandleKind;
+        direction: MindMapDirection;
+    } | null;
+    /**
+     * 点「+」快捷按钮：新建子/同级节点并把新节点作为活动节点。
+     * 新需求：点击加号**不进入就地文本编辑**，只添加节点。
+     */
+    private addMindMapNodeFromHandle;
     /** 进入思维导图编辑态（双击节点触发）：选中导图并定位到节点 */
     beginMindMapEdit(shapeId: string, nodeId: string | null): void;
-    /** 退出思维导图编辑态 */
+    /**
+     * 退出思维导图就地文本编辑（输入框收起）。
+     * **活动节点保留**：导图仍被选中时，「+」快捷按钮继续挂在那个节点上，
+     * 方便连续加节点；导图取消选中时由 render 里的钩子把活动节点一并清掉。
+     */
     exitMindMapEdit(): void;
     /** 更新思维导图某节点（文本/颜色/图标/说明等），自动重算布局尺寸。
      *  commit=false 时仅应用变更、不写历史（就地文本编辑逐键调用用）；首个变更传入 commit=true 形成单个撤销点。 */
     updateMindMapNode(shapeId: string, nodeId: string, patch: Partial<MindMapNode>, commit?: boolean): void;
-    /** 给指定节点添加一个子节点 */
-    addMindMapChild(shapeId: string, nodeId: string): void;
-    /** 给指定节点添加一个兄弟节点（根节点无兄弟） */
+    /** 设置思维导图某节点的手动偏移（拖拽用）：连子树一起平移；不写历史（调用方在拖拽开始时 commitHistory 一次） */
+    setMindMapNodeOffset(shapeId: string, nodeId: string, offset: {
+        dx: number;
+        dy: number;
+    }): void;
+    /**
+     * 给指定节点添加一个子节点。
+     * - 根节点：必须传入 direction，决定新子节点生长在哪个方向；
+     * - 非根节点：direction 缺省则继承该节点自身方向。
+     */
+    addMindMapChild(shapeId: string, nodeId: string, direction?: MindMapDirection): void;
+    /** 给指定节点添加一个兄弟节点（根节点无兄弟）；兄弟继承该节点方向 */
     addMindMapSibling(shapeId: string, nodeId: string): void;
+    /** 将节点在其同方向兄弟列表中移动到目标索引 */
+    reorderMindMapNode(shapeId: string, nodeId: string, targetIndex: number): void;
+    /**
+     * 拖拽换层级：把节点移到目标父节点下、同方向兄弟组的 insertIndex 处。
+     * 「拖到某个节点框上」= 成为该节点的同方向兄弟（即 targetParent = 该节点的父节点）。
+     * 非法落点（目标是自己或自己的后代替）不修改文档。
+     */
+    moveMindMapNodeToParent(shapeId: string, nodeId: string, targetParentId: string, direction: MindMapDirection, insertIndex: number): void;
     /** 删除指定节点（含子树）；删除根节点则移除整个思维导图 */
     deleteMindMapNode(shapeId: string, nodeId: string): void;
     /** 折叠/展开指定节点 */
     toggleMindMapCollapse(shapeId: string, nodeId: string): void;
+    /** 节点能否「升级」levels 层：depth 必须 ≥ levels + 1（至少得有个新父节点）。根节点不可升级。 */
+    canPromoteMindMapNode(shapeId: string, nodeId: string, levels: number): boolean;
+    /**
+     * 把节点升级 levels 层（升 1 层 = 成为父节点的兄弟；升 2 层 = 成为祖父节点的兄弟）。
+     * 节点自身子树整体上移，不被拆散。不可升级时（已到顶层）直接返回，不改动文档。
+     */
+    promoteMindMapNode(shapeId: string, nodeId: string, levels: number): void;
     /** 获取选中的表格（恰好选中一个时） */
     getSelectedTable(): TableShape | null;
     private getTableById;
@@ -1664,6 +1916,14 @@ declare class Renderer {
     } | null, mindMapHover?: {
         shapeId: string;
         nodeId: string;
+    } | null, mindMapReorderTarget?: {
+        shapeId: string;
+        nodeId: string;
+        targetIndex: number;
+        direction: MindMapDirection;
+        siblingIds: string[];
+        /** 「成为子节点」模式：目标节点 id（高亮它 + 子组为空时定位占位框） */
+        childParentId?: string;
     } | null, 
     /** 导出用：非 null 时先以该颜色铺满整块画布（白底等），默认不铺（透明） */
     background?: string | null, 
@@ -1747,6 +2007,17 @@ declare class Renderer {
     private drawMindMap;
     private drawMindMapConnections;
     private drawMindMapNodes;
+    /**
+     * 节点拖拽重排序时的「落点占位」预览。
+     * 不再只画一条小线，而是在松手后会插入的位置画一个与节点等大的虚线圆角框：
+     * 内边与同方向兄弟对齐、按 CROSS_GAP 让出缝隙，一眼能看出节点会落到哪里。
+     */
+    private drawMindMapReorderIndicator;
+    /**
+     * 节点上的「+」快捷按钮：实心主色圆 + 白色加号，外圈再套一圈白环，
+     * 让它压在连线上也能被看清楚。位置来自 mindMapNodeHandles（与命中检测同源）。
+     */
+    private drawMindMapHandles;
     /** 按像素宽度截断文本并加省略号 */
     private ellipsizeText;
     /**
@@ -2246,6 +2517,11 @@ declare abstract class Tool {
      * @returns 是否确实清理了状态（false = 本来就是空闲态，调用方可跳过重绘）
      */
     cancelTransient(): boolean;
+    /**
+     * 是否正处于「拖拽/调整图形」中（移动/缩放/旋转图形、拖连线端点或线段、从锚点拉新连线）。
+     * 默认 false；选择工具等会覆盖，供编辑器据此临时隐藏顶栏工具条。
+     */
+    isDragging(): boolean;
     dispose(): void;
 }
 
@@ -2340,6 +2616,11 @@ declare class SelectTool extends Tool {
      */
     private finishSegmentDrag;
     hasTransientState(): boolean;
+    /**
+     * 拖拽/调整图形中：移动、缩放、旋转、拖连线端点、拖线段、从锚点拉新连线。
+     * （框选空白、表格内框选单元格不算「拖图形」，不触发顶栏隐藏。）
+     */
+    isDragging(): boolean;
     /**
      * 取消一切瞬态交互（拖拽/生成/框选/旋转/连线端点拖拽）并清掉画布上的瞬态预览。
      * 触发场景：指针在窗口外松手丢失 pointerup、窗口失焦、点击画布外、无按压的移动、
@@ -2378,6 +2659,12 @@ declare class SelectTool extends Tool {
     /** 生成点位命中阈值 / 单击 vs 拖动判定阈值 */
     private static readonly GEN_HIT_THRESHOLD;
     private static readonly CLICK_MOVE_THRESHOLD;
+    /**
+     * 「点击锚点生成图形」时源图形与新图形之间的默认间距（页面单位，**边到边**）。
+     * 旧实现是「中心沿法线外移 96」：对默认矩形(120×60)实际边距只有 36，看着太挤；
+     * 现在直接按边距算，取 36 + 40 = 76（用户要求 +40px），且不再随图形大小变化。
+     */
+    private static readonly GEN_GAP;
     /** 支持四边连接锚点的图形类型（矩形类、流程图形、UML 等） */
     private static readonly GEN_SUPPORTED_TYPES;
     /**
@@ -2389,8 +2676,18 @@ declare class SelectTool extends Tool {
     private hitGenPoint;
     /** 悬停（未按下）时指针所在的、支持连线锚点的图形 id（已选中的交给选择手柄，返回 null） */
     private findHoverAnchorShape;
-    /** 生成点位预览的落点：拖动时跟随光标；静止/悬浮时向外延伸一个默认位置的框 */
+    /**
+     * 生成点位预览的落点：拖动时跟随光标；静止/悬浮时沿出线方向外移
+     * 「默认间距 GEN_GAP + 新图形在该方向上的半个尺寸」，即**两个图形边到边**留出 GEN_GAP。
+     */
     private genPreviewTarget;
+    /**
+     * 「将要新建的图形」本体（预览虚框 / 避让 / 接入点计算共用）：
+     * 尺寸与最终 createGeneratedConnection 创建出来的完全一致（同型时沿用源图形尺寸）。
+     */
+    private genGhostShape;
+    /** 「将要新建的图形」的尺寸（页面单位） */
+    private genGhostSize;
     /** 生成拖动：更新预览（真实样式的连线 + 待放置图形虚框）与目标高亮 */
     private handleGenerating;
     private handleRotating;
@@ -2595,44 +2892,6 @@ declare class ArrowTool extends Tool {
     private getCircleBindingPosition;
 }
 
-/** 不同层级节点的默认颜色，超过 6 层后循环复用 */
-declare const MINDMAP_COLORS: string[];
-declare const MINDMAP_FONT_SIZE = 14;
-declare const MINDMAP_NODE_HEIGHT = 40;
-declare const MINDMAP_MIN_WIDTH = 80;
-declare const MINDMAP_MAX_WIDTH = 240;
-interface MindMapNodePos {
-    x: number;
-    y: number;
-    depth: number;
-    width: number;
-    height: number;
-}
-interface MindMapLayoutResult {
-    positions: Map<string, MindMapNodePos>;
-    width: number;
-    height: number;
-}
-/** 节点颜色：手动设置优先，否则按层级取默认色 */
-declare function mindMapNodeColor(node: MindMapNode, depth: number): string;
-/** 节点框尺寸：由文本长度决定（CJK 按全宽估算），图标占位额外加宽 */
-declare function mindMapNodeSize(node: MindMapNode): {
-    width: number;
-    height: number;
-};
-/** 深拷贝节点树（撤销/重做快照用） */
-declare function cloneMindMapNode(node: MindMapNode): MindMapNode;
-declare function findMindMapNode(root: MindMapNode, nodeId: string): MindMapNode | null;
-declare function getMindMapNodeDepth(root: MindMapNode, nodeId: string): number;
-declare function getMindMapParent(root: MindMapNode, nodeId: string): MindMapNode | null;
-declare function countMindMapNodes(root: MindMapNode): number;
-/**
- * 横向树布局：根在左，子节点向右展开，每个节点垂直居中于其子树。
- * 返回以内容包围盒中心为原点的局部坐标（shape.x/y 即该中心），
- * 便于复用现有选中框/旋转/命中检测逻辑。
- */
-declare function layoutMindMap(root: MindMapNode): MindMapLayoutResult;
-
 /**
  * 表格的纯数据操作（唯一实现）：行列增删、合并/拆分、命中定位。
  *
@@ -2839,4 +3098,4 @@ declare function imageDataUrl(src: string): string | null;
 /** 清空缓存（测试/卸载时用；会释放自己创建的 blob 地址） */
 declare function clearImageCache(): void;
 
-export { type ArrowBinding, type ArrowHeadType, type ArrowShape, type ArrowStyle, ArrowTool, BoardExtentKeeper, type BoardExtentResult, type BoardExtentUpdate, Camera, type CameraState, type CircleShape, type ConnectionType, DEFAULT_HIGHLIGHTER_COLOR, DEFAULT_IMAGE_MAX_SIZE_BYTES, 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, type ImageShape, type ImageUploadConfig, type ImageUploadOption, type ImageUploader, 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, addImageReadyListener, calcUmlClassSize, clearImageCache, cloneMindMapNode, cloneTable, cloneTableCells, collapseRoute, collectTemporaryImageSrcs, connectorSegmentHandles, countMindMapNodes, createTableCells, downloadBlob, ensureImagesLoaded, exportToBlob, findMindMapNode, getContentBounds, getIcon, getLanguage, getMindMapNodeDepth, getMindMapParent, getTheme, hasIcon, hexToRgba, hitTableBody, hitTableMoveHandle, iconInk, iconsByCategory, imageDataUrl, isEmptyRect, isFlippableShapeType, isImageFailed, isImageLoading, isStubCorner, isUploaderFunction, layoutMindMap, loadImage, mindMapNodeColor, mindMapNodeSize, offsetConnectorSegment, parseUploadResponse, peekImage, pickSegmentHandle, pointToSegmentDistance, pruneStubBends, rectsIntersect, renderSVGString, renderToCanvas, routeToUserPoints, sameRoute, searchIcons, setImageCrossOrigin, setLanguage, setTheme, shadeColor, subscribeLanguage, subscribeTheme, subtractUnion, 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, unionRect, uploadImageViaConfig };
+export { type ArrowBinding, type ArrowHeadType, type ArrowShape, type ArrowStyle, ArrowTool, BoardExtentKeeper, type BoardExtentResult, type BoardExtentUpdate, Camera, type CameraState, type CircleShape, type ConnectionType, DEFAULT_HIGHLIGHTER_COLOR, DEFAULT_IMAGE_MAX_SIZE_BYTES, DEFAULT_PAGE_THEME, 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, type ImageShape, type ImageUploadConfig, type ImageUploadOption, type ImageUploader, LANGUAGES, type Language, type LineShape, LineTool, MINDMAP_COLORS, MINDMAP_DIRECTIONS, MINDMAP_FONT_SIZE, MINDMAP_HANDLE_HIT_RADIUS, MINDMAP_HANDLE_RADIUS, MINDMAP_MAX_WIDTH, MINDMAP_MIN_WIDTH, MINDMAP_NODE_HEIGHT, MIN_HANDLE_SEGMENT, MIN_JOG, Mat2d, type MessageKey, type MindMapDirection, type MindMapHandleKind, type MindMapHandlePos, type MindMapLayoutResult, type MindMapNode, type MindMapNodePos, type MindMapShape, type OctagonShape, PAGE_THEMES, type PageTheme, type PageThemePreset, 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, addImageReadyListener, calcUmlClassSize, clearImageCache, cloneMindMapNode, cloneTable, cloneTableCells, collapseRoute, collectTemporaryImageSrcs, connectorSegmentHandles, countMindMapNodes, createTableCells, downloadBlob, effectiveDirection, ensureImagesLoaded, exportToBlob, findMindMapNode, getContentBounds, getIcon, getLanguage, getMindMapNodeDepth, getMindMapNodeSiblings, getMindMapParent, getTheme, hasIcon, hexToRgba, hitTableBody, hitTableMoveHandle, iconInk, iconsByCategory, imageDataUrl, isEmptyRect, isFlippableShapeType, isHorizontalDirection, isImageFailed, isImageLoading, isStubCorner, isUploaderFunction, layoutMindMap, loadImage, mindMapHandleAtLocalPoint, mindMapNodeColor, mindMapNodeHandles, mindMapNodeSize, moveMindMapNodeInTree, offsetConnectorSegment, parseUploadResponse, peekImage, pickSegmentHandle, pointToSegmentDistance, promoteMindMapNodeInTree, pruneStubBends, rectsIntersect, renderSVGString, renderToCanvas, reorderMindMapNodeInTree, routeToUserPoints, sameRoute, searchIcons, setImageCrossOrigin, setLanguage, setTheme, shadeColor, subscribeLanguage, subscribeTheme, subtractUnion, 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, unionRect, uploadImageViaConfig };