@visualli/core 0.1.5 → 0.1.6

package/dist/performance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types/index.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types/index.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=index.cjs.map

package/dist/types/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["// ─── Types Barrel Export ───────────────────────────────────────────────────────\n\nexport * from './mindmap.js';\nexport * from './meta.js';\nexport * from './layer.js';\nexport * from './document.js';\n// Re-export schema types for external use\nexport {\n  type Meta,\n  type Node,\n  type Container,\n  type Layer,\n  type Connection,\n  type Extension,\n  type VisualliFragment,\n} from './schema.js';\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types/index.d.cts

@@ -0,0 +1,8 @@
+export { F as FlatNode, a as MindMapConfig, M as MindMapConnection, b as MindMapData, c as MindMapNode, d as NodeMap, N as NodeSelection, R as RenderConfig, S as SpatialBounds, T as TopLevelConnection, V as ViewportState } from '../mindmap-DWS0WZT_.cjs';
+export { L as LayerConnection, b as LayerContainer, c as LayerNode, V as VisualliDocument, a as VisualliLayer, d as VisualliMeta, e as VisualliRenderConnection, f as VisualliRenderNode } from '../document-B3hnNr-F.cjs';
+import { Meta, Layer } from '@visualli/bindings';
+export { Connection, Container, Extension, Layer, Meta, Node } from '@visualli/bindings';
+
+type VisualliFragment = Meta | Layer;
+
+export type { VisualliFragment };

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+export { F as FlatNode, a as MindMapConfig, M as MindMapConnection, b as MindMapData, c as MindMapNode, d as NodeMap, N as NodeSelection, R as RenderConfig, S as SpatialBounds, T as TopLevelConnection, V as ViewportState } from '../mindmap-DWS0WZT_.js';
+export { L as LayerConnection, b as LayerContainer, c as LayerNode, V as VisualliDocument, a as VisualliLayer, d as VisualliMeta, e as VisualliRenderConnection, f as VisualliRenderNode } from '../document-B3hnNr-F.js';
+import { Meta, Layer } from '@visualli/bindings';
+export { Connection, Container, Extension, Layer, Meta, Node } from '@visualli/bindings';
+
+type VisualliFragment = Meta | Layer;
+
+export type { VisualliFragment };

package/dist/types/index.js

@@ -0,0 +1,2 @@
+import "../chunk-VLGR5PZX.js";
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/viewport/index.cjs

@@ -0,0 +1,131 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/viewport/index.ts
+var viewport_exports = {};
+__export(viewport_exports, {
+  calculateViewportBounds: () => calculateViewportBounds,
+  clampZoom: () => clampZoom,
+  focusOnNode: () => focusOnNode,
+  isNodeInViewport: () => isNodeInViewport,
+  panViewport: () => panViewport,
+  recalculateViewportBounds: () => recalculateViewportBounds,
+  screenToWorld: () => screenToWorld,
+  setViewportCenter: () => setViewportCenter,
+  worldToScreen: () => worldToScreen,
+  zoomViewport: () => zoomViewport
+});
+module.exports = __toCommonJS(viewport_exports);
+
+// src/constants/performanceConstants.ts
+var FPS_TARGET = 60;
+var TARGET_FRAME_TIME = 1e3 / FPS_TARGET;
+var VIEWPORT_MARGIN = 0.1;
+var ZOOM_MIN = 0.05;
+var ZOOM_MAX = 5;
+var DEFAULT_CANVAS_WIDTH = 1920;
+var DEFAULT_CANVAS_HEIGHT = 1080;
+
+// 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);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  calculateViewportBounds,
+  clampZoom,
+  focusOnNode,
+  isNodeInViewport,
+  panViewport,
+  recalculateViewportBounds,
+  screenToWorld,
+  setViewportCenter,
+  worldToScreen,
+  zoomViewport
+});
+//# sourceMappingURL=index.cjs.map

package/dist/viewport/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/viewport/index.ts","../../src/constants/performanceConstants.ts","../../src/viewport/viewportUtils.ts"],"sourcesContent":["export * from './viewportUtils.js';\n","// ─── 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","// ─── 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":"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","names":[]}

package/dist/viewport/index.d.cts

