@chartgpu/chartgpu 0.2.5

package/dist/interaction/createAnnotationAuthoring.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Annotation authoring helper for ChartGPU instances.
+ *
+ * Provides right-click context menu for adding vertical lines and text annotations,
+ * with undo/redo, JSON export, drag-to-reposition, and editing capabilities.
+ */
+import type { ChartGPUInstance } from '../ChartGPU';
+import type { AnnotationConfig } from '../config/types';
+/**
+ * Configuration options for annotation authoring.
+ */
+export interface AnnotationAuthoringOptions {
+    /**
+     * Z-index for the context menu (default: 1000).
+     */
+    readonly menuZIndex?: number;
+    /**
+     * Enable right-click context menu (default: true).
+     */
+    readonly enableContextMenu?: boolean;
+}
+/**
+ * Annotation authoring instance returned by `createAnnotationAuthoring`.
+ *
+ * Provides programmatic control over annotations and manages UI lifecycle.
+ */
+export interface AnnotationAuthoringInstance {
+    /**
+     * Programmatically add a vertical line annotation.
+     *
+     * @param x - X-coordinate in data domain units
+     */
+    addVerticalLine(x: number): void;
+    /**
+     * Programmatically add a text annotation.
+     *
+     * @param x - X-coordinate (domain units for 'data' space, fraction [0-1] for 'plot' space)
+     * @param y - Y-coordinate (domain units for 'data' space, fraction [0-1] for 'plot' space)
+     * @param text - Annotation text content
+     * @param space - Coordinate space: 'data' (default) or 'plot'
+     */
+    addTextNote(x: number, y: number, text: string, space?: 'data' | 'plot'): void;
+    /**
+     * Undo the last annotation change.
+     *
+     * @returns `true` if undo was successful, `false` if nothing to undo
+     */
+    undo(): boolean;
+    /**
+     * Redo a previously undone change.
+     *
+     * @returns `true` if redo was successful, `false` if nothing to redo
+     */
+    redo(): boolean;
+    /**
+     * Export current annotations as JSON string.
+     *
+     * @returns JSON string representation of annotations array
+     */
+    exportJSON(): string;
+    /**
+     * Get the current annotations array.
+     *
+     * @returns Readonly copy of current annotations
+     */
+    getAnnotations(): readonly AnnotationConfig[];
+    /**
+     * Clean up event listeners and DOM elements.
+     *
+     * Safe to call multiple times. After disposal, the instance should not be used.
+     */
+    dispose(): void;
+}
+/**
+ * Creates an annotation authoring helper for a chart instance.
+ *
+ * Features:
+ * - Right-click context menu for adding vertical lines and text annotations
+ * - Optional toolbar with undo/redo/export buttons
+ * - Undo/redo history (50 entries max)
+ * - JSON export with clipboard integration
+ * - Automatic coordinate conversion (data-space and plot-space)
+ * - Event listener cleanup on dispose
+ *
+ * Annotations are persisted by calling `chart.setOption({ ...options, annotations })`,
+ * so they integrate seamlessly with the chart's option system.
+ *
+ * @param container - The chart container element (must contain the chart canvas)
+ * @param chart - The ChartGPU instance
+ * @param options - Optional configuration for menu/toolbar z-index and visibility
+ * @returns Annotation authoring instance with programmatic API and dispose method
+ * @throws Error if canvas is not found
+ *
+ * @example
+ * ```ts
+ * const chart = await ChartGPU.create(container, options);
+ * const authoring = createAnnotationAuthoring(container, chart, {
+ *   showToolbar: true,
+ *   enableContextMenu: true,
+ * });
+ *
+ * // Programmatic API
+ * authoring.addVerticalLine(Date.now());
+ * authoring.addTextNote(x, y, 'Peak', 'data');
+ * authoring.undo();
+ * authoring.redo();
+ * const json = authoring.exportJSON();
+ *
+ * // Cleanup
+ * authoring.dispose();
+ * chart.dispose();
+ * ```
+ */
+export declare function createAnnotationAuthoring(container: HTMLElement, chart: ChartGPUInstance, options?: AnnotationAuthoringOptions): AnnotationAuthoringInstance;
+//# sourceMappingURL=createAnnotationAuthoring.d.ts.map

