@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
@@ -75,14 +75,28 @@ export declare const WRUN_LANE_CURRENCY_AUTO = "Auto";
75
75
  * contracts and "USD" on every other market, one the host knows no facts for included; "USD",
76
76
  * "Coin" and an absent word read as written. */
77
77
  export declare function wrunLaneCurrency(currency: string | undefined, sizeUnit: number): string | undefined;
78
+ /** One setting key of a `visible_by` or `needed_by` word (contract C-COINS item 1): a select param of the same sheet
79
+ * and the option values its row or input shows on. */
80
+ export interface WrunVisibleBySettingKey {
81
+ name: string;
82
+ values: readonly number[];
83
+ }
84
+ /** The setting keys of a word, the ONE reader of their syntax (a respelled contract is one edit here): every own key
85
+ * beside `size_unit` that holds a list, each value a finite number. A key holding no list, or a list holding
86
+ * anything else, reads as absent, the size-unit list's rule. */
87
+ export declare function wrunVisibleBySettingKeys(word: unknown): WrunVisibleBySettingKey[];
78
88
  /** Whether a row declaring `visibleBy` (a setting's or an output's `visible_by`, kit 0.69.0) shows
79
89
  * on a market of size unit `sizeUnit`, the kit's `wrunVisibleOnMarket`: always without the word,
80
90
  * else only when its `size_unit` list names the code. A word holding no list (a malformed
81
91
  * persisted row) reads as absent. The one predicate the settings dialog (its rows) and the run
82
- * result (an output's plot and the stats rows drawn from it) ask. */
92
+ * result (an output's plot and the stats rows drawn from it) ask. With `settingOf` (a setting's
93
+ * word, an input's `needed_by`), each setting key must also list the value its setting reads
94
+ * there (contract C-COINS item 1, AND across keys); a key whose setting reads nothing never hides,
95
+ * the rule of a `when` gate it cannot read. Without it, setting keys are not read (an output's
96
+ * word keeps the size unit only). */
83
97
  export declare function wrunRowVisibleHere(visibleBy: {
84
98
  size_unit?: unknown;
85
- } | null | undefined, sizeUnit: number): boolean;
99
+ } | null | undefined, sizeUnit: number, settingOf?: (name: string) => number | undefined): boolean;
86
100
  /** Whether a `visible_by` list needs the market's kind to decide (the directory row on a crypto
87
101
  * venue): it names some but not all of 0, 1 and 2, the units the kind tells apart. A list deciding
88
102
  * on contracts alone (`[3]`, `[0, 1, 2]`) needs only the point value and the zone. */
@@ -147,14 +147,43 @@ export function wrunLaneCurrency(currency, sizeUnit) {
147
147
  return currency;
148
148
  return sizeUnit === CONTRACTS_SIZE_UNIT ? 'Coin' : 'USD';
149
149
  }
