@xiangfa/mindmap 0.3.0

package/dist/plugins/multi-line.d.ts

@@ -0,0 +1,2 @@
+import type { MindMapPlugin } from './types';
+export declare const multiLinePlugin: MindMapPlugin;

package/dist/plugins/runner.d.ts

@@ -0,0 +1,30 @@
+import type { MindMapPlugin, ParseContext, ParsedLineResult, LayoutContext } from './types';
+import type { MindMapData, LayoutNode, Edge } from '../types';
+import type { TokenLayout } from '../utils/inline-markdown';
+import type { ThemeColors } from '../utils/theme';
+export declare function runPreParseMarkdown(plugins: MindMapPlugin[], md: string, ctx: ParseContext): string;
+export declare function runParseLine(plugins: MindMapPlugin[], line: string, index: number, ctx: ParseContext): ParsedLineResult | null;
+export declare function runCollectFollowLines(plugins: MindMapPlugin[], lines: string[], startIdx: number, node: MindMapData, ctx: ParseContext): number;
+export declare function runTransformNodeData(plugins: MindMapPlugin[], node: MindMapData, rawText: string, ctx: ParseContext): MindMapData;
+export declare function runPostParseTree(plugins: MindMapPlugin[], roots: MindMapData[], ctx: ParseContext): MindMapData[];
+export declare function runSerializePreamble(plugins: MindMapPlugin[], roots: MindMapData[]): string;
+export declare function runSerializeListMarker(plugins: MindMapPlugin[], node: MindMapData, defaultMarker: string): string;
+export declare function runSerializeNodeText(plugins: MindMapPlugin[], node: MindMapData, baseText: string): string;
+export declare function runSerializeFollowLines(plugins: MindMapPlugin[], node: MindMapData, indent: number): string[];
+export declare function runAdjustNodeSize(plugins: MindMapPlugin[], node: MindMapData, width: number, height: number, fontSize: number): {
+    width: number;
+    height: number;
+};
+export declare function runFilterChildren(plugins: MindMapPlugin[], node: MindMapData, children: MindMapData[], ctx: LayoutContext): MindMapData[];
+export declare function runTransformEdge(plugins: MindMapPlugin[], edge: Edge, fromNode: LayoutNode, toNode: LayoutNode): Edge;
+export declare function runGenerateExtraEdges(plugins: MindMapPlugin[], nodes: LayoutNode[], roots: MindMapData[], ctx: LayoutContext): Edge[];
+export declare function runTransformNodeColor(plugins: MindMapPlugin[], node: LayoutNode, data: MindMapData, parentColor: string): {
+    color?: string;
+    bgColor?: string;
+};
+export declare function runRenderNodeDecoration(plugins: MindMapPlugin[], node: LayoutNode, theme: ThemeColors): React.ReactNode[];
+export declare function runRenderInlineToken(plugins: MindMapPlugin[], layout: TokenLayout, key: number): React.ReactNode | null;
+export declare function runRenderOverlay(plugins: MindMapPlugin[], nodes: LayoutNode[], edges: Edge[], theme: ThemeColors): React.ReactNode[];
+export declare function runExportNodeDecoration(plugins: MindMapPlugin[], node: LayoutNode, theme: ThemeColors, allPlugins?: MindMapPlugin[], pngSafe?: boolean): string;
+export declare function runExportInlineToken(plugins: MindMapPlugin[], layout: TokenLayout, pngSafe?: boolean): string | null;
+export declare function runExportOverlay(plugins: MindMapPlugin[], nodes: LayoutNode[], edges: Edge[], theme: ThemeColors): string;

package/dist/plugins/tags.d.ts

@@ -0,0 +1,2 @@
+import type { MindMapPlugin } from './types';
+export declare const tagsPlugin: MindMapPlugin;

package/dist/plugins/types.d.ts

