react-klinecharts-ui 0.1.0 → 0.3.0

package/dist/index.js

@@ -1,7 +1,7 @@
-import { registerExtensions } from './chunk-PUULIBFN.js';
-export { abcd_default as abcd, anyWaves_default as anyWaves, arrow_default as arrow, circle_default as circle, eightWaves_default as eightWaves, fibonacciCircle_default as fibonacciCircle, fibonacciExtension_default as fibonacciExtension, fibonacciSegment_default as fibonacciSegment, fibonacciSpeedResistanceFan_default as fibonacciSpeedResistanceFan, fibonacciSpiral_default as fibonacciSpiral, fiveWaves_default as fiveWaves, gannBox_default as gannBox, orderLine_default as orderLine, overlays, parallelogram_default as parallelogram, rect_default as rect, registerExtensions, threeWaves_default as threeWaves, triangle_default as triangle, xabcd_default as xabcd } from './chunk-PUULIBFN.js';
+import { registerExtensions, TA_default } from './chunk-U325AHHX.js';
+export { TA_default as TA, abcd_default as abcd, anyWaves_default as anyWaves, arrow_default as arrow, bollTv_default as bollTv, brush_default as brush, cci_default as cci, circle_default as circle, depthOverlay_default as depthOverlay, eightWaves_default as eightWaves, elliottWave_default as elliottWave, fibRetracement_default as fibRetracement, fibonacciCircle_default as fibonacciCircle, fibonacciExtension_default as fibonacciExtension, fibonacciSegment_default as fibonacciSegment, fibonacciSpeedResistanceFan_default as fibonacciSpeedResistanceFan, fibonacciSpiral_default as fibonacciSpiral, fiveWaves_default as fiveWaves, gannBox_default as gannBox, gannFan_default as gannFan, hma_default as hma, ichimoku_default as ichimoku, indicators, longPosition_default as longPosition, maRibbon_default as maRibbon, macdTv_default as macdTv, measure_default as measure, orderLine_default as orderLine, overlays, parallelChannel_default as parallelChannel, parallelogram_default as parallelogram, pivotPoints_default as pivotPoints, ray_default as ray, rect_default as rect, registerExtensions, rsiTv_default as rsiTv, shortPosition_default as shortPosition, stochastic_default as stochastic, superTrend_default as superTrend, threeWaves_default as threeWaves, triangle_default as triangle, vwap_default as vwap, xabcd_default as xabcd } from './chunk-U325AHHX.js';
 import { createContext, useContext, useReducer, useRef, useCallback, useEffect, useMemo, useState } from 'react';
-import { registerOverlay } from 'react-klinecharts';
+import { registerOverlay, registerIndicator } from 'react-klinecharts';
 import { jsx } from 'react/jsx-runtime';
 
 var KlinechartsUIStateContext = createContext(null);
@@ -124,6 +124,7 @@ function KlinechartsUIProvider({
     })
   );
   const fullscreenContainerRef = useRef(null);
