@visualli/core 0.1.7 → 0.2.0

package/README.md

@@ -7,13 +7,13 @@ Framework-agnostic core logic, types, and algorithms for Visualli. Zero React /
 | Module | What it provides |
 |--------|------------------|
 | **Types** | Full TypeScript interfaces for `VisualliDocument`, `VisualliLayer`, `FlatNode`, `ViewportState`, `RenderConfig`, `Connection`, and more |
-| **Parser** | Parse `.visualli` JSONL files, convert layers to flat nodes, resolve spatial overlaps |
-| **Layout** | Circular and linear layout algorithms with automatic radius/spacing calculation |
-| **Viewport** | Pure pan/zoom/bounds math — world↔screen coordinate transforms, fit-to-screen |
+| **Parser** | Parse `.visualli` JSONL files and convert layers to flat nodes: each idea sized for its label and coloured by the design system's rules, placed where the file puts it |
+| **Layout** | Circular and linear layouts for files whose ideas carry no positions |
+| **Design system** | The Visualli design system's rules, copied verbatim from `design-system/` (tokens, blob geometry, motion, idea size, colours, containers, fit, peek, trail, level of detail) |
+| **Viewport** | Pure pan/zoom/bounds math — world↔screen coordinate transforms, fit to view |
 | **Spatial index** | RBush-backed O(log n) spatial index for viewport culling of large node graphs |
-| **Animations** | Easing functions (cubic, quartic, sine, bezier LUT) and timing phase constants |
 | **Performance** | rAF-based FPS monitor, memory monitor, profiler |
-| **Constants** | Design tokens (colors, spacing, typography), zoom limits, FPS targets, render config |
+| **Constants** | Zoom limits, FPS targets, render config |
 
 ## Installation
 
@@ -36,6 +36,10 @@ const doc = parseVisualliFile(rawJsonlString);
 // Get the root layer
 const rootLayerId = [...doc.layers.keys()][0];
 const nodes = getNodesForLayer(doc, rootLayerId); // FlatNode[]
+
+// Ideas are sized for their labels (the design system's idea.ts). Renderers pass their own text measurement in the
+// label face; without one, an approximation is used.
+const sized = getNodesForLayer(doc, rootLayerId, { measure: (text, px) => ctx.measureText(text).width, labelScale: 1 });
 ```
 
 ### Apply layouts
@@ -75,25 +79,15 @@ index.bulkLoad(nodes.map(n => ({
 const visible = index.query(viewportBounds); // string[] — node IDs
 ```
 
-### Easing
-
-```ts
-import { easeInOutCubic, easeOutCubic, createCubicBezier } from '@visualli/core';
-
-const t = easeInOutCubic(progress); // 0..1 → 0..1
-const custom = createCubicBezier(0.4, 0, 0.2, 1); // CSS timing function
-```
-
-### Colors & design tokens
+### Colours
 
 ```ts
-import {
-  getColorForLevel, getThemeBackground,
-  LEVEL_COLOR_ARRAY, DS_COLORS, BRAND_COLORS,
-} from '@visualli/core';
+import { ideaColor, ideaStyle } from '@visualli/core';
 
-const nodeColor = getColorForLevel(2);         // '#...' for level 2
-const bg        = getThemeBackground(isDark);  // canvas background
+ideaColor('teal', 0);      // { topic: 'teal', custom: null } — a topic name
+ideaColor(undefined, 2);   // { topic: 'iris', custom: null } — no colour: topics in sibling order
+ideaColor('#b7e7f3', 0);   // { topic: null, custom: { fill: '#b7e7f3', ring: '#8fb4be' } } — drawn as given
+ideaStyle('dark', node);   // { fill, ring } in a theme
 ```
 
 ## Module Reference
@@ -104,7 +98,7 @@ const bg        = getThemeBackground(isDark);  // canvas background
 |--------|-------------|
 | `VisualliDocument` | Top-level document (layers Map, extensions Map) |
 | `VisualliLayer` | A single layer: level, nodes, connections, containers |
-| `FlatNode` | Renderable node (position, size, title, color, level, parentId) |
+| `FlatNode` | Renderable idea: position, size for its label (`width` / `height`, `kind`), title, colour (`topic` or `custom`), level, parentId |
 | `NodeMap` | `Map<string, FlatNode>` |
 | `ViewportState` | `centerX/Y`, `zoomLevel`, `rotation`, `visibleBounds` |
 | `RenderConfig` | Quality level, FPS target, culling flag, render mode |
@@ -116,15 +110,15 @@ const bg        = getThemeBackground(isDark);  // canvas background
 |--------|-------------|
 | `parseVisualliFile(str)` | Parse JSONL → `VisualliDocument` |
 | `loadVisualliFileFromFile(file)` | Parse a browser `File` object |
