@visualli/core 0.1.5 → 0.1.7

package/dist/chunk-LDJRGT2Q.js

@@ -0,0 +1,163 @@
+// src/constants/performanceConstants.ts
+var FPS_TARGET = 60;
+var FPS_WARNING_THRESHOLD = 45;
+var FPS_CRITICAL_THRESHOLD = 30;
+var TARGET_FRAME_TIME = 1e3 / FPS_TARGET;
+var MAX_FRAME_TIME = 18;
+var FPS_TARGETS = {
+  PAN_MIN: 30,
+  ZOOM_TARGET: 60,
+  WARNING_THRESHOLD: 20
+};
+var TIMING_THRESHOLDS = {
+  VIEWPORT_QUERY_MAX: 5,
+  SPATIAL_UPDATE_MAX: 10,
+  DRAG_RESPONSE_MAX: 16,
+  LOAD_5K_TARGET: 2e3,
+  LOAD_10K_TARGET: 3e3,
+  VIEWPORT_DEBOUNCE: 100,
+  SPATIAL_INDEX_BUILD: 50
+};
+var MEMORY_TARGET_MB = 500;
+var MEMORY_WARNING_MB = 600;
+var MEMORY_CRITICAL_MB = 800;
+var MEMORY_LIMITS = {
+  MAX_10K_NODES: 500,
+  MAX_GROWTH_PERCENT: 20,
+  WARNING_THRESHOLD: 400
+};
+var VIEWPORT_MARGIN = 0.1;
+var MAX_VISIBLE_NODES = 800;
+var CULLING_QUERY_TIME_BUDGET = 5;
+var RBUSH_MAX_ENTRIES = 16;
+var SPATIAL_INDEX_BUILD_BUDGET = 50;
+var NODE_MIN_WIDTH = 200;
+var NODE_HEIGHT = 80;
+var NODE_PADDING = 40;
+var CHAR_WIDTH = 8;
+var TITLE_MAX_LENGTH = 150;
+var CORNER_RADIUS = 8;
+var BORDER_WIDTH_NORMAL = 2;
+var BORDER_WIDTH_SELECTED = 3;
+var COLOR_SELECTED = "#1B2D4F";
+var COLOR_BORDER_LIGHT = "#4A3728";
+var COLOR_BORDER_DARK = "#FAF6F1";
+var COLOR_DEFAULT_NODE = "#FAF6F1";
+var ZOOM_MIN = 0.05;
+var ZOOM_MAX = 5;
+var ZOOM_DEFAULT = 1;
+var ZOOM_STEP = 0.1;
+var ZOOM_WHEEL_SENSITIVITY = 1e-3;
+var ZOOM_NAV_IN_THRESHOLD = 2.7;
+var ZOOM_NAV_OUT_THRESHOLD = 0.4;
+var TEXT_LABEL_HIDE_BELOW_ZOOM = 0.3;
+var QUALITY_HIGH = {
+  shadows: true,
+  bezierCurves: true,
+  animations: true,
+  textQuality: "high",
+  antialiasing: true
+};
+var QUALITY_MEDIUM = {
+  shadows: false,
+  bezierCurves: true,
+  animations: true,
+  textQuality: "medium",
+  antialiasing: true
+};
+var QUALITY_LOW = {
+  shadows: false,
+  bezierCurves: false,
+  animations: false,
+  textQuality: "low",
+  antialiasing: false
+};
+var FPS_SAMPLE_WINDOW = 60;
+var FPS_UPDATE_INTERVAL = 1e3;
+var MEMORY_CHECK_INTERVAL = 5e3;
+var PERFORMANCE_TOAST_COOLDOWN = 1e4;
+var FPS_DOWNGRADE_THRESHOLD = 45;
+var FPS_UPGRADE_THRESHOLD = 58;
+var FPS_STABILIZATION_FRAMES = 180;
+var DEFAULT_CANVAS_WIDTH = 1920;
+var DEFAULT_CANVAS_HEIGHT = 1080;
+var CLICK_THRESHOLD = 5;
+var DOUBLE_CLICK_DELAY = 300;
+var DRAG_START_DISTANCE = 10;
+var MAX_NODES = 2e4;
+var CIRCULAR_REFERENCE_MAX_DEPTH = 1e3;
+var RESIZE_DEBOUNCE = 300;
+var SCROLL_THROTTLE = 16;
+var SEARCH_DEBOUNCE = 500;
+var NODE_COUNT_THRESHOLDS = {
+  SPATIAL_INDEX_MIN: 100,
+  VIEWPORT_CULLING_MIN: 500,
+  CANVAS_RENDERING_MIN: 2e3,
+  DOM_RENDERING_MAX: 5e3
+};
+var VIEWPORT_CONFIG = {
+  BUFFER_PERCENT: 0.2,
+  MIN_VISIBLE_NODES: 10
+};
+
+export {
+  FPS_TARGET,
+  FPS_WARNING_THRESHOLD,
+  FPS_CRITICAL_THRESHOLD,
+  TARGET_FRAME_TIME,
+  MAX_FRAME_TIME,
+  FPS_TARGETS,
+  TIMING_THRESHOLDS,
+  MEMORY_TARGET_MB,
+  MEMORY_WARNING_MB,
+  MEMORY_CRITICAL_MB,
+  MEMORY_LIMITS,
+  VIEWPORT_MARGIN,
+  MAX_VISIBLE_NODES,
+  CULLING_QUERY_TIME_BUDGET,
+  RBUSH_MAX_ENTRIES,
+  SPATIAL_INDEX_BUILD_BUDGET,
+  NODE_MIN_WIDTH,
+  NODE_HEIGHT,
+  NODE_PADDING,
+  CHAR_WIDTH,
+  TITLE_MAX_LENGTH,
+  CORNER_RADIUS,
+  BORDER_WIDTH_NORMAL,
+  BORDER_WIDTH_SELECTED,
+  COLOR_SELECTED,
+  COLOR_BORDER_LIGHT,
+  COLOR_BORDER_DARK,
+  COLOR_DEFAULT_NODE,
+  ZOOM_MIN,
+  ZOOM_MAX,
+  ZOOM_DEFAULT,
+  ZOOM_STEP,
+  ZOOM_WHEEL_SENSITIVITY,
+  ZOOM_NAV_IN_THRESHOLD,
+  ZOOM_NAV_OUT_THRESHOLD,
+  TEXT_LABEL_HIDE_BELOW_ZOOM,
+  QUALITY_HIGH,
+  QUALITY_MEDIUM,
+  QUALITY_LOW,
+  FPS_SAMPLE_WINDOW,
+  FPS_UPDATE_INTERVAL,
+  MEMORY_CHECK_INTERVAL,
+  PERFORMANCE_TOAST_COOLDOWN,
+  FPS_DOWNGRADE_THRESHOLD,
+  FPS_UPGRADE_THRESHOLD,
+  FPS_STABILIZATION_FRAMES,
+  DEFAULT_CANVAS_WIDTH,
+  DEFAULT_CANVAS_HEIGHT,
+  CLICK_THRESHOLD,
+  DOUBLE_CLICK_DELAY,
+  DRAG_START_DISTANCE,
+  MAX_NODES,
+  CIRCULAR_REFERENCE_MAX_DEPTH,
+  RESIZE_DEBOUNCE,
+  SCROLL_THROTTLE,
+  SEARCH_DEBOUNCE,
+  NODE_COUNT_THRESHOLDS,
+  VIEWPORT_CONFIG
+};
+//# sourceMappingURL=chunk-LDJRGT2Q.js.map

