@orangecharts/wrun-chart-host 0.11.1 → 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (319) hide show
  1. package/README.md +1 -0
  2. package/dist/constants/feature-flags.constants.d.ts +4 -4
  3. package/dist/constants/feature-flags.constants.js +38 -52
  4. package/dist/constants/feature-limits.constants.d.ts +1 -1
  5. package/dist/constants/feature-limits.constants.js +5 -4
  6. package/dist/constants/interval.constants.d.ts +7 -0
  7. package/dist/constants/interval.constants.js +7 -0
  8. package/dist/constants/scriptEditor/cme-official-scripts.constants.d.ts +20 -149
  9. package/dist/constants/scriptEditor/cme-official-scripts.constants.js +20 -309
  10. package/dist/constants/stocks-compliance.constants.d.ts +15 -0
  11. package/dist/constants/stocks-compliance.constants.js +15 -0
  12. package/dist/host-env.d.ts +69 -3
  13. package/dist/host-env.js +21 -0
  14. package/dist/host-ports.types.d.ts +36 -3
  15. package/dist/index.d.ts +18 -0
  16. package/dist/index.js +19 -0
  17. package/dist/indicators/controls/tpo-session.util.d.ts +52 -12
  18. package/dist/indicators/controls/tpo-session.util.js +113 -16
  19. package/dist/instances/script-engine-worker-ohlcv-transfer.d.ts +6 -0
  20. package/dist/instances/script-engine-worker-ohlcv-transfer.js +16 -0
  21. package/dist/interfaces/cme-realtime.interface.d.ts +8 -0
  22. package/dist/interfaces/cme-realtime.interface.js +2 -1
  23. package/dist/interfaces/feed.interface.d.ts +15 -1
  24. package/dist/interfaces/replay.interface.d.ts +5 -0
  25. package/dist/interfaces/stocks-realtime.interface.d.ts +4 -3
  26. package/dist/interfaces/stocks-realtime.interface.js +5 -4
  27. package/dist/interfaces/wrun-runtime.interface.d.ts +141 -20
  28. package/dist/kscript-data/controls/live-ohlcv-merge.util.d.ts +17 -0
  29. package/dist/kscript-data/controls/live-ohlcv-merge.util.js +22 -0
  30. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +46 -40
  31. package/dist/kscript-data/controls/live-trades-merge.util.js +80 -107
  32. package/dist/market-data/billing.interface.d.ts +9 -1
  33. package/dist/market-data/venue.d.ts +1 -1
  34. package/dist/market-data/venues/index.d.ts +5 -5
  35. package/dist/market-data/venues/opra.js +3 -3
  36. package/dist/market-data/venues/stocks.contract.copy.json +6 -5
  37. package/dist/market-data/venues/stocks.d.ts +5 -5
  38. package/dist/market-data/venues/stocks.js +21 -18
  39. package/dist/settings-templates/frvp-fields.d.ts +12 -1
  40. package/dist/settings-templates/frvp-fields.js +15 -4
  41. package/dist/settings-templates/index.js +12 -5
  42. package/dist/settings-templates/indicator-fields.js +43 -2
  43. package/dist/settings-templates/tool-rules.d.ts +17 -8
  44. package/dist/settings-templates/tool-rules.js +15 -8
  45. package/dist/settings-templates/tool-tables.generated.js +4 -2
  46. package/dist/utility/auth/server-clock.util.d.ts +3 -1
  47. package/dist/utility/auth/server-clock.util.js +3 -1
  48. package/dist/utility/chart/book-live-bucket.util.js +2 -2
  49. package/dist/utility/chart/cache-alignment.util.d.ts +38 -7
  50. package/dist/utility/chart/cache-alignment.util.js +50 -13
  51. package/dist/utility/chart/chart-data-fetch-generation.util.d.ts +2 -0
  52. package/dist/utility/chart/chart-data-fetch-generation.util.js +16 -0
  53. package/dist/utility/chart/cme-session-bucket.util.d.ts +18 -75
  54. package/dist/utility/chart/cme-session-bucket.util.js +25 -332
  55. package/dist/utility/chart/continuous-contracts.util.js +6 -5
  56. package/dist/utility/chart/display-offset.leaf.d.ts +24 -0
  57. package/dist/utility/chart/display-offset.leaf.js +41 -0
  58. package/dist/utility/chart/effective-chart-session.util.d.ts +2 -1
  59. package/dist/utility/chart/effective-chart-session.util.js +13 -5
  60. package/dist/utility/chart/feed-interval.util.d.ts +6 -20
  61. package/dist/utility/chart/feed-interval.util.js +13 -22
  62. package/dist/utility/chart/fetch-dedupe-policy.util.d.ts +27 -7
  63. package/dist/utility/chart/fetch-dedupe-policy.util.js +86 -11
  64. package/dist/utility/chart/footprint-band.util.d.ts +21 -5
  65. package/dist/utility/chart/footprint-band.util.js +53 -14
  66. package/dist/utility/chart/host-bar-placement.util.d.ts +7 -4
  67. package/dist/utility/chart/host-bar-placement.util.js +8 -2
  68. package/dist/utility/chart/indicator-inflight-registry.util.d.ts +32 -0
  69. package/dist/utility/chart/indicator-inflight-registry.util.js +52 -0
  70. package/dist/utility/chart/indicator-run-interval.util.d.ts +10 -4
  71. package/dist/utility/chart/indicator-run-interval.util.js +21 -12
  72. package/dist/utility/chart/interval-registry.util.d.ts +1 -1
  73. package/dist/utility/chart/interval-registry.util.js +1 -1
  74. package/dist/utility/chart/kscript-legend-entries.util.d.ts +12 -0
  75. package/dist/utility/chart/kscript-legend-entries.util.js +16 -0
  76. package/dist/utility/chart/kscript-run-interval-projection.util.d.ts +1 -1
  77. package/dist/utility/chart/kscript-run-interval-projection.util.js +4 -2
  78. package/dist/utility/chart/kscript-venue-policy.util.d.ts +53 -62
  79. package/dist/utility/chart/kscript-venue-policy.util.js +85 -94
  80. package/dist/utility/chart/live-bucket.util.d.ts +39 -17
  81. package/dist/utility/chart/live-bucket.util.js +103 -57
  82. package/dist/utility/chart/local-kscript-source-revalidation.util.d.ts +58 -20
  83. package/dist/utility/chart/local-kscript-source-revalidation.util.js +98 -23
  84. package/dist/utility/chart/local-kscript-warmup-depth.util.d.ts +35 -11
  85. package/dist/utility/chart/local-kscript-warmup-depth.util.js +24 -3
  86. package/dist/utility/chart/market-session-schedule.util.d.ts +8 -0
  87. package/dist/utility/chart/market-session-schedule.util.js +39 -1
  88. package/dist/utility/chart/market-session.util.d.ts +136 -0
  89. package/dist/utility/chart/market-session.util.js +341 -0
  90. package/dist/utility/chart/om-panel.util.d.ts +5 -3
  91. package/dist/utility/chart/om-panel.util.js +42 -7
  92. package/dist/utility/chart/om-target.util.d.ts +14 -1
  93. package/dist/utility/chart/om-target.util.js +22 -5
  94. package/dist/utility/chart/opra-read-access.leaf.d.ts +16 -1
  95. package/dist/utility/chart/opra-read-access.leaf.js +22 -0
  96. package/dist/utility/chart/profile-row-height.util.d.ts +49 -16
  97. package/dist/utility/chart/profile-row-height.util.js +74 -37
  98. package/dist/utility/chart/rth-session.util.d.ts +55 -20
  99. package/dist/utility/chart/rth-session.util.js +94 -46
  100. package/dist/utility/chart/session-lattice.util.d.ts +150 -0
  101. package/dist/utility/chart/session-lattice.util.js +488 -0
  102. package/dist/utility/chart/trading-day.util.d.ts +40 -2
  103. package/dist/utility/chart/trading-day.util.js +84 -7
  104. package/dist/utility/chart/us-equities-session.util.d.ts +32 -11
  105. package/dist/utility/chart/us-equities-session.util.js +44 -15
  106. package/dist/utility/chart/window-geometry.leaf.d.ts +28 -7
  107. package/dist/utility/chart/window-geometry.leaf.js +57 -8
  108. package/dist/utility/chart/wrun-bar-session-facts.util.d.ts +21 -14
  109. package/dist/utility/chart/wrun-bar-session-facts.util.js +32 -38
  110. package/dist/utility/chart/wrun-run-result.util.d.ts +38 -13
  111. package/dist/utility/chart/wrun-run-result.util.js +97 -27
  112. package/dist/utility/common/time.util.js +5 -4
  113. package/dist/utility/market-events/earnings-scope.util.d.ts +10 -5
  114. package/dist/utility/market-events/earnings-scope.util.js +17 -9
  115. package/dist/utility/market-events/market-events.util.d.ts +14 -7
  116. package/dist/utility/market-events/market-events.util.js +30 -17
  117. package/dist/utility/number-format.util.d.ts +14 -21
  118. package/dist/utility/number-format.util.js +38 -24
  119. package/dist/utility/options/option-venue-disclosure.util.d.ts +40 -6
  120. package/dist/utility/options/option-venue-disclosure.util.js +71 -11
  121. package/dist/utility/options/option-venue.util.d.ts +1 -1
  122. package/dist/utility/options/option-venue.util.js +1 -1
  123. package/dist/utility/pool-symbol.leaf.d.ts +7 -0
  124. package/dist/utility/pool-symbol.leaf.js +50 -5
  125. package/dist/utility/stocks/stock-display.util.d.ts +15 -0
  126. package/dist/utility/stocks/stock-display.util.js +37 -0
  127. package/dist/utility/symbol-selection/contract-expiry.util.js +5 -4
  128. package/dist/utility/v2/gate-plane.util.d.ts +6 -0
  129. package/dist/utility/v2/gate-plane.util.js +11 -1
  130. package/dist/utility/v2/gate-session-latch.util.d.ts +1 -1
  131. package/dist/utility/v2/gate-session-latch.util.js +3 -3
  132. package/dist/utility/v2/governed-tier.leaf.d.ts +17 -16
  133. package/dist/utility/v2/governed-tier.leaf.js +17 -16
  134. package/dist/utility/v2/stocks-governed.util.d.ts +5 -0
  135. package/dist/utility/v2/stocks-governed.util.js +14 -0
  136. package/dist/utility/v2/v2-enums.leaf.d.ts +13 -0
  137. package/dist/utility/v2/v2-enums.leaf.js +458 -0
  138. package/dist/utility/wrun/derived-roots.leaf.d.ts +21 -1
  139. package/dist/utility/wrun/derived-roots.leaf.js +27 -1
  140. package/dist/utility/wrun/derived-roots.util.d.ts +44 -32
  141. package/dist/utility/wrun/derived-roots.util.js +97 -56
  142. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.d.ts +4 -3
  143. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.js +4 -3
  144. package/dist/utility/wrun/sources/lanes/option_daily.d.ts +2 -1
  145. package/dist/utility/wrun/sources/lanes/option_daily.js +2 -1
  146. package/dist/utility/wrun/sources/lanes/options_flow.d.ts +3 -0
  147. package/dist/utility/wrun/sources/lanes/options_flow.js +23 -5
  148. package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +3 -4
  149. package/dist/utility/wrun/sources/row-lane-registry.js +9 -4
  150. package/dist/utility/wrun/sources/row-lanes/dark_pool.d.ts +19 -0
  151. package/dist/utility/wrun/sources/row-lanes/dark_pool.js +104 -0
  152. package/dist/utility/wrun/sources/row-lanes/index.js +2 -0
  153. package/dist/utility/wrun/sources/wrun-lane-fetch-abort.util.d.ts +20 -0
  154. package/dist/utility/wrun/sources/wrun-lane-fetch-abort.util.js +103 -0
  155. package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +19 -2
  156. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +15 -13
  157. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +49 -23
  158. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +14 -9
  159. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +75 -27
  160. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +139 -82
  161. package/dist/utility/wrun/wrun-app-layer.leaf.d.ts +78 -0
  162. package/dist/utility/wrun/wrun-app-layer.leaf.js +89 -0
  163. package/dist/utility/wrun/wrun-bar-count.util.d.ts +11 -7
  164. package/dist/utility/wrun/wrun-bar-count.util.js +12 -8
  165. package/dist/utility/wrun/wrun-batched-kinds.leaf.d.ts +13 -0
  166. package/dist/utility/wrun/wrun-batched-kinds.leaf.js +18 -0
  167. package/dist/utility/wrun/wrun-batched-marks.util.d.ts +46 -23
  168. package/dist/utility/wrun/wrun-batched-marks.util.js +260 -62
  169. package/dist/utility/wrun/wrun-batched-readout.util.d.ts +26 -19
  170. package/dist/utility/wrun/wrun-batched-readout.util.js +81 -27
  171. package/dist/utility/wrun/wrun-book-bands.leaf.d.ts +8 -0
  172. package/dist/utility/wrun/wrun-book-bands.leaf.js +7 -0
  173. package/dist/utility/wrun/wrun-candle-equal.leaf.d.ts +19 -0
  174. package/dist/utility/wrun/wrun-candle-equal.leaf.js +40 -0
  175. package/dist/utility/wrun/wrun-canvas-readout.util.d.ts +4 -2
  176. package/dist/utility/wrun/wrun-canvases.util.d.ts +24 -7
  177. package/dist/utility/wrun/wrun-canvases.util.js +99 -30
  178. package/dist/utility/wrun/wrun-chart-context-names.util.d.ts +6 -3
  179. package/dist/utility/wrun/wrun-chart-context-names.util.js +8 -4
  180. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +47 -29
  181. package/dist/utility/wrun/wrun-chart-market-facts.util.js +201 -201
  182. package/dist/utility/wrun/wrun-child-overlay-id.util.js +2 -1
  183. package/dist/utility/wrun/wrun-cme-legs-note.util.d.ts +15 -0
  184. package/dist/utility/wrun/wrun-cme-legs-note.util.js +49 -0
  185. package/dist/utility/wrun/wrun-cme-root-specs.util.d.ts +38 -0
  186. package/dist/utility/wrun/wrun-cme-root-specs.util.js +81 -0
  187. package/dist/utility/wrun/wrun-coin-lane-live.util.js +3 -0
  188. package/dist/utility/wrun/wrun-color-settings.util.d.ts +6 -1
  189. package/dist/utility/wrun/wrun-color-settings.util.js +32 -7
  190. package/dist/utility/wrun/wrun-dark-pool.util.d.ts +50 -0
  191. package/dist/utility/wrun/wrun-dark-pool.util.js +127 -0
  192. package/dist/utility/wrun/wrun-declared-warmup.util.d.ts +67 -12
  193. package/dist/utility/wrun/wrun-declared-warmup.util.js +165 -13
  194. package/dist/utility/wrun/wrun-draft-legend-note.util.d.ts +18 -8
  195. package/dist/utility/wrun/wrun-draft-legend-note.util.js +57 -11
  196. package/dist/utility/wrun/wrun-draft-overlay.util.d.ts +14 -10
  197. package/dist/utility/wrun/wrun-draft-overlay.util.js +26 -14
  198. package/dist/utility/wrun/wrun-earnings-facts.util.js +3 -2
  199. package/dist/utility/wrun/wrun-etf-funds.util.d.ts +2 -0
  200. package/dist/utility/wrun/wrun-etf-funds.util.js +4 -0
  201. package/dist/utility/wrun/wrun-held-lanes.util.js +8 -2
  202. package/dist/utility/wrun/wrun-history-as-of.util.d.ts +77 -0
  203. package/dist/utility/wrun/wrun-history-as-of.util.js +108 -0
  204. package/dist/utility/wrun/wrun-host.service.d.ts +64 -14
  205. package/dist/utility/wrun/wrun-host.service.js +137 -27
  206. package/dist/utility/wrun/wrun-hosted-wire-caps.d.ts +3 -3
  207. package/dist/utility/wrun/wrun-hosted-wire-caps.js +12 -2
  208. package/dist/utility/wrun/wrun-hover.util.d.ts +8 -2
  209. package/dist/utility/wrun/wrun-hover.util.js +24 -13
  210. package/dist/utility/wrun/wrun-inert-legend.util.d.ts +13 -0
  211. package/dist/utility/wrun/wrun-inert-legend.util.js +31 -3
  212. package/dist/utility/wrun/wrun-input-requirements.leaf.d.ts +7 -5
  213. package/dist/utility/wrun/wrun-input-requirements.leaf.js +16 -6
  214. package/dist/utility/wrun/wrun-install-pacer.util.d.ts +26 -0
  215. package/dist/utility/wrun/wrun-install-pacer.util.js +145 -0
  216. package/dist/utility/wrun/wrun-kit-refusal-stages.types.d.ts +22 -0
  217. package/dist/utility/wrun/wrun-kit-refusal-stages.types.js +1 -0
  218. package/dist/utility/wrun/wrun-lane-refusal.leaf.d.ts +12 -5
  219. package/dist/utility/wrun/wrun-lane-refusal.leaf.js +23 -5
  220. package/dist/utility/wrun/wrun-lane-warmup.util.js +22 -4
  221. package/dist/utility/wrun/wrun-leg-close.util.d.ts +6 -5
  222. package/dist/utility/wrun/wrun-leg-close.util.js +11 -9
  223. package/dist/utility/wrun/wrun-leg-fetch.util.d.ts +3 -1
  224. package/dist/utility/wrun/wrun-leg-fetch.util.js +9 -2
  225. package/dist/utility/wrun/wrun-levels-child.util.d.ts +2 -0
  226. package/dist/utility/wrun/wrun-levels-child.util.js +6 -0
  227. package/dist/utility/wrun/wrun-lifecycle.contract.d.ts +4 -0
  228. package/dist/utility/wrun/wrun-live-intake.util.d.ts +15 -6
  229. package/dist/utility/wrun/wrun-live-intake.util.js +167 -47
  230. package/dist/utility/wrun/wrun-live-tick.util.d.ts +52 -8
  231. package/dist/utility/wrun/wrun-live-tick.util.js +655 -97
  232. package/dist/utility/wrun/wrun-market-facts.util.d.ts +16 -2
  233. package/dist/utility/wrun/wrun-market-facts.util.js +32 -3
  234. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +27 -27
  235. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +28 -16
  236. package/dist/utility/wrun/wrun-market-size-defaults.util.js +34 -5
  237. package/dist/utility/wrun/wrun-oi-lane.util.d.ts +10 -7
  238. package/dist/utility/wrun/wrun-oi-lane.util.js +16 -10
  239. package/dist/utility/wrun/wrun-option-strike-flow.util.js +1 -1
  240. package/dist/utility/wrun/wrun-option-views.util.d.ts +2 -2
  241. package/dist/utility/wrun/wrun-option-views.util.js +5 -2
  242. package/dist/utility/wrun/wrun-options-flow-underlying.leaf.d.ts +5 -0
  243. package/dist/utility/wrun/wrun-options-flow-underlying.leaf.js +16 -0
  244. package/dist/utility/wrun/wrun-options-stop.util.d.ts +3 -2
  245. package/dist/utility/wrun/wrun-options-stop.util.js +6 -4
  246. package/dist/utility/wrun/wrun-output-words.util.d.ts +14 -0
  247. package/dist/utility/wrun/wrun-output-words.util.js +51 -0
  248. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +116 -11
  249. package/dist/utility/wrun/wrun-overlay-drivers.util.js +208 -43
  250. package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +20 -10
  251. package/dist/utility/wrun/wrun-overlay-park.util.d.ts +84 -0
  252. package/dist/utility/wrun/wrun-overlay-park.util.js +135 -0
  253. package/dist/utility/wrun/wrun-overlay-recovery.util.d.ts +37 -4
  254. package/dist/utility/wrun/wrun-overlay-recovery.util.js +26 -14
  255. package/dist/utility/wrun/wrun-overlay-result.util.d.ts +6 -1
  256. package/dist/utility/wrun/wrun-overlay-result.util.js +2 -0
  257. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +247 -26
  258. package/dist/utility/wrun/wrun-overlay-run.util.js +2234 -408
  259. package/dist/utility/wrun/wrun-pack.util.d.ts +8 -5
  260. package/dist/utility/wrun/wrun-panel-mount.util.d.ts +11 -2
  261. package/dist/utility/wrun/wrun-panel-mount.util.js +122 -19
  262. package/dist/utility/wrun/wrun-panel-style.util.d.ts +4 -2
  263. package/dist/utility/wrun/wrun-panel-style.util.js +3 -2
  264. package/dist/utility/wrun/wrun-pin-spelling.util.d.ts +7 -0
  265. package/dist/utility/wrun/wrun-pin-spelling.util.js +18 -4
  266. package/dist/utility/wrun/wrun-pin-venues.util.d.ts +26 -17
  267. package/dist/utility/wrun/wrun-pin-venues.util.js +43 -36
  268. package/dist/utility/wrun/wrun-pinned-lanes.util.d.ts +58 -0
  269. package/dist/utility/wrun/wrun-pinned-lanes.util.js +72 -0
  270. package/dist/utility/wrun/wrun-prefix-cohort.util.js +2 -1
  271. package/dist/utility/wrun/wrun-prefix-lanes.util.d.ts +22 -9
  272. package/dist/utility/wrun/wrun-prefix-lanes.util.js +145 -26
  273. package/dist/utility/wrun/wrun-prefix-proof.util.d.ts +29 -0
  274. package/dist/utility/wrun/wrun-prefix-proof.util.js +23 -5
  275. package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +9 -1
  276. package/dist/utility/wrun/wrun-refusal-surface.util.js +15 -1
  277. package/dist/utility/wrun/wrun-refusal.util.d.ts +19 -1
  278. package/dist/utility/wrun/wrun-refusal.util.js +103 -16
  279. package/dist/utility/wrun/wrun-registry-errors.util.d.ts +20 -6
  280. package/dist/utility/wrun/wrun-registry-errors.util.js +20 -6
  281. package/dist/utility/wrun/wrun-replay-rows.util.js +6 -10
  282. package/dist/utility/wrun/wrun-run-health.util.d.ts +95 -5
  283. package/dist/utility/wrun/wrun-run-health.util.js +209 -3
  284. package/dist/utility/wrun/wrun-run-interval-session.util.d.ts +2 -2
  285. package/dist/utility/wrun/wrun-run-interval-session.util.js +2 -2
  286. package/dist/utility/wrun/wrun-run-interval.util.d.ts +9 -8
  287. package/dist/utility/wrun/wrun-run-interval.util.js +13 -11
  288. package/dist/utility/wrun/wrun-sandbox-row-source.js +5 -2
  289. package/dist/utility/wrun/wrun-script-inputs.util.d.ts +38 -11
  290. package/dist/utility/wrun/wrun-script-inputs.util.js +194 -56
  291. package/dist/utility/wrun/wrun-session-composition.util.d.ts +81 -0
  292. package/dist/utility/wrun/wrun-session-composition.util.js +169 -0
  293. package/dist/utility/wrun/wrun-setting-words.util.d.ts +10 -7
  294. package/dist/utility/wrun/wrun-setting-words.util.js +25 -7
  295. package/dist/utility/wrun/wrun-source-rows.util.d.ts +94 -28
  296. package/dist/utility/wrun/wrun-source-rows.util.js +738 -93
  297. package/dist/utility/wrun/wrun-stream-clock.util.d.ts +45 -0
  298. package/dist/utility/wrun/wrun-stream-clock.util.js +108 -0
  299. package/dist/utility/wrun/wrun-style-names.util.d.ts +23 -0
  300. package/dist/utility/wrun/wrun-style-names.util.js +74 -0
  301. package/dist/utility/wrun/wrun-tape-coins.util.d.ts +116 -0
  302. package/dist/utility/wrun/wrun-tape-coins.util.js +110 -0
  303. package/dist/utility/wrun/wrun-tape-source.util.d.ts +62 -32
  304. package/dist/utility/wrun/wrun-tape-source.util.js +72 -34
  305. package/dist/utility/wrun/wrun-tier-grid.util.d.ts +13 -5
  306. package/dist/utility/wrun/wrun-tier-grid.util.js +23 -13
  307. package/dist/utility/wrun/wrun-tpo-rows.util.js +2 -1
  308. package/dist/utility/wrun/wrun-trades-lane.util.d.ts +73 -0
  309. package/dist/utility/wrun/wrun-trades-lane.util.js +82 -0
  310. package/dist/utility/wrun/wrun-twin-compute-inputs.util.d.ts +5 -0
  311. package/dist/utility/wrun/wrun-twin-compute-inputs.util.js +9 -2
  312. package/dist/utility/wrun/wrun-visibility-table.d.ts +13 -0
  313. package/dist/utility/wrun/wrun-visibility-table.js +9 -0
  314. package/dist/utility/wrun/wrun-volume-profile.util.js +7 -3
  315. package/dist/utils/replay/replay-buffer-math.d.ts +16 -6
  316. package/dist/utils/replay/replay-buffer-math.js +60 -30
  317. package/dist/workers/constants/socket-slots.d.ts +11 -7
  318. package/dist/workers/constants/socket-slots.js +6 -5
  319. package/package.json +5 -5
