uplot-plus 0.5.10 → 0.5.24

package/dist/hooks/useChartStore.d.ts

@@ -1,4 +1,4 @@
-import type { ScaleConfig, SeriesConfig, BBox, ChartData } from '../types';
+import type { ScaleConfig, ResolvedSeriesConfig, BBox, ChartData } from '../types';
 import type { ActionKey, ReactionValue } from '../types/interaction';
 import type { AxisConfig, AxisState } from '../types/axes';
 import type { SelectState } from '../types/cursor';
@@ -7,6 +7,7 @@ import { DataStore } from '../core/DataStore';
 import { CursorManager } from '../core/CursorManager';
 import { RenderScheduler } from '../core/RenderScheduler';
 import { CanvasRenderer } from '../rendering/CanvasRenderer';
+import type { ResolvedTheme } from '../rendering/theme';
 import type { BandConfig } from '../types/bands';
 import { Side } from '../types/common';
 import type { DrawCallback, CursorDrawCallback } from '../types/hooks';
@@ -43,7 +44,7 @@ export interface ChartStore {
     cursorManager: CursorManager;
     selectState: SelectState;
     scaleConfigs: ScaleConfig[];
-    seriesConfigs: SeriesConfig[];
+    seriesConfigs: ResolvedSeriesConfig[];
     axisConfigs: AxisConfig[];
     bandConfigs: BandConfig[];
     axisStates: AxisState[];
@@ -70,17 +71,23 @@ export interface ChartStore {
     xlabel: string | undefined;
     /** Y-axis label for default axis */
     ylabel: string | undefined;
+    /** BCP 47 locale for number/date formatting */
+    locale: string | undefined;
+    /** IANA timezone for time axis labels */
+    timezone: string | undefined;
     snapshot: ChartSnapshot;
     revision: number;
     eventCallbacks: EventCallbacks;
+    theme: ResolvedTheme;
     _prevScaleRanges: Map<string, {
         min: number;
         max: number;
     }>;
     _prevPlotBox: BBox | null;
+    _prevThemeKey: string;
     registerScale: (cfg: ScaleConfig) => void;
     unregisterScale: (id: string) => void;
-    registerSeries: (cfg: SeriesConfig) => void;
+    registerSeries: (cfg: ResolvedSeriesConfig) => void;
     unregisterSeries: (group: number, index: number) => void;
     toggleSeries: (group: number, index: number) => void;
     setFocus: (seriesIdx: number | null) => void;
@@ -90,7 +97,7 @@ export interface ChartStore {
     subscribe: (fn: () => void) => () => void;
     subscribeCursor: (fn: () => void) => () => void;
     /** Pre-built lookup map for series config by "group:index" key */
-    seriesConfigMap: Map<string, SeriesConfig>;
+    seriesConfigMap: Map<string, ResolvedSeriesConfig>;
     redraw: () => void;
     /** Stable snapshot getter for useSyncExternalStore (no useCallback needed) */
     getSnapshot: () => ChartSnapshot;
@@ -99,7 +106,7 @@ export interface ChartStore {
     /** Update a scale config in-place (replaces scaleConfigs entry + syncs manager + clears cache) */
     updateScale: (cfg: ScaleConfig) => void;
     /** Update a series config in-place (replaces seriesConfigs entry + rebuilds map + invalidates render) */
-    updateSeries: (cfg: SeriesConfig) => void;
+    updateSeries: (cfg: ResolvedSeriesConfig) => void;
     /** Register an axis config (deduplicates by scale+side) */
     registerAxis: (cfg: AxisConfig) => void;
     /** Unregister an axis config by scale+side */
@@ -114,8 +121,8 @@ export interface ChartStore {
     setData: (data: ChartData) => void;
     /** Set the canvas element */
     setCanvas: (node: HTMLCanvasElement | null) => void;
-    /** Set title and axis labels */
-    setLabels: (title?: string, xlabel?: string, ylabel?: string) => void;
+    /** Set title, axis labels, locale, and timezone */
+    setLabels: (title?: string, xlabel?: string, ylabel?: string, locale?: string, timezone?: string) => void;
 }
 /**
  * Creates a mutable ChartStore. Called once per Chart component instance.

package/dist/hooks/useChartStore.d.ts.map

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

package/dist/hooks/useDraggableOverlay.d.ts

@@ -0,0 +1,84 @@
+import type React from 'react';
+import type { CornerPosition, OverlayPosition, OverlayOffset } from '../types/common';
+export type { CornerPosition };
+export interface UseDraggableOverlayOptions {
+    mode: 'cursor' | 'draggable';
+    show: boolean;
+    position: OverlayPosition;
+    offset: OverlayOffset;
+    idleOpacity: number;
+    estimatedSize: {
+        w: number;
+        h: number;
+    };
+}
+export interface DraggableOverlayResult {
+    panelRef: React.RefObject<HTMLDivElement>;
+    /** Computed position to render at. null = not ready or hidden. */
+    renderPos: {
+        x: number;
+        y: number;
+    } | null;
+    isDragging: boolean;
+    hovered: boolean;
+    /** Mutable ref — true if a drag occurred since last mousedown. Use to suppress click actions. */
+    didDrag: React.MutableRefObject<boolean>;
+    /** Mode-appropriate CSS for the Panel container. */
+    panelStyle: React.CSSProperties;
+    /** Handlers to spread onto the Panel. No-ops in cursor mode. */
+    panelHandlers: {
+        onMouseDown?: React.MouseEventHandler;
+        onMouseEnter?: React.MouseEventHandler;
+        onMouseLeave?: React.MouseEventHandler;
+    };
+}
+/** Padding from plot edges for corner-anchored positions */
+export declare const CORNER_PAD = 8;
+/**
+ * Resolve initial position for draggable mode.
+ * When panelW/panelH are available (after first render), positions are exact.
+ * On first render (panelW/panelH = 0), top-left is always correct;
+ * other corners get corrected by the layout effect.
+ */
+export declare function resolveInitialPos(position: {
+    x: number;
+    y: number;
+} | CornerPosition | undefined, plotBox: {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}, panelW: number, panelH: number): {
+    x: number;
+    y: number;
+};
+/**
+ * Compute cursor-mode position: cursor coords + offset, clamped to plot bounds.
+ * Returns null when cursor is off-chart.
+ */
+export declare function computeCursorPos(cursorLeft: number, cursorTop: number, plotLeft: number, plotTop: number, plotWidth: number, plotHeight: number, offsetX: number, offsetY: number, panelW: number, panelH: number): {
+    x: number;
+    y: number;
+} | null;
+/**
+ * Clamp a position to stay within plot bounds given panel dimensions.
+ * Returns the original position if already in bounds.
+ */
+export declare function clampToBounds(pos: {
+    x: number;
+    y: number;
+}, plotLeft: number, plotTop: number, plotWidth: number, plotHeight: number, panelW: number, panelH: number): {
+    x: number;
+    y: number;
+};
+/**
+ * Shared overlay positioning hook for cursor-follow and draggable modes.
+ *
+ * Owns: position state, drag event handlers, bounds-sync effects,
+ * cursor-mode measurement, initialization, idle opacity styling.
+ *
+ * Callers provide content-dependent `estimatedSize` (via estimatePanelSize)
+ * and handle their own content rendering.
+ */
+export declare function useDraggableOverlay({ mode, show, position, offset, idleOpacity, estimatedSize, }: UseDraggableOverlayOptions): DraggableOverlayResult;
+//# sourceMappingURL=useDraggableOverlay.d.ts.map

package/dist/hooks/useDraggableOverlay.d.ts.map

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

package/dist/hooks/useInteraction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useInteraction.d.ts","sourceRoot":"","sources":["../../src/hooks/useInteraction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AA2ZlD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,cAAc,GAAG,IAAI,GACjC,IAAI,CAKN;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,GAAG,MAAM,IAAI,CAugB/E"}
+{"version":3,"file":"useInteraction.d.ts","sourceRoot":"","sources":["../../src/hooks/useInteraction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AA+ZlD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,cAAc,GAAG,IAAI,GACjC,IAAI,CAKN;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,GAAG,MAAM,IAAI,CAghB/E"}