package/dist/chunk-LDJRGT2Q.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants/performanceConstants.ts"],"sourcesContent":["// ─── Performance & Rendering Constants ───────────────────────────────────────\n\n// ── FPS ───────────────────────────────────────────────────────────────────────\n\nexport const FPS_TARGET                 = 60;\nexport const FPS_WARNING_THRESHOLD      = 45;\nexport const FPS_CRITICAL_THRESHOLD     = 30;\nexport const TARGET_FRAME_TIME          = 1000 / FPS_TARGET; // ~16.67 ms\nexport const MAX_FRAME_TIME             = 18;                 // p95 threshold\n\n/** Legacy frame-rate targets kept for backward compatibility. */\nexport const FPS_TARGETS = {\n  PAN_MIN:           30,\n  ZOOM_TARGET:       60,\n  WARNING_THRESHOLD: 20,\n} as const;\n\n// ── Timing Thresholds (ms) ────────────────────────────────────────────────────\n\nexport const TIMING_THRESHOLDS = {\n  VIEWPORT_QUERY_MAX:    5,\n  SPATIAL_UPDATE_MAX:    10,\n  DRAG_RESPONSE_MAX:     16,\n  LOAD_5K_TARGET:        2000,\n  LOAD_10K_TARGET:       3000,\n  VIEWPORT_DEBOUNCE:     100,\n  SPATIAL_INDEX_BUILD:   50,\n} as const;\n\n// ── Memory Limits (MB) ────────────────────────────────────────────────────────\n\nexport const MEMORY_TARGET_MB   = 500;\nexport const MEMORY_WARNING_MB  = 600;\nexport const MEMORY_CRITICAL_MB = 800;\n\nexport const MEMORY_LIMITS = {\n  MAX_10K_NODES:       500,\n  MAX_GROWTH_PERCENT:  20,\n  WARNING_THRESHOLD:   400,\n} as const;\n\n// ── Viewport Culling ──────────────────────────────────────────────────────────\n\nexport const VIEWPORT_MARGIN          = 0.1;\nexport const MAX_VISIBLE_NODES        = 800;\nexport const CULLING_QUERY_TIME_BUDGET = 5;\n\n// ── Spatial Index ─────────────────────────────────────────────────────────────\n\nexport const RBUSH_MAX_ENTRIES        = 16;\nexport const SPATIAL_INDEX_BUILD_BUDGET = 50;\n\n// ── Node Dimensions ───────────────────────────────────────────────────────────\n\nexport const NODE_MIN_WIDTH    = 200;\nexport const NODE_HEIGHT       = 80;\nexport const NODE_PADDING      = 40;\nexport const CHAR_WIDTH        = 8;\nexport const TITLE_MAX_LENGTH  = 150;\n\n// ── Visual Styling ────────────────────────────────────────────────────────────\n\nexport const CORNER_RADIUS         = 8;\nexport const BORDER_WIDTH_NORMAL   = 2;\nexport const BORDER_WIDTH_SELECTED = 3;\n\nexport const COLOR_SELECTED      = '#1B2D4F';\nexport const COLOR_BORDER_LIGHT  = '#4A3728';\nexport const COLOR_BORDER_DARK   = '#FAF6F1';\nexport const COLOR_DEFAULT_NODE  = '#FAF6F1';\n\n// ── Zoom Constraints ──────────────────────────────────────────────────────────\n\nexport const ZOOM_MIN              = 0.05;\nexport const ZOOM_MAX              = 5.0;\nexport const ZOOM_DEFAULT          = 1.0;\nexport const ZOOM_STEP             = 0.1;\nexport const ZOOM_WHEEL_SENSITIVITY = 0.001;\n\nexport const ZOOM_NAV_IN_THRESHOLD  = 2.7;\nexport const ZOOM_NAV_OUT_THRESHOLD = 0.4;\nexport const TEXT_LABEL_HIDE_BELOW_ZOOM = 0.3;\n\n// ── Quality Level Presets ─────────────────────────────────────────────────────\n\nexport const QUALITY_HIGH = {\n  shadows:      true,\n  bezierCurves: true,\n  animations:   true,\n  textQuality:  'high'   as const,\n  antialiasing: true,\n};\n\nexport const QUALITY_MEDIUM = {\n  shadows:      false,\n  bezierCurves: true,\n  animations:   true,\n  textQuality:  'medium' as const,\n  antialiasing: true,\n};\n\nexport const QUALITY_LOW = {\n  shadows:      false,\n  bezierCurves: false,\n  animations:   false,\n  textQuality:  'low'    as const,\n  antialiasing: false,\n};\n\n// ── Performance Monitoring ────────────────────────────────────────────────────\n\nexport const FPS_SAMPLE_WINDOW          = 60;\nexport const FPS_UPDATE_INTERVAL        = 1000;\nexport const MEMORY_CHECK_INTERVAL      = 5000;\nexport const PERFORMANCE_TOAST_COOLDOWN = 10000;\n\n// ── Auto-Adjustment ───────────────────────────────────────────────────────────\n\nexport const FPS_DOWNGRADE_THRESHOLD    = 45;\nexport const FPS_UPGRADE_THRESHOLD      = 58;\nexport const FPS_STABILIZATION_FRAMES   = 180;\n\n// ── Canvas Dimensions ─────────────────────────────────────────────────────────\n\nexport const DEFAULT_CANVAS_WIDTH  = 1920;\nexport const DEFAULT_CANVAS_HEIGHT = 1080;\n\n// ── Interaction ───────────────────────────────────────────────────────────────\n\nexport const CLICK_THRESHOLD      = 5;\nexport const DOUBLE_CLICK_DELAY   = 300;\nexport const DRAG_START_DISTANCE  = 10;\n\n// ── Data Validation ───────────────────────────────────────────────────────────\n\nexport const MAX_NODES                    = 20000;\nexport const CIRCULAR_REFERENCE_MAX_DEPTH = 1000;\n\n// ── Debounce / Throttle ───────────────────────────────────────────────────────\n\nexport const RESIZE_DEBOUNCE  = 300;\nexport const SCROLL_THROTTLE  = 16;\nexport const SEARCH_DEBOUNCE  = 500;\n\n/** Node count thresholds that gate optimisation strategies. */\nexport const NODE_COUNT_THRESHOLDS = {\n  SPATIAL_INDEX_MIN:    100,\n  VIEWPORT_CULLING_MIN: 500,\n  CANVAS_RENDERING_MIN: 2000,\n  DOM_RENDERING_MAX:    5000,\n} as const;\n\n/** Viewport buffer configuration. */\nexport const VIEWPORT_CONFIG = {\n  BUFFER_PERCENT:   0.2,\n  MIN_VISIBLE_NODES: 10,\n} as const;\n"],"mappings":";AAIO,IAAM,aAA6B;AACnC,IAAM,wBAA6B;AACnC,IAAM,yBAA6B;AACnC,IAAM,oBAA6B,MAAO;AAC1C,IAAM,iBAA6B;AAGnC,IAAM,cAAc;AAAA,EACzB,SAAmB;AAAA,EACnB,aAAmB;AAAA,EACnB,mBAAmB;AACrB;AAIO,IAAM,oBAAoB;AAAA,EAC/B,oBAAuB;AAAA,EACvB,oBAAuB;AAAA,EACvB,mBAAuB;AAAA,EACvB,gBAAuB;AAAA,EACvB,iBAAuB;AAAA,EACvB,mBAAuB;AAAA,EACvB,qBAAuB;AACzB;AAIO,IAAM,mBAAqB;AAC3B,IAAM,oBAAqB;AAC3B,IAAM,qBAAqB;AAE3B,IAAM,gBAAgB;AAAA,EAC3B,eAAqB;AAAA,EACrB,oBAAqB;AAAA,EACrB,mBAAqB;AACvB;AAIO,IAAM,kBAA2B;AACjC,IAAM,oBAA2B;AACjC,IAAM,4BAA4B;AAIlC,IAAM,oBAA2B;AACjC,IAAM,6BAA6B;AAInC,IAAM,iBAAoB;AAC1B,IAAM,cAAoB;AAC1B,IAAM,eAAoB;AAC1B,IAAM,aAAoB;AAC1B,IAAM,mBAAoB;AAI1B,IAAM,gBAAwB;AAC9B,IAAM,sBAAwB;AAC9B,IAAM,wBAAwB;AAE9B,IAAM,iBAAsB;AAC5B,IAAM,qBAAsB;AAC5B,IAAM,oBAAsB;AAC5B,IAAM,qBAAsB;AAI5B,IAAM,WAAwB;AAC9B,IAAM,WAAwB;AAC9B,IAAM,eAAwB;AAC9B,IAAM,YAAwB;AAC9B,IAAM,yBAAyB;AAE/B,IAAM,wBAAyB;AAC/B,IAAM,yBAAyB;AAC/B,IAAM,6BAA6B;AAInC,IAAM,eAAe;AAAA,EAC1B,SAAc;AAAA,EACd,cAAc;AAAA,EACd,YAAc;AAAA,EACd,aAAc;AAAA,EACd,cAAc;AAChB;AAEO,IAAM,iBAAiB;AAAA,EAC5B,SAAc;AAAA,EACd,cAAc;AAAA,EACd,YAAc;AAAA,EACd,aAAc;AAAA,EACd,cAAc;AAChB;AAEO,IAAM,cAAc;AAAA,EACzB,SAAc;AAAA,EACd,cAAc;AAAA,EACd,YAAc;AAAA,EACd,aAAc;AAAA,EACd,cAAc;AAChB;AAIO,IAAM,oBAA6B;AACnC,IAAM,sBAA6B;AACnC,IAAM,wBAA6B;AACnC,IAAM,6BAA6B;AAInC,IAAM,0BAA6B;AACnC,IAAM,wBAA6B;AACnC,IAAM,2BAA6B;AAInC,IAAM,uBAAwB;AAC9B,IAAM,wBAAwB;AAI9B,IAAM,kBAAuB;AAC7B,IAAM,qBAAuB;AAC7B,IAAM,sBAAuB;AAI7B,IAAM,YAA+B;AACrC,IAAM,+BAA+B;AAIrC,IAAM,kBAAmB;AACzB,IAAM,kBAAmB;AACzB,IAAM,kBAAmB;AAGzB,IAAM,wBAAwB;AAAA,EACnC,mBAAsB;AAAA,EACtB,sBAAsB;AAAA,EACtB,sBAAsB;AAAA,EACtB,mBAAsB;AACxB;AAGO,IAAM,kBAAkB;AAAA,EAC7B,gBAAkB;AAAA,EAClB,mBAAmB;AACrB;","names":[]}