package/dist/interaction/createAnnotationAuthoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAnnotationAuthoring.d.ts","sourceRoot":"","sources":["../../src/interaction/createAnnotationAuthoring.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAyB,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAgE,MAAM,iBAAiB,CAAC;AActH;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;;;;;;OAOG;IACH,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/E;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC;IAChB;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC;IAChB;;;;OAIG;IACH,UAAU,IAAI,MAAM,CAAC;IACrB;;;;OAIG;IACH,cAAc,IAAI,SAAS,gBAAgB,EAAE,CAAC;IAC9C;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,0BAA+B,GACvC,2BAA2B,CA2pB7B"}

package/dist/interaction/createAnnotationDragHandler.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Drag handler for repositioning annotations
+ *
+ * Handles dragging annotations to reposition them:
+ * - lineX: constrained to horizontal movement
+ * - lineY: constrained to vertical movement
+ * - text: free 2D movement (data or plot space)
+ * - point: free 2D movement (data space)
+ *
+ * Uses optimistic updates during drag for 60 FPS performance.
+ */
+import type { AnnotationConfig } from '../config/types.js';
+import type { ChartGPUInstance } from '../ChartGPU.js';
+export interface AnnotationDragCallbacks {
+    onDragMove: (index: number, updates: Partial<AnnotationConfig>) => void;
+    onDragEnd: (index: number, updates: Partial<AnnotationConfig>) => void;
+    onDragCancel: () => void;
+}
+export interface AnnotationDragHandler {
+    startDrag(annotationIndex: number, annotation: AnnotationConfig, startPointerX: number, startPointerY: number): void;
+    isDragging(): boolean;
+    dispose(): void;
+}
+/**
+ * Creates a drag handler for repositioning annotations
+ */
+export declare function createAnnotationDragHandler(chart: ChartGPUInstance, canvas: HTMLCanvasElement, callbacks: AnnotationDragCallbacks): AnnotationDragHandler;
+//# sourceMappingURL=createAnnotationDragHandler.d.ts.map

package/dist/interaction/createAnnotationDragHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAnnotationDragHandler.d.ts","sourceRoot":"","sources":["../../src/interaction/createAnnotationDragHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAa,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IACxE,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IACvE,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,CACP,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,gBAAgB,EAC5B,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GACpB,IAAI,CAAC;IACR,UAAU,IAAI,OAAO,CAAC;IACtB,OAAO,IAAI,IAAI,CAAC;CACjB;AAUD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,uBAAuB,GACjC,qBAAqB,CAyXvB"}

package/dist/interaction/createAnnotationHitTester.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Hit testing for chart annotations
+ *
+ * Detects which annotation (if any) the user clicked or hovered over.
+ * Uses canvas-space coordinates and configurable hit tolerances.
+ */
+import type { AnnotationConfig } from '../config/types.js';
+import type { ChartGPUInstance } from '../ChartGPU.js';
+export interface AnnotationHitTestResult {
+    readonly annotationIndex: number;
+    readonly annotation: AnnotationConfig;
+    readonly hitType: 'line' | 'text' | 'point' | 'label';
+    readonly distanceCssPx: number;
+}
+export interface AnnotationHitTesterOptions {
+    readonly lineTolerance?: number;
+    readonly textTolerance?: number;
+    readonly pointTolerance?: number;
+    readonly labelTolerance?: number;
+    readonly spatialGridThreshold?: number;
+}
+export interface AnnotationHitTester {
+    hitTest(canvasX: number, canvasY: number): AnnotationHitTestResult | null;
+    updateTextBounds(textBounds: Map<number, DOMRect>): void;
+    invalidateCache(): void;
+    dispose(): void;
+}
+/**
+ * Creates an annotation hit tester for detecting pointer interactions
+ */
+export declare function createAnnotationHitTester(chart: ChartGPUInstance, canvas: HTMLCanvasElement, options?: AnnotationHitTesterOptions): AnnotationHitTester;
+//# sourceMappingURL=createAnnotationHitTester.d.ts.map

