@chartgpu/chartgpu 0.2.5

package/dist/types/core/GPUContext.d.ts

@@ -0,0 +1,242 @@
+/**
+ * GPUContext - WebGPU device and adapter management
+ *
+ * Handles WebGPU initialization, adapter selection, and device creation
+ * following WebGPU best practices for resource management and error handling.
+ *
+ * This module provides both functional and class-based APIs for maximum flexibility.
+ */
+/** Canvas types supported by GPUContext. */
+export type SupportedCanvas = HTMLCanvasElement | OffscreenCanvas;
+/** Options for GPU context initialization. */
+export interface GPUContextOptions {
+    /** DPR for high-DPI displays. Auto-detects on main thread, defaults to 1.0 in workers. */
+    readonly devicePixelRatio?: number;
+    /** Canvas alpha mode. Default: 'opaque' (faster, no transparency). */
+    readonly alphaMode?: 'opaque' | 'premultiplied';
+    /** GPU power preference for adapter selection. */
+    readonly powerPreference?: 'low-power' | 'high-performance';
+}
+/**
+ * Represents the state of a GPU context.
+ * All properties are readonly to ensure immutability.
+ */
+export interface GPUContextState {
+    readonly adapter: GPUAdapter | null;
+    readonly device: GPUDevice | null;
+    readonly initialized: boolean;
+    readonly canvas: SupportedCanvas | null;
+    readonly canvasContext: GPUCanvasContext | null;
+    readonly preferredFormat: GPUTextureFormat | null;
+    readonly devicePixelRatio: number;
+    readonly alphaMode: 'opaque' | 'premultiplied';
+    readonly powerPreference: 'low-power' | 'high-performance';
+}
+/** Reliable type guard - instanceof works in workers where HTMLCanvasElement is undefined. */
+export declare function isHTMLCanvasElement(canvas: SupportedCanvas): canvas is HTMLCanvasElement;
+/**
+ * Creates a new GPUContext state with initial values.
+ *
+ * @param canvas - Optional canvas element (HTMLCanvasElement or OffscreenCanvas) to configure for WebGPU rendering
+ * @param options - Optional configuration for device pixel ratio, alpha mode, and power preference
+ * @returns A new GPUContextState instance
+ */
+export declare function createGPUContext(canvas?: SupportedCanvas, options?: GPUContextOptions): GPUContextState;
+/**
+ * Initializes the WebGPU context by requesting an adapter and device.
+ * Returns a new state object with initialized values.
+ *
+ * @param context - The GPU context state to initialize
+ * @returns A new GPUContextState with initialized adapter and device
+ * @throws {Error} If WebGPU is not available in the browser
+ * @throws {Error} If adapter request fails
+ * @throws {Error} If device request fails
+ * @throws {Error} If already initialized
+ */
+export declare function initializeGPUContext(context: GPUContextState): Promise<GPUContextState>;
+/**
+ * Gets the current texture from the canvas context.
+ *
+ * @param context - The GPU context state
+ * @returns The current canvas texture
+ * @throws {Error} If canvas is not configured or context is not initialized
+ *
+ * @example
+ * ```typescript
+ * const texture = getCanvasTexture(context);
+ * // Use texture in render pass
+ * ```
+ */
+export declare function getCanvasTexture(context: GPUContextState): GPUTexture;
+/**
+ * Clears the canvas to a solid color.
+ * Creates a command encoder, begins a render pass with the specified clear color,
+ * ends the pass, and submits it to the queue.
+ *
+ * @param context - The GPU context state
+ * @param r - Red component (0.0 to 1.0)
+ * @param g - Green component (0.0 to 1.0)
+ * @param b - Blue component (0.0 to 1.0)
+ * @param a - Alpha component (0.0 to 1.0)
+ * @throws {Error} If canvas is not configured or context is not initialized
+ * @throws {Error} If device is not available
+ *
+ * @example
+ * ```typescript
+ * // Clear to dark purple (#1a1a2e)
+ * clearScreen(context, 0x1a / 255, 0x1a / 255, 0x2e / 255, 1.0);
+ * ```
+ */
+export declare function clearScreen(context: GPUContextState, r: number, g: number, b: number, a: number): void;
+/**
+ * Destroys the WebGPU device and cleans up resources.
+ * Returns a new state object with reset values.
+ * After calling this, the context must be reinitialized before use.
+ *
+ * @param context - The GPU context state to destroy
+ * @returns A new GPUContextState with reset values
+ */
+export declare function destroyGPUContext(context: GPUContextState): GPUContextState;
+/**
+ * Convenience function that creates and initializes a GPU context in one step.
+ *
+ * @param canvas - Optional canvas element (HTMLCanvasElement or OffscreenCanvas) to configure for WebGPU rendering
+ * @param options - Optional configuration for device pixel ratio, alpha mode, and power preference
+ * @returns A fully initialized GPUContextState
+ * @throws {Error} If initialization fails
+ *
+ * @example
+ * ```typescript
+ * const context = await createGPUContextAsync();
+ * const device = context.device;
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const canvas = document.querySelector('canvas');
+ * const context = await createGPUContextAsync(canvas);
+ * const texture = getCanvasTexture(context);
+ * ```
+ */
+export declare function createGPUContextAsync(canvas?: SupportedCanvas, options?: GPUContextOptions): Promise<GPUContextState>;
+/**
+ * GPUContext class wrapper for backward compatibility.
+ *
+ * This class provides a class-based API that internally uses the functional implementation.
+ * Use the functional API directly for better type safety and immutability.
+ */
+export declare class GPUContext {
+    private _state;
+    /**
+     * Gets the WebGPU adapter, or null if not initialized.
+     */
+    get adapter(): GPUAdapter | null;
+    /**
+     * Gets the WebGPU device, or null if not initialized.
+     */
+    get device(): GPUDevice | null;
+    /**
+     * Checks if the context has been initialized.
+     */
+    get initialized(): boolean;
+    /**
+     * Gets the canvas element, or null if not provided.
+     */
+    get canvas(): SupportedCanvas | null;
+    /**
+     * Gets the WebGPU canvas context, or null if canvas is not configured.
+     */
+    get canvasContext(): GPUCanvasContext | null;
+    /**
+     * Gets the preferred canvas format, or null if canvas is not configured.
+     */
+    get preferredFormat(): GPUTextureFormat | null;
+    /**
+     * Gets the device pixel ratio used for canvas sizing.
+     */
+    get devicePixelRatio(): number;
+    /**
+     * Gets the canvas alpha mode.
+     */
+    get alphaMode(): 'opaque' | 'premultiplied';
+    /**
+     * Gets the GPU power preference.
+     */
+    get powerPreference(): 'low-power' | 'high-performance';
+    /**
+     * Creates a new GPUContext instance.
+     *
+     * @param canvas - Optional canvas element (HTMLCanvasElement or OffscreenCanvas) to configure for WebGPU rendering
+     * @param options - Optional configuration for device pixel ratio, alpha mode, and power preference
+     */
+    constructor(canvas?: SupportedCanvas, options?: GPUContextOptions);
+    /**
+     * Initializes the WebGPU context by requesting an adapter and device.
+     *
+     * @throws {Error} If WebGPU is not available in the browser
+     * @throws {Error} If adapter request fails
+     * @throws {Error} If device request fails
+     * @throws {Error} If already initialized
+     */
+    initialize(): Promise<void>;
+    /**
+     * Static factory method to create and initialize a GPUContext instance.
+     *
+     * @param canvas - Optional canvas element (HTMLCanvasElement or OffscreenCanvas) to configure for WebGPU rendering
+     * @param options - Optional configuration for device pixel ratio, alpha mode, and power preference
+     * @returns A fully initialized GPUContext instance
+     * @throws {Error} If initialization fails
+     *
+     * @example
+     * ```typescript
+     * const context = await GPUContext.create();
+     * const device = context.device;
+     * ```
+     *
+     * @example
+     * ```typescript
+     * const canvas = document.querySelector('canvas');
+     * const context = await GPUContext.create(canvas);
+     * const texture = context.getCanvasTexture();
+     * ```
+     */
+    static create(canvas?: SupportedCanvas, options?: GPUContextOptions): Promise<GPUContext>;
+    /**
+     * Gets the current texture from the canvas context.
+     *
+     * @returns The current canvas texture
+     * @throws {Error} If canvas is not configured or context is not initialized
+     *
+     * @example
+     * ```typescript
+     * const texture = context.getCanvasTexture();
+     * // Use texture in render pass
+     * ```
+     */
+    getCanvasTexture(): GPUTexture;
+    /**
+     * Clears the canvas to a solid color.
+     * Creates a command encoder, begins a render pass with the specified clear color,
+     * ends the pass, and submits it to the queue.
+     *
+     * @param r - Red component (0.0 to 1.0)
+     * @param g - Green component (0.0 to 1.0)
+     * @param b - Blue component (0.0 to 1.0)
+     * @param a - Alpha component (0.0 to 1.0)
+     * @throws {Error} If canvas is not configured or context is not initialized
+     * @throws {Error} If device is not available
+     *
+     * @example
+     * ```typescript
+     * // Clear to dark purple (#1a1a2e)
+     * context.clearScreen(0x1a / 255, 0x1a / 255, 0x2e / 255, 1.0);
+     * ```
+     */
+    clearScreen(r: number, g: number, b: number, a: number): void;
+    /**
+     * Destroys the WebGPU device and cleans up resources.
+     * After calling destroy(), the context must be reinitialized before use.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=GPUContext.d.ts.map

package/dist/types/core/GPUContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GPUContext.d.ts","sourceRoot":"","sources":["../../../src/core/GPUContext.ts"],"names":[],"mappings":"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"}

package/dist/types/core/RenderScheduler.d.ts

@@ -0,0 +1,174 @@
+/**
+ * RenderScheduler - 60fps render loop management
+ *
+ * Manages a requestAnimationFrame-based render loop that runs at 60fps,
+ * providing delta time tracking and frame scheduling control.
+ *
+ * This module provides both functional and class-based APIs for maximum flexibility.
+ * The functional API is preferred for better type safety and immutability.
+ */
+/**
+ * Callback function type for render frames.
+ * Receives delta time in milliseconds since the last frame.
+ */
+export type RenderCallback = (deltaTime: number) => void;
+import type { ExactFPS, Milliseconds, FrameTimeStats, FrameDropStats } from '../config/types';
+/**
+ * Represents the state of a render scheduler.
+ * All properties are readonly to ensure immutability.
+ */
+export interface RenderSchedulerState {
+    readonly id: symbol;
+    readonly running: boolean;
+}
+/**
+ * Creates a new RenderScheduler state with initial values.
+ *
+ * @returns A new RenderSchedulerState instance
+ */
+export declare function createRenderScheduler(): RenderSchedulerState;
+/**
+ * Starts the render loop.
+ *
+ * Begins a requestAnimationFrame loop that calls the provided callback
+ * every frame with the delta time in milliseconds since the last frame.
+ * Returns a new state object with running set to true.
+ *
+ * @param state - The scheduler state to start
+ * @param callback - Function to call each frame with delta time
+ * @returns A new RenderSchedulerState with running set to true
+ * @throws {Error} If callback is not provided
+ * @throws {Error} If scheduler is already running
+ * @throws {Error} If state is invalid
+ */
+export declare function startRenderScheduler(state: RenderSchedulerState, callback: RenderCallback): RenderSchedulerState;
+/**
+ * Stops the render loop.
+ *
+ * Cancels any pending requestAnimationFrame calls and stops the loop.
+ * Returns a new state object with running set to false.
+ * The scheduler can be restarted by calling startRenderScheduler() again.
+ *
+ * @param state - The scheduler state to stop
+ * @returns A new RenderSchedulerState with running set to false
+ * @throws {Error} If state is invalid
+ */
+export declare function stopRenderScheduler(state: RenderSchedulerState): RenderSchedulerState;
+/**
+ * Marks the current frame as dirty and schedules a render if idle.
+ *
+ * This function implements render-on-demand: it schedules a frame when the
+ * scheduler is idle. Multiple calls coalesce into a single frame.
+ *
+ * @param state - The scheduler state
+ * @throws {Error} If state is invalid
+ */
+export declare function requestRender(state: RenderSchedulerState): void;
+/**
+ * Calculates exact FPS from frame timestamp deltas.
+ *
+ * Uses the circular buffer of performance.now() timestamps to calculate
+ * frame-perfect FPS. Algorithm:
+ * 1. Sum all frame time deltas in the buffer
+ * 2. Divide by (count - 1) to get average frame time
+ * 3. Convert to FPS: 1000ms / avg_frame_time
+ *
+ * Returns 0 if insufficient data (< 2 frames).
+ *
+ * @param state - The scheduler state
+ * @returns Exact FPS measurement
+ */
+export declare function getCurrentFPS(state: RenderSchedulerState): ExactFPS;
+/**
+ * Calculates frame time statistics from the circular buffer.
+ *
+ * Computes min, max, avg, and percentiles (p50, p95, p99) for frame times.
+ * Returns zero stats if insufficient data.
+ *
+ * @param state - The scheduler state
+ * @returns Frame time statistics
+ */
+export declare function getFrameStats(state: RenderSchedulerState): FrameTimeStats;
+/**
+ * Gets frame drop statistics for the scheduler.
+ *
+ * @param state - The scheduler state
+ * @returns Frame drop statistics
+ */
+export declare function getFrameDropStats(state: RenderSchedulerState): FrameDropStats;
+/**
+ * Gets total frames rendered and elapsed time.
+ *
+ * @param state - The scheduler state
+ * @returns Object with totalFrames and elapsedTime
+ */
+export declare function getTotalFrames(state: RenderSchedulerState): {
+    totalFrames: number;
+    elapsedTime: Milliseconds;
+};
+/**
+ * Destroys the render scheduler and cleans up resources.
+ * Stops the loop if running and removes internal state from the map.
+ * Returns a new state object with reset values.
+ * After calling this, the scheduler must be recreated before use.
+ *
+ * **Important:** Always call this function when done with a scheduler to prevent memory leaks.
+ * The internal state map will retain entries until explicitly destroyed.
+ *
+ * @param state - The scheduler state to destroy
+ * @returns A new RenderSchedulerState with reset values
+ */
+export declare function destroyRenderScheduler(state: RenderSchedulerState): RenderSchedulerState;
+/**
+ * Convenience function that creates a scheduler and starts it in one step.
+ *
+ * @param callback - Function to call each frame with delta time
+ * @returns A RenderSchedulerState with the loop running
+ * @throws {Error} If callback is not provided
+ *
+ * @example
+ * ```typescript
+ * const scheduler = createRenderSchedulerAsync((deltaTime) => {
+ *   renderFrame(deltaTime);
+ * });
+ * ```
+ */
+export declare function createRenderSchedulerAsync(callback: RenderCallback): RenderSchedulerState;
+/**
+ * RenderScheduler class wrapper for backward compatibility.
+ *
+ * This class provides a class-based API that internally uses the functional implementation.
+ * Use the functional API directly for better type safety and immutability.
+ */
+export declare class RenderScheduler {
+    private _state;
+    /**
+     * Checks if the scheduler is currently running.
+     */
+    get running(): boolean;
+    /**
+     * Creates a new RenderScheduler instance.
+     */
+    constructor();
+    /**
+     * Starts the render loop.
+     *
+     * @param callback - Function to call each frame with delta time
+     * @throws {Error} If callback is not provided or scheduler already running
+     */
+    start(callback: RenderCallback): void;
+    /**
+     * Stops the render loop.
+     */
+    stop(): void;
+    /**
+     * Marks the current frame as dirty, indicating it needs to be rendered.
+     */
+    requestRender(): void;
+    /**
+     * Destroys the render scheduler and cleans up resources.
+     * After calling destroy(), the scheduler must be recreated before use.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=RenderScheduler.d.ts.map

package/dist/types/core/RenderScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderScheduler.d.ts","sourceRoot":"","sources":["../../../src/core/RenderScheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE9F;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAgDD;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,oBAAoB,CA2B5D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,cAAc,GACvB,oBAAoB,CA2FtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,oBAAoB,CAmBrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CA2B/D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,oBAAoB,GAAG,QAAQ,CA4BnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,oBAAoB,GAAG,cAAc,CA+DzE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,GAAG,cAAc,CAe7E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,oBAAoB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,YAAY,CAAA;CAAE,CAW9G;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,oBAAoB,GAAG,oBAAoB,CAoBxF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,cAAc,GAAG,oBAAoB,CAGzF;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAuB;IAErC;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;;IAKH;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAIrC;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;;OAGG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/types/core/createAnimationController.d.ts

@@ -0,0 +1,15 @@
+import type { EasingFunction } from '../utils/easing';
+export type AnimationId = symbol;
+export interface AnimationController {
+    animate(from: number, to: number, duration: number, easing: EasingFunction, onUpdate: (value: number) => void, onComplete?: () => void): AnimationId;
+    animate(from: ReadonlyArray<number>, to: ReadonlyArray<number>, duration: number, easing: EasingFunction, onUpdate: (value: ReadonlyArray<number>) => void, onComplete?: () => void): AnimationId;
+    cancel(animationId: AnimationId): void;
+    cancelAll(): void;
+    /**
+     * Progresses all active animations to `timestamp` (ms).
+     * Intended to be called once per frame by the caller (e.g. a render loop).
+     */
+    update(timestamp: number): void;
+}
+export declare function createAnimationController(): AnimationController;
+//# sourceMappingURL=createAnimationController.d.ts.map

package/dist/types/core/createAnimationController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAnimationController.d.ts","sourceRoot":"","sources":["../../../src/core/createAnimationController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,MAAM,WAAW,mBAAmB;IAClC,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EACjC,UAAU,CAAC,EAAE,MAAM,IAAI,GACtB,WAAW,CAAC;IACf,OAAO,CACL,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAC3B,EAAE,EAAE,aAAa,CAAC,MAAM,CAAC,EACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,IAAI,EAChD,UAAU,CAAC,EAAE,MAAM,IAAI,GACtB,WAAW,CAAC;IAEf,MAAM,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IACvC,SAAS,IAAI,IAAI,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAiCD,wBAAgB,yBAAyB,IAAI,mBAAmB,CAoH/D"}

package/dist/types/core/createRenderCoordinator.d.ts

@@ -0,0 +1,129 @@
+import type { ResolvedChartGPUOptions } from '../config/OptionResolver';
+import type { AxisLabel, DataPoint, LegendItem, PointerEventData, OHLCDataPoint, TooltipData } from '../config/types';
+import type { SupportedCanvas } from './GPUContext';
+import type { ChartGPUEventPayload } from '../interaction/createEventManager';
+import type { NearestPointMatch } from '../interaction/findNearestPoint';
+import type { CandlestickMatch } from '../interaction/findCandlestick';
+import type { PieSliceMatch } from '../interaction/findPieSlice';
+export interface GPUContextLike {
+    readonly device: GPUDevice | null;
+    readonly canvas: SupportedCanvas | null;
+    readonly canvasContext: GPUCanvasContext | null;
+    readonly preferredFormat: GPUTextureFormat | null;
+    readonly initialized: boolean;
+    readonly devicePixelRatio?: number;
+}
+export interface RenderCoordinator {
+    setOptions(resolvedOptions: ResolvedChartGPUOptions): void;
+    /**
+     * Appends new points to a cartesian series’ runtime data without requiring a full `setOptions(...)`
+     * resolver pass.
+     *
+     * Appends are coalesced and flushed once per render frame.
+     */
+    appendData(seriesIndex: number, newPoints: ReadonlyArray<DataPoint> | ReadonlyArray<OHLCDataPoint>): void;
+    /**
+     * Gets the current “interaction x” in domain units (or `null` when inactive).
+     *
+     * This is derived from pointer movement inside the plot grid and can also be driven
+     * externally via `setInteractionX(...)` (e.g. chart sync).
+     */
+    getInteractionX(): number | null;
+    /**
+     * Drives the chart’s crosshair + tooltip from a domain-space x value.
+     *
+     * Passing `null` clears the interaction (hides crosshair/tooltip).
+     */
+    setInteractionX(x: number | null, source?: unknown): void;
+    /**
+     * Subscribes to interaction x changes (domain units).
+     *
+     * Returns an unsubscribe function.
+     */
+    onInteractionXChange(callback: (x: number | null, source?: unknown) => void): () => void;
+    /**
+     * Returns the current percent-space zoom window (or `null` when zoom is disabled).
+     */
+    getZoomRange(): Readonly<{
+        start: number;
+        end: number;
+    }> | null;
+    /**
+     * Sets the percent-space zoom window.
+     *
+     * No-op when zoom is disabled.
+     */
+    setZoomRange(start: number, end: number): void;
+    /**
+     * Subscribes to zoom window changes (percent space).
+     *
+     * Returns an unsubscribe function.
+     */
+    onZoomRangeChange(cb: (range: Readonly<{
+        start: number;
+        end: number;
+    }>) => void): () => void;
+    /**
+     * Accepts a pointer event with pre-computed grid coordinates for worker thread event forwarding.
+     * Only available when domOverlays is false.
+     */
+    handlePointerEvent(event: PointerEventData): void;
+    render(): void;
+    dispose(): void;
+}
+export type RenderCoordinatorCallbacks = Readonly<{
+    /**
+     * Optional hook for render-on-demand systems (like `ChartGPU`) to re-render when
+     * interaction state changes (e.g. crosshair on pointer move).
+     */
+    readonly onRequestRender?: () => void;
+    /**
+     * When false, DOM overlays (tooltip, legend, text overlay, event manager) are disabled.
+     * Instead, callbacks are used to emit data for external rendering.
+     * Default: true (DOM overlays enabled).
+     */
+    readonly domOverlays?: boolean;
+    /**
+     * Called when tooltip data changes (only when domOverlays is false).
+     * Receives tooltip data including content, params array, and position, or null when hidden.
+     */
+    readonly onTooltipUpdate?: (data: TooltipData | null) => void;
+    /**
+     * Called when legend items change (only when domOverlays is false).
+     */
+    readonly onLegendUpdate?: (items: ReadonlyArray<LegendItem>) => void;
+    /**
+     * Called when axis labels change (only when domOverlays is false).
+     */
+    readonly onAxisLabelsUpdate?: (xLabels: ReadonlyArray<AxisLabel>, yLabels: ReadonlyArray<AxisLabel>) => void;
+    /**
+     * Called when hover state changes (only when domOverlays is false).
+     */
+    readonly onHoverChange?: (payload: ChartGPUEventPayload | null) => void;
+    /**
+     * Called when crosshair moves (only when domOverlays is false).
+     * Receives canvas-local CSS pixel x coordinate, or null when crosshair is hidden.
+     */
+    readonly onCrosshairMove?: (x: number | null) => void;
+    /**
+     * Called when user taps/clicks (only when domOverlays is false).
+     * Includes hit test result with seriesIndex, dataIndex, and value.
+     * Main thread is responsible for tap detection; worker thread performs hit testing.
+     */
+    readonly onClickData?: (payload: {
+        readonly x: number;
+        readonly y: number;
+        readonly gridX: number;
+        readonly gridY: number;
+        readonly isInGrid: boolean;
+        readonly nearest: NearestPointMatch | null;
+        readonly pieSlice: PieSliceMatch | null;
+        readonly candlestick: CandlestickMatch | null;
+    }) => void;
+    /**
+     * Called when GPU device is lost.
+     */
+    readonly onDeviceLost?: (reason: string) => void;
+}>;
+export declare function createRenderCoordinator(gpuContext: GPUContextLike, options: ResolvedChartGPUOptions, callbacks?: RenderCoordinatorCallbacks): RenderCoordinator;
+//# sourceMappingURL=createRenderCoordinator.d.ts.map

package/dist/types/core/createRenderCoordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRenderCoordinator.d.ts","sourceRoot":"","sources":["../../../src/core/createRenderCoordinator.ts"],"names":[],"mappings":"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"}

package/dist/types/data/createDataStore.d.ts

@@ -0,0 +1,33 @@
+import type { DataPoint } from '../config/types';
+export interface DataStore {
+    setSeries(index: number, data: ReadonlyArray<DataPoint>): void;
+    /**
+     * Appends new points to an existing series without re-uploading the entire buffer when possible.
+     *
+     * - Reuses the same geometric growth policy as `setSeries`.
+     * - When no reallocation is needed, writes only the appended byte range via `queue.writeBuffer(...)`.
+     * - Maintains `pointCount` and a CPU-side combined data array so `getSeriesData(...)` remains correct.
+     *
+     * Throws if the series has not been set yet.
+     */
+    appendSeries(index: number, newPoints: ReadonlyArray<DataPoint>): void;
+    removeSeries(index: number): void;
+    getSeriesBuffer(index: number): GPUBuffer;
+    /**
+     * Returns the number of points last set for the given series index.
+     *
+     * Throws if the series has not been set yet.
+     */
+    getSeriesPointCount(index: number): number;
+    /**
+     * Returns the last CPU-side data set for the given series index.
+     *
+     * This is intended for internal metadata/hit-testing paths that need the same
+     * input array that was packed into the GPU buffer (without re-threading it
+     * through other state). Throws if the series has not been set yet.
+     */
+    getSeriesData(index: number): ReadonlyArray<DataPoint>;
+    dispose(): void;
+}
+export declare function createDataStore(device: GPUDevice): DataStore;
+//# sourceMappingURL=createDataStore.d.ts.map

package/dist/types/data/createDataStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDataStore.d.ts","sourceRoot":"","sources":["../../../src/data/createDataStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IAC/D;;;;;;;;OAQG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IACvE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C;;;;OAIG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C;;;;;;OAMG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACvD,OAAO,IAAI,IAAI,CAAC;CACjB;AAiDD,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAmN5D"}

package/dist/types/data/createStreamBuffer.d.ts

@@ -0,0 +1,20 @@
+export interface StreamBuffer {
+    /**
+     * Writes a new vertex payload into the streaming buffer.
+     *
+     * Notes:
+     * - `data` is interpreted as interleaved `vec2<f32>` vertices: `[x0, y0, x1, y1, ...]`.
+     * - Uses double buffering (alternates GPU buffers each write) to avoid writing into the same
+     *   buffer the GPU might still be reading from the prior frame.
+     * - Uses a per-buffer CPU mirror (Uint32 bit patterns) to compute partial updates.
+     */
+    write(data: Float32Array): void;
+    /** Returns the GPUBuffer that contains the most recently written data. */
+    getBuffer(): GPUBuffer;
+    /** Returns the vertex count for the most recently written data. */
+    getVertexCount(): number;
+    /** Destroys GPU resources (best-effort). Safe to call multiple times. */
+    dispose(): void;
+}
+export declare function createStreamBuffer(device: GPUDevice, maxSize: number): StreamBuffer;
+//# sourceMappingURL=createStreamBuffer.d.ts.map

package/dist/types/data/createStreamBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStreamBuffer.d.ts","sourceRoot":"","sources":["../../../src/data/createStreamBuffer.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAChC,0EAA0E;IAC1E,SAAS,IAAI,SAAS,CAAC;IACvB,mEAAmE;IACnE,cAAc,IAAI,MAAM,CAAC;IACzB,yEAAyE;IACzE,OAAO,IAAI,IAAI,CAAC;CACjB;AAoBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAiKnF"}

package/dist/types/data/lttbSample.d.ts

@@ -0,0 +1,5 @@
+import type { DataPoint } from '../config/types';
+export declare function lttbSample(data: Float32Array, targetPoints: number): Float32Array;
+export declare function lttbSample(data: DataPoint[], targetPoints: number): DataPoint[];
+export declare function lttbSample(data: ReadonlyArray<DataPoint>, targetPoints: number): ReadonlyArray<DataPoint>;
+//# sourceMappingURL=lttbSample.d.ts.map

package/dist/types/data/lttbSample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lttbSample.d.ts","sourceRoot":"","sources":["../../../src/data/lttbSample.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,iBAAiB,CAAC;AA6KjE,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,YAAY,CAAC;AACnF,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;AACjF,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC"}