@363045841yyt/klinechart-core 0.7.3 → 0.7.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (247) hide show
  1. package/README.md +201 -201
  2. package/README.zh-CN.md +201 -201
  3. package/dist/controllers/index.d.ts +1 -0
  4. package/dist/controllers/index.d.ts.map +1 -1
  5. package/dist/controllers/index.js +1 -0
  6. package/dist/controllers/index.js.map +1 -1
  7. package/dist/engine/chart.d.ts +11 -19
  8. package/dist/engine/chart.d.ts.map +1 -1
  9. package/dist/engine/chart.js +92 -109
  10. package/dist/engine/chart.js.map +1 -1
  11. package/dist/engine/renderers/Indicator/indicatorData.d.ts +1 -0
  12. package/dist/engine/renderers/Indicator/indicatorData.d.ts.map +1 -1
  13. package/dist/engine/renderers/Indicator/indicatorData.js +1 -1
  14. package/dist/engine/renderers/Indicator/indicatorData.js.map +1 -1
  15. package/dist/engine/renderers/webgl/candleSurface.js +47 -47
  16. package/dist/engine/subPaneManager.d.ts +4 -0
  17. package/dist/engine/subPaneManager.d.ts.map +1 -1
  18. package/dist/engine/subPaneManager.js +13 -0
  19. package/dist/engine/subPaneManager.js.map +1 -1
  20. package/dist/version.d.ts +1 -1
  21. package/dist/version.d.ts.map +1 -1
  22. package/dist/version.js +1 -2
  23. package/dist/version.js.map +1 -1
  24. package/package.json +129 -122
  25. package/src/__tests__/signal.test.ts +124 -124
  26. package/src/config/chartSettings.ts +66 -66
  27. package/src/controllers/__tests__/drawing.test.ts +214 -214
  28. package/src/controllers/__tests__/indicatorSelector.test.ts +481 -481
  29. package/src/controllers/__tests__/toolbar.test.ts +225 -225
  30. package/src/controllers/createChartController.ts +665 -665
  31. package/src/controllers/createDrawingController.ts +96 -96
  32. package/src/controllers/createIndicatorSelectorController.ts +307 -307
  33. package/src/controllers/createToolbarController.ts +146 -146
  34. package/src/controllers/index.ts +20 -19
  35. package/src/controllers/types.ts +284 -284
  36. package/src/engine/__tests__/chart.dpr.test.ts +401 -401
  37. package/src/engine/__tests__/paneRenderer.resize.test.ts +92 -92
  38. package/src/engine/chart-store.ts +121 -121
  39. package/src/engine/chart.d.ts +617 -617
  40. package/src/engine/chart.ts +2803 -2815
  41. package/src/engine/controller/__tests__/interaction.dpr.test.ts +259 -259
  42. package/src/engine/controller/interaction.ts +722 -722
  43. package/src/engine/controller/markerInteraction.ts +130 -130
  44. package/src/engine/controller/pinchTracker.ts +82 -82
  45. package/src/engine/controller/tooltipPosition.ts +48 -48
  46. package/src/engine/draw/__tests__/pixelAlign.spec.ts +176 -176
  47. package/src/engine/draw/pixelAlign.ts +259 -259
  48. package/src/engine/drawing/index.ts +655 -655
  49. package/src/engine/drawing/interaction.ts +842 -842
  50. package/src/engine/drawing/plugin.ts +343 -343
  51. package/src/engine/indicators/__tests__/__fixtures__/golden/atr.json +38 -38
  52. package/src/engine/indicators/__tests__/__fixtures__/golden/dema.json +14 -14
  53. package/src/engine/indicators/__tests__/__fixtures__/golden/hma.json +14 -14
  54. package/src/engine/indicators/__tests__/__fixtures__/golden/index.ts +55 -55
  55. package/src/engine/indicators/__tests__/__fixtures__/golden/kama.json +14 -14
  56. package/src/engine/indicators/__tests__/__fixtures__/golden/tema.json +14 -14
  57. package/src/engine/indicators/__tests__/__fixtures__/golden/wma.json +40 -40
  58. package/src/engine/indicators/__tests__/__fixtures__/synthetic.ts +65 -65
  59. package/src/engine/indicators/__tests__/_propertyAssertions.ts +76 -76
  60. package/src/engine/indicators/__tests__/atr.test.ts +153 -153
  61. package/src/engine/indicators/__tests__/calculators.test.ts +614 -614
  62. package/src/engine/indicators/__tests__/cmf-mfi.test.ts +100 -100
  63. package/src/engine/indicators/__tests__/dema.test.ts +73 -73
  64. package/src/engine/indicators/__tests__/donchian.test.ts +70 -70
  65. package/src/engine/indicators/__tests__/hma.test.ts +73 -73
  66. package/src/engine/indicators/__tests__/ichimoku.test.ts +105 -105
  67. package/src/engine/indicators/__tests__/kama.test.ts +80 -80
  68. package/src/engine/indicators/__tests__/keltner.test.ts +65 -65
  69. package/src/engine/indicators/__tests__/pivot-fib.test.ts +110 -110
  70. package/src/engine/indicators/__tests__/roc.test.ts +68 -68
  71. package/src/engine/indicators/__tests__/sar.test.ts +86 -86
  72. package/src/engine/indicators/__tests__/scheduler.test.ts +831 -831
  73. package/src/engine/indicators/__tests__/soa.test.ts +533 -533
  74. package/src/engine/indicators/__tests__/structure.test.ts +110 -110
  75. package/src/engine/indicators/__tests__/supertrend.test.ts +65 -65
  76. package/src/engine/indicators/__tests__/tema.test.ts +68 -68
  77. package/src/engine/indicators/__tests__/trix.test.ts +70 -70
  78. package/src/engine/indicators/__tests__/volatility.test.ts +117 -117
  79. package/src/engine/indicators/__tests__/volume.test.ts +115 -115
  80. package/src/engine/indicators/__tests__/volumeProfile.test.ts +74 -74
  81. package/src/engine/indicators/__tests__/vwap.test.ts +69 -69
  82. package/src/engine/indicators/__tests__/wma.test.ts +112 -112
  83. package/src/engine/indicators/__tests__/zones.test.ts +95 -95
  84. package/src/engine/indicators/atrState.ts +27 -27
  85. package/src/engine/indicators/bollState.ts +51 -51
  86. package/src/engine/indicators/calculators.ts +2593 -2593
  87. package/src/engine/indicators/cciState.ts +25 -25
  88. package/src/engine/indicators/chaikinVolState.ts +32 -32
  89. package/src/engine/indicators/cmfState.ts +27 -27
  90. package/src/engine/indicators/demaState.ts +27 -27
  91. package/src/engine/indicators/donchianState.ts +43 -43
  92. package/src/engine/indicators/eneState.ts +43 -43
  93. package/src/engine/indicators/expmaState.ts +43 -43
  94. package/src/engine/indicators/fastkState.ts +25 -25
  95. package/src/engine/indicators/fibState.ts +41 -41
  96. package/src/engine/indicators/hmaState.ts +27 -27
  97. package/src/engine/indicators/hvState.ts +28 -28
  98. package/src/engine/indicators/ichimokuState.ts +70 -70
  99. package/src/engine/indicators/indicator.worker.ts +169 -169
  100. package/src/engine/indicators/indicatorDefinitionRegistry.ts +62 -62
  101. package/src/engine/indicators/indicatorMetadata.ts +110 -110
  102. package/src/engine/indicators/indicatorRegistry.ts +106 -106
  103. package/src/engine/indicators/indicatorRuntime.ts +1548 -1548
  104. package/src/engine/indicators/kamaState.ts +34 -34
  105. package/src/engine/indicators/keltnerState.ts +49 -49
  106. package/src/engine/indicators/kstState.ts +42 -42
  107. package/src/engine/indicators/maState.ts +36 -36
  108. package/src/engine/indicators/macdState.ts +76 -76
  109. package/src/engine/indicators/mfiState.ts +27 -27
  110. package/src/engine/indicators/momState.ts +25 -25
  111. package/src/engine/indicators/obvState.ts +25 -25
  112. package/src/engine/indicators/parkinsonState.ts +28 -28
  113. package/src/engine/indicators/pivotState.ts +51 -51
  114. package/src/engine/indicators/pvtState.ts +25 -25
  115. package/src/engine/indicators/rocState.ts +27 -27
  116. package/src/engine/indicators/rsiState.ts +65 -65
  117. package/src/engine/indicators/sarState.ts +41 -41
  118. package/src/engine/indicators/scheduler.ts +1205 -1205
  119. package/src/engine/indicators/soa.ts +352 -352
  120. package/src/engine/indicators/stateComposer.ts +1262 -1262
  121. package/src/engine/indicators/stochState.ts +26 -26
  122. package/src/engine/indicators/structureState.ts +69 -69
  123. package/src/engine/indicators/supertrendState.ts +37 -37
  124. package/src/engine/indicators/temaState.ts +27 -27
  125. package/src/engine/indicators/trixState.ts +35 -35
  126. package/src/engine/indicators/vmaState.ts +27 -27
  127. package/src/engine/indicators/volumeProfileState.ts +63 -63
  128. package/src/engine/indicators/vwapState.ts +29 -29
  129. package/src/engine/indicators/wmaState.ts +27 -27
  130. package/src/engine/indicators/wmsrState.ts +25 -25
  131. package/src/engine/indicators/workerProtocol.ts +613 -613
  132. package/src/engine/indicators/zonesState.ts +47 -47
  133. package/src/engine/layout/pane.ts +161 -161
  134. package/src/engine/marker/registry.ts +265 -265
  135. package/src/engine/paneRenderer.ts +169 -169
  136. package/src/engine/renderers/Indicator/atr.ts +237 -237
  137. package/src/engine/renderers/Indicator/boll.ts +317 -317
  138. package/src/engine/renderers/Indicator/cci.ts +275 -275
  139. package/src/engine/renderers/Indicator/chaikinVol.ts +138 -138
  140. package/src/engine/renderers/Indicator/cmf.ts +137 -137
  141. package/src/engine/renderers/Indicator/dema.ts +136 -136
  142. package/src/engine/renderers/Indicator/donchian.ts +137 -137
  143. package/src/engine/renderers/Indicator/ene.ts +271 -271
  144. package/src/engine/renderers/Indicator/expma.ts +197 -197
  145. package/src/engine/renderers/Indicator/fastk.ts +316 -316
  146. package/src/engine/renderers/Indicator/fib.ts +141 -141
  147. package/src/engine/renderers/Indicator/hma.ts +136 -136
  148. package/src/engine/renderers/Indicator/hv.ts +124 -124
  149. package/src/engine/renderers/Indicator/ichimoku.ts +181 -181
  150. package/src/engine/renderers/Indicator/index.ts +241 -241
  151. package/src/engine/renderers/Indicator/indicatorData.ts +650 -650
  152. package/src/engine/renderers/Indicator/kama.ts +136 -136
  153. package/src/engine/renderers/Indicator/keltner.ts +137 -137
  154. package/src/engine/renderers/Indicator/kst.ts +302 -302
  155. package/src/engine/renderers/Indicator/ma.ts +200 -200
  156. package/src/engine/renderers/Indicator/macd.ts +477 -477
  157. package/src/engine/renderers/Indicator/macdLegend.ts +141 -141
  158. package/src/engine/renderers/Indicator/mainIndicatorLegend.ts +272 -272
  159. package/src/engine/renderers/Indicator/mfi.ts +142 -142
  160. package/src/engine/renderers/Indicator/mom.ts +311 -311
  161. package/src/engine/renderers/Indicator/obv.ts +123 -123
  162. package/src/engine/renderers/Indicator/parkinson.ts +124 -124
  163. package/src/engine/renderers/Indicator/pivot.ts +131 -131
  164. package/src/engine/renderers/Indicator/pvt.ts +123 -123
  165. package/src/engine/renderers/Indicator/roc.ts +143 -143
  166. package/src/engine/renderers/Indicator/rsi.ts +390 -390
  167. package/src/engine/renderers/Indicator/sar.ts +113 -113
  168. package/src/engine/renderers/Indicator/scale/atr_scale.ts +19 -19
  169. package/src/engine/renderers/Indicator/scale/cci_scale.ts +19 -19
  170. package/src/engine/renderers/Indicator/scale/fastk_scale.ts +19 -19
  171. package/src/engine/renderers/Indicator/scale/indicator_scale.ts +204 -204
  172. package/src/engine/renderers/Indicator/scale/kst_scale.ts +19 -19
  173. package/src/engine/renderers/Indicator/scale/macd_scale.ts +22 -22
  174. package/src/engine/renderers/Indicator/scale/mom_scale.ts +19 -19
  175. package/src/engine/renderers/Indicator/scale/rsi_scale.ts +19 -19
  176. package/src/engine/renderers/Indicator/scale/stoch_scale.ts +19 -19
  177. package/src/engine/renderers/Indicator/scale/volume_scale.ts +26 -26
  178. package/src/engine/renderers/Indicator/scale/wmsr_scale.ts +19 -19
  179. package/src/engine/renderers/Indicator/stoch.ts +359 -359
  180. package/src/engine/renderers/Indicator/structure.ts +126 -126
  181. package/src/engine/renderers/Indicator/subPaneConfig.ts +265 -265
  182. package/src/engine/renderers/Indicator/supertrend.ts +115 -115
  183. package/src/engine/renderers/Indicator/tema.ts +136 -136
  184. package/src/engine/renderers/Indicator/trix.ts +158 -158
  185. package/src/engine/renderers/Indicator/vma.ts +124 -124
  186. package/src/engine/renderers/Indicator/volumeProfile.ts +125 -125
  187. package/src/engine/renderers/Indicator/vwap.ts +123 -123
  188. package/src/engine/renderers/Indicator/wma.ts +136 -136
  189. package/src/engine/renderers/Indicator/wmsr.ts +328 -328
  190. package/src/engine/renderers/Indicator/zones.ts +104 -104
  191. package/src/engine/renderers/__tests__/boll.renderer.test.ts +314 -314
  192. package/src/engine/renderers/__tests__/ene.renderer.test.ts +305 -305
  193. package/src/engine/renderers/__tests__/expma.renderer.test.ts +279 -279
  194. package/src/engine/renderers/__tests__/ma.renderer.test.ts +426 -426
  195. package/src/engine/renderers/__tests__/mainIndicatorLegend.renderer.test.ts +502 -502
  196. package/src/engine/renderers/__tests__/yAxis.renderer.test.ts +173 -173
  197. package/src/engine/renderers/candle.ts +459 -459
  198. package/src/engine/renderers/crosshair.ts +69 -69
  199. package/src/engine/renderers/customMarkers.ts +162 -162
  200. package/src/engine/renderers/extremaMarkers.ts +246 -246
  201. package/src/engine/renderers/gridLines.ts +90 -90
  202. package/src/engine/renderers/lastPrice.ts +97 -97
  203. package/src/engine/renderers/paneTitle.ts +136 -136
  204. package/src/engine/renderers/subVolume.ts +236 -236
  205. package/src/engine/renderers/timeAxis.ts +121 -121
  206. package/src/engine/renderers/webgl/candleSurface.ts +955 -955
  207. package/src/engine/renderers/webgl/sharedWebGLSurface.ts +146 -146
  208. package/src/engine/renderers/yAxis.ts +105 -105
  209. package/src/engine/scale/__tests__/logFormula.spec.ts +148 -148
  210. package/src/engine/scale/logFormula.ts +130 -130
  211. package/src/engine/scale/price.ts +39 -39
  212. package/src/engine/scale/priceScale.ts +264 -264
  213. package/src/engine/subPaneManager.ts +442 -427
  214. package/src/engine/theme/colors.ts +642 -642
  215. package/src/engine/theme/fonts.ts +20 -20
  216. package/src/engine/utils/klineConfig.ts +49 -49
  217. package/src/engine/utils/tickCount.ts +11 -11
  218. package/src/engine/utils/tickPosition.ts +214 -214
  219. package/src/engine/utils/zoom.ts +83 -83
  220. package/src/engine/viewport/viewport.ts +67 -67
  221. package/src/index.ts +3 -3
  222. package/src/plugin/ConfigManager.ts +93 -93
  223. package/src/plugin/EventBus.ts +77 -77
  224. package/src/plugin/HookSystem.ts +106 -106
  225. package/src/plugin/PluginHost.ts +243 -243
  226. package/src/plugin/PluginRegistry.ts +92 -92
  227. package/src/plugin/StateStore.ts +73 -73
  228. package/src/plugin/index.ts +19 -19
  229. package/src/plugin/rendererPluginManager.ts +368 -368
  230. package/src/plugin/stateKeys.ts +8 -8
  231. package/src/plugin/types.ts +526 -526
  232. package/src/reactivity/index.ts +2 -2
  233. package/src/reactivity/signal.ts +119 -119
  234. package/src/semantic/controller.ts +251 -251
  235. package/src/semantic/drawShape.ts +260 -260
  236. package/src/semantic/index.ts +28 -28
  237. package/src/semantic/schema.json +256 -256
  238. package/src/semantic/types.ts +251 -251
  239. package/src/semantic/validator.ts +349 -349
  240. package/src/types/kLine.ts +13 -13
  241. package/src/types/price.ts +56 -56
  242. package/src/types/volumePrice.ts +33 -33
  243. package/src/utils/dateFormat.ts +208 -208
  244. package/src/utils/kLineDraw/axis.ts +562 -562
  245. package/src/utils/priceToY.ts +34 -34
  246. package/src/utils/volumePrice.ts +202 -202
  247. package/src/version.ts +1 -1
