@orangecharts/wrun-chart-host 0.11.1 → 0.14.0

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 (307) hide show
  1. package/README.md +1 -0
  2. package/dist/constants/feature-flags.constants.d.ts +3 -4
  3. package/dist/constants/feature-flags.constants.js +34 -52
  4. package/dist/constants/feature-limits.constants.d.ts +1 -1
  5. package/dist/constants/feature-limits.constants.js +5 -4
  6. package/dist/constants/interval.constants.d.ts +7 -0
  7. package/dist/constants/interval.constants.js +7 -0
  8. package/dist/constants/scriptEditor/cme-official-scripts.constants.d.ts +20 -149
  9. package/dist/constants/scriptEditor/cme-official-scripts.constants.js +20 -309
  10. package/dist/constants/stocks-compliance.constants.d.ts +15 -0
  11. package/dist/constants/stocks-compliance.constants.js +15 -0
  12. package/dist/host-env.d.ts +55 -3
  13. package/dist/host-env.js +6 -0
  14. package/dist/host-ports.types.d.ts +36 -3
  15. package/dist/index.d.ts +17 -0
  16. package/dist/index.js +18 -0
  17. package/dist/indicators/controls/tpo-session.util.d.ts +52 -12
  18. package/dist/indicators/controls/tpo-session.util.js +113 -16
  19. package/dist/instances/script-engine-worker-ohlcv-transfer.d.ts +6 -0
  20. package/dist/instances/script-engine-worker-ohlcv-transfer.js +16 -0
  21. package/dist/interfaces/cme-realtime.interface.d.ts +8 -0
  22. package/dist/interfaces/cme-realtime.interface.js +2 -1
  23. package/dist/interfaces/feed.interface.d.ts +15 -1
  24. package/dist/interfaces/replay.interface.d.ts +5 -0
  25. package/dist/interfaces/stocks-realtime.interface.d.ts +4 -3
  26. package/dist/interfaces/stocks-realtime.interface.js +5 -4
  27. package/dist/interfaces/wrun-runtime.interface.d.ts +97 -19
  28. package/dist/kscript-data/controls/live-ohlcv-merge.util.d.ts +17 -0
  29. package/dist/kscript-data/controls/live-ohlcv-merge.util.js +22 -0
  30. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +46 -40
  31. package/dist/kscript-data/controls/live-trades-merge.util.js +80 -107
  32. package/dist/market-data/billing.interface.d.ts +9 -1
  33. package/dist/market-data/venue.d.ts +1 -1
  34. package/dist/market-data/venues/index.d.ts +4 -4
  35. package/dist/market-data/venues/stocks.contract.copy.json +4 -4
  36. package/dist/market-data/venues/stocks.d.ts +4 -4
  37. package/dist/market-data/venues/stocks.js +15 -13
  38. package/dist/settings-templates/frvp-fields.d.ts +12 -1
  39. package/dist/settings-templates/frvp-fields.js +15 -4
  40. package/dist/settings-templates/index.js +12 -5
  41. package/dist/settings-templates/indicator-fields.js +28 -2
  42. package/dist/settings-templates/tool-rules.d.ts +17 -8
  43. package/dist/settings-templates/tool-rules.js +15 -8
  44. package/dist/settings-templates/tool-tables.generated.js +4 -2
  45. package/dist/utility/auth/server-clock.util.d.ts +3 -1
  46. package/dist/utility/auth/server-clock.util.js +3 -1
  47. package/dist/utility/chart/book-live-bucket.util.js +2 -2
  48. package/dist/utility/chart/cache-alignment.util.d.ts +15 -7
  49. package/dist/utility/chart/cache-alignment.util.js +14 -7
  50. package/dist/utility/chart/chart-data-fetch-generation.util.d.ts +2 -0
  51. package/dist/utility/chart/chart-data-fetch-generation.util.js +16 -0
  52. package/dist/utility/chart/cme-session-bucket.util.d.ts +18 -75
  53. package/dist/utility/chart/cme-session-bucket.util.js +25 -332
  54. package/dist/utility/chart/continuous-contracts.util.js +6 -5
  55. package/dist/utility/chart/display-offset.leaf.d.ts +24 -0
  56. package/dist/utility/chart/display-offset.leaf.js +41 -0
  57. package/dist/utility/chart/effective-chart-session.util.d.ts +2 -1
  58. package/dist/utility/chart/effective-chart-session.util.js +13 -5
  59. package/dist/utility/chart/feed-interval.util.d.ts +6 -20
  60. package/dist/utility/chart/feed-interval.util.js +13 -22
  61. package/dist/utility/chart/fetch-dedupe-policy.util.d.ts +27 -7
  62. package/dist/utility/chart/fetch-dedupe-policy.util.js +86 -11
  63. package/dist/utility/chart/host-bar-placement.util.d.ts +7 -4
  64. package/dist/utility/chart/host-bar-placement.util.js +8 -2
  65. package/dist/utility/chart/indicator-inflight-registry.util.d.ts +32 -0
  66. package/dist/utility/chart/indicator-inflight-registry.util.js +52 -0
  67. package/dist/utility/chart/indicator-run-interval.util.d.ts +10 -4
  68. package/dist/utility/chart/indicator-run-interval.util.js +21 -12
  69. package/dist/utility/chart/interval-registry.util.d.ts +1 -1
  70. package/dist/utility/chart/interval-registry.util.js +1 -1
  71. package/dist/utility/chart/kscript-legend-entries.util.d.ts +12 -0
  72. package/dist/utility/chart/kscript-legend-entries.util.js +16 -0
  73. package/dist/utility/chart/kscript-run-interval-projection.util.d.ts +1 -1
  74. package/dist/utility/chart/kscript-run-interval-projection.util.js +4 -2
  75. package/dist/utility/chart/kscript-venue-policy.util.d.ts +53 -62
  76. package/dist/utility/chart/kscript-venue-policy.util.js +85 -94
  77. package/dist/utility/chart/live-bucket.util.d.ts +39 -17
  78. package/dist/utility/chart/live-bucket.util.js +103 -57
  79. package/dist/utility/chart/local-kscript-source-revalidation.util.d.ts +58 -20
  80. package/dist/utility/chart/local-kscript-source-revalidation.util.js +98 -23
  81. package/dist/utility/chart/local-kscript-warmup-depth.util.d.ts +35 -11
  82. package/dist/utility/chart/local-kscript-warmup-depth.util.js +24 -3
  83. package/dist/utility/chart/market-session-schedule.util.d.ts +8 -0
  84. package/dist/utility/chart/market-session-schedule.util.js +39 -1
  85. package/dist/utility/chart/market-session.util.d.ts +136 -0
  86. package/dist/utility/chart/market-session.util.js +341 -0
  87. package/dist/utility/chart/om-panel.util.d.ts +5 -3
  88. package/dist/utility/chart/om-panel.util.js +42 -7
  89. package/dist/utility/chart/om-target.util.d.ts +14 -1
  90. package/dist/utility/chart/om-target.util.js +22 -5
  91. package/dist/utility/chart/opra-read-access.leaf.d.ts +16 -1
  92. package/dist/utility/chart/opra-read-access.leaf.js +22 -0
  93. package/dist/utility/chart/profile-row-height.util.d.ts +49 -16
  94. package/dist/utility/chart/profile-row-height.util.js +74 -37
  95. package/dist/utility/chart/rth-session.util.d.ts +55 -20
  96. package/dist/utility/chart/rth-session.util.js +94 -46
  97. package/dist/utility/chart/session-lattice.util.d.ts +150 -0
  98. package/dist/utility/chart/session-lattice.util.js +488 -0
  99. package/dist/utility/chart/trading-day.util.d.ts +40 -2
  100. package/dist/utility/chart/trading-day.util.js +84 -7
  101. package/dist/utility/chart/us-equities-session.util.d.ts +32 -11
  102. package/dist/utility/chart/us-equities-session.util.js +44 -15
  103. package/dist/utility/chart/window-geometry.leaf.d.ts +28 -7
  104. package/dist/utility/chart/window-geometry.leaf.js +57 -8
  105. package/dist/utility/chart/wrun-bar-session-facts.util.d.ts +21 -14
  106. package/dist/utility/chart/wrun-bar-session-facts.util.js +32 -38
  107. package/dist/utility/chart/wrun-run-result.util.d.ts +29 -12
  108. package/dist/utility/chart/wrun-run-result.util.js +89 -25
  109. package/dist/utility/common/time.util.js +5 -4
  110. package/dist/utility/market-events/earnings-scope.util.d.ts +10 -5
  111. package/dist/utility/market-events/earnings-scope.util.js +17 -9
  112. package/dist/utility/market-events/market-events.util.d.ts +14 -7
  113. package/dist/utility/market-events/market-events.util.js +30 -17
  114. package/dist/utility/number-format.util.d.ts +14 -21
  115. package/dist/utility/number-format.util.js +38 -24
  116. package/dist/utility/options/option-venue-disclosure.util.d.ts +40 -6
  117. package/dist/utility/options/option-venue-disclosure.util.js +71 -11
  118. package/dist/utility/options/option-venue.util.d.ts +1 -1
  119. package/dist/utility/options/option-venue.util.js +1 -1
  120. package/dist/utility/pool-symbol.leaf.d.ts +7 -0
  121. package/dist/utility/pool-symbol.leaf.js +50 -5
  122. package/dist/utility/stocks/stock-display.util.d.ts +15 -0
  123. package/dist/utility/stocks/stock-display.util.js +37 -0
  124. package/dist/utility/symbol-selection/contract-expiry.util.js +5 -4
  125. package/dist/utility/v2/gate-plane.util.d.ts +6 -0
  126. package/dist/utility/v2/gate-plane.util.js +11 -1
  127. package/dist/utility/v2/gate-session-latch.util.d.ts +1 -1
  128. package/dist/utility/v2/gate-session-latch.util.js +3 -3
  129. package/dist/utility/v2/governed-tier.leaf.d.ts +17 -16
  130. package/dist/utility/v2/governed-tier.leaf.js +17 -16
  131. package/dist/utility/v2/stocks-governed.util.d.ts +5 -0
  132. package/dist/utility/v2/stocks-governed.util.js +14 -0
  133. package/dist/utility/v2/v2-enums.leaf.d.ts +13 -0
  134. package/dist/utility/v2/v2-enums.leaf.js +458 -0
  135. package/dist/utility/wrun/derived-roots.leaf.d.ts +21 -1
  136. package/dist/utility/wrun/derived-roots.leaf.js +27 -1
  137. package/dist/utility/wrun/derived-roots.util.d.ts +44 -32
  138. package/dist/utility/wrun/derived-roots.util.js +97 -56
  139. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.d.ts +4 -3
  140. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.js +4 -3
  141. package/dist/utility/wrun/sources/lanes/option_daily.d.ts +2 -1
  142. package/dist/utility/wrun/sources/lanes/option_daily.js +2 -1
  143. package/dist/utility/wrun/sources/lanes/options_flow.d.ts +3 -0
  144. package/dist/utility/wrun/sources/lanes/options_flow.js +23 -5
  145. package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +3 -4
  146. package/dist/utility/wrun/sources/row-lane-registry.js +9 -4
  147. package/dist/utility/wrun/sources/row-lanes/dark_pool.d.ts +19 -0
  148. package/dist/utility/wrun/sources/row-lanes/dark_pool.js +104 -0
  149. package/dist/utility/wrun/sources/row-lanes/index.js +2 -0
  150. package/dist/utility/wrun/sources/wrun-lane-fetch-abort.util.d.ts +20 -0
  151. package/dist/utility/wrun/sources/wrun-lane-fetch-abort.util.js +103 -0
  152. package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +19 -2
  153. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +15 -13
  154. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +49 -23
  155. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +14 -9
  156. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +75 -27
  157. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +139 -82
  158. package/dist/utility/wrun/wrun-app-layer.leaf.d.ts +78 -0
  159. package/dist/utility/wrun/wrun-app-layer.leaf.js +89 -0
  160. package/dist/utility/wrun/wrun-bar-count.util.d.ts +11 -7
  161. package/dist/utility/wrun/wrun-bar-count.util.js +12 -8
  162. package/dist/utility/wrun/wrun-batched-kinds.leaf.d.ts +13 -0
  163. package/dist/utility/wrun/wrun-batched-kinds.leaf.js +18 -0
  164. package/dist/utility/wrun/wrun-batched-marks.util.d.ts +41 -22
  165. package/dist/utility/wrun/wrun-batched-marks.util.js +255 -59
  166. package/dist/utility/wrun/wrun-batched-readout.util.d.ts +26 -19
  167. package/dist/utility/wrun/wrun-batched-readout.util.js +81 -27
  168. package/dist/utility/wrun/wrun-book-bands.leaf.d.ts +8 -0
  169. package/dist/utility/wrun/wrun-book-bands.leaf.js +7 -0
  170. package/dist/utility/wrun/wrun-candle-equal.leaf.d.ts +19 -0
  171. package/dist/utility/wrun/wrun-candle-equal.leaf.js +40 -0
  172. package/dist/utility/wrun/wrun-canvas-readout.util.d.ts +4 -2
  173. package/dist/utility/wrun/wrun-canvases.util.js +7 -3
  174. package/dist/utility/wrun/wrun-chart-context-names.util.d.ts +6 -3
  175. package/dist/utility/wrun/wrun-chart-context-names.util.js +8 -4
  176. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +47 -29
  177. package/dist/utility/wrun/wrun-chart-market-facts.util.js +201 -201
  178. package/dist/utility/wrun/wrun-child-overlay-id.util.js +2 -1
  179. package/dist/utility/wrun/wrun-cme-legs-note.util.d.ts +15 -0
  180. package/dist/utility/wrun/wrun-cme-legs-note.util.js +49 -0
  181. package/dist/utility/wrun/wrun-cme-root-specs.util.d.ts +38 -0
  182. package/dist/utility/wrun/wrun-cme-root-specs.util.js +81 -0
  183. package/dist/utility/wrun/wrun-coin-lane-live.util.js +3 -0
  184. package/dist/utility/wrun/wrun-color-settings.util.d.ts +6 -1
  185. package/dist/utility/wrun/wrun-color-settings.util.js +32 -7
  186. package/dist/utility/wrun/wrun-dark-pool.util.d.ts +50 -0
  187. package/dist/utility/wrun/wrun-dark-pool.util.js +127 -0
  188. package/dist/utility/wrun/wrun-declared-warmup.util.d.ts +67 -12
  189. package/dist/utility/wrun/wrun-declared-warmup.util.js +165 -13
  190. package/dist/utility/wrun/wrun-draft-legend-note.util.d.ts +18 -8
  191. package/dist/utility/wrun/wrun-draft-legend-note.util.js +57 -11
  192. package/dist/utility/wrun/wrun-draft-overlay.util.d.ts +14 -10
  193. package/dist/utility/wrun/wrun-draft-overlay.util.js +26 -14
  194. package/dist/utility/wrun/wrun-earnings-facts.util.js +3 -2
  195. package/dist/utility/wrun/wrun-etf-funds.util.d.ts +2 -0
  196. package/dist/utility/wrun/wrun-etf-funds.util.js +4 -0
  197. package/dist/utility/wrun/wrun-held-lanes.util.js +8 -2
  198. package/dist/utility/wrun/wrun-history-as-of.util.d.ts +77 -0
  199. package/dist/utility/wrun/wrun-history-as-of.util.js +108 -0
  200. package/dist/utility/wrun/wrun-host.service.d.ts +64 -14
  201. package/dist/utility/wrun/wrun-host.service.js +137 -27
  202. package/dist/utility/wrun/wrun-hosted-wire-caps.d.ts +3 -3
  203. package/dist/utility/wrun/wrun-hosted-wire-caps.js +12 -2
  204. package/dist/utility/wrun/wrun-inert-legend.util.d.ts +13 -0
  205. package/dist/utility/wrun/wrun-inert-legend.util.js +31 -3
  206. package/dist/utility/wrun/wrun-input-requirements.leaf.d.ts +7 -5
  207. package/dist/utility/wrun/wrun-input-requirements.leaf.js +16 -6
  208. package/dist/utility/wrun/wrun-install-pacer.util.d.ts +26 -0
  209. package/dist/utility/wrun/wrun-install-pacer.util.js +145 -0
  210. package/dist/utility/wrun/wrun-kit-refusal-stages.types.d.ts +22 -0
  211. package/dist/utility/wrun/wrun-kit-refusal-stages.types.js +1 -0
  212. package/dist/utility/wrun/wrun-lane-refusal.leaf.d.ts +12 -5
  213. package/dist/utility/wrun/wrun-lane-refusal.leaf.js +23 -5
  214. package/dist/utility/wrun/wrun-lane-warmup.util.js +22 -4
  215. package/dist/utility/wrun/wrun-leg-close.util.d.ts +6 -5
  216. package/dist/utility/wrun/wrun-leg-close.util.js +11 -9
  217. package/dist/utility/wrun/wrun-leg-fetch.util.d.ts +3 -1
  218. package/dist/utility/wrun/wrun-leg-fetch.util.js +9 -2
  219. package/dist/utility/wrun/wrun-levels-child.util.d.ts +2 -0
  220. package/dist/utility/wrun/wrun-levels-child.util.js +6 -0
  221. package/dist/utility/wrun/wrun-lifecycle.contract.d.ts +4 -0
  222. package/dist/utility/wrun/wrun-live-intake.util.d.ts +15 -6
  223. package/dist/utility/wrun/wrun-live-intake.util.js +167 -47
  224. package/dist/utility/wrun/wrun-live-tick.util.d.ts +52 -8
  225. package/dist/utility/wrun/wrun-live-tick.util.js +648 -97
  226. package/dist/utility/wrun/wrun-market-facts.util.d.ts +16 -2
  227. package/dist/utility/wrun/wrun-market-facts.util.js +32 -3
  228. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +27 -27
  229. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +28 -16
  230. package/dist/utility/wrun/wrun-market-size-defaults.util.js +34 -5
  231. package/dist/utility/wrun/wrun-oi-lane.util.d.ts +10 -7
  232. package/dist/utility/wrun/wrun-oi-lane.util.js +16 -10
  233. package/dist/utility/wrun/wrun-option-strike-flow.util.js +1 -1
  234. package/dist/utility/wrun/wrun-option-views.util.d.ts +2 -2
  235. package/dist/utility/wrun/wrun-option-views.util.js +5 -2
  236. package/dist/utility/wrun/wrun-options-flow-underlying.leaf.d.ts +5 -0
  237. package/dist/utility/wrun/wrun-options-flow-underlying.leaf.js +16 -0
  238. package/dist/utility/wrun/wrun-options-stop.util.d.ts +3 -2
  239. package/dist/utility/wrun/wrun-options-stop.util.js +6 -4
  240. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +75 -11
  241. package/dist/utility/wrun/wrun-overlay-drivers.util.js +176 -43
  242. package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +20 -10
  243. package/dist/utility/wrun/wrun-overlay-park.util.d.ts +84 -0
  244. package/dist/utility/wrun/wrun-overlay-park.util.js +135 -0
  245. package/dist/utility/wrun/wrun-overlay-recovery.util.d.ts +37 -4
  246. package/dist/utility/wrun/wrun-overlay-recovery.util.js +26 -14
  247. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +239 -24
  248. package/dist/utility/wrun/wrun-overlay-run.util.js +2204 -405
  249. package/dist/utility/wrun/wrun-pack.util.d.ts +8 -5
  250. package/dist/utility/wrun/wrun-panel-mount.util.d.ts +2 -1
  251. package/dist/utility/wrun/wrun-panel-mount.util.js +20 -14
  252. package/dist/utility/wrun/wrun-panel-style.util.d.ts +4 -2
  253. package/dist/utility/wrun/wrun-panel-style.util.js +3 -2
  254. package/dist/utility/wrun/wrun-pin-spelling.util.d.ts +7 -0
  255. package/dist/utility/wrun/wrun-pin-spelling.util.js +18 -4
  256. package/dist/utility/wrun/wrun-pin-venues.util.d.ts +26 -17
  257. package/dist/utility/wrun/wrun-pin-venues.util.js +43 -36
  258. package/dist/utility/wrun/wrun-pinned-lanes.util.d.ts +58 -0
  259. package/dist/utility/wrun/wrun-pinned-lanes.util.js +72 -0
  260. package/dist/utility/wrun/wrun-prefix-cohort.util.js +2 -1
  261. package/dist/utility/wrun/wrun-prefix-lanes.util.d.ts +22 -9
  262. package/dist/utility/wrun/wrun-prefix-lanes.util.js +145 -26
  263. package/dist/utility/wrun/wrun-prefix-proof.util.d.ts +29 -0
  264. package/dist/utility/wrun/wrun-prefix-proof.util.js +23 -5
  265. package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +9 -1
  266. package/dist/utility/wrun/wrun-refusal-surface.util.js +15 -1
  267. package/dist/utility/wrun/wrun-refusal.util.d.ts +19 -1
  268. package/dist/utility/wrun/wrun-refusal.util.js +103 -16
  269. package/dist/utility/wrun/wrun-registry-errors.util.d.ts +20 -6
  270. package/dist/utility/wrun/wrun-registry-errors.util.js +20 -6
  271. package/dist/utility/wrun/wrun-replay-rows.util.js +6 -10
  272. package/dist/utility/wrun/wrun-run-health.util.d.ts +89 -2
  273. package/dist/utility/wrun/wrun-run-health.util.js +204 -1
  274. package/dist/utility/wrun/wrun-run-interval-session.util.d.ts +2 -2
  275. package/dist/utility/wrun/wrun-run-interval-session.util.js +2 -2
  276. package/dist/utility/wrun/wrun-run-interval.util.d.ts +9 -8
  277. package/dist/utility/wrun/wrun-run-interval.util.js +13 -11
  278. package/dist/utility/wrun/wrun-sandbox-row-source.js +5 -2
  279. package/dist/utility/wrun/wrun-script-inputs.util.d.ts +13 -3
  280. package/dist/utility/wrun/wrun-script-inputs.util.js +51 -13
  281. package/dist/utility/wrun/wrun-session-composition.util.d.ts +81 -0
  282. package/dist/utility/wrun/wrun-session-composition.util.js +169 -0
  283. package/dist/utility/wrun/wrun-setting-words.util.d.ts +10 -7
  284. package/dist/utility/wrun/wrun-setting-words.util.js +25 -7
  285. package/dist/utility/wrun/wrun-source-rows.util.d.ts +94 -28
  286. package/dist/utility/wrun/wrun-source-rows.util.js +738 -93
  287. package/dist/utility/wrun/wrun-stream-clock.util.d.ts +45 -0
  288. package/dist/utility/wrun/wrun-stream-clock.util.js +108 -0
  289. package/dist/utility/wrun/wrun-tape-coins.util.d.ts +116 -0
  290. package/dist/utility/wrun/wrun-tape-coins.util.js +110 -0
  291. package/dist/utility/wrun/wrun-tape-source.util.d.ts +62 -32
  292. package/dist/utility/wrun/wrun-tape-source.util.js +72 -34
  293. package/dist/utility/wrun/wrun-tier-grid.util.d.ts +13 -5
  294. package/dist/utility/wrun/wrun-tier-grid.util.js +23 -13
  295. package/dist/utility/wrun/wrun-tpo-rows.util.js +2 -1
  296. package/dist/utility/wrun/wrun-trades-lane.util.d.ts +73 -0
  297. package/dist/utility/wrun/wrun-trades-lane.util.js +82 -0
  298. package/dist/utility/wrun/wrun-twin-compute-inputs.util.d.ts +5 -0
  299. package/dist/utility/wrun/wrun-twin-compute-inputs.util.js +9 -2
  300. package/dist/utility/wrun/wrun-visibility-table.d.ts +13 -0
  301. package/dist/utility/wrun/wrun-visibility-table.js +9 -0
  302. package/dist/utility/wrun/wrun-volume-profile.util.js +7 -3
  303. package/dist/utils/replay/replay-buffer-math.d.ts +16 -6
  304. package/dist/utils/replay/replay-buffer-math.js +60 -30
  305. package/dist/workers/constants/socket-slots.d.ts +11 -7
  306. package/dist/workers/constants/socket-slots.js +6 -5
  307. package/package.json +5 -5