package/dist/chunk-LI3BVD6H.js

@@ -0,0 +1,98 @@
+// src/layout/layoutUtils.ts
+function getNodeBounds(node) {
+  const baseWidth = Math.max(120, node.title.length * 8 + 40);
+  const baseHeight = Math.max(40, 32 + 16);
+  const padding = 20;
+  return {
+    x: node.x - baseWidth / 2 - padding,
+    y: node.y - baseHeight / 2 - padding,
+    width: baseWidth + padding * 2,
+    height: baseHeight + padding * 2
+  };
+}
+function checkCollision(box1, box2) {
+  return !(box1.x + box1.width < box2.x || box2.x + box2.width < box1.x || box1.y + box1.height < box2.y || box2.y + box2.height < box1.y);
+}
+function resolveCollisions(nodes, maxIterations = 10) {
+  const result = [...nodes];
+  for (let iter = 0; iter < maxIterations; iter++) {
+    let hasCollisions = false;
+    const byLevel = result.reduce((acc, n) => {
+      var _a;
+      (acc[_a = n.level] ?? (acc[_a] = [])).push(n);
+      return acc;
+    }, {});
+    for (const levelNodes of Object.values(byLevel)) {
+      for (let i = 0; i < levelNodes.length; i++) {
+        for (let j = i + 1; j < levelNodes.length; j++) {
+          const n1 = levelNodes[i];
+          const n2 = levelNodes[j];
+          if (!checkCollision(getNodeBounds(n1), getNodeBounds(n2))) continue;
+          hasCollisions = true;
+          const dx = n2.x - n1.x;
+          const dy = n2.y - n1.y;
+          const dist = Math.sqrt(dx * dx + dy * dy);
+          if (dist < 1) {
+            n2.x += 100;
+          } else {
+            const b1 = getNodeBounds(n1);
+            const b2 = getNodeBounds(n2);
+            const minSep = (b1.width + b2.width) / 2;
+            const overlap = minSep - dist + 20;
+            if (overlap > 0) {
+              const move = overlap / 2;
+              n1.x -= dx / dist * move;
+              n1.y -= dy / dist * move;
+              n2.x += dx / dist * move;
+              n2.y += dy / dist * move;
+            }
+          }
+        }
+      }
+    }
+    if (!hasCollisions) break;
+  }
+  return result;
+}
+function optimizeLayout(nodes) {
+  const result = [...nodes];
+  const iterations = 5;
+  const repulsion = 1e3;
+  const damp = 0.8;
+  for (let iter = 0; iter < iterations; iter++) {
+    const forces = /* @__PURE__ */ new Map();
+    result.forEach((n) => forces.set(n.id, { x: 0, y: 0 }));
+    for (let i = 0; i < result.length; i++) {
+      for (let j = i + 1; j < result.length; j++) {
+        const n1 = result[i];
+        const n2 = result[j];
+        if (n1.level !== n2.level) continue;
+        const dx = n2.x - n1.x;
+        const dy = n2.y - n1.y;
+        const dist = Math.sqrt(dx * dx + dy * dy);
+        if (dist <= 0 || dist >= 300) continue;
+        const force = repulsion / (dist * dist);
+        const f1 = forces.get(n1.id);
+        const f2 = forces.get(n2.id);
+        f1.x -= dx / dist * force;
+        f1.y -= dy / dist * force;
+        f2.x += dx / dist * force;
+        f2.y += dy / dist * force;
+      }
+    }
+    result.forEach((n) => {
+      const f = forces.get(n.id);
+      n.x += f.x * damp;
+      n.y += f.y * damp;
+    });
+  }
+  return resolveCollisions(result);
+}
+
+export {
+  getNodeBounds,
+  checkCollision,
+  resolveCollisions,
+  optimizeLayout
+};
+//# sourceMappingURL=chunk-LI3BVD6H.js.map

