velo-plot 1.11.1

package/dist/testing/index.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Sci Plot - Testing Utilities
+ *
+ * Provides utilities for testing chart applications:
+ * - Mock data generators
+ * - Chart test harness
+ * - Snapshot helpers
+ * - Performance benchmarks
+ *
+ * @module testing
+ */
+export interface MockChartOptions {
+    /** Canvas width (default: 800) */
+    width?: number;
+    /** Canvas height (default: 600) */
+    height?: number;
+    /** Device pixel ratio (default: 1) */
+    devicePixelRatio?: number;
+    /** Theme (default: 'dark') */
+    theme?: string;
+    /** Enable WebGL mock (default: true) */
+    mockWebGL?: boolean;
+}
+export interface WaveformOptions {
+    /** Number of points (default: 1000) */
+    pointCount?: number;
+    /** Amplitude (default: 1) */
+    amplitude?: number;
+    /** Frequency in Hz (default: 1) */
+    frequency?: number;
+    /** Phase offset in radians (default: 0) */
+    phase?: number;
+    /** Noise level (0-1, default: 0) */
+    noise?: number;
+    /** X start value (default: 0) */
+    xStart?: number;
+    /** X end value (default: 10) */
+    xEnd?: number;
+    /** DC offset (default: 0) */
+    offset?: number;
+}
+export interface RandomDataOptions {
+    /** Number of points (default: 1000) */
+    pointCount?: number;
+    /** X range [min, max] (default: [0, 100]) */
+    xRange?: [number, number];
+    /** Y range [min, max] (default: [-1, 1]) */
+    yRange?: [number, number];
+    /** Sort by X value (default: true) */
+    sorted?: boolean;
+    /** Seed for reproducible random (optional) */
+    seed?: number;
+}
+export interface BenchmarkResult {
+    /** Average frames per second */
+    avgFps: number;
+    /** Minimum FPS recorded */
+    minFps: number;
+    /** Maximum FPS recorded */
+    maxFps: number;
+    /** Average frame time in ms */
+    avgFrameTime: number;
+    /** Total frames rendered */
+    frameCount: number;
+    /** Test duration in ms */
+    duration: number;
+    /** Points per frame */
+    pointsRendered: number;
+    /** Points per second throughput */
+    throughput: number;
+}
+export interface BenchmarkOptions {
+    /** Duration of benchmark in ms (default: 5000) */
+    duration?: number;
+    /** Warmup duration in ms (default: 1000) */
+    warmup?: number;
+    /** Target FPS for assertions (default: 55) */
+    targetFps?: number;
+    /** Enable console output (default: false) */
+    verbose?: boolean;
+}
+export interface SnapshotOptions {
+    /** Output format: 'json' | 'png' | 'canvas' (default: 'json') */
+    format?: 'json' | 'png' | 'canvas';
+    /** Include data in snapshot (default: false for performance) */
+    includeData?: boolean;
+    /** Include styles in snapshot (default: true) */
+    includeStyles?: boolean;
+}
+export interface ChartSnapshot {
+    /** Snapshot timestamp */
+    timestamp: number;
+    /** Chart configuration */
+    config: Record<string, unknown>;
+    /** Series metadata (without data by default) */
+    series: {
+        id: string;
+        type: string;
+        pointCount: number;
+        style?: Record<string, unknown>;
+    }[];
+    /** View bounds */
+    bounds: {
+        xMin: number;
+        xMax: number;
+        yMin: number;
+        yMax: number;
+    };
+    /** Canvas data URL (if format is 'png') */
+    image?: string;
+}
+/**
+ * Generate a sine wave
+ */
+export declare function generateSineWave(options?: WaveformOptions): {
+    x: Float32Array;
+    y: Float32Array;
+};
+/**
+ * Generate a square wave
+ */
+export declare function generateSquareWave(options?: WaveformOptions): {
+    x: Float32Array;
+    y: Float32Array;
+};
+/**
+ * Generate a sawtooth wave
+ */
+export declare function generateSawtoothWave(options?: WaveformOptions): {
+    x: Float32Array;
+    y: Float32Array;
+};
+/**
+ * Generate a triangle wave
+ */
+export declare function generateTriangleWave(options?: WaveformOptions): {
+    x: Float32Array;
+    y: Float32Array;
+};
+/**
+ * Generate random data points
+ */
+export declare function generateRandomData(options?: RandomDataOptions): {
+    x: Float32Array;
+    y: Float32Array;
+};
+/**
+ * Generate a cyclic voltammogram (CV) mock data
+ */
+export declare function generateCVData(options?: {
+    pointCount?: number;
+    vMin?: number;
+    vMax?: number;
+    cycles?: number;
+    peakCurrent?: number;
+    noise?: number;
+}): {
+    x: Float32Array;
+    y: Float32Array;
+};
+/**
+ * Generate electrochemical impedance spectroscopy (EIS) Nyquist data
+ */
+export declare function generateNyquistData(options?: {
+    pointCount?: number;
+    rSolution?: number;
+    rCharge?: number;
+    frequency?: [number, number];
+}): {
+    x: Float32Array;
+    y: Float32Array;
+};
+/**
+ * Benchmark chart rendering performance
+ */
+export declare function benchmarkRender(chart: {
+    render: () => void;
+    getAllSeries: () => {
+        getPointCount: () => number;
+    }[];
+}, options?: BenchmarkOptions): Promise<BenchmarkResult>;
+/**
+ * Create a snapshot of chart state for testing
+ */
+export declare function createSnapshot(chart: {
+    getViewBounds: () => {
+        xMin: number;
+        xMax: number;
+        yMin: number;
+        yMax: number;
+    };
+    getAllSeries: () => {
+        getId: () => string;
+        getType: () => string;
+        getPointCount: () => number;
+        getStyle: () => Record<string, unknown>;
+    }[];
+    exportImage?: () => string;
+}, options?: SnapshotOptions): ChartSnapshot;
+/**
+ * Compare two snapshots for equality
+ */
+export declare function compareSnapshots(a: ChartSnapshot, b: ChartSnapshot, tolerance?: number): {
+    equal: boolean;
+    differences: string[];
+};
+/**
+ * Assert that a benchmark meets performance requirements
+ */
+export declare function assertPerformance(result: BenchmarkResult, requirements: {
+    minFps?: number;
+    maxFrameTime?: number;
+    minThroughput?: number;
+}): {
+    passed: boolean;
+    failures: string[];
+};
+/**
+ * Wait for a number of animation frames
+ */
+export declare function waitForFrames(count?: number): Promise<void>;
+/**
+ * Wait for a specified duration
+ */
+export declare function waitFor(ms: number): Promise<void>;

