uplot-plus 0.1.1 → 0.1.3

package/dist/annotations.d.ts

@@ -0,0 +1,22 @@
+import type { DrawContext } from './types/hooks';
+import type { ScaleState } from './types';
+export interface AnnotationStyle {
+    stroke?: string;
+    width?: number;
+    dash?: number[];
+    fill?: string;
+    font?: string;
+}
+/** Draw a horizontal line at a y-value.
+ *  Assumes ctx is already pxRatio-scaled (handled by the library). */
+export declare function drawHLine(dc: DrawContext, yScale: ScaleState, value: number, style?: AnnotationStyle): void;
+/** Draw a vertical line at an x-value.
+ *  Assumes ctx is already pxRatio-scaled (handled by the library). */
+export declare function drawVLine(dc: DrawContext, xScale: ScaleState, value: number, style?: AnnotationStyle): void;
+/** Draw a text label at data coordinates.
+ *  Assumes ctx is already pxRatio-scaled (handled by the library). */
+export declare function drawLabel(dc: DrawContext, xScale: ScaleState, yScale: ScaleState, xVal: number, yVal: number, text: string, style?: AnnotationStyle): void;
+/** Draw a shaded region between two y-values.
+ *  Assumes ctx is already pxRatio-scaled (handled by the library). */
+export declare function drawRegion(dc: DrawContext, yScale: ScaleState, yMin: number, yMax: number, style?: AnnotationStyle): void;
+//# sourceMappingURL=annotations.d.ts.map

package/dist/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../src/annotations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;sEACsE;AACtE,wBAAgB,SAAS,CACvB,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,eAAoB,GAC1B,IAAI,CAYN;AAED;sEACsE;AACtE,wBAAgB,SAAS,CACvB,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,eAAoB,GAC1B,IAAI,CAYN;AAED;sEACsE;AACtE,wBAAgB,SAAS,CACvB,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,eAAoB,GAC1B,IAAI,CASN;AAED;sEACsE;AACtE,wBAAgB,UAAU,CACxB,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,eAAoB,GAC1B,IAAI,CAcN"}

package/dist/axes/layout.d.ts

@@ -0,0 +1,30 @@
+import type { ScaleState, BBox } from '../types';
+import type { AxisState } from '../types/axes';
+/**
+ * Run one cycle of axis calculation.
+ * For each visible axis, compute tick positions, labels, and size.
+ * Returns true if all axis sizes have converged.
+ *
+ * Ported from uPlot uPlot.js axesCalc.
+ */
+export declare function axesCalc(axisStates: AxisState[], getScale: (id: string) => ScaleState | undefined, plotWidCss: number, plotHgtCss: number, cycleNum: number): boolean;
+/**
+ * Compute the plot area bounding box by subtracting axis sizes from the chart dimensions.
+ *
+ * Ported from uPlot uPlot.js calcPlotRect (lines 818-870).
+ */
+export declare function calcPlotRect(chartWidth: number, chartHeight: number, axisStates: AxisState[]): BBox;
+/**
+ * Compute axis positions (_pos and _lpos) using cumulative offsets from plot edges.
+ *
+ * Ported from uPlot uPlot.js calcAxesRects (lines 872-899).
+ */
+export declare function calcAxesRects(axisStates: AxisState[], plotBox: BBox): void;
+/**
+ * Run the convergence loop: repeatedly calculate axes and plot rect
+ * until axis sizes stabilize (or max 3 cycles).
+ *
+ * Ported from uPlot uPlot.js convergeSize.
+ */
+export declare function convergeSize(chartWidth: number, chartHeight: number, axisStates: AxisState[], getScale: (id: string) => ScaleState | undefined): BBox;
+//# sourceMappingURL=layout.d.ts.map

package/dist/axes/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/axes/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAiB/C;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,UAAU,EAAE,SAAS,EAAE,EACvB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,EAChD,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAoFT;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,SAAS,EAAE,GACtB,IAAI,CAsCN;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,GAAG,IAAI,CA8B1E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,SAAS,EAAE,EACvB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,GAC/C,IAAI,CAqCN"}

