@orangecharts/wrun-chart-host 0.3.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (362) hide show
  1. package/README.md +23 -6
  2. package/dist/constants/exchange-names.leaf.d.ts +8 -0
  3. package/dist/constants/exchange-names.leaf.js +101 -0
  4. package/dist/constants/kscript-data-interval-restrictions.constants.d.ts +15 -0
  5. package/dist/constants/kscript-data-interval-restrictions.constants.js +40 -0
  6. package/dist/constants/opra-compliance.constants.d.ts +19 -0
  7. package/dist/constants/opra-compliance.constants.js +19 -0
  8. package/dist/constants/replay-ladder.leaf.d.ts +30 -0
  9. package/dist/constants/replay-ladder.leaf.js +99 -0
  10. package/dist/constants/scriptEditor/builtin-script-snippets.d.ts +133 -0
  11. package/dist/constants/scriptEditor/builtin-script-snippets.js +451 -0
  12. package/dist/constants/scriptEditor/cme-official-scripts.constants.d.ts +168 -0
  13. package/dist/constants/scriptEditor/cme-official-scripts.constants.js +398 -0
  14. package/dist/constants/scriptEditor/converted-script-id.leaf.d.ts +8 -0
  15. package/dist/constants/scriptEditor/converted-script-id.leaf.js +10 -0
  16. package/dist/constants/scriptEditor/execution.constants.d.ts +4 -0
  17. package/dist/constants/scriptEditor/execution.constants.js +14 -0
  18. package/dist/constants/wrun-prefix-safe.constants.d.ts +23 -0
  19. package/dist/constants/wrun-prefix-safe.constants.js +26 -0
  20. package/dist/host-env.d.ts +321 -24
  21. package/dist/host-env.js +15 -0
  22. package/dist/host-ports.types.d.ts +857 -35
  23. package/dist/index.d.ts +149 -2
  24. package/dist/index.js +149 -2
  25. package/dist/instances/script-engine-worker-ohlcv-transfer.d.ts +31 -0
  26. package/dist/instances/script-engine-worker-ohlcv-transfer.js +164 -0
  27. package/dist/interfaces/market-event.interface.d.ts +231 -0
  28. package/dist/interfaces/market-event.interface.js +15 -0
  29. package/dist/interfaces/opra-realtime.interface.d.ts +70 -134
  30. package/dist/interfaces/opra-realtime.interface.js +34 -59
  31. package/dist/interfaces/replay.interface.d.ts +285 -0
  32. package/dist/interfaces/replay.interface.js +1 -0
  33. package/dist/kscript-data/controls/live-ohlcv-merge.util.d.ts +1 -0
  34. package/dist/kscript-data/controls/live-ohlcv-merge.util.js +93 -0
  35. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +5 -1
  36. package/dist/kscript-data/controls/live-trades-merge.util.js +2 -2
  37. package/dist/market-data/billing.interface.d.ts +219 -0
  38. package/dist/market-data/billing.interface.js +58 -0
  39. package/dist/market-data/venue-governed.util.d.ts +2 -0
  40. package/dist/market-data/venue-governed.util.js +10 -0
  41. package/dist/market-data/venue.d.ts +122 -0
  42. package/dist/market-data/venue.js +1 -0
  43. package/dist/market-data/venues/index.d.ts +97 -0
  44. package/dist/market-data/venues/index.js +33 -0
  45. package/dist/market-data/venues/opra.contract.copy.json +35 -0
  46. package/dist/market-data/venues/opra.d.ts +70 -0
  47. package/dist/market-data/venues/opra.js +74 -0
  48. package/dist/replay/replayIndicatorRows.d.ts +31 -0
  49. package/dist/replay/replayIndicatorRows.js +117 -0
  50. package/dist/replay/replayLadder.d.ts +85 -0
  51. package/dist/replay/replayLadder.js +388 -0
  52. package/dist/utility/auth/server-clock.util.d.ts +81 -0
  53. package/dist/utility/auth/server-clock.util.js +238 -0
  54. package/dist/utility/chart/builtin-identity.util.d.ts +18 -0
  55. package/dist/utility/chart/builtin-identity.util.js +51 -0
  56. package/dist/utility/chart/cache-alignment.util.d.ts +454 -0
  57. package/dist/utility/chart/cache-alignment.util.js +926 -0
  58. package/dist/utility/chart/chart-data-fetch-generation.util.d.ts +15 -0
  59. package/dist/utility/chart/chart-data-fetch-generation.util.js +22 -0
  60. package/dist/utility/chart/chart-mount-epoch.util.d.ts +5 -0
  61. package/dist/utility/chart/chart-mount-epoch.util.js +29 -0
  62. package/dist/utility/chart/chart-time-domain.util.d.ts +12 -0
  63. package/dist/utility/chart/chart-time-domain.util.js +23 -0
  64. package/dist/utility/chart/color-customization.leaf.d.ts +10 -0
  65. package/dist/utility/chart/color-customization.leaf.js +16 -0
  66. package/dist/utility/chart/date-labelled-interval.leaf.d.ts +15 -0
  67. package/dist/utility/chart/date-labelled-interval.leaf.js +19 -0
  68. package/dist/utility/chart/footprint-tick-grid.util.d.ts +106 -0
  69. package/dist/utility/chart/footprint-tick-grid.util.js +167 -0
  70. package/dist/utility/chart/gesture-timing.leaf.d.ts +29 -0
  71. package/dist/utility/chart/gesture-timing.leaf.js +29 -0
  72. package/dist/utility/chart/governed-contract-coin.util.d.ts +22 -0
  73. package/dist/utility/chart/governed-contract-coin.util.js +39 -0
  74. package/dist/utility/chart/host-bar-placement.util.d.ts +107 -0
  75. package/dist/utility/chart/host-bar-placement.util.js +447 -0
  76. package/dist/utility/chart/index-host-tier.util.d.ts +31 -0
  77. package/dist/utility/chart/index-host-tier.util.js +118 -0
  78. package/dist/utility/chart/index-mode-admission.util.d.ts +34 -0
  79. package/dist/utility/chart/index-mode-admission.util.js +67 -0
  80. package/dist/utility/chart/indicator-error-message.util.d.ts +35 -0
  81. package/dist/utility/chart/indicator-error-message.util.js +44 -0
  82. package/dist/utility/chart/indicator-run-interval.util.d.ts +130 -0
  83. package/dist/utility/chart/indicator-run-interval.util.js +268 -0
  84. package/dist/utility/chart/kscript-apply-fingerprint.util.d.ts +65 -0
  85. package/dist/utility/chart/kscript-apply-fingerprint.util.js +357 -0
  86. package/dist/utility/chart/kscript-chart-flush.leaf.d.ts +22 -0
  87. package/dist/utility/chart/kscript-chart-flush.leaf.js +13 -0
  88. package/dist/utility/chart/kscript-data-interval-restriction.leaf.d.ts +6 -0
  89. package/dist/utility/chart/kscript-data-interval-restriction.leaf.js +27 -0
  90. package/dist/utility/chart/kscript-integration-decision.leaf.d.ts +89 -0
  91. package/dist/utility/chart/kscript-integration-decision.leaf.js +80 -0
  92. package/dist/utility/chart/kscript-live-coalesce.util.d.ts +76 -0
  93. package/dist/utility/chart/kscript-live-coalesce.util.js +156 -0
  94. package/dist/utility/chart/kscript-live-rest-pace.util.d.ts +34 -0
  95. package/dist/utility/chart/kscript-live-rest-pace.util.js +134 -0
  96. package/dist/utility/chart/kscript-live-source-identity.util.d.ts +98 -0
  97. package/dist/utility/chart/kscript-live-source-identity.util.js +121 -0
  98. package/dist/utility/chart/kscript-mounted-plot-set.leaf.d.ts +48 -0
  99. package/dist/utility/chart/kscript-mounted-plot-set.leaf.js +145 -0
  100. package/dist/utility/chart/kscript-perf-tracker.util.d.ts +243 -0
  101. package/dist/utility/chart/kscript-perf-tracker.util.js +522 -0
  102. package/dist/utility/chart/kscript-run-interval-projection.util.d.ts +43 -0
  103. package/dist/utility/chart/kscript-run-interval-projection.util.js +471 -0
  104. package/dist/utility/chart/kscript-run-result-equality.util.d.ts +38 -0
  105. package/dist/utility/chart/kscript-run-result-equality.util.js +89 -0
  106. package/dist/utility/chart/kscript-settings-revision.leaf.d.ts +2 -0
  107. package/dist/utility/chart/kscript-settings-revision.leaf.js +12 -0
  108. package/dist/utility/chart/kscript-source-degrade.leaf.d.ts +63 -0
  109. package/dist/utility/chart/kscript-source-degrade.leaf.js +68 -0
  110. package/dist/utility/chart/kscript-source-retention.util.d.ts +134 -0
  111. package/dist/utility/chart/kscript-source-retention.util.js +218 -0
  112. package/dist/utility/chart/kscript-standin-identity.leaf.d.ts +57 -0
  113. package/dist/utility/chart/kscript-standin-identity.leaf.js +61 -0
  114. package/dist/utility/chart/kscript-titancharts-preparation.util.d.ts +15 -0
  115. package/dist/utility/chart/kscript-titancharts-preparation.util.js +376 -0
  116. package/dist/utility/chart/kscript-titancharts-render-keys.constants.d.ts +9 -0
  117. package/dist/utility/chart/kscript-titancharts-render-keys.constants.js +130 -0
  118. package/dist/utility/chart/kscript-venue-policy.util.d.ts +217 -0
  119. package/dist/utility/chart/kscript-venue-policy.util.js +324 -0
  120. package/dist/utility/chart/live-cadence.util.d.ts +38 -0
  121. package/dist/utility/chart/live-cadence.util.js +37 -0
  122. package/dist/utility/chart/live-feed-series-match.leaf.d.ts +13 -0
  123. package/dist/utility/chart/live-feed-series-match.leaf.js +21 -0
  124. package/dist/utility/chart/local-engine-self-heal-backoff.util.d.ts +46 -0
  125. package/dist/utility/chart/local-engine-self-heal-backoff.util.js +46 -0
  126. package/dist/utility/chart/local-engine-uninit.leaf.d.ts +21 -0
  127. package/dist/utility/chart/local-engine-uninit.leaf.js +22 -0
  128. package/dist/utility/chart/local-kscript-source-revalidation.util.d.ts +62 -0
  129. package/dist/utility/chart/local-kscript-source-revalidation.util.js +123 -0
  130. package/dist/utility/chart/local-kscript-warmup-depth.util.d.ts +214 -0
  131. package/dist/utility/chart/local-kscript-warmup-depth.util.js +376 -0
  132. package/dist/utility/chart/local-technical-script-live-apply-coalescer.util.d.ts +85 -0
  133. package/dist/utility/chart/local-technical-script-live-apply-coalescer.util.js +197 -0
  134. package/dist/utility/chart/local-technical-script-range.leaf.d.ts +72 -0
  135. package/dist/utility/chart/local-technical-script-range.leaf.js +126 -0
  136. package/dist/utility/chart/mixed-mode.util.d.ts +167 -0
  137. package/dist/utility/chart/mixed-mode.util.js +139 -0
  138. package/dist/utility/chart/ohlcv-row-readiness.util.d.ts +36 -0
  139. package/dist/utility/chart/ohlcv-row-readiness.util.js +90 -0
  140. package/dist/utility/chart/opra-user-scripts-gate.util.d.ts +19 -0
  141. package/dist/utility/chart/opra-user-scripts-gate.util.js +32 -0
  142. package/dist/utility/chart/overlay-execution-guard-key.leaf.d.ts +8 -0
  143. package/dist/utility/chart/overlay-execution-guard-key.leaf.js +10 -0
  144. package/dist/utility/chart/price-precision.util.d.ts +40 -0
  145. package/dist/utility/chart/price-precision.util.js +70 -0
  146. package/dist/utility/chart/profile-block-size.util.d.ts +64 -0
  147. package/dist/utility/chart/profile-block-size.util.js +141 -0
  148. package/dist/utility/chart/protected-kscript-degenerate-rows.leaf.d.ts +11 -0
  149. package/dist/utility/chart/protected-kscript-degenerate-rows.leaf.js +29 -0
  150. package/dist/utility/chart/protected-kscript-empty-output.util.d.ts +28 -0
  151. package/dist/utility/chart/protected-kscript-empty-output.util.js +84 -0
  152. package/dist/utility/chart/run-interval-unservable.leaf.d.ts +9 -0
  153. package/dist/utility/chart/run-interval-unservable.leaf.js +20 -0
  154. package/dist/utility/chart/run-interval-warmup.leaf.d.ts +19 -0
  155. package/dist/utility/chart/run-interval-warmup.leaf.js +35 -0
  156. package/dist/utility/chart/titan-constants.pin.d.ts +9 -5
  157. package/dist/utility/chart/titan-constants.pin.js +18 -5
  158. package/dist/utility/chart/warmup-backfill-retry.leaf.d.ts +9 -0
  159. package/dist/utility/chart/warmup-backfill-retry.leaf.js +9 -0
  160. package/dist/utility/chart/window-geometry.leaf.d.ts +119 -0
  161. package/dist/utility/chart/window-geometry.leaf.js +391 -0
  162. package/dist/utility/chart/window-owner.leaf.d.ts +19 -0
  163. package/dist/utility/chart/window-owner.leaf.js +24 -0
  164. package/dist/utility/chart/wrun-bar-session-facts.util.d.ts +11 -2
  165. package/dist/utility/chart/wrun-bar-session-facts.util.js +10 -3
  166. package/dist/utility/chart/wrun-run-result.util.d.ts +5 -1
  167. package/dist/utility/chart/wrun-run-result.util.js +20 -14
  168. package/dist/utility/common/data-processing.util.d.ts +138 -0
  169. package/dist/utility/common/data-processing.util.js +346 -0
  170. package/dist/utility/common/visible-timeout.util.d.ts +13 -4
  171. package/dist/utility/common/visible-timeout.util.js +23 -8
  172. package/dist/utility/exchange-format.leaf.d.ts +1 -0
  173. package/dist/utility/exchange-format.leaf.js +47 -0
  174. package/dist/utility/html-escape.leaf.d.ts +11 -0
  175. package/dist/utility/html-escape.leaf.js +20 -0
  176. package/dist/utility/market-events/earnings-scope.util.d.ts +60 -0
  177. package/dist/utility/market-events/earnings-scope.util.js +92 -0
  178. package/dist/utility/market-events/market-events.util.d.ts +147 -0
  179. package/dist/utility/market-events/market-events.util.js +392 -0
  180. package/dist/utility/market-events/zoned-clock.util.d.ts +1 -0
  181. package/dist/utility/market-events/zoned-clock.util.js +11 -0
  182. package/dist/utility/options/option-venue-disclosure.util.d.ts +43 -0
  183. package/dist/utility/options/option-venue-disclosure.util.js +56 -0
  184. package/dist/utility/scriptEditor/package-semver.util.d.ts +51 -0
  185. package/dist/utility/scriptEditor/package-semver.util.js +120 -0
  186. package/dist/utility/scriptEditor/temp-script-id.util.d.ts +18 -0
  187. package/dist/utility/scriptEditor/temp-script-id.util.js +25 -0
  188. package/dist/utility/symbol-selection/markets-request-from-symbols.leaf.d.ts +20 -0
  189. package/dist/utility/symbol-selection/markets-request-from-symbols.leaf.js +81 -0
  190. package/dist/utility/v2/governed-tier.leaf.d.ts +103 -0
  191. package/dist/utility/v2/governed-tier.leaf.js +113 -0
  192. package/dist/utility/watchlist/import/import-request.leaf.d.ts +10 -0
  193. package/dist/utility/watchlist/import/import-request.leaf.js +10 -0
  194. package/dist/utility/wrun/sources/lanes/option_daily.d.ts +43 -15
  195. package/dist/utility/wrun/sources/lanes/option_daily.js +78 -20
  196. package/dist/utility/wrun/sources/lanes/option_stats_10m.d.ts +14 -10
  197. package/dist/utility/wrun/sources/lanes/option_stats_10m.js +5 -4
  198. package/dist/utility/wrun/sources/lanes/series.js +2 -2
  199. package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +22 -3
  200. package/dist/utility/wrun/sources/opra-option-lanes.util.js +38 -7
  201. package/dist/utility/wrun/sources/registry.js +31 -1
  202. package/dist/utility/wrun/sources/row-lane-registry.js +5 -5
  203. package/dist/utility/wrun/sources/row-lanes/option_contract_state.d.ts +49 -0
  204. package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +75 -20
  205. package/dist/utility/wrun/sources/row-lanes/option_strikes.d.ts +49 -0
  206. package/dist/utility/wrun/sources/row-lanes/option_strikes.js +57 -47
  207. package/dist/utility/wrun/sources/row-lanes/option_surface.d.ts +36 -4
  208. package/dist/utility/wrun/sources/row-lanes/option_surface.js +6 -12
  209. package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +37 -3
  210. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +128 -2
  211. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +233 -51
  212. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +0 -8
  213. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +26 -24
  214. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +85 -104
  215. package/dist/utility/wrun/wrun-alert-outputs.registry.d.ts +166 -0
  216. package/dist/utility/wrun/wrun-alert-outputs.registry.js +219 -0
  217. package/dist/utility/wrun/wrun-bar-count.util.d.ts +83 -0
  218. package/dist/utility/wrun/wrun-bar-count.util.js +259 -0
  219. package/dist/utility/wrun/wrun-chart-context-names.util.d.ts +84 -0
  220. package/dist/utility/wrun/wrun-chart-context-names.util.js +186 -0
  221. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +253 -0
  222. package/dist/utility/wrun/wrun-chart-market-facts.util.js +731 -0
  223. package/dist/utility/wrun/wrun-cloud-opra-stamp.util.d.ts +28 -0
  224. package/dist/utility/wrun/wrun-cloud-opra-stamp.util.js +45 -0
  225. package/dist/utility/wrun/wrun-coin-lane-live.util.d.ts +18 -0
  226. package/dist/utility/wrun/wrun-coin-lane-live.util.js +47 -0
  227. package/dist/utility/wrun/wrun-deadline.util.js +2 -1
  228. package/dist/utility/wrun/wrun-debug-output.util.d.ts +39 -0
  229. package/dist/utility/wrun/wrun-debug-output.util.js +63 -0
  230. package/dist/utility/wrun/wrun-declared-warmup.util.d.ts +113 -0
  231. package/dist/utility/wrun/wrun-declared-warmup.util.js +181 -0
  232. package/dist/utility/wrun/wrun-draft-legend-note.util.d.ts +43 -0
  233. package/dist/utility/wrun/wrun-draft-legend-note.util.js +158 -0
  234. package/dist/utility/wrun/wrun-draft-overlay.util.d.ts +181 -0
  235. package/dist/utility/wrun/wrun-draft-overlay.util.js +357 -0
  236. package/dist/utility/wrun/wrun-draw-skipped.leaf.d.ts +16 -0
  237. package/dist/utility/wrun/wrun-draw-skipped.leaf.js +16 -0
  238. package/dist/utility/wrun/wrun-earnings-facts.util.d.ts +42 -0
  239. package/dist/utility/wrun/wrun-earnings-facts.util.js +131 -0
  240. package/dist/utility/wrun/wrun-first-run-depth.util.d.ts +32 -0
  241. package/dist/utility/wrun/wrun-first-run-depth.util.js +118 -0
  242. package/dist/utility/wrun/wrun-gate-plane-readers.util.d.ts +24 -0
  243. package/dist/utility/wrun/wrun-gate-plane-readers.util.js +31 -0
  244. package/dist/utility/wrun/wrun-held-lanes.util.d.ts +32 -0
  245. package/dist/utility/wrun/wrun-held-lanes.util.js +94 -0
  246. package/dist/utility/wrun/wrun-host-visible-clock.util.d.ts +2 -0
  247. package/dist/utility/wrun/wrun-host-visible-clock.util.js +17 -0
  248. package/dist/utility/wrun/wrun-host.service.d.ts +266 -0
  249. package/dist/utility/wrun/wrun-host.service.js +655 -0
  250. package/dist/utility/wrun/wrun-inert-legend.util.d.ts +33 -0
  251. package/dist/utility/wrun/wrun-inert-legend.util.js +125 -0
  252. package/dist/utility/wrun/wrun-input-requirements.leaf.d.ts +155 -0
  253. package/dist/utility/wrun/wrun-input-requirements.leaf.js +450 -0
  254. package/dist/utility/wrun/wrun-integration-route.util.d.ts +51 -0
  255. package/dist/utility/wrun/wrun-integration-route.util.js +59 -0
  256. package/dist/utility/wrun/wrun-latest-history.leaf.d.ts +8 -0
  257. package/dist/utility/wrun/wrun-latest-history.leaf.js +8 -0
  258. package/dist/utility/wrun/wrun-legend-hover.lazy.d.ts +12 -0
  259. package/dist/utility/wrun/wrun-legend-hover.lazy.js +96 -0
  260. package/dist/utility/wrun/wrun-lifecycle-runtime.util.d.ts +21 -0
  261. package/dist/utility/wrun/wrun-lifecycle-runtime.util.js +21 -0
  262. package/dist/utility/wrun/wrun-live-hidden-hold.util.d.ts +23 -0
  263. package/dist/utility/wrun/wrun-live-hidden-hold.util.js +13 -0
  264. package/dist/utility/wrun/wrun-live-intake.util.d.ts +374 -0
  265. package/dist/utility/wrun/wrun-live-intake.util.js +2027 -0
  266. package/dist/utility/wrun/wrun-live-patch.util.d.ts +116 -0
  267. package/dist/utility/wrun/wrun-live-patch.util.js +523 -0
  268. package/dist/utility/wrun/wrun-live-tick.util.d.ts +619 -0
  269. package/dist/utility/wrun/wrun-live-tick.util.js +4974 -0
  270. package/dist/utility/wrun/wrun-loading-owner.util.d.ts +58 -0
  271. package/dist/utility/wrun/wrun-loading-owner.util.js +89 -0
  272. package/dist/utility/wrun/wrun-official-scope.leaf.d.ts +29 -0
  273. package/dist/utility/wrun/wrun-official-scope.leaf.js +36 -0
  274. package/dist/utility/wrun/wrun-oi-lane.util.d.ts +27 -0
  275. package/dist/utility/wrun/wrun-oi-lane.util.js +42 -0
  276. package/dist/utility/wrun/wrun-opra-stats.leaf.d.ts +29 -10
  277. package/dist/utility/wrun/wrun-opra-stats.leaf.js +29 -10
  278. package/dist/utility/wrun/wrun-options-stop.util.d.ts +52 -0
  279. package/dist/utility/wrun/wrun-options-stop.util.js +123 -0
  280. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +719 -0
  281. package/dist/utility/wrun/wrun-overlay-drivers.util.js +1180 -0
  282. package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.d.ts +50 -0
  283. package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.js +131 -0
  284. package/dist/utility/wrun/wrun-overlay-lifecycle.util.d.ts +118 -0
  285. package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +466 -0
  286. package/dist/utility/wrun/wrun-overlay-metadata.util.d.ts +45 -0
  287. package/dist/utility/wrun/wrun-overlay-metadata.util.js +112 -0
  288. package/dist/utility/wrun/wrun-overlay-recovery.util.d.ts +114 -0
  289. package/dist/utility/wrun/wrun-overlay-recovery.util.js +971 -0
  290. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +858 -0
  291. package/dist/utility/wrun/wrun-overlay-run.util.js +11013 -0
  292. package/dist/utility/wrun/wrun-panel-mount.lazy.d.ts +10 -0
  293. package/dist/utility/wrun/wrun-panel-mount.lazy.js +68 -0
  294. package/dist/utility/wrun/wrun-panel-mount.util.d.ts +392 -0
  295. package/dist/utility/wrun/wrun-panel-mount.util.js +2346 -0
  296. package/dist/utility/wrun/wrun-param-map.util.d.ts +19 -4
  297. package/dist/utility/wrun/wrun-param-map.util.js +40 -47
  298. package/dist/utility/wrun/wrun-param-values.util.d.ts +9 -3
  299. package/dist/utility/wrun/wrun-param-values.util.js +5 -5
  300. package/dist/utility/wrun/wrun-pause-dim.util.d.ts +52 -0
  301. package/dist/utility/wrun/wrun-pause-dim.util.js +153 -0
  302. package/dist/utility/wrun/wrun-plot-gate.types.d.ts +23 -0
  303. package/dist/utility/wrun/wrun-plot-gate.types.js +7 -0
  304. package/dist/utility/wrun/wrun-prefix-cohort.util.d.ts +93 -0
  305. package/dist/utility/wrun/wrun-prefix-cohort.util.js +484 -0
  306. package/dist/utility/wrun/wrun-prefix-lanes.util.d.ts +114 -0
  307. package/dist/utility/wrun/wrun-prefix-lanes.util.js +486 -0
  308. package/dist/utility/wrun/wrun-prefix-proof.util.d.ts +317 -0
  309. package/dist/utility/wrun/wrun-prefix-proof.util.js +630 -0
  310. package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +73 -0
  311. package/dist/utility/wrun/wrun-refusal-surface.util.js +380 -0
  312. package/dist/utility/wrun/wrun-refusal-text.util.d.ts +15 -0
  313. package/dist/utility/wrun/wrun-refusal-text.util.js +40 -0
  314. package/dist/utility/wrun/wrun-replay-lane.util.d.ts +139 -0
  315. package/dist/utility/wrun/wrun-replay-lane.util.js +520 -0
  316. package/dist/utility/wrun/wrun-replay-rows.util.d.ts +21 -0
  317. package/dist/utility/wrun/wrun-replay-rows.util.js +172 -0
  318. package/dist/utility/wrun/wrun-row-source-factory.d.ts +53 -0
  319. package/dist/utility/wrun/wrun-row-source-factory.js +435 -0
  320. package/dist/utility/wrun/wrun-run-cells.util.d.ts +36 -0
  321. package/dist/utility/wrun/wrun-run-cells.util.js +46 -0
  322. package/dist/utility/wrun/wrun-run-interval-projection.types.d.ts +14 -0
  323. package/dist/utility/wrun/wrun-run-interval-projection.types.js +1 -0
  324. package/dist/utility/wrun/wrun-run-interval-session.util.d.ts +133 -0
  325. package/dist/utility/wrun/wrun-run-interval-session.util.js +121 -0
  326. package/dist/utility/wrun/wrun-run-interval.util.d.ts +98 -0
  327. package/dist/utility/wrun/wrun-run-interval.util.js +207 -0
  328. package/dist/utility/wrun/wrun-run-retained.util.d.ts +122 -0
  329. package/dist/utility/wrun/wrun-run-retained.util.js +255 -0
  330. package/dist/utility/wrun/wrun-sandbox-row-source.d.ts +184 -0
  331. package/dist/utility/wrun/wrun-sandbox-row-source.js +444 -0
  332. package/dist/utility/wrun/wrun-script-inputs.util.js +4 -4
  333. package/dist/utility/wrun/wrun-series-stream.util.d.ts +86 -0
  334. package/dist/utility/wrun/wrun-series-stream.util.js +537 -0
  335. package/dist/utility/wrun/wrun-sheet-remembered.util.d.ts +21 -0
  336. package/dist/utility/wrun/wrun-sheet-remembered.util.js +36 -0
  337. package/dist/utility/wrun/wrun-signal-sound-reasons.leaf.d.ts +7 -0
  338. package/dist/utility/wrun/wrun-signal-sound-reasons.leaf.js +12 -0
  339. package/dist/utility/wrun/wrun-socket-row-source.js +4 -2
  340. package/dist/utility/wrun/wrun-source-rows.util.d.ts +175 -3
  341. package/dist/utility/wrun/wrun-source-rows.util.js +294 -8
  342. package/dist/utility/wrun/wrun-stats-strip.util.d.ts +46 -0
  343. package/dist/utility/wrun/wrun-stats-strip.util.js +87 -0
  344. package/dist/utility/wrun/wrun-table-chrome.util.d.ts +163 -0
  345. package/dist/utility/wrun/wrun-table-chrome.util.js +557 -0
  346. package/dist/utility/wrun/wrun-text-params.util.d.ts +11 -6
  347. package/dist/utility/wrun/wrun-text-params.util.js +19 -30
  348. package/dist/utility/wrun/wrun-transient-rerun.util.d.ts +64 -0
  349. package/dist/utility/wrun/wrun-transient-rerun.util.js +317 -0
  350. package/dist/utility/wrun/wrun-twin-lookback.util.d.ts +10 -0
  351. package/dist/utility/wrun/wrun-twin-lookback.util.js +43 -0
  352. package/dist/utility/wrun/wrun-warmup-head-store.util.d.ts +41 -0
  353. package/dist/utility/wrun/wrun-warmup-head-store.util.js +120 -0
  354. package/dist/utility/wrun-alert-params.leaf.d.ts +24 -0
  355. package/dist/utility/wrun-alert-params.leaf.js +24 -0
  356. package/dist/utils/replay/replay-buffer-math.d.ts +148 -0
  357. package/dist/utils/replay/replay-buffer-math.js +684 -0
  358. package/dist/workers/wrun/wrun-abi-host.d.ts +190 -0
  359. package/dist/workers/wrun/wrun-abi-host.js +1201 -0
  360. package/dist/workers/wrun/wrun-engine-handler.d.ts +37 -0
  361. package/dist/workers/wrun/wrun-engine-handler.js +211 -0
  362. package/package.json +3 -3
