velo-plot 1.11.1

package/dist/index.core.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Sci Plot - Core Bundle
+ *
+ * Minimal bundle containing only the essential features for 2D charts.
+ * Achieve ~60KB gzipped by excluding optional plugins.
+ */
+export { createChart } from './core/Chart';
+export { Series } from './core/Series';
+export { EventEmitter } from './core/EventEmitter';
+export type { Chart, ChartOptions, ExportOptions } from './core/Chart';
+export type { AxisOptions, SeriesOptions, SeriesData, SeriesStyle, ZoomOptions, Point, Bounds, Range, ScaleType, SeriesType, } from './types';
+export { LinearScale, LogScale, createScale } from './scales';
+export type { Scale } from './scales';
+export { NativeWebGLRenderer, parseColor, createRenderer, createNativeRenderer, } from './renderer';
+export type { IWebGLRenderer, SeriesRenderData, RenderOptions } from './renderer';
+export { DARK_THEME, LIGHT_THEME, DEFAULT_THEME, createTheme, getThemeByName, } from './theme';
+export type { ChartTheme, GridTheme, AxisTheme } from './theme';
+export { AnimationEngine, easings, DEFAULT_ANIMATION_CONFIG, getSharedAnimationEngine, } from './core/animation';
+export { createPluginContext, PluginManagerImpl, getPluginRegistry, registerPlugin, definePlugin, createPlugin, createConfigurablePlugin, } from './plugins';
+export type { PluginManifest, PluginContext, ChartPlugin, PluginFactory, PluginManager, } from './plugins';