package/dist/theme/colorSchemes.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Color Schemes - Palettes optimized for multi-series charts
+ *
+ * Each scheme includes:
+ * - 20 distinct colors for series
+ * - 1 highlight color for hover/selection states
+ *
+ * These schemes are designed to work with both dark and light themes
+ * and provide maximum visual distinction between multiple series.
+ */
+export interface ColorScheme {
+    /** Scheme name */
+    name: string;
+    /** Series color palette (20 colors) */
+    colors: string[];
+    /** Highlight color for hover/selection (distinct from palette) */
+    highlightColor: string;
+    /** Whether optimized for dark backgrounds */
+    isDark: boolean;
+}
+/**
+ * VIBRANT - High saturation, energetic colors for dark backgrounds
+ */
+export declare const VIBRANT_SCHEME: ColorScheme;
+/**
+ * PASTEL - Soft, muted colors for light backgrounds
+ */
+export declare const PASTEL_SCHEME: ColorScheme;
+/**
+ * NEON - Electric, fluorescent colors for dark backgrounds
+ */
+export declare const NEON_SCHEME: ColorScheme;
+/**
+ * EARTH - Natural, organic tones for light backgrounds
+ */
+export declare const EARTH_SCHEME: ColorScheme;
+/**
+ * OCEAN - Blue and aquatic tones for both backgrounds
+ */
+export declare const OCEAN_SCHEME: ColorScheme;
+/**
+ * All available color schemes
+ */
+export declare const COLOR_SCHEMES: ColorScheme[];
+/**
+ * Get a color scheme by name
+ */
+export declare function getColorScheme(name: string): ColorScheme;
+/**
+ * Get color from scheme by index (cycles if index > 20)
+ */
+export declare function getColorFromScheme(scheme: ColorScheme, index: number): string;
+/**
+ * Auto-select appropriate scheme based on theme
+ */
+export declare function getDefaultSchemeForTheme(isDark: boolean): ColorScheme;

