chartgpu 0.2.2 → 0.2.3

package/README.md

@@ -38,7 +38,7 @@ ChartGPU is a TypeScript charting library built on WebGPU for smooth, interactiv
 
 ## Architecture
 
-At a high level, `ChartGPU.create(...)` owns the canvas + WebGPU lifecycle, and delegates render orchestration (layout/scales/data upload/render passes + internal overlays) to the render coordinator. For deeper internal notes, see [`docs/api/INTERNALS.md`](https://github.com/hunterg325/ChartGPU/blob/main/docs/api/INTERNALS.md) (especially “Render coordinator”).
+At a high level, `ChartGPU.create(...)` owns the canvas + WebGPU lifecycle, and delegates render orchestration (layout/scales/data upload/render passes + internal overlays) to the render coordinator. For deeper internal notes, see [`docs/api/INTERNALS.md`](https://github.com/hunterg325/ChartGPU/blob/main/docs/api/INTERNALS.md) (especially "Render coordinator").
 
 ```mermaid
 flowchart TB
@@ -77,7 +77,23 @@ flowchart TB
       GPUInit --> CanvasConfig["canvasContext.configure(format)"]
     end
 
-    subgraph RenderCoordinatorLayer["Render coordinator (src/core/createRenderCoordinator.ts)"]
+    subgraph RenderCoordinatorLayer["Render coordinator (src/core/createRenderCoordinator.ts)<br/>Modular architecture with specialized modules"]
+      subgraph CoordModules["Coordinator modules (src/core/renderCoordinator/*)"]
+        Utils["utils/ - Canvas, bounds, axes, time formatting"]
+        GPU["gpu/ - Texture management, MSAA"]
+        Renderers["renderers/ - Renderer pool management"]
+        DataMods["data/ - Visible slice computation"]
+        Zoom["zoom/ - Zoom state utilities"]
+        Anim["animation/ - Animation helpers"]
+        Interact["interaction/ - Pointer & hit-testing"]
+        UI["ui/ - Tooltip & legend helpers"]
+        AxisMods["axis/ - Tick computation & labels"]
+        Annot["annotations/ - Annotation processing"]
+        Render["render/ - Series, overlays, labels"]
+      end
+
+      Coordinator --> CoordModules
+
       Coordinator --> Layout["GridArea layout"]
       Coordinator --> Scales["xScale/yScale (clip space for render)"]
       Coordinator --> DataUpload["createDataStore(device) (GPU buffer upload/caching)"]
@@ -249,7 +265,9 @@ See the [chartgpu-react repository](https://github.com/ChartGPU/chartgpu-react)
 
 - Chrome 113+ or Edge 113+ (WebGPU enabled by default)
 - Safari 18+ (WebGPU enabled by default)
-- Firefox: not supported (WebGPU support in development)
+- Firefox: Windows 114+, Mac 145+, Linux nightly
+
+See the [gpuweb repository](https://github.com/gpuweb/gpuweb/wiki/Implementation-Status) for full Implementation Status
 
 ## Documentation
 

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

@@ -1 +1 @@
-{"version":3,"file":"createRenderCoordinator.d.ts","sourceRoot":"","sources":["../../src/core/createRenderCoordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,uBAAuB,EAExB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAGV,SAAS,EAET,aAAa,EAId,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAiD,MAAM,cAAc,CAAC;AAkEzF,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;AA4CD,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,eAAe,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC3D;;;;;OAKG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,aAAa,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAC1G;;;;;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;AAirCH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,uBAAuB,EAChC,SAAS,CAAC,EAAE,0BAA0B,GACrC,iBAAiB,CA+0GnB"}
+{"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,EAGV,SAAS,EAET,aAAa,EAGd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAiD,MAAM,cAAc,CAAC;AA6DzF,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,aAAa,CAAC,SAAS,CAAC,GAAG,aAAa,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAC1G;;;;;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;AAo3BH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,uBAAuB,EAChC,SAAS,CAAC,EAAE,0BAA0B,GACrC,iBAAiB,CAorFnB"}

package/dist/core/renderCoordinator/animation/animationHelpers.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Animation helper utilities for intro and update animations.
+ *
+ * Provides pure functions for animation config resolution, easing transformations,
+ * series interpolation, and animation state management. These utilities support
+ * both intro animations (initial reveal) and update animations (smooth transitions).
+ *
+ * @module animationHelpers
+ */
+import type { AnimationConfig, DataPoint } from '../../../config/types';
+import type { ResolvedPieSeriesConfig } from '../../../config/OptionResolver';
+import type { EasingFunction } from '../../../utils/easing';
+/**
+ * Intro animation phase state machine.
+ */
+export type IntroPhase = 'pending' | 'running' | 'done';
+/**
+ * Domain boundaries with min and max values.
+ */
+export interface DomainBounds {
+    readonly min: number;
+    readonly max: number;
+}
+/**
+ * Resolved animation configuration with timing and easing.
+ */
+export interface ResolvedAnimationConfig {
+    readonly delayMs: number;
+    readonly durationMs: number;
+    readonly easing: EasingFunction;
+}
+/**
+ * Series configuration type that supports all series types.
+ */
+export type AnySeriesConfig = {
+    readonly type: 'line';
+    readonly data: ReadonlyArray<DataPoint>;
+} | {
+    readonly type: 'area';
+    readonly data: ReadonlyArray<DataPoint>;
+} | {
+    readonly type: 'bar';
+    readonly data: ReadonlyArray<DataPoint>;
+} | {
+    readonly type: 'scatter';
+    readonly data: ReadonlyArray<DataPoint>;
+} | {
+    readonly type: 'candlestick';
+    readonly data: ReadonlyArray<any>;
+} | ResolvedPieSeriesConfig;
+/**
+ * Clamps a value between 0 and 1.
+ *
+ * @param value - Value to clamp
+ * @returns Clamped value in [0, 1]
+ */
+export declare function clamp01(value: number): number;
+/**
+ * Resolves animation configuration from options.
+ *
+ * Returns null if animation is disabled (false or null).
+ * Returns default config if animation is true or an empty object.
+ * Converts duration/delay from user config to milliseconds.
+ *
+ * @param animation - Animation options from chart config
+ * @param getEasingFn - Function to resolve easing by name (to avoid circular deps)
+ * @returns Resolved animation config or null if disabled
+ */
+export declare function resolveAnimationConfig(animation: boolean | AnimationConfig | null | undefined, getEasingFn: (name: string) => EasingFunction): ResolvedAnimationConfig | null;
+/**
+ * Creates an easing function that incorporates delay.
+ *
+ * The returned function maps t ∈ [0, 1] to an output considering both delay
+ * and duration:
+ * - t in [0, delay]: output = 0 (delay phase)
+ * - t in [delay, delay+duration]: output = easing((t-delay)/duration)
+ * - t > delay+duration: output = 1 (complete)
+ *
+ * @param delayMs - Delay before animation starts (milliseconds)
+ * @param durationMs - Animation duration after delay (milliseconds)
+ * @param easing - Base easing function to apply after delay
+ * @returns Easing function with delay incorporated
+ */
+export declare function createEasingWithDelay(delayMs: number, durationMs: number, easing: EasingFunction): EasingFunction;
+/**
+ * Checks if a series configuration has drawable marks.
+ *
+ * Returns true if the series has data that will produce visible marks:
+ * - Pie: at least one slice with value > 0
+ * - Cartesian (line/area/bar/scatter/candlestick): at least one data point
+ *
+ * @param series - Series configuration to check
+ * @returns True if series has drawable content
+ */
+export declare function hasDrawableMarks(series: AnySeriesConfig): boolean;
+/**
+ * Checks if any series in the list has drawable marks.
+ *
+ * @param seriesList - Array of series configurations
+ * @returns True if at least one series has drawable marks
+ */
+export declare function hasAnyDrawableMarks(seriesList: ReadonlyArray<AnySeriesConfig>): boolean;
+/**
+ * Linearly interpolates between two domain bounds.
+ *
+ * @param from - Starting domain
+ * @param to - Ending domain
+ * @param t - Interpolation progress [0, 1]
+ * @returns Interpolated domain
+ */
+export declare function lerpDomain(from: DomainBounds, to: DomainBounds, t: number): DomainBounds;
+/**
+ * Linearly interpolates between two numbers.
+ *
+ * @param from - Starting value
+ * @param to - Ending value
+ * @param t - Interpolation progress [0, 1]
+ * @returns Interpolated value
+ */
+export declare function lerp(from: number, to: number, t: number): number;
+/**
+ * Interpolates cartesian series data between from and to states.
+ *
+ * Returns null if array lengths don't match (can't interpolate mismatched arrays).
+ * Reuses cache array if provided and same length.
+ *
+ * @param fromData - Starting data points
+ * @param toData - Ending data points
+ * @param t - Interpolation progress [0, 1]
+ * @param cache - Optional cache array to reuse
+ * @returns Interpolated data points or null if lengths mismatch
+ */
+export declare function interpolateCartesianData(fromData: ReadonlyArray<DataPoint>, toData: ReadonlyArray<DataPoint>, t: number, cache: DataPoint[] | null): DataPoint[] | null;
+/**
+ * Interpolates pie series data between from and to states.
+ *
+ * Returns the toSeries unchanged if data array lengths don't match.
+ * Only interpolates the value property; angles are recomputed by the renderer.
+ *
+ * @param fromSeries - Starting pie series
+ * @param toSeries - Ending pie series
+ * @param t - Interpolation progress [0, 1]
+ * @param cache - Optional cache array to reuse
+ * @returns Interpolated pie series
+ */
+export declare function interpolatePieData(fromSeries: ResolvedPieSeriesConfig, toSeries: ResolvedPieSeriesConfig, t: number, cache: ResolvedPieSeriesConfig['data'] | null): ResolvedPieSeriesConfig;
+/**
+ * Checks if two domain bounds are equal.
+ *
+ * @param a - First domain
+ * @param b - Second domain
+ * @returns True if domains have identical min and max
+ */
+export declare function isDomainEqual(a: DomainBounds, b: DomainBounds): boolean;
+/**
+ * Determines the next intro phase based on current state and conditions.
+ *
+ * State machine transitions:
+ * - pending → running: when has drawable marks and animation enabled
+ * - running → done: when animation completes
+ * - done → pending: when retriggering (e.g., visibility change)
+ *
+ * @param currentPhase - Current intro phase
+ * @param hasDrawable - Whether series have drawable marks
+ * @param animationEnabled - Whether animation is enabled
+ * @param retrigger - Whether to retrigger from done state
+ * @returns Next intro phase
+ */
+export declare function computeNextIntroPhase(currentPhase: IntroPhase, hasDrawable: boolean, animationEnabled: boolean, retrigger?: boolean): IntroPhase;
+/**
+ * Applies intro animation progress to create an animated bar Y scale.
+ *
+ * During intro, bars grow from the zero line (or domain min if no zero).
+ * This creates a scale that compresses bars based on progress.
+ *
+ * @param baseYScale - Original Y scale
+ * @param yMin - Domain minimum
+ * @param yMax - Domain maximum
+ * @param progress - Animation progress [0, 1]
+ * @returns Y coordinate adjusted for intro animation
+ */
+export declare function applyBarIntroProgress(baseY: number, yMin: number, yMax: number, progress: number): number;
+//# sourceMappingURL=animationHelpers.d.ts.map

package/dist/core/renderCoordinator/animation/animationHelpers.d.ts.map

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

package/dist/core/renderCoordinator/annotations/processAnnotations.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Annotation processing for the RenderCoordinator.
+ *
+ * Processes annotation configurations into GPU-renderable instances (reference lines,
+ * markers) and DOM label data. Supports layering (above/below series) and multiple
+ * annotation types (lineX, lineY, point, text).
+ *
+ * @module processAnnotations
+ */
+import type { AnnotationConfig } from '../../../config/types';
+import type { LinearScale } from '../../../utils/scales';
+import type { ThemeConfig } from '../../../themes/types';
+import type { ReferenceLineInstance } from '../../../renderers/createReferenceLineRenderer';
+import type { AnnotationMarkerInstance } from '../../../renderers/createAnnotationMarkerRenderer';
+/**
+ * Internal type for annotation label data (DOM overlay).
+ */
+export interface AnnotationLabelData {
+    readonly text: string;
+    readonly x: number;
+    readonly y: number;
+    readonly anchor?: 'start' | 'middle' | 'end';
+    readonly color?: string;
+    readonly fontSize?: number;
+    readonly background?: Readonly<{
+        readonly backgroundColor: string;
+        readonly padding?: readonly [number, number, number, number];
+        readonly borderRadius?: number;
+    }>;
+}
+/**
+ * Plot bounds in CSS pixels.
+ */
+export interface PlotBounds {
+    readonly leftCss: number;
+    readonly rightCss: number;
+    readonly topCss: number;
+    readonly bottomCss: number;
+    readonly widthCss: number;
+    readonly heightCss: number;
+}
+/**
+ * Context for annotation processing.
+ */
+export interface AnnotationContext {
+    readonly annotations: ReadonlyArray<AnnotationConfig>;
+    readonly xScale: LinearScale;
+    readonly yScale: LinearScale;
+    readonly plotBounds: PlotBounds;
+    readonly canvasCssWidth: number;
+    readonly canvasCssHeight: number;
+    readonly theme: ThemeConfig;
+    readonly offsetX?: number;
+    readonly offsetY?: number;
+}
+/**
+ * Result of annotation processing.
+ */
+export interface AnnotationResult {
+    readonly linesBelow: ReferenceLineInstance[];
+    readonly linesAbove: ReferenceLineInstance[];
+    readonly markersBelow: AnnotationMarkerInstance[];
+    readonly markersAbove: AnnotationMarkerInstance[];
+    readonly labels: AnnotationLabelData[];
+}
+/**
+ * Processes annotations into GPU-renderable instances and DOM labels.
+ *
+ * **Annotation Types:**
+ * - `lineX`: Vertical reference line at x coordinate
+ * - `lineY`: Horizontal reference line at y coordinate
+ * - `point`: Marker at (x, y) coordinate
+ * - `text`: Text annotation with flexible positioning
+ *
+ * **Layering:**
+ * - `belowSeries`: Rendered before series (occluded by data)
+ * - `aboveSeries`: Rendered after series (always visible, default)
+ *
+ * **Labels:**
+ * - Optional text labels for all annotation types
+ * - Template support with {x}, {y}, {value}, {name} placeholders
+ * - Background styling with padding and border radius
+ *
+ * @param context - Annotation processing context
+ * @returns Annotation result with lines, markers, and labels
+ */
+export declare function processAnnotations(context: AnnotationContext): AnnotationResult;
+//# sourceMappingURL=processAnnotations.d.ts.map

package/dist/core/renderCoordinator/annotations/processAnnotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processAnnotations.d.ts","sourceRoot":"","sources":["../../../../src/core/renderCoordinator/annotations/processAnnotations.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAC5F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mDAAmD,CAAC;AAMlG;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC;QAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,qBAAqB,EAAE,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,qBAAqB,EAAE,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,wBAAwB,EAAE,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,wBAAwB,EAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,mBAAmB,EAAE,CAAC;CACxC;AA8FD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAoP/E"}

package/dist/core/renderCoordinator/axis/axisLabelHelpers.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Axis label positioning and layout helpers.
+ *
+ * Provides pure functions for calculating axis label positions, anchor points,
+ * and title placements without DOM manipulation. These helpers are used by the
+ * render coordinator to position axis labels and titles correctly.
+ *
+ * @module axisLabelHelpers
+ */
+import type { TextOverlayAnchor } from '../../../components/createTextOverlay';
+/**
+ * Default label padding in CSS pixels.
+ */
+export declare const LABEL_PADDING_CSS_PX = 4;
+/**
+ * Calculates the anchor point for an x-axis tick label.
+ *
+ * - Single tick: centered
+ * - First tick: left-aligned (start)
+ * - Last tick: right-aligned (end)
+ * - Middle ticks: centered (middle)
+ *
+ * @param tickIndex - Index of the current tick
+ * @param totalTicks - Total number of ticks
+ * @returns Text anchor for label positioning
+ */
+export declare function getXAxisTickLabelAnchor(tickIndex: number, totalTicks: number): TextOverlayAnchor;
+/**
+ * Calculates the Y position for x-axis labels.
+ *
+ * X-axis labels are positioned below the plot area, with spacing for tick marks.
+ *
+ * @param plotBottomCss - Bottom edge of plot area in CSS pixels
+ * @param tickLengthCssPx - Length of tick marks
+ * @param fontSize - Font size for labels
+ * @returns Y position in CSS pixels (canvas-local)
+ */
+export declare function getXAxisLabelY(plotBottomCss: number, tickLengthCssPx: number, fontSize: number): number;
+/**
+ * Calculates the X position for y-axis labels.
+ *
+ * Y-axis labels are positioned to the left of the plot area, with spacing for tick marks.
+ *
+ * @param plotLeftCss - Left edge of plot area in CSS pixels
+ * @param tickLengthCssPx - Length of tick marks
+ * @returns X position in CSS pixels (canvas-local)
+ */
+export declare function getYAxisLabelX(plotLeftCss: number, tickLengthCssPx: number): number;
+/**
+ * Calculates the Y position for the x-axis title.
+ *
+ * The title is centered vertically between the tick labels and the bottom edge
+ * (or zoom slider if present).
+ *
+ * @param xLabelY - Y position of x-axis tick labels
+ * @param fontSize - Font size for tick labels
+ * @param canvasCssHeight - Canvas height in CSS pixels
+ * @param hasSliderZoom - Whether a slider zoom control is present
+ * @param sliderHeightCssPx - Height of slider zoom control (default: 32)
+ * @returns Y position for x-axis title in CSS pixels
+ */
+export declare function getXAxisTitleY(xLabelY: number, fontSize: number, canvasCssHeight: number, hasSliderZoom: boolean, sliderHeightCssPx?: number): number;
+/**
+ * Calculates the X position for the y-axis title.
+ *
+ * The title is positioned to the left of the tick labels, accounting for their width.
+ *
+ * @param yLabelX - X position of y-axis tick labels
+ * @param maxTickLabelWidth - Maximum width of tick labels in CSS pixels
+ * @param titleFontSize - Font size for axis title
+ * @returns X position for y-axis title in CSS pixels
+ */
+export declare function getYAxisTitleX(yLabelX: number, maxTickLabelWidth: number, titleFontSize: number): number;
+/**
+ * Measures the maximum width of a set of rendered labels.
+ *
+ * @param labelSpans - Array of HTMLSpanElement labels
+ * @returns Maximum width in CSS pixels, or 0 if no labels
+ */
+export declare function measureMaxLabelWidth(labelSpans: readonly HTMLSpanElement[]): number;
+/**
+ * Calculates the center position between two coordinates.
+ *
+ * Utility for centering axis titles within plot area.
+ *
+ * @param a - First coordinate
+ * @param b - Second coordinate
+ * @returns Midpoint between a and b
+ */
+export declare function getCenterPosition(a: number, b: number): number;
+//# sourceMappingURL=axisLabelHelpers.d.ts.map

package/dist/core/renderCoordinator/axis/axisLabelHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axisLabelHelpers.d.ts","sourceRoot":"","sources":["../../../../src/core/renderCoordinator/axis/axisLabelHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAKhG;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvG;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,OAAO,EACtB,iBAAiB,GAAE,MAAW,GAC7B,MAAM,CAUR;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAGxG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAGnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/dist/core/renderCoordinator/axis/computeAxisTicks.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Axis tick computation and formatting.
+ *
+ * Generates tick values and formatting for linear axes. Handles decimal precision
+ * determination based on tick step size and provides number formatting utilities.
+ *
+ * @module computeAxisTicks
+ */
+/**
+ * Generates evenly-spaced tick values between domain min and max.
+ *
+ * @param domainMin - Minimum value of the domain
+ * @param domainMax - Maximum value of the domain
+ * @param tickCount - Number of ticks to generate (must be >= 1)
+ * @returns Array of tick values
+ */
+export declare function generateLinearTicks(domainMin: number, domainMax: number, tickCount: number): number[];
+/**
+ * Computes the maximum number of decimal places needed to display a tick step cleanly.
+ *
+ * Prefers "clean" decimal representations (e.g., 2.5, 0.25, 0.125) without relying on
+ * magnitude alone. Accepts floating-point noise and caps the search to keep formatting
+ * reasonable.
+ *
+ * @param tickStep - The step size between ticks
+ * @param cap - Maximum number of decimal places to consider (default: 8)
+ * @returns Number of decimal places (0 to cap)
+ */
+export declare function computeMaxFractionDigitsFromStep(tickStep: number, cap?: number): number;
+/**
+ * Creates an Intl.NumberFormat for tick value formatting.
+ *
+ * Automatically determines the appropriate number of decimal places based on the
+ * tick step size using `computeMaxFractionDigitsFromStep()`.
+ *
+ * @param tickStep - The step size between ticks
+ * @returns Intl.NumberFormat configured for tick formatting
+ */
+export declare function createTickFormatter(tickStep: number): Intl.NumberFormat;
+/**
+ * Formats a numeric tick value using the provided number formatter.
+ *
+ * Handles edge cases:
+ * - Non-finite values return null
+ * - Values near zero (< 1e-12) are normalized to 0 to avoid "-0" display
+ * - Unexpected "NaN" output from formatter is guarded against
+ *
+ * @param nf - Intl.NumberFormat to use for formatting
+ * @param v - Numeric value to format
+ * @returns Formatted string or null if value cannot be formatted
+ */
+export declare function formatTickValue(nf: Intl.NumberFormat, v: number): string | null;
+//# sourceMappingURL=computeAxisTicks.d.ts.map

package/dist/core/renderCoordinator/axis/computeAxisTicks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeAxisTicks.d.ts","sourceRoot":"","sources":["../../../../src/core/renderCoordinator/axis/computeAxisTicks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CASrG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,MAAyC,GAAG,MAAM,CAiBzH;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC,YAAY,CAGvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO/E"}

package/dist/core/renderCoordinator/data/computeVisibleSlice.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Visible Slice Computation Utilities
+ *
+ * Provides efficient data slicing for zoom operations using binary search
+ * when data is monotonic, with fallback to linear filtering.
+ *
+ * Key features:
+ * - Binary search slicing for O(log n) performance on sorted data
+ * - WeakMap caching of monotonicity checks to avoid O(n) scans
+ * - Separate implementations for cartesian (x-based) and OHLC (timestamp-based) data
+ * - Support for both tuple and object data formats
+ */
+import type { DataPoint, DataPointTuple, OHLCDataPoint, OHLCDataPointTuple } from '../../../config/types';
+type TuplePoint = DataPointTuple;
+export declare function isTuplePoint(p: DataPoint): p is TuplePoint;
+export declare function isTupleDataArray(data: ReadonlyArray<DataPoint>): data is ReadonlyArray<TuplePoint>;
+export declare function isTupleOHLCDataPoint(p: OHLCDataPoint): p is OHLCDataPointTuple;
+/**
+ * Checks if cartesian data is monotonic non-decreasing by X coordinate with all finite values.
+ * Results are cached in a WeakMap to avoid repeated O(n) scans.
+ */
+export declare function isMonotonicNonDecreasingFiniteX(data: ReadonlyArray<DataPoint>, isTuple: boolean): boolean;
+/**
+ * Checks if OHLC data is monotonic non-decreasing by timestamp with all finite values.
+ * Results are cached in a WeakMap to avoid repeated O(n) scans.
+ */
+export declare function isMonotonicNonDecreasingFiniteTimestamp(data: ReadonlyArray<OHLCDataPoint>): boolean;
+/**
+ * Slices cartesian data to the visible X range [xMin, xMax].
+ *
+ * Uses binary search (O(log n)) when data is monotonic by X;
+ * otherwise falls back to linear filtering (O(n)).
+ *
+ * @param data - Cartesian data points (tuple or object format)
+ * @param xMin - Minimum X value (inclusive)
+ * @param xMax - Maximum X value (inclusive)
+ * @returns Sliced data array containing only points within [xMin, xMax]
+ */
+export declare function sliceVisibleRangeByX(data: ReadonlyArray<DataPoint>, xMin: number, xMax: number): ReadonlyArray<DataPoint>;
+/**
+ * Finds the index range of visible points in cartesian data.
+ *
+ * Returns { start, end } indices suitable for slicing or iteration.
+ * Only works correctly when data is monotonic; returns full range otherwise.
+ *
+ * @param data - Cartesian data points (tuple or object format)
+ * @param xMin - Minimum X value (inclusive)
+ * @param xMax - Maximum X value (inclusive)
+ * @returns Index range { start, end } for visible data
+ */
+export declare function findVisibleRangeIndicesByX(data: ReadonlyArray<DataPoint>, xMin: number, xMax: number): {
+    readonly start: number;
+    readonly end: number;
+};
+/**
+ * Slices OHLC/candlestick data to the visible timestamp range [xMin, xMax].
+ *
+ * Uses binary search (O(log n)) when timestamps are monotonic;
+ * otherwise falls back to linear filtering (O(n)).
+ *
+ * @param data - OHLC data points (tuple or object format)
+ * @param xMin - Minimum timestamp (inclusive)
+ * @param xMax - Maximum timestamp (inclusive)
+ * @returns Sliced data array containing only points within [xMin, xMax]
+ */
+export declare function sliceVisibleRangeByOHLC(data: ReadonlyArray<OHLCDataPoint>, xMin: number, xMax: number): ReadonlyArray<OHLCDataPoint>;
+export {};
+//# sourceMappingURL=computeVisibleSlice.d.ts.map

package/dist/core/renderCoordinator/data/computeVisibleSlice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeVisibleSlice.d.ts","sourceRoot":"","sources":["../../../../src/core/renderCoordinator/data/computeVisibleSlice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,aAAa,EACb,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAK/B,KAAK,UAAU,GAAG,cAAc,CAAC;AAKjC,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,IAAI,UAAU,CAE1D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI,aAAa,CAAC,UAAU,CAAC,CAElG;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,aAAa,GAAG,CAAC,IAAI,kBAAkB,CAE9E;AAMD;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAuCzG;AAED;;;GAGG;AACH,wBAAgB,uCAAuC,CAAC,IAAI,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,OAAO,CAqBnG;AAoGD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,aAAa,CAAC,SAAS,CAAC,CA8B1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAuBlD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,aAAa,CAAC,aAAa,CAAC,EAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,aAAa,CAAC,aAAa,CAAC,CA8B9B"}

package/dist/core/renderCoordinator/gpu/textureManager.d.ts

@@ -0,0 +1,69 @@
+/**
+ * GPU texture management for the RenderCoordinator.
+ *
+ * Handles lazy allocation of render target textures and MSAA overlay management.
+ * Uses a multi-pass rendering strategy:
+ * 1. Main scene → single-sample texture
+ * 2. Blit to MSAA target + draw annotations (MSAA overlay pass)
+ * 3. Draw UI overlays on resolved swapchain (single-sample)
+ *
+ * @module textureManager
+ */
+/**
+ * Texture manager state exposed to the render coordinator.
+ */
+export interface TextureManagerState {
+    readonly mainColorView: GPUTextureView | null;
+    readonly overlayMsaaView: GPUTextureView | null;
+    readonly overlayBlitBindGroup: GPUBindGroup | null;
+    readonly overlayBlitPipeline: GPURenderPipeline;
+    readonly msaaSampleCount: number;
+}
+/**
+ * Configuration for texture manager creation.
+ */
+export interface TextureManagerConfig {
+    readonly device: GPUDevice;
+    readonly targetFormat: GPUTextureFormat;
+}
+/**
+ * Texture manager interface returned by factory function.
+ */
+export interface TextureManager {
+    /**
+     * Ensures textures are allocated for the given dimensions.
+     * Reallocates if size or format changes.
+     *
+     * @param width - Canvas width in device pixels
+     * @param height - Canvas height in device pixels
+     */
+    ensureTextures(width: number, height: number): void;
+    /**
+     * Gets current texture manager state for rendering.
+     *
+     * @returns Current state with texture views and bind groups
+     */
+    getState(): TextureManagerState;
+    /**
+     * Disposes all GPU resources.
+     * Textures, views, and bind groups are destroyed.
+     */
+    dispose(): void;
+}
+/**
+ * Creates a texture manager for render target allocation and management.
+ *
+ * The texture manager uses lazy allocation: textures are only created when
+ * first requested via ensureTextures(), and are reallocated if dimensions
+ * or format change.
+ *
+ * **Architecture:**
+ * - Main color texture: Single-sample render target for main scene
+ * - Overlay MSAA texture: Multi-sample render target for annotations
+ * - Blit pipeline: Copies main color to MSAA target for overlay pass
+ *
+ * @param config - Configuration with device and target format
+ * @returns Texture manager instance
+ */
+export declare function createTextureManager(config: TextureManagerConfig): TextureManager;
+//# sourceMappingURL=textureManager.d.ts.map

package/dist/core/renderCoordinator/gpu/textureManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textureManager.d.ts","sourceRoot":"","sources":["../../../../src/core/renderCoordinator/gpu/textureManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAuCH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,eAAe,EAAE,cAAc,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,oBAAoB,EAAE,YAAY,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,mBAAmB,EAAE,iBAAiB,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAgBD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpD;;;;OAIG;IACH,QAAQ,IAAI,mBAAmB,CAAC;IAEhC;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAiBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CA+HjF"}