velo-plot 1.11.1

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

@@ -0,0 +1,49 @@
+import { PluginContext, InteractionEvent, PluginManifest } from '../types';
+
+export interface RoiPoint {
+    x: number;
+    y: number;
+}
+export interface RoiRegion {
+    id: string;
+    tool: "rectangle" | "circle" | "polygon" | "lasso";
+    points: RoiPoint[];
+    color?: string;
+    fill?: string;
+}
+export interface RoiMaskResult {
+    regionId: string;
+    seriesId: string;
+    masks: boolean[];
+}
+export interface RoiSelectedEvent {
+    region: RoiRegion;
+    seriesIds: string[];
+    masks: RoiMaskResult[];
+}
+export interface RoiAPI {
+    setTool(tool: RoiTool): void;
+    clear(): void;
+    getRegions(): RoiRegion[];
+    removeRegion(id: string): void;
+    calculateMasks(regionId: string): RoiMaskResult[];
+    isEnabled(): boolean;
+    setEnabled(enabled: boolean): void;
+}
+export type RoiTool = "rectangle" | "circle" | "polygon" | "lasso";
+export interface PluginROIConfig {
+    defaultTool?: RoiTool;
+    stroke?: string;
+    fill?: string;
+    enabled?: boolean;
+    mask?: boolean;
+}
+export declare const PluginROI: (config?: PluginROIConfig) => {
+    manifest: PluginManifest;
+    onInit(pluginCtx: PluginContext): void;
+    onDestroy(): void;
+    onInteraction(_pluginCtx: PluginContext, event: InteractionEvent): void;
+    onRenderOverlay(pluginCtx: PluginContext): void;
+    api: RoiAPI;
+};
+export type RoiEvent = "roi:selected" | "roi:created" | "roi:cleared";

package/dist/plugins/roi/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview Types for ROI (Region of Interest) plugin
+ * @module plugins/roi/types
+ */
+export type RoiTool = "rectangle" | "polygon" | "lasso" | "circle";
+export interface RoiPoint {
+    x: number;
+    y: number;
+}
+export interface RoiRegion {
+    id: string;
+    tool: RoiTool;
+    points: RoiPoint[];
+    createdAt: number;
+}
+export interface RoiMaskResult {
+    seriesId: string;
+    indices: number[];
+}
+export interface PluginRoiConfig {
+    /** Enable ROI tools (default: true) */
+    enabled?: boolean;
+    /** Active tools (default: all) */
+    tools?: RoiTool[];
+    /** Active tool for creation (default: rectangle) */
+    defaultTool?: RoiTool;
+    /** Whether to mask (filter) data outside ROI (default: false) */
+    mask?: boolean;
+    /** Persistent regions (default: true) */
+    persistent?: boolean;
+    /** Allow additive selection (default: true) */
+    additive?: boolean;
+    /** Stroke color (default: theme accent) */
+    stroke?: string;
+    /** Fill color (default: rgba(0, 242, 255, 0.15)) */
+    fill?: string;
+    /** Line width (default: 1.5) */
+    lineWidth?: number;
+    /** Debug logging (default: false) */
+    debug?: boolean;
+}
+export interface RoiEvent {
+    region: RoiRegion;
+    seriesIds: string[];
+}
+export interface RoiSelectedEvent extends RoiEvent {
+    masks: RoiMaskResult[];
+}
+export interface RoiAPI {
+    setTool(tool: RoiTool): void;
+    getTool(): RoiTool;
+    enable(): void;
+    disable(): void;
+    isEnabled(): boolean;
+    clear(): void;
+    getRegions(): RoiRegion[];
+    selectRegion(id: string): RoiMaskResult[];
+    maskSeries(seriesId: string, indices: number[]): void;
+    updateConfig(config: Partial<PluginRoiConfig>): void;
+}

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