@@ -0,0 +1,56 @@
+import { V as ViewportState } from '../mindmap-DWS0WZT_.cjs';
+
+interface WorldBounds {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+/**
+ * Calculate the visible world-space bounding box including a margin buffer.
+ */
+declare function calculateViewportBounds(viewport: ViewportState, canvasWidth?: number, canvasHeight?: number): WorldBounds;
+/**
+ * Return a new ViewportState with `visibleBounds` recalculated.
+ */
+declare function recalculateViewportBounds(viewport: ViewportState, canvasWidth?: number, canvasHeight?: number): ViewportState;
+/**
+ * Convert world-space coordinates to screen-space pixel coordinates.
+ */
+declare function worldToScreen(worldX: number, worldY: number, viewport: ViewportState, canvasWidth?: number, canvasHeight?: number): {
+    x: number;
+    y: number;
+};
+/**
+ * Convert screen-space pixel coordinates to world-space coordinates.
+ */
+declare function screenToWorld(screenX: number, screenY: number, viewport: ViewportState, canvasWidth?: number, canvasHeight?: number): {
+    x: number;
+    y: number;
+};
+/** Clamp zoom to [ZOOM_MIN, ZOOM_MAX]. */
+declare function clampZoom(zoom: number): number;
+/**
+ * Pan the viewport by a screen-space delta (positive = right/down).
+ */
+declare function panViewport(deltaX: number, deltaY: number, viewport: ViewportState): ViewportState;
+/** Teleport the viewport centre to the given world coordinates. */
+declare function setViewportCenter(x: number, y: number, viewport: ViewportState): ViewportState;
+/**
+ * Zoom the viewport by a multiplicative delta, optionally around a pivot point.
+ *
+ * @param delta   - Multiplier delta, e.g. 0.1 for +10% zoom
+ * @param pivotX  - Optional screen-space X pivot
+ * @param pivotY  - Optional screen-space Y pivot
+ */
+declare function zoomViewport(delta: number, viewport: ViewportState, pivotX?: number, pivotY?: number, canvasWidth?: number, canvasHeight?: number): ViewportState;
+/**
+ * Create a viewport centred on a node (world coordinates) at the given zoom level.
+ */
+declare function focusOnNode(nodeX: number, nodeY: number, zoom: number): ViewportState;
+/**
+ * Test whether a world-space AABB intersects the viewport's visible bounds.
+ */
+declare function isNodeInViewport(nodeX: number, nodeY: number, nodeWidth: number, nodeHeight: number, viewport: ViewportState, canvasWidth?: number, canvasHeight?: number): boolean;
+
+export { type WorldBounds, calculateViewportBounds, clampZoom, focusOnNode, isNodeInViewport, panViewport, recalculateViewportBounds, screenToWorld, setViewportCenter, worldToScreen, zoomViewport };

package/dist/viewport/index.d.ts

@@ -0,0 +1,56 @@
+import { V as ViewportState } from '../mindmap-DWS0WZT_.js';
+
+interface WorldBounds {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+/**
+ * Calculate the visible world-space bounding box including a margin buffer.
+ */
+declare function calculateViewportBounds(viewport: ViewportState, canvasWidth?: number, canvasHeight?: number): WorldBounds;
+/**
+ * Return a new ViewportState with `visibleBounds` recalculated.
+ */
+declare function recalculateViewportBounds(viewport: ViewportState, canvasWidth?: number, canvasHeight?: number): ViewportState;
+/**
+ * Convert world-space coordinates to screen-space pixel coordinates.
+ */
+declare function worldToScreen(worldX: number, worldY: number, viewport: ViewportState, canvasWidth?: number, canvasHeight?: number): {
+    x: number;
+    y: number;
+};
+/**
+ * Convert screen-space pixel coordinates to world-space coordinates.
+ */
+declare function screenToWorld(screenX: number, screenY: number, viewport: ViewportState, canvasWidth?: number, canvasHeight?: number): {
+    x: number;
+    y: number;
+};
+/** Clamp zoom to [ZOOM_MIN, ZOOM_MAX]. */
+declare function clampZoom(zoom: number): number;
+/**
+ * Pan the viewport by a screen-space delta (positive = right/down).
+ */
+declare function panViewport(deltaX: number, deltaY: number, viewport: ViewportState): ViewportState;
+/** Teleport the viewport centre to the given world coordinates. */
+declare function setViewportCenter(x: number, y: number, viewport: ViewportState): ViewportState;
+/**
+ * Zoom the viewport by a multiplicative delta, optionally around a pivot point.
+ *
+ * @param delta   - Multiplier delta, e.g. 0.1 for +10% zoom
+ * @param pivotX  - Optional screen-space X pivot
+ * @param pivotY  - Optional screen-space Y pivot
+ */
+declare function zoomViewport(delta: number, viewport: ViewportState, pivotX?: number, pivotY?: number, canvasWidth?: number, canvasHeight?: number): ViewportState;
+/**
+ * Create a viewport centred on a node (world coordinates) at the given zoom level.
+ */
+declare function focusOnNode(nodeX: number, nodeY: number, zoom: number): ViewportState;
+/**
+ * Test whether a world-space AABB intersects the viewport's visible bounds.
+ */
+declare function isNodeInViewport(nodeX: number, nodeY: number, nodeWidth: number, nodeHeight: number, viewport: ViewportState, canvasWidth?: number, canvasHeight?: number): boolean;
+
+export { type WorldBounds, calculateViewportBounds, clampZoom, focusOnNode, isNodeInViewport, panViewport, recalculateViewportBounds, screenToWorld, setViewportCenter, worldToScreen, zoomViewport };

package/dist/viewport/index.js

@@ -0,0 +1,26 @@
+import {
+  calculateViewportBounds,
+  clampZoom,
+  focusOnNode,
+  isNodeInViewport,
+  panViewport,
+  recalculateViewportBounds,
+  screenToWorld,
+  setViewportCenter,
+  worldToScreen,
+  zoomViewport
+} from "../chunk-LJYSKSCE.js";
+import "../chunk-LDJRGT2Q.js";
+export {
+  calculateViewportBounds,
+  clampZoom,
+  focusOnNode,
+  isNodeInViewport,
+  panViewport,
+  recalculateViewportBounds,
+  screenToWorld,
+  setViewportCenter,
+  worldToScreen,
+  zoomViewport
+};
+//# sourceMappingURL=index.js.map

package/dist/viewport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visualli/core",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Framework-agnostic core logic, types, and engines for Visualli",
   "repository": {
     "type": "git",
@@ -50,6 +50,11 @@
       "types": "./dist/animations/index.d.ts",
       "import": "./dist/animations/index.js",
       "require": "./dist/animations/index.cjs"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js",
+      "require": "./dist/config/index.cjs"
     }
   },
   "files": [

package/src/config/README.md

@@ -0,0 +1,59 @@
+# Configuration Module
+
+This module exports all configuration constants and utilities for Visualli.
+
+## Usage
+
+### Import all config (from main package)
+```typescript
+import { ALL_BLOB_SHAPES, BlobShape, getBlobTypeForLayer, drawBlobPath } from '@visualli/core';
+```
+
+### Import from config sub-path (recommended for tree-shaking)
+```typescript
+import { ALL_BLOB_SHAPES, BlobShape, getBlobTypeForLayer, drawBlobPath } from '@visualli/core/config';
+```
+
+### Import specific config file
+```typescript
+import { 
+  ALL_BLOB_SHAPES, 
+  BlobShape, 
+  BlobPoint,
+  ACTIVE_BLOB_TYPES,
+  BLOB_LAYER_CONFIG,
+  NODE_LAYER_CONFIG,
+  BLOB_TEXT_OFFSETS,
+  getBlobTypeForLayer,
+  drawBlobPath 
+} from '@visualli/core/config';
+```
+
+## Available Exports
+
+### Blob Shapes (`blobShapes.ts`)
+- **`ALL_BLOB_SHAPES`** - Array of 6 predefined blob shapes (Shape 0-5)
+- **`ACTIVE_BLOB_TYPES`** - Array of active blob type indices
+- **`BLOB_LAYER_CONFIG`** - Configuration for blob rendering layers
+- **`NODE_LAYER_CONFIG`** - Configuration for node layer
+- **`BLOB_TEXT_OFFSETS`** - Text positioning offsets per shape
+- **`getBlobTypeForLayer(level: number)`** - Get blob type for a specific tree level
+- **`drawBlobPath(ctx, radiusX, radiusY, blobType)`** - Draw blob path on canvas
+
+### Text Scaling (`textScaling.ts`)
+- Text scaling configuration utilities
+
+## Adding New Configuration
+
+To add new configuration modules:
+
+1. Create your config file in `src/config/your-config.ts`
+2. Add the export to `src/config/index.ts`:
+   ```typescript
+   export * from './your-config.js';
+   ```
+3. The exports will automatically be available via both:
+   - `@visualli/core` (main barrel)
+   - `@visualli/core/config` (sub-path for better tree-shaking)
+
+No need to update `package.json` or `tsup.config.ts` - they're already configured to handle all config files automatically!