mind-elixir 5.8.3-beta.1 → 5.9.0

package/dist/PlaintextConverter.js

@@ -1,178 +1,228 @@
-const L = `- Root Node
+class x {
+  node;
+  children = [];
+  // slots[i] represents elements that appear *before* children[i]
+  // slots[children.length] represents elements that appear *after* all children
+  slots;
+  constructor(e) {
+    this.node = e;
+    const s = e.children?.length ?? 0;
+    this.slots = Array.from({ length: s + 1 }, () => []);
+  }
+}
+function j(a) {
+  const { nodeData: e, arrows: s = [], summaries: n = [] } = a, o = /* @__PURE__ */ new Map();
+  function r(t) {
+    const d = new x(t);
+    return o.set(t.id, d), t.children && (d.children = t.children.map(r)), d;
+  }
+  const i = r(e), l = [], g = /* @__PURE__ */ new Set();
+  for (const t of s) {
+    g.add(t.from), g.add(t.to);
+    const d = t.metadata, u = d?.parentId, p = d?.index ?? 1 / 0;
+    if (!u) {
+      l.push(t);
+      continue;
+    }
+    const w = o.get(u);
+    if (w) {
+      const y = Math.min(p, w.children.length);
+      w.slots[y].push({ type: "arrow", arrow: t });
+    } else
+      l.push(t);
+  }
+  for (const t of n) {
+    const d = o.get(t.parent);
+    if (d) {
+      const u = Math.min(t.end + 1, d.children.length);
+      d.slots[u].push({ type: "summary", summary: t });
+    }
+  }
+  function h(t) {
+    return o.get(t)?.node.metadata?.refId ?? t;
+  }
+  const f = [];
+  function c(t, d) {
+    const u = "  ".repeat(d), p = "  ".repeat(d + 1), w = t.node.metadata, y = [t.node.topic], M = w?.refId ?? (g.has(t.node.id) ? t.node.id : void 0);
+    M && y.push(`[^${M}]`), t.node.style && Object.keys(t.node.style).length > 0 && y.push(JSON.stringify(t.node.style)), f.push(`${u}- ${y.join(" ")}`);
+    for (let I = 0; I <= t.children.length; I++) {
+      for (const C of t.slots[I])
+        if (C.type === "arrow") {
+          const m = C.arrow, $ = m.bidirectional ? `<-${m.label ?? ""}->` : `>-${m.label ?? ""}->`;
+          f.push(`${p}- > [^${h(m.from)}] ${$} [^${h(m.to)}]`);
+        } else if (C.type === "summary") {
+          const m = C.summary, $ = m.end - m.start + 1, b = $ === t.children.length ? "" : `:${$} `;
+          f.push(`${p}- }${b}${m.label}`);
+        }
+      I < t.children.length && c(t.children[I], d + 1);
+    }
+  }
+  c(i, 0);
+  for (const t of l) {
+    const d = t.bidirectional ? `<-${t.label ?? ""}->` : `>-${t.label ?? ""}->`;
+    f.push(`- > [^${h(t.from)}] ${d} [^${h(t.to)}]`);
+  }
+  return f.join(`
+`) + `
+`;
+}
+function N() {
+  return ((/* @__PURE__ */ new Date()).getTime().toString(16) + Math.random().toString(16).substring(2)).substring(2, 18);
+}
+const k = `- Root Node
   - Child Node 1
     - Child Node 1-1 {"color": "#e87a90", "fontSize": "18px"}
     - Child Node 1-2
     - Child Node 1-3
     - }:2 Summary of first two nodes
   - Child Node 2
-    - Child Node 2-1 [^id1]
+    - Child Node 2-1 [^node-2-1]
     - Child Node 2-2 [^id2]
     - Child Node 2-3
-    - > [^id1] <-Bidirectional Link-> [^id2]
+    - > [^node-2-1] <-Bidirectional Link-> [^id2]
   - Child Node 3
     - Child Node 3-1 [^id3]
     - Child Node 3-2 [^id4]
     - Child Node 3-3 [^id5] {"fontFamily": "Arial", "fontWeight": "bold"}
     - > [^id3] >-Unidirectional Link-> [^id4]
-    - > [^id3] <-Unidirectional Link-< [^id5]
   - Child Node 4
     - Child Node 4-1 [^id6]
     - Child Node 4-2 [^id7]
     - Child Node 4-3 [^id8]
     - } Summary of all previous nodes
     - Child Node 4-4
