@chartgpu/chartgpu 0.2.5

package/dist/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;
+/** Options for GPU context initialization. */
+export interface GPUContextOptions {
+    /** DPR for high-DPI displays. Auto-detects from `window.devicePixelRatio`, defaults to 1.0. */
+    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: HTMLCanvasElement | 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 for DOM canvases (safe when DOM globals are absent). */
+export declare function isHTMLCanvasElement(canvas: HTMLCanvasElement): canvas is HTMLCanvasElement;
+/**
+ * Creates a new GPUContext state with initial values.
+ *
+ * @param canvas - Optional canvas element (HTMLCanvasElement) 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?: HTMLCanvasElement, 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) 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?: HTMLCanvasElement, 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) to configure for WebGPU rendering
+     * @param options - Optional configuration for device pixel ratio, alpha mode, and power preference
+     */
+    constructor(canvas?: HTMLCanvasElement, 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) 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?: HTMLCanvasElement, 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/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/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/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/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/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/core/createRenderCoordinator.d.ts

@@ -0,0 +1,78 @@
+import type { ResolvedChartGPUOptions } from '../config/OptionResolver';
+import type { OHLCDataPoint } from '../config/types';
+import { GPUContext } from './GPUContext';
+import type { CartesianSeriesData } from '../config/types';
+export interface GPUContextLike {
+    readonly device: GPUDevice | null;
+    readonly canvas: HTMLCanvasElement | 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: CartesianSeriesData | 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;
+    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;
+    /**
+     * Called when GPU device is lost.
+     */
+    readonly onDeviceLost?: (reason: string) => void;
+}>;
+export declare function createRenderCoordinator(gpuContext: GPUContext, options: ResolvedChartGPUOptions, callbacks?: RenderCoordinatorCallbacks): RenderCoordinator;
+//# sourceMappingURL=createRenderCoordinator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createRenderCoordinator.d.ts","sourceRoot":"","sources":["../../src/core/createRenderCoordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,uBAAuB,EAExB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAKV,aAAa,EAGd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAiD,MAAM,cAAc,CAAC;AAgBzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAqD3D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAmCD,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,eAAe,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC3D;;;;;OAKG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,GAAG,aAAa,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IACrG;;;;;OAKG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;IACjC;;;;OAIG;IACH,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1D;;;;OAIG;IACH,oBAAoB,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACzF;;OAEG;IACH,YAAY,IAAI,QAAQ,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IAChE;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC7F,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IACtC;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD,CAAC,CAAC;AAq4BH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,uBAAuB,EAChC,SAAS,CAAC,EAAE,0BAA0B,GACrC,iBAAiB,CAkpFnB"}