chartgpu 0.2.2 → 0.2.4

package/dist/core/renderCoordinator/render/renderOverlays.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Overlay Rendering Utilities
+ *
+ * Prepares and renders GPU-based chart overlays (grid, axes, crosshair, highlight).
+ * These overlays are rendered on top of the main chart series.
+ *
+ * @module renderOverlays
+ */
+import type { ResolvedChartGPUOptions } from '../../../config/OptionResolver';
+import type { LinearScale } from '../../../utils/scales';
+import type { GridRenderer } from '../../../renderers/createGridRenderer';
+import type { AxisRenderer } from '../../../renderers/createAxisRenderer';
+import type { CrosshairRenderer } from '../../../renderers/createCrosshairRenderer';
+import type { HighlightRenderer } from '../../../renderers/createHighlightRenderer';
+import type { GridArea } from '../../../renderers/createGridRenderer';
+export interface OverlayRenderers {
+    gridRenderer: GridRenderer;
+    xAxisRenderer: AxisRenderer;
+    yAxisRenderer: AxisRenderer;
+    crosshairRenderer: CrosshairRenderer;
+    highlightRenderer: HighlightRenderer;
+}
+export interface OverlayPrepareContext {
+    currentOptions: ResolvedChartGPUOptions;
+    xScale: LinearScale;
+    yScale: LinearScale;
+    gridArea: GridArea;
+    xTickCount: number;
+    hasCartesianSeries: boolean;
+    effectivePointer: {
+        hasPointer: boolean;
+        isInGrid: boolean;
+        source: 'mouse' | 'sync';
+        x: number;
+        y: number;
+        gridX: number;
+        gridY: number;
+    };
+    interactionScales: {
+        xScale: LinearScale;
+        yScale: LinearScale;
+    } | null;
+    seriesForRender: ReadonlyArray<any>;
+    withAlpha: (color: string, alpha: number) => string;
+}
+export interface OverlayRenderContext {
+    mainPass: GPURenderPassEncoder;
+    topOverlayPass: GPURenderPassEncoder;
+    hasCartesianSeries: boolean;
+}
+/**
+ * Prepares all overlay renderers with current frame data.
+ *
+ * This includes grid lines, axes, crosshair, and point highlights.
+ *
+ * @param renderers - Overlay renderer instances
+ * @param context - Rendering context with scales, options, and pointer state
+ */
+export declare function prepareOverlays(renderers: OverlayRenderers, context: OverlayPrepareContext): void;
+/**
+ * Renders all overlay elements to the appropriate render passes.
+ *
+ * Grid is rendered in the main pass (background).
+ * Highlight, axes, and crosshair are rendered in the top overlay pass (foreground).
+ *
+ * @param renderers - Overlay renderer instances
+ * @param context - Render pass context
+ */
+export declare function renderOverlays(renderers: OverlayRenderers, context: OverlayRenderContext): void;
+//# sourceMappingURL=renderOverlays.d.ts.map

package/dist/core/renderCoordinator/render/renderOverlays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderOverlays.d.ts","sourceRoot":"","sources":["../../../../src/core/renderCoordinator/render/renderOverlays.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAA0B,MAAM,4CAA4C,CAAC;AAC5G,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,4CAA4C,CAAC;AACpG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AAStE,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,YAAY,CAAC;IAC5B,aAAa,EAAE,YAAY,CAAC;IAC5B,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,uBAAuB,CAAC;IACxC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE;QAChB,UAAU,EAAE,OAAO,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;QACzB,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,iBAAiB,EAAE;QACjB,MAAM,EAAE,WAAW,CAAC;QACpB,MAAM,EAAE,WAAW,CAAC;KACrB,GAAG,IAAI,CAAC;IACT,eAAe,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IACpC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACrD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,cAAc,EAAE,oBAAoB,CAAC;IACrC,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAoGjG;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAe/F"}