package/dist/axes/ticks.d.ts

@@ -0,0 +1,47 @@
+import type { AxisConfig, AxisState } from '../types/axes';
+/**
+ * Generate tick split positions for a numeric (linear) axis.
+ * Ported from uPlot opts.js numAxisSplits.
+ */
+export declare function numAxisSplits(scaleMin: number, scaleMax: number, foundIncr: number, _foundSpace: number, forceMin: boolean): number[];
+/**
+ * Format tick values as strings for a numeric axis.
+ * Ported from uPlot opts.js numAxisVals.
+ */
+export declare function numAxisVals(splits: number[]): string[];
+/**
+ * Generate tick split positions for a log-scale axis.
+ * Ported from uPlot opts.js logAxisSplits.
+ */
+export declare function logAxisSplits(scaleMin: number, scaleMax: number, logBase: number): number[];
+/**
+ * Generate tick split positions for an asinh (symmetric log) axis.
+ * Produces linear ticks near zero and logarithmic ticks at larger magnitudes.
+ *
+ * @param scaleMin - minimum value on the scale
+ * @param scaleMax - maximum value on the scale
+ * @param linthresh - linear threshold (values within [-linthresh, linthresh] are linear)
+ */
+export declare function asinhAxisSplits(scaleMin: number, scaleMax: number, linthresh?: number): number[];
+/**
+ * Filter log axis split values to reduce label density.
+ * Keeps only values that are exact powers of the log base.
+ * This prevents crowded labels at intermediate ticks (2, 3, 4... between 1 and 10).
+ */
+export declare function logAxisValFilter(splits: number[], logBase: number): boolean[];
+/**
+ * Determine optimal tick increment and spacing for an axis.
+ * Ported from uPlot uPlot.js getIncrSpace.
+ */
+export declare function getIncrSpace(axis: AxisConfig, min: number, max: number, fullDim: number): [number, number];
+/**
+ * Compute the size of an axis in CSS pixels.
+ * For vertical axes, estimates width from the longest tick label.
+ * For horizontal axes, uses a fixed height based on font size.
+ */
+export declare function computeAxisSize(axis: AxisConfig, _values: string[] | null, _cycleNum: number): number;
+/**
+ * Create an initial AxisState from an AxisConfig.
+ */
+export declare function createAxisState(config: AxisConfig): AxisState;
+//# sourceMappingURL=ticks.d.ts.map

package/dist/axes/ticks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticks.d.ts","sourceRoot":"","sources":["../../src/axes/ticks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAiB3D;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,OAAO,GAChB,MAAM,EAAE,CAaV;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEtD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,MAAM,EAAE,CA0CV;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,SAAI,GACZ,MAAM,EAAE,CA8CV;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,EAAE,CAUX;AAYD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,CAAC,MAAM,EAAE,MAAM,CAAC,CAWlB;AAKD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EACxB,SAAS,EAAE,MAAM,GAChB,MAAM,CAsBR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAa7D"}

package/dist/colors.d.ts

@@ -0,0 +1,32 @@
+import type { GradientConfig } from './types';
+/**
+ * Create a vertical linear gradient that fades a color from one opacity to another.
+ * Useful for area charts: `fill={fadeGradient('#3498db')}`.
+ *
+ * Supports hex (#rgb, #rrggbb) and rgb()/rgba() color strings.
+ *
+ * @param color - CSS color string (hex or rgb/rgba)
+ * @param fromAlpha - opacity at the top (default 0.8)
+ * @param toAlpha - opacity at the bottom (default 0.0)
+ */
+export declare function fadeGradient(color: string, fromAlpha?: number, toAlpha?: number): GradientConfig;
+/**
+ * Return a CSS color string with a new alpha value.
+ * Useful for matching fill to stroke: `fill={withAlpha(stroke, 0.1)}`.
+ *
+ * Supports hex (#rgb, #rrggbb) and rgb()/rgba() color strings.
+ *
+ * @param color - CSS color string (hex or rgb/rgba)
+ * @param alpha - opacity 0–1
+ */
+export declare function withAlpha(color: string, alpha: number): string;
+/**
+ * Generate a palette of N visually distinct colors using HSL rotation.
+ * Uses the golden angle (~137.5°) for maximum separation between adjacent colors.
+ *
+ * @param n - number of colors to generate
+ * @param saturation - HSL saturation percentage (default 65)
+ * @param lightness - HSL lightness percentage (default 50)
+ */
+export declare function palette(n: number, saturation?: number, lightness?: number): string[];
+//# sourceMappingURL=colors.d.ts.map