-  - > [^id1] <-Link position is not restricted, as long as the id can be found during rendering-> [^id8]
+- > [^node-2-1] <-Link position is not restricted, as long as the id can be found during rendering-> [^id8]
+
 `;
-function b(r) {
-  const e = r.split(`
-`).filter((t) => t.trim()), d = {
+function v(a, e = "Root") {
+  const s = a.split(`
+`).filter((h) => h.trim());
+  if (s.length === 0)
+    throw new Error("Failed to parse plaintext: no root node found");
+  const n = {
     arrowLines: [],
-    summaryLines: [],
     nodeIdMap: /* @__PURE__ */ new Map()
-  }, n = y(e, 0, -2, d);
-  if (!n.node)
+  }, o = [], r = [], i = [];
+  for (const h of s) {
+    const f = S(h), c = T(h);
+    for (; r.length > 0 && r[r.length - 1].indent >= f; )
+      r.pop();
+    const t = r.length > 0 ? r[r.length - 1].node : null, d = t ? t.children ??= [] : i;
+    if (c.type === "arrow") {
+      n.arrowLines.push({
+        content: c.content,
+        parentId: t?.id ?? null,
+        index: d.length
+      });
+      continue;
+    }
+    if (c.type === "summary") {
+      const w = O(c.content, d, t?.id ?? "");
+      w && o.push(w);
+      continue;
+    }
+    const u = N(), p = {
+      topic: c.topic,
+      id: u
+    };
+    c.style && (p.style = c.style), c.refId && (n.nodeIdMap.set(c.refId, u), p.metadata = { refId: c.refId }), d.push(p), r.push({ indent: f, node: p });
+  }
+  if (i.length === 0)
     throw new Error("Failed to parse plaintext: no root node found");
-  const s = d.arrowLines.map(({ content: t }) => N(t, d)).filter((t) => t !== null), o = d.summaryLines.map(({ content: t, parentChildren: i, parentId: l }) => g(t, i, l)).filter((t) => t !== null);
+  let l;
+  i.length === 1 ? l = i[0] : l = {
+    topic: e,
+    id: N(),
+    children: i
+  };
+  const g = n.arrowLines.map(({ content: h, parentId: f, index: c }) => {
+    const t = R(h, n);
+    return t && (t.metadata = { parentId: f, index: c }), t;
+  }).filter((h) => h !== null);
   return {
-    nodeData: n.node,
-    arrows: s.length > 0 ? s : void 0,
+    nodeData: l,
+    arrows: g.length > 0 ? g : void 0,
     summaries: o.length > 0 ? o : void 0
   };
 }
-function y(r, e, d, n) {
-  if (e >= r.length)
-    return { node: null, nextIndex: e };
-  const s = r[e], o = I(s);
-  if (o <= d)
-    return { node: null, nextIndex: e };
-  const t = w(s);
-  if (t.type === "arrow" || t.type === "summary")
-    return { node: null, nextIndex: e + 1 };
-  const i = u(), l = {
-    topic: t.topic,
-    id: i
-  };
-  t.style && (l.style = t.style), t.refId && n.nodeIdMap.set(t.refId, i);
-  const c = [];
-  let a = e + 1;
-  for (; a < r.length; ) {
-    const m = r[a], p = I(m);
-    if (p <= o)
-      break;
-    if (p === o + 2) {
-      const f = w(m);
-      if (f.type === "arrow")
-        n.arrowLines.push({
-          content: f.content,
-          parentChildren: c
-        }), a++;
-      else if (f.type === "summary")
-        n.summaryLines.push({
-          content: f.content,
-          parentChildren: c,
-          parentId: i
-          // Pass parent node ID
-        }), a++;
-      else {
-        const h = y(r, a, o, n);
-        h.node && c.push(h.node), a = h.nextIndex;
-      }
-    } else
-      a++;
-  }
-  return c.length > 0 && (l.children = c), { node: l, nextIndex: a };
-}
-function I(r) {
-  const e = r.match(/^(\s*)/);
+function S(a) {
+  const e = a.match(/^(\s*)/);
   return e ? e[1].length : 0;
 }
-function C(r) {
+function L(a) {
   try {
-    const e = r.trim().startsWith("{") ? r : `{${r}}`;
+    const e = a.trim().startsWith("{") ? a : `{${a}}`;
     return JSON.parse(e);
   } catch {
     return {};
   }
 }
-function w(r) {
-  const d = r.trim().replace(/^-\s*/, "");
-  if (d.startsWith(">"))
+function T(a) {
+  const s = a.trim().replace(/^-\s*/, "");
+  if (s.startsWith(">"))
     return {
       type: "arrow",
       topic: "",
-      content: d.substring(1).trim()
+      content: s.substring(1).trim()
     };
-  if (d.startsWith("}"))
+  if (s.startsWith("}"))
     return {
       type: "summary",
       topic: "",
-      content: d.substring(1).trim()
+      content: s.substring(1).trim()
     };
-  let n = d, s, o;
-  const t = n.match(/\[\^(\w+)\]/);
-  t && (s = t[1], n = n.replace(t[0], "").trim());
-  const i = n.match(/\{([^}]+)\}/);
-  return i && (o = C(i[1]), n = n.replace(i[0], "").trim()), {
+  let n = s, o, r;
+  const i = n.match(/\[\^([\w-]+)\]/);
+  i && (o = i[1], n = n.replace(i[0], "").trim());
+  const l = n.match(/\{([^}]+)\}/);
+  return l && (r = L(l[1]), n = n.replace(l[0], "").trim()), {
     type: "node",
     topic: n,
     content: n,
-    refId: s,
-    style: o
+    refId: o,
+    style: r
   };
 }
-function N(r, e) {
-  const d = r.match(/\[\^(\w+)\]\s*<-([^-]*)->\s*\[\^(\w+)\]/);
-  if (d) {
-    const o = d[1], t = d[2].trim(), i = d[3];
+function R(a, e) {
+  const s = a.match(/\[\^([\w-]+)\]\s*<-([^-]*)->\s*\[\^([\w-]+)\]/);
+  if (s) {
+    const o = s[1], r = s[2].trim(), i = s[3];
     return {
-      id: u(),
-      label: t,
+      id: N(),
+      label: r,
       from: e.nodeIdMap.get(o) || o,
       to: e.nodeIdMap.get(i) || i,
       bidirectional: !0
     };
   }
-  const n = r.match(/\[\^(\w+)\]\s*>-([^-]*)->\s*\[\^(\w+)\]/);
+  const n = a.match(/\[\^([\w-]+)\]\s*>-([^-]*)->\s*\[\^([\w-]+)\]/);
   if (n) {
-    const o = n[1], t = n[2].trim(), i = n[3];
+    const o = n[1], r = n[2].trim(), i = n[3];
     return {
-      id: u(),
-      label: t,
-      from: e.nodeIdMap.get(o) || o,
-      to: e.nodeIdMap.get(i) || i
-    };
-  }
-  const s = r.match(/\[\^(\w+)\]\s*<-([^-]*)-<\s*\[\^(\w+)\]/);
-  if (s) {
-    const o = s[3], t = s[2].trim(), i = s[1];
-    return {
-      id: u(),
-      label: t,
+      id: N(),
+      label: r,
       from: e.nodeIdMap.get(o) || o,
       to: e.nodeIdMap.get(i) || i
     };
   }
   return null;
 }
-function g(r, e, d) {
-  const n = r.match(/^:(\d+)\s+(.*)/);
-  let s, o;
-  if (n ? (s = parseInt(n[1], 10), o = n[2]) : (s = e.length, o = r.trim()), e.length === 0 || s === 0)
+function O(a, e, s) {
+  const n = a.match(/^:(\d+)\s+(.*)/);
+  let o, r;
+  if (n ? (o = parseInt(n[1], 10), r = n[2]) : (o = e.length, r = a.trim()), e.length === 0 || o === 0)
     return null;
-  const t = e.slice(-s), i = e.indexOf(t[0]), l = e.indexOf(t[t.length - 1]);
+  const i = e.slice(-o), l = e.indexOf(i[0]), g = e.indexOf(i[i.length - 1]);
   return {
-    id: u(),
-    label: o,
-    parent: d,
-    start: i,
-    end: l
+    id: N(),
+    label: r,
+    parent: s,
+    start: l,
+    end: g
   };
 }
-let M = 0;
-function u() {
-  return `node-${Date.now()}-${M++}`;
-}
 export {
-  L as plaintextExample,
-  b as plaintextToMindElixir
+  j as mindElixirToPlaintext,
+  k as plaintextExample,
+  v as plaintextToMindElixir
 };

package/dist/types/arrow.d.ts

@@ -26,7 +26,7 @@ export interface ArrowStyle {
      */
     labelColor?: string;
 }
-export interface Arrow {
+export interface Arrow<M = unknown> {
     id: string;
     /**
      * label of arrow
@@ -62,6 +62,10 @@ export interface Arrow {
      * style properties for the arrow
      */
     style?: ArrowStyle;
+    /**
+     * Generic metadata for the arrow, can be used to store any custom data.
+     */
+    metadata?: M;
 }
 export interface DivData {
     cx: number;

package/dist/types/index.d.ts

@@ -26,10 +26,10 @@ declare namespace MindElixir {
         selectArrow: (this: MindElixirInstance, link: import("./docs").CustomSvg) => void;
         unselectArrow: (this: MindElixirInstance) => void;
         rmSubline: (this: MindElixirInstance, tpc: Topic) => Promise<void>;
-        reshapeNode: (this: MindElixirInstance, tpc: Topic, patchData: Partial<import("./docs").NodeObj>) => Promise<void>;
-        insertSibling: (this: MindElixirInstance, type: "before" | "after", el?: Topic | undefined, node?: import("./docs").NodeObj | undefined) => Promise<void>;
-        insertParent: (this: MindElixirInstance, el?: Topic | undefined, node?: import("./docs").NodeObj | undefined) => Promise<void>;
-        addChild: (this: MindElixirInstance, el?: Topic | undefined, node?: import("./docs").NodeObj | undefined) => Promise<void>;
+        reshapeNode: (this: MindElixirInstance, tpc: Topic, patchData: Partial<import("./docs").NodeObj<unknown>>) => Promise<void>;
+        insertSibling: (this: MindElixirInstance, type: "before" | "after", el?: Topic | undefined, node?: import("./docs").NodeObj<unknown> | undefined) => Promise<void>;
+        insertParent: (this: MindElixirInstance, el?: Topic | undefined, node?: import("./docs").NodeObj<unknown> | undefined) => Promise<void>;
+        addChild: (this: MindElixirInstance, el?: Topic | undefined, node?: import("./docs").NodeObj<unknown> | undefined) => Promise<void>;
         copyNode: (this: MindElixirInstance, node: Topic, to: Topic) => Promise<void>;
         copyNodes: (this: MindElixirInstance, tpcs: Topic[], to: Topic) => Promise<void>;
         moveUpNode: (this: MindElixirInstance, el?: Topic | undefined) => Promise<void>;

package/dist/types/methods.d.ts

@@ -31,10 +31,10 @@ declare const methods: {
     selectArrow: (this: MindElixirInstance, link: import("./docs").CustomSvg) => void;
     unselectArrow: (this: MindElixirInstance) => void;
     rmSubline: (this: MindElixirInstance, tpc: import("./docs").Topic) => Promise<void>;
-    reshapeNode: (this: MindElixirInstance, tpc: import("./docs").Topic, patchData: Partial<import("./types").NodeObj>) => Promise<void>;
-    insertSibling: (this: MindElixirInstance, type: "before" | "after", el?: import("./docs").Topic | undefined, node?: import("./types").NodeObj | undefined) => Promise<void>;
-    insertParent: (this: MindElixirInstance, el?: import("./docs").Topic | undefined, node?: import("./types").NodeObj | undefined) => Promise<void>;
-    addChild: (this: MindElixirInstance, el?: import("./docs").Topic | undefined, node?: import("./types").NodeObj | undefined) => Promise<void>;
+    reshapeNode: (this: MindElixirInstance, tpc: import("./docs").Topic, patchData: Partial<import("./types").NodeObj<unknown>>) => Promise<void>;
+    insertSibling: (this: MindElixirInstance, type: "before" | "after", el?: import("./docs").Topic | undefined, node?: import("./types").NodeObj<unknown> | undefined) => Promise<void>;
+    insertParent: (this: MindElixirInstance, el?: import("./docs").Topic | undefined, node?: import("./types").NodeObj<unknown> | undefined) => Promise<void>;
+    addChild: (this: MindElixirInstance, el?: import("./docs").Topic | undefined, node?: import("./types").NodeObj<unknown> | undefined) => Promise<void>;
     copyNode: (this: MindElixirInstance, node: import("./docs").Topic, to: import("./docs").Topic) => Promise<void>;
     copyNodes: (this: MindElixirInstance, tpcs: import("./docs").Topic[], to: import("./docs").Topic) => Promise<void>;
     moveUpNode: (this: MindElixirInstance, el?: import("./docs").Topic | undefined) => Promise<void>;

package/dist/types/types/index.d.ts

@@ -180,7 +180,7 @@ export interface TagObj {
  *
  * @public
  */
-export interface NodeObj {
+export interface NodeObj<M = unknown> {
     topic: string;
     id: Uid;
     style?: Partial<{
@@ -225,6 +225,10 @@ export interface NodeObj {
      * Extra data for the node, which can be used to store any custom data.
      */
     note?: string;
+    /**
+     * Generic metadata for the node, can be used to store any custom data.
+     */
+    metadata?: M;
 }
 export type NodeObjExport = Omit<NodeObj, 'parent'>;
 /**

package/dist/types/utils/mindElixirToPlaintext.d.ts

@@ -0,0 +1,8 @@
+import type { MindElixirData } from '../types';
+/**
+ * Convert MindElixirData back to plaintext format
+ *
+ * @param data - The MindElixirData object to convert
+ * @returns Plaintext string
+ */
+export declare function mindElixirToPlaintext(data: MindElixirData): string;

package/dist/types/utils/plaintextConverter.d.ts

@@ -1,18 +1,2 @@
-import type { MindElixirData } from '../types';
-export declare const plaintextExample = "- Root Node\n  - Child Node 1\n    - Child Node 1-1 {\"color\": \"#e87a90\", \"fontSize\": \"18px\"}\n    - Child Node 1-2\n    - Child Node 1-3\n    - }:2 Summary of first two nodes\n  - Child Node 2\n    - Child Node 2-1 [^id1]\n    - Child Node 2-2 [^id2]\n    - Child Node 2-3\n    - > [^id1] <-Bidirectional Link-> [^id2]\n  - Child Node 3\n    - Child Node 3-1 [^id3]\n    - Child Node 3-2 [^id4]\n    - Child Node 3-3 [^id5] {\"fontFamily\": \"Arial\", \"fontWeight\": \"bold\"}\n    - > [^id3] >-Unidirectional Link-> [^id4]\n    - > [^id3] <-Unidirectional Link-< [^id5]\n  - Child Node 4\n    - Child Node 4-1 [^id6]\n    - Child Node 4-2 [^id7]\n    - Child Node 4-3 [^id8]\n    - } Summary of all previous nodes\n    - Child Node 4-4\n  - > [^id1] <-Link position is not restricted, as long as the id can be found during rendering-> [^id8]\n";
-/**
- * Convert plaintext format to MindElixirData
- *
- * Format:
- * - Root node
- *   - Child 1
- *     - Child 1-1 [^id1]
- *     - Child 1-2 {"color": "#e87a90", "fontSize": "18px", "fontFamily": "Arial"}
- *     - }:2 Summary of first two nodes
- *   - Child 2 [^id2]
- *     - > [^id1] <-label-> [^id2]
- *
- * @param plaintext - The plaintext string to convert
- * @returns MindElixirData object
- */
-export declare function plaintextToMindElixir(plaintext: string): MindElixirData;
+export * from './mindElixirToPlaintext';
+export * from './plaintextToMindElixir';

package/dist/types/utils/plaintextToMindElixir.d.ts

@@ -0,0 +1,30 @@
+import type { MindElixirData } from '../types';
+export interface NodePlaintextMeta {
+    refId: string;
+}
+export interface ArrowPlaintextMeta {
+    parentId: string | null;
+    index: number;
+}
+export declare const plaintextExample = "- Root Node\n  - Child Node 1\n    - Child Node 1-1 {\"color\": \"#e87a90\", \"fontSize\": \"18px\"}\n    - Child Node 1-2\n    - Child Node 1-3\n    - }:2 Summary of first two nodes\n  - Child Node 2\n    - Child Node 2-1 [^node-2-1]\n    - Child Node 2-2 [^id2]\n    - Child Node 2-3\n    - > [^node-2-1] <-Bidirectional Link-> [^id2]\n  - Child Node 3\n    - Child Node 3-1 [^id3]\n    - Child Node 3-2 [^id4]\n    - Child Node 3-3 [^id5] {\"fontFamily\": \"Arial\", \"fontWeight\": \"bold\"}\n    - > [^id3] >-Unidirectional Link-> [^id4]\n  - Child Node 4\n    - Child Node 4-1 [^id6]\n    - Child Node 4-2 [^id7]\n    - Child Node 4-3 [^id8]\n    - } Summary of all previous nodes\n    - Child Node 4-4\n- > [^node-2-1] <-Link position is not restricted, as long as the id can be found during rendering-> [^id8]\n\n";
+/**
+ * Convert plaintext format to MindElixirData
+ *
+ * Format:
+ * - Root node
+ *   - Child 1
+ *     - Child 1-1 [^id1]
+ *     - Child 1-2 {"color": "#e87a90", "fontSize": "18px", "fontFamily": "Arial"}
+ *     - }:2 Summary of first two nodes
+ *   - Child 2 [^id2]
+ *     - > [^id1] <-label-> [^id2]
+ *
+ * When the plaintext contains more than one top-level node, a synthetic root
+ * node is automatically created to wrap them as first-level children.
+ *
+ * @param plaintext - The plaintext string to convert
+ * @param rootName - Optional name for the synthetic root node when multiple
+ *   top-level nodes are detected (defaults to 'Root')
+ * @returns MindElixirData object
+ */
+export declare function plaintextToMindElixir(plaintext: string, rootName?: string): MindElixirData;