-| `getNodesForLayer(doc, layerId)` | `FlatNode[]` for one layer |
-| `convertVisualliToFlatNodes(doc)` | All layers → `NodeMap` |
+| `getNodesForLayer(doc, layerId, opts?)` | `FlatNode[]` for one layer (`opts`: `measure`, `labelScale` for sizing ideas) |
+| `convertVisualliToFlatNodes(doc, opts?)` | All layers → `NodeMap` |
 | `getChildLayers(doc, layerId)` | Direct child layers |
 
 ### `layout/`
 
 | Export | Description |
 |--------|-------------|
-| `applyCircularLayout(nodes)` | Radial arrangement |
+| `applyCircularLayout(nodes)` | Radial arrangement (used when the file gives no positions) |
 | `applyLinearHorizontalLayout(nodes)` | Left-to-right tree |
 | `applyLinearVerticalLayout(nodes)` | Top-to-bottom tree |
 | `resolveCollisions(nodes)` | Push apart overlapping nodes |
@@ -137,7 +131,7 @@ const bg        = getThemeBackground(isDark);  // canvas background
 | `zoomViewport(delta, vp, px, py, w, h)` | Zoom to cursor |
 | `panViewport(dx, dy, vp)` | Translate camera |
 | `setViewportCenter(x, y, vp)` | Teleport center |
-| `clampZoom(level)` | Clamp to `[ZOOM_MIN, ZOOM_MAX]` |
+| `clampZoom(level, fit?)` | Clamp to `[ZOOM_MIN, ZOOM_MAX]` × the layer's fit scale (the design system's limits are relative to the fit) |
 | `worldToScreen(x, y, vp, w, h)` | World → screen px |
 | `screenToWorld(x, y, vp, w, h)` | Screen px → world |
 
@@ -145,12 +139,11 @@ const bg        = getThemeBackground(isDark);  // canvas background
 
 | Export | Description |
 |--------|-------------|
-| `ZOOM_MIN` / `ZOOM_MAX` | `0.3` / `5.0` |
-| `ZOOM_NAV_IN_THRESHOLD` | `2.7` — zoom level that triggers drill-in |
-| `ZOOM_NAV_OUT_THRESHOLD` | `0.4` — zoom level that triggers back navigation |
-| `LEVEL_COLOR_ARRAY` | 10-color palette indexed by node level |
+| `ZOOM_MIN` / `ZOOM_MAX` | `0.3` / `5.0` — the design system's `VIEW`, relative to the layer's fit |
 | `DEFAULT_RENDER_CONFIG` | Baseline quality settings |
-| `ANIMATION_PHASES` | Duration constants for layer transitions |
+
+Motion, idea size, colours, fit, peek placement and the depth trail are the design system's rules, exported verbatim
+(`MOTION`, `layerReveal`, `IDEA`, `ideaSize`, `labelGrowth`, `ideaColor`, `layerBounds`, `fitView`, `peekPosition`, `TRAIL` …).
 
 ## TypeScript
 