package/dist/interaction/createAnnotationHitTester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAnnotationHitTester.d.ts","sourceRoot":"","sources":["../../src/interaction/createAnnotationHitTester.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAa,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACtD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAAC;IAC1E,gBAAgB,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,eAAe,IAAI,IAAI,CAAC;IACxB,OAAO,IAAI,IAAI,CAAC;CACjB;AASD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,0BAA+B,GACvC,mBAAmB,CAgarB"}

package/dist/interaction/createChartSync.d.ts

@@ -0,0 +1,27 @@
+import type { ChartGPU } from '../ChartGPU';
+export type DisconnectCharts = () => void;
+export type ChartSyncOptions = Readonly<{
+    /**
+     * Sync crosshair + tooltip (interaction-x) across charts.
+     *x
+     * @default true
+     */
+    readonly syncCrosshair?: boolean;
+    /**
+     * Sync zoom/pan across charts (percent-space zoom range).
+     *
+     * @default false
+     */
+    readonly syncZoom?: boolean;
+}>;
+/**
+ * Connects multiple charts so pointer movement in one chart drives crosshair/tooltip x
+ * in the other charts (domain x sync). Returns a `disconnect()` function.
+ *
+ * Notes:
+ * - By default, syncs interaction only (crosshair + tooltip x), not zoom/options.
+ * - Enable zoom sync via `{ syncZoom: true }`.
+ * - Uses a per-connection loop guard to prevent feedback.
+ */
+export declare function connectCharts(charts: ChartGPU[], options?: ChartSyncOptions): DisconnectCharts;
+//# sourceMappingURL=createChartSync.d.ts.map

package/dist/interaction/createChartSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createChartSync.d.ts","sourceRoot":"","sources":["../../src/interaction/createChartSync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAgE,MAAM,aAAa,CAAC;AAE1G,MAAM,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC;AAE1C,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAwF9F"}

package/dist/interaction/createEventManager.d.ts

@@ -0,0 +1,24 @@
+import type { GridArea } from '../renderers/createGridRenderer';
+export type ChartGPUEventName = 'mousemove' | 'click' | 'mouseleave';
+export type ChartGPUEventPayload = {
+    readonly x: number;
+    readonly y: number;
+    readonly gridX: number;
+    readonly gridY: number;
+    /** Plot (grid) width in CSS pixels. */
+    readonly plotWidthCss: number;
+    /** Plot (grid) height in CSS pixels. */
+    readonly plotHeightCss: number;
+    readonly isInGrid: boolean;
+    readonly originalEvent: PointerEvent;
+};
+export type ChartGPUEventCallback = (payload: ChartGPUEventPayload) => void;
+export interface EventManager {
+    readonly canvas: HTMLCanvasElement;
+    on(event: ChartGPUEventName, callback: ChartGPUEventCallback): void;
+    off(event: ChartGPUEventName, callback: ChartGPUEventCallback): void;
+    updateGridArea(gridArea: GridArea): void;
+    dispose(): void;
+}
+export declare function createEventManager(canvas: HTMLCanvasElement, initialGridArea: GridArea): EventManager;
+//# sourceMappingURL=createEventManager.d.ts.map

package/dist/interaction/createEventManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createEventManager.d.ts","sourceRoot":"","sources":["../../src/interaction/createEventManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEhE,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,OAAO,GAAG,YAAY,CAAC;AAErE,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;AAE5E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACpE,GAAG,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACrE,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACzC,OAAO,IAAI,IAAI,CAAC;CACjB;AAcD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,QAAQ,GAAG,YAAY,CA6KrG"}

package/dist/interaction/createHoverState.d.ts

@@ -0,0 +1,20 @@
+export type HoverTarget = Readonly<{
+    seriesIndex: number;
+    dataIndex: number;
+}>;
+export type HoverChangeCallback = (hovered: HoverTarget | null) => void;
+export interface HoverState {
+    setHovered(seriesIndex: number, dataIndex: number): void;
+    clearHovered(): void;
+    getHovered(): HoverTarget | null;
+    onChange(callback: HoverChangeCallback): () => void;
+    destroy?: () => void;
+}
+/**
+ * Tracks hovered series/data indices and notifies listeners on changes.
+ *
+ * - Updates are debounced to avoid spamming downstream work during rapid pointer movement.
+ * - Listeners fire only when the hovered target actually changes.
+ */
+export declare function createHoverState(): HoverState;
+//# sourceMappingURL=createHoverState.d.ts.map