package/dist/core/renderCoordinator/render/renderSeries.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Series Rendering Utilities
+ *
+ * Prepares and renders all chart series types (area, line, bar, scatter, candlestick, pie).
+ * Handles intro animations, GPU buffer management, and multi-pass rendering with proper layering.
+ *
+ * @module renderSeries
+ */
+import type { ResolvedChartGPUOptions, ResolvedSeriesConfig, ResolvedBarSeriesConfig } from '../../../config/OptionResolver';
+import type { LinearScale } from '../../../utils/scales';
+import type { GridArea } from '../../../renderers/createGridRenderer';
+import type { LineRenderer } from '../../../renderers/createLineRenderer';
+import type { AreaRenderer } from '../../../renderers/createAreaRenderer';
+import type { BarRenderer } from '../../../renderers/createBarRenderer';
+import type { ScatterRenderer } from '../../../renderers/createScatterRenderer';
+import type { ScatterDensityRenderer } from '../../../renderers/createScatterDensityRenderer';
+import type { PieRenderer } from '../../../renderers/createPieRenderer';
+import type { CandlestickRenderer } from '../../../renderers/createCandlestickRenderer';
+import type { ReferenceLineRenderer } from '../../../renderers/createReferenceLineRenderer';
+import type { AnnotationMarkerRenderer } from '../../../renderers/createAnnotationMarkerRenderer';
+import type { DataStore } from '../../../data/createDataStore';
+export interface SeriesRenderers {
+    lineRenderers: LineRenderer[];
+    areaRenderers: AreaRenderer[];
+    barRenderer: BarRenderer;
+    scatterRenderers: ScatterRenderer[];
+    scatterDensityRenderers: ScatterDensityRenderer[];
+    pieRenderers: PieRenderer[];
+    candlestickRenderers: CandlestickRenderer[];
+}
+export interface AnnotationRenderers {
+    referenceLineRenderer: ReferenceLineRenderer;
+    referenceLineRendererMsaa: ReferenceLineRenderer;
+    annotationMarkerRenderer: AnnotationMarkerRenderer;
+    annotationMarkerRendererMsaa: AnnotationMarkerRenderer;
+}
+export interface SeriesPrepareContext {
+    currentOptions: ResolvedChartGPUOptions;
+    seriesForRender: ReadonlyArray<ResolvedSeriesConfig>;
+    xScale: LinearScale;
+    yScale: LinearScale;
+    gridArea: GridArea;
+    dataStore: DataStore;
+    appendedGpuThisFrame: Set<number>;
+    gpuSeriesKindByIndex: Array<'fullRawLine' | 'other' | 'unknown'>;
+    zoomState: {
+        getRange(): {
+            start: number;
+            end: number;
+        } | null;
+    } | null;
+    visibleXDomain: {
+        min: number;
+        max: number;
+    };
+    introPhase: 'pending' | 'running' | 'done';
+    introProgress01: number;
+    withAlpha: (color: string, alpha: number) => string;
+    maxRadiusCss: number;
+}
+export interface SeriesRenderContext {
+    hasCartesianSeries: boolean;
+    gridArea: GridArea;
+    mainPass: GPURenderPassEncoder;
+    plotScissor: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    introPhase: 'pending' | 'running' | 'done';
+    introProgress01: number;
+    referenceLineBelowCount: number;
+    markerBelowCount: number;
+}
+export interface AboveSeriesAnnotationContext {
+    hasCartesianSeries: boolean;
+    gridArea: GridArea;
+    overlayPass: GPURenderPassEncoder;
+    plotScissor: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    referenceLineBelowCount: number;
+    referenceLineAboveCount: number;
+    markerBelowCount: number;
+    markerAboveCount: number;
+}
+export interface SeriesPreparationResult {
+    visibleSeriesForRender: ReadonlyArray<{
+        series: ResolvedSeriesConfig;
+        originalIndex: number;
+    }>;
+    barSeriesConfigs: ResolvedBarSeriesConfig[];
+    visibleBarSeriesConfigs: ResolvedBarSeriesConfig[];
+}
+/**
+ * Prepares all series renderers with current frame data.
+ *
+ * This loop prepares ALL series (including hidden) to maintain correct renderer indices.
+ * Visibility filtering happens after preparation for rendering.
+ *
+ * @param renderers - Series renderer instances
+ * @param context - Preparation context with scales, options, and state
+ * @returns Preparation result with visibility-filtered series arrays
+ */
+export declare function prepareSeries(renderers: SeriesRenderers, context: SeriesPrepareContext): SeriesPreparationResult;
+/**
+ * Encodes scatter density compute passes before rendering.
+ *
+ * Must be called before beginRenderPass() for the main pass.
+ *
+ * @param renderers - Series renderer instances
+ * @param seriesForRender - All series configurations
+ * @param encoder - Command encoder for compute passes
+ */
+export declare function encodeScatterDensityCompute(renderers: SeriesRenderers, seriesForRender: ReadonlyArray<ResolvedSeriesConfig>, encoder: GPUCommandEncoder): void;
+/**
+ * Renders all series to the main render pass with proper layering.
+ *
+ * Render order (from back to front):
+ * 1. Pies (non-cartesian, behind cartesian series)
+ * 2. Annotations below series (reference lines, markers)
+ * 3. Area fills
+ * 4. Bars
+ * 5. Candlesticks
+ * 6. Scatter points
+ * 7. Line strokes
+ *
+ * @param renderers - Series renderer instances
+ * @param annotationRenderers - Annotation renderer instances
+ * @param context - Render pass context with pass encoders and state
+ */
+export declare function renderSeries(renderers: SeriesRenderers, annotationRenderers: AnnotationRenderers, context: SeriesRenderContext, prepResult: SeriesPreparationResult): void;
+/**
+ * Renders above-series annotations to the MSAA overlay pass.
+ *
+ * Must be called during the MSAA overlay pass (after blit).
+ *
+ * @param annotationRenderers - Annotation renderer instances
+ * @param context - Render pass context with overlay pass and state
+ */
+export declare function renderAboveSeriesAnnotations(annotationRenderers: AnnotationRenderers, context: AboveSeriesAnnotationContext): void;
+//# sourceMappingURL=renderSeries.d.ts.map