@@ -1,21 +1,54 @@
1
- /** The profile family a row table belongs to: one footprint column per bar,
2
- * the TPO letters, or a session volume profile. */
1
+ /** The profile family a row table belongs to: one footprint column per bar, the TPO letters, or a session volume
2
+ * profile. */
3
3
  export type ProfileRowKind = 'footprint' | 'tpo' | 'session';
4
- /** The table label of an interval given in milliseconds: the registry's
5
- * label when the span is a known interval (a custom one folds to its
6
- * standard, the tuning rule), else the largest table label no longer than
7
- * the span. An unknown or non-positive span reads as '' (the tables'
8
- * fallback of 1). */
4
+ /** A TPO session period: the engine's words or the sheet's. A closed set, so a chart interval can never stand in. */
5
+ export type TpoPeriod = 'Daily' | 'Weekly' | 'Monthly' | 'day' | 'week' | 'month';
6
+ /** A control's TPO session type as a period, or undefined (a custom session, an unknown word). */
7
+ export declare function tpoPeriodOf(value: unknown): TpoPeriod | undefined;
8
+ /** The session volume profile's default: 10 blocks per row on every interval (the old 5m value, so a daily SVP on 5m
9
+ * is unchanged; weekly gold on Binance Futures = 10 x 0.3 = 3.0). */
10
+ export declare const SESSION_PROFILE_ROW_MULTIPLIER = 10;
11
+ /** The TPO default's base on every interval (the old 5m value), scaled by the session period below. */
12
+ export declare const TPO_PROFILE_ROW_BASE = 10;
13
+ /** The table label of an interval given in milliseconds: the registry's label when the span is a known interval (a
14
+ * custom one folds to its standard, the tuning rule), else the largest table label no longer than the span. An
15
+ * unknown or non-positive span reads as '' (the tables' fallback of 1). */
9
16
  export declare function profileRowIntervalLabel(interval: string | number): string;