@@ -178,86 +171,25 @@ npm run typecheck  # tsc --noEmit (0 errors expected)
 
 ```
 src/
-├── types/           TypeScript interfaces, enums, Zod schemas
-│   ├── mindmap.ts   MindMapNode, FlatNode, NodeMap, ViewportState, RenderConfig …
-│   ├── meta.ts      VisualliMeta
-│   ├── layer.ts     VisualliLayer, LayerNode, LayerConnection, LayerContainer …
-│   ├── extension.ts VisualliExtension
-│   ├── document.ts  VisualliDocument
-│   ├── schema.ts    JSON-schema-aligned types + re-exports
-│   ├── processing.ts ConnectionState, ProcessingState, type guards
-│   └── sse.ts       SSEEvent discriminated union + Zod validation + helpers
-│
-├── layout/          Pure layout algorithms (no side-effects)
-│   ├── circularLayout.ts  applyCircularLayout, calculateOptimalRadiusPercentage
-│   ├── linearLayout.ts    applyLinearHorizontalLayout, applyLinearVerticalLayout
-│   └── layoutUtils.ts     getNodeBounds, resolveCollisions, optimizeLayout
-│
-├── parser/          File parsing and data conversion
-│   ├── visualliParser.ts    parseVisualliFile, loadVisualliFile, getChildLayers …
-│   ├── visualliConverter.ts convertVisualliToFlatNodes, resolveNodeOverlaps …
-│   ├── mindmapUtils.ts      flattenNodes, getVisibleNodes, calculateDistance …
-│   └── configUtils.ts       createMindMapConfig, generateSampleConfig
-│
-├── services/        Network utilities (fetch, SSE, logging)
-│   ├── api.ts       initApi, apiRequest, ApiError, mindmapApi, correlationId helpers
-│   ├── logger.ts    Logger class (buffered remote + console)
-│   └── sseClient.ts createSSEClient (fetch ReadableStream, reconnection)
-│
-├── constants/       Design tokens, performance thresholds, render config
-│   ├── performanceConstants.ts  FPS targets, zoom limits, node dimensions …
-│   ├── design.ts                DS_COLORS, LEVEL_COLORS, BRAND_COLORS, helpers …
-│   └── renderConfig.ts          DEFAULT_RENDER_CONFIG, FEATURE_FLAGS, helpers …
-│
-├── viewport/        Coordinate math and pan/zoom operations
-│   └── viewportUtils.ts  calculateViewportBounds, worldToScreen, zoomViewport …
+├── generated/       The Visualli design system, generated from design-system/ (never edited by hand)
+│   ├── designSystem.ts  TOKENS, METRICS, TYPE_STYLES, CANVAS_STYLE (from css/spec.css)
+│   └── geometry/        blob, motion, idea, color, container, interaction, detail — copied verbatim
 │
+├── types/           TypeScript interfaces (FlatNode, VisualliDocument, VisualliLayer, ViewportState …)
+├── parser/          parseVisualliFile; convertLayerToFlatNodes / getNodesForLayer (sizes, colours, positions)
+├── layout/          Circular and linear layouts, for layers whose ideas carry no positions
+├── rendering/       nodeGeometry (radii, rings, connector endpoints), ideaSize (idea.ts + measurement), culling
+├── theme/           Theme and comfort resolution; ideaColor / ideaStyle (the design system's colour rule)
+├── utils/           Layer navigation and fit to view (layerBounds / fitView)
+├── viewport/        Coordinate math and pan / zoom (limits relative to the layer's fit)
+├── constants/       Zoom limits, performance thresholds, render config
 ├── performance/     FPS / memory monitoring (browser APIs, no React)
-│   └── performanceMonitor.ts  FPSMonitor, MemoryMonitor, PerformanceProfiler
-│
-├── animations/      Easing functions and timing constants
-│   ├── easing.ts    easeInOutCubic, createCubicBezier …
-│   └── constants.ts ANIMATION_DURATION, ANIMATION_PHASES, COOLDOWN …
-│
 └── spatial/         RBush spatial index for O(log n) viewport culling
-    └── spatialIndex.ts  RBushSpatialIndex, ISpatialIndex, BoundingBox
-```
-
-## Installation
-
-```bash
-npm install @visualli/core
-```
-
-> **Dependencies:** `zod` (schema validation) · `rbush` (spatial index)
-
-## Quick Start
-
-```ts
-// Parse a .visualli document
-import { parseVisualliFile, convertVisualliToFlatNodes } from '@visualli/core/parser';
-
-const doc      = parseVisualliFile(rawJsonlString);
-const nodeMap  = convertVisualliToFlatNodes(doc);
-
-// Apply a circular layout
-import { applyCircularLayout } from '@visualli/core/layout';
-const nodes = [...nodeMap.values()];
-applyCircularLayout(nodes);
-
-// Viewport math
-import { zoomViewport } from '@visualli/core/viewport';
-const next = zoomViewport(0.1, currentViewport, pivotX, pivotY);
-
-// API client
-import { initApi, mindmapApi } from '@visualli/core/services';
-initApi({ baseUrl: 'https://api.example.com/api' });
-const list = await mindmapApi.getAllMindmaps();
 ```
 
 ## Design Principles
 
 - **No React** — no hooks, no JSX, no Context
-- **No DOM manipulation** — pure data transforms; browser APIs (`fetch`, `FileReader`) are used only at IO boundaries
-- **No Vite env vars** — configure at runtime via `initApi()`
+- **No DOM manipulation** — pure data transforms; text measurement is passed in by the renderer
+- **No design decisions of its own** — every visual rule comes from the Visualli design system (`design-system/`)
 - **Tree-shakeable** — import from sub-paths to avoid bundling unused modules

package/dist/chunk-25AJTPMS.js

