@363045841yyt/klinechart-core 0.7.9 → 0.7.11

package/dist/engine/indicators/stateComposer.js

@@ -2,1013 +2,109 @@
  * State Composer
  * 把 Worker/Runtime 返回的 series bundle 组装成与现有兼容的 render states
  */
-import { EMPTY_RSI_STATE } from './rsiState';
-import { EMPTY_CCI_STATE } from './cciState';
-import { EMPTY_STOCH_STATE } from './stochState';
-import { EMPTY_MOM_STATE } from './momState';
-import { EMPTY_WMSR_STATE } from './wmsrState';
-import { EMPTY_KST_STATE } from './kstState';
-import { EMPTY_FASTK_STATE } from './fastkState';
-import { EMPTY_MACD_STATE } from './macdState';
-import { EMPTY_ATR_STATE } from './atrState';
-import { EMPTY_WMA_STATE } from './wmaState';
-import { EMPTY_DEMA_STATE } from './demaState';
-import { EMPTY_TEMA_STATE } from './temaState';
-import { EMPTY_HMA_STATE } from './hmaState';
-import { EMPTY_KAMA_STATE } from './kamaState';
-import { EMPTY_SAR_STATE } from './sarState';
-import { EMPTY_SUPERTREND_STATE } from './supertrendState';
-import { EMPTY_KELTNER_STATE } from './keltnerState';
-import { EMPTY_DONCHIAN_STATE } from './donchianState';
-import { EMPTY_ICHIMOKU_STATE } from './ichimokuState';
-import { EMPTY_ROC_STATE } from './rocState';
-import { EMPTY_TRIX_STATE } from './trixState';
-import { EMPTY_HV_STATE } from './hvState';
-import { EMPTY_PARKINSON_STATE } from './parkinsonState';
-import { EMPTY_CHAIKIN_VOL_STATE } from './chaikinVolState';
-import { EMPTY_VMA_STATE } from './vmaState';
-import { EMPTY_OBV_STATE } from './obvState';
-import { EMPTY_PVT_STATE } from './pvtState';
-import { EMPTY_VWAP_STATE } from './vwapState';
-import { EMPTY_CMF_STATE } from './cmfState';
-import { EMPTY_MFI_STATE } from './mfiState';
-import { EMPTY_PIVOT_STATE } from './pivotState';
-import { EMPTY_FIB_STATE } from './fibState';
-import { EMPTY_STRUCTURE_STATE } from './structureState';
-import { EMPTY_ZONES_STATE } from './zonesState';
-import { EMPTY_VOLUME_PROFILE_STATE } from './volumeProfileState';
-function getLatestMACDPoint(bundle, visibleRange) {
-    const latestIndex = visibleRange.end - 1;
-    return latestIndex >= 0 && latestIndex < bundle.macd.series.length
-        ? bundle.macd.series[latestIndex]
-        : null;
-}
-function mergeEmptyState(state, timestamp, overrides) {
-    return {
-        ...state,
-        ...overrides,
-        timestamp,
-    };
-}
+const MAIN_RENDER_STATE_INDICATOR_IDS = ['ma', 'boll', 'expma', 'ene'];
+const METADATA_VISIBLE_STATE_INDICATOR_IDS = [
+    'cci',
+    'wma',
+    'dema',
+    'tema',
+    'hma',
+    'kama',
+    'roc',
+    'chaikinVol',
+    'obv',
+    'pvt',
+    'vwap',
+    'rsi',
+    'stoch',
+    'fastk',
+    'mfi',
+    'wmsr',
+    'cmf',
+    'atr',
+    'hv',
+    'kst',
+    'mom',
+    'parkinson',
+    'trix',
+    'vma',
+    'macd',
+    'sar',
+    'supertrend',
+    'keltner',
+    'donchian',
+    'ichimoku',
+    'pivot',
+    'fib',
+    'structure',
+    'zones',
+    'volumeProfile',
+];
 /**
  * 仅计算副图指标的 visible-only states
  * 用于滚动时的轻量更新，避免重复计算主图指标
  */
