velo-plot 2.0.0 → 3.0.0

package/dist/plugins/snapshot.js

@@ -15,7 +15,7 @@ const b = {
   fileName: "velo-plot-snapshot-export",
   download: !1
 };
-function S(c) {
+function R(c) {
   if (typeof c == "number") return c;
   switch (c) {
     case "8k":
@@ -30,61 +30,61 @@ function S(c) {
       return 1;
   }
 }
-function R(c = {}) {
-  let n = null;
-  async function p(e = {}) {
-    var f, h;
-    if (!n) throw new Error("Snapshot plugin not initialized");
-    const t = { ...k, ...c.defaultOptions, ...e }, s = n.chart, l = S(t.resolution), i = s.getDPR();
+function S(c = {}) {
+  let a = null;
+  async function p(t = {}) {
+    var u, h;
+    if (!a) throw new Error("Snapshot plugin not initialized");
+    const e = { ...k, ...c.defaultOptions, ...t }, n = a.chart, s = R(e.resolution), i = n.getDPR();
     try {
-      if (t.format === "svg") {
-        const a = s.exportSVG();
-        if (t.download) {
-          const r = new Blob([a], { type: "image/svg+xml" }), v = URL.createObjectURL(r), u = document.createElement("a");
-          u.download = `${t.fileName}.svg`, u.href = v, document.body.appendChild(u), u.click(), document.body.removeChild(u), URL.revokeObjectURL(v);
+      if (e.format === "svg") {
+        const o = n.exportSVG();
+        if (e.download) {
+          const l = new Blob([o], { type: "image/svg+xml" }), w = URL.createObjectURL(l), f = document.createElement("a");
+          f.download = `${e.fileName}.svg`, f.href = w, document.body.appendChild(f), f.click(), document.body.removeChild(f), URL.revokeObjectURL(w);
         }
-        return a;
+        return o;
       }
-      l > 1 && (s.setDPR(i * l), await new Promise((a) => requestAnimationFrame(a)), await new Promise((a) => setTimeout(a, 100)));
-      const m = (f = n.render.gl) == null ? void 0 : f.canvas, g = (h = n.render.ctx2d) == null ? void 0 : h.canvas;
+      s > 1 && (typeof n.setDevicePixelRatioOverride == "function" ? n.setDevicePixelRatioOverride(i * s) : n.setDPR(i * s), typeof n.render == "function" && n.render(), await new Promise((o) => requestAnimationFrame(o)), await new Promise((o) => requestAnimationFrame(o)), await new Promise((o) => setTimeout(o, 100)));
+      const m = (u = a.render.gl) == null ? void 0 : u.canvas, g = (h = a.render.ctx2d) == null ? void 0 : h.canvas;
       if (!m) throw new Error("WebGL canvas not found");
-      const o = document.createElement("canvas");
-      o.width = m.width, o.height = m.height;
-      const d = o.getContext("2d");
-      !t.transparent && t.includeBackground && (d.fillStyle = n.ui.theme.backgroundColor || "#ffffff", d.fillRect(0, 0, o.width, o.height)), d.drawImage(m, 0, 0), t.includeOverlays && g && d.drawImage(g, 0, 0), t.watermarkText && x(d, t.watermarkText, o.width, o.height, i * l);
-      const y = `image/${t.format}`, w = o.toDataURL(y, t.quality);
-      if (t.download) {
-        const a = t.format === "jpeg" ? "jpg" : t.format, r = document.createElement("a");
-        r.download = `${t.fileName}.${a}`, r.href = w, document.body.appendChild(r), r.click(), document.body.removeChild(r);
+      const r = document.createElement("canvas");
+      r.width = m.width, r.height = m.height;
+      const d = r.getContext("2d");
+      !e.transparent && e.includeBackground && (d.fillStyle = a.ui.theme.backgroundColor || "#ffffff", d.fillRect(0, 0, r.width, r.height)), d.drawImage(m, 0, 0), e.includeOverlays && g && d.drawImage(g, 0, 0), e.watermarkText && x(d, e.watermarkText, r.width, r.height, i * s);
+      const y = `image/${e.format}`, v = r.toDataURL(y, e.quality);
+      if (e.download) {
+        const o = e.format === "jpeg" ? "jpg" : e.format, l = document.createElement("a");
+        l.download = `${e.fileName}.${o}`, l.href = v, document.body.appendChild(l), l.click(), document.body.removeChild(l);
       }
-      return w;
+      return v;
     } finally {
-      l > 1 && s.setDPR(i);
+      s > 1 && (typeof n.setDevicePixelRatioOverride == "function" ? n.setDevicePixelRatioOverride(null) : n.setDPR(i));
     }
   }
-  function x(e, t, s, l, i) {
-    e.save();
-    const f = Math.max(16, 24 * (i / 2));
-    e.font = `bold ${f}px Inter, system-ui, sans-serif`, e.fillStyle = "rgba(128, 128, 128, 0.4)", e.textAlign = "right", e.textBaseline = "bottom", e.fillText(t, s - 20 * i / 2, l - 20 * i / 2), e.restore();
+  function x(t, e, n, s, i) {
+    t.save();
+    const u = Math.max(16, 24 * (i / 2));
+    t.font = `bold ${u}px Inter, system-ui, sans-serif`, t.fillStyle = "rgba(128, 128, 128, 0.4)", t.textAlign = "right", t.textBaseline = "bottom", t.fillText(e, n - 20 * i / 2, s - 20 * i / 2), t.restore();
   }
   return {
     manifest: b,
-    onInit(e) {
-      n = e, n.log.info("Snapshot plugin initialized");
+    onInit(t) {
+      a = t, a.log.info("Snapshot plugin initialized");
     },
     onDestroy() {
-      n = null;
+      a = null;
     },
     api: {
       takeSnapshot: p,
-      downloadSnapshot: async (e) => {
-        await p({ ...e, download: !0 });
+      downloadSnapshot: async (t) => {
+        await p({ ...t, download: !0 });
       }
     }
   };
 }
 export {
-  R as PluginSnapshot,
-  R as default
+  S as PluginSnapshot,
+  S as default
 };
 //# sourceMappingURL=snapshot.js.map

package/dist/plugins/snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.js","sources":["../../src/plugins/snapshot/index.ts"],"sourcesContent":["/**\n * SciPlot - Snapshot Plugin\n * \n * Provides high-resolution image export capabilities.\n * Supports different formats (PNG, JPEG, WebP) and resolutions (Standard, 2K, 4K, 8K).\n * \n * @module plugins/snapshot\n */\n\nimport type { \n  PluginManifest, \n  ChartPlugin, \n  PluginContext,\n} from '../types';\n\nimport type {\n  PluginSnapshotConfig,\n  SnapshotExportAPI,\n  SnapshotExportOptions,\n  SnapshotResolution,\n} from './types';\n\nconst manifestSnapshot: PluginManifest = {\n  name: \"velo-plot-snapshot\",\n  version: \"1.0.0\",\n  description: \"High-resolution image export for velo-plot\",\n  provides: [\"export\", \"snapshot\"],\n  tags: [\"snapshot\", \"export\", \"publication\", \"image\"],\n};\n\nconst DEFAULT_OPTIONS: Required<SnapshotExportOptions> = {\n  format: 'png',\n  quality: 0.9,\n  resolution: 'standard',\n  includeBackground: true,\n  includeOverlays: true,\n  watermarkText: '',\n  transparent: false,\n  fileName: 'velo-plot-snapshot-export',\n  download: false\n};\n\nfunction resolutionToScale(res: SnapshotResolution): number {\n  if (typeof res === 'number') return res;\n  switch (res) {\n    case '8k': return 8;\n    case '4k': return 4;\n    case '2k': return 2;\n    case 'standard': return 1;\n    default: return 1;\n  }\n}\n\n/**\n * SciPlot Snapshot Plugin\n * \n * Captures the current chart view with all layers (WebGL + Overlay).\n */\nexport function PluginSnapshot(\n  config: PluginSnapshotConfig = {}\n): ChartPlugin<PluginSnapshotConfig> {\n  let ctx: PluginContext | null = null;\n\n  /**\n   * Captures the chart as an image\n   */\n  async function takeSnapshot(options: SnapshotExportOptions = {}): Promise<string | Blob> {\n    if (!ctx) throw new Error(\"Snapshot plugin not initialized\");\n    \n    const opt = { ...DEFAULT_OPTIONS, ...config.defaultOptions, ...options };\n    const chart = ctx.chart;\n    \n    // 1. Determine target resolution scale\n    const scale = resolutionToScale(opt.resolution);\n    const originalDPR = chart.getDPR();\n    \n    try {\n        if (opt.format === 'svg') {\n          const svg = chart.exportSVG();\n          if (opt.download) {\n            const blob = new Blob([svg], { type: 'image/svg+xml' });\n            const url = URL.createObjectURL(blob);\n            const link = document.createElement('a');\n            link.download = `${opt.fileName}.svg`;\n            link.href = url;\n            document.body.appendChild(link);\n            link.click();\n            document.body.removeChild(link);\n            URL.revokeObjectURL(url);\n          }\n          return svg;\n        }\n\n        // High-res re-render if scale > 1\n        // We temporarily boost the device pixel ratio to force a higher resolution render\n        if (scale > 1) {\n            chart.setDPR(originalDPR * scale);\n            // Wait for DOM and GL updates\n            await new Promise(r => requestAnimationFrame(r));\n            // Small delay to ensure all overlays (which might have their own throttles) are ready\n            await new Promise(r => setTimeout(r, 100));\n        }\n\n        const webglCanvas = (ctx.render.gl?.canvas) as HTMLCanvasElement;\n        const overlayCanvas = (ctx.render.ctx2d?.canvas) as HTMLCanvasElement;\n        \n        if (!webglCanvas) throw new Error(\"WebGL canvas not found\");\n\n        // 3. Compose layers into a final canvas\n        const compositionCanvas = document.createElement('canvas');\n        compositionCanvas.width = webglCanvas.width;\n        compositionCanvas.height = webglCanvas.height;\n        const compCtx = compositionCanvas.getContext('2d')!;\n        \n        // Fill background if not transparent\n        if (!opt.transparent && opt.includeBackground) {\n          compCtx.fillStyle = ctx.ui.theme.backgroundColor || '#ffffff';\n          compCtx.fillRect(0, 0, compositionCanvas.width, compositionCanvas.height);\n        }\n        \n        // Draw WebGL layer (bottom)\n        compCtx.drawImage(webglCanvas, 0, 0);\n        \n        // Draw Overlay layer (top) - contains annotations, tooltips, etc.\n        if (opt.includeOverlays && overlayCanvas) {\n          compCtx.drawImage(overlayCanvas, 0, 0);\n        }\n        \n        // Apply Watermark\n        if (opt.watermarkText) {\n          drawWatermark(compCtx, opt.watermarkText, compositionCanvas.width, compositionCanvas.height, originalDPR * scale);\n        }\n        \n        const mimeType = `image/${opt.format}`;\n        const dataUrl = compositionCanvas.toDataURL(mimeType, opt.quality);\n        \n        // Automatic download if requested\n        if (opt.download) {\n          const extension = opt.format === 'jpeg' ? 'jpg' : opt.format;\n          const link = document.createElement('a');\n          link.download = `${opt.fileName}.${extension}`;\n          link.href = dataUrl;\n          document.body.appendChild(link);\n          link.click();\n          document.body.removeChild(link);\n        }\n        \n        return dataUrl;\n    } finally {\n        // 4. Restore original resolution\n        if (scale > 1) {\n            chart.setDPR(originalDPR);\n        }\n    }\n  }\n\n  /**\n   * Helper to draw a watermark on the captured image\n   */\n  function drawWatermark(c: CanvasRenderingContext2D, text: string, w: number, h: number, dpr: number) {\n    c.save();\n    // Scale font size according to DPR\n    const fontSize = Math.max(16, 24 * (dpr / 2));\n    c.font = `bold ${fontSize}px Inter, system-ui, sans-serif`;\n    c.fillStyle = 'rgba(128, 128, 128, 0.4)';\n    c.textAlign = 'right';\n    c.textBaseline = 'bottom';\n    c.fillText(text, w - (20 * dpr/2), h - (20 * dpr/2));\n    c.restore();\n  }\n\n  const api: SnapshotExportAPI & Record<string, unknown> = {\n    takeSnapshot,\n    downloadSnapshot: async (opt: SnapshotExportOptions) => {\n      await takeSnapshot({ ...opt, download: true });\n    }\n  };\n\n  return {\n    manifest: manifestSnapshot,\n    onInit(c) { \n        ctx = c; \n        ctx.log.info(\"Snapshot plugin initialized\");\n    },\n    onDestroy() {\n        ctx = null;\n    },\n    api\n  };\n}\n\nexport default PluginSnapshot;\n\nexport type {\n  SnapshotFormat,\n  SnapshotResolution,\n  SnapshotExportOptions,\n  SnapshotExportAPI,\n  PluginSnapshotConfig\n} from './types';\n"],"names":["manifestSnapshot","DEFAULT_OPTIONS","resolutionToScale","res","PluginSnapshot","config","ctx","takeSnapshot","options","_a","_b","opt","chart","scale","originalDPR","svg","blob","url","link","r","webglCanvas","overlayCanvas","compositionCanvas","compCtx","drawWatermark","mimeType","dataUrl","extension","c","text","w","h","dpr","fontSize"],"mappings":"AAsBA,MAAMA,IAAmC;AAAA,EACvC,MAAM;AAAA,EACN,SAAS;AAAA,EACT,aAAa;AAAA,EACb,UAAU,CAAC,UAAU,UAAU;AAAA,EAC/B,MAAM,CAAC,YAAY,UAAU,eAAe,OAAO;AACrD,GAEMC,IAAmD;AAAA,EACvD,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,YAAY;AAAA,EACZ,mBAAmB;AAAA,EACnB,iBAAiB;AAAA,EACjB,eAAe;AAAA,EACf,aAAa;AAAA,EACb,UAAU;AAAA,EACV,UAAU;AACZ;AAEA,SAASC,EAAkBC,GAAiC;AAC1D,MAAI,OAAOA,KAAQ,SAAU,QAAOA;AACpC,UAAQA,GAAA;AAAA,IACN,KAAK;AAAM,aAAO;AAAA,IAClB,KAAK;AAAM,aAAO;AAAA,IAClB,KAAK;AAAM,aAAO;AAAA,IAClB,KAAK;AAAY,aAAO;AAAA,IACxB;AAAS,aAAO;AAAA,EAAA;AAEpB;AAOO,SAASC,EACdC,IAA+B,IACI;AACnC,MAAIC,IAA4B;AAKhC,iBAAeC,EAAaC,IAAiC,IAA4B;AA5C3F,QAAAC,GAAAC;AA6CI,QAAI,CAACJ,EAAK,OAAM,IAAI,MAAM,iCAAiC;AAE3D,UAAMK,IAAM,EAAE,GAAGV,GAAiB,GAAGI,EAAO,gBAAgB,GAAGG,EAAA,GACzDI,IAAQN,EAAI,OAGZO,IAAQX,EAAkBS,EAAI,UAAU,GACxCG,IAAcF,EAAM,OAAA;AAE1B,QAAI;AACA,UAAID,EAAI,WAAW,OAAO;AACxB,cAAMI,IAAMH,EAAM,UAAA;AAClB,YAAID,EAAI,UAAU;AAChB,gBAAMK,IAAO,IAAI,KAAK,CAACD,CAAG,GAAG,EAAE,MAAM,iBAAiB,GAChDE,IAAM,IAAI,gBAAgBD,CAAI,GAC9BE,IAAO,SAAS,cAAc,GAAG;AACvC,UAAAA,EAAK,WAAW,GAAGP,EAAI,QAAQ,QAC/BO,EAAK,OAAOD,GACZ,SAAS,KAAK,YAAYC,CAAI,GAC9BA,EAAK,MAAA,GACL,SAAS,KAAK,YAAYA,CAAI,GAC9B,IAAI,gBAAgBD,CAAG;AAAA,QACzB;AACA,eAAOF;AAAA,MACT;AAIA,MAAIF,IAAQ,MACRD,EAAM,OAAOE,IAAcD,CAAK,GAEhC,MAAM,IAAI,QAAQ,CAAAM,MAAK,sBAAsBA,CAAC,CAAC,GAE/C,MAAM,IAAI,QAAQ,CAAAA,MAAK,WAAWA,GAAG,GAAG,CAAC;AAG7C,YAAMC,KAAeX,IAAAH,EAAI,OAAO,OAAX,gBAAAG,EAAe,QAC9BY,KAAiBX,IAAAJ,EAAI,OAAO,UAAX,gBAAAI,EAAkB;AAEzC,UAAI,CAACU,EAAa,OAAM,IAAI,MAAM,wBAAwB;AAG1D,YAAME,IAAoB,SAAS,cAAc,QAAQ;AACzD,MAAAA,EAAkB,QAAQF,EAAY,OACtCE,EAAkB,SAASF,EAAY;AACvC,YAAMG,IAAUD,EAAkB,WAAW,IAAI;AAGjD,MAAI,CAACX,EAAI,eAAeA,EAAI,sBAC1BY,EAAQ,YAAYjB,EAAI,GAAG,MAAM,mBAAmB,WACpDiB,EAAQ,SAAS,GAAG,GAAGD,EAAkB,OAAOA,EAAkB,MAAM,IAI1EC,EAAQ,UAAUH,GAAa,GAAG,CAAC,GAG/BT,EAAI,mBAAmBU,KACzBE,EAAQ,UAAUF,GAAe,GAAG,CAAC,GAInCV,EAAI,iBACNa,EAAcD,GAASZ,EAAI,eAAeW,EAAkB,OAAOA,EAAkB,QAAQR,IAAcD,CAAK;AAGlH,YAAMY,IAAW,SAASd,EAAI,MAAM,IAC9Be,IAAUJ,EAAkB,UAAUG,GAAUd,EAAI,OAAO;AAGjE,UAAIA,EAAI,UAAU;AAChB,cAAMgB,IAAYhB,EAAI,WAAW,SAAS,QAAQA,EAAI,QAChDO,IAAO,SAAS,cAAc,GAAG;AACvC,QAAAA,EAAK,WAAW,GAAGP,EAAI,QAAQ,IAAIgB,CAAS,IAC5CT,EAAK,OAAOQ,GACZ,SAAS,KAAK,YAAYR,CAAI,GAC9BA,EAAK,MAAA,GACL,SAAS,KAAK,YAAYA,CAAI;AAAA,MAChC;AAEA,aAAOQ;AAAA,IACX,UAAA;AAEI,MAAIb,IAAQ,KACRD,EAAM,OAAOE,CAAW;AAAA,IAEhC;AAAA,EACF;AAKA,WAASU,EAAcI,GAA6BC,GAAcC,GAAWC,GAAWC,GAAa;AACnG,IAAAJ,EAAE,KAAA;AAEF,UAAMK,IAAW,KAAK,IAAI,IAAI,MAAMD,IAAM,EAAE;AAC5C,IAAAJ,EAAE,OAAO,QAAQK,CAAQ,mCACzBL,EAAE,YAAY,4BACdA,EAAE,YAAY,SACdA,EAAE,eAAe,UACjBA,EAAE,SAASC,GAAMC,IAAK,KAAKE,IAAI,GAAID,IAAK,KAAKC,IAAI,CAAE,GACnDJ,EAAE,QAAA;AAAA,EACJ;AASA,SAAO;AAAA,IACL,UAAU5B;AAAA,IACV,OAAO4B,GAAG;AACN,MAAAtB,IAAMsB,GACNtB,EAAI,IAAI,KAAK,6BAA6B;AAAA,IAC9C;AAAA,IACA,YAAY;AACR,MAAAA,IAAM;AAAA,IACV;AAAA,IACA,KAhBuD;AAAA,MACvD,cAAAC;AAAA,MACA,kBAAkB,OAAOI,MAA+B;AACtD,cAAMJ,EAAa,EAAE,GAAGI,GAAK,UAAU,IAAM;AAAA,MAC/C;AAAA,IAAA;AAAA,EAYA;AAEJ;"}
+{"version":3,"file":"snapshot.js","sources":["../../src/plugins/snapshot/index.ts"],"sourcesContent":["/**\n * VeloPlot - Snapshot Plugin\n * \n * Provides high-resolution image export capabilities.\n * Supports different formats (PNG, JPEG, WebP) and resolutions (Standard, 2K, 4K, 8K).\n * \n * @module plugins/snapshot\n */\n\nimport type { \n  PluginManifest, \n  ChartPlugin, \n  PluginContext,\n} from '../types';\n\nimport type {\n  PluginSnapshotConfig,\n  SnapshotExportAPI,\n  SnapshotExportOptions,\n  SnapshotResolution,\n} from './types';\n\nconst manifestSnapshot: PluginManifest = {\n  name: \"velo-plot-snapshot\",\n  version: \"1.0.0\",\n  description: \"High-resolution image export for velo-plot\",\n  provides: [\"export\", \"snapshot\"],\n  tags: [\"snapshot\", \"export\", \"publication\", \"image\"],\n};\n\nconst DEFAULT_OPTIONS: Required<SnapshotExportOptions> = {\n  format: 'png',\n  quality: 0.9,\n  resolution: 'standard',\n  includeBackground: true,\n  includeOverlays: true,\n  watermarkText: '',\n  transparent: false,\n  fileName: 'velo-plot-snapshot-export',\n  download: false\n};\n\nfunction resolutionToScale(res: SnapshotResolution): number {\n  if (typeof res === 'number') return res;\n  switch (res) {\n    case '8k': return 8;\n    case '4k': return 4;\n    case '2k': return 2;\n    case 'standard': return 1;\n    default: return 1;\n  }\n}\n\n/**\n * VeloPlot Snapshot Plugin\n * \n * Captures the current chart view with all layers (WebGL + Overlay).\n */\nexport function PluginSnapshot(\n  config: PluginSnapshotConfig = {}\n): ChartPlugin<PluginSnapshotConfig> {\n  let ctx: PluginContext | null = null;\n\n  /**\n   * Captures the chart as an image\n   */\n  async function takeSnapshot(options: SnapshotExportOptions = {}): Promise<string | Blob> {\n    if (!ctx) throw new Error(\"Snapshot plugin not initialized\");\n    \n    const opt = { ...DEFAULT_OPTIONS, ...config.defaultOptions, ...options };\n    const chart = ctx.chart;\n    \n    // 1. Determine target resolution scale\n    const scale = resolutionToScale(opt.resolution);\n    const originalDPR = chart.getDPR();\n    \n    try {\n        if (opt.format === 'svg') {\n          const svg = chart.exportSVG();\n          if (opt.download) {\n            const blob = new Blob([svg], { type: 'image/svg+xml' });\n            const url = URL.createObjectURL(blob);\n            const link = document.createElement('a');\n            link.download = `${opt.fileName}.svg`;\n            link.href = url;\n            document.body.appendChild(link);\n            link.click();\n            document.body.removeChild(link);\n            URL.revokeObjectURL(url);\n          }\n          return svg;\n        }\n\n        // High-res re-render if scale > 1.\n        // We temporarily lock the device pixel ratio to force a higher-resolution\n        // render. Using an explicit override (instead of setDPR) is essential:\n        // a plain setDPR gets reverted by the very next resize() call, so the\n        // backing stores would stay at screen resolution and every preset would\n        // look identical / pixelated. The override survives resize().\n        if (scale > 1) {\n            if (typeof chart.setDevicePixelRatioOverride === 'function') {\n                chart.setDevicePixelRatioOverride(originalDPR * scale);\n            } else {\n                chart.setDPR(originalDPR * scale);\n            }\n            // Force a synchronous full render at the boosted DPR before capture.\n            if (typeof chart.render === 'function') {\n                chart.render();\n            }\n            // Wait for DOM and GL updates\n            await new Promise(r => requestAnimationFrame(r));\n            // Second frame ensures the resized backing store has actually been painted.\n            await new Promise(r => requestAnimationFrame(r));\n            // Small delay to ensure all overlays (which might have their own throttles) are ready\n            await new Promise(r => setTimeout(r, 100));\n        }\n\n        const webglCanvas = (ctx.render.gl?.canvas) as HTMLCanvasElement;\n        const overlayCanvas = (ctx.render.ctx2d?.canvas) as HTMLCanvasElement;\n        \n        if (!webglCanvas) throw new Error(\"WebGL canvas not found\");\n\n        // 3. Compose layers into a final canvas\n        const compositionCanvas = document.createElement('canvas');\n        compositionCanvas.width = webglCanvas.width;\n        compositionCanvas.height = webglCanvas.height;\n        const compCtx = compositionCanvas.getContext('2d')!;\n        \n        // Fill background if not transparent\n        if (!opt.transparent && opt.includeBackground) {\n          compCtx.fillStyle = ctx.ui.theme.backgroundColor || '#ffffff';\n          compCtx.fillRect(0, 0, compositionCanvas.width, compositionCanvas.height);\n        }\n        \n        // Draw WebGL layer (bottom)\n        compCtx.drawImage(webglCanvas, 0, 0);\n        \n        // Draw Overlay layer (top) - contains annotations, tooltips, etc.\n        if (opt.includeOverlays && overlayCanvas) {\n          compCtx.drawImage(overlayCanvas, 0, 0);\n        }\n        \n        // Apply Watermark\n        if (opt.watermarkText) {\n          drawWatermark(compCtx, opt.watermarkText, compositionCanvas.width, compositionCanvas.height, originalDPR * scale);\n        }\n        \n        const mimeType = `image/${opt.format}`;\n        const dataUrl = compositionCanvas.toDataURL(mimeType, opt.quality);\n        \n        // Automatic download if requested\n        if (opt.download) {\n          const extension = opt.format === 'jpeg' ? 'jpg' : opt.format;\n          const link = document.createElement('a');\n          link.download = `${opt.fileName}.${extension}`;\n          link.href = dataUrl;\n          document.body.appendChild(link);\n          link.click();\n          document.body.removeChild(link);\n        }\n        \n        return dataUrl;\n    } finally {\n        // 4. Restore original resolution\n        if (scale > 1) {\n            if (typeof chart.setDevicePixelRatioOverride === 'function') {\n                chart.setDevicePixelRatioOverride(null);\n            } else {\n                chart.setDPR(originalDPR);\n            }\n        }\n    }\n  }\n\n  /**\n   * Helper to draw a watermark on the captured image\n   */\n  function drawWatermark(c: CanvasRenderingContext2D, text: string, w: number, h: number, dpr: number) {\n    c.save();\n    // Scale font size according to DPR\n    const fontSize = Math.max(16, 24 * (dpr / 2));\n    c.font = `bold ${fontSize}px Inter, system-ui, sans-serif`;\n    c.fillStyle = 'rgba(128, 128, 128, 0.4)';\n    c.textAlign = 'right';\n    c.textBaseline = 'bottom';\n    c.fillText(text, w - (20 * dpr/2), h - (20 * dpr/2));\n    c.restore();\n  }\n\n  const api: SnapshotExportAPI & Record<string, unknown> = {\n    takeSnapshot,\n    downloadSnapshot: async (opt: SnapshotExportOptions) => {\n      await takeSnapshot({ ...opt, download: true });\n    }\n  };\n\n  return {\n    manifest: manifestSnapshot,\n    onInit(c) { \n        ctx = c; \n        ctx.log.info(\"Snapshot plugin initialized\");\n    },\n    onDestroy() {\n        ctx = null;\n    },\n    api\n  };\n}\n\nexport default PluginSnapshot;\n\nexport type {\n  SnapshotFormat,\n  SnapshotResolution,\n  SnapshotExportOptions,\n  SnapshotExportAPI,\n  PluginSnapshotConfig\n} from './types';\n"],"names":["manifestSnapshot","DEFAULT_OPTIONS","resolutionToScale","res","PluginSnapshot","config","ctx","takeSnapshot","options","_a","_b","opt","chart","scale","originalDPR","svg","blob","url","link","r","webglCanvas","overlayCanvas","compositionCanvas","compCtx","drawWatermark","mimeType","dataUrl","extension","c","text","w","h","dpr","fontSize"],"mappings":"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"}

package/dist/plugins/streaming/index.d.ts

@@ -1,6 +1,6 @@
 import { ChartPlugin } from '../types';
 /**
- * Sci Plot - Streaming Plugin
+ * Velo Plot - Streaming Plugin
  *
  * Provides real-time data streaming capabilities including:
  * - WebSocket connections
@@ -24,7 +24,7 @@ export interface PluginStreamingConfig {
     };
 }
 /**
- * SciPlot Streaming Plugin
+ * VeloPlot Streaming Plugin
  *
  * Enables seamless integration with real-time data sources.
  */

package/dist/plugins/streaming.d.ts

@@ -1,3 +1,3 @@
 export * from './streaming/index'
-import SciPlot from './streaming/index'
-export default SciPlot
+import VeloPlot from './streaming/index'
+export default VeloPlot

package/dist/plugins/sync/index.d.ts

@@ -1,6 +1,6 @@
 import { ChartPlugin } from '../types';
 /**
- * SciPlot Engine - Chart Sync Plugin
+ * VeloPlot Engine - Chart Sync Plugin
  *
  * Provides synchronization between multiple chart instances.
  *
@@ -14,10 +14,11 @@ export interface PluginSyncConfig {
     syncAxes?: "x" | "y" | "both";
 }
 /**
- * SciPlot Sync Plugin
+ * VeloPlot Sync Plugin
  *
  * @deprecated Use `ChartGroup` / `createChartGroup` from `velo-plot` (or `velo-plot/full`) instead.
  * This plugin stub does not perform synchronization. Kept for backward-compatible imports only.
+ * **Removed in v4.0.**
  */
 export declare function PluginSync(config?: PluginSyncConfig): ChartPlugin<PluginSyncConfig>;
 export default PluginSync;

package/dist/plugins/sync.d.ts

@@ -1,3 +1,3 @@
 export * from './sync/index'
-import SciPlot from './sync/index'
-export default SciPlot
+import VeloPlot from './sync/index'
+export default VeloPlot

package/dist/plugins/sync.js

@@ -1,4 +1,4 @@
-import { C as c, c as s, a as i, l } from "../index-CUGS98p4.js";
+import { C as c, c as s, a as i, l } from "../index-CaXWSOTk.js";
 const n = {
   name: "velo-plot-sync",
   version: "1.0.0",

package/dist/plugins/sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync.js","sources":["../../src/plugins/sync/index.ts"],"sourcesContent":["/**\n * SciPlot Engine - Chart Sync Plugin\n * \n * Provides synchronization between multiple chart instances.\n * \n * @module plugins/sync\n */\n\nexport * from \"../../core/sync\";\n\nimport type { PluginManifest, ChartPlugin, PluginContext } from \"../types\";\n\nexport interface PluginSyncConfig {\n    /** Group ID to join */\n    groupId?: string;\n    /** Sync axes: 'x' | 'y' | 'both' */\n    syncAxes?: \"x\" | \"y\" | \"both\";\n}\n\nconst manifestSync: PluginManifest = {\n    name: \"velo-plot-sync\",\n    version: \"1.0.0\",\n    description: \"Multi-chart synchronization for velo-plot\",\n    provides: [\"interaction\"],\n    tags: [\"sync\", \"multi-chart\", \"coordination\"],\n};\n\n/**\n * SciPlot Sync Plugin\n *\n * @deprecated Use `ChartGroup` / `createChartGroup` from `velo-plot` (or `velo-plot/full`) instead.\n * This plugin stub does not perform synchronization. Kept for backward-compatible imports only.\n */\nexport function PluginSync(config: PluginSyncConfig = {}): ChartPlugin<PluginSyncConfig> {\n  void config;\n  return {\n    manifest: manifestSync,\n\n    onInit(_ctx: PluginContext) {\n      console.warn(\n        \"[PluginSync] Deprecated: use ChartGroup / createChartGroup from the core sync module instead.\",\n      );\n    },\n\n    onDestroy(_ctx: PluginContext) {\n    },\n  };\n}\n\nexport default PluginSync;\n"],"names":["manifestSync","PluginSync","config","_ctx"],"mappings":";AAmBA,MAAMA,IAA+B;AAAA,EACjC,MAAM;AAAA,EACN,SAAS;AAAA,EACT,aAAa;AAAA,EACb,UAAU,CAAC,aAAa;AAAA,EACxB,MAAM,CAAC,QAAQ,eAAe,cAAc;AAChD;AAQO,SAASC,EAAWC,IAA2B,IAAmC;AAEvF,SAAO;AAAA,IACL,UAAUF;AAAA,IAEV,OAAOG,GAAqB;AAC1B,cAAQ;AAAA,QACN;AAAA,MAAA;AAAA,IAEJ;AAAA,IAEA,UAAUA,GAAqB;AAAA,IAC/B;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"sync.js","sources":["../../src/plugins/sync/index.ts"],"sourcesContent":["/**\n * VeloPlot Engine - Chart Sync Plugin\n * \n * Provides synchronization between multiple chart instances.\n * \n * @module plugins/sync\n */\n\nexport * from \"../../core/sync\";\n\nimport type { PluginManifest, ChartPlugin, PluginContext } from \"../types\";\n\nexport interface PluginSyncConfig {\n    /** Group ID to join */\n    groupId?: string;\n    /** Sync axes: 'x' | 'y' | 'both' */\n    syncAxes?: \"x\" | \"y\" | \"both\";\n}\n\nconst manifestSync: PluginManifest = {\n    name: \"velo-plot-sync\",\n    version: \"1.0.0\",\n    description: \"Multi-chart synchronization for velo-plot\",\n    provides: [\"interaction\"],\n    tags: [\"sync\", \"multi-chart\", \"coordination\"],\n};\n\n/**\n * VeloPlot Sync Plugin\n *\n * @deprecated Use `ChartGroup` / `createChartGroup` from `velo-plot` (or `velo-plot/full`) instead.\n * This plugin stub does not perform synchronization. Kept for backward-compatible imports only.\n * **Removed in v4.0.**\n */\nexport function PluginSync(config: PluginSyncConfig = {}): ChartPlugin<PluginSyncConfig> {\n  void config;\n  return {\n    manifest: manifestSync,\n\n    onInit(_ctx: PluginContext) {\n      console.warn(\n        \"[PluginSync] Deprecated: use ChartGroup / createChartGroup from the core sync module instead.\",\n      );\n    },\n\n    onDestroy(_ctx: PluginContext) {\n    },\n  };\n}\n\nexport default PluginSync;\n"],"names":["manifestSync","PluginSync","config","_ctx"],"mappings":";AAmBA,MAAMA,IAA+B;AAAA,EACjC,MAAM;AAAA,EACN,SAAS;AAAA,EACT,aAAa;AAAA,EACb,UAAU,CAAC,aAAa;AAAA,EACxB,MAAM,CAAC,QAAQ,eAAe,cAAc;AAChD;AASO,SAASC,EAAWC,IAA2B,IAAmC;AAEvF,SAAO;AAAA,IACL,UAAUF;AAAA,IAEV,OAAOG,GAAqB;AAC1B,cAAQ;AAAA,QACN;AAAA,MAAA;AAAA,IAEJ;AAAA,IAEA,UAAUA,GAAqB;AAAA,IAC/B;AAAA,EAAA;AAEJ;"}

package/dist/plugins/theme-editor/index.d.ts

@@ -8,7 +8,7 @@ export interface PluginThemeEditorConfig {
     position?: "left" | "right";
 }
 /**
- * SciPlot Theme Editor Plugin
+ * VeloPlot Theme Editor Plugin
  *
  * Adds a visual panel to customize chart colors and styles.
  */

package/dist/plugins/theme-editor.d.ts

@@ -1,3 +1,3 @@
 export * from './theme-editor/index'
-import SciPlot from './theme-editor/index'
-export default SciPlot
+import VeloPlot from './theme-editor/index'
+export default VeloPlot

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

@@ -12,7 +12,7 @@ export interface PluginToolsConfig {
     useEnhancedTooltips?: boolean;
 }
 /**
- * SciPlot Tools Plugin
+ * VeloPlot Tools Plugin
  *
  * Adds specialized tools for scientific data analysis and interaction.
  */

package/dist/plugins/tools/tooltip/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Tooltip System - High-performance, customizable tooltips for Sci Plot
+ * Tooltip System - High-performance, customizable tooltips for Velo Plot
  *
  * This module provides a comprehensive tooltip system with:
  * - Multiple tooltip types (datapoint, crosshair, heatmap, etc.)

package/dist/plugins/tools.d.ts

@@ -1,3 +1,3 @@
 export * from './tools/index'
-import SciPlot from './tools/index'
-export default SciPlot
+import VeloPlot from './tools/index'
+export default VeloPlot

package/dist/plugins/tools.js

@@ -1,4 +1,4 @@
-import { D as l, b as s, P as e, T, P as t } from "../index-CWipqOLP.js";
+import { D as l, b as s, P as e, T, P as t } from "../index-qunX30Xu.js";
 export {
   l as DeltaTool,
   s as PeakTool,

package/dist/plugins/types.d.ts

@@ -36,7 +36,7 @@ export interface PluginManifest {
     dependencies?: string[];
     /** Optional plugins that enhance this one if present */
     optionalDependencies?: string[];
-    /** Minimum Sci Plot version required */
+    /** Minimum Velo Plot version required */
     engineVersion?: PluginVersion;
     /** Plugin-specific configuration schema (JSON Schema format) */
     configSchema?: Record<string, unknown>;

package/dist/plugins/video-recorder.d.ts

@@ -1,3 +1,3 @@
 export * from './video-recorder/index'
-import SciPlot from './video-recorder/index'
-export default SciPlot
+import VeloPlot from './video-recorder/index'
+export default VeloPlot

package/dist/plugins/virtualization.d.ts

@@ -1,3 +1,3 @@
 export * from './virtualization/index'
-import SciPlot from './virtualization/index'
-export default SciPlot
+import VeloPlot from './virtualization/index'
+export default VeloPlot

package/dist/plugins/virtualization.js

@@ -1,4 +1,4 @@
-import { P as t, P as l } from "../index-D7dTq6VB.js";
+import { P as t, P as l } from "../index-0InEyj0q.js";
 export {
   t as PluginVirtualization,
   l as default

package/dist/pool-DZ8shSqv.js

@@ -0,0 +1,109 @@
+var h = Object.defineProperty;
+var l = (n, e, r) => e in n ? h(n, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : n[e] = r;
+var i = (n, e, r) => l(n, typeof e != "symbol" ? e + "" : e, r);
+class k {
+  constructor(e, r = {}) {
+    i(this, "workers", []);
+    i(this, "pending", /* @__PURE__ */ new Map());
+    i(this, "nextWorker", 0);
+    i(this, "poolSize");
+    i(this, "syncFallback");
+    i(this, "timeoutMs");
+    i(this, "workerFactory");
+    i(this, "syncHandler");
+    i(this, "destroyed", !1);
+    if (this.workerFactory = e, this.poolSize = r.poolSize ?? 2, this.syncFallback = r.syncFallback ?? !0, this.timeoutMs = r.timeoutMs ?? 250, this.syncHandler = r.syncHandler, typeof Worker < "u")
+      for (let t = 0; t < this.poolSize; t++)
+        this.spawnWorker();
+  }
+  removeWorker(e) {
+    const r = this.workers.indexOf(e);
+    r >= 0 && this.workers.splice(r, 1), e.terminate();
+  }
+  workerErrorMessage(e) {
+    const r = e;
+    return typeof r.message == "string" && r.message ? r.message : "Worker error";
+  }
+  rejectPendingWithSyncFallback(e, r) {
+    this.removeWorker(e);
+    const t = this.workerErrorMessage(r), s = [...this.pending.entries()];
+    this.pending.clear();
+    for (const [, o] of s) {
+      if (this.clearTaskTimer(o), this.syncFallback && this.syncHandler) {
+        Promise.resolve(this.syncHandler(o.task)).then(o.resolve).catch(o.reject);
+        continue;
+      }
+      o.reject(new Error(t));
+    }
+  }
+  clearTaskTimer(e) {
+    e.timer !== void 0 && clearTimeout(e.timer);
+  }
+  settleWithSync(e) {
+    if (this.syncFallback && this.syncHandler) {
+      Promise.resolve(this.syncHandler(e.task)).then(e.resolve).catch(e.reject);
+      return;
+    }
+    e.reject(new Error("Worker task timed out"));
+  }
+  spawnWorker() {
+    const e = this.workerFactory();
+    e.onmessage = (r) => {
+      const t = r.data;
+      if (!(t != null && t.id)) return;
+      const s = this.pending.get(t.id);
+      if (s) {
+        if (this.pending.delete(t.id), this.clearTaskTimer(s), t.type === "error" || t.error) {
+          this.syncFallback && this.syncHandler ? this.settleWithSync(s) : s.reject(new Error(t.error ?? "Worker task failed"));
+          return;
+        }
+        s.resolve(t);
+      }
+    }, e.onerror = (r) => {
+      this.rejectPendingWithSyncFallback(e, r);
+    }, this.workers.push(e);
+  }
+  /** Dispatch a task to the pool. Falls back to syncHandler when no workers exist. */
+  run(e) {
+    return this.destroyed ? Promise.reject(new Error("WorkerPool destroyed")) : this.workers.length === 0 ? this.syncFallback && this.syncHandler ? Promise.resolve(this.syncHandler(e)) : Promise.reject(new Error("No workers available and sync fallback disabled")) : new Promise((r, t) => {
+      const s = { resolve: r, reject: t, task: e };
+      this.timeoutMs > 0 && (s.timer = setTimeout(() => {
+        this.pending.has(e.id) && (this.pending.delete(e.id), this.settleWithSync(s));
+      }, this.timeoutMs)), this.pending.set(e.id, s);
+      const o = this.nextWorker;
+      this.nextWorker = (this.nextWorker + 1) % this.workers.length;
+      try {
+        this.workers[o].postMessage(e);
+      } catch (a) {
+        if (this.pending.delete(e.id), this.clearTaskTimer(s), this.syncFallback && this.syncHandler) {
+          Promise.resolve(this.syncHandler(e)).then(r).catch(t);
+          return;
+        }
+        t(a instanceof Error ? a : new Error(String(a)));
+      }
+    });
+  }
+  size() {
+    return this.workers.length;
+  }
+  pendingCount() {
+    return this.pending.size;
+  }
+  destroy() {
+    this.destroyed = !0;
+    for (const e of this.pending.values())
+      this.clearTaskTimer(e);
+    for (const e of this.workers)
+      e.terminate();
+    this.workers = [], this.pending.clear();
+  }
+}
+let c = 0;
+function y(n = "task") {
+  return c += 1, `${n}-${c}-${Date.now()}`;
+}
+export {
+  k as W,
+  y as n
+};
+//# sourceMappingURL=pool-DZ8shSqv.js.map

package/dist/pool-DZ8shSqv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool-DZ8shSqv.js","sources":["../src/workers/pool.ts"],"sourcesContent":["/**\n * Generic worker pool with round-robin dispatch and sync fallback.\n * @module workers/pool\n */\n\nexport interface WorkerPoolOptions {\n  /** Number of workers (default: 2) */\n  poolSize?: number;\n  /** Run tasks on main thread when Worker is unavailable */\n  syncFallback?: boolean;\n  /**\n   * If a worker never answers (common with broken Vite worker URLs in docs),\n   * fall back to syncHandler after this many ms (default: 250).\n   * Set 0 to disable.\n   */\n  timeoutMs?: number;\n}\n\nexport class WorkerPool<TMessage extends { id: string }, TResult = unknown> {\n  private workers: Worker[] = [];\n  private pending = new Map<\n    string,\n    {\n      resolve: (value: TResult) => void;\n      reject: (error: Error) => void;\n      task: TMessage;\n      timer?: ReturnType<typeof setTimeout>;\n    }\n  >();\n  private nextWorker = 0;\n  private readonly poolSize: number;\n  private readonly syncFallback: boolean;\n  private readonly timeoutMs: number;\n  private readonly workerFactory: () => Worker;\n  private readonly syncHandler?: (task: TMessage) => TResult | Promise<TResult>;\n  private destroyed = false;\n\n  constructor(\n    workerFactory: () => Worker,\n    options: WorkerPoolOptions & {\n      syncHandler?: (task: TMessage) => TResult | Promise<TResult>;\n    } = {},\n  ) {\n    this.workerFactory = workerFactory;\n    this.poolSize = options.poolSize ?? 2;\n    this.syncFallback = options.syncFallback ?? true;\n    this.timeoutMs = options.timeoutMs ?? 250;\n    this.syncHandler = options.syncHandler;\n\n    if (typeof Worker !== \"undefined\") {\n      for (let i = 0; i < this.poolSize; i++) {\n        this.spawnWorker();\n      }\n    }\n  }\n\n  private removeWorker(worker: Worker): void {\n    const index = this.workers.indexOf(worker);\n    if (index >= 0) this.workers.splice(index, 1);\n    worker.terminate();\n  }\n\n  private workerErrorMessage(event: Event): string {\n    const maybe = event as { message?: string };\n    if (typeof maybe.message === \"string\" && maybe.message) return maybe.message;\n    return \"Worker error\";\n  }\n\n  private rejectPendingWithSyncFallback(failedWorker: Worker, event: Event): void {\n    this.removeWorker(failedWorker);\n    const message = this.workerErrorMessage(event);\n    const entries = [...this.pending.entries()];\n    this.pending.clear();\n\n    for (const [, entry] of entries) {\n      this.clearTaskTimer(entry);\n      if (this.syncFallback && this.syncHandler) {\n        Promise.resolve(this.syncHandler(entry.task)).then(entry.resolve).catch(entry.reject);\n        continue;\n      }\n      entry.reject(new Error(message));\n    }\n  }\n\n  private clearTaskTimer(entry: { timer?: ReturnType<typeof setTimeout> }): void {\n    if (entry.timer !== undefined) clearTimeout(entry.timer);\n  }\n\n  private settleWithSync(entry: {\n    resolve: (value: TResult) => void;\n    reject: (error: Error) => void;\n    task: TMessage;\n  }): void {\n    if (this.syncFallback && this.syncHandler) {\n      Promise.resolve(this.syncHandler(entry.task)).then(entry.resolve).catch(entry.reject);\n      return;\n    }\n    entry.reject(new Error(\"Worker task timed out\"));\n  }\n\n  private spawnWorker(): void {\n    const worker = this.workerFactory();\n    worker.onmessage = (event: MessageEvent) => {\n      const data = event.data as { id?: string; type?: string; error?: string };\n      if (!data?.id) return;\n\n      const task = this.pending.get(data.id);\n      if (!task) return;\n\n      this.pending.delete(data.id);\n      this.clearTaskTimer(task);\n\n      if (data.type === \"error\" || data.error) {\n        if (this.syncFallback && this.syncHandler) {\n          this.settleWithSync(task);\n        } else {\n          task.reject(new Error(data.error ?? \"Worker task failed\"));\n        }\n        return;\n      }\n\n      task.resolve(data as TResult);\n    };\n\n    worker.onerror = (event) => {\n      this.rejectPendingWithSyncFallback(worker, event);\n    };\n\n    this.workers.push(worker);\n  }\n\n  /** Dispatch a task to the pool. Falls back to syncHandler when no workers exist. */\n  run(task: TMessage): Promise<TResult> {\n    if (this.destroyed) {\n      return Promise.reject(new Error(\"WorkerPool destroyed\"));\n    }\n\n    if (this.workers.length === 0) {\n      if (this.syncFallback && this.syncHandler) {\n        return Promise.resolve(this.syncHandler(task));\n      }\n      return Promise.reject(new Error(\"No workers available and sync fallback disabled\"));\n    }\n\n    return new Promise((resolve, reject) => {\n      const entry: {\n        resolve: (value: TResult) => void;\n        reject: (error: Error) => void;\n        task: TMessage;\n        timer?: ReturnType<typeof setTimeout>;\n      } = { resolve, reject, task };\n\n      if (this.timeoutMs > 0) {\n        entry.timer = setTimeout(() => {\n          if (!this.pending.has(task.id)) return;\n          this.pending.delete(task.id);\n          // Silent worker (Vite docs often loads a broken worker URL that never\n          // answers and never fires onerror) — fall back to main-thread calc.\n          this.settleWithSync(entry);\n        }, this.timeoutMs);\n      }\n\n      this.pending.set(task.id, entry);\n      const workerIndex = this.nextWorker;\n      this.nextWorker = (this.nextWorker + 1) % this.workers.length;\n      try {\n        this.workers[workerIndex].postMessage(task);\n      } catch (err) {\n        this.pending.delete(task.id);\n        this.clearTaskTimer(entry);\n        if (this.syncFallback && this.syncHandler) {\n          Promise.resolve(this.syncHandler(task)).then(resolve).catch(reject);\n          return;\n        }\n        reject(err instanceof Error ? err : new Error(String(err)));\n      }\n    });\n  }\n\n  size(): number {\n    return this.workers.length;\n  }\n\n  pendingCount(): number {\n    return this.pending.size;\n  }\n\n  destroy(): void {\n    this.destroyed = true;\n    for (const entry of this.pending.values()) {\n      this.clearTaskTimer(entry);\n    }\n    for (const worker of this.workers) {\n      worker.terminate();\n    }\n    this.workers = [];\n    this.pending.clear();\n  }\n}\n\nlet taskCounter = 0;\n\n/** Generate a unique task id */\nexport function nextTaskId(prefix = \"task\"): string {\n  taskCounter += 1;\n  return `${prefix}-${taskCounter}-${Date.now()}`;\n}\n"],"names":["WorkerPool","workerFactory","options","__publicField","i","worker","index","event","maybe","failedWorker","message","entries","entry","data","task","resolve","reject","workerIndex","err","taskCounter","nextTaskId","prefix"],"mappings":"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"}

package/dist/react/StackedPlot.d.ts

@@ -0,0 +1,31 @@
+import { CSSProperties } from 'react';
+import { UseStackedPlotOptions } from './useStackedPlot';
+import { StackedChart } from '../core/stacked';
+import { Bounds } from '../types';
+import { AddIndicatorOptions } from '../core/indicator/addIndicator';
+import { IndicatorPresetName } from '../core/indicator/indicatorPresets';
+
+export interface StackedPlotIndicator extends AddIndicatorOptions {
+    type: IndicatorPresetName;
+}
+export interface StackedPlotProps extends UseStackedPlotOptions {
+    width?: number | string;
+    height?: number | string;
+    className?: string;
+    style?: CSSProperties;
+    indicators?: StackedPlotIndicator[];
+    onCrosshairMove?: (event: {
+        price?: number;
+        x: number;
+    }) => void;
+    drawingTools?: string[];
+    ariaLabel?: string;
+}
+export interface StackedPlotRef {
+    getStack: () => StackedChart | null;
+    fitAll: () => void;
+    resetAll: () => void;
+    getBounds: () => Bounds | null;
+}
+export declare const StackedPlot: import('react').ForwardRefExoticComponent<StackedPlotProps & import('react').RefAttributes<StackedPlotRef>>;
+export default StackedPlot;

package/dist/react/VeloPlot.d.ts

@@ -0,0 +1,29 @@
+import { CSSProperties } from 'react';
+import { UseVeloPlotOptions } from './useVeloPlot';
+import { ZoomOptions, CursorOptions, Bounds } from '../types';
+import { Chart } from '../core/Chart';
+import { VeloPlotSeries } from '../bindings/shared';
+
+export type { VeloPlotSeries } from '../bindings/shared';
+export interface VeloPlotProps extends UseVeloPlotOptions {
+    series?: VeloPlotSeries[];
+    zoom?: ZoomOptions;
+    onZoomChange?: (bounds: Bounds) => void;
+    cursor?: CursorOptions;
+    width?: number | string;
+    height?: number | string;
+    className?: string;
+    style?: CSSProperties;
+    debug?: boolean;
+    /** Custom aria-label for accessibility */
+    ariaLabel?: string;
+    /** Enable keyboard navigation (default: true) */
+    keyboardNav?: boolean;
+}
+export interface VeloPlotRef {
+    getChart: () => Chart | null;
+    resetZoom: () => void;
+    getBounds: () => Bounds | null;
+}
+export declare const VeloPlot: import('react').ForwardRefExoticComponent<VeloPlotProps & import('react').RefAttributes<VeloPlotRef>>;
+export default VeloPlot;

package/dist/react/index.d.ts

@@ -1,6 +1,28 @@
+import { useVeloPlot as useVeloPlotImpl } from './useVeloPlot';
 /**
  * React bindings for Velo Plot
  */
-export { SciPlot, type SciPlotProps, type SciPlotRef, type SciPlotSeries } from './SciPlot';
-export { useSciPlot, type UseSciPlotOptions, type UseSciPlotReturn } from './useSciPlot';
-export { useStackedPlot, type UseStackedPlotOptions, type UseStackedPlotReturn } from './useStackedPlot';
+export { VeloPlot, type VeloPlotProps, type VeloPlotRef, type VeloPlotSeries, } from './VeloPlot';
+export { StackedPlot, type StackedPlotProps, type StackedPlotRef, type StackedPlotIndicator, } from './StackedPlot';
+export { useVeloPlot, type UseVeloPlotOptions, type UseVeloPlotReturn, } from './useVeloPlot';
+export { useStackedPlot, type UseStackedPlotOptions, type UseStackedPlotReturn, } from './useStackedPlot';
+export { useIndicator, type UseIndicatorReturn, } from './useIndicator';
+export { useChartSync, useChartGroup, type UseChartSyncReturn, } from './useChartSync';
+/**
+ * @deprecated Use `VeloPlot` instead. **Removed in v4.0.**
+ */
+export declare const SciPlot: import('react').ForwardRefExoticComponent<import('./VeloPlot').VeloPlotProps & import('react').RefAttributes<import('./VeloPlot').VeloPlotRef>>;
+/**
+ * @deprecated Use `VeloPlot` instead. **Removed in v4.0.**
+ */
+export declare const SciChart: import('react').ForwardRefExoticComponent<import('./VeloPlot').VeloPlotProps & import('react').RefAttributes<import('./VeloPlot').VeloPlotRef>>;
+/**
+ * @deprecated Use `useVeloPlot` instead. **Removed in v4.0.**
+ */
+export declare const useSciPlot: typeof useVeloPlotImpl;
+/**
+ * @deprecated Use `useVeloPlot` instead. **Removed in v4.0.**
+ */
+export declare const useSciChart: typeof useVeloPlotImpl;
+export type { VeloPlotProps as SciPlotProps, VeloPlotRef as SciPlotRef, VeloPlotSeries as SciPlotSeries, VeloPlotProps as SciChartProps, VeloPlotRef as SciChartRef, VeloPlotSeries as SciChartSeries, } from './VeloPlot';
+export type { UseVeloPlotOptions as UseSciPlotOptions, UseVeloPlotReturn as UseSciPlotReturn, UseVeloPlotOptions as UseSciChartOptions, UseVeloPlotReturn as UseSciChartReturn, } from './useVeloPlot';

package/dist/react/useChartSync.d.ts

@@ -0,0 +1,8 @@
+import { ChartLike, SyncOptions, ChartGroup } from '../core/sync';
+
+export interface UseChartSyncReturn {
+    group: ChartGroup | null;
+}
+export declare function useChartSync(charts: ChartLike[], options?: SyncOptions): UseChartSyncReturn;
+/** Alias matching roadmap naming (`useChartGroup` ≡ `useChartSync`). */
+export declare const useChartGroup: typeof useChartSync;

package/dist/react/useIndicator.d.ts

@@ -0,0 +1,12 @@
+import { AddIndicatorOptions, AddIndicatorResult } from '../core/indicator/addIndicator';
+import { IndicatorPresetName } from '../core/indicator/indicatorPresets';
+import { IndicatorHost } from '../bindings/shared';
+
+export interface UseIndicatorReturn {
+    result: (AddIndicatorResult & {
+        paneId?: string;
+    }) | null;
+    isLoading: boolean;
+    error: Error | null;
+}
+export declare function useIndicator(host: IndicatorHost, preset: IndicatorPresetName, options?: AddIndicatorOptions): UseIndicatorReturn;

package/dist/react/useVeloPlot.d.ts

@@ -0,0 +1,19 @@
+import { RefObject } from 'react';
+import { Chart } from '../core/Chart';
+import { SeriesOptions, SeriesUpdateData, ZoomOptions, Bounds } from '../types';
+import { ChartBindingOptions } from '../bindings/shared';
+
+export interface UseVeloPlotOptions extends ChartBindingOptions {
+}
+export interface UseVeloPlotReturn {
+    chart: Chart | null;
+    isReady: boolean;
+    error: Error | null;
+    bounds: Bounds | null;
+    addSeries: (options: SeriesOptions) => void;
+    updateSeries: (id: string, data: SeriesUpdateData) => void;
+    removeSeries: (id: string) => void;
+    zoom: (options: ZoomOptions) => void;
+    resetZoom: () => void;
+}
+export declare function useVeloPlot(containerRef: RefObject<HTMLDivElement>, options?: UseVeloPlotOptions): UseVeloPlotReturn;