@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,69 +1,69 @@
1
- import { describe, it, expect } from 'vitest'
2
- import { calcVWAPData } from '../calculators'
3
- import {
4
- empty,
5
- constantPrice,
6
- pureUptrend,
7
- pureDowntrend,
8
- sideways,
9
- spikeAtBar19,
10
- } from './__fixtures__/synthetic'
11
-
12
- describe('calcVWAPData', () => {
13
- it('empty returns empty', () => {
14
- expect(calcVWAPData(empty, 0)).toEqual([])
15
- })
16
-
17
- it('on constantPrice (TP=100, volume=1000) VWAP = 100 throughout', () => {
18
- const out = calcVWAPData(constantPrice, 0)
19
- for (const v of out) expect(v).toBeCloseTo(100, 9)
20
- })
21
-
22
- it('VWAP between min low and max high of cumulative window', () => {
23
- for (const fx of [pureUptrend, pureDowntrend, sideways, spikeAtBar19]) {
24
- const out = calcVWAPData(fx, 0)
25
- for (let t = 0; t < out.length; t++) {
26
- const v = out[t]
27
- if (v === undefined) continue
28
- let cumLo = Infinity
29
- let cumHi = -Infinity
30
- for (let i = 0; i <= t; i++) {
31
- if (fx[i]!.low < cumLo) cumLo = fx[i]!.low
32
- if (fx[i]!.high > cumHi) cumHi = fx[i]!.high
33
- }
34
- expect(v).toBeGreaterThanOrEqual(cumLo - 1e-9)
35
- expect(v).toBeLessThanOrEqual(cumHi + 1e-9)
36
- }
37
- }
38
- })
39
-
40
- it('on pureUptrend VWAP monotonically increases (each new TP > running average)', () => {
41
- const out = calcVWAPData(pureUptrend, 0)
42
- for (let t = 1; t < out.length; t++) {
43
- expect(out[t]!).toBeGreaterThan(out[t - 1]!)
44
- }
45
- })
46
-
47
- it('session reset triggers when gap exceeds threshold', () => {
48
- // Construct data with a big timestamp gap to trigger reset
49
- const HOUR_MS = 3_600_000
50
- const data = pureUptrend.map((bar, i) => ({
51
- ...bar,
52
- timestamp: bar.timestamp + (i >= 15 ? 24 * HOUR_MS : 0), // 15-bar gap day-jump
53
- }))
54
- const noReset = calcVWAPData(data, 0)
55
- const withReset = calcVWAPData(data, 12 * HOUR_MS)
56
- // After reset, VWAP at bar 15+ should be different from no-reset version
57
- expect(withReset[15]).not.toBeCloseTo(noReset[15]!, 6)
58
- })
59
-
60
- it('extensional consistency', () => {
61
- const full = calcVWAPData(pureUptrend, 0)
62
- for (let n = 5; n < pureUptrend.length; n++) {
63
- const partial = calcVWAPData(pureUptrend.slice(0, n), 0)
64
- for (let i = 0; i < n; i++) {
65
- expect(partial[i]).toBeCloseTo(full[i]!, 9)
66
- }
67
- }
68
- })
69
- })
1
+ import { describe, it, expect } from 'vitest'
2
+ import { calcVWAPData } from '../calculators'
3
+ import {
4
+ empty,
5
+ constantPrice,
6
+ pureUptrend,
7
+ pureDowntrend,
8
+ sideways,
9
+ spikeAtBar19,
10
+ } from './__fixtures__/synthetic'
11
+
12
+ describe('calcVWAPData', () => {
13
+ it('empty returns empty', () => {
14
+ expect(calcVWAPData(empty, 0)).toEqual([])
15
+ })
16
+
17
+ it('on constantPrice (TP=100, volume=1000) VWAP = 100 throughout', () => {
18
+ const out = calcVWAPData(constantPrice, 0)
19
+ for (const v of out) expect(v).toBeCloseTo(100, 9)
20
+ })
21
+
22
+ it('VWAP between min low and max high of cumulative window', () => {
23
+ for (const fx of [pureUptrend, pureDowntrend, sideways, spikeAtBar19]) {
24
+ const out = calcVWAPData(fx, 0)
25
+ for (let t = 0; t < out.length; t++) {
26
+ const v = out[t]
27
+ if (v === undefined) continue
28
+ let cumLo = Infinity
29
+ let cumHi = -Infinity
30
+ for (let i = 0; i <= t; i++) {
31
+ if (fx[i]!.low < cumLo) cumLo = fx[i]!.low
32
+ if (fx[i]!.high > cumHi) cumHi = fx[i]!.high
33
+ }
34
+ expect(v).toBeGreaterThanOrEqual(cumLo - 1e-9)
35
+ expect(v).toBeLessThanOrEqual(cumHi + 1e-9)
36
+ }
37
+ }
38
+ })
39
+
40
+ it('on pureUptrend VWAP monotonically increases (each new TP > running average)', () => {
41
+ const out = calcVWAPData(pureUptrend, 0)
42
+ for (let t = 1; t < out.length; t++) {
43
+ expect(out[t]!).toBeGreaterThan(out[t - 1]!)
44
+ }
45
+ })
46
+
47
+ it('session reset triggers when gap exceeds threshold', () => {
48
+ // Construct data with a big timestamp gap to trigger reset
49
+ const HOUR_MS = 3_600_000
50
+ const data = pureUptrend.map((bar, i) => ({
51
+ ...bar,
52
+ timestamp: bar.timestamp + (i >= 15 ? 24 * HOUR_MS : 0), // 15-bar gap day-jump
53
+ }))
54
+ const noReset = calcVWAPData(data, 0)
55
+ const withReset = calcVWAPData(data, 12 * HOUR_MS)
56
+ // After reset, VWAP at bar 15+ should be different from no-reset version
57
+ expect(withReset[15]).not.toBeCloseTo(noReset[15]!, 6)
58
+ })
59
+
60
+ it('extensional consistency', () => {
61
+ const full = calcVWAPData(pureUptrend, 0)
62
+ for (let n = 5; n < pureUptrend.length; n++) {
63
+ const partial = calcVWAPData(pureUptrend.slice(0, n), 0)
64
+ for (let i = 0; i < n; i++) {
65
+ expect(partial[i]).toBeCloseTo(full[i]!, 9)
66
+ }
67
+ }
68
+ })
69
+ })
@@ -1,112 +1,112 @@
1
- import { describe, it, expect } from 'vitest'
2
- import { calcWMAData } from '../calculators'
3
- import {
4
- empty,
5
- singleBar,
6
- shortSequence,
7
- constantPrice,
8
- pureUptrend,
9
- pureDowntrend,
10
- sideways,
11
- spikeAtBar19,
12
- } from './__fixtures__/synthetic'
13
- import { WMA_GOLDEN, assertSeriesClose } from './__fixtures__/golden'
14
- import {
15
- assertFiniteOrUndefined,
16
- assertWarmupThenDefined,
17
- } from './_propertyAssertions'
18
-
19
- describe('calcWMAData — Linear-weighted moving average', () => {
20
- describe('edge cases', () => {
21
- it('empty returns empty array', () => {
22
- expect(calcWMAData(empty, 9)).toEqual([])
23
- })
24
-
25
- it('single bar with period 9 returns [undefined]', () => {
26
- expect(calcWMAData(singleBar, 9)).toEqual([undefined])
27
- })
28
-
29
- it('shorter than period returns all undefined', () => {
30
- const out = calcWMAData(shortSequence, 9)
31
- expect(out).toHaveLength(shortSequence.length)
32
- for (const v of out) expect(v).toBeUndefined()
33
- })
34
-
35
- it('period = 0 or negative returns all undefined', () => {
36
- const zero = calcWMAData(pureUptrend, 0)
37
- for (const v of zero) expect(v).toBeUndefined()
38
- const neg = calcWMAData(pureUptrend, -3)
39
- for (const v of neg) expect(v).toBeUndefined()
40
- })
41
-
42
- it('period = 1 reproduces close[t] exactly', () => {
43
- const out = calcWMAData(pureUptrend, 1)
44
- for (let i = 0; i < out.length; i++) {
45
- expect(out[i]).toBeCloseTo(pureUptrend[i]!.close, 12)
46
- }
47
- })
48
- })
49
-
50
- describe('golden values', () => {
51
- it('constantPrice → WMA(9) equals 100 after warm-up', () => {
52
- assertSeriesClose(calcWMAData(constantPrice, 9), WMA_GOLDEN.constantPrice!.series)
53
- })
54
-
55
- it('pureUptrend → WMA(9) matches closed-form derivation', () => {
56
- assertSeriesClose(calcWMAData(pureUptrend, 9), WMA_GOLDEN.pureUptrend!.series)
57
- })
58
- })
59
-
60
- describe('mathematical properties', () => {
61
- it('warm-up region exactly [0, period-1)', () => {
62
- assertWarmupThenDefined(calcWMAData(pureUptrend, 9), 8, 'WMA(9) pureUptrend')
63
- })
64
-
65
- it('all values finite (or undefined in warm-up)', () => {
66
- for (const fx of [pureUptrend, pureDowntrend, sideways, spikeAtBar19]) {
67
- assertFiniteOrUndefined(calcWMAData(fx, 9), 'WMA series')
68
- }
69
- })
70
-
71
- it('downtrend WMA mirrors uptrend WMA around the center value', () => {
72
- // pureUptrend close = 100+i, pureDowntrend close = 200-i
73
- // sum of corresponding closes = 300 for all i → WMA up + WMA down = 300
74
- const up = calcWMAData(pureUptrend, 9)
75
- const dn = calcWMAData(pureDowntrend, 9)
76
- for (let i = 0; i < up.length; i++) {
77
- if (up[i] === undefined) {
78
- expect(dn[i]).toBeUndefined()
79
- } else {
80
- expect(up[i]! + dn[i]!).toBeCloseTo(300, 9)
81
- }
82
- }
83
- })
84
-
85
- it('WMA lag on linear input equals (period-1)/3', () => {
86
- // For close = 100+t, WMA(period)(t) = (100+t) - (period-1)/3 at steady state
87
- const period = 9
88
- const out = calcWMAData(pureUptrend, period)
89
- const lag = (period - 1) / 3
90
- for (let t = period - 1; t < out.length; t++) {
91
- const expected = 100 + t - lag
92
- expect(out[t]!).toBeCloseTo(expected, 9)
93
- }
94
- })
95
- })
96
-
97
- describe('extensional consistency', () => {
98
- it('extending data preserves earlier WMA values', () => {
99
- for (let n = 9; n < pureUptrend.length; n++) {
100
- const prefix = calcWMAData(pureUptrend.slice(0, n), 9)
101
- const extended = calcWMAData(pureUptrend.slice(0, n + 1), 9)
102
- for (let i = 0; i < prefix.length; i++) {
103
- if (prefix[i] === undefined) {
104
- expect(extended[i]).toBeUndefined()
105
- } else {
106
- expect(extended[i]).toBeCloseTo(prefix[i]!, 12)
107
- }
108
- }
109
- }
110
- })
111
- })
112
- })
1
+ import { describe, it, expect } from 'vitest'
2
+ import { calcWMAData } from '../calculators'
3
+ import {
4
+ empty,
5
+ singleBar,
6
+ shortSequence,
7
+ constantPrice,
8
+ pureUptrend,
9
+ pureDowntrend,
10
+ sideways,
11
+ spikeAtBar19,
12
+ } from './__fixtures__/synthetic'
13
+ import { WMA_GOLDEN, assertSeriesClose } from './__fixtures__/golden'
14
+ import {
15
+ assertFiniteOrUndefined,
16
+ assertWarmupThenDefined,
17
+ } from './_propertyAssertions'
18
+
19
+ describe('calcWMAData — Linear-weighted moving average', () => {
20
+ describe('edge cases', () => {
21
+ it('empty returns empty array', () => {
22
+ expect(calcWMAData(empty, 9)).toEqual([])
23
+ })
24
+
25
+ it('single bar with period 9 returns [undefined]', () => {
26
+ expect(calcWMAData(singleBar, 9)).toEqual([undefined])
27
+ })
28
+
29
+ it('shorter than period returns all undefined', () => {
30
+ const out = calcWMAData(shortSequence, 9)
31
+ expect(out).toHaveLength(shortSequence.length)
32
+ for (const v of out) expect(v).toBeUndefined()
33
+ })
34
+
35
+ it('period = 0 or negative returns all undefined', () => {
36
+ const zero = calcWMAData(pureUptrend, 0)
37
+ for (const v of zero) expect(v).toBeUndefined()
38
+ const neg = calcWMAData(pureUptrend, -3)
39
+ for (const v of neg) expect(v).toBeUndefined()
40
+ })
41
+
42
+ it('period = 1 reproduces close[t] exactly', () => {
43
+ const out = calcWMAData(pureUptrend, 1)
44
+ for (let i = 0; i < out.length; i++) {
45
+ expect(out[i]).toBeCloseTo(pureUptrend[i]!.close, 12)
46
+ }
47
+ })
48
+ })
49
+
50
+ describe('golden values', () => {
51
+ it('constantPrice → WMA(9) equals 100 after warm-up', () => {
52
+ assertSeriesClose(calcWMAData(constantPrice, 9), WMA_GOLDEN.constantPrice!.series)
53
+ })
54
+
55
+ it('pureUptrend → WMA(9) matches closed-form derivation', () => {
56
+ assertSeriesClose(calcWMAData(pureUptrend, 9), WMA_GOLDEN.pureUptrend!.series)
57
+ })
58
+ })
59
+
60
+ describe('mathematical properties', () => {
61
+ it('warm-up region exactly [0, period-1)', () => {
62
+ assertWarmupThenDefined(calcWMAData(pureUptrend, 9), 8, 'WMA(9) pureUptrend')
63
+ })
64
+
65
+ it('all values finite (or undefined in warm-up)', () => {
66
+ for (const fx of [pureUptrend, pureDowntrend, sideways, spikeAtBar19]) {
67
+ assertFiniteOrUndefined(calcWMAData(fx, 9), 'WMA series')
68
+ }
69
+ })
70
+
71
+ it('downtrend WMA mirrors uptrend WMA around the center value', () => {
72
+ // pureUptrend close = 100+i, pureDowntrend close = 200-i
73
+ // sum of corresponding closes = 300 for all i → WMA up + WMA down = 300
74
+ const up = calcWMAData(pureUptrend, 9)
75
+ const dn = calcWMAData(pureDowntrend, 9)
76
+ for (let i = 0; i < up.length; i++) {
77
+ if (up[i] === undefined) {
78
+ expect(dn[i]).toBeUndefined()
79
+ } else {
80
+ expect(up[i]! + dn[i]!).toBeCloseTo(300, 9)
81
+ }
82
+ }
83
+ })
84
+
85
+ it('WMA lag on linear input equals (period-1)/3', () => {
86
+ // For close = 100+t, WMA(period)(t) = (100+t) - (period-1)/3 at steady state
87
+ const period = 9
88
+ const out = calcWMAData(pureUptrend, period)
89
+ const lag = (period - 1) / 3
90
+ for (let t = period - 1; t < out.length; t++) {
91
+ const expected = 100 + t - lag
92
+ expect(out[t]!).toBeCloseTo(expected, 9)
93
+ }
94
+ })
95
+ })
96
+
97
+ describe('extensional consistency', () => {
98
+ it('extending data preserves earlier WMA values', () => {
99
+ for (let n = 9; n < pureUptrend.length; n++) {
100
+ const prefix = calcWMAData(pureUptrend.slice(0, n), 9)
101
+ const extended = calcWMAData(pureUptrend.slice(0, n + 1), 9)
102
+ for (let i = 0; i < prefix.length; i++) {
103
+ if (prefix[i] === undefined) {
104
+ expect(extended[i]).toBeUndefined()
105
+ } else {
106
+ expect(extended[i]).toBeCloseTo(prefix[i]!, 12)
107
+ }
108
+ }
109
+ }
110
+ })
111
+ })
112
+ })
@@ -1,95 +1,95 @@
1
- import { describe, it, expect } from 'vitest'
2
- import { calcZonesData } from '../calculators'
3
- import type { KLineData } from '@/types/price'
4
- import {
5
- empty,
6
- pureUptrend,
7
- constantPrice,
8
- sideways,
9
- } from './__fixtures__/synthetic'
10
-
11
- function buildGapFixture(): KLineData[] {
12
- const result: KLineData[] = []
13
- const T0 = 1_700_000_000_000
14
- // Build a clear bullish FVG: bar[i-2].high < bar[i].low
15
- // bar 0: H=100, L=99
16
- result.push({ timestamp: T0, open: 99.5, high: 100, low: 99, close: 99.5, volume: 100 })
17
- // bar 1: H=102, L=100.5 (gap up vs bar 0)
18
- result.push({ timestamp: T0 + 60000, open: 101, high: 102, low: 100.5, close: 101.5, volume: 100 })
19
- // bar 2: H=104, L=101 (bar 0.high=100 < bar 2.low=101 → bullish FVG)
20
- result.push({ timestamp: T0 + 120000, open: 102, high: 104, low: 101, close: 103, volume: 100 })
21
- // Continue uptrend
22
- for (let i = 3; i < 15; i++) {
23
- const close = 103 + i
24
- result.push({ timestamp: T0 + i * 60000, open: close, high: close + 0.5, low: close - 0.5, close, volume: 100 })
25
- }
26
- return result
27
- }
28
-
29
- describe('calcZonesData', () => {
30
- it('empty returns empty', () => {
31
- expect(calcZonesData(empty, 5, 2, 2, 'close')).toEqual([])
32
- })
33
-
34
- it('constant price → no FVGs (no gaps possible)', () => {
35
- const zones = calcZonesData(constantPrice, 5, 2, 2, 'close')
36
- expect(zones.filter((z) => z.kind === 'FVG_BULL' || z.kind === 'FVG_BEAR')).toEqual([])
37
- })
38
-
39
- it('gap fixture → at least one bullish FVG detected', () => {
40
- const data = buildGapFixture()
41
- const zones = calcZonesData(data, 5, 2, 2, 'close')
42
- const fvgs = zones.filter((z) => z.kind === 'FVG_BULL')
43
- expect(fvgs.length).toBeGreaterThanOrEqual(1)
44
- // First FVG should be at bar 1 (middle of the 3-bar pattern)
45
- const firstFvg = fvgs[0]!
46
- expect(firstFvg.startIndex).toBe(1)
47
- // Zone bounds: bar[0].high=100, bar[2].low=101 → low=100, high=101
48
- expect(firstFvg.low).toBe(100)
49
- expect(firstFvg.high).toBe(101)
50
- })
51
-
52
- it('zone high > zone low invariant', () => {
53
- const data = buildGapFixture()
54
- const zones = calcZonesData(data, 5, 2, 2, 'close')
55
- for (const z of zones) {
56
- expect(z.high).toBeGreaterThanOrEqual(z.low)
57
- }
58
- })
59
-
60
- it('zone endIndex (if set) > startIndex', () => {
61
- const data = buildGapFixture()
62
- const zones = calcZonesData(data, 5, 2, 2, 'close')
63
- for (const z of zones) {
64
- if (z.endIndex !== undefined) {
65
- expect(z.endIndex).toBeGreaterThan(z.startIndex)
66
- }
67
- }
68
- })
69
-
70
- it('extensional consistency on pure uptrend', () => {
71
- const full = calcZonesData(pureUptrend, 5, 2, 2, 'close')
72
- for (let n = 5; n < pureUptrend.length; n++) {
73
- const partial = calcZonesData(pureUptrend.slice(0, n), 5, 2, 2, 'close')
74
- // Zones in partial that started in the prefix should also appear in full
75
- for (const pz of partial) {
76
- if (pz.startIndex + 2 < n) {
77
- const fz = full.find((z) => z.startIndex === pz.startIndex && z.kind === pz.kind)
78
- expect(fz).toBeDefined()
79
- if (fz) {
80
- expect(fz.high).toBeCloseTo(pz.high, 9)
81
- expect(fz.low).toBeCloseTo(pz.low, 9)
82
- }
83
- }
84
- }
85
- }
86
- })
87
-
88
- it('disabled flags filter zones in renderer mode but raw output includes all', () => {
89
- // calcZonesData always returns all zone kinds; the renderer params filter rendering
90
- const data = buildGapFixture()
91
- const zones = calcZonesData(data, 5, 2, 2, 'close')
92
- // Just sanity: array exists
93
- expect(Array.isArray(zones)).toBe(true)
94
- })
95
- })
1
+ import { describe, it, expect } from 'vitest'
2
+ import { calcZonesData } from '../calculators'
3
+ import type { KLineData } from '@/types/price'
4
+ import {
5
+ empty,
6
+ pureUptrend,
7
+ constantPrice,
8
+ sideways,
9
+ } from './__fixtures__/synthetic'
10
+
11
+ function buildGapFixture(): KLineData[] {
12
+ const result: KLineData[] = []
13
+ const T0 = 1_700_000_000_000
14
+ // Build a clear bullish FVG: bar[i-2].high < bar[i].low
15
+ // bar 0: H=100, L=99
16
+ result.push({ timestamp: T0, open: 99.5, high: 100, low: 99, close: 99.5, volume: 100 })
17
+ // bar 1: H=102, L=100.5 (gap up vs bar 0)
18
+ result.push({ timestamp: T0 + 60000, open: 101, high: 102, low: 100.5, close: 101.5, volume: 100 })
19
+ // bar 2: H=104, L=101 (bar 0.high=100 < bar 2.low=101 → bullish FVG)
20
+ result.push({ timestamp: T0 + 120000, open: 102, high: 104, low: 101, close: 103, volume: 100 })
21
+ // Continue uptrend
22
+ for (let i = 3; i < 15; i++) {
23
+ const close = 103 + i
24
+ result.push({ timestamp: T0 + i * 60000, open: close, high: close + 0.5, low: close - 0.5, close, volume: 100 })
25
+ }
26
+ return result
27
+ }
28
+
29
+ describe('calcZonesData', () => {
30
+ it('empty returns empty', () => {
31
+ expect(calcZonesData(empty, 5, 2, 2, 'close')).toEqual([])
32
+ })
33
+
34
+ it('constant price → no FVGs (no gaps possible)', () => {
35
+ const zones = calcZonesData(constantPrice, 5, 2, 2, 'close')
36
+ expect(zones.filter((z) => z.kind === 'FVG_BULL' || z.kind === 'FVG_BEAR')).toEqual([])
37
+ })
38
+
39
+ it('gap fixture → at least one bullish FVG detected', () => {
40
+ const data = buildGapFixture()
41
+ const zones = calcZonesData(data, 5, 2, 2, 'close')
42
+ const fvgs = zones.filter((z) => z.kind === 'FVG_BULL')
43
+ expect(fvgs.length).toBeGreaterThanOrEqual(1)
44
+ // First FVG should be at bar 1 (middle of the 3-bar pattern)
45
+ const firstFvg = fvgs[0]!
46
+ expect(firstFvg.startIndex).toBe(1)
47
+ // Zone bounds: bar[0].high=100, bar[2].low=101 → low=100, high=101
48
+ expect(firstFvg.low).toBe(100)
49
+ expect(firstFvg.high).toBe(101)
50
+ })
51
+
52
+ it('zone high > zone low invariant', () => {
53
+ const data = buildGapFixture()
54
+ const zones = calcZonesData(data, 5, 2, 2, 'close')
55
+ for (const z of zones) {
56
+ expect(z.high).toBeGreaterThanOrEqual(z.low)
57
+ }
58
+ })
59
+
60
+ it('zone endIndex (if set) > startIndex', () => {
61
+ const data = buildGapFixture()
62
+ const zones = calcZonesData(data, 5, 2, 2, 'close')
63
+ for (const z of zones) {
64
+ if (z.endIndex !== undefined) {
65
+ expect(z.endIndex).toBeGreaterThan(z.startIndex)
66
+ }
67
+ }
68
+ })
69
+
70
+ it('extensional consistency on pure uptrend', () => {
71
+ const full = calcZonesData(pureUptrend, 5, 2, 2, 'close')
72
+ for (let n = 5; n < pureUptrend.length; n++) {
73
+ const partial = calcZonesData(pureUptrend.slice(0, n), 5, 2, 2, 'close')
74
+ // Zones in partial that started in the prefix should also appear in full
75
+ for (const pz of partial) {
76
+ if (pz.startIndex + 2 < n) {
77
+ const fz = full.find((z) => z.startIndex === pz.startIndex && z.kind === pz.kind)
78
+ expect(fz).toBeDefined()
79
+ if (fz) {
80
+ expect(fz.high).toBeCloseTo(pz.high, 9)
81
+ expect(fz.low).toBeCloseTo(pz.low, 9)
82
+ }
83
+ }
84
+ }
85
+ }
86
+ })
87
+
88
+ it('disabled flags filter zones in renderer mode but raw output includes all', () => {
89
+ // calcZonesData always returns all zone kinds; the renderer params filter rendering
90
+ const data = buildGapFixture()
91
+ const zones = calcZonesData(data, 5, 2, 2, 'close')
92
+ // Just sanity: array exists
93
+ expect(Array.isArray(zones)).toBe(true)
94
+ })
95
+ })
@@ -1,27 +1,27 @@
1
- import type { BaseIndicatorState } from '../../plugin'
2
- import { createIndicatorStateKey } from '../../plugin/stateKeys'
3
-
4
- export interface ATRRenderState extends BaseIndicatorState {
5
- timestamp: number
6
- series: (number | undefined)[]
7
- params: { period: number; showATR: boolean }
8
- valueMin: number
9
- valueMax: number
10
- visibleMin: number
11
- visibleMax: number
12
- }
13
-
14
- export const createATRStateKey = (paneId: string) =>
15
- createIndicatorStateKey('atr', paneId)
16
-
17
- export const DEFAULT_ATR_PERIOD = 14
18
-
19
- export const EMPTY_ATR_STATE: ATRRenderState = {
20
- timestamp: 0,
21
- series: [],
22
- params: { period: DEFAULT_ATR_PERIOD, showATR: true },
23
- valueMin: 0,
24
- valueMax: 1,
25
- visibleMin: Infinity,
26
- visibleMax: -Infinity,
27
- }
1
+ import type { BaseIndicatorState } from '../../plugin'
2
+ import { createIndicatorStateKey } from '../../plugin/stateKeys'
3
+
4
+ export interface ATRRenderState extends BaseIndicatorState {
5
+ timestamp: number
6
+ series: (number | undefined)[]
7
+ params: { period: number; showATR: boolean }
8
+ valueMin: number
9
+ valueMax: number
10
+ visibleMin: number
11
+ visibleMax: number
12
+ }
13
+
14
+ export const createATRStateKey = (paneId: string) =>
15
+ createIndicatorStateKey('atr', paneId)
16
+
17
+ export const DEFAULT_ATR_PERIOD = 14
18
+
19
+ export const EMPTY_ATR_STATE: ATRRenderState = {
20
+ timestamp: 0,
21
+ series: [],
22
+ params: { period: DEFAULT_ATR_PERIOD, showATR: true },
23
+ valueMin: 0,
24
+ valueMax: 1,
25
+ visibleMin: Infinity,
26
+ visibleMax: -Infinity,
27
+ }