@orangecharts/wrun-chart-host 0.4.0 → 0.5.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 (322) hide show
  1. package/README.md +15 -4
  2. package/dist/constants/exchange-names.leaf.d.ts +8 -0
  3. package/dist/constants/exchange-names.leaf.js +101 -0
  4. package/dist/constants/kscript-data-interval-restrictions.constants.d.ts +15 -0
  5. package/dist/constants/kscript-data-interval-restrictions.constants.js +40 -0
  6. package/dist/constants/opra-compliance.constants.d.ts +19 -0
  7. package/dist/constants/opra-compliance.constants.js +19 -0
  8. package/dist/constants/replay-ladder.leaf.d.ts +30 -0
  9. package/dist/constants/replay-ladder.leaf.js +99 -0
  10. package/dist/constants/scriptEditor/cme-official-scripts.constants.d.ts +168 -0
  11. package/dist/constants/scriptEditor/cme-official-scripts.constants.js +398 -0
  12. package/dist/constants/scriptEditor/converted-script-id.leaf.d.ts +8 -0
  13. package/dist/constants/scriptEditor/converted-script-id.leaf.js +10 -0
  14. package/dist/constants/scriptEditor/execution.constants.d.ts +4 -0
  15. package/dist/constants/scriptEditor/execution.constants.js +14 -0
  16. package/dist/constants/wrun-prefix-safe.constants.d.ts +23 -0
  17. package/dist/constants/wrun-prefix-safe.constants.js +26 -0
  18. package/dist/host-env.d.ts +313 -18
  19. package/dist/host-env.js +15 -0
  20. package/dist/host-ports.types.d.ts +853 -16
  21. package/dist/index.d.ts +139 -2
  22. package/dist/index.js +139 -2
  23. package/dist/instances/script-engine-worker-ohlcv-transfer.d.ts +31 -0
  24. package/dist/instances/script-engine-worker-ohlcv-transfer.js +164 -0
  25. package/dist/interfaces/market-event.interface.d.ts +231 -0
  26. package/dist/interfaces/market-event.interface.js +15 -0
  27. package/dist/interfaces/opra-realtime.interface.d.ts +70 -134
  28. package/dist/interfaces/opra-realtime.interface.js +34 -59
  29. package/dist/interfaces/replay.interface.d.ts +285 -0
  30. package/dist/interfaces/replay.interface.js +1 -0
  31. package/dist/kscript-data/controls/live-ohlcv-merge.util.d.ts +1 -0
  32. package/dist/kscript-data/controls/live-ohlcv-merge.util.js +93 -0
  33. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +5 -1
  34. package/dist/kscript-data/controls/live-trades-merge.util.js +2 -2
  35. package/dist/market-data/billing.interface.d.ts +219 -0
  36. package/dist/market-data/billing.interface.js +58 -0
  37. package/dist/market-data/venue-governed.util.d.ts +2 -0
  38. package/dist/market-data/venue-governed.util.js +10 -0
  39. package/dist/market-data/venue.d.ts +122 -0
  40. package/dist/market-data/venue.js +1 -0
  41. package/dist/market-data/venues/index.d.ts +97 -0
  42. package/dist/market-data/venues/index.js +33 -0
  43. package/dist/market-data/venues/opra.contract.copy.json +35 -0
  44. package/dist/market-data/venues/opra.d.ts +70 -0
  45. package/dist/market-data/venues/opra.js +74 -0
  46. package/dist/replay/replayIndicatorRows.d.ts +31 -0
  47. package/dist/replay/replayIndicatorRows.js +117 -0
  48. package/dist/replay/replayLadder.d.ts +85 -0
  49. package/dist/replay/replayLadder.js +388 -0
  50. package/dist/utility/auth/server-clock.util.d.ts +81 -0
  51. package/dist/utility/auth/server-clock.util.js +238 -0
  52. package/dist/utility/chart/builtin-identity.util.d.ts +18 -0
  53. package/dist/utility/chart/builtin-identity.util.js +51 -0
  54. package/dist/utility/chart/cache-alignment.util.d.ts +454 -0
  55. package/dist/utility/chart/cache-alignment.util.js +926 -0
  56. package/dist/utility/chart/chart-data-fetch-generation.util.d.ts +15 -0
  57. package/dist/utility/chart/chart-data-fetch-generation.util.js +22 -0
  58. package/dist/utility/chart/chart-mount-epoch.util.d.ts +5 -0
  59. package/dist/utility/chart/chart-mount-epoch.util.js +29 -0
  60. package/dist/utility/chart/chart-time-domain.util.d.ts +12 -0
  61. package/dist/utility/chart/chart-time-domain.util.js +23 -0
  62. package/dist/utility/chart/color-customization.leaf.d.ts +10 -0
  63. package/dist/utility/chart/color-customization.leaf.js +16 -0
  64. package/dist/utility/chart/footprint-tick-grid.util.d.ts +106 -0
  65. package/dist/utility/chart/footprint-tick-grid.util.js +167 -0
  66. package/dist/utility/chart/gesture-timing.leaf.d.ts +29 -0
  67. package/dist/utility/chart/gesture-timing.leaf.js +29 -0
  68. package/dist/utility/chart/governed-contract-coin.util.d.ts +22 -0
  69. package/dist/utility/chart/governed-contract-coin.util.js +39 -0
  70. package/dist/utility/chart/host-bar-placement.util.d.ts +107 -0
  71. package/dist/utility/chart/host-bar-placement.util.js +447 -0
  72. package/dist/utility/chart/index-host-tier.util.d.ts +31 -0
  73. package/dist/utility/chart/index-host-tier.util.js +118 -0
  74. package/dist/utility/chart/index-mode-admission.util.d.ts +34 -0
  75. package/dist/utility/chart/index-mode-admission.util.js +67 -0
  76. package/dist/utility/chart/indicator-error-message.util.d.ts +35 -0
  77. package/dist/utility/chart/indicator-error-message.util.js +44 -0
  78. package/dist/utility/chart/kscript-apply-fingerprint.util.d.ts +65 -0
  79. package/dist/utility/chart/kscript-apply-fingerprint.util.js +357 -0
  80. package/dist/utility/chart/kscript-chart-flush.leaf.d.ts +22 -0
  81. package/dist/utility/chart/kscript-chart-flush.leaf.js +13 -0
  82. package/dist/utility/chart/kscript-data-interval-restriction.leaf.d.ts +6 -0
  83. package/dist/utility/chart/kscript-data-interval-restriction.leaf.js +27 -0
  84. package/dist/utility/chart/kscript-integration-decision.leaf.d.ts +89 -0
  85. package/dist/utility/chart/kscript-integration-decision.leaf.js +80 -0
  86. package/dist/utility/chart/kscript-live-coalesce.util.d.ts +76 -0
  87. package/dist/utility/chart/kscript-live-coalesce.util.js +156 -0
  88. package/dist/utility/chart/kscript-live-rest-pace.util.d.ts +34 -0
  89. package/dist/utility/chart/kscript-live-rest-pace.util.js +134 -0
  90. package/dist/utility/chart/kscript-live-source-identity.util.d.ts +98 -0
  91. package/dist/utility/chart/kscript-live-source-identity.util.js +121 -0
  92. package/dist/utility/chart/kscript-mounted-plot-set.leaf.d.ts +48 -0
  93. package/dist/utility/chart/kscript-mounted-plot-set.leaf.js +145 -0
  94. package/dist/utility/chart/kscript-perf-tracker.util.d.ts +243 -0
  95. package/dist/utility/chart/kscript-perf-tracker.util.js +522 -0
  96. package/dist/utility/chart/kscript-run-interval-projection.util.d.ts +43 -0
  97. package/dist/utility/chart/kscript-run-interval-projection.util.js +471 -0
  98. package/dist/utility/chart/kscript-run-result-equality.util.d.ts +38 -0
  99. package/dist/utility/chart/kscript-run-result-equality.util.js +89 -0
  100. package/dist/utility/chart/kscript-settings-revision.leaf.d.ts +2 -0
  101. package/dist/utility/chart/kscript-settings-revision.leaf.js +12 -0
  102. package/dist/utility/chart/kscript-source-degrade.leaf.d.ts +63 -0
  103. package/dist/utility/chart/kscript-source-degrade.leaf.js +68 -0
  104. package/dist/utility/chart/kscript-source-retention.util.d.ts +134 -0
  105. package/dist/utility/chart/kscript-source-retention.util.js +218 -0
  106. package/dist/utility/chart/kscript-standin-identity.leaf.d.ts +57 -0
  107. package/dist/utility/chart/kscript-standin-identity.leaf.js +61 -0
  108. package/dist/utility/chart/kscript-titancharts-preparation.util.d.ts +15 -0
  109. package/dist/utility/chart/kscript-titancharts-preparation.util.js +376 -0
  110. package/dist/utility/chart/kscript-titancharts-render-keys.constants.d.ts +9 -0
  111. package/dist/utility/chart/kscript-titancharts-render-keys.constants.js +130 -0
  112. package/dist/utility/chart/kscript-venue-policy.util.d.ts +217 -0
  113. package/dist/utility/chart/kscript-venue-policy.util.js +324 -0
  114. package/dist/utility/chart/live-cadence.util.d.ts +38 -0
  115. package/dist/utility/chart/live-cadence.util.js +37 -0
  116. package/dist/utility/chart/live-feed-series-match.leaf.d.ts +13 -0
  117. package/dist/utility/chart/live-feed-series-match.leaf.js +21 -0
  118. package/dist/utility/chart/local-engine-self-heal-backoff.util.d.ts +46 -0
  119. package/dist/utility/chart/local-engine-self-heal-backoff.util.js +46 -0
  120. package/dist/utility/chart/local-engine-uninit.leaf.d.ts +21 -0
  121. package/dist/utility/chart/local-engine-uninit.leaf.js +22 -0
  122. package/dist/utility/chart/local-kscript-source-revalidation.util.d.ts +62 -0
  123. package/dist/utility/chart/local-kscript-source-revalidation.util.js +123 -0
  124. package/dist/utility/chart/local-kscript-warmup-depth.util.d.ts +214 -0
  125. package/dist/utility/chart/local-kscript-warmup-depth.util.js +376 -0
  126. package/dist/utility/chart/local-technical-script-live-apply-coalescer.util.d.ts +85 -0
  127. package/dist/utility/chart/local-technical-script-live-apply-coalescer.util.js +197 -0
  128. package/dist/utility/chart/local-technical-script-range.leaf.d.ts +72 -0
  129. package/dist/utility/chart/local-technical-script-range.leaf.js +126 -0
  130. package/dist/utility/chart/mixed-mode.util.d.ts +167 -0
  131. package/dist/utility/chart/mixed-mode.util.js +139 -0
  132. package/dist/utility/chart/ohlcv-row-readiness.util.d.ts +36 -0
  133. package/dist/utility/chart/ohlcv-row-readiness.util.js +90 -0
  134. package/dist/utility/chart/opra-user-scripts-gate.util.d.ts +19 -0
  135. package/dist/utility/chart/opra-user-scripts-gate.util.js +32 -0
  136. package/dist/utility/chart/overlay-execution-guard-key.leaf.d.ts +8 -0
  137. package/dist/utility/chart/overlay-execution-guard-key.leaf.js +10 -0
  138. package/dist/utility/chart/price-precision.util.d.ts +40 -0
  139. package/dist/utility/chart/price-precision.util.js +70 -0
  140. package/dist/utility/chart/profile-block-size.util.d.ts +64 -0
  141. package/dist/utility/chart/profile-block-size.util.js +141 -0
  142. package/dist/utility/chart/protected-kscript-degenerate-rows.leaf.d.ts +11 -0
  143. package/dist/utility/chart/protected-kscript-degenerate-rows.leaf.js +29 -0
  144. package/dist/utility/chart/protected-kscript-empty-output.util.d.ts +28 -0
  145. package/dist/utility/chart/protected-kscript-empty-output.util.js +84 -0
  146. package/dist/utility/chart/run-interval-unservable.leaf.d.ts +9 -0
  147. package/dist/utility/chart/run-interval-unservable.leaf.js +20 -0
  148. package/dist/utility/chart/run-interval-warmup.leaf.d.ts +19 -0
  149. package/dist/utility/chart/run-interval-warmup.leaf.js +35 -0
  150. package/dist/utility/chart/titan-constants.pin.d.ts +9 -5
  151. package/dist/utility/chart/titan-constants.pin.js +18 -5
  152. package/dist/utility/chart/warmup-backfill-retry.leaf.d.ts +9 -0
  153. package/dist/utility/chart/warmup-backfill-retry.leaf.js +9 -0
  154. package/dist/utility/chart/wrun-bar-session-facts.util.d.ts +11 -2
  155. package/dist/utility/chart/wrun-bar-session-facts.util.js +10 -3
  156. package/dist/utility/chart/wrun-run-result.util.d.ts +5 -1
  157. package/dist/utility/chart/wrun-run-result.util.js +20 -14
  158. package/dist/utility/common/data-processing.util.d.ts +138 -0
  159. package/dist/utility/common/data-processing.util.js +346 -0
  160. package/dist/utility/common/visible-timeout.util.d.ts +13 -4
  161. package/dist/utility/common/visible-timeout.util.js +23 -8
  162. package/dist/utility/exchange-format.leaf.d.ts +1 -0
  163. package/dist/utility/exchange-format.leaf.js +47 -0
  164. package/dist/utility/market-events/earnings-scope.util.d.ts +60 -0
  165. package/dist/utility/market-events/earnings-scope.util.js +92 -0
  166. package/dist/utility/market-events/market-events.util.d.ts +147 -0
  167. package/dist/utility/market-events/market-events.util.js +392 -0
  168. package/dist/utility/market-events/zoned-clock.util.d.ts +1 -0
  169. package/dist/utility/market-events/zoned-clock.util.js +11 -0
  170. package/dist/utility/options/option-venue-disclosure.util.d.ts +43 -0
  171. package/dist/utility/options/option-venue-disclosure.util.js +56 -0
  172. package/dist/utility/scriptEditor/package-semver.util.d.ts +51 -0
  173. package/dist/utility/scriptEditor/package-semver.util.js +120 -0
  174. package/dist/utility/scriptEditor/temp-script-id.util.d.ts +18 -0
  175. package/dist/utility/scriptEditor/temp-script-id.util.js +25 -0
  176. package/dist/utility/symbol-selection/markets-request-from-symbols.leaf.d.ts +20 -0
  177. package/dist/utility/symbol-selection/markets-request-from-symbols.leaf.js +81 -0
  178. package/dist/utility/v2/governed-tier.leaf.d.ts +103 -0
  179. package/dist/utility/v2/governed-tier.leaf.js +113 -0
  180. package/dist/utility/watchlist/import/import-request.leaf.d.ts +10 -0
  181. package/dist/utility/watchlist/import/import-request.leaf.js +10 -0
  182. package/dist/utility/wrun/sources/lanes/series.js +2 -2
  183. package/dist/utility/wrun/sources/row-lanes/option_contract_state.d.ts +4 -4
  184. package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +5 -6
  185. package/dist/utility/wrun/wrun-alert-outputs.registry.d.ts +166 -0
  186. package/dist/utility/wrun/wrun-alert-outputs.registry.js +219 -0
  187. package/dist/utility/wrun/wrun-bar-count.util.d.ts +83 -0
  188. package/dist/utility/wrun/wrun-bar-count.util.js +259 -0
  189. package/dist/utility/wrun/wrun-chart-context-names.util.d.ts +84 -0
  190. package/dist/utility/wrun/wrun-chart-context-names.util.js +186 -0
  191. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +253 -0
  192. package/dist/utility/wrun/wrun-chart-market-facts.util.js +731 -0
  193. package/dist/utility/wrun/wrun-cloud-opra-stamp.util.d.ts +28 -0
  194. package/dist/utility/wrun/wrun-cloud-opra-stamp.util.js +45 -0
  195. package/dist/utility/wrun/wrun-coin-lane-live.util.d.ts +18 -0
  196. package/dist/utility/wrun/wrun-coin-lane-live.util.js +47 -0
  197. package/dist/utility/wrun/wrun-deadline.util.js +2 -1
  198. package/dist/utility/wrun/wrun-debug-output.util.d.ts +39 -0
  199. package/dist/utility/wrun/wrun-debug-output.util.js +63 -0
  200. package/dist/utility/wrun/wrun-declared-warmup.util.d.ts +113 -0
  201. package/dist/utility/wrun/wrun-declared-warmup.util.js +181 -0
  202. package/dist/utility/wrun/wrun-draft-legend-note.util.d.ts +43 -0
  203. package/dist/utility/wrun/wrun-draft-legend-note.util.js +158 -0
  204. package/dist/utility/wrun/wrun-draft-overlay.util.d.ts +181 -0
  205. package/dist/utility/wrun/wrun-draft-overlay.util.js +357 -0
  206. package/dist/utility/wrun/wrun-draw-skipped.leaf.d.ts +16 -0
  207. package/dist/utility/wrun/wrun-draw-skipped.leaf.js +16 -0
  208. package/dist/utility/wrun/wrun-earnings-facts.util.d.ts +42 -0
  209. package/dist/utility/wrun/wrun-earnings-facts.util.js +131 -0
  210. package/dist/utility/wrun/wrun-first-run-depth.util.d.ts +32 -0
  211. package/dist/utility/wrun/wrun-first-run-depth.util.js +118 -0
  212. package/dist/utility/wrun/wrun-gate-plane-readers.util.d.ts +24 -0
  213. package/dist/utility/wrun/wrun-gate-plane-readers.util.js +31 -0
  214. package/dist/utility/wrun/wrun-held-lanes.util.d.ts +32 -0
  215. package/dist/utility/wrun/wrun-held-lanes.util.js +94 -0
  216. package/dist/utility/wrun/wrun-host-visible-clock.util.d.ts +2 -0
  217. package/dist/utility/wrun/wrun-host-visible-clock.util.js +17 -0
  218. package/dist/utility/wrun/wrun-host.service.d.ts +266 -0
  219. package/dist/utility/wrun/wrun-host.service.js +655 -0
  220. package/dist/utility/wrun/wrun-inert-legend.util.d.ts +33 -0
  221. package/dist/utility/wrun/wrun-inert-legend.util.js +125 -0
  222. package/dist/utility/wrun/wrun-input-requirements.leaf.d.ts +155 -0
  223. package/dist/utility/wrun/wrun-input-requirements.leaf.js +450 -0
  224. package/dist/utility/wrun/wrun-integration-route.util.d.ts +51 -0
  225. package/dist/utility/wrun/wrun-integration-route.util.js +59 -0
  226. package/dist/utility/wrun/wrun-latest-history.leaf.d.ts +8 -0
  227. package/dist/utility/wrun/wrun-latest-history.leaf.js +8 -0
  228. package/dist/utility/wrun/wrun-legend-hover.lazy.d.ts +12 -0
  229. package/dist/utility/wrun/wrun-legend-hover.lazy.js +96 -0
  230. package/dist/utility/wrun/wrun-lifecycle-runtime.util.d.ts +21 -0
  231. package/dist/utility/wrun/wrun-lifecycle-runtime.util.js +21 -0
  232. package/dist/utility/wrun/wrun-live-hidden-hold.util.d.ts +23 -0
  233. package/dist/utility/wrun/wrun-live-hidden-hold.util.js +13 -0
  234. package/dist/utility/wrun/wrun-live-intake.util.d.ts +374 -0
  235. package/dist/utility/wrun/wrun-live-intake.util.js +2027 -0
  236. package/dist/utility/wrun/wrun-live-patch.util.d.ts +116 -0
  237. package/dist/utility/wrun/wrun-live-patch.util.js +523 -0
  238. package/dist/utility/wrun/wrun-live-tick.util.d.ts +619 -0
  239. package/dist/utility/wrun/wrun-live-tick.util.js +4974 -0
  240. package/dist/utility/wrun/wrun-loading-owner.util.d.ts +58 -0
  241. package/dist/utility/wrun/wrun-loading-owner.util.js +89 -0
  242. package/dist/utility/wrun/wrun-official-scope.leaf.d.ts +29 -0
  243. package/dist/utility/wrun/wrun-official-scope.leaf.js +36 -0
  244. package/dist/utility/wrun/wrun-oi-lane.util.d.ts +27 -0
  245. package/dist/utility/wrun/wrun-oi-lane.util.js +42 -0
  246. package/dist/utility/wrun/wrun-options-stop.util.d.ts +52 -0
  247. package/dist/utility/wrun/wrun-options-stop.util.js +123 -0
  248. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +719 -0
  249. package/dist/utility/wrun/wrun-overlay-drivers.util.js +1180 -0
  250. package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.d.ts +50 -0
  251. package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.js +131 -0
  252. package/dist/utility/wrun/wrun-overlay-lifecycle.util.d.ts +118 -0
  253. package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +466 -0
  254. package/dist/utility/wrun/wrun-overlay-metadata.util.d.ts +45 -0
  255. package/dist/utility/wrun/wrun-overlay-metadata.util.js +112 -0
  256. package/dist/utility/wrun/wrun-overlay-recovery.util.d.ts +114 -0
  257. package/dist/utility/wrun/wrun-overlay-recovery.util.js +971 -0
  258. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +858 -0
  259. package/dist/utility/wrun/wrun-overlay-run.util.js +11013 -0
  260. package/dist/utility/wrun/wrun-panel-mount.util.d.ts +24 -9
  261. package/dist/utility/wrun/wrun-panel-mount.util.js +138 -43
  262. package/dist/utility/wrun/wrun-param-map.util.d.ts +19 -4
  263. package/dist/utility/wrun/wrun-param-map.util.js +40 -47
  264. package/dist/utility/wrun/wrun-param-values.util.d.ts +9 -3
  265. package/dist/utility/wrun/wrun-param-values.util.js +5 -5
  266. package/dist/utility/wrun/wrun-prefix-cohort.util.d.ts +93 -0
  267. package/dist/utility/wrun/wrun-prefix-cohort.util.js +484 -0
  268. package/dist/utility/wrun/wrun-prefix-lanes.util.d.ts +114 -0
  269. package/dist/utility/wrun/wrun-prefix-lanes.util.js +486 -0
  270. package/dist/utility/wrun/wrun-prefix-proof.util.d.ts +317 -0
  271. package/dist/utility/wrun/wrun-prefix-proof.util.js +630 -0
  272. package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +73 -0
  273. package/dist/utility/wrun/wrun-refusal-surface.util.js +380 -0
  274. package/dist/utility/wrun/wrun-refusal-text.util.d.ts +15 -0
  275. package/dist/utility/wrun/wrun-refusal-text.util.js +40 -0
  276. package/dist/utility/wrun/wrun-replay-lane.util.d.ts +139 -0
  277. package/dist/utility/wrun/wrun-replay-lane.util.js +520 -0
  278. package/dist/utility/wrun/wrun-replay-rows.util.d.ts +21 -0
  279. package/dist/utility/wrun/wrun-replay-rows.util.js +172 -0
  280. package/dist/utility/wrun/wrun-row-source-factory.d.ts +53 -0
  281. package/dist/utility/wrun/wrun-row-source-factory.js +435 -0
  282. package/dist/utility/wrun/wrun-run-cells.util.d.ts +36 -0
  283. package/dist/utility/wrun/wrun-run-cells.util.js +46 -0
  284. package/dist/utility/wrun/wrun-run-interval-session.util.d.ts +133 -0
  285. package/dist/utility/wrun/wrun-run-interval-session.util.js +121 -0
  286. package/dist/utility/wrun/wrun-run-interval.util.d.ts +98 -0
  287. package/dist/utility/wrun/wrun-run-interval.util.js +207 -0
  288. package/dist/utility/wrun/wrun-run-retained.util.d.ts +122 -0
  289. package/dist/utility/wrun/wrun-run-retained.util.js +255 -0
  290. package/dist/utility/wrun/wrun-sandbox-row-source.d.ts +184 -0
  291. package/dist/utility/wrun/wrun-sandbox-row-source.js +444 -0
  292. package/dist/utility/wrun/wrun-script-inputs.util.js +4 -4
  293. package/dist/utility/wrun/wrun-series-stream.util.d.ts +86 -0
  294. package/dist/utility/wrun/wrun-series-stream.util.js +537 -0
  295. package/dist/utility/wrun/wrun-sheet-remembered.util.d.ts +21 -0
  296. package/dist/utility/wrun/wrun-sheet-remembered.util.js +36 -0
  297. package/dist/utility/wrun/wrun-signal-sound-reasons.leaf.d.ts +7 -0
  298. package/dist/utility/wrun/wrun-signal-sound-reasons.leaf.js +12 -0
  299. package/dist/utility/wrun/wrun-socket-row-source.js +4 -2
  300. package/dist/utility/wrun/wrun-source-rows.util.d.ts +175 -3
  301. package/dist/utility/wrun/wrun-source-rows.util.js +294 -8
  302. package/dist/utility/wrun/wrun-stats-strip.util.d.ts +46 -0
  303. package/dist/utility/wrun/wrun-stats-strip.util.js +87 -0
  304. package/dist/utility/wrun/wrun-table-chrome.util.d.ts +163 -0
  305. package/dist/utility/wrun/wrun-table-chrome.util.js +557 -0
  306. package/dist/utility/wrun/wrun-text-params.util.d.ts +11 -6
  307. package/dist/utility/wrun/wrun-text-params.util.js +19 -30
  308. package/dist/utility/wrun/wrun-transient-rerun.util.d.ts +64 -0
  309. package/dist/utility/wrun/wrun-transient-rerun.util.js +317 -0
  310. package/dist/utility/wrun/wrun-twin-lookback.util.d.ts +10 -0
  311. package/dist/utility/wrun/wrun-twin-lookback.util.js +43 -0
  312. package/dist/utility/wrun/wrun-warmup-head-store.util.d.ts +41 -0
  313. package/dist/utility/wrun/wrun-warmup-head-store.util.js +120 -0
  314. package/dist/utility/wrun-alert-params.leaf.d.ts +24 -0
  315. package/dist/utility/wrun-alert-params.leaf.js +24 -0
  316. package/dist/utils/replay/replay-buffer-math.d.ts +148 -0
  317. package/dist/utils/replay/replay-buffer-math.js +684 -0
  318. package/dist/workers/wrun/wrun-abi-host.d.ts +190 -0
  319. package/dist/workers/wrun/wrun-abi-host.js +1201 -0
  320. package/dist/workers/wrun/wrun-engine-handler.d.ts +37 -0
  321. package/dist/workers/wrun/wrun-engine-handler.js +211 -0
  322. package/package.json +3 -3
