@orangecharts/wrun-chart-host 0.9.0 → 0.11.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 (252) hide show
  1. package/README.md +2 -0
  2. package/dist/constants/feature-flags.constants.d.ts +15 -1
  3. package/dist/constants/feature-flags.constants.js +130 -24
  4. package/dist/constants/governed-exchanges.constants.d.ts +12 -0
  5. package/dist/constants/governed-exchanges.constants.js +16 -0
  6. package/dist/constants/opra-compliance.constants.d.ts +3 -2
  7. package/dist/constants/opra-compliance.constants.js +3 -2
  8. package/dist/constants/option-venues.constants.d.ts +2 -2
  9. package/dist/constants/scriptEditor/builtin-script-snippets.d.ts +26 -0
  10. package/dist/constants/scriptEditor/builtin-script-snippets.js +6 -0
  11. package/dist/constants/scriptEditor/technicalIndicatorScriptKeys.constants.d.ts +15 -0
  12. package/dist/constants/scriptEditor/technicalIndicatorScriptKeys.constants.js +17 -0
  13. package/dist/constants/venue-presets.constants.d.ts +20 -20
  14. package/dist/constants/venue-presets.constants.js +24 -26
  15. package/dist/host-env.d.ts +21 -5
  16. package/dist/host-env.js +6 -0
  17. package/dist/host-ports.types.d.ts +102 -19
  18. package/dist/index.d.ts +18 -0
  19. package/dist/index.js +18 -0
  20. package/dist/interfaces/cancel-reason.interface.d.ts +1 -1
  21. package/dist/interfaces/cme-realtime.interface.d.ts +16 -9
  22. package/dist/interfaces/cme-realtime.interface.js +6 -3
  23. package/dist/interfaces/kscript-diagnostics.interface.d.ts +12 -0
  24. package/dist/interfaces/opra-realtime.interface.d.ts +1 -5
  25. package/dist/interfaces/prediction-market.interface.d.ts +7 -0
  26. package/dist/interfaces/replay.interface.d.ts +8 -0
  27. package/dist/interfaces/stocks-realtime.interface.d.ts +57 -0
  28. package/dist/interfaces/stocks-realtime.interface.js +32 -0
  29. package/dist/interfaces/wrun-runtime.interface.d.ts +18 -2
  30. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +62 -94
  31. package/dist/kscript-data/controls/live-trades-merge.util.js +106 -171
  32. package/dist/market-data/billing.interface.d.ts +174 -36
  33. package/dist/market-data/billing.interface.js +58 -8
  34. package/dist/market-data/venue.d.ts +152 -7
  35. package/dist/market-data/venues/cme.contract.copy.json +66 -0
  36. package/dist/market-data/venues/cme.d.ts +126 -0
  37. package/dist/market-data/venues/cme.js +133 -0
  38. package/dist/market-data/venues/index.d.ts +294 -7
  39. package/dist/market-data/venues/index.js +49 -6
  40. package/dist/market-data/venues/opra.contract.copy.json +3 -2
  41. package/dist/market-data/venues/opra.d.ts +2 -2
  42. package/dist/market-data/venues/opra.js +5 -2
  43. package/dist/market-data/venues/stocks.contract.copy.json +64 -0
  44. package/dist/market-data/venues/stocks.d.ts +130 -0
  45. package/dist/market-data/venues/stocks.js +117 -0
  46. package/dist/settings-templates/footprint-rows.js +35 -2
  47. package/dist/settings-templates/form-rows.d.ts +2 -1
  48. package/dist/settings-templates/index.js +7 -3
  49. package/dist/settings-templates/indicator-fields.d.ts +5 -4
  50. package/dist/settings-templates/indicator-fields.js +79 -10
  51. package/dist/settings-templates/tool-rules.d.ts +32 -15
  52. package/dist/settings-templates/tool-rules.js +33 -11
  53. package/dist/settings-templates/tool-tables.generated.js +95 -31
  54. package/dist/utility/chart/book-live-bucket.util.d.ts +15 -0
  55. package/dist/utility/chart/book-live-bucket.util.js +47 -0
  56. package/dist/utility/chart/cme-cache-context.util.d.ts +5 -3
  57. package/dist/utility/chart/cme-cache-context.util.js +10 -6
  58. package/dist/utility/chart/cme-realtime.util.js +10 -0
  59. package/dist/utility/chart/cme-user-scripts-gate.util.d.ts +83 -0
  60. package/dist/utility/chart/cme-user-scripts-gate.util.js +142 -0
  61. package/dist/utility/chart/effective-chart-session.util.d.ts +14 -0
  62. package/dist/utility/chart/effective-chart-session.util.js +39 -0
  63. package/dist/utility/chart/host-bar-placement.util.d.ts +28 -0
  64. package/dist/utility/chart/host-bar-placement.util.js +170 -30
  65. package/dist/utility/chart/index-host-tier.util.d.ts +3 -1
  66. package/dist/utility/chart/index-host-tier.util.js +7 -2
  67. package/dist/utility/chart/index-mode-admission.util.js +30 -3
  68. package/dist/utility/chart/kscript-apply-fingerprint.util.js +1 -1
  69. package/dist/utility/chart/kscript-drawing-safe-area.util.d.ts +35 -11
  70. package/dist/utility/chart/kscript-drawing-safe-area.util.js +145 -35
  71. package/dist/utility/chart/kscript-live-coalesce.util.d.ts +9 -7
  72. package/dist/utility/chart/kscript-live-coalesce.util.js +13 -8
  73. package/dist/utility/chart/kscript-live-source-identity.util.d.ts +9 -0
  74. package/dist/utility/chart/kscript-live-source-identity.util.js +10 -1
  75. package/dist/utility/chart/kscript-provenance-keys.util.js +13 -0
  76. package/dist/utility/chart/kscript-standin-identity.leaf.d.ts +5 -1
  77. package/dist/utility/chart/kscript-titancharts-render-keys.constants.d.ts +32 -2
  78. package/dist/utility/chart/kscript-titancharts-render-keys.constants.js +45 -0
  79. package/dist/utility/chart/kscript-venue-policy.util.d.ts +156 -43
  80. package/dist/utility/chart/kscript-venue-policy.util.js +249 -59
  81. package/dist/utility/chart/live-bucket.util.d.ts +24 -8
  82. package/dist/utility/chart/live-bucket.util.js +85 -27
  83. package/dist/utility/chart/market-session-schedule.util.d.ts +10 -0
  84. package/dist/utility/chart/market-session-schedule.util.js +16 -0
  85. package/dist/utility/chart/marketKind.util.js +5 -0
  86. package/dist/utility/chart/mixed-mode.util.d.ts +7 -0
  87. package/dist/utility/chart/mixed-mode.util.js +14 -0
  88. package/dist/utility/chart/opra-read-access.leaf.d.ts +5 -3
  89. package/dist/utility/chart/opra-read-access.leaf.js +5 -3
  90. package/dist/utility/chart/opra-user-scripts-gate.util.d.ts +11 -16
  91. package/dist/utility/chart/opra-user-scripts-gate.util.js +12 -28
  92. package/dist/utility/chart/rth-session.util.d.ts +12 -10
  93. package/dist/utility/chart/rth-session.util.js +25 -21
  94. package/dist/utility/chart/trading-day.util.d.ts +17 -0
  95. package/dist/utility/chart/trading-day.util.js +59 -0
  96. package/dist/utility/chart/window-geometry.leaf.d.ts +8 -0
  97. package/dist/utility/chart/window-geometry.leaf.js +22 -6
  98. package/dist/utility/chart/window-owner.leaf.d.ts +23 -2
  99. package/dist/utility/chart/window-owner.leaf.js +45 -3
  100. package/dist/utility/chart/wrun-bar-session-facts.util.d.ts +33 -15
  101. package/dist/utility/chart/wrun-bar-session-facts.util.js +70 -20
  102. package/dist/utility/chart/wrun-run-result.util.d.ts +12 -0
  103. package/dist/utility/chart/wrun-run-result.util.js +141 -6
  104. package/dist/utility/intl-locale.util.js +5 -0
  105. package/dist/utility/options/option-bar-anchor.util.d.ts +145 -0
  106. package/dist/utility/options/option-bar-anchor.util.js +340 -0
  107. package/dist/utility/options/option-venue.util.d.ts +18 -0
  108. package/dist/utility/options/option-venue.util.js +27 -0
  109. package/dist/utility/scriptEditor/wrun-runtime-diagnostics.leaf.js +4 -0
  110. package/dist/utility/v2/gate-plane.util.d.ts +12 -3
  111. package/dist/utility/v2/gate-plane.util.js +30 -4
  112. package/dist/utility/v2/gate-session-latch.util.js +1 -1
  113. package/dist/utility/v2/stocks-governed.util.d.ts +16 -0
  114. package/dist/utility/v2/stocks-governed.util.js +34 -0
  115. package/dist/utility/wrun/derived-roots.leaf.d.ts +13 -0
  116. package/dist/utility/wrun/derived-roots.leaf.js +27 -0
  117. package/dist/utility/wrun/derived-roots.util.d.ts +205 -0
  118. package/dist/utility/wrun/derived-roots.util.js +451 -0
  119. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.d.ts +43 -7
  120. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.js +89 -19
  121. package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.d.ts +9 -4
  122. package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.js +47 -6
  123. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.d.ts +4 -2
  124. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.js +4 -2
  125. package/dist/utility/wrun/run-schedule/wrun-own-candles.util.d.ts +24 -3
  126. package/dist/utility/wrun/run-schedule/wrun-own-candles.util.js +46 -10
  127. package/dist/utility/wrun/sources/lanes/option_daily.js +5 -2
  128. package/dist/utility/wrun/sources/lanes/options_flow.js +5 -2
  129. package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +64 -19
  130. package/dist/utility/wrun/sources/opra-option-lanes.util.js +105 -35
  131. package/dist/utility/wrun/sources/row-lanes/option_contract_flow.js +2 -1
  132. package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +2 -1
  133. package/dist/utility/wrun/sources/row-lanes/option_prints.d.ts +3 -0
  134. package/dist/utility/wrun/sources/row-lanes/option_prints.js +19 -4
  135. package/dist/utility/wrun/sources/row-lanes/option_strike_flow.js +17 -4
  136. package/dist/utility/wrun/sources/row-lanes/option_strikes.d.ts +52 -13
  137. package/dist/utility/wrun/sources/row-lanes/option_strikes.js +88 -19
  138. package/dist/utility/wrun/sources/row-lanes/option_surface.js +2 -1
  139. package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +19 -0
  140. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +24 -9
  141. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +41 -10
  142. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.d.ts +111 -0
  143. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.js +133 -0
  144. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.d.ts +15 -3
  145. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.js +22 -3
  146. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +31 -0
  147. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +197 -13
  148. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +761 -27
  149. package/dist/utility/wrun/wrun-browser-sources.leaf.js +1 -2
  150. package/dist/utility/wrun/wrun-builtin-twin.util.d.ts +12 -0
  151. package/dist/utility/wrun/wrun-builtin-twin.util.js +21 -0
  152. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +60 -16
  153. package/dist/utility/wrun/wrun-chart-market-facts.util.js +113 -61
  154. package/dist/utility/wrun/wrun-color-settings.util.d.ts +9 -0
  155. package/dist/utility/wrun/wrun-color-settings.util.js +33 -0
  156. package/dist/utility/wrun/wrun-download-meter.util.d.ts +15 -0
  157. package/dist/utility/wrun/wrun-download-meter.util.js +14 -2
  158. package/dist/utility/wrun/wrun-download-plan.util.d.ts +99 -0
  159. package/dist/utility/wrun/wrun-download-plan.util.js +118 -0
  160. package/dist/utility/wrun/wrun-draft-legend-note.util.d.ts +11 -3
  161. package/dist/utility/wrun/wrun-draft-legend-note.util.js +26 -4
  162. package/dist/utility/wrun/wrun-frames.d.ts +27 -6
  163. package/dist/utility/wrun/wrun-frames.js +73 -10
  164. package/dist/utility/wrun/wrun-handles.util.d.ts +7 -3
  165. package/dist/utility/wrun/wrun-handles.util.js +9 -8
  166. package/dist/utility/wrun/wrun-hosted-wire.util.d.ts +7 -1
  167. package/dist/utility/wrun/wrun-hosted-wire.util.js +12 -2
  168. package/dist/utility/wrun/wrun-hud-looks.util.d.ts +18 -4
  169. package/dist/utility/wrun/wrun-hud-looks.util.js +45 -13
  170. package/dist/utility/wrun/wrun-input-requirements.leaf.d.ts +68 -0
  171. package/dist/utility/wrun/wrun-input-requirements.leaf.js +163 -7
  172. package/dist/utility/wrun/wrun-latest-snapshot.d.ts +11 -0
  173. package/dist/utility/wrun/wrun-leg-close.util.d.ts +59 -23
  174. package/dist/utility/wrun/wrun-leg-close.util.js +186 -28
  175. package/dist/utility/wrun/wrun-live-intake.util.d.ts +35 -15
  176. package/dist/utility/wrun/wrun-live-intake.util.js +243 -126
  177. package/dist/utility/wrun/wrun-live-tick.util.d.ts +13 -5
  178. package/dist/utility/wrun/wrun-live-tick.util.js +279 -99
  179. package/dist/utility/wrun/wrun-market-facts.util.d.ts +13 -3
  180. package/dist/utility/wrun/wrun-market-facts.util.js +13 -3
  181. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +60 -11
  182. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +70 -5
  183. package/dist/utility/wrun/wrun-market-size-defaults.util.js +31 -5
  184. package/dist/utility/wrun/wrun-opra-lane.util.d.ts +17 -4
  185. package/dist/utility/wrun/wrun-opra-lane.util.js +6 -4
  186. package/dist/utility/wrun/wrun-option-book-rows.util.d.ts +56 -0
  187. package/dist/utility/wrun/wrun-option-book-rows.util.js +96 -0
  188. package/dist/utility/wrun/wrun-option-strike-flow-forecast.util.d.ts +31 -0
  189. package/dist/utility/wrun/wrun-option-strike-flow-forecast.util.js +119 -0
  190. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.d.ts +23 -6
  191. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.js +47 -11
  192. package/dist/utility/wrun/wrun-option-strike-flow.util.d.ts +86 -19
  193. package/dist/utility/wrun/wrun-option-strike-flow.util.js +168 -62
  194. package/dist/utility/wrun/wrun-option-views.util.d.ts +323 -28
  195. package/dist/utility/wrun/wrun-option-views.util.js +484 -71
  196. package/dist/utility/wrun/wrun-options-chain.util.d.ts +3 -3
  197. package/dist/utility/wrun/wrun-options-chain.util.js +2 -0
  198. package/dist/utility/wrun/wrun-output-style.util.d.ts +6 -2
  199. package/dist/utility/wrun/wrun-output-style.util.js +20 -2
  200. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +32 -2
  201. package/dist/utility/wrun/wrun-overlay-drivers.util.js +13 -3
  202. package/dist/utility/wrun/wrun-overlay-lifecycle.util.d.ts +10 -1
  203. package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +52 -4
  204. package/dist/utility/wrun/wrun-overlay-recovery.util.js +3 -1
  205. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +160 -42
  206. package/dist/utility/wrun/wrun-overlay-run.util.js +1244 -209
  207. package/dist/utility/wrun/wrun-pane-format.util.d.ts +2 -1
  208. package/dist/utility/wrun/wrun-pane-format.util.js +7 -3
  209. package/dist/utility/wrun/wrun-panel-mount.util.d.ts +9 -0
  210. package/dist/utility/wrun/wrun-panel-mount.util.js +114 -19
  211. package/dist/utility/wrun/wrun-panel-style.util.d.ts +10 -9
  212. package/dist/utility/wrun/wrun-panel-style.util.js +58 -9
  213. package/dist/utility/wrun/wrun-param-map.util.d.ts +14 -11
  214. package/dist/utility/wrun/wrun-param-map.util.js +10 -5
  215. package/dist/utility/wrun/wrun-param-values.util.d.ts +14 -4
  216. package/dist/utility/wrun/wrun-param-values.util.js +4 -0
  217. package/dist/utility/wrun/wrun-pin-spelling.util.d.ts +15 -2
  218. package/dist/utility/wrun/wrun-pin-spelling.util.js +39 -14
  219. package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +50 -0
  220. package/dist/utility/wrun/wrun-refusal-surface.util.js +68 -0
  221. package/dist/utility/wrun/wrun-refusal.util.d.ts +3 -2
  222. package/dist/utility/wrun/wrun-refusal.util.js +22 -0
  223. package/dist/utility/wrun/wrun-refused-latest.util.d.ts +10 -0
  224. package/dist/utility/wrun/wrun-refused-latest.util.js +12 -0
  225. package/dist/utility/wrun/wrun-registry-errors.util.d.ts +26 -0
  226. package/dist/utility/wrun/wrun-registry-errors.util.js +34 -0
  227. package/dist/utility/wrun/wrun-replay-lane.util.js +3 -2
  228. package/dist/utility/wrun/wrun-row-source.d.ts +11 -0
  229. package/dist/utility/wrun/wrun-run-interval-session.util.d.ts +20 -6
  230. package/dist/utility/wrun/wrun-run-interval-session.util.js +22 -7
  231. package/dist/utility/wrun/wrun-run-interval.util.d.ts +43 -9
  232. package/dist/utility/wrun/wrun-run-interval.util.js +58 -15
  233. package/dist/utility/wrun/wrun-script-inputs.util.d.ts +45 -1
  234. package/dist/utility/wrun/wrun-script-inputs.util.js +112 -4
  235. package/dist/utility/wrun/wrun-setting-words.util.d.ts +7 -3
  236. package/dist/utility/wrun/wrun-setting-words.util.js +13 -5
  237. package/dist/utility/wrun/wrun-socket-row-source.d.ts +27 -2
  238. package/dist/utility/wrun/wrun-socket-row-source.js +118 -8
  239. package/dist/utility/wrun/wrun-source-rows.util.d.ts +29 -18
  240. package/dist/utility/wrun/wrun-source-rows.util.js +61 -27
  241. package/dist/utility/wrun/wrun-style-words.util.js +6 -4
  242. package/dist/utility/wrun/wrun-table-chrome.util.d.ts +3 -2
  243. package/dist/utility/wrun/wrun-table-chrome.util.js +19 -11
  244. package/dist/utility/wrun/wrun-tape-per-order.util.d.ts +2 -0
  245. package/dist/utility/wrun/wrun-tape-per-order.util.js +7 -0
  246. package/dist/utility/wrun/wrun-tape-source.util.d.ts +17 -9
  247. package/dist/utility/wrun/wrun-tape-source.util.js +20 -12
  248. package/dist/utils/replay/replay-buffer-math.d.ts +53 -2
  249. package/dist/utils/replay/replay-buffer-math.js +227 -20
  250. package/dist/workers/constants/socket-slots.d.ts +91 -6
  251. package/dist/workers/constants/socket-slots.js +85 -6
  252. package/package.json +5 -5