@@ -1,42 +1,88 @@
1
1
  /**
2
- * `option_contract_state`: the chain summary of every contract of the chart's underlying with the prior session's close
3
- * and the prior open interest, on the LIVE bar only (UW-PARITY S7, `contracts/sources.md`).
2
+ * `option_contract_state`: the chain summary of every contract of the chart's options chain with the prior session's
3
+ * close and the prior open interest, on the LIVE bar only (UW-PARITY S7, `contracts/sources.md`), on every chain the
4
+ * chain summary serves (OPTIONS-PORT P5: OPRA, CME, the crypto venues).
4
5
  *
5
6
  * - Tuple, width 13: `[root_code, expiry_ms, side_cp, strike, bid, ask, last, prev_close, theta, volume_day, oi, oi_prev,
6
7
  * present]`; bits 4 to 11 of `present` say which of bid through oi_prev were served (0 with the bit clear otherwise).
7
8
  * `prev_close` and `oi_prev` are kiyotaka-go !62's chain fields (`prevClose`, `openInterestPrev`, decoded since
8
9
  * pb-common 12.68.0); a summary that leaves one out reads 0 with its bit clear. There is no protocol-pending refusal
9
10
  * for this class.
10
- * - Backend: the governed `StreamOptionChainSummary` read the options chain lane reads (the worker's chain store,
11
- * `ensureFreshChain`), as an acquisition of its own (`K_OPTION_CHAIN_SUMMARY`: a package reading `options_chain` too
12
- * reads the chain twice, separately; the hand-wired chain lane is untouched). The K type is om's fetch type for the
13
- * class (`option_chain_summary`).
11
+ * - Units (OPTIONS-PORT C3): sizes (`volume_day`, `oi`, `oi_prev`) in coin on a crypto chain, contracts on OPRA and
12
+ * CME; prices (`bid`, `ask`, `last`, `prev_close`) in USD per underlying unit on every venue (the worker converts a
13
+ * coin-quoted book's, and serves one absent when the price it converts by is unknown).
14
+ * - Backend: the chain summary of the chain's exchange and underlying, as an acquisition of its own
15
+ * (`K_OPTION_CHAIN_SUMMARY`: a package reading `options_chain` too reads the chain twice, separately). On OPRA and
16
+ * CME the governed `StreamOptionChainSummary` read the options chain lane reads (the worker's chain store,
17
+ * `ensureFreshChain`); on a crypto chain the plain read (the worker's plain chain summary util). The K type is om's
18
+ * fetch type for the class (`option_chain_summary`).
14
19
  * - Landing `latest`: the newest chain snapshot is the live row's block, every other row an empty one (read it on
15
20
  * `bar.isLast()`), like `options_chain`; an empty chain degrades like every state lane.
16
- * - Knobs (acquisition facets): `expiries` ("all", "nearest:N" or "0dte") and `strike_window_pct` (above 0, at most 100);
17
- * `max_cells` is required (the static plan) and a block over it refuses the run, never truncated. A market pin and
18
- * the knobs of the other options classes are refused by name.
19
- * - Governed by OPRA: served where the chart's options ride the OPRA plane (a US stock or ETF chart, an OPRA contract
20
- * chart), the wall for a run that may not read OPRA, the provenance stamp and the routed tier (U10a's rules).
21
+ * - A CHAIN lane (`chain`): the chain is the one chain resolver's (opra-option-lanes.util `decideWrunLaneChain`), per
22
+ * input, and its plane is per instance: OPRA's rules on a US stock or OPRA contract chart (unchanged: the wall, the
23
+ * provenance stamp, the routed tier), CME's on a CME futures chart (a continuous chart reads its lead contract, and a
24
+ * live session rebuilds once the lead rolls: `acquisitionMoved`), none on a crypto chain. ONE book per input (D11),
25
+ * named in the acquisition (`stateBook`) unless it is the underlying's own series; the worker keeps its contracts.
26
+ * - Knobs (acquisition facets): `expiries` ("all", "nearest:N" or "0dte", the chain's market's own trade date) and
27
+ * `strike_window_pct` (above 0, at most 100), `book` (`auto` or one series name), `venue` (kit 0.87.0: the chain
28
+ * the one venue decision names for the word, in `options_chain`'s words; absent reads `auto`, the chain
29
+ * `options_chain`'s `auto` reads on the same chart); `max_cells` is required (the static plan) and a block over it
30
+ * refuses the run, never truncated. A market pin and the knobs of the other options classes are refused by name.
21
31
  *
22
- * LIGHT at module load: the chain resolver is imported inside `identity`.
32
+ * LIGHT at module load: the chain resolver's directory, listing and lead reads run inside `identity` and `facets`.
23
33
  */
