@chartgpu/chartgpu 0.2.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ChartGPU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,208 @@
+<p align="center" style="margin-bottom:0; margin-top:20px;">
+  <img src="docs/assets/chartgpu.png" alt="ChartGPU" width="400">
+</p>
+
+<p align="center" style="margin-top:-18px;">
+  The fastest open-source charting library — 50M points at 60 FPS.
+</p>
+
+<div align="center">
+
+
+[<img src="docs/assets/powered-by-webgpu.svg" alt="Powered by WebGPU" height="28" />](https://forthebadge.com)
+[![GitHub Stars](https://img.shields.io/github/stars/ChartGPU/chartgpu?style=for-the-badge&color=yellow)](https://github.com/chartgpu/chartgpu)
+[![CI Status](https://img.shields.io/github/actions/workflow/status/chartgpu/chartgpu/tests.yml?branch=main&style=for-the-badge&label=Tests)](https://github.com/chartgpu/chartgpu/actions/workflows/tests.yml)
+[![npm version](https://img.shields.io/npm/v/chartgpu?style=for-the-badge&color=blue)](https://www.npmjs.com/package/chartgpu)
+[![NPM Downloads](https://img.shields.io/npm/dm/chartgpu?style=for-the-badge&color=%2368cc49)](https://www.npmjs.com/package/chartgpu)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://github.com/chartgpu/chartgpu/blob/main/LICENSE)
+[![Live Demo](https://img.shields.io/badge/demo-live-brightgreen?style=for-the-badge)](https://chartgpu.github.io/ChartGPU/examples/)
+[![Examples](https://img.shields.io/badge/Examples-Code%20Samples-blue?style=for-the-badge)](https://github.com/chartgpu/chartgpu/tree/main/examples)
+[![Documentation](https://img.shields.io/badge/Documentation-Getting%20Started-blue?style=for-the-badge)](https://github.com/chartgpu/chartgpu/blob/main/docs/GETTING_STARTED.md)
+
+[<img src="https://hackerbadge.now.sh/api?id=46706528" alt="Featured on Hacker News" height="30" />](https://news.ycombinator.com/item?id=46706528)
+
+[<img src="https://awesome.re/mentioned-badge.svg" alt="Featured in Awesome WebGPU" style="height: 30px;" />](https://github.com/mikbry/awesome-webgpu)
+
+
+</div>
+
+ChartGPU is a TypeScript charting library built on WebGPU for smooth, interactive rendering—especially when you have lots of data.
+
+## Demo
+
+![ChartGPU demo](https://raw.githubusercontent.com/chartgpu/chartgpu/main/docs/assets/chart-gpu-demo.gif)
+
+### 35M points (benchmark)
+
+35,000,000 points rendered at ~72 FPS (benchmark mode).
+
+![35 million point benchmark at 72 FPS](docs/assets/35-million-ultimate-benchmark-example.png)
+
+## Quick Start
+
+```ts
+import { ChartGPU } from 'chartgpu';
+const container = document.getElementById('chart')!;
+await ChartGPU.create(container, {
+  series: [{ type: 'line', data: [[0, 1], [1, 3], [2, 2]] }],
+});
+```
+
+### Annotations
+
+Add reference lines, point markers, and text overlays to highlight important data features:
+
+```ts
+await ChartGPU.create(container, {
+  series: [{ type: 'line', data: [[0, 1], [1, 3], [2, 2]] }],
+  annotations: [
+    // Horizontal reference line
+    {
+      id: 'ref-y',
+      type: 'lineY',
+      y: 2.5,
+      layer: 'belowSeries',
+      style: { color: '#ffd166', lineWidth: 2, lineDash: [8, 6], opacity: 0.95 },
+      label: { text: 'threshold' },
+    },
+    // Point marker at peak
+    {
+      id: 'peak',
+      type: 'point',
+      x: 1,
+      y: 3,
+      layer: 'aboveSeries',
+      marker: { symbol: 'circle', size: 8, style: { color: '#ff4ab0' } },
+      label: { template: 'peak={y}', decimals: 2 },
+    },
+  ],
+});
+```
+
+See [Annotations Documentation](https://github.com/chartgpu/chartgpu/blob/main/docs/api/options.md#annotations) and the [annotations example](https://github.com/chartgpu/chartgpu/tree/main/examples/annotation-authoring).
+
+## Highlights
+
+- 🚀 WebGPU-accelerated rendering for high FPS with large datasets
+- 📈 Multiple series types: line, area, bar, scatter, pie, candlestick
+- 🌡️ Scatter density/heatmap mode (`mode: 'density'`) for large point clouds — see [`docs/api/options.md#scatterseriesconfig`](docs/api/options.md#scatterseriesconfig) and [`examples/scatter-density-1m/`](examples/scatter-density-1m/)
+- 📍 Annotation overlays: reference lines (horizontal/vertical), point markers, and text labels — see [`docs/api/options.md#annotations`](docs/api/options.md#annotations) and [`examples/annotations/`](examples/annotations/)
+- 🧭 Built-in interaction: hover highlight, tooltip, crosshair
+- 🔁 Streaming updates via `appendData(...)` with typed-array support (`XYArraysData`, `InterleavedXYData`, `DataPoint[]`) — see [`examples/cartesian-data-formats/`](examples/cartesian-data-formats/)
+- 🔍 X-axis zoom (inside gestures + optional slider UI)
+- 🎛️ Theme presets (`'dark' | 'light'`) and custom theme support
+
+
+### Candlestick Charts
+
+Financial OHLC (open-high-low-close) candlestick rendering with classic/hollow style toggle and color customization. The live streaming demo renders **5 million candlesticks at over 100 FPS** with real-time updates.
+
+![Candlestick chart example](docs/assets/candle-stick-example.png)
+
+### Scatter Density (1M points)
+
+GPU-binned density/heatmap mode for scatter plots (`mode: 'density'`) to reveal structure in overplotted point clouds. See [`docs/api/options.md#scatterseriesconfig`](docs/api/options.md#scatterseriesconfig) and the demo in [`examples/scatter-density-1m/`](examples/scatter-density-1m/).
+
+![Scatter density chart example (1M points)](docs/assets/scatter-plot-density-chart-1million-points-example.png)
+
+### Interactive Annotation Authoring
+
+Full-featured annotation authoring system with interactive editing capabilities. Create, edit, drag, and delete annotations with an intuitive UI. Supports all annotation types: reference lines (horizontal/vertical), point markers, text annotations (plot-space + data-space tracking), labels, and styling options.
+
+![Annotations comprehensive demo](docs/assets/annotations.png)
+
+**Key features:**
+- **Right-click empty space** → Add vertical/horizontal line or text note with custom color, style & label
+- **Click & drag annotations** → Reposition them (lines constrained to their axis)
+- **Right-click on annotation** → Edit properties or delete
+- **Full styling control** → Color picker, line style (solid/dashed), line width, and label customization
+- **Undo/Redo support** → All annotations are reversible
+- **Scroll to zoom, Drag to pan** → Standard chart interactions work seamlessly
+
+![Annotation configuration dialog](docs/assets/annontations-add-indicator.png)
+
+The annotation authoring system is demonstrated in the [`examples/annotation-authoring/`](examples/annotation-authoring/) example.
+
+## Installation
+
+```bash
+npm install chartgpu
+```
+
+**GitHub Packages:**
+
+```bash
+npm install @chartgpu/chartgpu
+```
+
+For GitHub Packages, configure your `.npmrc`:
+
+```
+@chartgpu:registry=https://npm.pkg.github.com
+```
+
+## React Integration
+
+React bindings are available via [`chartgpu-react`](https://github.com/ChartGPU/chartgpu-react):
+
+```bash
+npm install chartgpu-react
+```
+
+```tsx
+import { ChartGPUChart } from 'chartgpu-react';
+
+function MyChart() {
+  return (
+    <ChartGPUChart
+      options={{
+        series: [{ type: 'line', data: [[0, 1], [1, 3], [2, 2]] }],
+      }}
+    />
+  );
+}
+```
+
+See the [chartgpu-react repository](https://github.com/ChartGPU/chartgpu-react) for full documentation and examples.
+
+## Browser support (WebGPU required)
+
+- Chrome 113+ or Edge 113+ (WebGPU enabled by default)
+- Safari 18+ (WebGPU enabled by default)
+- Firefox: Windows 114+, Mac 145+, Linux nightly
+
+See the [gpuweb repository](https://github.com/gpuweb/gpuweb/wiki/Implementation-Status) for full Implementation Status
+
+## Who's Using ChartGPU
+
+ChartGPU is a young project and we'd love to hear how you're using it! If your team or project uses ChartGPU, [open a pull request](https://github.com/chartgpu/chartgpu/pulls) to add your name here.
+
+<!-- Add your project/company below:
+- [Your Project](https://link) — short description
+-->
+
+## Documentation
+
+- Full documentation: [Getting Started](https://github.com/chartgpu/chartgpu/blob/main/docs/GETTING_STARTED.md)
+- API reference: [`docs/api/README.md`](https://github.com/chartgpu/chartgpu/blob/main/docs/api/README.md)
+
+## Examples
+
+- Browse examples: [`examples/`](https://github.com/chartgpu/chartgpu/tree/main/examples)
+- Run locally:
+  - `npm install`
+  - `npm run dev` (opens `http://localhost:5173/examples/`)
+
+## Contributing
+
+See [`CONTRIBUTING.md`](https://github.com/chartgpu/chartgpu/blob/main/CONTRIBUTING.md).
+
+## License
+
+MIT — see [`LICENSE`](https://github.com/chartgpu/chartgpu/blob/main/LICENSE).
+
+## Architecture
+
+ChartGPU follows a functional-first architecture. `ChartGPU.create(...)` owns the canvas and WebGPU lifecycle, delegating render orchestration to a modular render coordinator with 11 specialized modules.
+
+For the full architecture diagram, see [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md). For deep internal notes, see [`docs/api/INTERNALS.md`](docs/api/INTERNALS.md).

package/dist/ChartGPU.d.ts

@@ -0,0 +1,146 @@
+import type { CartesianSeriesData, ChartGPUOptions, OHLCDataPoint } from './config/types';
+import type { PerformanceMetrics, PerformanceCapabilities } from './config/types';
+/**
+ * Hit-test match for a chart element.
+ */
+export type ChartGPUHitTestMatch = Readonly<{
+    readonly kind: 'cartesian' | 'candlestick' | 'pie';
+    readonly seriesIndex: number;
+    readonly dataIndex: number;
+    readonly value: readonly [number, number];
+}>;
+/**
+ * Result of a hit-test operation on a chart.
+ */
+export type ChartGPUHitTestResult = Readonly<{
+    readonly isInGrid: boolean;
+    readonly canvasX: number;
+    readonly canvasY: number;
+    readonly gridX: number;
+    readonly gridY: number;
+    readonly match: ChartGPUHitTestMatch | null;
+}>;
+export interface ChartGPUInstance {
+    readonly options: Readonly<ChartGPUOptions>;
+    readonly disposed: boolean;
+    setOption(options: ChartGPUOptions): void;
+    /**
+     * Appends new points to a cartesian series at runtime (streaming).
+     *
+     * Accepts multiple formats for efficient data append without per-point object allocations:
+     * - `DataPoint[]`: Traditional array of point objects/tuples (existing behavior)
+     * - `XYArraysData`: Separate x/y/size arrays (`{x: ArrayLike<number>, y: ArrayLike<number>, size?: ArrayLike<number>}`)
+     * - `InterleavedXYData`: Typed array with [x0,y0,x1,y1,...] layout (e.g. `Float32Array`)
+     * - `OHLCDataPoint[]`: For candlestick series only
+     *
+     * Point count is derived via `getPointCount()` from `cartesianData.ts`:
+     * - `XYArraysData`: min(x.length, y.length)
+     * - `InterleavedXYData`: floor(length / 2), ignoring trailing odd element
+     * - `DataView` is unsupported and throws an error
+     *
+     * Pie series are non-cartesian and are not supported by streaming append.
+     */
+    appendData(seriesIndex: number, newPoints: CartesianSeriesData | OHLCDataPoint[]): void;
+    resize(): void;
+    dispose(): void;
+    on(eventName: 'crosshairMove', callback: ChartGPUCrosshairMoveCallback): void;
+    on(eventName: 'zoomRangeChange', callback: ChartGPUZoomRangeChangeCallback): void;
+    on(eventName: ChartGPUEventName, callback: ChartGPUEventCallback): void;
+    off(eventName: 'crosshairMove', callback: ChartGPUCrosshairMoveCallback): void;
+    off(eventName: 'zoomRangeChange', callback: ChartGPUZoomRangeChangeCallback): void;
+    off(eventName: ChartGPUEventName, callback: ChartGPUEventCallback): void;
+    /**
+     * Gets the current “interaction x” in domain units (or `null` when inactive).
+     *
+     * This is derived from pointer movement inside the plot grid and can also be driven
+     * externally via `setInteractionX(...)` (e.g. chart sync).
+     */
+    getInteractionX(): number | null;
+    /**
+     * Drives the chart’s crosshair + tooltip from a domain-space x value.
+     *
+     * Passing `null` clears the interaction (hides crosshair/tooltip).
+     */
+    setInteractionX(x: number | null, source?: unknown): void;
+    /**
+     * Alias for `setInteractionX(...)` for chart sync semantics.
+     */
+    setCrosshairX(x: number | null, source?: unknown): void;
+    /**
+     * Subscribes to interaction x changes (domain units).
+     *
+     * Returns an unsubscribe function.
+     */
+    onInteractionXChange(callback: (x: number | null, source?: unknown) => void): () => void;
+    /**
+     * Returns the current percent-space zoom window (or `null` when zoom is disabled).
+     */
+    getZoomRange(): Readonly<{
+        start: number;
+        end: number;
+    }> | null;
+    /**
+     * Sets the percent-space zoom window.
+     *
+     * No-op when zoom is disabled.
+     */
+    setZoomRange(start: number, end: number, source?: unknown): void;
+    /**
+     * Gets the latest performance metrics.
+     * Returns exact FPS and detailed frame statistics.
+     *
+     * @returns Current performance metrics, or null if not available
+     */
+    getPerformanceMetrics(): Readonly<PerformanceMetrics> | null;
+    /**
+     * Gets the performance capabilities of the current environment.
+     * Indicates which performance features are supported.
+     *
+     * @returns Performance capabilities, or null if not initialized
+     */
+    getPerformanceCapabilities(): Readonly<PerformanceCapabilities> | null;
+    /**
+     * Registers a callback to be notified of performance metric updates.
+     * Callback is invoked every frame with the latest metrics.
+     *
+     * @param callback - Function to call with updated metrics
+     * @returns Unsubscribe function to remove the callback
+     */
+    onPerformanceUpdate(callback: (metrics: Readonly<PerformanceMetrics>) => void): () => void;
+    /**
+     * Performs hit-testing on a pointer or mouse event.
+     *
+     * Returns coordinates and matched chart element (if any).
+     * Accepts both `PointerEvent` (for hover/click) and `MouseEvent` (for contextmenu/right-click).
+     *
+     * @param e - Pointer or mouse event to test
+     * @returns Hit-test result with coordinates and optional match
+     */
+    hitTest(e: PointerEvent | MouseEvent): ChartGPUHitTestResult;
+}
+export type ChartGPU = ChartGPUInstance;
+export type ChartGPUEventName = 'click' | 'mouseover' | 'mouseout' | 'crosshairMove' | 'zoomRangeChange';
+export type ChartGPUEventPayload = Readonly<{
+    readonly seriesIndex: number | null;
+    readonly dataIndex: number | null;
+    readonly value: readonly [number, number] | null;
+    readonly seriesName: string | null;
+    readonly event: PointerEvent;
+}>;
+export type ChartGPUCrosshairMovePayload = Readonly<{
+    readonly x: number | null;
+    readonly source?: unknown;
+}>;
+export type ChartGPUZoomRangeChangePayload = Readonly<{
+    readonly start: number;
+    readonly end: number;
+    readonly source?: unknown;
+}>;
+export type ChartGPUEventCallback = (payload: ChartGPUEventPayload) => void;
+export type ChartGPUCrosshairMoveCallback = (payload: ChartGPUCrosshairMovePayload) => void;
+export type ChartGPUZoomRangeChangeCallback = (payload: ChartGPUZoomRangeChangePayload) => void;
+export declare function createChartGPU(container: HTMLElement, options: ChartGPUOptions): Promise<ChartGPUInstance>;
+export declare const ChartGPU: {
+    create: typeof createChartGPU;
+};
+//# sourceMappingURL=ChartGPU.d.ts.map

package/dist/ChartGPU.d.ts.map

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

package/dist/components/createAnnotationConfigDialog.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Configuration dialog for creating and editing annotations
+ *
+ * Provides a modal dialog for setting annotation properties:
+ * - Label, color, line style, line width (for lines)
+ * - Text content, color, font size (for text annotations)
+ * - Label, color, marker size (for point annotations)
+ */
+import type { AnnotationConfig } from '../config/types.js';
+export interface AnnotationConfigDialogOptions {
+    readonly palette?: readonly string[];
+    readonly zIndex?: number;
+}
+export interface AnnotationConfigDialog {
+    showCreate(annotationType: 'lineX' | 'lineY' | 'text' | 'point', defaults: Partial<AnnotationConfig>, onSave: (config: AnnotationConfig) => void, onCancel: () => void): void;
+    showEdit(annotation: AnnotationConfig, onSave: (updates: Partial<AnnotationConfig>) => void, onCancel: () => void): void;
+    hide(): void;
+    dispose(): void;
+}
+/**
+ * Creates a configuration dialog for annotations
+ */
+export declare function createAnnotationConfigDialog(container: HTMLElement, options?: AnnotationConfigDialogOptions): AnnotationConfigDialog;
+//# sourceMappingURL=createAnnotationConfigDialog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createAnnotationConfigDialog.d.ts","sourceRoot":"","sources":["../../src/components/createAnnotationConfigDialog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,CACR,cAAc,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,EACpD,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,EACnC,MAAM,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,EAC1C,QAAQ,EAAE,MAAM,IAAI,GACnB,IAAI,CAAC;IAER,QAAQ,CACN,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,IAAI,EACpD,QAAQ,EAAE,MAAM,IAAI,GACnB,IAAI,CAAC;IAER,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,IAAI,IAAI,CAAC;CACjB;AAiBD;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,WAAW,EACtB,OAAO,GAAE,6BAAkC,GAC1C,sBAAsB,CA2rBxB"}

package/dist/components/createDataZoomSlider.d.ts

@@ -0,0 +1,14 @@
+import type { ZoomState } from '../interaction/createZoomState';
+import type { ThemeConfig } from '../themes/types';
+export interface DataZoomSlider {
+    update(theme: ThemeConfig): void;
+    dispose(): void;
+}
+export interface DataZoomSliderOptions {
+    readonly height?: number;
+    readonly marginTop?: number;
+    readonly zIndex?: number;
+    readonly showPreview?: boolean;
+}
+export declare function createDataZoomSlider(container: HTMLElement, zoomState: ZoomState, options?: DataZoomSliderOptions): DataZoomSlider;
+//# sourceMappingURL=createDataZoomSlider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createDataZoomSlider.d.ts","sourceRoot":"","sources":["../../src/components/createDataZoomSlider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAgBD,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,WAAW,EACtB,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,cAAc,CA+RhB"}

package/dist/components/createLegend.d.ts

@@ -0,0 +1,9 @@
+import type { SeriesConfig } from '../config/types';
+import type { ThemeConfig } from '../themes/types';
+export type LegendPosition = 'top' | 'bottom' | 'left' | 'right';
+export interface Legend {
+    update(series: ReadonlyArray<SeriesConfig>, theme: ThemeConfig): void;
+    dispose(): void;
+}
+export declare function createLegend(container: HTMLElement, position?: LegendPosition, onSeriesToggle?: (seriesIndex: number, sliceIndex?: number) => void): Legend;
+//# sourceMappingURL=createLegend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createLegend.d.ts","sourceRoot":"","sources":["../../src/components/createLegend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,MAAM;IACrB,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACtE,OAAO,IAAI,IAAI,CAAC;CACjB;AAwCD,wBAAgB,YAAY,CAC1B,SAAS,EAAE,WAAW,EACtB,QAAQ,GAAE,cAAwB,EAClC,cAAc,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,GAClE,MAAM,CAyPR"}

package/dist/components/createTextOverlay.d.ts

@@ -0,0 +1,17 @@
+export type TextOverlayAnchor = 'start' | 'middle' | 'end';
+export interface TextOverlayLabelOptions {
+    readonly fontSize?: number;
+    readonly color?: string;
+    readonly anchor?: TextOverlayAnchor;
+    /**
+     * Rotation in degrees (CSS `rotate(<deg>deg)`).
+     */
+    readonly rotation?: number;
+}
+export interface TextOverlay {
+    clear(): void;
+    addLabel(text: string, x: number, y: number, options?: TextOverlayLabelOptions): HTMLSpanElement;
+    dispose(): void;
+}
+export declare function createTextOverlay(container: HTMLElement): TextOverlay;
+//# sourceMappingURL=createTextOverlay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createTextOverlay.d.ts","sourceRoot":"","sources":["../../src/components/createTextOverlay.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE3D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IACpC;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,CAAC,EAAE,uBAAuB,GAChC,eAAe,CAAC;IACnB,OAAO,IAAI,IAAI,CAAC;CACjB;AAeD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,WAAW,GAAG,WAAW,CAiFrE"}

package/dist/components/createTooltip.d.ts

@@ -0,0 +1,12 @@
+export interface Tooltip {
+    /**
+     * Show tooltip at container-local CSS pixel coordinates.
+     *
+     * `content` is treated as HTML (assigned via `innerHTML`).
+     */
+    show(x: number, y: number, content: string): void;
+    hide(): void;
+    dispose(): void;
+}
+export declare function createTooltip(container: HTMLElement): Tooltip;
+//# sourceMappingURL=createTooltip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createTooltip.d.ts","sourceRoot":"","sources":["../../src/components/createTooltip.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB;;;;OAIG;IACH,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,IAAI,IAAI,CAAC;CACjB;AASD,wBAAgB,aAAa,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAsL7D"}

package/dist/components/formatTooltip.d.ts

@@ -0,0 +1,19 @@
+import type { TooltipParams } from '../config/types';
+/**
+ * Default tooltip formatter for candlestick series in item mode.
+ * Renders O/H/L/C values with colored arrow and percentage change.
+ */
+export declare function formatCandlestickTooltip(params: TooltipParams): string;
+/**
+ * Default tooltip formatter for item mode.
+ * Returns a compact single-row HTML snippet: dot + series name + y value.
+ * For candlestick series, returns O/H/L/C with arrow and percentage change.
+ */
+export declare function formatTooltipItem(params: TooltipParams): string;
+/**
+ * Default tooltip formatter for axis mode.
+ * Renders an x header line then one row per series with the y value.
+ * Candlestick series show O/H/L/C values with arrow and percentage change.
+ */
+export declare function formatTooltipAxis(params: TooltipParams[]): string;
+//# sourceMappingURL=formatTooltip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatTooltip.d.ts","sourceRoot":"","sources":["../../src/components/formatTooltip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAqIrD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAK/D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAkBjE"}

package/dist/config/OptionResolver.d.ts

@@ -0,0 +1,137 @@
+import type { AreaStyleConfig, AnnotationConfig, AxisConfig, CandlestickItemStyleConfig, CandlestickSeriesConfig, CandlestickStyle, ChartGPUOptions, GridConfig, LineStyleConfig, AreaSeriesConfig, BarSeriesConfig, LineSeriesConfig, PieDataItem, PieSeriesConfig, ScatterSeriesConfig, SeriesSampling } from './types';
+import type { ThemeConfig } from '../themes/types';
+export type ResolvedGridConfig = Readonly<Required<GridConfig>>;
+export type ResolvedLineStyleConfig = Readonly<Required<Omit<LineStyleConfig, 'color'>> & {
+    readonly color: string;
+}>;
+export type ResolvedAreaStyleConfig = Readonly<Required<Omit<AreaStyleConfig, 'color'>> & {
+    readonly color: string;
+}>;
+export type RawBounds = Readonly<{
+    xMin: number;
+    xMax: number;
+    yMin: number;
+    yMax: number;
+}>;
+export type ResolvedLineSeriesConfig = Readonly<Omit<LineSeriesConfig, 'color' | 'lineStyle' | 'areaStyle' | 'sampling' | 'samplingThreshold' | 'data'> & {
+    readonly color: string;
+    readonly lineStyle: ResolvedLineStyleConfig;
+    readonly areaStyle?: ResolvedAreaStyleConfig;
+    readonly sampling: SeriesSampling;
+    readonly samplingThreshold: number;
+    /**
+     * Original (unsampled) series data.
+     *
+     * Used at runtime for zoom-aware re-sampling so we can increase detail when zoomed-in without
+     * losing outliers or permanently discarding points.
+     */
+    readonly rawData: Readonly<LineSeriesConfig['data']>;
+    readonly data: Readonly<LineSeriesConfig['data']>;
+    /**
+     * Bounds computed from the original (unsampled) data. Used for axis auto-bounds so sampling
+     * cannot clip outliers.
+     */
+    readonly rawBounds?: RawBounds;
+}>;
+export type ResolvedAreaSeriesConfig = Readonly<Omit<AreaSeriesConfig, 'color' | 'areaStyle' | 'sampling' | 'samplingThreshold' | 'data'> & {
+    readonly color: string;
+    readonly areaStyle: ResolvedAreaStyleConfig;
+    readonly sampling: SeriesSampling;
+    readonly samplingThreshold: number;
+    /** Original (unsampled) series data (see `ResolvedLineSeriesConfig.rawData`). */
+    readonly rawData: Readonly<AreaSeriesConfig['data']>;
+    readonly data: Readonly<AreaSeriesConfig['data']>;
+    /**
+     * Bounds computed from the original (unsampled) data. Used for axis auto-bounds so sampling
+     * cannot clip outliers.
+     */
+    readonly rawBounds?: RawBounds;
+}>;
+export type ResolvedBarSeriesConfig = Readonly<Omit<BarSeriesConfig, 'color' | 'sampling' | 'samplingThreshold' | 'data'> & {
+    readonly color: string;
+    readonly sampling: SeriesSampling;
+    readonly samplingThreshold: number;
+    /** Original (unsampled) series data (see `ResolvedLineSeriesConfig.rawData`). */
+    readonly rawData: Readonly<BarSeriesConfig['data']>;
+    readonly data: Readonly<BarSeriesConfig['data']>;
+    /**
+     * Bounds computed from the original (unsampled) data. Used for axis auto-bounds so sampling
+     * cannot clip outliers.
+     */
+    readonly rawBounds?: RawBounds;
+}>;
+export type ResolvedScatterSeriesConfig = Readonly<Omit<ScatterSeriesConfig, 'color' | 'sampling' | 'samplingThreshold' | 'data' | 'mode' | 'binSize' | 'densityColormap' | 'densityNormalization'> & {
+    readonly color: string;
+    readonly sampling: SeriesSampling;
+    readonly samplingThreshold: number;
+    readonly mode: NonNullable<ScatterSeriesConfig['mode']>;
+    readonly binSize: number;
+    readonly densityColormap: NonNullable<ScatterSeriesConfig['densityColormap']>;
+    readonly densityNormalization: NonNullable<ScatterSeriesConfig['densityNormalization']>;
+    /** Original (unsampled) series data (see `ResolvedLineSeriesConfig.rawData`). */
+    readonly rawData: Readonly<ScatterSeriesConfig['data']>;
+    readonly data: Readonly<ScatterSeriesConfig['data']>;
+    /**
+     * Bounds computed from the original (unsampled) data. Used for axis auto-bounds so sampling
+     * cannot clip outliers.
+     */
+    readonly rawBounds?: RawBounds;
+}>;
+export type ResolvedPieDataItem = Readonly<Omit<PieDataItem, 'color' | 'visible'> & {
+    readonly color: string;
+    readonly visible: boolean;
+}>;
+export type ResolvedPieSeriesConfig = Readonly<Omit<PieSeriesConfig, 'color' | 'data'> & {
+    readonly color: string;
+    readonly data: ReadonlyArray<ResolvedPieDataItem>;
+}>;
+export type ResolvedCandlestickItemStyleConfig = Readonly<Required<CandlestickItemStyleConfig>>;
+export type ResolvedCandlestickSeriesConfig = Readonly<Omit<CandlestickSeriesConfig, 'color' | 'style' | 'itemStyle' | 'barWidth' | 'barMinWidth' | 'barMaxWidth' | 'sampling' | 'samplingThreshold' | 'data'> & {
+    readonly color: string;
+    readonly style: CandlestickStyle;
+    readonly itemStyle: ResolvedCandlestickItemStyleConfig;
+    readonly barWidth: number | string;
+    readonly barMinWidth: number;
+    readonly barMaxWidth: number;
+    readonly sampling: 'none' | 'ohlc';
+    readonly samplingThreshold: number;
+    /** Original (unsampled) series data. */
+    readonly rawData: Readonly<CandlestickSeriesConfig['data']>;
+    readonly data: Readonly<CandlestickSeriesConfig['data']>;
+    /**
+     * Bounds computed from the original (unsampled) data. Used for axis auto-bounds so sampling
+     * cannot clip outliers.
+     */
+    readonly rawBounds?: RawBounds;
+}>;
+export type ResolvedSeriesConfig = ResolvedLineSeriesConfig | ResolvedAreaSeriesConfig | ResolvedBarSeriesConfig | ResolvedScatterSeriesConfig | ResolvedPieSeriesConfig | ResolvedCandlestickSeriesConfig;
+export interface ResolvedChartGPUOptions extends Omit<ChartGPUOptions, 'grid' | 'xAxis' | 'yAxis' | 'theme' | 'palette' | 'series' | 'legend'> {
+    readonly grid: ResolvedGridConfig;
+    readonly xAxis: AxisConfig;
+    readonly yAxis: AxisConfig;
+    readonly autoScroll: boolean;
+    readonly theme: ThemeConfig;
+    readonly palette: ReadonlyArray<string>;
+    readonly series: ReadonlyArray<ResolvedSeriesConfig>;
+    readonly annotations?: ReadonlyArray<AnnotationConfig>;
+    readonly legend?: import('./types').LegendConfig;
+}
+export declare function resolveOptions(userOptions?: ChartGPUOptions): ResolvedChartGPUOptions;
+/**
+ * Resolves chart options with slider bottom-space reservation.
+ *
+ * This function wraps `resolveOptions()` and applies additional grid bottom spacing
+ * when a slider-type dataZoom is configured. The reservation ensures x-axis labels
+ * and ticks are visible above the slider overlay.
+ *
+ * **Usage**: Use this function instead of `resolveOptions()` when creating charts
+ * to ensure consistent slider layout.
+ *
+ * @param userOptions - User-provided chart options
+ * @returns Resolved options with slider bottom-space applied if needed
+ */
+export declare function resolveOptionsForChart(userOptions?: ChartGPUOptions): ResolvedChartGPUOptions;
+export declare const OptionResolver: {
+    readonly resolve: typeof resolveOptions;
+};
+//# sourceMappingURL=OptionResolver.d.ts.map