@@ -0,0 +1,11 @@
+import { ChartPlugin } from '../types';
+import { PluginSnapshotConfig } from './types';
+
+/**
+ * SciPlot Snapshot Plugin
+ *
+ * Captures the current chart view with all layers (WebGL + Overlay).
+ */
+export declare function PluginSnapshot(config?: PluginSnapshotConfig): ChartPlugin<PluginSnapshotConfig>;
+export default PluginSnapshot;
+export type { SnapshotFormat, SnapshotResolution, SnapshotExportOptions, SnapshotExportAPI, PluginSnapshotConfig } from './types';

package/dist/plugins/snapshot/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * SciPlot - Snapshot Export Plugin Types
+ */
+export type SnapshotFormat = 'png' | 'jpeg' | 'webp';
+/**
+ * Snapshot Resolution presets or scale factor
+ */
+export type SnapshotResolution = 'standard' | '2k' | '4k' | '8k' | number;
+export interface SnapshotExportOptions {
+    /** Image format (default: 'png') */
+    format?: SnapshotFormat;
+    /** Image quality 0-1 (for jpeg/webp) */
+    quality?: number;
+    /** Resolution preset or scale factor (default: 'standard') */
+    resolution?: SnapshotResolution;
+    /** Whether to include the background of the chart (default: true) */
+    includeBackground?: boolean;
+    /** Whether to include annotations and overlays (default: true) */
+    includeOverlays?: boolean;
+    /** Custom watermark text */
+    watermarkText?: string;
+    /** Transparent background (only for png/webp) */
+    transparent?: boolean;
+    /** Filename for download */
+    fileName?: string;
+    /** Whether to trigger automatic download */
+    download?: boolean;
+}
+export interface SnapshotExportAPI {
+    /** Takes a snapshot and returns the data URL or Blob */
+    takeSnapshot(options?: SnapshotExportOptions): Promise<string | Blob>;
+    /** Takes a snapshot and triggers a browser download */
+    downloadSnapshot(options?: SnapshotExportOptions): Promise<void>;
+}
+export interface PluginSnapshotConfig {
+    /** Default options for all snapshots */
+    defaultOptions?: SnapshotExportOptions;
+}

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

@@ -0,0 +1,32 @@
+import { ChartPlugin } from '../types';
+/**
+ * Sci Plot - Streaming Plugin
+ *
+ * Provides real-time data streaming capabilities including:
+ * - WebSocket connections
+ * - Backpressure management
+ * - Mock data streaming for testing
+ *
+ * @module plugins/streaming
+ */
+export { createWebSocketStream, } from '../../streaming/websocket';
+export { connectStreamToChart, createMessageParser, } from '../../streaming/utils';
+export { BackpressureManager, CircularBuffer, createBackpressureManager, } from '../../streaming/backpressure';
+export { createMockStream } from '../../streaming/mock';
+export * from '../../streaming/types';
+export interface PluginStreamingConfig {
+    /** Default WebSocket URL */
+    url?: string;
+    /** Backpressure strategy */
+    backpressure?: {
+        maxBufferSize?: number;
+        overflowStrategy?: "drop-oldest" | "drop-newest" | "error";
+    };
+}
+/**
+ * SciPlot Streaming Plugin
+ *
+ * Enables seamless integration with real-time data sources.
+ */
+export declare function PluginStreaming(_config?: PluginStreamingConfig): ChartPlugin<PluginStreamingConfig>;
+export default PluginStreaming;

package/dist/plugins/streaming.d.ts

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

package/dist/plugins/streaming.js

@@ -0,0 +1,13 @@
+import { B as r, C as s, P as t, a as c, e as n, b as o, d as u, c as g, P as m } from "../index-BMiZoKmm.js";
+export {
+  r as BackpressureManager,
+  s as CircularBuffer,
+  t as PluginStreaming,
+  c as connectStreamToChart,
+  n as createBackpressureManager,
+  o as createMessageParser,
+  u as createMockStream,
+  g as createWebSocketStream,
+  m as default
+};
+//# sourceMappingURL=streaming.js.map

package/dist/plugins/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

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

