@visualli/core 0.1.6 → 0.2.0

package/dist/chunk-UAMEJG2C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/generated/geometry/interaction.ts","../src/constants/performanceConstants.ts"],"sourcesContent":["// Generated from visualli.ai design-system/components/src/interaction.ts — do not edit here.\n/* How the canvas answers the pointer and the keyboard — the timing and rules behind the peek (an idea's summary)\n   and terms (semantic anchors: an underlined word and its definition card). The look and the pop-in animation live\n   in the CSS (.vi-fact, .vi-anchor, .vi-anchor-card); these are the behaviours, as data, so every renderer (VisualMap,\n   the spec SDK on a canvas) opens and closes them alike. Times in ms. No dependencies, so it can travel alone. */\n\n/** Terms (semantic anchors) in a peek's text. */\nexport const TERM = {\n  /** Hovering the term this long opens its definition card… */ hoverOpen: 250,\n  /** …which closes this long after the pointer leaves both the term and the card (moving between them keeps it open). */ hoverClose: 300,\n  /** Only a mouse opens on hover; touch and pen open on tap. */ hoverPointers: ['mouse'] as readonly string[],\n  /** A click, tap, Enter or Space pins the card open (hovering away doesn't close it); pressing again unpins and closes. */ clickPins: true,\n  /** Escape closes the card and returns focus to the term; a press anywhere outside the term and its card closes it. */ escapeCloses: true, pressOutsideCloses: true,\n  /** Opening by click or keyboard moves focus to the card's first link or button. */ focusCardOnOpen: true,\n  /** The card is kept this far inside the viewport's left and right edges. */ viewportMargin: 8,\n  /** The card's link to a source about the term. */ learnMoreLabel: 'Learn more',\n} as const;\n\n/** The peek: an idea's summary card on hover (pointer) or tap (touch). */\nexport const PEEK = {\n  /** Hovering an idea opens its peek at once; it stays this long after the pointer leaves the idea (and while the\n   *  pointer is over the peek itself), so the pointer can travel from the idea onto the card. */ hoverClose: 180,\n} as const;\n\n/** The touch peek: a bottom sheet with a grip. */\nexport const SHEET = {\n  /** Dragging the grip down this far closes the sheet (or collapses it when expanded); up this far expands it. */ dismissDrag: 80, expandDrag: 40,\n  /** Its height: this share of the map, at most `maxHeight` px; the map pans the chosen idea into the space above it. */ heightRatio: 0.42, maxHeight: 300,\n} as const;\n\n/** Zoom, pan and fit. */\nexport const VIEW = {\n  /** Each zoom step multiplies or divides the zoom by this. */ zoomStep: 1.2,\n  /** Zoom limits (the zoom-min / zoom-max tokens; the build checks they agree). */ zoomMin: 0.3, zoomMax: 5,\n  /** Fit to view never enlarges a layer beyond this. */ fitMax: 1.1,\n} as const;\n\n/** Touch gestures on the map (any touch input — phones, tablets and touchscreen laptops alike; it follows the pointer\n *  in use, not the device, so a mouse or trackpad on the same laptop isn't affected). */\nexport const GESTURE = {\n  /** Two fingers pinch to zoom the map's contents — ideas, connectors, containers and their labels — around the\n   *  point between the fingers, within VIEW's limits. Controls, the depth trail, the peek, chat and the page never scale. */ pinchZoom: true,\n  /** Moving both fingers pans the contents. */ twoFingerPan: true,\n  /** The pointers that pinch (PointerEvent.pointerType). */ pointers: ['touch'] as readonly string[],\n  /** Where the map is the page (an app: AppShell, the mobile app), it takes every touch gesture (touch-action: none),\n   *  so the browser never zooms the page. Embedded on a scrolling page (website, docs), one finger still scrolls the\n   *  page (touch-action: pan-x pan-y); two fingers that land together pinch the map. */ appTouchAction: 'none', embeddedTouchAction: 'pan-x pan-y',\n  /** Zoom never navigates: stepping inside and backing out stay explicit (tap an idea / Step inside, the depth trail,\n   *  Escape or Backspace). */ zoomNavigates: false,\n} as const;\n\n/** The zoom after a pinch: the zoom at the start, scaled by how far the fingers spread, within VIEW's limits. */\nexport function pinchZoom(startZoom: number, startDistance: number, distance: number): number {\n  const z = startZoom * (distance / Math.max(startDistance, 1));\n  return Math.min(VIEW.zoomMax, Math.max(VIEW.zoomMin, z));\n}\n\n/** Keeps the map point that was under `from` under `to` when the scale changes from `s0` to `s1`: the new\n *  translation, given the old one (screen = world × s + t). Used to zoom around the fingers. */\nexport function zoomAround(t0: { x: number; y: number }, s0: number, s1: number, from: { x: number; y: number }, to: { x: number; y: number }): { x: number; y: number } {\n  const wx = (from.x - t0.x) / s0, wy = (from.y - t0.y) / s0;\n  return { x: to.x - wx * s1, y: to.y - wy * s1 };\n}\n\n/** Framing a layer (fit to view): its ideas with room around them, and its container hulls with room for the name pill. */\nexport const FRAME = {\n  /** Room beyond each idea's outline (at least `minPadX` / `minPadY` from its centre). */ clearX: 50, clearY: 46, minPadX: 150, minPadY: 120,\n  /** Room beyond each container hull for its dashed line and the name pill straddling it. */ hullX: 24, hullY: 40,\n} as const;\nexport type FrameBox = { x0: number; y0: number; x1: number; y1: number };\n\n/** The box a layer is framed by: every idea (`rx` / `ry` its half size) and every container hull. */\nexport function layerBounds(ideas: ReadonlyArray<{ x: number; y: number; rx: number; ry: number }>, hulls: ReadonlyArray<FrameBox> = []): FrameBox {\n  let x0 = Infinity, y0 = Infinity, x1 = -Infinity, y1 = -Infinity;\n  for (const n of ideas) {\n    const px = Math.max(FRAME.minPadX, n.rx + FRAME.clearX), py = Math.max(FRAME.minPadY, n.ry + FRAME.clearY);\n    x0 = Math.min(x0, n.x - px); x1 = Math.max(x1, n.x + px); y0 = Math.min(y0, n.y - py); y1 = Math.max(y1, n.y + py);\n  }\n  for (const h of hulls) { x0 = Math.min(x0, h.x0 - FRAME.hullX); x1 = Math.max(x1, h.x1 + FRAME.hullX); y0 = Math.min(y0, h.y0 - FRAME.hullY); y1 = Math.max(y1, h.y1 + FRAME.hullY); }\n  if (!Number.isFinite(x0)) return { x0: -FRAME.minPadX, y0: -FRAME.minPadY, x1: FRAME.minPadX, y1: FRAME.minPadY };\n  return { x0, y0, x1, y1 };\n}\n\n/** Fit to view: the scale that shows `bounds` in an area of `width` × `height` (never beyond VIEW.fitMax), and the\n *  world point to centre. */\nexport function fitView(bounds: FrameBox, width: number, height: number): { scale: number; center: { x: number; y: number } } {\n  const scale = Math.min(width / Math.max(1, bounds.x1 - bounds.x0), height / Math.max(1, bounds.y1 - bounds.y0), VIEW.fitMax);\n  return { scale, center: { x: (bounds.x0 + bounds.x1) / 2, y: (bounds.y0 + bounds.y1) / 2 } };\n}\n\n/** Where the peek card sits (pointer): beside the idea — right of it if it fits, else left — and level with it. */\nexport const PEEK_PLACEMENT = {\n  /** Gap between the idea's outermost ring and the card. */ gap: 16,\n  /** The card's width and the height kept clear below it. */ cardWidth: 300, cardHeight: 220,\n  /** The card is raised this much above the idea's centre. */ raise: 70,\n  /** Kept this far inside the map's edges. */ margin: 12,\n} as const;\n\n/** The peek card's top-left, in map (screen) pixels. `idea`: the idea's centre on screen and its on-screen half\n *  width with its outermost ring (`half`); `box`: the map's size. */\nexport function peekPosition(idea: { x: number; y: number; half: number }, box: { w: number; h: number }, card: { w: number; h: number } = { w: PEEK_PLACEMENT.cardWidth, h: PEEK_PLACEMENT.cardHeight }) {\n  const P = PEEK_PLACEMENT, half = idea.half + P.gap;\n  const right = idea.x + half + card.w < box.w - P.margin;\n  return { left: right ? idea.x + half : Math.max(P.margin, idea.x - half - card.w), top: Math.min(Math.max(P.margin, idea.y - P.raise), box.h - card.h), side: right ? 'right' as const : 'left' as const };\n}\n\n/** The depth trail: each entry shows the idea that was stepped into — its title and a dot in its color (the same\n *  topic or custom color the idea is drawn in, including the sibling-order topic of an uncolored idea). The first\n *  entry is the map itself: a `stone` dot and the home glyph only (`rootLabel: 'icon'`) — no text, since a map's title\n *  usually repeats its centre idea's, which the next entry shows; its accessible name and tooltip are the map's title.\n *  The dot is the idea shape (shapeForLevel). */\nexport const TRAIL = { rootTopic: 'stone', rootLabel: 'icon', homeIconSize: 12, dotBox: 16, dotRadius: 6.4, stroke: 1.25, currentStroke: 1.75 } as const;\n\n/** How an input answers: a mouse hovers (peeks and terms open on hover); touch and pen tap. Null for unknown pointers. */\nexport function pointerModeFor(pointerType: string): 'hover' | 'touch' | null {\n  return pointerType === 'mouse' ? 'hover' : pointerType === 'touch' || pointerType === 'pen' ? 'touch' : null;\n}\n\n/** Whether a pointer of this type opens a term on hover (PointerEvent.pointerType). */\nexport function hoverOpensTerm(pointerType: string): boolean {\n  return TERM.hoverPointers.includes(pointerType);\n}\n","// ─── Performance & Rendering Constants ───────────────────────────────────────\n//\n// Performance budgets and interaction thresholds. Visual values (colours,\n// stroke widths, node size, zoom range) come from the design system tokens.\n\nimport { VIEW } from '../generated/geometry/interaction.js';\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// ── Zoom Constraints ──────────────────────────────────────────────────────────\n\n// Zoom limits: the design system's VIEW (geometry/interaction.ts; equal to the zoom-min / zoom-max tokens).\nexport const ZOOM_MIN              = VIEW.zoomMin;\nexport const ZOOM_MAX              = VIEW.zoomMax;\nexport const ZOOM_DEFAULT          = 1.0;\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":"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","names":[]}