10
17
  /**
11
- * The row multiplier behind a profile canvas's `row_height: "auto"` (the
12
- * native controls' `getBarsForInterval`): the kind's table at the chart
13
- * interval (a label, or a span in milliseconds), 1 for an interval outside
14
- * the table. A TPO period word (the engine's 'Daily' | 'Weekly' | 'Monthly',
15
- * or the sheet's 'day' | 'week' | 'month') scales the TPO base by the native
16
- * session multiplier, floored, exactly like the control.
18
+ * The default row multiplier of a fresh profile (the native controls' default, and a profile canvas's
19
+ * `row_height: "auto"` for a footprint):
20
+ * - `('footprint', interval)`: the footprint table at the chart interval (a label, or a span in milliseconds), 1 for
21
+ * an interval outside it;
22
+ * - `('session')`: SESSION_PROFILE_ROW_MULTIPLIER on every interval;
23
+ * - `('tpo', period)`: TPO_PROFILE_ROW_BASE scaled by the period (Daily 10, Weekly 15, Monthly 20), floored.
24
+ * The session and TPO forms take no interval on purpose (PROFILE-ROWS): the compiler refuses one.
17
25
  */
18
- export declare function profileRowMultiplier(kind: ProfileRowKind, interval: string | number, period?: string): number;
19
- /** The engine's TPO session word for a sheet period (`day` -> 'Daily'); an
20
- * engine word passes through unchanged. */
26
+ export declare function profileRowMultiplier(kind: 'footprint', interval: string | number): number;
27
+ export declare function profileRowMultiplier(kind: 'session'): number;
28
+ export declare function profileRowMultiplier(kind: 'tpo', period?: TpoPeriod): number;
29
+ /**
30
+ * The interval-keyed session / TPO tables, for the profiles whose window is the view rather than a session: the
31
+ * kScript profile canvases (`row_height: "auto"`, visible and range spans among them). They keep the old sizing until
32
+ * titan merges rows before its 10,000-row cap (PROFILE_MAX_VISIBLE_ROWS): a fixed fine grid there can blank a
33
+ * zoomed-out view (PROFILE-ROWS LEFT). Never a session profile's default: the class scan
34
+ * (tests/indicators/controls/profile-rows-one-size.class.spec.ts) refuses it in the native controls.
35
+ */
36
+ export declare function viewScaledProfileRowMultiplier(kind: 'session' | 'tpo', interval: string | number, period?: string): number;
37
+ /** A positive finite multiplier, or undefined. */
38
+ export declare function savedProfileRowMultiplier(value: unknown): number | undefined;
39
+ /** The row height of `multiplier` blocks, or undefined while the block is unknown (a pending block). */
40
+ export declare function profileRowHeight(minimumBarHeight: unknown, multiplier: number): number | undefined;
41
+ /**
42
+ * The patch a profile dialog writes when the user types "Ticks per row": the one row size for every interval, its
43
+ * row height on the current block, and the old per-interval memory emptied (`{}` reads as absent to the conflict
44
+ * classifier and the server echo, workspace-conflict-classify.util).
45
+ */
46
+ export declare function profileRowSizeEditPatch(modelValue: {
47
+ minimumBarHeight?: unknown;
48
+ }, multiplier: number): {
49
+ barHeightMultiplier: number;
50
+ barHeight?: number;
51
+ intervalBarHeights: Record<string, number>;
52
+ };
53
+ /** The engine's TPO session word for a sheet period (`day` -> 'Daily'); an engine word passes through unchanged. */
21
54
  export declare function tpoPeriodWord(period: string): string;