package/dist/interaction/createHoverState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createHoverState.d.ts","sourceRoot":"","sources":["../../src/interaction/createHoverState.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;AAExE,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzD,YAAY,IAAI,IAAI,CAAC;IACrB,UAAU,IAAI,WAAW,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAAC;IACpD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAmBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAgE7C"}

package/dist/interaction/createInsideZoom.d.ts

@@ -0,0 +1,14 @@
+import type { EventManager } from './createEventManager';
+import type { ZoomState } from './createZoomState';
+export type InsideZoom = Readonly<{
+    enable(): void;
+    disable(): void;
+    dispose(): void;
+}>;
+/**
+ * Internal “inside” zoom interaction:
+ * - wheel zoom centered at cursor-x (only when inside grid)
+ * - shift+left drag OR middle-mouse drag pans left/right (only when inside grid)
+ */
+export declare function createInsideZoom(eventManager: EventManager, zoomState: ZoomState): InsideZoom;
+//# sourceMappingURL=createInsideZoom.d.ts.map

package/dist/interaction/createInsideZoom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createInsideZoom.d.ts","sourceRoot":"","sources":["../../src/interaction/createInsideZoom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAwB,MAAM,sBAAsB,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;IAChB,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC,CAAC;AAuDH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,GAAG,UAAU,CAmI7F"}

package/dist/interaction/createZoomState.d.ts

@@ -0,0 +1,63 @@
+export type ZoomRange = Readonly<{
+    start: number;
+    end: number;
+}>;
+export type ZoomRangeChangeCallback = (range: ZoomRange) => void;
+export interface ZoomState {
+    /**
+     * Returns the current zoom window in percent space, clamped to [0, 100].
+     */
+    getRange(): ZoomRange;
+    /**
+     * Sets the zoom window in percent space.
+     */
+    setRange(start: number, end: number): void;
+    /**
+     * Zooms in around `center` by shrinking the span by `factor`.
+     *
+     * `factor <= 1` is treated as a no-op.
+     */
+    zoomIn(center: number, factor: number): void;
+    /**
+     * Zooms out around `center` by growing the span by `factor`.
+     *
+     * `factor <= 1` is treated as a no-op.
+     */
+    zoomOut(center: number, factor: number): void;
+    /**
+     * Pans the zoom window by `delta` percent points (preserving span).
+     */
+    pan(delta: number): void;
+    /**
+     * Subscribes to changes. Returns an unsubscribe function.
+     */
+    onChange(callback: ZoomRangeChangeCallback): () => void;
+}
+export type ZoomSpanConstraints = Readonly<{
+    /**
+     * Minimum allowed span (percent points in [0, 100]).
+     */
+    readonly minSpan?: number;
+    /**
+     * Maximum allowed span (percent points in [0, 100]).
+     */
+    readonly maxSpan?: number;
+}>;
+export type ZoomRangeAnchor = 'start' | 'end' | 'center' | Readonly<{
+    center: number;
+    ratio: number;
+}>;
+export interface ZoomStateWithConstraints extends ZoomState {
+    /**
+     * Updates span constraints at runtime (used by coordinator on setOption/appendData).
+     *
+     * Passing `undefined` leaves that constraint unchanged.
+     */
+    setSpanConstraints(minSpan?: number, maxSpan?: number): void;
+    /**
+     * Sets a range with an explicit anchor for clamping (used by slider handles).
+     */
+    setRangeAnchored(start: number, end: number, anchor: ZoomRangeAnchor): void;
+}
+export declare function createZoomState(initialStart: number, initialEnd: number, constraints?: ZoomSpanConstraints): ZoomStateWithConstraints;
+//# sourceMappingURL=createZoomState.d.ts.map

package/dist/interaction/createZoomState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createZoomState.d.ts","sourceRoot":"","sources":["../../src/interaction/createZoomState.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEjE,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAEjE,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,QAAQ,IAAI,SAAS,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,IAAI,CAAC;CACzD;AAED,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,KAAK,GACL,QAAQ,GACR,QAAQ,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEhD,MAAM,WAAW,wBAAyB,SAAQ,SAAS;IACzD;;;;OAIG;IACH,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7D;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;CAC7E;AAgBD,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,mBAAmB,GAChC,wBAAwB,CA0M1B"}