@@ -32,11 +32,12 @@
32
32
  * colour rows are the declared `palette` / buy and sell colours read below.
33
33
  */
34
34
  import { DEFAULT_TPO_COLOR_SCHEMES } from '../../constants/tpo-color-schemes.constants.js';
35
- import { profileRowMultiplier, tpoPeriodWord } from '../chart/profile-row-height.util.js';
35
+ import { profileRowMultiplier, tpoPeriodWord, viewScaledProfileRowMultiplier } from '../chart/profile-row-height.util.js';
36
36
  import { getTradingDayAnchor } from '../chart/trading-day.util.js';
37
37
  import { wrunLegendName } from '../chart/wrun-legend-name.util.js';
38
38
  import { heatmapSensitivityForQuantile, heatmapSensitivityQuantile } from '../indicators/heatmap-sensitivity.util.js';
39
39
  import { isWrunStyleTargetHidden } from './wrun-color-settings.util.js';
40
+ import { isWrunBandedBookSource } from './wrun-book-bands.leaf.js';
40
41
  import { WRUN_MAX_ROWS_PER_PERIOD, WRUN_ROW_CAP_MAX_DOUBLINGS, wrunAutoRowUnit } from './wrun-auto-row.util.js';
41
42
  import { WRUN_FOOTPRINT_CELL_METRIC_DEFAULT, WRUN_FOOTPRINT_MODE_DEFAULT } from './wrun-footprint-modes.util.js';