@@ -0,0 +1,22 @@
+import { ChartPlugin } from '../types';
+/**
+ * SciPlot Engine - Chart Sync Plugin
+ *
+ * Provides synchronization between multiple chart instances.
+ *
+ * @module plugins/sync
+ */
+export * from '../../core/sync';
+export interface PluginSyncConfig {
+    /** Group ID to join */
+    groupId?: string;
+    /** Sync axes: 'x' | 'y' | 'both' */
+    syncAxes?: "x" | "y" | "both";
+}
+/**
+ * SciPlot Sync Plugin
+ *
+ * Enables smooth coordination and synchronization between separate chart instances.
+ */
+export declare function PluginSync(config?: PluginSyncConfig): ChartPlugin<PluginSyncConfig>;
+export default PluginSync;

package/dist/plugins/sync.d.ts

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

package/dist/plugins/sync.js

@@ -0,0 +1,261 @@
+var h = Object.defineProperty;
+var l = (o, t, s) => t in o ? h(o, t, { enumerable: !0, configurable: !0, writable: !0, value: s }) : o[t] = s;
+var a = (o, t, s) => l(o, typeof t != "symbol" ? t + "" : t, s);
+class c {
+  constructor(t) {
+    a(this, "charts", /* @__PURE__ */ new Map());
+    a(this, "options");
+    a(this, "eventHandlers", /* @__PURE__ */ new Map());
+    a(this, "isUpdating", !1);
+    a(this, "debounceTimers", /* @__PURE__ */ new Map());
+    this.options = {
+      axis: "x",
+      syncCursor: !0,
+      syncSelection: !1,
+      syncZoom: !0,
+      syncPan: !0,
+      debounce: 0,
+      bidirectional: !0,
+      ...t
+    };
+  }
+  /**
+   * Add a chart to the group
+   */
+  add(t) {
+    const s = t.getId();
+    return this.charts.has(s) ? (console.warn(`[ChartGroup] Chart ${s} is already in the group`), this) : (this.charts.set(s, t), this.attachEventHandlers(t), this);
+  }
+  /**
+   * Add multiple charts at once
+   */
+  addAll(...t) {
+    for (const s of t)
+      this.add(s);
+    return this;
+  }
+  /**
+   * Remove a chart from the group
+   */
+  remove(t) {
+    const s = t.getId();
+    return this.charts.has(s) ? (this.detachEventHandlers(t), this.charts.delete(s), this) : this;
+  }
+  /**
+   * Get all charts in the group
+   */
+  getCharts() {
+    return Array.from(this.charts.values());
+  }
+  /**
+   * Get chart count
+   */
+  size() {
+    return this.charts.size;
+  }
+  /**
+   * Check if a chart is in the group
+   */
+  has(t) {
+    return this.charts.has(t.getId());
+  }
+  /**
+   * Set synchronization axis
+   */
+  syncAxis(t) {
+    return this.options.axis = t, this;
+  }
+  /**
+   * Enable/disable cursor synchronization
+   */
+  syncCursor(t) {
+    return this.options.syncCursor = t, this;
+  }
+  /**
+   * Enable/disable selection synchronization
+   */
+  syncSelection(t) {
+    return this.options.syncSelection = t, this;
+  }
+  /**
+   * Synchronize all charts to a specific view
+   */
+  syncTo(t, s) {
+    this.propagateZoom(s || "", t);
+  }
+  /**
+   * Reset all charts to auto-scale
+   */
+  resetAll() {
+    for (const t of this.charts.values())
+      t.zoom({ x: void 0, y: void 0 });
+  }
+  /**
+   * Clear all selections in the group
+   */
+  clearAllSelections() {
+    var t;
+    for (const s of this.charts.values())
+      (t = s.clearSelection) == null || t.call(s);
+  }
+  /**
+   * Destroy the group and cleanup
+   */
+  destroy() {
+    for (const t of this.charts.values())
+      this.detachEventHandlers(t);
+    this.charts.clear(), this.eventHandlers.clear();
+    for (const t of this.debounceTimers.values())
+      clearTimeout(t);
+    this.debounceTimers.clear();
+  }
+  // ============================================
+  // Private Methods
+  // ============================================
+  attachEventHandlers(t) {
+    const s = t.getId(), i = /* @__PURE__ */ new Map();
+    if (this.options.syncZoom) {
+      const n = (...e) => {
+        const r = e[0];
+        this.handleZoom(s, r);
+      };
+      t.on("zoom", n), i.set("zoom", n);
+    }
+    if (this.options.syncPan) {
+      const n = (...e) => {
+        const r = e[0];
+        this.handlePan(s, r);
+      };
+      t.on("pan", n), i.set("pan", n);
+    }
+    if (this.options.syncCursor) {
+      const n = (...e) => {
+        const r = e[0];
+        this.handleCursor(s, r);
+      };
+      t.on("hover", n), i.set("hover", n);
+    }
+    if (this.options.syncSelection) {
+      const n = (...e) => {
+        const r = e[0];
+        this.handleSelection(s, r);
+      };
+      t.on("selectionChange", n), i.set("selectionChange", n);
+    }
+    this.eventHandlers.set(s, i);
+  }
+  detachEventHandlers(t) {
+    const s = t.getId(), i = this.eventHandlers.get(s);
+    if (i) {
+      for (const [n, e] of i.entries())
+        t.off(n, e);
+      this.eventHandlers.delete(s);
+    }
+  }
+  handleZoom(t, s) {
+    if (this.isUpdating) return;
+    const i = {};
+    (this.options.axis === "x" || this.options.axis === "xy") && (i.xMin = s.x[0], i.xMax = s.x[1]), (this.options.axis === "y" || this.options.axis === "xy") && (i.yMin = s.y[0], i.yMax = s.y[1]), this.debounceAction(`zoom-${t}`, () => {
+      this.propagateZoom(t, i);
+    });
+  }
+  handlePan(t, s) {
+    if (this.isUpdating) return;
+    const i = this.options.axis === "x" || this.options.axis === "xy" ? s.deltaX : 0, n = this.options.axis === "y" || this.options.axis === "xy" ? s.deltaY : 0;
+    i === 0 && n === 0 || this.debounceAction(`pan-${t}`, () => {
+      this.propagatePan(t, i, n);
+    });
+  }
+  handleCursor(t, s) {
+    var i, n;
+    if (!this.isUpdating)
+      for (const [e, r] of this.charts.entries())
+        e !== t && (s != null && s.point ? (i = r.setExternalCursor) == null || i.call(r, s.point.x, s.point.y) : (n = r.clearExternalCursor) == null || n.call(r));
+  }
+  handleSelection(t, s) {
+    if (!(this.isUpdating || !this.options.syncSelection))
+      for (const [i, n] of this.charts.entries())
+        ;
+  }
+  propagateZoom(t, s) {
+    if (!this.isUpdating) {
+      this.isUpdating = !0;
+      try {
+        for (const [i, n] of this.charts.entries()) {
+          if (i === t && !this.options.bidirectional || i === t) continue;
+          const e = {
+            animate: !1
+          };
+          s.xMin !== void 0 && s.xMax !== void 0 && (e.x = [s.xMin, s.xMax]), s.yMin !== void 0 && s.yMax !== void 0 && (e.y = [s.yMin, s.yMax]), n.zoom(e);
+        }
+      } finally {
+        this.isUpdating = !1;
+      }
+    }
+  }
+  propagatePan(t, s, i) {
+    if (!this.isUpdating) {
+      this.isUpdating = !0;
+      try {
+        for (const [n, e] of this.charts.entries())
+          n !== t && e.pan(s, i);
+      } finally {
+        this.isUpdating = !1;
+      }
+    }
+  }
+  debounceAction(t, s) {
+    if (this.options.debounce <= 0) {
+      s();
+      return;
+    }
+    const i = this.debounceTimers.get(t);
+    i && clearTimeout(i);
+    const n = window.setTimeout(() => {
+      this.debounceTimers.delete(t), s();
+    }, this.options.debounce);
+    this.debounceTimers.set(t, n);
+  }
+}
+function d(o, t) {
+  const s = new c(t);
+  return s.addAll(...o), s;
+}
+function p(o, t, s) {
+  return d([o, t], s);
+}
+function y(o, t, s = "x") {
+  return new c({
+    axis: s,
+    bidirectional: !1,
+    syncCursor: !0,
+    syncZoom: !0,
+    syncPan: !0
+  }).addAll(o, t);
+}
+const u = {
+  name: "velo-plot-sync",
+  version: "1.0.0",
+  description: "Multi-chart synchronization for velo-plot",
+  provides: ["interaction"],
+  tags: ["sync", "multi-chart", "coordination"]
+};
+function x(o = {}) {
+  return {
+    manifest: u,
+    onInit(t) {
+      o.groupId;
+    },
+    onDestroy(t) {
+    }
+  };
+}
+export {
+  c as ChartGroup,
+  x as PluginSync,
+  d as createChartGroup,
+  y as createMasterSlave,
+  x as default,
+  p as linkCharts
+};
+//# sourceMappingURL=sync.js.map