@@ -1,272 +1,272 @@
1
- import type { RendererPluginWithHost, PluginHost, RenderContext } from '../../../plugin'
2
- import { RENDERER_PRIORITY } from '../../../plugin'
3
- import type { KLineData } from '../../../types/price'
4
- import { MA_STATE_KEY, type MARenderState } from '../../indicators/maState'
5
- import { BOLL_STATE_KEY, type BOLLRenderState } from '../../indicators/bollState'
6
- import { EXPMA_STATE_KEY, type EXPMARenderState } from '../../indicators/expmaState'
7
- import { ENE_STATE_KEY, type ENERenderState } from '../../indicators/eneState'
8
- import { getColors } from '../../theme/colors'
9
- import { getFont, setCanvasFont } from '../../theme/fonts'
10
-
11
- const textWidthCache = new Map<string, number>()
12
- const TEXT_WIDTH_CACHE_LIMIT = 512
13
-
14
- function measureTextWidth(ctx: CanvasRenderingContext2D, text: string): number {
15
- const key = `${ctx.font}\n${text}`
16
- const cached = textWidthCache.get(key)
17
- if (cached !== undefined) {
18
- return cached
19
- }
20
-
21
- const width = ctx.measureText(text).width
22
- if (textWidthCache.size >= TEXT_WIDTH_CACHE_LIMIT) {
23
- textWidthCache.clear()
24
- }
25
- textWidthCache.set(key, width)
26
- return width
27
- }
28
-
29
- /** 指标行数据 */
30
- interface IndicatorRow {
31
- enabled: boolean
32
- params: Record<string, unknown>
33
- }
34
-
35
- /** 渲染器配置 */
36
- interface MainIndicatorLegendConfig {
37
- yPaddingPx: number
38
- indicators: Record<string, IndicatorRow>
39
- }
40
-
41
- /**
42
- * 创建主图指标图例渲染器插件
43
- *
44
- * 统一管理 MA、BOLL 等主图指标的图例显示,支持多行排列
45
- * MA 数据从 StateStore 读取(与 MA 线渲染器共享同一数据源)
46
- */
47
- export function createMainIndicatorLegendRendererPlugin(options: {
48
- yPaddingPx: number
49
- }): RendererPluginWithHost {
50
- const config: MainIndicatorLegendConfig = {
51
- yPaddingPx: options.yPaddingPx,
52
- indicators: {
53
- MA: { enabled: true, params: {} },
54
- BOLL: { enabled: false, params: { period: 20, multiplier: 2 } },
55
- EXPMA: { enabled: false, params: { fastPeriod: 12, slowPeriod: 50 } },
56
- ENE: { enabled: false, params: { period: 10, deviation: 11 } },
57
- },
58
- }
59
-
60
- let pluginHost: PluginHost | null = null
61
-
62
- return {
63
- name: 'mainIndicatorLegend',
64
- version: '2.1.0',
65
- description: '主图指标图例渲染器(MA 数据来自 StateStore)',
66
- debugName: '主图指标图例',
67
- paneId: 'main',
68
- priority: RENDERER_PRIORITY.FOREGROUND,
69
- layer: 'overlay',
70
- enabled: true,
71
-
72
- onInstall(host: PluginHost): void {
73
- pluginHost = host
74
- },
75
-
76
- getDeclaredNamespaces(): string[] {
77
- return [MA_STATE_KEY, BOLL_STATE_KEY, EXPMA_STATE_KEY, ENE_STATE_KEY]
78
- },
79
-
80
- draw(context: RenderContext) {
81
- const { overlayCtx, data, range, crosshairIndex } = context
82
- const klineData = data as KLineData[]
83
- const colors = getColors(context.theme)
84
- if (!klineData.length || !overlayCtx) return
85
-
86
- const fontSize = 12
87
- const lineHeight = fontSize + 6
88
- const legendX = 12
89
- const gap = 10
90
-
91
- overlayCtx.save()
92
- setCanvasFont(overlayCtx, getFont(fontSize))
93
- overlayCtx.textAlign = 'left'
94
-
95
- const targetIndex = crosshairIndex ?? Math.min(range.end - 1, klineData.length - 1)
96
- const rows: Array<{ draw: (rowIndex: number) => void }> = []
97
-
98
- const maIndicator = config.indicators.MA
99
- if (maIndicator?.enabled) {
100
- rows.push({
101
- draw: (rowIndex: number) => {
102
- const items: Array<{ label: string; color: string; value?: number }> = []
103
- const state = pluginHost?.getSharedState<MARenderState>(MA_STATE_KEY)
104
-
105
- if (state && state.visibleMin <= state.visibleMax) {
106
- for (const period of state.enabledPeriods) {
107
- const colorKey = `MA${period}` as keyof typeof colors.MA
108
- const series = state.series[period]
109
- const value = series?.[targetIndex]
110
-
111
- items.push({
112
- label: `MA${period}`,
113
- color: colors.MA[colorKey] || colors.MA.MA5,
114
- value: value,
115
- })
116
- }
117
- }
118
-
119
- if (items.length > 0) {
120
- let x = legendX
121
- const y = config.yPaddingPx / 2 + fontSize + rowIndex * lineHeight
122
-
123
- overlayCtx.fillStyle = colors.PRICE.NEUTRAL
124
- overlayCtx.fillText('MA', x, y)
125
- x += measureTextWidth(overlayCtx, 'MA') + gap
126
-
127
- for (const it of items) {
128
- const valText = typeof it.value === 'number' ? ` ${it.value.toFixed(2)}` : ''
129
- const text = `${it.label}${valText}`
130
- overlayCtx.fillStyle = it.color
131
- overlayCtx.fillText(text, x, y)
132
- x += measureTextWidth(overlayCtx, text) + gap
133
- }
134
- }
135
- }
136
- })
137
- }
138
-
139
- const bollIndicator = config.indicators.BOLL
140
- if (bollIndicator?.enabled) {
141
- rows.push({
142
- draw: (rowIndex: number) => {
143
- const bollState = pluginHost?.getSharedState<BOLLRenderState>(BOLL_STATE_KEY)
144
- const boll = bollState?.series[targetIndex]
145
- const period = bollState?.params.period ?? 20
146
- const multiplier = bollState?.params.multiplier ?? 2
147
-
148
- let x = legendX
149
- const y = config.yPaddingPx / 2 + fontSize + rowIndex * lineHeight
150
- const titleText = `BOLL(${period},${multiplier})`
151
-
152
- overlayCtx.fillStyle = colors.PRICE.NEUTRAL
153
- overlayCtx.fillText(titleText, x, y)
154
- x += measureTextWidth(overlayCtx, titleText) + gap
155
-
156
- if (boll) {
157
- const upperText = `上轨:${boll.upper.toFixed(2)}`
158
- overlayCtx.fillStyle = colors.BOLL.UPPER
159
- overlayCtx.fillText(upperText, x, y)
160
- x += measureTextWidth(overlayCtx, upperText) + gap
161
-
162
- const middleText = `中轨:${boll.middle.toFixed(2)}`
163
- overlayCtx.fillStyle = colors.BOLL.MIDDLE
164
- overlayCtx.fillText(middleText, x, y)
165
- x += measureTextWidth(overlayCtx, middleText) + gap
166
-
167
- const lowerText = `下轨:${boll.lower.toFixed(2)}`
168
- overlayCtx.fillStyle = colors.BOLL.LOWER
169
- overlayCtx.fillText(lowerText, x, y)
170
- }
171
- }
172
- })
173
- }
174
-
175
- const expmaIndicator = config.indicators.EXPMA
176
- if (expmaIndicator?.enabled) {
177
- rows.push({
178
- draw: (rowIndex: number) => {
179
- const expmaState = pluginHost?.getSharedState<EXPMARenderState>(EXPMA_STATE_KEY)
180
- const expma = expmaState?.series[targetIndex]
181
- const fastPeriod = expmaState?.params.fastPeriod ?? 12
182
- const slowPeriod = expmaState?.params.slowPeriod ?? 50
183
-
184
- let x = legendX
185
- const y = config.yPaddingPx / 2 + fontSize + rowIndex * lineHeight
186
- const titleText = `EXPMA(${fastPeriod},${slowPeriod})`
187
-
188
- overlayCtx.fillStyle = colors.PRICE.NEUTRAL
189
- overlayCtx.fillText(titleText, x, y)
190
- x += measureTextWidth(overlayCtx, titleText) + gap
191
-
192
- if (expma) {
193
- const fastText = `快:${expma.fast.toFixed(2)}`
194
- overlayCtx.fillStyle = colors.EXPMA.FAST
195
- overlayCtx.fillText(fastText, x, y)
196
- x += measureTextWidth(overlayCtx, fastText) + gap
197
-
198
- const slowText = `慢:${expma.slow.toFixed(2)}`
199
- overlayCtx.fillStyle = colors.EXPMA.SLOW
200
- overlayCtx.fillText(slowText, x, y)
201
- }
202
- }
203
- })
204
- }
205
-
206
- const eneIndicator = config.indicators.ENE
207
- if (eneIndicator?.enabled) {
208
- rows.push({
209
- draw: (rowIndex: number) => {
210
- const eneState = pluginHost?.getSharedState<ENERenderState>(ENE_STATE_KEY)
211
- const ene = eneState?.series[targetIndex]
212
- const period = eneState?.params.period ?? 10
213
- const deviation = eneState?.params.deviation ?? 11
214
-
215
- let x = legendX
216
- const y = config.yPaddingPx / 2 + fontSize + rowIndex * lineHeight
217
- const titleText = `ENE(${period},${deviation})`
218
-
219
- overlayCtx.fillStyle = colors.PRICE.NEUTRAL
220
- overlayCtx.fillText(titleText, x, y)
221
- x += measureTextWidth(overlayCtx, titleText) + gap
222
-
223
- if (ene) {
224
- const upperText = `上轨:${ene.upper.toFixed(2)}`
225
- overlayCtx.fillStyle = colors.ENE.UPPER
226
- overlayCtx.fillText(upperText, x, y)
227
- x += measureTextWidth(overlayCtx, upperText) + gap
228
-
229
- const middleText = `中轨:${ene.middle.toFixed(2)}`
230
- overlayCtx.fillStyle = colors.ENE.MIDDLE
231
- overlayCtx.fillText(middleText, x, y)
232
- x += measureTextWidth(overlayCtx, middleText) + gap
233
-
234
- const lowerText = `下轨:${ene.lower.toFixed(2)}`
235
- overlayCtx.fillStyle = colors.ENE.LOWER
236
- overlayCtx.fillText(lowerText, x, y)
237
- }
238
- }
239
- })
240
- }
241
-
242
- rows.forEach((row, index) => row.draw(index))
243
- overlayCtx.restore()
244
- },
245
-
246
- getConfig() {
247
- return {
248
- yPaddingPx: config.yPaddingPx,
249
- indicators: { ...config.indicators },
250
- }
251
- },
252
-
253
- setConfig(newConfig: Record<string, unknown>) {
254
- if (typeof newConfig.yPaddingPx === 'number') {
255
- config.yPaddingPx = newConfig.yPaddingPx
256
- }
257
- if (newConfig.indicators && typeof newConfig.indicators === 'object') {
258
- for (const [id, row] of Object.entries(newConfig.indicators) as [string, IndicatorRow][]) {
259
- if (!config.indicators[id]) {
260
- config.indicators[id] = { enabled: false, params: {} }
261
- }
262
- if (row.enabled !== undefined) {
263
- config.indicators[id].enabled = row.enabled
264
- }
265
- if (row.params) {
266
- config.indicators[id].params = row.params
267
- }
268
- }
269
- }
270
- },
271
- }
272
- }
1
+ import type { RendererPluginWithHost, PluginHost, RenderContext } from '../../../plugin'
2
+ import { RENDERER_PRIORITY } from '../../../plugin'
3
+ import type { KLineData } from '../../../types/price'
4
+ import { MA_STATE_KEY, type MARenderState } from '../../indicators/maState'
5
+ import { BOLL_STATE_KEY, type BOLLRenderState } from '../../indicators/bollState'
6
+ import { EXPMA_STATE_KEY, type EXPMARenderState } from '../../indicators/expmaState'
7
+ import { ENE_STATE_KEY, type ENERenderState } from '../../indicators/eneState'
8
+ import { getColors } from '../../theme/colors'
9
+ import { getFont, setCanvasFont } from '../../theme/fonts'
10
+
11
+ const textWidthCache = new Map<string, number>()
12
+ const TEXT_WIDTH_CACHE_LIMIT = 512
13
+
14
+ function measureTextWidth(ctx: CanvasRenderingContext2D, text: string): number {
15
+ const key = `${ctx.font}\n${text}`
16
+ const cached = textWidthCache.get(key)
17
+ if (cached !== undefined) {
18
+ return cached
19
+ }
20
+
21
+ const width = ctx.measureText(text).width
22
+ if (textWidthCache.size >= TEXT_WIDTH_CACHE_LIMIT) {
23
+ textWidthCache.clear()
24
+ }
25
+ textWidthCache.set(key, width)
26
+ return width
27
+ }
28
+
29
+ /** 指标行数据 */
30
+ interface IndicatorRow {
31
+ enabled: boolean
32
+ params: Record<string, unknown>
33
+ }
34
+
35
+ /** 渲染器配置 */
36
+ interface MainIndicatorLegendConfig {
37
+ yPaddingPx: number
38
+ indicators: Record<string, IndicatorRow>
39
+ }
40
+
41
+ /**
42
+ * 创建主图指标图例渲染器插件
43
+ *
44
+ * 统一管理 MA、BOLL 等主图指标的图例显示,支持多行排列
45
+ * MA 数据从 StateStore 读取(与 MA 线渲染器共享同一数据源)
46
+ */
47
+ export function createMainIndicatorLegendRendererPlugin(options: {
48
+ yPaddingPx: number
49
+ }): RendererPluginWithHost {
50
+ const config: MainIndicatorLegendConfig = {
51
+ yPaddingPx: options.yPaddingPx,
52
+ indicators: {
53
+ MA: { enabled: true, params: {} },
54
+ BOLL: { enabled: false, params: { period: 20, multiplier: 2 } },
55
+ EXPMA: { enabled: false, params: { fastPeriod: 12, slowPeriod: 50 } },
56
+ ENE: { enabled: false, params: { period: 10, deviation: 11 } },
57
+ },
58
+ }
59
+
60
+ let pluginHost: PluginHost | null = null
61
+
62
+ return {
63
+ name: 'mainIndicatorLegend',
64
+ version: '2.1.0',
65
+ description: '主图指标图例渲染器(MA 数据来自 StateStore)',
66
+ debugName: '主图指标图例',
67
+ paneId: 'main',
68
+ priority: RENDERER_PRIORITY.FOREGROUND,
69
+ layer: 'overlay',
70
+ enabled: true,
71
+
72
+ onInstall(host: PluginHost): void {
73
+ pluginHost = host
74
+ },
75
+
76
+ getDeclaredNamespaces(): string[] {
77
+ return [MA_STATE_KEY, BOLL_STATE_KEY, EXPMA_STATE_KEY, ENE_STATE_KEY]
78
+ },
79
+
80
+ draw(context: RenderContext) {
81
+ const { overlayCtx, data, range, crosshairIndex } = context
82
+ const klineData = data as KLineData[]
83
+ const colors = getColors(context.theme)
84
+ if (!klineData.length || !overlayCtx) return
85
+
86
+ const fontSize = 12
87
+ const lineHeight = fontSize + 6
88
+ const legendX = 12
89
+ const gap = 10
90
+
91
+ overlayCtx.save()
92
+ setCanvasFont(overlayCtx, getFont(fontSize))
93
+ overlayCtx.textAlign = 'left'
94
+
95
+ const targetIndex = crosshairIndex ?? Math.min(range.end - 1, klineData.length - 1)
96
+ const rows: Array<{ draw: (rowIndex: number) => void }> = []
97
+
98
+ const maIndicator = config.indicators.MA
99
+ if (maIndicator?.enabled) {
100
+ rows.push({
101
+ draw: (rowIndex: number) => {
102
+ const items: Array<{ label: string; color: string; value?: number }> = []
103
+ const state = pluginHost?.getSharedState<MARenderState>(MA_STATE_KEY)
104
+
105
+ if (state && state.visibleMin <= state.visibleMax) {
106
+ for (const period of state.enabledPeriods) {
107
+ const colorKey = `MA${period}` as keyof typeof colors.MA
108
+ const series = state.series[period]
109
+ const value = series?.[targetIndex]
110
+
111
+ items.push({
112
+ label: `MA${period}`,
113
+ color: colors.MA[colorKey] || colors.MA.MA5,
114
+ value: value,
115
+ })
116
+ }
117
+ }
118
+
119
+ if (items.length > 0) {
120
+ let x = legendX
121
+ const y = config.yPaddingPx / 2 + fontSize + rowIndex * lineHeight
122
+
123
+ overlayCtx.fillStyle = colors.PRICE.NEUTRAL
124
+ overlayCtx.fillText('MA', x, y)
125
+ x += measureTextWidth(overlayCtx, 'MA') + gap
126
+
127
+ for (const it of items) {
128
+ const valText = typeof it.value === 'number' ? ` ${it.value.toFixed(2)}` : ''
129
+ const text = `${it.label}${valText}`
130
+ overlayCtx.fillStyle = it.color
131
+ overlayCtx.fillText(text, x, y)
132
+ x += measureTextWidth(overlayCtx, text) + gap
133
+ }
134
+ }
135
+ }
136
+ })
137
+ }
138
+
139
+ const bollIndicator = config.indicators.BOLL
140
+ if (bollIndicator?.enabled) {
141
+ rows.push({
142
+ draw: (rowIndex: number) => {
143
+ const bollState = pluginHost?.getSharedState<BOLLRenderState>(BOLL_STATE_KEY)
144
+ const boll = bollState?.series[targetIndex]
145
+ const period = bollState?.params.period ?? 20
146
+ const multiplier = bollState?.params.multiplier ?? 2
147
+
148
+ let x = legendX
149
+ const y = config.yPaddingPx / 2 + fontSize + rowIndex * lineHeight
150
+ const titleText = `BOLL(${period},${multiplier})`
151
+
152
+ overlayCtx.fillStyle = colors.PRICE.NEUTRAL
153
+ overlayCtx.fillText(titleText, x, y)
154
+ x += measureTextWidth(overlayCtx, titleText) + gap
155
+
156
+ if (boll) {
157
+ const upperText = `上轨:${boll.upper.toFixed(2)}`
158
+ overlayCtx.fillStyle = colors.BOLL.UPPER
159
+ overlayCtx.fillText(upperText, x, y)
160
+ x += measureTextWidth(overlayCtx, upperText) + gap
161
+
162
+ const middleText = `中轨:${boll.middle.toFixed(2)}`
163
+ overlayCtx.fillStyle = colors.BOLL.MIDDLE
164
+ overlayCtx.fillText(middleText, x, y)
165
+ x += measureTextWidth(overlayCtx, middleText) + gap
166
+
167
+ const lowerText = `下轨:${boll.lower.toFixed(2)}`
168
+ overlayCtx.fillStyle = colors.BOLL.LOWER
169
+ overlayCtx.fillText(lowerText, x, y)
170
+ }
171
+ }
172
+ })
173
+ }
174
+
175
+ const expmaIndicator = config.indicators.EXPMA
176
+ if (expmaIndicator?.enabled) {
177
+ rows.push({
178
+ draw: (rowIndex: number) => {
179
+ const expmaState = pluginHost?.getSharedState<EXPMARenderState>(EXPMA_STATE_KEY)
180
+ const expma = expmaState?.series[targetIndex]
181
+ const fastPeriod = expmaState?.params.fastPeriod ?? 12
182
+ const slowPeriod = expmaState?.params.slowPeriod ?? 50
183
+
184
+ let x = legendX
185
+ const y = config.yPaddingPx / 2 + fontSize + rowIndex * lineHeight
186
+ const titleText = `EXPMA(${fastPeriod},${slowPeriod})`
187
+
188
+ overlayCtx.fillStyle = colors.PRICE.NEUTRAL
189
+ overlayCtx.fillText(titleText, x, y)
190
+ x += measureTextWidth(overlayCtx, titleText) + gap
191
+
192
+ if (expma) {
193
+ const fastText = `快:${expma.fast.toFixed(2)}`
194
+ overlayCtx.fillStyle = colors.EXPMA.FAST
195
+ overlayCtx.fillText(fastText, x, y)
196
+ x += measureTextWidth(overlayCtx, fastText) + gap
197
+
198
+ const slowText = `慢:${expma.slow.toFixed(2)}`
199
+ overlayCtx.fillStyle = colors.EXPMA.SLOW
200
+ overlayCtx.fillText(slowText, x, y)
201
+ }
202
+ }
203
+ })
204
+ }
205
+
206
+ const eneIndicator = config.indicators.ENE
207
+ if (eneIndicator?.enabled) {
208
+ rows.push({
209
+ draw: (rowIndex: number) => {
210
+ const eneState = pluginHost?.getSharedState<ENERenderState>(ENE_STATE_KEY)
211
+ const ene = eneState?.series[targetIndex]
212
+ const period = eneState?.params.period ?? 10
213
+ const deviation = eneState?.params.deviation ?? 11
214
+
215
+ let x = legendX
216
+ const y = config.yPaddingPx / 2 + fontSize + rowIndex * lineHeight
217
+ const titleText = `ENE(${period},${deviation})`
218
+
219
+ overlayCtx.fillStyle = colors.PRICE.NEUTRAL
220
+ overlayCtx.fillText(titleText, x, y)
221
+ x += measureTextWidth(overlayCtx, titleText) + gap
222
+
223
+ if (ene) {
224
+ const upperText = `上轨:${ene.upper.toFixed(2)}`
225
+ overlayCtx.fillStyle = colors.ENE.UPPER
226
+ overlayCtx.fillText(upperText, x, y)
227
+ x += measureTextWidth(overlayCtx, upperText) + gap
228
+
229
+ const middleText = `中轨:${ene.middle.toFixed(2)}`
230
+ overlayCtx.fillStyle = colors.ENE.MIDDLE
231
+ overlayCtx.fillText(middleText, x, y)
232
+ x += measureTextWidth(overlayCtx, middleText) + gap
233
+
234
+ const lowerText = `下轨:${ene.lower.toFixed(2)}`
235
+ overlayCtx.fillStyle = colors.ENE.LOWER
236
+ overlayCtx.fillText(lowerText, x, y)
237
+ }
238
+ }
239
+ })
240
+ }
241
+
242
+ rows.forEach((row, index) => row.draw(index))
243
+ overlayCtx.restore()
244
+ },
245
+
246
+ getConfig() {
247
+ return {
248
+ yPaddingPx: config.yPaddingPx,
249
+ indicators: { ...config.indicators },
250
+ }
251
+ },
252
+
253
+ setConfig(newConfig: Record<string, unknown>) {
254
+ if (typeof newConfig.yPaddingPx === 'number') {
255
+ config.yPaddingPx = newConfig.yPaddingPx
256
+ }
257
+ if (newConfig.indicators && typeof newConfig.indicators === 'object') {
258
+ for (const [id, row] of Object.entries(newConfig.indicators) as [string, IndicatorRow][]) {
259
+ if (!config.indicators[id]) {
260
+ config.indicators[id] = { enabled: false, params: {} }
261
+ }
262
+ if (row.enabled !== undefined) {
263
+ config.indicators[id].enabled = row.enabled
264
+ }
265
+ if (row.params) {
266
+ config.indicators[id].params = row.params
267
+ }
268
+ }
269
+ }
270
+ },
271
+ }
272
+ }