42
43
  import { formatWrunNumber, resolveWrunColorWord, wrunFontFamilyCss, } from './wrun-style-words.util.js';
@@ -244,6 +245,18 @@ function nthZeroOf(values, index) {
244
245
  * zero pick re-reads the zero at its rank in that order.
245
246
  */
246
247
  export function wrunCanvasScaleOf(words, values, options) {
248
+ return pickCanvasScale(words, values, options).scale;
249
+ }
250
+ /**
251
+ * `wrunCanvasScaleOf`'s pick, and whether the sample gave every bound left to it (`spread`). It did not when it held
252
+ * no finite cell, or when the quantiles it was read at meet (every cell at the zero floor, a declared bound or the
253
+ * centre, or at least the quantile's share of them): the bounds are then stand-ins (`[floor, floor + 1]`,
254
+ * `centre +- 1`), chosen for want of a scale, never one the cells chose. A mounted heatmap holds only a scale its
255
+ * sample gave (wrun-panel-mount.util `holdsHeatmapScale`, `wrunHeatmapScaleDecided`): a stand-in held through the
256
+ * passes after it would saturate every cell the next rows bring. Bounds all declared take nothing from the sample
257
+ * and read as given.
258
+ */
259
+ function pickCanvasScale(words, values, options) {
247
260
  const q = finite(words.auto_quantile) ? words.auto_quantile : WRUN_CANVAS_DEFAULT_QUANTILE;
248
261
  const scale = words.scale ?? 'linear';
249
262
  const diverging = options.diverging || finite(words.center);
@@ -259,11 +272,13 @@ export function wrunCanvasScaleOf(words, values, options) {
259
272
  deviations[count++] = Math.abs(value - center);
260
273
  }
261
274
  let reach = count === 0 ? 0 : selectKth(deviations, count, quantileRank(count, q));
262
- if (!(reach > 0))
275
+ const reached = reach > 0;
276
+ if (!reached)
263
277
  reach = 1;
264
278
  const min = finite(words.min) ? words.min : center - reach;
265
279
  const max = finite(words.max) ? words.max : center + reach;
266
- return { min, max: max > min ? max : min + 1, center, scale };
280
+ const given = finite(words.min) && finite(words.max);
281
+ return { scale: { min, max: max > min ? max : min + 1, center, scale }, spread: given || (reached && max > min) };
267
282
  }
268
283
  const work = new Float64Array(values.length);
269
284
  let count = 0;
@@ -288,7 +303,8 @@ export function wrunCanvasScaleOf(words, values, options) {
288
303
  };
289
304
  const min = finite(words.min) ? words.min : options.zeroFloor ? 0 : count === 0 ? 0 : pick(1 - q);
290
305
  const max = finite(words.max) ? words.max : count === 0 ? min + 1 : pick(q);
291
- return { min, max: max > min ? max : min + 1, scale };
306
+ const given = finite(words.max) && (finite(words.min) || options.zeroFloor === true);
307
+ return { scale: { min, max: max > min ? max : min + 1, scale }, spread: given || (count > 0 && max > min) };
292
308
  }