package/dist/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../src/colors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAqC9C;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,SAAS,SAAM,EACf,OAAO,SAAM,GACZ,cAAc,CAchB;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,SAAK,EAAE,SAAS,SAAK,GAAG,MAAM,EAAE,CAQ5E"}

package/dist/components/Axis.d.ts

@@ -0,0 +1,14 @@
+import type { AxisConfig } from '../types';
+import { Side } from '../types';
+export type AxisProps = Omit<AxisConfig, 'side'> & {
+    side?: Side;
+};
+/**
+ * Renderless component that registers an axis config with the chart store.
+ * Must be a child of <Chart>.
+ *
+ * Mount effect registers/unregisters based on identity keys (scale, side).
+ * Sync effect updates config when any prop changes (shallow-equality bail-out).
+ */
+export declare function Axis(props: AxisProps): null;
+//# sourceMappingURL=Axis.d.ts.map

package/dist/components/Axis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Axis.d.ts","sourceRoot":"","sources":["../../src/components/Axis.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAIhC,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAMnE;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAuC3C"}

package/dist/components/Band.d.ts

@@ -0,0 +1,10 @@
+import type { BandConfig } from '../types/bands';
+/**
+ * Renderless component that registers a band config with the chart store.
+ * A band fills the area between two series.
+ *
+ * Uses a mount/update split: registers once on mount, replaces config immutably on prop changes.
+ * Destructures series tuple to primitives for stable dependency comparison.
+ */
+export declare function Band({ series, group, fill, dir }: BandConfig): null;
+//# sourceMappingURL=Band.d.ts.map

package/dist/components/Band.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Band.d.ts","sourceRoot":"","sources":["../../src/components/Band.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,UAAU,GAAG,IAAI,CA6BnE"}

package/dist/components/Chart.d.ts

