react-klinecharts-ui 0.5.0 → 1.0.0

package/dist/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkUJNJH3BS_cjs = require('./chunk-UJNJH3BS.cjs');
+var chunkLGYYJ2GP_cjs = require('./chunk-LGYYJ2GP.cjs');
 var react = require('react');
-var reactKlinecharts = require('react-klinecharts');
+var klinecharts = require('klinecharts');
 var jsxRuntime = require('react/jsx-runtime');
 
 var KlinechartsUIStateContext = react.createContext(null);
@@ -64,6 +64,25 @@ function reducer(state, action) {
       return { ...state, indicatorVisibility: action.visibility };
     case "SET_ALERTS":
       return { ...state, alerts: action.alerts };
+    case "ADD_ALERT":
+      return { ...state, alerts: [...state.alerts, action.alert] };
+    case "REMOVE_ALERT":
+      return {
+        ...state,
+        alerts: state.alerts.filter((a) => a.id !== action.id)
+      };
+    case "CLEAR_ALERTS":
+      return { ...state, alerts: [] };
+    case "MARK_ALERT_TRIGGERED": {
+      if (action.ids.length === 0) return state;
+      const triggered = new Set(action.ids);
+      return {
+        ...state,
+        alerts: state.alerts.map(
+          (a) => triggered.has(a.id) ? { ...a, triggered: true } : a
+        )
+      };
+    }
     case "SET_MEASURE":
       return { ...state, measure: { ...state.measure, ...action.measure } };
     case "SET_REPLAY":
@@ -153,7 +172,6 @@ function KlinechartsUIProvider({
   const replayIndexRef = react.useRef(0);
   const alertPrevCloseRef = react.useRef(null);
   const stateRef = react.useRef(state);
-  stateRef.current = state;
   const callbacksRef = react.useRef({
     onStateChange,
     onSymbolChange,
@@ -163,15 +181,18 @@ function KlinechartsUIProvider({
     onMainIndicatorsChange,
     onSubIndicatorsChange
   });
-  callbacksRef.current = {
-    onStateChange,
-    onSymbolChange,
-    onPeriodChange,
-    onThemeChange,
-    onTimezoneChange,
-    onMainIndicatorsChange,
-    onSubIndicatorsChange
-  };
+  react.useEffect(() => {
+    stateRef.current = state;
+    callbacksRef.current = {
+      onStateChange,
+      onSymbolChange,
+      onPeriodChange,
+      onThemeChange,
+      onTimezoneChange,
+      onMainIndicatorsChange,
+      onSubIndicatorsChange
+    };
+  });
   const enhancedDispatch = react.useCallback((action) => {
     const prevState = stateRef.current;
     const newState = reducer(prevState, action);
@@ -201,11 +222,17 @@ function KlinechartsUIProvider({
     }
   }, []);
   const extraOverlaysRef = react.useRef(extraOverlays);
+  const datafeedRef = react.useRef(datafeed);
+  const onSettingsChangeRef = react.useRef(onSettingsChange);
+  react.useEffect(() => {
+    datafeedRef.current = datafeed;
+    onSettingsChangeRef.current = onSettingsChange;
+  });
   react.useEffect(() => {
     if (shouldRegister) {
-      chunkUJNJH3BS_cjs.registerExtensions();
+      chunkLGYYJ2GP_cjs.registerExtensions();
     }
-    extraOverlaysRef.current?.forEach((overlay) => reactKlinecharts.registerOverlay(overlay));
+    extraOverlaysRef.current?.forEach((overlay) => klinecharts.registerOverlay(overlay));
   }, [shouldRegister]);
   react.useEffect(() => {
     if (state.chart && state.styles) {
@@ -225,26 +252,29 @@ function KlinechartsUIProvider({
       alertPrevCloseRef.current = currentClose;
       if (prevClose === null) return;
       const alerts = stateRef.current.alerts;
-      let changed = false;
-      const next = alerts.map((alert) => {
-        if (alert.triggered) return alert;
+      const triggeredIds = [];
+      for (const alert of alerts) {
+        if (alert.triggered) continue;
         const crossedUp = prevClose < alert.price && currentClose >= alert.price;
         const crossedDown = prevClose > alert.price && currentClose <= alert.price;
         const shouldTrigger = alert.condition === "crossing_up" ? crossedUp : alert.condition === "crossing_down" ? crossedDown : crossedUp || crossedDown;
         if (shouldTrigger) {
-          changed = true;
-          const triggered = { ...alert, triggered: true };
-          alertTriggeredListenerRef.current?.(triggered);
-          return triggered;
+          triggeredIds.push(alert.id);
+          alertTriggeredListenerRef.current?.({ ...alert, triggered: true });
         }
-        return alert;
-      });
-      if (changed) {
-        enhancedDispatch({ type: "SET_ALERTS", alerts: next });
+      }
+      if (triggeredIds.length > 0) {
+        enhancedDispatch({
+          type: "MARK_ALERT_TRIGGERED",
+          ids: triggeredIds
+        });
       }
     }, 1e3);
     return () => clearInterval(interval);
   }, [state.chart, hasAlerts, enhancedDispatch]);
+  react.useEffect(() => {
+    alertPrevCloseRef.current = null;
+  }, [state.symbol, state.period]);
   react.useEffect(() => {
     return () => {
       if (replayIntervalRef.current !== null) {
@@ -256,8 +286,8 @@ function KlinechartsUIProvider({
   const dispatchValue = react.useMemo(
     () => ({
       dispatch: enhancedDispatch,
-      datafeed,
-      onSettingsChange,
+      datafeed: datafeedRef.current,
+      onSettingsChange: onSettingsChangeRef.current,
       fullscreenContainerRef,
       undoRedoListenerRef,
       alertTriggeredListenerRef,
@@ -265,7 +295,8 @@ function KlinechartsUIProvider({
       replaySavedDataRef,
       replayIndexRef
     }),
-    [enhancedDispatch, datafeed, onSettingsChange]
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [enhancedDispatch]
   );
   return /* @__PURE__ */ jsxRuntime.jsx(KlinechartsUIStateContext.Provider, { value: state, children: /* @__PURE__ */ jsxRuntime.jsx(KlinechartsUIDispatchContext.Provider, { value: dispatchValue, children }) });
 }
@@ -1223,15 +1254,17 @@ function useDrawingTools() {
   const [isVisible, setIsVisible] = react.useState(true);
   const [autoRetrigger, setAutoRetrigger] = react.useState(true);
   const activeToolRef = react.useRef(activeTool);
-  activeToolRef.current = activeTool;
   const autoRetriggerRef = react.useRef(autoRetrigger);
-  autoRetriggerRef.current = autoRetrigger;
   const isLockedRef = react.useRef(isLocked);
-  isLockedRef.current = isLocked;
   const isVisibleRef = react.useRef(isVisible);
-  isVisibleRef.current = isVisible;
   const magnetModeRef = react.useRef(magnetMode);
-  magnetModeRef.current = magnetMode;
+  react.useEffect(() => {
+    activeToolRef.current = activeTool;
+    autoRetriggerRef.current = autoRetrigger;
+    isLockedRef.current = isLocked;
+    isVisibleRef.current = isVisible;
+    magnetModeRef.current = magnetMode;
+  });
   const categories = react.useMemo(
     () => DRAWING_CATEGORIES.map((cat) => ({
       key: cat.key,
@@ -1242,6 +1275,8 @@ function useDrawingTools() {
     })),
     []
   );
+  const createOverlayForToolRef = react.useRef(() => {
+  });
   const createOverlayForTool = react.useCallback(
     (name) => {
       const mode = magnetModeRef.current === "strong" ? "strong_magnet" : magnetModeRef.current === "weak" ? "weak_magnet" : "normal";
@@ -1267,7 +1302,7 @@ function useDrawingTools() {
           });
           if (autoRetriggerRef.current && activeToolRef.current === name) {
             requestAnimationFrame(() => {
-              createOverlayForTool(name);
+              createOverlayForToolRef.current(name);
             });
           }
         }
@@ -1275,6 +1310,9 @@ function useDrawingTools() {
     },
     [state.chart, undoRedoListenerRef]
   );
+  react.useEffect(() => {
+    createOverlayForToolRef.current = createOverlayForTool;
+  });
   const selectTool = react.useCallback(
     (name) => {
       setActiveTool(name);
@@ -1678,28 +1716,81 @@ function useScreenshot() {
     clear
   };
 }
+function useHotkeys() {
+  const { state } = useKlinechartsUI();
+  const registerHotkey = react.useCallback((template) => {
+    klinecharts.registerHotkey(template);
+  }, []);
+  const getHotkey = react.useCallback(
+    (name) => klinecharts.getHotkey(name) ?? null,
+    []
+  );
+  const setHotkeysEnabled = react.useCallback(
+    (enabled, exclude) => {
+      state.chart?.setHotkey(
+        exclude ? { enabled, exclude } : { enabled }
+      );
+    },
+    [state.chart]
+  );
+  const getHotkeysConfig = react.useCallback(
+    () => state.chart?.getHotkey() ?? null,
+    [state.chart]
+  );
+  return {
+    registerHotkey,
+    getHotkey,
+    supportedHotkeys: klinecharts.getSupportedHotkeys(),
+    setHotkeysEnabled,
+    getHotkeysConfig
+  };
+}
+function useChartAxes() {
+  const { state } = useKlinechartsUI();
+  const overrideXAxis = react.useCallback(
+    (override) => {
+      if (!state.chart) return;
+      state.chart.overrideXAxis(override);
+    },
+    [state.chart]
+  );
+  const overrideYAxis = react.useCallback(
+    (override) => {
+      if (!state.chart) return;
+      state.chart.overrideYAxis(override);
+    },
+    [state.chart]
+  );
+  return { overrideXAxis, overrideYAxis };
+}
 function useFullscreen() {
   const { fullscreenContainerRef } = useKlinechartsUIDispatch();
   const [isFullscreen, setIsFullscreen] = react.useState(false);
   const enter = react.useCallback(() => {
     const el = fullscreenContainerRef.current;
     if (!el) return;
+    let result;
     if (el.requestFullscreen) {
-      el.requestFullscreen();
+      result = el.requestFullscreen();
     } else if ("webkitRequestFullscreen" in el) {
       el.webkitRequestFullscreen();
     } else if ("msRequestFullscreen" in el) {
       el.msRequestFullscreen();
     }
+    result?.catch(() => {
+    });
   }, [fullscreenContainerRef]);
   const exit = react.useCallback(() => {
+    let result;
     if (document.exitFullscreen) {
-      document.exitFullscreen();
+      result = document.exitFullscreen();
     } else if ("webkitExitFullscreen" in document) {
       document.webkitExitFullscreen();
     } else if ("msExitFullscreen" in document) {
       document.msExitFullscreen();
     }
+    result?.catch(() => {
+    });
   }, []);
   const toggle = react.useCallback(() => {
     if (isFullscreen) {
@@ -1730,6 +1821,7 @@ function useFullscreen() {
 function useOrderLines() {
   const { state } = useKlinechartsUI();
   const callbacksRef = react.useRef(/* @__PURE__ */ new Map());
+  const ownedIdsRef = react.useRef(/* @__PURE__ */ new Set());
   const createOrderLine = react.useCallback(
     (options) => {
       if (!state.chart) return null;
@@ -1760,6 +1852,7 @@ function useOrderLines() {
           }
         }
       });
+      ownedIdsRef.current.add(id);
       return id;
     },
     [state.chart]
@@ -1791,12 +1884,28 @@ function useOrderLines() {
     (id) => {
       state.chart?.removeOverlay({ id });
       callbacksRef.current.delete(id);
+      ownedIdsRef.current.delete(id);
     },
     [state.chart]
   );
   const removeAllOrderLines = react.useCallback(() => {
     state.chart?.removeOverlay({ name: "orderLine" });
     callbacksRef.current.clear();
+    ownedIdsRef.current.clear();
+  }, [state.chart]);
+  react.useEffect(() => {
+    const chart = state.chart;
+    const owned = ownedIdsRef.current;
+    return () => {
+      owned.forEach((id) => {
+        try {
+          chart?.removeOverlay({ id });
+        } catch {
+        }
+      });
+      owned.clear();
+      callbacksRef.current.clear();
+    };
   }, [state.chart]);
   return {
     createOrderLine,
@@ -1814,6 +1923,14 @@ function useUndoRedo() {
   const isProcessingRef = react.useRef(false);
   const canUndo = undoStack.length > 0;
   const canRedo = redoStack.length > 0;
+  const undoStackRef = react.useRef([]);
+  const redoStackRef = react.useRef([]);
+  react.useEffect(() => {
+    undoStackRef.current = undoStack;
+  }, [undoStack]);
+  react.useEffect(() => {
+    redoStackRef.current = redoStack;
+  }, [redoStack]);
   const pushAction = react.useCallback((action) => {
     if (isProcessingRef.current) return;
     setUndoStack((prev) => [...prev, action]);
@@ -1830,10 +1947,11 @@ function useUndoRedo() {
     setRedoStack([]);
   }, []);
   const undo = react.useCallback(() => {
-    if (undoStack.length === 0 || !state.chart || isProcessingRef.current)
+    const stack = undoStackRef.current;
+    if (stack.length === 0 || !state.chart || isProcessingRef.current)
       return;
     isProcessingRef.current = true;
-    const action = undoStack[undoStack.length - 1];
+    const action = stack[stack.length - 1];
     setUndoStack((prev) => prev.slice(0, -1));
     try {
       switch (action.type) {
@@ -1954,12 +2072,13 @@ function useUndoRedo() {
     } finally {
       isProcessingRef.current = false;
     }
-  }, [undoStack, state.chart, state.mainIndicators, state.subIndicators, state.indicatorAxes, dispatch]);
+  }, [state.chart, state.mainIndicators, state.subIndicators, state.indicatorAxes, dispatch]);
   const redo = react.useCallback(() => {
-    if (redoStack.length === 0 || !state.chart || isProcessingRef.current)
+    const stack = redoStackRef.current;
+    if (stack.length === 0 || !state.chart || isProcessingRef.current)
       return;
     isProcessingRef.current = true;
-    const action = redoStack[redoStack.length - 1];
+    const action = stack[stack.length - 1];
     setRedoStack((prev) => prev.slice(0, -1));
     try {
       switch (action.type) {
@@ -2084,7 +2203,7 @@ function useUndoRedo() {
     } finally {
       isProcessingRef.current = false;
     }
-  }, [redoStack, state.chart, state.mainIndicators, state.subIndicators, state.indicatorAxes, dispatch]);
+  }, [state.chart, state.mainIndicators, state.subIndicators, state.indicatorAxes, dispatch]);
   react.useEffect(() => {
     const handleKeyDown = (e) => {
       const isCtrlOrMeta = e.ctrlKey || e.metaKey;
@@ -2122,6 +2241,7 @@ function generateId() {
   );
 }
 function getLayoutIds() {
+  if (typeof localStorage === "undefined") return [];
   try {
     const raw = localStorage.getItem(INDEX_KEY);
     return raw ? JSON.parse(raw) : [];
@@ -2130,6 +2250,7 @@ function getLayoutIds() {
   }
 }
 function getEntry(id) {
+  if (typeof localStorage === "undefined") return null;
   try {
     const raw = localStorage.getItem(STORAGE_KEY_PREFIX + id);
     return raw ? JSON.parse(raw) : null;
@@ -2139,35 +2260,31 @@ function getEntry(id) {
 }
 function useLayoutManager() {
   const { state, dispatch } = useKlinechartsUI();
-  const [layouts, setLayouts] = react.useState([]);
+  const [layouts, setLayouts] = react.useState(
+    () => getLayoutIds().map((id) => getEntry(id)).filter((e) => e !== null)
+  );
   const [autoSaveEnabled, setAutoSaveEnabled] = react.useState(false);
   const autoSaveTimerRef = react.useRef(null);
   const autoSaveIdRef = react.useRef(null);
   const refreshLayouts = react.useCallback(() => {
-    const entries = getLayoutIds().map((id) => getEntry(id)).filter((e) => e !== null);
-    setLayouts(entries);
+    setLayouts(
+      getLayoutIds().map((id) => getEntry(id)).filter((e) => e !== null)
+    );
   }, []);
-  react.useEffect(() => {
-    refreshLayouts();
-  }, [refreshLayouts]);
   const serializeState = react.useCallback(() => {
     const chart = state.chart;
     if (!chart) return null;
     const indicators2 = [];
-    const indicatorMap = chart.getIndicatorByPaneId?.();
-    if (indicatorMap) {
-      indicatorMap.forEach((paneIndicators, paneId) => {
-        paneIndicators.forEach((indicator) => {
-          const yAxisId = state.indicatorAxes[indicator.id];
-          indicators2.push({
-            paneId,
-            name: indicator.name,
-            calcParams: indicator.calcParams,
-            visible: indicator.visible,
-            ...indicator.styles ? { styles: indicator.styles } : {},
-            ...yAxisId ? { yAxisId } : {}
-          });
-        });
+    const allIndicators = chart.getIndicators();
+    for (const indicator of allIndicators) {
+      const yAxisId = state.indicatorAxes[indicator.id];
+      indicators2.push({
+        paneId: indicator.paneId,
+        name: indicator.name,
+        calcParams: indicator.calcParams,
+        visible: indicator.visible,
+        ...indicator.styles ? { styles: indicator.styles } : {},
+        ...yAxisId ? { yAxisId } : {}
       });
     }
     const drawings = [];
@@ -2231,13 +2348,8 @@ function useLayoutManager() {
       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 });
-          });
-        });
+      for (const indicator of chart.getIndicators()) {
+        chart.removeIndicator({ id: indicator.id });
       }
       const newMainIndicators = [];
       const newSubIndicators = {};
@@ -2255,7 +2367,12 @@ function useLayoutManager() {
               visible: ind.visible
             },
             {
-              isStack: ind.paneId !== "candle_pane",
+              // Main indicators stack OVER the candle series on the candle
+              // pane (isStack: true), exactly as useIndicators does on the
+              // add path. The previous `ind.paneId !== "candle_pane"` inverted
+              // this, so loading a layout with main indicators replaced the
+              // candles instead of overlaying them.
+              isStack: isMain,
               pane: { id: ind.paneId },
               ...ind.yAxisId ? { yAxis: { id: ind.yAxisId } } : {}
             }
@@ -2455,8 +2572,10 @@ function useScriptEditor() {
   const [status, setStatus] = react.useState("");
   const [isRunning, setIsRunning] = react.useState(false);
   const activeIdRef = react.useRef(null);
+  const [activeName, setActiveName] = react.useState(null);
   const activeNameRef = react.useRef(null);
-  const hasActiveScript = activeNameRef.current !== null;
+  activeNameRef.current = activeName;
+  const hasActiveScript = activeName !== null;
   const runScript = react.useCallback(() => {
     const chart = state.chart;
     if (!chart) {
@@ -2477,31 +2596,38 @@ function useScriptEditor() {
         `"use strict";
 ${code}`
       ];
-      const fn = new Function(...allArgs);
+      const compiledFn = new Function(...allArgs);
       const shadowValues = SHADOW_KEYS.map(() => void 0);
-      const result = fn(...shadowValues, chunkUJNJH3BS_cjs.TA_default, dataList, parsedParams);
-      if (!Array.isArray(result)) {
+      const sampleResult = compiledFn(
+        ...shadowValues,
+        chunkLGYYJ2GP_cjs.TA_default,
+        dataList,
+        parsedParams
+      );
+      if (!Array.isArray(sampleResult)) {
         throw new Error("Script must return an Array.");
       }
-      const sample = result.find((v) => v !== null && v !== void 0);
+      const sample = sampleResult.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 indicatorName = `_custom_script_active`;
       const figures = seriesKeys.map((key, i) => ({
         key,
         title: `${key}: `,
         type: "line",
         styles: () => ({ color: SERIES_COLORS[i % SERIES_COLORS.length] })
       }));
-      reactKlinecharts.registerIndicator({
+      klinecharts.registerIndicator({
         name: indicatorName,
         shortName: (scriptName.trim() || `Script #${scriptCounter}`) + (placement === "main" ? " (Main)" : " (Sub)"),
         calcParams: parsedParams,
         figures,
-        calc: () => result,
+        calc: (liveDataList) => compiledFn(...shadowValues, chunkLGYYJ2GP_cjs.TA_default, liveDataList, parsedParams),
         extendData: {
           isCustomScript: true,
           code,
@@ -2527,7 +2653,7 @@ ${code}`
         paneId = chart.createIndicator({ name: indicatorName });
       }
       activeIdRef.current = typeof paneId === "string" ? paneId : null;
-      activeNameRef.current = indicatorName;
+      setActiveName(indicatorName);
       const title = scriptName.trim() || `Script #${scriptCounter}`;
       setStatus(
         `${title} applied to ${placement === "main" ? "Main Chart" : "Sub Pane"} \u2014 ${seriesKeys.length} series: ${seriesKeys.join(", ")}`
@@ -2549,7 +2675,7 @@ ${code}`
       } catch {
       }
       activeIdRef.current = null;
-      activeNameRef.current = null;
+      setActiveName(null);
       setStatus("Indicator removed.");
     }
   }, [state.chart]);
@@ -2666,52 +2792,48 @@ function useAlerts() {
   const { alertTriggeredListenerRef } = useKlinechartsUIDispatch();
   const alerts = state.alerts;
   const addAlert = react.useCallback(
-    (price, condition, message) => {
+    (price, condition, message, extendData) => {
       const id = `alert_${++alertCounter}`;
+      const precision = state.chart?.getSymbol()?.pricePrecision ?? 2;
+      const resolvedExtendData = {
+        ...extendData,
+        text: extendData?.text ?? message ?? price.toFixed(precision)
+      };
       const alert = {
         id,
         price,
         condition,
         message,
-        triggered: false
+        triggered: false,
+        extendData: resolvedExtendData
       };
-      dispatch({ type: "SET_ALERTS", alerts: [...state.alerts, alert] });
+      dispatch({ type: "ADD_ALERT", alert });
       if (state.chart) {
+        chunkLGYYJ2GP_cjs.ensureAlertLineRegistered();
         state.chart.createOverlay({
-          name: "horizontalStraightLine",
+          name: "alertLine",
           id,
           groupId: "price_alerts",
           points: [{ value: price }],
-          styles: {
-            line: {
-              style: "dashed",
-              color: "#ff9800",
-              size: 1
-            }
-          },
+          extendData: resolvedExtendData,
           lock: true
         });
       }
       return id;
     },
-    [state.chart, state.alerts, dispatch]
+    [state.chart, dispatch]
   );
   const removeAlert = react.useCallback(
     (id) => {
-      dispatch({
-        type: "SET_ALERTS",
-        alerts: state.alerts.filter((a) => a.id !== id)
-      });
+      dispatch({ type: "REMOVE_ALERT", id });
       state.chart?.removeOverlay({ id });
     },
-    [state.chart, state.alerts, dispatch]
+    [state.chart, dispatch]
   );
   const clearAlerts = react.useCallback(() => {
-    for (const alert of state.alerts) {
-      state.chart?.removeOverlay({ id: alert.id });
-    }
-    dispatch({ type: "SET_ALERTS", alerts: [] });
-  }, [state.chart, state.alerts, dispatch]);
+    state.chart?.removeOverlay({ groupId: "price_alerts" });
+    dispatch({ type: "CLEAR_ALERTS" });
+  }, [state.chart, dispatch]);
   const onAlertTriggered = react.useCallback(
     (callback) => {
       alertTriggeredListenerRef.current = callback;
@@ -2895,6 +3017,7 @@ function useReplay() {
   );
   const startReplay = react.useCallback(() => {
     if (!state.chart) return;
+    if (isReplaying) return;
     const dataList = state.chart.getDataList();
     if (!dataList || dataList.length === 0) return;
     replaySavedDataRef.current = [...dataList];
@@ -2910,7 +3033,12 @@ function useReplay() {
     });
     state.chart.clearData?.();
     startInterval(speed);
-  }, [state.chart, speed, startInterval, replaySavedDataRef, replayIndexRef, dispatch]);
+  }, [state.chart, state.symbol, state.period, speed, startInterval, isReplaying, replaySavedDataRef, replayIndexRef, dispatch]);
+  react.useEffect(() => {
+    if (isReplaying) {
+      stopReplay();
+    }
+  }, [state.symbol, state.period]);
   const stopReplay = react.useCallback(() => {
     if (!state.chart) return;
     clearInterval_();
@@ -3006,24 +3134,29 @@ var DEFAULT_COLORS = [
   "#ff5722",
   "#8bc34a"
 ];
-var colorIndex = 0;
-var compareCounter = 0;
 function useCompare() {
   const { state, datafeed } = useKlinechartsUI();
   const [symbols, setSymbols] = react.useState([]);
   const indicatorsRef = react.useRef(/* @__PURE__ */ new Map());
+  const instanceSalt = react.useId().replace(/[^a-zA-Z0-9]/g, "");
   const addSymbol = react.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 assignedColor = color ?? DEFAULT_COLORS[symbols.length % 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 mainSymbol = state.symbol;
+      const symbol = {
+        ticker,
+        pricePrecision: mainSymbol?.pricePrecision ?? 2,
+        volumePrecision: mainSymbol?.volumePrecision ?? 8
+      };
       const compareData = await datafeed.getHistoryKLineData(
-        { ticker },
-        { ...state.period, label: "" },
+        symbol,
+        state.period,
         from,
         to
       );
@@ -3042,14 +3175,8 @@ function useCompare() {
       }
       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}`;
-      reactKlinecharts.registerIndicator({
+      const indicatorName = `__cmp_${instanceSalt}_${ticker}`;
+      klinecharts.registerIndicator({
         name: indicatorName,
         shortName: ticker,
         figures: [
@@ -3060,7 +3187,16 @@ function useCompare() {
             styles: () => ({ color: assignedColor })
           }
         ],
-        calc: () => normalizedData
+        calc: (dataList) => {
+          let lastPct = null;
+          return dataList.map((bar) => {
+            const close = compareMap.get(bar.timestamp);
+            if (close != null) {
+              lastPct = (close - bp) / bp * 100;
+            }
+            return { pct: lastPct };
+          });
+        }
       });
       const paneId = state.chart.createIndicator(
         { name: indicatorName },
@@ -3078,7 +3214,7 @@ function useCompare() {
         ];
       });
     },
-    [state.chart, state.period, datafeed]
+    [state.chart, state.symbol, state.period, datafeed, symbols.length, instanceSalt]
   );
   const removeSymbol = react.useCallback(
     (ticker) => {
@@ -3288,13 +3424,11 @@ function useAnnotations() {
     [state.chart]
   );
   const clearAnnotations = react.useCallback(() => {
-    setAnnotations((prev) => {
-      for (const annotation of prev) {
-        state.chart?.removeOverlay({ id: annotation.id });
-      }
-      return [];
-    });
-  }, [state.chart]);
+    for (const annotation of annotations) {
+      state.chart?.removeOverlay({ id: annotation.id });
+    }
+    setAnnotations([]);
+  }, [state.chart, annotations]);
   react.useEffect(() => {
     return () => {
       state.chart?.removeOverlay({ groupId: "annotations" });
@@ -3375,175 +3509,179 @@ function createDataLoader(datafeed, dispatch) {
 
 Object.defineProperty(exports, "TA", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.TA_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.TA_default; }
 });
 Object.defineProperty(exports, "abcd", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.abcd_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.abcd_default; }
+});
+Object.defineProperty(exports, "alertLine", {
+  enumerable: true,
+  get: function () { return chunkLGYYJ2GP_cjs.alertLine_default; }
 });
 Object.defineProperty(exports, "anyWaves", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.anyWaves_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.anyWaves_default; }
 });
 Object.defineProperty(exports, "arrow", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.arrow_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.arrow_default; }
 });
 Object.defineProperty(exports, "bollTv", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.bollTv_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.bollTv_default; }
 });
 Object.defineProperty(exports, "brush", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.brush_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.brush_default; }
 });
 Object.defineProperty(exports, "cci", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.cci_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.cci_default; }
 });
 Object.defineProperty(exports, "circle", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.circle_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.circle_default; }
 });
 Object.defineProperty(exports, "depthOverlay", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.depthOverlay_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.depthOverlay_default; }
 });
 Object.defineProperty(exports, "eightWaves", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.eightWaves_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.eightWaves_default; }
 });
 Object.defineProperty(exports, "elliottWave", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.elliottWave_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.elliottWave_default; }
 });
 Object.defineProperty(exports, "fibRetracement", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.fibRetracement_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.fibRetracement_default; }
 });
 Object.defineProperty(exports, "fibonacciCircle", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.fibonacciCircle_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.fibonacciCircle_default; }
 });
 Object.defineProperty(exports, "fibonacciExtension", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.fibonacciExtension_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.fibonacciExtension_default; }
 });
 Object.defineProperty(exports, "fibonacciSegment", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.fibonacciSegment_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.fibonacciSegment_default; }
 });
 Object.defineProperty(exports, "fibonacciSpeedResistanceFan", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.fibonacciSpeedResistanceFan_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.fibonacciSpeedResistanceFan_default; }
 });
 Object.defineProperty(exports, "fibonacciSpiral", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.fibonacciSpiral_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.fibonacciSpiral_default; }
 });
 Object.defineProperty(exports, "fiveWaves", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.fiveWaves_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.fiveWaves_default; }
 });
 Object.defineProperty(exports, "gannBox", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.gannBox_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.gannBox_default; }
 });
 Object.defineProperty(exports, "gannFan", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.gannFan_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.gannFan_default; }
 });
 Object.defineProperty(exports, "hma", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.hma_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.hma_default; }
 });
 Object.defineProperty(exports, "ichimoku", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.ichimoku_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.ichimoku_default; }
 });
 Object.defineProperty(exports, "indicators", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.indicators; }