293
309
  /** A value's position (0..1) on the scale: the diverging ramp sits its
294
310
  * centre at 0.5, `sqrt` lifts the small values, `log` (sequential only)
@@ -528,10 +544,13 @@ function rowsIntervalMs(rows) {
528
544
  }
529
545
  return Number.isFinite(smallest) ? smallest : undefined;
530
546
  }
547
+ /** The source class a canvas's `cells` name: none for a banded book input (`isWrunBandedBookSource`), whose block is
548
+ * band sums, never the levels a book canvas paints (the kit refuses a canvas naming one). */
531
549
  function inputSourceClass(sheet, name) {
532
550
  if (name === undefined)
533
551
  return undefined;
534
- return sheet.inputSources?.[name]?.source;
552
+ const source = sheet.inputSources?.[name];
553
+ return isWrunBandedBookSource(source) ? undefined : source?.source;
535
554
  }
536
555
  // ── The run's cell rows (handed by the run and tick routes) ─────────────────
537
556
  /**
@@ -663,8 +682,13 @@ function heatmapSensitivityRule(sheet, heatmap, index) {
663
682
  const rule = heatmapScaleRule(sheet, heatmap);
664
683
  if (rule === null)
665
684
  return null;
666
- const fromQuantile = !finite(heatmap.max) || (!finite(heatmap.min) && !rule.zeroFloor);
667
- return fromQuantile && !quantileBoundByParam(sheet, heatmap, index) ? rule : null;
685
+ return boundFromSample(heatmap, rule) && !quantileBoundByParam(sheet, heatmap, index) ? rule : null;
686
+ }
687
+ /** A bound of the heatmap's colour scale comes from the cell sample (`wrunCanvasScaleOf`): `max` undeclared, or
688
+ * `min` undeclared where the word has no zero floor (a diverging heatmap never has one). Both declared (or `max`
689
+ * declared over a zero floor) and the sample decides nothing. */
690
+ function boundFromSample(heatmap, rule) {
691
+ return !finite(heatmap.max) || (!finite(heatmap.min) && !rule.zeroFloor);
668
692
  }