@@ -0,0 +1,8 @@
+import type { ChartProps } from '../types';
+/**
+ * Root chart component.
+ * Creates a canvas element, manages the chart store, and provides context to children.
+ * Canvas drawing is completely decoupled from React's reconciliation cycle.
+ */
+export declare function Chart({ width, height, data, children, className, pxRatio: pxRatioOverride, onDraw, onCursorDraw, syncKey, cursor, onClick, onContextMenu, onDblClick, onCursorMove, onCursorLeave, onScaleChange, onSelect, }: ChartProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Chart.d.ts.map

package/dist/components/Chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chart.d.ts","sourceRoot":"","sources":["../../src/components/Chart.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAO3C;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,EACpB,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAClE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EACrC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAC/D,aAAa,EAAE,QAAQ,GACxB,EAAE,UAAU,2CAsJZ"}

package/dist/components/Legend.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { LegendConfig } from '../types/legend';
+interface LegendProps extends LegendConfig {
+    className?: string;
+}
+/**
+ * Legend component that shows series labels with color swatches.
+ * Updates live as the cursor moves. Click to toggle series visibility.
+ */
+export declare function Legend({ show, position, className }: LegendProps): React.ReactElement | null;
+export {};
+//# sourceMappingURL=Legend.d.ts.map

package/dist/components/Legend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Legend.d.ts","sourceRoot":"","sources":["../../src/components/Legend.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA0D,MAAM,OAAO,CAAC;AAE/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,UAAU,WAAY,SAAQ,YAAY;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAwDD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,EAAE,IAAW,EAAE,QAAmB,EAAE,SAAS,EAAE,EAAE,WAAW,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAiE9G"}

package/dist/components/Scale.d.ts

@@ -0,0 +1,11 @@
+import type { ScaleConfig } from '../types';
+export type ScaleProps = ScaleConfig;
+/**
+ * Renderless component that registers a scale config with the chart store.
+ * Must be a child of <Chart>.
+ *
+ * Mount effect registers/unregisters based on identity key (id).
+ * Sync effect updates config when any prop changes (shallow-equality bail-out).
+ */
+export declare function Scale(props: ScaleProps): null;
+//# sourceMappingURL=Scale.d.ts.map

package/dist/components/Scale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scale.d.ts","sourceRoot":"","sources":["../../src/components/Scale.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAI5C,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC;AAErC;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAiC7C"}

package/dist/components/Series.d.ts

@@ -0,0 +1,11 @@
+import type { SeriesConfig } from '../types';
+export type SeriesProps = SeriesConfig;
+/**
+ * Renderless component that registers a series config with the chart store.
+ * Must be a child of <Chart>.
+ *
+ * Mount effect registers/unregisters based on identity keys (group, index).
+ * Sync effect updates config when any prop changes (shallow-equality bail-out).
+ */
+export declare function Series(props: SeriesProps): null;
+//# sourceMappingURL=Series.d.ts.map

package/dist/components/Series.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Series.d.ts","sourceRoot":"","sources":["../../src/components/Series.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAI7C,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAoC/C"}

package/dist/components/Sparkline.d.ts

@@ -0,0 +1,28 @@
+import type { ChartData, ColorValue } from '../types';
+import type { PathBuilder } from '../paths/types';
+export interface SparklineProps {
+    /** Chart data (single group, single series expected) */
+    data: ChartData;
+    /** Width in CSS pixels (default: 150) */
+    width?: number;
+    /** Height in CSS pixels (default: 30) */
+    height?: number;
+    /** Line/bar color (default: '#03a9f4') */
+    stroke?: ColorValue;
+    /** Fill color */
+    fill?: ColorValue;
+    /** Line width in CSS pixels (default: 1) */
+    lineWidth?: number;
+    /** Path builder — pass bars() for bar sparklines (default: linear) */
+    paths?: PathBuilder;
+    /** Fill target value (e.g. 0 for bars) */
+    fillTo?: number;
+    /** CSS class name for the wrapper div */
+    className?: string;
+}
+/**
+ * Compact inline chart with no axes or interaction.
+ * Ideal for sparklines in tables and dashboards.
+ */
+export declare function Sparkline({ data, width, height, stroke, fill, lineWidth, paths, fillTo, className, }: SparklineProps): React.JSX.Element;
+//# sourceMappingURL=Sparkline.d.ts.map

package/dist/components/Sparkline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sparkline.d.ts","sourceRoot":"","sources":["../../src/components/Sparkline.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,IAAI,EAAE,SAAS,CAAC;IAChB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,iBAAiB;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,KAAW,EACX,MAAW,EACX,MAAkB,EAClB,IAAI,EACJ,SAAa,EACb,KAAK,EACL,MAAM,EACN,SAAS,GACV,EAAE,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAqBpC"}

package/dist/components/Timeline.d.ts

@@ -0,0 +1,8 @@
+import type { TimelineProps } from '../types/timeline';
+/**
+ * Timeline component — renders discrete event spans as horizontal colored bars.
+ * Each lane is a category, each segment is a time range with optional color/label.
+ * Uses useDrawHook to draw on the persistent canvas layer.
+ */
+export declare function Timeline({ lanes, laneHeight, gap, scaleId, }: TimelineProps): null;
+//# sourceMappingURL=Timeline.d.ts.map

package/dist/components/Timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Timeline.d.ts","sourceRoot":"","sources":["../../src/components/Timeline.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,UAAe,EACf,GAAO,EACP,OAAa,GACd,EAAE,aAAa,GAAG,IAAI,CA+DtB"}

package/dist/components/Tooltip.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { TooltipProps } from '../types/tooltip';
+/**
+ * Tooltip component that shows data values at the cursor position.
+ * Uses useSyncExternalStore to subscribe to cursor state updates.
+ * Positioned as an absolute HTML overlay inside the chart container.
+ */
+export declare function Tooltip({ show, className, children, offset, }: TooltipProps): React.ReactElement | null;
+//# sourceMappingURL=Tooltip.d.ts.map

package/dist/components/Tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../src/components/Tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoD,MAAM,OAAO,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAA4B,MAAM,kBAAkB,CAAC;AAa/E;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EACtB,IAAW,EACX,SAAS,EACT,QAAQ,EACR,MAAW,GACZ,EAAE,YAAY,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAiI1C"}

package/dist/components/ZoomRanger.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import type { ChartData } from '../types';
+export interface ZoomRangerProps {
+    /** Chart width in CSS pixels */
+    width: number;
+    /** Chart height in CSS pixels */
+    height: number;
+    /** Data to render in the overview */
+    data: ChartData;
+    /** Called when the selection range changes */
+    onRangeChange?: (min: number, max: number) => void;
+    /** Initial selection range as [min, max] data values */
+    initialRange?: [number, number];
+    /** CSS class for the outer wrapper */
+    className?: string;
+    /** Series colors (one per series in group 0) */
+    colors?: string[];
+    /** Show grip handles on edges */
+    grips?: boolean;
+}
+/**
+ * ZoomRanger — an overview mini-chart with a draggable selection window.
+ * The selection controls the zoom range of a linked detail chart via onRangeChange.
+ */
+export declare function ZoomRanger({ width, height, data, onRangeChange, initialRange, className, colors, grips, }: ZoomRangerProps): React.ReactElement;
+//# sourceMappingURL=ZoomRanger.d.ts.map

package/dist/components/ZoomRanger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZoomRanger.d.ts","sourceRoot":"","sources":["../../src/components/ZoomRanger.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAM1C,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,IAAI,EAAE,SAAS,CAAC;IAChB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,wDAAwD;IACxD,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,MAAM,EACN,IAAI,EACJ,aAAa,EACb,YAAY,EACZ,SAAS,EACT,MAAM,EACN,KAAa,GACd,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAwNtC"}

package/dist/components/annotations/AnnotationLabel.d.ts

@@ -0,0 +1,26 @@
+export interface AnnotationLabelProps {
+    /** X data value */
+    x: number;
+    /** Y data value */
+    y: number;
+    /** Label text */
+    text: string;
+    /** Scale id for the x-axis (default: 'x') */
+    xScale?: string;
+    /** Scale id for the y-axis (default: 'y') */
+    yScale?: string;
+    /** Text color (default: '#000') */
+    fill?: string;
+    /** Font (default: '12px sans-serif') */
+    font?: string;
+    /** Text alignment (default: 'left') */
+    align?: CanvasTextAlign;
+    /** Text baseline (default: 'bottom') */
+    baseline?: CanvasTextBaseline;
+}
+/**
+ * Declarative text label annotation at data coordinates.
+ * Place inside `<Chart>`.
+ */
+export declare function AnnotationLabel(props: AnnotationLabelProps): null;
+//# sourceMappingURL=AnnotationLabel.d.ts.map

package/dist/components/annotations/AnnotationLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnnotationLabel.d.ts","sourceRoot":"","sources":["../../../src/components/annotations/AnnotationLabel.tsx"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACnC,mBAAmB;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,mBAAmB;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAmBjE"}

