@orangecharts/wrun-chart-host 0.11.1 → 0.15.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 (319) hide show
  1. package/README.md +1 -0
  2. package/dist/constants/feature-flags.constants.d.ts +4 -4
  3. package/dist/constants/feature-flags.constants.js +38 -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 +69 -3
  13. package/dist/host-env.js +21 -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 +52 -12
  18. package/dist/indicators/controls/tpo-session.util.js +113 -16
  19. package/dist/instances/script-engine-worker-ohlcv-transfer.d.ts +6 -0
  20. package/dist/instances/script-engine-worker-ohlcv-transfer.js +16 -0
  21. package/dist/interfaces/cme-realtime.interface.d.ts +8 -0
  22. package/dist/interfaces/cme-realtime.interface.js +2 -1
  23. package/dist/interfaces/feed.interface.d.ts +15 -1
  24. package/dist/interfaces/replay.interface.d.ts +5 -0
  25. package/dist/interfaces/stocks-realtime.interface.d.ts +4 -3
  26. package/dist/interfaces/stocks-realtime.interface.js +5 -4
  27. package/dist/interfaces/wrun-runtime.interface.d.ts +141 -20
  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 +5 -5
  35. package/dist/market-data/venues/opra.js +3 -3
  36. package/dist/market-data/venues/stocks.contract.copy.json +6 -5
  37. package/dist/market-data/venues/stocks.d.ts +5 -5
  38. package/dist/market-data/venues/stocks.js +21 -18
  39. package/dist/settings-templates/frvp-fields.d.ts +12 -1
  40. package/dist/settings-templates/frvp-fields.js +15 -4
  41. package/dist/settings-templates/index.js +12 -5
  42. package/dist/settings-templates/indicator-fields.js +43 -2
  43. package/dist/settings-templates/tool-rules.d.ts +17 -8
  44. package/dist/settings-templates/tool-rules.js +15 -8
  45. package/dist/settings-templates/tool-tables.generated.js +4 -2
  46. package/dist/utility/auth/server-clock.util.d.ts +3 -1
  47. package/dist/utility/auth/server-clock.util.js +3 -1
  48. package/dist/utility/chart/book-live-bucket.util.js +2 -2
  49. package/dist/utility/chart/cache-alignment.util.d.ts +38 -7
  50. package/dist/utility/chart/cache-alignment.util.js +50 -13
  51. package/dist/utility/chart/chart-data-fetch-generation.util.d.ts +2 -0
  52. package/dist/utility/chart/chart-data-fetch-generation.util.js +16 -0
  53. package/dist/utility/chart/cme-session-bucket.util.d.ts +18 -75
  54. package/dist/utility/chart/cme-session-bucket.util.js +25 -332
  55. package/dist/utility/chart/continuous-contracts.util.js +6 -5
  56. package/dist/utility/chart/display-offset.leaf.d.ts +24 -0
  57. package/dist/utility/chart/display-offset.leaf.js +41 -0
  58. package/dist/utility/chart/effective-chart-session.util.d.ts +2 -1
  59. package/dist/utility/chart/effective-chart-session.util.js +13 -5
  60. package/dist/utility/chart/feed-interval.util.d.ts +6 -20
  61. package/dist/utility/chart/feed-interval.util.js +13 -22
  62. package/dist/utility/chart/fetch-dedupe-policy.util.d.ts +27 -7
  63. package/dist/utility/chart/fetch-dedupe-policy.util.js +86 -11
  64. package/dist/utility/chart/footprint-band.util.d.ts +21 -5
  65. package/dist/utility/chart/footprint-band.util.js +53 -14
  66. package/dist/utility/chart/host-bar-placement.util.d.ts +7 -4
  67. package/dist/utility/chart/host-bar-placement.util.js +8 -2
  68. package/dist/utility/chart/indicator-inflight-registry.util.d.ts +32 -0
  69. package/dist/utility/chart/indicator-inflight-registry.util.js +52 -0
  70. package/dist/utility/chart/indicator-run-interval.util.d.ts +10 -4
  71. package/dist/utility/chart/indicator-run-interval.util.js +21 -12
  72. package/dist/utility/chart/interval-registry.util.d.ts +1 -1
  73. package/dist/utility/chart/interval-registry.util.js +1 -1
  74. package/dist/utility/chart/kscript-legend-entries.util.d.ts +12 -0
  75. package/dist/utility/chart/kscript-legend-entries.util.js +16 -0
  76. package/dist/utility/chart/kscript-run-interval-projection.util.d.ts +1 -1
  77. package/dist/utility/chart/kscript-run-interval-projection.util.js +4 -2
  78. package/dist/utility/chart/kscript-venue-policy.util.d.ts +53 -62
  79. package/dist/utility/chart/kscript-venue-policy.util.js +85 -94
  80. package/dist/utility/chart/live-bucket.util.d.ts +39 -17
  81. package/dist/utility/chart/live-bucket.util.js +103 -57
  82. package/dist/utility/chart/local-kscript-source-revalidation.util.d.ts +58 -20
  83. package/dist/utility/chart/local-kscript-source-revalidation.util.js +98 -23
  84. package/dist/utility/chart/local-kscript-warmup-depth.util.d.ts +35 -11
  85. package/dist/utility/chart/local-kscript-warmup-depth.util.js +24 -3
  86. package/dist/utility/chart/market-session-schedule.util.d.ts +8 -0
  87. package/dist/utility/chart/market-session-schedule.util.js +39 -1
  88. package/dist/utility/chart/market-session.util.d.ts +136 -0
  89. package/dist/utility/chart/market-session.util.js +341 -0
  90. package/dist/utility/chart/om-panel.util.d.ts +5 -3
  91. package/dist/utility/chart/om-panel.util.js +42 -7
  92. package/dist/utility/chart/om-target.util.d.ts +14 -1
  93. package/dist/utility/chart/om-target.util.js +22 -5
  94. package/dist/utility/chart/opra-read-access.leaf.d.ts +16 -1
  95. package/dist/utility/chart/opra-read-access.leaf.js +22 -0
  96. package/dist/utility/chart/profile-row-height.util.d.ts +49 -16
  97. package/dist/utility/chart/profile-row-height.util.js +74 -37
  98. package/dist/utility/chart/rth-session.util.d.ts +55 -20
  99. package/dist/utility/chart/rth-session.util.js +94 -46
  100. package/dist/utility/chart/session-lattice.util.d.ts +150 -0
  101. package/dist/utility/chart/session-lattice.util.js +488 -0
  102. package/dist/utility/chart/trading-day.util.d.ts +40 -2
  103. package/dist/utility/chart/trading-day.util.js +84 -7
  104. package/dist/utility/chart/us-equities-session.util.d.ts +32 -11
  105. package/dist/utility/chart/us-equities-session.util.js +44 -15
  106. package/dist/utility/chart/window-geometry.leaf.d.ts +28 -7
  107. package/dist/utility/chart/window-geometry.leaf.js +57 -8
  108. package/dist/utility/chart/wrun-bar-session-facts.util.d.ts +21 -14
  109. package/dist/utility/chart/wrun-bar-session-facts.util.js +32 -38
  110. package/dist/utility/chart/wrun-run-result.util.d.ts +38 -13
  111. package/dist/utility/chart/wrun-run-result.util.js +97 -27
  112. package/dist/utility/common/time.util.js +5 -4
  113. package/dist/utility/market-events/earnings-scope.util.d.ts +10 -5
  114. package/dist/utility/market-events/earnings-scope.util.js +17 -9
  115. package/dist/utility/market-events/market-events.util.d.ts +14 -7
  116. package/dist/utility/market-events/market-events.util.js +30 -17
  117. package/dist/utility/number-format.util.d.ts +14 -21
  118. package/dist/utility/number-format.util.js +38 -24
  119. package/dist/utility/options/option-venue-disclosure.util.d.ts +40 -6
  120. package/dist/utility/options/option-venue-disclosure.util.js +71 -11
  121. package/dist/utility/options/option-venue.util.d.ts +1 -1
  122. package/dist/utility/options/option-venue.util.js +1 -1
  123. package/dist/utility/pool-symbol.leaf.d.ts +7 -0
  124. package/dist/utility/pool-symbol.leaf.js +50 -5
  125. package/dist/utility/stocks/stock-display.util.d.ts +15 -0
  126. package/dist/utility/stocks/stock-display.util.js +37 -0
  127. package/dist/utility/symbol-selection/contract-expiry.util.js +5 -4
  128. package/dist/utility/v2/gate-plane.util.d.ts +6 -0
  129. package/dist/utility/v2/gate-plane.util.js +11 -1
  130. package/dist/utility/v2/gate-session-latch.util.d.ts +1 -1
  131. package/dist/utility/v2/gate-session-latch.util.js +3 -3
  132. package/dist/utility/v2/governed-tier.leaf.d.ts +17 -16
  133. package/dist/utility/v2/governed-tier.leaf.js +17 -16
  134. package/dist/utility/v2/stocks-governed.util.d.ts +5 -0
  135. package/dist/utility/v2/stocks-governed.util.js +14 -0
  136. package/dist/utility/v2/v2-enums.leaf.d.ts +13 -0
  137. package/dist/utility/v2/v2-enums.leaf.js +458 -0
  138. package/dist/utility/wrun/derived-roots.leaf.d.ts +21 -1
  139. package/dist/utility/wrun/derived-roots.leaf.js +27 -1
  140. package/dist/utility/wrun/derived-roots.util.d.ts +44 -32
  141. package/dist/utility/wrun/derived-roots.util.js +97 -56
  142. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.d.ts +4 -3
  143. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.js +4 -3
  144. package/dist/utility/wrun/sources/lanes/option_daily.d.ts +2 -1
  145. package/dist/utility/wrun/sources/lanes/option_daily.js +2 -1
  146. package/dist/utility/wrun/sources/lanes/options_flow.d.ts +3 -0
  147. package/dist/utility/wrun/sources/lanes/options_flow.js +23 -5
  148. package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +3 -4
  149. package/dist/utility/wrun/sources/row-lane-registry.js +9 -4
  150. package/dist/utility/wrun/sources/row-lanes/dark_pool.d.ts +19 -0
  151. package/dist/utility/wrun/sources/row-lanes/dark_pool.js +104 -0
  152. package/dist/utility/wrun/sources/row-lanes/index.js +2 -0
  153. package/dist/utility/wrun/sources/wrun-lane-fetch-abort.util.d.ts +20 -0
  154. package/dist/utility/wrun/sources/wrun-lane-fetch-abort.util.js +103 -0
  155. package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +19 -2
  156. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +15 -13
  157. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +49 -23
  158. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +14 -9
  159. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +75 -27
  160. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +139 -82
  161. package/dist/utility/wrun/wrun-app-layer.leaf.d.ts +78 -0
  162. package/dist/utility/wrun/wrun-app-layer.leaf.js +89 -0
  163. package/dist/utility/wrun/wrun-bar-count.util.d.ts +11 -7
  164. package/dist/utility/wrun/wrun-bar-count.util.js +12 -8
  165. package/dist/utility/wrun/wrun-batched-kinds.leaf.d.ts +13 -0
  166. package/dist/utility/wrun/wrun-batched-kinds.leaf.js +18 -0
  167. package/dist/utility/wrun/wrun-batched-marks.util.d.ts +46 -23
  168. package/dist/utility/wrun/wrun-batched-marks.util.js +260 -62
  169. package/dist/utility/wrun/wrun-batched-readout.util.d.ts +26 -19
  170. package/dist/utility/wrun/wrun-batched-readout.util.js +81 -27
  171. package/dist/utility/wrun/wrun-book-bands.leaf.d.ts +8 -0
  172. package/dist/utility/wrun/wrun-book-bands.leaf.js +7 -0
  173. package/dist/utility/wrun/wrun-candle-equal.leaf.d.ts +19 -0
  174. package/dist/utility/wrun/wrun-candle-equal.leaf.js +40 -0
  175. package/dist/utility/wrun/wrun-canvas-readout.util.d.ts +4 -2
  176. package/dist/utility/wrun/wrun-canvases.util.d.ts +24 -7
  177. package/dist/utility/wrun/wrun-canvases.util.js +99 -30
  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-hover.util.d.ts +8 -2
  209. package/dist/utility/wrun/wrun-hover.util.js +24 -13
  210. package/dist/utility/wrun/wrun-inert-legend.util.d.ts +13 -0
  211. package/dist/utility/wrun/wrun-inert-legend.util.js +31 -3
  212. package/dist/utility/wrun/wrun-input-requirements.leaf.d.ts +7 -5
  213. package/dist/utility/wrun/wrun-input-requirements.leaf.js +16 -6
  214. package/dist/utility/wrun/wrun-install-pacer.util.d.ts +26 -0
  215. package/dist/utility/wrun/wrun-install-pacer.util.js +145 -0
  216. package/dist/utility/wrun/wrun-kit-refusal-stages.types.d.ts +22 -0
  217. package/dist/utility/wrun/wrun-kit-refusal-stages.types.js +1 -0
  218. package/dist/utility/wrun/wrun-lane-refusal.leaf.d.ts +12 -5
  219. package/dist/utility/wrun/wrun-lane-refusal.leaf.js +23 -5
  220. package/dist/utility/wrun/wrun-lane-warmup.util.js +22 -4
  221. package/dist/utility/wrun/wrun-leg-close.util.d.ts +6 -5
  222. package/dist/utility/wrun/wrun-leg-close.util.js +11 -9
  223. package/dist/utility/wrun/wrun-leg-fetch.util.d.ts +3 -1
  224. package/dist/utility/wrun/wrun-leg-fetch.util.js +9 -2
  225. package/dist/utility/wrun/wrun-levels-child.util.d.ts +2 -0
  226. package/dist/utility/wrun/wrun-levels-child.util.js +6 -0
  227. package/dist/utility/wrun/wrun-lifecycle.contract.d.ts +4 -0
  228. package/dist/utility/wrun/wrun-live-intake.util.d.ts +15 -6
  229. package/dist/utility/wrun/wrun-live-intake.util.js +167 -47
  230. package/dist/utility/wrun/wrun-live-tick.util.d.ts +52 -8
  231. package/dist/utility/wrun/wrun-live-tick.util.js +655 -97
  232. package/dist/utility/wrun/wrun-market-facts.util.d.ts +16 -2
  233. package/dist/utility/wrun/wrun-market-facts.util.js +32 -3
  234. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +27 -27
  235. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +28 -16
  236. package/dist/utility/wrun/wrun-market-size-defaults.util.js +34 -5
  237. package/dist/utility/wrun/wrun-oi-lane.util.d.ts +10 -7
  238. package/dist/utility/wrun/wrun-oi-lane.util.js +16 -10
  239. package/dist/utility/wrun/wrun-option-strike-flow.util.js +1 -1
  240. package/dist/utility/wrun/wrun-option-views.util.d.ts +2 -2
  241. package/dist/utility/wrun/wrun-option-views.util.js +5 -2
  242. package/dist/utility/wrun/wrun-options-flow-underlying.leaf.d.ts +5 -0
  243. package/dist/utility/wrun/wrun-options-flow-underlying.leaf.js +16 -0
  244. package/dist/utility/wrun/wrun-options-stop.util.d.ts +3 -2
  245. package/dist/utility/wrun/wrun-options-stop.util.js +6 -4
  246. package/dist/utility/wrun/wrun-output-words.util.d.ts +14 -0
  247. package/dist/utility/wrun/wrun-output-words.util.js +51 -0
  248. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +116 -11
  249. package/dist/utility/wrun/wrun-overlay-drivers.util.js +208 -43
  250. package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +20 -10
  251. package/dist/utility/wrun/wrun-overlay-park.util.d.ts +84 -0
  252. package/dist/utility/wrun/wrun-overlay-park.util.js +135 -0
  253. package/dist/utility/wrun/wrun-overlay-recovery.util.d.ts +37 -4
  254. package/dist/utility/wrun/wrun-overlay-recovery.util.js +26 -14
  255. package/dist/utility/wrun/wrun-overlay-result.util.d.ts +6 -1
  256. package/dist/utility/wrun/wrun-overlay-result.util.js +2 -0
  257. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +247 -26
  258. package/dist/utility/wrun/wrun-overlay-run.util.js +2234 -408
  259. package/dist/utility/wrun/wrun-pack.util.d.ts +8 -5
  260. package/dist/utility/wrun/wrun-panel-mount.util.d.ts +11 -2
  261. package/dist/utility/wrun/wrun-panel-mount.util.js +122 -19
  262. package/dist/utility/wrun/wrun-panel-style.util.d.ts +4 -2
  263. package/dist/utility/wrun/wrun-panel-style.util.js +3 -2
  264. package/dist/utility/wrun/wrun-pin-spelling.util.d.ts +7 -0
  265. package/dist/utility/wrun/wrun-pin-spelling.util.js +18 -4
  266. package/dist/utility/wrun/wrun-pin-venues.util.d.ts +26 -17
  267. package/dist/utility/wrun/wrun-pin-venues.util.js +43 -36
  268. package/dist/utility/wrun/wrun-pinned-lanes.util.d.ts +58 -0
  269. package/dist/utility/wrun/wrun-pinned-lanes.util.js +72 -0
  270. package/dist/utility/wrun/wrun-prefix-cohort.util.js +2 -1
  271. package/dist/utility/wrun/wrun-prefix-lanes.util.d.ts +22 -9
  272. package/dist/utility/wrun/wrun-prefix-lanes.util.js +145 -26
  273. package/dist/utility/wrun/wrun-prefix-proof.util.d.ts +29 -0
  274. package/dist/utility/wrun/wrun-prefix-proof.util.js +23 -5
  275. package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +9 -1
  276. package/dist/utility/wrun/wrun-refusal-surface.util.js +15 -1
  277. package/dist/utility/wrun/wrun-refusal.util.d.ts +19 -1
  278. package/dist/utility/wrun/wrun-refusal.util.js +103 -16
  279. package/dist/utility/wrun/wrun-registry-errors.util.d.ts +20 -6
  280. package/dist/utility/wrun/wrun-registry-errors.util.js +20 -6
  281. package/dist/utility/wrun/wrun-replay-rows.util.js +6 -10
  282. package/dist/utility/wrun/wrun-run-health.util.d.ts +95 -5
  283. package/dist/utility/wrun/wrun-run-health.util.js +209 -3
  284. package/dist/utility/wrun/wrun-run-interval-session.util.d.ts +2 -2
  285. package/dist/utility/wrun/wrun-run-interval-session.util.js +2 -2
  286. package/dist/utility/wrun/wrun-run-interval.util.d.ts +9 -8
  287. package/dist/utility/wrun/wrun-run-interval.util.js +13 -11
  288. package/dist/utility/wrun/wrun-sandbox-row-source.js +5 -2
  289. package/dist/utility/wrun/wrun-script-inputs.util.d.ts +38 -11
  290. package/dist/utility/wrun/wrun-script-inputs.util.js +194 -56
  291. package/dist/utility/wrun/wrun-session-composition.util.d.ts +81 -0
  292. package/dist/utility/wrun/wrun-session-composition.util.js +169 -0
  293. package/dist/utility/wrun/wrun-setting-words.util.d.ts +10 -7
  294. package/dist/utility/wrun/wrun-setting-words.util.js +25 -7
  295. package/dist/utility/wrun/wrun-source-rows.util.d.ts +94 -28
  296. package/dist/utility/wrun/wrun-source-rows.util.js +738 -93
  297. package/dist/utility/wrun/wrun-stream-clock.util.d.ts +45 -0
  298. package/dist/utility/wrun/wrun-stream-clock.util.js +108 -0
  299. package/dist/utility/wrun/wrun-style-names.util.d.ts +23 -0
  300. package/dist/utility/wrun/wrun-style-names.util.js +74 -0
  301. package/dist/utility/wrun/wrun-tape-coins.util.d.ts +116 -0
  302. package/dist/utility/wrun/wrun-tape-coins.util.js +110 -0
  303. package/dist/utility/wrun/wrun-tape-source.util.d.ts +62 -32
  304. package/dist/utility/wrun/wrun-tape-source.util.js +72 -34
  305. package/dist/utility/wrun/wrun-tier-grid.util.d.ts +13 -5
  306. package/dist/utility/wrun/wrun-tier-grid.util.js +23 -13
  307. package/dist/utility/wrun/wrun-tpo-rows.util.js +2 -1
  308. package/dist/utility/wrun/wrun-trades-lane.util.d.ts +73 -0
  309. package/dist/utility/wrun/wrun-trades-lane.util.js +82 -0
  310. package/dist/utility/wrun/wrun-twin-compute-inputs.util.d.ts +5 -0
  311. package/dist/utility/wrun/wrun-twin-compute-inputs.util.js +9 -2
  312. package/dist/utility/wrun/wrun-visibility-table.d.ts +13 -0
  313. package/dist/utility/wrun/wrun-visibility-table.js +9 -0
  314. package/dist/utility/wrun/wrun-volume-profile.util.js +7 -3
  315. package/dist/utils/replay/replay-buffer-math.d.ts +16 -6
  316. package/dist/utils/replay/replay-buffer-math.js +60 -30
  317. package/dist/workers/constants/socket-slots.d.ts +11 -7
  318. package/dist/workers/constants/socket-slots.js +6 -5
  319. package/package.json +5 -5