package/dist/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Sci Plot - High-Performance Scientific Charting
+ *
+ * A WebGL-based charting engine designed for scientific data visualization
+ * and high-performance rendering of large datasets.
+ *
+ * Features:
+ * - 10⁵–10⁶ points at 60 FPS
+ * - Zoom/pan via GPU uniforms (no buffer recreation)
+ * - Scientific precision with Float32/Float64 arrays
+ * - Data analysis utilities (peak detection, cycle detection, etc.)
+ *
+ * @packageDocumentation
+ */
+export { createChart } from './core/Chart';
+export { Series } from './core/Series';
+export { EventEmitter } from './core/EventEmitter';
+export type { Chart, ChartOptions, ExportOptions } from './core/Chart';
+export { AnimationEngine, easings, DEFAULT_ANIMATION_CONFIG, mergeAnimationConfig, getSharedAnimationEngine, } from './core/animation';
+export type { AnimationOptions, AnimationHandle, BoundsAnimation, ChartAnimationConfig, EasingFunction, EasingName, } from './core/animation';
+export { ChartInitQueue, getChartInitQueue, queueChartInit, waitForAnimations, resetChartQueue, } from './core/ChartInitQueue';
+export { AnnotationManager } from './core/annotations';
+export type { Annotation, AnnotationType, HorizontalLineAnnotation, VerticalLineAnnotation, RectangleAnnotation, BandAnnotation, TextAnnotation, ArrowAnnotation, } from './core/annotations';
+export type { AxisOptions, SeriesOptions, SeriesData, SeriesStyle, SeriesUpdateData, ZoomOptions, CursorOptions, ChartEventMap, Point, Bounds, Range, ScaleType, SeriesType, StepMode, ErrorBarStyle, ErrorBarDirection, ScatterSymbol, DeltaMeasurement, PeakMeasurement, PolarMode, PolarData, PolarStyle, PolarOptions, TernaryData, TernaryStyle, TernaryOptions, } from './types';
+export { LinearScale, LogScale, createScale, type Scale } from './scales';
+export { NativeWebGLRenderer, interleaveData, parseColor, createRenderer, createNativeRenderer, WebGPURenderer, type WebGPURendererOptions, type IWebGLRenderer, type SeriesRenderData, type RenderOptions, } from './renderer';
+export { DARK_THEME, LIGHT_THEME, MIDNIGHT_THEME, ELECTROCHEM_THEME, DEFAULT_THEME, createTheme, getThemeByName, type ChartTheme, type GridTheme, type AxisTheme, type LegendTheme, type CursorTheme, } from './theme';
+export { DEFAULT_LAYOUT, mergeLayoutOptions, type LayoutOptions, type LegendOptions, type CrosshairOptions, type CrosshairValueMode, type CornerPosition, type ChartTitleOptions, type AxisLayoutOptions, type ChartMargins, type PlotAreaPadding, type LegendPositionPreset, type ToolbarPositionPreset, type ToolbarPosition, } from './core/layout';
+export { OverlayRenderer, } from './core/OverlayRenderer';
+export { SERIALIZATION_VERSION, encodeFloat32Array, decodeFloat32Array, compressString, decompressString, stateToUrlHash, urlHashToState, validateChartState, StateHistory, type SerializedAxis, type SerializedSeries, type ChartState, type SerializeOptions, type DeserializeOptions, type StateSnapshot, } from './serialization';
+export type { PlotArea, CursorState, } from './types';
+export { TooltipManager, TOOLTIP_THEMES, getTooltipThemeForChartTheme, } from './plugins/tools/tooltip';
+export type { TooltipData, TooltipType, TooltipTheme, TooltipOptions, TooltipTemplate, DataPointTooltip, CrosshairTooltip, HeatmapTooltip, } from './plugins/tools/tooltip';
+export { lttbDownsample, minMaxDownsample, calculateTargetPoints, } from './workers/downsample';
+export { formatWithPrefix, formatValue, formatScientific, getBestPrefix, detectCycles, generateCycleColors, detectPeaks, validateData, calculateStats, movingAverage, downsampleLTTB, subtractBaseline, integrate, derivative, cumulativeIntegral, calculateR2, solveLinearSystem, fft, ifft, analyzeSpectrum, powerSpectrum, dominantFrequency, analyzeComplexSpectrum, fftFromComplexInput, hanningWindow, hammingWindow, blackmanWindow, nextPowerOf2, complexToArrays, arraysToComplex, ifftFromArrays, ifftComplex, getPositiveFrequencies, lowPassFilter, highPassFilter, bandPassFilter, bandStopFilter, butterworth, exponentialMovingAverage, gaussianSmooth, savitzkyGolay, medianFilter, singleFrequencyFilter, crossCorrelation, autoCorrelation, detectAnomalies, trapezoidalIntegration, simpsonsIntegration, tTest, type CycleInfo, type Peak, type PrefixInfo, type ValidationResult, type DataStats, type FFTResult, type ComplexFFTResult, type PowerSpectrumResult, type FilterOptions, type ButterworthOptions, type SingleFrequencyFilterOptions, } from './plugins/analysis';
+export { createWebSocketStream, connectStreamToChart, createMessageParser, createMockStream, type WebSocketStream, type WebSocketStreamConfig, type DataPoint, type StreamStats, type WebSocketState, } from './streaming';
+export { SciPlot, useSciPlot, type SciPlotProps, type SciPlotRef, type SciPlotSeries, type UseSciPlotOptions, type UseSciPlotReturn, } from './react';
+export { WebGPUBackend, WebGLBackend, GpuRenderer, createGpuRenderer, SeriesAdapter, parseColorToRGBA, PipelineCache, BaseBufferStore, BaseTextureStore, GpuBenchmark, GpuCompute, } from './gpu';
+export type { GpuBackendType, RGBA, GpuViewport, GpuBackend, BufferId, TextureId, FrameUniforms, DrawKind, DrawCall, DrawList, PointSymbol, SeriesData as GpuSeriesData, Bounds as GpuBounds, GpuRenderOptions, GpuRendererOptions, BackendPreference, WebGPUBackendOptions, BenchmarkResult, BenchmarkOptions, DataStats as GpuDataStats, DataBounds as GpuDataBounds, Peak as GpuPeak, GpuComputeOptions, } from './gpu';
+export { setGlobalLocale, getGlobalLocale, getLocale, registerLocale, createLocaleFormatter, LOCALE_EN_US, LOCALE_ES_ES, LOCALE_DE_DE, LOCALE_FR_FR, LOCALE_PT_BR, LOCALE_ZH_CN, LOCALE_JA_JP, type LocaleConfig, type LocaleFormatter, } from './core/locale';
+export { KeyBindingManager, DEFAULT_KEY_BINDINGS, createKeyBinding, parseShortcut, type KeyAction, type KeyBinding, type KeyBindingCallbacks, type KeyBindingManagerOptions, } from './core/keybindings';
+export { ClipboardManager, getClipboardManager, copyToClipboard, formatData, type ClipboardFormat, type ClipboardOptions, type ClipboardDataPoint, type ClipboardResult, } from './core/clipboard';
+export { DebugOverlay, createDebugOverlay, enableDebugMode, type DebugStats, type DebugOverlayOptions, } from './core/debug';
+export { LoadingIndicator, createLoadingIndicator, showLoading, showProgress, type LoadingIndicatorType, type LoadingIndicatorOptions, type LoadingState, } from './core/loading';
+export { generateSineWave, generateSquareWave, generateSawtoothWave, generateTriangleWave, generateRandomData, generateCVData, generateNyquistData, benchmarkRender, assertPerformance, createSnapshot, compareSnapshots, waitForFrames, waitFor, type MockChartOptions, type WaveformOptions, type RandomDataOptions, type BenchmarkResult as TestBenchmarkResult, type BenchmarkOptions as TestBenchmarkOptions, type SnapshotOptions, type ChartSnapshot, } from './testing';
+export { ChartGroup, createChartGroup, linkCharts, createMasterSlave, type SyncAxis, type SyncOptions, type ChartLike, type SyncEvent, } from './core/sync';
+export { ThemeEditor, createThemeEditor, getPresetTheme, getPresetNames, THEME_PRESETS, type EditorTheme, type ThemeEditorOptions, type ThemePreset, type ColorGroup, type ColorProperty, } from './core/theme-editor';
+export { BackpressureManager, CircularBuffer, createBackpressureManager, createRealtimeBackpressure, createLosslessBackpressure, type OverflowStrategy, type BackpressureConfig, type PressureStats, type BufferHealth, } from './streaming/backpressure';
+export { sma, ema, wma, dema, tema, rsi, macd, stochastic, roc, momentum, bollingerBands, atr, standardDeviation, vwap, obv, adx, aroon, percentChange, cumsum, normalize, type IndicatorResult, type OHLCData, } from './plugins/analysis';
+export { createPluginContext, PluginManagerImpl, getPluginRegistry, registerPlugin, definePlugin, defineAndRegister, loadPlugin, listPluginsByCategory, validateManifest, checkPluginCompatibility, createPlugin, createConfigurablePlugin, CrosshairPlugin, StatsPlugin, WatermarkPlugin, GridHighlightPlugin, DataLoggerPlugin, DirectionIndicatorPlugin, Plugin3D, PluginGpu, PluginTools, PluginAnalysis, PluginAnnotations, PluginStreaming, PluginThemeEditor, PluginI18n, PluginKeyboard, PluginClipboard, PluginSync, PluginDebug, PluginLoading, PluginDataExport, PluginContextMenu, PluginAnomalyDetection, PluginMLIntegration, PluginPatternRecognition, PluginRegression, PluginRadar, PluginSnapshot, PluginDataTransform, PluginLaTeX, PluginDragEdit, PluginCaching, PluginLazyLoad, PluginBrokenAxis, PluginVideoRecorder, PluginOffscreen, PluginVirtualization, PluginROI, PluginForecasting, BuiltinPlugins, } from './plugins';
+export type { PluginVersion, PluginCapability, PluginManifest, PluginContext, RenderContext, CoordinateContext, DataContext, UIContext as PluginUIContext, EventContext as PluginEventContext, PluginStorage, PluginLogger, OverlayOptions, NotificationOptions, PickResult, BeforeRenderEvent, AfterRenderEvent, InteractionEvent, ViewChangeEvent, SeriesChangeEvent, DataUpdateEvent, ChartPlugin, PluginFactory, TypedPlugin, PluginManager, PluginRegistry, PluginRegistryEntry, ContextDependencies, CrosshairPluginConfig, StatsPluginConfig, WatermarkPluginConfig, GridHighlightConfig, DataLoggerConfig, DirectionIndicatorConfig, Plugin3DConfig, PluginGpuConfig, PluginToolsConfig, PluginAnalysisConfig, PluginAnnotationsConfig, PluginStreamingConfig, PluginThemeEditorConfig, PluginI18nConfig, PluginKeyboardConfig, PluginClipboardConfig, PluginSyncConfig, PluginDebugConfig, PluginLoadingConfig, PluginDataExportConfig, PluginContextMenuConfig, PluginAnomalyDetectionConfig, PluginMLIntegrationConfig, PluginPatternRecognitionConfig, PluginRegressionConfig, PluginRadarConfig, PluginSnapshotConfig, PluginDataTransformConfig, PluginLaTeXConfig, PluginDragEditConfig, PluginCachingConfig, PluginLazyLoadConfig, PluginBrokenAxisConfig, PluginVideoRecorderConfig, PluginOffscreenConfig, PluginVirtualizationConfig, PluginROIConfig, PluginForecastingConfig, RegressionAPI, RegressionResult, RegressionData, MLIntegrationAPI, MLModelAPI, PredictionResult, VisualizationConfig, DataTransformAPI, TransformOp, TransformType, RadarAPI, RadarSeriesData, RadarPoint, LaTeXPluginAPI, LaTeXDimensions, DragEditAPI, DragEditEvent, CachingAPI, CacheStats, LazyLoadAPI, DataProvider, OffscreenAPI, OffscreenStats, OffscreenMode, OffscreenTransferMode, OffscreenFallbackMode, VirtualizationAPI, VirtualizationStats, VirtualizationMode, VirtualizationStrategy, RoiAPI, RoiRegion, RoiPoint, RoiMaskResult, RoiTool, RoiEvent, RoiSelectedEvent, BrokenAxisAPI, AxisBreak, VideoRecorderAPI, VideoRecorderOptions, SnapshotExportAPI as SnapshotAPI, SnapshotExportOptions, SnapshotResolution, SnapshotFormat, AnomalyDetectionResult, AnomalyPoint, AnomalyMethod, PatternRecognitionAPI, PatternMatch, PatternDetectionResult, ForecastingAPI, ForecastingOptions, ForecastingResult, ForecastingParams } from './plugins';