package/dist/components/annotations/HLine.d.ts

@@ -0,0 +1,22 @@
+export interface HLineProps {
+    /** Y data value where the line is drawn */
+    value: number;
+    /** Scale id for the y-axis (default: 'y') */
+    yScale?: string;
+    /** Line color (default: 'red') */
+    stroke?: string;
+    /** Line width in CSS pixels (default: 1) */
+    width?: number;
+    /** Dash pattern */
+    dash?: number[];
+    /** Optional text label drawn at the left edge */
+    label?: string;
+    /** Font for the label */
+    labelFont?: string;
+}
+/**
+ * Declarative horizontal line annotation.
+ * Renders a horizontal line at a y-data-value. Place inside `<Chart>`.
+ */
+export declare function HLine(props: HLineProps): null;
+//# sourceMappingURL=HLine.d.ts.map

package/dist/components/annotations/HLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HLine.d.ts","sourceRoot":"","sources":["../../../src/components/annotations/HLine.tsx"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CA6B7C"}

package/dist/components/annotations/Region.d.ts

@@ -0,0 +1,22 @@
+export interface RegionProps {
+    /** Lower y data value */
+    yMin: number;
+    /** Upper y data value */
+    yMax: number;
+    /** Scale id for the y-axis (default: 'y') */
+    yScale?: string;
+    /** Fill color (default: 'rgba(255,0,0,0.1)') */
+    fill?: string;
+    /** Border stroke color */
+    stroke?: string;
+    /** Border stroke width */
+    strokeWidth?: number;
+    /** Border dash pattern */
+    dash?: number[];
+}
+/**
+ * Declarative shaded region annotation.
+ * Fills the area between two y-data-values. Place inside `<Chart>`.
+ */
+export declare function Region(props: RegionProps): null;
+//# sourceMappingURL=Region.d.ts.map