package/dist/chunk-LI3BVD6H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/layout/layoutUtils.ts"],"sourcesContent":["// ─── Layout Utilities ─────────────────────────────────────────────────────────\n//\n// Collision detection and force-based positioning for MindMapNode trees.\n\nimport type { MindMapNode } from '../types/mindmap.js';\n\nexport interface CollisionBox {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\n/** Axis-aligned bounding box for a node, expanded by a fixed padding. */\nexport function getNodeBounds(node: MindMapNode): CollisionBox {\n  const baseWidth = Math.max(120, node.title.length * 8 + 40);\n  const baseHeight = Math.max(40, 32 + 16);\n  const padding = 20;\n  return {\n    x: node.x - baseWidth / 2 - padding,\n    y: node.y - baseHeight / 2 - padding,\n    width: baseWidth + padding * 2,\n    height: baseHeight + padding * 2,\n  };\n}\n\nexport function checkCollision(box1: CollisionBox, box2: CollisionBox): boolean {\n  return !(\n    box1.x + box1.width < box2.x ||\n    box2.x + box2.width < box1.x ||\n    box1.y + box1.height < box2.y ||\n    box2.y + box2.height < box1.y\n  );\n}\n\n/**\n * Iteratively resolve bounding-box collisions within each level.\n * Nodes are pushed apart symmetrically until no overlaps remain\n * or `maxIterations` is reached.\n */\nexport function resolveCollisions(nodes: MindMapNode[], maxIterations = 10): MindMapNode[] {\n  const result = [...nodes];\n\n  for (let iter = 0; iter < maxIterations; iter++) {\n    let hasCollisions = false;\n\n    const byLevel = result.reduce<Record<number, MindMapNode[]>>((acc, n) => {\n      (acc[n.level] ??= []).push(n);\n      return acc;\n    }, {});\n\n    for (const levelNodes of Object.values(byLevel)) {\n      for (let i = 0; i < levelNodes.length; i++) {\n        for (let j = i + 1; j < levelNodes.length; j++) {\n          const n1 = levelNodes[i];\n          const n2 = levelNodes[j];\n          if (!checkCollision(getNodeBounds(n1), getNodeBounds(n2))) continue;\n\n          hasCollisions = true;\n          const dx = n2.x - n1.x;\n          const dy = n2.y - n1.y;\n          const dist = Math.sqrt(dx * dx + dy * dy);\n\n          if (dist < 1) {\n            n2.x += 100;\n          } else {\n            const b1 = getNodeBounds(n1);\n            const b2 = getNodeBounds(n2);\n            const minSep = (b1.width + b2.width) / 2;\n            const overlap = minSep - dist + 20;\n            if (overlap > 0) {\n              const move = overlap / 2;\n              n1.x -= (dx / dist) * move;\n              n1.y -= (dy / dist) * move;\n              n2.x += (dx / dist) * move;\n              n2.y += (dy / dist) * move;\n            }\n          }\n        }\n      }\n    }\n\n    if (!hasCollisions) break;\n  }\n\n  return result;\n}\n\n/**\n * Apply a lightweight repulsive force between same-level nodes that are\n * closer than 300 px, then resolve remaining collisions.\n */\nexport function optimizeLayout(nodes: MindMapNode[]): MindMapNode[] {\n  const result = [...nodes];\n  const iterations = 5;\n  const repulsion = 1000;\n  const damp = 0.8;\n\n  for (let iter = 0; iter < iterations; iter++) {\n    const forces = new Map<string, { x: number; y: number }>();\n    result.forEach(n => forces.set(n.id, { x: 0, y: 0 }));\n\n    for (let i = 0; i < result.length; i++) {\n      for (let j = i + 1; j < result.length; j++) {\n        const n1 = result[i];\n        const n2 = result[j];\n        if (n1.level !== n2.level) continue;\n\n        const dx = n2.x - n1.x;\n        const dy = n2.y - n1.y;\n        const dist = Math.sqrt(dx * dx + dy * dy);\n        if (dist <= 0 || dist >= 300) continue;\n\n        const force = repulsion / (dist * dist);\n        const f1 = forces.get(n1.id)!;\n        const f2 = forces.get(n2.id)!;\n        f1.x -= (dx / dist) * force;\n        f1.y -= (dy / dist) * force;\n        f2.x += (dx / dist) * force;\n        f2.y += (dy / dist) * force;\n      }\n    }\n\n    result.forEach(n => {\n      const f = forces.get(n.id)!;\n      n.x += f.x * damp;\n      n.y += f.y * damp;\n    });\n  }\n\n  return resolveCollisions(result);\n}\n"],"mappings":";AAcO,SAAS,cAAc,MAAiC;AAC7D,QAAM,YAAY,KAAK,IAAI,KAAK,KAAK,MAAM,SAAS,IAAI,EAAE;AAC1D,QAAM,aAAa,KAAK,IAAI,IAAI,KAAK,EAAE;AACvC,QAAM,UAAU;AAChB,SAAO;AAAA,IACL,GAAG,KAAK,IAAI,YAAY,IAAI;AAAA,IAC5B,GAAG,KAAK,IAAI,aAAa,IAAI;AAAA,IAC7B,OAAO,YAAY,UAAU;AAAA,IAC7B,QAAQ,aAAa,UAAU;AAAA,EACjC;AACF;AAEO,SAAS,eAAe,MAAoB,MAA6B;AAC9E,SAAO,EACL,KAAK,IAAI,KAAK,QAAQ,KAAK,KAC3B,KAAK,IAAI,KAAK,QAAQ,KAAK,KAC3B,KAAK,IAAI,KAAK,SAAS,KAAK,KAC5B,KAAK,IAAI,KAAK,SAAS,KAAK;AAEhC;AAOO,SAAS,kBAAkB,OAAsB,gBAAgB,IAAmB;AACzF,QAAM,SAAS,CAAC,GAAG,KAAK;AAExB,WAAS,OAAO,GAAG,OAAO,eAAe,QAAQ;AAC/C,QAAI,gBAAgB;AAEpB,UAAM,UAAU,OAAO,OAAsC,CAAC,KAAK,MAAM;AA9C7E;AA+CM,OAAC,SAAI,EAAE,WAAN,UAAiB,CAAC,IAAG,KAAK,CAAC;AAC5B,aAAO;AAAA,IACT,GAAG,CAAC,CAAC;AAEL,eAAW,cAAc,OAAO,OAAO,OAAO,GAAG;AAC/C,eAAS,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;AAC1C,iBAAS,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;AAC9C,gBAAM,KAAK,WAAW,CAAC;AACvB,gBAAM,KAAK,WAAW,CAAC;AACvB,cAAI,CAAC,eAAe,cAAc,EAAE,GAAG,cAAc,EAAE,CAAC,EAAG;AAE3D,0BAAgB;AAChB,gBAAM,KAAK,GAAG,IAAI,GAAG;AACrB,gBAAM,KAAK,GAAG,IAAI,GAAG;AACrB,gBAAM,OAAO,KAAK,KAAK,KAAK,KAAK,KAAK,EAAE;AAExC,cAAI,OAAO,GAAG;AACZ,eAAG,KAAK;AAAA,UACV,OAAO;AACL,kBAAM,KAAK,cAAc,EAAE;AAC3B,kBAAM,KAAK,cAAc,EAAE;AAC3B,kBAAM,UAAU,GAAG,QAAQ,GAAG,SAAS;AACvC,kBAAM,UAAU,SAAS,OAAO;AAChC,gBAAI,UAAU,GAAG;AACf,oBAAM,OAAO,UAAU;AACvB,iBAAG,KAAM,KAAK,OAAQ;AACtB,iBAAG,KAAM,KAAK,OAAQ;AACtB,iBAAG,KAAM,KAAK,OAAQ;AACtB,iBAAG,KAAM,KAAK,OAAQ;AAAA,YACxB;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,QAAI,CAAC,cAAe;AAAA,EACtB;AAEA,SAAO;AACT;AAMO,SAAS,eAAe,OAAqC;AAClE,QAAM,SAAS,CAAC,GAAG,KAAK;AACxB,QAAM,aAAa;AACnB,QAAM,YAAY;AAClB,QAAM,OAAO;AAEb,WAAS,OAAO,GAAG,OAAO,YAAY,QAAQ;AAC5C,UAAM,SAAS,oBAAI,IAAsC;AACzD,WAAO,QAAQ,OAAK,OAAO,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC;AAEpD,aAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,eAAS,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AAC1C,cAAM,KAAK,OAAO,CAAC;AACnB,cAAM,KAAK,OAAO,CAAC;AACnB,YAAI,GAAG,UAAU,GAAG,MAAO;AAE3B,cAAM,KAAK,GAAG,IAAI,GAAG;AACrB,cAAM,KAAK,GAAG,IAAI,GAAG;AACrB,cAAM,OAAO,KAAK,KAAK,KAAK,KAAK,KAAK,EAAE;AACxC,YAAI,QAAQ,KAAK,QAAQ,IAAK;AAE9B,cAAM,QAAQ,aAAa,OAAO;AAClC,cAAM,KAAK,OAAO,IAAI,GAAG,EAAE;AAC3B,cAAM,KAAK,OAAO,IAAI,GAAG,EAAE;AAC3B,WAAG,KAAM,KAAK,OAAQ;AACtB,WAAG,KAAM,KAAK,OAAQ;AACtB,WAAG,KAAM,KAAK,OAAQ;AACtB,WAAG,KAAM,KAAK,OAAQ;AAAA,MACxB;AAAA,IACF;AAEA,WAAO,QAAQ,OAAK;AAClB,YAAM,IAAI,OAAO,IAAI,EAAE,EAAE;AACzB,QAAE,KAAK,EAAE,IAAI;AACb,QAAE,KAAK,EAAE,IAAI;AAAA,IACf,CAAC;AAAA,EACH;AAEA,SAAO,kBAAkB,MAAM;AACjC;","names":[]}

