velo-plot 1.11.1

package/dist/plugins/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sources":["../../src/core/clipboard/index.ts","../../src/plugins/clipboard/index.ts"],"sourcesContent":["/**\n * Sci Plot - Clipboard Module\n * \n * Provides clipboard operations for copying chart data to various formats.\n * Supports copying selected points, visible data, or all data.\n * \n * @module clipboard\n */\n\n// ============================================\n// Types\n// ============================================\n\nexport type ClipboardFormat = 'tsv' | 'csv' | 'json' | 'markdown';\n\nexport interface ClipboardOptions {\n  /** Output format (default: 'tsv' - Excel compatible) */\n  format?: ClipboardFormat;\n  /** Include column headers (default: true) */\n  includeHeaders?: boolean;\n  /** Decimal precision (default: 6) */\n  precision?: number;\n  /** Use scientific notation for very large/small numbers (default: true) */\n  scientific?: boolean;\n  /** Scientific notation threshold (default: 1e6) */\n  scientificThreshold?: number;\n  /** Custom column separator (overrides format default) */\n  separator?: string;\n  /** Custom line separator (default: '\\n') */\n  lineSeparator?: string;\n  /** Include series name in output (default: true for multi-series) */\n  includeSeriesName?: boolean;\n  /** Custom header names */\n  headers?: {\n    x?: string;\n    y?: string;\n    series?: string;\n  };\n}\n\nexport interface ClipboardDataPoint {\n  x: number;\n  y: number;\n  seriesId?: string;\n  seriesName?: string;\n  index?: number;\n}\n\nexport interface ClipboardResult {\n  /** Whether the copy was successful */\n  success: boolean;\n  /** Number of points copied */\n  pointCount: number;\n  /** Number of series included */\n  seriesCount: number;\n  /** The formatted text that was copied */\n  text?: string;\n  /** Error message if failed */\n  error?: string;\n}\n\n// ============================================\n// Format Helpers\n// ============================================\n\nconst FORMAT_CONFIGS: Record<ClipboardFormat, { separator: string; quote: boolean; extension: string }> = {\n  tsv: { separator: '\\t', quote: false, extension: 'tsv' },\n  csv: { separator: ',', quote: true, extension: 'csv' },\n  json: { separator: '', quote: false, extension: 'json' },\n  markdown: { separator: ' | ', quote: false, extension: 'md' },\n};\n\n// ============================================\n// Clipboard Manager\n// ============================================\n\nexport class ClipboardManager {\n  private defaultOptions: ClipboardOptions = {\n    format: 'tsv',\n    includeHeaders: true,\n    precision: 6,\n    scientific: true,\n    scientificThreshold: 1e6,\n    lineSeparator: '\\n',\n    includeSeriesName: false,\n  };\n\n  constructor(options?: Partial<ClipboardOptions>) {\n    if (options) {\n      this.defaultOptions = { ...this.defaultOptions, ...options };\n    }\n  }\n\n  /**\n   * Copy data points to clipboard\n   */\n  async copyPoints(\n    points: ClipboardDataPoint[],\n    options?: Partial<ClipboardOptions>\n  ): Promise<ClipboardResult> {\n    const opts = { ...this.defaultOptions, ...options };\n    \n    if (!points || points.length === 0) {\n      return {\n        success: false,\n        pointCount: 0,\n        seriesCount: 0,\n        error: 'No data points to copy',\n      };\n    }\n\n    try {\n      const text = this.formatPoints(points, opts);\n      await this.writeToClipboard(text);\n\n      const seriesIds = new Set(points.map(p => p.seriesId).filter(Boolean));\n      \n      return {\n        success: true,\n        pointCount: points.length,\n        seriesCount: seriesIds.size || 1,\n        text,\n      };\n    } catch (error) {\n      return {\n        success: false,\n        pointCount: 0,\n        seriesCount: 0,\n        error: error instanceof Error ? error.message : 'Failed to copy to clipboard',\n      };\n    }\n  }\n\n  /**\n   * Copy series data to clipboard\n   */\n  async copySeries(\n    seriesData: { id: string; name?: string; x: Float32Array | Float64Array; y: Float32Array | Float64Array }[],\n    options?: Partial<ClipboardOptions>\n  ): Promise<ClipboardResult> {\n    const points: ClipboardDataPoint[] = [];\n    \n    for (const series of seriesData) {\n      for (let i = 0; i < series.x.length; i++) {\n        points.push({\n          x: series.x[i],\n          y: series.y[i],\n          seriesId: series.id,\n          seriesName: series.name || series.id,\n          index: i,\n        });\n      }\n    }\n\n    // Enable series name if multiple series\n    const opts = { ...options };\n    if (seriesData.length > 1 && opts.includeSeriesName === undefined) {\n      opts.includeSeriesName = true;\n    }\n\n    return this.copyPoints(points, opts);\n  }\n\n  /**\n   * Format data points to string\n   */\n  formatPoints(points: ClipboardDataPoint[], options: ClipboardOptions): string {\n    const format = options.format || 'tsv';\n    \n    if (format === 'json') {\n      return this.formatAsJson(points, options);\n    }\n    \n    if (format === 'markdown') {\n      return this.formatAsMarkdown(points, options);\n    }\n\n    return this.formatAsDelimited(points, options);\n  }\n\n  /**\n   * Format as delimited text (TSV/CSV)\n   */\n  private formatAsDelimited(points: ClipboardDataPoint[], options: ClipboardOptions): string {\n    const format = options.format || 'tsv';\n    const config = FORMAT_CONFIGS[format];\n    const separator = options.separator || config.separator;\n    const lineSeparator = options.lineSeparator || '\\n';\n    const lines: string[] = [];\n\n    // Headers\n    if (options.includeHeaders) {\n      const headerParts: string[] = [];\n      if (options.includeSeriesName) {\n        headerParts.push(options.headers?.series || 'Series');\n      }\n      headerParts.push(options.headers?.x || 'X');\n      headerParts.push(options.headers?.y || 'Y');\n      lines.push(headerParts.join(separator));\n    }\n\n    // Data rows\n    for (const point of points) {\n      const rowParts: string[] = [];\n      \n      if (options.includeSeriesName) {\n        const seriesName = point.seriesName || point.seriesId || '';\n        rowParts.push(config.quote ? `\"${seriesName}\"` : seriesName);\n      }\n      \n      rowParts.push(this.formatNumber(point.x, options));\n      rowParts.push(this.formatNumber(point.y, options));\n      \n      lines.push(rowParts.join(separator));\n    }\n\n    return lines.join(lineSeparator);\n  }\n\n  /**\n   * Format as JSON\n   */\n  private formatAsJson(points: ClipboardDataPoint[], options: ClipboardOptions): string {\n    const data = points.map(p => {\n      const obj: Record<string, unknown> = {\n        x: this.roundNumber(p.x, options.precision || 6),\n        y: this.roundNumber(p.y, options.precision || 6),\n      };\n      if (options.includeSeriesName && p.seriesId) {\n        obj.series = p.seriesName || p.seriesId;\n      }\n      return obj;\n    });\n\n    return JSON.stringify(data, null, 2);\n  }\n\n  /**\n   * Format as Markdown table\n   */\n  private formatAsMarkdown(points: ClipboardDataPoint[], options: ClipboardOptions): string {\n    const lines: string[] = [];\n    const separator = ' | ';\n\n    // Header\n    const headerParts: string[] = [];\n    if (options.includeSeriesName) {\n      headerParts.push(options.headers?.series || 'Series');\n    }\n    headerParts.push(options.headers?.x || 'X');\n    headerParts.push(options.headers?.y || 'Y');\n    \n    lines.push('| ' + headerParts.join(separator) + ' |');\n    \n    // Separator row\n    const sepRow = headerParts.map(() => '---');\n    lines.push('| ' + sepRow.join(separator) + ' |');\n\n    // Data rows\n    for (const point of points) {\n      const rowParts: string[] = [];\n      \n      if (options.includeSeriesName) {\n        rowParts.push(point.seriesName || point.seriesId || '');\n      }\n      \n      rowParts.push(this.formatNumber(point.x, options));\n      rowParts.push(this.formatNumber(point.y, options));\n      \n      lines.push('| ' + rowParts.join(separator) + ' |');\n    }\n\n    return lines.join('\\n');\n  }\n\n  /**\n   * Format a number for output\n   */\n  private formatNumber(value: number, options: ClipboardOptions): string {\n    const precision = options.precision ?? 6;\n    const threshold = options.scientificThreshold ?? 1e6;\n\n    if (!isFinite(value)) {\n      return value.toString();\n    }\n\n    // Use scientific notation for very large or very small numbers\n    if (options.scientific && (Math.abs(value) >= threshold || (Math.abs(value) < 1e-4 && value !== 0))) {\n      return value.toExponential(precision);\n    }\n\n    return this.roundNumber(value, precision).toString();\n  }\n\n  /**\n   * Round a number to specified precision\n   */\n  private roundNumber(value: number, precision: number): number {\n    const factor = Math.pow(10, precision);\n    return Math.round(value * factor) / factor;\n  }\n\n  /**\n   * Write text to system clipboard\n   */\n  private async writeToClipboard(text: string): Promise<void> {\n    if (navigator.clipboard && navigator.clipboard.writeText) {\n      await navigator.clipboard.writeText(text);\n    } else {\n      // Fallback for older browsers\n      this.fallbackCopyToClipboard(text);\n    }\n  }\n\n  /**\n   * Fallback clipboard copy using hidden textarea\n   */\n  private fallbackCopyToClipboard(text: string): void {\n    const textarea = document.createElement('textarea');\n    textarea.value = text;\n    textarea.style.position = 'fixed';\n    textarea.style.left = '-9999px';\n    textarea.style.top = '-9999px';\n    document.body.appendChild(textarea);\n    textarea.focus();\n    textarea.select();\n    \n    try {\n      document.execCommand('copy');\n    } finally {\n      document.body.removeChild(textarea);\n    }\n  }\n\n  /**\n   * Read from clipboard (for paste functionality)\n   */\n  async readFromClipboard(): Promise<string | null> {\n    if (navigator.clipboard && navigator.clipboard.readText) {\n      try {\n        return await navigator.clipboard.readText();\n      } catch {\n        return null;\n      }\n    }\n    return null;\n  }\n\n  /**\n   * Parse clipboard text to data points\n   */\n  parseClipboardData(text: string, format?: ClipboardFormat): ClipboardDataPoint[] {\n    const points: ClipboardDataPoint[] = [];\n    \n    // Try to detect format\n    const detectedFormat = format || this.detectFormat(text);\n    \n    if (detectedFormat === 'json') {\n      return this.parseJson(text);\n    }\n\n    // Parse as delimited\n    const lines = text.trim().split(/\\r?\\n/);\n    const separator = detectedFormat === 'csv' ? ',' : detectedFormat === 'tsv' ? '\\t' : ',';\n    \n    // Skip header if present\n    const hasHeader = lines.length > 0 && /^[a-zA-Z]/.test(lines[0].trim());\n    const startIndex = hasHeader ? 1 : 0;\n\n    for (let i = startIndex; i < lines.length; i++) {\n      const parts = lines[i].split(separator).map(p => p.trim().replace(/^\"|\"$/g, ''));\n      \n      if (parts.length >= 2) {\n        const x = parseFloat(parts[0]);\n        const y = parseFloat(parts[1]);\n        \n        if (!isNaN(x) && !isNaN(y)) {\n          points.push({ x, y, index: i - startIndex });\n        }\n      }\n    }\n\n    return points;\n  }\n\n  /**\n   * Detect format from text content\n   */\n  private detectFormat(text: string): ClipboardFormat {\n    const trimmed = text.trim();\n    \n    if (trimmed.startsWith('[') || trimmed.startsWith('{')) {\n      return 'json';\n    }\n    \n    if (trimmed.includes('\\t')) {\n      return 'tsv';\n    }\n    \n    if (trimmed.includes(' | ')) {\n      return 'markdown';\n    }\n    \n    return 'csv';\n  }\n\n  /**\n   * Parse JSON data\n   */\n  private parseJson(text: string): ClipboardDataPoint[] {\n    try {\n      const data = JSON.parse(text);\n      const points: ClipboardDataPoint[] = [];\n      const items = Array.isArray(data) ? data : [data];\n      \n      for (let i = 0; i < items.length; i++) {\n        const item = items[i];\n        if (typeof item.x === 'number' && typeof item.y === 'number') {\n          points.push({\n            x: item.x,\n            y: item.y,\n            seriesId: item.series || item.seriesId,\n            seriesName: item.seriesName || item.series,\n            index: i,\n          });\n        }\n      }\n      \n      return points;\n    } catch {\n      return [];\n    }\n  }\n\n  /**\n   * Set default options\n   */\n  setDefaults(options: Partial<ClipboardOptions>): void {\n    this.defaultOptions = { ...this.defaultOptions, ...options };\n  }\n\n  /**\n   * Get current default options\n   */\n  getDefaults(): ClipboardOptions {\n    return { ...this.defaultOptions };\n  }\n}\n\n// ============================================\n// Convenience Functions\n// ============================================\n\n/** Singleton instance for global use */\nlet globalClipboardManager: ClipboardManager | null = null;\n\n/**\n * Get the global clipboard manager instance\n */\nexport function getClipboardManager(): ClipboardManager {\n  if (!globalClipboardManager) {\n    globalClipboardManager = new ClipboardManager();\n  }\n  return globalClipboardManager;\n}\n\n/**\n * Copy data points to clipboard (convenience function)\n */\nexport async function copyToClipboard(\n  points: ClipboardDataPoint[],\n  options?: Partial<ClipboardOptions>\n): Promise<ClipboardResult> {\n  return getClipboardManager().copyPoints(points, options);\n}\n\n/**\n * Format data as delimited string (without copying)\n */\nexport function formatData(\n  points: ClipboardDataPoint[],\n  options?: Partial<ClipboardOptions>\n): string {\n  const manager = getClipboardManager();\n  return manager.formatPoints(points, { ...manager.getDefaults(), ...options });\n}\n","/**\n * SciPlot Engine - Clipboard Plugin\n * \n * Provides clipboard integration for copying chart data and images.\n * \n * @module plugins/clipboard\n */\n\nexport * from \"../../core/clipboard\";\n\nimport type { PluginManifest, ChartPlugin, PluginContext } from \"../types\";\n\nexport interface PluginClipboardConfig {\n    /** Default format for copied data: 'csv' | 'json' | 'image' */\n    defaultFormat?: string;\n}\n\nconst manifestClipboard: PluginManifest = {\n    name: \"velo-plot-clipboard\",\n    version: \"1.0.0\",\n    description: \"Clipboard integration for velo-plot\",\n    provides: [\"interaction\"],\n    tags: [\"clipboard\", \"copy\", \"paste\", \"export\"],\n};\n\n/**\n * SciPlot Clipboard Plugin\n * \n * Adds support for copying data and screenshots to the clipboard.\n */\nexport function PluginClipboard(_config: PluginClipboardConfig = {}): ChartPlugin<PluginClipboardConfig> {\n    return {\n        manifest: manifestClipboard,\n\n        onInit(_ctx: PluginContext) {\n        },\n\n        onDestroy(_ctx: PluginContext) {\n        },\n\n        api: {\n            copyCurrentView() {\n                // Implementation would call copyToClipboard with data from current view\n            }\n        }\n    };\n}\n\nexport default PluginClipboard;\n"],"names":["FORMAT_CONFIGS","ClipboardManager","options","__publicField","points","opts","text","seriesIds","p","error","seriesData","series","i","format","_a","_b","_c","config","separator","lineSeparator","lines","headerParts","point","rowParts","seriesName","data","obj","sepRow","value","precision","threshold","factor","textarea","detectedFormat","startIndex","parts","x","y","trimmed","items","item","globalClipboardManager","getClipboardManager","copyToClipboard","formatData","manager","manifestClipboard","PluginClipboard","_config","_ctx"],"mappings":"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"}

