@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
@@ -1,36 +1,34 @@
1
1
  /**
2
- * The two catalog venue groups behind the Spot and Perps presets of the multi-venue indicators, each venue with
3
- * the quote its catalog pair is synthesized from: the coin, then the quote (`BTC` + `-USD` is Coinbase's `BTC-USD`,
4
- * `BTC` + `-USDT-SWAP` OKX's perpetual `BTC-USDT-SWAP`); an empty quote is a pair spelled as the bare coin
5
- * (Hyperliquid's `BTC`). ONE source of truth for every reader: the predefined catalog (`store/common.ts`
6
- * fetchPredefinedSymbolsByCoinAndType) builds its pairs from these maps, the venue-choice resolver (`venue-legs.util`
7
- * presetVenues) names their venues, in this order, and the wrun pin speller (`wrun-pin-spelling.util`) reads how
8
- * each venue spells a pair.
2
+ * Data about crypto venues that the multi-venue indicators and the wrun pin speller read. No list here says which
3
+ * venues join the Spot or Perps preset: both derive from the catalog for the chart's coin (web
4
+ * src/utility/indicators/venues-for-coin.util.ts eligibleVenues), and tests/constants/venue-presets.constants.spec.ts
5
+ * fails on a per-preset venue list in this file.
9
6
  */
10
7
  /**
11
- * The deep perp venues, in the aggregated tools' order: every aggregated indicator reads them by default (the web
12
- * app's AGGREGATED_DEFAULT_EXCHANGES is this list) and the Perps preset lists exactly them (its type below fails the
13
- * build on a venue missing or extra). Deep only: OKEX_FUTURES (dated futures, a basis away from the perp price) and
14
- * DERIBIT (coin-scoped profiles can carry option instruments) left 2026-08-07, BITFINEX_DERIVATIVES 2026-08-09 (its
15
- * perp prints sat $60-80 off the deep venues with dust volume).
8
+ * How a venue spells a pair in its catalog where the spelling is fixed: the coin, then this quote (`BTC` + `-USD` is
9
+ * Coinbase's `BTC-USD`, `BTC` + `-USDT-SWAP` OKX's perpetual `BTC-USDT-SWAP`); an empty quote is a pair spelled as the
10
+ * bare coin (Hyperliquid's `BTC`). One entry per venue, whatever group it pools in. The wrun pin speller
11
+ * (`wrun-pin-spelling.util`) reads it to vouch for a pin's form; a venue outside it has its pins confirmed by the
12
+ * catalog.
16
13
  */