150
+ /** The size-unit key of a `visible_by` or `needed_by` word; every other key names a setting. */
151
+ const WRUN_VISIBLE_BY_SIZE_UNIT_KEY = 'size_unit';
152
+ /** The setting keys of a word, the ONE reader of their syntax (a respelled contract is one edit here): every own key
153
+ * beside `size_unit` that holds a list, each value a finite number. A key holding no list, or a list holding
154
+ * anything else, reads as absent, the size-unit list's rule. */
155
+ export function wrunVisibleBySettingKeys(word) {
156
+ if (word === null || typeof word !== 'object' || Array.isArray(word))
157
+ return [];
158
+ const keys = [];
159
+ for (const [name, values] of Object.entries(word)) {
160
+ if (name === WRUN_VISIBLE_BY_SIZE_UNIT_KEY || !Array.isArray(values))
161
+ continue;
162
+ if (!values.every((value) => typeof value === 'number' && Number.isFinite(value)))
163
+ continue;
164
+ keys.push({ name, values: values });
165
+ }
166
+ return keys;
167
+ }
150
168
  /** Whether a row declaring `visibleBy` (a setting's or an output's `visible_by`, kit 0.69.0) shows
151
169
  * on a market of size unit `sizeUnit`, the kit's `wrunVisibleOnMarket`: always without the word,
152
170
  * else only when its `size_unit` list names the code. A word holding no list (a malformed
153
171
  * persisted row) reads as absent. The one predicate the settings dialog (its rows) and the run
154
- * result (an output's plot and the stats rows drawn from it) ask. */
155
- export function wrunRowVisibleHere(visibleBy, sizeUnit) {
172
+ * result (an output's plot and the stats rows drawn from it) ask. With `settingOf` (a setting's
173
+ * word, an input's `needed_by`), each setting key must also list the value its setting reads
174
+ * there (contract C-COINS item 1, AND across keys); a key whose setting reads nothing never hides,
175
+ * the rule of a `when` gate it cannot read. Without it, setting keys are not read (an output's
176
+ * word keeps the size unit only). */
177
+ export function wrunRowVisibleHere(visibleBy, sizeUnit, settingOf) {
156
178
  const codes = visibleBy?.size_unit;
157
- return !Array.isArray(codes) || codes.includes(sizeUnit);
179
+ if (Array.isArray(codes) && !codes.includes(sizeUnit))
180
+ return false;
181
+ if (settingOf === undefined)
182
+ return true;
183
+ return wrunVisibleBySettingKeys(visibleBy).every((key) => {
184
+ const value = settingOf(key.name);
185
+ return value === undefined || key.values.includes(value);
186
+ });
158
187
  }
159
188
  /** Whether a `visible_by` list needs the market's kind to decide (the directory row on a crypto
160
189
  * venue): it names some but not all of 0, 1 and 2, the units the kind tells apart. A list deciding
@@ -32,12 +32,14 @@
32
32
  * NQ), 10 for a root the table lacks, and Whale size to ten times that. Why: an order is one trade, so a flat 10 draws a
33
33
  * different density on every root; at 10, NQ showed 652 orders an hour and ES 5,827 on Friday 2026-10-23's open hour,
34
34
  * and each table row is the smallest 1, 2 or 5 floor with at most 30 orders an hour there. Where prints are still judged
35
- * per fill (the switch off, any venue but the CME Group's, or a root the large-print table does not hold, whose tape
36
- * rides the raw TRADE fills: live-trades-merge.util `tradesLargeServesCmeRoot`), the package's flat 10 and 100 stand
37
- * (the rule's `package` verdict, reason `per-fill`), so a record a per-order session moved returns to them: a floor
38
- * measured on orders never judges single fills (COMEX:MGC1! on 2026-10-29, a root the table does not hold: the largest
39
- * fill in two hours was 21 contracts, so GC's 50 would have drawn nothing, while 10 kept 79 fills, about 40 an hour).
40
- * Untouched rows only, as every rule.
35
+ * per fill (the switch off, or any venue but the CME Group's), the package's flat 10 and 100 stand (the rule's `package`
36
+ * verdict, reason `per-fill`), so a record a per-order session moved returns to them. Untouched rows only, as every rule.
37
+ *
38
+ * The COIN rule again from 0.10.0 on (contract C-COINS, Big Trades' Min size and Whale size in coins, `min_coins` and
39
+ * `whale_coins`, the floor of its `tape_coins` input): the coin rule above, BTC 10 and ETH 200. A sheet declaring it
40
+ * beside the dollar rule (0.10.0's Min value stays) reads the two apart (`wrunMarketScaledFamilies` splits the coin
41
+ * rules off as `coins`), each with its own verdict, so a stock or a CME chart still moves Min value as 0.9.0 did while
42
+ * the coin rule reads the package's defaults there.
41
43
  *
42
44
  * A run reads only the family its sheet declares (`wrunMarketScaledRulesOfSheet`). A market whose closed candles cover
43
45
  * under an hour moves nothing: the next run asks again.
@@ -50,8 +52,7 @@
50
52
  * (`wrunMarketScaledFamilies`): each family has its own verdict and memo, so a volume rule waiting on its candles never
51
53
  * holds the option back.
52
54
  *
53
- * Pure: the specs and the phone app read the same rules. It reads the import-free size unit table and the tape rules'
54
- * one served-root rule (live-trades-merge.util, a store-free leaf the history worker shares).
55
+ * Pure: the specs and the phone app read the same rules. Its one import is the import-free size unit table.
55
56
  */
56
57
  import type { WrunScriptInputDeclaration } from './wrun-script-inputs.util.js';
57
58
  /** How a market-scaled param's default follows the market. */
@@ -84,9 +85,8 @@ export type WrunMarketScaledRule =
84
85
  readonly carriesFrom?: never;
85
86
  }
86
87
  /** A contracts floor by the CME product root (the contracts rule, `wrunMarketContractsVerdict`): the root's row of
87
- * `table`, `other` for a root it lacks, where the root's tape is the large-print table's per-order rows; the
88
- * package's default where prints are judged per fill (the switch off, or a root the table does not hold). Never a
89
- * value carried from an older version (the contracts carry has its own rules). */
88
+ * `table`, `other` for a root it lacks, where the live plane serves per-order prints; the package's default where
89
+ * prints are judged per fill. Never a value carried from an older version (the contracts carry has its own rules). */
90
90
  | {
91
91
  readonly kind: 'cme-root-contracts';
92
92
  readonly table: Readonly<Record<string, number>>;
@@ -96,8 +96,7 @@ export type WrunMarketScaledRule =
96
96
  /**
97
97
  * Big Trades' Min size in contracts on a CME Group market whose prints are judged per aggressor order, by product root:
98
98
  * the smallest 1, 2 or 5 floor with at most 30 orders an hour on Friday 2026-10-23's open hour (at a flat 10, NQ showed
99
- * 652 orders an hour and ES 5,827). A root the table lacks reads `WRUN_CME_ROOT_MIN_CONTRACTS_OTHER` where the
100
- * large-print table holds it; a root the large-print table does not hold is judged per fill (`wrunMarketContractsVerdict`).
99
+ * 652 orders an hour and ES 5,827). A root the table lacks reads `WRUN_CME_ROOT_MIN_CONTRACTS_OTHER`.
101
100
  */
102
101
  export declare const WRUN_CME_ROOT_MIN_CONTRACTS: Readonly<Record<string, number>>;
103
102
  /** The contracts floor of a CME root the table does not list: the package's 10. */
@@ -115,15 +114,19 @@ export declare function wrunMarketScaledParamsOf(packageName: string | undefined
115
114
  export declare function wrunMarketScaledRulesOfSheet(rules: Readonly<Record<string, WrunMarketScaledRule>> | undefined, paramNames: Iterable<string>): Readonly<Record<string, WrunMarketScaledRule>> | undefined;
116
115
  /** A package's scaled rules split by family: the VOLUME rules (`daily-volume`, `daily-dollar-volume` and the
117
116
  * multiples of them, read off the candles), the OPTION rules (`contracts-option`, read off the market's units) and the
118
- * CONTRACTS rules (`cme-root-contracts` and the multiples of them, read off the product root and the live plane). The
119
- * run head reads each family with its own verdict and memo; a family the rules leave empty is absent. */
117
+ * CONTRACTS rules (`cme-root-contracts` and the multiples of them, read off the product root and the live plane). A set
118
+ * holding both volume rules (Big Trades 0.10.0) keeps the dollar rule as VOLUME and the coin rule and its multiples as
119
+ * COINS, each read alone (`wrunMarketSizeVerdict` over each), so neither verdict holds the other back. The run head
120
+ * reads each family with its own verdict and memo; a family the rules leave empty is absent. */
120
121
  export interface WrunMarketScaledFamilies {
121
122
  volume?: Readonly<Record<string, WrunMarketScaledRule>>;
123
+ coins?: Readonly<Record<string, WrunMarketScaledRule>>;
122
124
  options?: Readonly<Record<string, WrunMarketScaledRule>>;
123
125
  contracts?: Readonly<Record<string, WrunMarketScaledRule>>;
124
126
  }
125
127
  /** The scaled rules split into their families (`WrunMarketScaledFamilies`): every option rule to `options`, every
126
- * contracts rule and multiple of one to `contracts`, every other rule to `volume`. */
128
+ * contracts rule and multiple of one to `contracts`, the coin rule and its multiples to `coins` where the dollar rule
129
+ * stands beside them, every other rule to `volume`. */
127
130
  export declare function wrunMarketScaledFamilies(rules: Readonly<Record<string, WrunMarketScaledRule>>): WrunMarketScaledFamilies;
128
131
  /** A market's daily volume in its candles' unit (the coin rule's volume), `wrunDailyCandleSum` of each candle's
129
132
  * volume. */
@@ -179,7 +182,7 @@ export type WrunMarketSizeVerdict =
179
182
  * tape (`candle-unit`: contracts on an inverse or an OKX swap, a formula chart's candles, which are no market's). The
180
183
  * dollar rule: no point value (`point-value`: ICE, PLATTS, a CME root off the table), a quote that is no dollar
181
184
  * (`quote`: KRW, a coin), a formula chart (`candle-unit`). The contracts rule: prints judged per fill (`per-fill`:
182
- * the per-order switch off, a venue it never holds for, or a CME root the large-print table does not hold). */
185
+ * the per-order switch off, or a venue it never holds for). */
183
186
  | {
184
187
  kind: 'package';
185
188
  reason: 'contracts' | 'size-unit' | 'candle-unit' | 'point-value' | 'quote' | 'per-fill';
@@ -192,10 +195,10 @@ export type WrunMarketSizeVerdict =
192
195
  kind: 'skip';
193
196
  reason: 'size-unit' | 'quote' | 'cover';
194
197
  };
195
- /** The verdict of a market's facts on a package's VOLUME rules (`allRules`, one volume family: a sheet declares one,
196
- * and the head passes `wrunMarketScaledFamilies(...).volume`; an option rule among them is left out, never read as a
197
- * dollar rule). A set holding both volume families reads the dollar rule only when the coin rule agrees to move (a
198
- * mixed set is no shipped sheet's; the stricter verdict wins). */
198
+ /** The verdict of a market's facts on a package's VOLUME rules (`allRules`, one volume family: the head passes
199
+ * `wrunMarketScaledFamilies(...).volume` and, for a sheet declaring both rules, `.coins` apart; an option rule among
200
+ * them is left out, never read as a dollar rule). A set holding both volume families reads the dollar rule only when
201
+ * the coin rule agrees to move (the stricter verdict wins); the head never passes one. */
199
202
  export declare function wrunMarketSizeVerdict(allRules: Readonly<Record<string, WrunMarketScaledRule>>, facts: WrunMarketSizeFacts): WrunMarketSizeVerdict;
200
203
  /**
201
204
  * The verdict of a market's facts on a package's OPTION rules (`contracts-option`, the head passes
@@ -215,12 +218,9 @@ export interface WrunMarketContractsFacts {
215
218
  }
216
219
  /**
217
220
  * The verdict of a market's facts on a package's CONTRACTS rules (the head passes `wrunMarketScaledFamilies(...).
218
- * contracts`). It reads no candles: where prints are judged per order (the switch holds and the large-print table
219
- * holds the root, `tradesLargeServesCmeRoot`: its tape reads the collector's one row per order), each root contracts
220
- * rule's row for the root (its `other` for a root the table lacks) and each multiple of one (`market`); where they are
221
- * judged per fill (the switch off, or a root the large-print table does not hold, whose tape rides the raw fills), the
222
- * package's own defaults (`package`, `per-fill`), so a record never keeps a per-order default once its tape is no
223
- * longer judged per order.
221
+ * contracts`). It reads no candles: where prints are judged per order, each root contracts rule's row for the root
222
+ * (its `other` for a root the table lacks) and each multiple of one (`market`); where they are judged per fill, the
223
+ * package's own defaults (`package`, `per-fill`), so a record never keeps a per-order default once the plane is off.
224
224
  */
225
225
  export declare function wrunMarketContractsVerdict(rules: Readonly<Record<string, WrunMarketScaledRule>>, facts: WrunMarketContractsFacts): WrunMarketSizeVerdict;
226
226
  /** What one unit of a market's STORED trade amount is worth in US dollars (wrun-chart-market-facts.util
@@ -1,10 +1,8 @@
1
1
  import { WRUN_MARKET_SIZE_UNITS } from './wrun-market-facts.util.js';
2
- import { tradesLargeServesCmeRoot } from '../../kscript-data/controls/live-trades-merge.util.js';
3
2
  /**
4
3
  * Big Trades' Min size in contracts on a CME Group market whose prints are judged per aggressor order, by product root:
5
4
  * the smallest 1, 2 or 5 floor with at most 30 orders an hour on Friday 2026-10-23's open hour (at a flat 10, NQ showed
6
- * 652 orders an hour and ES 5,827). A root the table lacks reads `WRUN_CME_ROOT_MIN_CONTRACTS_OTHER` where the
7
- * large-print table holds it; a root the large-print table does not hold is judged per fill (`wrunMarketContractsVerdict`).
5
+ * 652 orders an hour and ES 5,827). A root the table lacks reads `WRUN_CME_ROOT_MIN_CONTRACTS_OTHER`.
8
6
  */
9
7
  export const WRUN_CME_ROOT_MIN_CONTRACTS = Object.freeze({
10
8
  NQ: 50,
@@ -47,6 +45,10 @@ export const WRUN_MARKET_SCALED_PARAMS = Object.freeze({
47
45
  }),
48
46
  // 0.8.0: the whale threshold in contracts, ten times Min size's (the package's 100 per fill).
49
47
  whale_contracts: Object.freeze({ kind: 'times', param: 'min_contracts', factor: 10 }),
48
+ // 0.10.0, the coin rule (C-COINS): the coins tape's floor (its `min_coins` facet names it) in Coins mode.
49
+ min_coins: Object.freeze({ kind: 'daily-volume', share: 0.0001 }),
50
+ // 0.10.0: the whale threshold in coins, ten times Min size's market default.
51
+ whale_coins: Object.freeze({ kind: 'times', param: 'min_coins', factor: 10 }),
50
52
  }),
51
53
  });
