flow-mindmap 0.4.0 → 0.4.2

package/dist/core/layout.d.ts

@@ -0,0 +1,144 @@
+export interface LayoutNode {
+    id: string;
+    text: string;
+    depth: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** Font size to render this node's text at, in px. */
+    fontSize: number;
+    isRoot: boolean;
+    collapsed?: boolean;
+    side: 1 | -1;
+    /**
+     * Direction this node's children fan out in: 'right' (default for
+     * mindmap right side / tree), 'left' (mindmap left side), or 'down'
+     * (org mode).
+     */
+    _dir: 'right' | 'left' | 'down';
+    /** Direction this node's children fan out in, as a signed scalar
+     *  (1 = right, -1 = left).  Mirrors `_dir` for callers that need
+     *  a number.  Kept in sync by applyDoLayout and forceRight — when
+     *  the height-based balancer moves a child to the opposite side,
+     *  the whole subtree gets its `side` / `_dir` / `_dirRight`
+     *  re-stamped so descendants fan the right way. */
+    _dirRight: 1 | -1;
+    /** Layout-only: vertical extent of this node's subtree (post-order
+     *  walk result, read by layoutHorizontal).  Not for public use. */
+    _subtreeH: number;
+    /** Layout-only: horizontal extent of this node's subtree (read by
+     *  layoutVertical / org mode).  Not for public use. */
+    _subtreeW: number;
+    /** Optional embedded image (mirrored from MindMapNode.image).
+     *  The renderer uses src/width/height; naturalW/H lock the
+     *  resize aspect ratio. */
+    image?: MindMapImage;
+    /** Mirrored from MindMapNode.link.  Read by the renderer to
+     *  show a link icon next to the text. */
+    link?: {
+        url: string;
+    };
+    /** Mirrored from MindMapNode.note.  Read by the renderer to
+     *  show a note icon next to the text. */
+    note?: {
+        text: string;
+    };
+    /** Mirrored from MindMapNode.richContent.  Read by the renderer
+     *  to show a small framed body under the node title (code / list /
+     *  table / paragraph).  Undefined means the node is plain text
+     *  only — the default behaviour, unchanged from before this
+     *  field was introduced. */
+    richContent?: RichContent;
+    /** Inset (px) the SVG edge anchor should retreat from the
+     *  geometric box edge on the in-side, to land at the visible
+     *  content edge instead.  Set to `.zm-node` padding +
+     *  `.zm-rich` padding + 2 for code/table nodes (their visible
+     *  content sits well inside the box); 0 for plain nodes (the
+     *  geometric edge IS the visible edge).  Used by lineAnchor
+     *  in MindMap.vue — non-zero for nodes whose first child of
+     *  the line would otherwise appear to pierce the rich body. */
+    _richInsetX?: number;
+    children: LayoutNode[];
+    parent: LayoutNode | null;
+}
+import type { MindMapNode, MindMapImage, RichContent } from '../types';
+/** Return the rendered font size for a node at the given depth, scaled
+ *  by the host's `theme.fontSize` (default 14).  The base table is
+ *  tuned at 14px; values scale linearly so a 30px theme produces
+ *  roughly 2.14× larger nodes. */
+declare function fontAt(depth: number, baseFontSize?: number): number;
+declare function heightAt(depth: number, baseFontSize?: number): number;
+/** Max text-label width in px.  MUST match `max-width` on `.zm-text`
+ *  in MindMap.vue.  The layout reserves this much room for the label
+ *  regardless of how long the actual text is — the DOM then truncates
+ *  with `text-overflow: ellipsis`.  Without this cap, a long string
+ *  pushes the rendered node box past the layout's reserved width and
+ *  the line anchor (computed from layout width) ends up inside the
+ *  box.  The 200px default is the same value `flow-mindmap` shipped
+ *  with before; keeping it keeps edge anchors stable. */
+export declare const TEXT_MAX_W = 200;
+export type LayoutMode = 'mindmap' | 'tree' | 'org';
+export interface LayoutOptions {
+    mode?: LayoutMode;
+    /** @deprecated kept for API compat; ignored in 1.html-style layout. */
+    balanced?: boolean;
+    /** Base font size (px) used to scale node metrics (font/height/
+     *  min-width).  The internal tier table is tuned for 14px; values
+     *  scale linearly.  Default 14. */
+    baseFontSize?: number;
+    /**
+     * When true, layout() leaves each LayoutNode's existing x/y in
+     * place — it still does the doLayout split / redirect / stack
+     * walk, but skips writing to child.x / child.y.  Used after a
+     * drag: we commit the offset into the data tree, clear the
+     * per-node offset map, then re-run layout with this flag so
+     * the dragged node (and its subtree) stay where the user put
+     * them.  The root is still forced to (0, 0) — to put the
+     * dragged node at a new position, the surrounding tree moves
+     * relative to it.  New nodes added later get the algorithmic
+     * position since their LayoutNode has x = 0, y = 0.
+     */
+    preservePositions?: boolean;
+    /**
+     * Per-node measured size of the rendered rich body (the
+     * `<div class="zm-rich">` element above the title), in px.  The
+     * caller (MindMap.vue) populates this after each render with
+     * `el.offsetWidth` / `el.offsetHeight`; layout reads it for
+     * nodes that carry code / table rich content.  When a node has
+     * a measured size we use it directly so the box grows /
+     * shrinks to fit the content.  When the caller hasn't
+     * measured a node yet we fall back to the fixed floor / cap.
+     * IDs not present in the map are simply ignored — useful for
+     * the very first render before measurement has happened.
+     */
+    richHeights?: Record<string, number>;
+    richWidths?: Record<string, number>;
+}
+export declare function layout(root: MindMapNode, options?: LayoutOptions): {
+    root: LayoutNode;
+    width: number;
+    height: number;
+    vbX: number;
+    vbY: number;
+    vbW: number;
+    vbH: number;
+};
+export declare const LAYOUT: {
+    /** Legacy single-size values for callers that still expect them. */
+    NODE_W: number;
+    NODE_H: number;
+    NODE_FONTS: number[];
+    NODE_HEIGHTS: number[];
+    NODE_MIN_W: number[];
+    NODE_PAD_H: number[];
+    NODE_FONT_WEIGHTS: number[];
+    H_GAP: number;
+    V_GAP: number;
+    SIDE_PADDING: number;
+    heightAt: typeof heightAt;
+    fontAt: typeof fontAt;
+    /** Clear the text-measurement cache (call after font load). */
+    clearMeasureCache: () => void;
+};
+export {};