@@ -0,0 +1,103 @@
1
+ /**
2
+ * The abort signal a lane's OWN fetch reads (`WrunPollLaneFetchAsk.signal`): one per overlay, aborted when the overlay
3
+ * leaves its chart or pauses (the drivers' live teardown hook, both causes) and when its chart's dataset ends (the
4
+ * fetch-generation bump every `cancelFetchDataOfChart` drives: an interval or symbol switch in place, a refetch, a
5
+ * teardown), so a lane whose fetch is a long scan (the `dark_pool` row lane's day reads of the stocks tape) stops with
6
+ * the picture it was asked for instead of reading on for nothing and holding the overlay's next run back. A chart
7
+ * fetch never reads it: the chart's own fetch door cancels its reads with the chart.
8
+ *
9
+ * A consumer (the run, the live reconcile, a prefix page) takes its signal once, when it starts, scoped to the chart
10
+ * and the generation it planned under: a teardown or a dataset end meanwhile aborts what it holds, and a consumer whose
11
+ * generation already ended takes an aborted signal and leaves nothing in the map. The next consumer after an abort
12
+ * takes a fresh signal.
13
+ *
14
+ * The hooks register with the first signal handed out (a module that merely imports this one registers nothing), and
15
+ * a node spec's partial mock of the drivers util is tolerated: the registration is retried at the next ask.
16
+ */
17
+ import { getChartDataFetchGeneration, onChartDataFetchGenerationBump, } from '../../chart/chart-data-fetch-generation.util.js';
18
+ import { onWrunOverlayLiveTeardown } from '../wrun-overlay-drivers.util.js';
19
+ const controllers = new Map();
20
+ let teardownRegistered = false;
21
+ let datasetEndOff;
22
+ function registerHooks() {
23
+ if (!teardownRegistered) {
24
+ try {
25
+ onWrunOverlayLiveTeardown((indicatorId) => abortWrunLaneFetches(indicatorId));
26
+ teardownRegistered = true;
27
+ }
28
+ catch {
29
+ // A partial mock of the drivers util: retried at the next ask.
30
+ }
31
+ }
32
+ if (datasetEndOff === undefined) {
33
+ try {
34
+ datasetEndOff = onChartDataFetchGenerationBump((chartIndex) => abortWrunLaneFetchesOfChart(chartIndex));
35
+ }
36
+ catch {
37
+ // A partial mock of the generation leaf: retried at the next ask.
38
+ }
39
+ }
40
+ }
41
+ function abortedSignal(reason) {
42
+ const controller = new AbortController();
43
+ controller.abort(new DOMException(reason, 'AbortError'));
44
+ return controller.signal;
45
+ }
46
+ /**
47
+ * The overlay's own-fetch signal: live until the overlay leaves its chart or pauses, or the scope's chart dataset ends,
48
+ * then a fresh one. With a scope whose generation is not the chart's any more, an aborted signal and no entry.
49
+ */
50
+ export function wrunLaneFetchSignal(indicatorId, scope) {
51
+ registerHooks();
52
+ if (scope !== undefined && getChartDataFetchGeneration(scope.chartIndex) !== scope.generation) {
53
+ return abortedSignal(`wrun overlay '${indicatorId}' asked for a dataset its chart replaced`);
54
+ }
55
+ if (scope?.isCurrent !== undefined && !scope.isCurrent()) {
56
+ return abortedSignal(`wrun overlay '${indicatorId}' asked after its run was superseded`);
57
+ }
58
+ let entry = controllers.get(indicatorId);
59
+ // An overlay asked on another chart than its signal's left that chart: what it still reads there stops.
60
+ if (entry !== undefined &&
61
+ scope !== undefined &&
62
+ entry.chartIndex !== undefined &&
63
+ entry.chartIndex !== scope.chartIndex) {
64
+ abortWrunLaneFetches(indicatorId);
65
+ entry = undefined;
66
+ }
67
+ if (entry === undefined || entry.controller.signal.aborted) {
68
+ entry = { controller: new AbortController(), chartIndex: scope?.chartIndex };
69
+ controllers.set(indicatorId, entry);
70
+ }
71
+ else if (entry.chartIndex === undefined && scope !== undefined) {
72
+ entry.chartIndex = scope.chartIndex;
73
+ }
74
+ return entry.controller.signal;
75
+ }
76
+ /** Abort every own fetch of an overlay still out (the teardown hook's): their reads stop, their answers land nowhere. */
77
+ export function abortWrunLaneFetches(indicatorId) {
78
+ const entry = controllers.get(indicatorId);
79
+ if (entry === undefined)
80
+ return;
81
+ controllers.delete(indicatorId);
82
+ entry.controller.abort(new DOMException(`wrun overlay '${indicatorId}' left its chart`, 'AbortError'));
83
+ }
84
+ /** Abort the own fetches of every overlay on a chart whose dataset ended (the generation bump's). */
85
+ export function abortWrunLaneFetchesOfChart(chartIndex) {
86
+ for (const [indicatorId, entry] of [...controllers]) {
87
+ if (entry.chartIndex !== chartIndex)
88
+ continue;
89
+ controllers.delete(indicatorId);
90
+ entry.controller.abort(new DOMException(`chart ${chartIndex}'s dataset ended`, 'AbortError'));
91
+ }
92
+ }
93
+ /** Test seam: whether an overlay holds a signal in the map. */
94
+ export function __wrunLaneFetchSignalHeldForTests(indicatorId) {
95
+ return controllers.has(indicatorId);
96
+ }
97
+ /** Test seam: forget every signal and the hooks' registration. */
98
+ export function __resetWrunLaneFetchAbortsForTests() {
99
+ controllers.clear();
100
+ teardownRegistered = false;
101
+ datasetEndOff?.();
102
+ datasetEndOff = undefined;
103
+ }
@@ -39,6 +39,7 @@
39
39
  * planned; `forming` views and bindings are refused by the kit.