669
693
  /** The author's scale words as declared (absent words stay absent). */
670
694
  function heatmapScaleWords(heatmap) {
@@ -676,21 +700,56 @@ function heatmapScaleWords(heatmap) {
676
700
  ...(heatmap.scale !== undefined ? { scale: heatmap.scale } : {}),
677
701
  };
678
702
  }
679
- /** The scale sample a heatmap child was built with, kept beside it (keyed by
680
- * the child's own rows array, a fresh array per child): a Sensitivity re-pick
681
- * needs only a new selection, never another walk of the window. */
703
+ /**
704
+ * The scale sample a heatmap child's bounds were picked from, kept beside it, keyed by the child's own
705
+ * `settings` object (a fresh object per child per build, holding the bounds the sample gave): a Sensitivity
706
+ * re-pick needs only a new selection, never another walk of the window. The key is the settings and never the
707
+ * rows: every seam that keeps a mounted record (a live merge adopting the engine's rows, a cell-budget trim, a
708
+ * windowed landing, a retranslate, a blank) copies the child as `{ ...child, data }`, which shares the settings,
709
+ * so the sample stays with the bounds it gave while the rows move under them. Keyed by the rows (as it was until
710
+ * 2026-11-07), the first live merge or trim lost it and the next re-pick sampled whatever rows the canvas held
711
+ * then. Kept whenever a bound comes from the sample (`boundFromSample`), with or without a Sensitivity row, beside
712
+ * whether the sample gave the bounds it was read for (`pickCanvasScale`'s `spread`): the mount's scale hold reads it
713
+ * (`wrunHeatmapScaleDecided`).
714
+ */
682
715
  const heatmapSamples = new WeakMap();
683
716
  /**
684
- * A windowed landing (wrun-panel-mount.util: a pan-back page or a prefix run landed inside its history
685
- * window) keeps the colour scale its heatmap was drawn with; only a full run samples again. The rows it lands
686
- * take the sample the mounted rows' bounds were picked from, so a Sensitivity re-pick afterwards reads that
687
- * sample instead of walking the landed rows into another basis. A child with no kept sample (one that
688
- * crossed a copy or a trim) still walks its rows on the next re-pick, as before.
717
+ * The colour scale a heatmap child was decided with, carried onto another child: `to` takes the sample `from`'s
718
+ * bounds were picked from, so a Sensitivity re-pick on `to` reads that sample instead of walking `to`'s rows into
719
+ * another basis. The mount's scale hold calls it when a pass of the same picture brings new rows
720
+ * (wrun-panel-mount.util `carryHeatmapScale`: the held child is the pass's own with the decided bounds). A child
721
+ * with no kept sample (one that crossed a copy) still walks its rows on the next re-pick, as before.
689
722
  */
690
723
  export function keepWrunHeatmapScaleSample(from, to) {
691
- const sample = heatmapSamples.get(from);
692
- if (sample !== undefined && from !== to)
693
- heatmapSamples.set(to, sample);
724
+ const sample = heatmapSamples.get(from.settings);
725
+ if (sample !== undefined && from.settings !== to.settings)
726
+ heatmapSamples.set(to.settings, sample);
727
+ }
728
+ /** Whether a heatmap child's colour bounds were picked from a sample kept beside it (`heatmapSamples`), whatever it
729
+ * gave: false for a child whose bounds were all declared and for one that crossed a copy. A mount's merge keeps
730
+ * such a scale on its record, as the engine keeps it on screen. */
731
+ export function wrunHeatmapScaleKept(child) {
732
+ return heatmapSamples.has(child.settings);
733
+ }
734
+ /**
735
+ * Whether the colour bounds a heatmap child shows were given by its kept sample, judged on the sample at the
736
+ * quantile they are read at (`pickCanvasScale`'s `spread`, never the bound numbers): its own bounds at the
737
+ * author's quantile, or, with the viewer's Sensitivity on a child with scale words, the re-pick at that position's
738
+ * quantile. False for a sample with no finite cell, one whose cells all sit at the zero floor, a declared bound or
739
+ * the centre (a grid writing 0 until a late input lands, a window of zero-volume buckets), one where at least the
740
+ * quantile's share of them does, a child with no kept sample, and one whose bounds were all declared: the bounds
741
+ * are then stand-ins or the author's, never a scale the cells chose. The mount holds a scale only when this is true
742
+ * (wrun-panel-mount.util `holdsHeatmapScale`); anything else is decided again by the next pass.
743
+ */
744
+ export function wrunHeatmapScaleDecided(child, sensitivity) {
745
+ const kept = heatmapSamples.get(child.settings);
746
+ if (kept === undefined)
747
+ return false;
748
+ const inputs = child.scale;
749
+ if (child.kind !== 'heatmap' || inputs === undefined || !finite(sensitivity))
750
+ return kept.spread;
751
+ const words = { ...inputs.words, auto_quantile: heatmapSensitivityQuantile(sensitivity) };
752
+ return pickCanvasScale(words, kept.values, { diverging: inputs.diverging, zeroFloor: inputs.zeroFloor }).spread;
694
753
  }
695
754
  /** The newest `tailRows` rows of a source (a live tick's tail), else all of them. */