@@ -0,0 +1,68 @@
+// src/generated/geometry/idea.ts
+var LABEL_GROWTH = { idea: 1.3, connector: 1.6 };
+var IDEA = {
+  /** Width an idea starts at… */
+  baseWidth: { root: 240, node: 200, mini: 120 },
+  /** …and the widest it gets before it grows taller instead. */
+  maxWidth: { root: 400, node: 360, mini: 200 },
+  /** Width grows in steps of this. */
+  step: 20,
+  /** Height = width × aspect (at least `minRy` × 2), more if the label needs it. */
+  aspect: 0.74,
+  minRy: 64,
+  /** The label's box is the idea's width less this (22 each side). */
+  labelInset: 44,
+  /** The idea widens until its label fits in this many lines. */
+  labelLines: 3,
+  /** Label size (before the label scale and zoom growth), weight from the canvas type styles. */
+  labelSize: { root: 30, node: 22, mini: 15 },
+  labelLineHeight: 1.15,
+  /** The label may fill at most this share of the idea's height. */
+  labelFillHeight: 0.7
+};
+function wrapLines(text, maxWidth, measure) {
+  const words = text.split(/\s+/).filter(Boolean);
+  const lines = [];
+  let cur = "";
+  for (const w of words) {
+    const next = cur ? `${cur} ${w}` : w;
+    if (cur && measure(next) > maxWidth) {
+      lines.push(cur);
+      cur = w;
+    } else cur = next;
+  }
+  if (cur) lines.push(cur);
+  return lines.length ? lines : [""];
+}
+function ideaSize(kind, label, measure, labelScale = 1) {
+  const px = IDEA.labelSize[kind] * labelScale * LABEL_GROWTH.idea;
+  const fit = (w) => wrapLines(label, w - IDEA.labelInset, (t) => measure(t, px));
+  const base = IDEA.baseWidth[kind], max = IDEA.maxWidth[kind];
+  let width = base, lines = fit(width);
+  while (lines.length > IDEA.labelLines && width < max) {
+    width = Math.min(max, width + IDEA.step);
+    lines = fit(width);
+  }
+  const rx = width / 2;
+  const ry = Math.max(IDEA.minRy, rx * IDEA.aspect, lines.length * px * IDEA.labelLineHeight / 2 / IDEA.labelFillHeight);
+  return { width, height: ry * 2, rx, ry, lines };
+}
+function labelGrowth(scale) {
+  const inv = 1 / Math.max(scale, 1e-4);
+  return { idea: Math.max(1, Math.min(inv, LABEL_GROWTH.idea)), connector: Math.max(1, Math.min(inv, LABEL_GROWTH.connector)) };
+}
+
+// src/rendering/ideaSize.ts
+var approximateMeasure = (text, px) => text.length * px * 0.5;
+var ideaKindOf = (layer, index) => layer.level === 0 && (layer.layout ?? "radial") === "radial" && index === 0 ? "root" : "node";
+
+export {
+  LABEL_GROWTH,
+  IDEA,
+  wrapLines,
+  ideaSize,
+  labelGrowth,
+  approximateMeasure,
+  ideaKindOf
+};
+//# sourceMappingURL=chunk-25AJTPMS.js.map