17
- export const DEEP_PERP_VENUES = ['BYBIT', 'BINANCE_FUTURES', 'OKEX_SWAP', 'HYPERLIQUID_FUTURES'];
18
- export const SPOT_PRESET_VENUE_QUOTES = Object.freeze({
14
+ export const VENUE_PAIR_QUOTES = Object.freeze({
19
15
  BINANCE: 'USDT',
20
- COINBASE: '-USD',
21
- BYBIT_SPOT: 'USDT',
22
- OKEX: '-USDT',
23
- BITSTAMP: 'USD',
24
- });
25
- /** The Perps preset: every deep perp venue, in catalog order (Binance first, the order the preset always had). */
26
- export const PERP_PRESET_VENUE_QUOTES = Object.freeze({
27
16
  BINANCE_FUTURES: 'USDT',
28
17
  BYBIT: 'USDT',
18
+ BYBIT_SPOT: 'USDT',
19
+ OKEX: '-USDT',
29
20
  OKEX_SWAP: '-USDT-SWAP',
21
+ COINBASE: '-USD',
22
+ BITSTAMP: 'USD',
30
23
  HYPERLIQUID_FUTURES: '',
31
24
  });
32
- /** The catalog venue groups by preset. */
33
- export const PRESET_VENUE_QUOTES = Object.freeze({
34
- SPOT: SPOT_PRESET_VENUE_QUOTES,
35
- PERP: PERP_PRESET_VENUE_QUOTES,
36
- });
25
+ /**
26
+ * The stock venues of the aggregated panes that sum venues by name (Agg. Open Interest, Volume, Liquidations, Funding
27
+ * Rate, TPO, Session VP, Visible Range VP, Volume Footprint, Order Book Heatmap; the web app's
28
+ * AGGREGATED_DEFAULT_EXCHANGES): the deep perp venues. Not a preset (the presets derive from the catalog). Deep only:
29
+ * OKEX_FUTURES (dated futures, a basis away from the perp price) and DERIBIT (coin-scoped profiles can carry option
30
+ * instruments) left 2026-08-07, BITFINEX_DERIVATIVES 2026-08-09 (its perp prints sat $60-80 off the deep venues with
31
+ * dust volume). Its signature is also the legacy `stock` reading of a names row saved before 2026-10-06
32
+ * (venue-names-adapter.util), so changing it re-reads those rows as picks.
33
+ */
34
+ export const AGGREGATED_DEFAULT_EXCHANGES = ['BYBIT', 'BINANCE_FUTURES', 'OKEX_SWAP', 'HYPERLIQUID_FUTURES'];
@@ -21,8 +21,11 @@ import type { WrunRefusalContext, WrunRefusalOut } from './utility/wrun/wrun-ref
21
21
  * CHANGED 0.5.0: + 'prepareModuleBytes' (utility/wrun/wrun-host.service.ts:406-408), 'wrunLaneGatedOff'
22
22
  * (wrun-chart-market-facts.util.ts:578), 'wrunLegCandleOpenMs' (wrun-live-tick.util.ts:3633), 'WRUN_STATS_STRIP_WORDS'
23
23
  * (wrun-stats-strip.util.ts, moved whole by U5a). Kit 0.86.3's host entry exports all four; web's seam
24
- * src/utility/wrun/wrun-shared-host.ts re-exports all four. 58 names. */
25
- export type WrunSharedHostModule = Pick<typeof WrunKitHost, 'decodeWrunHostedWire' | 'WRUN_HOST_CELL_TUPLE_WIDTHS' | 'WRUN_MAX_SHAPE_OFFSET_BARS' | 'WRUN_MINICHARTS_LABEL_MAX_CHARS' | 'WRUN_MINICHARTS_MAX_BARS' | 'WRUN_MINICHARTS_MAX_PANELS' | 'WRUN_MINICHARTS_TITLE_MAX_CHARS' | 'WRUN_STRATEGY_SHEET_FIELDS' | 'wrunMiniChartGridPayload' | 'wrunShapeEdgeTs' | 'wrunStrategyWireBytes' | 'WRUN_CANDLES_FORMING_OPEN_VIEW' | 'WRUN_CANDLES_FORMING_VIEW' | 'WRUN_CANDLE_CLASSES' | 'WRUN_FEED_HOST_CAP' | 'WRUN_HOST_ABI_TABLES' | 'WRUN_HOST_PROFILES' | 'WRUN_MARKET_KIND_STOCK' | 'WRUN_MARKET_ZONE_NEW_YORK' | 'WRUN_MAX_LEG_BARS' | 'WRUN_MAX_LEG_OFFSET' | 'WRUN_OPTIONS_VENUES_HOST_CAP' | 'WRUN_PIN_SYMBOL_LITERAL_CODE' | 'WRUN_SECTION_KINDS' | 'WrunStrategyHost' | 'WrunStrategyRefusalError' | 'adaptWrunCells' | 'advanceWrunCarry' | 'alignWrunRows' | 'alignWrunTailRows' | 'cloneWrunInputCarry' | 'cmeSessionBarEndMs' | 'cmeSessionBarOpenMs' | 'cmeSessionBucketMs' | 'emptyWrunInputCarry' | 'isCmeSessionLatticeExchange' | 'isCmeSessionLatticeIntervalMs' | 'planWrunRun' | 'regularWindowClose' | 'resolveWrunStrategySheet' | 'wrunCalendarOfVenue' | 'wrunCelledLegCheck' | 'wrunLegCandleCloseMs' | 'wrunLegFetchStart' | 'wrunLegRowBoundsMs' | 'wrunMarketLegCandleClose' | 'wrunParamValueRefusal' | 'wrunPinSymbolLiteral' | 'wrunPinVenueRefused' | 'wrunPinVenueRefusedMessage' | 'wrunRefusalMessage' | 'wrunServedLegStart' | 'wrunSessionClock' | 'wrunUsEquitiesSession' | 'prepareModuleBytes' | 'wrunLaneGatedOff' | 'wrunLegCandleOpenMs' | 'WRUN_STATS_STRIP_WORDS'>;
24
+ * src/utility/wrun/wrun-shared-host.ts re-exports all four. 58 names.
25
+ * CHANGED (OPTLOAD W3 R2): + 'wrunDownloadReadCost' and 'wrunDownloadPlanReads', the kit's download rule the run prices
26
+ * its reads by before any fetch (utility/wrun/wrun-download-plan.util.ts); kit 0.97.0's host entry exports both. 60
27
+ * names. */
28
+ export type WrunSharedHostModule = Pick<typeof WrunKitHost, 'decodeWrunHostedWire' | 'WRUN_HOST_CELL_TUPLE_WIDTHS' | 'WRUN_MAX_SHAPE_OFFSET_BARS' | 'WRUN_MINICHARTS_LABEL_MAX_CHARS' | 'WRUN_MINICHARTS_MAX_BARS' | 'WRUN_MINICHARTS_MAX_PANELS' | 'WRUN_MINICHARTS_TITLE_MAX_CHARS' | 'WRUN_STRATEGY_SHEET_FIELDS' | 'wrunMiniChartGridPayload' | 'wrunShapeEdgeTs' | 'wrunStrategyWireBytes' | 'WRUN_CANDLES_FORMING_OPEN_VIEW' | 'WRUN_CANDLES_FORMING_VIEW' | 'WRUN_CANDLE_CLASSES' | 'WRUN_FEED_HOST_CAP' | 'WRUN_HOST_ABI_TABLES' | 'WRUN_HOST_PROFILES' | 'WRUN_MARKET_KIND_STOCK' | 'WRUN_MARKET_ZONE_NEW_YORK' | 'WRUN_MAX_LEG_BARS' | 'WRUN_MAX_LEG_OFFSET' | 'WRUN_OPTIONS_VENUES_HOST_CAP' | 'WRUN_PIN_SYMBOL_LITERAL_CODE' | 'WRUN_SECTION_KINDS' | 'WrunStrategyHost' | 'WrunStrategyRefusalError' | 'adaptWrunCells' | 'advanceWrunCarry' | 'alignWrunRows' | 'alignWrunTailRows' | 'cloneWrunInputCarry' | 'cmeSessionBarEndMs' | 'cmeSessionBarOpenMs' | 'cmeSessionBucketMs' | 'emptyWrunInputCarry' | 'isCmeSessionLatticeExchange' | 'isCmeSessionLatticeIntervalMs' | 'planWrunRun' | 'regularWindowClose' | 'resolveWrunStrategySheet' | 'wrunCalendarOfVenue' | 'wrunCelledLegCheck' | 'wrunLegCandleCloseMs' | 'wrunLegFetchStart' | 'wrunLegRowBoundsMs' | 'wrunMarketLegCandleClose' | 'wrunParamValueRefusal' | 'wrunPinSymbolLiteral' | 'wrunPinVenueRefused' | 'wrunPinVenueRefusedMessage' | 'wrunRefusalMessage' | 'wrunServedLegStart' | 'wrunSessionClock' | 'wrunUsEquitiesSession' | 'prepareModuleBytes' | 'wrunLaneGatedOff' | 'wrunLegCandleOpenMs' | 'WRUN_STATS_STRIP_WORDS' | 'wrunDownloadReadCost' | 'wrunDownloadPlanReads'>;
26
29
  /** The kit main entry's tables package code reads (web: src/utility/wrun/wrun-kit.ts `wrunIndicatorKit`); either may be
27
30
  * absent on an older kit, so both stay unknown and are checked where read. */
28
31
  export interface WrunKitMainModule {
@@ -179,6 +182,8 @@ export interface WrunChartHostEnv {
179
182
  * once per pass, and only for a run that carries a table on a normal cell (wrunHostLeavesTablesToWindow). web:
180
183
  * answered from the layout's window cells. */
181
184
  tablesShownInWindow?: (chartIndex: number, overlayId: string) => boolean;
185
+ /** Optional. The per-order switch (`wrunTapePerOrder` is its one reader); absent reads off, as the sandbox and phone app ship. */
186
+ tapePerOrder?: boolean;
182
187
  }
183
188
  /** The mounted chart and the host's chart store, as package code reads and writes them. */
184
189
  export interface WrunHostChart {
@@ -357,7 +362,9 @@ export interface WrunHostChart {
357
362
  * { reconcileScriptPaneSideAfterRunResultApply } (executor :6355). */
358
363
  loadOffchartGridHeights(): Promise<WrunOffchartGridHeightsModule>;
359
364
  /** 0.5.0, boot loader. web: import('@/utility/indicators/options-overlay-provenance.util') viewed as
360
- * { admittedOpraSources, setOptionsOverlayOpraProvenance } (executor :8753; the cloud OPRA stamp, moved whole). */
365
+ * { admittedOpraSources, setOptionsOverlayOpraProvenance } (executor :8753; the cloud OPRA stamp, moved whole), and
366
+ * `noteGatePlaneOptionsRead` (optional: the add door's options stamp, OPTLOAD W3,
367
+ * run-schedule/wrun-gate-reader-warm.util). */
361
368
  loadOptionsOverlayProvenance(): Promise<WrunOptionsOverlayProvenanceModule>;
362
369
  /** 0.5.0, boot loader. web: import('@/indicators/indicator-registry') viewed as { indicatorRegistry } (executor :7699). */
363
370
  loadIndicatorRegistry(): Promise<WrunIndicatorRegistryModule>;
@@ -413,7 +420,10 @@ export interface WrunHostMarket {
413
420
  loadOptionsChartSource(): Promise<WrunOptionsChartSourceModule>;
414
421
  /** 0.3.0, boot loader. web: import('@/utility/options/opra-options-gate.util') viewed as { governedOptionPlane,
415
422
  * opraOptionPlaneStop } (sync, called after the loads: sources/opra-option-lanes.util.ts `resolveWrunChartChain`;
416
- * the stop's type is `OpraOptionPlaneStop`). */
423
+ * the stop's type is `OpraOptionPlaneStop`). Next release: the view's optional stock twin members (the gate's
424
+ * `chartOptionsMarket`, and `awaitStockTwin` from utility/options/stock-twin-probe.util) answer beside it, read by
425
+ * run-schedule/wrun-chart-gate-reader.util `decideWrunChartOptionsMarket` (a run's one options market); a host that
426
+ * binds neither reads every chart's options off its own market. */
417
427
  loadOptionsGate(): Promise<WrunOptionsGateModule>;
418
428
  /** 0.3.0, boot loader. web: import('@/utility/wrun/wrun-options-chain-venues.util') viewed as
419
429
  * { resolveWrunOptionsChainCryptoVenues } (sources/opra-option-lanes.util.ts `resolveWrunLaneCryptoVenues`). */
@@ -423,7 +433,9 @@ export interface WrunHostMarket {
423
433
  loadDeribitOptions(): Promise<WrunDeribitOptionsModule>;
424
434
  /** 0.3.0, boot loader. web: import('@/services/option-chain.service') viewed as { optionChainServiceForExchange,
425
435
  * default: { resolveChainContract } } (sources/opra-option-lanes.util.ts `readWrunLaneChainSeries`, the `auto` book's
426
- * directory read, and `resolveWrunLaneChainChart`, a continuous CME chart's lead contract). */
436
+ * directory read, and `resolveWrunLaneChainChart`, a continuous CME chart's lead contract). The market port the add
437
+ * door starts the CME optionable directory through (`default.prewarmOptionableDirectory`, optional: OPTLOAD W3,
438
+ * run-schedule/wrun-gate-reader-warm.util). */
427
439
  loadOptionChainService(): Promise<WrunOptionChainServiceModule>;
428
440
  /** 0.5.0, boot loader. web: import('@/services/continuous-contracts.service') viewed as { default: { getResolvedLead } }
429
441
  * (executor :8817). */
@@ -557,6 +569,10 @@ export declare function wrunHostShowsWindows(): boolean;
557
569
  * `chartIndex` (a mount that names no chart): the cell mounts the table, never a table that mounts nowhere. Read
558
570
  * when a mount runs, never at module load. */
559
571
  export declare function wrunHostLeavesTablesToWindow(chartIndex: number | undefined, overlayId: string): boolean;
572
+ /** Whether the realm's host turned the per-order floor's switch on (`WrunChartHostEnv.tapePerOrder`): false for a host
573
+ * that never set the member, and before the realm's entry set the env. Read when a request, a print or a run head
574
+ * asks, never at module load; `wrunTapePerOrder` (utility/wrun/wrun-tape-per-order.util) is its one reader. */
575
+ export declare function wrunHostTapePerOrder(): boolean;
560
576
  /** The error a host's `sharedHost()` throws before its load. */
561
577
  export declare function wrunChartHostUnloadedError(): Error;
562
578
  /** The shared host now, or its load: `undefined` once the env's `sharedHost()` answers, else the env's
package/dist/host-env.js CHANGED
@@ -35,6 +35,12 @@ export function wrunHostLeavesTablesToWindow(chartIndex, overlayId) {
35
35
  return false;
36
36
  }
37
37
  }
38
+ /** Whether the realm's host turned the per-order floor's switch on (`WrunChartHostEnv.tapePerOrder`): false for a host
39
+ * that never set the member, and before the realm's entry set the env. Read when a request, a print or a run head
40
+ * asks, never at module load; `wrunTapePerOrder` (utility/wrun/wrun-tape-per-order.util) is its one reader. */
41
+ export function wrunHostTapePerOrder() {
42
+ return hasWrunChartHostEnv() && wrunChartHostEnv().tapePerOrder === true;
43
+ }
38
44
  /** The error a host's `sharedHost()` throws before its load. */
39
45
  export function wrunChartHostUnloadedError() {
40
46
  return new Error('wrun_chart_host_unloaded');
@@ -29,7 +29,7 @@ import type { WrunRefusal, WrunRefusalClass, WrunRefusalOverlayTarget } from './
29
29
  import type { WrunRowSourceIdentity } from './utility/wrun/wrun-row-source.js';
30
30
  import type { WrunSocketTransport } from './utility/wrun/wrun-socket-row-source.js';
31
31
  import type { WrunColorTheme } from './utility/wrun/wrun-style-words.util.js';
32
- import type { GateProvider as WrunGateProvider } from './workers/constants/socket-slots.js';
32
+ import type { GateProvider as WrunGateProvider, OptionsGateProvider as WrunOptionsGateProvider } from './workers/constants/socket-slots.js';
33
33
  export type { WrunRowSourceIdentity, WrunRowSourcePatch, WrunRowSourceRecord, WrunRowWindow, } from './utility/wrun/wrun-row-source.js';
34
34
  export type { WrunSocketAsk, WrunSocketAskKind, WrunSocketChartRows, WrunSocketLoadSignals, WrunSocketTransport, } from './utility/wrun/wrun-socket-row-source.js';
35
35
  /** The overlay a hosted port acts for. */
@@ -150,7 +150,15 @@ export interface WrunChartStoreView {
150
150
  notify?: boolean;
151
151
  hasVisibleDrawings?: boolean;
152
152
  }): void;
153
- setIndicatorPrintOutputs(chartIndex: number, indicatorId: string, printOutputsInput: unknown): void;
153
+ /** CHANGED: the lines with the provenance of the run that printed them (web: console-run-output.leaf
154
+ * `IndicatorOutputProvenance`): `opra` when the run read OPRA, its own fact from before it computed. Required.
155
+ * CHANGED (next release): `cme` when the run is a CME user study (the `cme-user-scripts` gate opened the CME plane
156
+ * to it), its own fact from before it computed; optional, so every writer that names OPRA alone compiles as before
157
+ * and reads unmarked for CME. */
158
+ setIndicatorPrintOutputs(chartIndex: number, indicatorId: string, printOutputsInput: unknown, provenance: {
159
+ opra: boolean;
160
+ cme?: boolean;
161
+ }): void;
154
162
  setIndicatorRunOutputSummary(chartIndex: number, indicatorId: string, runResult: WrunKScriptRunResultLike | null): void;
155
163
  setKScriptLoadingIndicator(chartIndex: number, indicatorId: string, loading: boolean): void;
156
164
  indicatorSettingsSync(chartIndex: number, indicatorId: string): {
@@ -195,6 +203,10 @@ export interface WrunOffchartGridHeightsModule {
195
203
  export interface WrunOptionsOverlayProvenanceModule {
196
204
  admittedOpraSources(chartIndex: number, overlayId: string): number;
197
205
  setOptionsOverlayOpraProvenance(chartIndex: number, overlayId: string, opra: boolean): void;
206
+ /** CHANGED (next release, optional): this account reads options on a gate plane in this browser, the stamp the
207
+ * next chart load reads to prepare the plane's access before an add asks (web: `noteGatePlaneOptionsRead`). Read by
208
+ * the add's own door (run-schedule/wrun-gate-reader-warm.util); a host that binds none keeps no stamp. */
209
+ noteGatePlaneOptionsRead?(): void;
198
210
  }
199
211
  /** Loader view of the indicator registry: a control by its type, for its live subscription (web:
200
212
  * indicators/indicator-registry.ts, a Map of `IIndicatorControl`). */
@@ -250,12 +262,16 @@ export interface WrunMainCandleRequestIdentity {
250
262
  category?: number;
251
263
  }
252
264
  /** The identity a chart's mounted main rows were loaded for, the fields the package reads (web: ohlcv-cache.types.ts
253
- * `MainDataRequestIdentity`; one way, web's carries the pool, session and adjustment fields too). */
265
+ * `MainDataRequestIdentity`; one way, web's carries the pool and adjustment fields too). */
254
266
  export interface WrunLoadedMainIdentity {
255
267
  readonly exchange: string | null;
256
268
  readonly symbol: string | null;
257
269
  readonly interval: string | null;
258
270
  readonly transformations: string | null;
271
+ /** The chart's persisted session word the rows were loaded under: the identity compare reads the session the chart
272
+ * rides from it (`wrunChartMarketIdentity`'s fifth term, effectiveChartSessionType), so a host that leaves it out
273
+ * compares as the market's default session. */
274
+ readonly sessionType?: unknown;
259
275
  }
260
276
  /** A lazy-load check's target range (web: utility/chart/viewport-pan-tracking.util.ts `LazyLoadTargetRange`). */
261
277
  export interface WrunLazyLoadTargetRange {
@@ -349,8 +365,12 @@ export interface WrunMainCandleFetchOptions {
349
365
  /** What suspects an options add is coming and warms the chart's gate reader for it, with no add asked yet (OPTLOAD g1
350
366
  * round 2): a surface's open (`indicators-dialog`, `options-panel`: run-schedule/wrun-chart-gate-reader.util
351
367
  * `warmWrunChartGateReaderOnIntent`), or a row's settled intent (`add-intent`: a hover's dwell, a detail panel; the
352
- * loader's intent warm through wrun-gate-reader-warm.util `warmWrunSheetGateReaders`). */
353
- export type WrunGateReaderIntentSurface = 'indicators-dialog' | 'options-panel' | 'add-intent';
368
+ * loader's intent warm through wrun-gate-reader-warm.util `warmWrunSheetGateReaders`, and a native options row's, web:
369
+ * utility/options/gate-reader-intent-warm.util). OPTLOAD W3: the chart's load and each switch of its market, for an
370
+ * account that reads options (`chart-load`, web: utility/options/chart-options-access.util). CHANGED (next release):
371
+ * an add's click before its admission (`add-click`, web: the chart store's add wrapper; the add may still be refused,
372
+ * so the warm asks the lease). */
373
+ export type WrunGateReaderIntentSurface = 'indicators-dialog' | 'options-panel' | 'add-intent' | 'chart-load' | 'add-click';
354
374
  /** What an intent warm did: `dialed` (this tab dials the reader and holds its lease), `already` (this tab's reader was
355
375
  * dialing or open), `held-elsewhere` (another tab holds that reader for this identity and tier), `busy` (another tab is
356
376
  * deciding its warm now), `unknown` (the browser cannot say who holds it: never dialed), `no-plane` (the chart's options
@@ -358,6 +378,12 @@ export type WrunGateReaderIntentSurface = 'indicators-dialog' | 'options-panel'
358
378
  * `not-entitled` (the gate refused this identity there, or the dial's own guards stopped it), `failed` (a load or a
359
379
  * port failed). */
360
380
  export type WrunGateReaderIntentWarm = 'dialed' | 'already' | 'held-elsewhere' | 'busy' | 'unknown' | 'no-plane' | 'not-served' | 'not-entitled' | 'failed';
381
+ /** Which reads of the plane an intent warm readies the reader for, so it dials the slot those reads ride: `candles`
382
+ * (market data, StreamPoints: the reader tier the account's served access picks, real-time once the gate confirmed
383
+ * it) or `metadata` (the one-shot reference reads, a chain's expiry list among them: always the delayed reader,
384
+ * utility/v2/governed-tier.leaf `resolveGovernedSlot`). A native options add's first read is `metadata` (its chain's
385
+ * expiries), its data reads `candles`, so the two can need two readers. Absent: `candles`. */
386
+ export type WrunGateReaderReadKind = 'candles' | 'metadata';
361
387
  /** Loader view of the V2 transport the main candles ride (web: services/v2.service.ts default `fetchData`, generic on
362
388
  * web; the payload is the transport's own type, `never` here), the gate reader warm a door asks of it
363
389
  * (`warmGateReaderFor`: dial the reader a read naming the exchange rides, under the on-demand guards; a hint,
@@ -367,7 +393,9 @@ export interface WrunV2ServiceModule {
367
393
  readonly default: {
368
394
  fetchData(indicator: string, payload: never, chartIndex: number, options: WrunMainCandleFetchOptions): Promise<void>;
369
395
  warmGateReaderFor(exchange: string): void;
370
- warmGateReaderOnIntent(exchange: string, surface: WrunGateReaderIntentSurface): Promise<WrunGateReaderIntentWarm>;
396
+ /** CHANGED (next release, optional `kind`): the reads the warm readies the reader for (WrunGateReaderReadKind); a
397
+ * host that takes two arguments warms the `candles` reader, as before. */
398
+ warmGateReaderOnIntent(exchange: string, surface: WrunGateReaderIntentSurface, kind?: WrunGateReaderReadKind): Promise<WrunGateReaderIntentWarm>;
371
399
  /** CHANGED (next release, optional): one series read answered whole (web: v2.service `sendSeriesOneShot`, the
372
400
  * worker's `readSeries` over the app's series descriptor, a typed `never` here as `fetchData`'s payload is: the
373
401
  * descriptor is the app's). Read by the C-DOLLAR stored unit (wrun-chart-market-facts.util
@@ -397,7 +425,14 @@ export interface WrunMarketsRawPage {
397
425
  pageCount?: number;
398
426
  incomplete?: boolean;
399
427
  failedSources?: readonly unknown[];
428
+ pendingSources?: readonly unknown[];
400
429
  vetoed?: true;
430
+ /** A batched read's lost pairs (web: `MarketsRawPage.unansweredPairs`): their absence proves nothing. */
431
+ unansweredPairs?: ReadonlyArray<{
432
+ exchange: unknown;
433
+ rawSymbol?: string;
434
+ normalizedSymbol?: string;
435
+ }>;
401
436
  }
402
437
  /** CHANGED 0.5.0: loader view of the metadata service: the one market query lanes ask, and the raw catalog page and the
403
438
  * block sizes a run reads. */
@@ -426,7 +461,7 @@ export interface WrunMetadataServiceModule {
426
461
  }
427
462
  /** The gate planes an option chain lists on (workers/constants/socket-slots.ts `GateProvider`) and a crypto option
428
463
  * chain's source (utility/options/option-venue.util.ts `OptionSource`): both modules moved in phase 1a. */
429
- export type { WrunGateProvider, WrunOptionSource };
464
+ export type { WrunGateProvider, WrunOptionsGateProvider, WrunOptionSource };
430
465
  /** The chart facts the options chart source reads (web: indicators/controls/optionsChartSource.ts `OptionsChartMetadata`;
431
466
  * its `category` is the protocol package's enum, unknown here). */
432
467
  export type WrunOptionsChartMetadata = {
@@ -437,7 +472,7 @@ export type WrunOptionsChartMetadata = {
437
472
  } | null | undefined;
438
473
  /** Where an options control reads its chain (web: optionsChartSource.ts `OptionsChartSource`). */
439
474
  export type WrunOptionsChartSource = {
440
- venue: WrunGateProvider;
475
+ venue: WrunOptionsGateProvider;
441
476
  exchange: string;
442
477
  underlying: string;
443
478
  } | {
@@ -449,24 +484,60 @@ export type WrunOptionsChartSource = {
449
484
  };
450
485
  /** Loader view of the options chart source. */
451
486
  export interface WrunOptionsChartSourceModule {
452
- resolveOptionsChartSource(metadata: WrunOptionsChartMetadata): Promise<WrunOptionsChartSource>;
487
+ /** `plane`: a run's frozen decision (the plane its head decided), so no lane of the run decides again. */
488
+ resolveOptionsChartSource(metadata: WrunOptionsChartMetadata, plane?: WrunOptionsGateProvider | null): Promise<WrunOptionsChartSource>;
453
489
  }
454
490
  /** Why a chart whose options list on OPRA reads none: the reason the gate folds into `governedOptionPlane`'s null
455
491
  * (web: utility/options/opra-options-gate.util.ts `OpraOptionPlaneStop`). */
456
492
  export type OpraOptionPlaneStop = 'flag-off' | 'chart-kind';
457
- /** CHANGED 0.5.0: loader view of the OPRA options gate (sync after the load), and its flag reads and hydration waits. */
493
+ /** CHANGED (next release): the chart market the OPRA plane decisions read (web: utility/options/opra-options-gate.util.ts
494
+ * `ChartOptionsMarketRef`). The `symbol` key is required, its value may be missing: a stock twin is one market of a
495
+ * venue (BINANCE_FUTURES NVDAUSDT, never BINANCE_FUTURES), so a decision always sees which market it judges. */
496
+ export interface WrunChartOptionsMarketRef {
497
+ exchange?: string | null;
498
+ symbol: string | null | undefined;
499
+ coin?: string | null;
500
+ /** The protocol's Category value or its name, unknown here: an option contract is never a stock twin. */
501
+ category?: unknown;
502
+ }
503
+ /** The market whose options a chart reads (web: `ChartOptionsMarket`): the chart's own, or, for a stock twin while the
504
+ * opra flag is lit, its US stock's market (POLYGON `NVDA/USD`) with `twinOf` naming the chart market. */
505
+ export interface WrunChartOptionsMarket extends WrunChartOptionsMarketRef {
506
+ twinOf?: {
507
+ exchange: string;
508
+ symbol: string;
509
+ };
510
+ }
511
+ /** CHANGED 0.5.0: loader view of the OPRA options gate (sync after the load), and its flag reads and hydration waits.
512
+ * CHANGED (next release): the plane decisions take `WrunChartOptionsMarketRef` (the `symbol` key required), and two
513
+ * optional ports read the stock twin seam; a host that binds neither reads every chart's options off its own market. */
458
514
  export interface WrunOptionsGateModule {
459
- governedOptionPlane(metadata: {
460
- exchange?: string | null;
461
- } | null | undefined): WrunGateProvider | null;
462
- opraOptionPlaneStop(metadata: {
463
- exchange?: string | null;
464
- } | null | undefined): OpraOptionPlaneStop | undefined;
465
- opraFlagDecidesChartOptions(metadata: {
466
- exchange?: string | null;
467
- } | null | undefined): boolean;
515
+ governedOptionPlane(metadata: WrunChartOptionsMarketRef | null | undefined): WrunOptionsGateProvider | null;
516
+ opraOptionPlaneStop(metadata: WrunChartOptionsMarketRef | null | undefined): OpraOptionPlaneStop | undefined;
517
+ opraFlagDecidesChartOptions(metadata: WrunChartOptionsMarketRef | null | undefined): boolean;
468
518
  awaitOpraFlagHydration(timeoutMs?: number): Promise<void>;
469
519
  awaitOpraUserScriptsFlagHydration(timeoutMs?: number): Promise<void>;
520
+ /** NEW (optional): arm the late re-judgment of the user-script overlays an OPRA wall judged closed, called by a run
521
+ * head whose bounded `opra-user-scripts` wait ran out with the flag dark (web: opra-options-gate.util
522
+ * `armOpraUserScriptsRejudge`: the first time the flag turns on, every chart's walled user-script overlays are
523
+ * judged again). A host that binds none leaves such a run walled until its next run. */
524
+ armOpraUserScriptsRejudge?(): void;
525
+ /** NEW (next release, optional): the bounded wait for the flag map a run the `cme-user-scripts` gate may open the
526
+ * CME plane to waits on before a CME wall reads it, the twin of `awaitOpraUserScriptsFlagHydration` (web:
527
+ * `awaitCmeUserScriptsFlagHydration`). A host that binds none judges by the map as it stands, closed until it
528
+ * lands. */
529
+ awaitCmeUserScriptsFlagHydration?(timeoutMs?: number): Promise<void>;
530
+ /** NEW (next release, optional): arm the late re-judgment of the CME user-study overlays a CME wall judged closed,
531
+ * called by a run head whose bounded `cme-user-scripts` wait ran out with the flag dark, the twin of
532
+ * `armOpraUserScriptsRejudge` (web: `armCmeUserScriptsRejudge`: the first time the gate opens, every chart's walled
533
+ * CME user studies are judged again). A host that binds none leaves such a run walled until its next run. */
534
+ armCmeUserScriptsRejudge?(): void;
535
+ /** NEW (next release, optional): the market whose options a chart reads (web: `chartOptionsMarket`, the input itself
536
+ * for every market but a known stock twin under a lit opra flag). */
537
+ chartOptionsMarket?(market: WrunChartOptionsMarketRef): WrunChartOptionsMarket;
538
+ /** NEW (next release, optional): a market's stock twin answer, awaited and bounded (web: stock-twin-probe.util
539
+ * `awaitStockTwin`): its US stock's ticker, or null for no twin or no answer in time. */
540
+ awaitStockTwin?(market: WrunChartOptionsMarketRef, timeoutMs?: number): Promise<string | null>;
470
541
  }
471
542
  /** The crypto venue words of the `options_chain` venue knob and the words as the chart reads them
472
543
  * (utility/wrun/wrun-options-chain.util.ts, moved in phase 1a). */
@@ -519,6 +590,11 @@ export interface WrunOptionChainServiceModule {
519
590
  readonly default: {
520
591
  resolveChainContract(exchangeName: string, underlying: string): Promise<string | null>;
521
592
  forVenue(venueId: OptionVenue['id']): WrunOptionChainDirectory;
593
+ /** CHANGED (next release, optional): start the CME optionable directory read a chain lane's identity awaits, ahead
594
+ * of the plan (web: option-chain.service `prewarmOptionableDirectory`: a fresh snapshot reads nothing, a failure
595
+ * leaves the read to the plan). Read by the add door on a CME chart (run-schedule/wrun-gate-reader-warm.util); a
596
+ * host that binds none leaves the directory to the plan. */
597
+ prewarmOptionableDirectory?(): void;
522
598
  };
523
599
  }
524
600
  /** Loader view of the continuous contracts service: a continuous symbol's lead contract (web:
@@ -1012,6 +1088,10 @@ export interface WrunStandInChart {
1012
1088
  transformations?: unknown;
1013
1089
  /** The signed-in account the chart is viewed by (none reads as the guest). */
1014
1090
  account?: string | null;
1091
+ /** The chart's persisted session and back-adjustment: with the venue they name the candle set the picture is drawn
1092
+ * on (web: `kscriptStandInCandlesOf`, the candle cache's own key fork on CME and Polygon equities). */
1093
+ sessionType?: unknown;
1094
+ adjusted?: unknown;
1015
1095
  }
1016
1096
  /** The engine surface a stand-in uses: the adapter's chart view plus mount, removal, batch and the load state (web:
1017
1097
  * kscript-standin.util.ts `KScriptStandInTarget`). */
@@ -1036,6 +1116,9 @@ export interface WrunStandInWriteArgs {
1036
1116
  chartIntervalMs: number;
1037
1117
  runInterval: WrunOverlayRunInterval | null | undefined;
1038
1118
  nowMs?: number;
1119
+ /** Who asks (web: `KScriptStandInWriteSite`): the run's accepted integration (`run`, the default), or web's workspace
1120
+ * switch teardown storing the shown picture (`switch-teardown`). */
1121
+ site?: 'run' | 'switch-teardown';
1039
1122
  }
1040
1123
  /** Why the chart's end-of-data marker shows (web: utility/chart/end-of-data-marker.util.ts `EndOfDataMarkerReason`). */
1041
1124
  export type WrunEndOfDataMarkerReason = HistoryWallKind | 'layout-cap';
package/dist/index.d.ts CHANGED
@@ -49,8 +49,10 @@ export * from './kscript-data/controls/live-trades-merge.util.js';
49
49
  export * from './market-data/billing.interface.js';
50
50
  export * from './market-data/venue.js';
51
51
  export * from './market-data/venue-governed.util.js';
52
+ export * from './market-data/venues/cme.js';
52
53
  export * from './market-data/venues/index.js';
53
54
  export * from './market-data/venues/opra.js';
55
+ export * from './market-data/venues/stocks.js';
54
56
  export * from './replay/replayIndicatorRows.js';
55
57
  export * from './settings-templates/footprint-rows.js';
56
58
  export * from './settings-templates/form-rows.js';
@@ -61,6 +63,7 @@ export * from './settings-templates/tool-rules.js';
61
63
  export * from './settings-templates/tool-tables.generated.js';
62
64
  export * from './utility/auth/server-clock.util.js';
63
65
  export * from './utility/blk-market.util.js';
66
+ export * from './utility/chart/book-live-bucket.util.js';
64
67
  export * from './utility/chart/builtin-identity.util.js';
65
68
  export * from './utility/chart/cache-alignment.util.js';
66
69
  export * from './utility/chart/calendar-interval.util.js';
@@ -74,10 +77,12 @@ export * from './utility/chart/cme-cache-context.util.js';
74
77
  export * from './utility/chart/cme-realtime.util.js';
75
78
  export * from './utility/chart/cme-session-bucket.util.js';
76
79
  export * from './utility/chart/cme-trade-calendar.util.js';
80
+ export * from './utility/chart/cme-user-scripts-gate.util.js';
77
81
  export * from './utility/chart/color-customization.leaf.js';
78
82
  export * from './utility/chart/continuous-contracts.util.js';
79
83
  export * from './utility/chart/crypto-index.leaf.js';
80
84
  export * from './utility/chart/date-labelled-interval.leaf.js';
85
+ export * from './utility/chart/effective-chart-session.util.js';
81
86
  export * from './utility/chart/feed-interval.util.js';
82
87
  export * from './utility/chart/fetch-dedupe-policy.util.js';
83
88
  export * from './utility/chart/footprint-band.util.js';
@@ -161,6 +166,7 @@ export * from './utility/chart/profile-block-size.util.js';
161
166
  export * from './utility/chart/profile-row-height.util.js';
162
167
  export * from './utility/chart/protected-kscript-degenerate-rows.leaf.js';
163
168
  export * from './utility/chart/protected-kscript-empty-output.util.js';
169
+ export * from './utility/chart/quote-perp.leaf.js';
164
170
  export * from './utility/chart/rth-session.util.js';
165
171
  export * from './utility/chart/run-interval-unservable.leaf.js';
166
172
  export * from './utility/chart/run-interval-warmup.leaf.js';
@@ -191,6 +197,7 @@ export * from './utility/market-events/earnings-scope.util.js';
191
197
  export * from './utility/market-events/zoned-clock.util.js';
192
198
  export * from './utility/number-format.util.js';
193
199
  export * from './utility/options/cme-options-root.util.js';
200
+ export * from './utility/options/option-bar-anchor.util.js';
194
201
  export * from './utility/options/option-book.util.js';
195
202
  export * from './utility/options/option-symbol.util.js';
196
203
  export * from './utility/options/option-trade-date.util.js';
@@ -207,10 +214,12 @@ export * from './utility/v2/gate-plane.util.js';
207
214
  export * from './utility/v2/gate-session-latch.util.js';
208
215
  export * from './utility/v2/governed-tier.leaf.js';
209
216
  export * from './utility/v2/opra-governed.util.js';
217
+ export * from './utility/v2/stocks-governed.util.js';
210
218
  export * from './utility/watchlist/import/import-request.leaf.js';
211
219
  export * from './utility/watchlist/import/tradingview-symbols.leaf.js';
212
220
  export * from './utility/wrun-alert-params.leaf.js';
213
221
  export * from './utility/wrun-display-name.util.js';
222
+ export * from './utility/wrun/derived-roots.util.js';
214
223
  export * from './utility/wrun/run-schedule/wrun-chart-gate-reader.util.js';
215
224
  export * from './utility/wrun/run-schedule/wrun-gate-reader-warm.util.js';
216
225
  export * from './utility/wrun/run-schedule/wrun-lane-groups.util.js';
@@ -228,6 +237,7 @@ export * from './utility/wrun/sources/row-lanes/index.js';
228
237
  export * from './utility/wrun/sources/row-lanes/option_contract_flow.js';
229
238
  export * from './utility/wrun/sources/wrun-poll-lane.types.js';
230
239
  export * from './utility/wrun/sources/wrun-poll-lanes.util.js';
240
+ export * from './utility/wrun/sources/wrun-row-lane-add-memo.util.js';
231
241
  export * from './utility/wrun/sources/wrun-row-lane-first-paint.util.js';
232
242
  export * from './utility/wrun/sources/wrun-row-lane.types.js';
233
243
  export * from './utility/wrun/sources/wrun-row-lanes.util.js';
@@ -246,6 +256,7 @@ export * from './utility/wrun/wrun-canvas-readout.util.js';
246
256
  export * from './utility/wrun/wrun-canvases.util.js';
247
257
  export * from './utility/wrun/wrun-cap-notice.util.js';
248
258
  export * from './utility/wrun/wrun-card-style.util.js';
259
+ export * from './utility/wrun/wrun-cell-capacity.leaf.js';
249
260
  export * from './utility/wrun/wrun-chart-context-names.util.js';
250
261
  export * from './utility/wrun/wrun-chart-context.util.js';
251
262
  export * from './utility/wrun/wrun-chart-market-facts.util.js';
@@ -263,7 +274,9 @@ export * from './utility/wrun/wrun-daily-lane.util.js';
263
274
  export * from './utility/wrun/wrun-deadline.util.js';
264
275
  export * from './utility/wrun/wrun-debug-output.util.js';
265
276
  export * from './utility/wrun/wrun-declared-warmup.util.js';
277
+ export * from './utility/wrun/wrun-dollar-unit-port.leaf.js';
266
278
  export * from './utility/wrun/wrun-download-meter.util.js';
279
+ export * from './utility/wrun/wrun-download-plan.util.js';
267
280
  export * from './utility/wrun/wrun-draft-legend-note.util.js';
268
281
  export * from './utility/wrun/wrun-draft-overlay.util.js';
269
282
  export * from './utility/wrun/wrun-draw-skipped.leaf.js';
@@ -305,6 +318,7 @@ export * from './utility/wrun/wrun-live-patch.util.js';
305
318
  export * from './utility/wrun/wrun-live-tick.util.js';
306
319
  export * from './utility/wrun/wrun-loading-owner.util.js';
307
320
  export * from './utility/wrun/wrun-market-facts.util.js';
321
+ export * from './utility/wrun/wrun-market-size-contract-carry.leaf.js';
308
322
  export * from './utility/wrun/wrun-market-size-defaults.leaf.js';
309
323
  export * from './utility/wrun/wrun-market-size-defaults.util.js';
310
324
  export * from './utility/wrun/wrun-memory-clamp.util.js';
@@ -314,9 +328,11 @@ export * from './utility/wrun/wrun-oi-lane.util.js';
314
328
  export * from './utility/wrun/wrun-opra-flow.leaf.js';
315
329
  export * from './utility/wrun/wrun-opra-lane.util.js';
316
330
  export * from './utility/wrun/wrun-opra-stats.leaf.js';
331
+ export * from './utility/wrun/wrun-option-book-rows.util.js';
317
332
  export * from './utility/wrun/wrun-option-contract-flow.util.js';
318
333
  export * from './utility/wrun/wrun-option-knobs.util.js';
319
334
  export * from './utility/wrun/wrun-option-prints.util.js';
335
+ export * from './utility/wrun/wrun-option-strike-flow-forecast.util.js';
320
336
  export * from './utility/wrun/wrun-option-strike-flow-lane.util.js';
321
337
  export * from './utility/wrun/wrun-option-strike-flow.util.js';
322
338
  export * from './utility/wrun/wrun-option-summary-lane.util.js';
@@ -348,6 +364,7 @@ export * from './utility/wrun/wrun-protocol-pending.util.js';
348
364
  export * from './utility/wrun/wrun-refusal-surface.util.js';
349
365
  export * from './utility/wrun/wrun-refusal-text.util.js';
350
366
  export * from './utility/wrun/wrun-refusal.util.js';
367
+ export * from './utility/wrun/wrun-refused-latest.util.js';
351
368
  export * from './utility/wrun/wrun-registry-errors.util.js';
352
369
  export * from './utility/wrun/wrun-render-select.util.js';
353
370
  export * from './utility/wrun/wrun-replay-lane.util.js';
@@ -378,6 +395,7 @@ export * from './utility/wrun/wrun-style-flags.util.js';
378
395
  export * from './utility/wrun/wrun-symbol-code.util.js';
379
396
  export * from './utility/wrun/wrun-table-chrome.util.js';
380
397
  export * from './utility/wrun/wrun-table-look.util.js';
398
+ export * from './utility/wrun/wrun-tape-per-order.util.js';
381
399
  export * from './utility/wrun/wrun-tape-source.util.js';
382
400
  export * from './utility/wrun/wrun-text-look.util.js';
383
401
  export * from './utility/wrun/wrun-text-params.util.js';