package/dist/interaction/findCandlestick.d.ts

@@ -0,0 +1,41 @@
+import type { ResolvedCandlestickSeriesConfig } from '../config/OptionResolver';
+import type { OHLCDataPoint } from '../config/types';
+import type { LinearScale } from '../utils/scales';
+export interface CandlestickMatch {
+    seriesIndex: number;
+    dataIndex: number;
+    point: OHLCDataPoint;
+}
+/**
+ * Computes the candlestick body width in xScale **range-space** units.
+ *
+ * Notes:
+ * - This mirrors `createCandlestickRenderer.ts` bar width semantics, but stays in range units
+ *   (CSS pixels in ChartGPU interaction usage).
+ * - No DPR conversions are applied here.
+ */
+export declare function computeCandlestickBodyWidthRange(series: ResolvedCandlestickSeriesConfig, data: ReadonlyArray<OHLCDataPoint>, xScale: LinearScale, plotWidthFallback?: number): number;
+/**
+ * Finds the candlestick body under the given cursor position.
+ *
+ * Coordinate system contract:
+ * - `x`/`y` MUST be in the same units as `xScale`/`yScale` **range-space**
+ *   (ChartGPU interaction uses grid-local CSS pixels).
+ *
+ * Hit-test semantics:
+ * - Body-only hit-testing (wicks ignored).
+ * - A candle hits if:
+ *   - `abs(x - xCenter) <= barWidth / 2`, AND
+ *   - `y` is between the scaled `open` and `close` (inclusive).
+ *
+ * Performance:
+ * - Per-series lower-bound binary search on timestamp, then scans left/right while x-distance alone can still hit.
+ * - If timestamps are not monotonic non-decreasing finite numbers, falls back to an O(n) scan for correctness.
+ *
+ * Edge cases:
+ * - Skips non-finite timestamps/open/close.
+ * - If `barWidthClip` is non-finite or <= 0, returns null.
+ * - Returns the closest in x (min abs dx) among hits; ties broken by smaller `dataIndex` (then smaller `seriesIndex`).
+ */
+export declare function findCandlestick(series: ReadonlyArray<ResolvedCandlestickSeriesConfig>, x: number, y: number, xScale: LinearScale, yScale: LinearScale, barWidthClip: number): CandlestickMatch | null;
+//# sourceMappingURL=findCandlestick.d.ts.map

package/dist/interaction/findCandlestick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findCandlestick.d.ts","sourceRoot":"","sources":["../../src/interaction/findCandlestick.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,CAAC;CACtB;AA0CD;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,+BAA+B,EACvC,IAAI,EAAE,aAAa,CAAC,aAAa,CAAC,EAClC,MAAM,EAAE,WAAW,EACnB,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,CAkDR;AAqCD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,CAAC,+BAA+B,CAAC,EACtD,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,MAAM,GACnB,gBAAgB,GAAG,IAAI,CA2GzB"}

package/dist/interaction/findNearestPoint.d.ts