696
755
  function newestRows(rows, tailRows) {
@@ -718,15 +777,16 @@ function heatmapChild(sheet, heatmap, index, cellRows, outputRows, tailRows) {
718
777
  data = newestRows((layout === 'book' ? cellRows?.bookRows : cellRows?.volumeProfileRows) ?? [], tailRows).map(wrunPlainCanvasRow);
719
778
  // A tick's tail samples no scale and keeps no Sensitivity inputs: its rows
720
779
  // only merge into a mounted canvas, which keeps the bounds (and the sample a
721
- // Sensitivity re-pick reads) of the full run that mounted it.
780
+ // Sensitivity re-pick reads) of the pass that decided them.
722
781
  let scale;
782
+ let sample;
723
783
  let sensitivity = null;
724
784
  if (tailRows === undefined) {
725
- const sample = sampleCellValues(layout, valueField, data);
726
- scale = wrunCanvasScaleOf(heatmap, sample, { diverging, zeroFloor });
785
+ const values = sampleCellValues(layout, valueField, data);
786
+ const picked = pickCanvasScale(heatmap, values, { diverging, zeroFloor });
787
+ scale = picked.scale;
788
+ sample = { values, spread: picked.spread };
727
789
  sensitivity = heatmapSensitivityRule(sheet, heatmap, index);
728
- if (sensitivity !== null)
729
- heatmapSamples.set(data, sample);
730
790
  }
731
791
  const format = numberFormatOf(heatmap);
732
792
  const rowHeight = heatmap.row_height ?? (layout === 'book' ? bookGroupingOf(data) : undefined);
@@ -758,6 +818,9 @@ function heatmapChild(sheet, heatmap, index, cellRows, outputRows, tailRows) {
758
818
  valueFormat: format,
759
819
  hoverReadout: heatmap.tooltip !== undefined,
760
820
  };
821
+ // The sample beside the settings holding the bounds it gave (heatmapSamples), whenever a bound came from it.
822
+ if (sample !== undefined && boundFromSample(heatmap, rule))
823
+ heatmapSamples.set(settings, sample);
761
824
  const readout = heatmap.tooltip !== undefined
762
825
  ? { kind: 'heatmap', label: heatmap.label ?? wrunCanvasNameWords(heatmap.name), tooltip: heatmap.tooltip, format }
763
826
  : undefined;
@@ -811,20 +874,26 @@ export function wrunHeatmapSensitivityRows(sheet) {
811
874
  * re-picked from the child's own scale sample at the position's quantile
812
875
  * (the options heatmap's map); the child's own bounds, the author's exactly,
813
876
  * when no position is set or the child carries no scale words. The centre
814
- * never depends on the quantile, so only `min` and `max` move.
877
+ * never depends on the quantile, so only `min` and `max` move. A mounted
878
+ * record's own bounds and sample are its decided scale's (the mount's scale
879
+ * hold), so a re-pick never reads the rows the canvas holds now.
815
880
  */
816
881
  export function wrunHeatmapSensitivityBounds(child, sensitivity) {
817
882
  const own = { min: child.settings.min, max: child.settings.max };
818
883
  const inputs = child.scale;
819
884
  if (child.kind !== 'heatmap' || inputs === undefined || !finite(sensitivity))
820
885
  return own;
821
- let sample = heatmapSamples.get(child.data);
822
- if (sample === undefined) {
886
+ // The sample the child's own bounds were picked from (kept beside its settings, heatmapSamples): on a mounted
887
+ // record that is the decided scale's, whatever rows the record holds now.
888
+ let kept = heatmapSamples.get(child.settings);
889
+ if (kept === undefined) {
823
890
  // A child that crossed a copy (no kept sample) walks its rows again.
824
- sample = sampleCellValues(inputs.layout, inputs.valueField, child.data);
825
- heatmapSamples.set(child.data, sample);
891
+ const values = sampleCellValues(inputs.layout, inputs.valueField, child.data);
892
+ const rule = { diverging: inputs.diverging, zeroFloor: inputs.zeroFloor };
893
+ kept = { values, spread: pickCanvasScale(inputs.words, values, rule).spread };
894
+ heatmapSamples.set(child.settings, kept);
826
895
  }
827
- const scale = wrunCanvasScaleOf({ ...inputs.words, auto_quantile: heatmapSensitivityQuantile(sensitivity) }, sample, {
896
+ const scale = wrunCanvasScaleOf({ ...inputs.words, auto_quantile: heatmapSensitivityQuantile(sensitivity) }, kept.values, {
828
897
  diverging: inputs.diverging,
829
898
  zeroFloor: inputs.zeroFloor,
830
899
  });
@@ -1020,7 +1089,7 @@ function tpoAutoRow(ctx, period, cellRows, bars, profileRows) {
1020
1089
  // on the chart interval (an intrabar leg's finer bars would shrink it).
1021
1090
  bars: (cellRows?.ohlcvRows ?? bars),
1022
1091
  });
1023
- const multiplier = resolved.source === 'bar-range' ? 1 : profileRowMultiplier('tpo', ctx.intervalMs, tpoPeriodWord(period));
1092
+ const multiplier = resolved.source === 'bar-range' ? 1 : viewScaledProfileRowMultiplier('tpo', ctx.intervalMs, tpoPeriodWord(period));
1024
1093
  const unit = Math.max(resolved.unit, widestBarSpan(bars ?? []) / ((WRUN_TPO_MAX_ROWS_PER_BAR / 2) * multiplier));
1025
1094
  return { rowHeight: trimmedRowHeight(unit * multiplier), minimumBarHeight: unit };
1026
1095
  }
@@ -7,7 +7,8 @@
7
7
  * - symbol: the TickerBar's display symbol (useSymbolData's `displaySymbol`,
8
8
  * built on `resolveChartSymbolData`: the "prefix+coin+quote" of a market, a
9
9
  * formula's expression by labels, an economic series' label, a prediction
10
- * market's title; the raw metadata symbol before the resolve lands).
10
+ * market's title; the metadata symbol before the resolve lands, a US stock's
11
+ * by its bare ticker, `stock-display.util`).
11
12
  * - exchange: the header's display exchange name (TBSymbolButton: a
12
13
  * prediction market's `formatEnhancedExchangeName` upper-cased, a formula's
13
14
  * one venue label, an economic series' publisher label, else
@@ -43,10 +44,12 @@ export interface WrunChartNameSource {
43
44
  /** The header's display symbol (useSymbolData's `displaySymbol`): a
44
45
  * prediction market's title, a formula's labelled expression, an economic
45
46
  * series' label, else "prefix+coin+quote" (a pool address appended), and
46
- * the raw metadata symbol while nothing is resolved. On a plain market the
47
+ * the metadata symbol while nothing is resolved. On a plain market the
47
48
  * three parts are slices of the venue's own symbol, so the name is that
48
49
  * symbol, the string a kScript's `currentSymbol` reads on the same chart
49
- * (1000PEPEUSDT keeps its 1000, KRW-RLUSD its KRW-). */
50
+ * (1000PEPEUSDT keeps its 1000, KRW-RLUSD its KRW-), but for a US stock:
51
+ * it names its bare ticker (SOXL), never its vendor pair's SOXL/USD, both
52
+ * resolved and before (`stock-display.util`). */
50
53
  export declare function wrunChartDisplaySymbol(meta: WrunChartNameSource | undefined, data: WrunSymbolDisplayData | null | undefined): string;
51
54
  /** The header's display exchange name (TBSymbolButton): a prediction
52
55
  * market's short venue label upper-cased (HYPERLIQUID_HIP4 reads "HL
@@ -7,7 +7,8 @@
7
7
  * - symbol: the TickerBar's display symbol (useSymbolData's `displaySymbol`,
8
8
  * built on `resolveChartSymbolData`: the "prefix+coin+quote" of a market, a
9
9
  * formula's expression by labels, an economic series' label, a prediction
10
- * market's title; the raw metadata symbol before the resolve lands).
10
+ * market's title; the metadata symbol before the resolve lands, a US stock's
11
+ * by its bare ticker, `stock-display.util`).
11
12
  * - exchange: the header's display exchange name (TBSymbolButton: a
12
13
  * prediction market's `formatEnhancedExchangeName` upper-cased, a formula's
13
14
  * one venue label, an economic series' publisher label, else
@@ -32,23 +33,26 @@ import { formatEnhancedExchangeName } from '../../constants/exchange-names.leaf.
32
33
  import { checkIsPredictionMarket } from '../chart/index-mode.util.js';
33
34
  import { formatExchangeDisplay } from '../exchange-format.leaf.js';
34
35
  import { formatPoolAddress } from '../pool-symbol.leaf.js';
36
+ import { marketDisplaySymbol } from '../stocks/stock-display.util.js';
35
37
  function nonEmptyString(value) {
36
38
  return typeof value === 'string' && value !== '' ? value : undefined;
37
39
  }
38
40
  /** The header's display symbol (useSymbolData's `displaySymbol`): a
39
41
  * prediction market's title, a formula's labelled expression, an economic
40
42
  * series' label, else "prefix+coin+quote" (a pool address appended), and
41
- * the raw metadata symbol while nothing is resolved. On a plain market the
43
+ * the metadata symbol while nothing is resolved. On a plain market the
42
44
  * three parts are slices of the venue's own symbol, so the name is that
43
45
  * symbol, the string a kScript's `currentSymbol` reads on the same chart
44
- * (1000PEPEUSDT keeps its 1000, KRW-RLUSD its KRW-). */
46
+ * (1000PEPEUSDT keeps its 1000, KRW-RLUSD its KRW-), but for a US stock:
47
+ * it names its bare ticker (SOXL), never its vendor pair's SOXL/USD, both
48
+ * resolved and before (`stock-display.util`). */
45
49
  export function wrunChartDisplaySymbol(meta, data) {
46
50
  const raw = nonEmptyString(meta?.symbol) ?? '';
47
51
  const pm = meta?.polymarketMetadata;
48
52
  if (pm)
49
53
  return nonEmptyString(pm.fullName) ?? nonEmptyString(pm.title) ?? raw;
50
54
  if (!data)
51
- return raw;
55
+ return marketDisplaySymbol(nonEmptyString(meta?.exchange), raw);
52
56
  if (data.isTransformation)
53
57
  return data.displayExpression ?? data.fullSymbol;
54
58
  if (data.isFred)
@@ -63,7 +63,6 @@
63
63
  * only (the directory read goes through the markets service); the hosted lanes
64
64
  * carry the numbers to the worker inside `wrunHostFill`.
65
65
  */
66
- import type { WrunMarketKind, WrunMarketQuoteIsUsd } from '@orangecharts/indicator-kit';
67
66
  import type { WrunVenueLegsResult } from '../../host-ports.types.js';
68
67
  import type { CmeExchangeDto } from '../../interfaces/cme-realtime.interface.js';
69
68
  import type { WrunIndicatorMetadata } from '../../interfaces/wrun-runtime.interface.js';
@@ -115,17 +114,7 @@ export interface WrunMarketDirectoryRow {
115
114
  coin?: unknown;
116
115
  underlyingSymbol?: unknown;
117
116
  }
118
- export interface CmeRootSpec {
119
- /** What the contract trades (a futures contract reports its underlying's kind). */
120
- kind: WrunMarketKind;
121
- pointValue: number;
122
- /** The quotation currency of the price the chart draws. */
123
- quote: WrunMarketQuoteIsUsd;
124
- /** The CME Group exchange the root lists on (its contracts and its options). */
125
- exchange: CmeExchangeDto;
126
- }
127
- /** Read-only outside this module: the paper venue reads each contract's point value from it. */
128
- export declare const CME_ROOT_SPECS: Readonly<Record<string, Readonly<CmeRootSpec>>>;
117
+ export { CME_ROOT_SPECS, type CmeRootSpec } from './wrun-cme-root-specs.util.js';
129
118
  /** The CME Group exchange a futures root lists on (`CME_ROOT_SPECS`), or undefined for a root off the table. */
130
119
  export declare function wrunCmeRootExchange(root: string): CmeExchangeDto | undefined;
131
120
  /**
@@ -214,8 +203,10 @@ export declare function wrunMarketFactsNeedDirectory(metadata: (Pick<WrunIndicat
214
203
  * (wrunVisibleByNeedsKind: it names some but not all of 0, 1 and 2): the sheet's lane demand on a
215
204
  * market (wrunSheetWithLaneDemand) then waits on the directory row, so a crypto venue's coin is
216
205
  * never read as unit 0 before the row answers. A list deciding on contracts alone (`[0, 1, 2]`,
217
- * `[3]`) needs only the point value and the zone and waits on nothing. */
218
- export declare function wrunLaneDemandNeedsDirectory(sheet: Partial<Pick<WrunIndicatorMetadata, 'inputSources'>> | undefined): boolean;
206
+ * `[3]`) needs only the point value and the zone and waits on nothing. A setting key (C-COINS item
207
+ * 1) reads its select's default where the market hides the select's row, so a select only the kind
208
+ * shows decides the demand too. */
209
+ export declare function wrunLaneDemandNeedsDirectory(sheet: Partial<Pick<WrunIndicatorMetadata, 'inputSources' | 'params'>> | undefined): boolean;
219
210
  /** wrunMarketFactsNeedDirectory over an overlay's declared inputs
220
211
  * (`settings.scriptInputs`), for a lane that holds no sheet (the cloud
221
212
  * payload): a row under a directory fact's generated name. */
@@ -235,16 +226,32 @@ export declare function wrunChartSizeUnit(market: WrunFactsMarket | undefined):
235
226
  * copy with its own `inputSources`, every other key shared.
236
227
  */
237
228
  export declare function wrunSheetWithLaneCurrencies<Sheet extends Pick<WrunIndicatorMetadata, 'inputSources'>>(sheet: Sheet, sizeUnit: number): Sheet;
229
+ /**
230
+ * The value a setting key reads on a market of size unit `sizeUnit` (contract C-COINS item 1), the run's side of the
231
+ * dialog's `wrunRowsOnMarket`, read only to decide whether a row shows or an input is asked: the run value of the
232
+ * select it names (`wrunParamValuesFromSettings` over `settings`), or its declared default where the select's own row
233
+ * is hidden on the market (its `visible_by` size-unit list alone: a select a key names is keyed by the size unit only),
234
+ * so a stock or CME chart that saved Coins decides as Dollars. init() and the paint still read the saved value.
235
+ * Undefined for a name the sheet declares no param under (the key then never hides).
236
+ */
237
+ export declare function wrunSheetSettingReader(sheet: Partial<Pick<WrunIndicatorMetadata, 'params'>>, settings: unknown, sizeUnit: number): (name: string) => number | undefined;
238
+ /** `sheet` with the inputs the sheet a session ran on its market left unasked (`ran`, the live context's) marked
239
+ * `undemanded` again, by name: a paint-only save swaps the session's sheet for the overlay's own sheet repainted, and
240
+ * without the marks the session's ticks would ask and fill a lane its run never asked (0.9.0's dollar tape on CME).
241
+ * The sheet itself when `ran` marks none it lacks. */
242
+ export declare function wrunSheetKeepingRunMarksOf<Sheet extends Pick<WrunIndicatorMetadata, 'inputSources'>>(sheet: Sheet, ran: Partial<Pick<WrunIndicatorMetadata, 'inputSources'>> | undefined): Sheet;
238
243
  /**
239
244
  * The sheet a run plans its lanes from on a market of size unit `sizeUnit`: every input source whose
240
245
  * `needed_by` (kit 0.72.0) leaves that size unit out, read by the predicate a row's `visible_by` is
241
246
  * (wrunRowVisibleHere), is marked `undemanded`, so no reader past this seam asks, subscribes, folds
242
247
  * or re-asks its lane (wrunSourceLane answers none for it), and the row builder reads the input's
243
- * fill on every bar (NaN, 0 under `missing: "zero"`) without ever holding the run. An input without
244
- * the word is needed on every market. The sheet itself when every input is needed here; else a copy
245
- * with its own `inputSources`.
248
+ * fill on every bar (NaN, 0 under `missing: "zero"`) without ever holding the run. A setting key
249
+ * beside the size unit (contract C-COINS item 1) must list the value its select reads under
250
+ * `settings` (wrunSheetSettingReader: its default without settings, or where the market hides the
251
+ * select's own row). An input without the word is needed on every market. The sheet itself when
252
+ * every input is needed here; else a copy with its own `inputSources`.
246
253
  */
247
- export declare function wrunSheetWithLaneDemand<Sheet extends Pick<WrunIndicatorMetadata, 'inputSources'>>(sheet: Sheet, sizeUnit: number): Sheet;
254
+ export declare function wrunSheetWithLaneDemand<Sheet extends Pick<WrunIndicatorMetadata, 'inputSources'>>(sheet: Sheet, sizeUnit: number, settings?: unknown): Sheet;
248
255
  /**
249
256
  * The sheet a run plans its lanes from on a chart of span `chartIntervalMs`, with every leg stream lane (`candles`,
250
257
  * `oi_candles`, `volume_profile_candles`: wrun-leg-stream-classes) its `chart_interval_below` gates off there (the kit's own `wrunLaneGatedOff`, read off the shared
@@ -297,10 +304,17 @@ export declare function wrunHostedLaneFills(market: WrunFactsMarket | undefined)
297
304
  point_value: number;
298
305
  zone: number;
299
306
  };
307
+ /** A lead contract not known yet is no failed read: the run head never asks it again on its own, and says which. */
308
+ export type WrunMarketReadFailure = 'read-failed' | 'contract-unknown';
309
+ /** A person's own rerun ends every rest of the market's failed reads, or the Retry a refusal offers would read
310
+ * nothing for a minute; a definite answer and a read in flight stay. */
311
+ export declare function forgetWrunMarketReadFailures(market: WrunFactsMarket | undefined): void;
312
+ /** A run head's mark: its own re-asks (wrun-overlay-run.util) reach only reads that failed after it. */
313
+ export declare function wrunMarketReadMark(): number;
300
314
  /**
301
315
  * Ask the directory for `market`'s row (om's read): once per market for the
302
316
  * session, a definite answer (the row, or not listed) kept; concurrent callers
303
- * share one search; a failure is asked again a minute later and meanwhile the
317
+ * share one search; a failure rests a minute (`warmMarketRead`) and meanwhile the
304
318
  * facts read as the chart knows them without the row. Never rejects. A venue
305
319
  * whose listings om never reads asks nothing.
306
320
  */
@@ -348,13 +362,13 @@ export declare function wrunMarketTradeUnitsOf(record: Record<string, unknown> |
348
362
  /**
349
363
  * Ask the instrument registry for `market`'s trade units: once per market for the session, a definite answer (the
350
364
  * record's units, or none) kept; concurrent callers share one read; a failed read, or a continuous chart whose lead is
351
- * not known yet, is asked again a minute later. A host whose metadata service reads no registry record
352
- * (`getSymbolMetadata` unbound) settles none. Never rejects. The read is fresh (`{ fresh: true }`, as the option units
353
- * read is): a cached record can predate the registry's point value fill.
365
+ * not known yet, rests a minute (`warmMarketRead`, ended by a person's rerun). A host whose metadata service reads no
366
+ * registry record (`getSymbolMetadata` unbound) settles none. Never rejects. The read is fresh (`{ fresh: true }`, as
367
+ * the option units read is): a cached record can predate the registry's point value fill.
354
368
  */
355
369
  export declare function warmWrunMarketTradeUnits(market: WrunFactsMarket | undefined): Promise<void>;
356
370
  /** The registry's units of `market` once a read settled them: the units, null for no record, undefined while the
357
- * registry can still answer (not asked yet, in flight, or a failed read that is retried). Synchronous. */
371
+ * registry can still answer (not asked yet, in flight, or a failed read that rests). Synchronous. */
358
372
  export declare function wrunMarketTradeUnitsNow(market: WrunFactsMarket | undefined): WrunMarketTradeUnits | null | undefined;
359
373
  /** Warm everything a market's dollar unit and stored unit read (C-DOLLAR): the directory row (a crypto market's quote)
360
374
  * and the instrument registry's units. Never rejects. */
@@ -362,6 +376,9 @@ export declare function warmWrunMarketDollarFacts(market: WrunFactsMarket | unde
362
376
  /** True when a read of `market`'s dollar unit now would wait on nothing (warmWrunMarketDollarFacts): the directory row
363
377
  * (wrunMarketFactsSettled) and the registry's units each answered, failed recently, or are never asked. */
364
378
  export declare function wrunMarketDollarFactsSettled(market: WrunFactsMarket | undefined): boolean;
379
+ /** The refusal words tell a failed read from a lead contract not known yet; `failedAfter` (a `wrunMarketReadMark`)
380
+ * keeps a run head from asking again a rest an earlier run left. */
381
+ export declare function wrunMarketDollarReadFailure(market: WrunFactsMarket | undefined, failedAfter?: number): WrunMarketReadFailure | undefined;
365
382
  /** What one price unit times one size unit is worth in US dollars on a market (`unit`), or why that cannot be proven:
366
383
  * `point-value` (no point value: ICE, PLATTS, an option contract, a CME contract the registry holds none for) or
367
384
  * `quote` (the market is quoted in something other than dollars, or its quote is not known), `transient` while a read
@@ -413,12 +430,13 @@ export type WrunMarketStoredUnitDollars = {
413
430
  export declare function wrunStoredUnitDollarsOfRows(frames: readonly unknown[]): number | undefined;
414
431
  /**
415
432
  * Read what one STORED unit of `market` is worth in dollars off the large-print writer's own rows: the market's newest
416
- * TRADE_LARGE print (`wrunStoredUnitDollarsOfRows`), through the host's series read on the K_TRADES history's own wire
417
- * (the chart's market, its wire venue as the K_TRADES worker spells it; TRADE_LARGE is a v2-only read, never the /v3
418
- * catalog, whose crypto rows carry no unit): one row, newest first, over the table's week. Once per market for the
419
- * session; concurrent callers share one read; a failed read is asked again a minute later. A host whose v2 service
420
- * reads no series (`sendSeriesOneShot` unbound) settles none. Never rejects. Only a run head with a raw floor to carry
421
- * asks it (wrun-market-size-defaults.util).
433
+ * TRADE_LARGE print (`wrunStoredUnitDollarsOfRows`, the newest row of every answer), through the host's series read on
434
+ * the K_TRADES history's own wire (the chart's market, its wire venue as the K_TRADES worker spells it; TRADE_LARGE is
435
+ * a v2-only read, never the /v3 catalog, whose crypto rows carry no unit): one row a side, newest first, over the
436
+ * table's week (`STORED_UNIT_SIDES`: one row of a read whose limit binds is no newest by time, and on a linear market
437
+ * an older print's ratio is an older price). Once per market for the session; concurrent callers share one read; a
438
+ * failed read rests a minute (`warmMarketRead`). A host whose v2 service reads no series (`sendSeriesOneShot` unbound)
439
+ * settles none. Never rejects. Only a run head with a raw floor to carry asks it (wrun-market-size-defaults.util).
422
440
  */
423
441
  export declare function warmWrunMarketStoredUnit(market: WrunFactsMarket | undefined): Promise<void>;
424
442
  /**