@@ -0,0 +1,78 @@
+import type { MindMapData, LayoutNode, Edge, LayoutDirection } from "../types";
+import type { InlineToken, TokenLayout } from "../utils/inline-markdown";
+import type { ThemeColors } from "../utils/theme";
+export interface ParseContext {
+    lines: string[];
+    frontMatter: Record<string, string>;
+}
+export interface LayoutContext {
+    direction: LayoutDirection;
+    theme: ThemeColors;
+    readonly: boolean;
+    foldOverrides: Record<string, boolean>;
+}
+export interface ParsedLineResult {
+    indent: number;
+    text: string;
+    taskStatus?: import("../types").TaskStatus;
+    dottedLine?: boolean;
+    collapsed?: boolean;
+}
+export interface MindMapPlugin {
+    name: string;
+    /** Pre-process entire markdown string (e.g. extract frontmatter) */
+    preParseMarkdown?(md: string, ctx: ParseContext): string;
+    /** Match a non-standard line marker (-. or +). Return null to let core handle it. */
+    parseLine?(line: string, index: number, ctx: ParseContext): ParsedLineResult | null;
+    /** Collect follow-up lines after a node (e.g. | text). Return count of consumed lines. */
+    collectFollowLines?(lines: string[], startIdx: number, node: MindMapData, ctx: ParseContext): number;
+    /** Transform node data: extract #tags, @color(), {#id}, etc. from text into fields */
+    transformNodeData?(node: MindMapData, rawText: string, ctx: ParseContext): MindMapData;
+    /** Post-process the fully-built tree (e.g. resolve cross-link anchor references) */
+    postParseTree?(roots: MindMapData[], ctx: ParseContext): MindMapData[];
+    /** Emit text before the markdown body (e.g. frontmatter block) */
+    serializePreamble?(roots: MindMapData[]): string;
+    /** Override list marker for a node. Default is '- '. */
+    serializeListMarker?(node: MindMapData, defaultMarker: string): string;
+    /** Transform node text when serializing (e.g. re-attach #tags, @color(), {#id}) */
+    serializeNodeText?(node: MindMapData, baseText: string): string;
+    /** Emit extra lines after a node line (e.g. | text). Returns array of line contents (caller adds indent). */
+    serializeFollowLines?(node: MindMapData, indent: number): string[];
+    /** Additional regex pattern to splice into the inline markdown parser */
+    inlineTokenPattern?(): {
+        pattern: string;
+        priority: number;
+    };
+    /** Create an InlineToken from a regex match produced by this plugin's pattern */
+    createInlineToken?(match: RegExpExecArray, groupOffset: number): InlineToken | null;
+    /** Adjust a node's measured dimensions */
+    adjustNodeSize?(node: MindMapData, width: number, height: number, fontSize: number): {
+        width: number;
+        height: number;
+    };
+    /** Filter children before layout (folding plugin hides collapsed children) */
+    filterChildren?(node: MindMapData, children: MindMapData[], ctx: LayoutContext): MindMapData[];
+    /** Modify an edge's properties (e.g. set strokeDasharray for dotted lines) */
+    transformEdge?(edge: Edge, fromNode: LayoutNode, toNode: LayoutNode): Edge;
+    /** Produce additional edges after tree layout (e.g. cross-links) */
+    generateExtraEdges?(nodes: LayoutNode[], roots: MindMapData[], ctx: LayoutContext): Edge[];
+    /** Override node color (e.g. decorator plugin sets custom branch color) */
+    transformNodeColor?(node: LayoutNode, data: MindMapData, parentColor: string): {
+        color?: string;
+        bgColor?: string;
+    };
+    /** Render additional SVG elements on a node */
+    renderNodeDecoration?(node: LayoutNode, theme: ThemeColors): React.ReactNode;
+    /** Render an inline token introduced by this plugin */
+    renderInlineToken?(layout: TokenLayout, key: number): React.ReactNode;
+    /** Render an SVG overlay layer (e.g. cross-link arrows) */
+    renderOverlay?(nodes: LayoutNode[], edges: Edge[], theme: ThemeColors): React.ReactNode;
+    /** Build additional SVG string for a node during export. pngSafe=true means no foreignObject. */
+    exportNodeDecoration?(node: LayoutNode, theme: ThemeColors, plugins?: MindMapPlugin[], pngSafe?: boolean): string;
+    /** Build SVG tspan string for a custom inline token. pngSafe=true means no foreignObject. */
+    exportInlineToken?(layout: TokenLayout, pngSafe?: boolean): string;
+    /** Build SVG string for overlay elements during export */
+    exportOverlay?(nodes: LayoutNode[], edges: Edge[], theme: ThemeColors): string;
+    /** Load KaTex styles */
+    loadKatexStyle?(): void;
+}

