flow-mindmap 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of tracking or otherwise improving the Work,
+      but excludes communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses granted
+      to You under this License for that Work shall terminate as of the date
+      such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Support. While redistributing the Work or
+      Derivative Works thereof, You may choose to offer, and charge a
+      fee for, acceptance of support, warranty, indemnity, or other
+      liability obligations and/or rights consistent with this License.
+      However, in accepting such obligations, You may act only on Your
+      own behalf and on Your sole responsibility, not on behalf of any
+      other Contributor, and only if You agree to indemnify, defend,
+      and hold each Contributor harmless for any liability incurred by,
+      or claims asserted against, such Contributor by reason of your
+      accepting any such warranty or support.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed" page as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 xuze
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,288 @@
+# flow-mindmap
+
+A modern, minimalist mind mapping tool — xmind-style, embeddable as a Vue 3 component.
+
+- 纯 SVG 渲染,矢量缩放无损
+- 拖拽、缩放、平移画布
+- 键盘快捷键: `Tab` 添加子节点 / `Enter` 添加同级 / `F2` 编辑 / `Delete` 删除节点
+- 一键折叠/展开子树
+- 多种布局模式: mindmap(默认) / tree(右向树) / org(向下组织结构)
+- 可调画板: 渐变锥形连线、彩虹分支、节点背景/边框/字体样式、嵌入图片、超链接、节点笔记
+- 撤销/重做、JSON 导入导出
+- 扁平化 SVG 线框图标,无任何 Emoji
+- Apache-2.0 开源协议,可在 npm 安装作为组件使用
+
+## 安装
+
+```bash
+pnpm add flow-mindmap
+```
+
+## 快速开始
+
+### 全局注册(Vue 插件)
+
+```ts
+import { createApp } from 'vue'
+import App from './App.vue'
+import FlowMindmap from 'flow-mindmap'
+import 'flow-mindmap/style.css'
+
+const app = createApp(App)
+app.use(FlowMindmap) // 注册为 <FlowMindMap />
+app.mount('#app')
+```
+
+```vue
+<template>
+  <FlowMindMap :data="data" style="width: 100vw; height: 100vh" />
+</template>
+```
+
+### 局部导入
+
+```vue
+<script setup lang="ts">
+import { MindMap } from 'flow-mindmap'
+import 'flow-mindmap/style.css'
+import type { MindMapNode } from 'flow-mindmap'
+
+const data: MindMapNode = {
+  id: 'root',
+  text: '中心主题',
+  children: [
+    { id: 'a', text: '分支 A', children: [] },
+    { id: 'b', text: '分支 B', children: [] },
+  ],
+}
+</script>
+
+<template>
+  <MindMap :data="data" style="width: 100vw; height: 100vh" />
+</template>
+```
+
+## Props
+
+| Prop | Type | Default | 说明 |
+| ---- | ---- | ------- | ---- |
+| `data` | [`MindMapNode`](#数据类型) | — | **必填**。思维导图根节点。 |
+| `readonly` | `boolean` | `false` | 只读模式:禁用增删改、拖拽、编辑输入框。 |
+| `previewMode` | `boolean` | `false` | 预览模式:隐藏画布自带工具栏,只保留节点和折叠/调整手柄。适合做截图、嵌入展示。 |
+| `theme` | [`MindMapTheme`](#数据类型) | — | 主题色/字号/连线粗细等外观配置,见下表。 |
+
+### `MindMapTheme` 字段
+
+| 字段 | 类型 | 默认 | 说明 |
+| ---- | ---- | ---- | ---- |
+| `rootBg` | `string` | — | 根节点背景色 |
+| `rootText` | `string` | — | 根节点文字色 |
+| `branchBg` | `string` | — | 普通节点背景色 |
+| `branchText` | `string` | — | 普通节点文字色 |
+| `lineColor` | `string` | — | 连线颜色 |
+| `bgColor` | `string` | — | 画布背景色 |
+| `fontSize` | `number` | — | 基础字号(px) |
+| `lineWidthStart` | `number` | `2.2` | 父端连线粗细(px) |
+| `lineWidthEnd` | `number` | `0.8` | 子端连线粗细(px) |
+| `rainbowBranch` | `boolean` | `false` | 顶层分支按色板循环配色 |
+
+## Emits
+
+| 事件 | 载荷 | 说明 |
+| ---- | ---- | ---- |
+| `change` | `MindMapNode` | 数据变更(增删改、导入、拖动)后触发,载荷是**新的整棵根节点**。 |
+| `select` | `MindMapNode \| null` | 用户点击节点时触发;`null` 表示点空白处取消选中。 |
+| `edit-note` | `nodeId: string` | 用户点击节点笔记图标 / 右键"添加/编辑笔记"时触发,由父组件决定如何展示笔记编辑界面。 |
+
+## Expose 方法(通过 `ref` 访问)
+
+```vue
+<MindMap ref="mm" :data="data" />
+<script setup>
+const mm = ref()
+mm.value.addChild('a') // 给 id=a 的节点加一个子节点
+</script>
+```
+
+### 节点增删改
+
+| 方法 | 说明 |
+| ---- | ---- |
+| `addChild(parentId)` | 给指定节点添加子节点 |
+| `addSibling(nodeId)` | 给指定节点添加同级 |
+| `removeNode(nodeId)` | 删除节点及其子树 |
+| `duplicateNode(nodeId)` | 复制一个节点(包含子树)并插入到同级 |
+| `setNodeText(nodeId, text)` | 修改节点文字 |
+| `moveNode(srcId, targetId, position)` | 移动节点;`position` = `'before'` / `'after'`(同级)或 `'child'`(成为 target 最后一个子节点)。返回 `true` 表示成功。 |
+
+### 节点内容扩展
+
+| 方法 | 说明 |
+| ---- | ---- |
+| `applyNodeStyle(nodeId, style)` | 覆盖指定节点的样式(`{ bg, textColor, borderColor, fontWeight }`)。传空对象 `{}` 清除。 |
+| `getNodeStyle(nodeId)` | 读取指定节点的样式覆盖,无则返回 `{}`。 |
+| `applyNodeLink(nodeId, url)` | 设置节点的超链接,空字符串清除。 |
+| `removeNodeLink(nodeId)` | 删除节点的链接。 |
+| `applyNodeNote(nodeId, text)` | 设置节点的笔记,空字符串清除。 |
+| `removeNodeNote(nodeId)` | 删除节点的笔记。 |
+
+### 视图
+
+| 方法 | 说明 |
+| ---- | ---- |
+| `getData()` | 返回当前根节点(`MindMapNode`)。 |
+| `setData(d)` | 用新的根节点替换数据。 |
+| `resetView()` | 重置缩放/平移,让整棵树重新居中。 |
+| `setBalanced(v)` / `isBalanced()` / `balance()` | 强制布局平衡模式(暂停/恢复/立即执行)。`autoBalanceOnChange` 设置项决定默认是否平衡。 |
+
+### 撤销/重做
+
+| 方法 | 说明 |
+| ---- | ---- |
+| `undo()` / `redo()` | 撤销 / 重做最近一次数据变更。 |
+| `canUndo()` / `canRedo()` | 是否可撤销 / 重做。 |
+
+### 导入/导出
+
+| 方法 | 说明 |
+| ---- | ---- |
+| `exportData()` | 返回当前数据的 JSON 字符串。 |
+| `importData(json)` | 从 JSON 字符串恢复数据,成功返回 `true`。 |
+
+### 设置项
+
+通过 [`MindMapSettings`](#数据类型) 控制画板、布局、连线、分支色板等行为。
+
+| 方法 | 说明 |
+| ---- | ---- |
+| `applySettings(s)` | 部分更新设置,只覆盖传入的字段。 |
+| `getSettings()` | 读取当前生效的设置。 |
+
+### 调色板
+
+| 方法 | 说明 |
+| ---- | ---- |
+| `setBranchPalette(id)` | 切换到指定色板;`id` 可以是内置(`'default'` / `'classic'` / `'vivid'` / `'dev'` / `'mint'`)或在 `settings.customPalettes` 注册过的自定义 id。未知 id 静默 no-op。 |
+| `getBranchPalette()` | 读取当前色板 id。 |
+| `getBranchPalettes()` | 读取所有色板(内置 + 自定义),用于渲染选择器。 |
+
+### 连线宽度(高级)
+
+| 方法 | 说明 |
+| ---- | ---- |
+| `lineWidthForDepth(depth)` | 深度 `depth` 节点出发的连线**父端**宽度(px)。 |
+| `endWidthForDepth(depth)` | 深度 `depth` 节点出发的连线**子端**宽度(px)。 |
+
+## 数据类型
+
+```ts
+import type {
+  MindMapNode,
+  MindMapImage,
+  MindMapOptions,
+  MindMapTheme,
+  MindMapSettings,
+  MindMapExpose,
+  NodeStyle,
+  LineStyle,
+  LayoutMode,
+  BranchPalette,
+  BranchPaletteId,
+} from 'flow-mindmap'
+```
+
+### `MindMapNode`
+
+```ts
+interface MindMapNode {
+  id: string
+  text: string
+  children: MindMapNode[]
+  collapsed?: boolean   // 初始折叠状态
+  image?: MindMapImage  // 节点上方嵌入的图片
+  link?: { url: string }// 节点超链接(图标点击跳转)
+  note?: { text: string }// 节点笔记(图标悬浮预览、点击展开编辑)
+  _x?: number           // 内部:拖拽后的位置覆盖(库内部使用,勿读勿写)
+  _y?: number
+}
+```
+
+### `MindMapImage`
+
+```ts
+interface MindMapImage {
+  src: string           // 远程 URL 或 data URL
+  naturalW: number      // 源图原始宽(用于锁定长宽比)
+  naturalH: number      // 源图原始高
+  width: number         // 当前渲染宽(用户可拖拽调整,24~400 px)
+  height: number        // 当前渲染高
+}
+```
+
+### `NodeStyle`
+
+```ts
+interface NodeStyle {
+  bg?: string                       // 背景色
+  textColor?: string                // 文字色
+  borderColor?: string              // 边框色
+  fontWeight?: 400 | 600            // 字重
+}
+```
+
+### `MindMapSettings`
+
+```ts
+interface MindMapSettings {
+  autoBalanceOnChange: boolean   // 增删/拖拽后自动回到平衡布局
+  lineWidthStart: number         // 父端连线粗细
+  lineWidthEnd: number           // 子端连线粗细
+  rainbowBranch: boolean         // 顶层分支按色板循环配色
+  branchPaletteId: string        // 当前色板 id
+  customPalettes: BranchPalette[]// 用户自定义色板
+  lineStyle: 'curve' | 'straight'// 连线形状:曲线(xmind 默认) / 直线
+  layoutMode: 'mindmap' | 'tree' | 'org'  // 布局模式
+  taperedEdge: boolean           // 锥形连线(每条独立锥化)
+  showOrderBadge: boolean        // 节点上显示兄弟序号角标(调试用)
+}
+```
+
+### `BranchPalette`
+
+```ts
+interface BranchPalette {
+  id: string      // 唯一 id
+  name: string    // 在选择器里显示的名字
+  colors: string[]// 十六进制色值,按顺序循环
+}
+```
+
+## 工具函数
+
+```ts
+import {
+  uid,         // 生成不重复 id
+  clone,       // 深克隆节点
+  findNode,    // (root, id) => 节点
+  findParent,  // (root, id) => 父节点
+  removeNode,  // (root, id) => 移除子树
+  addChild,    // (parent, text) => 新子节点
+  addSibling,  // (node, text) => 新同级节点
+} from 'flow-mindmap'
+```
+
+## 全局组件
+
+`app.use(FlowMindmap)` 会把组件注册为 `<FlowMindMap />`(驼峰式),所有 prop / event 与 `<MindMap>` 一致。
+
+## 本地开发
+
+```bash
+pnpm install
+pnpm dev      # http://localhost:7851  — 应用 demo
+pnpm build    # 打包为 npm 库
+```
+
+## 协议
+
+[Apache-2.0](./LICENSE) © xuze

package/dist/components/DataPanel.vue.d.ts

@@ -0,0 +1,10 @@
+import type { MindMapNode } from '../types';
+type __VLS_Props = {
+    data: MindMapNode;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    import: (data: MindMapNode) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onImport?: ((data: MindMapNode) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/Drawer.vue.d.ts

@@ -0,0 +1,33 @@
+type __VLS_Props = {
+    /** 'left' slides in from the left edge, 'right' from the right. */
+    side?: 'left' | 'right';
+    /** Pixels wide. */
+    width?: number;
+    /** Show or hide the panel. Animation handles the transition. */
+    open?: boolean;
+    /** Optional title shown in the header. */
+    title?: string;
+};
+declare var __VLS_5: {}, __VLS_7: {};
+type __VLS_Slots = {} & {
+    header?: (props: typeof __VLS_5) => any;
+} & {
+    default?: (props: typeof __VLS_7) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:open": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {
+    title: string;
+    width: number;
+    side: "left" | "right";
+    open: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/Icon.vue.d.ts

@@ -0,0 +1,7 @@
+type __VLS_Props = {
+    name: string;
+    size?: number | string;
+    stroke?: number | string;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/MarkdownPanel.vue.d.ts

@@ -0,0 +1,12 @@
+import type { MindMapNode } from '../types';
+type __VLS_Props = {
+    /** Current data tree.  Used to populate the editor on first mount
+     *  (as markdown) and as the source of the "export .md" action. */
+    data: MindMapNode;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    import: (data: MindMapNode) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onImport?: ((data: MindMapNode) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/MindMap.vue.d.ts

@@ -0,0 +1,60 @@
+import type { MindMapNode, MindMapTheme, MindMapSettings, NodeStyle } from '../types';
+type __VLS_Props = {
+    data: MindMapNode;
+    readonly?: boolean;
+    theme?: MindMapTheme;
+    /**
+     * When true, hides the MindMap's own toolbar and any UI that
+     * isn't strictly the canvas (resize handles, collapse
+     * buttons still appear on hover so the user can still
+     * interact).  The app-level top toolbar / drawers are
+     * controlled by the parent (App.vue) — this only toggles
+     * the canvas's own chrome.
+     */
+    previewMode?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    addChild: (parentId: string) => void;
+    addSibling: (nodeId: string) => void;
+    removeNode: (nodeId: string) => void;
+    duplicateNode: (nodeId: string) => void;
+    setNodeText: (nodeId: string, text: string) => void;
+    moveNode: (srcId: string, targetId: string, position: "before" | "after" | "child") => boolean;
+    getData: () => MindMapNode;
+    setData: (data: MindMapNode) => void;
+    resetView: () => void;
+    exportData: () => string;
+    importData: (json: string) => boolean;
+    setBalanced: (value: boolean) => void;
+    isBalanced: () => boolean;
+    balance: () => void;
+    applyNodeStyle: (nodeId: string, style: NodeStyle) => void;
+    getNodeStyle: (nodeId: string) => NodeStyle;
+    applyNodeLink: (nodeId: string, url: string) => void;
+    removeNodeLink: (nodeId: string) => void;
+    applyNodeNote: (nodeId: string, text: string) => void;
+    removeNodeNote: (nodeId: string) => void;
+    undo: () => void;
+    redo: () => void;
+    canUndo: () => boolean;
+    canRedo: () => boolean;
+    applySettings: (s: Partial<MindMapSettings>) => void;
+    getSettings: () => MindMapSettings;
+    setBranchPalette: (id: import("../types").BranchPaletteId) => void;
+    getBranchPalette: () => import("../types").BranchPaletteId;
+    getBranchPalettes: () => import("../types").BranchPalette[];
+    lineWidthForDepth: (depth: number) => number;
+    endWidthForDepth: (depth: number) => number;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    select: (node: MindMapNode | null) => any;
+    change: (data: MindMapNode) => any;
+    "edit-note": (nodeId: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((node: MindMapNode | null) => any) | undefined;
+    onChange?: ((data: MindMapNode) => any) | undefined;
+    "onEdit-note"?: ((nodeId: string) => any) | undefined;
+}>, {
+    readonly: boolean;
+    previewMode: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/NodeContextMenu.vue.d.ts

@@ -0,0 +1,46 @@
+type __VLS_Props = {
+    /** Cursor X in viewport coords (clientX). */
+    x: number;
+    /** Cursor Y in viewport coords (clientY). */
+    y: number;
+    /** Container the menu should not escape — used to clamp the
+     *  position so the menu stays on-screen. */
+    container: HTMLElement | null;
+    /** Whether the node already has an image.  When true, the
+     *  "添加图片" action is renamed "替换图片" and a "移除图片"
+     *  action is appended. */
+    hasImage?: boolean;
+    /** Whether the node already has a link.  Drives the label /
+     *  presence of the "添加链接" / "编辑链接" / "移除链接"
+     *  actions. */
+    hasLink?: boolean;
+    /** Whether the node already has a note.  Same role as
+     *  hasLink for the note action. */
+    hasNote?: boolean;
+    /** True if the component is in readonly mode — all actions
+     *  render but are disabled. */
+    readonly?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    close: () => any;
+    pickImage: () => any;
+    setLink: () => any;
+    removeLink: () => any;
+    editNote: () => any;
+    removeNote: () => any;
+    removeImage: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: (() => any) | undefined;
+    onPickImage?: (() => any) | undefined;
+    onSetLink?: (() => any) | undefined;
+    onRemoveLink?: (() => any) | undefined;
+    onEditNote?: (() => any) | undefined;
+    onRemoveNote?: (() => any) | undefined;
+    onRemoveImage?: (() => any) | undefined;
+}>, {
+    hasImage: boolean;
+    hasLink: boolean;
+    hasNote: boolean;
+    readonly: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;