@@ -0,0 +1,61 @@
+import type { DataPoint } from '../config/types';
+import type { ResolvedBarSeriesConfig, ResolvedSeriesConfig } from '../config/OptionResolver';
+import type { LinearScale } from '../utils/scales';
+export type NearestPointMatch = Readonly<{
+    seriesIndex: number;
+    dataIndex: number;
+    point: DataPoint;
+    /** Euclidean distance in range units. */
+    distance: number;
+}>;
+export type BarBounds = {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+};
+export declare function isPointInBar(x: number, y: number, barBounds: BarBounds): boolean;
+export type BarClusterSlots = Readonly<{
+    clusterIndexBySeries: ReadonlyArray<number>;
+    clusterCount: number;
+    stackIdBySeries: ReadonlyArray<string>;
+}>;
+export declare function computeBarClusterSlots(seriesConfigs: ReadonlyArray<ResolvedBarSeriesConfig>): BarClusterSlots;
+export declare function computeBarCategoryStep(seriesConfigs: ReadonlyArray<ResolvedBarSeriesConfig>): number;
+export declare function computeCategoryWidthPx(seriesConfigs: ReadonlyArray<ResolvedBarSeriesConfig>, xScale: LinearScale, categoryStep: number): number;
+export type BarLayoutPx = Readonly<{
+    categoryStep: number;
+    categoryWidthPx: number;
+    barWidthPx: number;
+    gapPx: number;
+    clusterWidthPx: number;
+    clusterSlots: BarClusterSlots;
+}>;
+export declare function computeBarLayoutPx(seriesConfigs: ReadonlyArray<ResolvedBarSeriesConfig>, xScale: LinearScale): BarLayoutPx;
+export declare function inferPlotHeightPxForBarHitTesting(seriesConfigs: ReadonlyArray<ResolvedBarSeriesConfig>, yScale: LinearScale): number;
+export declare function computeBaselineDomainAndPx(seriesConfigs: ReadonlyArray<ResolvedBarSeriesConfig>, yScale: LinearScale, plotHeightPx: number): Readonly<{
+    baselineDomain: number;
+    baselinePx: number;
+}>;
+export declare function bucketStackedXKey(xCenterPx: number, categoryWidthPx: number, xDomain: number, categoryStep: number): number;
+/**
+ * Finds the nearest data point to the given cursor position across all series.
+ *
+ * Coordinate system contract:
+ * - `x`/`y` MUST be in the same units as `xScale`/`yScale` **range**.
+ * - If you pass **grid-local CSS pixels** (e.g. `payload.gridX` / `payload.gridY` from `createEventManager`),
+ *   then `xScale.range()` / `yScale.range()` must also be in **CSS pixels**.
+ * - If your scales are in **clip space** (e.g. \([-1, 1]\)), pass cursor coordinates in clip space too.
+ *
+ * DPR/WebGPU note:
+ * - Pointer events are naturally in CSS pixels; WebGPU rendering often uses device pixels or clip space.
+ *   This helper stays agnostic and only computes Euclidean distance in the provided **range-space**.
+ *
+ * Performance notes:
+ * - Assumes each series is sorted by increasing x in domain space.
+ * - Uses per-series lower-bound binary search on x, then expands outward while x-distance alone can still win.
+ * - Uses squared distance comparisons and computes `sqrt` only for the final match.
+ * - Skips non-finite points and any points whose scaled coordinates are NaN.
+ */
+export declare function findNearestPoint(series: ReadonlyArray<ResolvedSeriesConfig>, x: number, y: number, xScale: LinearScale, yScale: LinearScale, maxDistance?: number): NearestPointMatch | null;
+//# sourceMappingURL=findNearestPoint.d.ts.map

package/dist/interaction/findNearestPoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findNearestPoint.d.ts","sourceRoot":"","sources":["../../src/interaction/findNearestPoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAA0D,MAAM,iBAAiB,CAAC;AACzG,OAAO,KAAK,EACV,uBAAuB,EAEvB,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAyBnD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAShF;AAqED,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,oBAAoB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACxC,CAAC,CAAC;AAEH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,aAAa,CAAC,uBAAuB,CAAC,GACpD,eAAe,CAgCjB;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,aAAa,CAAC,uBAAuB,CAAC,GAAG,MAAM,CAoBpG;AAED,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,aAAa,CAAC,uBAAuB,CAAC,EACrD,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAgCR;AAyBD,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,eAAe,CAAC;CAC/B,CAAC,CAAC;AAEH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,aAAa,CAAC,uBAAuB,CAAC,EACrD,MAAM,EAAE,WAAW,GAClB,WAAW,CAyCb;AAsBD,wBAAgB,iCAAiC,CAC/C,aAAa,EAAE,aAAa,CAAC,uBAAuB,CAAC,EACrD,MAAM,EAAE,WAAW,GAClB,MAAM,CAgBR;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,aAAa,CAAC,uBAAuB,CAAC,EACrD,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,MAAM,GACnB,QAAQ,CAAC;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAgC1D;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,MAAM,CAWR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,aAAa,CAAC,oBAAoB,CAAC,EAC3C,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,EACnB,WAAW,GAAE,MAAgC,GAC5C,iBAAiB,GAAG,IAAI,CAoU1B"}

package/dist/interaction/findPieSlice.d.ts