52
54
  /** The scaled params of a package, or undefined for a package that scales none. */
@@ -73,22 +75,34 @@ function isWrunContractsRule(rule, rules) {
73
75
  return true;
74
76
  return rule.kind === 'times' && rules[rule.param]?.kind === 'cme-root-contracts';
75
77
  }
78
+ /** Whether a rule is the coin rule or a multiple of it in `rules`. */
79
+ function isWrunCoinRule(rule, rules) {
80
+ if (rule.kind === 'daily-volume')
81
+ return true;
82
+ return rule.kind === 'times' && rules[rule.param]?.kind === 'daily-volume';
83
+ }
76
84
  /** The scaled rules split into their families (`WrunMarketScaledFamilies`): every option rule to `options`, every
77
- * contracts rule and multiple of one to `contracts`, every other rule to `volume`. */
85
+ * contracts rule and multiple of one to `contracts`, the coin rule and its multiples to `coins` where the dollar rule
86
+ * stands beside them, every other rule to `volume`. */
78
87
  export function wrunMarketScaledFamilies(rules) {
79
88
  const volume = {};
89
+ const coins = {};
80
90
  const options = {};
81
91
  const contracts = {};
92
+ const splitsCoins = readsDollarVolume(rules) && readsCoinVolume(rules);
82
93
  for (const [name, rule] of Object.entries(rules)) {
83
94
  if (rule.kind === 'contracts-option')
84
95
  options[name] = rule;
85
96
  else if (isWrunContractsRule(rule, rules))
86
97
  contracts[name] = rule;
98
+ else if (splitsCoins && isWrunCoinRule(rule, rules))
99
+ coins[name] = rule;
87
100
  else
88
101
  volume[name] = rule;
89
102
  }
90
103
  return {
91
104
  ...(Object.keys(volume).length > 0 ? { volume } : {}),
105
+ ...(Object.keys(coins).length > 0 ? { coins } : {}),
92
106
  ...(Object.keys(options).length > 0 ? { options } : {}),
93
107
  ...(Object.keys(contracts).length > 0 ? { contracts } : {}),
94
108
  };
@@ -228,12 +242,13 @@ function wrunCoinVerdict(rules, facts) {
228
242
  const defaults = daily === undefined ? undefined : wrunMarketScaledDefaults(rules, daily);
229
243
  return defaults === undefined ? { kind: 'skip', reason: 'cover' } : { kind: 'market', defaults };
230
244
  }
231
- /** The verdict of a market's facts on a package's VOLUME rules (`allRules`, one volume family: a sheet declares one,
232
- * and the head passes `wrunMarketScaledFamilies(...).volume`; an option rule among them is left out, never read as a
233
- * dollar rule). A set holding both volume families reads the dollar rule only when the coin rule agrees to move (a
234
- * mixed set is no shipped sheet's; the stricter verdict wins). */
245
+ /** The verdict of a market's facts on a package's VOLUME rules (`allRules`, one volume family: the head passes
246
+ * `wrunMarketScaledFamilies(...).volume` and, for a sheet declaring both rules, `.coins` apart; an option rule among
247
+ * them is left out, never read as a dollar rule). A set holding both volume families reads the dollar rule only when
248
+ * the coin rule agrees to move (the stricter verdict wins); the head never passes one. */
235
249
  export function wrunMarketSizeVerdict(allRules, facts) {
236
- const rules = wrunMarketScaledFamilies(allRules).volume ?? {};
250
+ const split = wrunMarketScaledFamilies(allRules);
251
+ const rules = { ...(split.volume ?? {}), ...(split.coins ?? {}) };
237
252
  const dollar = readsDollarVolume(rules);
238
253
  const coin = readsCoinVolume(rules);
239
254
  if (dollar && !coin)
@@ -274,15 +289,12 @@ export function wrunMarketOptionVerdict(rules, facts) {
274
289
  }
275
290
  /**
276
291
  * The verdict of a market's facts on a package's CONTRACTS rules (the head passes `wrunMarketScaledFamilies(...).
277
- * contracts`). It reads no candles: where prints are judged per order (the switch holds and the large-print table
278
- * holds the root, `tradesLargeServesCmeRoot`: its tape reads the collector's one row per order), each root contracts
279
- * rule's row for the root (its `other` for a root the table lacks) and each multiple of one (`market`); where they are
280
- * judged per fill (the switch off, or a root the large-print table does not hold, whose tape rides the raw fills), the
281
- * package's own defaults (`package`, `per-fill`), so a record never keeps a per-order default once its tape is no
282
- * longer judged per order.
292
+ * contracts`). It reads no candles: where prints are judged per order, each root contracts rule's row for the root
293
+ * (its `other` for a root the table lacks) and each multiple of one (`market`); where they are judged per fill, the
294
+ * package's own defaults (`package`, `per-fill`), so a record never keeps a per-order default once the plane is off.
283
295
  */
284
296
  export function wrunMarketContractsVerdict(rules, facts) {
285
- if (!facts.perOrder || !tradesLargeServesCmeRoot(facts.root))
297
+ if (!facts.perOrder)
286
298
  return { kind: 'package', reason: 'per-fill' };
287
299
  const defaults = {};
288
300
  for (const [name, rule] of Object.entries(rules)) {
@@ -40,6 +40,11 @@
40
40
  * waits on its candles never holds the option back, nor the option the volume rules. Its select row moves while
41
41
  * untouched like a number row (value and default together, in the row's own spelling), and the two families'
42
42
  * defaults merge into one move patch.
43
+ * - The coins family (C-COINS, Big Trades 0.10.0's Min size and Whale size in coins, `min_coins` and `whale_coins`):
44
+ * the coin rule, split off the dollar rule it stands beside (`wrunMarketScaledFamilies` `coins`) and resolved in the
45
+ * same warm block with its own verdict and memo key (`<market>#min_coins,whale_coins`), so the dollar rule moves Min
46
+ * value on a stock or a CME chart exactly as 0.9.0's sheet does while the coin rule reads the package's defaults
47
+ * there.
43
48
  * - The contracts carry (BT-CME, wrun-market-size-contract-carry.leaf, by param name): on a market that counts
44
49
  * contracts, a 0.5.x count still the user's latest word (the dollar row unmarked, or still at its carried mark: S0
45
50
  * kept the old name there) moves to Min size or Whale size exactly; else a changed dollar value (0.6.x or 0.7.x, a
@@ -228,6 +233,7 @@ const WRUN_MARKET_SIZE_UNPROVEN = Object.freeze({ kind: 'skip', reason: 'unprove
228
233
  function wrunMarketSizeUnprovenFacts(families) {
229
234
  return {
230
235
  ...(families.volume !== undefined ? { verdict: WRUN_MARKET_SIZE_UNPROVEN } : {}),
236
+ ...(families.coins !== undefined ? { coinsVerdict: WRUN_MARKET_SIZE_UNPROVEN } : {}),
231
237
  ...(families.options !== undefined ? { optionVerdict: WRUN_MARKET_SIZE_UNPROVEN } : {}),
232
238
  };
233
239
  }
@@ -265,15 +271,19 @@ export async function reconcileWrunMarketSizeDefaults(args) {
265
271
  const transformations = typeof chartMetadata?.transformations === 'string' ? chartMetadata.transformations : '';
266
272
  const formula = wrunChartFormulaOf(exchange, symbol, transformations);
267
273
  const family = families.volume === undefined ? undefined : Object.keys(families.volume).sort().join(',');
274
+ const coinsFamily = families.coins === undefined ? undefined : Object.keys(families.coins).sort().join(',');
268
275
  const marketKey = formula === undefined ? `${exchange}|${symbol}` : `${exchange}|${symbol}|${formula}`;
269
276
  const volumeKey = family === undefined ? undefined : `${marketKey}#${family}`;
277
+ const coinsKey = coinsFamily === undefined ? undefined : `${marketKey}#${coinsFamily}`;
270
278
  const optionKey = families.options === undefined ? undefined : `${marketKey}#options`;
271
279
  const contractsKey = families.contracts === undefined ? undefined : `${marketKey}#contracts`;
272
280
  let resolved = wrunMarketSizeDefaultsByMount.get(meta);
273
281
  let volumeDefaults = volumeKey === undefined ? undefined : resolved?.get(volumeKey);
282
+ let coinsDefaults = coinsKey === undefined ? undefined : resolved?.get(coinsKey);
274
283
  let optionDefaults = optionKey === undefined ? undefined : resolved?.get(optionKey);
275
284
  let contractsDefaults = contractsKey === undefined ? undefined : resolved?.get(contractsKey);
276
285
  const volumeOwed = volumeKey !== undefined && volumeDefaults === undefined;
286
+ const coinsOwed = coinsKey !== undefined && coinsDefaults === undefined;
277
287
  const optionsOwed = optionKey !== undefined && optionDefaults === undefined;
278
288
  const contractsOwed = contractsKey !== undefined && contractsDefaults === undefined;
279
289
  // The contracts carry (BT-CME, wrun-market-size-contract-carry.leaf): on a market that counts contracts (its size
@@ -284,7 +294,7 @@ export async function reconcileWrunMarketSizeDefaults(args) {
284
294
  const pending = wrunPendingDollarCarries(meta.settings, rules, sheetParams).filter((carry) => !contractPending.some((entry) => entry.raw === carry.from));
285
295
  const pricesContracts = contractPending.some((entry) => entry.from === 'dollars');
286
296
  let headFacts;
287
- if (volumeOwed || optionsOwed || pending.length > 0 || contractPending.length > 0) {
297
+ if (volumeOwed || coinsOwed || optionsOwed || pending.length > 0 || contractPending.length > 0) {
288
298
  // A crypto market's coin unit and quote are the directory row's (its asset class, its quote), a CME contract's
289
299
  // point value the instrument registry's, and only with a raw floor to carry or a dollar value to count in
290
300
  // contracts, what one stored unit is worth (the large-print writer's own rows): each asked once per market for
@@ -336,6 +346,9 @@ export async function reconcileWrunMarketSizeDefaults(args) {
336
346
  if (volumeOwed && volumeKey !== undefined && family !== undefined && headFacts?.verdict !== undefined) {
337
347
  volumeDefaults = resolve(volumeKey, headFacts.verdict, families.volume, 'wrun-market-size-defaults', family);
338
348
  }
349
+ if (coinsOwed && coinsKey !== undefined && coinsFamily !== undefined && headFacts?.coinsVerdict !== undefined) {
350
+ coinsDefaults = resolve(coinsKey, headFacts.coinsVerdict, families.coins, 'wrun-market-size-defaults', coinsFamily);
351
+ }
339
352
  if (optionsOwed && optionKey !== undefined && headFacts?.optionVerdict !== undefined) {
340
353
  optionDefaults = resolve(optionKey, headFacts.optionVerdict, families.options, 'wrun-market-size-option-defaults', 'options');
341
354
  }
@@ -360,9 +373,17 @@ export async function reconcileWrunMarketSizeDefaults(args) {
360
373
  // carry, then the dollar carry over what it left; then the market's defaults, both families' in one patch.
361
374
  const storedUnit = headFacts?.storedUnit;
362
375
  const sizeUnit = headFacts?.sizeUnit;
363
- const defaults = volumeDefaults === undefined && optionDefaults === undefined && contractsDefaults === undefined
376
+ const defaults = volumeDefaults === undefined &&
377
+ coinsDefaults === undefined &&
378
+ optionDefaults === undefined &&
379
+ contractsDefaults === undefined
364
380
  ? undefined
365
- : { ...(volumeDefaults ?? {}), ...(optionDefaults ?? {}), ...(contractsDefaults ?? {}) };
381
+ : {
382
+ ...(volumeDefaults ?? {}),
383
+ ...(coinsDefaults ?? {}),
384
+ ...(optionDefaults ?? {}),
385
+ ...(contractsDefaults ?? {}),
386
+ };
366
387
  // What one contract is worth: the large-print writer's own price of one stored unit (a CME contract).
367
388
  const perContract = storedUnit?.kind === 'dollars' ? storedUnit.perUnit : undefined;
368
389
  const contractCarry = wrunContractCarryPatch(meta.settings, contractPending, perContract);
@@ -462,7 +483,7 @@ function wrunChartFormulaOf(exchange, symbol, transformations) {
462
483
  */
463
484
  function wrunMarketSizeFactsNow(families, facts) {
464
485
  const rowsOwn = facts.loaded !== null && wrunChartMarketIdentity(facts.loaded) === facts.identity;
465
- const rows = rowsOwn && families.volume !== undefined
486
+ const rows = rowsOwn && (families.volume !== undefined || families.coins !== undefined)
466
487
  ? wrunChartCandleRows(facts.tc)
467
488
  : [];
468
489
  // A formula chart's candles are no market's: its dollar volume is no market's either, so the dollar rule reads the
@@ -479,7 +500,15 @@ function wrunMarketSizeFactsNow(families, facts) {
479
500
  intervalMs: wrunChartIntervalMsOf(facts.chartMetadata?.interval),
480
501
  };
481
502
  const optionVerdict = families.options === undefined ? undefined : wrunMarketOptionVerdict(families.options, sizeFacts);
482
- const options = optionVerdict === undefined ? {} : { optionVerdict };
503
+ // The coin rule beside the dollar rule (0.10.0) reads the same candles alone; rows held back read as unproven.
504
+ const coinsRead = families.coins === undefined ? undefined : wrunMarketSizeVerdict(families.coins, sizeFacts);
505
+ const coinsVerdict = coinsRead !== undefined && !rowsOwn && coinsRead.kind === 'skip' && coinsRead.reason === 'cover'
506
+ ? WRUN_MARKET_SIZE_UNPROVEN
507
+ : coinsRead;
508
+ const options = {
509
+ ...(optionVerdict === undefined ? {} : { optionVerdict }),
510
+ ...(coinsVerdict === undefined ? {} : { coinsVerdict }),
511
+ };
483
512
  if (families.volume === undefined)
484
513
  return options;
485
514
  const verdict = wrunMarketSizeVerdict(families.volume, sizeFacts);
@@ -9,11 +9,14 @@
9
9
  * label already written into `currency` by the paint seam (wrunSheetWithSettings), and "Auto" resolved by the
10
10
  * market seam (wrunSheetWithLaneCurrencies).
11
11
  *
12
- * One package reads one open-interest lane (the run fetches it once, as it does the volume profile): `oi` inputs
13
- * that declare two units refuse by name before any fetch. An open-interest STREAM (`oi_candles`) is a leg of its
14
- * own and carries its own units (wrun-leg-stream-classes), so it never meets this rule.
12
+ * One package reads one open-interest lane per market (the run fetches each once, as it does the volume profile):
13
+ * the chart's own lane, and one lane per market an `oi` input pins (U9e, wrun-pinned-lanes.util). One lane is one
14
+ * fetch in one unit, so `oi` inputs on one market that declare two units refuse by name before any fetch; inputs on
15
+ * two markets read two lanes and may declare a unit each. An open-interest STREAM (`oi_candles`) is a leg of its own
16
+ * and carries its own units (wrun-leg-stream-classes), so it never meets this rule.
15
17
  */
16
18
  import type { WrunIndicatorMetadata } from '../../interfaces/wrun-runtime.interface.js';
19
+ import { type WrunPinnedLaneId } from './wrun-pinned-lanes.util.js';
17
20
  export declare const WRUN_OI_ONE_LANE_CODE = "wrun_oi_one_lane";
18
21
  /** The lane payload extras of a Coin open-interest lane (the K_OPEN_INTEREST source payload's key). */
19
22
  export interface WrunOiLaneExtras {
@@ -21,7 +24,7 @@ export interface WrunOiLaneExtras {
21
24
  }
22
25
  /** The units one `oi` input reads: "Coin" when it says so, else "USD" (the default). */
23
26
  export declare function wrunOiInputCurrency(currency: unknown): 'USD' | 'Coin';
24
- /** The lane payload extras the sheet's demanded `oi` inputs declare: `{ currency: 'Coin' }` when they read native
25
- * units, undefined for the USD lane (the payload as before). Throws, naming the inputs, when two inputs declare
26
- * different units. */
27
- export declare function wrunOiLaneExtras(metadata: Pick<WrunIndicatorMetadata, 'inputs' | 'inputSources'>): WrunOiLaneExtras | undefined;
27
+ /** The lane payload extras the sheet's demanded `oi` inputs on one lane declare (`lane`: a pinned lane's id, absent
28
+ * the chart's own lane): `{ currency: 'Coin' }` when they read native units, undefined for the USD lane (the payload
29
+ * as before). Throws, naming the inputs, when two inputs on that lane declare different units. */
30
+ export declare function wrunOiLaneExtras(metadata: Pick<WrunIndicatorMetadata, 'inputs' | 'inputSources'>, lane?: WrunPinnedLaneId): WrunOiLaneExtras | undefined;
@@ -9,29 +9,35 @@
9
9
  * label already written into `currency` by the paint seam (wrunSheetWithSettings), and "Auto" resolved by the
10
10
  * market seam (wrunSheetWithLaneCurrencies).
11
11
  *
12
- * One package reads one open-interest lane (the run fetches it once, as it does the volume profile): `oi` inputs
13
- * that declare two units refuse by name before any fetch. An open-interest STREAM (`oi_candles`) is a leg of its
14
- * own and carries its own units (wrun-leg-stream-classes), so it never meets this rule.
12
+ * One package reads one open-interest lane per market (the run fetches each once, as it does the volume profile):
13
+ * the chart's own lane, and one lane per market an `oi` input pins (U9e, wrun-pinned-lanes.util). One lane is one
14
+ * fetch in one unit, so `oi` inputs on one market that declare two units refuse by name before any fetch; inputs on
15
+ * two markets read two lanes and may declare a unit each. An open-interest STREAM (`oi_candles`) is a leg of its own
16
+ * and carries its own units (wrun-leg-stream-classes), so it never meets this rule.
15
17
  */
18
+ import { wrunPinnedLaneOfSource } from './wrun-pinned-lanes.util.js';
16
19
  export const WRUN_OI_ONE_LANE_CODE = 'wrun_oi_one_lane';
17
20
  /** The units one `oi` input reads: "Coin" when it says so, else "USD" (the default). */
18
21
  export function wrunOiInputCurrency(currency) {
19
22
  return currency === 'Coin' ? 'Coin' : 'USD';
20
23
  }
21
- /** The lane payload extras the sheet's demanded `oi` inputs declare: `{ currency: 'Coin' }` when they read native
22
- * units, undefined for the USD lane (the payload as before). Throws, naming the inputs, when two inputs declare
23
- * different units. */
24
- export function wrunOiLaneExtras(metadata) {
24
+ /** The lane payload extras the sheet's demanded `oi` inputs on one lane declare (`lane`: a pinned lane's id, absent
25
+ * the chart's own lane): `{ currency: 'Coin' }` when they read native units, undefined for the USD lane (the payload
26
+ * as before). Throws, naming the inputs, when two inputs on that lane declare different units. */
27
+ export function wrunOiLaneExtras(metadata, lane) {
25
28
  let declared;
26
29
  for (const input of metadata.inputs) {
27
30
  const source = metadata.inputSources[input.name];
28
31
  if (source?.source !== 'oi' || source.undemanded === true)
29
32
  continue;
33
+ if (wrunPinnedLaneOfSource(source) !== lane)
34
+ continue;
30
35
  const currency = wrunOiInputCurrency(source.currency);
31
36
  if (declared !== undefined && declared.currency !== currency) {
32
- throw new Error(`oi inputs declare two units (${declared.inputs.join(', ')}: ${declared.currency}; ${input.name}: ${currency}) ` +
33
- `(${WRUN_OI_ONE_LANE_CODE}): one package reads one open interest lane, so declare the same currency on ` +
34
- 'every oi input, or read the other units through an oi_candles input');
37
+ const market = lane === undefined ? '' : ` on ${lane.slice(lane.indexOf('@') + 1).replace('|', '/')}`;
38
+ throw new Error(`oi inputs${market} declare two units (${declared.inputs.join(', ')}: ${declared.currency}; ${input.name}: ${currency}) ` +
39
+ `(${WRUN_OI_ONE_LANE_CODE}): one package reads one open interest lane per market, so declare the same currency on ` +
40
+ 'every oi input of a market, or read the other units through an oi_candles input');
35
41
  }
36
42
  declared =
37
43
  declared === undefined
@@ -311,7 +311,7 @@ export function wrunOptionFlowGrouping(args) {
311
311
  }
312
312
  const cashSession = OPTION_BAR_ANCHOR_RULES[OPTION_BAR_ANCHOR.US_EQUITY_RTH];
313
313
  if (cashSession.fitsTier(tierMs, barMs, false) &&
314
- isEquityRegularSessionGated(barGrid?.exchange, barGrid?.sessionType) &&
314
+ isEquityRegularSessionGated(barGrid?.exchange, barGrid?.sessionType, barMs) &&
315
315
  lands((ts) => cashSession.barOpenMs(ts, barMs), everyDrop)) {
316
316
  return { kind: 'bars', barSeconds: barMs / 1000, barAnchor: cashSession.anchor };
317
317
  }
@@ -675,8 +675,8 @@ export declare function wrunOptionViewRowWidthsOf(sourceClass: WrunOptionViewCla
675
675
  * by): a view block's row width when its words name a fold (`wrunOptionViewWordsRowWidth`: a page view fold, a book
676
676
  * fold's own width when wider, the strike kit fold), the class's tuple and its velocity lists when an `option_strikes`
677
677
  * input names `velocity_windows` (`wrunOptionStrikesVelocityWidth`; the kit sizes it so from the om schema's knob on,
678
- * `WRUN_OPTION_STRIKES_VELOCITY_SERVED`), else the class's own width. The words alone decide it, never a param, so a
679
- * setting never resizes a block.
678
+ * `WRUN_OPTION_STRIKES_VELOCITY_SERVED`), a banded book's two (`bands`), else the class's own width. The words alone
679
+ * decide it, never a param, so a setting never resizes a block.
680
680
  */
681
681
  export declare function wrunOptionInputTupleWidth(source: Readonly<Record<string, unknown>>, classWidth: number): number;
682
682
  /** pb-common `OptionSurfacePick` by word (the gateway decodes numbers, never names). */
@@ -60,6 +60,7 @@
60
60
  import { wrunChartHostEnv } from '../../host-env.js';
61
61
  import { gateSessionHeldElsewhere } from '../v2/gate-session-latch.util.js';
62
62
  import { refuseWrunPollInput } from './sources/wrun-poll-lane.types.js';
63
+ import { isWrunBandedBookSource, WRUN_BOOK_BAND_TUPLE_WIDTH } from './wrun-book-bands.leaf.js';
63
64
  import { refuseWrunOptionKnob } from './wrun-option-knobs.util.js';
64
65
  import { wrunPresentHasBit, wrunPresentIsPartial, wrunPresentWithPartial } from './wrun-present-bits.util.js';
65
66
  import { attachWrunRefusal, wrunAuthorRuleSeed } from './wrun-refusal.util.js';
@@ -1037,11 +1038,13 @@ export function wrunOptionViewRowWidthsOf(sourceClass) {
1037
1038
  * by): a view block's row width when its words name a fold (`wrunOptionViewWordsRowWidth`: a page view fold, a book
1038
1039
  * fold's own width when wider, the strike kit fold), the class's tuple and its velocity lists when an `option_strikes`
1039
1040
  * input names `velocity_windows` (`wrunOptionStrikesVelocityWidth`; the kit sizes it so from the om schema's knob on,
1040
- * `WRUN_OPTION_STRIKES_VELOCITY_SERVED`), else the class's own width. The words alone decide it, never a param, so a
1041
- * setting never resizes a block.
1041
+ * `WRUN_OPTION_STRIKES_VELOCITY_SERVED`), a banded book's two (`bands`), else the class's own width. The words alone
1042
+ * decide it, never a param, so a setting never resizes a block.
1042
1043
  */
1043
1044
  export function wrunOptionInputTupleWidth(source, classWidth) {
1044
1045
  const cls = source.source;
1046
+ if (isWrunBandedBookSource(source))
1047
+ return WRUN_BOOK_BAND_TUPLE_WIDTH;
1045
1048
  if (cls === 'option_strikes') {
1046
1049
  if (source[WRUN_OPTION_LANE_WORDS.option_strikes.knob] === 'kit')
1047
1050
  return WRUN_OPTION_VIEW_ROW_WIDTHS.option_strikes;
@@ -0,0 +1,5 @@
1
+ import { type WrunOptionsFlowScope } from './wrun-opra-flow.leaf.js';
2
+ /** The scopes that read one underlying, so take another root's `underlying` (om `WRUN_OPTIONS_FLOW_UNDERLYING_SCOPES`). */
3
+ export declare const WRUN_OPTIONS_FLOW_UNDERLYING_SCOPES: readonly WrunOptionsFlowScope[];
4
+ /** om's words for another root beside a scope that spans underlyings (`WRUN_OPTIONS_FLOW_UNDERLYING_SCOPE_TAKES`). */
5
+ export declare function wrunOptionsFlowUnderlyingScopeTakes(underlying: unknown, scope: unknown): string | undefined;
@@ -0,0 +1,16 @@
1
+ // The options flow's contract F scope rule, off the boot path: only the flow lane and the planners' step read it.
2
+ import { WRUN_OPTIONS_FLOW_SCOPES } from './wrun-opra-flow.leaf.js';
3
+ /** The scopes that read one underlying, so take another root's `underlying` (om `WRUN_OPTIONS_FLOW_UNDERLYING_SCOPES`). */
4
+ export const WRUN_OPTIONS_FLOW_UNDERLYING_SCOPES = Object.freeze(['ticker', 'prints']);
5
+ /** om's words for another root beside a scope that spans underlyings (`WRUN_OPTIONS_FLOW_UNDERLYING_SCOPE_TAKES`). */
6
+ export function wrunOptionsFlowUnderlyingScopeTakes(underlying, scope) {
7
+ const word = scope === undefined ? 'ticker' : scope;
8
+ if (underlying === undefined || underlying === 'auto' || typeof word !== 'string')
9
+ return undefined;
10
+ if (!WRUN_OPTIONS_FLOW_SCOPES.includes(word))
11
+ return undefined;
12
+ if (WRUN_OPTIONS_FLOW_UNDERLYING_SCOPES.includes(word))
13
+ return undefined;
14
+ return (`"auto" beside scope ${JSON.stringify(word)}, which spans underlyings; ` +
15
+ `another root's flow is read under scope "ticker" or "prints" only`);
16
+ }
@@ -29,8 +29,9 @@ export interface WrunGateLaneFacts {
29
29
  optionsChainExtras?: Readonly<Record<string, unknown>>;
30
30
  }
31
31
  /**
32
- * The gate plane each lane of a run reads, by lane id: an OPRA poll lane (`opra`) and a governed row lane read OPRA;
33
- * a chain lane of either kind reads the plane its instance's chain lists on (OPRA, CME, or none for a crypto chain);
32
+ * The gate plane each lane of a run reads, by lane id: an OPRA poll lane (`opra`) reads OPRA and a governed row lane its
33
+ * plane (`governed`: OPRA, or the US stocks tape for `stocks`); a chain lane of either kind reads the plane its
34
+ * instance's chain lists on (OPRA, CME, or none for a crypto chain);
34
35
  * the options chain lane the plane of its governed chain. A lane on no gate plane is absent.
35
36
  */
36
37
  export declare function wrunLaneGatePlanes(facts: WrunGateLaneFacts): Map<string, WrunRefusalGatePlane>;
@@ -46,8 +46,9 @@ export function wrunSessionStopPlaneOf(error) {
46
46
  return refusal.out?.kind === 'take-session' ? refusal.out.plane : undefined;
47
47
  }
48
48
  /**
49
- * The gate plane each lane of a run reads, by lane id: an OPRA poll lane (`opra`) and a governed row lane read OPRA;
50
- * a chain lane of either kind reads the plane its instance's chain lists on (OPRA, CME, or none for a crypto chain);
49
+ * The gate plane each lane of a run reads, by lane id: an OPRA poll lane (`opra`) reads OPRA and a governed row lane its
50
+ * plane (`governed`: OPRA, or the US stocks tape for `stocks`); a chain lane of either kind reads the plane its
51
+ * instance's chain lists on (OPRA, CME, or none for a crypto chain);
51
52
  * the options chain lane the plane of its governed chain. A lane on no gate plane is absent.
52
53
  */
53
54
  export function wrunLaneGatePlanes(facts) {
@@ -68,8 +69,9 @@ export function wrunLaneGatePlanes(facts) {
68
69
  const lane = wrunRowLaneByKey(instance.laneKey);
69
70
  if (lane === undefined)
70
71
  continue;
71
- if (lane.governed === 'opra') {
72
- planes.set(instance.key, 'opra');
72
+ // A governed lane reads its own plane: OPRA's, or the US stocks tape's (`dark_pool`).
73
+ if (lane.governed !== undefined) {
74
+ planes.set(instance.key, lane.governed);
73
75
  continue;
74
76
  }
75
77
  const plane = wrunRowLaneChainPlane(lane, instance.extras);