+  const undoRedoListenerRef = useRef(null);
   const stateRef = useRef(state);
   stateRef.current = state;
   const callbacksRef = useRef({
@@ -189,7 +190,8 @@ function KlinechartsUIProvider({
       dispatch: enhancedDispatch,
       datafeed,
       onSettingsChange,
-      fullscreenContainerRef
+      fullscreenContainerRef,
+      undoRedoListenerRef
     }),
     [enhancedDispatch, datafeed, onSettingsChange]
   );
@@ -357,7 +359,14 @@ var MAIN_INDICATORS = [
   "SMA",
   "BOLL",
   "SAR",
-  "BBI"
+  "BBI",
+  "BOLL_TV",
+  "Ichimoku",
+  "SuperTrend",
+  "HMA",
+  "VWAP",
+  "PivotPoints",
+  "MA_Ribbon"
 ];
 var SUB_INDICATORS = [
   "MA",
@@ -385,7 +394,11 @@ var SUB_INDICATORS = [
   "ROC",
   "PVT",
   "BBI",
-  "AO"
+  "AO",
+  "MACD_TV",
+  "RSI_TV",
+  "CCI_TV",
+  "Stochastic"
 ];
 var INDICATOR_PARAMS = {
   SMA: {
@@ -544,12 +557,98 @@ var INDICATOR_PARAMS = {
       { label: "params_1", defaultValue: 5 },
       { label: "params_2", defaultValue: 34 }
     ]
+  },
+  BOLL_TV: {
+    name: "BOLL_TV",
+    localeKey: "boll_tv",
+    params: [
+      { label: "period", defaultValue: 20 },
+      { label: "multiplier", defaultValue: 2 }
+    ]
+  },
+  Ichimoku: {
+    name: "Ichimoku",
+    localeKey: "ichimoku",
+    params: [
+      { label: "tenkan", defaultValue: 9 },
+      { label: "kijun", defaultValue: 26 },
+      { label: "senkou_b", defaultValue: 52 },
+      { label: "offset", defaultValue: 26 }
+    ]
+  },
+  SuperTrend: {
+    name: "SuperTrend",
+    localeKey: "super_trend",
+    params: [
+      { label: "period", defaultValue: 10 },
+      { label: "factor", defaultValue: 3 }
+    ]
+  },
+  HMA: {
+    name: "HMA",
+    localeKey: "hma",
+    params: [{ label: "period", defaultValue: 9 }]
+  },
+  VWAP: {
+    name: "VWAP",
+    localeKey: "vwap",
+    params: []
+  },
+  PivotPoints: {
+    name: "PivotPoints",
+    localeKey: "pivot_points",
+    params: []
+  },
+  MA_Ribbon: {
+    name: "MA_Ribbon",
+    localeKey: "ma_ribbon",
+    params: [
+      { label: "period_1", defaultValue: 10 },
+      { label: "period_2", defaultValue: 20 },
+      { label: "period_3", defaultValue: 30 },
+      { label: "period_4", defaultValue: 40 }
+    ]
+  },
+  MACD_TV: {
+    name: "MACD_TV",
+    localeKey: "macd_tv",
+    params: [
+      { label: "fast", defaultValue: 12 },
+      { label: "slow", defaultValue: 26 },
+      { label: "signal", defaultValue: 9 }
+    ]
+  },
+  RSI_TV: {
+    name: "RSI_TV",
+    localeKey: "rsi_tv",
+    params: [
+      { label: "rsi_period", defaultValue: 14 },
+      { label: "ma_period", defaultValue: 14 }
+    ]
+  },
+  CCI_TV: {
+    name: "CCI_TV",
+    localeKey: "cci_tv",
+    params: [{ label: "period", defaultValue: 20 }]
+  },
+  Stochastic: {
+    name: "Stochastic",
+    localeKey: "stochastic",
+    params: [
+      { label: "period", defaultValue: 14 },
+      { label: "smooth_k", defaultValue: 3 },
+      { label: "smooth_d", defaultValue: 3 }
+    ]
   }
 };
 
 // src/hooks/useIndicators.ts
+var COLLAPSED_HEIGHT = 30;
 function useIndicators() {
   const { state, dispatch } = useKlinechartsUI();
+  const { undoRedoListenerRef } = useKlinechartsUIDispatch();
+  const paneHeightsRef = useRef({});
+  const collapsedPanesRef = useRef(/* @__PURE__ */ new Set());
   const mainIndicators = useMemo(() => {
     const activeNames = state.mainIndicators;
     const inactive = MAIN_INDICATORS.filter((n) => !activeNames.includes(n));
@@ -576,16 +675,24 @@ function useIndicators() {
       );
       const newIndicators = [...state.mainIndicators, name];
       dispatch({ type: "SET_MAIN_INDICATORS", indicators: newIndicators });
+      undoRedoListenerRef.current?.({
+        type: "indicator_toggled",
+        data: { name, wasActive: false, isMain: true, paneId: "candle_pane" }
+      });
     },
-    [state.chart, state.mainIndicators, dispatch]
+    [state.chart, state.mainIndicators, dispatch, undoRedoListenerRef]
   );
   const removeMainIndicator = useCallback(
     (name) => {
       state.chart?.removeIndicator({ id: `main_${name}` });
       const newIndicators = state.mainIndicators.filter((n) => n !== name);
       dispatch({ type: "SET_MAIN_INDICATORS", indicators: newIndicators });
+      undoRedoListenerRef.current?.({
+        type: "indicator_toggled",
+        data: { name, wasActive: true, isMain: true, paneId: "candle_pane" }
+      });
     },
-    [state.chart, state.mainIndicators, dispatch]
+    [state.chart, state.mainIndicators, dispatch, undoRedoListenerRef]
   );
   const addSubIndicator = useCallback(
     (name) => {
@@ -595,17 +702,26 @@ function useIndicators() {
       const paneId = state.chart?.getIndicators({ id })?.[0]?.paneId ?? "";
       const newIndicators = { ...state.subIndicators, [name]: paneId };
       dispatch({ type: "SET_SUB_INDICATORS", indicators: newIndicators });
+      undoRedoListenerRef.current?.({
+        type: "indicator_toggled",
+        data: { name, wasActive: false, isMain: false, paneId }
+      });
     },
-    [state.chart, state.subIndicators, dispatch]
+    [state.chart, state.subIndicators, dispatch, undoRedoListenerRef]
   );
   const removeSubIndicator = useCallback(
     (name) => {
+      const paneId = state.subIndicators[name] ?? "";
       state.chart?.removeIndicator({ id: `sub_${name}` });
       const newIndicators = { ...state.subIndicators };
       delete newIndicators[name];
       dispatch({ type: "SET_SUB_INDICATORS", indicators: newIndicators });
+      undoRedoListenerRef.current?.({
+        type: "indicator_toggled",
+        data: { name, wasActive: true, isMain: false, paneId }
+      });
     },
-    [state.chart, state.subIndicators, dispatch]
+    [state.chart, state.subIndicators, dispatch, undoRedoListenerRef]
   );
   const toggleMainIndicator = useCallback(
     (name) => {
@@ -651,9 +767,15 @@ function useIndicators() {
   const moveToMain = useCallback(
     (name) => {
       if (!state.chart) return;
+      const prevCalcParams = state.chart.getIndicators({ id: `sub_${name}` })?.[0]?.calcParams;
       state.chart.removeIndicator({ id: `sub_${name}` });
       state.chart.createIndicator(
-        { name, id: `main_${name}`, paneId: "candle_pane" },
+        {
+          name,
+          id: `main_${name}`,
+          paneId: "candle_pane",
+          ...prevCalcParams ? { calcParams: prevCalcParams } : {}
+        },
         true,
         { id: "candle_pane" }
       );
@@ -670,9 +792,14 @@ function useIndicators() {
   const moveToSub = useCallback(
     (name) => {
       if (!state.chart) return;
+      const prevCalcParams = state.chart.getIndicators({ id: `main_${name}` })?.[0]?.calcParams;
       state.chart.removeIndicator({ id: `main_${name}` });
       const subId = `sub_${name}`;
-      state.chart.createIndicator({ name, id: subId });
+      state.chart.createIndicator({
+        name,
+        id: subId,
+        ...prevCalcParams ? { calcParams: prevCalcParams } : {}
+      });
       const paneId = state.chart.getIndicators({ id: subId })?.[0]?.paneId ?? "";
       const newMain = state.mainIndicators.filter((n) => n !== name);
       dispatch({ type: "SET_MAIN_INDICATORS", indicators: newMain });
@@ -691,6 +818,90 @@ function useIndicators() {
     (name) => name in state.subIndicators,
     [state.subIndicators]
   );
+  const collapseSubIndicator = useCallback(
+    (name) => {
+      const paneId = state.subIndicators[name];
+      if (!state.chart || !paneId) return;
+      const currentSize = state.chart.getSize?.(paneId);
+      if (currentSize?.height && currentSize.height > COLLAPSED_HEIGHT) {
+        paneHeightsRef.current[paneId] = currentSize.height;
+      }
+      collapsedPanesRef.current.add(paneId);
+      state.chart.setPaneOptions?.({
+        id: paneId,
+        height: COLLAPSED_HEIGHT
+      });
+      state.chart.overrideIndicator({ name, id: `sub_${name}`, visible: false });
+    },
+    [state.chart, state.subIndicators]
+  );
+  const expandSubIndicator = useCallback(
+    (name) => {
+      const paneId = state.subIndicators[name];
+      if (!state.chart || !paneId) return;
+      const savedHeight = paneHeightsRef.current[paneId] ?? 100;
+      collapsedPanesRef.current.delete(paneId);
+      state.chart.setPaneOptions?.({
+        id: paneId,
+        height: savedHeight
+      });
+      state.chart.overrideIndicator({ name, id: `sub_${name}`, visible: true });
+    },
+    [state.chart, state.subIndicators]
+  );
+  const isSubIndicatorCollapsed = useCallback(
+    (name) => {
+      const paneId = state.subIndicators[name];
+      return paneId ? collapsedPanesRef.current.has(paneId) : false;
+    },
+    [state.subIndicators]
+  );
+  const reorderSubIndicator = useCallback(
+    (name, direction) => {
+      if (!state.chart) return;
+      const subNames = Object.keys(state.subIndicators);
+      const idx = subNames.indexOf(name);
+      if (idx === -1) return;
+      const swapIdx = direction === "up" ? idx - 1 : idx + 1;
+      if (swapIdx < 0 || swapIdx >= subNames.length) return;
+      const subStates = subNames.map((n) => {
+        const id = `sub_${n}`;
+        const indicator = state.chart.getIndicators({ id })?.[0];
+        return {
+          name: n,
+          calcParams: indicator?.calcParams,
+          visible: indicator?.visible ?? true,
+          styles: indicator?.styles,
+          paneId: state.subIndicators[n]
+        };
+      });
+      [subStates[idx], subStates[swapIdx]] = [subStates[swapIdx], subStates[idx]];
+      for (const n of subNames) {
+        state.chart.removeIndicator({ id: `sub_${n}` });
+      }
+      const newSubIndicators = {};
+      for (const sub of subStates) {
+        const id = `sub_${sub.name}`;
+        state.chart.createIndicator({
+          name: sub.name,
+          id,
+          ...sub.calcParams ? { calcParams: sub.calcParams } : {},
+          visible: sub.visible
+        });
+        const paneId = state.chart.getIndicators({ id })?.[0]?.paneId ?? "";
+        newSubIndicators[sub.name] = paneId;
+        if (sub.styles) {
+          state.chart.overrideIndicator({
+            name: sub.name,
+            paneId,
+            styles: sub.styles
+          });
+        }
+      }
+      dispatch({ type: "SET_SUB_INDICATORS", indicators: newSubIndicators });
+    },
+    [state.chart, state.subIndicators, dispatch]
+  );
   return {
     mainIndicators,
     subIndicators,
@@ -710,7 +921,11 @@ function useIndicators() {
     updateIndicatorParams,
     getIndicatorParams,
     isMainIndicatorActive,
-    isSubIndicatorActive
+    isSubIndicatorActive,
+    collapseSubIndicator,
+    expandSubIndicator,
+    isSubIndicatorCollapsed,
+    reorderSubIndicator
   };
 }
 
@@ -736,7 +951,9 @@ var DRAWING_CATEGORIES = [
     key: "moreLine",
     tools: [
       { name: "priceChannelLine", localeKey: "price_channel_line" },
-      { name: "parallelStraightLine", localeKey: "parallel_straight_line" }
+      { name: "parallelStraightLine", localeKey: "parallel_straight_line" },
+      { name: "ray", localeKey: "ray" },
+      { name: "parallelChannel", localeKey: "parallel_channel" }
     ]
   },
   {
@@ -760,7 +977,9 @@ var DRAWING_CATEGORIES = [
         localeKey: "fibonacci_speed_resistance_fan"
       },
       { name: "fibonacciExtension", localeKey: "fibonacci_extension" },
-      { name: "gannBox", localeKey: "gann_box" }
+      { name: "fibRetracement", localeKey: "fib_retracement" },
+      { name: "gannBox", localeKey: "gann_box" },
+      { name: "gannFan", localeKey: "gann_fan" }
     ]
   },
   {
@@ -771,7 +990,27 @@ var DRAWING_CATEGORIES = [
       { name: "threeWaves", localeKey: "three_waves" },
       { name: "fiveWaves", localeKey: "five_waves" },
       { name: "eightWaves", localeKey: "eight_waves" },
-      { name: "anyWaves", localeKey: "any_waves" }
+      { name: "anyWaves", localeKey: "any_waves" },
+      { name: "elliottWave", localeKey: "elliott_wave" }
+    ]
+  },
+  {
+    key: "measure",
+    tools: [
+      { name: "measure", localeKey: "measure" }
+    ]
+  },
+  {
+    key: "position",
+    tools: [
+      { name: "longPosition", localeKey: "long_position" },
+      { name: "shortPosition", localeKey: "short_position" }
+    ]
+  },
+  {
+    key: "annotation",
+    tools: [
+      { name: "brush", localeKey: "brush" }
     ]
   }
 ];
@@ -780,10 +1019,22 @@ var DRAWING_CATEGORIES = [
 var DRAWING_GROUP_ID = "drawing_tools";
 function useDrawingTools() {
   const { state } = useKlinechartsUI();
+  const { undoRedoListenerRef } = useKlinechartsUIDispatch();
   const [activeTool, setActiveTool] = useState(null);
   const [magnetMode, setMagnetModeState] = useState("normal");
   const [isLocked, setIsLocked] = useState(false);
   const [isVisible, setIsVisible] = useState(true);
+  const [autoRetrigger, setAutoRetrigger] = useState(true);
+  const activeToolRef = useRef(activeTool);
+  activeToolRef.current = activeTool;
+  const autoRetriggerRef = useRef(autoRetrigger);
+  autoRetriggerRef.current = autoRetrigger;
+  const isLockedRef = useRef(isLocked);
+  isLockedRef.current = isLocked;
+  const isVisibleRef = useRef(isVisible);
+  isVisibleRef.current = isVisible;
+  const magnetModeRef = useRef(magnetMode);
+  magnetModeRef.current = magnetMode;
   const categories = useMemo(
     () => DRAWING_CATEGORIES.map((cat) => ({
       key: cat.key,
@@ -794,18 +1045,45 @@ function useDrawingTools() {
     })),
     []
   );
-  const selectTool = useCallback(
+  const createOverlayForTool = useCallback(
     (name) => {
-      setActiveTool(name);
+      const mode = magnetModeRef.current === "strong" ? "strong_magnet" : magnetModeRef.current === "weak" ? "weak_magnet" : "normal";
       state.chart?.createOverlay({
         name,
         groupId: DRAWING_GROUP_ID,
-        lock: isLocked,
-        visible: isVisible,
-        mode: magnetMode === "strong" ? "strong_magnet" : magnetMode === "weak" ? "weak_magnet" : "normal"
+        lock: isLockedRef.current,
+        visible: isVisibleRef.current,
+        mode,
+        onDrawEnd: (event) => {
+          const o = event.overlay;
+          undoRedoListenerRef.current?.({
+            type: "overlay_added",
+            data: {
+              id: o.id,
+              overlayData: {
+                name: o.name,
+                points: o.points,
+                styles: o.styles,
+                extendData: o.extendData
+              }
+            }
+          });
+          if (autoRetriggerRef.current && activeToolRef.current === name) {
+            requestAnimationFrame(() => {
+              createOverlayForTool(name);
+            });
+          }
+        }
       });
     },
-    [state.chart, isLocked, isVisible, magnetMode]
+    [state.chart, undoRedoListenerRef]
+  );
+  const selectTool = useCallback(
+    (name) => {
+      setActiveTool(name);
+      createOverlayForTool(name);
+    },
+    [createOverlayForTool]
   );
   const clearActiveTool = useCallback(() => {
     setActiveTool(null);
@@ -853,21 +1131,37 @@ function useDrawingTools() {
     }
   }, [state.chart, isVisible]);
   const removeAllDrawings = useCallback(() => {
+    const overlays2 = state.chart?.getOverlays({ groupId: DRAWING_GROUP_ID });
+    if (overlays2 && overlays2.length > 0) {
+      const snapshot = overlays2.map((o) => ({
+        name: o.name,
+        id: o.id,
+        points: o.points,
+        styles: o.styles,
+        extendData: o.extendData
+      }));
+      undoRedoListenerRef.current?.({
+        type: "overlays_removed",
+        data: { overlays: snapshot }
+      });
+    }
     state.chart?.removeOverlay({ groupId: DRAWING_GROUP_ID });
     setActiveTool(null);
-  }, [state.chart]);
+  }, [state.chart, undoRedoListenerRef]);
   return {
     categories,
     activeTool,
     magnetMode,
     isLocked,
     isVisible,
+    autoRetrigger,
     selectTool,
     clearActiveTool,
     setMagnetMode,
     toggleLock,
     toggleVisibility,
-    removeAllDrawings
+    removeAllDrawings,
+    setAutoRetrigger
   };
 }
 
@@ -1259,12 +1553,12 @@ function useOrderLines() {
       if (onPriceChange) {
         callbacksRef.current.set(id, onPriceChange);
       }
-      const dataCount = state.chart.getDataList().length;
-      const anchorIndex = dataCount > 0 ? dataCount - 1 : 0;
+      const dataList = state.chart.getDataList();
+      const anchorTimestamp = dataList.length > 0 ? dataList[dataList.length - 1].timestamp : Date.now();
       state.chart.createOverlay({
         name: "orderLine",
         id,
-        points: [{ dataIndex: anchorIndex, value: price }],
+        points: [{ timestamp: anchorTimestamp, value: price }],
         extendData,
         lock: !draggable,
         mode: "normal",
@@ -1288,11 +1582,11 @@ function useOrderLines() {
       if (onPriceChange !== void 0) {
         callbacksRef.current.set(id, onPriceChange);
       }
-      const dataCount = state.chart.getDataList().length;
-      const anchorIndex = dataCount > 0 ? dataCount - 1 : 0;
+      const dataList = state.chart.getDataList();
+      const anchorTimestamp = dataList.length > 0 ? dataList[dataList.length - 1].timestamp : Date.now();
       state.chart.overrideOverlay({
         id,
-        ...price != null ? { points: [{ dataIndex: anchorIndex, value: price }] } : {},
+        ...price != null ? { points: [{ timestamp: anchorTimestamp, value: price }] } : {},
         ...draggable != null ? { lock: !draggable } : {},
         extendData: {
           ...existing.extendData,
@@ -1320,6 +1614,1496 @@ function useOrderLines() {
     removeAllOrderLines
   };
 }
+var DRAWING_GROUP_ID2 = "drawing_tools";
+function useUndoRedo() {
+  const { state, dispatch } = useKlinechartsUI();
+  const { undoRedoListenerRef } = useKlinechartsUIDispatch();
+  const [undoStack, setUndoStack] = useState([]);
+  const [redoStack, setRedoStack] = useState([]);
+  const isProcessingRef = useRef(false);
+  const canUndo = undoStack.length > 0;
+  const canRedo = redoStack.length > 0;
+  const pushAction = useCallback((action) => {
+    if (isProcessingRef.current) return;
+    setUndoStack((prev) => [...prev, action]);
+    setRedoStack([]);
+  }, []);
+  useEffect(() => {
+    undoRedoListenerRef.current = pushAction;
+    return () => {
+      undoRedoListenerRef.current = null;
+    };
+  }, [pushAction, undoRedoListenerRef]);
+  const clear = useCallback(() => {
+    setUndoStack([]);
+    setRedoStack([]);
+  }, []);
+  const undo = useCallback(() => {
+    if (undoStack.length === 0 || !state.chart || isProcessingRef.current)
+      return;
+    isProcessingRef.current = true;
+    const action = undoStack[undoStack.length - 1];
+    setUndoStack((prev) => prev.slice(0, -1));
+    try {
+      switch (action.type) {
+        case "overlay_added": {
+          const { id, overlayData } = action.data;
+          state.chart.removeOverlay({ id });
+          setRedoStack((prev) => [
+            ...prev,
+            {
+              type: "overlay_added",
+              data: { id, overlayData }
+            }
+          ]);
+          break;
+        }
+        case "overlays_removed": {
+          const { overlays: overlays2 } = action.data;
+          const restoredIds = [];
+          for (const overlay of overlays2) {
+            const newId = state.chart.createOverlay({
+              ...overlay,
+              groupId: DRAWING_GROUP_ID2
+            });
+            if (typeof newId === "string") {
+              restoredIds.push(newId);
+            }
+          }
+          setRedoStack((prev) => [
+            ...prev,
+            {
+              type: "overlays_removed",
+              data: {
+                overlays: overlays2.map((o, i) => ({
+                  ...o,
+                  id: restoredIds[i]
+                }))
+              }
+            }
+          ]);
+          break;
+        }
+        case "indicator_toggled": {
+          const { name, wasActive, isMain, paneId } = action.data;
+          if (wasActive) {
+            if (isMain) {
+              state.chart.createIndicator(
+                { name, id: `main_${name}`, paneId: "candle_pane" },
+                true,
+                { id: "candle_pane" }
+              );
+              dispatch({
+                type: "SET_MAIN_INDICATORS",
+                indicators: [...state.mainIndicators, name]
+              });
+            } else {
+              state.chart.createIndicator({ name, id: `sub_${name}` });
+              const newPaneId = state.chart.getIndicators({ id: `sub_${name}` })?.[0]?.paneId ?? "";
+              dispatch({
+                type: "SET_SUB_INDICATORS",
+                indicators: {
+                  ...state.subIndicators,
+                  [name]: newPaneId
+                }
+              });
+            }
+          } else {
+            if (isMain) {
+              state.chart.removeIndicator({ id: `main_${name}` });
+              dispatch({
+                type: "SET_MAIN_INDICATORS",
+                indicators: state.mainIndicators.filter(
+                  (n) => n !== name
+                )
+              });
+            } else {
+              state.chart.removeIndicator({ id: `sub_${name}` });
+              const newSub = { ...state.subIndicators };
+              delete newSub[name];
+              dispatch({
+                type: "SET_SUB_INDICATORS",
+                indicators: newSub
+              });
+            }
+          }
+          setRedoStack((prev) => [
+            ...prev,
+            {
+              type: "indicator_toggled",
+              data: {
+                name,
+                wasActive: !wasActive,
+                isMain,
+                paneId
+              }
+            }
+          ]);
+          break;
+        }
+      }
+    } finally {
+      isProcessingRef.current = false;
+    }
+  }, [undoStack, state.chart, state.mainIndicators, state.subIndicators, dispatch]);
+  const redo = useCallback(() => {
+    if (redoStack.length === 0 || !state.chart || isProcessingRef.current)
+      return;
+    isProcessingRef.current = true;
+    const action = redoStack[redoStack.length - 1];
+    setRedoStack((prev) => prev.slice(0, -1));
+    try {
+      switch (action.type) {
+        case "overlay_added": {
+          const { overlayData } = action.data;
+          const newId = state.chart.createOverlay({
+            ...overlayData,
+            groupId: DRAWING_GROUP_ID2
+          });
+          setUndoStack((prev) => [
+            ...prev,
+            {
+              type: "overlay_added",
+              data: {
+                id: typeof newId === "string" ? newId : action.data.id,
+                overlayData
+              }
+            }
+          ]);
+          break;
+        }
+        case "overlays_removed": {
+          const { overlays: overlays2 } = action.data;
+          const snapshotOverlays = overlays2.map((o) => {
+            const allOverlays = state.chart?.getOverlays({ id: o.id });
+            const actual = allOverlays?.[0];
+            return actual ? {
+              name: actual.name,
+              points: actual.points,
+              styles: actual.styles,
+              extendData: actual.extendData
+            } : o;
+          });
+          for (const overlay of overlays2) {
+            state.chart.removeOverlay({ id: overlay.id });
+          }
+          setUndoStack((prev) => [
+            ...prev,
+            {
+              type: "overlays_removed",
+              data: { overlays: snapshotOverlays }
+            }
+          ]);
+          break;
+        }
+        case "indicator_toggled": {
+          const { name, wasActive, isMain } = action.data;
+          if (wasActive) {
+            if (isMain) {
+              state.chart.createIndicator(
+                { name, id: `main_${name}`, paneId: "candle_pane" },
+                true,
+                { id: "candle_pane" }
+              );
+              dispatch({
+                type: "SET_MAIN_INDICATORS",
+                indicators: [...state.mainIndicators, name]
+              });
+            } else {
+              state.chart.createIndicator({ name, id: `sub_${name}` });
+              const newPaneId = state.chart.getIndicators({ id: `sub_${name}` })?.[0]?.paneId ?? "";
+              dispatch({
+                type: "SET_SUB_INDICATORS",
+                indicators: {
+                  ...state.subIndicators,
+                  [name]: newPaneId
+                }
+              });
+            }
+          } else {
+            if (isMain) {
+              state.chart.removeIndicator({ id: `main_${name}` });
+              dispatch({
+                type: "SET_MAIN_INDICATORS",
+                indicators: state.mainIndicators.filter(
+                  (n) => n !== name
+                )
+              });
+            } else {
+              state.chart.removeIndicator({ id: `sub_${name}` });
+              const newSub = { ...state.subIndicators };
+              delete newSub[name];
+              dispatch({
+                type: "SET_SUB_INDICATORS",
+                indicators: newSub
+              });
+            }
+          }
+          setUndoStack((prev) => [
+            ...prev,
+            {
+              type: "indicator_toggled",
+              data: {
+                name,
+                wasActive: !wasActive,
+                isMain
+              }
+            }
+          ]);
+          break;
+        }
+      }
+    } finally {
+      isProcessingRef.current = false;
+    }
+  }, [redoStack, state.chart, state.mainIndicators, state.subIndicators, dispatch]);
+  useEffect(() => {
+    const handleKeyDown = (e) => {
+      const isCtrlOrMeta = e.ctrlKey || e.metaKey;
+      if (!isCtrlOrMeta) return;
+      if (e.key === "z" && !e.shiftKey) {
+        e.preventDefault();
+        undo();
+      } else if (e.key === "y" || e.key === "z" && e.shiftKey) {
+        e.preventDefault();
+        redo();
+      }
+    };
+    window.addEventListener("keydown", handleKeyDown);
+    return () => window.removeEventListener("keydown", handleKeyDown);
+  }, [undo, redo]);
+  return {
+    canUndo,
+    canRedo,
+    undo,
+    redo,
+    pushAction,
+    clear
+  };
+}
+var STORAGE_KEY_PREFIX = "klinecharts_layout:";
+var INDEX_KEY = "klinecharts_layout_index";
+var STATE_VERSION = "1.0";
+function generateId() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(
+    /[xy]/g,
+    (c) => {
+      const r = Math.random() * 16 | 0;
+      return (c === "x" ? r : r & 3 | 8).toString(16);
+    }
+  );
+}
+function getLayoutIds() {
+  try {
+    const raw = localStorage.getItem(INDEX_KEY);
+    return raw ? JSON.parse(raw) : [];
+  } catch {
+    return [];
+  }
+}
+function getEntry(id) {
+  try {
+    const raw = localStorage.getItem(STORAGE_KEY_PREFIX + id);
+    return raw ? JSON.parse(raw) : null;
+  } catch {
+    return null;
+  }
+}
+function useLayoutManager() {
+  const { state, dispatch } = useKlinechartsUI();
+  const [layouts, setLayouts] = useState([]);
+  const [autoSaveEnabled, setAutoSaveEnabled] = useState(false);
+  const autoSaveTimerRef = useRef(null);
+  const autoSaveIdRef = useRef(null);
+  const refreshLayouts = useCallback(() => {
+    const entries = getLayoutIds().map((id) => getEntry(id)).filter((e) => e !== null);
+    setLayouts(entries);
+  }, []);
+  useEffect(() => {
+    refreshLayouts();
+  }, [refreshLayouts]);
+  const serializeState = useCallback(() => {
+    const chart = state.chart;
+    if (!chart) return null;
+    const indicators2 = [];
+    const indicatorMap = chart.getIndicatorByPaneId?.();
+    if (indicatorMap) {
+      indicatorMap.forEach((paneIndicators, paneId) => {
+        paneIndicators.forEach((indicator) => {
+          indicators2.push({
+            paneId,
+            name: indicator.name,
+            calcParams: indicator.calcParams,
+            visible: indicator.visible,
+            ...indicator.styles ? { styles: indicator.styles } : {}
+          });
+        });
+      });
+    }
+    const drawings = [];
+    const allOverlays = chart.getOverlays({});
+    if (allOverlays) {
+      for (const overlay of allOverlays) {
+        drawings.push({
+          name: overlay.name,
+          points: overlay.points,
+          styles: overlay.styles,
+          extendData: overlay.extendData
+        });
+      }
+    }
+    return {
+      version: STATE_VERSION,
+      meta: {
+        symbol: state.symbol?.ticker ?? "",
+        period: state.period?.label ?? "",
+        timestamp: Date.now(),
+        lastModified: Date.now()
+      },
+      indicators: indicators2,
+      drawings
+    };
+  }, [state.chart, state.symbol, state.period]);
+  const saveLayout = useCallback(
+    (name) => {
+      const chartState = serializeState();
+      if (!chartState) return null;
+      const id = generateId();
+      const now = Date.now();
+      const entry = {
+        id,
+        name: name.trim() || `Layout ${new Date(now).toLocaleString()}`,
+        symbol: chartState.meta.symbol,
+        period: chartState.meta.period,
+        timestamp: now,
+        lastModified: now,
+        state: chartState
+      };
+      localStorage.setItem(
+        STORAGE_KEY_PREFIX + id,
+        JSON.stringify(entry)
+      );
+      const ids = getLayoutIds();
+      if (!ids.includes(id)) {
+        ids.push(id);
+        localStorage.setItem(INDEX_KEY, JSON.stringify(ids));
+      }
+      refreshLayouts();
+      return id;
+    },
+    [serializeState, refreshLayouts]
+  );
+  const loadLayout = useCallback(
+    (id) => {
+      const entry = getEntry(id);
+      if (!entry || !state.chart) return false;
+      const chartState = entry.state;
+      if (chartState.version !== STATE_VERSION) return false;
+      const chart = state.chart;
+      chart.removeOverlay();
+      const indicatorMap = chart.getIndicatorByPaneId?.();
+      if (indicatorMap) {
+        indicatorMap.forEach((_paneIndicators, paneId) => {
+          _paneIndicators.forEach((_, indicatorName) => {
+            chart.removeIndicator({ paneId, name: indicatorName });
+          });
+        });
+      }
+      const newMainIndicators = [];
+      const newSubIndicators = {};
+      if (chartState.indicators) {
+        for (const ind of chartState.indicators) {
+          chart.createIndicator(
+            {
+              name: ind.name,
+              calcParams: ind.calcParams,
+              visible: ind.visible
+            },
+            ind.paneId !== "candle_pane",
+            { id: ind.paneId }
+          );
+          if (ind.styles) {
+            chart.overrideIndicator({
+              name: ind.name,
+              paneId: ind.paneId,
+              styles: ind.styles
+            });
+          }
+          if (ind.paneId === "candle_pane") {
+            newMainIndicators.push(ind.name);
+          } else {
+            newSubIndicators[ind.name] = ind.paneId;
+          }
+        }
+      }
+      dispatch({
+        type: "SET_MAIN_INDICATORS",
+        indicators: newMainIndicators
+      });
+      dispatch({
+        type: "SET_SUB_INDICATORS",
+        indicators: newSubIndicators
+      });
+      if (chartState.drawings) {
+        for (const drawing of chartState.drawings) {
+          chart.createOverlay({
+            name: drawing.name,
+            points: drawing.points,
+            styles: drawing.styles,
+            extendData: drawing.extendData
+          });
+        }
+      }
+      return true;
+    },
+    [state.chart, dispatch]
+  );
+  const deleteLayout = useCallback(
+    (id) => {
+      localStorage.removeItem(STORAGE_KEY_PREFIX + id);
+      const ids = getLayoutIds().filter((i) => i !== id);
+      localStorage.setItem(INDEX_KEY, JSON.stringify(ids));
+      refreshLayouts();
+    },
+    [refreshLayouts]
+  );
+  const renameLayout = useCallback(
+    (id, name) => {
+      const entry = getEntry(id);
+      if (!entry) return false;
+      const updated = {
+        ...entry,
+        name: name.trim(),
+        lastModified: Date.now()
+      };
+      localStorage.setItem(
+        STORAGE_KEY_PREFIX + id,
+        JSON.stringify(updated)
+      );
+      refreshLayouts();
+      return true;
+    },
+    [refreshLayouts]
+  );
+  useEffect(() => {
+    if (!autoSaveEnabled || !state.chart) return;
+    if (autoSaveTimerRef.current) {
+      clearTimeout(autoSaveTimerRef.current);
+    }
+    autoSaveTimerRef.current = setTimeout(() => {
+      const chartState = serializeState();
+      if (!chartState) return;
+      if (autoSaveIdRef.current) {
+        const entry = getEntry(autoSaveIdRef.current);
+        if (entry) {
+          const updated = {
+            ...entry,
+            lastModified: Date.now(),
+            state: chartState
+          };
+          localStorage.setItem(
+            STORAGE_KEY_PREFIX + autoSaveIdRef.current,
+            JSON.stringify(updated)
+          );
+          refreshLayouts();
+        }
+      } else {
+        const id = generateId();
+        const now = Date.now();
+        const entry = {
+          id,
+          name: "Auto-save",
+          symbol: chartState.meta.symbol,
+          period: chartState.meta.period,
+          timestamp: now,
+          lastModified: now,
+          state: chartState
+        };
+        localStorage.setItem(
+          STORAGE_KEY_PREFIX + id,
+          JSON.stringify(entry)
+        );
+        const ids = getLayoutIds();
+        ids.push(id);
+        localStorage.setItem(INDEX_KEY, JSON.stringify(ids));
+        autoSaveIdRef.current = id;
+        refreshLayouts();
+      }
+    }, 5e3);
+    return () => {
+      if (autoSaveTimerRef.current) {
+        clearTimeout(autoSaveTimerRef.current);
+      }
+    };
+  }, [
+    autoSaveEnabled,
+    state.chart,
+    state.mainIndicators,
+    state.subIndicators,
+    serializeState,
+    refreshLayouts
+  ]);
+  return {
+    layouts,
+    saveLayout,
+    loadLayout,
+    deleteLayout,
+    renameLayout,
+    refreshLayouts,
+    autoSaveEnabled,
+    setAutoSaveEnabled
+  };
+}
+var DEFAULT_SCRIPT = `// Custom Indicator \u2014 Pine Script Style
+// Available: TA, dataList, params
+
+const period = params[0] ?? 14
+const closes = dataList.map(d => d.close)
+const highs  = dataList.map(d => d.high)
+const lows   = dataList.map(d => d.low)
+
+// Example: RSI + Bollinger Bands
+const rsi  = TA.rsi(closes, period)
+const boll = TA.bollinger(closes, period, 2)
+
+// Return one object per candle \u2014 each key = one line on chart
+return rsi.map((v, i) => ({
+  rsi:   v,
+  upper: boll.upper[i],
+  mid:   boll.mid[i],
+  lower: boll.lower[i],
+}))`;
+var SERIES_COLORS = [
+  "#2962FF",
+  "#FF6D00",
+  "#00BCD4",
+  "#E91E63",
+  "#76FF03",
+  "#FFD600"
+];
+var SHADOW_KEYS = [
+  "fetch",
+  "XMLHttpRequest",
+  "WebSocket",
+  "Worker",
+  "SharedWorker",
+  "importScripts",
+  "self",
+  "caches",
+  "indexedDB"
+];
+var scriptCounter = 0;
+function useScriptEditor() {
+  const { state } = useKlinechartsUI();
+  const [code, setCode] = useState(DEFAULT_SCRIPT);
+  const [scriptName, setScriptName] = useState("");
+  const [params, setParams] = useState("14");
+  const [placement, setPlacement] = useState("sub");
+  const [error, setError] = useState("");
+  const [status, setStatus] = useState("");
+  const [isRunning, setIsRunning] = useState(false);
+  const activeIdRef = useRef(null);
+  const activeNameRef = useRef(null);
+  const hasActiveScript = activeNameRef.current !== null;
+  const runScript = useCallback(() => {
+    const chart = state.chart;
+    if (!chart) {
+      setError("Chart not initialized");
+      return;
+    }
+    setError("");
+    setStatus("Running...");
+    setIsRunning(true);
+    try {
+      const parsedParams = params.split(",").map((s) => parseFloat(s.trim())).filter((n) => !isNaN(n));
+      const dataList = chart.getDataList?.() ?? [];
+      const allArgs = [
+        ...SHADOW_KEYS,
+        "TA",
+        "dataList",
+        "params",
+        `"use strict";
+${code}`
+      ];
+      const fn = new Function(...allArgs);
+      const shadowValues = SHADOW_KEYS.map(() => void 0);
+      const result = fn(...shadowValues, TA_default, dataList, parsedParams);
+      if (!Array.isArray(result)) {
+        throw new Error("Script must return an Array.");
+      }
+      const sample = result.find((v) => v !== null && v !== void 0);
+      const seriesKeys = sample ? Object.keys(sample) : ["value"];
+      if (seriesKeys.length === 0) {
+        throw new Error("Returned objects have no keys.");
+      }
+      scriptCounter++;
+      const indicatorName = `_custom_script_${scriptCounter}`;
+      const figures = seriesKeys.map((key, i) => ({
+        key,
+        title: `${key}: `,
+        type: "line",
+        styles: () => ({ color: SERIES_COLORS[i % SERIES_COLORS.length] })
+      }));
+      registerIndicator({
+        name: indicatorName,
+        shortName: (scriptName.trim() || `Script #${scriptCounter}`) + (placement === "main" ? " (Main)" : " (Sub)"),
+        calcParams: parsedParams,
+        figures,
+        calc: () => result,
+        extendData: {
+          isCustomScript: true,
+          code,
+          placement
+        }
+      });
+      if (activeNameRef.current) {
+        try {
+          chart.removeIndicator({
+            id: activeIdRef.current === "candle_pane" ? "candle_pane" : activeIdRef.current,
+            name: activeNameRef.current
+          });
+        } catch {
+        }
+      }
+      let paneId = null;
+      if (placement === "main") {
+        paneId = chart.createIndicator(
+          { name: indicatorName },
+          true,
+          { id: "candle_pane" }
+        );
+      } else {
+        paneId = chart.createIndicator({ name: indicatorName });
+      }
+      activeIdRef.current = typeof paneId === "string" ? paneId : null;
+      activeNameRef.current = indicatorName;
+      const title = scriptName.trim() || `Script #${scriptCounter}`;
+      setStatus(
+        `${title} applied to ${placement === "main" ? "Main Chart" : "Sub Pane"} \u2014 ${seriesKeys.length} series: ${seriesKeys.join(", ")}`
+      );
+    } catch (e) {
+      setError(e?.message ?? String(e));
+    } finally {
+      setIsRunning(false);
+    }
+  }, [state.chart, code, scriptName, params, placement]);
+  const removeScript = useCallback(() => {
+    const chart = state.chart;
+    if (chart && activeNameRef.current && activeIdRef.current) {
+      try {
+        chart.removeIndicator({
+          id: activeIdRef.current,
+          name: activeNameRef.current
+        });
+      } catch {
+      }
+      activeIdRef.current = null;
+      activeNameRef.current = null;
+      setStatus("Indicator removed.");
+    }
+  }, [state.chart]);
+  const resetCode = useCallback(() => {
+    setCode(DEFAULT_SCRIPT);
+    setError("");
+    setStatus("");
+  }, []);
+  const exportScript = useCallback(() => {
+    const blob = new Blob([code], {
+      type: "text/javascript;charset=utf-8"
+    });
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = `${scriptName.trim() || "custom_indicator"}.js`;
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+    URL.revokeObjectURL(url);
+    setStatus("Script exported.");
+  }, [code, scriptName]);
+  const importScript = useCallback(
+    (file) => {
+      const reader = new FileReader();
+      reader.onload = (e) => {
+        const content = e.target?.result;
+        if (content) {
+          setCode(content);
+          if (!scriptName) {
+            setScriptName(file.name.replace(/\.(js|ts|txt)$/i, ""));
+          }
+          setError("");
+          setStatus(`Loaded ${file.name}`);
+        }
+      };
+      reader.readAsText(file);
+    },
+    [scriptName]
+  );
+  return {
+    code,
+    setCode,
+    scriptName,
+    setScriptName,
+    params,
+    setParams,
+    placement,
+    setPlacement,
+    error,
+    status,
+    isRunning,
+    hasActiveScript,
+    runScript,
+    removeScript,
+    resetCode,
+    exportScript,
+    importScript,
+    defaultScript: DEFAULT_SCRIPT
+  };
+}
+function useCrosshair() {
+  const { state } = useKlinechartsUI();
+  const [barData, setBarData] = useState(null);
+  const rafRef = useRef(0);
+  const handler = useCallback(
+    (event) => {
+      if (rafRef.current) {
+        cancelAnimationFrame(rafRef.current);
+      }
+      rafRef.current = requestAnimationFrame(() => {
+        rafRef.current = 0;
+        const klineData = event?.kLineData;
+        if (!klineData) {
+          setBarData(null);
+          return;
+        }
+        const pricePrecision = state.symbol?.pricePrecision ?? 2;
+        const open = klineData.open ?? 0;
+        const close = klineData.close ?? 0;
+        const change = parseFloat((close - open).toFixed(pricePrecision));
+        const changePercent = open !== 0 ? parseFloat((change / open * 100).toFixed(2)) : 0;
+        setBarData({
+          open,
+          high: klineData.high ?? 0,
+          low: klineData.low ?? 0,
+          close,
+          volume: klineData.volume ?? 0,
+          timestamp: klineData.timestamp ?? 0,
+          change,
+          changePercent
+        });
+      });
+    },
+    [state.symbol?.pricePrecision]
+  );
+  useEffect(() => {
+    const chart = state.chart;
+    if (!chart) return;
+    chart.subscribeAction?.("onCrosshairChange", handler);
+    return () => {
+      if (rafRef.current) {
+        cancelAnimationFrame(rafRef.current);
+        rafRef.current = 0;
+      }
+      chart.unsubscribeAction?.("onCrosshairChange", handler);
+    };
+  }, [state.chart, handler]);
+  return { barData };
+}
+var alertCounter = 0;
+function useAlerts() {
+  const { state } = useKlinechartsUI();
+  const [alerts, setAlerts] = useState([]);
+  const callbackRef = useRef(null);
+  const prevCloseRef = useRef(null);
+  const addAlert = useCallback(
+    (price, condition, message) => {
+      const id = `alert_${++alertCounter}`;
+      const alert = {
+        id,
+        price,
+        condition,
+        message,
+        triggered: false
+      };
+      setAlerts((prev) => [...prev, alert]);
+      if (state.chart) {
+        state.chart.createOverlay({
+          name: "horizontalStraightLine",
+          id,
+          groupId: "price_alerts",
+          points: [{ value: price }],
+          styles: {
+            line: {
+              style: "dashed",
+              color: "#ff9800",
+              size: 1
+            }
+          },
+          lock: true
+        });
+      }
+      return id;
+    },
+    [state.chart]
+  );
+  const removeAlert = useCallback(
+    (id) => {
+      setAlerts((prev) => prev.filter((a) => a.id !== id));
+      state.chart?.removeOverlay({ id });
+    },
+    [state.chart]
+  );
+  const clearAlerts = useCallback(() => {
+    setAlerts((prev) => {
+      for (const alert of prev) {
+        state.chart?.removeOverlay({ id: alert.id });
+      }
+      return [];
+    });
+  }, [state.chart]);
+  const onAlertTriggered = useCallback(
+    (callback) => {
+      callbackRef.current = callback;
+    },
+    []
+  );
+  useEffect(() => {
+    if (!state.chart) return;
+    const interval = setInterval(() => {
+      const dataList = state.chart?.getDataList();
+      if (!dataList || dataList.length === 0) return;
+      const lastBar = dataList[dataList.length - 1];
+      const currentClose = lastBar.close;
+      const prevClose = prevCloseRef.current;
+      if (prevClose === null) {
+        prevCloseRef.current = currentClose;
+        return;
+      }
+      prevCloseRef.current = currentClose;
+      setAlerts((prev) => {
+        let changed = false;
+        const next = prev.map((alert) => {
+          if (alert.triggered) return alert;
+          let shouldTrigger = false;
+          if (alert.condition === "crossing_up") {
+            shouldTrigger = prevClose < alert.price && currentClose >= alert.price;
+          } else if (alert.condition === "crossing_down") {
+            shouldTrigger = prevClose > alert.price && currentClose <= alert.price;
+          } else if (alert.condition === "crossing") {
+            shouldTrigger = prevClose < alert.price && currentClose >= alert.price || prevClose > alert.price && currentClose <= alert.price;
+          }
+          if (shouldTrigger) {
+            changed = true;
+            const triggered = { ...alert, triggered: true };
+            callbackRef.current?.(triggered);
+            return triggered;
+          }
+          return alert;
+        });
+        return changed ? next : prev;
+      });
+    }, 1e3);
+    return () => clearInterval(interval);
+  }, [state.chart]);
+  return {
+    alerts,
+    addAlert,
+    removeAlert,
+    clearAlerts,
+    onAlertTriggered
+  };
+}
+function useDataExport() {
+  const { state } = useKlinechartsUI();
+  const exportAll = useCallback(
+    (format) => {
+      if (!state.chart) return;
+      const dataList = state.chart.getDataList();
+      if (!dataList || dataList.length === 0) return;
+      downloadData(dataList, format, state.symbol?.ticker);
+    },
+    [state.chart, state.symbol?.ticker]
+  );
+  const exportVisible = useCallback(
+    (format) => {
+      if (!state.chart) return;
+      const dataList = state.chart.getDataList();
+      if (!dataList || dataList.length === 0) return;
+      const visibleRange = state.chart.getVisibleRange?.();
+      if (!visibleRange) {
+        downloadData(dataList, format, state.symbol?.ticker);
+        return;
+      }
+      const { from, to } = visibleRange;
+      const visibleData = dataList.slice(from, to);
+      downloadData(visibleData, format, state.symbol?.ticker);
+    },
+    [state.chart, state.symbol?.ticker]
+  );
+  return { exportAll, exportVisible };
+}
+function formatRow(bar) {
+  return {
+    date: new Date(bar.timestamp).toISOString(),
+    open: bar.open,
+    high: bar.high,
+    low: bar.low,
+    close: bar.close,
+    volume: bar.volume ?? 0
+  };
+}
+function buildCsv(dataList) {
+  const header = "Date,Open,High,Low,Close,Volume\n";
+  const rows = dataList.map((bar) => {
+    const r = formatRow(bar);
+    return `${r.date},${r.open},${r.high},${r.low},${r.close},${r.volume}`;
+  });
+  return header + rows.join("\n");
+}
+function buildJson(dataList) {
+  return JSON.stringify(dataList.map(formatRow), null, 2);
+}
+function downloadData(dataList, format, ticker) {
+  const content = format === "csv" ? buildCsv(dataList) : buildJson(dataList);
+  const mimeType = format === "csv" ? "text/csv" : "application/json";
+  const blob = new Blob([content], { type: mimeType });
+  const url = URL.createObjectURL(blob);
+  const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const prefix = ticker ?? "chart";
+  const filename = `${prefix}_${date}.${format}`;
+  const link = document.createElement("a");
+  link.href = url;
+  link.download = filename;
+  document.body.appendChild(link);
+  link.click();
+  document.body.removeChild(link);
+  URL.revokeObjectURL(url);
+}
+function useWatchlist() {
+  const { state } = useKlinechartsUI();
+  const { dispatch, datafeed } = useKlinechartsUIDispatch();
+  const [items, setItems] = useState([]);
+  const subscriptionsRef = useRef(/* @__PURE__ */ new Map());
+  const activeSymbol = state.symbol?.ticker ?? null;
+  const addSymbol = useCallback(
+    (ticker) => {
+      setItems((prev) => {
+        if (prev.some((item) => item.ticker === ticker)) return prev;
+        return [
+          ...prev,
+          { ticker, lastPrice: null, change: null, changePercent: null }
+        ];
+      });
+      if (subscriptionsRef.current.has(ticker)) return;
+      const symbolInfo = { ticker };
+      const period = state.period;
+      subscriptionsRef.current.set(ticker, { symbolInfo, period });
+      datafeed.subscribe(symbolInfo, period, (bar) => {
+        setItems(
+          (prev) => prev.map((item) => {
+            if (item.ticker !== ticker) return item;
+            const change = bar.close - bar.open;
+            const changePercent = bar.open !== 0 ? change / bar.open * 100 : null;
+            return {
+              ...item,
+              lastPrice: bar.close,
+              change,
+              changePercent
+            };
+          })
+        );
+      });
+    },
+    [datafeed, state.period]
+  );
+  const removeSymbol = useCallback(
+    (ticker) => {
+      const sub = subscriptionsRef.current.get(ticker);
+      if (sub) {
+        datafeed.unsubscribe(sub.symbolInfo, sub.period);
+        subscriptionsRef.current.delete(ticker);
+      }
+      setItems((prev) => prev.filter((item) => item.ticker !== ticker));
+    },
+    [datafeed]
+  );
+  const switchSymbol = useCallback(
+    (ticker) => {
+      dispatch({ type: "SET_SYMBOL", symbol: { ticker } });
+    },
+    [dispatch]
+  );
+  useEffect(() => {
+    return () => {
+      subscriptionsRef.current.forEach((sub) => {
+        datafeed.unsubscribe(sub.symbolInfo, sub.period);
+      });
+      subscriptionsRef.current.clear();
+    };
+  }, [datafeed]);
+  return {
+    items,
+    addSymbol,
+    removeSymbol,
+    switchSymbol,
+    activeSymbol
+  };
+}
+function useReplay() {
+  const { state } = useKlinechartsUI();
+  const [isReplaying, setIsReplaying] = useState(false);
+  const [isPaused, setIsPaused] = useState(false);
+  const [speed, setSpeedState] = useState(1);
+  const [barIndex, setBarIndex] = useState(0);
+  const [totalBars, setTotalBars] = useState(0);
+  const intervalRef = useRef(null);
+  const savedDataRef = useRef([]);
+  const currentIndexRef = useRef(0);
+  const clearInterval_ = useCallback(() => {
+    if (intervalRef.current !== null) {
+      clearInterval(intervalRef.current);
+      intervalRef.current = null;
+    }
+  }, []);
+  const addNextBar = useCallback(() => {
+    if (!state.chart) return;
+    const data = savedDataRef.current;
+    const idx = currentIndexRef.current;
+    if (idx >= data.length) {
+      clearInterval_();
+      setIsPaused(true);
+      return;
+    }
+    const bar = data[idx];
+    state.chart.updateData?.(bar);
+    currentIndexRef.current = idx + 1;
+    setBarIndex(idx + 1);
+  }, [state.chart, clearInterval_]);
+  const startInterval = useCallback(
+    (currentSpeed) => {
+      clearInterval_();
+      intervalRef.current = setInterval(addNextBar, 1e3 / currentSpeed);
+    },
+    [addNextBar, clearInterval_]
+  );
+  const startReplay = useCallback(() => {
+    if (!state.chart) return;
+    const dataList = state.chart.getDataList();
+    if (!dataList || dataList.length === 0) return;
+    savedDataRef.current = [...dataList];
+    currentIndexRef.current = 0;
+    setTotalBars(dataList.length);
+    setBarIndex(0);
+    setIsReplaying(true);
+    setIsPaused(false);
+    state.chart.clearData?.();
+    startInterval(speed);
+  }, [state.chart, speed, startInterval]);
+  const stopReplay = useCallback(() => {
+    if (!state.chart) return;
+    clearInterval_();
+    const data = savedDataRef.current;
+    if (data.length > 0) {
+      state.chart.clearData?.();
+      for (const bar of data) {
+        state.chart.updateData?.(bar);
+      }
+    }
+    savedDataRef.current = [];
+    currentIndexRef.current = 0;
+    setIsReplaying(false);
+    setIsPaused(false);
+    setBarIndex(0);
+    setTotalBars(0);
+  }, [state.chart, clearInterval_]);
+  const togglePause = useCallback(() => {
+    if (!isReplaying) return;
+    if (isPaused) {
+      startInterval(speed);
+      setIsPaused(false);
+    } else {
+      clearInterval_();
+      setIsPaused(true);
+    }
+  }, [isReplaying, isPaused, speed, startInterval, clearInterval_]);
+  const stepForward = useCallback(() => {
+    if (!isReplaying || !isPaused) return;
+    addNextBar();
+  }, [isReplaying, isPaused, addNextBar]);
+  const stepBackward = useCallback(() => {
+    if (!isReplaying || !isPaused || !state.chart) return;
+    const idx = currentIndexRef.current;
+    if (idx <= 1) return;
+    const data = savedDataRef.current;
+    state.chart.clearData?.();
+    for (let i = 0; i < idx - 1; i++) {
+      state.chart.updateData?.(data[i]);
+    }
+    currentIndexRef.current = idx - 1;
+    setBarIndex(idx - 1);
+  }, [isReplaying, isPaused, state.chart]);
+  const seekTo = useCallback(
+    (targetIndex) => {
+      if (!isReplaying || !state.chart) return;
+      const data = savedDataRef.current;
+      const clamped = Math.max(0, Math.min(targetIndex, data.length));
+      clearInterval_();
+      setIsPaused(true);
+      state.chart.clearData?.();
+      for (let i = 0; i < clamped; i++) {
+        state.chart.updateData?.(data[i]);
+      }
+      currentIndexRef.current = clamped;
+      setBarIndex(clamped);
+    },
+    [isReplaying, state.chart, clearInterval_]
+  );
+  const setSpeed = useCallback(
+    (newSpeed) => {
+      setSpeedState(newSpeed);
+      if (isReplaying && !isPaused) {
+        startInterval(newSpeed);
+      }
+    },
+    [isReplaying, isPaused, startInterval]
+  );
+  useEffect(() => {
+    return () => {
+      clearInterval_();
+    };
+  }, [clearInterval_]);
+  return {
+    isReplaying,
+    isPaused,
+    speed,
+    barIndex,
+    totalBars,
+    startReplay,
+    stopReplay,
+    togglePause,
+    stepForward,
+    stepBackward,
+    seekTo,
+    setSpeed
+  };
+}
+var DEFAULT_COLORS = [
+  "#2196f3",
+  "#ff9800",
+  "#4caf50",
+  "#e91e63",
+  "#9c27b0",
+  "#00bcd4",
+  "#ff5722",
+  "#8bc34a"
+];
+var colorIndex = 0;
+var compareCounter = 0;
+function useCompare() {
+  const { state, datafeed } = useKlinechartsUI();
+  const [symbols, setSymbols] = useState([]);
+  const indicatorsRef = useRef(/* @__PURE__ */ new Map());
+  const addSymbol = useCallback(
+    async (ticker, color) => {
+      if (!state.chart || !datafeed) return;
+      if (indicatorsRef.current.has(ticker)) return;
+      const assignedColor = color ?? DEFAULT_COLORS[colorIndex++ % DEFAULT_COLORS.length];
+      const mainDataList = state.chart.getDataList();
+      if (!mainDataList || mainDataList.length === 0) return;
+      const from = mainDataList[0].timestamp;
+      const to = mainDataList[mainDataList.length - 1].timestamp;
+      const compareData = await datafeed.getHistoryKLineData(
+        { ticker },
+        { ...state.period, label: "" },
+        from,
+        to
+      );
+      if (!compareData || compareData.length === 0) return;
+      const compareMap = /* @__PURE__ */ new Map();
+      for (const bar of compareData) {
+        compareMap.set(bar.timestamp, bar.close);
+      }
+      let basePrice = null;
+      for (const bar of mainDataList) {
+        const close = compareMap.get(bar.timestamp);
+        if (close != null) {
+          basePrice = close;
+          break;
+        }
+      }
+      if (basePrice === null || basePrice === 0) return;
+      const bp = basePrice;
+      const normalizedData = mainDataList.map((mainBar) => {
+        const close = compareMap.get(mainBar.timestamp);
+        return {
+          pct: close != null ? (close - bp) / bp * 100 : NaN
+        };
+      });
+      const indicatorName = `__cmp_${++compareCounter}_${ticker}`;
+      registerIndicator({
+        name: indicatorName,
+        shortName: ticker,
+        figures: [
+          {
+            key: "pct",
+            title: `${ticker} %: `,
+            type: "line",
+            styles: () => ({ color: assignedColor })
+          }
+        ],
+        calc: () => normalizedData
+      });
+      const paneId = state.chart.createIndicator(
+        { name: indicatorName },
+        true,
+        { id: "candle_pane" }
+      );
+      indicatorsRef.current.set(ticker, {
+        name: indicatorName,
+        paneId: typeof paneId === "string" ? paneId : "candle_pane"
+      });
+      setSymbols((prev) => {
+        if (prev.some((s) => s.ticker === ticker)) return prev;
+        return [
+          ...prev,
+          { ticker, basePrice: bp, color: assignedColor, visible: true }
+        ];
+      });
+    },
+    [state.chart, state.period, datafeed]
+  );
+  const removeSymbol = useCallback(
+    (ticker) => {
+      const info = indicatorsRef.current.get(ticker);
+      if (info && state.chart) {
+        try {
+          state.chart.removeIndicator({ name: info.name });
+        } catch {
+        }
+        indicatorsRef.current.delete(ticker);
+      }
+      setSymbols((prev) => prev.filter((s) => s.ticker !== ticker));
+    },
+    [state.chart]
+  );
+  const toggleSymbol = useCallback(
+    (ticker) => {
+      const info = indicatorsRef.current.get(ticker);
+      if (!info || !state.chart) return;
+      setSymbols((prev) => {
+        const sym = prev.find((s) => s.ticker === ticker);
+        if (!sym) return prev;
+        const newVisible = !sym.visible;
+        state.chart?.overrideIndicator({
+          name: info.name,
+          visible: newVisible
+        });
+        return prev.map(
+          (s) => s.ticker === ticker ? { ...s, visible: newVisible } : s
+        );
+      });
+    },
+    [state.chart]
+  );
+  const clearAll = useCallback(() => {
+    indicatorsRef.current.forEach((info) => {
+      try {
+        state.chart?.removeIndicator({ name: info.name });
+      } catch {
+      }
+    });
+    indicatorsRef.current.clear();
+    setSymbols([]);
+  }, [state.chart]);
+  useEffect(() => {
+    return () => {
+      indicatorsRef.current.forEach((info) => {
+        try {
+          state.chart?.removeIndicator({ name: info.name });
+        } catch {
+        }
+      });
+      indicatorsRef.current.clear();
+    };
+  }, [state.chart]);
+  return { symbols, addSymbol, removeSymbol, toggleSymbol, clearAll };
+}
+var MEASURE_OVERLAY_ID = "__measure_line__";
+function useMeasure() {
+  const { state } = useKlinechartsUI();
+  const [isActive, setIsActive] = useState(false);
+  const [fromPoint, setFromPoint] = useState(null);
+  const [result, setResult] = useState(null);
+  const clickCountRef = useRef(0);
+  const computeResult = useCallback(
+    (from, to) => {
+      const priceDiff = to.price - from.price;
+      const pricePercent = from.price !== 0 ? priceDiff / from.price * 100 : 0;
+      const bars = Math.abs(to.barIndex - from.barIndex);
+      const timeDiff = Math.abs(to.timestamp - from.timestamp);
+      return { from, to, priceDiff, pricePercent, bars, timeDiff };
+    },
+    []
+  );
+  const cleanup = useCallback(() => {
+    state.chart?.removeOverlay({ id: MEASURE_OVERLAY_ID });
+  }, [state.chart]);
+  const startMeasure = useCallback(() => {
+    cleanup();
+    setIsActive(true);
+    setFromPoint(null);
+    setResult(null);
+    clickCountRef.current = 0;
+    if (!state.chart) return;
+    state.chart.createOverlay({
+      name: "segment",
+      id: MEASURE_OVERLAY_ID,
+      groupId: "measure",
+      styles: {
+        line: {
+          style: "dashed",
+          color: "#FFD600",
+          size: 1
+        }
+      },
+      lock: true,
+      onDrawEnd: (event) => {
+        const overlay = event?.overlay;
+        const points = overlay?.points;
+        if (!points || points.length < 2) return;
+        const chart = state.chart;
+        if (!chart) return;
+        const dataList = chart.getDataList();
+        if (!dataList || dataList.length === 0) return;
+        const makePoint = (p) => {
+          const idx = Math.max(
+            0,
+            Math.min(p.dataIndex ?? 0, dataList.length - 1)
+          );
+          const bar = dataList[idx];
+          return {
+            price: p.value ?? bar?.close ?? 0,
+            timestamp: bar?.timestamp ?? 0,
+            barIndex: idx
+          };
+        };
+        const from = makePoint(points[0]);
+        const to = makePoint(points[1]);
+        setFromPoint(from);
+        setResult(computeResult(from, to));
+        setIsActive(false);
+      }
+    });
+  }, [state.chart, cleanup, computeResult]);
+  const cancelMeasure = useCallback(() => {
+    cleanup();
+    setIsActive(false);
+    setFromPoint(null);
+    clickCountRef.current = 0;
+  }, [cleanup]);
+  const clearResult = useCallback(() => {
+    cleanup();
+    setResult(null);
+    setFromPoint(null);
+  }, [cleanup]);
+  useEffect(() => {
+    return () => {
+      state.chart?.removeOverlay({ id: MEASURE_OVERLAY_ID });
+    };
+  }, [state.chart]);
+  return {
+    isActive,
+    startMeasure,
+    cancelMeasure,
+    result,
+    clearResult,
+    fromPoint
+  };
+}
+var annotationCounter = 0;
+function useAnnotations() {
+  const { state } = useKlinechartsUI();
+  const [annotations, setAnnotations] = useState([]);
+  const addAnnotation = useCallback(
+    (text, price, timestamp, color) => {
+      const id = `annotation_${++annotationCounter}`;
+      const annotation = {
+        id,
+        text,
+        price,
+        timestamp,
+        color
+      };
+      setAnnotations((prev) => [...prev, annotation]);
+      if (state.chart) {
+        state.chart.createOverlay({
+          name: "simpleAnnotation",
+          id,
+          groupId: "annotations",
+          points: [{ timestamp, value: price }],
+          extendData: text,
+          styles: color ? {
+            text: {
+              color
+            }
+          } : void 0,
+          lock: true
+        });
+      }
+      return id;
+    },
+    [state.chart]
+  );
+  const removeAnnotation = useCallback(
+    (id) => {
+      setAnnotations((prev) => prev.filter((a) => a.id !== id));
+      state.chart?.removeOverlay({ id });
+    },
+    [state.chart]
+  );
+  const updateAnnotation = useCallback(
+    (id, updates) => {
+      setAnnotations(
+        (prev) => prev.map((a) => a.id === id ? { ...a, ...updates } : a)
+      );
+      if (state.chart) {
+        const overrideData = { id };
+        if (updates.text !== void 0) {
+          overrideData.extendData = updates.text;
+        }
+        if (updates.color !== void 0) {
+          overrideData.styles = {
+            text: {
+              color: updates.color
+            }
+          };
+        }
+        state.chart.overrideOverlay(overrideData);
+      }
+    },
+    [state.chart]
+  );
+  const clearAnnotations = useCallback(() => {
+    setAnnotations((prev) => {
+      for (const annotation of prev) {
+        state.chart?.removeOverlay({ id: annotation.id });
+      }
+      return [];
+    });
+  }, [state.chart]);
+  useEffect(() => {
+    return () => {
+      state.chart?.removeOverlay({ groupId: "annotations" });
+    };
+  }, [state.chart]);
+  return {
+    annotations,
+    addAnnotation,
+    removeAnnotation,
+    updateAnnotation,
+    clearAnnotations
+  };
+}
 
 // src/utils/createDataLoader.ts
 function createDataLoader(datafeed, dispatch) {
@@ -1385,6 +3169,6 @@ function createDataLoader(datafeed, dispatch) {
   };
 }
 
-export { CANDLE_TYPES, COMPARE_RULES, DEFAULT_PERIODS, DRAWING_CATEGORIES, INDICATOR_PARAMS, KlinechartsUIDispatchContext, KlinechartsUIProvider, KlinechartsUIStateContext, MAIN_INDICATORS, PRICE_AXIS_TYPES, SUB_INDICATORS, TIMEZONES, TOOLTIP_SHOW_RULES, YAXIS_POSITIONS, createDataLoader, useDrawingTools, useFullscreen, useIndicators, useKlinechartsUI, useKlinechartsUILoading, useKlinechartsUISettings, useKlinechartsUITheme, useOrderLines, usePeriods, useScreenshot, useSymbolSearch, useTimezone };
+export { CANDLE_TYPES, COMPARE_RULES, DEFAULT_PERIODS, DRAWING_CATEGORIES, INDICATOR_PARAMS, KlinechartsUIDispatchContext, KlinechartsUIProvider, KlinechartsUIStateContext, MAIN_INDICATORS, PRICE_AXIS_TYPES, SUB_INDICATORS, TIMEZONES, TOOLTIP_SHOW_RULES, YAXIS_POSITIONS, createDataLoader, useAlerts, useAnnotations, useCompare, useCrosshair, useDataExport, useDrawingTools, useFullscreen, useIndicators, useKlinechartsUI, useKlinechartsUILoading, useKlinechartsUISettings, useKlinechartsUITheme, useLayoutManager, useMeasure, useOrderLines, usePeriods, useReplay, useScreenshot, useScriptEditor, useSymbolSearch, useTimezone, useUndoRedo, useWatchlist };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map