@@ -1,14 +1,30 @@
1
1
  /**
2
- * The row-height multiplier tables behind every profile canvas (WRUN-STYLE
3
- * g6 PT-footprint, PT-tpo, DL-time-anchored): the three `INTERVAL_TO_BARS`
4
- * tables moved verbatim out of the native controls (aggregated volume
5
- * footprint, TPO, session volume profile), which import them back through
6
- * their unchanged `getBarsForInterval` exports. A leaf: it imports the
7
- * interval registry only, so the wrun canvases never load a control module
8
- * (stores, workers, dialogs) to size a row.
2
+ * The row-height multipliers behind every profile canvas (WRUN-STYLE g6 PT-footprint, PT-tpo, DL-time-anchored), in
3
+ * multiples of the market's served block.
4
+ *
5
+ * PROFILE-ROWS (2026-11-03): a profile that spans many candles keeps ONE row size on every chart interval. Its point of
6
+ * control and value area are the busiest rows of its grid, so a grid that follows the interval moves them: one weekly
7
+ * gold profile showed seven POCs on seven intervals (S._Trades, #general). The session and TPO defaults therefore take
8
+ * no interval at all, and the rows draw at exactly that size at every zoom, thin on a zoomed-out view (Kyle
9
+ * 2026-11-03: no titan row merge, TradingView's Ticks Per Row; docs/features/indicators/profiles.md). A footprint is
10
+ * one candle's rows, so its default still follows the chart interval (TradingView's Auto row size does the same, from
11
+ * the ATR).
12
+ *
13
+ * A leaf: it imports the interval registry only, so the wrun canvases never load a control module (stores, workers,
14
+ * dialogs) to size a row.
9
15
  */