24
- import { refuseWrunLaneStrayKnob, resolveWrunLaneOpraChain } from '../opra-option-lanes.util.js';
34
+ import { decideWrunLaneChain, refuseWrunLaneStrayKnob, resolveWrunLaneChainChart, wrunLaneChainLeadMoved, wrunLaneChartKey, } from '../opra-option-lanes.util.js';
25
35
  import { refuseWrunPollInput } from '../wrun-poll-lane.types.js';
26
36
  import { wrunOptionExpiriesKnob, wrunOptionExpiriesText, wrunOptionStrikeWindowKnob, } from '../../wrun-option-knobs.util.js';
27
37
  /** f64s per tuple (the source contract's width, the `present` mask included). */
28
38
  export const WRUN_OPTION_CONTRACT_STATE_WIDTH = 13;
29
39
  /** om's code for a market pin on the OPRA classes. */
30
40
  export const WRUN_OPTION_MARKET_PINNED_CODE = 'wrun_option_market_pinned';
31
- /** The knobs of the other options classes, each refused here by name. */
41
+ /** The payload field an instance names its chain's exchange in (its plane follows it). */
42
+ export const WRUN_OPTION_CONTRACT_STATE_EXCHANGE_FIELD = 'stateExchange';
43
+ /** The knobs of the other options classes, each refused here by name (`venue` is this class's own since kit 0.87.0). */
32
44
  const STRAY_KNOBS = [
33
- ['venue', "'options_chain', 'option_strikes', 'option_surface', 'options_oi' and 'options_volume'"],
34
45
  ['history', "'tape' and 'option_prints' celled"],
35
46
  ['min_size', "'tape' celled"],
36
47
  ['min_premium', "'option_prints' celled"],
37
48
  ['overflow', "'option_prints' celled"],
38
49
  ['min_volume', "'option_contract_flow' celled"],
39
50
  ];