+  get: function () { return chunkLGYYJ2GP_cjs.indicators; }
 });
 Object.defineProperty(exports, "longPosition", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.longPosition_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.longPosition_default; }
 });
 Object.defineProperty(exports, "maRibbon", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.maRibbon_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.maRibbon_default; }
 });
 Object.defineProperty(exports, "macdTv", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.macdTv_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.macdTv_default; }
 });
 Object.defineProperty(exports, "measure", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.measure_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.measure_default; }
 });
 Object.defineProperty(exports, "orderLine", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.orderLine_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.orderLine_default; }
 });
 Object.defineProperty(exports, "overlays", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.overlays; }
+  get: function () { return chunkLGYYJ2GP_cjs.overlays; }
 });
 Object.defineProperty(exports, "parallelChannel", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.parallelChannel_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.parallelChannel_default; }
 });
 Object.defineProperty(exports, "parallelogram", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.parallelogram_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.parallelogram_default; }
 });
 Object.defineProperty(exports, "pivotPoints", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.pivotPoints_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.pivotPoints_default; }
 });
 Object.defineProperty(exports, "ray", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.ray_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.ray_default; }
 });
 Object.defineProperty(exports, "rect", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.rect_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.rect_default; }
 });
 Object.defineProperty(exports, "registerExtensions", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.registerExtensions; }