package/dist/chunk-LJYSKSCE.js

@@ -0,0 +1,95 @@
+import {
+  DEFAULT_CANVAS_HEIGHT,
+  DEFAULT_CANVAS_WIDTH,
+  VIEWPORT_MARGIN,
+  ZOOM_MAX,
+  ZOOM_MIN
+} from "./chunk-LDJRGT2Q.js";
+
+// src/viewport/viewportUtils.ts
+function calculateViewportBounds(viewport, canvasWidth = DEFAULT_CANVAS_WIDTH, canvasHeight = DEFAULT_CANVAS_HEIGHT) {
+  const worldW = canvasWidth / viewport.zoomLevel;
+  const worldH = canvasHeight / viewport.zoomLevel;
+  const mx = worldW * VIEWPORT_MARGIN;
+  const my = worldH * VIEWPORT_MARGIN;
+  return {
+    minX: viewport.centerX - worldW / 2 - mx,
+    minY: viewport.centerY - worldH / 2 - my,
+    maxX: viewport.centerX + worldW / 2 + mx,
+    maxY: viewport.centerY + worldH / 2 + my
+  };
+}
+function recalculateViewportBounds(viewport, canvasWidth = DEFAULT_CANVAS_WIDTH, canvasHeight = DEFAULT_CANVAS_HEIGHT) {
+  return {
+    ...viewport,
+    visibleBounds: calculateViewportBounds(viewport, canvasWidth, canvasHeight)
+  };
+}
+function worldToScreen(worldX, worldY, viewport, canvasWidth = DEFAULT_CANVAS_WIDTH, canvasHeight = DEFAULT_CANVAS_HEIGHT) {
+  return {
+    x: (worldX - viewport.centerX) * viewport.zoomLevel + canvasWidth / 2,
+    y: (worldY - viewport.centerY) * viewport.zoomLevel + canvasHeight / 2
+  };
+}
+function screenToWorld(screenX, screenY, viewport, canvasWidth = DEFAULT_CANVAS_WIDTH, canvasHeight = DEFAULT_CANVAS_HEIGHT) {
+  return {
+    x: (screenX - canvasWidth / 2) / viewport.zoomLevel + viewport.centerX,
+    y: (screenY - canvasHeight / 2) / viewport.zoomLevel + viewport.centerY
+  };
+}
+function clampZoom(zoom) {
+  return Math.min(ZOOM_MAX, Math.max(ZOOM_MIN, zoom));
+}
+function panViewport(deltaX, deltaY, viewport) {
+  return {
+    ...viewport,
+    centerX: viewport.centerX - deltaX / viewport.zoomLevel,
+    centerY: viewport.centerY - deltaY / viewport.zoomLevel
+  };
+}
+function setViewportCenter(x, y, viewport) {
+  return { ...viewport, centerX: x, centerY: y };
+}
+function zoomViewport(delta, viewport, pivotX, pivotY, canvasWidth = DEFAULT_CANVAS_WIDTH, canvasHeight = DEFAULT_CANVAS_HEIGHT) {
+  const newZoom = clampZoom(viewport.zoomLevel * (1 + delta));
+  let cx = viewport.centerX;
+  let cy = viewport.centerY;
+  if (pivotX !== void 0 && pivotY !== void 0) {
+    const worldPivot = screenToWorld(pivotX, pivotY, viewport, canvasWidth, canvasHeight);
+    cx = worldPivot.x - (pivotX - canvasWidth / 2) / newZoom;
+    cy = worldPivot.y - (pivotY - canvasHeight / 2) / newZoom;
+  }
+  return { ...viewport, centerX: cx, centerY: cy, zoomLevel: newZoom };
+}
+function focusOnNode(nodeX, nodeY, zoom) {
+  const clamped = clampZoom(zoom);
+  return {
+    centerX: nodeX,
+    centerY: nodeY,
+    zoomLevel: clamped,
+    rotation: 0,
+    visibleBounds: calculateViewportBounds(
+      { centerX: nodeX, centerY: nodeY, zoomLevel: clamped, rotation: 0, visibleBounds: { minX: 0, minY: 0, maxX: 0, maxY: 0 } }
+    )
+  };
+}
+function isNodeInViewport(nodeX, nodeY, nodeWidth, nodeHeight, viewport, canvasWidth = DEFAULT_CANVAS_WIDTH, canvasHeight = DEFAULT_CANVAS_HEIGHT) {
+  const bounds = calculateViewportBounds(viewport, canvasWidth, canvasHeight);
+  const hw = nodeWidth / 2;
+  const hh = nodeHeight / 2;
+  return !(nodeX + hw < bounds.minX || nodeX - hw > bounds.maxX || nodeY + hh < bounds.minY || nodeY - hh > bounds.maxY);
+}
+
+export {
+  calculateViewportBounds,
+  recalculateViewportBounds,
+  worldToScreen,
+  screenToWorld,
+  clampZoom,
+  panViewport,
+  setViewportCenter,
+  zoomViewport,
+  focusOnNode,
+  isNodeInViewport
+};
+//# sourceMappingURL=chunk-LJYSKSCE.js.map