51
+ /** What `identity` resolved for a chart (the one chain resolver's chart), read back by `facets`. Keyed by the chart
52
+ * market; the newest entries kept. */
53
+ const STATE_CHARTS_KEPT = 16;
54
+ const stateCharts = new Map();
55
+ function rememberStateChart(key, chart) {
56
+ stateCharts.delete(key);
57
+ stateCharts.set(key, chart);
58
+ while (stateCharts.size > STATE_CHARTS_KEPT)
59
+ stateCharts.delete(stateCharts.keys().next().value);
60
+ }
61
+ /** Test seam: forget every resolved chart. */
62
+ export function __resetWrunContractStateChartsForTests() {
63
+ stateCharts.clear();
64
+ }
65
+ /**
66
+ * An input's chain as the ask's fields (the acquisition key: the class, the plane its exchange names, the exchange,
67
+ * the underlying, the book): `stateExchange` and `stateUnderlying` always (an OPRA chain's exactly as before),
68
+ * `stateBook` for a book other than the underlying's own series (Deribit's BTC_USDC, OKX's BTC-USD), and
69
+ * `stateContinuous` for a CME chain read off a continuous alias (`wrunOptionContractStateAcquisitionMoved` reads it).
70
+ */
71
+ export function wrunOptionContractStateExtras(chain) {
72
+ const book = chain.book.toUpperCase();
73
+ return {
74
+ [WRUN_OPTION_CONTRACT_STATE_EXCHANGE_FIELD]: chain.exchange,
75
+ stateUnderlying: chain.underlying,
76
+ ...(book !== chain.underlying.toUpperCase() ? { stateBook: book } : {}),
77
+ ...(chain.continuous !== undefined ? { stateContinuous: chain.continuous } : {}),
78
+ };
79
+ }
80
+ /** Whether an acquisition no longer names the contract the lane would plan now (D12): a CME chain read off a
81
+ * continuous alias whose lead rolled since the run planned it (`wrunLaneChainLeadMoved`). A live session holding it
82
+ * rebuilds, so the live bar never reads the old contract's chain under the new one's name. */
83
+ export function wrunOptionContractStateAcquisitionMoved(acquisition) {
84
+ return wrunLaneChainLeadMoved(acquisition[WRUN_OPTION_CONTRACT_STATE_EXCHANGE_FIELD], acquisition.stateContinuous, acquisition.stateUnderlying);
85
+ }
40
86
  export const rowLane = {
41
87
  sourceClass: 'option_contract_state',
42
88
  laneKey: 'option_contract_state',
@@ -45,13 +91,13 @@ export const rowLane = {
45
91
  label: 'Option contract quotes',
46
92
  feedWords: 'wrun.refusal.feed.optionContractState',
47
93
  width: WRUN_OPTION_CONTRACT_STATE_WIDTH,
48
- governed: 'opra',
94
+ chain: { exchangeField: WRUN_OPTION_CONTRACT_STATE_EXCHANGE_FIELD },
49
95
  landing: { kind: 'latest' },
96
+ acquisitionMoved: wrunOptionContractStateAcquisitionMoved,
50
97
  identity: async (ctx) => {
51
- const chain = await resolveWrunLaneOpraChain(ctx);
52
- return { stateExchange: chain.exchange, stateUnderlying: chain.underlying };
98
+ rememberStateChart(wrunLaneChartKey(ctx), await resolveWrunLaneChainChart(ctx));
53
99
  },
54
- facets: (source, ctx) => {
100
+ facets: async (source, ctx) => {
55
101
  for (const [knob, owners] of STRAY_KNOBS) {
56
102
  if (source[knob] !== undefined)
57
103
  refuseWrunLaneStrayKnob(ctx, knob, owners);
@@ -59,10 +105,19 @@ export const rowLane = {
59
105
  if (source.symbol !== undefined || source.exchange !== undefined) {
60
106
  refuseWrunPollInput(ctx, `pins option_contract_state cells to a fixed market (${WRUN_OPTION_MARKET_PINNED_CODE}); it reads the chart's own underlying, so drop the symbol and exchange pin`, { cls: 'run-failed', variant: 'generic' });
61
107
  }
62
- // om's knob words and its one refusal name (`wrun_option_knob_invalid`), as every OPRA class refuses them.
108
+ // om's knob words and its one refusal name (`wrun_option_knob_invalid`), as every options class refuses them.
63
109
  const expiries = wrunOptionExpiriesKnob(source, ctx);
64
110
  const strikeWindowPct = wrunOptionStrikeWindowKnob(source, ctx);
111
+ const chart = stateCharts.get(wrunLaneChartKey(ctx));
112
+ if (chart === undefined) {
113
+ return refuseWrunPollInput(ctx, 'could not resolve the chart market for its options chain: Run again', {
114
+ cls: 'run-failed',
115
+ variant: 'generic',
116
+ });
117
+ }
118
+ const chain = await decideWrunLaneChain(chart, { venue: source.venue, book: source.book }, ctx);
65
119
  return {
120
+ ...wrunOptionContractStateExtras(chain),
66
121
  stateExpiries: wrunOptionExpiriesText(expiries),
67
122
  ...(strikeWindowPct !== undefined ? { stateStrikeWindowPct: strikeWindowPct } : {}),
68
123
  };
@@ -1,3 +1,38 @@
1
+ /**
2
+ * `option_strikes`: the chart's options chain measured by strike on EVERY bar (UW-PARITY S1, adopting om's class as
3
+ * the om worktree `feat/wrun-option-strikes` defines it: `WRUN_OPTION_STRIKES_TUPLE_WIDTH`, wrun-host cells.ts
4
+ * `kscriptStrikeCells` / `wrunOptionStrikesBlock`, docs "Option strikes"), on every chain the strike job writes
5
+ * (OPTIONS-PORT P5: OPRA, CME, the crypto venues).
6
+ *
7
+ * - Tuple, width 12, NO `present` mask: `[strike, expiry_ms, net_gex, call_gex, put_gex, net_dex, net_vex, call_oi,
8
+ * put_oi, call_iv, put_iv, underlying]`. A side the strike does not list reads NaN in its own fields, and so does an
9
+ * IV the side does not report: only a strike or an expiry that is not a finite number drops the tuple (om's adapter;
10
+ * `finiteColumns`), and nothing reads bit 14 off the last column (`presentMask: false`). On a crypto chain `call_oi`
11
+ * and `put_oi` are in coin (OPTIONS-PORT C3), contracts on OPRA and CME.
12
+ * - Per bar: ONE snapshot, the newest minute of strike rows inside the bar (every expiry and strike of that minute),
13
+ * stamped at the bar's open: a snapshot landing with no tier rule (`landing: { kind: 'snapshot' }`, the newest row of
14
+ * each host bar, any chart interval), its rows read off OPTION_STRIKE_AGG (pb-common 12.67.0, MINUTE, by the chain's
15
+ * exchange and underlying; the K_OPTION_STRIKES control and its worker twin). A bar holding no minute (outside the
16
+ * session, a minute the backend missed, history past its about seven days) is an EMPTY block; an empty answer is
17
+ * quiet (om's `absence: "empty"`).
18
+ * - A CHAIN lane (`chain`): the chain is the one chain resolver's (opra-option-lanes.util `decideWrunLaneChain`), per
19
+ * input, and its plane is per instance: OPRA's rules on a US stock or OPRA contract chart (unchanged: the wall, native
20
+ * rows, the provenance stamp, the routed tier), CME's on a CME futures chart (a continuous chart reads its lead
21
+ * contract's rows, and a live session rebuilds once the lead rolls: `acquisitionMoved`), none on a crypto chain.
22
+ * Every chain the decision resolves is read.
23
+ * - ONE book per input (D11): the `book` knob (`auto`, the chain's default book off its directory, or one series name)
24
+ * decided when the run plans and named in the acquisition (`strikeBook`) unless it is the underlying's own series. A
25
+ * strike read by coin answers every book of the chain (a row's book rides its synthetic symbol's `|<series>` tail), so
26
+ * the worker keeps the asked book's rows and keys its store by the book.
27
+ * - Knobs, the options chain's words: `venue` ("auto" by default) through the venue decision every chain class shares
28
+ * (`decideWrunLaneChainIdentity`: a pinned word, the flag, the listing, the directory, the OPRA wall), `book`, and
29
+ * `expiries` ("all", or "nearest:N": the N earliest expiries each bar's snapshot lists, kept per input before the
30
+ * packer judges `max_cells`, never a fetch facet). A market pin, `history` and `min_size` are refused by name; a
31
+ * block over `max_cells` refuses the run (wrun_cell_block_too_large, never truncated). One chain per package.
32
+ *
33
+ * LIGHT at module load: the chain resolver's directory, listing and lead reads run inside `identity` and `facets`.
34
+ */
35
+ import { type WrunLaneChain } from '../opra-option-lanes.util.js';
1
36
  import type { WrunRowLaneDescriptor } from '../wrun-row-lane.types.js';
2
37
  /** f64s per tuple (om's `WRUN_OPTION_STRIKES_TUPLE_WIDTH`). */
3
38
  export declare const WRUN_OPTION_STRIKES_WIDTH = 12;
@@ -5,9 +40,23 @@ export declare const WRUN_OPTION_STRIKES_WIDTH = 12;
5
40
  export declare const WRUN_OPTION_STRIKES_FINITE_COLUMNS: readonly number[];
6
41
  /** om's code for a market pin on the chain classes. */
7
42
  export declare const WRUN_OPTIONS_CHAIN_MARKET_PINNED_CODE = "wrun_options_chain_market_pinned";
43
+ /** The payload field an instance names its chain's exchange in (its plane follows it). */
44
+ export declare const WRUN_OPTION_STRIKES_EXCHANGE_FIELD = "strikeExchange";
8
45
  /** Test seam: forget every resolved chart. */
9
46
  export declare function __resetWrunStrikesChartsForTests(): void;
10
47
  /** The tuples an input keeps under its `expiries` word: every one, or ("nearest:N") the tuples of the N earliest
11
48
  * distinct expiries the bar's snapshot lists (om's `wrunOptionsChainKept`, the expiry being the second member). */
12
49
  export declare function wrunOptionStrikesKept(tuples: ReadonlyArray<ReadonlyArray<number>>, expiriesWord: unknown): ReadonlyArray<ReadonlyArray<number>>;
50
+ /**
51
+ * An input's chain as the ask's fields (the acquisition key: the class, the plane its exchange names, the exchange,
52
+ * the underlying, the book): `strikeExchange` and `strikeUnderlying` always (an OPRA chain's exactly as before),
53
+ * `strikeBook` for a book other than the underlying's own series (Deribit's BTC_USDC, OKX's BTC-USD: the strike job
54
+ * writes a `|<series>` tail for those alone), and `strikeContinuous` for a CME chain read off a continuous alias
55
+ * (`wrunOptionStrikesAcquisitionMoved` reads it).
56
+ */
57
+ export declare function wrunOptionStrikesExtras(chain: WrunLaneChain): Record<string, unknown>;
58
+ /** Whether an acquisition no longer names the contract the lane would plan now (D12): a CME chain read off a
59
+ * continuous alias whose lead rolled since the run planned it (`wrunLaneChainLeadMoved`). A live session holding it
60
+ * rebuilds, so no store or buffer joins the old contract's strikes to the new one's. */
61
+ export declare function wrunOptionStrikesAcquisitionMoved(acquisition: Readonly<Record<string, unknown>>): boolean;
13
62
  export declare const rowLane: WrunRowLaneDescriptor;
@@ -1,33 +1,40 @@
1
1
  /**
2
2
  * `option_strikes`: the chart's options chain measured by strike on EVERY bar (UW-PARITY S1, adopting om's class as
3
3
  * the om worktree `feat/wrun-option-strikes` defines it: `WRUN_OPTION_STRIKES_TUPLE_WIDTH`, wrun-host cells.ts
4
- * `kscriptStrikeCells` / `wrunOptionStrikesBlock`, docs "Option strikes").
4
+ * `kscriptStrikeCells` / `wrunOptionStrikesBlock`, docs "Option strikes"), on every chain the strike job writes
5
+ * (OPTIONS-PORT P5: OPRA, CME, the crypto venues).
5
6
  *
6
7
  * - Tuple, width 12, NO `present` mask: `[strike, expiry_ms, net_gex, call_gex, put_gex, net_dex, net_vex, call_oi,
7
8
  * put_oi, call_iv, put_iv, underlying]`. A side the strike does not list reads NaN in its own fields, and so does an
8
9
  * IV the side does not report: only a strike or an expiry that is not a finite number drops the tuple (om's adapter;
9
- * `finiteColumns`), and nothing reads bit 14 off the last column (`presentMask: false`).
10
+ * `finiteColumns`), and nothing reads bit 14 off the last column (`presentMask: false`). On a crypto chain `call_oi`
11
+ * and `put_oi` are in coin (OPTIONS-PORT C3), contracts on OPRA and CME.
10
12
  * - Per bar: ONE snapshot, the newest minute of strike rows inside the bar (every expiry and strike of that minute),
11
13
  * stamped at the bar's open: a snapshot landing with no tier rule (`landing: { kind: 'snapshot' }`, the newest row of
12
- * each host bar, any chart interval), its rows read off OPTION_STRIKE_AGG (pb-common 12.67.0, MINUTE, by the
13
- * chain's underlying; the K_OPTION_STRIKES control and its worker twin). A bar holding no minute (outside the
14
+ * each host bar, any chart interval), its rows read off OPTION_STRIKE_AGG (pb-common 12.67.0, MINUTE, by the chain's
15
+ * exchange and underlying; the K_OPTION_STRIKES control and its worker twin). A bar holding no minute (outside the
14
16
  * session, a minute the backend missed, history past its about seven days) is an EMPTY block; an empty answer is
15
17
  * quiet (om's `absence: "empty"`).
16
- * - Knobs, the options chain's words: `venue` ("auto" by default) through the chain decision the options_chain lane
17
- * makes (`decideWrunOptionsChainIdentity`: a pinned word, the flag, the listing, the directory, the OPRA wall), and
18
+ * - A CHAIN lane (`chain`): the chain is the one chain resolver's (opra-option-lanes.util `decideWrunLaneChain`), per
19
+ * input, and its plane is per instance: OPRA's rules on a US stock or OPRA contract chart (unchanged: the wall, native
20
+ * rows, the provenance stamp, the routed tier), CME's on a CME futures chart (a continuous chart reads its lead
21
+ * contract's rows, and a live session rebuilds once the lead rolls: `acquisitionMoved`), none on a crypto chain.
22
+ * Every chain the decision resolves is read.
23
+ * - ONE book per input (D11): the `book` knob (`auto`, the chain's default book off its directory, or one series name)
24
+ * decided when the run plans and named in the acquisition (`strikeBook`) unless it is the underlying's own series. A
25
+ * strike read by coin answers every book of the chain (a row's book rides its synthetic symbol's `|<series>` tail), so
26
+ * the worker keeps the asked book's rows and keys its store by the book.
27
+ * - Knobs, the options chain's words: `venue` ("auto" by default) through the venue decision every chain class shares
28
+ * (`decideWrunLaneChainIdentity`: a pinned word, the flag, the listing, the directory, the OPRA wall), `book`, and
18
29
  * `expiries` ("all", or "nearest:N": the N earliest expiries each bar's snapshot lists, kept per input before the
19
30
  * packer judges `max_cells`, never a fetch facet). A market pin, `history` and `min_size` are refused by name; a
20
31
  * block over `max_cells` refuses the run (wrun_cell_block_too_large, never truncated). One chain per package.
21
- * - The strike rows exist for OPRA chains only: on a chart whose options ride the OPRA plane the lane is governed
22
- * (the wall, native rows, the provenance stamp, the routed tier); anywhere else (`offPlane: 'empty'`) the decision
23
- * still refuses by name, and a chain it resolves (Deribit, CME, a crypto venue) reads empty blocks with no fetch.
24
32
  *
25
- * LIGHT at module load: the chain resolver and the listing are imported inside `identity`.
33
+ * LIGHT at module load: the chain resolver's directory, listing and lead reads run inside `identity` and `facets`.
26
34
  */
27
- import { wrunChartHostEnv } from '../../../../host-env.js';
28
- import { refuseWrunLaneStrayKnob, resolveWrunLaneChartChain, resolveWrunLaneCryptoVenues, wrunLaneChainRefusalError, wrunLaneChartKey, } from '../opra-option-lanes.util.js';
35
+ import { decideWrunLaneChain, decideWrunLaneChainIdentity, refuseWrunLaneStrayKnob, resolveWrunLaneChainChart, wrunLaneChainLeadMoved, wrunLaneChainRefusalError, wrunLaneChartKey, } from '../opra-option-lanes.util.js';
29
36
  import { refuseWrunPollInput } from '../wrun-poll-lane.types.js';
30
- import { decideWrunOptionsChainIdentity, WRUN_OPTIONS_CHAIN_EXPIRIES_CODE, wrunOptionsChainExpiries, wrunOptionsChainIdentityKey, } from '../../wrun-options-chain.util.js';
37
+ import { WRUN_OPTIONS_CHAIN_EXPIRIES_CODE, wrunOptionsChainExpiries, wrunOptionsChainIdentityKey, } from '../../wrun-options-chain.util.js';
31
38
  import { attachWrunRefusal } from '../../wrun-refusal.util.js';
32
39
  /** f64s per tuple (om's `WRUN_OPTION_STRIKES_TUPLE_WIDTH`). */
33
40
  export const WRUN_OPTION_STRIKES_WIDTH = 12;
@@ -35,6 +42,10 @@ export const WRUN_OPTION_STRIKES_WIDTH = 12;
35
42
  export const WRUN_OPTION_STRIKES_FINITE_COLUMNS = Object.freeze([0, 1]);
36
43
  /** om's code for a market pin on the chain classes. */
37
44
  export const WRUN_OPTIONS_CHAIN_MARKET_PINNED_CODE = 'wrun_options_chain_market_pinned';
45
+ /** The payload field an instance names its chain's exchange in (its plane follows it). */
46
+ export const WRUN_OPTION_STRIKES_EXCHANGE_FIELD = 'strikeExchange';
47
+ /** What `identity` resolved for a chart (the one chain resolver's chart), read back by `facets`. Keyed by the chart
48
+ * market; the newest entries kept. */
38
49
  const STRIKES_CHARTS_KEPT = 16;
39
50
  const strikesCharts = new Map();
40
51
  function rememberStrikesChart(key, chart) {
@@ -57,6 +68,28 @@ export function wrunOptionStrikesKept(tuples, expiriesWord) {
57
68
  const nearest = new Set(distinct.slice(0, expiries.count));
58
69
  return tuples.filter((tuple) => nearest.has(Number(tuple[1])));
59
70
  }
71
+ /**
72
+ * An input's chain as the ask's fields (the acquisition key: the class, the plane its exchange names, the exchange,
73
+ * the underlying, the book): `strikeExchange` and `strikeUnderlying` always (an OPRA chain's exactly as before),
74
+ * `strikeBook` for a book other than the underlying's own series (Deribit's BTC_USDC, OKX's BTC-USD: the strike job
75
+ * writes a `|<series>` tail for those alone), and `strikeContinuous` for a CME chain read off a continuous alias
76
+ * (`wrunOptionStrikesAcquisitionMoved` reads it).
77
+ */
78
+ export function wrunOptionStrikesExtras(chain) {
79
+ const book = chain.book.toUpperCase();
80
+ return {
81
+ [WRUN_OPTION_STRIKES_EXCHANGE_FIELD]: chain.exchange,
82
+ strikeUnderlying: chain.underlying,
83
+ ...(book !== chain.underlying.toUpperCase() ? { strikeBook: book } : {}),
84
+ ...(chain.continuous !== undefined ? { strikeContinuous: chain.continuous } : {}),
85
+ };
86
+ }
87
+ /** Whether an acquisition no longer names the contract the lane would plan now (D12): a CME chain read off a
88
+ * continuous alias whose lead rolled since the run planned it (`wrunLaneChainLeadMoved`). A live session holding it
89
+ * rebuilds, so no store or buffer joins the old contract's strikes to the new one's. */
90
+ export function wrunOptionStrikesAcquisitionMoved(acquisition) {
91
+ return wrunLaneChainLeadMoved(acquisition[WRUN_OPTION_STRIKES_EXCHANGE_FIELD], acquisition.strikeContinuous, acquisition.strikeUnderlying);
92
+ }
60
93
  export const rowLane = {
61
94
  sourceClass: 'option_strikes',
62
95
  laneKey: 'option_strikes',
@@ -66,20 +99,15 @@ export const rowLane = {
66
99
  width: WRUN_OPTION_STRIKES_WIDTH,
67
100
  finiteColumns: WRUN_OPTION_STRIKES_FINITE_COLUMNS,
68
101
  presentMask: false,
69
- governed: 'opra',
70
- offPlane: 'empty',
102
+ chain: { exchangeField: WRUN_OPTION_STRIKES_EXCHANGE_FIELD },
71
103
  acquisitions: 'one',
72
104
  emptyAnswer: 'quiet',
73
105
  landing: { kind: 'snapshot' },
106
+ acquisitionMoved: wrunOptionStrikesAcquisitionMoved,
74
107
  identity: async (ctx) => {
75
- const chain = await resolveWrunLaneChartChain(ctx);
76
- const [cryptoVenues, { hasDeribitOptions }] = await Promise.all([
77
- resolveWrunLaneCryptoVenues(chain, ctx.coin),
78
- wrunChartHostEnv().market.loadDeribitOptions(),
79
- ]);
80
- rememberStrikesChart(wrunLaneChartKey(ctx), { chain, cryptoVenues, deribitListed: hasDeribitOptions });
108
+ rememberStrikesChart(wrunLaneChartKey(ctx), await resolveWrunLaneChainChart(ctx));
81
109
  },
82
- facets: (source, ctx) => {
110
+ facets: async (source, ctx) => {
83
111
  for (const knob of ['history', 'min_size']) {
84
112
  if (source[knob] !== undefined)
85
113
  refuseWrunLaneStrayKnob(ctx, knob, "'tape' celled");
@@ -94,25 +122,11 @@ export const rowLane = {
94
122
  variant: 'generic',
95
123
  });
96
124
  }
97
- const decision = decideWrunOptionsChainIdentity({
98
- venue: source.venue === undefined ? undefined : String(source.venue),
99
- chartSource: chart.chain.chartSource,
100
- chartCoin: ctx.coin,
101
- deribitListed: chart.deribitListed,
102
- cryptoVenues: chart.cryptoVenues,
103
- marketLabel: `${ctx.exchange}/${ctx.symbol}`,
104
- inputName: ctx.inputName,
105
- official: ctx.official === true,
106
- opraUserScripts: ctx.opraUserScripts === true,
107
- ...(chart.chain.directoryFailed !== undefined ? { directoryFailed: chart.chain.directoryFailed } : {}),
108
- // The known reason the chart's OPRA options ride no plane (the flag, the router): the refusal says it.
109
- ...(chart.chain.opraStop !== undefined ? { opraStop: chart.chain.opraStop } : {}),
110
- // Another screen holds the session of the chain's plane: the refusal says so, with Resume here.
111
- ...(chart.chain.heldElsewhere !== undefined ? { heldElsewhere: chart.chain.heldElsewhere } : {}),
112
- });
113
125
  // om's order: the venue word, then the expiries word, then the chain the word resolves.
114
- if (!decision.ok && decision.reason === 'bad-venue-word')
126
+ const decision = decideWrunLaneChainIdentity(chart, source.venue, ctx);
127
+ if (!decision.ok && decision.reason === 'bad-venue-word') {
115
128
  throw wrunLaneChainRefusalError(decision, 'option_strikes');
129
+ }
116
130
  const expiries = source.expiries;
117
131
  const expiriesRead = expiries === undefined || (typeof expiries === 'string' && wrunOptionsChainExpiries(expiries) !== undefined);
118
132
  if (!expiriesRead) {
@@ -120,15 +134,11 @@ export const rowLane = {
120
134
  }
121
135
  if (!decision.ok)
122
136
  throw wrunLaneChainRefusalError(decision, 'option_strikes');
123
- const { identity } = decision;
124
- const strikeChain = wrunOptionsChainIdentityKey(identity);
125
- // Only an OPRA chain lists strike rows; any other chain the word resolves (off the plane) is never fetched.
126
- if (identity.venue !== 'opra')
127
- return { strikeChain };
137
+ const chain = await decideWrunLaneChain(chart, { venue: source.venue, book: source.book }, ctx);
128
138
  return {
129
- strikeChain,
130
- strikeExchange: identity.exchange,
131
- strikeUnderlying: identity.underlying,
139
+ // The chain's identity as the options chain keys it (one chain per package: `acquisitions: 'one'`).
140
+ strikeChain: wrunOptionsChainIdentityKey(decision.identity),
141
+ ...wrunOptionStrikesExtras(chain),
132
142
  // The run's bar span: the worker keeps the newest minute of each of these bars.
133
143
  hostIntervalMs: ctx.intervalMs,
134
144
  };
@@ -1,3 +1,35 @@
1
+ /**
2
+ * `option_surface`: the volatility surface of the chart's options chain, one tuple per expiry on every bar (UW-PARITY S9,
3
+ * `contracts/sources.md`), on every chain the surface job samples (OPTIONS-PORT P1: the crypto venues, CME, OPRA).
4
+ *
5
+ * - Tuple, width 9: `[expiry_ms, dte_days, forward, atm_iv, iv_p25, iv_c25, iv_p10, iv_c10, present]`; bits 1 to 7 of
6
+ * `present` for dte_days through iv_c10 (each bit its column, 0 with the bit clear when the sample leaves it out),
7
+ * bit 8 when the forward came from put-call parity, bit 14 a partial bar.
8
+ * - Backend: OPTION_SURFACE (type 251, kiyotaka-go !62), venue-agnostic, by the chain's exchange and underlying (a
9
+ * crypto venue's root coin, a CME futures contract, an OPRA ticker), one surface per BOOK (a chain's series: Deribit's
10
+ * BTC and BTC_USDC, OKX's BTC-USD and BTC-USD_UM), sampled by the option-surface job into two tiers: 5m kept 30 days
11
+ * and 1d (the session's last sample, or a CME settlement, stamped at its UTC date) kept for good. pb-common 12.68.0
12
+ * names the type; under a pin that does not, every input refuses by name before any fetch
13
+ * (`protocol-pending:OPTION_SURFACE`, the one protocol gate every lane reading a type by name shares:
14
+ * wrun-protocol-pending.util).
15
+ * - Per bar, a snapshot under the tier rule (rule 9): each host bar reads the finest tier that fits it and still
16
+ * retains it (a 09:30-anchored stock bar of 5m or more reads 5m buckets within 30 days, a daily bar past them the 1d
17
+ * row), its newest SEALED bucket, and a bar its tier answered nothing for reads the next coarser tier (D12: a CME
18
+ * daily bar whose 5m tier holds no session reads its settlement DAY row); a bar no fitting tier retains (an intraday
19
+ * bar older than 30 days, a bar finer than 5m) is partial (bit 14, the marker tuple when it holds none).
20
+ * - A CHAIN lane (`chain`): the chain is the one chain resolver's (opra-option-lanes.util `decideWrunLaneChain`), per
21
+ * input, and its plane is per instance: OPRA's rules on a US stock or OPRA contract chart (unchanged), CME's on a CME
22
+ * futures chart (a continuous chart reads its lead contract, and a live session rebuilds once the lead rolls:
23
+ * `acquisitionMoved`), none on a crypto chain.
24
+ * - Knobs: `venue` (the options chain's words, decided by the venue decision `options_chain` reads, so `auto` reads
25
+ * the chain `options_chain`'s `auto` reads on the same chart: the chart's own options market, else the coin's
26
+ * Deribit chain, else the first venue that lists it), `book` (`auto` or one series name: ONE series per input,
27
+ * decided when the run plans and named in the acquisition, `auto` the chain's default book over the series its
28
+ * directory lists, opra-option-lanes.util `resolveWrunLaneChainAutoBook`; an answer never picks it) and `max_cells`
29
+ * (a block over it refuses the run); a market pin and the other options classes' knobs refuse by name.
30
+ *
31
+ * LIGHT at module load: pb-common and the chain resolver are imported inside `identity`.
32
+ */
1
33
  import { type WrunLaneChain } from '../opra-option-lanes.util.js';
2
34
  import type { WrunRowLaneDescriptor } from '../wrun-row-lane.types.js';
3
35
  import type { WrunBackendTier } from '../../wrun-tier-grid.util.js';
@@ -23,10 +55,10 @@ export declare function __resetWrunSurfaceChartsForTests(): void;
23
55
  export declare function wrunOptionSurfaceExtras(chain: WrunLaneChain): Record<string, unknown>;
24
56
  /**
25
57
  * Whether an acquisition no longer names the chain the lane would plan now (D12): a CME chain read off a continuous
26
- * alias whose lead contract rolled since the run planned it (`peekRegisteredContinuousLead`, the lead resolver's
27
- * last answer, names another contract than `surfaceUnderlying`). A live session holding it rebuilds (the full run
28
- * plans the lead contract and its own series, and drops every buffered row), so no ask, cache or buffer joins the
29
- * old contract's surfaces to the new one's. A lead not resolved yet moves nothing.
58
+ * alias whose lead contract rolled since the run planned it (`wrunLaneChainLeadMoved`, every chain lane's one rule:
59
+ * the lead resolver's last answer names another contract than `surfaceUnderlying`). A live session holding it
60
+ * rebuilds (the full run plans the lead contract and its own series, and drops every buffered row), so no ask, cache
61
+ * or buffer joins the old contract's surfaces to the new one's. A lead not resolved yet moves nothing.
30
62
  */
31
63
  export declare function wrunOptionSurfaceAcquisitionMoved(acquisition: Readonly<Record<string, unknown>>): boolean;
32
64
  /**
@@ -30,8 +30,7 @@
30
30
  *
31
31
  * LIGHT at module load: pb-common and the chain resolver are imported inside `identity`.
32
32
  */
33
- import { peekRegisteredContinuousLead } from '../../../chart/continuous-contracts.util.js';
34
- import { decideWrunLaneChain, refuseWrunLaneStrayKnob, resolveWrunLaneChainChart, wrunLaneChainPlaneOf, wrunLaneChartKey, } from '../opra-option-lanes.util.js';
33
+ import { decideWrunLaneChain, refuseWrunLaneStrayKnob, resolveWrunLaneChainChart, wrunLaneChainLeadMoved, wrunLaneChainPlaneOf, wrunLaneChartKey, } from '../opra-option-lanes.util.js';
35
34
  import { refuseWrunPollInput } from '../wrun-poll-lane.types.js';
36
35
  import { assertWrunProtocolType } from '../../wrun-protocol-pending.util.js';
37
36
  const MINUTE_MS = 60_000;
@@ -94,18 +93,13 @@ export function wrunOptionSurfaceExtras(chain) {
94
93
  }
95
94
  /**
96
95
  * Whether an acquisition no longer names the chain the lane would plan now (D12): a CME chain read off a continuous
97
- * alias whose lead contract rolled since the run planned it (`peekRegisteredContinuousLead`, the lead resolver's
98
- * last answer, names another contract than `surfaceUnderlying`). A live session holding it rebuilds (the full run
99
- * plans the lead contract and its own series, and drops every buffered row), so no ask, cache or buffer joins the
100
- * old contract's surfaces to the new one's. A lead not resolved yet moves nothing.
96
+ * alias whose lead contract rolled since the run planned it (`wrunLaneChainLeadMoved`, every chain lane's one rule:
97
+ * the lead resolver's last answer names another contract than `surfaceUnderlying`). A live session holding it
98
+ * rebuilds (the full run plans the lead contract and its own series, and drops every buffered row), so no ask, cache
99
+ * or buffer joins the old contract's surfaces to the new one's. A lead not resolved yet moves nothing.
101
100
  */
102
101
  export function wrunOptionSurfaceAcquisitionMoved(acquisition) {
103
- const alias = acquisition.surfaceContinuous;
104
- const exchange = acquisition[WRUN_OPTION_SURFACE_EXCHANGE_FIELD];
105
- if (typeof alias !== 'string' || alias === '' || typeof exchange !== 'string')
106
- return false;
107
- const lead = peekRegisteredContinuousLead(exchange, alias)?.symbol;
108
- return typeof lead === 'string' && lead !== '' && lead !== acquisition.surfaceUnderlying;
102
+ return wrunLaneChainLeadMoved(acquisition[WRUN_OPTION_SURFACE_EXCHANGE_FIELD], acquisition.surfaceContinuous, acquisition.surfaceUnderlying);
109
103
  }
110
104
  /**
111
105
  * Whether an acquisition's bar its tier answered nothing for reads the next coarser tier (D12): a CME chain's, whose
@@ -42,6 +42,7 @@ import type { WrunInputSource } from '../../../interfaces/wrun-runtime.interface
42
42
  import type { WrunDailyLanding } from '../wrun-daily-lane.util.js';
43
43
  import { type WrunRefusalSeed } from '../wrun-refusal.util.js';
44
44
  import type { WrunBackendTier, WrunTierLanding } from '../wrun-tier-grid.util.js';
45
+ import type { WrunRowLaneChain } from './wrun-row-lane.types.js';
45
46
  /** An input's declaration as a lane reads it: the typed fields, and any knob the sheet carries
46
47
  * that the interface does not name yet (`asset`, `publisher`, `series`, ...), as `unknown`. */
47
48
  export type WrunPollLaneSource = WrunInputSource & Readonly<Record<string, unknown>>;
@@ -56,8 +57,8 @@ export interface WrunPollLaneContext {
56
57
  exchange: string;
57
58
  symbol: string;
58
59
  /** The chart market's category as the chart holds it (pb-common `Category`: an option contract chart's `OPTION`),
59
- * handed to a lane that resolves the chart's options chain (the chart's options controls read it); absent when
60
- * unknown. */
60
+ * handed to a lane that resolves the chart's options chain (the chart's options controls read it, and so does a
61
+ * `chain` lane's plan); absent when unknown. */
61
62
  category?: number;
62
63
  /** The chart's bar interval in ms. */
63
64
  intervalMs: number;
@@ -70,12 +71,23 @@ export interface WrunPollLaneContext {
70
71
  * otherwise. */
71
72
  cryptoVenue?: boolean;
72
73
  /** The run is an OpenMarket package's (`isOfficialWrunOverlay`, read at the run's wall door), handed to an
73
- * `opra` lane's plan (and every row lane's). Absent reads false (fail closed). */
74
+ * `opra` lane's plan and a `chain` lane's (and every row lane's): the chain decision's `auto` reads the OPRA chain
75
+ * only for a run the plane is open to. Absent reads false (fail closed). */
74
76
  official?: boolean;
75
77
  /** The `opra-user-scripts` flag opened the OPRA plane to the run (`isOpraUserScriptRun`), handed like
76
78
  * `official`. Absent reads false. With `official`, the one OPRA decision (`mayReadOpra`): an `opra` lane is
77
79
  * refused before its `plan` runs for a run it says no to, so a lane reads these only for its own choices. */
78
80
  opraUserScripts?: boolean;
81
+ /** The chart's options ride the OPRA plane (the run's `isOpraPlaneExchange`, the planner's one verdict), handed to a
82
+ * `chain` lane: its chain there is OPRA's chain of the chart's own underlying. Absent reads false. */
83
+ opraPlane?: boolean;
84
+ /**
85
+ * The run's plan as an identity: one object per `planWrunPollLanes` call, the same for every input it plans. A lane
86
+ * keys a resolution every input of the run shares by it (a `WeakMap`: a `chain` lane's chart, its chain and its
87
+ * book), so two inputs of one run never read two answers and the chart is resolved once. Absent outside a run's
88
+ * plan (a spec calling `plan` alone): nothing is shared.
89
+ */
90
+ runScope?: object;
79
91
  }
80
92
  /**
81
93
  * How a lane's rows land on the chart grid:
@@ -202,6 +214,28 @@ export interface WrunPollLane {
202
214
  * the legend names a delayed tier.
203
215
  */
204
216
  opra?: true;
217
+ /**
218
+ * A CHAIN lane (OPTIONS-PORT P5, the row lanes' mark, `WrunRowLaneChain`): it reads the chart's options chain on
219
+ * whichever plane that chain lists on, decided per INSTANCE by the one chain resolver (opra-option-lanes.util
220
+ * `resolveWrunLaneChainChart` then `decideWrunLaneChain`, in its `plan`), never per descriptor. Its `plan` answers
221
+ * the chain's exchange in the payload field `exchangeField`, and the instance's plane follows that exchange
222
+ * (`wrunLaneChainPlaneOf`):
223
+ * - `opra`: the OPRA wall (before the chain is resolved on a chart whose options ride the plane), the plane and its
224
+ * routed tier in the ask, the overlay's OPRA provenance and the legend's delayed-tier note, as an `opra` lane's;
225
+ * - `cme`: the CME display wall (OpenMarket's own packages only) and the routed tier in the ask (`servedTier`);
226
+ * - `plain` (a crypto options venue): nothing beside the lane's own fields.
227
+ * It is admitted on every chart (a chart with no chain refuses by name in its `plan`) and rides the native-rows path
228
+ * on every plane (`nativeRows`: its rows are its chain's, never the chart market's). The registry refuses it beside
229
+ * `opra`, `global`, an own `fetch` or a `live` channel.
230
+ */
231
+ chain?: WrunRowLaneChain;
232
+ /**
233
+ * Whether an instance's acquisition (the full run's record of its payload) no longer names the read the lane would
234
+ * plan now (a CME chain read off a continuous alias whose lead contract rolled). A live session holding such an
235
+ * instance rebuilds (the row lanes' rule, `WrunRowLaneDescriptor.acquisitionMoved`), so no ask, cache or buffer joins
236
+ * two reads. Synchronous, read on every drain. Absent: an acquisition never moves.
237
+ */
238
+ acquisitionMoved?: (acquisition: Readonly<Record<string, unknown>>) => boolean;
205
239
  /**
206
240
  * The record each refusal BY NAME its K control's worker twin may answer (wrun-lane-refusal.leaf: a backend switch
207
241
  * that keeps the read off, a series the data plane samples for a configured list only), by its code. The run