drawui-core 0.5.1 → 0.5.2

package/dist/index.d.cts

@@ -567,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;
 
 /**
  * 国际化：框架无关的轻量字典 + 语言切换。
@@ -758,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': "表格";
@@ -794,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': "图片插入失败";
@@ -947,6 +970,29 @@ declare function getMindMapNodeSiblings(root: MindMapNode, nodeId: string): {
  * 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;
@@ -963,6 +1009,11 @@ type UiEvent = {
  | {
     kind: 'imageError';
     message: string;
+}
+/** 正在拖拽/调整图形（移动/缩放/旋转/拖连线端点或线段/从锚点拉新连线）：React 侧据此临时隐藏顶栏工具条 */
+ | {
+    kind: 'drag';
+    active: boolean;
 };
 /** Editor 构造选项：主题色 / 语言 / 初始数据 / 本地持久化开关 */
 interface EditorOptions {
@@ -997,6 +1048,8 @@ declare class Editor {
     private isPanning;
     private panStart;
     private dragStartPositions;
+    /** 是否正处于「拖拽/调整图形」交互中：通过 UiEvent 'drag' 通知 React 临时隐藏顶栏工具条 */
+    private interactionDragging;
     private lastClickTime;
     private lastClickShapeId;
     private editingShapeId;
@@ -1031,6 +1084,13 @@ declare class Editor {
      * siblingIds 已按 cross 坐标排好序，方便 Renderer 直接画插入指示线。
      */
     private mindMapReorderTarget;
+    /**
+     * 拖拽「换层级」计划。两种落点：
+     * - `sibling`：拖到目标节点的**外侧**（框外 48px 内）→ 成为该节点的同方向兄弟（targetParent = 目标节点的父节点）；
+     * - `child`：拖到目标节点的**框内** → 成为该节点的子节点（targetParent = 目标节点自身）。
+     * 与 mindMapReorderTarget 的区别：那个是「同父级内重排序」，这个是「换父级（换层级）」。
+     */
+    private mindMapReparentPlan;
     private tableSelection;
     private tableEditing;
     private renderScheduled;
@@ -1198,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;
     /** 批量更新选中图形的文字颜色/高亮背景色/高亮透明度，提交历史记录 */
@@ -1343,6 +1405,15 @@ declare class Editor {
     private pageToMindMapLocal;
     /** 计算拖拽节点时，在其同方向兄弟列表中的目标插入索引 */
     private calcMindMapReorderTarget;
+    /**
+     * 结构变化后补偿导图中心的位移，让**根节点在屏幕上不动**。
+     *
+     * 背景：`layoutMindMap` 末尾会把包围盒中心对齐到导图中心，所以树一变宽/变高，
+     * 所有节点都会整体平移 —— 换层级/增删节点时看起来就是「整张图跳了一下」。
+     * 这里按根节点在旧/新布局中的局部坐标差反向平移导图中心，于是只有受影响的
+     * 子树重排，画面不会整体滑走（XMind 等也是这样，居中主题是视觉锚点）。
+     */
+    private anchorMindMapAtRoot;
     /** 获取选中的思维导图（恰好选中一个时） */
     getSelectedMindMap(): MindMapShape | null;
     /** 页面坐标下的思维导图节点命中：返回所在导图与节点 id */
@@ -1361,6 +1432,21 @@ declare class Editor {
         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;
@@ -1427,10 +1513,23 @@ declare class Editor {
     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;
@@ -1823,6 +1922,8 @@ declare class Renderer {
         targetIndex: number;
         direction: MindMapDirection;
         siblingIds: string[];
+        /** 「成为子节点」模式：目标节点 id（高亮它 + 子组为空时定位占位框） */
+        childParentId?: string;
     } | null, 
     /** 导出用：非 null 时先以该颜色铺满整块画布（白底等），默认不铺（透明） */
     background?: string | null, 
@@ -2416,6 +2517,11 @@ declare abstract class Tool {
      * @returns 是否确实清理了状态（false = 本来就是空闲态，调用方可跳过重绘）
      */
     cancelTransient(): boolean;
+    /**
+     * 是否正处于「拖拽/调整图形」中（移动/缩放/旋转图形、拖连线端点或线段、从锚点拉新连线）。
+     * 默认 false；选择工具等会覆盖，供编辑器据此临时隐藏顶栏工具条。
+     */
+    isDragging(): boolean;
     dispose(): void;
 }
 
@@ -2510,6 +2616,11 @@ declare class SelectTool extends Tool {
      */
     private finishSegmentDrag;
     hasTransientState(): boolean;
+    /**
+     * 拖拽/调整图形中：移动、缩放、旋转、拖连线端点、拖线段、从锚点拉新连线。
+     * （框选空白、表格内框选单元格不算「拖图形」，不触发顶栏隐藏。）
+     */
+    isDragging(): boolean;
     /**
      * 取消一切瞬态交互（拖拽/生成/框选/旋转/连线端点拖拽）并清掉画布上的瞬态预览。
      * 触发场景：指针在窗口外松手丢失 pointerup、窗口失焦、点击画布外、无按压的移动、
@@ -2987,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_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, 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, offsetConnectorSegment, parseUploadResponse, peekImage, pickSegmentHandle, pointToSegmentDistance, 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 };
+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 };

package/dist/index.d.ts

@@ -567,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;
 
 /**
  * 国际化：框架无关的轻量字典 + 语言切换。
@@ -758,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': "表格";
@@ -794,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': "图片插入失败";
@@ -947,6 +970,29 @@ declare function getMindMapNodeSiblings(root: MindMapNode, nodeId: string): {
  * 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;
@@ -963,6 +1009,11 @@ type UiEvent = {
  | {
     kind: 'imageError';
     message: string;
+}
+/** 正在拖拽/调整图形（移动/缩放/旋转/拖连线端点或线段/从锚点拉新连线）：React 侧据此临时隐藏顶栏工具条 */
+ | {
+    kind: 'drag';
+    active: boolean;
 };
 /** Editor 构造选项：主题色 / 语言 / 初始数据 / 本地持久化开关 */
 interface EditorOptions {
@@ -997,6 +1048,8 @@ declare class Editor {
     private isPanning;
     private panStart;
     private dragStartPositions;
+    /** 是否正处于「拖拽/调整图形」交互中：通过 UiEvent 'drag' 通知 React 临时隐藏顶栏工具条 */
+    private interactionDragging;
     private lastClickTime;
     private lastClickShapeId;
     private editingShapeId;
@@ -1031,6 +1084,13 @@ declare class Editor {
      * siblingIds 已按 cross 坐标排好序，方便 Renderer 直接画插入指示线。
      */
     private mindMapReorderTarget;
+    /**
+     * 拖拽「换层级」计划。两种落点：
+     * - `sibling`：拖到目标节点的**外侧**（框外 48px 内）→ 成为该节点的同方向兄弟（targetParent = 目标节点的父节点）；
+     * - `child`：拖到目标节点的**框内** → 成为该节点的子节点（targetParent = 目标节点自身）。
+     * 与 mindMapReorderTarget 的区别：那个是「同父级内重排序」，这个是「换父级（换层级）」。
+     */
+    private mindMapReparentPlan;
     private tableSelection;
     private tableEditing;
     private renderScheduled;
@@ -1198,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;
     /** 批量更新选中图形的文字颜色/高亮背景色/高亮透明度，提交历史记录 */
@@ -1343,6 +1405,15 @@ declare class Editor {
     private pageToMindMapLocal;
     /** 计算拖拽节点时，在其同方向兄弟列表中的目标插入索引 */
     private calcMindMapReorderTarget;
+    /**
+     * 结构变化后补偿导图中心的位移，让**根节点在屏幕上不动**。
+     *
+     * 背景：`layoutMindMap` 末尾会把包围盒中心对齐到导图中心，所以树一变宽/变高，
+     * 所有节点都会整体平移 —— 换层级/增删节点时看起来就是「整张图跳了一下」。
+     * 这里按根节点在旧/新布局中的局部坐标差反向平移导图中心，于是只有受影响的
+     * 子树重排，画面不会整体滑走（XMind 等也是这样，居中主题是视觉锚点）。
+     */
+    private anchorMindMapAtRoot;
     /** 获取选中的思维导图（恰好选中一个时） */
     getSelectedMindMap(): MindMapShape | null;
     /** 页面坐标下的思维导图节点命中：返回所在导图与节点 id */
@@ -1361,6 +1432,21 @@ declare class Editor {
         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;
@@ -1427,10 +1513,23 @@ declare class Editor {
     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;
@@ -1823,6 +1922,8 @@ declare class Renderer {
         targetIndex: number;
         direction: MindMapDirection;
         siblingIds: string[];
+        /** 「成为子节点」模式：目标节点 id（高亮它 + 子组为空时定位占位框） */
+        childParentId?: string;
     } | null, 
     /** 导出用：非 null 时先以该颜色铺满整块画布（白底等），默认不铺（透明） */
     background?: string | null, 
@@ -2416,6 +2517,11 @@ declare abstract class Tool {
      * @returns 是否确实清理了状态（false = 本来就是空闲态，调用方可跳过重绘）
      */
     cancelTransient(): boolean;
+    /**
+     * 是否正处于「拖拽/调整图形」中（移动/缩放/旋转图形、拖连线端点或线段、从锚点拉新连线）。
+     * 默认 false；选择工具等会覆盖，供编辑器据此临时隐藏顶栏工具条。
+     */
+    isDragging(): boolean;
     dispose(): void;
 }
 
@@ -2510,6 +2616,11 @@ declare class SelectTool extends Tool {
      */
     private finishSegmentDrag;
     hasTransientState(): boolean;
+    /**
+     * 拖拽/调整图形中：移动、缩放、旋转、拖连线端点、拖线段、从锚点拉新连线。
+     * （框选空白、表格内框选单元格不算「拖图形」，不触发顶栏隐藏。）
+     */
+    isDragging(): boolean;
     /**
      * 取消一切瞬态交互（拖拽/生成/框选/旋转/连线端点拖拽）并清掉画布上的瞬态预览。
      * 触发场景：指针在窗口外松手丢失 pointerup、窗口失焦、点击画布外、无按压的移动、
@@ -2987,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_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, 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, offsetConnectorSegment, parseUploadResponse, peekImage, pickSegmentHandle, pointToSegmentDistance, 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 };
+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 };