package/dist/overlay/CanvasOverlay.d.ts

@@ -0,0 +1,102 @@
+import { Bounds } from '../types';
+import { Scale } from '../scales';
+
+export interface OverlayTheme {
+    /** Background color (usually transparent) */
+    background: string;
+    /** Axis line color */
+    axisColor: string;
+    /** Tick mark color */
+    tickColor: string;
+    /** Label text color */
+    labelColor: string;
+    /** Grid line color */
+    gridColor: string;
+    /** Cursor line color */
+    cursorColor: string;
+    /** Font family */
+    fontFamily: string;
+    /** Base font size */
+    fontSize: number;
+}
+export declare const DEFAULT_THEME: OverlayTheme;
+export interface AxisConfig {
+    /** Axis label (e.g., 'E / V') */
+    label?: string;
+    /** Tick values to draw */
+    ticks?: number[];
+    /** Format function for tick labels */
+    tickFormat?: (value: number) => string;
+    /** Show grid lines */
+    showGrid?: boolean;
+}
+export interface CursorState {
+    /** Cursor enabled */
+    enabled: boolean;
+    /** Cursor X position in pixels */
+    x: number;
+    /** Cursor Y position in pixels */
+    y: number;
+    /** Show crosshair */
+    crosshair: boolean;
+    /** Tooltip text */
+    tooltip?: string;
+}
+/**
+ * Canvas Overlay manages the 2D rendering layer
+ */
+export declare class CanvasOverlay {
+    private canvas;
+    private ctx;
+    private dpr;
+    private theme;
+    private readonly MARGIN;
+    constructor(parentElement: HTMLElement, theme?: Partial<OverlayTheme>);
+    /**
+     * Resize the overlay canvas
+     */
+    resize(): void;
+    /**
+     * Get the plot area (excluding margins)
+     */
+    getPlotArea(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /**
+     * Clear the overlay
+     */
+    clear(): void;
+    /**
+     * Render axes
+     */
+    renderAxes(bounds: Bounds, xAxis?: AxisConfig, yAxis?: AxisConfig, xScale?: Scale, yScale?: Scale): void;
+    private renderGrid;
+    private renderXAxis;
+    private renderYAxis;
+    private renderXAxisLabel;
+    private renderYAxisLabel;
+    /**
+     * Render cursor/crosshair
+     */
+    renderCursor(cursor: CursorState): void;
+    /**
+     * Render tooltip
+     */
+    renderTooltip(x: number, y: number, text: string): void;
+    /**
+     * Render FPS counter (debug)
+     */
+    renderFPS(fps: number, frameTime: number): void;
+    private dataToPixelX;
+    private dataToPixelY;
+    private generateTicks;
+    private formatNumber;
+    private formatScientific;
+    /**
+     * Destroy the overlay
+     */
+    destroy(): void;
+}

package/dist/overlay/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Overlay module exports
+ */
+export { CanvasOverlay, DEFAULT_THEME, type OverlayTheme, type AxisConfig, type CursorState, } from './CanvasOverlay';

package/dist/plugins/3d/Area3DRenderer.d.ts

@@ -0,0 +1,122 @@
+import { OrbitCamera, OrbitCameraOptions } from './camera/OrbitCamera';
+import { OrbitControllerOptions } from './controls/OrbitController';
+import { Axes3DOptions } from './Axes3D';
+import { Tooltip3DOptions } from './Tooltip3D';
+import { Renderer3DOptions, RenderStats3D, Renderer3DEventCallback } from './types';
+import { CustomThemeOptions } from './colorThemes';
+
+export interface AreaSeriesData {
+    /** X coordinates */
+    x: Float32Array;
+    /** Y coordinates (top of area) */
+    y: Float32Array;
+    /** Z coordinates */
+    z: Float32Array;
+    /** Base Y value (bottom of area, default: 0) */
+    baseY?: number;
+    /** Color per vertex (optional, RGB) */
+    colors?: Float32Array;
+    /** Single area color [r, g, b] */
+    color?: [number, number, number];
+}
+export interface Area3DRendererOptions extends Renderer3DOptions {
+    camera?: OrbitCameraOptions;
+    controls?: OrbitControllerOptions;
+    axes?: Axes3DOptions;
+    showAxes?: boolean;
+    /** Opacity of areas (default: 0.8) */
+    opacity?: number;
+    /** Enable tooltips (default: true) */
+    enableTooltip?: boolean;
+    tooltip?: Tooltip3DOptions;
+    /** Color theme options */
+    theme?: CustomThemeOptions;
+}
+export declare class Area3DRenderer {
+    private canvas;
+    private gl;
+    private dpr;
+    private programs;
+    private camera;
+    private controller;
+    private axes;
+    private vao;
+    private positionBuffer;
+    private normalBuffer;
+    private colorBuffer;
+    private indexBuffer;
+    private indexCount;
+    private backgroundColor;
+    private showAxes;
+    private opacity;
+    private areas;
+    private bounds;
+    private animationFrameId;
+    private needsRender;
+    private eventListeners;
+    private hoveredSeriesIndex;
+    private colorTheme;
+    private tooltip;
+    private enableTooltip;
+    private lastHitIndex;
+    private boundHandleMouseMove?;
+    private boundHandleMouseLeave?;
+    private lastFrameTime;
+    private frameCount;
+    private fps;
+    private lastFpsUpdate;
+    constructor(options: Area3DRendererOptions);
+    private handleMouseMove;
+    private handleMouseLeave;
+    pickAtScreen(screenX: number, screenY: number): {
+        seriesIndex: number;
+        pointIndex: number;
+        distance: number;
+        point: [number, number, number];
+    } | null;
+    private initBuffers;
+    private handleResize;
+    resize(): void;
+    /**
+     * Set area data (single area or array of areas)
+     */
+    setData(areas: AreaSeriesData | AreaSeriesData[]): void;
+    /**
+     * Add a single area
+     */
+    addArea(area: AreaSeriesData): void;
+    /**
+     * Clear all areas
+     */
+    clearAreas(): void;
+    private buildAreaGeometry;
+    private calculateBounds;
+    /**
+     * Fit camera to show all data
+     */
+    fitToData(): void;
+    getCanvasSize(): {
+        width: number;
+        height: number;
+    };
+    /**
+     * Render a single frame
+     */
+    render(): void;
+    startRenderLoop(): void;
+    stopRenderLoop(): void;
+    getStats(): RenderStats3D;
+    getCamera(): OrbitCamera;
+    getAxisLabels(): import('./Axes3D').AxisLabel3D[];
+    getViewProjectionMatrix(): Float32Array;
+    projectToScreen(worldPos: [number, number, number]): {
+        x: number;
+        y: number;
+        visible: boolean;
+    };
+    exportImage(format?: 'png' | 'jpeg' | 'webp', quality?: number, transparent?: boolean): string;
+    on(event: string, callback: Renderer3DEventCallback): void;
+    off(event: string, callback: Renderer3DEventCallback): void;
+    private emitEvent;
+    destroy(): void;
+}

package/dist/plugins/3d/Axes3D.d.ts

@@ -0,0 +1,104 @@
+import { Bounds3D, Axis3DConfig } from './types';
+
+/** Axis label info for text overlay rendering */
+export interface AxisLabel3D {
+    text: string;
+    worldPosition: [number, number, number];
+    axis: 'x' | 'y' | 'z' | 'title';
+    color: [number, number, number];
+}
+/** Full axis configuration with defaults applied */
+export interface Axes3DOptions {
+    /** X-axis configuration */
+    xAxis?: Axis3DConfig & {
+        label?: string;
+        tickFormat?: (v: number) => string;
+    };
+    /** Y-axis configuration */
+    yAxis?: Axis3DConfig & {
+        label?: string;
+        tickFormat?: (v: number) => string;
+    };
+    /** Z-axis configuration */
+    zAxis?: Axis3DConfig & {
+        label?: string;
+        tickFormat?: (v: number) => string;
+    };
+    /** Show axis lines */
+    showAxes?: boolean;
+    /** Show wall grids */
+    showWallGrids?: boolean;
+    /** Show floor grid (XZ plane) */
+    showFloorGrid?: boolean;
+    /** Grid line color */
+    gridColor?: [number, number, number];
+    /** Grid line opacity */
+    gridOpacity?: number;
+    /** Wall grid opacity (slightly more transparent) */
+    wallGridOpacity?: number;
+    /** Number of ticks per axis */
+    tickCount?: number;
+    /** Axis line width */
+    lineWidth?: number;
+    /** Box wireframe color */
+    boxColor?: [number, number, number];
+    /** Box wireframe opacity */
+    boxOpacity?: number;
+}
+export declare class Axes3D {
+    private gl;
+    private axisVAO;
+    private axisPositionBuffer;
+    private axisColorBuffer;
+    private gridVAO;
+    private gridPositionBuffer;
+    private gridColorBuffer;
+    private boxVAO;
+    private boxPositionBuffer;
+    private boxColorBuffer;
+    private lineProgram;
+    private lineUniforms;
+    private axisVertexCount;
+    private gridVertexCount;
+    private boxVertexCount;
+    private bounds;
+    private labels;
+    private options;
+    constructor(gl: WebGL2RenderingContext, options?: Axes3DOptions);
+    private initLineShader;
+    private initBuffers;
+    /**
+     * Update axes geometry based on data bounds
+     */
+    updateBounds(bounds: Bounds3D): void;
+    private buildBoxGeometry;
+    private buildGridGeometry;
+    private buildAxisGeometry;
+    private buildLabels;
+    /**
+     * Render axes and grid
+     */
+    render(viewProjectionMatrix: Float32Array): void;
+    private renderLines;
+    /**
+     * Get labels for 2D text overlay rendering.
+     * Returns world positions that need to be projected to screen coordinates.
+     */
+    getLabels(): AxisLabel3D[];
+    /**
+     * Project a 3D world position to 2D screen coordinates.
+     */
+    projectToScreen(worldPos: [number, number, number], viewProjectionMatrix: Float32Array, canvasWidth: number, canvasHeight: number): {
+        x: number;
+        y: number;
+        visible: boolean;
+    };
+    /**
+     * Update options
+     */
+    setOptions(options: Partial<Axes3DOptions>): void;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}

package/dist/plugins/3d/Bubble3DRenderer.d.ts

@@ -0,0 +1,198 @@
+import { OrbitCamera, OrbitCameraOptions } from './camera/OrbitCamera';
+import { OrbitController, OrbitControllerOptions } from './controls/OrbitController';
+import { Axes3DOptions } from './Axes3D';
+import { Ray3D, HitResult } from './Raycaster3D';
+import { Bubble3DData, Bubble3DStyle, Renderer3DOptions, RenderStats3D, Renderer3DEventCallback } from './types';
+import { Tooltip3DOptions, Tooltip3DData } from './Tooltip3D';
+import { CustomThemeOptions } from './colorThemes';
+
+export interface Bubble3DRendererOptions extends Renderer3DOptions {
+    camera?: OrbitCameraOptions;
+    controls?: OrbitControllerOptions;
+    style?: Bubble3DStyle;
+    autoRender?: boolean;
+    /** Axes configuration */
+    axes?: Axes3DOptions;
+    /** Show axes (default: true) */
+    showAxes?: boolean;
+    /** Enable tooltips on hover (default: true) */
+    enableTooltip?: boolean;
+    /** Tooltip configuration */
+    tooltip?: Tooltip3DOptions;
+    /** Custom tooltip formatter */
+    tooltipFormatter?: (data: Tooltip3DData) => string;
+    /** Color theme options */
+    theme?: CustomThemeOptions;
+}
+export declare class Bubble3DRenderer {
+    private canvas;
+    private gl;
+    private dpr;
+    private programs;
+    private mesh;
+    private camera;
+    private controller;
+    private axes;
+    private backgroundColor;
+    private style;
+    private showAxes;
+    private instanceData;
+    private bounds;
+    private animationFrameId;
+    private autoRender;
+    private needsRender;
+    private eventListeners;
+    private tooltip;
+    private enableTooltip;
+    private lastHitIndex;
+    private boundHandleMouseMove;
+    private boundHandleMouseLeave;
+    private lastFrameTime;
+    private frameCount;
+    private fps;
+    private lastFpsUpdate;
+    private colorTheme;
+    constructor(options: Bubble3DRendererOptions);
+    private handleMouseMove;
+    private handleMouseLeave;
+    private createGeometry;
+    private handleResize;
+    /**
+     * Resize canvas to match display size.
+     */
+    resize(): void;
+    /**
+     * Set bubble data for rendering.
+     */
+    setData(data: Bubble3DData): void;
+    private calculateBounds;
+    /**
+     * Fit camera to view all data.
+     */
+    fitToData(): void;
+    /**
+     * Render a single frame.
+     */
+    render(): void;
+    /**
+     * Start automatic render loop.
+     */
+    startRenderLoop(): void;
+    /**
+     * Stop automatic render loop.
+     */
+    stopRenderLoop(): void;
+    /**
+     * Request a render on next frame.
+     */
+    requestRender(): void;
+    /**
+     * Get render statistics.
+     */
+    getStats(): RenderStats3D;
+    /**
+     * Get camera instance for direct manipulation.
+     */
+    getCamera(): OrbitCamera;
+    /**
+     * Get controller instance for configuration.
+     */
+    getController(): OrbitController;
+    /**
+     * Update style options.
+     */
+    setStyle(style: Partial<Bubble3DStyle>): void;
+    /**
+     * Set background color.
+     */
+    setBackgroundColor(r: number, g: number, b: number, a?: number): void;
+    /**
+     * Add event listener.
+     */
+    on(event: string, callback: Renderer3DEventCallback): void;
+    /**
+     * Remove event listener.
+     */
+    off(event: string, callback: Renderer3DEventCallback): void;
+    private emitEvent;
+    /**
+     * Get axis labels for 2D text overlay rendering.
+     * Returns labels with world positions that need to be projected to screen.
+     */
+    getAxisLabels(): {
+        text: string;
+        worldPosition: [number, number, number];
+        axis: string;
+        color: [number, number, number];
+    }[];
+    /**
+     * Project world coordinates to screen coordinates.
+     * Useful for positioning 2D overlay text.
+     */
+    projectToScreen(worldPos: [number, number, number]): {
+        x: number;
+        y: number;
+        visible: boolean;
+    };
+    /**
+     * Get the current view-projection matrix.
+     */
+    getViewProjectionMatrix(): Float32Array;
+    /**
+     * Get canvas dimensions.
+     */
+    getCanvasSize(): {
+        width: number;
+        height: number;
+    };
+    /**
+     * Get WebGL context info.
+     */
+    getContextInfo(): Record<string, any>;
+    /**
+     * Pick a bubble at screen coordinates.
+     * @param screenX X coordinate relative to canvas
+     * @param screenY Y coordinate relative to canvas
+     * @returns Hit result with bubble index, or null if no hit
+     */
+    pickAtScreen(screenX: number, screenY: number): HitResult | null;
+    /**
+     * Create a ray from screen coordinates.
+     * Useful for custom picking logic.
+     */
+    createRay(screenX: number, screenY: number): Ray3D;
+    /**
+     * Get data for a specific bubble by index.
+     */
+    getBubbleData(index: number): {
+        position: [number, number, number];
+        color: [number, number, number];
+        scale: number;
+    } | null;
+    /**
+     * Export the current view as an image.
+     * @param format Image format ('png' | 'jpeg' | 'webp')
+     * @param quality Quality for jpeg/webp (0-1)
+     * @param transparent Use transparent background (only for 'png')
+     * @returns Data URL of the image
+     */
+    exportImage(format?: 'png' | 'jpeg' | 'webp', quality?: number, transparent?: boolean): string;
+    /**
+     * Export the current view as a Blob.
+     * @param format Image format ('png' | 'jpeg' | 'webp')
+     * @param quality Quality for jpeg/webp (0-1)
+     * @returns Promise that resolves to Blob
+     */
+    exportImageBlob(format?: 'png' | 'jpeg' | 'webp', quality?: number): Promise<Blob | null>;
+    /**
+     * Download the current view as an image file.
+     * @param filename Filename without extension
+     * @param format Image format
+     * @param quality Quality for jpeg/webp
+     */
+    downloadImage(filename?: string, format?: 'png' | 'jpeg' | 'webp', quality?: number): void;
+    /**
+     * Clean up all resources.
+     */
+    destroy(): void;
+}