@@ -0,0 +1,36 @@
+import type { ResolvedPieSeriesConfig } from '../config/OptionResolver';
+export type PieSliceMatch = Readonly<{
+    seriesIndex: number;
+    dataIndex: number;
+    slice: ResolvedPieSeriesConfig['data'][number];
+}>;
+export type PieHitTestConfig = Readonly<{
+    seriesIndex: number;
+    series: ResolvedPieSeriesConfig;
+}>;
+export type PieCenterCssPx = Readonly<{
+    x: number;
+    y: number;
+}>;
+export type PieRadiusCssPx = Readonly<{
+    inner: number;
+    outer: number;
+}>;
+/**
+ * Finds the pie slice under a given pointer position.
+ *
+ * Coordinate contract:
+ * - `x`/`y` are plot/grid-local CSS pixels (origin at plot top-left, +y down).
+ * - `center` is plot-local CSS pixels.
+ * - `radius` is CSS pixels (inner/outer). Points within the donut hole are not hoverable.
+ *
+ * Angle conventions:
+ * - Uses +y up for polar angle (to match `pie.wgsl` atan2(p.y, p.x)).
+ * - Wraps angles to [0, 2π).
+ * - Matches `createPieRenderer.ts` start angle default (90°).
+ *
+ * Value conventions:
+ * - Ignores non-finite and non-positive slice values (mirrors renderer).
+ */
+export declare function findPieSlice(x: number, y: number, pieConfig: PieHitTestConfig, center: PieCenterCssPx, radius: PieRadiusCssPx): PieSliceMatch | null;
+//# sourceMappingURL=findPieSlice.d.ts.map

package/dist/interaction/findPieSlice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findPieSlice.d.ts","sourceRoot":"","sources":["../../src/interaction/findPieSlice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAUxE,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,uBAAuB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;CAChD,CAAC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,uBAAuB,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAExE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAC1B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,GACrB,aAAa,GAAG,IAAI,CAoFtB"}

package/dist/interaction/findPointsAtX.d.ts

@@ -0,0 +1,37 @@
+import type { DataPoint } from '../config/types';
+import type { ResolvedSeriesConfig } from '../config/OptionResolver';
+import type { LinearScale } from '../utils/scales';
+export type PointsAtXMatch = Readonly<{
+    seriesIndex: number;
+    dataIndex: number;
+    point: DataPoint;
+}>;
+/**
+ * Finds (at most) one nearest point per series at a given x position.
+ *
+ * Coordinate system contract (mirrors `findNearestPoint`):
+ * - `xValue` and optional `tolerance` MUST be in the same units as `xScale` **range**.
+ *   (Example: if your `xScale.range()` is in grid-local CSS pixels, pass `payload.gridX` from `createEventManager`.)
+ *   Note: ChartGPU's internal renderer scales are currently in clip space (NDC, typically \[-1, 1\]); in that case
+ *   convert your pointer x into clip space before calling this helper.
+ *
+ * Behavior:
+ * - Assumes each series is sorted by increasing x in domain space.
+ * - Uses a lower-bound binary search in domain-x, then expands outward while x-distance alone can still improve.
+ * - Skips points with non-finite domain x or non-finite scaled x. If a series contains any NaN x values, this helper
+ *   falls back to an O(n) scan for correctness (NaN breaks total ordering for binary search).
+ * - Stable tie-breaking: for equal distance, chooses the smaller `dataIndex`.
+ *
+ * If `tolerance` is provided, it is interpreted in **xScale range units**. Matches beyond tolerance are omitted.
+ * If `tolerance` is omitted (or non-finite), the nearest point per series is returned when possible.
+ *
+ * Bar series special-case:
+ * - Bars occupy x-intervals \([left, right)\) in **xScale range units** (grid-local CSS px for interaction scales),
+ *   using the same shared layout math as the bar renderer (grouping + stacking slots).
+ * - If `tolerance` is finite, a bar match is only returned when `xValue` falls inside the bar interval expanded by
+ *   `tolerance` on both sides: \([left - tolerance, right + tolerance)\).
+ * - If `tolerance` is omitted / non-finite, we first attempt an exact interval hit (no expansion) and otherwise fall
+ *   back to the existing nearest-x behavior (so axis-trigger tooltips still work away from bars).
+ */
+export declare function findPointsAtX(series: ReadonlyArray<ResolvedSeriesConfig>, xValue: number, xScale: LinearScale, tolerance?: number): ReadonlyArray<PointsAtXMatch>;
+//# sourceMappingURL=findPointsAtX.d.ts.map