package/dist/plugins/context-menu/index.d.ts

@@ -0,0 +1,12 @@
+import { ChartPlugin } from '../types';
+import { PluginContextMenuConfig } from './types';
+
+export * from './types';
+/**
+ * Sci Plot Context Menu Plugin
+ *
+ * Adds a customizable context menu with built-in actions and
+ * extensibility for custom menu items.
+ */
+export declare function PluginContextMenu(config?: PluginContextMenuConfig): ChartPlugin<PluginContextMenuConfig>;
+export default PluginContextMenu;

package/dist/plugins/context-menu/renderer.d.ts

@@ -0,0 +1,43 @@
+import { MenuItem, MenuStyle, MenuContext, MenuState } from './types';
+
+export declare class MenuRenderer {
+    private _container;
+    private menuElement;
+    private style;
+    private onItemClick;
+    private zIndex;
+    constructor(container: HTMLElement, style: MenuStyle | undefined, zIndex: number, onItemClick: (item: MenuItem, context: MenuContext) => void);
+    /**
+     * Show the context menu
+     */
+    show(state: MenuState): void;
+    /**
+     * Hide the context menu
+     */
+    hide(): void;
+    /**
+     * Check if menu is visible
+     */
+    isVisible(): boolean;
+    /**
+     * Destroy the renderer
+     */
+    destroy(): void;
+    /**
+     * Update styling
+     */
+    updateStyle(style: MenuStyle): void;
+    /**
+     * Get container reference
+     */
+    getContainer(): HTMLElement;
+    private createMenu;
+    private createMenuItem;
+    private showSubmenu;
+    private hideSubmenu;
+    private positionMenu;
+    private getMenuStyle;
+    private getItemStyle;
+    private handleOutsideClick;
+    private handleKeyDown;
+}