@@ -0,0 +1,346 @@
1
+ /* eslint-disable @typescript-eslint/no-explicit-any */
2
+ import { Intervals } from '../../constants/interval.constants.js';
3
+ import { serverNowMs } from '../auth/server-clock.util.js';
4
+ import { isCmeGoverned } from '../chart/cme-realtime.util.js';
5
+ import { calendarBarStartMs, calendarMonthsOfMs } from '../chart/calendar-interval.util.js';
6
+ function findMonday(timestamp) {
7
+ const date = new Date(timestamp);
8
+ const day = date.getUTCDay();
9
+ const daysSinceMonday = (day + 6) % 7;
10
+ return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate() - daysSinceMonday);
11
+ }
12
+ export function timestampToTsdbTimestamp(timestamp) {
13
+ return Number(`${timestamp.seconds}000`);
14
+ }
15
+ /**
16
+ * Convert the tsdb timestamp to milliseconds
17
+ * @param timestamp - The timestamp to convert
18
+ * @returns The timestamp in milliseconds
19
+ */
20
+ export function tsdbTimestampToMs(timestamp) {
21
+ const ts = timestamp.seconds + (timestamp.nanoseconds ?? 0) * 1e-9;
22
+ return ts * 1000;
23
+ }
24
+ /**
25
+ * The start of the calendar bar (1M 3M 6M 1Y) a book stamp belongs to: a stamp
26
+ * exactly on a calendar boundary closes the bar before it, as an exact
27
+ * multiple does on a fixed grid (block book stamps are END labels).
28
+ */
29
+ function calendarBookBarStartMs(timestamp, months) {
30
+ const start = calendarBarStartMs(timestamp, months);
31
+ return start === timestamp ? calendarBarStartMs(timestamp - 1, months) : start;
32
+ }
33
+ /**
34
+ * Round the timestamp to the nearest interval in the past. A calendar length
35
+ * (1M 3M 6M 1Y) rounds onto its UTC calendar boundary, where its candles open.
36
+ * @param timestamp - The timestamp to round
37
+ * @param interval - The interval to round to
38
+ * @returns The rounded timestamp
39
+ */
40
+ export function roundObTimestamp(timestamp, interval) {
41
+ if (interval === Intervals.WEEK) {
42
+ return findMonday(timestamp);
43
+ }
44
+ const months = calendarMonthsOfMs(interval);
45
+ if (months !== null)
46
+ return calendarBookBarStartMs(timestamp, months);
47
+ const remainder = timestamp % interval;
48
+ if (remainder === 0) {
49
+ timestamp -= interval;
50
+ }
51
+ else {
52
+ timestamp -= remainder;
53
+ }
54
+ return timestamp;
55
+ }
56
+ /**
57
+ * Parses flattened orderbook data, transforming
58
+ * [numPriceLevels, timestamp_μs, price1, amount1, ...]
59
+ * into
60
+ * [segmentSize, timestamp_ms, price1, amount1, ...]
61
+ *
62
+ * Orderbook consumers must additionally call `shiftOrderbookTimestamps` to
63
+ * align timestamps with the candle interval start. TPSL consumers skip the
64
+ * shift since their timestamps are used as-is.
65
+ *
66
+ * @param flatPoints - Flattened data from backend
67
+ * @returns Float64Array with format [segmentSize, timestamp_ms, price1, amount1, ...]
68
+ */
69
+ export function parseOrderbookFlatData(flatPoints) {
70
+ if (!flatPoints?.length)
71
+ return new Float64Array();
72
+ // Copy flatPointsto Float64Array
73
+ const result = new Float64Array(flatPoints.length);
74
+ result.set(flatPoints);
75
+ let index = 0;
76
+ while (index < result.length) {
77
+ if (index + 1 >= result.length)
78
+ break;
79
+ const numPriceLevels = result[index];
80
+ const timestamp = result[index + 1];
81
+ // Calculate segment size: count + timestamp + price/amount pairs
82
+ // [count, timestamp, price1, amount1, price2, amount2, ...]
83
+ const segmentSize = 2 + numPriceLevels * 2;
84
+ // Check bounds
85
+ if (index + segmentSize > result.length)
86
+ break;
87
+ // Transform the first element from numPriceLevels to segmentSize
88
+ result[index] = segmentSize;
89
+ result[index + 1] = timestamp / 1000;
90
+ index += segmentSize;
91
+ }
92
+ return result;
93
+ }
94
+ /**
95
+ * The bar an END-stamped book point paints on: one interval back on a fixed
96
+ * grid, the calendar bar the stamp closes at a calendar length (1M 3M 6M 1Y:
97
+ * a bar of 28 to 366 days, where one average-length step back lands mid-bar
98
+ * or inside the bar before). The ladder projections (orderbook-ladder.util)
99
+ * must place a stamp exactly as this does: both heatmap paths paint one grid.
100
+ */
101
+ export function bookBarStartMs(stampMs, intervalMs) {
102
+ const months = calendarMonthsOfMs(intervalMs);
103
+ return months === null ? stampMs - intervalMs : calendarBookBarStartMs(stampMs, months);
104
+ }
105
+ /**
106
+ * Moves each segment's timestamp, in place, from the bucket-end stamp to the
107
+ * start of the bar it closes (`bookBarStartMs`), so the orderbook heatmap
108
+ * aligns with the candles. TPSL does not need this.
109
+ *
110
+ * @param data - Float64Array produced by `parseOrderbookFlatData`
111
+ * @param intervalMs - The chart interval in ms
112
+ */
113
+ export function shiftOrderbookTimestamps(data, intervalMs) {
114
+ let index = 0;
115
+ while (index < data.length) {
116
+ const segmentSize = data[index];
117
+ if (!segmentSize || index + segmentSize > data.length)
118
+ break;
119
+ data[index + 1] = bookBarStartMs(data[index + 1], intervalMs);
120
+ index += segmentSize;
121
+ }
122
+ }
123
+ /**
124
+ * Process block book snapshot data (live feed)
125
+ * @param point - The point to process
126
+ * @returns Float64Array
127
+ *
128
+ * @note The data is sorted by ascending price
129
+ */
130
+ export function processBlockBookSnapshot(point) {
131
+ if (!point)
132
+ return new Float64Array();
133
+ const snapshot = point.blockBookSnapshot;
134
+ if (!snapshot)
135
+ return new Float64Array();
136
+ const { timestamp, bids = [], asks = [] } = snapshot;
137
+ const formattedData = [];
138
+ formattedData.push(bids.length + asks.length + 2);
139
+ formattedData.push(timestampToTsdbTimestamp(timestamp)); // timestamp needs to be adjusted to the interval in main thread
140
+ const quantities = new Map(); // price -> total quantity
141
+ for (let i = 0; i < bids.length; i += 2) {
142
+ quantities.set(bids[i], (quantities.get(bids[i]) || 0) + bids[i + 1]);
143
+ }
144
+ for (let i = 0; i < asks.length; i += 2) {
145
+ quantities.set(asks[i], (quantities.get(asks[i]) || 0) + asks[i + 1]);
146
+ }
147
+ // Sort by price ascending (lowest price first)
148
+ const sortedQuantities = Array.from(quantities.entries()).sort((a, b) => a[0] - b[0]);
149
+ for (const [price, quantity] of sortedQuantities) {
150
+ formattedData.push(price, quantity);
151
+ }
152
+ // Correct the length of the data
153
+ formattedData[0] = formattedData.length;
154
+ return new Float64Array(formattedData);
155
+ }
156
+ export function processBlockBookSnapshots(points) {
157
+ if (!points)
158
+ return [];
159
+ return points.map((point) => processBlockBookSnapshot(point));
160
+ }
161
+ /**
162
+ * The bid level count of a flat book frame (`processBlockBookSnapshot`), so a
163
+ * kScript riding a heatmap's stream can split the price-ascending flat back
164
+ * into sides on the main thread (`kScriptOrderbookRowFromFlatBook`). The flat
165
+ * merges levels by price, so the split is only knowable when every wire level
166
+ * survived: -1 when the flat's level count differs from the snapshot's bid
167
+ * pairs plus ask pairs (a duplicate price inside a side, or one price on both
168
+ * sides), or when both sides exist and the book is crossed, locked or merged
169
+ * (`!(bids[0] < asks[0])`, best levels first on the wire). A -1 makes the
170
+ * rider skip that frame instead of guessing the boundary.
171
+ */
172
+ export function flatBookBidLevels(flat, bids, asks) {
173
+ const bidPairs = bids.length / 2;
174
+ const askPairs = asks.length / 2;
175
+ const flatLevels = (flat.length - 2) / 2;
176
+ if (!Number.isInteger(bidPairs) || !Number.isInteger(askPairs) || flatLevels !== bidPairs + askPairs)
177
+ return -1;
178
+ if (bidPairs > 0 && askPairs > 0 && !(bids[0] < asks[0]))
179
+ return -1;
180
+ return bidPairs;
181
+ }
182
+ function clipOrderbookLevels(levels, maxDepth) {
183
+ const maxLevels = Number(maxDepth);
184
+ if (!Number.isFinite(maxLevels) || maxLevels <= 0)
185
+ return levels;
186
+ return levels.slice(0, Math.floor(maxLevels) * 2);
187
+ }
188
+ function normalizeKScriptBlockBookSnapshotOptions(options) {
189
+ return typeof options === 'number' ? { maxDepth: options } : (options ?? {});
190
+ }
191
+ function normalizeOrderbookBucketPrice(price, blockSize, side) {
192
+ const rawBucket = side === 'ask' ? Math.ceil(price / blockSize) * blockSize : Math.floor(price / blockSize) * blockSize;
193
+ return Number(rawBucket.toFixed(8));
194
+ }
195
+ function aggregateOrderbookLevelsByBlock(levels, side, options) {
196
+ const sourceBlockSize = Number(options.sourceBlockSize);
197
+ const targetBlockSize = Number(options.targetBlockSize);
198
+ if (!Number.isFinite(sourceBlockSize) ||
199
+ !Number.isFinite(targetBlockSize) ||
200
+ sourceBlockSize <= 0 ||
201
+ targetBlockSize <= 0 ||
202
+ sourceBlockSize >= targetBlockSize) {
203
+ return levels;
204
+ }
205
+ const quantitiesByBucket = new Map();
206
+ for (let index = 0; index < levels.length; index += 2) {
207
+ const price = Number(levels[index]);
208
+ const quantity = Number(levels[index + 1]);
209
+ if (!Number.isFinite(price) || !Number.isFinite(quantity))
210
+ continue;
211
+ const bucketPrice = normalizeOrderbookBucketPrice(price, targetBlockSize, side);
212
+ quantitiesByBucket.set(bucketPrice, (quantitiesByBucket.get(bucketPrice) ?? 0) + quantity);
213
+ }
214
+ return Array.from(quantitiesByBucket.entries()).flat();
215
+ }
216
+ export function processKScriptBlockBookSnapshot(point, options) {
217
+ if (!point)
218
+ return new Float64Array();
219
+ const snapshot = point.blockBookSnapshot;
220
+ if (!snapshot)
221
+ return new Float64Array();
222
+ const normalizedOptions = normalizeKScriptBlockBookSnapshotOptions(options);
223
+ const timestamp = timestampToTsdbTimestamp(snapshot.timestamp); // timestamp needs to be adjusted to the interval in main thread
224
+ const bids = clipOrderbookLevels(aggregateOrderbookLevelsByBlock(snapshot.bids ?? [], 'bid', normalizedOptions), normalizedOptions.maxDepth);
225
+ const snapshotAsks = clipOrderbookLevels(aggregateOrderbookLevelsByBlock(snapshot.asks ?? [], 'ask', normalizedOptions), normalizedOptions.maxDepth);
226
+ // sort asks reversely
227
+ const askMap = new Map();
228
+ for (let i = 0; i < snapshotAsks.length; i += 2) {
229
+ askMap.set(snapshotAsks[i], -snapshotAsks[i + 1]); // set ask amounts to negative
230
+ }
231
+ const asks = Array.from(askMap.entries())
232
+ .sort((a, b) => b[0] - a[0])
233
+ .flat();
234
+ const float64Array = new Float64Array(bids.length + asks.length + 1);
235
+ float64Array[0] = timestamp;
236
+ float64Array.set(bids, 1);
237
+ float64Array.set(asks, bids.length + 1);
238
+ return float64Array;
239
+ }
240
+ export function processKScriptBlockBookSnapshots(points, options) {
241
+ if (!points)
242
+ return [];
243
+ return points.map((point) => processKScriptBlockBookSnapshot(point, options));
244
+ }
245
+ /**
246
+ * Rows `[ts, value per subset]` from values keyed by subset name and ms timestamp: each `subsetEnum` member (bar the
247
+ * zero member) at its enum value's index, null where it has no value at that ts; ts ascending over every subset.
248
+ */
249
+ export function subsetRows(values, subsetEnum) {
250
+ const elementSize = Object.keys(subsetEnum).filter((key) => isNaN(Number(key))).length - 1;
251
+ const times = [...new Set([...values.values()].flatMap((byTs) => [...byTs.keys()]))].sort((a, b) => a - b);
252
+ return times.map((time) => [
253
+ time,
254
+ ...Array.from({ length: elementSize }, (_, i) => values.get(subsetEnum[i + 1])?.get(time) ?? null),
255
+ ]);
256
+ }
257
+ /**
258
+ * The column `subsetRows` gives a subset inside each row: the subset's enum
259
+ * VALUE (the timestamp holds column 0, the slot of the enum's zero member), so a subset is read
260
+ * by its enum member, whichever members the enum gains later. Undefined for a name the enum
261
+ * does not hold.
262
+ */
263
+ export function subsetPointColumn(subsetEnum, subsetName) {
264
+ const value = subsetEnum[subsetName];
265
+ return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : undefined;
266
+ }
267
+ /**
268
+ * Whether the gateway-side BLOCK_BOOK replay clip still applies to history
269
+ * windows on this request interval.
270
+ *
271
+ * SECOND (intervalSec === 1) windows are served directly up to now since
272
+ * tsdb-gateway MR !1954 (coin-grouped SUM in the 1s BLOCK_BOOK_SNAPSHOT_AGG
273
+ * fold, gateway issue #13), so they are exempt from the client clip, and so
274
+ * are the other sub-minute rungs (5s 15s 30s: the 1s fold labelled and
275
+ * gapfilled on the bar's grid, tsdb-gateway !2189). Every other interval
276
+ * (MINUTE and coarser, or callers that do not declare an interval) keeps the
277
+ * 3-minute clip: the gateway hard-errors ("internal error") on younger
278
+ * windows there. If the gateway ever regresses on young SECOND windows,
279
+ * re-enforcing here restores the full clip and widens the seam top-up's owned
280
+ * window from the boot subscribe seam back to the whole young window
281
+ * (heatmap-seam-topup.util.ts).
282
+ */
283
+ export const isObReplayCapEnforcedForIntervalSec = (intervalSec, exchange) => {
284
+ if (intervalSec === undefined || !(intervalSec > 0 && intervalSec < 60))
285
+ return true;
286
+ // The young-SECOND exemption is a PER-GATEWAY capability, not a global one:
287
+ // the crypto gateway serves young SECOND book windows (gw !1954), while the
288
+ // governed CME gate still hard-errors ("internal error") on windows younger
289
+ // than its 3-minute fold boundary (2026-08-12 field report: ES1! 1s heatmap
290
+ // refetch stuck in a transport-retry loop) and serves the other sub-minute
291
+ // rungs like 1s. Governed venues keep the clip; the seam boot-bridge +
292
+ // top-up own the young window there at 1s.
293
+ return isCmeGoverned(exchange);
294
+ };
295
+ /**
296
+ * Calculates a safe replay cap timestamp for orderbook data.
297
+ * Clip-enforced intervals cap at truncate(now, 3 minutes); exempt intervals
298
+ * (sub-minute, see isObReplayCapEnforcedForIntervalSec) cap at now. `now` is
299
+ * the server's: the gateway clips on its own clock, and a device clock an
300
+ * hour ahead put the cap an hour past it (the young window it refuses was
301
+ * asked), one an hour behind cut the newest hour off every window.
302
+ * Returns UNIX seconds.
303
+ */
304
+ export const calculateObReplayCapInSeconds = (intervalSec, exchange) => {
305
+ const now = serverNowMs();
306
+ if (!isObReplayCapEnforcedForIntervalSec(intervalSec, exchange))
307
+ return Math.floor(now / 1000);
308
+ const replayCap = now - (now % Intervals.MINUTE3);
309
+ return Math.floor(replayCap / 1000);
310
+ };
311
+ /**
312
+ * Applies the orderbook replay cap to data requests: prevents fetching the
313
+ * last 3 minutes on clip-enforced intervals, passes exempt intervals
314
+ * (sub-minute) through capped at now.
315
+ *
316
+ * @param from - The start timestamp in seconds
317
+ * @param period - The period duration in seconds
318
+ * @param intervalSec - The request interval in seconds, when the caller knows it
319
+ */
320
+ export const applyObReplayCap = (from, period, intervalSec, exchange) => {
321
+ // Ensure integer timestamps
322
+ const startTime = Math.floor(from);
323
+ const duration = Math.floor(Math.max(60, period));
324
+ const replayCapTime = calculateObReplayCapInSeconds(intervalSec, exchange);
325
+ const endTime = startTime + duration;
326
+ // If the entire request is before the cap, return as-is
327
+ if (endTime <= replayCapTime) {
328
+ return {
329
+ from: startTime,
330
+ period: duration,
331
+ };
332
+ }
333
+ // If the request starts after or at the cap, return zero period
334
+ if (startTime >= replayCapTime) {
335
+ return {
336
+ from: startTime,
337
+ period: 0, // No data available
338
+ };
339
+ }
340
+ // Truncate the period to end at the replay cap
341
+ const truncatedDuration = Math.floor(Math.max(0, replayCapTime - startTime));
342
+ return {
343
+ from: startTime,
344
+ period: truncatedDuration,
345
+ };
346
+ };
@@ -6,12 +6,21 @@ export interface VisibleTimeout {
6
6
  /** Time since the start spent not visible; frozen once fired or cleared. */
7
7
  hiddenMs(): number;
8
8
  }