package/dist/interaction/findPointsAtX.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findPointsAtX.d.ts","sourceRoot":"","sources":["../../src/interaction/findPointsAtX.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAuB,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EAA2B,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC9F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC,CAAC;AAuFH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,CAAC,oBAAoB,CAAC,EAC3C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,aAAa,CAAC,cAAc,CAAC,CAgM/B"}

package/dist/renderers/createAnnotationMarkerRenderer.d.ts

@@ -0,0 +1,58 @@
+export type AnnotationMarkerInstance = Readonly<{
+    /**
+     * Center in CANVAS-LOCAL CSS pixels.
+     * (0,0) is the canvas top-left in CSS pixel coordinates.
+     */
+    xCssPx: number;
+    yCssPx: number;
+    /** Marker diameter in CSS pixels. */
+    sizeCssPx: number;
+    /** Fill color RGBA in 0..1 (straight alpha). */
+    fillRgba: readonly [r: number, g: number, b: number, a: number];
+    /** Optional stroke width in CSS pixels (0 disables stroke). */
+    strokeWidthCssPx?: number;
+    /** Optional stroke color RGBA in 0..1 (straight alpha). */
+    strokeRgba?: readonly [r: number, g: number, b: number, a: number];
+}>;
+export interface AnnotationMarkerRenderer {
+    /**
+     * Uploads marker instances and prepares uniforms for rendering.
+     *
+     * Coordinate contract:
+     * - `instances[*].xCssPx/yCssPx` are CANVAS-LOCAL CSS pixels.
+     * - `canvasWidth/canvasHeight` are in *device pixels* (same as render target size).
+     * - `devicePixelRatio` is used to convert CSS px to device px inside the shader.
+     *
+     * Scissor contract:
+     * - This renderer intentionally does NOT set or reset scissor state.
+     *   The caller must set scissor for plot clipping before invoking `render()`.
+     */
+    prepare(params: Readonly<{
+        canvasWidth: number;
+        canvasHeight: number;
+        devicePixelRatio: number;
+        instances: readonly AnnotationMarkerInstance[];
+    }>): void;
+    /** Draws all prepared instances (if any). */
+    render(passEncoder: GPURenderPassEncoder, firstInstance?: number, instanceCount?: number): void;
+    /** Cleans up GPU resources (best-effort). */
+    dispose(): void;
+}
+export interface AnnotationMarkerRendererOptions {
+    /**
+     * Must match the canvas context format used for the render pass color attachment.
+     * Usually this is `gpuContext.preferredFormat`.
+     *
+     * Defaults to `'bgra8unorm'` for backward compatibility.
+     */
+    readonly targetFormat?: GPUTextureFormat;
+    /**
+     * Multisample count for the render pipeline.
+     *
+     * Must match the render pass color attachment sampleCount.
+     * Defaults to 1 (no MSAA).
+     */
+    readonly sampleCount?: number;
+}
+export declare function createAnnotationMarkerRenderer(device: GPUDevice, options?: AnnotationMarkerRendererOptions): AnnotationMarkerRenderer;
+//# sourceMappingURL=createAnnotationMarkerRenderer.d.ts.map

package/dist/renderers/createAnnotationMarkerRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAnnotationMarkerRenderer.d.ts","sourceRoot":"","sources":["../../src/renderers/createAnnotationMarkerRenderer.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IAEf,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAElB,gDAAgD;IAChD,QAAQ,EAAE,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAEhE,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;CACpE,CAAC,CAAC;AAEH,MAAM,WAAW,wBAAwB;IACvC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,SAAS,EAAE,SAAS,wBAAwB,EAAE,CAAC;KAChD,CAAC,GAAG,IAAI,CAAC;IAEV,6CAA6C;IAC7C,MAAM,CAAC,WAAW,EAAE,oBAAoB,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhG,6CAA6C;IAC7C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,+BAA+B;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAEzC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAiBD,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,+BAA+B,GAAG,wBAAwB,CA8MrI"}