velo-plot 1.15.0 → 2.0.0

package/dist/plugins/caching.js

@@ -21,8 +21,8 @@ const x = {
   },
   debug: !1
 };
-function k(y = {}) {
-  const s = { ...$, ...y };
+function k(p = {}) {
+  const s = { ...$, ...p };
   let f = null;
   const o = /* @__PURE__ */ new Map(), r = {
     hits: 0,
@@ -38,7 +38,7 @@ function k(y = {}) {
       0
     ) : 100;
   }
-  function p(e) {
+  function z(e) {
     if (o.size === 0) return;
     const t = Array.from(o.entries());
     s.strategy === "lru" ? t.sort((a, l) => a[1].lastAccess - l[1].lastAccess) : s.strategy === "lfu" && t.sort((a, l) => a[1].hits - l[1].hits);
@@ -60,7 +60,7 @@ function k(y = {}) {
       o.delete(i);
     return s.debug && t.length > 0 && console.log(`[Cache] Pruned ${t.length} expired entries`), t.length;
   }
-  function z(e) {
+  function b(e) {
     if (!s.enabled) return;
     const t = o.get(e);
     if (!t) {
@@ -73,12 +73,12 @@ function k(y = {}) {
     }
     return t.lastAccess = Date.now(), t.hits++, r.hits++, s.debug && console.log(`[Cache] HIT: ${e}`), t.value;
   }
-  function b(e, t, i = {}) {
+  function v(e, t, i = {}) {
     if (!s.enabled) return;
     const n = i.size ?? u(t);
     if (c + n > s.maxSize) {
-      const T = c + n - s.maxSize;
-      p(T);
+      const A = c + n - s.maxSize;
+      z(A);
     }
     if (n > s.maxSize) {
       console.warn(`[Cache] Value too large to cache: ${e} (${n} bytes)`);
@@ -97,7 +97,7 @@ function k(y = {}) {
     };
     o.set(e, l), c += n, s.debug && console.log(`[Cache] SET: ${e} (${n} bytes)`);
   }
-  function v(e) {
+  function T(e) {
     return o.has(e);
   }
   function I(e) {
@@ -112,7 +112,7 @@ function k(y = {}) {
       timestamp: Date.now()
     });
   }
-  function S(e) {
+  function y(e) {
     const t = [];
     for (const [i, n] of o.entries())
       n.tags && n.tags.some((a) => e.includes(a)) && (t.push(i), c -= n.size);
@@ -124,7 +124,7 @@ function k(y = {}) {
       timestamp: Date.now()
     }), t.length;
   }
-  function w() {
+  function C() {
     const e = r.hits + r.misses;
     return {
       hits: r.hits,
@@ -136,26 +136,26 @@ function k(y = {}) {
       evictions: r.evictions
     };
   }
-  function A() {
+  function D() {
     r.hits = 0, r.misses = 0, r.evictions = 0;
   }
-  function C() {
+  function S() {
     return Array.from(o.keys());
   }
-  function D() {
+  function w() {
     return o.size;
   }
   const m = {
-    get: z,
-    set: b,
-    has: v,
+    get: b,
+    set: v,
+    has: T,
     delete: I,
     clear: h,
-    invalidateByTags: S,
-    getStats: w,
-    resetStats: A,
-    keys: C,
-    size: D,
+    invalidateByTags: y,
+    getStats: C,
+    resetStats: D,
+    keys: S,
+    size: w,
     prune: g,
     updateConfig(e) {
       Object.assign(s, e);
@@ -169,6 +169,11 @@ function k(y = {}) {
         g();
       }, 6e4);
     },
+    onDataUpdate(e) {
+      if (!s.autoInvalidate) return;
+      const t = [];
+      s.cacheTypes.transforms && t.push("transform"), s.cacheTypes.analysis && t.push("analysis"), s.cacheTypes.bounds && t.push("bounds"), t.length > 0 && y(t);
+    },
     onDestroy(e) {
       d !== null && clearInterval(d), h(), delete e.chart.caching, f = null;
     },

package/dist/plugins/caching.js.map

@@ -1 +1 @@
-{"version":3,"file":"caching.js","sources":["../../src/plugins/caching/index.ts"],"sourcesContent":["/**\n * @fileoverview Advanced caching plugin for performance optimization\n * @module plugins/caching\n */\n\nimport type {\n  PluginCachingConfig,\n  CachingAPI,\n  CacheEntry,\n  CacheStats,\n} from './types';\nimport type {\n  ChartPlugin,\n  PluginContext,\n  PluginManifest,\n} from '../types';\n\nconst manifest: PluginManifest = {\n  name: 'velo-plot-caching',\n  version: '1.0.0',\n  description: 'Advanced caching system for performance optimization',\n  provides: ['caching', 'performance'],\n  tags: ['optimization', 'cache', 'memory'],\n};\n\nconst DEFAULT_CONFIG: Required<PluginCachingConfig> = {\n  enabled: true,\n  maxSize: 50 * 1024 * 1024, // 50MB\n  strategy: 'lru',\n  defaultTTL: undefined as any,\n  autoInvalidate: true,\n  cacheTypes: {\n    transforms: true,\n    analysis: true,\n    frames: false,\n    bounds: true,\n  },\n  onInvalidate: () => {},\n  debug: false,\n};\n\nexport function PluginCaching(\n  userConfig: Partial<PluginCachingConfig> = {}\n): ChartPlugin<PluginCachingConfig> {\n  const config = { ...DEFAULT_CONFIG, ...userConfig };\n  let ctx: PluginContext | null = null;\n\n  // Cache storage\n  const cache = new Map<string, CacheEntry>();\n  \n  // Statistics\n  const stats = {\n    hits: 0,\n    misses: 0,\n    evictions: 0,\n  };\n  \n  let currentSize = 0;\n\n  /**\n   * Estimate size of value in bytes\n   */\n  function estimateSize(value: any): number {\n    if (value === null || value === undefined) return 0;\n    \n    const type = typeof value;\n    \n    if (type === 'boolean') return 4;\n    if (type === 'number') return 8;\n    if (type === 'string') return value.length * 2;\n    \n    if (value instanceof Float32Array || value instanceof Float64Array) {\n      return value.byteLength;\n    }\n    \n    if (Array.isArray(value)) {\n      return value.reduce((sum, item) => sum + estimateSize(item), 0);\n    }\n    \n    if (type === 'object') {\n      return Object.keys(value).reduce(\n        (sum, key) => sum + key.length * 2 + estimateSize(value[key]),\n        0\n      );\n    }\n    \n    return 100; // Default estimate\n  }\n\n  /**\n   * Evict entries based on strategy\n   */\n  function evict(requiredSpace: number): void {\n    if (cache.size === 0) return;\n\n    const entries = Array.from(cache.entries());\n    \n    // Sort based on strategy\n    if (config.strategy === 'lru') {\n      // Least recently used\n      entries.sort((a, b) => a[1].lastAccess - b[1].lastAccess);\n    } else if (config.strategy === 'lfu') {\n      // Least frequently used\n      entries.sort((a, b) => a[1].hits - b[1].hits);\n    }\n    // FIFO is already in insertion order (Map preserves order)\n    \n    let freedSpace = 0;\n    const keysToDelete: string[] = [];\n    \n    for (const [key, entry] of entries) {\n      if (freedSpace >= requiredSpace) break;\n      \n      keysToDelete.push(key);\n      freedSpace += entry.size;\n      currentSize -= entry.size;\n      stats.evictions++;\n    }\n    \n    // Delete entries\n    for (const key of keysToDelete) {\n      cache.delete(key);\n    }\n    \n    if (config.debug && keysToDelete.length > 0) {\n      console.log(`[Cache] Evicted ${keysToDelete.length} entries, freed ${freedSpace} bytes`);\n    }\n  }\n\n  /**\n   * Prune expired entries\n   */\n  function pruneExpired(): number {\n    const now = Date.now();\n    const keysToDelete: string[] = [];\n    \n    for (const [key, entry] of cache.entries()) {\n      if (entry.ttl && now - entry.timestamp > entry.ttl) {\n        keysToDelete.push(key);\n        currentSize -= entry.size;\n      }\n    }\n    \n    for (const key of keysToDelete) {\n      cache.delete(key);\n    }\n    \n    if (config.debug && keysToDelete.length > 0) {\n      console.log(`[Cache] Pruned ${keysToDelete.length} expired entries`);\n    }\n    \n    return keysToDelete.length;\n  }\n\n  /**\n   * Get value from cache\n   */\n  function get<T>(key: string): T | undefined {\n    if (!config.enabled) return undefined;\n    \n    const entry = cache.get(key);\n    \n    if (!entry) {\n      stats.misses++;\n      return undefined;\n    }\n    \n    // Check TTL\n    if (entry.ttl) {\n      const age = Date.now() - entry.timestamp;\n      if (age > entry.ttl) {\n        cache.delete(key);\n        currentSize -= entry.size;\n        stats.misses++;\n        return undefined;\n      }\n    }\n    \n    // Update access metadata\n    entry.lastAccess = Date.now();\n    entry.hits++;\n    stats.hits++;\n    \n    if (config.debug) {\n      console.log(`[Cache] HIT: ${key}`);\n    }\n    \n    return entry.value as T;\n  }\n\n  /**\n   * Set value in cache\n   */\n  function set<T>(\n    key: string,\n    value: T,\n    options: { ttl?: number; tags?: string[]; size?: number } = {}\n  ): void {\n    if (!config.enabled) return;\n    \n    // Estimate size\n    const size = options.size ?? estimateSize(value);\n    \n    // Check if we need to evict\n    if (currentSize + size > config.maxSize) {\n      const requiredSpace = currentSize + size - config.maxSize;\n      evict(requiredSpace);\n    }\n    \n    // Still too large after eviction?\n    if (size > config.maxSize) {\n      console.warn(`[Cache] Value too large to cache: ${key} (${size} bytes)`);\n      return;\n    }\n    \n    // Remove old entry if exists\n    const oldEntry = cache.get(key);\n    if (oldEntry) {\n      currentSize -= oldEntry.size;\n    }\n    \n    // Create entry\n    const entry: CacheEntry<T> = {\n      value,\n      timestamp: Date.now(),\n      lastAccess: Date.now(),\n      hits: 0,\n      size,\n      ttl: options.ttl ?? config.defaultTTL,\n      tags: options.tags,\n    };\n    \n    cache.set(key, entry);\n    currentSize += size;\n    \n    if (config.debug) {\n      console.log(`[Cache] SET: ${key} (${size} bytes)`);\n    }\n  }\n\n  /**\n   * Check if key exists\n   */\n  function has(key: string): boolean {\n    return cache.has(key);\n  }\n\n  /**\n   * Delete specific key\n   */\n  function deleteKey(key: string): boolean {\n    const entry = cache.get(key);\n    if (entry) {\n      currentSize -= entry.size;\n      return cache.delete(key);\n    }\n    return false;\n  }\n\n  /**\n   * Clear all cache\n   */\n  function clear(): void {\n    const count = cache.size;\n    cache.clear();\n    currentSize = 0;\n    \n    if (config.debug) {\n      console.log(`[Cache] Cleared ${count} entries`);\n    }\n    \n    if (config.onInvalidate) {\n      config.onInvalidate({\n        keys: [],\n        reason: 'manual',\n        timestamp: Date.now(),\n      });\n    }\n  }\n\n  /**\n   * Invalidate by tags\n   */\n  function invalidateByTags(tags: string[]): number {\n    const keysToDelete: string[] = [];\n    \n    for (const [key, entry] of cache.entries()) {\n      if (entry.tags && entry.tags.some(tag => tags.includes(tag))) {\n        keysToDelete.push(key);\n        currentSize -= entry.size;\n      }\n    }\n    \n    for (const key of keysToDelete) {\n      cache.delete(key);\n    }\n    \n    if (config.debug && keysToDelete.length > 0) {\n      console.log(`[Cache] Invalidated ${keysToDelete.length} entries by tags:`, tags);\n    }\n    \n    if (config.onInvalidate && keysToDelete.length > 0) {\n      config.onInvalidate({\n        keys: keysToDelete,\n        reason: 'tag',\n        timestamp: Date.now(),\n      });\n    }\n    \n    return keysToDelete.length;\n  }\n\n  /**\n   * Get cache statistics\n   */\n  function getStats(): CacheStats {\n    const total = stats.hits + stats.misses;\n    \n    return {\n      hits: stats.hits,\n      misses: stats.misses,\n      hitRatio: total > 0 ? stats.hits / total : 0,\n      currentSize,\n      maxSize: config.maxSize,\n      entryCount: cache.size,\n      evictions: stats.evictions,\n    };\n  }\n\n  /**\n   * Reset statistics\n   */\n  function resetStats(): void {\n    stats.hits = 0;\n    stats.misses = 0;\n    stats.evictions = 0;\n  }\n\n  /**\n   * Get all keys\n   */\n  function keys(): string[] {\n    return Array.from(cache.keys());\n  }\n\n  /**\n   * Get cache size\n   */\n  function size(): number {\n    return cache.size;\n  }\n\n  // API implementation\n  const api: CachingAPI & Record<string, unknown> = {\n    get,\n    set,\n    has,\n    delete: deleteKey,\n    clear,\n    invalidateByTags,\n    getStats,\n    resetStats,\n    keys,\n    size,\n    prune: pruneExpired,\n    updateConfig(newConfig: Partial<PluginCachingConfig>) {\n      Object.assign(config, newConfig);\n    },\n  };\n\n  // Periodic cleanup\n  let cleanupInterval: number | null = null;\n\n  return {\n    manifest,\n\n    onInit(pluginCtx: PluginContext) {\n      ctx = pluginCtx;\n\n      // Attach to chart API\n      (ctx.chart as any).caching = api;\n\n      // Setup periodic cleanup (every 60 seconds)\n      cleanupInterval = window.setInterval(() => {\n        pruneExpired();\n      }, 60000);\n\n      // TODO: Auto-invalidate on data changes if enabled\n      // Requires 'dataUpdate' event to be added to ChartEventMap\n      // if (config.autoInvalidate) {\n      //   ctx.chart.on?.('dataUpdate', () => {\n      //     if (config.cacheTypes.transforms) invalidateByTags(['transform']);\n      //     if (config.cacheTypes.analysis) invalidateByTags(['analysis']);\n      //     if (config.cacheTypes.bounds) invalidateByTags(['bounds']);\n      //   });\n      // }\n    },\n\n    onDestroy(pluginCtx: PluginContext) {\n      // Clear cleanup interval\n      if (cleanupInterval !== null) {\n        clearInterval(cleanupInterval);\n      }\n\n      // Clear cache\n      clear();\n\n      // Remove from chart API\n      delete (pluginCtx.chart as any).caching;\n\n      ctx = null;\n    },\n\n    api,\n  };\n}\n\nexport default PluginCaching;\n\n// Type exports\nexport type {\n  PluginCachingConfig,\n  CachingAPI,\n  CacheEntry,\n  CacheStats,\n  CacheStrategy,\n  CacheInvalidationEvent,\n} from './types';\n"],"names":["manifest","DEFAULT_CONFIG","PluginCaching","userConfig","config","ctx","cache","stats","currentSize","estimateSize","value","type","sum","item","key","evict","requiredSpace","entries","b","freedSpace","keysToDelete","entry","pruneExpired","now","get","set","options","size","oldEntry","has","deleteKey","clear","count","invalidateByTags","tags","tag","getStats","total","resetStats","keys","api","newConfig","cleanupInterval","pluginCtx"],"mappings":"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"}
+{"version":3,"file":"caching.js","sources":["../../src/plugins/caching/index.ts"],"sourcesContent":["/**\n * @fileoverview Advanced caching plugin for performance optimization\n * @module plugins/caching\n */\n\nimport type {\n  PluginCachingConfig,\n  CachingAPI,\n  CacheEntry,\n  CacheStats,\n} from './types';\nimport type {\n  ChartPlugin,\n  PluginContext,\n  PluginManifest,\n} from '../types';\n\nconst manifest: PluginManifest = {\n  name: 'velo-plot-caching',\n  version: '1.0.0',\n  description: 'Advanced caching system for performance optimization',\n  provides: ['caching', 'performance'],\n  tags: ['optimization', 'cache', 'memory'],\n};\n\nconst DEFAULT_CONFIG: Required<PluginCachingConfig> = {\n  enabled: true,\n  maxSize: 50 * 1024 * 1024, // 50MB\n  strategy: 'lru',\n  defaultTTL: undefined as any,\n  autoInvalidate: true,\n  cacheTypes: {\n    transforms: true,\n    analysis: true,\n    frames: false,\n    bounds: true,\n  },\n  onInvalidate: () => {},\n  debug: false,\n};\n\nexport function PluginCaching(\n  userConfig: Partial<PluginCachingConfig> = {}\n): ChartPlugin<PluginCachingConfig> {\n  const config = { ...DEFAULT_CONFIG, ...userConfig };\n  let ctx: PluginContext | null = null;\n\n  // Cache storage\n  const cache = new Map<string, CacheEntry>();\n  \n  // Statistics\n  const stats = {\n    hits: 0,\n    misses: 0,\n    evictions: 0,\n  };\n  \n  let currentSize = 0;\n\n  /**\n   * Estimate size of value in bytes\n   */\n  function estimateSize(value: any): number {\n    if (value === null || value === undefined) return 0;\n    \n    const type = typeof value;\n    \n    if (type === 'boolean') return 4;\n    if (type === 'number') return 8;\n    if (type === 'string') return value.length * 2;\n    \n    if (value instanceof Float32Array || value instanceof Float64Array) {\n      return value.byteLength;\n    }\n    \n    if (Array.isArray(value)) {\n      return value.reduce((sum, item) => sum + estimateSize(item), 0);\n    }\n    \n    if (type === 'object') {\n      return Object.keys(value).reduce(\n        (sum, key) => sum + key.length * 2 + estimateSize(value[key]),\n        0\n      );\n    }\n    \n    return 100; // Default estimate\n  }\n\n  /**\n   * Evict entries based on strategy\n   */\n  function evict(requiredSpace: number): void {\n    if (cache.size === 0) return;\n\n    const entries = Array.from(cache.entries());\n    \n    // Sort based on strategy\n    if (config.strategy === 'lru') {\n      // Least recently used\n      entries.sort((a, b) => a[1].lastAccess - b[1].lastAccess);\n    } else if (config.strategy === 'lfu') {\n      // Least frequently used\n      entries.sort((a, b) => a[1].hits - b[1].hits);\n    }\n    // FIFO is already in insertion order (Map preserves order)\n    \n    let freedSpace = 0;\n    const keysToDelete: string[] = [];\n    \n    for (const [key, entry] of entries) {\n      if (freedSpace >= requiredSpace) break;\n      \n      keysToDelete.push(key);\n      freedSpace += entry.size;\n      currentSize -= entry.size;\n      stats.evictions++;\n    }\n    \n    // Delete entries\n    for (const key of keysToDelete) {\n      cache.delete(key);\n    }\n    \n    if (config.debug && keysToDelete.length > 0) {\n      console.log(`[Cache] Evicted ${keysToDelete.length} entries, freed ${freedSpace} bytes`);\n    }\n  }\n\n  /**\n   * Prune expired entries\n   */\n  function pruneExpired(): number {\n    const now = Date.now();\n    const keysToDelete: string[] = [];\n    \n    for (const [key, entry] of cache.entries()) {\n      if (entry.ttl && now - entry.timestamp > entry.ttl) {\n        keysToDelete.push(key);\n        currentSize -= entry.size;\n      }\n    }\n    \n    for (const key of keysToDelete) {\n      cache.delete(key);\n    }\n    \n    if (config.debug && keysToDelete.length > 0) {\n      console.log(`[Cache] Pruned ${keysToDelete.length} expired entries`);\n    }\n    \n    return keysToDelete.length;\n  }\n\n  /**\n   * Get value from cache\n   */\n  function get<T>(key: string): T | undefined {\n    if (!config.enabled) return undefined;\n    \n    const entry = cache.get(key);\n    \n    if (!entry) {\n      stats.misses++;\n      return undefined;\n    }\n    \n    // Check TTL\n    if (entry.ttl) {\n      const age = Date.now() - entry.timestamp;\n      if (age > entry.ttl) {\n        cache.delete(key);\n        currentSize -= entry.size;\n        stats.misses++;\n        return undefined;\n      }\n    }\n    \n    // Update access metadata\n    entry.lastAccess = Date.now();\n    entry.hits++;\n    stats.hits++;\n    \n    if (config.debug) {\n      console.log(`[Cache] HIT: ${key}`);\n    }\n    \n    return entry.value as T;\n  }\n\n  /**\n   * Set value in cache\n   */\n  function set<T>(\n    key: string,\n    value: T,\n    options: { ttl?: number; tags?: string[]; size?: number } = {}\n  ): void {\n    if (!config.enabled) return;\n    \n    // Estimate size\n    const size = options.size ?? estimateSize(value);\n    \n    // Check if we need to evict\n    if (currentSize + size > config.maxSize) {\n      const requiredSpace = currentSize + size - config.maxSize;\n      evict(requiredSpace);\n    }\n    \n    // Still too large after eviction?\n    if (size > config.maxSize) {\n      console.warn(`[Cache] Value too large to cache: ${key} (${size} bytes)`);\n      return;\n    }\n    \n    // Remove old entry if exists\n    const oldEntry = cache.get(key);\n    if (oldEntry) {\n      currentSize -= oldEntry.size;\n    }\n    \n    // Create entry\n    const entry: CacheEntry<T> = {\n      value,\n      timestamp: Date.now(),\n      lastAccess: Date.now(),\n      hits: 0,\n      size,\n      ttl: options.ttl ?? config.defaultTTL,\n      tags: options.tags,\n    };\n    \n    cache.set(key, entry);\n    currentSize += size;\n    \n    if (config.debug) {\n      console.log(`[Cache] SET: ${key} (${size} bytes)`);\n    }\n  }\n\n  /**\n   * Check if key exists\n   */\n  function has(key: string): boolean {\n    return cache.has(key);\n  }\n\n  /**\n   * Delete specific key\n   */\n  function deleteKey(key: string): boolean {\n    const entry = cache.get(key);\n    if (entry) {\n      currentSize -= entry.size;\n      return cache.delete(key);\n    }\n    return false;\n  }\n\n  /**\n   * Clear all cache\n   */\n  function clear(): void {\n    const count = cache.size;\n    cache.clear();\n    currentSize = 0;\n    \n    if (config.debug) {\n      console.log(`[Cache] Cleared ${count} entries`);\n    }\n    \n    if (config.onInvalidate) {\n      config.onInvalidate({\n        keys: [],\n        reason: 'manual',\n        timestamp: Date.now(),\n      });\n    }\n  }\n\n  /**\n   * Invalidate by tags\n   */\n  function invalidateByTags(tags: string[]): number {\n    const keysToDelete: string[] = [];\n    \n    for (const [key, entry] of cache.entries()) {\n      if (entry.tags && entry.tags.some(tag => tags.includes(tag))) {\n        keysToDelete.push(key);\n        currentSize -= entry.size;\n      }\n    }\n    \n    for (const key of keysToDelete) {\n      cache.delete(key);\n    }\n    \n    if (config.debug && keysToDelete.length > 0) {\n      console.log(`[Cache] Invalidated ${keysToDelete.length} entries by tags:`, tags);\n    }\n    \n    if (config.onInvalidate && keysToDelete.length > 0) {\n      config.onInvalidate({\n        keys: keysToDelete,\n        reason: 'tag',\n        timestamp: Date.now(),\n      });\n    }\n    \n    return keysToDelete.length;\n  }\n\n  /**\n   * Get cache statistics\n   */\n  function getStats(): CacheStats {\n    const total = stats.hits + stats.misses;\n    \n    return {\n      hits: stats.hits,\n      misses: stats.misses,\n      hitRatio: total > 0 ? stats.hits / total : 0,\n      currentSize,\n      maxSize: config.maxSize,\n      entryCount: cache.size,\n      evictions: stats.evictions,\n    };\n  }\n\n  /**\n   * Reset statistics\n   */\n  function resetStats(): void {\n    stats.hits = 0;\n    stats.misses = 0;\n    stats.evictions = 0;\n  }\n\n  /**\n   * Get all keys\n   */\n  function keys(): string[] {\n    return Array.from(cache.keys());\n  }\n\n  /**\n   * Get cache size\n   */\n  function size(): number {\n    return cache.size;\n  }\n\n  // API implementation\n  const api: CachingAPI & Record<string, unknown> = {\n    get,\n    set,\n    has,\n    delete: deleteKey,\n    clear,\n    invalidateByTags,\n    getStats,\n    resetStats,\n    keys,\n    size,\n    prune: pruneExpired,\n    updateConfig(newConfig: Partial<PluginCachingConfig>) {\n      Object.assign(config, newConfig);\n    },\n  };\n\n  // Periodic cleanup\n  let cleanupInterval: number | null = null;\n\n  return {\n    manifest,\n\n    onInit(pluginCtx: PluginContext) {\n      ctx = pluginCtx;\n\n      // Attach to chart API\n      (ctx.chart as any).caching = api;\n\n      // Setup periodic cleanup (every 60 seconds)\n      cleanupInterval = window.setInterval(() => {\n        pruneExpired();\n      }, 60000);\n    },\n\n    onDataUpdate(_pluginCtx: PluginContext) {\n      if (!config.autoInvalidate) return;\n\n      const tags: string[] = [];\n      if (config.cacheTypes.transforms) tags.push(\"transform\");\n      if (config.cacheTypes.analysis) tags.push(\"analysis\");\n      if (config.cacheTypes.bounds) tags.push(\"bounds\");\n\n      if (tags.length > 0) {\n        invalidateByTags(tags);\n      }\n    },\n\n    onDestroy(pluginCtx: PluginContext) {\n      // Clear cleanup interval\n      if (cleanupInterval !== null) {\n        clearInterval(cleanupInterval);\n      }\n\n      // Clear cache\n      clear();\n\n      // Remove from chart API\n      delete (pluginCtx.chart as any).caching;\n\n      ctx = null;\n    },\n\n    api,\n  };\n}\n\nexport default PluginCaching;\n\n// Type exports\nexport type {\n  PluginCachingConfig,\n  CachingAPI,\n  CacheEntry,\n  CacheStats,\n  CacheStrategy,\n  CacheInvalidationEvent,\n} from './types';\n"],"names":["manifest","DEFAULT_CONFIG","PluginCaching","userConfig","config","ctx","cache","stats","currentSize","estimateSize","value","type","sum","item","key","evict","requiredSpace","entries","b","freedSpace","keysToDelete","entry","pruneExpired","now","get","set","options","size","oldEntry","has","deleteKey","clear","count","invalidateByTags","tags","tag","getStats","total","resetStats","keys","api","newConfig","cleanupInterval","pluginCtx","_pluginCtx"],"mappings":"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"}

package/dist/plugins/drawing-tools/index.d.ts

@@ -0,0 +1,29 @@
+import { ChartPlugin } from '../types';
+
+export type DrawingMode = "none" | "pan" | "trendline" | "horizontal" | "vertical" | "rectangle" | "fibonacci" | "measure";
+export interface PluginDrawingToolsConfig {
+    /** Default stroke color */
+    color?: string;
+    /** Enable candle magnet by default */
+    magnet?: boolean;
+    /** Return to pan mode after each completed stroke (default true) */
+    autoDeselect?: boolean;
+    /** Notified when drawing mode changes (including auto-deselect to none) */
+    onModeChange?: (mode: DrawingMode) => void;
+    /** Color for upward measurements (default green) */
+    measureUpColor?: string;
+    /** Color for downward measurements (default red) */
+    measureDownColor?: string;
+}
+export interface DrawingToolsAPI {
+    setMode(mode: DrawingMode): void;
+    getMode(): DrawingMode;
+    setMagnet(enabled: boolean): void;
+    isMagnet(): boolean;
+    undo(): boolean;
+    redo(): boolean;
+    clear(): void;
+}
+export declare function PluginDrawingTools(config?: PluginDrawingToolsConfig): ChartPlugin<PluginDrawingToolsConfig>;
+export { snapToCandle, findNearestBarIndex } from './snapToCandle';
+export default PluginDrawingTools;

package/dist/plugins/drawing-tools/measure.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Measurement helper for the price-range / measure tool (TradingView-style).
+ */
+export interface MeasurePoint {
+    x: number;
+    y: number;
+}
+export interface Measurement {
+    /** Absolute price change (end - start) */
+    change: number;
+    /** Percentage change relative to the start price */
+    percent: number;
+    /** Number of bars spanned (rounded X distance) */
+    bars: number;
+    /** True when the range moves up (change >= 0) */
+    up: boolean;
+}
+export declare function computeMeasurement(a: MeasurePoint, b: MeasurePoint): Measurement;
+export declare function formatMeasurement(m: Measurement): string;
+/** Compact price formatting used for level labels. */
+export declare function formatPrice(value: number): string;

package/dist/plugins/drawing-tools/snapToCandle.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Snap drawing points to nearest candlestick O/H/L/C (TradingView-style magnet).
+ */
+export interface CandleSnapInput {
+    x: number;
+    y: number;
+    barX: Float32Array | Float64Array;
+    open: Float32Array | Float64Array;
+    high: Float32Array | Float64Array;
+    low: Float32Array | Float64Array;
+    close: Float32Array | Float64Array;
+    dataToPixelX: (x: number) => number;
+    dataToPixelY: (y: number) => number;
+    pixelThreshold?: number;
+    enabled?: boolean;
+}
+export declare function findNearestBarIndex(barX: Float32Array | Float64Array, x: number): number;
+export declare function snapToCandle(input: CandleSnapInput): {
+    x: number;
+    y: number;
+};