package/dist/components/annotations/Region.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Region.d.ts","sourceRoot":"","sources":["../../../src/components/annotations/Region.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAkB/C"}

package/dist/components/annotations/VLine.d.ts

@@ -0,0 +1,22 @@
+export interface VLineProps {
+    /** X data value where the line is drawn */
+    value: number;
+    /** Scale id for the x-axis (default: 'x') */
+    xScale?: string;
+    /** Line color (default: 'red') */
+    stroke?: string;
+    /** Line width in CSS pixels (default: 1) */
+    width?: number;
+    /** Dash pattern */
+    dash?: number[];
+    /** Optional text label drawn at the top */
+    label?: string;
+    /** Font for the label */
+    labelFont?: string;
+}
+/**
+ * Declarative vertical line annotation.
+ * Renders a vertical line at an x-data-value. Place inside `<Chart>`.
+ */
+export declare function VLine(props: VLineProps): null;
+//# sourceMappingURL=VLine.d.ts.map

package/dist/components/annotations/VLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VLine.d.ts","sourceRoot":"","sources":["../../../src/components/annotations/VLine.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CA6B7C"}

package/dist/components/annotations/index.d.ts

@@ -0,0 +1,9 @@
+export { HLine } from './HLine';
+export { VLine } from './VLine';
+export { Region } from './Region';
+export { AnnotationLabel } from './AnnotationLabel';
+export type { HLineProps } from './HLine';
+export type { VLineProps } from './VLine';
+export type { RegionProps } from './Region';
+export type { AnnotationLabelProps } from './AnnotationLabel';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/annotations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/annotations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/BlockMinMax.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Block Min-Max Tree for O(n/blockSize) range min/max queries.
+ *
+ * Divides a data array into fixed-size blocks and pre-computes
+ * min/max for each block. Range queries decompose into:
+ *   partial-left-block + full-middle-blocks + partial-right-block
+ *
+ * Build: O(n)  |  Query: O(n/blockSize + blockSize)  |  Update: O(blockSize)
+ */
+export declare class BlockMinMaxTree {
+    /** Flat array of [min, max] pairs per block */
+    private blocks;
+    /** Number of blocks */
+    private nBlocks;
+    /** Block size */
+    private blockSize;
+    /** Reference to underlying data */
+    private data;
+    /** Total data length */
+    private len;
+    constructor(data: ArrayLike<number | null>, blockSize?: number);
+    /** Build min/max for all blocks */
+    private buildAll;
+    /**
+     * Query min/max over index range [i0, i1] (inclusive).
+     * Returns [Infinity, -Infinity] if no valid data in range.
+     */
+    rangeMinMax(i0: number, i1: number): [number, number];
+    /**
+     * Rebuild a single block (for incremental append).
+     * @param blockIdx - index of the block to rebuild
+     */
+    updateBlock(blockIdx: number): void;
+    /**
+     * Grow the tree to accommodate new data length.
+     * Only rebuilds newly added blocks.
+     */
+    grow(newLen: number): void;
+    /** Update data reference (for when the backing array changes, e.g. append with realloc) */
+    setData(data: ArrayLike<number | null>): void;
+}
+//# sourceMappingURL=BlockMinMax.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BlockMinMax.d.ts","sourceRoot":"","sources":["../../src/core/BlockMinMax.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,qBAAa,eAAe;IAC1B,+CAA+C;IAC/C,OAAO,CAAC,MAAM,CAAe;IAC7B,uBAAuB;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,iBAAiB;IACjB,OAAO,CAAC,SAAS,CAAS;IAC1B,mCAAmC;IACnC,OAAO,CAAC,IAAI,CAA2B;IACvC,wBAAwB;IACxB,OAAO,CAAC,GAAG,CAAS;gBAER,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,SAAS,SAAqB;IAS1E,mCAAmC;IACnC,OAAO,CAAC,QAAQ;IAsBhB;;;OAGG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAqDrD;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAsBnC;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAkB1B,2FAA2F;IAC3F,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI;CAG9C"}