package/dist/core/palettes.d.ts

@@ -0,0 +1,43 @@
+export interface BranchPalette {
+    id: string;
+    name: string;
+    /** Hex colors cycled across top-level branches, in display order. */
+    colors: string[];
+}
+export declare const BUILTIN_PALETTES: readonly BranchPalette[];
+/**
+ * Resolve a palette by id from a combined list of built-ins and
+ * user-defined custom palettes.  Falls back to the default palette
+ * if `id` is missing or points at a deleted custom palette.  Pure
+ * — no DOM, no reactive deps — so it can be called from a computed
+ * or a watch.
+ */
+export declare function resolvePalette(id: string, customPalettes?: readonly BranchPalette[]): BranchPalette;
+/**
+ * Parse a free-form text blob into a cleaned color array.  Accepts:
+ *
+ *   1. **Hex codes** — `#rgb` / `#rgba` / `#rrggbb` / `#rrggbbaa`,
+ *      with or without the leading `#`.  The alpha channel on
+ *      4- or 8-digit hex is silently dropped.
+ *   2. **`rgb()` / `rgba()` functions** — `rgb(255, 99, 71)`,
+ *      `rgba(255,99,71,0.5)`.  Whitespace and percentage values
+ *      are both accepted (matches CSS rules).  Alpha dropped.
+ *   3. **CSS named colors** — the 30 most common (`red`, `tomato`,
+ *      `coral`, `teal`, …).  A small curated set keeps the parser
+ *      from silently accepting typos that look color-ish
+ *      (`tan`, `peru` are in; `chartreuse1` is not).
+ *   4. **JSON / JS array** — `['#f87171', 'red']`,
+ *      `["#f87171","rgb(0,0,255)"]`, even a single-line
+ *      `["red","blue"]`.  Bracket and quote chars are tolerated
+ *      so a copy-pasted `[…]` round-trips cleanly.
+ *   5. **Any-delimiter blob** — the parser scans the raw text for
+ *      color-shaped substrings rather than splitting on commas,
+ *      so a user can paste `rgb(255, 0, 0), #0f0, blue` and every
+ *      piece lands.
+ *
+ * Malformed tokens are dropped silently (consistent with the
+ * rest of the canvas's "paste messy text" UX).  Returns at most
+ * `maxColors` entries; output is lowercased `#rrggbb` for stable
+ * dedup and direct comparison with `BUILTIN_PALETTES`.
+ */
+export declare function parsePaletteInput(text: string, maxColors?: number): string[];

package/dist/entry.d.ts

@@ -0,0 +1,18 @@
+import MindMap from './components/MindMap.vue';
+import Outline from './components/Outline.vue';
+import Drawer from './components/Drawer.vue';
+import DataPanel from './components/DataPanel.vue';
+import MarkdownPanel from './components/MarkdownPanel.vue';
+import SettingsPanel from './components/SettingsPanel.vue';
+import NotePanel from './components/NotePanel.vue';
+import MindMapApp from './App.vue';
+import type { App } from 'vue';
+import type { MindMapNode, MindMapOptions, MindMapTheme, MindMapExpose, MindMapSettings, NodeStyle, LineStyle, LayoutMode, BranchPalette, BranchPaletteId, RichContent } from './types';
+import { uid, clone, findNode, findParent, removeNode, addChild, addSibling, markdownToMindMap, mindMapToMarkdown, markdownToRichMindMap, richBlockToMarkdown } from './tree';
+export type { MindMapNode, MindMapOptions, MindMapTheme, MindMapExpose, MindMapSettings, NodeStyle, LineStyle, LayoutMode, BranchPalette, BranchPaletteId, RichContent };
+export { MindMap, Outline, Drawer, DataPanel, MarkdownPanel, SettingsPanel, NotePanel, MindMapApp };
+export { uid, clone, findNode, findParent, removeNode, addChild, addSibling, markdownToMindMap, mindMapToMarkdown, markdownToRichMindMap, richBlockToMarkdown };
+declare const plugin: {
+    install(app: App): void;
+};
+export default plugin;