+  get: function () { return chunkLGYYJ2GP_cjs.registerExtensions; }
 });
 Object.defineProperty(exports, "rsiTv", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.rsiTv_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.rsiTv_default; }
 });
 Object.defineProperty(exports, "shortPosition", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.shortPosition_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.shortPosition_default; }
 });
 Object.defineProperty(exports, "stochastic", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.stochastic_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.stochastic_default; }
 });
 Object.defineProperty(exports, "superTrend", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.superTrend_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.superTrend_default; }
 });
 Object.defineProperty(exports, "threeWaves", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.threeWaves_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.threeWaves_default; }
 });
 Object.defineProperty(exports, "triangle", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.triangle_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.triangle_default; }
 });
 Object.defineProperty(exports, "vwap", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.vwap_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.vwap_default; }
 });
 Object.defineProperty(exports, "xabcd", {
   enumerable: true,
-  get: function () { return chunkUJNJH3BS_cjs.xabcd_default; }
+  get: function () { return chunkLGYYJ2GP_cjs.xabcd_default; }
 });
 exports.CANDLE_TYPES = CANDLE_TYPES;
 exports.COMPARE_RULES = COMPARE_RULES;
@@ -3562,11 +3700,13 @@ exports.YAXIS_POSITIONS = YAXIS_POSITIONS;
 exports.createDataLoader = createDataLoader;
 exports.useAlerts = useAlerts;
 exports.useAnnotations = useAnnotations;
+exports.useChartAxes = useChartAxes;
 exports.useCompare = useCompare;
 exports.useCrosshair = useCrosshair;
 exports.useDataExport = useDataExport;
 exports.useDrawingTools = useDrawingTools;
 exports.useFullscreen = useFullscreen;
+exports.useHotkeys = useHotkeys;
 exports.useIndicators = useIndicators;
 exports.useKlinechartsUI = useKlinechartsUI;
 exports.useKlinechartsUILoading = useKlinechartsUILoading;