package/dist/core/CursorManager.d.ts

@@ -0,0 +1,43 @@
+import type { CursorState, ScaleState, BBox } from '../types';
+import type { ChartData } from '../types/data';
+import type { SeriesConfig } from '../types/series';
+/** Minimal store interface to avoid circular dependency with ChartStore. */
+export interface SyncTarget {
+    dataStore: {
+        data: ChartData;
+        getWindow(gi: number): [number, number];
+    };
+    scaleManager: {
+        getGroupXScaleKey(gi: number): string | undefined;
+        getScale(id: string): ScaleState | undefined;
+    };
+    seriesConfigs: SeriesConfig[];
+    plotBox: BBox;
+}
+/**
+ * Manages cursor position and nearest-point snapping.
+ * Computes the closest data point across all visible series/groups
+ * using pixel-space Euclidean distance.
+ */
+export declare class CursorManager {
+    state: CursorState;
+    /** Hide the cursor (move off-screen) */
+    hide(): void;
+    /**
+     * Update cursor position and snap to nearest data point.
+     *
+     * @param cssX - cursor X in CSS pixels relative to plot area left
+     * @param cssY - cursor Y in CSS pixels relative to plot area top
+     * @param plotBox - current plot bounding box
+     * @param data - chart data groups
+     * @param seriesConfigs - all series configs
+     * @param getScale - scale lookup
+     */
+    update(cssX: number, cssY: number, plotBox: BBox, data: ChartData, seriesConfigs: SeriesConfig[], getScale: (id: string) => ScaleState | undefined, getWindow: (groupIdx: number) => [number, number], getGroupXScaleKey: (groupIdx: number) => string | undefined): void;
+    /**
+     * Sync cursor to a specific x-value (from another chart in a sync group).
+     * Finds the closest data index and positions the cursor there.
+     */
+    syncToValue(xVal: number, store: SyncTarget): void;
+}
+//# sourceMappingURL=CursorManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CursorManager.d.ts","sourceRoot":"","sources":["../../src/core/CursorManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpD,4EAA4E;AAC5E,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IACxE,YAAY,EAAE;QAAE,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAA;KAAE,CAAC;IAClH,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,OAAO,EAAE,IAAI,CAAC;CACf;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,KAAK,EAAE,WAAW,CAMhB;IAEF,wCAAwC;IACxC,IAAI,IAAI,IAAI;IAQZ;;;;;;;;;OASG;IACH,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,IAAI,EACb,IAAI,EAAE,SAAS,EACf,aAAa,EAAE,YAAY,EAAE,EAC7B,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,EAChD,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,EACjD,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAC1D,IAAI;IAyGP;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;CA6CnD"}

