@orangecharts/wrun-chart-host 0.11.0 → 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 (311) 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 +18 -0
  16. package/dist/index.js +19 -0
  17. package/dist/indicators/controls/tpo-session.util.d.ts +78 -15
  18. package/dist/indicators/controls/tpo-session.util.js +320 -242
  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/market-sessions.util.d.ts +83 -0
  88. package/dist/utility/chart/market-sessions.util.js +220 -0
  89. package/dist/utility/chart/om-panel.util.d.ts +5 -3
  90. package/dist/utility/chart/om-panel.util.js +42 -7
  91. package/dist/utility/chart/om-target.util.d.ts +14 -1
  92. package/dist/utility/chart/om-target.util.js +22 -5
  93. package/dist/utility/chart/opra-read-access.leaf.d.ts +16 -1
  94. package/dist/utility/chart/opra-read-access.leaf.js +22 -0
  95. package/dist/utility/chart/profile-row-height.util.d.ts +49 -16
  96. package/dist/utility/chart/profile-row-height.util.js +74 -37
  97. package/dist/utility/chart/rth-session.util.d.ts +55 -20
  98. package/dist/utility/chart/rth-session.util.js +94 -46
  99. package/dist/utility/chart/session-interval.util.d.ts +2 -1
  100. package/dist/utility/chart/session-interval.util.js +1 -3
  101. package/dist/utility/chart/session-lattice.util.d.ts +150 -0
  102. package/dist/utility/chart/session-lattice.util.js +488 -0
  103. package/dist/utility/chart/trading-day.util.d.ts +40 -2
  104. package/dist/utility/chart/trading-day.util.js +84 -7
  105. package/dist/utility/chart/us-equities-session.util.d.ts +32 -11
  106. package/dist/utility/chart/us-equities-session.util.js +44 -15
  107. package/dist/utility/chart/window-geometry.leaf.d.ts +28 -7
  108. package/dist/utility/chart/window-geometry.leaf.js +57 -8
  109. package/dist/utility/chart/wrun-bar-session-facts.util.d.ts +21 -14
  110. package/dist/utility/chart/wrun-bar-session-facts.util.js +32 -38
  111. package/dist/utility/chart/wrun-run-result.util.d.ts +29 -12
  112. package/dist/utility/chart/wrun-run-result.util.js +89 -25
  113. package/dist/utility/common/time.util.js +5 -4
  114. package/dist/utility/market-events/earnings-scope.util.d.ts +10 -5
  115. package/dist/utility/market-events/earnings-scope.util.js +17 -9
  116. package/dist/utility/market-events/market-events.util.d.ts +14 -7
  117. package/dist/utility/market-events/market-events.util.js +30 -17
  118. package/dist/utility/number-format.util.d.ts +14 -21
  119. package/dist/utility/number-format.util.js +38 -24
  120. package/dist/utility/options/option-venue-disclosure.util.d.ts +40 -6
  121. package/dist/utility/options/option-venue-disclosure.util.js +71 -11
  122. package/dist/utility/options/option-venue.util.d.ts +1 -1
  123. package/dist/utility/options/option-venue.util.js +1 -1
  124. package/dist/utility/pool-symbol.leaf.d.ts +7 -0
  125. package/dist/utility/pool-symbol.leaf.js +50 -5
  126. package/dist/utility/stocks/stock-display.util.d.ts +15 -0
  127. package/dist/utility/stocks/stock-display.util.js +37 -0
  128. package/dist/utility/symbol-selection/contract-expiry.util.js +5 -4
  129. package/dist/utility/v2/gate-plane.util.d.ts +6 -0
  130. package/dist/utility/v2/gate-plane.util.js +11 -1
  131. package/dist/utility/v2/gate-session-latch.util.d.ts +1 -1
  132. package/dist/utility/v2/gate-session-latch.util.js +3 -3
  133. package/dist/utility/v2/governed-tier.leaf.d.ts +17 -16
  134. package/dist/utility/v2/governed-tier.leaf.js +17 -16
  135. package/dist/utility/v2/stocks-governed.util.d.ts +5 -0
  136. package/dist/utility/v2/stocks-governed.util.js +14 -0
  137. package/dist/utility/v2/v2-enums.leaf.d.ts +13 -0
  138. package/dist/utility/v2/v2-enums.leaf.js +458 -0
  139. package/dist/utility/wrun/derived-roots.leaf.d.ts +21 -1
  140. package/dist/utility/wrun/derived-roots.leaf.js +27 -1
  141. package/dist/utility/wrun/derived-roots.util.d.ts +44 -32
  142. package/dist/utility/wrun/derived-roots.util.js +97 -56
  143. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.d.ts +4 -3
  144. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.js +4 -3
  145. package/dist/utility/wrun/sources/lanes/option_daily.d.ts +2 -1
  146. package/dist/utility/wrun/sources/lanes/option_daily.js +2 -1
  147. package/dist/utility/wrun/sources/lanes/options_flow.d.ts +3 -0
  148. package/dist/utility/wrun/sources/lanes/options_flow.js +23 -5
  149. package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +3 -4
  150. package/dist/utility/wrun/sources/row-lane-registry.js +9 -4
  151. package/dist/utility/wrun/sources/row-lanes/dark_pool.d.ts +19 -0
  152. package/dist/utility/wrun/sources/row-lanes/dark_pool.js +104 -0
  153. package/dist/utility/wrun/sources/row-lanes/index.js +2 -0
  154. package/dist/utility/wrun/sources/wrun-lane-fetch-abort.util.d.ts +20 -0
  155. package/dist/utility/wrun/sources/wrun-lane-fetch-abort.util.js +103 -0
  156. package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +19 -2
  157. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +15 -13
  158. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +49 -23
  159. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +14 -9
  160. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +75 -27
  161. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +139 -82
  162. package/dist/utility/wrun/wrun-app-layer.leaf.d.ts +78 -0
  163. package/dist/utility/wrun/wrun-app-layer.leaf.js +89 -0
  164. package/dist/utility/wrun/wrun-bar-count.util.d.ts +11 -7
  165. package/dist/utility/wrun/wrun-bar-count.util.js +12 -8
  166. package/dist/utility/wrun/wrun-batched-kinds.leaf.d.ts +13 -0
  167. package/dist/utility/wrun/wrun-batched-kinds.leaf.js +18 -0
  168. package/dist/utility/wrun/wrun-batched-marks.util.d.ts +41 -22
  169. package/dist/utility/wrun/wrun-batched-marks.util.js +255 -59
  170. package/dist/utility/wrun/wrun-batched-readout.util.d.ts +26 -19
  171. package/dist/utility/wrun/wrun-batched-readout.util.js +81 -27
  172. package/dist/utility/wrun/wrun-book-bands.leaf.d.ts +8 -0
  173. package/dist/utility/wrun/wrun-book-bands.leaf.js +7 -0
  174. package/dist/utility/wrun/wrun-candle-equal.leaf.d.ts +19 -0
  175. package/dist/utility/wrun/wrun-candle-equal.leaf.js +40 -0
  176. package/dist/utility/wrun/wrun-canvas-readout.util.d.ts +4 -2
  177. package/dist/utility/wrun/wrun-canvases.util.js +7 -3
  178. package/dist/utility/wrun/wrun-chart-context-names.util.d.ts +6 -3
  179. package/dist/utility/wrun/wrun-chart-context-names.util.js +8 -4
  180. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +47 -29
  181. package/dist/utility/wrun/wrun-chart-market-facts.util.js +201 -201
  182. package/dist/utility/wrun/wrun-child-overlay-id.util.js +2 -1
  183. package/dist/utility/wrun/wrun-cme-legs-note.util.d.ts +15 -0
  184. package/dist/utility/wrun/wrun-cme-legs-note.util.js +49 -0
  185. package/dist/utility/wrun/wrun-cme-root-specs.util.d.ts +38 -0
  186. package/dist/utility/wrun/wrun-cme-root-specs.util.js +81 -0
  187. package/dist/utility/wrun/wrun-coin-lane-live.util.js +3 -0
  188. package/dist/utility/wrun/wrun-color-settings.util.d.ts +6 -1
  189. package/dist/utility/wrun/wrun-color-settings.util.js +32 -7
  190. package/dist/utility/wrun/wrun-dark-pool.util.d.ts +50 -0
  191. package/dist/utility/wrun/wrun-dark-pool.util.js +127 -0
  192. package/dist/utility/wrun/wrun-declared-warmup.util.d.ts +67 -12
  193. package/dist/utility/wrun/wrun-declared-warmup.util.js +165 -13
  194. package/dist/utility/wrun/wrun-draft-legend-note.util.d.ts +18 -8
  195. package/dist/utility/wrun/wrun-draft-legend-note.util.js +57 -11
  196. package/dist/utility/wrun/wrun-draft-overlay.util.d.ts +14 -10
  197. package/dist/utility/wrun/wrun-draft-overlay.util.js +26 -14
  198. package/dist/utility/wrun/wrun-earnings-facts.util.js +3 -2
  199. package/dist/utility/wrun/wrun-etf-funds.util.d.ts +2 -0
  200. package/dist/utility/wrun/wrun-etf-funds.util.js +4 -0
  201. package/dist/utility/wrun/wrun-held-lanes.util.js +8 -2
  202. package/dist/utility/wrun/wrun-history-as-of.util.d.ts +77 -0
  203. package/dist/utility/wrun/wrun-history-as-of.util.js +108 -0
  204. package/dist/utility/wrun/wrun-host.service.d.ts +64 -14
  205. package/dist/utility/wrun/wrun-host.service.js +137 -27
  206. package/dist/utility/wrun/wrun-hosted-wire-caps.d.ts +3 -3
  207. package/dist/utility/wrun/wrun-hosted-wire-caps.js +12 -2
  208. package/dist/utility/wrun/wrun-inert-legend.util.d.ts +13 -0
  209. package/dist/utility/wrun/wrun-inert-legend.util.js +31 -3
  210. package/dist/utility/wrun/wrun-input-requirements.leaf.d.ts +7 -5
  211. package/dist/utility/wrun/wrun-input-requirements.leaf.js +16 -6
  212. package/dist/utility/wrun/wrun-install-pacer.util.d.ts +26 -0
  213. package/dist/utility/wrun/wrun-install-pacer.util.js +145 -0
  214. package/dist/utility/wrun/wrun-kit-refusal-stages.types.d.ts +22 -0
  215. package/dist/utility/wrun/wrun-kit-refusal-stages.types.js +1 -0
  216. package/dist/utility/wrun/wrun-lane-refusal.leaf.d.ts +12 -5
  217. package/dist/utility/wrun/wrun-lane-refusal.leaf.js +23 -5
  218. package/dist/utility/wrun/wrun-lane-warmup.util.js +22 -4
  219. package/dist/utility/wrun/wrun-leg-close.util.d.ts +6 -5
  220. package/dist/utility/wrun/wrun-leg-close.util.js +11 -9
  221. package/dist/utility/wrun/wrun-leg-fetch.util.d.ts +3 -1
  222. package/dist/utility/wrun/wrun-leg-fetch.util.js +9 -2
  223. package/dist/utility/wrun/wrun-levels-child.util.d.ts +2 -0
  224. package/dist/utility/wrun/wrun-levels-child.util.js +6 -0
  225. package/dist/utility/wrun/wrun-lifecycle.contract.d.ts +4 -0
  226. package/dist/utility/wrun/wrun-live-intake.util.d.ts +15 -6
  227. package/dist/utility/wrun/wrun-live-intake.util.js +167 -47
  228. package/dist/utility/wrun/wrun-live-tick.util.d.ts +52 -8
  229. package/dist/utility/wrun/wrun-live-tick.util.js +648 -97
  230. package/dist/utility/wrun/wrun-market-facts.util.d.ts +16 -2
  231. package/dist/utility/wrun/wrun-market-facts.util.js +32 -3
  232. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +27 -27
  233. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +28 -16
  234. package/dist/utility/wrun/wrun-market-size-defaults.util.js +34 -5
  235. package/dist/utility/wrun/wrun-oi-lane.util.d.ts +10 -7
  236. package/dist/utility/wrun/wrun-oi-lane.util.js +16 -10
  237. package/dist/utility/wrun/wrun-option-strike-flow.util.js +1 -1
  238. package/dist/utility/wrun/wrun-option-views.util.d.ts +2 -2
  239. package/dist/utility/wrun/wrun-option-views.util.js +5 -2
  240. package/dist/utility/wrun/wrun-options-flow-underlying.leaf.d.ts +5 -0
  241. package/dist/utility/wrun/wrun-options-flow-underlying.leaf.js +16 -0
  242. package/dist/utility/wrun/wrun-options-stop.util.d.ts +3 -2
  243. package/dist/utility/wrun/wrun-options-stop.util.js +6 -4
  244. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +75 -11
  245. package/dist/utility/wrun/wrun-overlay-drivers.util.js +176 -43
  246. package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +20 -10
  247. package/dist/utility/wrun/wrun-overlay-park.util.d.ts +84 -0
  248. package/dist/utility/wrun/wrun-overlay-park.util.js +135 -0
  249. package/dist/utility/wrun/wrun-overlay-recovery.util.d.ts +37 -4
  250. package/dist/utility/wrun/wrun-overlay-recovery.util.js +26 -14
  251. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +239 -24
  252. package/dist/utility/wrun/wrun-overlay-run.util.js +2204 -405
  253. package/dist/utility/wrun/wrun-pack.util.d.ts +8 -5
  254. package/dist/utility/wrun/wrun-panel-mount.util.d.ts +2 -1
  255. package/dist/utility/wrun/wrun-panel-mount.util.js +20 -14
  256. package/dist/utility/wrun/wrun-panel-style.util.d.ts +4 -2
  257. package/dist/utility/wrun/wrun-panel-style.util.js +3 -2
  258. package/dist/utility/wrun/wrun-pin-spelling.util.d.ts +7 -0
  259. package/dist/utility/wrun/wrun-pin-spelling.util.js +18 -4
  260. package/dist/utility/wrun/wrun-pin-venues.util.d.ts +26 -17
  261. package/dist/utility/wrun/wrun-pin-venues.util.js +43 -36
  262. package/dist/utility/wrun/wrun-pinned-lanes.util.d.ts +58 -0
  263. package/dist/utility/wrun/wrun-pinned-lanes.util.js +72 -0
  264. package/dist/utility/wrun/wrun-prefix-cohort.util.js +2 -1
  265. package/dist/utility/wrun/wrun-prefix-lanes.util.d.ts +22 -9
  266. package/dist/utility/wrun/wrun-prefix-lanes.util.js +145 -26
  267. package/dist/utility/wrun/wrun-prefix-proof.util.d.ts +29 -0
  268. package/dist/utility/wrun/wrun-prefix-proof.util.js +23 -5
  269. package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +9 -1
  270. package/dist/utility/wrun/wrun-refusal-surface.util.js +15 -1
  271. package/dist/utility/wrun/wrun-refusal.util.d.ts +19 -1
  272. package/dist/utility/wrun/wrun-refusal.util.js +103 -16
  273. package/dist/utility/wrun/wrun-registry-errors.util.d.ts +20 -6
  274. package/dist/utility/wrun/wrun-registry-errors.util.js +20 -6
  275. package/dist/utility/wrun/wrun-replay-rows.util.js +6 -10
  276. package/dist/utility/wrun/wrun-run-health.util.d.ts +89 -2
  277. package/dist/utility/wrun/wrun-run-health.util.js +204 -1
  278. package/dist/utility/wrun/wrun-run-interval-session.util.d.ts +2 -2
  279. package/dist/utility/wrun/wrun-run-interval-session.util.js +2 -2
  280. package/dist/utility/wrun/wrun-run-interval.util.d.ts +9 -8
  281. package/dist/utility/wrun/wrun-run-interval.util.js +13 -11
  282. package/dist/utility/wrun/wrun-sandbox-row-source.js +5 -2
  283. package/dist/utility/wrun/wrun-script-inputs.util.d.ts +13 -3
  284. package/dist/utility/wrun/wrun-script-inputs.util.js +51 -13
  285. package/dist/utility/wrun/wrun-session-composition.util.d.ts +81 -0
  286. package/dist/utility/wrun/wrun-session-composition.util.js +169 -0
  287. package/dist/utility/wrun/wrun-setting-words.util.d.ts +10 -7
  288. package/dist/utility/wrun/wrun-setting-words.util.js +25 -7
  289. package/dist/utility/wrun/wrun-source-rows.util.d.ts +94 -28
  290. package/dist/utility/wrun/wrun-source-rows.util.js +738 -93
  291. package/dist/utility/wrun/wrun-stream-clock.util.d.ts +45 -0
  292. package/dist/utility/wrun/wrun-stream-clock.util.js +108 -0
  293. package/dist/utility/wrun/wrun-tape-coins.util.d.ts +116 -0
  294. package/dist/utility/wrun/wrun-tape-coins.util.js +110 -0
  295. package/dist/utility/wrun/wrun-tape-source.util.d.ts +62 -32
  296. package/dist/utility/wrun/wrun-tape-source.util.js +72 -34
  297. package/dist/utility/wrun/wrun-tier-grid.util.d.ts +13 -5
  298. package/dist/utility/wrun/wrun-tier-grid.util.js +23 -13
  299. package/dist/utility/wrun/wrun-tpo-rows.util.js +2 -1
  300. package/dist/utility/wrun/wrun-trades-lane.util.d.ts +73 -0
  301. package/dist/utility/wrun/wrun-trades-lane.util.js +82 -0
  302. package/dist/utility/wrun/wrun-twin-compute-inputs.util.d.ts +5 -0
  303. package/dist/utility/wrun/wrun-twin-compute-inputs.util.js +9 -2
  304. package/dist/utility/wrun/wrun-visibility-table.d.ts +13 -0
  305. package/dist/utility/wrun/wrun-visibility-table.js +9 -0
  306. package/dist/utility/wrun/wrun-volume-profile.util.js +44 -32
  307. package/dist/utils/replay/replay-buffer-math.d.ts +16 -6
  308. package/dist/utils/replay/replay-buffer-math.js +60 -30
  309. package/dist/workers/constants/socket-slots.d.ts +11 -7
  310. package/dist/workers/constants/socket-slots.js +6 -5
  311. package/package.json +11 -11