40
40
  */
41
41
  import type { OpraOptionPlaneStop } from '../../../host-ports.types.js';
42
+ import type { OpraReadFacts } from '../../chart/opra-read-access.leaf.js';
42
43
  import type { WrunInputSource } from '../../../interfaces/wrun-runtime.interface.js';
43
44
  import type { GateProvider } from '../../../workers/constants/socket-slots.js';
44
45
  import type { WrunDailyLanding } from '../wrun-daily-lane.util.js';
@@ -49,7 +50,7 @@ import type { WrunRowLaneChain, WrunRowLaneHorizon } from './wrun-row-lane.types
49
50
  * that the interface does not name yet (`asset`, `publisher`, `series`, ...), as `unknown`. */
50
51
  export type WrunPollLaneSource = WrunInputSource & Readonly<Record<string, unknown>>;
51
52
  /** The chart a lane is planned against, and the input being planned. */
52
- export interface WrunPollLaneContext {
53
+ export interface WrunPollLaneContext extends OpraReadFacts {
53
54
  /** The input's declared name (every refusal names it). */
54
55
  inputName: string;
55
56
  /** The input's source class (the lane's own; carried so a refusal can name it). */
@@ -64,6 +65,9 @@ export interface WrunPollLaneContext {
64
65
  category?: number;
65
66
  /** The chart's bar interval in ms. */
66
67
  intervalMs: number;
68
+ /** The chart market's metadata whole (its feed fields), for a lane whose resolver reads more than the market (a
69
+ * `stocks` row lane). Opaque to the planners; absent outside a run's plan. */
70
+ chartMetadata?: Readonly<Record<string, unknown>>;
67
71
  /** The chart is index-mode (a stock, forex, commodity or DEX chart): only a `global` lane is
68
72
  * planned there, and the chart's coin is not a crypto asset a lane may default to. */
69
73
  indexMode: boolean;
@@ -100,6 +104,9 @@ export interface WrunPollLaneContext {
100
104
  plane: GateProvider | null;
101
105
  opraStop?: OpraOptionPlaneStop;
102
106
  };
107
+ /** The crypto venue word a contract F root's chain is read under (derived-roots.util `wrunUnderlyingLaneContext`: the
108
+ * chart's own crypto venue when its listing names the root), for a lane whose `venue` knob names no chain. */
109
+ underlyingVenue?: string;
103
110
  /**
104
111
  * The run's plan as an identity: one object per `planWrunPollLanes` call, the same for every input it plans. A lane
105
112
  * keys a resolution every input of the run shares by it (a `WeakMap`: a `chain` lane's chart, its chain and its
@@ -160,10 +167,20 @@ export interface WrunPollLaneFetchAsk {
160
167
  toTs: number;
161
168
  /** The grid's bar interval, ms (the run interval on a run at another interval). */
162
169
  intervalMs: number;
170
+ /** The run clock's now, the instant the plan's horizon was cut at (absent: the lane reads the server clock). */
171
+ nowMs?: number;
172
+ /** The host bars the ask reaches on the chart's session grid, each its span (wrun-tier-grid `wrunHostBarSpansWithin`):
173
+ * a lane marks a bar by a row inside it. Absent: the lane steps `intervalMs` from its own times. */
174
+ hostBars?: ReadonlyArray<{
175
+ fromMs: number;
176
+ toMs: number;
177
+ }>;
163
178
  /** Told, once the answer is in, whether it is the whole window: true when the source said nothing more follows,
164
179
  * false when the answer ended early (the source named more without a way to it). A lane that cannot tell never
165
180
  * calls it; a caller that needs the verdict (a wrun prefix page) reads its absence as not whole. */
166
181
  onComplete?: (complete: boolean) => void;
182
+ /** Aborted when the overlay leaves its chart or pauses (wrun-lane-fetch-abort.util): a long scan stops with it. */
183
+ signal?: AbortSignal;
167
184
  }
168
185
  /** A lane's live channel (`WrunPollLane.live`; contract in `wrun-series-stream.util.ts`): its ask,
169
186
  * its sink (rows on the grid's bar opens, reopens, spans it cannot vouch for, re-plans) and its
@@ -256,7 +273,7 @@ export interface WrunPollLane {
256
273
  * (`wrunLaneChainPlaneOf`):
257
274
  * - `opra`: the OPRA wall (before the chain is resolved on a chart whose options ride the plane), the plane and its
258
275
  * routed tier in the ask, the overlay's OPRA provenance and the legend's delayed-tier note, as an `opra` lane's;
259
- * - `cme`: the CME display wall (OpenMarket's own packages only) and the routed tier in the ask (`servedTier`);
276
+ * - `cme`: the CME chain wall (`mayReadCmeChain`) and the routed tier in the ask (`servedTier`);
260
277
  * - `plain` (a crypto options venue): nothing beside the lane's own fields.
261
278
  * It is admitted on every chart (a chart with no chain refuses by name in its `plan`) and rides the native-rows path
262
279
  * on every plane (`nativeRows`: its rows are its chain's, never the chart market's). The registry refuses it beside
@@ -40,7 +40,7 @@
40
40
  * naming `tierChoice: 'coarsest'`, the coarsest that already serves the bar.
41
41
  */
42
42
  import type { WrunIndicatorMetadata, WrunInputSource, WrunMetadataParam } from '../../../interfaces/wrun-runtime.interface.js';
43
- import type { OpraReadFacts } from '../../chart/opra-read-access.leaf.js';
43
+ import { type OpraReadFacts } from '../../chart/opra-read-access.leaf.js';
44
44
  import type { OpraOptionPlaneStop } from '../../../host-ports.types.js';
45
45
  import { type WrunRunOptionsMarket } from '../derived-roots.util.js';
46
46
  import { type WrunRefusalSeed } from '../wrun-refusal.util.js';
@@ -69,6 +69,8 @@ export declare function planWrunPollLaneInputs(metadata: WrunIndicatorMetadata):
69
69
  /** A value's canonical text: object keys sorted at every depth, `undefined` members dropped (the instance key's
70
70
  * suffix, here and for the row lanes). */
71
71
  export declare function stableJson(value: unknown): string;
72
+ /** The extras field naming a contract F root's market (`planWrunLaneUnderlying`'s key), absent on the chart's own reads. */
73
+ export declare const WRUN_POLL_LANE_UNDERLYING_FIELD = "underlyingMarket";
72
74
  /** The id of the lane instance `extras` names: `poll:<laneKey>` when the ask carries no extras,
73
75
  * else the extras' canonical text appended, so equal asks are ONE instance whatever order
74
76
  * their fields were written in and different asks never collide. */
@@ -76,11 +78,11 @@ export declare function wrunPollLaneInstanceKey(laneKey: string, extras: Readonl
76
78
  /** Why a lane reading the chart's market is not served on an index-mode chart, as its refusal
77
79
  * says it: such a chart serves candles, time and the global series (named by class). */
78
80
  export declare function wrunPollLaneIndexModeReason(): string;
79
- /** What the run hands the poll planner beside the chart: its OPRA facts (`mayReadOpra`: who may read the plane)
80
- * and the predicate an `opra` lane is admitted by (`isOpraPlaneExchange`, over the chart market's exchange and
81
- * symbol: the chart's options ride the OPRA plane, a US stock or ETF chart under either venue spelling while the
82
- * `opra` flag is lit, an OPRA contract chart, a stock twin reading its stock's chain; absent, no chart is judged off
83
- * the plane). */
81
+ /** What the run hands the poll planner beside the chart: its plane facts (`mayReadOpra`: who may read the OPRA plane;
82
+ * `mayReadCmeChain`: who may read a CME chain) and the predicate an `opra` lane is admitted by (`isOpraPlaneExchange`,
83
+ * over the chart market's exchange and symbol: the chart's options ride the OPRA plane, a US stock or ETF chart under
84
+ * either venue spelling while the `opra` flag is lit, an OPRA contract chart, a stock twin reading its stock's chain;
85
+ * absent, no chart is judged off the plane). */
84
86
  export interface WrunPollLaneRunFacts extends OpraReadFacts {
85
87
  isOpraPlaneExchange?: (exchange: string, symbol: string) => boolean;
86
88
  /** Why a chart off the plane is off it although its options list on OPRA (opra-options-gate.util
@@ -272,12 +274,12 @@ export type WrunPollLanePlanResult = WrunPollLanePlan & WrunPollLaneInstance[];
272
274
  * A `chain` lane (the chart's options chain on whichever plane it lists on) is admitted on every chart its options are
273
275
  * not stopped on: its `plan` resolves the chain through the one chain resolver. It meets the OPRA wall before its
274
276
  * `plan` runs where the chart's options list on OPRA (every chain it reads there is OPRA's), and each instance then
275
- * meets its own plane's wall (`assertWrunLaneChainPlaneReadable`: OPRA's, the CME display wall, none for a crypto
277
+ * meets its own plane's wall (`assertWrunLaneChainPlaneReadable`: OPRA's, the CME chain wall, none for a crypto
276
278
  * chain). On a chart whose options list on OPRA but ride no plane for a known reason (`run.opraPlaneStop`) it keeps an
277
279
  * `opra` lane's rules (`wrunChainLaneStop`, the row lanes' one rule): a declared fill drops the input with the stop's
278
- * note, any other input refuses with it, and no chain is resolved past the stop. Its context carries the run's OPRA
279
- * facts (the chain decision's `auto` reads them), the chart's category, the plane verdict (`opraPlane`: a lane reading
280
- * by coin there reads no chain directory) and the plan's `runScope` (its inputs share one chart resolution).
280
+ * note, any other input refuses with it, and no chain is resolved past the stop. Its context carries the run's plane
281
+ * facts (the chain decision's `auto` reads the OPRA ones), the chart's category, the plane verdict (`opraPlane`: a lane
282
+ * reading by coin there reads no chain directory) and the plan's `runScope` (its inputs share one chart resolution).
281
283
  *
282
284
  * A chart with no option chain (a LINK perp, a forex pair, a stock listing no options) does not serve an options feed:
283
285
  * an input whose lane's `plan` refuses so (`wrunLaneNoChainRefusal`: the record's `no-options` / `chain`) meets the
@@ -308,9 +310,9 @@ export declare function planWrunPollLaneInstances(metadata: WrunIndicatorMetadat
308
310
  }, isIndexModeExchange?: (exchange: string) => boolean, isCryptoVenueExchange?: (exchange: string) => boolean, run?: WrunPollLaneRunFacts): Promise<WrunPollLaneInstance[]>;
309
311
  /**
310
312
  * A chain instance against its own plane's wall, by the plane and the exchange its chain lists on: an OPRA chain the
311
- * OPRA wall (`mayReadOpra`), a CME chain the CME display wall (OpenMarket's own packages only, the run door's rule on
312
- * a CME chart, kscript-venue-policy.util; the `opra-user-scripts` flag never opens it), a crypto chain (`plain`)
313
- * none. The row lanes keep the same rule (wrun-row-lanes.util), in the same words.
313
+ * OPRA wall (`mayReadOpra`), a CME chain the CME chain wall (`mayReadCmeChain`: an official run, or a CME chart study;
314
+ * the `opra-user-scripts` flag never opens it), a crypto chain (`plain`) none. The row lanes, the options chain lane
315
+ * and a CME root read through `underlying` meet this one rule, in the same words.
314
316
  */
315
317
  export declare function assertWrunLaneChainPlaneReadable(plane: WrunLaneChainPlane | undefined, exchange: string, run: OpraReadFacts | undefined, ctx: Pick<WrunPollLaneContext, 'inputName' | 'sourceClass'>): void;
316
318
  /** The exchange a chain-lane instance's chain lists on (the payload field its `chain` names); '' for any other lane
@@ -1,4 +1,5 @@
1
- import { wrunUnderlyingLaneContext } from '../derived-roots.util.js';
1
+ import { mayReadCmeChain, planeReadFactsOf } from '../../chart/opra-read-access.leaf.js';
2
+ import { planWrunLaneUnderlying, resolveWrunUnderlyingSettingKnob, wrunTakesUnderlying, wrunUnderlyingLaneContext, } from '../derived-roots.util.js';
2
3
  import { wrunParamChoices } from '../wrun-color-settings.util.js';
3
4
  import { isWrunOptionsChainCryptoVenueWord } from '../wrun-options-chain.util.js';
4
5
  import { refuseWrunOptionKnob } from '../wrun-option-knobs.util.js';
@@ -59,6 +60,8 @@ export function stableJson(value) {
59
60
  }
60
61
  return JSON.stringify(value) ?? 'null';
61
62
  }
63
+ /** The extras field naming a contract F root's market (`planWrunLaneUnderlying`'s key), absent on the chart's own reads. */
64
+ export const WRUN_POLL_LANE_UNDERLYING_FIELD = 'underlyingMarket';
62
65
  /** The id of the lane instance `extras` names: `poll:<laneKey>` when the ask carries no extras,
63
66
  * else the extras' canonical text appended, so equal asks are ONE instance whatever order
64
67
  * their fields were written in and different asks never collide. */
@@ -410,12 +413,12 @@ function wrunPollLanePlanResult(lanes, missingFeeds) {
410
413
  * A `chain` lane (the chart's options chain on whichever plane it lists on) is admitted on every chart its options are
411
414
  * not stopped on: its `plan` resolves the chain through the one chain resolver. It meets the OPRA wall before its
412
415
  * `plan` runs where the chart's options list on OPRA (every chain it reads there is OPRA's), and each instance then
413
- * meets its own plane's wall (`assertWrunLaneChainPlaneReadable`: OPRA's, the CME display wall, none for a crypto
416
+ * meets its own plane's wall (`assertWrunLaneChainPlaneReadable`: OPRA's, the CME chain wall, none for a crypto
414
417
  * chain). On a chart whose options list on OPRA but ride no plane for a known reason (`run.opraPlaneStop`) it keeps an
415
418
  * `opra` lane's rules (`wrunChainLaneStop`, the row lanes' one rule): a declared fill drops the input with the stop's
416
- * note, any other input refuses with it, and no chain is resolved past the stop. Its context carries the run's OPRA
417
- * facts (the chain decision's `auto` reads them), the chart's category, the plane verdict (`opraPlane`: a lane reading
418
- * by coin there reads no chain directory) and the plan's `runScope` (its inputs share one chart resolution).
419
+ * note, any other input refuses with it, and no chain is resolved past the stop. Its context carries the run's plane
420
+ * facts (the chain decision's `auto` reads the OPRA ones), the chart's category, the plane verdict (`opraPlane`: a lane
421
+ * reading by coin there reads no chain directory) and the plan's `runScope` (its inputs share one chart resolution).
419
422
  *
420
423
  * A chart with no option chain (a LINK perp, a forex pair, a stock listing no options) does not serve an options feed:
421
424
  * an input whose lane's `plan` refuses so (`wrunLaneNoChainRefusal`: the record's `no-options` / `chain`) meets the
@@ -461,12 +464,10 @@ export async function planWrunPollLanes(metadata, chart, isIndexModeExchange = (
461
464
  sourceClass: planned.lane.sourceClass,
462
465
  indexMode: indexModeChart,
463
466
  cryptoVenue,
464
- // The run's OPRA facts reach the plan of a lane that reads OPRA (`opra`) or may (a `chain` lane: its chain
465
- // decision's `auto` reads them), the lanes the decision concerns; every other lane's context is as it always
466
- // was. Absent reads closed.
467
- ...(run !== undefined && (planned.lane.opra === true || chainLane)
468
- ? { official: run.official === true, opraUserScripts: run.opraUserScripts === true }
469
- : {}),
467
+ // The run's plane facts reach the plan of a lane that reads OPRA (`opra`) or may (a `chain` lane: its chain
468
+ // decision's `auto` reads them, its CME chain the CME chain fact), the lanes the decisions concern; every other
469
+ // lane's context is as it always was. Absent reads closed.
470
+ ...(run !== undefined && (planned.lane.opra === true || chainLane) ? planeReadFactsOf(run) : {}),
470
471
  ...(chainLane ? { runScope, opraPlane: plane.onPlane } : {}),
471
472
  };
472
473
  // A chain lane reads the run's one options market: a stock twin's stock in place of the chart's
@@ -490,11 +491,24 @@ export async function planWrunPollLanes(metadata, chart, isIndexModeExchange = (
490
491
  continue;
491
492
  }
492
493
  let answered;
494
+ let underlyingKey;
493
495
  try {
496
+ const params = metadata.params ?? [];
497
+ const declared = planned.source;
498
+ // Contract F: a root's input plans against the root's market (`planWrunLaneUnderlying`, the row lanes' one rule).
499
+ const underlying = wrunTakesUnderlying(planned.lane.sourceClass) && declared.underlying !== undefined
500
+ ? await planWrunLaneUnderlying(declared, laneCtx, params, run, WRUN_POLL_LANE_UNSERVED_FILLS)
501
+ : undefined;
502
+ if (underlying !== undefined && 'why' in underlying) {
503
+ wrunUnservedLaneInput(missing, unserved, WRUN_POLL_LANE_UNSERVED_FILLS, underlying.why, cryptoVenue);
504
+ continue;
505
+ }
506
+ underlyingKey = underlying?.key;
494
507
  // An option knob naming a setting reads the setting's current value before the lane judges it (om
495
508
  // `resolveOptionParamKnobs`): the instance's extras carry the value, so a settings change re-plans and re-asks.
496
- const source = resolveWrunOptionSettingKnobs(ctx, planned.source, metadata.params ?? [], run?.paramValues);
497
- answered = await planned.lane.plan(source, laneCtx);
509
+ // The lane reads the word an `underlying` setting picks, the word its root was planned by.
510
+ const source = resolveWrunOptionSettingKnobs(ctx, resolveWrunUnderlyingSettingKnob(ctx, declared, params, run?.paramValues), params, run?.paramValues);
511
+ answered = await planned.lane.plan(source, underlying?.ctx ?? laneCtx);
498
512
  }
499
513
  catch (error) {
500
514
  // A chart with no option chain does not serve the feed (`wrunLaneNoChainRefusal`), nor one whose options plane
@@ -508,6 +522,9 @@ export async function planWrunPollLanes(metadata, chart, isIndexModeExchange = (
508
522
  for (const [key, value] of Object.entries(answered ?? {}))
509
523
  if (value !== undefined)
510
524
  extras[key] = value;
525
+ // A root's input is its own instance, named by the root's market: two roots of one sheet are two fetches.
526
+ if (underlyingKey !== undefined)
527
+ extras[WRUN_POLL_LANE_UNDERLYING_FIELD] = underlyingKey;
511
528
  // A chain instance meets its own plane's wall, by the exchange its chain lists on.
512
529
  if (chainLane) {
513
530
  assertWrunLaneChainPlaneReadable(wrunPollLaneChainPlane(planned.lane, extras), wrunPollLaneChainExchange(planned.lane, extras), run, ctx);
@@ -537,22 +554,31 @@ export async function planWrunPollLaneInstances(metadata, chart, isIndexModeExch
537
554
  // ---------------------------------------------------------------------------
538
555
  // A chain lane's plane per instance (`WrunPollLane.chain`, the row lanes' mark): the run's and the live tick's rule
539
556
  // ---------------------------------------------------------------------------
540
- /** The record seed of the CME display wall on a chain instance's CME chain (the display wall's own record). */
541
- const WRUN_CME_WALL_SEED = Object.freeze({ cls: 'cme-wall' });
557
+ /** The CME chain wall's seed for a run the gate is open to: the `cme-wall` `chain` row (CME chart only, works-on). */
558
+ const WRUN_CME_CHAIN_WALL_SEED = Object.freeze({ cls: 'cme-wall', variant: 'chain' });
559
+ /** For a run the gate is closed to: the default CME wall words, never the switch OUT (the read is walled there too). */
560
+ const WRUN_CME_CHAIN_CLOSED_SEED = Object.freeze({
561
+ cls: 'cme-wall',
562
+ out: { kind: 'works-on' },
563
+ });
542
564
  /**
543
565
  * A chain instance against its own plane's wall, by the plane and the exchange its chain lists on: an OPRA chain the
544
- * OPRA wall (`mayReadOpra`), a CME chain the CME display wall (OpenMarket's own packages only, the run door's rule on
545
- * a CME chart, kscript-venue-policy.util; the `opra-user-scripts` flag never opens it), a crypto chain (`plain`)
546
- * none. The row lanes keep the same rule (wrun-row-lanes.util), in the same words.
566
+ * OPRA wall (`mayReadOpra`), a CME chain the CME chain wall (`mayReadCmeChain`: an official run, or a CME chart study;
567
+ * the `opra-user-scripts` flag never opens it), a crypto chain (`plain`) none. The row lanes, the options chain lane
568
+ * and a CME root read through `underlying` meet this one rule, in the same words.
547
569
  */
548
570
  export function assertWrunLaneChainPlaneReadable(plane, exchange, run, ctx) {
549
571
  if (plane === 'opra')
550
572
  assertWrunOpraLaneReadable(run, ctx);
551
- // OpenMarket's own packages only, whatever the `cme-user-scripts` gate says: the gate opens CME chart studies (the
552
- // chart's own futures data), never CME options data (no implied expansion to CME options in this release).
553
- if (plane === 'cme' && run?.official !== true) {
554
- refuseWrunPollInput(ctx, `reads CME options data (${exchange}), which is open to OpenMarket's own Indicators only: a package you wrote ` +
555
- 'or added from the community cannot read it yet', WRUN_CME_WALL_SEED);
573
+ // A user run off a CME chart holds no CME mark and no CME authorisation: its output would carry CME data off it.
574
+ if (plane === 'cme' && !mayReadCmeChain(run)) {
575
+ // Worded by the gate, as every CME door is: a CME chart is a way out only for a run the gate is open to.
576
+ const open = run?.cmeUserScripts === true;
577
+ refuseWrunPollInput(ctx, open
578
+ ? `reads CME options data (${exchange}): a package you wrote or added from the community reads it on a CME ` +
579
+ 'futures chart only, in the browser'
580
+ : `reads CME options data (${exchange}), which a package you wrote or added from the community cannot read ` +
581
+ 'on this account yet', open ? WRUN_CME_CHAIN_WALL_SEED : WRUN_CME_CHAIN_CLOSED_SEED);
556
582
  }
557
583
  }
558
584
  /** The exchange a chain-lane instance's chain lists on (the payload field its `chain` names); '' for any other lane
@@ -35,7 +35,7 @@ import type { WrunBackendTier, WrunHostBarGroup, WrunTierChoice } from '../wrun-
35
35
  /** An input's declaration as a row lane reads it (the typed fields and any knob the sheet carries). */
36
36
  export type WrunRowLaneSource = WrunPollLaneSource;
37
37
  /** The chart a row lane is planned against, and the input being planned (the poll lanes' context: the
38
- * market, the interval, the index-mode verdict and the run's OPRA facts, `official` and `opraUserScripts`). */
38
+ * market, the interval, the index-mode verdict and the run's plane facts, `official` and the rest). */
39
39
  export type WrunRowLaneContext = WrunPollLaneContext;
40
40
  /**
41
41
  * How a lane's rows reach the chart's bars:
@@ -148,7 +148,7 @@ export interface WrunRowLaneLiveByCoin {
148
148
  * - `opra` (US options data): the OPRA wall (`opra-official-only:<class>`, before the chain is resolved on a chart
149
149
  * whose options ride the plane), the plane stamp and its routed tier in the ask (`wrunPlane`, `servedTier`), the
150
150
  * overlay's OPRA provenance before the first fetch and the legend's delayed-tier note, as a governed lane's;
151
- * - `cme` (a CME Group exchange): the CME display wall (official packages only) and the routed tier in the ask
151
+ * - `cme` (a CME Group exchange): the CME chain wall (`mayReadCmeChain`) and the routed tier in the ask
152
152
  * (`servedTier`, so no source cache serves one tier's rows to the other); no plane stamp, no provenance, no legend
153
153
  * note (the chart's own delay badge names the delay);
154
154
  * - `plain` (a crypto options venue): nothing beside the lane's own fields.
@@ -216,14 +216,19 @@ export interface WrunRowLaneDescriptor {
216
216
  * horizon made them (a lane whose answer cannot pass the budget). */
217
217
  rowBudget?: WrunRowLaneRowBudget;
218
218
  /**
219
- * The lane reads a governed plane on every chart it serves: `opra` (US options data). Its inputs are refused by
220
- * name before any fetch for a run that may not read OPRA (`opra-official-only:<class>`); it is admitted on the
221
- * charts whose options ride the plane (a US stock or ETF chart while the `opra` flag is lit, an OPRA contract
222
- * chart) and nowhere else; its asks ride the native-rows path naming the plane and their routed tier; the run
223
- * stamps the overlay's OPRA provenance before its first fetch and the legend names a delayed tier. A `chain` lane
224
- * declares none: its plane is its instance's.
219
+ * The lane reads a governed plane on every chart it serves:
220
+ * - `opra` (US options data). Its inputs are refused by name before any fetch for a run that may not read OPRA
221
+ * (`opra-official-only:<class>`); it is admitted on the charts whose options ride the plane (a US stock or ETF
222
+ * chart while the `opra` flag is lit, an OPRA contract chart) and nowhere else; its asks ride the native-rows path
223
+ * naming the plane and their routed tier; the run stamps the overlay's OPRA provenance before its first fetch and
224
+ * the legend names a delayed tier.
225
+ * - `stocks` (the US stocks tape, `dark_pool`): admitted on every chart; its identity answers the tape market
226
+ * (`exchange`) or refuses by name. Its asks name the plane and the tape's tier (`wrunRowLaneChainAsk`), the run
227
+ * stamps the tape provenance, the legend carries the delay statement, the reconcile opens the tape's poll window.
228
+ * Never fed live by coin.
229
+ * A `chain` lane declares none: its plane is its instance's.
225
230
  */
226
- governed?: 'opra';
231
+ governed?: 'opra' | 'stocks';
227
232
  /**
228
233
  * A CHAIN lane: it reads the chart's options chain on whichever plane that chain lists on, decided per INSTANCE by
229
234
  * the one chain resolver (sources/opra-option-lanes.util `decideWrunLaneChain`), never per descriptor (see
@@ -33,15 +33,17 @@
33
33
  * projection, after its window-level pass over every held bar where it declares one, with a partial bar kept partial
34
34
  * unless the class carries no `present` mask; a view block, the block of an input whose words name a fold, as it
35
35
  * is, `wrunRowLaneAtWidth`; a `latest` lane on the live row).
36
- * - `wrunRowLaneReachFromMs` / `wrunRunSourceReachFromMs`: how far back a lane's source holds rows (its horizon, its
37
- * longest-kept tier), and where a run's history sources begin, which the warm-up decider reads so a first value a
38
- * source's history explains never buys a page of older candles.
36
+ * - `wrunRowLaneReachFromMs` / `wrunPollLaneReachFromMs` / `wrunEveryBarAnswerReachMs` / `wrunRunSourceReachFromMs`:
37
+ * how far back a lane's source holds rows (its horizon, its longest-kept tier, or the first row of an answer that
38
+ * holds every bar it covers), and where a run's history sources begin across every lane it read, which the warm-up
39
+ * decider reads so a first value a source's history explains never buys a page of older candles. Any other lane's
40
+ * start is unknown: a quiet lead is no history start.
39
41
  */
40
42
  import type { WrunIndicatorMetadata, WrunInputSource, WrunMetadataParam } from '../../../interfaces/wrun-runtime.interface.js';
41
43
  import type { LiveBucketVenue } from '../../chart/live-bucket.util.js';
42
- import type { OpraReadFacts } from '../../chart/opra-read-access.leaf.js';
44
+ import { type OpraReadFacts } from '../../chart/opra-read-access.leaf.js';
43
45
  import type { OpraOptionPlaneStop } from '../../../host-ports.types.js';
44
- import type { WrunPollLaneFetchAsk } from './wrun-poll-lane.types.js';
46
+ import type { WrunPollLane, WrunPollLaneFetchAsk, WrunPollLaneInstance } from './wrun-poll-lane.types.js';
45
47
  import { type WrunLaneChainPlane, type WrunRowLaneCellInput, type WrunRowLaneDescriptor, type WrunRowLaneHorizon, type WrunRowLaneId, type WrunRowLaneInstance, type WrunRowLaneRowBudget } from './wrun-row-lane.types.js';
46
48
  import { type WrunRunOptionsMarket } from '../derived-roots.util.js';
47
49
  import type { WrunRowLaneRowDependency } from './wrun-row-lane-add-memo.util.js';
@@ -96,6 +98,9 @@ export interface WrunRowLaneChart {
96
98
  * `opraOptionPlaneStop`: the flag check's `flag-off`, the plane router's `chart-kind`); absent, the market's own
97
99
  * words. */
98
100
  opraPlaneStop?: (exchange: string, symbol: string) => OpraOptionPlaneStop | undefined;
101
+ /** The chart market's metadata whole (its feed fields, its display token), handed on to every lane's context
102
+ * (`WrunRowLaneContext.chartMetadata`): a `stocks` lane resolves the chart's tape market and feed from it. */
103
+ chartMetadata?: Readonly<Record<string, unknown>>;
99
104
  }
100
105
  /** The run's plan of its row lanes: the instances to fetch, and the feeds the chart never serves to inputs that
101
106
  * declared `missing: "empty"` (one entry per lane key). */
@@ -113,8 +118,10 @@ export interface WrunRowLanePlan {
113
118
  * on a chart whose options list on OPRA (riding the plane or stopped off it), before its chain is resolved;
114
119
  * 2. the admission: a governed OPRA lane is served where the chart's options ride the OPRA plane
115
120
  * (`isOpraPlaneExchange`) and nowhere else; a chain lane on every chart no known stop keeps its options off the
116
- * plane on (`wrunChainLaneStop`, the chain poll lanes' one rule: no chain is resolved past the stop); any other lane
117
- * wherever the chart is not index-mode. An input the chart does not serve meets the one rule both planners keep
121
+ * plane on (`wrunChainLaneStop`, the chain poll lanes' one rule: no chain is resolved past the stop); a `stocks` lane
122
+ * on every chart (its identity asks the chart's tape market, `chartMetadata`, and refuses off a US stock tape market
123
+ * with the unserved-scope seed, so a declared fill reads the market's note, and on Price only by name); any other
124
+ * lane wherever the chart is not index-mode. An input the chart does not serve meets the one rule both planners keep
118
125
  * (wrun-poll-lanes.util `wrunUnservedLaneInput`): declaring `missing: "empty"` it is dropped (its blocks read EMPTY,
119
126
  * a note names the feed), any other refuses by name, seeded feed-missing (paused); a lane off the plane for a known
120
127
  * reason (`opraPlaneStop`: the `opra` flag dark, an index chart) says that reason instead (`options-stopped`, the
@@ -123,18 +130,19 @@ export interface WrunRowLanePlan {
123
130
  * facets (awaited, in declaration order), each knob naming a setting first read as the setting's current value
124
131
  * (`resolveWrunOptionSettingKnobs` over `run.paramValues`), the context carrying the plan's facts beside the chart
125
132
  * (`WrunRowLanePlanFacts`); the instance is the identity and the facets together. An input naming another root
126
- * (contract F's `underlying`, `planWrunRowLaneUnderlying`) is planned against that root's market instead, its
133
+ * (contract F's `underlying`, derived-roots.util `planWrunLaneUnderlying`) is planned against that root's market, its
127
134
  * identity once per lane and market. A lane with
128
135
  * `acquisitions: 'one'` refuses a second input whose acquisition differs (one fetch, one live fold per package). A
129
136
  * chart with no option chain (an identity or facets refusal seeded `no-options` / `chain`, `wrunLaneNoChainRefusal`:
130
137
  * a LINK perp, a forex pair) does not serve the feed either: the same one rule, its note naming the feed with the
131
138
  * chain decision's words, its refusal the decision's own. A chain lane's instance then meets its own plane's wall
132
- * (`assertWrunLaneChainPlaneReadable`, the one rule a chain poll lane meets too): OPRA's, or the CME display wall
133
- * (OpenMarket's own packages only); a plain chain (a crypto venue) none.
139
+ * (`assertWrunLaneChainPlaneReadable`, the one rule a chain poll lane meets too): OPRA's, or the CME chain wall
140
+ * (`mayReadCmeChain`: an official run, or a CME chart study); a plain chain (a crypto venue) none.
134
141
  */
135
142
  export declare function planWrunRowLanes(metadata: WrunIndicatorMetadata, chart: WrunRowLaneChart, run?: WrunRowLaneRunFacts): Promise<WrunRowLanePlan>;
136
- /** The run facts the row-lane planner reads: the OPRA facts and the run's setting values by name (wrun-param-values.util
137
- * `wrunParamValuesFromSettings` over the overlay's settings; absent: a knob naming a setting is refused by name). */
143
+ /** The run facts the row-lane planner reads: the plane facts (OPRA's and the CME chain's) and the run's setting values
144
+ * by name (wrun-param-values.util `wrunParamValuesFromSettings` over the overlay's settings; absent: a knob naming a
145
+ * setting is refused by name). */
138
146
  export interface WrunRowLaneRunFacts extends OpraReadFacts {
139
147
  paramValues?: Readonly<Record<string, number>>;
140
148
  /** The run's one options decision (derived-roots.util `decideWrunRunOptionsMarket`, taken at its head): every chain
@@ -182,11 +190,16 @@ export declare function wrunRowLaneMovedInstance(instances: ReadonlyArray<Pick<W
182
190
  * plane names beside it, by the chain poll lanes' one rule (`wrunPollLaneChainAsk`): an OPRA chain names the plane and
183
191
  * its routed tier (Door C judges it an OPRA ask, the legend names a delayed tier); a CME chain its routed tier alone
184
192
  * (`servedTier`, so no source cache serves one tier's rows to the other; the chart's own badge names the delay); a
185
- * plain chain (a crypto venue) nothing. Any other lane's payload as it is. `tierOf` is the routing's rule
186
- * (governed-route.util `governedMarketDataTier`), handed in so this module stays off the routing graph, and asked only
187
- * for a governed exchange: it answers delayed for any exchange no gate governs.
193
+ * plain chain (a crypto venue) nothing. A `stocks` lane's payload names its plane and the tier its tape is routed to
194
+ * (`wrunPlane: 'stocks'`, `servedTier`: the legend's delay statement and the add memo's fingerprint read them). Any
195
+ * other lane's payload as it is. `tierOf` is the routing's rule (governed-route.util `governedMarketDataTier`), handed
196
+ * in so this module stays off the routing graph, and asked only for a governed exchange: it answers delayed for any
197
+ * exchange no gate governs.
188
198
  */
189
- export declare function wrunRowLaneChainAsk(lane: Pick<WrunRowLaneDescriptor, 'chain'>, extras: Readonly<Record<string, unknown>>, tierOf: (exchange: string) => 'realtime' | 'delayed'): Readonly<Record<string, unknown>>;
199
+ export declare function wrunRowLaneChainAsk(lane: Pick<WrunRowLaneDescriptor, 'chain' | 'governed'>, extras: Readonly<Record<string, unknown>>, tierOf: (exchange: string) => 'realtime' | 'delayed'): Readonly<Record<string, unknown>>;
200
+ /** The tape a `stocks` lane's instance reads (its identity's `exchange`, a stocks-governed code), or null for any other
201
+ * lane and a payload naming no tape: the provenance stamp, the live reconcile's poll window and the tier follow it. */
202
+ export declare function wrunRowLaneStocksTapeOf(lane: Pick<WrunRowLaneDescriptor, 'governed'>, extras: Readonly<Record<string, unknown>>): string | null;
190
203
  /** How an empty answer reads for a lane: quiet (present EMPTY blocks) or degrading (a state lane's). */
191
204
  export declare function wrunRowLaneEmptyAnswer(lane: Pick<WrunRowLaneDescriptor, 'emptyAnswer' | 'landing'>): 'quiet' | 'degrades';
192
205
  /** Whether an instance must answer rows: its lane degrades on an empty answer and some input reading it does not
@@ -482,22 +495,57 @@ export declare function wrunRowLaneProjectedBarRows(lane: Pick<WrunRowLaneDescri
482
495
  tier?: WrunBackendTier;
483
496
  }, nowMs: number, acquisition?: Readonly<Record<string, unknown>>): number;
484
497
  /**
485
- * How far back one row lane's source holds rows for an acquisition at the clock: the later of its horizon's served
486
- * start and the oldest bar its longest-kept tier still holds; null when it names neither, or a tier keeps its rows for
487
- * good (it may answer any window). A `latest` lane reads one snapshot on the live row, no history: undefined.
498
+ * How far back one row lane's source holds rows for an acquisition at the clock, as the lane declares it: the later of
499
+ * its horizon's served start and the oldest bar its longest-kept tier still holds; null when it names neither, or a
500
+ * tier keeps its rows for good (it may answer any window). A `latest` lane reads one snapshot on the live row, no
501
+ * history: undefined.
488
502
  */
489
503
  export declare function wrunRowLaneReachFromMs(lane: Pick<WrunRowLaneDescriptor, 'landing' | 'horizon'>, extras: Readonly<Record<string, unknown>>, nowMs: number): number | null | undefined;
504
+ /** A poll lane's declared reach, the row lanes' rule over its host grid's tiers and its `horizon`; null when it names
505
+ * neither (a daily join, a lane with no tiers). */
506
+ export declare function wrunPollLaneReachFromMs(lane: Pick<WrunPollLane, 'barGrid' | 'horizon'>, extras: Readonly<Record<string, unknown>>, nowMs: number): number | null;
507
+ /** Whether a row lane's host-bar row holds data: a tuple that is no partial marker (bit 14, read where the block has a
508
+ * `present` mask); a packed block is read tuple by tuple at the named width, and reads as no data without one. */
509
+ export declare function wrunRowLaneRowHasData(row: ArrayLike<unknown>, presentMask: boolean, width?: number): boolean;
490
510
  /**
491
- * Where the rows of a run's history sources begin at the clock: the warm-up decider's `sourceReachFromTs`
492
- * (local-kscript-warmup-depth.util), the earliest reach among the row lane instances that read a history
493
- * (`wrunRowLaneReachFromMs`). A visible first value at or after it, with it at or after the loaded start, is a
494
- * source's history beginning, never a warm-up a page of older candles could fill. Null when no instance reads a
495
- * history, when one names no reach, or when the run reads any other source beside the chart's candles (a poll lane, a
496
- * pinned leg, a trades lane: none names its reach yet), since older candles may then still bring that source rows.
511
+ * Where an answer that holds a row for every bar it covers begins (a quiet bar too, so a missing older row is no
512
+ * history): its first row, when the run asked from before it. Null when that row is a partial marker (a bar the host
513
+ * left unasked or unretained: the declared reach names it), sits at or before the asked start, or there is none.
514
+ */
515
+ export declare function wrunEveryBarAnswerReachMs(rows: ReadonlyArray<ArrayLike<unknown>> | undefined, askedFromMs: number, covered?: (row: ArrayLike<unknown>) => boolean): number | null;
516
+ /** One history source a run read: its id, its rows over the window, its row or poll lane instance where it has one. */
517
+ export interface WrunRunHistoryLane {
518
+ lane: string;
519
+ rows: ReadonlyArray<ArrayLike<unknown>> | undefined;
520
+ /** Its declared reach and the `present` mask its tuples carry. */
521
+ rowLane?: Pick<WrunRowLaneInstance, 'laneKey' | 'extras'>;
522
+ /** Its declared reach. */
523
+ pollLane?: Pick<WrunPollLaneInstance, 'laneKey' | 'extras'>;
524
+ /** Its answer holds a row for every bar it covers (`wrunEveryBarAnswerReachMs`); absent, its rows prove no start. */
525
+ answersEveryBar?: boolean;
526
+ }
527
+ /** Every lane and leg a run read, each with its instance: the one list both warm-up asks build, none left out. */
528
+ export declare function wrunRunHistoryLanesOf(args: {
529
+ lanes: ReadonlyArray<{
530
+ lane: string;
531
+ rows: ReadonlyArray<ArrayLike<unknown>> | undefined;
532
+ }>;
533
+ rowLanes: ReadonlyArray<Pick<WrunRowLaneInstance, 'key' | 'laneKey' | 'extras'>>;
534
+ pollLanes: ReadonlyArray<Pick<WrunPollLaneInstance, 'key' | 'laneKey' | 'extras'>>;
535
+ legs: ReadonlyArray<{
536
+ fetchKey: string;
537
+ }>;
538
+ legRows: (fetchKey: string) => ReadonlyArray<ArrayLike<unknown>> | undefined;
539
+ }): WrunRunHistoryLane[];
540
+ /**
541
+ * Where a run's history sources begin (the warm-up decider's `sourceReachFromTs`): the earliest start among every lane
542
+ * and leg it read, each from a declared reach or an every-bar answer asked from before its first row. Null when any
543
+ * lane's start is unknown (a sparse lane's first row, an illiquid leg, a weekend start), since older candles may then
544
+ * still bring that lane rows. A lane that reads no history bounds nothing.
497
545
  */
498
546
  export declare function wrunRunSourceReachFromMs(args: {
499
- rowLanes: ReadonlyArray<Pick<WrunRowLaneInstance, 'laneKey' | 'extras'>>;
500
- readsOtherSources: boolean;
547
+ lanes: ReadonlyArray<WrunRunHistoryLane>;
548
+ askedFromMs: number;
501
549
  nowMs: number;
502
550
  }): number | null;
503
551
  /** The ask shape a lane's own `fetch` takes, over a window. */