package/dist/core/DataStore.d.ts

@@ -0,0 +1,51 @@
+import type { ChartData } from '../types';
+import type { ScaleState } from '../types';
+import { SortOrder } from '../types';
+import { BlockMinMaxTree } from './BlockMinMax';
+/**
+ * Manages chart data and per-xGroup visible windows.
+ * The window for each group is the index range [i0, i1] of x-values
+ * that fall within the group's x-scale range.
+ */
+export declare class DataStore {
+    data: ChartData;
+    /** Per-group visible window: groupIdx -> [i0, i1] */
+    windows: Map<number, [number, number]>;
+    /** Per-group min/max cache: groupIdx -> ("index:i0:i1" -> [min, max]) */
+    private minMaxCache;
+    /** Block min-max trees for fast range queries: "group:seriesIndex" -> tree */
+    private blockTrees;
+    setData(data: ChartData): void;
+    /** Get or lazily build a block min-max tree for a series */
+    private getOrBuildTree;
+    /**
+     * Update the visible window for each xGroup based on its x-scale range.
+     * @param getXScale - function to look up the x-scale for a group index
+     */
+    /** Update windows and return true if any window actually changed */
+    updateWindows(getXScale: (groupIdx: number) => ScaleState | undefined): boolean;
+    /** Get the visible window for a group */
+    getWindow(groupIdx: number): [number, number];
+    /** Get x values for a group */
+    getXValues(groupIdx: number): ArrayLike<number>;
+    /** Get y values for a specific series */
+    getYValues(groupIdx: number, seriesIdx: number): ArrayLike<number | null>;
+    /** Get cached min/max for a series within a window range */
+    getCachedMinMax(group: number, index: number, i0: number, i1: number, sorted: SortOrder, isLog: boolean): [number, number];
+    /** Get block tree for a series (exposed for incremental append) */
+    getBlockTree(group: number, index: number): BlockMinMaxTree | undefined;
+    /**
+     * Append new data points to an existing group.
+     * Much cheaper than setData() for streaming scenarios — O(newPoints) instead of O(totalPoints).
+     *
+     * Only works with regular arrays (not Float64Array) since arrays need to grow.
+     * Block trees are incrementally updated, and only the affected group's cache is invalidated.
+     */
+    appendData(groupIdx: number, newX: number[], newSeries: (number | null)[][]): void;
+    /**
+     * Convert x-arrays in chart data to Float64Array for optimal memory layout.
+     * Call before setData() when not using appendData() (Float64Array is fixed-length).
+     */
+    static toTypedX(data: ChartData): ChartData;
+}
+//# sourceMappingURL=DataStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataStore.d.ts","sourceRoot":"","sources":["../../src/core/DataStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;GAIG;AACH,qBAAa,SAAS;IACpB,IAAI,EAAE,SAAS,CAAM;IAErB,qDAAqD;IACrD,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAa;IAEnD,yEAAyE;IACzE,OAAO,CAAC,WAAW,CAAyD;IAE5E,8EAA8E;IAC9E,OAAO,CAAC,UAAU,CAA2C;IAE7D,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAQ9B,4DAA4D;IAC5D,OAAO,CAAC,cAAc;IAetB;;;OAGG;IACH,oEAAoE;IACpE,aAAa,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,GAAG,OAAO;IA2C/E,yCAAyC;IACzC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAI7C,+BAA+B;IAC/B,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;IAI/C,yCAAyC;IACzC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzE,4DAA4D;IAC5D,eAAe,CACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,OAAO,GACb,CAAC,MAAM,EAAE,MAAM,CAAC;IAgCnB,mEAAmE;IACnE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIvE;;;;;;OAMG;IACH,UAAU,CACR,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,GAC7B,IAAI;IAqCP;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS;CAQ5C"}