package/dist/plugins/context-menu/types.d.ts

@@ -0,0 +1,202 @@
+/**
+ * Context Menu Plugin - Type Definitions
+ *
+ * @module plugins/context-menu/types
+ */
+/**
+ * Base menu item properties
+ */
+export interface MenuItemBase {
+    /** Unique identifier for the item */
+    id?: string;
+    /** Display label */
+    label: string;
+    /** Icon (emoji, SVG string, or icon class) */
+    icon?: string;
+    /** Keyboard shortcut hint */
+    shortcut?: string;
+    /** Whether the item is disabled */
+    disabled?: boolean;
+    /** Whether the item is hidden */
+    hidden?: boolean;
+    /** CSS class for styling */
+    className?: string;
+}
+/**
+ * Separator item
+ */
+export interface MenuSeparator {
+    type: 'separator';
+}
+/**
+ * Action menu item
+ */
+export interface MenuActionItem extends MenuItemBase {
+    type?: 'action';
+    /** Action identifier (for built-in actions) */
+    action?: BuiltinAction;
+    /** Custom click handler */
+    onClick?: (context: MenuContext) => void;
+}
+/**
+ * Submenu item
+ */
+export interface MenuSubmenuItem extends MenuItemBase {
+    type: 'submenu';
+    /** Submenu items */
+    items: MenuItem[];
+}
+/**
+ * Checkbox menu item
+ */
+export interface MenuCheckboxItem extends MenuItemBase {
+    type: 'checkbox';
+    /** Whether the checkbox is checked */
+    checked?: boolean;
+    /** Change handler */
+    onChange?: (checked: boolean, context: MenuContext) => void;
+}
+/**
+ * Radio group item
+ */
+export interface MenuRadioItem extends MenuItemBase {
+    type: 'radio';
+    /** Radio group name */
+    group: string;
+    /** Value for this option */
+    value: string;
+    /** Whether this option is selected */
+    selected?: boolean;
+    /** Change handler */
+    onChange?: (value: string, context: MenuContext) => void;
+}
+/**
+ * All menu item types
+ */
+export type MenuItem = MenuActionItem | MenuSubmenuItem | MenuCheckboxItem | MenuRadioItem | MenuSeparator;
+/**
+ * Built-in menu actions
+ */
+export type BuiltinAction = 'zoomToFit' | 'zoomIn' | 'zoomOut' | 'resetView' | 'panMode' | 'boxZoomMode' | 'selectMode' | 'exportCSV' | 'exportJSON' | 'exportImage' | 'copyToClipboard' | 'toggleLegend' | 'toggleGrid' | 'toggleCrosshair' | 'addHorizontalLine' | 'addVerticalLine' | 'addTextAnnotation' | 'clearAnnotations' | 'showStats';
+/**
+ * Context passed to menu handlers
+ */
+export interface MenuContext {
+    /** The chart instance */
+    chart: unknown;
+    /** Mouse event that triggered the menu */
+    event: MouseEvent;
+    /** Click position in pixels */
+    pixelPosition: {
+        x: number;
+        y: number;
+    };
+    /** Click position in data coordinates */
+    dataPosition: {
+        x: number;
+        y: number;
+    } | null;
+    /** Series ID if clicked on a series */
+    seriesId: string | null;
+    /** Annotation ID if clicked on an annotation */
+    annotationId: string | null;
+    /** Point index if clicked near a data point */
+    pointIndex: number | null;
+    /** Area where the click occurred */
+    area: 'plot' | 'xAxis' | 'yAxis' | 'legend' | 'title' | 'outside';
+}
+/**
+ * Position for the menu
+ */
+export interface MenuPosition {
+    x: number;
+    y: number;
+}
+/**
+ * Menu template definition
+ */
+export interface MenuTemplate {
+    /** Template name */
+    name: string;
+    /** Items in this template */
+    items: MenuItem[];
+    /** Condition to show this template */
+    condition?: (context: MenuContext) => boolean;
+}
+/**
+ * Menu styling options
+ */
+export interface MenuStyle {
+    /** Background color */
+    backgroundColor?: string;
+    /** Text color */
+    textColor?: string;
+    /** Border color */
+    borderColor?: string;
+    /** Border radius */
+    borderRadius?: string;
+    /** Box shadow */
+    boxShadow?: string;
+    /** Font family */
+    fontFamily?: string;
+    /** Font size */
+    fontSize?: string;
+    /** Item padding */
+    itemPadding?: string;
+    /** Hover background */
+    hoverBackground?: string;
+    /** Separator color */
+    separatorColor?: string;
+    /** Disabled opacity */
+    disabledOpacity?: number;
+    /** Menu min width */
+    minWidth?: string;
+    /** Menu max width */
+    maxWidth?: string;
+    /** Animation duration */
+    animationDuration?: string;
+}
+/**
+ * Configuration for PluginContextMenu
+ */
+export interface PluginContextMenuConfig {
+    /** Enable context menu */
+    enabled?: boolean;
+    /** Custom menu items */
+    items?: MenuItem[];
+    /** Menu templates for different contexts */
+    templates?: MenuTemplate[];
+    /** Use default menu items */
+    useDefaults?: boolean;
+    /** Custom styling */
+    style?: MenuStyle;
+    /** Prevent default browser context menu */
+    preventDefault?: boolean;
+    /** Show on right-click */
+    showOnRightClick?: boolean;
+    /** Show on long-press (touch) */
+    showOnLongPress?: boolean;
+    /** Long press duration in ms */
+    longPressDuration?: number;
+    /** Before show hook */
+    beforeShow?: (context: MenuContext) => MenuItem[] | false;
+    /** After hide hook */
+    afterHide?: () => void;
+    /** Z-index for the menu */
+    zIndex?: number;
+}
+/**
+ * Current menu state
+ */
+export interface MenuState {
+    /** Whether the menu is visible */
+    visible: boolean;
+    /** Menu position */
+    position: MenuPosition;
+    /** Current items to display */
+    items: MenuItem[];
+    /** Active submenu path */
+    submenuPath: string[];
+    /** Current context */
+    context: MenuContext | null;
+}

package/dist/plugins/context-menu.d.ts

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