@@ -11,11 +11,16 @@
11
11
  * flight. 'await' coalesces onto it, 'skip' drops this request (the
12
12
  * wave/recovery loop owns covering the span), 'ignore' dispatches anyway.
13
13
  * - onRecentCompletion: what to do when an identical key completed within
14
- * the fetchCache completion window. 'skip' drops, 'refresh' fetches anyway
15
- * (heals must re-request), 'ignore' means the lane never consults the
16
- * window at all.
14
+ * the fetchCache completion window. 'skip' drops, 'skip-fresh' drops only
15
+ * while that completion is younger than the request registry's fresh bound
16
+ * (the interval's saved-copy too-old bound) and fetches after it, 'refresh'
17
+ * fetches anyway (heals must re-request), 'ignore' means the lane never
18
+ * consults the window at all.
17
19
  * - registersPending: whether the dispatch marks a pending ledger entry
18
20
  * (owner-token guarded) that twins can observe.
21
+ * - onDeliveredAnswer: what to do when the overlay still holds the delivered
22
+ * answer to this ask's exact data key (DELIVERED_ANSWER_SKIP below). 'skip'
23
+ * keeps the ask home, 'send' always dispatches.
19
24
  *
20
25
  * The legally-asked-twice cases are deliberate: main polling + main gap
21
26
  * recovery can fetch overlapping windows on the same tick, and post-wake
@@ -55,8 +60,15 @@
55
60
  * not the fetchCache. isReplayBuffer outranks isDomReplayWindow when both are
56
61
  * stamped (the buffer lane's own collector wins).
57
62
  *
58
- * Two suppression classes live OUTSIDE this flag table because they depend on
59
- * delivered data, not request flags:
63
+ * Four suppression classes judge delivered data or another request, not
64
+ * request flags, at the guard site (the last three live wholly outside this
65
+ * table):
66
+ * - DELIVERED_ANSWER_SKIP (the web ledger, fetch-cache.util.ts): an ask whose
67
+ * class says onDeliveredAnswer 'skip' (a history page, IND_LAZY_PAGE) stays
68
+ * home while the overlay holds the answer to its exact data key (the chart
69
+ * identity plus sharedRequestKeyFor of the payload, never its window) and
70
+ * still mounts the rows that answer's commit left. The verb is this table's;
71
+ * the record of delivered answers is the web ledger's.
60
72
  * - FIXED_WINDOW_COVERED_SKIP (fixed-window-fetch-skip.util.ts): fixed-window
61
73
  * single-request overlays replace the wave span with a settings-derived
62
74
  * range at payload build, so ledger keys never match their repeats; the
@@ -67,6 +79,10 @@
67
79
  * past orderflow retention) arms a 60s identity+range memory; heal-class
68
80
  * re-asks of the same window skip until the TTL expires instead of looping
69
81
  * the identical empty fetch every wave round.
82
+ * - REQUEST_IDENTICAL_KEPT (request-identity-candidate.util.ts): a replacing
83
+ * site's re-ask that would send the byte-identical request a live owner of
84
+ * the overlay already sent keeps that owner instead (ring
85
+ * indicator-reask-identical-kept); it never reaches this table's sites.
70
86
  */
71
87
  export declare function registerDataLoadHealRegisterFlagReader(reader: (() => boolean) | null): void;
72
88
  export declare function isDataLoadHealRegisterEnabled(): boolean;
@@ -88,12 +104,14 @@ export interface FetchDedupeIntent {
88
104
  /** A split-family child whose span IS the parent's registered pre-split span (the owner span). */
89
105
  isSplitFamilyOwnerChild?: boolean;
90
106
  }
91
- export type FetchDedupePolicyName = 'MAIN_COALESCE' | 'MAIN_POLL_BYPASS' | 'MAIN_HISTORICAL_BYPASS' | 'MAIN_RETRY_BYPASS' | 'IND_SKIP_DUPLICATE' | 'IND_REPAIR_REFRESH' | 'IND_POLL_BYPASS' | 'HEATMAP_CACHE_ONLY_BYPASS' | 'IND_RETRY_BYPASS' | 'IND_SPLIT_FAMILY_OWNER_CHILD' | 'IND_REPLAY_LANE_BYPASS' | 'IND_SEAM_TOPUP' | 'KSCRIPT_SOURCE_DEDUPE' | 'DOM_REPLAY_WINDOW' | 'TAPE_SVP_SEED' | 'FOOTPRINT_PANEL';
107
+ export type FetchDedupePolicyName = 'MAIN_COALESCE' | 'MAIN_POLL_BYPASS' | 'MAIN_HISTORICAL_BYPASS' | 'MAIN_RETRY_BYPASS' | 'IND_SKIP_DUPLICATE' | 'IND_REPAIR_REFRESH' | 'IND_LAZY_PAGE' | 'IND_POLL_BYPASS' | 'HEATMAP_CACHE_ONLY_BYPASS' | 'IND_RETRY_BYPASS' | 'IND_SPLIT_FAMILY_OWNER_CHILD' | 'IND_REPLAY_LANE_BYPASS' | 'IND_SEAM_TOPUP' | 'KSCRIPT_SOURCE_DEDUPE' | 'DOM_REPLAY_WINDOW' | 'TAPE_SVP_SEED' | 'FOOTPRINT_PANEL';
92
108
  export interface FetchDedupePolicy {
93
109
  name: FetchDedupePolicyName;
94
110
  onPendingTwin: 'await' | 'skip' | 'ignore';
95
- onRecentCompletion: 'skip' | 'refresh' | 'ignore';
111
+ onRecentCompletion: 'skip' | 'skip-fresh' | 'refresh' | 'ignore';
96
112
  registersPending: boolean;
113
+ /** A history page asks for a window, never for fresher data: only that class stays home on an answer the overlay holds. */
114
+ onDeliveredAnswer: 'skip' | 'send';
97
115
  why: string;
98
116
  }
99
117
  /** Branch precedence mirrors the historical guard-site code order exactly. */
@@ -103,6 +121,8 @@ export declare const MAIN_PLAN_FLAG_KEY = "data-load-main-plan";
103
121
  export declare function isMainPlanEnabled(readExplicitlyOff: (key: string) => boolean): boolean;
104
122
  export declare const RECEIPT_SETTLE_FLAG_KEY = "data-load-receipt-settle";
105
123
  export declare function isReceiptSettleEnabled(readExplicitlyOff: (key: string) => boolean): boolean;
124
+ export declare const ENGINE_QUEUE_HOLD_FLAG_KEY = "data-load-engine-queue-hold";
125
+ export declare function isEngineQueueHoldEnabled(readExplicitlyOff: (key: string) => boolean): boolean;
106
126
  export declare function isShareableFetchDedupePolicy(policy: FetchDedupePolicyName | FetchDedupePolicy): boolean;
107
127
  export declare const KICK_BASE_HARD_KILL = false;
108
128
  export declare const KICK_BASE_FLAG_KEY = "data-load-kick-base";
@@ -11,11 +11,16 @@
11
11
  * flight. 'await' coalesces onto it, 'skip' drops this request (the
12
12
  * wave/recovery loop owns covering the span), 'ignore' dispatches anyway.
13
13
  * - onRecentCompletion: what to do when an identical key completed within
14
- * the fetchCache completion window. 'skip' drops, 'refresh' fetches anyway
15
- * (heals must re-request), 'ignore' means the lane never consults the
16
- * window at all.
14
+ * the fetchCache completion window. 'skip' drops, 'skip-fresh' drops only
15
+ * while that completion is younger than the request registry's fresh bound
16
+ * (the interval's saved-copy too-old bound) and fetches after it, 'refresh'
17
+ * fetches anyway (heals must re-request), 'ignore' means the lane never
18
+ * consults the window at all.
17
19
  * - registersPending: whether the dispatch marks a pending ledger entry
18
20
  * (owner-token guarded) that twins can observe.
21
+ * - onDeliveredAnswer: what to do when the overlay still holds the delivered
22
+ * answer to this ask's exact data key (DELIVERED_ANSWER_SKIP below). 'skip'
23
+ * keeps the ask home, 'send' always dispatches.
19
24
  *
20
25
  * The legally-asked-twice cases are deliberate: main polling + main gap
21
26
  * recovery can fetch overlapping windows on the same tick, and post-wake
@@ -55,8 +60,15 @@
55
60
  * not the fetchCache. isReplayBuffer outranks isDomReplayWindow when both are
56
61
  * stamped (the buffer lane's own collector wins).
57
62
  *
58
- * Two suppression classes live OUTSIDE this flag table because they depend on
59
- * delivered data, not request flags:
63
+ * Four suppression classes judge delivered data or another request, not
64
+ * request flags, at the guard site (the last three live wholly outside this
65
+ * table):
66
+ * - DELIVERED_ANSWER_SKIP (the web ledger, fetch-cache.util.ts): an ask whose
67
+ * class says onDeliveredAnswer 'skip' (a history page, IND_LAZY_PAGE) stays
68
+ * home while the overlay holds the answer to its exact data key (the chart
69
+ * identity plus sharedRequestKeyFor of the payload, never its window) and
70
+ * still mounts the rows that answer's commit left. The verb is this table's;
71
+ * the record of delivered answers is the web ledger's.
60
72
  * - FIXED_WINDOW_COVERED_SKIP (fixed-window-fetch-skip.util.ts): fixed-window
61
73
  * single-request overlays replace the wave span with a settings-derived
62
74
  * range at payload build, so ledger keys never match their repeats; the
@@ -67,6 +79,10 @@
67
79
  * past orderflow retention) arms a 60s identity+range memory; heal-class
68
80
  * re-asks of the same window skip until the TTL expires instead of looping
69
81
  * the identical empty fetch every wave round.
82
+ * - REQUEST_IDENTICAL_KEPT (request-identity-candidate.util.ts): a replacing
83
+ * site's re-ask that would send the byte-identical request a live owner of
84
+ * the overlay already sent keeps that owner instead (ring
85
+ * indicator-reask-identical-kept); it never reaches this table's sites.
70
86
  */
71
87
  /**
72
88
  * Kill switch for data-loading phase S6 (background lanes, poll cadence
@@ -104,6 +120,7 @@ const POLICIES = {
104
120
  onPendingTwin: 'await',
105
121
  onRecentCompletion: 'ignore',
106
122
  registersPending: true,
123
+ onDeliveredAnswer: 'send',
107
124
  why: 'An identical in-flight twin paints this same chart slot; await it. Recent completions are ' +
108
125
  'deliberately NOT suppressed for main data: cache-aligned requests are bucket-canonical, so ' +
109
126
  'legitimate re-fetches carry identical keys by design and skipping them strands stale paints.',
@@ -113,6 +130,7 @@ const POLICIES = {
113
130
  onPendingTwin: 'ignore',
114
131
  onRecentCompletion: 'ignore',
115
132
  registersPending: false,
133
+ onDeliveredAnswer: 'send',
116
134
  why: 'Polling re-issues an identical (from=0, period) key every tick; it once marked itself pending ' +
117
135
  'without clearing, silently suppressing every poll after the first.',
118
136
  },
@@ -121,6 +139,7 @@ const POLICIES = {
121
139
  onPendingTwin: 'ignore',
122
140
  onRecentCompletion: 'ignore',
123
141
  registersPending: false,
142
+ onDeliveredAnswer: 'send',
124
143
  why: 'Historical-mode fetches replace the dataset under explicit identity stamps; nothing may absorb them.',
125
144
  },
126
145
  MAIN_RETRY_BYPASS: {
@@ -128,6 +147,7 @@ const POLICIES = {
128
147
  onPendingTwin: 'ignore',
129
148
  onRecentCompletion: 'ignore',
130
149
  registersPending: false,
150
+ onDeliveredAnswer: 'send',
131
151
  why: 'Blank-boot retries and hedges exist to dispatch a REAL transport request past a possibly wedged twin.',
132
152
  },
133
153
  IND_SKIP_DUPLICATE: {
@@ -135,6 +155,7 @@ const POLICIES = {
135
155
  onPendingTwin: 'skip',
136
156
  onRecentCompletion: 'skip',
137
157
  registersPending: true,
158
+ onDeliveredAnswer: 'send',
138
159
  why: 'Indicator policy differs from main: in-flight duplicates are skipped, not awaited, because the ' +
139
160
  'lazy wave / gap-recovery loop owns covering the span; a recent completion means the span was just served. ' +
140
161
  'CMETAIL adjudication 2026-09-02: that ownership assumption fails for types outside those healers, so a ' +
@@ -146,17 +167,37 @@ const POLICIES = {
146
167
  onPendingTwin: 'skip',
147
168
  onRecentCompletion: 'refresh',
148
169
  registersPending: true,
149
- why: 'Lazy-load and gap-recovery requests may re-request a recently completed range, but never bypass the ' +
150
- 'in-flight duplicate guard. A receipt is a claim, never proof of rows: a gap heal of a CLOSED window ' +
151
- 'stays home on its receipt only where every 50-bar piece holds a row on the pane or no main bar ' +
152
- '(COVERED_RECENT_COMPLETION_SKIP, the stamp-proof round 2026-10-08), and every other heal refreshes ' +
153
- 'past it. A lazy wave re-ask skips only the whole-span repeat (receipt plus a spanning row set).',
170
+ onDeliveredAnswer: 'send',
171
+ why: 'Gap-recovery, heal and repair requests (isGapRecovery) may re-request a recently completed range, but ' +
172
+ 'never bypass the in-flight duplicate guard. A receipt is a claim, never proof of rows: a gap heal of a ' +
173
+ 'CLOSED window stays home on its receipt only where every 50-bar piece holds a row on the pane or no main ' +
174
+ 'bar (COVERED_RECENT_COMPLETION_SKIP, the stamp-proof round 2026-10-08), and every other heal refreshes ' +
175
+ 'past it. Lazy pages (isLazyload alone) left this class for IND_LAZY_PAGE (2026-11-01).',
176
+ },
177
+ IND_LAZY_PAGE: {
178
+ name: 'IND_LAZY_PAGE',
179
+ onPendingTwin: 'skip',
180
+ onRecentCompletion: 'skip-fresh',
181
+ registersPending: true,
182
+ onDeliveredAnswer: 'skip',
183
+ why: 'A lazy page (isLazyload without isGapRecovery: the lazy wave, the row coverage keeper, the add-time ' +
184
+ 'fills) whose ALIGNED window a completion younger than the request registry fresh bound covers whole is ' +
185
+ 'served by that receipt and does not leave (adjudicated 2026-11-01, WRUN-PANBACK-2: the TPO Daily boot ' +
186
+ 'pair, a lazy page 0.36 s after its aligned primary completed, went out twice). The bound is the one the ' +
187
+ 'registry reads to call a repeat a duplicate rather than a refresh (cachedPaintMaxWriteAgeMs of the ' +
188
+ 'interval); a venue with none keeps the completion window. An older receipt refreshes as before, where a ' +
189
+ 'whole-span repeat still stays home on the receipt plus a spanning row set (COVERED_RECENT_COMPLETION_SKIP); ' +
190
+ 'an in-flight twin is skipped as before. Recovery, heal and repair asks keep IND_REPAIR_REFRESH. A page whose ' +
191
+ 'exact data key the overlay still holds stays home whatever window it was asked for and however old the ' +
192
+ 'receipt (onDeliveredAnswer, DELIVERED_ANSWER_SKIP, adjudicated 2026-11-02: the GEX curve payload carries ' +
193
+ 'no window, so every page carried a new ledger key while its wire key never moved).',
154
194
  },
155
195
  IND_POLL_BYPASS: {
156
196
  name: 'IND_POLL_BYPASS',
157
197
  onPendingTwin: 'ignore',
158
198
  onRecentCompletion: 'ignore',
159
199
  registersPending: false,
200
+ onDeliveredAnswer: 'send',
160
201
  why: 'Indicator polling sizes its own steady-state requests each tick; the ledger never gates it.',
161
202
  },
162
203
  HEATMAP_CACHE_ONLY_BYPASS: {
@@ -164,6 +205,7 @@ const POLICIES = {
164
205
  onPendingTwin: 'ignore',
165
206
  onRecentCompletion: 'ignore',
166
207
  registersPending: false,
208
+ onDeliveredAnswer: 'send',
167
209
  why: 'Cache-only heatmap reads serve from the local chunk cache; transport dedupe must not suppress them.',
168
210
  },
169
211
  IND_RETRY_BYPASS: {
@@ -171,6 +213,7 @@ const POLICIES = {
171
213
  onPendingTwin: 'ignore',
172
214
  onRecentCompletion: 'ignore',
173
215
  registersPending: false,
216
+ onDeliveredAnswer: 'send',
174
217
  why: 'The transport retry chain re-dispatches its own request; its twin IS the entry being retried.',
175
218
  },
176
219
  IND_SPLIT_FAMILY_OWNER_CHILD: {
@@ -178,6 +221,7 @@ const POLICIES = {
178
221
  onPendingTwin: 'ignore',
179
222
  onRecentCompletion: 'ignore',
180
223
  registersPending: false,
224
+ onDeliveredAnswer: 'send',
181
225
  why: 'A split-family child whose span equals the pre-split span its parent registered as pending (the ' +
182
226
  "planner's settled-tail cut leaves the newest unsettled piece as the parent's own ask). The pending " +
183
227
  'twin it sees IS its own family: skipping it left the span unserved and attached a re-arm receipt to ' +
@@ -192,6 +236,7 @@ const POLICIES = {
192
236
  onPendingTwin: 'ignore',
193
237
  onRecentCompletion: 'ignore',
194
238
  registersPending: false,
239
+ onDeliveredAnswer: 'send',
195
240
  why: 'Replay lane fetches deliver through their own collector (onReplayRows) and never paint the chart, ' +
196
241
  "so a ledger twin's completion can NEVER reach this consumer: a settings re-lane re-requests the " +
197
242
  'same deterministic chunk windows the replaced lane generation just fetched, and suppressing it ' +
@@ -204,6 +249,7 @@ const POLICIES = {
204
249
  onPendingTwin: 'skip',
205
250
  onRecentCompletion: 'refresh',
206
251
  registersPending: true,
252
+ onDeliveredAnswer: 'send',
207
253
  why: 'The one-shot 1s book seam top-up (heatmap-seam-topup.util.ts, adjudicated 2026-08-10) re-asks the ' +
208
254
  'structurally unowned [clipFloor .. first live apply] window once it ages past the 3-minute replay ' +
209
255
  'cap. Same verbs as IND_REPAIR_REFRESH (a heal must actually refresh, never bypass the in-flight ' +
@@ -216,6 +262,7 @@ const POLICIES = {
216
262
  onPendingTwin: 'skip',
217
263
  onRecentCompletion: 'skip',
218
264
  registersPending: true,
265
+ onDeliveredAnswer: 'send',
219
266
  why: 'Engine source fetches single-flight per source (kScriptSourceFetchInFlight) and consult the shared ' +
220
267
  'ledger. P6 key fix landed: entries are keyed by real chartIndex and completion keys carry the same ' +
221
268
  '(type, sourceName) as start keys, resolved on every terminal path; empty successful replies clear ' +
@@ -227,6 +274,7 @@ const POLICIES = {
227
274
  onPendingTwin: 'ignore',
228
275
  onRecentCompletion: 'ignore',
229
276
  registersPending: false,
277
+ onDeliveredAnswer: 'send',
230
278
  why: 'Replay-DOM window fetches (replayDomDriver.ts, adjudicated with Spec 2B/C) deliver through the ' +
231
279
  "driver's own collector into the pane worker's replay rings and never paint an overlay, so a ledger " +
232
280
  "twin's completion can never reach this consumer; like the replay buffer lane they neither consult " +
@@ -241,6 +289,7 @@ const POLICIES = {
241
289
  onPendingTwin: 'ignore',
242
290
  onRecentCompletion: 'ignore',
243
291
  registersPending: false,
292
+ onDeliveredAnswer: 'send',
244
293
  why: 'Tape session-SVP seed fetches (tape-svp-seed.service.ts, adjudicated with DOM new-viz F5) stream ' +
245
294
  '[sessionStart, enterCutoff) K_TRADES rows into a STAGING accumulator that merges atomically into ' +
246
295
  'the tape session stats on complete success and is discarded whole on any failure; they never paint ' +
@@ -257,6 +306,7 @@ const POLICIES = {
257
306
  onPendingTwin: 'ignore',
258
307
  onRecentCompletion: 'ignore',
259
308
  registersPending: false,
309
+ onDeliveredAnswer: 'send',
260
310
  why: 'Footprint panel own-lane fetches (footprint-panel-lane.service.ts, FOOTPRINT-PANEL) ask VOLUME_FOOTPRINT or ' +
261
311
  'AGGREGATED_VOLUME_FOOTPRINT snapshot windows under a fresh synthetic ovId per request and deliver into the ' +
262
312
  "panel lane's own store, never an overlay, so like the tape seed they neither consult nor write the " +
@@ -300,8 +350,10 @@ export function resolveFetchDedupePolicy(intent) {
300
350
  return POLICIES.IND_SPLIT_FAMILY_OWNER_CHILD;
301
351
  if (intent.isHeatmapSeamTopUp)
302
352
  return POLICIES.IND_SEAM_TOPUP;
303
- if (intent.isLazyload || intent.isGapRecovery)
353
+ if (intent.isGapRecovery)
304
354
  return POLICIES.IND_REPAIR_REFRESH;
355
+ if (intent.isLazyload)
356
+ return POLICIES.IND_LAZY_PAGE;
305
357
  return POLICIES.IND_SKIP_DUPLICATE;
306
358
  }
307
359
  export const FETCH_DEDUPE_POLICIES = Object.values(POLICIES);
@@ -354,6 +406,29 @@ export function isReceiptSettleEnabled(readExplicitlyOff) {
354
406
  return true;
355
407
  }
356
408
  }
409
+ // ── Kill switch: heals hold while the engine still holds a queued commit (HEAL-QUEUED-COMMIT, 2026-11-05) ──
410
+ //
411
+ // Same shape as the switches above: read ONCE per recovery poll cycle and once
412
+ // per wave-settled repair scan, carried as a boolean inside that unit of work.
413
+ // ON (default): the recovery poller and the repair scan hold while
414
+ // `engineQueuedOverlayWrites` reports a queued overlay write for the chart
415
+ // (bounded by the poller's busy budget and the scan's hold cap), and the poller
416
+ // vouches a range against the rows the engine holds before it dispatches it
417
+ // (a range the mounted rows cover is pruned, never fetched). OFF: today's
418
+ // dispatch, the stale-rows re-buy of the bucket a pan-time commit just landed.
419
+ const ENGINE_QUEUE_HOLD_HARD_KILL = false;
420
+ export const ENGINE_QUEUE_HOLD_FLAG_KEY = 'data-load-engine-queue-hold';
421
+ export function isEngineQueueHoldEnabled(readExplicitlyOff) {
422
+ if (ENGINE_QUEUE_HOLD_HARD_KILL)
423
+ return false;
424
+ try {
425
+ return !readExplicitlyOff(ENGINE_QUEUE_HOLD_FLAG_KEY);
426
+ }
427
+ catch {
428
+ // An unloaded or unavailable store reads ON (feature-gating.md, default-ON flags).
429
+ return true;
430
+ }
431
+ }
357
432
  /**
358
433
  * Cross-chart sharing eligibility (data-loading plan S11a, Codex C7), derived
359
434
  * from the RESOLVED policy and carried BESIDE the canonical payload to the
@@ -18,11 +18,13 @@
18
18
  import { type LiveBucketVenue } from './live-bucket.util.js';
19
19
  /**
20
20
  * How a host merges what lands in one of its bars: `flow` sums the rows,
21
- * `level` keeps the last row, `candle` folds OHLCV rows into one candle, and
21
+ * `level` keeps the last row, `candle` folds OHLCV rows into one candle,
22
22
  * `cells` (rows of time-stamped cells: a trade tape, option prints) places
23
- * each CELL by its own instant, its offset rebased to the bar's open.
23
+ * each CELL by its own instant, its offset rebased to the bar's open, and
24
+ * `passthrough` places nothing: every row keeps its own timestamp (a profile
25
+ * a tool aggregates over a window rides rows finer than the host's bars).
24
26
  */
25
- export type IndexHostMerge = 'flow' | 'level' | 'candle' | 'cells';
27
+ export type IndexHostMerge = 'flow' | 'level' | 'candle' | 'cells' | 'passthrough';
26
28
  /** An index-mode host's bars as the placement reads them. */
27
29
  export interface IndexHostBars {
28
30
  /** The mounted main candles, ascending by timestamp (ms). */
@@ -97,7 +99,8 @@ export interface PlaceRowsInHostBarsOptions {
97
99
  * stamped on it keeps that row object, so a series already on the host grid
98
100
  * comes back as the exact timestamp filter returned it; every other bar's row
99
101
  * is new and is handed to `onMade`. `opts.rowSpanMs` places each row by its
100
- * last instant instead (`PlaceRowsInHostBarsOptions`).
102
+ * last instant instead (`PlaceRowsInHostBarsOptions`). `passthrough` returns
103
+ * the rows as handed, in a new array, and makes none.
101
104
  */
102
105
  export declare function placeRowsInHostBars(rows: readonly number[][], bars: IndexHostBars, merge: IndexHostMerge, onMade?: (row: number[]) => void, opts?: PlaceRowsInHostBarsOptions): number[][];
103
106
  /**
@@ -71,7 +71,10 @@ function mergeRowsOntoBar(barTs, rows, merge) {
71
71
  export function hostBarRowOf(barTs, rows, merge) {
72
72
  if (rows.length === 1 && rows[0][0] === barTs)
73
73
  return rows[0];
74
- return merge === 'level' ? [barTs, ...rows[rows.length - 1].slice(1)] : mergeRowsOntoBar(barTs, rows, merge);
74
+ // A passthrough series has no bar row; a door that still asks keeps the last (the live doors branch it first).
75
+ return merge === 'level' || merge === 'passthrough'
76
+ ? [barTs, ...rows[rows.length - 1].slice(1)]
77
+ : mergeRowsOntoBar(barTs, rows, merge);
75
78
  }
76
79
  const hasFiniteTs = (row) => {
77
80
  const ts = row?.[0];
@@ -423,9 +426,12 @@ function placeCellsInHostBars(sorted, bars, out, onMade) {
423
426
  * stamped on it keeps that row object, so a series already on the host grid
424
427
  * comes back as the exact timestamp filter returned it; every other bar's row
425
428
  * is new and is handed to `onMade`. `opts.rowSpanMs` places each row by its
426
- * last instant instead (`PlaceRowsInHostBarsOptions`).
429
+ * last instant instead (`PlaceRowsInHostBarsOptions`). `passthrough` returns
430
+ * the rows as handed, in a new array, and makes none.
427
431
  */
428
432
  export function placeRowsInHostBars(rows, bars, merge, onMade, opts) {
433
+ if (merge === 'passthrough')
434
+ return rows.slice();
429
435
  const main = bars.mainRows;
430
436
  const out = [];
431
437
  if (!rows.length || !main.length)
@@ -17,10 +17,42 @@ export interface IndicatorInflightScheduleOptions {
17
17
  profile?: IndicatorInflightProfile;
18
18
  settleMs?: number;
19
19
  maxDeferMs?: number;
20
+ /**
21
+ * What this ask is for (a wave, a heal, a repair): it follows the runner, so
22
+ * the flight that runner starts reports it as its cover purpose. Defaults to
23
+ * the profile name.
24
+ */
25
+ purpose?: string;
20
26
  }
21
27
  export declare function __setIndicatorInflightClockForTests(fn: (() => number) | null): void;
22
28
  export declare function scheduleIndicatorInflightFetch(chartIndex: number, overlayId: string, range: IndicatorInflightRange, runner: IndicatorInflightRunner, options?: IndicatorInflightScheduleOptions): IndicatorInflightScheduleResult;
23
29
  export declare function hasPendingIndicatorInflight(chartIndex?: number, profile?: IndicatorInflightProfile): boolean;
30
+ /** A flight that covers a window: its own window (ms, half-open like every registry range), purpose and registry key. */
31
+ export interface IndicatorInflightCover {
32
+ fromMs: number;
33
+ toMs: number;
34
+ purpose: string;
35
+ key: string;
36
+ }
37
+ /**
38
+ * The in-flight run of this chart and identity (the overlay id its asks were
39
+ * scheduled under) whose window covers [fromMs, toMs) whole, or null when none
40
+ * does: nothing in flight (only queued, settled or cleared), a partial overlap,
41
+ * another chart or identity, or an empty window. The registry runs one flight
42
+ * per chart and identity and a later ask it covers coalesces onto it, so when
43
+ * several asks cover the window the answer is the earliest scheduled one's
44
+ * flight, named by the purpose of the runner on the wire, never a joiner's.
45
+ * Reads the registry only: no entry, runner or timer changes.
46
+ */
47
+ export declare function findIndicatorInflightCover(chartIndex: number, identityKey: string, fromMs: number, toMs: number): IndicatorInflightCover | null;
48
+ /**
49
+ * Settles when the flight a cover named finishes or its entry is cleared,
50
+ * exactly when an ask that coalesced onto it would; at once when that flight
51
+ * is gone already. Waiting joins nothing: the flight's runner, purpose, profile
52
+ * and queued union stay as they are, so a queued re-arm still runs the runner
53
+ * of the ask that queued it.
54
+ */
55
+ export declare function indicatorInflightCoverSettled(cover: IndicatorInflightCover): Promise<void>;
24
56
  export declare function clearIndicatorInflight(chartIndex: number, overlayId?: string, profile?: IndicatorInflightProfile): void;
25
57
  export declare function clearAllIndicatorInflight(profile?: IndicatorInflightProfile): void;
26
58
  export declare function __getPendingIndicatorInflightCountForTests(profile?: IndicatorInflightProfile): number;
@@ -27,6 +27,13 @@
27
27
  * missing range), and replacing would let the later narrow request shrink a
28
28
  * pending full-span recompute. A covering span is always a valid protected
29
29
  * request — the server computes supersets safely, never subsets.
30
+ *
31
+ * Covers: every flight records what its runner is for (`purpose`, the
32
+ * scheduler's name for it, else the profile name). findIndicatorInflightCover
33
+ * answers whether a flight of a chart and identity already covers a window, so
34
+ * a caller that would otherwise schedule onto it (gap recovery) can wait for it
35
+ * with indicatorInflightCoverSettled instead, without handing the flight its
36
+ * own runner.
30
37
  */
31
38
  import { notifyChartLoadPhaseInputChanged } from './chart-load-phase.util.js';
32
39
  const PROFILE_DEFAULTS = {
@@ -87,6 +94,7 @@ function startEntry(entry) {
87
94
  return;
88
95
  entry.desiredRange = undefined;
89
96
  entry.inFlightRange = cloneRange(range);
97
+ entry.inFlightPurpose = entry.purpose;
90
98
  entry.inFlightDeferred = entry.desiredDeferred;
91
99
  entry.desiredDeferred = undefined;
92
100
  notifyEntryChanged(entry);
@@ -109,6 +117,7 @@ function startEntry(entry) {
109
117
  const completedRange = entry.inFlightRange;
110
118
  entry.inFlightRange = undefined;
111
119
  entry.inFlightDeferred = undefined;
120
+ entry.inFlightPurpose = undefined;
112
121
  const desiredRange = entry.desiredRange;
113
122
  if (completedRange && desiredRange && !containsRange(completedRange, desiredRange)) {
114
123
  completedDeferred?.resolve();
@@ -136,6 +145,7 @@ export function scheduleIndicatorInflightFetch(chartIndex, overlayId, range, run
136
145
  return { key, status: 'ignored-invalid', range: normalizedRange, completion: Promise.resolve() };
137
146
  }
138
147
  const profile = options.profile ?? 'protected';
148
+ const purpose = options.purpose ?? profile;
139
149
  const defaults = PROFILE_DEFAULTS[profile];
140
150
  const settleMs = Math.max(0, options.settleMs ?? defaults.settleMs);
141
151
  const maxDeferMs = Math.max(settleMs, options.maxDeferMs ?? defaults.maxDeferMs);
@@ -147,6 +157,7 @@ export function scheduleIndicatorInflightFetch(chartIndex, overlayId, range, run
147
157
  chartIndex,
148
158
  overlayId,
149
159
  profile,
160
+ purpose,
150
161
  desiredRange: normalizedRange,
151
162
  runner,
152
163
  timer: null,
@@ -159,6 +170,7 @@ export function scheduleIndicatorInflightFetch(chartIndex, overlayId, range, run
159
170
  else {
160
171
  entry.runner = runner;
161
172
  entry.profile = profile;
173
+ entry.purpose = purpose;
162
174
  entry.settleMs = settleMs;
163
175
  entry.maxDeferMs = maxDeferMs;
164
176
  }
@@ -208,6 +220,46 @@ export function hasPendingIndicatorInflight(chartIndex, profile) {
208
220
  }
209
221
  return false;
210
222
  }
223
+ /**
224
+ * The in-flight run of this chart and identity (the overlay id its asks were
225
+ * scheduled under) whose window covers [fromMs, toMs) whole, or null when none
226
+ * does: nothing in flight (only queued, settled or cleared), a partial overlap,
227
+ * another chart or identity, or an empty window. The registry runs one flight
228
+ * per chart and identity and a later ask it covers coalesces onto it, so when
229
+ * several asks cover the window the answer is the earliest scheduled one's
230
+ * flight, named by the purpose of the runner on the wire, never a joiner's.
231
+ * Reads the registry only: no entry, runner or timer changes.
232
+ */
233
+ export function findIndicatorInflightCover(chartIndex, identityKey, fromMs, toMs) {
234
+ const wanted = { startMs: fromMs, endMs: toMs };
235
+ if (!isValidRange(wanted))
236
+ return null;
237
+ const entry = entriesByKey.get(indicatorInflightKey(chartIndex, identityKey));
238
+ const inFlight = entry?.inFlightRange;
239
+ if (!entry || !inFlight || !containsRange(inFlight, wanted))
240
+ return null;
241
+ return {
242
+ fromMs: inFlight.startMs,
243
+ toMs: inFlight.endMs,
244
+ purpose: entry.inFlightPurpose ?? entry.profile,
245
+ key: entry.key,
246
+ };
247
+ }
248
+ /**
249
+ * Settles when the flight a cover named finishes or its entry is cleared,
250
+ * exactly when an ask that coalesced onto it would; at once when that flight
251
+ * is gone already. Waiting joins nothing: the flight's runner, purpose, profile
252
+ * and queued union stay as they are, so a queued re-arm still runs the runner
253
+ * of the ask that queued it.
254
+ */
255
+ export function indicatorInflightCoverSettled(cover) {
256
+ const entry = entriesByKey.get(cover.key);
257
+ const inFlight = entry?.inFlightRange;
258
+ if (!entry || !inFlight || inFlight.startMs !== cover.fromMs || inFlight.endMs !== cover.toMs) {
259
+ return Promise.resolve();
260
+ }
261
+ return (entry.inFlightDeferred ??= createDeferred()).promise;
262
+ }
211
263
  export function clearIndicatorInflight(chartIndex, overlayId, profile) {
212
264
  const notifyChartIndexes = new Set();
213
265
  for (const [key, entry] of entriesByKey) {
@@ -1,4 +1,5 @@
1
1
  import type { BuiltinInputReader } from '../../constants/scriptEditor/builtin-script-snippets.js';
2
+ import { type SessionLatticeId } from './session-lattice.util.js';
2
3
  /**
3
4
  * Built-ins whose `timeframe` input runs the engine at that interval: every built-in template with
4
5
  * the input, the 14 classics (P2, 2026-10-03) and the 14 TradingView staples (2026-10-04), each
@@ -49,9 +50,14 @@ export interface OverlayRunInterval {
49
50
  * results. Absent everywhere else.
50
51
  */
51
52
  sessionLattice?: boolean;
53
+ /**
54
+ * Which session lattice (session-lattice.util `SessionLatticeId`: 'cme', 'forex') beside
55
+ * `sessionLattice`; a stamped run without one is a CME run from before the forex lattice.
56
+ */
57
+ sessionLatticeId?: SessionLatticeId;
52
58
  }
53
- /** What a run bar's span reads: the run interval and whether its bars ride the CME session lattice. */
54
- export type RunBarCalendar = Pick<OverlayRunInterval, 'intervalMs' | 'sessionLattice'>;
59
+ /** What a run bar's span reads: the run interval and whether (and which) session lattice its bars ride. */
60
+ export type RunBarCalendar = Pick<OverlayRunInterval, 'intervalMs' | 'sessionLattice' | 'sessionLatticeId'>;
55
61
  /** A run bar's span: it takes trades from `open` until `close`. */
56
62
  export interface RunBarSpan {
57
63
  open: number;
@@ -121,10 +127,10 @@ export declare function engineSettingsForRunInterval<T extends object>(settings:
121
127
  * live; on the lattice from its session open, before a 1D or 1W stamp). Chart bars before the first
122
128
  * shown row get NaN cells. Run rows before the first chart bar (the warm-up) are dropped.
123
129
  */
124
- export declare function projectRunRowsOntoChart(rows: readonly (readonly unknown[] | null | undefined)[], chartTimes: readonly number[], runMs: number, waitForClose: boolean, sessionLattice?: boolean): unknown[][];
130
+ export declare function projectRunRowsOntoChart(rows: readonly (readonly unknown[] | null | undefined)[], chartTimes: readonly number[], runMs: number, waitForClose: boolean, sessionLattice?: boolean, sessionLatticeId?: SessionLatticeId): unknown[][];
125
131
  /**
126
132
  * The chart time a run-bar time anchor (a drawing point at a run bar's stamp) lands on: where that
127
133
  * bar's value first shows (its close with wait for close on, its open with it off, read by
128
134
  * runBarSpan), clamped to the chart's loaded bars.
129
135
  */
130
- export declare function projectRunTimeOntoChart(runTime: number, chartTimes: readonly number[], runMs: number, waitForClose: boolean, sessionLattice?: boolean): number;
136
+ export declare function projectRunTimeOntoChart(runTime: number, chartTimes: readonly number[], runMs: number, waitForClose: boolean, sessionLattice?: boolean, sessionLatticeId?: SessionLatticeId): number;
@@ -12,7 +12,7 @@
12
12
  * template path until replay can serve run-interval candles clipped at the replay cursor.
13
13
  */
14
14
  import { Intervals } from '../../constants/interval.constants.js';
15
- import { cmeSessionBarEndMs, cmeSessionBarOpenMs, cmeSessionBucketMs } from './cme-session-bucket.util.js';
15
+ import { CME_SESSION_LATTICE, sessionLatticeBarEndMs, sessionLatticeBarOpenMs, sessionLatticeBucketMs, sessionLatticeById, } from './session-lattice.util.js';
16
16
  /**
17
17
  * Built-ins whose `timeframe` input runs the engine at that interval: every built-in template with
18
18
  * the input, the 14 classics (P2, 2026-10-03) and the 14 TradingView staples (2026-10-04), each
@@ -107,6 +107,12 @@ const TIMEFRAME_INTERVALS = {
107
107
  '1D': '1d',
108
108
  '1W': '1w',
109
109
  };
110
+ /** The lattice a run's bars ride, null off every lattice; a stamped run without an id is a CME run. */
111
+ function runLattice(run) {
112
+ if (!run.sessionLattice)
113
+ return null;
114
+ return sessionLatticeById(run.sessionLatticeId) ?? CME_SESSION_LATTICE;
115
+ }
110
116
  /**
111
117
  * The [open, close) of the run bar stamped `stamp`: `[stamp, stamp + intervalMs)`, or on the CME
112
118
  * session lattice its session bar's (cmeSessionBarOpenMs, cmeSessionBarEndMs: a 1D bar stamped at
@@ -115,14 +121,16 @@ const TIMEFRAME_INTERVALS = {
115
121
  * that is no run bar's) reads the plain span.
116
122
  */
117
123
  export function runBarSpan(stamp, run) {
118
- const close = run.sessionLattice ? cmeSessionBarEndMs(stamp, run.intervalMs) : null;
119
- if (close === null)
124
+ const lattice = runLattice(run);
125
+ const close = lattice ? sessionLatticeBarEndMs(lattice, stamp, run.intervalMs) : null;
126
+ if (close === null || lattice === null)
120
127
  return { open: stamp, close: stamp + run.intervalMs };
121
- return { open: cmeSessionBarOpenMs(stamp, run.intervalMs) ?? stamp, close };
128
+ return { open: sessionLatticeBarOpenMs(lattice, stamp, run.intervalMs) ?? stamp, close };
122
129
  }
123
130
  /** runBarSpan's close alone, for a loop over many bars that never reads the session open (uncached). */
124
131
  function runBarCloseMs(stamp, run) {
125
- return (run.sessionLattice ? cmeSessionBarEndMs(stamp, run.intervalMs) : null) ?? stamp + run.intervalMs;
132
+ const lattice = runLattice(run);
133
+ return (lattice ? sessionLatticeBarEndMs(lattice, stamp, run.intervalMs) : null) ?? stamp + run.intervalMs;
126
134
  }
127
135
  /** The first index whose time is at or after `time` (times ascending); times.length when none. */
128
136
  function firstIndexAtOrAfter(times, time) {
@@ -146,14 +154,15 @@ function firstIndexAtOrAfter(times, time) {
146
154
  * bar's open, a regular-hours one included). Infinity when no chart bar reaches that close.
147
155
  */
148
156
  export function nextRunBarCloseMs(stamp, chartTimes, run) {
149
- if (!run.sessionLattice)
157
+ const lattice = runLattice(run);
158
+ if (lattice === null)
150
159
  return stamp + 2 * run.intervalMs;
151
- const sessionClose = cmeSessionBarEndMs(stamp, run.intervalMs);
160
+ const sessionClose = sessionLatticeBarEndMs(lattice, stamp, run.intervalMs);
152
161
  const at = firstIndexAtOrAfter(chartTimes, sessionClose ?? stamp + run.intervalMs);
153
162
  if (at === chartTimes.length)
154
163
  return Number.POSITIVE_INFINITY;
155
164
  const first = chartTimes[at];
156
- const next = sessionClose === null ? first : (cmeSessionBucketMs(first, run.intervalMs) ?? first);
165
+ const next = sessionClose === null ? first : (sessionLatticeBucketMs(lattice, first, run.intervalMs) ?? first);
157
166
  return runBarCloseMs(next, run);
158
167
  }
159
168
  function intervalMsOf(interval) {
@@ -218,8 +227,8 @@ export function engineSettingsForRunInterval(settings) {
218
227
  * live; on the lattice from its session open, before a 1D or 1W stamp). Chart bars before the first
219
228
  * shown row get NaN cells. Run rows before the first chart bar (the warm-up) are dropped.
220
229
  */
221
- export function projectRunRowsOntoChart(rows, chartTimes, runMs, waitForClose, sessionLattice = false) {
222
- const run = { intervalMs: runMs, sessionLattice };
230
+ export function projectRunRowsOntoChart(rows, chartTimes, runMs, waitForClose, sessionLattice = false, sessionLatticeId) {
231
+ const run = { intervalMs: runMs, sessionLattice, sessionLatticeId };
223
232
  const usable = rows.filter((row) => Array.isArray(row) && Number.isFinite(Number(row[0])));
224
233
  const width = usable.reduce((max, row) => Math.max(max, row.length), 1);
225
234
  const emptyCells = new Array(width - 1).fill(NaN);
@@ -244,10 +253,10 @@ export function projectRunRowsOntoChart(rows, chartTimes, runMs, waitForClose, s
244
253
  * bar's value first shows (its close with wait for close on, its open with it off, read by
245
254
  * runBarSpan), clamped to the chart's loaded bars.
246
255
  */
247
- export function projectRunTimeOntoChart(runTime, chartTimes, runMs, waitForClose, sessionLattice = false) {
256
+ export function projectRunTimeOntoChart(runTime, chartTimes, runMs, waitForClose, sessionLattice = false, sessionLatticeId) {
248
257
  if (chartTimes.length === 0)
249
258
  return runTime;
250
- const span = runBarSpan(runTime, { intervalMs: runMs, sessionLattice });
259
+ const span = runBarSpan(runTime, { intervalMs: runMs, sessionLattice, sessionLatticeId });
251
260
  const target = waitForClose ? span.close : span.open;
252
261
  const first = chartTimes[0];
253
262
  const last = chartTimes[chartTimes.length - 1];