package/dist/chunk-25AJTPMS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/generated/geometry/idea.ts","../src/rendering/ideaSize.ts"],"sourcesContent":["// Generated from visualli.ai design-system/components/src/idea.ts — do not edit here.\n/* An idea's size and its label. An idea grows to show its whole label: it starts at its base width and widens in\n   steps until the label fits in `labelLines` lines; at its widest it grows taller instead, so a label is never cut.\n   Labels (and connector labels) grow a little when the map is zoomed out, so they stay readable. Every renderer sizes\n   ideas with these rules, measuring text with its own font engine (`measure`). No dependencies, so it can travel alone. */\n\nexport type IdeaKind = 'root' | 'node' | 'mini';\n\n/** How much labels grow when zoomed out (`scale` = the map's zoom): never smaller than their size, up to these caps.\n *  Idea labels and container names use `idea`; connector labels `connector`. Below 100% they grow; above, they don't. */\nexport const LABEL_GROWTH = { idea: 1.3, connector: 1.6 } as const;\n\nexport const IDEA = {\n  /** Width an idea starts at… */ baseWidth: { root: 240, node: 200, mini: 120 },\n  /** …and the widest it gets before it grows taller instead. */ maxWidth: { root: 400, node: 360, mini: 200 },\n  /** Width grows in steps of this. */ step: 20,\n  /** Height = width × aspect (at least `minRy` × 2), more if the label needs it. */ aspect: 0.74, minRy: 64,\n  /** The label's box is the idea's width less this (22 each side). */ labelInset: 44,\n  /** The idea widens until its label fits in this many lines. */ labelLines: 3,\n  /** Label size (before the label scale and zoom growth), weight from the canvas type styles. */ labelSize: { root: 30, node: 22, mini: 15 },\n  labelLineHeight: 1.15,\n  /** The label may fill at most this share of the idea's height. */ labelFillHeight: 0.7,\n} as const;\n\n/** Greedy word wrap of `text` into lines no wider than `maxWidth` (a single word longer than that gets its own line). */\nexport function wrapLines(text: string, maxWidth: number, measure: (s: string) => number): string[] {\n  const words = text.split(/\\s+/).filter(Boolean);\n  const lines: string[] = [];\n  let cur = '';\n  for (const w of words) {\n    const next = cur ? `${cur} ${w}` : w;\n    if (cur && measure(next) > maxWidth) { lines.push(cur); cur = w; } else cur = next;\n  }\n  if (cur) lines.push(cur);\n  return lines.length ? lines : [''];\n}\n\n/** An idea's size for its label: width, half-width / half-height for the blob, and the label's lines. The label is\n *  measured at its largest drawn size — its type size × `labelScale` (Comfort: larger text) × LABEL_GROWTH.idea (zoomed\n *  out) — so it fits at every zoom and the idea never changes size while zooming. `measure(text, px)` returns the\n *  text's width in px in the label's face at `px`. */\nexport function ideaSize(kind: IdeaKind, label: string, measure: (text: string, px: number) => number, labelScale = 1) {\n  const px = IDEA.labelSize[kind] * labelScale * LABEL_GROWTH.idea;\n  const fit = (w: number) => wrapLines(label, w - IDEA.labelInset, (t) => measure(t, px));\n  const base: number = IDEA.baseWidth[kind], max: number = IDEA.maxWidth[kind];\n  let width = base, lines = fit(width);\n  while (lines.length > IDEA.labelLines && width < max) { width = Math.min(max, width + IDEA.step); lines = fit(width); }\n  const rx = width / 2;\n  const ry = Math.max(IDEA.minRy, rx * IDEA.aspect, (lines.length * px * IDEA.labelLineHeight) / 2 / IDEA.labelFillHeight);\n  return { width, height: ry * 2, rx, ry, lines };\n}\n\nexport function labelGrowth(scale: number): { idea: number; connector: number } {\n  const inv = 1 / Math.max(scale, 0.0001);\n  return { idea: Math.max(1, Math.min(inv, LABEL_GROWTH.idea)), connector: Math.max(1, Math.min(inv, LABEL_GROWTH.connector)) };\n}\n","// ─── Idea size and label growth ──────────────────────────────────────────────\n//\n// The design system's idea.ts (copied verbatim into generated/geometry): an idea\n// grows to show its whole label, and labels grow a little when zoomed out. The\n// SDK only supplies the text measurement (its font engine) and picks the kind.\n\nimport { IDEA, LABEL_GROWTH, ideaSize, labelGrowth, wrapLines, type IdeaKind } from '../generated/geometry/idea.js';\nimport type { VisualliLayer } from '../types/layer.js';\n\nexport { IDEA, LABEL_GROWTH, ideaSize, labelGrowth, wrapLines };\nexport type { IdeaKind };\n\n/** Width in px of `text` in the idea label's face at `px` (the label's weight; readable type adds its tracking). */\nexport type IdeaMeasure = (text: string, px: number) => number;\n\n/** Measurement without a font engine (server, tests): half an em per character. Renderers pass the real face. */\nexport const approximateMeasure: IdeaMeasure = (text, px) => text.length * px * 0.5;\n\n/** The size kind of the `index`-th idea of a layer: the centre of the root radial layer is the root, the rest ideas. */\nexport const ideaKindOf = (layer: Pick<VisualliLayer, 'level' | 'layout'>, index: number): IdeaKind =>\n  layer.level === 0 && (layer.layout ?? 'radial') === 'radial' && index === 0 ? 'root' : 'node';\n"],"mappings":";AAUO,IAAM,eAAe,EAAE,MAAM,KAAK,WAAW,IAAI;AAEjD,IAAM,OAAO;AAAA;AAAA,EACc,WAAW,EAAE,MAAM,KAAK,MAAM,KAAK,MAAM,IAAI;AAAA;AAAA,EACd,UAAU,EAAE,MAAM,KAAK,MAAM,KAAK,MAAM,IAAI;AAAA;AAAA,EACtE,MAAM;AAAA;AAAA,EACwC,QAAQ;AAAA,EAAM,OAAO;AAAA;AAAA,EACnC,YAAY;AAAA;AAAA,EACjB,YAAY;AAAA;AAAA,EACoB,WAAW,EAAE,MAAM,IAAI,MAAM,IAAI,MAAM,GAAG;AAAA,EAC1I,iBAAiB;AAAA;AAAA,EACkD,iBAAiB;AACtF;AAGO,SAAS,UAAU,MAAc,UAAkB,SAA0C;AAClG,QAAM,QAAQ,KAAK,MAAM,KAAK,EAAE,OAAO,OAAO;AAC9C,QAAM,QAAkB,CAAC;AACzB,MAAI,MAAM;AACV,aAAW,KAAK,OAAO;AACrB,UAAM,OAAO,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK;AACnC,QAAI,OAAO,QAAQ,IAAI,IAAI,UAAU;AAAE,YAAM,KAAK,GAAG;AAAG,YAAM;AAAA,IAAG,MAAO,OAAM;AAAA,EAChF;AACA,MAAI,IAAK,OAAM,KAAK,GAAG;AACvB,SAAO,MAAM,SAAS,QAAQ,CAAC,EAAE;AACnC;AAMO,SAAS,SAAS,MAAgB,OAAe,SAA+C,aAAa,GAAG;AACrH,QAAM,KAAK,KAAK,UAAU,IAAI,IAAI,aAAa,aAAa;AAC5D,QAAM,MAAM,CAAC,MAAc,UAAU,OAAO,IAAI,KAAK,YAAY,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC;AACtF,QAAM,OAAe,KAAK,UAAU,IAAI,GAAG,MAAc,KAAK,SAAS,IAAI;AAC3E,MAAI,QAAQ,MAAM,QAAQ,IAAI,KAAK;AACnC,SAAO,MAAM,SAAS,KAAK,cAAc,QAAQ,KAAK;AAAE,YAAQ,KAAK,IAAI,KAAK,QAAQ,KAAK,IAAI;AAAG,YAAQ,IAAI,KAAK;AAAA,EAAG;AACtH,QAAM,KAAK,QAAQ;AACnB,QAAM,KAAK,KAAK,IAAI,KAAK,OAAO,KAAK,KAAK,QAAS,MAAM,SAAS,KAAK,KAAK,kBAAmB,IAAI,KAAK,eAAe;AACvH,SAAO,EAAE,OAAO,QAAQ,KAAK,GAAG,IAAI,IAAI,MAAM;AAChD;AAEO,SAAS,YAAY,OAAoD;AAC9E,QAAM,MAAM,IAAI,KAAK,IAAI,OAAO,IAAM;AACtC,SAAO,EAAE,MAAM,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,aAAa,IAAI,CAAC,GAAG,WAAW,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,aAAa,SAAS,CAAC,EAAE;AAC9H;;;ACvCO,IAAM,qBAAkC,CAAC,MAAM,OAAO,KAAK,SAAS,KAAK;AAGzE,IAAM,aAAa,CAAC,OAAgD,UACzE,MAAM,UAAU,MAAM,MAAM,UAAU,cAAc,YAAY,UAAU,IAAI,SAAS;","names":[]}

