@363045841yyt/klinechart-core 0.7.3 → 0.7.5-alpha.2

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 (231) hide show
  1. package/README.md +201 -201
  2. package/README.zh-CN.md +201 -201
  3. package/dist/engine/renderers/webgl/candleSurface.js +47 -47
  4. package/dist/version.d.ts +1 -1
  5. package/dist/version.d.ts.map +1 -1
  6. package/dist/version.js +1 -2
  7. package/dist/version.js.map +1 -1
  8. package/package.json +129 -122
  9. package/src/__tests__/signal.test.ts +124 -124
  10. package/src/config/chartSettings.ts +66 -66
  11. package/src/controllers/__tests__/drawing.test.ts +214 -214
  12. package/src/controllers/__tests__/indicatorSelector.test.ts +481 -481
  13. package/src/controllers/__tests__/toolbar.test.ts +225 -225
  14. package/src/controllers/createChartController.ts +665 -665
  15. package/src/controllers/createDrawingController.ts +96 -96
  16. package/src/controllers/createIndicatorSelectorController.ts +307 -307
  17. package/src/controllers/createToolbarController.ts +146 -146
  18. package/src/controllers/index.ts +19 -19
  19. package/src/controllers/types.ts +284 -284
  20. package/src/engine/__tests__/chart.dpr.test.ts +401 -401
  21. package/src/engine/__tests__/paneRenderer.resize.test.ts +92 -92
  22. package/src/engine/chart-store.ts +121 -121
  23. package/src/engine/chart.d.ts +617 -617
  24. package/src/engine/chart.ts +2815 -2815
  25. package/src/engine/controller/__tests__/interaction.dpr.test.ts +259 -259
  26. package/src/engine/controller/interaction.ts +722 -722
  27. package/src/engine/controller/markerInteraction.ts +130 -130
  28. package/src/engine/controller/pinchTracker.ts +82 -82
  29. package/src/engine/controller/tooltipPosition.ts +48 -48
  30. package/src/engine/draw/__tests__/pixelAlign.spec.ts +176 -176
  31. package/src/engine/draw/pixelAlign.ts +259 -259
  32. package/src/engine/drawing/index.ts +655 -655
  33. package/src/engine/drawing/interaction.ts +842 -842
  34. package/src/engine/drawing/plugin.ts +343 -343
  35. package/src/engine/indicators/__tests__/__fixtures__/golden/atr.json +38 -38
  36. package/src/engine/indicators/__tests__/__fixtures__/golden/dema.json +14 -14
  37. package/src/engine/indicators/__tests__/__fixtures__/golden/hma.json +14 -14
  38. package/src/engine/indicators/__tests__/__fixtures__/golden/index.ts +55 -55
  39. package/src/engine/indicators/__tests__/__fixtures__/golden/kama.json +14 -14
  40. package/src/engine/indicators/__tests__/__fixtures__/golden/tema.json +14 -14
  41. package/src/engine/indicators/__tests__/__fixtures__/golden/wma.json +40 -40
  42. package/src/engine/indicators/__tests__/__fixtures__/synthetic.ts +65 -65
  43. package/src/engine/indicators/__tests__/_propertyAssertions.ts +76 -76
  44. package/src/engine/indicators/__tests__/atr.test.ts +153 -153
  45. package/src/engine/indicators/__tests__/calculators.test.ts +614 -614
  46. package/src/engine/indicators/__tests__/cmf-mfi.test.ts +100 -100
  47. package/src/engine/indicators/__tests__/dema.test.ts +73 -73
  48. package/src/engine/indicators/__tests__/donchian.test.ts +70 -70
  49. package/src/engine/indicators/__tests__/hma.test.ts +73 -73
  50. package/src/engine/indicators/__tests__/ichimoku.test.ts +105 -105
  51. package/src/engine/indicators/__tests__/kama.test.ts +80 -80
  52. package/src/engine/indicators/__tests__/keltner.test.ts +65 -65
  53. package/src/engine/indicators/__tests__/pivot-fib.test.ts +110 -110
  54. package/src/engine/indicators/__tests__/roc.test.ts +68 -68
  55. package/src/engine/indicators/__tests__/sar.test.ts +86 -86
  56. package/src/engine/indicators/__tests__/scheduler.test.ts +831 -831
  57. package/src/engine/indicators/__tests__/soa.test.ts +533 -533
  58. package/src/engine/indicators/__tests__/structure.test.ts +110 -110
  59. package/src/engine/indicators/__tests__/supertrend.test.ts +65 -65
  60. package/src/engine/indicators/__tests__/tema.test.ts +68 -68
  61. package/src/engine/indicators/__tests__/trix.test.ts +70 -70
  62. package/src/engine/indicators/__tests__/volatility.test.ts +117 -117
  63. package/src/engine/indicators/__tests__/volume.test.ts +115 -115
  64. package/src/engine/indicators/__tests__/volumeProfile.test.ts +74 -74
  65. package/src/engine/indicators/__tests__/vwap.test.ts +69 -69
  66. package/src/engine/indicators/__tests__/wma.test.ts +112 -112
  67. package/src/engine/indicators/__tests__/zones.test.ts +95 -95
  68. package/src/engine/indicators/atrState.ts +27 -27
  69. package/src/engine/indicators/bollState.ts +51 -51
  70. package/src/engine/indicators/calculators.ts +2593 -2593
  71. package/src/engine/indicators/cciState.ts +25 -25
  72. package/src/engine/indicators/chaikinVolState.ts +32 -32
  73. package/src/engine/indicators/cmfState.ts +27 -27
  74. package/src/engine/indicators/demaState.ts +27 -27
  75. package/src/engine/indicators/donchianState.ts +43 -43
  76. package/src/engine/indicators/eneState.ts +43 -43
  77. package/src/engine/indicators/expmaState.ts +43 -43
  78. package/src/engine/indicators/fastkState.ts +25 -25
  79. package/src/engine/indicators/fibState.ts +41 -41
  80. package/src/engine/indicators/hmaState.ts +27 -27
  81. package/src/engine/indicators/hvState.ts +28 -28
  82. package/src/engine/indicators/ichimokuState.ts +70 -70
  83. package/src/engine/indicators/indicator.worker.ts +169 -169
  84. package/src/engine/indicators/indicatorDefinitionRegistry.ts +62 -62
  85. package/src/engine/indicators/indicatorMetadata.ts +110 -110
  86. package/src/engine/indicators/indicatorRegistry.ts +106 -106
  87. package/src/engine/indicators/indicatorRuntime.ts +1548 -1548
  88. package/src/engine/indicators/kamaState.ts +34 -34
  89. package/src/engine/indicators/keltnerState.ts +49 -49
  90. package/src/engine/indicators/kstState.ts +42 -42
  91. package/src/engine/indicators/maState.ts +36 -36
  92. package/src/engine/indicators/macdState.ts +76 -76
  93. package/src/engine/indicators/mfiState.ts +27 -27
  94. package/src/engine/indicators/momState.ts +25 -25
  95. package/src/engine/indicators/obvState.ts +25 -25
  96. package/src/engine/indicators/parkinsonState.ts +28 -28
  97. package/src/engine/indicators/pivotState.ts +51 -51
  98. package/src/engine/indicators/pvtState.ts +25 -25
  99. package/src/engine/indicators/rocState.ts +27 -27
  100. package/src/engine/indicators/rsiState.ts +65 -65
  101. package/src/engine/indicators/sarState.ts +41 -41
  102. package/src/engine/indicators/scheduler.ts +1205 -1205
  103. package/src/engine/indicators/soa.ts +352 -352
  104. package/src/engine/indicators/stateComposer.ts +1262 -1262
  105. package/src/engine/indicators/stochState.ts +26 -26
  106. package/src/engine/indicators/structureState.ts +69 -69
  107. package/src/engine/indicators/supertrendState.ts +37 -37
  108. package/src/engine/indicators/temaState.ts +27 -27
  109. package/src/engine/indicators/trixState.ts +35 -35
  110. package/src/engine/indicators/vmaState.ts +27 -27
  111. package/src/engine/indicators/volumeProfileState.ts +63 -63
  112. package/src/engine/indicators/vwapState.ts +29 -29
  113. package/src/engine/indicators/wmaState.ts +27 -27
  114. package/src/engine/indicators/wmsrState.ts +25 -25
  115. package/src/engine/indicators/workerProtocol.ts +613 -613
  116. package/src/engine/indicators/zonesState.ts +47 -47
  117. package/src/engine/layout/pane.ts +161 -161
  118. package/src/engine/marker/registry.ts +265 -265
  119. package/src/engine/paneRenderer.ts +169 -169
  120. package/src/engine/renderers/Indicator/atr.ts +237 -237
  121. package/src/engine/renderers/Indicator/boll.ts +317 -317
  122. package/src/engine/renderers/Indicator/cci.ts +275 -275
  123. package/src/engine/renderers/Indicator/chaikinVol.ts +138 -138
  124. package/src/engine/renderers/Indicator/cmf.ts +137 -137
  125. package/src/engine/renderers/Indicator/dema.ts +136 -136
  126. package/src/engine/renderers/Indicator/donchian.ts +137 -137
  127. package/src/engine/renderers/Indicator/ene.ts +271 -271
  128. package/src/engine/renderers/Indicator/expma.ts +197 -197
  129. package/src/engine/renderers/Indicator/fastk.ts +316 -316
  130. package/src/engine/renderers/Indicator/fib.ts +141 -141
  131. package/src/engine/renderers/Indicator/hma.ts +136 -136
  132. package/src/engine/renderers/Indicator/hv.ts +124 -124
  133. package/src/engine/renderers/Indicator/ichimoku.ts +181 -181
  134. package/src/engine/renderers/Indicator/index.ts +241 -241
  135. package/src/engine/renderers/Indicator/indicatorData.ts +650 -650
  136. package/src/engine/renderers/Indicator/kama.ts +136 -136
  137. package/src/engine/renderers/Indicator/keltner.ts +137 -137
  138. package/src/engine/renderers/Indicator/kst.ts +302 -302
  139. package/src/engine/renderers/Indicator/ma.ts +200 -200
  140. package/src/engine/renderers/Indicator/macd.ts +477 -477
  141. package/src/engine/renderers/Indicator/macdLegend.ts +141 -141
  142. package/src/engine/renderers/Indicator/mainIndicatorLegend.ts +272 -272
  143. package/src/engine/renderers/Indicator/mfi.ts +142 -142
  144. package/src/engine/renderers/Indicator/mom.ts +311 -311
  145. package/src/engine/renderers/Indicator/obv.ts +123 -123
  146. package/src/engine/renderers/Indicator/parkinson.ts +124 -124
  147. package/src/engine/renderers/Indicator/pivot.ts +131 -131
  148. package/src/engine/renderers/Indicator/pvt.ts +123 -123
  149. package/src/engine/renderers/Indicator/roc.ts +143 -143
  150. package/src/engine/renderers/Indicator/rsi.ts +390 -390
  151. package/src/engine/renderers/Indicator/sar.ts +113 -113
  152. package/src/engine/renderers/Indicator/scale/atr_scale.ts +19 -19
  153. package/src/engine/renderers/Indicator/scale/cci_scale.ts +19 -19
  154. package/src/engine/renderers/Indicator/scale/fastk_scale.ts +19 -19
  155. package/src/engine/renderers/Indicator/scale/indicator_scale.ts +204 -204
  156. package/src/engine/renderers/Indicator/scale/kst_scale.ts +19 -19
  157. package/src/engine/renderers/Indicator/scale/macd_scale.ts +22 -22
  158. package/src/engine/renderers/Indicator/scale/mom_scale.ts +19 -19
  159. package/src/engine/renderers/Indicator/scale/rsi_scale.ts +19 -19
  160. package/src/engine/renderers/Indicator/scale/stoch_scale.ts +19 -19
  161. package/src/engine/renderers/Indicator/scale/volume_scale.ts +26 -26
  162. package/src/engine/renderers/Indicator/scale/wmsr_scale.ts +19 -19
  163. package/src/engine/renderers/Indicator/stoch.ts +359 -359
  164. package/src/engine/renderers/Indicator/structure.ts +126 -126
  165. package/src/engine/renderers/Indicator/subPaneConfig.ts +265 -265
  166. package/src/engine/renderers/Indicator/supertrend.ts +115 -115
  167. package/src/engine/renderers/Indicator/tema.ts +136 -136
  168. package/src/engine/renderers/Indicator/trix.ts +158 -158
  169. package/src/engine/renderers/Indicator/vma.ts +124 -124
  170. package/src/engine/renderers/Indicator/volumeProfile.ts +125 -125
  171. package/src/engine/renderers/Indicator/vwap.ts +123 -123
  172. package/src/engine/renderers/Indicator/wma.ts +136 -136
  173. package/src/engine/renderers/Indicator/wmsr.ts +328 -328
  174. package/src/engine/renderers/Indicator/zones.ts +104 -104
  175. package/src/engine/renderers/__tests__/boll.renderer.test.ts +314 -314
  176. package/src/engine/renderers/__tests__/ene.renderer.test.ts +305 -305
  177. package/src/engine/renderers/__tests__/expma.renderer.test.ts +279 -279
  178. package/src/engine/renderers/__tests__/ma.renderer.test.ts +426 -426
  179. package/src/engine/renderers/__tests__/mainIndicatorLegend.renderer.test.ts +502 -502
  180. package/src/engine/renderers/__tests__/yAxis.renderer.test.ts +173 -173
  181. package/src/engine/renderers/candle.ts +459 -459
  182. package/src/engine/renderers/crosshair.ts +69 -69
  183. package/src/engine/renderers/customMarkers.ts +162 -162
  184. package/src/engine/renderers/extremaMarkers.ts +246 -246
  185. package/src/engine/renderers/gridLines.ts +90 -90
  186. package/src/engine/renderers/lastPrice.ts +97 -97
  187. package/src/engine/renderers/paneTitle.ts +136 -136
  188. package/src/engine/renderers/subVolume.ts +236 -236
  189. package/src/engine/renderers/timeAxis.ts +121 -121
  190. package/src/engine/renderers/webgl/candleSurface.ts +955 -955
  191. package/src/engine/renderers/webgl/sharedWebGLSurface.ts +146 -146
  192. package/src/engine/renderers/yAxis.ts +105 -105
  193. package/src/engine/scale/__tests__/logFormula.spec.ts +148 -148
  194. package/src/engine/scale/logFormula.ts +130 -130
  195. package/src/engine/scale/price.ts +39 -39
  196. package/src/engine/scale/priceScale.ts +264 -264
  197. package/src/engine/subPaneManager.ts +427 -427
  198. package/src/engine/theme/colors.ts +642 -642
  199. package/src/engine/theme/fonts.ts +20 -20
  200. package/src/engine/utils/klineConfig.ts +49 -49
  201. package/src/engine/utils/tickCount.ts +11 -11
  202. package/src/engine/utils/tickPosition.ts +214 -214
  203. package/src/engine/utils/zoom.ts +83 -83
  204. package/src/engine/viewport/viewport.ts +67 -67
  205. package/src/index.ts +3 -3
  206. package/src/plugin/ConfigManager.ts +93 -93
  207. package/src/plugin/EventBus.ts +77 -77
  208. package/src/plugin/HookSystem.ts +106 -106
  209. package/src/plugin/PluginHost.ts +243 -243
  210. package/src/plugin/PluginRegistry.ts +92 -92
  211. package/src/plugin/StateStore.ts +73 -73
  212. package/src/plugin/index.ts +19 -19
  213. package/src/plugin/rendererPluginManager.ts +368 -368
  214. package/src/plugin/stateKeys.ts +8 -8
  215. package/src/plugin/types.ts +526 -526
  216. package/src/reactivity/index.ts +2 -2
  217. package/src/reactivity/signal.ts +119 -119
  218. package/src/semantic/controller.ts +251 -251
  219. package/src/semantic/drawShape.ts +260 -260
  220. package/src/semantic/index.ts +28 -28
  221. package/src/semantic/schema.json +256 -256
  222. package/src/semantic/types.ts +251 -251
  223. package/src/semantic/validator.ts +349 -349
  224. package/src/types/kLine.ts +13 -13
  225. package/src/types/price.ts +56 -56
  226. package/src/types/volumePrice.ts +33 -33
  227. package/src/utils/dateFormat.ts +208 -208
  228. package/src/utils/kLineDraw/axis.ts +562 -562
  229. package/src/utils/priceToY.ts +34 -34
  230. package/src/utils/volumePrice.ts +202 -202
  231. 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
+ }