uplot-plus 0.3.2 → 0.4.0

package/dist/src/types/interaction.d.ts

@@ -0,0 +1,62 @@
+import type { ChartStore } from '../hooks/useChartStore';
+import type { Orientation } from './common';
+/**
+ * Context computed by the interaction hook, passed to action matchers and reaction handlers.
+ */
+export interface ActionContext {
+    /** Plot-relative x coordinate (CSS px from plot left edge) */
+    cx: number;
+    /** Plot-relative y coordinate (CSS px from plot top edge) */
+    cy: number;
+    /** Whether (cx, cy) is inside the plot area */
+    inPlot: boolean;
+    /** For gutter hits: the scale ID that was hit */
+    scaleId?: string;
+    /** For gutter hits: the axis orientation */
+    ori?: Orientation;
+    /** The classified action string (e.g. 'leftClick', 'shiftLeftDrag'). Set by the hook before dispatch. */
+    action?: string;
+}
+/**
+ * Continuation for multi-event gestures (drag, pan, gutter drag).
+ * Returned by reaction handlers that need to track mousemove/mouseup.
+ */
+export interface DragContinuation {
+    onMove: (store: ChartStore, e: Event, ctx: ActionContext) => void;
+    onEnd: (store: ChartStore, e: Event, ctx: ActionContext) => void;
+}
+/**
+ * Action key: a built-in string name or a custom matcher function.
+ *
+ * Built-in strings follow the pattern `{modifier?}{Button}{Type}`:
+ * - Drag:     left/middle/rightDrag, shift/alt/ctrlLeft/Middle/RightDrag
+ * - Click:    left/middle/rightClick, shift/alt/ctrlLeft/Middle/RightClick
+ * - Dblclick: leftDblclick, shift/alt/ctrlLeftDblclick
+ * - Gutter:   xGutterDrag, yGutterDrag
+ * - Wheel:    wheel, shiftWheel, altWheel, ctrlWheel
+ * - Hover:    hover (fired on cursor position change, not when stationary)
+ * - Touch:    touchDrag, pinch
+ * - Keyboard: key{Key}, shift/alt/ctrlKey{Key} — e.g. shiftKeyX, ctrlKeyS, keyEscape
+ */
+export type ActionKey = string | ((e: Event, ctx: ActionContext) => boolean);
+/**
+ * Reaction value: a built-in string name or a custom handler function.
+ *
+ * Built-in reaction strings: 'zoomX', 'zoomY', 'zoomXY', 'panX', 'panY', 'panXY', 'reset', 'none'
+ *
+ * Custom handlers return a DragContinuation for multi-event gestures, or void for one-shot.
+ */
+export type ReactionValue = string | ((store: ChartStore, e: Event, ctx: ActionContext) => DragContinuation | void);
+/** A single action→reaction binding. */
+export type ActionEntry = [ActionKey, ReactionValue];
+/** User-facing actions list: array of [action, reaction] tuples (merged with defaults). */
+export type ActionList = ActionEntry[];
+/**
+ * Focus reaction factory: dims non-nearest series to the given alpha.
+ * Use as a reaction for the 'hover' action:
+ *   `actions={[['hover', focus(0.15)]]}`
+ */
+export declare function focus(alpha?: number): ReactionValue;
+/** Default actions — standard charting interactions out of the box. */
+export declare const DEFAULT_ACTIONS: ActionList;
+//# sourceMappingURL=interaction.d.ts.map

package/dist/src/types/interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../../src/types/interaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,MAAM,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,yGAAyG;IACzG,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IAClE,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;CAClE;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC;AAE7E;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,KAAK,gBAAgB,GAAG,IAAI,CAAC,CAAC;AAEnF,wCAAwC;AACxC,MAAM,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAErD,2FAA2F;AAC3F,MAAM,MAAM,UAAU,GAAG,WAAW,EAAE,CAAC;AAEvC;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,SAAO,GAAG,aAAa,CAIjD;AAED,uEAAuE;AACvE,eAAO,MAAM,eAAe,EAAE,UAQ7B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uplot-plus",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "High-performance React charting library with multi-x-axis support",
   "type": "module",
   "main": "dist/index.cjs",
@@ -32,8 +32,7 @@
     "lint": "eslint src/ demo/",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
-    "build:demo": "vite build demo",
-    "bench": "vite serve bench --config bench/vite.config.ts"
+    "build:demo": "vite build demo"
   },
   "peerDependencies": {
     "react": ">=18.0.0",

package/dist/src/paths/candlestick.d.ts

@@ -1,35 +0,0 @@
-import type { DrawCallback } from '../types/hooks';
-import type { ScaleState } from '../types';
-export interface CandlestickOpts {
-    /** X values array */
-    xValues: ArrayLike<number>;
-    /** Open values array */
-    open: ArrayLike<number | null>;
-    /** High values array */
-    high: ArrayLike<number | null>;
-    /** Low values array */
-    low: ArrayLike<number | null>;
-    /** Close values array */
-    close: ArrayLike<number | null>;
-    /** X scale state — must have min/max set */
-    xScale: ScaleState;
-    /** Y scale state — must have min/max set */
-    yScale: ScaleState;
-    /** Color for up candles (close >= open) */
-    upColor?: string;
-    /** Color for down candles (close < open) */
-    downColor?: string;
-    /** Body width as fraction of available space (default 0.6) */
-    bodyWidth?: number;
-    /** Wick width in CSS pixels (default 1) */
-    wickWidth?: number;
-}
-/**
- * Creates a DrawCallback that renders candlestick (OHLC) candles.
- * Use with the Chart's `onDraw` prop or `useDrawHook`.
- *
- * The caller must provide the data arrays and scale states directly
- * since DrawCallback only receives { ctx, plotBox, pxRatio }.
- */
-export declare function drawCandlesticks(opts: CandlestickOpts): DrawCallback;
-//# sourceMappingURL=candlestick.d.ts.map

package/dist/src/paths/candlestick.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"candlestick.d.ts","sourceRoot":"","sources":["../../../src/paths/candlestick.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3B,wBAAwB;IACxB,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/B,wBAAwB;IACxB,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/B,uBAAuB;IACvB,GAAG,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9B,yBAAyB;IACzB,KAAK,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAChC,4CAA4C;IAC5C,MAAM,EAAE,UAAU,CAAC;IACnB,4CAA4C;IAC5C,MAAM,EAAE,UAAU,CAAC;IACnB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,YAAY,CAyDpE"}