package/dist/style.css

@@ -0,0 +1,2 @@
+.mindmap-container{width:100%;height:100%;position:relative;overflow:hidden}.mindmap-svg{cursor:grab;-webkit-user-select:none;user-select:none;touch-action:none;width:100%;height:100%;display:block}.mindmap-svg:focus{outline:none}.mindmap-svg.dragging-canvas,.mindmap-svg.dragging-node{cursor:grabbing}.mindmap-node-animated{transition:transform .3s ease-out}.mindmap-edge-animated{transition:d .3s ease-out}@keyframes mindmap-node-appear{0%{opacity:0;transform:scale(.85)}to{opacity:1;transform:scale(1)}}.mindmap-node-new{animation:.3s ease-out mindmap-node-appear}@keyframes mindmap-expand-appear{0%{opacity:0;transform:scale(.5)}to{opacity:1;transform:scale(1)}}.mindmap-node-expanding{animation:.3s ease-out both mindmap-expand-appear}@keyframes mindmap-edge-draw{0%{stroke-dashoffset:300px}to{stroke-dashoffset:0}}.mindmap-edge-expanding{stroke-dasharray:300;animation:.3s ease-out both mindmap-edge-draw}.mindmap-edit-input{text-align:center;box-sizing:border-box;background:0 0;border:none;outline:none;width:100%;height:100%;margin:0;padding:0}.mindmap-edit-root{color:#fff;background:0 0}.mindmap-edit-child{color:inherit;background:0 0;border-radius:4px}.mindmap-zoom-controls{-webkit-backdrop-filter:blur(8px);backdrop-filter:blur(8px);border-radius:8px;align-items:center;gap:2px;padding:4px;display:flex;position:absolute;bottom:16px;left:16px;box-shadow:0 2px 8px #0000001a}.mindmap-ctrl-btn{cursor:pointer;width:32px;height:32px;color:inherit;background:0 0;border:none;border-radius:6px;justify-content:center;align-items:center;transition:background .15s,color .15s;display:flex}.mindmap-ctrl-btn:hover{background:#80808033}.mindmap-ctrl-pct{cursor:pointer;min-width:48px;height:32px;color:inherit;background:0 0;border:none;border-radius:6px;justify-content:center;align-items:center;font-family:system-ui,sans-serif;font-size:13px;font-weight:500;transition:background .15s;display:flex}.mindmap-ctrl-pct:hover{background:#80808033}.mindmap-extra-controls{-webkit-backdrop-filter:blur(8px);backdrop-filter:blur(8px);z-index:20;border-radius:8px;align-items:center;gap:2px;padding:4px;display:flex;position:absolute;bottom:16px;right:16px;box-shadow:0 2px 8px #0000001a}.mindmap-text-editor{resize:none;box-sizing:border-box;z-index:10;border:none;outline:none;width:100%;height:100%;padding:24px;font-family:ui-monospace,SFMono-Regular,SF Mono,Menlo,monospace;font-size:15px;line-height:1.7;position:absolute;inset:0}.mindmap-add-btn{opacity:0;cursor:pointer;transition:opacity .2s}.mindmap-node-g:hover .mindmap-add-btn{opacity:1}.mindmap-context-menu{-webkit-backdrop-filter:blur(12px);backdrop-filter:blur(12px);z-index:1000;border:1px solid;border-radius:8px;min-width:150px;padding:4px 0;font-family:system-ui,-apple-system,sans-serif;position:absolute}.mindmap-ctx-item{cursor:pointer;white-space:nowrap;justify-content:space-between;align-items:center;padding:8px 16px;font-size:14px;display:flex;position:relative}.mindmap-ctx-item:hover{filter:brightness(.92);background:#8080801a}.mindmap-ctx-arrow{opacity:.5;margin-left:12px;font-size:8px}.mindmap-ctx-divider{opacity:.3;border-top:1px solid;height:0;margin:4px 8px}.mindmap-ctx-submenu{-webkit-backdrop-filter:blur(12px);backdrop-filter:blur(12px);border:1px solid;border-radius:8px;min-width:140px;padding:4px 0;position:absolute;top:-4px;left:100%}.mindmap-ctx-has-sub{position:relative}.mindmap-dialog-backdrop{-webkit-backdrop-filter:blur(8px);backdrop-filter:blur(8px);z-index:2000;background:#0003;justify-content:center;align-items:center;font-family:system-ui,-apple-system,sans-serif;animation:.15s ease-out mindmap-fade-in;display:flex;position:absolute;inset:0}@keyframes mindmap-fade-in{0%{opacity:0}to{opacity:1}}.mindmap-dialog-modal{border:1px solid;border-radius:12px;width:calc(100% - 32px);max-width:480px;max-height:80%;padding:24px;animation:.2s ease-out mindmap-dialog-enter;position:relative;overflow-y:auto;box-shadow:0 8px 32px #0003}@keyframes mindmap-dialog-enter{0%{opacity:0;transform:scale(.95)translateY(8px)}to{opacity:1;transform:scale(1)translateY(0)}}.mindmap-dialog-header{justify-content:space-between;align-items:center;margin-bottom:16px;display:flex}.mindmap-dialog-title{margin:0;font-size:16px;font-weight:600}.mindmap-dialog-close{cursor:pointer;width:28px;height:28px;color:inherit;opacity:.5;background:0 0;border:none;border-radius:6px;flex-shrink:0;justify-content:center;align-items:center;transition:opacity .15s,background .15s;display:flex}.mindmap-dialog-close:hover{opacity:1;background:#80808033}@media (width<=500px){.mindmap-dialog-modal{max-height:90%;padding:16px}}@media (width<=768px){.mindmap-ctrl-btn{width:28px;height:28px}.mindmap-ctrl-btn svg{width:14px;height:14px}.mindmap-ctrl-pct{min-width:40px;height:28px;font-size:12px}.mindmap-zoom-controls,.mindmap-extra-controls{gap:1px;padding:3px;bottom:12px}.mindmap-zoom-controls{left:12px}.mindmap-extra-controls{right:12px}}.mindmap-node-content{white-space:nowrap;box-sizing:border-box;justify-content:center;align-items:center;gap:4px;line-height:1;display:flex;overflow:hidden}.mindmap-node-root-content{line-height:1}.mindmap-node-content strong{font-weight:700}.mindmap-node-content em{font-style:italic}.mindmap-node-content del{opacity:.6;text-decoration:line-through}.mindmap-node-content .mindmap-inline-code{background:#8080801f;border-radius:3px;padding:1px 4px;font-family:SFMono-Regular,Consolas,Liberation Mono,Menlo,monospace;font-size:.88em}.mindmap-node-content .mindmap-highlight{color:#fac800;background:#fcd34d33;border-radius:2px;padding:1px 2px}.mindmap-node-content .mindmap-link{color:#2563eb;cursor:pointer;text-decoration:none}.mindmap-node-content .mindmap-link:hover{text-decoration:underline}.mindmap-node-content .mindmap-inline-image{vertical-align:middle;border-radius:2px;max-width:80px;max-height:1.2em}.mindmap-node-root-content .mindmap-inline-code{background:#ffffff26}.mindmap-node-root-content .mindmap-highlight{color:#fcd34d;background:#fbbf2433}.mindmap-node-root-content .mindmap-link{color:#93c5fd}.mindmap-task-icon{vertical-align:middle;flex-shrink:0}.mindmap-remark-indicator{opacity:.5;cursor:help;flex-shrink:0;font-size:.7em;line-height:1;transition:opacity .15s}.mindmap-remark-indicator:hover{opacity:1}.mindmap-remark-tooltip{white-space:pre-wrap;-webkit-backdrop-filter:blur(12px);backdrop-filter:blur(12px);z-index:1000;pointer-events:none;border-radius:8px;max-width:280px;padding:8px 12px;font-family:system-ui,-apple-system,sans-serif;font-size:13px;line-height:1.5;animation:.15s ease-out mindmap-fade-in;position:absolute;box-shadow:0 4px 16px #00000026}
+/*$vite$:1*/

package/dist/types.d.ts

@@ -0,0 +1,105 @@
+export type TaskStatus = 'todo' | 'doing' | 'done';
+export interface CrossLink {
+    targetAnchorId: string;
+    label?: string;
+    dotted?: boolean;
+}
+export interface MindMapData {
+    id: string;
+    text: string;
+    children?: MindMapData[];
+    remark?: string;
+    taskStatus?: TaskStatus;
+    dottedLine?: boolean;
+    multiLineContent?: string[];
+    tags?: string[];
+    anchorId?: string;
+    crossLinks?: CrossLink[];
+    collapsed?: boolean;
+}
+export type LayoutDirection = 'left' | 'right' | 'both';
+export type ThemeMode = 'light' | 'dark' | 'auto';
+export interface ToolbarConfig {
+    zoom?: boolean;
+}
+export interface LayoutNode {
+    id: string;
+    text: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    color: string;
+    depth: number;
+    side: 'left' | 'right' | 'root';
+    parentId?: string;
+    remark?: string;
+    taskStatus?: TaskStatus;
+    dottedLine?: boolean;
+    multiLineContent?: string[];
+    tags?: string[];
+    anchorId?: string;
+    crossLinks?: CrossLink[];
+    collapsed?: boolean;
+}
+export interface Edge {
+    key: string;
+    path: string;
+    color: string;
+    fromId: string;
+    toId: string;
+    strokeDasharray?: string;
+    label?: string;
+    isCrossLink?: boolean;
+}
+export type MindMapEvent = {
+    type: 'nodeAdd';
+    node: MindMapData;
+    parentId: string | null;
+} | {
+    type: 'nodeDelete';
+    nodeId: string;
+} | {
+    type: 'nodeTextChange';
+    nodeId: string;
+    oldText: string;
+    newText: string;
+} | {
+    type: 'nodeSelect';
+    nodeId: string | null;
+} | {
+    type: 'modeChange';
+    mode: 'view' | 'text';
+} | {
+    type: 'directionChange';
+    direction: LayoutDirection;
+} | {
+    type: 'zoomChange';
+    zoom: number;
+} | {
+    type: 'fullscreenChange';
+    fullscreen: boolean;
+};
+export interface MindMapProps {
+    data?: MindMapData | MindMapData[];
+    markdown?: string;
+    defaultDirection?: LayoutDirection;
+    theme?: ThemeMode;
+    locale?: string;
+    messages?: Partial<import('./utils/i18n').MindMapMessages>;
+    readonly?: boolean;
+    toolbar?: boolean | ToolbarConfig;
+    onDataChange?: (data: MindMapData[]) => void;
+    onEvent?: (event: MindMapEvent) => void;
+    plugins?: import('./plugins/types').MindMapPlugin[];
+}
+export interface MindMapRef {
+    exportToSVG(): string;
+    exportToPNG(): Promise<Blob>;
+    exportToOutline(): string;
+    getData(): MindMapData[];
+    setData(data: MindMapData | MindMapData[]): void;
+    setMarkdown(md: string): void;
+    fitView(): void;
+    setDirection(dir: LayoutDirection): void;
+}

package/dist/utils/export.d.ts

@@ -0,0 +1,18 @@
+import type { LayoutNode, Edge } from '../types';
+import type { ThemeColors } from './theme';
+import type { MindMapPlugin } from '../plugins/types';
+interface ExportOptions {
+    padding?: number;
+    scale?: number;
+    background?: string;
+    /** When true, avoid foreignObject elements (for PNG canvas export) */
+    pngSafe?: boolean;
+}
+/**
+ * Build SVG string for export. Uses pure SVG elements with inline styles.
+ * Works for both SVG file export and PNG conversion.
+ */
+export declare function buildExportSVG(nodes: LayoutNode[], edges: Edge[], options?: ExportOptions, theme?: ThemeColors, plugins?: MindMapPlugin[]): string;
+export declare const buildExportSVGForPNG: typeof buildExportSVG;
+export declare function exportToPNG(svgString: string, options?: ExportOptions): Promise<Blob>;
+export {};

package/dist/utils/i18n.d.ts

@@ -0,0 +1,22 @@
+export interface MindMapMessages {
+    newNode: string;
+    zoomIn: string;
+    zoomOut: string;
+    resetView: string;
+    layoutLeft: string;
+    layoutBoth: string;
+    layoutRight: string;
+    textMode: string;
+    viewMode: string;
+    fullscreen: string;
+    exitFullscreen: string;
+    newRootNode: string;
+    export: string;
+    exportSVG: string;
+    exportPNG: string;
+    exportMarkdown: string;
+    layout: string;
+    close: string;
+}
+export declare function detectLocale(): string;
+export declare function resolveMessages(locale?: string, overrides?: Partial<MindMapMessages>): MindMapMessages;

package/dist/utils/inline-markdown.d.ts

@@ -0,0 +1,66 @@
+import type { MindMapPlugin } from "../plugins/types";
+export type InlineToken = {
+    type: "text";
+    content: string;
+} | {
+    type: "bold";
+    content: string;
+} | {
+    type: "italic";
+    content: string;
+} | {
+    type: "strikethrough";
+    content: string;
+} | {
+    type: "code";
+    content: string;
+} | {
+    type: "highlight";
+    content: string;
+} | {
+    type: "link";
+    text: string;
+    url: string;
+} | {
+    type: "image";
+    alt: string;
+    url: string;
+} | {
+    type: "latex-inline";
+    content: string;
+} | {
+    type: "latex-block";
+    content: string;
+};
+/**
+ * Parse inline markdown text into tokens.
+ * Priority: image > link > code > bold > italic > strikethrough > highlight
+ * Plugins can inject additional patterns (e.g. LaTeX $...$).
+ */
+export declare function parseInlineMarkdown(text: string, plugins?: MindMapPlugin[]): InlineToken[];
+/**
+ * Strip all inline markdown markers, returning plain text for measurement.
+ */
+export declare function stripInlineMarkdown(text: string): string;
+export interface TokenLayout {
+    token: InlineToken;
+    x: number;
+    width: number;
+}
+/**
+ * Compute per-token layout (x offset and width) for SVG rendering.
+ */
+export declare function computeTokenLayouts(tokens: InlineToken[], fontSize: number, fontWeight: number, fontFamily: string): TokenLayout[];
+declare function escapeXml(str: string): string;
+export { escapeXml };
+/**
+ * Build SVG elements string for a node's formatted text content.
+ * Returns background rects + text element + remark indicator as SVG string.
+ * All styles are inline SVG attributes — no CSS dependencies.
+ */
+export declare function buildSvgNodeTextString(text: string, fontSize: number, fontWeight: number, fontFamily: string, textColor: string, taskStatus: string | undefined, remarkText: string | undefined, plugins?: MindMapPlugin[], highlightTextColor?: string, highlightBgColor?: string, pngSafe?: boolean): string;
+/**
+ * Build SVG string for a single line of inline-markdown-formatted text at a given y coordinate.
+ * Used by plugins (e.g. multi-line) to render additional text lines during export.
+ */
+export declare function buildSvgTextLineString(text: string, fontSize: number, fontWeight: number, fontFamily: string, textColor: string, y: number, plugins?: MindMapPlugin[], highlightTextColor?: string, highlightBgColor?: string, opacity?: number): string;

package/dist/utils/layout.d.ts

@@ -0,0 +1,14 @@
+import type { MindMapData, LayoutNode, Edge, LayoutDirection } from '../types';
+import type { MindMapPlugin } from '../plugins/types';
+export declare function computeEdgePath(fromX: number, fromY: number, fromW: number, toX: number, toY: number, toW: number, side: 'left' | 'right' | 'root'): string;
+export declare function layoutMindMap(data: MindMapData, direction?: LayoutDirection, colorMap?: Record<string, string>, splitIndex?: number, plugins?: MindMapPlugin[], readonly?: boolean, foldOverrides?: Record<string, boolean>): {
+    nodes: LayoutNode[];
+    edges: Edge[];
+};
+/**
+ * Layout multiple independent root trees, stacked vertically.
+ */
+export declare function layoutMultiRoot(roots: MindMapData[], direction?: LayoutDirection, colorMap?: Record<string, string>, splitIndices?: Record<string, number>, plugins?: MindMapPlugin[], readonly?: boolean, foldOverrides?: Record<string, boolean>): {
+    nodes: LayoutNode[];
+    edges: Edge[];
+};

package/dist/utils/markdown.d.ts

@@ -0,0 +1,20 @@
+import type { MindMapData } from '../types';
+import type { MindMapPlugin } from '../plugins/types';
+export declare function parseMarkdownList(md: string, plugins?: MindMapPlugin[]): MindMapData;
+export declare function toMarkdownList(data: MindMapData, indent?: number, plugins?: MindMapPlugin[]): string;
+/**
+ * Parse markdown with multiple root trees separated by blank lines.
+ */
+export declare function parseMarkdownMultiRoot(md: string, plugins?: MindMapPlugin[]): MindMapData[];
+/**
+ * Convert multiple root trees to markdown, separated by blank lines.
+ */
+export declare function toMarkdownMultiRoot(roots: MindMapData[], plugins?: MindMapPlugin[]): string;
+/**
+ * Get frontMatter from a parsed markdown context.
+ * Call this after parseMarkdownMultiRoot to retrieve frontmatter config.
+ */
+export declare function parseMarkdownWithFrontMatter(md: string, plugins: MindMapPlugin[]): {
+    roots: MindMapData[];
+    frontMatter: Record<string, string>;
+};

package/dist/utils/theme.d.ts

@@ -0,0 +1,62 @@
+export declare const BRANCH_COLORS: string[];
+export interface ThemeColors {
+    root: {
+        fontSize: number;
+        fontWeight: number;
+        fontFamily: string;
+        paddingH: number;
+        paddingV: number;
+        bgColor: string;
+        textColor: string;
+    };
+    node: {
+        fontSize: number;
+        fontWeight: number;
+        fontFamily: string;
+        paddingH: number;
+        paddingV: number;
+        textColor: string;
+    };
+    level1: {
+        fontSize: number;
+        fontWeight: number;
+    };
+    connection: {
+        strokeWidth: number;
+    };
+    layout: {
+        horizontalGap: number;
+        verticalGap: number;
+    };
+    canvas: {
+        bgColor: string;
+    };
+    controls: {
+        bgColor: string;
+        textColor: string;
+        hoverBg: string;
+        activeBg: string;
+    };
+    contextMenu: {
+        bgColor: string;
+        textColor: string;
+        hoverBg: string;
+        borderColor: string;
+        shadowColor: string;
+    };
+    addBtn: {
+        fill: string;
+        hoverFill: string;
+        iconColor: string;
+    };
+    selection: {
+        strokeColor: string;
+        fillColor: string;
+    };
+    highlight: {
+        textColor: string;
+        bgColor: string;
+    };
+}
+export declare function getTheme(mode: "light" | "dark"): ThemeColors;
+export declare const THEME: ThemeColors;

package/dist/utils/tree-ops.d.ts

@@ -0,0 +1,36 @@
+import type { MindMapData } from '../types';
+export declare function generateId(): string;
+export declare function normalizeData(data: MindMapData | MindMapData[]): MindMapData[];
+export declare function updateNodeText(node: MindMapData, id: string, text: string): MindMapData;
+export declare function updateNodeFields(node: MindMapData, id: string, fields: Partial<Pick<MindMapData, 'text' | 'taskStatus' | 'remark'>>): MindMapData;
+export declare function addChild(node: MindMapData, parentId: string, child: MindMapData): MindMapData;
+export declare function removeNode(node: MindMapData, targetId: string): MindMapData;
+export declare function swapSiblings(node: MindMapData, id1: string, id2: string): MindMapData;
+export declare function findSubtree(node: MindMapData, targetId: string): MindMapData | null;
+export declare function regenerateIds(node: MindMapData): MindMapData;
+export declare function getDescendantIds(nodeId: string, nodes: {
+    id: string;
+    parentId?: string;
+}[]): string[];
+export declare function updateNodeTextMulti(roots: MindMapData[], id: string, text: string): MindMapData[];
+export declare function updateNodeFieldsMulti(roots: MindMapData[], id: string, fields: Partial<Pick<MindMapData, 'text' | 'taskStatus' | 'remark'>>): MindMapData[];
+export declare function addChildMulti(roots: MindMapData[], parentId: string, child: MindMapData): MindMapData[];
+export declare function removeNodeMulti(roots: MindMapData[], targetId: string): MindMapData[];
+export declare function swapSiblingsMulti(roots: MindMapData[], id1: string, id2: string): MindMapData[];
+export declare function findSubtreeMulti(roots: MindMapData[], targetId: string): MindMapData | null;
+/**
+ * Add a child to a specific side of a root node's children.
+ * Returns the updated root and the new splitIndex.
+ */
+export declare function addChildToSide(root: MindMapData, child: MindMapData, side: 'left' | 'right', splitIndex: number): {
+    data: MindMapData;
+    newSplitIndex: number;
+};
+/**
+ * Move a direct child of root from one side to the other.
+ * Returns the updated root and new splitIndex, or null if already on target side.
+ */
+export declare function moveChildToSide(root: MindMapData, childId: string, toSide: 'left' | 'right', splitIndex: number): {
+    data: MindMapData;
+    newSplitIndex: number;
+} | null;

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@xiangfa/mindmap",
+  "description": "A beautiful, interactive mind map component for React.",
+  "private": false,
+  "version": "0.3.0",
+  "type": "module",
+  "main": "dist/mindmap.umd.cjs",
+  "module": "dist/esm/index.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": [
+    "*.css",
+    "./dist/esm/plugins/latex.js"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/mindmap.umd.cjs"
+      }
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "build:lib": "rm -rf dist && vite build --mode lib && tsc -p tsconfig.lib.json",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18",
+    "katex": ">=0.16"
+  },
+  "peerDependenciesMeta": {
+    "katex": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@types/node": "^24.12.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.0",
+    "eslint": "^9.39.4",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.5.2",
+    "globals": "^17.4.0",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.56.1",
+    "vite": "^8.0.0"
+  }
+}