9
+ /** A host's suspended state beside the page's visibility: calls `listener` with the host's state at once and on
10
+ * every change, and answers the unsubscribe (wrun-chart-host's `clock.watchHostSuspended`). */
11
+ export type VisibleTimeoutSuspendedWatch = (listener: (suspended: boolean) => void) => () => void;
12
+ export interface VisibleTimeoutOptions {
13
+ /** The host's suspended state: the clock pauses while it reads suspended, as while the page is hidden. Absent,
14
+ * only the page's visibility pauses it. */
15
+ watchSuspended?: VisibleTimeoutSuspendedWatch;
16
+ }
9
17
  /**
10
18
  * Runs `callback` once `budgetMs` of visible time has passed since the call. Outside a
11
19
  * browser (no `document`) every millisecond counts, as with a plain timeout, and so it
12
20
  * does for a document that reports no visibility state: only an explicit `hidden`
13
- * pauses the clock, so a deadline can never be parked forever by a missing API. Whatever
14
- * a deadline armed is released by `clear()`, by its own fire, and so by a caller's
15
- * re-arm (clear the old handle, start a new one).
21
+ * pauses the clock, so a deadline can never be parked forever by a missing API. A host's
22
+ * suspension (`options.watchSuspended`) pauses it too. Whatever a deadline armed is
23
+ * released by `clear()`, by its own fire, and so by a caller's re-arm (clear the old
24
+ * handle, start a new one).
16
25
  */