package/dist/{chunk-LJYSKSCE.js → chunk-W2CAOOJJ.js}

@@ -4,7 +4,7 @@ import {
   VIEWPORT_MARGIN,
   ZOOM_MAX,
   ZOOM_MIN
-} from "./chunk-LDJRGT2Q.js";
+} from "./chunk-UAMEJG2C.js";
 
 // src/viewport/viewportUtils.ts
 function calculateViewportBounds(viewport, canvasWidth = DEFAULT_CANVAS_WIDTH, canvasHeight = DEFAULT_CANVAS_HEIGHT) {
@@ -37,8 +37,8 @@ function screenToWorld(screenX, screenY, viewport, canvasWidth = DEFAULT_CANVAS_
     y: (screenY - canvasHeight / 2) / viewport.zoomLevel + viewport.centerY
   };
 }
-function clampZoom(zoom) {
-  return Math.min(ZOOM_MAX, Math.max(ZOOM_MIN, zoom));
+function clampZoom(zoom, fit = 1) {
+  return Math.min(ZOOM_MAX * fit, Math.max(ZOOM_MIN * fit, zoom));
 }
 function panViewport(deltaX, deltaY, viewport) {
   return {
@@ -50,8 +50,8 @@ function panViewport(deltaX, deltaY, viewport) {
 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));
+function zoomViewport(delta, viewport, pivotX, pivotY, canvasWidth = DEFAULT_CANVAS_WIDTH, canvasHeight = DEFAULT_CANVAS_HEIGHT, fit = 1) {
+  const newZoom = clampZoom(viewport.zoomLevel * (1 + delta), fit);
   let cx = viewport.centerX;
   let cy = viewport.centerY;
   if (pivotX !== void 0 && pivotY !== void 0) {
@@ -92,4 +92,4 @@ export {
   focusOnNode,
   isNodeInViewport
 };
-//# sourceMappingURL=chunk-LJYSKSCE.js.map
+//# sourceMappingURL=chunk-W2CAOOJJ.js.map

package/dist/chunk-W2CAOOJJ.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 the design system's limits (VIEW: ZOOM_MIN–ZOOM_MAX), which apply to the zoom relative to the\n *  layer's fit (`fit`: the fit-to-view scale), as in the design system's map (scale = fit × zoom). */\nexport function clampZoom(zoom: number, fit = 1): number {\n  return Math.min(ZOOM_MAX * fit, Math.max(ZOOM_MIN * fit, 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  fit = 1,\n): ViewportState {\n  const newZoom = clampZoom(viewport.zoomLevel * (1 + delta), fit);\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;AAMO,SAAS,UAAU,MAAc,MAAM,GAAW;AACvD,SAAO,KAAK,IAAI,WAAW,KAAK,KAAK,IAAI,WAAW,KAAK,IAAI,CAAC;AAChE;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,uBACf,MAAM,GACS;AACf,QAAM,UAAU,UAAU,SAAS,aAAa,IAAI,QAAQ,GAAG;AAE/D,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":[]}