package/dist/core/renderCoordinator/render/renderSeries.d.ts.map

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

package/dist/core/renderCoordinator/renderers/rendererPool.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Renderer pool management for the RenderCoordinator.
+ *
+ * Manages dynamic arrays of chart renderers with lazy instantiation and proper disposal.
+ * Each chart type (line, area, scatter, etc.) maintains a pool of renderer instances
+ * that grows/shrinks based on the number of series.
+ *
+ * @module rendererPool
+ */
+import { createAreaRenderer } from '../../../renderers/createAreaRenderer';
+import { createLineRenderer } from '../../../renderers/createLineRenderer';
+import { createScatterRenderer } from '../../../renderers/createScatterRenderer';
+import { createScatterDensityRenderer } from '../../../renderers/createScatterDensityRenderer';
+import { createPieRenderer } from '../../../renderers/createPieRenderer';
+import { createCandlestickRenderer } from '../../../renderers/createCandlestickRenderer';
+import { createBarRenderer } from '../../../renderers/createBarRenderer';
+/**
+ * Configuration for renderer pool creation.
+ */
+export interface RendererPoolConfig {
+    readonly device: GPUDevice;
+    readonly targetFormat: GPUTextureFormat;
+}
+/**
+ * Renderer pool state exposed to the render coordinator.
+ */
+export interface RendererPoolState {
+    readonly areaRenderers: ReadonlyArray<ReturnType<typeof createAreaRenderer>>;
+    readonly lineRenderers: ReadonlyArray<ReturnType<typeof createLineRenderer>>;
+    readonly scatterRenderers: ReadonlyArray<ReturnType<typeof createScatterRenderer>>;
+    readonly scatterDensityRenderers: ReadonlyArray<ReturnType<typeof createScatterDensityRenderer>>;
+    readonly pieRenderers: ReadonlyArray<ReturnType<typeof createPieRenderer>>;
+    readonly candlestickRenderers: ReadonlyArray<ReturnType<typeof createCandlestickRenderer>>;
+    readonly barRenderer: ReturnType<typeof createBarRenderer>;
+}
+/**
+ * Renderer pool interface returned by factory function.
+ */
+export interface RendererPool {
+    /**
+     * Ensures area renderer count matches the given count.
+     * Grows or shrinks the pool as needed, disposing excess renderers.
+     *
+     * @param count - Desired number of area renderers
+     */
+    ensureAreaRendererCount(count: number): void;
+    /**
+     * Ensures line renderer count matches the given count.
+     * Grows or shrinks the pool as needed, disposing excess renderers.
+     *
+     * @param count - Desired number of line renderers
+     */
+    ensureLineRendererCount(count: number): void;
+    /**
+     * Ensures scatter renderer count matches the given count.
+     * Grows or shrinks the pool as needed, disposing excess renderers.
+     *
+     * @param count - Desired number of scatter renderers
+     */
+    ensureScatterRendererCount(count: number): void;
+    /**
+     * Ensures scatter density renderer count matches the given count.
+     * Grows or shrinks the pool as needed, disposing excess renderers.
+     *
+     * @param count - Desired number of scatter density renderers
+     */
+    ensureScatterDensityRendererCount(count: number): void;
+    /**
+     * Ensures pie renderer count matches the given count.
+     * Grows or shrinks the pool as needed, disposing excess renderers.
+     *
+     * @param count - Desired number of pie renderers
+     */
+    ensurePieRendererCount(count: number): void;
+    /**
+     * Ensures candlestick renderer count matches the given count.
+     * Grows or shrinks the pool as needed, disposing excess renderers.
+     *
+     * @param count - Desired number of candlestick renderers
+     */
+    ensureCandlestickRendererCount(count: number): void;
+    /**
+     * Gets current renderer pool state for rendering.
+     * Returns readonly arrays to prevent external mutation.
+     *
+     * @returns Current state with all renderer arrays
+     */
+    getState(): RendererPoolState;
+    /**
+     * Disposes all renderers in the pool.
+     * Clears all arrays and destroys GPU resources.
+     */
+    dispose(): void;
+}
+/**
+ * Creates a renderer pool for dynamic renderer management.
+ *
+ * The renderer pool uses lazy instantiation: renderers are only created when
+ * the pool grows, and are disposed when the pool shrinks. This allows the
+ * render coordinator to efficiently handle varying numbers of series.
+ *
+ * **Architecture:**
+ * - Each chart type has a dedicated renderer array
+ * - Bar renderer is a singleton (not pooled)
+ * - Renderers are disposed when removed from the pool
+ * - Arrays are cleared to release references
+ *
+ * @param config - Configuration with device and target format
+ * @returns Renderer pool instance
+ */
+export declare function createRendererPool(config: RendererPoolConfig): RendererPool;
+//# sourceMappingURL=rendererPool.d.ts.map