17
- export declare function startVisibleTimeout(callback: () => unknown, budgetMs: number): VisibleTimeout;
26
+ export declare function startVisibleTimeout(callback: () => unknown, budgetMs: number, options?: VisibleTimeoutOptions): VisibleTimeout;
@@ -8,19 +8,26 @@
8
8
  // while hidden, the clock starts at the first visible moment, so the callback only
9
9
  // ever runs while the tab is visible.
10
10
  //
11
+ // A host can suspend its chart while the page stays visible (an app backgrounded,
12
+ // or its chart tab blurred, in a web view that keeps `visible`): a deadline handed
13
+ // the host's watch (`watchSuspended`) also pauses while the host reads suspended,
14
+ // on the same edges as a hide.
15
+ //
11
16
  // Deliberately no import: the chart boot path loads it (hidden-paced-loop.util says
12
17
  // why a leaf here must not pull document-visibility.util in).
13
18
  /**
14
19
  * Runs `callback` once `budgetMs` of visible time has passed since the call. Outside a
15
20
  * browser (no `document`) every millisecond counts, as with a plain timeout, and so it
16
21
  * does for a document that reports no visibility state: only an explicit `hidden`
17
- * pauses the clock, so a deadline can never be parked forever by a missing API. Whatever
18
- * a deadline armed is released by `clear()`, by its own fire, and so by a caller's
19
- * re-arm (clear the old handle, start a new one).
22
+ * pauses the clock, so a deadline can never be parked forever by a missing API. A host's
23
+ * suspension (`options.watchSuspended`) pauses it too. Whatever a deadline armed is
24
+ * released by `clear()`, by its own fire, and so by a caller's re-arm (clear the old
25
+ * handle, start a new one).
20
26
  */