@@ -18,11 +18,14 @@
18
18
  * - GROUPED (the data plane computes): OPTION_PRINT_AGG's STRIKE, EXPIRY or EXPIRY_STRIKE scope rows, grouped to the
19
19
  * chart's bar (`barSeconds` and `barAnchor`) or trade date (`span`) by the gateway, every knob applied there
20
20
  * (`optionRead`, `wrunOptionStrikeFlowOptionRead`), one row per group key per bar (`wrunOptionStrikeFlowTupleOf`);
21
+ * the anchors are the gateway's own (the one mirror, option-bar-anchor.util: UTC, US_EQUITY_RTH, a CME chart's
22
+ * regular session on CME_RTH or CME_ENERGY_RTH, its Globex trade date on CME_SESSION), offered where they land
23
+ * (`wrunOptionFlowGrouping`, at a tier the anchor takes: `wrunOptionFlowGroupedRead`);
21
24
  * - FOLDED (today's ask): the chain's CONTRACT rows at a contract tier, summed per group key and cut by the same rules
22
25
  * in the browser (`foldWrunOptionStrikeFlowGroup`, section 6.4 step by step), when the gateway refuses `optionRead` by
23
26
  * name (a deployment without the read: the session's fallback for the plane), when the chart's bars are no grouping
24
- * the gateway can draw (a CME session bar, a week), or when the chain's book is one of several of its coin (a crypto
25
- * venue: the gateway groups by coin, every book together).
27
+ * the gateway can draw (a Globex lattice bar off the UTC floor, a week), or when the chain's book is one of several of
28
+ * its coin (a crypto venue: the gateway groups by coin, every book together).
26
29
  * The worker twin answers one row per group stamp, `[stampMs, block]`, the block one Float64Array of the stamp's tuples
27
30
  * back to back (`packWrunOptionStrikeFlowTuples`), handed over by transfer; the lane's fold reads them in place
28
31
  * (`foldWrunOptionStrikeFlowBar`, the identity of a grouped bar).
@@ -33,11 +36,12 @@
33
36
  */
34
37
  import { KSCRIPT_SOURCE_CELL_BYTES, kScriptSourceAnswerRows } from '../chart/kscript-source-answer-budget.leaf.js';
35
38
  import { liveBucketStartsInRange } from '../chart/live-bucket.util.js';
36
- import { isEquityRegularSessionGated, usEquityAnchoredBucketStartMs } from '../chart/us-equities-session.util.js';
39
+ import { isEquityRegularSessionGated } from '../chart/us-equities-session.util.js';
40
+ import { OPTION_BAR_ANCHOR, OPTION_BAR_ANCHOR_RULES, optionBarAnchorRuleOf, optionBarAnchorsTaken, optionChartClosedAt, optionGridCeilBoundaryMs, optionGridFloorBoundaryMs, optionSessionAnchorOf, } from '../options/option-bar-anchor.util.js';
37
41
  import { optionExpiresOnTradeDay, optionTradeDateClockOf, optionTradeDayByClock, optionTradeDayStartMsByClock, } from '../options/option-trade-date.util.js';
38
42
  import { wrunPartialMarkerTuple } from './wrun-present-bits.util.js';
39
43
  import { WRUN_OPTION_CONTRACT_FLOW_BOOK_FIELD, WRUN_OPTION_CONTRACT_FLOW_EXCHANGE_FIELD, WRUN_OPTION_CONTRACT_FLOW_RAW, WRUN_OPTION_CONTRACT_FLOW_RAW_WIDTH, WRUN_OPTION_PRINT_AGG_TIERS, wrunOptionContractFlowBarRows, wrunOptionFlowTodayFromOf, } from './wrun-option-contract-flow.util.js';
40
- import { compareWrunOptionStrikeFlowTuples, WRUN_OPTION_FLOW_HISTORY, WRUN_OPTION_FLOW_SPANS, WRUN_OPTION_STRIKE_FLOW_COLUMN, WRUN_OPTION_STRIKE_FLOW_GROUPS, WRUN_OPTION_STRIKE_FLOW_TIERS, WRUN_OPTION_STRIKE_FLOW_WIDTH, wrunOptionStrikeFlowExpiriesOf, wrunOptionStrikeFlowPayloadKnobsOf, } from './wrun-option-strike-flow-lane.util.js';
44
+ import { compareWrunOptionStrikeFlowTuples, WRUN_OPTION_FLOW_HISTORY, WRUN_OPTION_FLOW_SPANS, WRUN_OPTION_STRIKE_FLOW_COLUMN, WRUN_OPTION_STRIKE_FLOW_FOLD_BUDGET_FIELD, WRUN_OPTION_STRIKE_FLOW_GROUPS, WRUN_OPTION_STRIKE_FLOW_TIERS, WRUN_OPTION_STRIKE_FLOW_WIDTH, wrunOptionStrikeFlowExpiriesOf, wrunOptionStrikeFlowPayloadKnobsOf, } from './wrun-option-strike-flow-lane.util.js';
41
45
  import { refuseWrunOptionKnob, WRUN_OPTION_STRIKE_WINDOW_MAX_PCT } from './wrun-option-knobs.util.js';
42
46
  import { wrunOptionChainAskStampHolds } from './wrun-option-prints.util.js';
43
47
  import { wrunBarTiers, wrunHostBarOf, wrunHostBarSpanOf, wrunTierSegments, } from './wrun-tier-grid.util.js';
@@ -67,17 +71,21 @@ export const WRUN_OPTION_STRIKE_FLOW_COLUMNS = Object.freeze([
67
71
  export const WRUN_OPTION_STRIKE_FLOW_DTE_CLASS = Object.freeze({ whole: 0, zero: 1, later: 2 });
68
72
  /** `strike_rows`: 1 to 200 (om `WRUN_OPTION_STRIKE_ROWS_MAX`). */
69
73
  export const WRUN_OPTION_STRIKE_ROWS_MAX = 200;
70
- /** The scope word of each group (pb-common `OptionPrintAggScope` STRIKE 5, EXPIRY 6, EXPIRY_STRIKE 7). */
74
+ /** The scope word of each group (pb-common `OptionPrintAggScope` STRIKE 5, EXPIRY 6, EXPIRY_STRIKE 7) and the read its
75
+ * grouped ask is, as the gateway registers the anchors it takes (option-bar-anchor.util). */
71
76
  export const WRUN_OPTION_STRIKE_FLOW_SCOPE = Object.freeze({
72
- strike: { word: 'STRIKE', id: 5 },
73
- expiry: { word: 'EXPIRY', id: 6 },
74
- expiry_strike: { word: 'EXPIRY_STRIKE', id: 7 },
77
+ strike: { word: 'STRIKE', id: 5, read: 'OPTION_PRINT_AGG/STRIKE' },
78
+ expiry: { word: 'EXPIRY', id: 6, read: 'OPTION_PRINT_AGG/EXPIRY' },
79
+ expiry_strike: { word: 'EXPIRY_STRIKE', id: 7, read: 'OPTION_PRINT_AGG/EXPIRY_STRIKE' },
75
80
  });
76
- /** pb-common enums the request names by number (the gateway decodes JSON with encoding/json): `BarAnchor`, `BarSpan`,
77
- * `OptionExpiryClass`, `OptionDteBucket`, `OptionType`. */
81
+ /** pb-common enums the request names by number (the gateway decodes JSON with encoding/json): `BarAnchor` (the anchor
82
+ * mirror's values, option-bar-anchor.util), `BarSpan`, `OptionExpiryClass`, `OptionDteBucket`, `OptionType`. */
78
83
  export const WRUN_OPTION_READ_ENUM = Object.freeze({
79
- anchorUtc: 0,
80
- anchorUsEquityRth: 1,
84
+ anchorUtc: OPTION_BAR_ANCHOR.UTC,
85
+ anchorUsEquityRth: OPTION_BAR_ANCHOR.US_EQUITY_RTH,
86
+ anchorCmeSession: OPTION_BAR_ANCHOR.CME_SESSION,
87
+ anchorCmeRth: OPTION_BAR_ANCHOR.CME_RTH,
88
+ anchorCmeEnergyRth: OPTION_BAR_ANCHOR.CME_ENERGY_RTH,
81
89
  spanSession: 1,
82
90
  expiryZeroDte: 1,
83
91
  expiryAfterToday: 2,
@@ -205,6 +213,7 @@ export function wrunOptionStrikeFlowAcquisitionOf(payload) {
205
213
  const book = upperOf(payload?.[WRUN_OPTION_CONTRACT_FLOW_BOOK_FIELD]);
206
214
  const knobs = wrunOptionStrikeFlowPayloadKnobsOf(payload);
207
215
  const todayFromMs = wrunOptionFlowTodayFromOf(payload);
216
+ const foldBudget = payload?.[WRUN_OPTION_STRIKE_FLOW_FOLD_BUDGET_FIELD];
208
217
  return {
209
218
  coin,
210
219
  exchange: upperOf(payload?.[WRUN_OPTION_CONTRACT_FLOW_EXCHANGE_FIELD]),
@@ -213,6 +222,9 @@ export function wrunOptionStrikeFlowAcquisitionOf(payload) {
213
222
  ...(typeof payload?.tier === 'string' ? { tier: payload.tier } : {}),
214
223
  ...wrunOptionFlowBarsOf(payload),
215
224
  ...(knobs.history === 'today' && todayFromMs !== undefined ? { todayFromMs } : {}),
225
+ ...(typeof foldBudget === 'number' && Number.isInteger(foldBudget) && foldBudget >= 1
226
+ ? { foldBudgetRows: foldBudget }
227
+ : {}),
216
228
  };
217
229
  }
218
230
  /** Whether a payload is an `option_strike_flow` lane ask the K control serves: a coin, a group, one of the class's tiers
@@ -231,33 +243,33 @@ export function wrunOptionFlowClockOf(acquisition) {
231
243
  }
232
244
  /** The most tier buckets a grouping is proved over bucket by bucket (beyond it the fold reads the chart's bars). */
233
245
  const GROUPING_PROOF_MAX_BUCKETS = 60_000;
234
- /** The clock's session the gateway draws (contract 3.4): RTH on the New York date, UTC on the UTC date; none else. */
235
- function sessionAnchorOf(clock) {
236
- if (clock.rule.offsetHours !== 0 || clock.rule.weekendsToMonday === true)
237
- return undefined;
238
- if (clock.zone === 'America/New_York')
239
- return WRUN_OPTION_READ_ENUM.anchorUsEquityRth;
240
- if (clock.zone === 'UTC')
241
- return WRUN_OPTION_READ_ENUM.anchorUtc;
242
- return undefined;
243
- }
246
+ /** The read a grouping is for when its caller names none: the strike scopes' (every anchor is theirs to take). */
247
+ const STRIKE_READ = 'OPTION_PRINT_AGG/STRIKE';
248
+ const everyDrop = () => true;
249
+ const noDrop = () => false;
244
250
  /**
245
- * The grouping of one ask's window `[fromMs, toMs)` at a tier: a session span groups by trade date (the gateway's
246
- * session where the clock has one), else a chart bar of a day reads its trade date's session where that session lands
247
- * on it (a daily bar holding one New York regular session, the cash session's buckets alone, or one UTC date), else the
248
- * chart's bars when the gateway's bars are exactly them (every tier bucket of the window lands on the host bar the
249
- * gateway's bar opens on: the UTC floor, or the 09:30 New York lattice of a regular-session stock chart's 45m to 12h
250
- * bars, the tier dividing 30 minutes, a bucket outside the cash session reaching no bar on either side), else the
251
- * chart's own bars, folded in the browser.
251
+ * The grouping of one ask's window `[fromMs, toMs)` at a tier, from the anchors `read` takes on the read's venue
252
+ * (`exchange`, the chain's; a decider naming none is offered no CME anchor, as the gateway lays those over the CME
253
+ * group's rows alone): a session span groups by trade date (the anchor whose sessions are the clock's trade dates, from
254
+ * a tier its sessions fit), else a chart bar of a day reads its trade date's session where that session lands on it (a
255
+ * daily bar holding one New York regular session, the cash session's buckets alone, one UTC date, or one Globex trade
256
+ * date), else the chart's bars when the gateway's bars are exactly them (every tier bucket of the window lands on the
257
+ * host bar the gateway's bar opens on: the UTC floor; the 09:30 New York lattice of a regular-session stock chart's 45m
258
+ * to 12h bars, the tier dividing 30 minutes, a bucket outside the cash session reaching no bar on either side; a CME
259
+ * regular session's lattice on a regular-hours CME chart, the tier dividing that anchor's (15 minutes on CME_RTH, 30 on
260
+ * CME_ENERGY_RTH), the window on its boundaries, a bucket the anchor drops reaching no bar or falling where the chart's
261
+ * product holds no trading, option-bar-anchor.util `optionChartClosedAt`: a weekday product's weekend, never an
262
+ * always-on root's), else the chart's own bars, folded in the browser.
252
263
  */
253
264
  export function wrunOptionFlowGrouping(args) {
254
- const { barMs, barGrid, tierMs, fromMs, toMs, clock } = args;
255
- const sessionAnchor = sessionAnchorOf(clock);
256
- const sessionServed = sessionAnchor !== undefined &&
257
- tierMs > 0 &&
258
- (sessionAnchor === WRUN_OPTION_READ_ENUM.anchorUtc ? DAY_MS % tierMs === 0 : HALF_HOUR_MS % tierMs === 0);
265
+ const { barMs, barGrid, tierMs, fromMs, toMs, clock, exchange } = args;
266
+ const read = args.read ?? STRIKE_READ;
267
+ const sessionRule = optionSessionAnchorOf(clock, read, exchange);
268
+ const sessionServed = sessionRule?.fitsTier(tierMs, 0, true) === true ? sessionRule : undefined;
259
269
  if (args.session) {
260
- return sessionServed ? { kind: 'session', barAnchor: sessionAnchor } : { kind: 'host', session: true };
270
+ return sessionServed !== undefined
271
+ ? { kind: 'session', barAnchor: sessionServed.anchor }
272
+ : { kind: 'host', session: true };
261
273
  }
262
274
  if (barMs === undefined || !(tierMs > 0) || !(toMs > fromMs) || fromMs % tierMs !== 0 || toMs % tierMs !== 0) {
263
275
  return { kind: 'host', session: false };
@@ -266,13 +278,13 @@ export function wrunOptionFlowGrouping(args) {
266
278
  if (buckets > GROUPING_PROOF_MAX_BUCKETS)
267
279
  return { kind: 'host', session: false };
268
280
  /** Whether every bucket's group (`barOf`: the host bar its group lands on, null for a bucket the anchor drops) is the
269
- * bucket's own host bar; a dropped bucket counts only where the anchor drops off the cash session (`drops`). */
281
+ * bucket's own host bar; a dropped bucket holding a host bar counts only where `drops` says the drop loses no row. */
270
282
  const lands = (barOf, drops) => {
271
283
  for (let ts = fromMs; ts < toMs; ts += tierMs) {
272
284
  const bar = barOf(ts);
273
285
  const host = wrunHostBarOf(ts, barMs, barGrid);
274
286
  if (bar === null) {
275
- if (!drops && host !== null)
287
+ if (host !== null && !drops(ts))
276
288
  return false;
277
289
  continue;
278
290
  }
@@ -281,28 +293,101 @@ export function wrunOptionFlowGrouping(args) {
281
293
  }
282
294
  return true;
283
295
  };
284
- if (barMs === DAY_MS && sessionServed) {
285
- const anchor = sessionAnchor;
296
+ if (barMs === DAY_MS && sessionServed !== undefined) {
297
+ const rule = sessionServed;
286
298
  const sessionBar = (ts) => {
287
- const stamp = wrunOptionFlowSessionStampMs(ts, anchor);
299
+ const stamp = rule.sessionOpenMs(ts);
288
300
  return stamp === null ? null : wrunHostBarOf(stamp, barMs, barGrid);
289
301
  };
290
- if (lands(sessionBar, anchor === WRUN_OPTION_READ_ENUM.anchorUsEquityRth)) {
291
- return { kind: 'session', barAnchor: anchor };
302
+ // A regular session drops the buckets off its hours, which the daily candle of its chart never holds.
303
+ if (lands(sessionBar, rule.session !== undefined ? everyDrop : noDrop)) {
304
+ return { kind: 'session', barAnchor: rule.anchor };
292
305
  }
293
306
  }
294
307
  if (barMs >= DAY_MS || barMs % tierMs !== 0)
295
308
  return { kind: 'host', session: false };
296
- if (fromMs % barMs === 0 && toMs % barMs === 0 && lands((ts) => ts - (ts % barMs), false)) {
297
- return { kind: 'bars', barSeconds: barMs / 1000, barAnchor: WRUN_OPTION_READ_ENUM.anchorUtc };
309
+ if (fromMs % barMs === 0 && toMs % barMs === 0 && lands((ts) => ts - (ts % barMs), noDrop)) {
310
+ return { kind: 'bars', barSeconds: barMs / 1000, barAnchor: OPTION_BAR_ANCHOR.UTC };
298
311
  }
299
- if (HALF_HOUR_MS % tierMs === 0 &&
312
+ const cashSession = OPTION_BAR_ANCHOR_RULES[OPTION_BAR_ANCHOR.US_EQUITY_RTH];
313
+ if (cashSession.fitsTier(tierMs, barMs, false) &&
300
314
  isEquityRegularSessionGated(barGrid?.exchange, barGrid?.sessionType) &&
301
- lands((ts) => usEquityAnchoredBucketStartMs(ts, barMs), true)) {
302
- return { kind: 'bars', barSeconds: barMs / 1000, barAnchor: WRUN_OPTION_READ_ENUM.anchorUsEquityRth };
315
+ lands((ts) => cashSession.barOpenMs(ts, barMs), everyDrop)) {
316
+ return { kind: 'bars', barSeconds: barMs / 1000, barAnchor: cashSession.anchor };
317
+ }
318
+ // A CME regular session drops its weekend days: only where the chart's product trades none there.
319
+ const chartClosed = optionChartClosedAt(barGrid);
320
+ for (const rule of wrunOptionFlowVenueSessionRules(read, exchange)) {
321
+ if (!rule.fitsTier(tierMs, barMs, false) || !rule.isBoundary(fromMs, barMs, false))
322
+ continue;
323
+ if (!rule.isBoundary(toMs, barMs, false))
324
+ continue;
325
+ if (lands((ts) => rule.barOpenMs(ts, barMs), chartClosed)) {
326
+ return { kind: 'bars', barSeconds: barMs / 1000, barAnchor: rule.anchor };
327
+ }
303
328
  }
304
329
  return { kind: 'host', session: false };
305
330
  }
331
+ /** The regular sessions a read takes on its venue that one venue group's rows alone are laid on (a CME group venue:
332
+ * CME_RTH, CME_ENERGY_RTH), in pb-common's order; none on a venue no such anchor lays, or a read naming no venue. */
333
+ function wrunOptionFlowVenueSessionRules(read, exchange) {
334
+ return optionBarAnchorsTaken(read, exchange).filter((rule) => rule.venues !== 'every' && rule.session !== undefined);
335
+ }
336
+ /**
337
+ * The grouping of one ask and the tier its grouped read rides (OPTLOAD W3 FE-ANCHOR): the ask's own tier wherever the
338
+ * gateway groups the window there (a session at the group's 30-minute view where that holds the window,
339
+ * `wrunOptionFlowGroupedTier`), else the coarsest of the read's tiers (`tiers`) finer than the ask's, dividing it and
340
+ * still holding the window's start, at which the chart's bars ARE an anchor's bars. A regular-hours CME chart's hours
341
+ * ride the 30-minute tier (their 13:30Z opens sit on it), which CME_RTH's 16:15 close does not divide (the gateway takes
342
+ * CME_RTH from tiers dividing 15 minutes alone), so they group from 5 minutes. Else `host`, at the ask's tier.
343
+ */
344
+ export function wrunOptionFlowGroupedRead(args) {
345
+ const { askTier, fromMs, nowMs } = args;
346
+ const at = (tier) => wrunOptionFlowGrouping({
347
+ barMs: args.barMs,
348
+ barGrid: args.barGrid,
349
+ tierMs: tier.ms,
350
+ fromMs,
351
+ toMs: args.toMs,
352
+ session: args.session,
353
+ clock: args.clock,
354
+ exchange: args.exchange,
355
+ read: args.read,
356
+ });
357
+ const grouping = at(askTier);
358
+ if (grouping.kind !== 'host') {
359
+ return { grouping, tier: wrunOptionFlowGroupedTier(grouping, askTier, args.sessionTier, fromMs, nowMs) };
360
+ }
361
+ if (!args.session) {
362
+ const finer = args.tiers
363
+ .filter((tier) => tier.ms > 0 &&
364
+ tier.ms < askTier.ms &&
365
+ askTier.ms % tier.ms === 0 &&
366
+ (tier.retentionMs === undefined || fromMs >= nowMs - tier.retentionMs))
367
+ .sort((a, b) => b.ms - a.ms);
368
+ for (const tier of finer) {
369
+ const stepped = at(tier);
370
+ if (stepped.kind === 'bars')
371
+ return { grouping: stepped, tier };
372
+ }
373
+ }
374
+ return { grouping, tier: askTier };
375
+ }
376
+ /**
377
+ * The window a grouped read of `[fromMs, toMs)` sends: on a session grouping the window widened to its anchor's session
378
+ * boundaries (the gateway refuses any other window; a CME trade date a weekday holiday's session is booked into opens
379
+ * at that session's open), else the window itself (a bar grouping was proved on it, its edges on the bars).
380
+ */
381
+ export function wrunOptionFlowGroupingWindow(grouping, fromMs, toMs) {
382
+ if (grouping.kind !== 'session')
383
+ return { fromMs, toMs };
384
+ const grid = {
385
+ anchor: grouping.barAnchor,
386
+ seconds: 0,
387
+ session: true,
388
+ };
389
+ return { fromMs: optionGridFloorBoundaryMs(grid, fromMs), toMs: optionGridCeilBoundaryMs(grid, toMs) };
390
+ }
306
391
  /** The most tier buckets the nested proof walks for one read (the gateway's own limit is 15,000 points a request). */
307
392
  const NESTED_PROOF_MAX_BUCKETS = 50_000;
308
393
  /** Every UTC group width the gateway takes, widest first: the whole minutes that divide a day (contract 3.2: B below a
@@ -354,18 +439,17 @@ export function wrunOptionNestedUtcBars(args) {
354
439
  if (fromMs % width !== 0 || toMs % width !== 0)
355
440
  continue;
356
441
  if (nests(width))
357
- return { barSeconds: width / 1000, barAnchor: WRUN_OPTION_READ_ENUM.anchorUtc };
442
+ return { barSeconds: width / 1000, barAnchor: OPTION_BAR_ANCHOR.UTC };
358
443
  }
359
444
  return undefined;
360
445
  }
361
- /** The trade-date group a bucket stamped `ts` sums into under the gateway's session (contract 3.4): on RTH the New York
362
- * date's 09:30 open for a bucket inside the cash session (null outside it), on UTC the UTC date's 00:00Z. */
446
+ /** The trade-date group a bucket stamped `ts` sums into under the gateway's session on an anchor (contract 3.4, the
447
+ * anchor mirror): on RTH the New York date's 09:30 open for a bucket inside the cash session (null outside it), on UTC
448
+ * the UTC date's 00:00Z, on CME_SESSION the 17:00 Chicago open of the trade date's first session day. */
363
449
  export function wrunOptionFlowSessionStampMs(ts, barAnchor) {
364
450
  if (!Number.isFinite(ts))
365
451
  return null;
366
- if (barAnchor === WRUN_OPTION_READ_ENUM.anchorUsEquityRth)
367
- return usEquityAnchoredBucketStartMs(ts, DAY_MS);
368
- return ts - (((ts % DAY_MS) + DAY_MS) % DAY_MS);
452
+ return optionBarAnchorRuleOf(barAnchor)?.sessionOpenMs(ts) ?? null;
369
453
  }
370
454
  /**
371
455
  * The stamp of the group a bucket stamped `ts` sums into, on the browser's side of a grouping (the fold's): the
@@ -376,12 +460,8 @@ export function wrunOptionFlowGroupStampMs(ts, grouping, bars) {
376
460
  if (!Number.isFinite(ts))
377
461
  return null;
378
462
  switch (grouping.kind) {
379
- case 'bars': {
380
- const barMs = grouping.barSeconds * 1000;
381
- return grouping.barAnchor === WRUN_OPTION_READ_ENUM.anchorUsEquityRth
382
- ? usEquityAnchoredBucketStartMs(ts, barMs)
383
- : ts - (((ts % barMs) + barMs) % barMs);
384
- }
463
+ case 'bars':
464
+ return optionBarAnchorRuleOf(grouping.barAnchor)?.barOpenMs(ts, grouping.barSeconds * 1000) ?? null;
385
465
  case 'session':
386
466
  return wrunOptionFlowSessionStampMs(ts, grouping.barAnchor);
387
467
  case 'host': {
@@ -723,6 +803,10 @@ export function wrunOptionStrikeFlowZeroDte(row, tierMs, clock) {
723
803
  * bars. A newest bar that cannot fit alone is skipped (a forming day read from minutes); from the first bar that fits,
724
804
  * a bar that would pass the budget stops the walk. The kept bars are read per run of one tier (`reads`); every asked
725
805
  * bar outside them is partial. `newerBarOpens` are the host bars after the ask, up to the clock.
806
+ *
807
+ * FE-FOLD-CAP (OPTLOAD W3, under R2's flag): `budgetRows` (the ask's `foldBudgetRows`, its share of the indicator's
808
+ * download budget in contract rows) caps the walk below the source answer budget; absent, the answer budget's 49,932
809
+ * rows a read, today's plan. `projectedRows` is what the kept bars are projected to read.
726
810
  */
727
811
  export function wrunOptionStrikeFlowFoldPlan(args) {
728
812
  const { barOpens, barMs, barGrid, nowMs } = args;
@@ -735,8 +819,18 @@ export function wrunOptionStrikeFlowFoldPlan(args) {
735
819
  choice: 'coarsest',
736
820
  sessionGrid: barGrid ?? null,
737
821
  });
738
- // The per-contract read weighs as `option_contract_flow`'s raw rows do: the same read, the same budget.
739
- const budget = kScriptSourceAnswerRows(WRUN_OPTION_CONTRACT_FLOW_RAW_WIDTH);
822
+ // The per-contract read weighs as `option_contract_flow`'s raw rows do: the same read, the same budget; a budgeted
823
+ // run's share caps it below (the smaller wins).
824
+ const answerRows = kScriptSourceAnswerRows(WRUN_OPTION_CONTRACT_FLOW_RAW_WIDTH);
825
+ const cap = args.budgetRows;
826
+ const capped = typeof cap === 'number' && cap >= 1;
827
+ const budget = capped ? Math.min(answerRows, Math.floor(cap)) : answerRows;
828
+ // The projection finds the chain's plane by the contract flow's exchange field (`flowExchange`): a lane's extras name
829
+ // it there (the lane's forecast), the worker's parsed acquisition as `exchange`. Under a cap both read the chain's own
830
+ // plane, so the cap the forecast priced is the cap the worker folds by (INT 2026-10-23: the worker read the plain
831
+ // plane, an ES1! regular-hours hour at 1,458 rows for the CME plane's 4,913, and its 5,831-row cap folded 3 hours).
832
+ // Without a cap the plan reads as it did (the flag-off fold, unchanged).
833
+ const projection = capped ? wrunOptionStrikeFlowProjectionOf(args.acquisition) : args.acquisition;
740
834
  let rows = 0;
741
835
  let keptFromMs = Number.POSITIVE_INFINITY;
742
836
  let keptToMs = Number.NEGATIVE_INFINITY;
@@ -748,7 +842,7 @@ export function wrunOptionStrikeFlowFoldPlan(args) {
748
842
  continue;
749
843
  }
750
844
  const span = bar.span ?? wrunHostBarSpanOf(bar.barOpenMs, barMs, barGrid ?? null);
751
- const projected = wrunOptionContractFlowBarRows({ openMs: span.fromMs, endMs: span.toMs, tier: bar.tier }, nowMs, args.acquisition);
845
+ const projected = wrunOptionContractFlowBarRows({ openMs: span.fromMs, endMs: span.toMs, tier: bar.tier }, nowMs, projection);
752
846
  const barRows = Number.isFinite(projected) && projected > 0 ? projected : 0;
753
847
  if (keptToMs === Number.NEGATIVE_INFINITY && barRows > budget)
754
848
  continue;
@@ -767,8 +861,20 @@ export function wrunOptionStrikeFlowFoldPlan(args) {
767
861
  partialBars: barOpens.filter((open) => !keptSet.has(open)),
768
862
  keptFromMs,
769
863
  keptToMs,
864
+ projectedRows: rows,
770
865
  };
771
866
  }
867
+ /** A strike flow acquisition as the contract flow projection reads it (`wrunOptionStrikeFlowFoldPlan` under a cap): the
868
+ * chain's exchange in `flowExchange`, from the parsed acquisition's `exchange` when the field is missing. */
869
+ function wrunOptionStrikeFlowProjectionOf(acquisition) {
870
+ const named = acquisition[WRUN_OPTION_CONTRACT_FLOW_EXCHANGE_FIELD];
871
+ if (typeof named === 'string' && named.trim() !== '')
872
+ return acquisition;
873
+ const exchange = acquisition.exchange;
874
+ return typeof exchange === 'string' && exchange.trim() !== ''
875
+ ? { ...acquisition, [WRUN_OPTION_CONTRACT_FLOW_EXCHANGE_FIELD]: exchange }
876
+ : acquisition;
877
+ }
772
878
  /** The host bars `[fromMs, toMs)` holds on the chart's grid, ascending (`liveBucketStartsInRange` over the grid). */
773
879
  export function wrunOptionFlowHostBars(fromMs, toMs, barMs, barGrid) {
774
880
  if (!(toMs > fromMs) || !(barMs > 0))