@visualli/core 0.1.7 → 0.2.1

package/dist/performance/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/performance/index.ts","../../src/constants/performanceConstants.ts","../../src/performance/performanceMonitor.ts"],"sourcesContent":["export * from './performanceMonitor.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","// ─── Performance Monitors ─────────────────────────────────────────────────────\n//\n// FPSMonitor     – tracks frame rate via requestAnimationFrame (browser)\n// MemoryMonitor  – polls performance.memory (Chrome)\n// PerformanceProfiler – mark / measure utility for arbitrary operations\n\nimport {\n  FPS_TARGET,\n  FPS_SAMPLE_WINDOW,\n  MEMORY_CHECK_INTERVAL,\n} from '../constants/performanceConstants.js';\n\n// ── FPS Monitor ───────────────────────────────────────────────────────────────\n\nexport class FPSMonitor {\n  private frameTimes: number[] = [];\n  private lastTime = 0;\n  private currentFPS = FPS_TARGET;\n  private rafId: number | null = null;\n\n  start(): void {\n    if (this.rafId !== null) return;\n\n    const measure = (ts: number) => {\n      if (this.lastTime > 0) {\n        this.frameTimes.push(ts - this.lastTime);\n        if (this.frameTimes.length > FPS_SAMPLE_WINDOW) this.frameTimes.shift();\n        this.currentFPS = this.calc();\n      }\n      this.lastTime = ts;\n      this.rafId = requestAnimationFrame(measure);\n    };\n\n    this.rafId = requestAnimationFrame(measure);\n  }\n\n  stop(): void {\n    if (this.rafId !== null) { cancelAnimationFrame(this.rafId); this.rafId = null; }\n  }\n\n  private calc(): number {\n    if (this.frameTimes.length === 0) return FPS_TARGET;\n    const avg = this.frameTimes.reduce((a, b) => a + b, 0) / this.frameTimes.length;\n    return Math.round(1000 / avg);\n  }\n\n  getFPS(): number { return this.currentFPS; }\n  getAverageFPS(): number { return this.currentFPS; }\n\n  getP95FrameTime(): number {\n    if (this.frameTimes.length === 0) return 0;\n    const sorted = [...this.frameTimes].sort((a, b) => a - b);\n    return sorted[Math.floor(sorted.length * 0.95)];\n  }\n\n  reset(): void { this.frameTimes = []; this.currentFPS = FPS_TARGET; }\n}\n\n// ── Memory Monitor ────────────────────────────────────────────────────────────\n\nexport interface MemoryStats {\n  usedJSHeapSize:  number;\n  totalJSHeapSize: number;\n  jsHeapSizeLimit: number;\n  heapUsagePercent: number;\n}\n\nexport class MemoryMonitor {\n  private timer: ReturnType<typeof setInterval> | null = null;\n  private current = 0;\n\n  start(onUpdate?: (mb: number) => void): void {\n    if (this.timer !== null) return;\n    this.timer = setInterval(() => {\n      this.current = this.measure();\n      onUpdate?.(this.current);\n    }, MEMORY_CHECK_INTERVAL);\n  }\n\n  stop(): void {\n    if (this.timer !== null) { clearInterval(this.timer); this.timer = null; }\n  }\n\n  private measure(): number {\n    const mem = (performance as unknown as Record<string, unknown>)['memory'] as Record<string, number> | undefined;\n    return mem ? mem['usedJSHeapSize'] / (1024 * 1024) : 0;\n  }\n\n  getMemoryMB(): number { return this.current; }\n\n  getStats(): MemoryStats | null {\n    const mem = (performance as unknown as Record<string, unknown>)['memory'] as Record<string, number> | undefined;\n    if (!mem) return null;\n    return {\n      usedJSHeapSize:   mem['usedJSHeapSize'],\n      totalJSHeapSize:  mem['totalJSHeapSize'],\n      jsHeapSizeLimit:  mem['jsHeapSizeLimit'],\n      heapUsagePercent: (mem['usedJSHeapSize'] / mem['jsHeapSizeLimit']) * 100,\n    };\n  }\n\n  static isSupported(): boolean {\n    return !!(performance as unknown as Record<string, unknown>)['memory'];\n  }\n}\n\n// ── Performance Profiler ──────────────────────────────────────────────────────\n\nexport class PerformanceProfiler {\n  private marks: Map<string, number> = new Map();\n  private measures: Map<string, number[]> = new Map();\n\n  mark(label: string): void {\n    this.marks.set(label, performance.now());\n  }\n\n  measure(label: string): number {\n    const start = this.marks.get(label);\n    if (start === undefined) return 0;\n    const duration = performance.now() - start;\n    const list = this.measures.get(label) ?? [];\n    list.push(duration);\n    this.measures.set(label, list);\n    this.marks.delete(label);\n    return duration;\n  }\n\n  getAverage(label: string): number {\n    const list = this.measures.get(label);\n    if (!list?.length) return 0;\n    return list.reduce((a, b) => a + b, 0) / list.length;\n  }\n\n  getP95(label: string): number {\n    const list = this.measures.get(label);\n    if (!list?.length) return 0;\n    const sorted = [...list].sort((a, b) => a - b);\n    return sorted[Math.floor(sorted.length * 0.95)];\n  }\n\n  clear(label?: string): void {\n    if (label) { this.marks.delete(label); this.measures.delete(label); }\n    else { this.marks.clear(); this.measures.clear(); }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/performance/index.ts","../../src/generated/geometry/interaction.ts","../../src/constants/performanceConstants.ts","../../src/performance/performanceMonitor.ts"],"sourcesContent":["export * from './performanceMonitor.js';\n","// 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","// ─── Performance Monitors ─────────────────────────────────────────────────────\n//\n// FPSMonitor     – tracks frame rate via requestAnimationFrame (browser)\n// MemoryMonitor  – polls performance.memory (Chrome)\n// PerformanceProfiler – mark / measure utility for arbitrary operations\n\nimport {\n  FPS_TARGET,\n  FPS_SAMPLE_WINDOW,\n  MEMORY_CHECK_INTERVAL,\n} from '../constants/performanceConstants.js';\n\n// ── FPS Monitor ───────────────────────────────────────────────────────────────\n\nexport class FPSMonitor {\n  private frameTimes: number[] = [];\n  private lastTime = 0;\n  private currentFPS = FPS_TARGET;\n  private rafId: number | null = null;\n\n  start(): void {\n    if (this.rafId !== null) return;\n\n    const measure = (ts: number) => {\n      if (this.lastTime > 0) {\n        this.frameTimes.push(ts - this.lastTime);\n        if (this.frameTimes.length > FPS_SAMPLE_WINDOW) this.frameTimes.shift();\n        this.currentFPS = this.calc();\n      }\n      this.lastTime = ts;\n      this.rafId = requestAnimationFrame(measure);\n    };\n\n    this.rafId = requestAnimationFrame(measure);\n  }\n\n  stop(): void {\n    if (this.rafId !== null) { cancelAnimationFrame(this.rafId); this.rafId = null; }\n  }\n\n  private calc(): number {\n    if (this.frameTimes.length === 0) return FPS_TARGET;\n    const avg = this.frameTimes.reduce((a, b) => a + b, 0) / this.frameTimes.length;\n    return Math.round(1000 / avg);\n  }\n\n  getFPS(): number { return this.currentFPS; }\n  getAverageFPS(): number { return this.currentFPS; }\n\n  getP95FrameTime(): number {\n    if (this.frameTimes.length === 0) return 0;\n    const sorted = [...this.frameTimes].sort((a, b) => a - b);\n    return sorted[Math.floor(sorted.length * 0.95)];\n  }\n\n  reset(): void { this.frameTimes = []; this.currentFPS = FPS_TARGET; }\n}\n\n// ── Memory Monitor ────────────────────────────────────────────────────────────\n\nexport interface MemoryStats {\n  usedJSHeapSize:  number;\n  totalJSHeapSize: number;\n  jsHeapSizeLimit: number;\n  heapUsagePercent: number;\n}\n\nexport class MemoryMonitor {\n  private timer: ReturnType<typeof setInterval> | null = null;\n  private current = 0;\n\n  start(onUpdate?: (mb: number) => void): void {\n    if (this.timer !== null) return;\n    this.timer = setInterval(() => {\n      this.current = this.measure();\n      onUpdate?.(this.current);\n    }, MEMORY_CHECK_INTERVAL);\n  }\n\n  stop(): void {\n    if (this.timer !== null) { clearInterval(this.timer); this.timer = null; }\n  }\n\n  private measure(): number {\n    const mem = (performance as unknown as Record<string, unknown>)['memory'] as Record<string, number> | undefined;\n    return mem ? mem['usedJSHeapSize'] / (1024 * 1024) : 0;\n  }\n\n  getMemoryMB(): number { return this.current; }\n\n  getStats(): MemoryStats | null {\n    const mem = (performance as unknown as Record<string, unknown>)['memory'] as Record<string, number> | undefined;\n    if (!mem) return null;\n    return {\n      usedJSHeapSize:   mem['usedJSHeapSize'],\n      totalJSHeapSize:  mem['totalJSHeapSize'],\n      jsHeapSizeLimit:  mem['jsHeapSizeLimit'],\n      heapUsagePercent: (mem['usedJSHeapSize'] / mem['jsHeapSizeLimit']) * 100,\n    };\n  }\n\n  static isSupported(): boolean {\n    return !!(performance as unknown as Record<string, unknown>)['memory'];\n  }\n}\n\n// ── Performance Profiler ──────────────────────────────────────────────────────\n\nexport class PerformanceProfiler {\n  private marks: Map<string, number> = new Map();\n  private measures: Map<string, number[]> = new Map();\n\n  mark(label: string): void {\n    this.marks.set(label, performance.now());\n  }\n\n  measure(label: string): number {\n    const start = this.marks.get(label);\n    if (start === undefined) return 0;\n    const duration = performance.now() - start;\n    const list = this.measures.get(label) ?? [];\n    list.push(duration);\n    this.measures.set(label, list);\n    this.marks.delete(label);\n    return duration;\n  }\n\n  getAverage(label: string): number {\n    const list = this.measures.get(label);\n    if (!list?.length) return 0;\n    return list.reduce((a, b) => a + b, 0) / list.length;\n  }\n\n  getP95(label: string): number {\n    const list = this.measures.get(label);\n    if (!list?.length) return 0;\n    const sorted = [...list].sort((a, b) => a - b);\n    return sorted[Math.floor(sorted.length * 0.95)];\n  }\n\n  clear(label?: string): void {\n    if (label) { this.marks.delete(label); this.measures.delete(label); }\n    else { this.marks.clear(); this.measures.clear(); }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/performance/index.js

@@ -2,8 +2,8 @@ import {
   FPSMonitor,
   MemoryMonitor,
   PerformanceProfiler
-} from "../chunk-PDP5CVUL.js";
-import "../chunk-LDJRGT2Q.js";
+} from "../chunk-LOQLNYB3.js";
+import "../chunk-UAMEJG2C.js";
 export {
   FPSMonitor,
   MemoryMonitor,