react-klinecharts-ui 0.2.0 → 0.3.0

package/dist/index.js

@@ -1,5 +1,5 @@
-import { registerExtensions, TA_default } from './chunk-B3NZ66YA.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, 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-B3NZ66YA.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, registerIndicator } from 'react-klinecharts';
 import { jsx } from 'react/jsx-runtime';
@@ -643,9 +643,12 @@ var INDICATOR_PARAMS = {
 };
 
 // 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));
@@ -815,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,
@@ -834,7 +921,11 @@ function useIndicators() {
     updateIndicatorParams,
     getIndicatorParams,
     isMainIndicatorActive,
-    isSubIndicatorActive
+    isSubIndicatorActive,
+    collapseSubIndicator,
+    expandSubIndicator,
+    isSubIndicatorCollapsed,
+    reorderSubIndicator
   };
 }
 
@@ -933,6 +1024,17 @@ function useDrawingTools() {
   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,
@@ -943,15 +1045,15 @@ 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?.({
@@ -966,10 +1068,22 @@ function useDrawingTools() {
               }
             }
           });
+          if (autoRetriggerRef.current && activeToolRef.current === name) {
+            requestAnimationFrame(() => {
+              createOverlayForTool(name);
+            });
+          }
         }
       });
     },
-    [state.chart, isLocked, isVisible, magnetMode, undoRedoListenerRef]
+    [state.chart, undoRedoListenerRef]
+  );
+  const selectTool = useCallback(
+    (name) => {
+      setActiveTool(name);
+      createOverlayForTool(name);
+    },
+    [createOverlayForTool]
   );
   const clearActiveTool = useCallback(() => {
     setActiveTool(null);
@@ -1040,12 +1154,14 @@ function useDrawingTools() {
     magnetMode,
     isLocked,
     isVisible,
+    autoRetrigger,
     selectTool,
     clearActiveTool,
     setMagnetMode,
     toggleLock,
     toggleVisibility,
-    removeAllDrawings
+    removeAllDrawings,
+    setAutoRetrigger
   };
 }
 
@@ -2244,6 +2360,750 @@ ${code}`
     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) {
@@ -2309,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, useLayoutManager, useOrderLines, usePeriods, useScreenshot, useScriptEditor, useSymbolSearch, useTimezone, useUndoRedo };
+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