@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,259 +1,259 @@
1
- import { describe, expect, it, vi } from 'vitest'
2
- import { InteractionController } from '@/core/controller/interaction'
3
- import type { KLineData } from '@/types/price'
4
-
5
- function createChartStub(args: {
6
- dpr: number
7
- plotWidth: number
8
- plotHeight: number
9
- paneByY?: Array<{
10
- id: string
11
- top: number
12
- height: number
13
- candleHitTest: boolean
14
- }>
15
- markerManager?: {
16
- hitTest: (worldX: number, y: number, radius: number) => any
17
- setHover: (id: string | null) => void
18
- hitTestCustomMarker: (x: number, y: number) => any
19
- }
20
- }) {
21
- const container = document.createElement('div') as HTMLDivElement
22
- Object.defineProperty(container, 'scrollLeft', { configurable: true, writable: true, value: 0 })
23
- Object.defineProperty(container, 'clientWidth', { configurable: true, value: 320 })
24
- Object.defineProperty(container, 'clientHeight', { configurable: true, value: 200 })
25
- Object.defineProperty(container, 'getBoundingClientRect', {
26
- configurable: true,
27
- value: () => ({ left: 0, top: 0, width: 320, height: 200 }),
28
- })
29
-
30
- const data: KLineData[] = [
31
- {
32
- timestamp: 20260101,
33
- open: 10,
34
- high: 12,
35
- low: 8,
36
- close: 11,
37
- volume: 1000,
38
- },
39
- {
40
- timestamp: 20260102,
41
- open: 11,
42
- high: 13,
43
- low: 9,
44
- close: 12,
45
- volume: 1200,
46
- },
47
- ]
48
-
49
- const paneDefs = args.paneByY ?? [{ id: 'main', top: 0, height: 160, candleHitTest: true }]
50
- const paneRenderers = paneDefs.map((paneDef) => ({
51
- getPane: () => ({
52
- id: paneDef.id,
53
- top: paneDef.top,
54
- height: paneDef.height,
55
- capabilities: {
56
- showPriceAxisTicks: true,
57
- showCrosshairPriceLabel: true,
58
- candleHitTest: paneDef.candleHitTest,
59
- supportsPriceTranslate: true,
60
- },
61
- yAxis: {
62
- yToPrice: (y: number) => y,
63
- priceToY: (p: number) => p,
64
- getPaddingTop: () => 0,
65
- getPaddingBottom: () => 0,
66
- getPriceOffset: () => 0,
67
- },
68
- }),
69
- }))
70
-
71
- const markerManager =
72
- args.markerManager ??
73
- ({
74
- hitTest: () => null,
75
- setHover: () => undefined,
76
- hitTestCustomMarker: () => null,
77
- } as const)
78
-
79
- const rightAxisLayer = document.createElement('div') as HTMLDivElement
80
-
81
- const chart = {
82
- getDom: () => ({ container, rightAxisLayer }),
83
- getViewport: () => ({
84
- viewWidth: 320,
85
- viewHeight: 200,
86
- plotWidth: args.plotWidth,
87
- plotHeight: args.plotHeight,
88
- scrollLeft: 0,
89
- dpr: args.dpr,
90
- }),
91
- getCurrentDpr: () => args.dpr,
92
- getCachedScrollLeft: () => 0,
93
- getMarkerManager: () => markerManager,
94
- getPaneRenderers: () => paneRenderers,
95
- getData: () => data,
96
- translatePrice: () => undefined,
97
- scheduleDraw: () => undefined,
98
- zoomAt: () => undefined,
99
- resetPriceOffset: () => undefined,
100
- resizePaneBoundary: () => false,
101
- scalePrice: () => undefined,
102
- }
103
-
104
- return chart
105
- }
106
-
107
- describe('InteractionController DPR consumption', () => {
108
- it('uses viewport plot bounds for hit boundary checks', () => {
109
- const chart = createChartStub({ dpr: 2, plotWidth: 100, plotHeight: 80 })
110
- const interaction = new InteractionController(chart as never)
111
-
112
- interaction.setKLinePositions([0, 10], { start: 0, end: 2 }, 10)
113
-
114
- interaction.onPointerMove({ clientX: 50, clientY: 40, isPrimary: true } as PointerEvent)
115
- expect(interaction.crosshairPos).not.toBeNull()
116
-
117
- interaction.onPointerMove({ clientX: 120, clientY: 40, isPrimary: true } as PointerEvent)
118
- expect(interaction.crosshairPos).toBeNull()
119
- expect(interaction.crosshairIndex).toBeNull()
120
- })
121
-
122
- it('uses current DPR in kWidthLogical = kWidthPx / dpr path', () => {
123
- const chartDpr1 = createChartStub({ dpr: 1, plotWidth: 300, plotHeight: 160 })
124
- const interactionDpr1 = new InteractionController(chartDpr1 as never)
125
- interactionDpr1.setKLinePositions([0, 10], { start: 0, end: 2 }, 10)
126
-
127
- interactionDpr1.onPointerMove({ clientX: 8, clientY: 40, isPrimary: true } as PointerEvent)
128
- expect(interactionDpr1.crosshairIndex).toBe(0)
129
-
130
- const chartDpr2 = createChartStub({ dpr: 2, plotWidth: 300, plotHeight: 160 })
131
- const interactionDpr2 = new InteractionController(chartDpr2 as never)
132
- interactionDpr2.setKLinePositions([0, 10], { start: 0, end: 2 }, 10)
133
-
134
- interactionDpr2.onPointerMove({ clientX: 8, clientY: 40, isPrimary: true } as PointerEvent)
135
- expect(interactionDpr2.crosshairIndex).toBe(1)
136
- })
137
- })
138
-
139
- describe('InteractionController pane capability gating', () => {
140
- it('does not set hoveredIndex when pointer is in indicator pane', () => {
141
- const chart = createChartStub({
142
- dpr: 1,
143
- plotWidth: 300,
144
- plotHeight: 200,
145
- paneByY: [
146
- { id: 'main', top: 0, height: 100, candleHitTest: true },
147
- { id: 'sub_MACD', top: 100, height: 100, candleHitTest: false },
148
- ],
149
- })
150
- const interaction = new InteractionController(chart as never)
151
-
152
- interaction.setKLinePositions([0, 10], { start: 0, end: 2 }, 10)
153
- interaction.onPointerMove({ clientX: 5, clientY: 140, isPrimary: true } as PointerEvent)
154
-
155
- expect(interaction.activePaneId).toBe('sub_MACD')
156
- expect(interaction.hoveredIndex).toBeNull()
157
- })
158
-
159
- it('sets hoveredIndex when candle is hit in price pane', () => {
160
- const chart = createChartStub({
161
- dpr: 1,
162
- plotWidth: 300,
163
- plotHeight: 200,
164
- paneByY: [
165
- { id: 'main', top: 0, height: 100, candleHitTest: true },
166
- { id: 'sub_MACD', top: 100, height: 100, candleHitTest: false },
167
- ],
168
- })
169
- const interaction = new InteractionController(chart as never)
170
-
171
- interaction.setKLinePositions([0, 10], { start: 0, end: 2 }, 10)
172
- interaction.onPointerMove({ clientX: 5, clientY: 10, isPrimary: true } as PointerEvent)
173
-
174
- expect(interaction.activePaneId).toBe('main')
175
- expect(interaction.crosshairIndex).not.toBeNull()
176
- expect(interaction.hoveredIndex).toBe(interaction.crosshairIndex)
177
- })
178
-
179
- it('clears hoveredIndex when moving from price pane to indicator pane', () => {
180
- const chart = createChartStub({
181
- dpr: 1,
182
- plotWidth: 300,
183
- plotHeight: 200,
184
- paneByY: [
185
- { id: 'main', top: 0, height: 100, candleHitTest: true },
186
- { id: 'sub_MACD', top: 100, height: 100, candleHitTest: false },
187
- ],
188
- })
189
- const interaction = new InteractionController(chart as never)
190
-
191
- interaction.setKLinePositions([0, 10], { start: 0, end: 2 }, 10)
192
- interaction.onPointerMove({ clientX: 5, clientY: 10, isPrimary: true } as PointerEvent)
193
- expect(interaction.hoveredIndex).toBe(interaction.crosshairIndex)
194
-
195
- interaction.onPointerMove({ clientX: 5, clientY: 140, isPrimary: true } as PointerEvent)
196
- expect(interaction.activePaneId).toBe('sub_MACD')
197
- expect(interaction.hoveredIndex).toBeNull()
198
- })
199
- })
200
-
201
- describe('InteractionController hover snapshot', () => {
202
- it('clears marker hover payloads on scroll', () => {
203
- const setHover = vi.fn()
204
- const marker = { id: 'm1' }
205
- const chart = createChartStub({
206
- dpr: 1,
207
- plotWidth: 300,
208
- plotHeight: 200,
209
- markerManager: {
210
- hitTest: () => marker,
211
- setHover,
212
- hitTestCustomMarker: () => null,
213
- },
214
- })
215
- const interaction = new InteractionController(chart as never)
216
-
217
- interaction.onPointerMove({ clientX: 20, clientY: 20, isPrimary: true } as PointerEvent)
218
- expect(interaction.getInteractionSnapshot().hoveredMarkerData).toBe(marker)
219
-
220
- interaction.onScroll()
221
-
222
- const snapshot = interaction.getInteractionSnapshot()
223
- expect(snapshot.hoveredMarkerData).toBeNull()
224
- expect(snapshot.hoveredCustomMarker).toBeNull()
225
- expect(snapshot.crosshairPos).toBeNull()
226
- expect(snapshot.hoveredIndex).toBeNull()
227
- expect(setHover).toHaveBeenCalledWith(null)
228
- })
229
-
230
- it('emits cleared snapshot when moving away from custom marker', () => {
231
- const customMarker = { id: 'c1' }
232
- let hoveringCustom = true
233
- const chart = createChartStub({
234
- dpr: 1,
235
- plotWidth: 300,
236
- plotHeight: 200,
237
- markerManager: {
238
- hitTest: () => null,
239
- setHover: () => undefined,
240
- hitTestCustomMarker: () => (hoveringCustom ? customMarker : null),
241
- },
242
- })
243
- const interaction = new InteractionController(chart as never)
244
- const changes: ReturnType<typeof interaction.getInteractionSnapshot>[] = []
245
- interaction.setOnInteractionChange((snapshot) => {
246
- changes.push(snapshot)
247
- })
248
-
249
- interaction.onPointerMove({ clientX: 20, clientY: 20, isPrimary: true } as PointerEvent)
250
- expect(interaction.getInteractionSnapshot().hoveredCustomMarker).toBe(customMarker)
251
-
252
- hoveringCustom = false
253
- interaction.setKLinePositions([0, 10], { start: 0, end: 2 }, 10)
254
- interaction.onPointerMove({ clientX: 20, clientY: 20, isPrimary: true } as PointerEvent)
255
-
256
- expect(interaction.getInteractionSnapshot().hoveredCustomMarker).toBeNull()
257
- expect(changes[changes.length - 1]?.hoveredCustomMarker).toBeNull()
258
- })
259
- })
1
+ import { describe, expect, it, vi } from 'vitest'
2
+ import { InteractionController } from '@/core/controller/interaction'
3
+ import type { KLineData } from '@/types/price'
4
+
5
+ function createChartStub(args: {
6
+ dpr: number
7
+ plotWidth: number
8
+ plotHeight: number
9
+ paneByY?: Array<{
10
+ id: string
11
+ top: number
12
+ height: number
13
+ candleHitTest: boolean
14
+ }>
15
+ markerManager?: {
16
+ hitTest: (worldX: number, y: number, radius: number) => any
17
+ setHover: (id: string | null) => void
18
+ hitTestCustomMarker: (x: number, y: number) => any
19
+ }
20
+ }) {
21
+ const container = document.createElement('div') as HTMLDivElement
22
+ Object.defineProperty(container, 'scrollLeft', { configurable: true, writable: true, value: 0 })
23
+ Object.defineProperty(container, 'clientWidth', { configurable: true, value: 320 })
24
+ Object.defineProperty(container, 'clientHeight', { configurable: true, value: 200 })
25
+ Object.defineProperty(container, 'getBoundingClientRect', {
26
+ configurable: true,
27
+ value: () => ({ left: 0, top: 0, width: 320, height: 200 }),
28
+ })
29
+
30
+ const data: KLineData[] = [
31
+ {
32
+ timestamp: 20260101,
33
+ open: 10,
34
+ high: 12,
35
+ low: 8,
36
+ close: 11,
37
+ volume: 1000,
38
+ },
39
+ {
40
+ timestamp: 20260102,
41
+ open: 11,
42
+ high: 13,
43
+ low: 9,
44
+ close: 12,
45
+ volume: 1200,
46
+ },
47
+ ]
48
+
49
+ const paneDefs = args.paneByY ?? [{ id: 'main', top: 0, height: 160, candleHitTest: true }]
50
+ const paneRenderers = paneDefs.map((paneDef) => ({
51
+ getPane: () => ({
52
+ id: paneDef.id,
53
+ top: paneDef.top,
54
+ height: paneDef.height,
55
+ capabilities: {
56
+ showPriceAxisTicks: true,
57
+ showCrosshairPriceLabel: true,
58
+ candleHitTest: paneDef.candleHitTest,
59
+ supportsPriceTranslate: true,
60
+ },
61
+ yAxis: {
62
+ yToPrice: (y: number) => y,
63
+ priceToY: (p: number) => p,
64
+ getPaddingTop: () => 0,
65
+ getPaddingBottom: () => 0,
66
+ getPriceOffset: () => 0,
67
+ },
68
+ }),
69
+ }))
70
+
71
+ const markerManager =
72
+ args.markerManager ??
73
+ ({
74
+ hitTest: () => null,
75
+ setHover: () => undefined,
76
+ hitTestCustomMarker: () => null,
77
+ } as const)
78
+
79
+ const rightAxisLayer = document.createElement('div') as HTMLDivElement
80
+
81
+ const chart = {
82
+ getDom: () => ({ container, rightAxisLayer }),
83
+ getViewport: () => ({
84
+ viewWidth: 320,
85
+ viewHeight: 200,
86
+ plotWidth: args.plotWidth,
87
+ plotHeight: args.plotHeight,
88
+ scrollLeft: 0,
89
+ dpr: args.dpr,
90
+ }),
91
+ getCurrentDpr: () => args.dpr,
92
+ getCachedScrollLeft: () => 0,
93
+ getMarkerManager: () => markerManager,
94
+ getPaneRenderers: () => paneRenderers,
95
+ getData: () => data,
96
+ translatePrice: () => undefined,
97
+ scheduleDraw: () => undefined,
98
+ zoomAt: () => undefined,
99
+ resetPriceOffset: () => undefined,
100
+ resizePaneBoundary: () => false,
101
+ scalePrice: () => undefined,
102
+ }
103
+
104
+ return chart
105
+ }
106
+
107
+ describe('InteractionController DPR consumption', () => {
108
+ it('uses viewport plot bounds for hit boundary checks', () => {
109
+ const chart = createChartStub({ dpr: 2, plotWidth: 100, plotHeight: 80 })
110
+ const interaction = new InteractionController(chart as never)
111
+
112
+ interaction.setKLinePositions([0, 10], { start: 0, end: 2 }, 10)
113
+
114
+ interaction.onPointerMove({ clientX: 50, clientY: 40, isPrimary: true } as PointerEvent)
115
+ expect(interaction.crosshairPos).not.toBeNull()
116
+
117
+ interaction.onPointerMove({ clientX: 120, clientY: 40, isPrimary: true } as PointerEvent)
118
+ expect(interaction.crosshairPos).toBeNull()
119
+ expect(interaction.crosshairIndex).toBeNull()
120
+ })
121
+
122
+ it('uses current DPR in kWidthLogical = kWidthPx / dpr path', () => {
123
+ const chartDpr1 = createChartStub({ dpr: 1, plotWidth: 300, plotHeight: 160 })
124
+ const interactionDpr1 = new InteractionController(chartDpr1 as never)
125
+ interactionDpr1.setKLinePositions([0, 10], { start: 0, end: 2 }, 10)
126
+
127
+ interactionDpr1.onPointerMove({ clientX: 8, clientY: 40, isPrimary: true } as PointerEvent)
128
+ expect(interactionDpr1.crosshairIndex).toBe(0)
129
+
130
+ const chartDpr2 = createChartStub({ dpr: 2, plotWidth: 300, plotHeight: 160 })
131
+ const interactionDpr2 = new InteractionController(chartDpr2 as never)
132
+ interactionDpr2.setKLinePositions([0, 10], { start: 0, end: 2 }, 10)
133
+
134
+ interactionDpr2.onPointerMove({ clientX: 8, clientY: 40, isPrimary: true } as PointerEvent)
135
+ expect(interactionDpr2.crosshairIndex).toBe(1)
136
+ })
137
+ })
138
+
139
+ describe('InteractionController pane capability gating', () => {
140
+ it('does not set hoveredIndex when pointer is in indicator pane', () => {
141
+ const chart = createChartStub({
142
+ dpr: 1,
143
+ plotWidth: 300,
144
+ plotHeight: 200,
145
+ paneByY: [
146
+ { id: 'main', top: 0, height: 100, candleHitTest: true },
147
+ { id: 'sub_MACD', top: 100, height: 100, candleHitTest: false },
148
+ ],
149
+ })
150
+ const interaction = new InteractionController(chart as never)
151
+
152
+ interaction.setKLinePositions([0, 10], { start: 0, end: 2 }, 10)
153
+ interaction.onPointerMove({ clientX: 5, clientY: 140, isPrimary: true } as PointerEvent)
154
+
155
+ expect(interaction.activePaneId).toBe('sub_MACD')
156
+ expect(interaction.hoveredIndex).toBeNull()
157
+ })
158
+
159
+ it('sets hoveredIndex when candle is hit in price pane', () => {
160
+ const chart = createChartStub({
161
+ dpr: 1,
162
+ plotWidth: 300,
163
+ plotHeight: 200,
164
+ paneByY: [
165
+ { id: 'main', top: 0, height: 100, candleHitTest: true },
166
+ { id: 'sub_MACD', top: 100, height: 100, candleHitTest: false },
167
+ ],
168
+ })
169
+ const interaction = new InteractionController(chart as never)
170
+
171
+ interaction.setKLinePositions([0, 10], { start: 0, end: 2 }, 10)
172
+ interaction.onPointerMove({ clientX: 5, clientY: 10, isPrimary: true } as PointerEvent)
173
+
174
+ expect(interaction.activePaneId).toBe('main')
175
+ expect(interaction.crosshairIndex).not.toBeNull()
176
+ expect(interaction.hoveredIndex).toBe(interaction.crosshairIndex)
177
+ })
178
+
179
+ it('clears hoveredIndex when moving from price pane to indicator pane', () => {
180
+ const chart = createChartStub({
181
+ dpr: 1,
182
+ plotWidth: 300,
183
+ plotHeight: 200,
184
+ paneByY: [
185
+ { id: 'main', top: 0, height: 100, candleHitTest: true },
186
+ { id: 'sub_MACD', top: 100, height: 100, candleHitTest: false },
187
+ ],
188
+ })
189
+ const interaction = new InteractionController(chart as never)
190
+
191
+ interaction.setKLinePositions([0, 10], { start: 0, end: 2 }, 10)
192
+ interaction.onPointerMove({ clientX: 5, clientY: 10, isPrimary: true } as PointerEvent)
193
+ expect(interaction.hoveredIndex).toBe(interaction.crosshairIndex)
194
+
195
+ interaction.onPointerMove({ clientX: 5, clientY: 140, isPrimary: true } as PointerEvent)
196
+ expect(interaction.activePaneId).toBe('sub_MACD')
197
+ expect(interaction.hoveredIndex).toBeNull()
198
+ })
199
+ })
200
+
201
+ describe('InteractionController hover snapshot', () => {
202
+ it('clears marker hover payloads on scroll', () => {
203
+ const setHover = vi.fn()
204
+ const marker = { id: 'm1' }
205
+ const chart = createChartStub({
206
+ dpr: 1,
207
+ plotWidth: 300,
208
+ plotHeight: 200,
209
+ markerManager: {
210
+ hitTest: () => marker,
211
+ setHover,
212
+ hitTestCustomMarker: () => null,
213
+ },
214
+ })
215
+ const interaction = new InteractionController(chart as never)
216
+
217
+ interaction.onPointerMove({ clientX: 20, clientY: 20, isPrimary: true } as PointerEvent)
218
+ expect(interaction.getInteractionSnapshot().hoveredMarkerData).toBe(marker)
219
+
220
+ interaction.onScroll()
221
+
222
+ const snapshot = interaction.getInteractionSnapshot()
223
+ expect(snapshot.hoveredMarkerData).toBeNull()
224
+ expect(snapshot.hoveredCustomMarker).toBeNull()
225
+ expect(snapshot.crosshairPos).toBeNull()
226
+ expect(snapshot.hoveredIndex).toBeNull()
227
+ expect(setHover).toHaveBeenCalledWith(null)
228
+ })
229
+
230
+ it('emits cleared snapshot when moving away from custom marker', () => {
231
+ const customMarker = { id: 'c1' }
232
+ let hoveringCustom = true
233
+ const chart = createChartStub({
234
+ dpr: 1,
235
+ plotWidth: 300,
236
+ plotHeight: 200,
237
+ markerManager: {
238
+ hitTest: () => null,
239
+ setHover: () => undefined,
240
+ hitTestCustomMarker: () => (hoveringCustom ? customMarker : null),
241
+ },
242
+ })
243
+ const interaction = new InteractionController(chart as never)
244
+ const changes: ReturnType<typeof interaction.getInteractionSnapshot>[] = []
245
+ interaction.setOnInteractionChange((snapshot) => {
246
+ changes.push(snapshot)
247
+ })
248
+
249
+ interaction.onPointerMove({ clientX: 20, clientY: 20, isPrimary: true } as PointerEvent)
250
+ expect(interaction.getInteractionSnapshot().hoveredCustomMarker).toBe(customMarker)
251
+
252
+ hoveringCustom = false
253
+ interaction.setKLinePositions([0, 10], { start: 0, end: 2 }, 10)
254
+ interaction.onPointerMove({ clientX: 20, clientY: 20, isPrimary: true } as PointerEvent)
255
+
256
+ expect(interaction.getInteractionSnapshot().hoveredCustomMarker).toBeNull()
257
+ expect(changes[changes.length - 1]?.hoveredCustomMarker).toBeNull()
258
+ })
259
+ })