21
- export function startVisibleTimeout(callback, budgetMs) {
27
+ export function startVisibleTimeout(callback, budgetMs, options) {
22
28
  const doc = typeof document === 'undefined' ? null : document;
23
- const isVisible = () => doc?.visibilityState !== 'hidden';
29
+ let hostSuspended = false;
30
+ const isVisible = () => doc?.visibilityState !== 'hidden' && !hostSuspended;
24
31
  // Monotonic, like the timers themselves: a wall-clock jump must not bank visible time.
25
32
  const now = () => performance.now();
26
33
  const startedAt = now();
@@ -43,6 +50,7 @@ export function startVisibleTimeout(callback, budgetMs) {
43
50
  pause();
44
51
  stoppedAt = now();
45
52
  doc?.removeEventListener?.('visibilitychange', onVisibilityChange);
53
+ unwatchSuspended?.();
46
54
  };
47
55
  const fire = () => {
48
56
  timer = null;
@@ -53,8 +61,10 @@ export function startVisibleTimeout(callback, budgetMs) {
53
61
  visibleSince = now();
54
62
  timer = setTimeout(fire, Math.max(0, budgetMs - bankedVisibleMs));
55
63
  };
56
- // Acts on edges only: a repeated `visible` never stacks a second timer.
64
+ // Acts on edges only: a repeated `visible` never stacks a second timer, and a stopped deadline arms nothing.
57
65
  function onVisibilityChange() {
66
+ if (stoppedAt !== null)
67
+ return;
58
68
  const visible = isVisible();
59
69
  if (visible && visibleSince === null)
60
70
  resume();
@@ -62,8 +72,13 @@ export function startVisibleTimeout(callback, budgetMs) {
62
72
  pause();
63
73
  }
64
74
  doc?.addEventListener?.('visibilitychange', onVisibilityChange);
65
- if (isVisible())
66
- resume();
75
+ // The host's watch answers its state at once (before the first arm) and on every change; its listener never stops
76
+ // the deadline, so `stop` reads the unwatch only once it is set.
77
+ const unwatchSuspended = options?.watchSuspended?.((suspended) => {
78
+ hostSuspended = suspended;
79
+ onVisibilityChange();
80
+ });
81
+ onVisibilityChange();
67
82
  return {
68
83
  clear: stop,
69
84
  visibleElapsedMs: () => visibleAt(now()),
@@ -0,0 +1 @@
1
+ export declare function formatExchangeDisplay(exchange: string, displayTransformations?: string): string;
@@ -0,0 +1,47 @@
1
+ /**
2
+ * A venue's display code (a leaf of utility/exchange-format.util.ts; P2/inventory.md section 1.1):
3
+ * `formatExchangeDisplay`, the exchange the chart header shows ("BINANCE.F", "OKX.F", "FRED"). The old module also
4
+ * reads the i18n plugin (formatExchangeName's suffix words), which keeps it out of the chart-host package; this leaf
5
+ * reads only the source delimiter (constants/data-source.constants, a package module) and moves with the phase 2
6
+ * closure. The old module re-exports it.
7
+ */
8
+ import { delimiter } from '../constants/data-source.constants.js';
9
+ export function formatExchangeDisplay(exchange, displayTransformations) {
10
+ if (exchange.toUpperCase() === 'SOLANA_ONCHAIN')
11
+ return 'Solana';
12
+ const suffixMap = {
13
+ _FUTURE: '.F',
14
+ _FUTURES: '.F',
15
+ _PERPETUAL: '.F',
16
+ _OPTION: '.O',
17
+ _OPTIONS: '.O',
18
+ _DERIVATIVES: '.D',
19
+ _SWAP: '.S',
20
+ _SPOT: '',
21
+ };
22
+ const applyTransformations = (exchangeString) => {
23
+ const result = exchangeString
24
+ .replace('PYTH_NETWORK', 'PYTH')
25
+ .replace('GATE_IO', 'GATE.IO')
26
+ .replace('OKEX_SWAP', 'OKX.F')
27
+ .replace('OKEX', 'OKX');
28
+ for (const [suffix, replacement] of Object.entries(suffixMap)) {
29
+ if (result.endsWith(suffix)) {
30
+ return result.slice(0, -suffix.length) + replacement;
31
+ }
32
+ }
33
+ return result;
34
+ };
35
+ // FRED is the St. Louis Fed's database, not the series' publisher (UNRATE is BLS data),
36
+ // so it always reads "FRED"; older picks stored "FEDERAL RESERVE" as the display venue.
37
+ if (exchange === 'FRED')
38
+ return 'FRED';
39
+ if (!displayTransformations) {
40
+ return applyTransformations(exchange);
41
+ }
42
+ if (delimiter && displayTransformations.includes(delimiter)) {
43
+ const exchangeDisplay = displayTransformations.split(delimiter)[0];
44
+ return applyTransformations(exchangeDisplay);
45
+ }
46
+ return applyTransformations(displayTransformations);
47
+ }
@@ -0,0 +1,60 @@
1
+ import type { EarningsEventKind, MarketEventsCoverage } from '../../interfaces/market-event.interface.js';
2
+ export declare const DAY_MS: number;
3
+ /** What one slice holds: one kind, one ticker or every ticker, the major companies (impact >= 2) or all of them. */
4
+ export interface EarningsScope {
5
+ kind: EarningsEventKind;
6
+ ticker: string | null;
7
+ majorOnly: boolean;
8
+ /** Epoch ms; normalized down to its UTC day. */
9
+ from: number;
10
+ /** Epoch ms, exclusive; normalized up to a UTC midnight. */
11
+ to: number;
12
+ }
13
+ /** A half-open span of whole UTC days, [from, to). */
14
+ export interface EarningsWindow {
15
+ from: number;
16
+ to: number;
17
+ }
18
+ /** The ticker filter the backend accepts (`^[A-Z][A-Z0-9.\-]{0,9}$`, upper case). */
19
+ export declare const EARNINGS_TICKER_PATTERN: RegExp;
20
+ /** `YYYY-MM-DD` of the UTC day an instant falls in. */
21
+ export declare function utcDayKey(ms: number): string;
22
+ /** A ticker as the slices key it: trimmed, upper case, null for none. */
23
+ export declare function normalizeEarningsTicker(ticker: string | null | undefined): string | null;
24
+ /** The scope's window on whole UTC days: `from` down to its midnight, `to` up to the next one (at least one day). */
25
+ export declare function earningsWindow(scope: Pick<EarningsScope, 'from' | 'to'>): EarningsWindow;
26
+ /** The scope every reader agrees on: the ticker normalized, the window on whole UTC days. */
27
+ export declare function normalizeEarningsScope(scope: EarningsScope): EarningsScope;
28
+ /**
29
+ * `${kind}|${ticker ?? '*'}|${majorOnly ? 'major' : 'all'}|${fromDay}|${toDay}`,
30
+ * the days `YYYY-MM-DD` of the normalized window (`toDay` is its exclusive
31
+ * end): `earnings|*|major|2026-10-01|2026-10-22`.
32
+ */
33
+ export declare function earningsScopeKey(scope: EarningsScope): string;
34
+ /** The kind an earnings scope key names; null for anything else (an asset class, a malformed key). */
35
+ export declare function earningsKeyKind(key: string): EarningsEventKind | null;
36
+ /**
37
+ * The list: the week behind today and the two ahead as days of the chart's
38
+ * zone, [today − 7 d, today + 14 d), rounded out to whole UTC days so no zone
39
+ * day is cut at either edge. In UTC that is exactly [today − 7 d, today + 14 d).
40
+ */
41
+ export declare function listWindow(now: number, offsetMs?: number): EarningsWindow;
42
+ /**
43
+ * One calendar month of the chart's zone (`month` 0 to 11 as
44
+ * `Date#getUTCMonth()` reads it), rounded out to whole UTC days. A zone east
45
+ * of UTC starts its month before UTC midnight: a US after-close print on the
46
+ * zone's 1st would otherwise fall out of both months.
47
+ */
48
+ export declare function monthWindow(year: number, month: number, offsetMs?: number): EarningsWindow;
49
+ /**
50
+ * One ticker's whole stored horizon, [today − 400 d, today + 90 d): 490 days,
51
+ * allowed because a ticker query is not held to the 92-day span of a broad one.
52
+ */
53
+ export declare function tickerWindow(now: number): EarningsWindow;
54
+ /**
55
+ * Whether a span [from, to) lies inside the served coverage. The served `to`
56
+ * may be an exclusive midnight or the last instant of its day; both read the
57
+ * same. No coverage covers nothing: those days show as unavailable, which is
58
+ * not the same as a day with zero reports.
59
+ */
60
+ export declare function coverageIncludes(coverage: MarketEventsCoverage | null, from: number, to: number): boolean;
@@ -0,0 +1,92 @@
1
+ export const DAY_MS = 24 * 60 * 60 * 1000;
2
+ /** The ticker filter the backend accepts (`^[A-Z][A-Z0-9.\-]{0,9}$`, upper case). */
3
+ export const EARNINGS_TICKER_PATTERN = /^[A-Z][A-Z0-9.-]{0,9}$/;
4
+ const floorUtcDay = (ms) => Math.floor(ms / DAY_MS) * DAY_MS;
5
+ const ceilUtcDay = (ms) => Math.ceil(ms / DAY_MS) * DAY_MS;
6
+ const pad2 = (value) => String(value).padStart(2, '0');
7
+ /** `YYYY-MM-DD` of the UTC day an instant falls in. */
8
+ export function utcDayKey(ms) {
9
+ const day = new Date(ms);
10
+ return `${day.getUTCFullYear()}-${pad2(day.getUTCMonth() + 1)}-${pad2(day.getUTCDate())}`;
11
+ }
12
+ /** A ticker as the slices key it: trimmed, upper case, null for none. */
13
+ export function normalizeEarningsTicker(ticker) {
14
+ const value = (ticker ?? '').trim().toUpperCase();
15
+ return value.length > 0 ? value : null;
16
+ }
17
+ /** The scope's window on whole UTC days: `from` down to its midnight, `to` up to the next one (at least one day). */
18
+ export function earningsWindow(scope) {
19
+ const from = floorUtcDay(scope.from);
20
+ const ceiled = ceilUtcDay(scope.to);
21
+ return { from, to: ceiled > from ? ceiled : from + DAY_MS };
22
+ }
23
+ /** The scope every reader agrees on: the ticker normalized, the window on whole UTC days. */
24
+ export function normalizeEarningsScope(scope) {
25
+ return {
26
+ kind: scope.kind,
27
+ ticker: normalizeEarningsTicker(scope.ticker),
28
+ majorOnly: scope.majorOnly === true,
29
+ ...earningsWindow(scope),
30
+ };
31
+ }
32
+ /**
33
+ * `${kind}|${ticker ?? '*'}|${majorOnly ? 'major' : 'all'}|${fromDay}|${toDay}`,
34
+ * the days `YYYY-MM-DD` of the normalized window (`toDay` is its exclusive
35
+ * end): `earnings|*|major|2026-10-01|2026-10-22`.
36
+ */
37
+ export function earningsScopeKey(scope) {
38
+ const normalized = normalizeEarningsScope(scope);
39
+ return [
40
+ normalized.kind,
41
+ normalized.ticker ?? '*',
42
+ normalized.majorOnly ? 'major' : 'all',
43
+ utcDayKey(normalized.from),
44
+ utcDayKey(normalized.to),
45
+ ].join('|');
46
+ }
47
+ /** The kind an earnings scope key names; null for anything else (an asset class, a malformed key). */
48
+ export function earningsKeyKind(key) {
49
+ if (key.startsWith('earnings|'))
50
+ return 'earnings';
51
+ if (key.startsWith('dividend|'))
52
+ return 'dividend';
53
+ return null;
54
+ }
55
+ /**
56
+ * The list: the week behind today and the two ahead as days of the chart's
57
+ * zone, [today − 7 d, today + 14 d), rounded out to whole UTC days so no zone
58
+ * day is cut at either edge. In UTC that is exactly [today − 7 d, today + 14 d).
59
+ */
60
+ export function listWindow(now, offsetMs = 0) {
61
+ const today = Math.floor((now + offsetMs) / DAY_MS) * DAY_MS - offsetMs;
62
+ return { from: floorUtcDay(today - 7 * DAY_MS), to: ceilUtcDay(today + 14 * DAY_MS) };
63
+ }
64
+ /**
65
+ * One calendar month of the chart's zone (`month` 0 to 11 as
66
+ * `Date#getUTCMonth()` reads it), rounded out to whole UTC days. A zone east
67
+ * of UTC starts its month before UTC midnight: a US after-close print on the
68
+ * zone's 1st would otherwise fall out of both months.
69
+ */
70
+ export function monthWindow(year, month, offsetMs = 0) {
71
+ return {
72
+ from: floorUtcDay(Date.UTC(year, month, 1) - offsetMs),
73
+ to: ceilUtcDay(Date.UTC(year, month + 1, 1) - offsetMs),
74
+ };
75
+ }
76
+ /**
77
+ * One ticker's whole stored horizon, [today − 400 d, today + 90 d): 490 days,
78
+ * allowed because a ticker query is not held to the 92-day span of a broad one.
79
+ */
80
+ export function tickerWindow(now) {
81
+ const today = floorUtcDay(now);
82
+ return { from: today - 400 * DAY_MS, to: today + 90 * DAY_MS };
83
+ }
84
+ /**
85
+ * Whether a span [from, to) lies inside the served coverage. The served `to`
86
+ * may be an exclusive midnight or the last instant of its day; both read the
87
+ * same. No coverage covers nothing: those days show as unavailable, which is
88
+ * not the same as a day with zero reports.
89
+ */
90
+ export function coverageIncludes(coverage, from, to) {
91
+ return coverage !== null && from >= coverage.from && to <= coverage.to + 1;
92
+ }