react-klinecharts-ui 1.0.0 → 1.1.0

package/dist/index.cjs

@@ -1,32 +1,12 @@
 'use strict';
 
-var chunkLGYYJ2GP_cjs = require('./chunk-LGYYJ2GP.cjs');
+var chunkSZDU2D3D_cjs = require('./chunk-SZDU2D3D.cjs');
+var chunkF24D6PWY_cjs = require('./chunk-F24D6PWY.cjs');
+require('./chunk-Q7SFCCGT.cjs');
 var react = require('react');
 var klinecharts = require('klinecharts');
 var jsxRuntime = require('react/jsx-runtime');
 
-var KlinechartsUIStateContext = react.createContext(null);
-var KlinechartsUIDispatchContext = react.createContext(null);
-function useKlinechartsUIDispatch() {
-  const ctx = react.useContext(KlinechartsUIDispatchContext);
-  if (!ctx) {
-    throw new Error(
-      "useKlinechartsUI must be used within a <KlinechartsUIProvider>"
-    );
-  }
-  return ctx;
-}
-function useKlinechartsUI() {
-  const state = react.useContext(KlinechartsUIStateContext);
-  const dispatch = react.useContext(KlinechartsUIDispatchContext);
-  if (!state || !dispatch) {
-    throw new Error(
-      "useKlinechartsUI must be used within a <KlinechartsUIProvider>"
-    );
-  }
-  return { state, ...dispatch };
-}
-
 // src/data/periods.ts
 var DEFAULT_PERIODS = [
   { span: 1, type: "minute", label: "1m" },
@@ -40,6 +20,50 @@ var DEFAULT_PERIODS = [
   { span: 1, type: "month", label: "M" },
   { span: 1, type: "year", label: "Y" }
 ];
+
+// src/storage/types.ts
+var DEFAULT_STORAGE_NAMESPACES = [
+  "alerts",
+  "settings",
+  "indicators"
+];
+var DEFAULT_STORAGE_KEY_PREFIX = "rkui:";
+
+// src/storage/createDefaultStorage.ts
+var NOOP_ADAPTER = {
+  getItem: () => null,
+  setItem: () => {
+  },
+  removeItem: () => {
+  }
+};
+function createDefaultStorage() {
+  if (typeof localStorage === "undefined") return NOOP_ADAPTER;
+  try {
+    const probe = localStorage.getItem("__rkui_probe__");
+    return probe === null ? localStorage : localStorage;
+  } catch {
+    return NOOP_ADAPTER;
+  }
+}
+function resolveStorage(options) {
+  const adapter = options?.adapter ?? createDefaultStorage();
+  const keyPrefix = options?.keyPrefix ?? DEFAULT_STORAGE_KEY_PREFIX;
+  const namespaces = new Set(
+    options?.namespaces ?? DEFAULT_STORAGE_NAMESPACES
+  );
+  return {
+    adapter,
+    namespaces,
+    keyPrefix,
+    key(namespace) {
+      return `${keyPrefix}${namespace}`;
+    },
+    persists(namespace) {
+      return namespaces.has(namespace);
+    }
+  };
+}
 function reducer(state, action) {
   switch (action.type) {
     case "SET_CHART":
@@ -103,13 +127,16 @@ function KlinechartsUIProvider({
   defaultPeriod,
   defaultTheme = "light",
   defaultTimezone = "Asia/Shanghai",
-  defaultMainIndicators = ["MA"],
-  defaultSubIndicators = ["VOL"],
+  // NOTE: no destructuring default here — the init function must distinguish
+  // "consumer passed default*" (wins) from "use stored value" (hydrate).
+  defaultMainIndicators,
+  defaultSubIndicators,
   defaultLocale = "en-US",
   periods,
   styles,
   registerExtensions: shouldRegister = true,
   overlays: extraOverlays,
+  storage: storageOptions,
   children,
   onStateChange,
   onSymbolChange,
@@ -120,6 +147,11 @@ function KlinechartsUIProvider({
   onSubIndicatorsChange,
   onSettingsChange
 }) {
+  const resolvedStorage = react.useMemo(
+    () => storageOptions ? resolveStorage(storageOptions) : null,
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    []
+  );
   const [state, dispatch] = react.useReducer(
     reducer,
     {
@@ -132,41 +164,61 @@ function KlinechartsUIProvider({
       defaultSubIndicators,
       defaultLocale,
       periods,
-      styles
-    },
-    (opts) => ({
-      chart: null,
-      datafeed: opts.datafeed,
-      symbol: opts.defaultSymbol ?? null,
-      period: opts.defaultPeriod ?? (opts.periods ?? DEFAULT_PERIODS)[0],
-      theme: opts.defaultTheme ?? "light",
-      timezone: opts.defaultTimezone ?? "Asia/Shanghai",
-      isLoading: false,
-      locale: opts.defaultLocale ?? "en-US",
-      periods: opts.periods ?? DEFAULT_PERIODS,
-      mainIndicators: opts.defaultMainIndicators ?? ["MA"],
-      subIndicators: (opts.defaultSubIndicators ?? ["VOL"]).reduce(
-        (acc, name) => ({ ...acc, [name]: "" }),
-        {}
-      ),
-      indicatorAxes: {},
-      indicatorVisibility: {},
-      alerts: [],
-      measure: { isActive: false, fromPoint: null, result: null },
-      replay: {
-        isReplaying: false,
-        isPaused: false,
-        speed: 1,
-        barIndex: 0,
-        totalBars: 0
-      },
-      styles: opts.styles,
-      screenshotUrl: null
-    })
+      styles,
+      storage: resolvedStorage
+    },
+    (opts) => {
+      const s = opts.storage;
+      const read = (ns, fallback) => {
+        if (!s || !s.persists(ns)) return fallback;
+        try {
+          const raw = s.adapter.getItem(s.key(ns));
+          return raw ? JSON.parse(raw) : fallback;
+        } catch {
+          return fallback;
+        }
+      };
+      const storedIndicators = read("indicators", {});
+      return {
+        chart: null,
+        datafeed: opts.datafeed,
+        symbol: opts.defaultSymbol ?? null,
+        period: opts.defaultPeriod ?? (opts.periods ?? DEFAULT_PERIODS)[0],
+        theme: opts.defaultTheme ?? "light",
+        timezone: opts.defaultTimezone ?? "Asia/Shanghai",
+        isLoading: false,
+        locale: opts.defaultLocale ?? "en-US",
+        periods: opts.periods ?? DEFAULT_PERIODS,
+        // Persistence semantics: STORED values win over `default*` props —
+        // the user's saved configuration should survive reload even when the
+        // app passes defaults. Only when storage is empty/unconfigured do the
+        // `default*` props apply, falling back to the built-ins last.
+        // (Settings live in useKlinechartsUISettings useState and hydrate
+        // separately via the dispatch-context `storage`.)
+        mainIndicators: storedIndicators.main ?? opts.defaultMainIndicators ?? ["MA"],
+        subIndicators: storedIndicators.sub ?? (opts.defaultSubIndicators ? opts.defaultSubIndicators.reduce(
+          (acc, name) => ({ ...acc, [name]: "" }),
+          {}
+        ) : { VOL: "" }),
+        indicatorAxes: storedIndicators.axes ?? {},
+        indicatorVisibility: storedIndicators.visibility ?? {},
+        alerts: read("alerts", []),
+        measure: { isActive: false, fromPoint: null, result: null },
+        replay: {
+          isReplaying: false,
+          isPaused: false,
+          speed: 1,
+          barIndex: 0,
+          totalBars: 0
+        },
+        styles: opts.styles,
+        screenshotUrl: null
+      };
+    }
   );
   const fullscreenContainerRef = react.useRef(null);
   const undoRedoListenerRef = react.useRef(null);
-  const alertTriggeredListenerRef = react.useRef(null);
+  const alertTriggeredListenersRef = react.useRef(/* @__PURE__ */ new Set());
   const replayIntervalRef = react.useRef(null);
   const replaySavedDataRef = react.useRef([]);
   const replayIndexRef = react.useRef(0);
@@ -230,7 +282,7 @@ function KlinechartsUIProvider({
   });
   react.useEffect(() => {
     if (shouldRegister) {
-      chunkLGYYJ2GP_cjs.registerExtensions();
+      chunkSZDU2D3D_cjs.registerExtensions();
     }
     extraOverlaysRef.current?.forEach((overlay) => klinecharts.registerOverlay(overlay));
   }, [shouldRegister]);
@@ -244,23 +296,53 @@ function KlinechartsUIProvider({
     const chart = state.chart;
     if (!chart || !hasAlerts) return;
     alertPrevCloseRef.current = null;
+    const prevValueByAlert = /* @__PURE__ */ new Map();
     const interval = setInterval(() => {
       const dataList = chart.getDataList();
       if (!dataList || dataList.length === 0) return;
-      const currentClose = dataList[dataList.length - 1].close;
-      const prevClose = alertPrevCloseRef.current;
-      alertPrevCloseRef.current = currentClose;
-      if (prevClose === null) return;
+      const lastIdx = dataList.length - 1;
+      const indicatorCache = /* @__PURE__ */ new Map();
+      const readIndicatorValue = (indicatorId, figureKey) => {
+        const cacheKey = `${indicatorId}:${figureKey}`;
+        if (indicatorCache.has(cacheKey)) return indicatorCache.get(cacheKey);
+        let value = null;
+        try {
+          const indicators2 = chart.getIndicators({ id: indicatorId });
+          const ind = indicators2?.[0];
+          const result = ind?.result;
+          const last = Array.isArray(result) ? result[lastIdx] : null;
+          if (last && typeof last === "object") {
+            const v = last[figureKey];
+            value = typeof v === "number" ? v : null;
+          }
+        } catch {
+          value = null;
+        }
+        indicatorCache.set(cacheKey, value);
+        return value;
+      };
       const alerts = stateRef.current.alerts;
       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 target = alert.target ?? { type: "price" };
+        let currentValue;
+        if (target.type === "indicator") {
+          currentValue = readIndicatorValue(target.indicatorId, target.figureKey);
+        } else {
+          currentValue = dataList[lastIdx].close;
+        }
+        if (currentValue === null || !Number.isFinite(currentValue)) continue;
+        const prevValue = prevValueByAlert.get(alert.id) ?? null;
+        prevValueByAlert.set(alert.id, currentValue);
+        if (prevValue === null) continue;
+        const crossedUp = prevValue < alert.price && currentValue >= alert.price;
+        const crossedDown = prevValue > alert.price && currentValue <= alert.price;
         const shouldTrigger = alert.condition === "crossing_up" ? crossedUp : alert.condition === "crossing_down" ? crossedDown : crossedUp || crossedDown;
         if (shouldTrigger) {
           triggeredIds.push(alert.id);
-          alertTriggeredListenerRef.current?.({ ...alert, triggered: true });
+          const fired = { ...alert, triggered: true };
+          alertTriggeredListenersRef.current.forEach((cb) => cb(fired));
         }
       }
       if (triggeredIds.length > 0) {
@@ -275,6 +357,36 @@ function KlinechartsUIProvider({
   react.useEffect(() => {
     alertPrevCloseRef.current = null;
   }, [state.symbol, state.period]);
+  const writeNs = react.useCallback(
+    (ns, value) => {
+      if (!resolvedStorage || !resolvedStorage.persists(ns)) return;
+      try {
+        resolvedStorage.adapter.setItem(
+          resolvedStorage.key(ns),
+          JSON.stringify(value)
+        );
+      } catch {
+      }
+    },
+    [resolvedStorage]
+  );
+  react.useEffect(() => {
+    writeNs("alerts", state.alerts);
+  }, [state.alerts, writeNs]);
+  react.useEffect(() => {
+    writeNs("indicators", {
+      main: state.mainIndicators,
+      sub: state.subIndicators,
+      axes: state.indicatorAxes,
+      visibility: state.indicatorVisibility
+    });
+  }, [
+    state.mainIndicators,
+    state.subIndicators,
+    state.indicatorAxes,
+    state.indicatorVisibility,
+    writeNs
+  ]);
   react.useEffect(() => {
     return () => {
       if (replayIntervalRef.current !== null) {
@@ -290,18 +402,19 @@ function KlinechartsUIProvider({
       onSettingsChange: onSettingsChangeRef.current,
       fullscreenContainerRef,
       undoRedoListenerRef,
-      alertTriggeredListenerRef,
+      alertTriggeredListenersRef,
       replayIntervalRef,
       replaySavedDataRef,
-      replayIndexRef
+      replayIndexRef,
+      storage: resolvedStorage
     }),
     // eslint-disable-next-line react-hooks/exhaustive-deps
-    [enhancedDispatch]
+    [enhancedDispatch, resolvedStorage]
   );
-  return /* @__PURE__ */ jsxRuntime.jsx(KlinechartsUIStateContext.Provider, { value: state, children: /* @__PURE__ */ jsxRuntime.jsx(KlinechartsUIDispatchContext.Provider, { value: dispatchValue, children }) });
+  return /* @__PURE__ */ jsxRuntime.jsx(chunkF24D6PWY_cjs.KlinechartsUIStateContext.Provider, { value: state, children: /* @__PURE__ */ jsxRuntime.jsx(chunkF24D6PWY_cjs.KlinechartsUIDispatchContext.Provider, { value: dispatchValue, children }) });
 }
 function useKlinechartsUITheme() {
-  const { state, dispatch } = useKlinechartsUI();
+  const { state, dispatch } = chunkF24D6PWY_cjs.useKlinechartsUI();
   const setTheme = react.useCallback(
     (theme) => {
       state.chart?.setStyles(theme);
@@ -322,11 +435,11 @@ function useKlinechartsUITheme() {
 
 // src/hooks/useKlinechartsUILoading.ts
 function useKlinechartsUILoading() {
-  const { state } = useKlinechartsUI();
+  const { state } = chunkF24D6PWY_cjs.useKlinechartsUI();
   return { isLoading: state.isLoading };
 }
 function usePeriods() {
-  const { state, dispatch } = useKlinechartsUI();
+  const { state, dispatch } = chunkF24D6PWY_cjs.useKlinechartsUI();
   const setPeriod = react.useCallback(
     (period) => {
       dispatch({ type: "SET_PERIOD", period });
@@ -364,7 +477,7 @@ var TIMEZONES = [
 
 // src/hooks/useTimezone.ts
 function useTimezone() {
-  const { state, dispatch } = useKlinechartsUI();
+  const { state, dispatch } = chunkF24D6PWY_cjs.useKlinechartsUI();
   const timezones = react.useMemo(
     () => TIMEZONES.map((tz) => ({
       key: tz.key,
@@ -386,7 +499,7 @@ function useTimezone() {
   };
 }
 function useSymbolSearch(debounceMs = 300) {
-  const { state, dispatch, datafeed } = useKlinechartsUI();
+  const { state, dispatch, datafeed } = chunkF24D6PWY_cjs.useKlinechartsUI();
   const [query, setQueryState] = react.useState("");
   const [results, setResults] = react.useState([]);
   const [isSearching, setIsSearching] = react.useState(false);
@@ -748,8 +861,8 @@ var INDICATOR_PARAMS = {
 // src/hooks/useIndicators.ts
 var COLLAPSED_HEIGHT = 30;
 function useIndicators() {
-  const { state, dispatch } = useKlinechartsUI();
-  const { undoRedoListenerRef } = useKlinechartsUIDispatch();
+  const { state, dispatch } = chunkF24D6PWY_cjs.useKlinechartsUI();
+  const { undoRedoListenerRef } = chunkF24D6PWY_cjs.useKlinechartsUIDispatch();
   const paneHeightsRef = react.useRef({});
   const collapsedPanesRef = react.useRef(/* @__PURE__ */ new Set());
   const mainIndicators = react.useMemo(() => {
@@ -1246,8 +1359,8 @@ var DRAWING_CATEGORIES = [
 // src/hooks/useDrawingTools.ts
 var DRAWING_GROUP_ID = "drawing_tools";
 function useDrawingTools() {
-  const { state } = useKlinechartsUI();
-  const { undoRedoListenerRef } = useKlinechartsUIDispatch();
+  const { state } = chunkF24D6PWY_cjs.useKlinechartsUI();
+  const { undoRedoListenerRef } = chunkF24D6PWY_cjs.useKlinechartsUIDispatch();
   const [activeTool, setActiveTool] = react.useState(null);
   const [magnetMode, setMagnetModeState] = react.useState("normal");
   const [isLocked, setIsLocked] = react.useState(false);
@@ -1437,8 +1550,18 @@ var defaultSettings = {
   tooltipShowRule: "always"
 };
 function useKlinechartsUISettings() {
-  const { state, onSettingsChange } = useKlinechartsUI();
-  const [settings, setSettings] = react.useState(defaultSettings);
+  const { state, onSettingsChange } = chunkF24D6PWY_cjs.useKlinechartsUI();
+  const { storage } = chunkF24D6PWY_cjs.useKlinechartsUIDispatch();
+  const [settings, setSettings] = react.useState(() => {
+    if (storage && storage.persists("settings")) {
+      try {
+        const raw = storage.adapter.getItem(storage.key("settings"));
+        if (raw) return { ...defaultSettings, ...JSON.parse(raw) };
+      } catch {
+      }
+    }
+    return defaultSettings;
+  });
   const isInitialMount = react.useRef(true);
   react.useEffect(() => {
     if (isInitialMount.current) {
@@ -1447,6 +1570,14 @@ function useKlinechartsUISettings() {
     }
     onSettingsChange?.({ ...settings });
   }, [settings, onSettingsChange]);
+  react.useEffect(() => {
+    if (!storage || !storage.persists("settings")) return;
+    if (isInitialMount.current) return;
+    try {
+      storage.adapter.setItem(storage.key("settings"), JSON.stringify(settings));
+    } catch {
+    }
+  }, [settings, storage]);
   const candleTypes = react.useMemo(
     () => CANDLE_TYPES.map((ct) => ({
       key: ct.key,
@@ -1688,7 +1819,7 @@ function useKlinechartsUISettings() {
   };
 }
 function useScreenshot() {
-  const { state, dispatch } = useKlinechartsUI();
+  const { state, dispatch } = chunkF24D6PWY_cjs.useKlinechartsUI();
   const capture = react.useCallback(() => {
     if (!state.chart) return;
     const url = state.chart.getConvertPictureUrl(true, "jpeg", state.theme === "dark" ? "#151517" : "#ffffff");
@@ -1717,7 +1848,7 @@ function useScreenshot() {
   };
 }
 function useHotkeys() {
-  const { state } = useKlinechartsUI();
+  const { state } = chunkF24D6PWY_cjs.useKlinechartsUI();
   const registerHotkey = react.useCallback((template) => {
     klinecharts.registerHotkey(template);
   }, []);
@@ -1746,7 +1877,7 @@ function useHotkeys() {
   };
 }
 function useChartAxes() {
-  const { state } = useKlinechartsUI();
+  const { state } = chunkF24D6PWY_cjs.useKlinechartsUI();
   const overrideXAxis = react.useCallback(
     (override) => {
       if (!state.chart) return;
@@ -1764,7 +1895,7 @@ function useChartAxes() {
   return { overrideXAxis, overrideYAxis };
 }
 function useFullscreen() {
-  const { fullscreenContainerRef } = useKlinechartsUIDispatch();
+  const { fullscreenContainerRef } = chunkF24D6PWY_cjs.useKlinechartsUIDispatch();
   const [isFullscreen, setIsFullscreen] = react.useState(false);
   const enter = react.useCallback(() => {
     const el = fullscreenContainerRef.current;
@@ -1819,7 +1950,7 @@ function useFullscreen() {
   };
 }
 function useOrderLines() {
-  const { state } = useKlinechartsUI();
+  const { state } = chunkF24D6PWY_cjs.useKlinechartsUI();
   const callbacksRef = react.useRef(/* @__PURE__ */ new Map());
   const ownedIdsRef = react.useRef(/* @__PURE__ */ new Set());
   const createOrderLine = react.useCallback(
@@ -1916,8 +2047,8 @@ function useOrderLines() {
 }
 var DRAWING_GROUP_ID2 = "drawing_tools";
 function useUndoRedo() {
-  const { state, dispatch } = useKlinechartsUI();
-  const { undoRedoListenerRef } = useKlinechartsUIDispatch();
+  const { state, dispatch } = chunkF24D6PWY_cjs.useKlinechartsUI();
+  const { undoRedoListenerRef } = chunkF24D6PWY_cjs.useKlinechartsUIDispatch();
   const [undoStack, setUndoStack] = react.useState([]);
   const [redoStack, setRedoStack] = react.useState([]);
   const isProcessingRef = react.useRef(false);
@@ -2259,7 +2390,7 @@ function getEntry(id) {
   }
 }
 function useLayoutManager() {
-  const { state, dispatch } = useKlinechartsUI();
+  const { state, dispatch } = chunkF24D6PWY_cjs.useKlinechartsUI();
   const [layouts, setLayouts] = react.useState(
     () => getLayoutIds().map((id) => getEntry(id)).filter((e) => e !== null)
   );
@@ -2563,7 +2694,7 @@ var SHADOW_KEYS = [
 ];
 var scriptCounter = 0;
 function useScriptEditor() {
-  const { state } = useKlinechartsUI();
+  const { state } = chunkF24D6PWY_cjs.useKlinechartsUI();
   const [code, setCode] = react.useState(DEFAULT_SCRIPT);
   const [scriptName, setScriptName] = react.useState("");
   const [params, setParams] = react.useState("14");
@@ -2600,7 +2731,7 @@ ${code}`
       const shadowValues = SHADOW_KEYS.map(() => void 0);
       const sampleResult = compiledFn(
         ...shadowValues,
-        chunkLGYYJ2GP_cjs.TA_default,
+        chunkSZDU2D3D_cjs.TA_default,
         dataList,
         parsedParams
       );
@@ -2627,7 +2758,7 @@ ${code}`
         shortName: (scriptName.trim() || `Script #${scriptCounter}`) + (placement === "main" ? " (Main)" : " (Sub)"),
         calcParams: parsedParams,
         figures,
-        calc: (liveDataList) => compiledFn(...shadowValues, chunkLGYYJ2GP_cjs.TA_default, liveDataList, parsedParams),
+        calc: (liveDataList) => compiledFn(...shadowValues, chunkSZDU2D3D_cjs.TA_default, liveDataList, parsedParams),
         extendData: {
           isCustomScript: true,
           code,
@@ -2738,7 +2869,7 @@ ${code}`
   };
 }
 function useCrosshair() {
-  const { state } = useKlinechartsUI();
+  const { state } = chunkF24D6PWY_cjs.useKlinechartsUI();
   const [barData, setBarData] = react.useState(null);
   const rafRef = react.useRef(0);
   const handler = react.useCallback(
@@ -2788,11 +2919,11 @@ function useCrosshair() {
 }
 var alertCounter = 0;
 function useAlerts() {
-  const { state, dispatch } = useKlinechartsUI();
-  const { alertTriggeredListenerRef } = useKlinechartsUIDispatch();
+  const { state, dispatch } = chunkF24D6PWY_cjs.useKlinechartsUI();
+  const { alertTriggeredListenersRef } = chunkF24D6PWY_cjs.useKlinechartsUIDispatch();
   const alerts = state.alerts;
   const addAlert = react.useCallback(
-    (price, condition, message, extendData) => {
+    (price, condition, message, extendData, target) => {
       const id = `alert_${++alertCounter}`;
       const precision = state.chart?.getSymbol()?.pricePrecision ?? 2;
       const resolvedExtendData = {
@@ -2805,11 +2936,14 @@ function useAlerts() {
         condition,
         message,
         triggered: false,
-        extendData: resolvedExtendData
+        extendData: resolvedExtendData,
+        // Persist the target only when it's an indicator alert; omit for the
+        // default price target so existing serialized alerts stay compatible.
+        ...target && target.type === "indicator" ? { target } : {}
       };
       dispatch({ type: "ADD_ALERT", alert });
       if (state.chart) {
-        chunkLGYYJ2GP_cjs.ensureAlertLineRegistered();
+        chunkSZDU2D3D_cjs.ensureAlertLineRegistered();
         state.chart.createOverlay({
           name: "alertLine",
           id,
@@ -2836,9 +2970,13 @@ function useAlerts() {
   }, [state.chart, dispatch]);
   const onAlertTriggered = react.useCallback(
     (callback) => {
-      alertTriggeredListenerRef.current = callback;
+      const set = alertTriggeredListenersRef.current;
+      set.add(callback);
+      return () => {
+        set.delete(callback);
+      };
     },
-    [alertTriggeredListenerRef]
+    [alertTriggeredListenersRef]
   );
   return {
     alerts,
@@ -2849,7 +2987,7 @@ function useAlerts() {
   };
 }
 function useDataExport() {
-  const { state } = useKlinechartsUI();
+  const { state } = chunkF24D6PWY_cjs.useKlinechartsUI();
   const exportAll = react.useCallback(
     (format) => {
       if (!state.chart) return;
@@ -2915,8 +3053,8 @@ function downloadData(dataList, format, ticker) {
   URL.revokeObjectURL(url);
 }
 function useWatchlist() {
-  const { state } = useKlinechartsUI();
-  const { dispatch, datafeed } = useKlinechartsUIDispatch();
+  const { state } = chunkF24D6PWY_cjs.useKlinechartsUI();
+  const { dispatch, datafeed } = chunkF24D6PWY_cjs.useKlinechartsUIDispatch();
   const [items, setItems] = react.useState([]);
   const subscriptionsRef = react.useRef(/* @__PURE__ */ new Map());
   const activeSymbol = state.symbol?.ticker ?? null;
@@ -2985,8 +3123,8 @@ function useWatchlist() {
   };
 }
 function useReplay() {
-  const { state, dispatch } = useKlinechartsUI();
-  const { replayIntervalRef, replaySavedDataRef, replayIndexRef } = useKlinechartsUIDispatch();
+  const { state, dispatch } = chunkF24D6PWY_cjs.useKlinechartsUI();
+  const { replayIntervalRef, replaySavedDataRef, replayIndexRef } = chunkF24D6PWY_cjs.useKlinechartsUIDispatch();
   const { isReplaying, isPaused, speed, barIndex, totalBars } = state.replay;
   const clearInterval_ = react.useCallback(() => {
     if (replayIntervalRef.current !== null) {
@@ -3135,7 +3273,7 @@ var DEFAULT_COLORS = [
   "#8bc34a"
 ];
 function useCompare() {
-  const { state, datafeed } = useKlinechartsUI();
+  const { state, datafeed } = chunkF24D6PWY_cjs.useKlinechartsUI();
   const [symbols, setSymbols] = react.useState([]);
   const indicatorsRef = react.useRef(/* @__PURE__ */ new Map());
   const instanceSalt = react.useId().replace(/[^a-zA-Z0-9]/g, "");
@@ -3281,7 +3419,7 @@ function computeResult(from, to) {
   return { from, to, priceDiff, pricePercent, bars, timeDiff };
 }
 function useMeasure() {
-  const { state, dispatch } = useKlinechartsUI();
+  const { state, dispatch } = chunkF24D6PWY_cjs.useKlinechartsUI();
   const { isActive, fromPoint, result } = state.measure;
   const cleanup = react.useCallback(() => {
     state.chart?.removeOverlay({ id: MEASURE_OVERLAY_ID });
@@ -3362,7 +3500,7 @@ function useMeasure() {
 }
 var annotationCounter = 0;
 function useAnnotations() {
-  const { state } = useKlinechartsUI();
+  const { state } = chunkF24D6PWY_cjs.useKlinechartsUI();
   const [annotations, setAnnotations] = react.useState([]);
   const addAnnotation = react.useCallback(
     (text, price, timestamp, color) => {
@@ -3442,265 +3580,375 @@ function useAnnotations() {
     clearAnnotations
   };
 }
+var WorkspaceContext = react.createContext(null);
+function useWorkspace() {
+  const ctx = react.useContext(WorkspaceContext);
+  if (!ctx) {
+    throw new Error("useWorkspace must be used within a <WorkspaceProvider>");
+  }
+  return ctx;
+}
 
-// src/utils/createDataLoader.ts
-function createDataLoader(datafeed, dispatch) {
-  let oldestTimestamp = null;
-  let currentGen = 0;
-  return {
-    getBars: async (params) => {
+// src/workspace/types.ts
+var DEFAULT_SYNC_CONFIG = {
+  crosshair: true,
+  scroll: true,
+  zoom: true,
+  symbol: true,
+  period: true
+};
+function reducer2(state, action) {
+  switch (action.type) {
+    case "SET_CELLS":
+      return { ...state, cells: action.cells };
+    case "ADD_CELL":
+      return { ...state, cells: [...state.cells, action.cell] };
+    case "REMOVE_CELL": {
+      const cells = state.cells.filter((c) => c.id !== action.id);
+      return {
+        cells,
+        activeCellId: state.activeCellId === action.id ? cells[0]?.id ?? null : state.activeCellId
+      };
+    }
+    case "SET_CELL_SYMBOL":
+      return {
+        ...state,
+        cells: state.cells.map(
+          (c) => c.id === action.id ? { ...c, symbol: action.symbol } : c
+        )
+      };
+    case "SET_CELL_PERIOD":
+      return {
+        ...state,
+        cells: state.cells.map(
+          (c) => c.id === action.id ? { ...c, period: action.period } : c
+        )
+      };
+    case "SET_ACTIVE_CELL":
+      return { ...state, activeCellId: action.id };
+    default:
+      return state;
+  }
+}
+function WorkspaceProvider({
+  defaultCells,
+  sync,
+  children
+}) {
+  const [state, dispatch] = react.useReducer(reducer2, defaultCells, (cells) => ({
+    cells,
+    activeCellId: cells[0]?.id ?? null
+  }));
+  const chartsRef = react.useRef(/* @__PURE__ */ new Map());
+  const broadcastingRef = react.useRef(false);
+  const resolvedSync = react.useMemo(
+    () => ({ ...DEFAULT_SYNC_CONFIG, ...sync }),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    []
+  );
+  const value = react.useMemo(
+    () => ({
+      state,
+      dispatch,
+      chartsRef,
+      broadcastingRef,
+      sync: resolvedSync
+    }),
+    [state, resolvedSync]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(WorkspaceContext.Provider, { value, children });
+}
+function useChartSync({ cellId }) {
+  const { chartsRef, broadcastingRef, sync, dispatch: workspaceDispatch } = useWorkspace();
+  const { state } = chunkF24D6PWY_cjs.useKlinechartsUI();
+  const chart = state.chart;
+  react.useEffect(() => {
+    if (!chart) return;
+    chartsRef.current.set(cellId, chart);
+    return () => {
+      chartsRef.current.delete(cellId);
+    };
+  }, [chart, cellId, chartsRef]);
+  react.useEffect(() => {
+    if (!chart) return;
+    const broadcast = (fn) => {
+      if (broadcastingRef.current) return;
+      broadcastingRef.current = true;
       try {
-        dispatch({ type: "SET_LOADING", isLoading: true });
-        if (params.type === "init") {
-          oldestTimestamp = null;
-          const gen = ++currentGen;
-          const data = await datafeed.getHistoryKLineData(
-            params.symbol,
-            { ...params.period, label: "" },
-            0,
-            Date.now()
-          );
-          if (gen !== currentGen) return;
-          if (data.length > 0) {
-            oldestTimestamp = data[0].timestamp;
-          }
-          params.callback(data, {
-            forward: data.length > 0,
-            backward: false
-          });
-        } else if (params.type === "forward" && oldestTimestamp !== null) {
-          const gen = currentGen;
-          const data = await datafeed.getHistoryKLineData(
-            params.symbol,
-            { ...params.period, label: "" },
-            0,
-            oldestTimestamp - 1
-          );
-          if (gen !== currentGen) return;
-          if (data.length > 0) {
-            oldestTimestamp = data[0].timestamp;
+        chartsRef.current.forEach((target, id) => {
+          if (id !== cellId) {
+            try {
+              fn(target);
+            } catch {
+            }
           }
-          params.callback(data, {
-            forward: data.length > 0,
-            backward: false
-          });
-        } else if (params.type === "backward") {
-          params.callback([], { forward: false, backward: false });
-        }
-      } catch (error) {
-        console.error("Failed to load chart data:", error);
-        params.callback([], { forward: false, backward: false });
+        });
       } finally {
-        dispatch({ type: "SET_LOADING", isLoading: false });
+        broadcastingRef.current = false;
       }
-    },
-    subscribeBar: (params) => {
-      datafeed.subscribe(
-        params.symbol,
-        { ...params.period, label: "" },
-        (klineData) => params.callback(klineData)
+    };
+    const onCrosshairChange = (data) => {
+      if (!sync.crosshair) return;
+      const crosshair = data;
+      if (!crosshair) return;
+      broadcast((target) => target.executeAction("onCrosshairChange", crosshair));
+    };
+    const onScroll = () => {
+      if (!sync.scroll) return;
+      let range = null;
+      try {
+        range = chart.getVisibleRange();
+      } catch {
+        return;
+      }
+      if (!range || range.realTo == null) return;
+      broadcast(
+        (target) => target.scrollToTimestamp(range.realTo, 0)
       );
-    },
-    unsubscribeBar: (params) => {
-      datafeed.unsubscribe(params.symbol, { ...params.period, label: "" });
+    };
+    const onZoom = () => {
+      if (!sync.zoom) return;
+      let bar = 0;
+      try {
+        bar = chart.getBarSpace().bar;
+      } catch {
+        return;
+      }
+      broadcast((target) => target.setBarSpace(bar));
+    };
+    chart.subscribeAction("onCrosshairChange", onCrosshairChange);
+    chart.subscribeAction("onScroll", onScroll);
+    chart.subscribeAction("onZoom", onZoom);
+    return () => {
+      chart.unsubscribeAction("onCrosshairChange", onCrosshairChange);
+      chart.unsubscribeAction("onScroll", onScroll);
+      chart.unsubscribeAction("onZoom", onZoom);
+    };
+  }, [chart, cellId, chartsRef, broadcastingRef, sync.crosshair, sync.scroll, sync.zoom]);
+  react.useEffect(() => {
+    if (state.symbol) {
+      workspaceDispatch({ type: "SET_CELL_SYMBOL", id: cellId, symbol: state.symbol });
     }
-  };
+  }, [state.symbol]);
+  react.useEffect(() => {
+    workspaceDispatch({ type: "SET_CELL_PERIOD", id: cellId, period: state.period });
+  }, [state.period]);
 }
 
 Object.defineProperty(exports, "TA", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.TA_default; }
+  get: function () { return chunkSZDU2D3D_cjs.TA_default; }
 });
 Object.defineProperty(exports, "abcd", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.abcd_default; }
+  get: function () { return chunkSZDU2D3D_cjs.abcd_default; }
 });
 Object.defineProperty(exports, "alertLine", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.alertLine_default; }
+  get: function () { return chunkSZDU2D3D_cjs.alertLine_default; }
 });
 Object.defineProperty(exports, "anyWaves", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.anyWaves_default; }
+  get: function () { return chunkSZDU2D3D_cjs.anyWaves_default; }
 });
 Object.defineProperty(exports, "arrow", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.arrow_default; }
+  get: function () { return chunkSZDU2D3D_cjs.arrow_default; }
 });
 Object.defineProperty(exports, "bollTv", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.bollTv_default; }
+  get: function () { return chunkSZDU2D3D_cjs.bollTv_default; }
 });
 Object.defineProperty(exports, "brush", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.brush_default; }
+  get: function () { return chunkSZDU2D3D_cjs.brush_default; }
 });
 Object.defineProperty(exports, "cci", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.cci_default; }
+  get: function () { return chunkSZDU2D3D_cjs.cci_default; }
 });
 Object.defineProperty(exports, "circle", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.circle_default; }
+  get: function () { return chunkSZDU2D3D_cjs.circle_default; }
 });
 Object.defineProperty(exports, "depthOverlay", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.depthOverlay_default; }
+  get: function () { return chunkSZDU2D3D_cjs.depthOverlay_default; }
 });
 Object.defineProperty(exports, "eightWaves", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.eightWaves_default; }
+  get: function () { return chunkSZDU2D3D_cjs.eightWaves_default; }
 });
 Object.defineProperty(exports, "elliottWave", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.elliottWave_default; }
+  get: function () { return chunkSZDU2D3D_cjs.elliottWave_default; }
 });
 Object.defineProperty(exports, "fibRetracement", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.fibRetracement_default; }
+  get: function () { return chunkSZDU2D3D_cjs.fibRetracement_default; }
 });
 Object.defineProperty(exports, "fibonacciCircle", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.fibonacciCircle_default; }
+  get: function () { return chunkSZDU2D3D_cjs.fibonacciCircle_default; }
 });
 Object.defineProperty(exports, "fibonacciExtension", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.fibonacciExtension_default; }
+  get: function () { return chunkSZDU2D3D_cjs.fibonacciExtension_default; }
 });
 Object.defineProperty(exports, "fibonacciSegment", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.fibonacciSegment_default; }
+  get: function () { return chunkSZDU2D3D_cjs.fibonacciSegment_default; }
 });
 Object.defineProperty(exports, "fibonacciSpeedResistanceFan", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.fibonacciSpeedResistanceFan_default; }
+  get: function () { return chunkSZDU2D3D_cjs.fibonacciSpeedResistanceFan_default; }
 });
 Object.defineProperty(exports, "fibonacciSpiral", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.fibonacciSpiral_default; }
+  get: function () { return chunkSZDU2D3D_cjs.fibonacciSpiral_default; }
 });
 Object.defineProperty(exports, "fiveWaves", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.fiveWaves_default; }
+  get: function () { return chunkSZDU2D3D_cjs.fiveWaves_default; }
 });
 Object.defineProperty(exports, "gannBox", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.gannBox_default; }
+  get: function () { return chunkSZDU2D3D_cjs.gannBox_default; }
 });
 Object.defineProperty(exports, "gannFan", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.gannFan_default; }
+  get: function () { return chunkSZDU2D3D_cjs.gannFan_default; }
 });
 Object.defineProperty(exports, "hma", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.hma_default; }
+  get: function () { return chunkSZDU2D3D_cjs.hma_default; }
 });
 Object.defineProperty(exports, "ichimoku", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.ichimoku_default; }
+  get: function () { return chunkSZDU2D3D_cjs.ichimoku_default; }
 });
 Object.defineProperty(exports, "indicators", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.indicators; }
+  get: function () { return chunkSZDU2D3D_cjs.indicators; }
 });
 Object.defineProperty(exports, "longPosition", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.longPosition_default; }
+  get: function () { return chunkSZDU2D3D_cjs.longPosition_default; }
 });
 Object.defineProperty(exports, "maRibbon", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.maRibbon_default; }
+  get: function () { return chunkSZDU2D3D_cjs.maRibbon_default; }
 });
 Object.defineProperty(exports, "macdTv", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.macdTv_default; }
+  get: function () { return chunkSZDU2D3D_cjs.macdTv_default; }
 });
 Object.defineProperty(exports, "measure", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.measure_default; }
+  get: function () { return chunkSZDU2D3D_cjs.measure_default; }
 });
 Object.defineProperty(exports, "orderLine", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.orderLine_default; }
+  get: function () { return chunkSZDU2D3D_cjs.orderLine_default; }
 });
 Object.defineProperty(exports, "overlays", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.overlays; }
+  get: function () { return chunkSZDU2D3D_cjs.overlays; }
 });
 Object.defineProperty(exports, "parallelChannel", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.parallelChannel_default; }
+  get: function () { return chunkSZDU2D3D_cjs.parallelChannel_default; }
 });
 Object.defineProperty(exports, "parallelogram", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.parallelogram_default; }
+  get: function () { return chunkSZDU2D3D_cjs.parallelogram_default; }
 });
 Object.defineProperty(exports, "pivotPoints", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.pivotPoints_default; }
+  get: function () { return chunkSZDU2D3D_cjs.pivotPoints_default; }
 });
 Object.defineProperty(exports, "ray", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.ray_default; }
+  get: function () { return chunkSZDU2D3D_cjs.ray_default; }
 });
 Object.defineProperty(exports, "rect", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.rect_default; }
+  get: function () { return chunkSZDU2D3D_cjs.rect_default; }
 });
 Object.defineProperty(exports, "registerExtensions", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.registerExtensions; }
+  get: function () { return chunkSZDU2D3D_cjs.registerExtensions; }
 });
 Object.defineProperty(exports, "rsiTv", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.rsiTv_default; }
+  get: function () { return chunkSZDU2D3D_cjs.rsiTv_default; }
 });
 Object.defineProperty(exports, "shortPosition", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.shortPosition_default; }
+  get: function () { return chunkSZDU2D3D_cjs.shortPosition_default; }
 });
 Object.defineProperty(exports, "stochastic", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.stochastic_default; }
+  get: function () { return chunkSZDU2D3D_cjs.stochastic_default; }
 });
 Object.defineProperty(exports, "superTrend", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.superTrend_default; }
+  get: function () { return chunkSZDU2D3D_cjs.superTrend_default; }
 });
 Object.defineProperty(exports, "threeWaves", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.threeWaves_default; }
+  get: function () { return chunkSZDU2D3D_cjs.threeWaves_default; }
 });
 Object.defineProperty(exports, "triangle", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.triangle_default; }
+  get: function () { return chunkSZDU2D3D_cjs.triangle_default; }
 });
 Object.defineProperty(exports, "vwap", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.vwap_default; }
+  get: function () { return chunkSZDU2D3D_cjs.vwap_default; }
 });
 Object.defineProperty(exports, "xabcd", {
   enumerable: true,
-  get: function () { return chunkLGYYJ2GP_cjs.xabcd_default; }
+  get: function () { return chunkSZDU2D3D_cjs.xabcd_default; }
+});
+Object.defineProperty(exports, "KlinechartsUIDispatchContext", {
+  enumerable: true,
+  get: function () { return chunkF24D6PWY_cjs.KlinechartsUIDispatchContext; }
+});
+Object.defineProperty(exports, "KlinechartsUIStateContext", {
+  enumerable: true,
+  get: function () { return chunkF24D6PWY_cjs.KlinechartsUIStateContext; }
+});
+Object.defineProperty(exports, "createDataLoader", {
+  enumerable: true,
+  get: function () { return chunkF24D6PWY_cjs.createDataLoader; }
+});
+Object.defineProperty(exports, "useKlinechartsUI", {
+  enumerable: true,
+  get: function () { return chunkF24D6PWY_cjs.useKlinechartsUI; }
 });
 exports.CANDLE_TYPES = CANDLE_TYPES;
 exports.COMPARE_RULES = COMPARE_RULES;
 exports.DEFAULT_PERIODS = DEFAULT_PERIODS;
+exports.DEFAULT_STORAGE_KEY_PREFIX = DEFAULT_STORAGE_KEY_PREFIX;
+exports.DEFAULT_STORAGE_NAMESPACES = DEFAULT_STORAGE_NAMESPACES;
+exports.DEFAULT_SYNC_CONFIG = DEFAULT_SYNC_CONFIG;
 exports.DRAWING_CATEGORIES = DRAWING_CATEGORIES;
 exports.INDICATOR_PARAMS = INDICATOR_PARAMS;
-exports.KlinechartsUIDispatchContext = KlinechartsUIDispatchContext;
 exports.KlinechartsUIProvider = KlinechartsUIProvider;
-exports.KlinechartsUIStateContext = KlinechartsUIStateContext;
 exports.MAIN_INDICATORS = MAIN_INDICATORS;
 exports.PRICE_AXIS_TYPES = PRICE_AXIS_TYPES;
 exports.SUB_INDICATORS = SUB_INDICATORS;
 exports.TIMEZONES = TIMEZONES;
 exports.TOOLTIP_SHOW_RULES = TOOLTIP_SHOW_RULES;
+exports.WorkspaceProvider = WorkspaceProvider;
 exports.YAXIS_POSITIONS = YAXIS_POSITIONS;
-exports.createDataLoader = createDataLoader;
+exports.createDefaultStorage = createDefaultStorage;
+exports.resolveStorage = resolveStorage;
 exports.useAlerts = useAlerts;
 exports.useAnnotations = useAnnotations;
 exports.useChartAxes = useChartAxes;
+exports.useChartSync = useChartSync;
 exports.useCompare = useCompare;
 exports.useCrosshair = useCrosshair;
 exports.useDataExport = useDataExport;
@@ -3708,7 +3956,6 @@ exports.useDrawingTools = useDrawingTools;
 exports.useFullscreen = useFullscreen;
 exports.useHotkeys = useHotkeys;
 exports.useIndicators = useIndicators;
-exports.useKlinechartsUI = useKlinechartsUI;
 exports.useKlinechartsUILoading = useKlinechartsUILoading;
 exports.useKlinechartsUISettings = useKlinechartsUISettings;
 exports.useKlinechartsUITheme = useKlinechartsUITheme;
@@ -3723,5 +3970,6 @@ exports.useSymbolSearch = useSymbolSearch;
 exports.useTimezone = useTimezone;
 exports.useUndoRedo = useUndoRedo;
 exports.useWatchlist = useWatchlist;
+exports.useWorkspace = useWorkspace;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map