package/dist/{chunk-6NXADJK2.js → chunk-7NJWM7ZE.js}

@@ -1,14 +1,24 @@
 import {
-  LAYOUT_SPACING,
-  LEVEL_COLORS,
-  getColorForLevel
-} from "./chunk-G5H3P4YZ.js";
+  approximateMeasure,
+  ideaKindOf,
+  ideaSize
+} from "./chunk-25AJTPMS.js";
+import {
+  LAYOUT_SPACING
+} from "./chunk-N7HCYULH.js";
 import {
   applyCircularLayout,
   applyLinearHorizontalLayout,
   applyLinearVerticalLayout,
   calculateOptimalRadiusPercentage
 } from "./chunk-GQMFBYLK.js";
+import {
+  ideaColor
+} from "./chunk-KVSM3APM.js";
+import {
+  TOKENS,
+  TOPICS
+} from "./chunk-LV3EXUQY.js";
 
 // src/parser/visualliParser.ts
 function toVisualliLayer(schemaLayer) {
@@ -75,6 +85,13 @@ function parseVisualliFile(content) {
         }
         break;
       }
+      case "extension": {
+        const id = obj["id"];
+        if (typeof id === "string") {
+          (doc.extensions ?? (doc.extensions = {}))[id] = Array.isArray(obj["data"]) ? obj["data"] : [];
+        }
+        break;
+      }
       default:
         break;
     }
@@ -112,6 +129,11 @@ function loadVisualliFileFromFile(file) {
     reader.readAsText(file);
   });
 }