package/dist/chunk-LJYSKSCE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/viewport/viewportUtils.ts"],"sourcesContent":["// ─── Viewport Utilities ───────────────────────────────────────────────────────\n//\n// Pure functions for viewport bounds calculation, coordinate transforms,\n// pan/zoom operations, and node visibility queries.\n\nimport type { ViewportState } from '../types/mindmap.js';\nimport {\n  VIEWPORT_MARGIN,\n  DEFAULT_CANVAS_WIDTH,\n  DEFAULT_CANVAS_HEIGHT,\n  ZOOM_MIN,\n  ZOOM_MAX,\n} from '../constants/performanceConstants.js';\n\n// ── Viewport Bounds ───────────────────────────────────────────────────────────\n\nexport interface WorldBounds {\n  minX: number;\n  minY: number;\n  maxX: number;\n  maxY: number;\n}\n\n/**\n * Calculate the visible world-space bounding box including a margin buffer.\n */\nexport function calculateViewportBounds(\n  viewport: ViewportState,\n  canvasWidth  = DEFAULT_CANVAS_WIDTH,\n  canvasHeight = DEFAULT_CANVAS_HEIGHT,\n): WorldBounds {\n  const worldW = canvasWidth  / viewport.zoomLevel;\n  const worldH = canvasHeight / viewport.zoomLevel;\n  const mx = worldW * VIEWPORT_MARGIN;\n  const my = worldH * VIEWPORT_MARGIN;\n  return {\n    minX: viewport.centerX - worldW / 2 - mx,\n    minY: viewport.centerY - worldH / 2 - my,\n    maxX: viewport.centerX + worldW / 2 + mx,\n    maxY: viewport.centerY + worldH / 2 + my,\n  };\n}\n\n/**\n * Return a new ViewportState with `visibleBounds` recalculated.\n */\nexport function recalculateViewportBounds(\n  viewport: ViewportState,\n  canvasWidth  = DEFAULT_CANVAS_WIDTH,\n  canvasHeight = DEFAULT_CANVAS_HEIGHT,\n): ViewportState {\n  return {\n    ...viewport,\n    visibleBounds: calculateViewportBounds(viewport, canvasWidth, canvasHeight),\n  };\n}\n\n// ── Coordinate Transforms ─────────────────────────────────────────────────────\n\n/**\n * Convert world-space coordinates to screen-space pixel coordinates.\n */\nexport function worldToScreen(\n  worldX: number,\n  worldY: number,\n  viewport: ViewportState,\n  canvasWidth  = DEFAULT_CANVAS_WIDTH,\n  canvasHeight = DEFAULT_CANVAS_HEIGHT,\n): { x: number; y: number } {\n  return {\n    x: (worldX - viewport.centerX) * viewport.zoomLevel + canvasWidth  / 2,\n    y: (worldY - viewport.centerY) * viewport.zoomLevel + canvasHeight / 2,\n  };\n}\n\n/**\n * Convert screen-space pixel coordinates to world-space coordinates.\n */\nexport function screenToWorld(\n  screenX: number,\n  screenY: number,\n  viewport: ViewportState,\n  canvasWidth  = DEFAULT_CANVAS_WIDTH,\n  canvasHeight = DEFAULT_CANVAS_HEIGHT,\n): { x: number; y: number } {\n  return {\n    x: (screenX - canvasWidth  / 2) / viewport.zoomLevel + viewport.centerX,\n    y: (screenY - canvasHeight / 2) / viewport.zoomLevel + viewport.centerY,\n  };\n}\n\n// ── Pan / Zoom ────────────────────────────────────────────────────────────────\n\n/** Clamp zoom to [ZOOM_MIN, ZOOM_MAX]. */\nexport function clampZoom(zoom: number): number {\n  return Math.min(ZOOM_MAX, Math.max(ZOOM_MIN, zoom));\n}\n\n/**\n * Pan the viewport by a screen-space delta (positive = right/down).\n */\nexport function panViewport(\n  deltaX: number,\n  deltaY: number,\n  viewport: ViewportState,\n): ViewportState {\n  return {\n    ...viewport,\n    centerX: viewport.centerX - deltaX / viewport.zoomLevel,\n    centerY: viewport.centerY - deltaY / viewport.zoomLevel,\n  };\n}\n\n/** Teleport the viewport centre to the given world coordinates. */\nexport function setViewportCenter(\n  x: number,\n  y: number,\n  viewport: ViewportState,\n): ViewportState {\n  return { ...viewport, centerX: x, centerY: y };\n}\n\n/**\n * Zoom the viewport by a multiplicative delta, optionally around a pivot point.\n *\n * @param delta   - Multiplier delta, e.g. 0.1 for +10% zoom\n * @param pivotX  - Optional screen-space X pivot\n * @param pivotY  - Optional screen-space Y pivot\n */\nexport function zoomViewport(\n  delta: number,\n  viewport: ViewportState,\n  pivotX?: number,\n  pivotY?: number,\n  canvasWidth  = DEFAULT_CANVAS_WIDTH,\n  canvasHeight = DEFAULT_CANVAS_HEIGHT,\n): ViewportState {\n  const newZoom = clampZoom(viewport.zoomLevel * (1 + delta));\n\n  let cx = viewport.centerX;\n  let cy = viewport.centerY;\n\n  if (pivotX !== undefined && pivotY !== undefined) {\n    const worldPivot = screenToWorld(pivotX, pivotY, viewport, canvasWidth, canvasHeight);\n    cx = worldPivot.x - (pivotX - canvasWidth  / 2) / newZoom;\n    cy = worldPivot.y - (pivotY - canvasHeight / 2) / newZoom;\n  }\n\n  return { ...viewport, centerX: cx, centerY: cy, zoomLevel: newZoom };\n}\n\n/**\n * Create a viewport centred on a node (world coordinates) at the given zoom level.\n */\nexport function focusOnNode(\n  nodeX: number,\n  nodeY: number,\n  zoom: number,\n): ViewportState {\n  const clamped = clampZoom(zoom);\n  return {\n    centerX:  nodeX,\n    centerY:  nodeY,\n    zoomLevel: clamped,\n    rotation: 0,\n    visibleBounds: calculateViewportBounds(\n      { centerX: nodeX, centerY: nodeY, zoomLevel: clamped, rotation: 0, visibleBounds: { minX: 0, minY: 0, maxX: 0, maxY: 0 } },\n    ),\n  };\n}\n\n// ── Visibility ────────────────────────────────────────────────────────────────\n\n/**\n * Test whether a world-space AABB intersects the viewport's visible bounds.\n */\nexport function isNodeInViewport(\n  nodeX: number,\n  nodeY: number,\n  nodeWidth: number,\n  nodeHeight: number,\n  viewport: ViewportState,\n  canvasWidth  = DEFAULT_CANVAS_WIDTH,\n  canvasHeight = DEFAULT_CANVAS_HEIGHT,\n): boolean {\n  const bounds = calculateViewportBounds(viewport, canvasWidth, canvasHeight);\n  const hw = nodeWidth  / 2;\n  const hh = nodeHeight / 2;\n  return !(\n    nodeX + hw < bounds.minX ||\n    nodeX - hw > bounds.maxX ||\n    nodeY + hh < bounds.minY ||\n    nodeY - hh > bounds.maxY\n  );\n}\n"],"mappings":";;;;;;;;;AA0BO,SAAS,wBACd,UACA,cAAe,sBACf,eAAe,uBACF;AACb,QAAM,SAAS,cAAe,SAAS;AACvC,QAAM,SAAS,eAAe,SAAS;AACvC,QAAM,KAAK,SAAS;AACpB,QAAM,KAAK,SAAS;AACpB,SAAO;AAAA,IACL,MAAM,SAAS,UAAU,SAAS,IAAI;AAAA,IACtC,MAAM,SAAS,UAAU,SAAS,IAAI;AAAA,IACtC,MAAM,SAAS,UAAU,SAAS,IAAI;AAAA,IACtC,MAAM,SAAS,UAAU,SAAS,IAAI;AAAA,EACxC;AACF;AAKO,SAAS,0BACd,UACA,cAAe,sBACf,eAAe,uBACA;AACf,SAAO;AAAA,IACL,GAAG;AAAA,IACH,eAAe,wBAAwB,UAAU,aAAa,YAAY;AAAA,EAC5E;AACF;AAOO,SAAS,cACd,QACA,QACA,UACA,cAAe,sBACf,eAAe,uBACW;AAC1B,SAAO;AAAA,IACL,IAAI,SAAS,SAAS,WAAW,SAAS,YAAY,cAAe;AAAA,IACrE,IAAI,SAAS,SAAS,WAAW,SAAS,YAAY,eAAe;AAAA,EACvE;AACF;AAKO,SAAS,cACd,SACA,SACA,UACA,cAAe,sBACf,eAAe,uBACW;AAC1B,SAAO;AAAA,IACL,IAAI,UAAU,cAAe,KAAK,SAAS,YAAY,SAAS;AAAA,IAChE,IAAI,UAAU,eAAe,KAAK,SAAS,YAAY,SAAS;AAAA,EAClE;AACF;AAKO,SAAS,UAAU,MAAsB;AAC9C,SAAO,KAAK,IAAI,UAAU,KAAK,IAAI,UAAU,IAAI,CAAC;AACpD;AAKO,SAAS,YACd,QACA,QACA,UACe;AACf,SAAO;AAAA,IACL,GAAG;AAAA,IACH,SAAS,SAAS,UAAU,SAAS,SAAS;AAAA,IAC9C,SAAS,SAAS,UAAU,SAAS,SAAS;AAAA,EAChD;AACF;AAGO,SAAS,kBACd,GACA,GACA,UACe;AACf,SAAO,EAAE,GAAG,UAAU,SAAS,GAAG,SAAS,EAAE;AAC/C;AASO,SAAS,aACd,OACA,UACA,QACA,QACA,cAAe,sBACf,eAAe,uBACA;AACf,QAAM,UAAU,UAAU,SAAS,aAAa,IAAI,MAAM;AAE1D,MAAI,KAAK,SAAS;AAClB,MAAI,KAAK,SAAS;AAElB,MAAI,WAAW,UAAa,WAAW,QAAW;AAChD,UAAM,aAAa,cAAc,QAAQ,QAAQ,UAAU,aAAa,YAAY;AACpF,SAAK,WAAW,KAAK,SAAS,cAAe,KAAK;AAClD,SAAK,WAAW,KAAK,SAAS,eAAe,KAAK;AAAA,EACpD;AAEA,SAAO,EAAE,GAAG,UAAU,SAAS,IAAI,SAAS,IAAI,WAAW,QAAQ;AACrE;AAKO,SAAS,YACd,OACA,OACA,MACe;AACf,QAAM,UAAU,UAAU,IAAI;AAC9B,SAAO;AAAA,IACL,SAAU;AAAA,IACV,SAAU;AAAA,IACV,WAAW;AAAA,IACX,UAAU;AAAA,IACV,eAAe;AAAA,MACb,EAAE,SAAS,OAAO,SAAS,OAAO,WAAW,SAAS,UAAU,GAAG,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,EAAE;AAAA,IAC3H;AAAA,EACF;AACF;AAOO,SAAS,iBACd,OACA,OACA,WACA,YACA,UACA,cAAe,sBACf,eAAe,uBACN;AACT,QAAM,SAAS,wBAAwB,UAAU,aAAa,YAAY;AAC1E,QAAM,KAAK,YAAa;AACxB,QAAM,KAAK,aAAa;AACxB,SAAO,EACL,QAAQ,KAAK,OAAO,QACpB,QAAQ,KAAK,OAAO,QACpB,QAAQ,KAAK,OAAO,QACpB,QAAQ,KAAK,OAAO;AAExB;","names":[]}