package/dist/core/renderCoordinator/renderers/rendererPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendererPool.d.ts","sourceRoot":"","sources":["../../../../src/core/renderCoordinator/renderers/rendererPool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAC7E,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAC7E,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC;IACnF,QAAQ,CAAC,uBAAuB,EAAE,aAAa,CAAC,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC,CAAC;IACjG,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;IAC3E,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC;IAC3F,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7C;;;;;OAKG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7C;;;;;OAKG;IACH,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhD;;;;;OAKG;IACH,iCAAiC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvD;;;;;OAKG;IACH,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C;;;;;OAKG;IACH,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpD;;;;;OAKG;IACH,QAAQ,IAAI,iBAAiB,CAAC;IAE9B;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CA+K3E"}

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

@@ -0,0 +1,19 @@
+/**
+ * Shared types for the RenderCoordinator modules.
+ *
+ * @module types
+ */
+/**
+ * Minimal GPUContext interface required by RenderCoordinator utilities.
+ * This interface allows the render coordinator to work with any object
+ * that provides WebGPU context properties, not just the full GPUContext class.
+ */
+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;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/renderCoordinator/ui/tooltipLegendHelpers.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Tooltip and legend helper utilities.
+ *
+ * Provides utilities for managing tooltip state, caching content to avoid
+ * unnecessary DOM updates, and computing tooltip anchor positions for special
+ * chart types like candlesticks.
+ *
+ * @module tooltipLegendHelpers
+ */
+import type { OHLCDataPoint } from '../../../config/types';
+import type { LinearScale } from '../../../utils/scales';
+/**
+ * Tooltip anchor position in canvas-local CSS pixels.
+ */
+export interface TooltipAnchor {
+    readonly x: number;
+    readonly y: number;
+}
+/**
+ * Cached tooltip state for content deduplication.
+ *
+ * Tracks the last displayed content and position to avoid unnecessary DOM updates
+ * when the tooltip hasn't actually changed.
+ */
+export interface TooltipCache {
+    content: string | null;
+    x: number | null;
+    y: number | null;
+}
+/**
+ * Creates a new empty tooltip cache.
+ *
+ * @returns Fresh tooltip cache with null values
+ */
+export declare function createTooltipCache(): TooltipCache;
+/**
+ * Checks if tooltip content or position has changed.
+ *
+ * Returns true if any of the values differ from the cache, indicating that
+ * a DOM update is needed.
+ *
+ * @param cache - Current cached state
+ * @param content - New content to display
+ * @param x - New X position in CSS pixels
+ * @param y - New Y position in CSS pixels
+ * @returns True if update is needed (values differ from cache)
+ */
+export declare function shouldUpdateTooltip(cache: TooltipCache, content: string, x: number, y: number): boolean;
+/**
+ * Updates the tooltip cache with new values.
+ *
+ * Should be called after successfully updating the DOM to keep cache in sync.
+ *
+ * @param cache - Tooltip cache to update (mutated)
+ * @param content - New content that was displayed
+ * @param x - New X position that was set
+ * @param y - New Y position that was set
+ */
+export declare function updateTooltipCache(cache: TooltipCache, content: string, x: number, y: number): void;
+/**
+ * Clears the tooltip cache.
+ *
+ * Should be called when the tooltip is hidden to ensure fresh state
+ * when it's shown again.
+ *
+ * @param cache - Tooltip cache to clear (mutated)
+ */
+export declare function clearTooltipCache(cache: TooltipCache): void;
+/**
+ * Computes container-local CSS pixel anchor coordinates for a candlestick tooltip.
+ *
+ * The anchor is positioned near the candle body center for stable tooltip positioning
+ * even when the cursor is at the edge of the candlestick.
+ *
+ * Coordinate transformations:
+ * 1. Extract O/H/L/C from data point (tuple: [timestamp, open, close, low, high])
+ * 2. Compute body center Y = (open + close) / 2
+ * 3. Transform to clip space via scales
+ * 4. Convert clip space to canvas-local CSS pixels
+ * 5. Add container offset for absolute positioning
+ *
+ * Returns null if any coordinate computation fails (non-finite values).
+ *
+ * @param point - OHLC data point (tuple or object format)
+ * @param xScale - Linear scale for X axis
+ * @param yScale - Linear scale for Y axis
+ * @param canvasCssWidth - Canvas width in CSS pixels
+ * @param canvasCssHeight - Canvas height in CSS pixels
+ * @param offsetX - Container offset X in CSS pixels (default: 0)
+ * @param offsetY - Container offset Y in CSS pixels (default: 0)
+ * @returns Tooltip anchor position or null if computation fails
+ */
+export declare function computeCandlestickTooltipAnchor(point: OHLCDataPoint, xScale: LinearScale, yScale: LinearScale, canvasCssWidth: number, canvasCssHeight: number, offsetX?: number, offsetY?: number): TooltipAnchor | null;
+/**
+ * Determines if a data point is an OHLC/candlestick point.
+ *
+ * Checks if the point is a 5-element tuple (timestamp, open, close, low, high)
+ * or an object with OHLC properties.
+ *
+ * @param point - Data point to check
+ * @returns True if point is OHLC format
+ */
+export declare function isOHLCDataPoint(point: any): point is OHLCDataPoint;
+//# sourceMappingURL=tooltipLegendHelpers.d.ts.map