-export function composeVisibleSubIndicatorStates(bundle, visibleRange, timestamp, activeMask = {}) {
-    const rsiActive = activeMask.rsi ?? true;
-    const cciActive = activeMask.cci ?? true;
-    const stochActive = activeMask.stoch ?? true;
-    const momActive = activeMask.mom ?? true;
-    const wmsrActive = activeMask.wmsr ?? true;
-    const kstActive = activeMask.kst ?? true;
-    const fastkActive = activeMask.fastk ?? true;
-    const macdActive = activeMask.macd ?? true;
-    const atrActive = activeMask.atr ?? true;
-    const wmaActive = activeMask.wma ?? true;
-    const demaActive = activeMask.dema ?? true;
-    const temaActive = activeMask.tema ?? true;
-    const hmaActive = activeMask.hma ?? true;
-    const kamaActive = activeMask.kama ?? true;
-    const sarActive = activeMask.sar ?? true;
-    const supertrendActive = activeMask.supertrend ?? true;
-    const keltnerActive = activeMask.keltner ?? true;
-    const donchianActive = activeMask.donchian ?? true;
-    const ichimokuActive = activeMask.ichimoku ?? true;
-    const rocActive = activeMask.roc ?? true;
-    const trixActive = activeMask.trix ?? true;
-    const hvActive = activeMask.hv ?? true;
-    const parkinsonActive = activeMask.parkinson ?? true;
-    const chaikinVolActive = activeMask.chaikinVol ?? true;
-    const vmaActive = activeMask.vma ?? true;
-    const obvActive = activeMask.obv ?? true;
-    const pvtActive = activeMask.pvt ?? true;
-    const vwapActive = activeMask.vwap ?? true;
-    const cmfActive = activeMask.cmf ?? true;
-    const mfiActive = activeMask.mfi ?? true;
-    const pivotActive = activeMask.pivot ?? true;
-    const fibActive = activeMask.fib ?? true;
-    const structureActive = activeMask.structure ?? true;
-    const zonesActive = activeMask.zones ?? true;
-    const vpActive = activeMask.volumeProfile ?? true;
-    const rsiExtremes = rsiActive ? calcRSIExtremes(bundle.rsi.series, visibleRange) : null;
-    const cciExtremes = cciActive ? calcCCIExtremes(bundle.cci.series, visibleRange) : null;
-    const stochExtremes = stochActive ? calcSTOCHExtremes(bundle.stoch.series, visibleRange) : null;
-    const momExtremes = momActive ? calcMOMExtremes(bundle.mom.series, visibleRange) : null;
-    const wmsrExtremes = wmsrActive ? calcWMSRExtremes(bundle.wmsr.series, visibleRange) : null;
-    const kstExtremes = kstActive ? calcKSTExtremes(bundle.kst.series, visibleRange) : null;
-    const fastkExtremes = fastkActive ? calcFASTKExtremes(bundle.fastk.series, visibleRange) : null;
-    const macdExtremes = macdActive ? calcMACDExtremes(bundle.macd.series, visibleRange) : null;
-    const atrExtremes = atrActive ? calcATRExtremes(bundle.atr.series, visibleRange) : null;
-    const wmaExtremes = wmaActive ? calcSparseExtremes(bundle.wma.series, visibleRange) : null;
-    const demaExtremes = demaActive ? calcSparseExtremes(bundle.dema.series, visibleRange) : null;
-    const temaExtremes = temaActive ? calcSparseExtremes(bundle.tema.series, visibleRange) : null;
-    const hmaExtremes = hmaActive ? calcSparseExtremes(bundle.hma.series, visibleRange) : null;
-    const kamaExtremes = kamaActive ? calcSparseExtremes(bundle.kama.series, visibleRange) : null;
-    const sarExtremes = sarActive ? calcSARExtremes(bundle.sar.series, visibleRange) : null;
-    const supertrendExtremes = supertrendActive ? calcSARExtremes(bundle.supertrend.series, visibleRange) : null;
-    const keltnerExtremes = keltnerActive ? calcBandExtremes(bundle.keltner.series, visibleRange) : null;
-    const donchianExtremes = donchianActive ? calcBandExtremes(bundle.donchian.series, visibleRange) : null;
-    const ichimokuExtremes = ichimokuActive ? calcIchimokuExtremes(bundle.ichimoku.series, visibleRange) : null;
-    const rocExtremes = rocActive ? calcSparseExtremes(bundle.roc.series, visibleRange) : null;
-    const trixSeriesExtremes = trixActive ? calcSparseExtremes(bundle.trix.series, visibleRange) : null;
-    const trixSignalExtremes = trixActive ? calcSparseExtremes(bundle.trix.signalSeries, visibleRange) : null;
-    const hvExtremes = hvActive ? calcSparseExtremes(bundle.hv.series, visibleRange) : null;
-    const parkinsonExtremes = parkinsonActive ? calcSparseExtremes(bundle.parkinson.series, visibleRange) : null;
-    const chaikinVolExtremes = chaikinVolActive ? calcSparseExtremes(bundle.chaikinVol.series, visibleRange) : null;
-    const vmaExtremes = vmaActive ? calcSparseExtremes(bundle.vma.series, visibleRange) : null;
-    const obvExtremes = obvActive ? calcSparseExtremes(bundle.obv.series, visibleRange) : null;
-    const pvtExtremes = pvtActive ? calcSparseExtremes(bundle.pvt.series, visibleRange) : null;
-    const vwapExtremes = vwapActive ? calcSparseExtremes(bundle.vwap.series, visibleRange) : null;
-    const cmfExtremes = cmfActive ? calcSparseExtremes(bundle.cmf.series, visibleRange) : null;
-    const mfiExtremes = mfiActive ? calcSparseExtremes(bundle.mfi.series, visibleRange) : null;
-    const pivotExtremes = pivotActive ? calcPivotExtremes(bundle.pivot.series, visibleRange) : null;
-    const fibExtremes = fibActive ? calcFibExtremes(bundle.fib.series, visibleRange) : null;
-    const latestPoint = macdActive ? getLatestMACDPoint(bundle, visibleRange) : null;
-    const macdPadding = macdExtremes ? Math.max(Math.abs(macdExtremes.max), Math.abs(macdExtremes.min)) * 0.1 : 0;
-    const macdValueMin = macdExtremes && Number.isFinite(macdExtremes.min) ? macdExtremes.min - macdPadding : EMPTY_MACD_STATE.valueMin;
-    const macdValueMax = macdExtremes && Number.isFinite(macdExtremes.max) ? macdExtremes.max + macdPadding : EMPTY_MACD_STATE.valueMax;
-    const cciValueMin = cciExtremes ? Math.min(cciExtremes.min, -150) : EMPTY_CCI_STATE.valueMin;
-    const cciValueMax = cciExtremes ? Math.max(cciExtremes.max, 150) : EMPTY_CCI_STATE.valueMax;
-    const momPadding = momExtremes ? Math.max(Math.abs(momExtremes.max), Math.abs(momExtremes.min)) * 0.1 : 0;
-    const momValueMin = momExtremes ? momExtremes.min - momPadding : EMPTY_MOM_STATE.valueMin;
-    const momValueMax = momExtremes ? momExtremes.max + momPadding : EMPTY_MOM_STATE.valueMax;
-    const kstRange = kstExtremes ? kstExtremes.max - kstExtremes.min : 0;
-    const kstPadding = kstRange * 0.1;
-    const kstValueMin = kstExtremes ? kstExtremes.min - kstPadding : EMPTY_KST_STATE.valueMin;
-    const kstValueMax = kstExtremes ? kstExtremes.max + kstPadding : EMPTY_KST_STATE.valueMax;
-    const atrValueMax = atrExtremes && Number.isFinite(atrExtremes.max)
-        ? atrExtremes.max * 1.1
-        : EMPTY_ATR_STATE.valueMax;
-    const maFamilyBounds = (ext, empty) => {
-        if (!ext || !Number.isFinite(ext.min) || !Number.isFinite(ext.max)) {
-            return { valueMin: empty.valueMin, valueMax: empty.valueMax };
-        }
-        const range = ext.max - ext.min;
-        const padding = range > 0 ? range * 0.05 : Math.max(1, Math.abs(ext.max) * 0.05);
-        return { valueMin: ext.min - padding, valueMax: ext.max + padding };
-    };
-    const wmaBounds = maFamilyBounds(wmaExtremes, EMPTY_WMA_STATE);
-    const demaBounds = maFamilyBounds(demaExtremes, EMPTY_DEMA_STATE);
-    const temaBounds = maFamilyBounds(temaExtremes, EMPTY_TEMA_STATE);
-    const hmaBounds = maFamilyBounds(hmaExtremes, EMPTY_HMA_STATE);
-    const kamaBounds = maFamilyBounds(kamaExtremes, EMPTY_KAMA_STATE);
-    const sarBounds = maFamilyBounds(sarExtremes, EMPTY_SAR_STATE);
-    const supertrendBounds = maFamilyBounds(supertrendExtremes, EMPTY_SUPERTREND_STATE);
-    const keltnerBounds = maFamilyBounds(keltnerExtremes, EMPTY_KELTNER_STATE);
-    const donchianBounds = maFamilyBounds(donchianExtremes, EMPTY_DONCHIAN_STATE);
-    const ichimokuBounds = maFamilyBounds(ichimokuExtremes, EMPTY_ICHIMOKU_STATE);
-    const rocBounds = maFamilyBounds(rocExtremes, EMPTY_ROC_STATE);
-    const trixCombinedMin = Math.min(trixSeriesExtremes?.min ?? Infinity, trixSignalExtremes?.min ?? Infinity);
-    const trixCombinedMax = Math.max(trixSeriesExtremes?.max ?? -Infinity, trixSignalExtremes?.max ?? -Infinity);
-    const trixBounds = maFamilyBounds(Number.isFinite(trixCombinedMin) && Number.isFinite(trixCombinedMax)
-        ? { min: trixCombinedMin, max: trixCombinedMax }
-        : null, EMPTY_TRIX_STATE);
-    // HV and Parkinson are non-negative volatility series; pad upward only
-    const hvValueMax = hvExtremes && Number.isFinite(hvExtremes.max) ? hvExtremes.max * 1.1 : EMPTY_HV_STATE.valueMax;
-    const parkinsonValueMax = parkinsonExtremes && Number.isFinite(parkinsonExtremes.max)
-        ? parkinsonExtremes.max * 1.1
-        : EMPTY_PARKINSON_STATE.valueMax;
-    const chaikinVolBounds = maFamilyBounds(chaikinVolExtremes, EMPTY_CHAIKIN_VOL_STATE);
-    const vmaValueMax = vmaExtremes && Number.isFinite(vmaExtremes.max) ? vmaExtremes.max * 1.1 : EMPTY_VMA_STATE.valueMax;
-    const obvBounds = maFamilyBounds(obvExtremes, EMPTY_OBV_STATE);
-    const pvtBounds = maFamilyBounds(pvtExtremes, EMPTY_PVT_STATE);
-    const vwapBounds = maFamilyBounds(vwapExtremes, EMPTY_VWAP_STATE);
-    return {
-        rsi: rsiActive ? {
-            timestamp,
-            series: bundle.rsi.series,
-            enabledPeriods: bundle.rsi.enabledPeriods,
-            params: bundle.rsi.params,
-            valueMin: 0,
-            valueMax: 100,
-            visibleMin: rsiExtremes.min,
-            visibleMax: rsiExtremes.max,
-        } : mergeEmptyState(EMPTY_RSI_STATE, timestamp, {
-            series: bundle.rsi.series,
-            enabledPeriods: bundle.rsi.enabledPeriods,
-            params: bundle.rsi.params,
-        }),
-        cci: cciActive ? {
-            timestamp,
-            series: bundle.cci.series,
-            params: bundle.cci.params,
-            valueMin: cciValueMin,
-            valueMax: cciValueMax,
-            visibleMin: cciExtremes.min,
-            visibleMax: cciExtremes.max,
-        } : mergeEmptyState(EMPTY_CCI_STATE, timestamp, {
-            series: bundle.cci.series,
-            params: bundle.cci.params,
-        }),
-        stoch: stochActive ? {
-            timestamp,
-            series: bundle.stoch.series,
-            params: bundle.stoch.params,
-            valueMin: 0,
-            valueMax: 100,
-            visibleMin: stochExtremes.min,
-            visibleMax: stochExtremes.max,
-        } : mergeEmptyState(EMPTY_STOCH_STATE, timestamp, {
-            series: bundle.stoch.series,
-            params: bundle.stoch.params,
-        }),
-        mom: momActive ? {
-            timestamp,
-            series: bundle.mom.series,
-            params: bundle.mom.params,
-            valueMin: momValueMin,
-            valueMax: momValueMax,
-            visibleMin: momExtremes.min,
-            visibleMax: momExtremes.max,
-        } : mergeEmptyState(EMPTY_MOM_STATE, timestamp, {
-            series: bundle.mom.series,
-            params: bundle.mom.params,
-        }),
-        wmsr: wmsrActive ? {
-            timestamp,
-            series: bundle.wmsr.series,
-            params: bundle.wmsr.params,
-            valueMin: -100,
-            valueMax: 0,
-            visibleMin: wmsrExtremes.min,
-            visibleMax: wmsrExtremes.max,
-        } : mergeEmptyState(EMPTY_WMSR_STATE, timestamp, {
-            series: bundle.wmsr.series,
-            params: bundle.wmsr.params,
-        }),
-        kst: kstActive ? {
-            timestamp,
-            series: bundle.kst.series,
-            params: bundle.kst.params,
-            valueMin: kstValueMin,
-            valueMax: kstValueMax,
-            visibleMin: kstExtremes.min,
-            visibleMax: kstExtremes.max,
-        } : mergeEmptyState(EMPTY_KST_STATE, timestamp, {
-            series: bundle.kst.series,
-            params: bundle.kst.params,
-        }),
-        fastk: fastkActive ? {
-            timestamp,
-            series: bundle.fastk.series,
-            params: bundle.fastk.params,
-            valueMin: 0,
-            valueMax: 100,
-            visibleMin: fastkExtremes.min,
-            visibleMax: fastkExtremes.max,
-        } : mergeEmptyState(EMPTY_FASTK_STATE, timestamp, {
-            series: bundle.fastk.series,
-            params: bundle.fastk.params,
-        }),
-        macd: macdActive ? {
-            timestamp,
-            series: bundle.macd.series,
-            params: bundle.macd.params,
-            valueMin: macdValueMin,
-            valueMax: macdValueMax,
-            visibleMin: macdExtremes.min,
-            visibleMax: macdExtremes.max,
-            latestValues: latestPoint ? {
-                dif: latestPoint.dif,
-                dea: latestPoint.dea,
-                macd: latestPoint.macd,
-            } : undefined,
-        } : mergeEmptyState(EMPTY_MACD_STATE, timestamp, {
-            series: bundle.macd.series,
-            params: bundle.macd.params,
-        }),
-        atr: atrActive ? {
-            timestamp,
-            series: bundle.atr.series,
-            params: bundle.atr.params,
-            valueMin: 0,
-            valueMax: atrValueMax,
-            visibleMin: atrExtremes.min,
-            visibleMax: atrExtremes.max,
-        } : mergeEmptyState(EMPTY_ATR_STATE, timestamp, {
-            series: bundle.atr.series,
-            params: bundle.atr.params,
-        }),
-        wma: wmaActive ? {
-            timestamp,
-            series: bundle.wma.series,
-            params: bundle.wma.params,
-            valueMin: wmaBounds.valueMin,
-            valueMax: wmaBounds.valueMax,
-            visibleMin: wmaExtremes.min,
-            visibleMax: wmaExtremes.max,
-        } : mergeEmptyState(EMPTY_WMA_STATE, timestamp, {
-            series: bundle.wma.series,
-            params: bundle.wma.params,
-        }),
-        dema: demaActive ? {
-            timestamp,
-            series: bundle.dema.series,
-            params: bundle.dema.params,
-            valueMin: demaBounds.valueMin,
-            valueMax: demaBounds.valueMax,
-            visibleMin: demaExtremes.min,
-            visibleMax: demaExtremes.max,
-        } : mergeEmptyState(EMPTY_DEMA_STATE, timestamp, {
-            series: bundle.dema.series,
-            params: bundle.dema.params,
-        }),
-        tema: temaActive ? {
-            timestamp,
-            series: bundle.tema.series,
-            params: bundle.tema.params,
-            valueMin: temaBounds.valueMin,
-            valueMax: temaBounds.valueMax,
-            visibleMin: temaExtremes.min,
-            visibleMax: temaExtremes.max,
-        } : mergeEmptyState(EMPTY_TEMA_STATE, timestamp, {
-            series: bundle.tema.series,
-            params: bundle.tema.params,
-        }),
-        hma: hmaActive ? {
-            timestamp,
-            series: bundle.hma.series,
-            params: bundle.hma.params,
-            valueMin: hmaBounds.valueMin,
-            valueMax: hmaBounds.valueMax,
-            visibleMin: hmaExtremes.min,
-            visibleMax: hmaExtremes.max,
-        } : mergeEmptyState(EMPTY_HMA_STATE, timestamp, {
-            series: bundle.hma.series,
-            params: bundle.hma.params,
-        }),
-        kama: kamaActive ? {
-            timestamp,
-            series: bundle.kama.series,
-            params: bundle.kama.params,
-            valueMin: kamaBounds.valueMin,
-            valueMax: kamaBounds.valueMax,
-            visibleMin: kamaExtremes.min,
-            visibleMax: kamaExtremes.max,
-        } : mergeEmptyState(EMPTY_KAMA_STATE, timestamp, {
-            series: bundle.kama.series,
-            params: bundle.kama.params,
-        }),
-        sar: sarActive ? {
-            timestamp,
-            series: bundle.sar.series,
-            params: bundle.sar.params,
-            valueMin: sarBounds.valueMin,
-            valueMax: sarBounds.valueMax,
-            visibleMin: sarExtremes.min,
-            visibleMax: sarExtremes.max,
-        } : mergeEmptyState(EMPTY_SAR_STATE, timestamp, {
-            series: bundle.sar.series,
-            params: bundle.sar.params,
-        }),
-        supertrend: supertrendActive ? {
-            timestamp,
-            series: bundle.supertrend.series,
-            params: bundle.supertrend.params,
-            valueMin: supertrendBounds.valueMin,
-            valueMax: supertrendBounds.valueMax,
-            visibleMin: supertrendExtremes.min,
-            visibleMax: supertrendExtremes.max,
-        } : mergeEmptyState(EMPTY_SUPERTREND_STATE, timestamp, {
-            series: bundle.supertrend.series,
-            params: bundle.supertrend.params,
-        }),
-        keltner: keltnerActive ? {
-            timestamp,
-            series: bundle.keltner.series,
-            params: bundle.keltner.params,
-            valueMin: keltnerBounds.valueMin,
-            valueMax: keltnerBounds.valueMax,
-            visibleMin: keltnerExtremes.min,
-            visibleMax: keltnerExtremes.max,
-        } : mergeEmptyState(EMPTY_KELTNER_STATE, timestamp, {
-            series: bundle.keltner.series,
-            params: bundle.keltner.params,
-        }),
-        donchian: donchianActive ? {
-            timestamp,
-            series: bundle.donchian.series,
-            params: bundle.donchian.params,
-            valueMin: donchianBounds.valueMin,
-            valueMax: donchianBounds.valueMax,
-            visibleMin: donchianExtremes.min,
-            visibleMax: donchianExtremes.max,
-        } : mergeEmptyState(EMPTY_DONCHIAN_STATE, timestamp, {
-            series: bundle.donchian.series,
-            params: bundle.donchian.params,
-        }),
-        ichimoku: ichimokuActive ? {
-            timestamp,
-            series: bundle.ichimoku.series,
-            params: bundle.ichimoku.params,
-            valueMin: ichimokuBounds.valueMin,
-            valueMax: ichimokuBounds.valueMax,
-            visibleMin: ichimokuExtremes.min,
-            visibleMax: ichimokuExtremes.max,
-        } : mergeEmptyState(EMPTY_ICHIMOKU_STATE, timestamp, {
-            series: bundle.ichimoku.series,
-            params: bundle.ichimoku.params,
-        }),
-        roc: rocActive ? {
-            timestamp,
-            series: bundle.roc.series,
-            params: bundle.roc.params,
-            valueMin: rocBounds.valueMin,
-            valueMax: rocBounds.valueMax,
-            visibleMin: rocExtremes.min,
-            visibleMax: rocExtremes.max,
-        } : mergeEmptyState(EMPTY_ROC_STATE, timestamp, {
-            series: bundle.roc.series,
-            params: bundle.roc.params,
-        }),
-        trix: trixActive ? {
-            timestamp,
-            series: bundle.trix.series,
-            signalSeries: bundle.trix.signalSeries,
-            params: bundle.trix.params,
-            valueMin: trixBounds.valueMin,
-            valueMax: trixBounds.valueMax,
-            visibleMin: Math.min(trixSeriesExtremes?.min ?? Infinity, trixSignalExtremes?.min ?? Infinity),
-            visibleMax: Math.max(trixSeriesExtremes?.max ?? -Infinity, trixSignalExtremes?.max ?? -Infinity),
-        } : mergeEmptyState(EMPTY_TRIX_STATE, timestamp, {
-            series: bundle.trix.series,
-            signalSeries: bundle.trix.signalSeries,
-            params: bundle.trix.params,
-        }),
-        hv: hvActive ? {
-            timestamp,
-            series: bundle.hv.series,
-            params: bundle.hv.params,
-            valueMin: 0,
-            valueMax: hvValueMax,
-            visibleMin: hvExtremes.min,
-            visibleMax: hvExtremes.max,
-        } : mergeEmptyState(EMPTY_HV_STATE, timestamp, {
-            series: bundle.hv.series,
-            params: bundle.hv.params,
-        }),
-        parkinson: parkinsonActive ? {
-            timestamp,
-            series: bundle.parkinson.series,
-            params: bundle.parkinson.params,
-            valueMin: 0,
-            valueMax: parkinsonValueMax,
-            visibleMin: parkinsonExtremes.min,
-            visibleMax: parkinsonExtremes.max,
-        } : mergeEmptyState(EMPTY_PARKINSON_STATE, timestamp, {
-            series: bundle.parkinson.series,
-            params: bundle.parkinson.params,
-        }),
-        chaikinVol: chaikinVolActive ? {
-            timestamp,
-            series: bundle.chaikinVol.series,
-            params: bundle.chaikinVol.params,
-            valueMin: chaikinVolBounds.valueMin,
-            valueMax: chaikinVolBounds.valueMax,
-            visibleMin: chaikinVolExtremes.min,
-            visibleMax: chaikinVolExtremes.max,
-        } : mergeEmptyState(EMPTY_CHAIKIN_VOL_STATE, timestamp, {
-            series: bundle.chaikinVol.series,
-            params: bundle.chaikinVol.params,
-        }),
-        vma: vmaActive ? {
-            timestamp,
-            series: bundle.vma.series,
-            params: bundle.vma.params,
-            valueMin: 0,
-            valueMax: vmaValueMax,
-            visibleMin: vmaExtremes.min,
-            visibleMax: vmaExtremes.max,
-        } : mergeEmptyState(EMPTY_VMA_STATE, timestamp, {
-            series: bundle.vma.series,
-            params: bundle.vma.params,
-        }),
-        obv: obvActive ? {
-            timestamp,
-            series: bundle.obv.series,
-            params: bundle.obv.params,
-            valueMin: obvBounds.valueMin,
-            valueMax: obvBounds.valueMax,
-            visibleMin: obvExtremes.min,
-            visibleMax: obvExtremes.max,
-        } : mergeEmptyState(EMPTY_OBV_STATE, timestamp, {
-            series: bundle.obv.series,
-            params: bundle.obv.params,
-        }),
-        pvt: pvtActive ? {
-            timestamp,
-            series: bundle.pvt.series,
-            params: bundle.pvt.params,
-            valueMin: pvtBounds.valueMin,
-            valueMax: pvtBounds.valueMax,
-            visibleMin: pvtExtremes.min,
-            visibleMax: pvtExtremes.max,
-        } : mergeEmptyState(EMPTY_PVT_STATE, timestamp, {
-            series: bundle.pvt.series,
-            params: bundle.pvt.params,
-        }),
-        vwap: vwapActive ? {
-            timestamp,
-            series: bundle.vwap.series,
-            params: bundle.vwap.params,
-            valueMin: vwapBounds.valueMin,
-            valueMax: vwapBounds.valueMax,
-            visibleMin: vwapExtremes.min,
-            visibleMax: vwapExtremes.max,
-        } : mergeEmptyState(EMPTY_VWAP_STATE, timestamp, {
-            series: bundle.vwap.series,
-            params: bundle.vwap.params,
-        }),
-        cmf: cmfActive ? {
-            timestamp,
-            series: bundle.cmf.series,
-            params: bundle.cmf.params,
-            valueMin: -1,
-            valueMax: 1,
-            visibleMin: cmfExtremes.min,
-            visibleMax: cmfExtremes.max,
-        } : mergeEmptyState(EMPTY_CMF_STATE, timestamp, {
-            series: bundle.cmf.series,
-            params: bundle.cmf.params,
-        }),
-        mfi: mfiActive ? {
-            timestamp,
-            series: bundle.mfi.series,
-            params: bundle.mfi.params,
-            valueMin: 0,
-            valueMax: 100,
-            visibleMin: mfiExtremes.min,
-            visibleMax: mfiExtremes.max,
-        } : mergeEmptyState(EMPTY_MFI_STATE, timestamp, {
-            series: bundle.mfi.series,
-            params: bundle.mfi.params,
-        }),
-        pivot: pivotActive ? {
-            timestamp,
-            series: bundle.pivot.series,
-            params: bundle.pivot.params,
-            valueMin: pivotExtremes.min,
-            valueMax: pivotExtremes.max,
-            visibleMin: pivotExtremes.min,
-            visibleMax: pivotExtremes.max,
-        } : mergeEmptyState(EMPTY_PIVOT_STATE, timestamp, {
-            series: bundle.pivot.series,
-            params: bundle.pivot.params,
-        }),
-        fib: fibActive ? {
-            timestamp,
-            series: bundle.fib.series,
-            params: bundle.fib.params,
-            valueMin: fibExtremes.min,
-            valueMax: fibExtremes.max,
-            visibleMin: fibExtremes.min,
-            visibleMax: fibExtremes.max,
-        } : mergeEmptyState(EMPTY_FIB_STATE, timestamp, {
-            series: bundle.fib.series,
-            params: bundle.fib.params,
-        }),
-        structure: structureActive ? {
-            timestamp,
-            series: bundle.structure.series,
-            params: bundle.structure.params,
-            valueMin: 0,
-            valueMax: 1,
-            visibleMin: 0,
-            visibleMax: 1,
-        } : mergeEmptyState(EMPTY_STRUCTURE_STATE, timestamp, {
-            series: bundle.structure.series,
-            params: bundle.structure.params,
-        }),
-        zones: zonesActive ? {
-            timestamp,
-            series: bundle.zones.series,
-            params: bundle.zones.params,
-            valueMin: 0,
-            valueMax: 1,
-            visibleMin: 0,
-            visibleMax: 1,
-        } : mergeEmptyState(EMPTY_ZONES_STATE, timestamp, {
-            series: bundle.zones.series,
-            params: bundle.zones.params,
-        }),
-        volumeProfile: vpActive ? {
-            timestamp,
-            series: bundle.volumeProfile.series,
-            params: bundle.volumeProfile.params,
-            valueMin: bundle.volumeProfile.series.bins[0]?.priceLow ?? 0,
-            valueMax: bundle.volumeProfile.series.bins[bundle.volumeProfile.series.bins.length - 1]?.priceHigh ?? 1,
-            visibleMin: bundle.volumeProfile.series.val,
-            visibleMax: bundle.volumeProfile.series.vah,
-        } : mergeEmptyState(EMPTY_VOLUME_PROFILE_STATE, timestamp, {
-            series: bundle.volumeProfile.series,
-            params: bundle.volumeProfile.params,
-        }),
-    };
+export function composeVisibleSubIndicatorStates(bundle, visibleRange, timestamp, activeMask = {}, getIndicatorMetadata) {
+    const states = {};
+    for (const indicatorId of METADATA_VISIBLE_STATE_INDICATOR_IDS) {
+        states[indicatorId] = composeRequiredMetadataVisibleState(indicatorId, bundle, visibleRange, timestamp, activeMask, getIndicatorMetadata);
+    }
+    return states;
 }
 /**
  * 从 series bundle 组装所有 render states
  * 同时计算 visibleMin/visibleMax 等派生字段
  */
-export function composeRenderStates(bundle, visibleRange, timestamp) {
-    const maExtremes = calcMAExtremes(bundle.ma.series, visibleRange);
-    const bollExtremes = calcBOLLExtremes(bundle.boll.series, visibleRange);
-    const expmaExtremes = calcEXPMAExtremes(bundle.expma.series, visibleRange);
-    const eneExtremes = calcENEExtremes(bundle.ene.series, visibleRange);
-    const subStates = composeVisibleSubIndicatorStates(bundle, visibleRange, timestamp);
+export function composeRenderStates(bundle, visibleRange, timestamp, getIndicatorMetadata) {
+    const mainStates = composeMainRenderStates(bundle, visibleRange, timestamp, getIndicatorMetadata);
+    const subStates = composeVisibleSubIndicatorStates(bundle, visibleRange, timestamp, {}, getIndicatorMetadata);
     return {
-        ma: {
-            timestamp,
-            series: bundle.ma.series,
-            enabledPeriods: bundle.ma.enabledPeriods,
-            visibleMin: maExtremes.min,
-            visibleMax: maExtremes.max,
-        },
-        boll: {
-            timestamp,
-            series: bundle.boll.series,
-            params: bundle.boll.params,
-            visibleMin: bollExtremes.min,
-            visibleMax: bollExtremes.max,
-        },
-        expma: {
-            timestamp,
-            series: bundle.expma.series,
-            params: bundle.expma.params,
-            visibleMin: expmaExtremes.min,
-            visibleMax: expmaExtremes.max,
-        },
-        ene: {
-            timestamp,
-            series: bundle.ene.series,
-            params: bundle.ene.params,
-            visibleMin: eneExtremes.min,
-            visibleMax: eneExtremes.max,
-        },
+        ...mainStates,
         ...subStates,
     };
 }
-// ============================================================================
-// 极值计算辅助函数
-// ============================================================================
-function calcMAExtremes(series, range) {
-    const seriesList = Object.values(series);
-    if (seriesList.length === 0 || range.start >= seriesList[0].length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    for (const values of seriesList) {
-        const end = Math.min(range.end, values.length);
-        for (let i = range.start; i < end; i++) {
-            const v = values[i];
-            if (v !== undefined) {
-                min = Math.min(min, v);
-                max = Math.max(max, v);
-            }
-        }
-    }
-    return { min, max };
-}
-function calcBOLLExtremes(series, range) {
-    if (series.length === 0 || range.start >= series.length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    const end = Math.min(range.end, series.length);
-    for (let i = range.start; i < end; i++) {
-        const p = series[i];
-        if (p) {
-            min = Math.min(min, p.upper, p.middle, p.lower);
-            max = Math.max(max, p.upper, p.middle, p.lower);
-        }
-    }
-    return { min, max };
-}
-function calcEXPMAExtremes(series, range) {
-    if (series.length === 0 || range.start >= series.length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    const end = Math.min(range.end, series.length);
-    for (let i = range.start; i < end; i++) {
-        const p = series[i];
-        if (p) {
-            min = Math.min(min, p.fast, p.slow);
-            max = Math.max(max, p.fast, p.slow);
-        }
-    }
-    return { min, max };
-}
-function calcENEExtremes(series, range) {
-    if (series.length === 0 || range.start >= series.length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    const end = Math.min(range.end, series.length);
-    for (let i = range.start; i < end; i++) {
-        const p = series[i];
-        if (p) {
-            min = Math.min(min, p.upper, p.middle, p.lower);
-            max = Math.max(max, p.upper, p.middle, p.lower);
-        }
-    }
-    return { min, max };
-}
-function calcRSIExtremes(series, range) {
-    const seriesList = Object.values(series);
-    if (seriesList.length === 0 || range.start >= seriesList[0].length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    for (const values of seriesList) {
-        const end = Math.min(range.end, values.length);
-        for (let i = range.start; i < end; i++) {
-            const v = values[i];
-            if (v !== undefined) {
-                min = Math.min(min, v);
-                max = Math.max(max, v);
-            }
-        }
-    }
-    return { min, max };
-}
-function calcCCIExtremes(series, range) {
-    if (series.length === 0 || range.start >= series.length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    const end = Math.min(range.end, series.length);
-    for (let i = range.start; i < end; i++) {
-        const v = series[i];
-        if (v !== undefined) {
-            min = Math.min(min, v);
-            max = Math.max(max, v);
-        }
-    }
-    return { min, max };
-}
-function calcSTOCHExtremes(series, range) {
-    if (series.length === 0 || range.start >= series.length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    const end = Math.min(range.end, series.length);
-    for (let i = range.start; i < end; i++) {
-        const p = series[i];
-        if (p) {
-            min = Math.min(min, p.k, p.d);
-            max = Math.max(max, p.k, p.d);
-        }
-    }
-    return { min, max };
-}
-function calcMOMExtremes(series, range) {
-    if (series.length === 0 || range.start >= series.length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    const end = Math.min(range.end, series.length);
-    for (let i = range.start; i < end; i++) {
-        const v = series[i];
-        if (v !== undefined) {
-            min = Math.min(min, v);
-            max = Math.max(max, v);
-        }
-    }
-    return { min, max };
-}
-function calcWMSRExtremes(series, range) {
-    if (series.length === 0 || range.start >= series.length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    const end = Math.min(range.end, series.length);
-    for (let i = range.start; i < end; i++) {
-        const v = series[i];
-        if (v !== undefined) {
-            min = Math.min(min, v);
-            max = Math.max(max, v);
-        }
-    }
-    return { min, max };
-}
-function calcKSTExtremes(series, range) {
-    // 快速检查：空数据直接返回
-    if (series.length === 0 || range.start >= series.length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    const end = Math.min(range.end, series.length);
-    for (let i = range.start; i < end; i++) {
-        const p = series[i];
-        if (p) {
-            min = Math.min(min, p.kst, p.signal);
-            max = Math.max(max, p.kst, p.signal);
-        }
-    }
-    return { min, max };
-}
-function calcFASTKExtremes(series, range) {
-    if (series.length === 0 || range.start >= series.length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    const end = Math.min(range.end, series.length);
-    for (let i = range.start; i < end; i++) {
-        const v = series[i];
-        if (v !== undefined) {
-            min = Math.min(min, v);
-            max = Math.max(max, v);
-        }
-    }
-    return { min, max };
-}
-function calcMACDExtremes(series, range) {
-    if (series.length === 0 || range.start >= series.length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    const end = Math.min(range.end, series.length);
-    for (let i = range.start; i < end; i++) {
-        const p = series[i];
-        if (p) {
-            min = Math.min(min, p.dif, p.dea, p.macd);
-            max = Math.max(max, p.dif, p.dea, p.macd);
-        }
-    }
-    return { min, max };
-}
-function calcATRExtremes(series, range) {
-    return calcSparseExtremes(series, range);
-}
-function calcPivotExtremes(series, range) {
-    if (series.length === 0 || range.start >= series.length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    const end = Math.min(range.end, series.length);
-    for (let i = range.start; i < end; i++) {
-        const p = series[i];
-        if (!p)
-            continue;
-        for (const v of [p.pp, p.r1, p.r2, p.r3, p.s1, p.s2, p.s3]) {
-            if (v < min)
-                min = v;
-            if (v > max)
-                max = v;
-        }
-    }
-    return { min, max };
-}
-function calcFibExtremes(series, range) {
-    if (series.length === 0 || range.start >= series.length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    const end = Math.min(range.end, series.length);
-    for (let i = range.start; i < end; i++) {
-        const p = series[i];
-        if (!p)
-            continue;
-        if (p.low < min)
-            min = p.low;
-        if (p.high > max)
-            max = p.high;
-    }
-    return { min, max };
-}
-function calcIchimokuExtremes(series, range) {
-    if (series.length === 0 || range.start >= series.length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    const end = Math.min(range.end, series.length);
-    for (let i = range.start; i < end; i++) {
-        const p = series[i];
-        if (!p)
+function composeRequiredMetadataVisibleState(indicatorId, bundle, visibleRange, timestamp, activeMask, getIndicatorMetadata) {
+    const meta = getIndicatorMetadata(indicatorId);
+    if (!meta)
+        return undefined;
+    const compose = meta.visibleState?.compose;
+    if (!compose) {
+        throw new Error(`[StateComposer] Missing visibleState.compose for ${indicatorId}`);
+    }
+    return compose({
+        bundle,
+        visibleRange,
+        timestamp,
+        active: activeMask[indicatorId] ?? true,
+    });
+}
+function composeMainRenderStates(bundle, visibleRange, timestamp, getIndicatorMetadata) {
+    const states = {};
+    for (const indicatorId of MAIN_RENDER_STATE_INDICATOR_IDS) {
+        const definition = getIndicatorMetadata(indicatorId);
+        if (!definition)
             continue;
-        for (const field of [p.tenkan, p.kijun, p.spanA, p.spanB, p.chikou]) {
-            if (field !== undefined) {
-                if (field < min)
-                    min = field;
-                if (field > max)
-                    max = field;
-            }
-        }
-    }
-    return { min, max };
-}
-function calcBandExtremes(series, range) {
-    if (series.length === 0 || range.start >= series.length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    const end = Math.min(range.end, series.length);
-    for (let i = range.start; i < end; i++) {
-        const p = series[i];
-        if (p) {
-            min = Math.min(min, p.lower);
-            max = Math.max(max, p.upper);
-        }
-    }
-    return { min, max };
-}
-function calcSARExtremes(series, range) {
-    if (series.length === 0 || range.start >= series.length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    const end = Math.min(range.end, series.length);
-    for (let i = range.start; i < end; i++) {
-        const p = series[i];
-        if (p) {
-            min = Math.min(min, p.value);
-            max = Math.max(max, p.value);
-        }
-    }
-    return { min, max };
-}
-function calcSparseExtremes(series, range) {
-    if (series.length === 0 || range.start >= series.length) {
-        return { min: Infinity, max: -Infinity };
-    }
-    let min = Infinity;
-    let max = -Infinity;
-    const end = Math.min(range.end, series.length);
-    for (let i = range.start; i < end; i++) {
-        const v = series[i];
-        if (v !== undefined) {
-            min = Math.min(min, v);
-            max = Math.max(max, v);
+        const composeRenderState = definition.mainPane?.composeRenderState;
+        if (!composeRenderState) {
+            throw new Error(`[StateComposer] Missing mainPane.composeRenderState for ${indicatorId}`);
         }
+        states[indicatorId] = composeRenderState(bundle, visibleRange, timestamp);
     }
-    return { min, max };
+    return states;
 }
 /**
  * 计算主图指标价格范围
  * 用于 Chart.draw() 中的 pane.updateRange
  */
-export function computeMainIndicatorPriceRange(bundle, visibleRange, activeMainIndicators) {
+export function computeMainIndicatorPriceRange(bundle, visibleRange, activeMainIndicators, getIndicatorMetadata) {
     let min = Infinity;
     let max = -Infinity;
-    const { start, end } = visibleRange;
-    // MA
-    if (activeMainIndicators.has('ma') && Object.keys(bundle.ma.series).length > 0) {
-        for (const values of Object.values(bundle.ma.series)) {
-            for (let i = start; i < end && i < values.length; i++) {
-                const v = values[i];
-                if (v !== undefined) {
-                    min = Math.min(min, v);
-                    max = Math.max(max, v);
-                }
-            }
-        }
-    }
-    // BOLL
-    if (activeMainIndicators.has('boll') && bundle.boll.series.length > 0) {
-        for (let i = start; i < end && i < bundle.boll.series.length; i++) {
-            const p = bundle.boll.series[i];
-            if (p) {
-                min = Math.min(min, p.upper, p.middle, p.lower);
-                max = Math.max(max, p.upper, p.middle, p.lower);
-            }
-        }
-    }
-    // EXPMA
-    if (activeMainIndicators.has('expma') && bundle.expma.series.length > 0) {
-        for (let i = start; i < end && i < bundle.expma.series.length; i++) {
-            const p = bundle.expma.series[i];
-            if (p) {
-                min = Math.min(min, p.fast, p.slow);
-                max = Math.max(max, p.fast, p.slow);
-            }
-        }
-    }
-    // ENE
-    if (activeMainIndicators.has('ene') && bundle.ene.series.length > 0) {
-        for (let i = start; i < end && i < bundle.ene.series.length; i++) {
-            const p = bundle.ene.series[i];
-            if (p) {
-                min = Math.min(min, p.upper, p.middle, p.lower);
-                max = Math.max(max, p.upper, p.middle, p.lower);
-            }
-        }
+    for (const indicatorId of activeMainIndicators) {
+        const range = getIndicatorMetadata(indicatorId)?.mainPane?.computePriceRange?.(bundle, visibleRange);
+        if (!range)
+            continue;
+        min = Math.min(min, range.min);
+        max = Math.max(max, range.max);
     }
     if (!Number.isFinite(min) || !Number.isFinite(max)) {
         return null;