package/dist/plugins/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sources":["../../src/core/sync/index.ts","../../src/plugins/sync/index.ts"],"sourcesContent":["/**\n * Sci Plot - Chart Synchronization Module\n * \n * Provides synchronization between multiple charts:\n * - Synchronized zoom/pan (X, Y, or both)\n * - Shared crosshair cursor\n * - Coordinated selection\n * - Event propagation between linked charts\n * \n * @module sync\n */\n\nimport type { Bounds, Range } from \"../../types\";\n\n// ============================================\n// Types\n// ============================================\n\nexport type SyncAxis = 'x' | 'y' | 'xy' | 'none';\n\nexport interface SyncOptions {\n  /** Synchronize axis (default: 'x') */\n  axis?: SyncAxis;\n  /** Synchronize cursor position (default: true) */\n  syncCursor?: boolean;\n  /** Synchronize selection state (default: false) */\n  syncSelection?: boolean;\n  /** Synchronize zoom level (default: true) */\n  syncZoom?: boolean;\n  /** Synchronize pan (default: true) */\n  syncPan?: boolean;\n  /** Debounce time for sync events in ms (default: 0) */\n  debounce?: number;\n  /** Enable bidirectional sync (default: true) */\n  bidirectional?: boolean;\n}\n\nexport interface ChartLike {\n  /** Unique identifier for the chart */\n  getId(): string;\n  /** Get current view bounds */\n  getViewBounds(): Bounds;\n  /** Set view bounds (zoom) */\n  zoom(options: { x?: Range; y?: Range; animate?: boolean }): void;\n  /** Pan the chart */\n  pan(dx: number, dy: number): void;\n  /** Get cursor position */\n  getCursorPosition?(): { x: number; y: number } | null;\n  /** Set external cursor position */\n  setExternalCursor?(x: number, y: number): void;\n  /** Clear external cursor */\n  clearExternalCursor?(): void;\n  /** Get selected points */\n  getSelectedPoints?(): { seriesId: string; indices: number[] }[];\n  /** Set selection */\n  selectPoints?(points: { seriesId: string; indices: number[] }[]): void;\n  /** Clear selection */\n  clearSelection?(): void;\n  /** Subscribe to events */\n  on(event: string, callback: (...args: unknown[]) => void): void;\n  /** Unsubscribe from events */\n  off(event: string, callback: (...args: unknown[]) => void): void;\n}\n\nexport interface SyncEvent {\n  /** Source chart ID */\n  sourceId: string;\n  /** Event type */\n  type: 'zoom' | 'pan' | 'cursor' | 'selection' | 'bounds';\n  /** Event data */\n  data: unknown;\n}\n\n// ============================================\n// Chart Group Implementation\n// ============================================\n\nexport class ChartGroup {\n  private charts: Map<string, ChartLike> = new Map();\n  private options: Required<SyncOptions>;\n  private eventHandlers: Map<string, Map<string, (...args: unknown[]) => void>> = new Map();\n  private isUpdating: boolean = false;\n  private debounceTimers: Map<string, number> = new Map();\n\n  constructor(options?: SyncOptions) {\n    this.options = {\n      axis: 'x',\n      syncCursor: true,\n      syncSelection: false,\n      syncZoom: true,\n      syncPan: true,\n      debounce: 0,\n      bidirectional: true,\n      ...options,\n    };\n  }\n\n  /**\n   * Add a chart to the group\n   */\n  add(chart: ChartLike): this {\n    const chartId = chart.getId();\n    \n    if (this.charts.has(chartId)) {\n      console.warn(`[ChartGroup] Chart ${chartId} is already in the group`);\n      return this;\n    }\n\n    this.charts.set(chartId, chart);\n    this.attachEventHandlers(chart);\n    \n    return this;\n  }\n\n  /**\n   * Add multiple charts at once\n   */\n  addAll(...charts: ChartLike[]): this {\n    for (const chart of charts) {\n      this.add(chart);\n    }\n    return this;\n  }\n\n  /**\n   * Remove a chart from the group\n   */\n  remove(chart: ChartLike): this {\n    const chartId = chart.getId();\n    \n    if (!this.charts.has(chartId)) {\n      return this;\n    }\n\n    this.detachEventHandlers(chart);\n    this.charts.delete(chartId);\n    \n    return this;\n  }\n\n  /**\n   * Get all charts in the group\n   */\n  getCharts(): ChartLike[] {\n    return Array.from(this.charts.values());\n  }\n\n  /**\n   * Get chart count\n   */\n  size(): number {\n    return this.charts.size;\n  }\n\n  /**\n   * Check if a chart is in the group\n   */\n  has(chart: ChartLike): boolean {\n    return this.charts.has(chart.getId());\n  }\n\n  /**\n   * Set synchronization axis\n   */\n  syncAxis(axis: SyncAxis): this {\n    this.options.axis = axis;\n    return this;\n  }\n\n  /**\n   * Enable/disable cursor synchronization\n   */\n  syncCursor(enabled: boolean): this {\n    this.options.syncCursor = enabled;\n    return this;\n  }\n\n  /**\n   * Enable/disable selection synchronization\n   */\n  syncSelection(enabled: boolean): this {\n    this.options.syncSelection = enabled;\n    return this;\n  }\n\n  /**\n   * Synchronize all charts to a specific view\n   */\n  syncTo(bounds: Partial<Bounds>, excludeChartId?: string): void {\n    this.propagateZoom(excludeChartId || '', bounds);\n  }\n\n  /**\n   * Reset all charts to auto-scale\n   */\n  resetAll(): void {\n    for (const chart of this.charts.values()) {\n      chart.zoom({ x: undefined, y: undefined });\n    }\n  }\n\n  /**\n   * Clear all selections in the group\n   */\n  clearAllSelections(): void {\n    for (const chart of this.charts.values()) {\n      chart.clearSelection?.();\n    }\n  }\n\n  /**\n   * Destroy the group and cleanup\n   */\n  destroy(): void {\n    for (const chart of this.charts.values()) {\n      this.detachEventHandlers(chart);\n    }\n    this.charts.clear();\n    this.eventHandlers.clear();\n    \n    // Clear any pending debounce timers\n    for (const timerId of this.debounceTimers.values()) {\n      clearTimeout(timerId);\n    }\n    this.debounceTimers.clear();\n  }\n\n  // ============================================\n  // Private Methods\n  // ============================================\n\n  private attachEventHandlers(chart: ChartLike): void {\n    const chartId = chart.getId();\n    const handlers = new Map<string, (...args: unknown[]) => void>();\n\n    // Zoom handler\n    if (this.options.syncZoom) {\n      const zoomHandler = (...args: unknown[]) => {\n        const e = args[0] as { x: Range; y: Range };\n        this.handleZoom(chartId, e);\n      };\n      chart.on('zoom', zoomHandler);\n      handlers.set('zoom', zoomHandler);\n    }\n\n    // Pan handler\n    if (this.options.syncPan) {\n      const panHandler = (...args: unknown[]) => {\n        const e = args[0] as { deltaX: number; deltaY: number };\n        this.handlePan(chartId, e);\n      };\n      chart.on('pan', panHandler);\n      handlers.set('pan', panHandler);\n    }\n\n    // Cursor handler\n    if (this.options.syncCursor) {\n      const hoverHandler = (...args: unknown[]) => {\n        const e = args[0] as { point?: { x: number; y: number } } | null;\n        this.handleCursor(chartId, e);\n      };\n      chart.on('hover', hoverHandler);\n      handlers.set('hover', hoverHandler);\n    }\n\n    // Selection handler\n    if (this.options.syncSelection) {\n      const selectionHandler = (...args: unknown[]) => {\n        const e = args[0] as { selected: unknown[] };\n        this.handleSelection(chartId, e);\n      };\n      chart.on('selectionChange', selectionHandler);\n      handlers.set('selectionChange', selectionHandler);\n    }\n\n    this.eventHandlers.set(chartId, handlers);\n  }\n\n  private detachEventHandlers(chart: ChartLike): void {\n    const chartId = chart.getId();\n    const handlers = this.eventHandlers.get(chartId);\n    \n    if (!handlers) return;\n\n    for (const [event, handler] of handlers.entries()) {\n      chart.off(event, handler);\n    }\n\n    this.eventHandlers.delete(chartId);\n  }\n\n  private handleZoom(sourceId: string, event: { x: Range; y: Range }): void {\n    if (this.isUpdating) return;\n    \n    const bounds: Partial<Bounds> = {};\n    \n    if (this.options.axis === 'x' || this.options.axis === 'xy') {\n      bounds.xMin = event.x[0];\n      bounds.xMax = event.x[1];\n    }\n    \n    if (this.options.axis === 'y' || this.options.axis === 'xy') {\n      bounds.yMin = event.y[0];\n      bounds.yMax = event.y[1];\n    }\n\n    this.debounceAction(`zoom-${sourceId}`, () => {\n      this.propagateZoom(sourceId, bounds);\n    });\n  }\n\n  private handlePan(sourceId: string, event: { deltaX: number; deltaY: number }): void {\n    if (this.isUpdating) return;\n\n    const dx = (this.options.axis === 'x' || this.options.axis === 'xy') ? event.deltaX : 0;\n    const dy = (this.options.axis === 'y' || this.options.axis === 'xy') ? event.deltaY : 0;\n\n    if (dx === 0 && dy === 0) return;\n\n    this.debounceAction(`pan-${sourceId}`, () => {\n      this.propagatePan(sourceId, dx, dy);\n    });\n  }\n\n  private handleCursor(sourceId: string, event: { point?: { x: number; y: number } } | null): void {\n    if (this.isUpdating) return;\n\n    for (const [chartId, chart] of this.charts.entries()) {\n      if (chartId === sourceId) continue;\n      \n      if (event?.point) {\n        chart.setExternalCursor?.(event.point.x, event.point.y);\n      } else {\n        chart.clearExternalCursor?.();\n      }\n    }\n  }\n\n  private handleSelection(sourceId: string, _event: { selected: unknown[] }): void {\n    if (this.isUpdating || !this.options.syncSelection) return;\n\n    // Selection sync is more complex - we need to map indices across charts\n    // For now, just clear selection on other charts when one changes\n    for (const [chartId, _chart] of this.charts.entries()) {\n      if (chartId === sourceId) continue;\n      // In a full implementation, you'd map selection by data values\n      // For basic sync, we just notify that selection changed\n    }\n  }\n\n  private propagateZoom(sourceId: string, bounds: Partial<Bounds>): void {\n    if (this.isUpdating) return;\n    \n    this.isUpdating = true;\n\n    try {\n      for (const [chartId, chart] of this.charts.entries()) {\n        if (chartId === sourceId && !this.options.bidirectional) continue;\n        if (chartId === sourceId) continue;\n\n        const zoomOptions: { x?: Range; y?: Range; animate?: boolean } = {\n          animate: false,\n        };\n\n        if (bounds.xMin !== undefined && bounds.xMax !== undefined) {\n          zoomOptions.x = [bounds.xMin, bounds.xMax];\n        }\n\n        if (bounds.yMin !== undefined && bounds.yMax !== undefined) {\n          zoomOptions.y = [bounds.yMin, bounds.yMax];\n        }\n\n        chart.zoom(zoomOptions);\n      }\n    } finally {\n      this.isUpdating = false;\n    }\n  }\n\n  private propagatePan(sourceId: string, dx: number, dy: number): void {\n    if (this.isUpdating) return;\n    \n    this.isUpdating = true;\n\n    try {\n      for (const [chartId, chart] of this.charts.entries()) {\n        if (chartId === sourceId) continue;\n        chart.pan(dx, dy);\n      }\n    } finally {\n      this.isUpdating = false;\n    }\n  }\n\n  private debounceAction(key: string, action: () => void): void {\n    if (this.options.debounce <= 0) {\n      action();\n      return;\n    }\n\n    // Clear existing timer\n    const existingTimer = this.debounceTimers.get(key);\n    if (existingTimer) {\n      clearTimeout(existingTimer);\n    }\n\n    // Set new timer\n    const timerId = window.setTimeout(() => {\n      this.debounceTimers.delete(key);\n      action();\n    }, this.options.debounce);\n\n    this.debounceTimers.set(key, timerId);\n  }\n}\n\n// ============================================\n// Convenience Functions\n// ============================================\n\n/**\n * Create a chart group with specified charts\n */\nexport function createChartGroup(\n  charts: ChartLike[],\n  options?: SyncOptions\n): ChartGroup {\n  const group = new ChartGroup(options);\n  group.addAll(...charts);\n  return group;\n}\n\n/**\n * Link two charts for synchronized viewing\n */\nexport function linkCharts(\n  chart1: ChartLike,\n  chart2: ChartLike,\n  options?: SyncOptions\n): ChartGroup {\n  return createChartGroup([chart1, chart2], options);\n}\n\n/**\n * Create a master-slave relationship (master controls slave)\n */\nexport function createMasterSlave(\n  master: ChartLike,\n  slave: ChartLike,\n  axis: SyncAxis = 'x'\n): ChartGroup {\n  return new ChartGroup({\n    axis,\n    bidirectional: false,\n    syncCursor: true,\n    syncZoom: true,\n    syncPan: true,\n  }).addAll(master, slave);\n}\n","/**\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 * Enables smooth coordination and synchronization between separate chart instances.\n */\nexport function PluginSync(config: PluginSyncConfig = {}): ChartPlugin<PluginSyncConfig> {\n    void config;\n    return {\n        manifest: manifestSync,\n\n        onInit(_ctx: PluginContext) {   \n            if (config.groupId) {\n                // Join the specified group\n            }\n        },\n\n        onDestroy(_ctx: PluginContext) {\n        }\n    };\n}\n\nexport default PluginSync;\n"],"names":["ChartGroup","options","__publicField","chart","chartId","charts","axis","enabled","bounds","excludeChartId","_a","timerId","handlers","zoomHandler","args","e","panHandler","hoverHandler","selectionHandler","event","handler","sourceId","dx","dy","_b","_event","_chart","zoomOptions","key","action","existingTimer","createChartGroup","group","linkCharts","chart1","chart2","createMasterSlave","master","slave","manifestSync","PluginSync","config","_ctx"],"mappings":"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"}

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

@@ -0,0 +1,18 @@
+import { ThemeEditor, EditorTheme, ThemePreset } from '../../core/theme-editor';
+import { ChartPlugin } from '../types';
+
+export interface PluginThemeEditorConfig {
+    /** Initial theme to edit */
+    initialTheme?: string;
+    /** Position in the UI */
+    position?: "left" | "right";
+}
+/**
+ * SciPlot Theme Editor Plugin
+ *
+ * Adds a visual panel to customize chart colors and styles.
+ */
+export declare function PluginThemeEditor(_config?: PluginThemeEditorConfig): ChartPlugin<PluginThemeEditorConfig>;
+export { ThemeEditor };
+export type { EditorTheme, ThemePreset };
+export default PluginThemeEditor;

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

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

package/dist/plugins/theme-editor.js

@@ -0,0 +1,7 @@
+import { P as o, T as r, P as t } from "../index-Dag88bW4.js";
+export {
+  o as PluginThemeEditor,
+  r as ThemeEditor,
+  t as default
+};
+//# sourceMappingURL=theme-editor.js.map

package/dist/plugins/theme-editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-editor.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}