10
16
  import { intervalLabelForMs, intervalMs, standardIntervalAtOrBelow, standardIntervalMsAtOrBelow, } from './interval-ladder.util.js';
11
- /** The native footprint's table (aggregated-volume-footprint/index.ts). */
17
+ const TPO_PERIODS = new Set(['Daily', 'Weekly', 'Monthly', 'day', 'week', 'month']);
18
+ /** A control's TPO session type as a period, or undefined (a custom session, an unknown word). */
19
+ export function tpoPeriodOf(value) {
20
+ return typeof value === 'string' && TPO_PERIODS.has(value) ? value : undefined;
21
+ }
22
+ /** The session volume profile's default: 10 blocks per row on every interval (the old 5m value, so a daily SVP on 5m
23
+ * is unchanged; weekly gold on Binance Futures = 10 x 0.3 = 3.0). */
24
+ export const SESSION_PROFILE_ROW_MULTIPLIER = 10;
25
+ /** The TPO default's base on every interval (the old 5m value), scaled by the session period below. */
26
+ export const TPO_PROFILE_ROW_BASE = 10;
27
+ /** The native footprint's table (aggregated-volume-footprint/index.ts): a footprint row follows its candle. */
12
28
  const FOOTPRINT_INTERVAL_TO_BARS = {
13
29
  '1s': 1,
14
30
  '1m': 2,
@@ -20,8 +36,8 @@ const FOOTPRINT_INTERVAL_TO_BARS = {
20
36
  '1d': 50,
21
37
  '1w': 250,
22
38
  };
23
- /** The native TPO's table (time-price-opportunity/index.ts). */
24
- const TPO_INTERVAL_TO_BARS = {
39
+ /** The interval-keyed TPO table (time-price-opportunity before PROFILE-ROWS): only the view-scaled callers below. */
40
+ const VIEW_SCALED_TPO_INTERVAL_TO_BARS = {
25
41
  '1s': 1,
26
42
  '1m': 5,
27
43
  '5m': 10,
@@ -32,8 +48,8 @@ const TPO_INTERVAL_TO_BARS = {
32
48
  '1d': 50,
33
49
  '1w': 100,
34
50
  };
35
- /** The native session profile's table (session-volume-profile/index.ts). */
36
- const SESSION_INTERVAL_TO_BARS = {
51
+ /** The interval-keyed session table (session-volume-profile before PROFILE-ROWS): only the view-scaled callers. */
52
+ const VIEW_SCALED_SESSION_INTERVAL_TO_BARS = {
37
53
  '1s': 1,
38
54
  '1m': 5,
39
55
  '5m': 10,
@@ -44,25 +60,17 @@ const SESSION_INTERVAL_TO_BARS = {
44
60
  '1d': 100,
45
61
  '1w': 200,
46
62
  };
47
- /** The TPO period's multiplier over its interval base (the native TPO's
48
- * `SESSION_MULTIPLIERS`, keyed by the engine's session words). */
63
+ /** The TPO period's multiplier over its base (the native TPO's `SESSION_MULTIPLIERS`, keyed by the engine's words). */
49
64
  const TPO_PERIOD_MULTIPLIERS = {
50
65
  Daily: 1,
51
66
  Weekly: 1.5,
52
67
  Monthly: 2,
53
68
  };
54
- const ROW_TABLES = {
55
- footprint: FOOTPRINT_INTERVAL_TO_BARS,
56
- tpo: TPO_INTERVAL_TO_BARS,
57
- session: SESSION_INTERVAL_TO_BARS,
58
- };
59
69
  /** The tables' labels, ascending by span (the scan keeps the largest match). */
60
70
  const TABLE_LABELS = ['1s', '1m', '5m', '15m', '30m', '1h', '4h', '1d', '1w'];
61
- /** The table label of an interval given in milliseconds: the registry's
62
- * label when the span is a known interval (a custom one folds to its
63
- * standard, the tuning rule), else the largest table label no longer than
64
- * the span. An unknown or non-positive span reads as '' (the tables'
65
- * fallback of 1). */
71
+ /** The table label of an interval given in milliseconds: the registry's label when the span is a known interval (a
72
+ * custom one folds to its standard, the tuning rule), else the largest table label no longer than the span. An
73
+ * unknown or non-positive span reads as '' (the tables' fallback of 1). */
66
74
  export function profileRowIntervalLabel(interval) {
67
75
  if (typeof interval === 'string')
68
76
  return standardIntervalAtOrBelow(interval);
@@ -79,23 +87,52 @@ export function profileRowIntervalLabel(interval) {
79
87
  }
80
88
  return label;
81
89
  }
82
- /**
83
- * The row multiplier behind a profile canvas's `row_height: "auto"` (the
84
- * native controls' `getBarsForInterval`): the kind's table at the chart
85
- * interval (a label, or a span in milliseconds), 1 for an interval outside
86
- * the table. A TPO period word (the engine's 'Daily' | 'Weekly' | 'Monthly',
87
- * or the sheet's 'day' | 'week' | 'month') scales the TPO base by the native
88
- * session multiplier, floored, exactly like the control.
89
- */
90
- export function profileRowMultiplier(kind, interval, period) {
91
- const base = ROW_TABLES[kind][profileRowIntervalLabel(interval)] || 1;
92
- if (kind !== 'tpo' || !period)
90
+ function tpoPeriodScaled(base, period) {
91
+ if (!period)
93
92
  return base;
94
93
  const multiplier = TPO_PERIOD_MULTIPLIERS[tpoPeriodWord(period)] || 1;
95
94
  return Math.floor(base * multiplier);
96
95
  }
97
- /** The engine's TPO session word for a sheet period (`day` -> 'Daily'); an
98
- * engine word passes through unchanged. */
96
+ export function profileRowMultiplier(kind, arg) {
97
+ if (kind === 'footprint') {
98
+ return FOOTPRINT_INTERVAL_TO_BARS[profileRowIntervalLabel(arg ?? '')] || 1;
99
+ }
100
+ if (kind === 'session')
101
+ return SESSION_PROFILE_ROW_MULTIPLIER;
102
+ return tpoPeriodScaled(TPO_PROFILE_ROW_BASE, typeof arg === 'string' ? arg : undefined);
103
+ }
104
+ /**
105
+ * The interval-keyed session / TPO tables, for the profiles whose window is the view rather than a session: the
106
+ * kScript profile canvases (`row_height: "auto"`, visible and range spans among them). They keep the old sizing until
107
+ * titan merges rows before its 10,000-row cap (PROFILE_MAX_VISIBLE_ROWS): a fixed fine grid there can blank a
108
+ * zoomed-out view (PROFILE-ROWS LEFT). Never a session profile's default: the class scan
109
+ * (tests/indicators/controls/profile-rows-one-size.class.spec.ts) refuses it in the native controls.
110
+ */
111
+ export function viewScaledProfileRowMultiplier(kind, interval, period) {
112
+ if (kind === 'session')
113
+ return VIEW_SCALED_SESSION_INTERVAL_TO_BARS[profileRowIntervalLabel(interval)] || 1;
114
+ return tpoPeriodScaled(VIEW_SCALED_TPO_INTERVAL_TO_BARS[profileRowIntervalLabel(interval)] || 1, period);
115
+ }
116
+ /** A positive finite multiplier, or undefined. */
117
+ export function savedProfileRowMultiplier(value) {
118
+ return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : undefined;
119
+ }
120
+ /** The row height of `multiplier` blocks, or undefined while the block is unknown (a pending block). */
121
+ export function profileRowHeight(minimumBarHeight, multiplier) {
122
+ return typeof minimumBarHeight === 'number' && Number.isFinite(minimumBarHeight) && minimumBarHeight > 0
123
+ ? minimumBarHeight * multiplier
124
+ : undefined;
125
+ }
126
+ /**
127
+ * The patch a profile dialog writes when the user types "Ticks per row": the one row size for every interval, its
128
+ * row height on the current block, and the old per-interval memory emptied (`{}` reads as absent to the conflict
129
+ * classifier and the server echo, workspace-conflict-classify.util).
130
+ */
131
+ export function profileRowSizeEditPatch(modelValue, multiplier) {
132
+ const barHeight = profileRowHeight(modelValue.minimumBarHeight, multiplier);
133
+ return { barHeightMultiplier: multiplier, ...(barHeight === undefined ? {} : { barHeight }), intervalBarHeights: {} };
134
+ }
135
+ /** The engine's TPO session word for a sheet period (`day` -> 'Daily'); an engine word passes through unchanged. */
99
136
  export function tpoPeriodWord(period) {
100
137
  switch (period) {
101
138
  case 'day':
@@ -6,6 +6,8 @@ export interface RthWindow {
6
6
  /** RTH close, minutes after local midnight of the trading date. */
7
7
  closeMinutes: number;
8
8
  }
9
+ /** Every root with an RTH window, in table order: the trade-date class guard walks each one, so a new root is covered on arrival. */
10
+ export declare const RTH_MAPPED_ROOTS: readonly string[];
9
11
  /**
10
12
  * The RTH window of a CME-group exchange, the client mirror of tsdb-gateway
11
13
  * `SessionVenueGroupOf`: NYMEX serves the energy pit session, CME, CBOT and
@@ -179,6 +181,26 @@ export declare function footprintRthFoldFetchTfMs(chartTfMs: number): number;
179
181
  * its identity, its fetch interval is never overridden).
180
182
  */
181
183
  export declare function rthLiveMergeIntervalMs(ovType: unknown, chartTfMs: number): number;
184
+ /** One venue-local calendar day of a session window: its `[open, close)` edges and the day's own span. */
185
+ export interface SessionDayBounds {
186
+ openMs: number;
187
+ closeMs: number;
188
+ /** The venue-local calendar day this window belongs to, [dayStartMs, dayEndMs) in UTC ms. */
189
+ dayStartMs: number;
190
+ dayEndMs: number;
191
+ /** That day's weekday, 0 = Sunday. */
192
+ weekday: number;
193
+ /** That venue-local calendar date as its 00:00Z label, the key cme-trade-calendar.util reads; never the UTC date of an instant (23:30 New York is the next UTC date). */
194
+ calendarDayMs: number;
195
+ }
196
+ /**
197
+ * The venue-local calendar day holding `tsMs` on `window`, with that day's window edges: the per-window day memo
198
+ * every op in this module reads, open to a window of any market (market-session.util walks the US equities window
199
+ * on it). Calendar-based like the ops: Saturday and Sunday have bounds too, so a caller that needs a trading day
200
+ * checks `weekday` (or a trade calendar) itself. Null for a non-finite instant or a zone the runtime rejects. Pass a
201
+ * frozen window constant: an ad-hoc object misses the memo (correct, slower).
202
+ */
203
+ export declare function sessionDayBoundsFor(window: Readonly<RthWindow>, tsMs: number): Readonly<SessionDayBounds> | null;
182
204
  export interface SessionDayWindow {
183
205
  openMs: number;
184
206
  closeMs: number;
@@ -188,12 +210,13 @@ export interface SessionDayWindow {
188
210
  * `[fromMs, toMs]`, in order: the walk steps one calendar day at a time in
189
211
  * the window's zone (`rthDayBoundsFor`, so it is DST-exact on 23h/25h days)
190
212
  * and keeps a day whose close is after `fromMs` and whose open is before
191
- * `toMs`. Calendar-based like the other walks: Saturday, Sunday and holidays
192
- * have mathematical bounds too, which is harmless for consumers that shade
193
- * or gate BARS (no bar trades 09:30-16:15 New York on a weekend) and wrong
194
- * for anyone who would count the windows as trading days. Empty for an
195
- * inverted or non-finite span. Ad-hoc window objects miss the per-window
196
- * memo (correct, slower); pass the frozen module constants.
213
+ * `toMs`. Calendar-based like `nextRthSessionOpenMs`: Saturday, Sunday and
214
+ * holidays have mathematical bounds too, which is harmless for consumers that
215
+ * shade or gate BARS (no bar trades 09:30-16:15 New York on a weekend) and
216
+ * wrong for anyone who would count the windows as trading days (the session
217
+ * picks below read `isRthTradeDay` for that). Empty for an inverted or
218
+ * non-finite span. Ad-hoc window objects miss the per-window memo (correct,
219
+ * slower); pass the frozen module constants.
197
220
  */
198
221
  export declare function sessionWindowsInRange(window: Readonly<RthWindow>, fromMs: number, toMs: number): SessionDayWindow[];
199
222
  /**
@@ -289,20 +312,32 @@ export declare function latestRthSessionBoundsAtOrBefore(symbol: unknown, tsMs:
289
312
  closeMs: number;
290
313
  } | null;
291
314
  /**
292
- * The next RTH open strictly AFTER `tsMs` on the same memoized window: inside
293
- * a session it is tomorrow's open, after the close it is the next calendar
294
- * day's, before the open it is today's. NON-AUTHORITATIVE, a HINT only
295
- * (data-loading S6, the poll cadence's probe hint): the RthWindow is a
296
- * chart-side filter (a timezone plus open and close minutes), not a venue
297
- * schedule. It admits Saturday and holiday sessions exactly like
298
- * `latestRthSessionBoundsAtOrBefore` (every calendar day has mathematical
299
- * bounds), the RTH window (09:30 to 16:15 New York, 09:00 to 14:30 on NYMEX)
300
- * is not the Globex cycle, and it can neither prove a venue still closed nor
301
- * name the 17:00 CT
302
- * reopen. A caller may shorten a timer to it (one extra probe on a
303
- * non-trading day at worst); it must never skip a request, derive 'closed'
304
- * or resume a cadence from it. Null for an unmapped symbol or a non-finite
305
- * instant.
315
+ * The next RTH session open strictly AFTER `tsMs` on a CME trade date
316
+ * (`isRthTradeDay`, the rule `latestRthSessionBoundsAtOrBefore` reads): inside
317
+ * a session or after the close it is the next trade date's open, before the
318
+ * open it is today's when today trades; Friday after the close names Monday.
319
+ * NON-AUTHORITATIVE, a HINT only (data-loading S6, the poll cadence's probe
320
+ * hint): the RthWindow is a chart-side filter (a timezone plus open and close
321
+ * minutes), not a venue schedule. The RTH window (09:30 to 16:15 New York,
322
+ * 09:00 to 14:30 on NYMEX) is not the Globex cycle, an early-halt holiday
323
+ * trades a morning this skips, and it can neither prove a venue still closed
324
+ * nor name the 17:00 CT reopen. A caller may shorten a timer to it; it must
325
+ * never skip a request, derive 'closed' or resume a cadence from it. Null for
326
+ * an unmapped symbol or a non-finite instant.
327
+ */
328
+ export declare function nextRthTradeSessionOpenMs(symbol: unknown, tsMs: number): number | null;
329
+ /**
330
+ * The next calendar day's RTH window open strictly AFTER `tsMs` on the same
331
+ * memoized window: inside a session it is tomorrow's open, after the close it
332
+ * is the next calendar day's, before the open it is today's. Every calendar
333
+ * day counts (Saturday and holidays included) on purpose: this is the step of
334
+ * the BAR walks (live-bucket's off-session resume, wrun-leg-close's next bar),
335
+ * which keep a bar only where the product trades by its schedule, and an
336
+ * early-halt holiday morning or an always-on root's weekend holds RTH bars a
337
+ * trade-date step would skip. Never a session pick: those read
338
+ * `nextRthTradeSessionOpenMs` and `latestRthSessionBoundsAtOrBefore`. Steps
339
+ * 24 h, so a Saturday instant in the hour before the spring-forward midnight
340
+ * resolves Monday's open. Null for an unmapped symbol or a non-finite instant.
306
341
  */
307
342
  export declare function nextRthSessionOpenMs(symbol: unknown, tsMs: number): number | null;
308
343
  /**
@@ -17,28 +17,22 @@
17
17
  * Worker-safe by design: no Vue / store / i18n imports (workers filter fetched
18
18
  * rows through `isWithinRthWindow`, the live-feed service gates merges).
19
19
  *
20
- * The ROOT SET mirrors the engine's venue-sessions module
21
- * (`@orangecharts/kscript` `dist/kscript/venue-sessions.d.ts`) and the shared
22
- * host's venue layer (om `packages/sdk/src/wrun-host/session-facts-venues.ts`
23
- * `RTH_ROOT_EXCHANGES`, the same root to listing-exchange table): when a root
24
- * is added to one, add it to the others in the same wave. The published
25
- * engine package ships ONLY the .d.ts for that subpath (the implementation is
26
- * bundled and mangled inside `dist/kscript-engine.js` and not re-exported
27
- * from the main entry), so the runtime import cannot resolve; `futuresRootOf`
28
- * below is a verbatim mirror of the engine source. The WINDOWS follow the
29
- * wire, not the engine: the engine table (3.0.94) gives the NYMEX energy
30
- * roots the uniform 09:30-16:15 window, and that table is being retired, so it
31
- * binds nothing here. Every reader takes the root's own window from this
32
- * table: the chart's gates (`getRthWindowForSymbol`) and the script-facing
33
- * session facts (`engineRthWindowForSymbol`, wrun `time.session`), the energy
34
- * pit session on NYMEX included, and the shared host's venue layer reads the
35
- * same windows, so a browser run and a cloud run of one indicator agree.
20
+ * The ROOT SET mirrors the shared host's venue layer (om
21
+ * `packages/sdk/src/wrun-host/session-facts-venues.ts` `RTH_ROOT_EXCHANGES`,
22
+ * the same root to listing-exchange table): when a root is added to one, add
23
+ * it to the other in the same wave. The WINDOWS follow the wire: every reader
24
+ * takes the root's own window from this table, the chart's gates
25
+ * (`getRthWindowForSymbol`) and the script-facing session facts
26
+ * (`engineRthWindowForSymbol`, wrun `time.session`) alike, the energy pit
27
+ * session on NYMEX included, and the shared host's venue layer reads the same
28
+ * windows, so a browser run and a cloud run of one indicator agree.
36
29
  */
37
30
  import dayjs from 'dayjs';
38
31
  import timezone from 'dayjs/plugin/timezone.js';
39
32
  import utc from 'dayjs/plugin/utc.js';
40
33
  import { Intervals } from '../../constants/interval.constants.js';
41
34
  import { isCmeGoverned, normalizeExchangeCode } from './cme-realtime.util.js';
35
+ import { isCmeTradeDate } from './cme-trade-calendar.util.js';
42
36
  import { intervalLabelForMs, isSubMinuteInterval, standardIntervalMsAtOrBelow } from './interval-registry.util.js';
43
37
  // No reading here goes through dayjs any more; the plugins stay registered for importers that rely on it.
44
38
  dayjs.extend(utc);
@@ -142,6 +136,8 @@ const RTH_ROOT_EXCHANGES = {
142
136
  ZS: 'CBOT',
143
137
  ZL: 'CBOT',
144
138
  };
139
+ /** Every root with an RTH window, in table order: the trade-date class guard walks each one, so a new root is covered on arrival. */
140
+ export const RTH_MAPPED_ROOTS = Object.freeze(Object.keys(RTH_ROOT_EXCHANGES));
145
141
  /**
146
142
  * The RTH window of a CME-group exchange, the client mirror of tsdb-gateway
147
143
  * `SessionVenueGroupOf`: NYMEX serves the energy pit session, CME, CBOT and
@@ -544,6 +540,7 @@ function rthDayBoundsFor(window, tsMs) {
544
540
  dayStartMs: zoneWallToUtcMs(zone, wall.year, wall.month, wall.day, 0),
545
541
  dayEndMs: zoneWallToUtcMs(zone, next.getUTCFullYear(), next.getUTCMonth() + 1, next.getUTCDate(), 0),
546
542
  weekday: (next.getUTCDay() + 6) % 7,
543
+ calendarDayMs: Date.UTC(wall.year, wall.month - 1, wall.day),
547
544
  };
548
545
  }
549
546
  catch {
@@ -554,17 +551,39 @@ function rthDayBoundsFor(window, tsMs) {
554
551
  spans.length = RTH_DAY_SPANS_PER_WINDOW;
555
552
  return bounds;
556
553
  }
554
+ /**
555
+ * The venue-local calendar day holding `tsMs` on `window`, with that day's window edges: the per-window day memo
556
+ * every op in this module reads, open to a window of any market (market-session.util walks the US equities window
557
+ * on it). Calendar-based like the ops: Saturday and Sunday have bounds too, so a caller that needs a trading day
558
+ * checks `weekday` (or a trade calendar) itself. Null for a non-finite instant or a zone the runtime rejects. Pass a
559
+ * frozen window constant: an ad-hoc object misses the memo (correct, slower).
560
+ */
561
+ export function sessionDayBoundsFor(window, tsMs) {
562
+ if (!Number.isFinite(tsMs))
563
+ return null;
564
+ return rthDayBoundsFor(window, tsMs);
565
+ }
566
+ /**
567
+ * Whether a session pick may name this venue day: its date is a CME trade date (every mapped root is CME-family; a
568
+ * weekend or rule holiday books its trading to the next date, as wrun `time.session` reads), so a pick never names a
569
+ * window the venue left empty. Membership and the bar walks keep every calendar day: the gateway's REGULAR filter is
570
+ * a wall clock, so an early-halt holiday morning and an always-on root's weekend still hold RTH bars.
571
+ */
572
+ function isRthTradeDay(bounds) {
573
+ return isCmeTradeDate(bounds.calendarDayMs);
574
+ }
557
575
  /**
558
576
  * Every venue-local calendar day's `[open, close)` window that touches
559
577
  * `[fromMs, toMs]`, in order: the walk steps one calendar day at a time in
560
578
  * the window's zone (`rthDayBoundsFor`, so it is DST-exact on 23h/25h days)
561
579
  * and keeps a day whose close is after `fromMs` and whose open is before
562
- * `toMs`. Calendar-based like the other walks: Saturday, Sunday and holidays
563
- * have mathematical bounds too, which is harmless for consumers that shade
564
- * or gate BARS (no bar trades 09:30-16:15 New York on a weekend) and wrong
565
- * for anyone who would count the windows as trading days. Empty for an
566
- * inverted or non-finite span. Ad-hoc window objects miss the per-window
567
- * memo (correct, slower); pass the frozen module constants.
580
+ * `toMs`. Calendar-based like `nextRthSessionOpenMs`: Saturday, Sunday and
581
+ * holidays have mathematical bounds too, which is harmless for consumers that
582
+ * shade or gate BARS (no bar trades 09:30-16:15 New York on a weekend) and
583
+ * wrong for anyone who would count the windows as trading days (the session
584
+ * picks below read `isRthTradeDay` for that). Empty for an inverted or
585
+ * non-finite span. Ad-hoc window objects miss the per-window memo (correct,
586
+ * slower); pass the frozen module constants.
568
587
  */
569
588
  export function sessionWindowsInRange(window, fromMs, toMs) {
570
589
  const windows = [];
@@ -760,13 +779,12 @@ export function rthAnchoredBucketEndMs(symbol, bucketStartMs, tfMs) {
760
779
  * "which session am I in" (null out of session); this answers "which session
761
780
  * did I most recently enter" — the primitive a session-anchored profile needs
762
781
  * to show the last completed session outside trading hours. Walks venue-local
763
- * calendar days backward (bounded) so a post-close Friday timestamp or a
764
- * weekend one resolves Friday's window. NOTE: the walk is calendar-based; a
765
- * calendar day with no trading (Saturday, holidays) still has mathematical
766
- * bounds, so DATA-aware callers must fall back a day when the returned window
767
- * turns out empty (dsp-session-window.util's deriveDspWindow is that guard).
768
- * Additive to the kscript venue-sessions mirror; not part of the mirrored
769
- * surface.
782
+ * calendar days backward (bounded) and names only a CME trade date
783
+ * (`isRthTradeDay`): a weekend or Monday pre-open timestamp resolves Friday's
784
+ * window, the Friday after Thanksgiving before the open Wednesday's. A trade
785
+ * date can still hold no rows for a thin contract, so DATA-aware callers keep
786
+ * their own skip (dsp-session-window.util's deriveDspWindow). Additive to the
787
+ * kscript venue-sessions mirror; not part of the mirrored surface.
770
788
  */
771
789
  const LATEST_RTH_LOOKBACK_DAYS = 7;
772
790
  export function latestRthSessionBoundsAtOrBefore(symbol, tsMs) {
@@ -775,30 +793,60 @@ export function latestRthSessionBoundsAtOrBefore(symbol, tsMs) {
775
793
  return null;
776
794
  if (!Number.isFinite(tsMs))
777
795
  return null;
778
- for (let daysBack = 0; daysBack <= LATEST_RTH_LOOKBACK_DAYS; daysBack++) {
779
- const bounds = rthDayBoundsFor(window, tsMs - daysBack * 24 * 60 * 60 * 1000);
796
+ let cursorMs = tsMs;
797
+ for (let day = 0; day <= LATEST_RTH_LOOKBACK_DAYS; day++) {
798
+ const bounds = rthDayBoundsFor(window, cursorMs);
780
799
  if (!bounds)
781
800
  return null;
782
- if (bounds.openMs <= tsMs)
801
+ if (bounds.openMs <= tsMs && isRthTradeDay(bounds))
783
802
  return { openMs: bounds.openMs, closeMs: bounds.closeMs };
803
+ cursorMs = bounds.dayStartMs - 1;
804
+ }
805
+ return null;
806
+ }
807
+ /**
808
+ * The next RTH session open strictly AFTER `tsMs` on a CME trade date
809
+ * (`isRthTradeDay`, the rule `latestRthSessionBoundsAtOrBefore` reads): inside
810
+ * a session or after the close it is the next trade date's open, before the
811
+ * open it is today's when today trades; Friday after the close names Monday.
812
+ * NON-AUTHORITATIVE, a HINT only (data-loading S6, the poll cadence's probe
813
+ * hint): the RthWindow is a chart-side filter (a timezone plus open and close
814
+ * minutes), not a venue schedule. The RTH window (09:30 to 16:15 New York,
815
+ * 09:00 to 14:30 on NYMEX) is not the Globex cycle, an early-halt holiday
816
+ * trades a morning this skips, and it can neither prove a venue still closed
817
+ * nor name the 17:00 CT reopen. A caller may shorten a timer to it; it must
818
+ * never skip a request, derive 'closed' or resume a cadence from it. Null for
819
+ * an unmapped symbol or a non-finite instant.
820
+ */
821
+ export function nextRthTradeSessionOpenMs(symbol, tsMs) {
822
+ const window = getRthWindowForSymbol(symbol);
823
+ if (!window)
824
+ return null;
825
+ if (!Number.isFinite(tsMs))
826
+ return null;
827
+ let cursorMs = tsMs;
828
+ for (let day = 0; day <= LATEST_RTH_LOOKBACK_DAYS; day++) {
829
+ const bounds = rthDayBoundsFor(window, cursorMs);
830
+ if (!bounds)
831
+ return null;
832
+ if (bounds.openMs > tsMs && isRthTradeDay(bounds))
833
+ return bounds.openMs;
834
+ cursorMs = bounds.dayEndMs;
784
835
  }
785
836
  return null;
786
837
  }
787
838
  /**
788
- * The next RTH open strictly AFTER `tsMs` on the same memoized window: inside
789
- * a session it is tomorrow's open, after the close it is the next calendar
790
- * day's, before the open it is today's. NON-AUTHORITATIVE, a HINT only
791
- * (data-loading S6, the poll cadence's probe hint): the RthWindow is a
792
- * chart-side filter (a timezone plus open and close minutes), not a venue
793
- * schedule. It admits Saturday and holiday sessions exactly like
794
- * `latestRthSessionBoundsAtOrBefore` (every calendar day has mathematical
795
- * bounds), the RTH window (09:30 to 16:15 New York, 09:00 to 14:30 on NYMEX)
796
- * is not the Globex cycle, and it can neither prove a venue still closed nor
797
- * name the 17:00 CT
798
- * reopen. A caller may shorten a timer to it (one extra probe on a
799
- * non-trading day at worst); it must never skip a request, derive 'closed'
800
- * or resume a cadence from it. Null for an unmapped symbol or a non-finite
801
- * instant.
839
+ * The next calendar day's RTH window open strictly AFTER `tsMs` on the same
840
+ * memoized window: inside a session it is tomorrow's open, after the close it
841
+ * is the next calendar day's, before the open it is today's. Every calendar
842
+ * day counts (Saturday and holidays included) on purpose: this is the step of
843
+ * the BAR walks (live-bucket's off-session resume, wrun-leg-close's next bar),
844
+ * which keep a bar only where the product trades by its schedule, and an
845
+ * early-halt holiday morning or an always-on root's weekend holds RTH bars a
846
+ * trade-date step would skip. Never a session pick: those read
847
+ * `nextRthTradeSessionOpenMs` and `latestRthSessionBoundsAtOrBefore`. Steps
848
+ * 24 h, so a Saturday instant in the hour before the spring-forward midnight
849
+ * resolves Monday's open. Null for an unmapped symbol or a non-finite instant.
802
850
  */
803
851
  export function nextRthSessionOpenMs(symbol, tsMs) {
804
852
  const window = getRthWindowForSymbol(symbol);