package/dist/theme/index.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Theme - Visual styling configuration for SciPlot
+ *
+ * Provides customizable themes for the chart including:
+ * - Grid styling
+ * - Axis styling
+ * - Legend styling
+ * - Cursor styling
+ */
+export interface GridTheme {
+    /** Grid visibility */
+    visible: boolean;
+    /** Major grid line color */
+    majorColor: string;
+    /** Minor grid line color */
+    minorColor: string;
+    /** Major grid line width */
+    majorWidth: number;
+    /** Minor grid line width */
+    minorWidth: number;
+    /** Line dash pattern for major lines [dash, gap] */
+    majorDash: number[];
+    /** Line dash pattern for minor lines [dash, gap] */
+    minorDash: number[];
+    /** Show minor grid lines */
+    showMinor: boolean;
+    /** Number of minor divisions between major lines */
+    minorDivisions: number;
+}
+export interface AxisTheme {
+    /** Axis line color */
+    lineColor: string;
+    /** Axis line width */
+    lineWidth: number;
+    /** Tick mark color */
+    tickColor: string;
+    /** Tick mark length */
+    tickLength: number;
+    /** Label color */
+    labelColor: string;
+    /** Label font size */
+    labelSize: number;
+    /** Axis title color */
+    titleColor: string;
+    /** Axis title font size */
+    titleSize: number;
+    /** Font family */
+    fontFamily: string;
+}
+export interface LegendTheme {
+    /** Legend visibility */
+    visible: boolean;
+    /** Position */
+    position: "top-left" | "top-right" | "bottom-left" | "bottom-right";
+    /** Background color */
+    backgroundColor: string;
+    /** Border color */
+    borderColor: string;
+    /** Border radius */
+    borderRadius: number;
+    /** Text color */
+    textColor: string;
+    /** Font size */
+    fontSize: number;
+    /** Font family */
+    fontFamily: string;
+    /** Padding inside legend */
+    padding: number;
+    /** Gap between items */
+    itemGap: number;
+    /** Color swatch size */
+    swatchSize: number;
+}
+export interface CursorTheme {
+    /** Cursor line color */
+    lineColor: string;
+    /** Cursor line width */
+    lineWidth: number;
+    /** Cursor line dash pattern */
+    lineDash: number[];
+    /** Tooltip background color */
+    tooltipBackground: string;
+    /** Tooltip border color */
+    tooltipBorder: string;
+    /** Tooltip text color */
+    tooltipColor: string;
+    /** Tooltip font size */
+    tooltipSize: number;
+}
+export interface ToolbarTheme {
+    /** Toolbar background color */
+    backgroundColor: string;
+    /** Border color */
+    borderColor: string;
+    /** Border radius */
+    borderRadius: number;
+}
+export interface ChartTheme {
+    /** Theme name */
+    name: string;
+    /** Whether the theme is dark */
+    isDark: boolean;
+    /** Background color */
+    backgroundColor: string;
+    /** Plot area background color */
+    plotAreaBackground: string;
+    /** Plot area border color */
+    plotBorderColor: string;
+    /** Grid theme */
+    grid: GridTheme;
+    /** X-axis theme */
+    xAxis: AxisTheme;
+    /** Y-axis theme */
+    yAxis: AxisTheme;
+    /** Legend theme */
+    legend: LegendTheme;
+    /** Cursor theme */
+    cursor: CursorTheme;
+    /** Toolbar theme */
+    toolbar: ToolbarTheme;
+}
+export declare const DARK_THEME: ChartTheme;
+export declare const MIDNIGHT_THEME: ChartTheme;
+/** Light theme - Clean white background */
+export declare const LIGHT_THEME: ChartTheme;
+/** Electrochemistry theme - Professional blue tones */
+export declare const ELECTROCHEM_THEME: ChartTheme;
+/**
+ * Create a custom theme by merging with base theme
+ */
+export declare function createTheme(base: ChartTheme, overrides: Partial<ChartTheme>): ChartTheme;
+/**
+ * Get a theme by name
+ */
+export declare function getThemeByName(name: string): ChartTheme;
+/** Default theme export */
+export declare const DEFAULT_THEME: ChartTheme;
+export { type ColorScheme, COLOR_SCHEMES, VIBRANT_SCHEME, PASTEL_SCHEME, NEON_SCHEME, EARTH_SCHEME, OCEAN_SCHEME, getColorScheme, getColorFromScheme, getDefaultSchemeForTheme, } from './colorSchemes';