+function getSemanticAnchors(doc) {
+  const raw = doc.extensions?.["semantic-anchors"];
+  if (!Array.isArray(raw)) return [];
+  return raw.filter((a) => !!a && typeof a.word === "string" && typeof a.description === "string");
+}
 function getChildLayers(doc, nodeId) {
   const result = [];
   for (const layer of doc.layers.values()) {
@@ -169,26 +191,10 @@ function resolveNodeOverlaps(nodes, maxIterations = 10) {
     if (!any) break;
   }
 }
-var COLOR_PALETTE = [
-  "#12C7D3",
-  "#325E8C",
-  "#8A70A6",
-  "#F54A57",
-  "#FF6C4D",
-  "#F28C16",
-  "#FFD347",
-  "#12C7D3",
-  "#7F7F7F",
-  "#8D8D8D",
-  "#12C7D3"
-];
-function getRandomColorForNode(nodeId) {
-  let hash = 0;
-  for (let i = 0; i < nodeId.length; i++) {
-    hash = nodeId.charCodeAt(i) + ((hash << 5) - hash);
-  }
-  const index = Math.abs(hash) % COLOR_PALETTE.length;
-  return COLOR_PALETTE[index];
+function hasFilePositions(layer) {
+  const ps = layer.nodes.map((n) => n.position);
+  if (!ps.length || !ps.every((p) => p && Number.isFinite(p.x) && Number.isFinite(p.y))) return false;
+  return ps.length === 1 || ps.some((p) => p.x !== ps[0].x || p.y !== ps[0].y);
 }
 function applyFormation(nodes, formation) {
   if (nodes.length === 0) return;
@@ -252,44 +258,34 @@ function proxyRadial(proxies, radius = 500) {
     proxies[i].y = radius * Math.sin(angle);
   }
 }
-function calculateNodeWidth(title) {
-  return Math.max(200, title.length * 8 + 40);
-}
-function makeFlatNode(nodeId, label, summary, layer, color, branchCount, x = 0, y = 0) {
+function makeFlatNode(node, layer, doc, siblingIndex, opts) {
+  const label = Array.isArray(node.data.label) ? node.data.label.join(" ") : node.data.label || "Untitled";
+  const branchCount = countLayersBeneath(doc, node.id);
+  const kind = ideaKindOf(layer, siblingIndex);
+  const size = ideaSize(kind, label, opts.measure ?? approximateMeasure, opts.labelScale ?? 1);
+  const { topic, custom } = ideaColor(node.data.color, siblingIndex);
   return {
-    id: nodeId,
+    id: node.id,
     parentId: layer.parentNodeId ?? null,
-    x,
-    y,
+    x: node.position?.x ?? 0,
+    y: node.position?.y ?? 0,
     level: layer.level,
     title: label,
-    description: summary,
-    color,
-    width: calculateNodeWidth(label),
-    height: 80,
+    description: node.data.summary || "",
+    color: node.data.color ?? "",
+    ...topic ? { topic } : {},
+    ...custom ? { custom } : {},
+    kind,
+    width: size.width,
+    height: size.height,
     isExpanded: branchCount > 0,
     branchCount,
     createdAt: /* @__PURE__ */ new Date(),
     updatedAt: /* @__PURE__ */ new Date()
   };
 }
-function convertLayerWithContainers(layer, doc) {
+function layoutLayerWithContainers(layer, flatNodes) {
   const PADDING = 80;
-  const flatNodes = [];
-  for (const node of layer.nodes) {
-    const label = Array.isArray(node.data.label) ? node.data.label.join(" ") : node.data.label || "Untitled";
-    const branchCount = countLayersBeneath(doc, node.id);
-    flatNodes.push(
-      makeFlatNode(
-        node.id,
-        label,
-        node.data.summary || "",
-        layer,
-        node.data.color || getRandomColorForNode(node.id),
-        branchCount
-      )
-    );
-  }
   const byId = new Map(flatNodes.map((n) => [n.id, n]));
   const containerNodeIds = /* @__PURE__ */ new Set();
   const containerGroups = /* @__PURE__ */ new Map();
@@ -302,11 +298,8 @@ function convertLayerWithContainers(layer, doc) {
     containerGroups.set(container.id, group);
   }
   const proxies = [];
-  for (const node of layer.nodes) {
-    if (!containerNodeIds.has(node.id)) {
-      const nodeWidth = calculateNodeWidth(node.data.label);
-      proxies.push({ id: node.id, x: 0, y: 0, width: nodeWidth, height: 80 });
-    }
+  for (const n of flatNodes) {
+    if (!containerNodeIds.has(n.id)) proxies.push({ id: n.id, x: 0, y: 0, width: n.width, height: n.height });
   }
   for (const container of layer.containers) {
     const group = containerGroups.get(container.id);
@@ -333,54 +326,40 @@ function convertLayerWithContainers(layer, doc) {
       }
     }
   }
-  resolveNodeOverlaps(flatNodes);
-  return flatNodes;
 }
-function convertLayerToFlatNodes(layer, doc) {
-  if ((layer.containers ?? []).length > 0) {
-    return convertLayerWithContainers(layer, doc);
-  }
-  const flatNodes = [];
-  for (const node of layer.nodes) {
-    const label = Array.isArray(node.data.label) ? node.data.label.join(" ") : node.data.label || "Untitled";
-    const branchCount = countLayersBeneath(doc, node.id);
-    flatNodes.push(
-      makeFlatNode(
-        node.id,
-        label,
-        node.data.summary || "",
-        layer,
-        node.data.color || getRandomColorForNode(node.id),
-        branchCount,
-        0,
-        0
-      )
-    );
+function layoutLayer(layer, flatNodes) {
+  const layout = layer.layout || "radial";
+  if (layout === "linear-horizontal") {
+    applyLinearHorizontalLayout(flatNodes, { centerX: 0, centerY: 0 });
+  } else if (layout === "linear-vertical") {
+    applyLinearVerticalLayout(flatNodes, { centerX: 0, centerY: 0 });
+  } else {
+    const pct = calculateOptimalRadiusPercentage(flatNodes.length, 2e3, 2e3, 200, 30);
+    applyCircularLayout(flatNodes, {
+      radiusPercentage: pct,
+      containerWidth: 2e3,
+      containerHeight: 2e3,
+      centerX: 0,
+      centerY: 0
+    });
   }
-  if (flatNodes.length > 0) {
-    const layout = layer.layout || "radial";
-    if (layout === "linear-horizontal") {
-      applyLinearHorizontalLayout(flatNodes, { centerX: 0, centerY: 0 });
-    } else if (layout === "linear-vertical") {
-      applyLinearVerticalLayout(flatNodes, { centerX: 0, centerY: 0 });
-    } else {
-      const pct = calculateOptimalRadiusPercentage(flatNodes.length, 2e3, 2e3, 200, 30);
-      applyCircularLayout(flatNodes, {
-        radiusPercentage: pct,
-        containerWidth: 2e3,
-        containerHeight: 2e3,
-        centerX: 0,
-        centerY: 0
-      });
-    }
+}
+function convertLayerToFlatNodes(layer, doc, opts = {}) {
+  const flatNodes = layer.nodes.map((node, i) => makeFlatNode(node, layer, doc, i, opts));
+  if (flatNodes.length === 0 || hasFilePositions(layer)) return flatNodes;
+  for (const n of flatNodes) {
+    n.x = 0;
+    n.y = 0;
   }
+  if ((layer.containers ?? []).length > 0) layoutLayerWithContainers(layer, flatNodes);
+  else layoutLayer(layer, flatNodes);
   resolveNodeOverlaps(flatNodes);
   return flatNodes;
 }
-function convertVisualliToFlatNodes(doc) {
+function convertVisualliToFlatNodes(doc, opts = {}) {
   const map = /* @__PURE__ */ new Map();
   for (const layer of doc.layers.values()) {
-    for (const node of convertLayerToFlatNodes(layer, doc)) {
+    for (const node of convertLayerToFlatNodes(layer, doc, opts)) {
       map.set(node.id, node);
     }
   }
@@ -392,9 +371,9 @@ function convertVisualliToFlatNodes(doc) {
   }
   return map;
 }
-function getNodesForLayer(doc, layerId) {
+function getNodesForLayer(doc, layerId, opts = {}) {
   const layer = doc.layers.get(layerId);
-  return layer ? convertLayerToFlatNodes(layer, doc) : [];
+  return layer ? convertLayerToFlatNodes(layer, doc, opts) : [];
 }
 
 // src/parser/mindmapUtils.ts
@@ -446,6 +425,8 @@ function calculateDistance(x1, y1, x2, y2) {
 }
 
 // src/parser/configUtils.ts
+var levelColor = (level) => TOKENS.light[`topic-${TOPICS[level % TOPICS.length]}`];
+var levelColors = (count) => Object.fromEntries(Array.from({ length: count }, (_, i) => [`level${i}`, levelColor(i)]));
 function createMindMapConfig(nodes, topLevelConnections, title = "Untitled Mindmap") {
   const now = (/* @__PURE__ */ new Date()).toISOString();
   return {
@@ -459,12 +440,7 @@ function createMindMapConfig(nodes, topLevelConnections, title = "Untitled Mindm
     nodes,
     topLevelConnections,
     settings: {
-      defaultColors: {
-        level0: LEVEL_COLORS.level0,
-        level1: LEVEL_COLORS.level1,
-        level2: LEVEL_COLORS.level2,
-        level3: LEVEL_COLORS.level3
-      },
+      defaultColors: levelColors(4),
       layout: {
         nodeSpacing: LAYOUT_SPACING.nodeSpacing,
         levelSpacing: LAYOUT_SPACING.levelSpacing
@@ -491,7 +467,7 @@ function generateLevelNodes(parentId, level, maxLevels, xOffset = 0, yOffset = 0
       level,
       x,
       y,
-      color: getColorForLevel(level),
+      color: levelColor(level),
       relationshipLabel: level > 0 ? "child" : void 0,
       parent: parentId ?? void 0
     };
@@ -520,17 +496,7 @@ function generateSampleConfig(maxLevels = 9) {
     nodes,
     topLevelConnections,
     settings: {
-      defaultColors: {
-        level0: LEVEL_COLORS.level0,
-        level1: LEVEL_COLORS.level1,
-        level2: LEVEL_COLORS.level2,
-        level3: LEVEL_COLORS.level3,
-        level4: LEVEL_COLORS.level4,
-        level5: LEVEL_COLORS.level5,
-        level6: LEVEL_COLORS.level6,
-        level7: LEVEL_COLORS.level7,
-        level8: LEVEL_COLORS.level8
-      },
+      defaultColors: levelColors(9),
       layout: {
         nodeSpacing: LAYOUT_SPACING.nodeSpacing,
         levelSpacing: LAYOUT_SPACING.levelSpacing
@@ -545,6 +511,7 @@ export {
   fetchAndParseVisualli,
   parseVisualliFromMongoDB,
   loadVisualliFileFromFile,
+  getSemanticAnchors,
   getChildLayers,
   countLayersBeneath,
   resolveNodeOverlaps,
@@ -559,4 +526,4 @@ export {
   createMindMapConfig,
   generateSampleConfig
 };
-//# sourceMappingURL=chunk-6NXADJK2.js.map
+//# sourceMappingURL=chunk-7NJWM7ZE.js.map