package/dist/core/renderCoordinator/ui/tooltipLegendHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltipLegendHelpers.d.ts","sourceRoot":"","sources":["../../../../src/core/renderCoordinator/ui/tooltipLegendHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAMjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,MAAM,EACf,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,OAAO,CAET;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,MAAM,EACf,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,IAAI,CAIN;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAI3D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,EACnB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,MAAU,EACnB,OAAO,GAAE,MAAU,GAClB,aAAa,GAAG,IAAI,CA0CtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,aAAa,CAclE"}

package/dist/core/renderCoordinator/utils/axisUtils.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Axis and grid utilities for the RenderCoordinator.
+ *
+ * These pure functions handle coordinate transformations between different spaces:
+ * - CSS pixels (DOM layout)
+ * - Device pixels (canvas.width/height)
+ * - Normalized device coordinates / clip space (WebGPU [-1, 1])
+ *
+ * @module axisUtils
+ */
+import type { GPUContextLike } from '../types';
+import type { ResolvedChartGPUOptions } from '../../../config/OptionResolver';
+import type { GridArea } from '../../../renderers/createGridRenderer';
+/**
+ * Computes grid area with margins and canvas dimensions for rendering layout.
+ * GridArea uses:
+ * - Margins (left, right, top, bottom) in CSS pixels
+ * - Canvas dimensions (canvasWidth, canvasHeight) in DEVICE pixels
+ * - devicePixelRatio for CSS-to-device conversion
+ *
+ * @param gpuContext - GPU context with canvas and device pixel ratio
+ * @param options - Resolved chart options with grid margins
+ * @returns GridArea object with margins, canvas dimensions, and DPR
+ * @throws If canvas is null or has invalid dimensions
+ */
+export declare const computeGridArea: (gpuContext: GPUContextLike, options: ResolvedChartGPUOptions) => GridArea;
+/**
+ * Converts RGBA normalized [0-1] values to CSS rgba() string.
+ *
+ * @param rgba - Array of [r, g, b, a] in range [0, 1]
+ * @returns CSS rgba() string
+ */
+export declare const rgba01ToCssRgba: (rgba: readonly [number, number, number, number]) => string;
+/**
+ * Applies alpha multiplier to CSS color.
+ * Parses color, multiplies alpha channel, and returns new CSS rgba() string.
+ *
+ * @param cssColor - CSS color string
+ * @param alphaMultiplier - Alpha multiplier in range [0, 1]
+ * @returns CSS rgba() string with modified alpha, or original color if parse fails
+ */
+export declare const withAlpha: (cssColor: string, alphaMultiplier: number) => string;
+/**
+ * Converts grid margins to normalized device clip coordinates for WebGPU.
+ * Output is in WebGPU clip space: [-1, 1] for both x and y.
+ * Y-axis is flipped (top is positive, bottom is negative).
+ *
+ * @param gridArea - Grid area with margins and canvas dimensions
+ * @returns Clip rect with left, right, top, bottom in range [-1, 1]
+ */
+export declare const computePlotClipRect: (gridArea: GridArea) => {
+    readonly left: number;
+    readonly right: number;
+    readonly top: number;
+    readonly bottom: number;
+};
+/**
+ * Clamps value to [0, 1] range.
+ *
+ * @param v - Value to clamp
+ * @returns Clamped value
+ */
+export declare const clamp01: (v: number) => number;
+/**
+ * Linear interpolation between two values with clamped t.
+ *
+ * @param a - Start value
+ * @param b - End value
+ * @param t01 - Interpolation parameter in range [0, 1]
+ * @returns Interpolated value
+ */
+export declare const lerp: (a: number, b: number, t01: number) => number;
+/**
+ * Interpolates between two domains (min/max pairs).
+ * Ensures result is a valid domain (min ≤ max, both finite).
+ *
+ * @param from - Start domain
+ * @param to - End domain
+ * @param t01 - Interpolation parameter in range [0, 1]
+ * @returns Interpolated domain
+ */
+export declare const lerpDomain: (from: {
+    readonly min: number;
+    readonly max: number;
+}, to: {
+    readonly min: number;
+    readonly max: number;
+}, t01: number) => {
+    readonly min: number;
+    readonly max: number;
+};
+/**
+ * Computes scissor rect in device pixels from grid margins.
+ * Used for WebGPU scissor testing to clip rendering to plot area.
+ *
+ * @param gridArea - Grid area with margins and canvas dimensions
+ * @returns Scissor rect with x, y, w, h in device pixels
+ */
+export declare const computePlotScissorDevicePx: (gridArea: GridArea) => {
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+};
+/**
+ * Converts clip-space X to canvas CSS pixels (from normalized [-1, 1]).
+ *
+ * @param xClip - X coordinate in clip space [-1, 1]
+ * @param canvasCssWidth - Canvas width in CSS pixels
+ * @returns X coordinate in canvas CSS pixels
+ */
+export declare const clipXToCanvasCssPx: (xClip: number, canvasCssWidth: number) => number;
+/**
+ * Converts clip-space Y to canvas CSS pixels (from normalized [-1, 1]).
+ * Y-axis is flipped (1 is top, -1 is bottom).
+ *
+ * @param yClip - Y coordinate in clip space [-1, 1]
+ * @param canvasCssHeight - Canvas height in CSS pixels
+ * @returns Y coordinate in canvas CSS pixels
+ */
+export declare const clipYToCanvasCssPx: (yClip: number, canvasCssHeight: number) => number;
+//# sourceMappingURL=axisUtils.d.ts.map

package/dist/core/renderCoordinator/utils/axisUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axisUtils.d.ts","sourceRoot":"","sources":["../../../../src/core/renderCoordinator/utils/axisUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AAKtE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAAI,YAAY,cAAc,EAAE,SAAS,uBAAuB,KAAG,QA4C9F,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,KAAG,MAMjF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,MAAM,EAAE,iBAAiB,MAAM,KAAG,MAKrE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,QAAQ,KACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAmBhG,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,KAAG,MAAqC,CAAC;AAE1E;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,KAAK,MAAM,KAAG,MAAoC,CAAC;AAE9F;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACpD,IAAI;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAClD,KAAK,MAAM,KACV;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAE9C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACrC,UAAU,QAAQ,KACjB;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAgBlF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,EAAE,gBAAgB,MAAM,KAAG,MAA4C,CAAC;AAExH;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,EAAE,iBAAiB,MAAM,KAAG,MAA6C,CAAC"}