@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,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
+ }