@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
@@ -1,4 +1,4 @@
1
- import type { FeedCombineRule, FeedHead, FeedWireBar, FeedWireRow } from '../../interfaces/feed.interface.js';
1
+ import type { FeedCombineRule, FeedHead, FeedValueKey, FeedWireBar, FeedWireRow } from '../../interfaces/feed.interface.js';
2
2
  /** C2: the intervals the relay regroups bars on, ascending. */
3
3
  export declare const FEED_BAR_INTERVALS_S: readonly [60, 300, 900, 1800, 3600, 14400, 86400, 604800];
4
4
  /** C4 poll: never more often than this. */
@@ -14,8 +14,7 @@ export type FeedRequest = {
14
14
  };
15
15
  /** C4: true when the feed draws its raw rows at their own timestamps on this chart interval. */
16
16
  export declare function feedDrawsRows(cadenceS: number, chartIntervalMs: number): boolean;
17
- /** What to ask the relay for on this chart interval: the rows, or bars on one of its intervals. */
18
- export declare function chooseFeedRequest(cadenceS: number, chartIntervalMs: number): FeedRequest;
17
+ export declare function chooseFeedRequest(cadenceS: number, chartIntervalMs: number, columnIndex?: number): FeedRequest;
19
18
  /** Two requests ask for the same thing (a regroup on the same interval, or the rows). */
20
19
  export declare function sameFeedRequest(a: FeedRequest | null, b: FeedRequest | null): boolean;
21
20
  /** C4 poll period: every `max(10, cadence_s / 2)` seconds (irregular feeds every 10 s). */
@@ -46,29 +45,17 @@ export interface FeedFetchWindowInput {
46
45
  cadenceS: number;
47
46
  chartIntervalMs: number;
48
47
  nowMs: number;
49
- /** The first mounted candle, ms; null while the candles have not landed. */
50
- mainFirstMs: number | null;
48
+ firstBarMs: number | null;
51
49
  /** The feed's newest row (head `last_ts`), seconds: always inside the window, so the legend has a value. */
52
50
  lastTs?: number | null;
53
51
  }
54
- /**
55
- * The window a full read covers, seconds: from one cadence (or one bar)
56
- * before the first candle, so the line enters from the left edge, to now.
57
- * The newest row is always inside, so a slow feed on a short chart still
58
- * shows its value.
59
- */
60
52
  export declare function feedFetchWindow(input: FeedFetchWindowInput): {
61
53
  fromSec: number;
62
54
  toSec: number;
63
55
  };
64
- /** Wire rows to chart rows `[ts_ms, value]` (the first value key; null and state cells read NaN), ascending, one per stamp. */
65
- export declare function feedRowsToSeries(rows: readonly FeedWireRow[]): number[][];
66
- /**
67
- * Wire bars to chart rows: `[ts_ms, value]` for a line, `[ts_ms, open, high, low, close]` for
68
- * candles. A line's value is the bar's `combined` (position 6, P3 C7: the value's rule over the
69
- * bucket, a sum for a volume) when the bar carries one, else its close (position 4).
70
- */
71
- export declare function feedBarsToSeries(bars: readonly FeedWireBar[], plot: FeedPlot): number[][];
56
+ export declare function feedColumnIndex(values: readonly FeedValueKey[] | null | undefined, column: string): number;
57
+ export declare function feedRowsToSeries(rows: readonly FeedWireRow[], columnIndex?: number): number[][];
58
+ export declare function feedBarsToSeries(bars: readonly FeedWireBar[], plot: FeedPlot, columnIndex?: number): number[][];
72
59
  /** Union by stamp, ascending; an incoming row replaces a held row at the same stamp. */
73
60
  export declare function mergeFeedSeries(held: readonly number[][], incoming: readonly number[][]): number[][];
74
61
  /** The newest stamp of a series, seconds; null when empty. */
@@ -76,7 +63,6 @@ export declare function feedSeriesLastTsSec(series: readonly number[][]): number
76
63
  export interface FeedReadingInput {
77
64
  /** The reading's stamp, seconds. */
78
65
  ts: number;
79
- /** Its first value (the plotted key); a null reading breaks a line and leaves bars as they are. */
80
66
  value: number | string | null;
81
67
  request: FeedRequest;
82
68
  plot: FeedPlot;
@@ -45,9 +45,8 @@ export function feedDrawsRows(cadenceS, chartIntervalMs) {
45
45
  return true;
46
46
  return chartIntervalMs <= cadenceS * 1_000;
47
47
  }
48
- /** What to ask the relay for on this chart interval: the rows, or bars on one of its intervals. */
49
- export function chooseFeedRequest(cadenceS, chartIntervalMs) {
50
- if (feedDrawsRows(cadenceS, chartIntervalMs))
48
+ export function chooseFeedRequest(cadenceS, chartIntervalMs, columnIndex = 0) {
49
+ if (columnIndex !== 0 || feedDrawsRows(cadenceS, chartIntervalMs))
51
50
  return { kind: 'rows' };
52
51
  let intervalS = 0;
53
52
  for (const candidate of FEED_BAR_INTERVALS_S) {
@@ -130,16 +129,10 @@ export function feedChartIntervalLabel(chartIntervalMs) {
130
129
  return label;
131
130
  return feedIntervalLabel(chartIntervalMs / 1_000);
132
131
  }
133
- /**
134
- * The window a full read covers, seconds: from one cadence (or one bar)
135
- * before the first candle, so the line enters from the left edge, to now.
136
- * The newest row is always inside, so a slow feed on a short chart still
137
- * shows its value.
138
- */
139
132
  export function feedFetchWindow(input) {
140
133
  const nowSec = Math.ceil(input.nowMs / 1_000);
141
- const firstSec = input.mainFirstMs !== null && Number.isFinite(input.mainFirstMs)
142
- ? Math.floor(input.mainFirstMs / 1_000)
134
+ const firstSec = input.firstBarMs !== null && Number.isFinite(input.firstBarMs)
135
+ ? Math.floor(input.firstBarMs / 1_000)
143
136
  : Math.floor((input.nowMs - FEED_DEFAULT_LOOKBACK_BARS * Math.max(1, input.chartIntervalMs)) / 1_000);
144
137
  const reachS = input.request.kind === 'bars' ? input.request.interval_s : Math.max(0, input.cadenceS);
145
138
  let fromSec = firstSec - reachS;
@@ -151,24 +144,22 @@ export function feedFetchWindow(input) {
151
144
  return { fromSec: Math.max(0, fromSec), toSec: nowSec };
152
145
  }
153
146
  const cell = (value) => (typeof value === 'number' && Number.isFinite(value) ? value : Number.NaN);
154
- /** Wire rows to chart rows `[ts_ms, value]` (the first value key; null and state cells read NaN), ascending, one per stamp. */
155
- export function feedRowsToSeries(rows) {
147
+ export function feedColumnIndex(values, column) {
148
+ if (!column)
149
+ return 0;
150
+ return (values ?? []).findIndex((value) => value.key === column);
151
+ }
152
+ export function feedRowsToSeries(rows, columnIndex = 0) {
156
153
  const series = rows
157
154
  .filter((row) => Array.isArray(row) && typeof row[0] === 'number' && Number.isFinite(row[0]))
158
- .map((row) => [row[0] * 1_000, cell(row[1])]);
155
+ .map((row) => [row[0] * 1_000, columnIndex >= 0 ? cell(row[1 + columnIndex]) : Number.NaN]);
159
156
  return dedupeAscending(series);
160
157
  }
161
- /**
162
- * Wire bars to chart rows: `[ts_ms, value]` for a line, `[ts_ms, open, high, low, close]` for
163
- * candles. A line's value is the bar's `combined` (position 6, P3 C7: the value's rule over the
164
- * bucket, a sum for a volume) when the bar carries one, else its close (position 4).
165
- */
166
- export function feedBarsToSeries(bars, plot) {
158
+ export function feedBarsToSeries(bars, plot, columnIndex = 0) {
167
159
  const series = bars
168
160
  .filter((bar) => Array.isArray(bar) && typeof bar[0] === 'number' && Number.isFinite(bar[0]))
169
161
  .map((bar) => {
170
- // A state feed's bar is [bucket, last_state, count]: no number to draw.
171
- const isStateBar = typeof bar[1] === 'string';
162
+ const isStateBar = typeof bar[1] === 'string' || columnIndex !== 0;
172
163
  const open = isStateBar ? Number.NaN : cell(bar[1]);
173
164
  const high = isStateBar ? Number.NaN : cell(bar[2]);
174
165
  const low = isStateBar ? Number.NaN : cell(bar[3]);
@@ -11,11 +11,16 @@
11
11
  * flight. 'await' coalesces onto it, 'skip' drops this request (the
12
12
  * wave/recovery loop owns covering the span), 'ignore' dispatches anyway.
13
13
  * - onRecentCompletion: what to do when an identical key completed within
14
- * the fetchCache completion window. 'skip' drops, 'refresh' fetches anyway
15
- * (heals must re-request), 'ignore' means the lane never consults the
16
- * window at all.
14
+ * the fetchCache completion window. 'skip' drops, 'skip-fresh' drops only
15
+ * while that completion is younger than the request registry's fresh bound
16
+ * (the interval's saved-copy too-old bound) and fetches after it, 'refresh'
17
+ * fetches anyway (heals must re-request), 'ignore' means the lane never
18
+ * consults the window at all.
17
19
  * - registersPending: whether the dispatch marks a pending ledger entry
18
20
  * (owner-token guarded) that twins can observe.
21
+ * - onDeliveredAnswer: what to do when the overlay still holds the delivered
22
+ * answer to this ask's exact data key (DELIVERED_ANSWER_SKIP below). 'skip'
23
+ * keeps the ask home, 'send' always dispatches.
19
24
  *
20
25
  * The legally-asked-twice cases are deliberate: main polling + main gap
21
26
  * recovery can fetch overlapping windows on the same tick, and post-wake
@@ -55,8 +60,15 @@
55
60
  * not the fetchCache. isReplayBuffer outranks isDomReplayWindow when both are
56
61
  * stamped (the buffer lane's own collector wins).
57
62
  *
58
- * Two suppression classes live OUTSIDE this flag table because they depend on
59
- * delivered data, not request flags:
63
+ * Four suppression classes judge delivered data or another request, not
64
+ * request flags, at the guard site (the last three live wholly outside this
65
+ * table):
66
+ * - DELIVERED_ANSWER_SKIP (the web ledger, fetch-cache.util.ts): an ask whose
67
+ * class says onDeliveredAnswer 'skip' (a history page, IND_LAZY_PAGE) stays
68
+ * home while the overlay holds the answer to its exact data key (the chart
69
+ * identity plus sharedRequestKeyFor of the payload, never its window) and
70
+ * still mounts the rows that answer's commit left. The verb is this table's;
71
+ * the record of delivered answers is the web ledger's.
60
72
  * - FIXED_WINDOW_COVERED_SKIP (fixed-window-fetch-skip.util.ts): fixed-window
61
73
  * single-request overlays replace the wave span with a settings-derived
62
74
  * range at payload build, so ledger keys never match their repeats; the
@@ -67,6 +79,10 @@
67
79
  * past orderflow retention) arms a 60s identity+range memory; heal-class
68
80
  * re-asks of the same window skip until the TTL expires instead of looping
69
81
  * the identical empty fetch every wave round.
82
+ * - REQUEST_IDENTICAL_KEPT (request-identity-candidate.util.ts): a replacing
83
+ * site's re-ask that would send the byte-identical request a live owner of
84
+ * the overlay already sent keeps that owner instead (ring
85
+ * indicator-reask-identical-kept); it never reaches this table's sites.
70
86
  */
71
87
  export declare function registerDataLoadHealRegisterFlagReader(reader: (() => boolean) | null): void;
72
88
  export declare function isDataLoadHealRegisterEnabled(): boolean;
@@ -88,12 +104,14 @@ export interface FetchDedupeIntent {
88
104
  /** A split-family child whose span IS the parent's registered pre-split span (the owner span). */
89
105
  isSplitFamilyOwnerChild?: boolean;
90
106
  }
91
- export type FetchDedupePolicyName = 'MAIN_COALESCE' | 'MAIN_POLL_BYPASS' | 'MAIN_HISTORICAL_BYPASS' | 'MAIN_RETRY_BYPASS' | 'IND_SKIP_DUPLICATE' | 'IND_REPAIR_REFRESH' | 'IND_POLL_BYPASS' | 'HEATMAP_CACHE_ONLY_BYPASS' | 'IND_RETRY_BYPASS' | 'IND_SPLIT_FAMILY_OWNER_CHILD' | 'IND_REPLAY_LANE_BYPASS' | 'IND_SEAM_TOPUP' | 'KSCRIPT_SOURCE_DEDUPE' | 'DOM_REPLAY_WINDOW' | 'TAPE_SVP_SEED' | 'FOOTPRINT_PANEL';
107
+ export type FetchDedupePolicyName = 'MAIN_COALESCE' | 'MAIN_POLL_BYPASS' | 'MAIN_HISTORICAL_BYPASS' | 'MAIN_RETRY_BYPASS' | 'IND_SKIP_DUPLICATE' | 'IND_REPAIR_REFRESH' | 'IND_LAZY_PAGE' | 'IND_POLL_BYPASS' | 'HEATMAP_CACHE_ONLY_BYPASS' | 'IND_RETRY_BYPASS' | 'IND_SPLIT_FAMILY_OWNER_CHILD' | 'IND_REPLAY_LANE_BYPASS' | 'IND_SEAM_TOPUP' | 'KSCRIPT_SOURCE_DEDUPE' | 'DOM_REPLAY_WINDOW' | 'TAPE_SVP_SEED' | 'FOOTPRINT_PANEL';
92
108
  export interface FetchDedupePolicy {
93
109
  name: FetchDedupePolicyName;
94
110
  onPendingTwin: 'await' | 'skip' | 'ignore';
95
- onRecentCompletion: 'skip' | 'refresh' | 'ignore';
111
+ onRecentCompletion: 'skip' | 'skip-fresh' | 'refresh' | 'ignore';
96
112
  registersPending: boolean;
113
+ /** A history page asks for a window, never for fresher data: only that class stays home on an answer the overlay holds. */
114
+ onDeliveredAnswer: 'skip' | 'send';
97
115
  why: string;
98
116
  }
99
117
  /** Branch precedence mirrors the historical guard-site code order exactly. */
@@ -103,6 +121,8 @@ export declare const MAIN_PLAN_FLAG_KEY = "data-load-main-plan";
103
121
  export declare function isMainPlanEnabled(readExplicitlyOff: (key: string) => boolean): boolean;
104
122
  export declare const RECEIPT_SETTLE_FLAG_KEY = "data-load-receipt-settle";
105
123
  export declare function isReceiptSettleEnabled(readExplicitlyOff: (key: string) => boolean): boolean;
124
+ export declare const ENGINE_QUEUE_HOLD_FLAG_KEY = "data-load-engine-queue-hold";
125
+ export declare function isEngineQueueHoldEnabled(readExplicitlyOff: (key: string) => boolean): boolean;
106
126
  export declare function isShareableFetchDedupePolicy(policy: FetchDedupePolicyName | FetchDedupePolicy): boolean;
107
127
  export declare const KICK_BASE_HARD_KILL = false;
108
128
  export declare const KICK_BASE_FLAG_KEY = "data-load-kick-base";
@@ -11,11 +11,16 @@
11
11
  * flight. 'await' coalesces onto it, 'skip' drops this request (the
12
12
  * wave/recovery loop owns covering the span), 'ignore' dispatches anyway.
13
13
  * - onRecentCompletion: what to do when an identical key completed within
14
- * the fetchCache completion window. 'skip' drops, 'refresh' fetches anyway
15
- * (heals must re-request), 'ignore' means the lane never consults the
16
- * window at all.
14
+ * the fetchCache completion window. 'skip' drops, 'skip-fresh' drops only
15
+ * while that completion is younger than the request registry's fresh bound
16
+ * (the interval's saved-copy too-old bound) and fetches after it, 'refresh'
17
+ * fetches anyway (heals must re-request), 'ignore' means the lane never
18
+ * consults the window at all.
17
19
  * - registersPending: whether the dispatch marks a pending ledger entry
18
20
  * (owner-token guarded) that twins can observe.
21
+ * - onDeliveredAnswer: what to do when the overlay still holds the delivered
22
+ * answer to this ask's exact data key (DELIVERED_ANSWER_SKIP below). 'skip'
23
+ * keeps the ask home, 'send' always dispatches.
19
24
  *
20
25
  * The legally-asked-twice cases are deliberate: main polling + main gap
21
26
  * recovery can fetch overlapping windows on the same tick, and post-wake
@@ -55,8 +60,15 @@
55
60
  * not the fetchCache. isReplayBuffer outranks isDomReplayWindow when both are
56
61
  * stamped (the buffer lane's own collector wins).
57
62
  *
58
- * Two suppression classes live OUTSIDE this flag table because they depend on
59
- * delivered data, not request flags:
63
+ * Four suppression classes judge delivered data or another request, not
64
+ * request flags, at the guard site (the last three live wholly outside this
65
+ * table):
66
+ * - DELIVERED_ANSWER_SKIP (the web ledger, fetch-cache.util.ts): an ask whose
67
+ * class says onDeliveredAnswer 'skip' (a history page, IND_LAZY_PAGE) stays
68
+ * home while the overlay holds the answer to its exact data key (the chart
69
+ * identity plus sharedRequestKeyFor of the payload, never its window) and
70
+ * still mounts the rows that answer's commit left. The verb is this table's;
71
+ * the record of delivered answers is the web ledger's.
60
72
  * - FIXED_WINDOW_COVERED_SKIP (fixed-window-fetch-skip.util.ts): fixed-window
61
73
  * single-request overlays replace the wave span with a settings-derived
62
74
  * range at payload build, so ledger keys never match their repeats; the
@@ -67,6 +79,10 @@
67
79
  * past orderflow retention) arms a 60s identity+range memory; heal-class
68
80
  * re-asks of the same window skip until the TTL expires instead of looping
69
81
  * the identical empty fetch every wave round.
82
+ * - REQUEST_IDENTICAL_KEPT (request-identity-candidate.util.ts): a replacing
83
+ * site's re-ask that would send the byte-identical request a live owner of
84
+ * the overlay already sent keeps that owner instead (ring
85
+ * indicator-reask-identical-kept); it never reaches this table's sites.
70
86
  */
71
87
  /**
72
88
  * Kill switch for data-loading phase S6 (background lanes, poll cadence
@@ -104,6 +120,7 @@ const POLICIES = {
104
120
  onPendingTwin: 'await',
105
121
  onRecentCompletion: 'ignore',
106
122
  registersPending: true,
123
+ onDeliveredAnswer: 'send',
107
124
  why: 'An identical in-flight twin paints this same chart slot; await it. Recent completions are ' +
108
125
  'deliberately NOT suppressed for main data: cache-aligned requests are bucket-canonical, so ' +
109
126
  'legitimate re-fetches carry identical keys by design and skipping them strands stale paints.',
@@ -113,6 +130,7 @@ const POLICIES = {
113
130
  onPendingTwin: 'ignore',
114
131
  onRecentCompletion: 'ignore',
115
132
  registersPending: false,
133
+ onDeliveredAnswer: 'send',
116
134
  why: 'Polling re-issues an identical (from=0, period) key every tick; it once marked itself pending ' +
117
135
  'without clearing, silently suppressing every poll after the first.',
118
136
  },
@@ -121,6 +139,7 @@ const POLICIES = {
121
139
  onPendingTwin: 'ignore',
122
140
  onRecentCompletion: 'ignore',
123
141
  registersPending: false,
142
+ onDeliveredAnswer: 'send',
124
143
  why: 'Historical-mode fetches replace the dataset under explicit identity stamps; nothing may absorb them.',
125
144
  },
126
145
  MAIN_RETRY_BYPASS: {
@@ -128,6 +147,7 @@ const POLICIES = {
128
147
  onPendingTwin: 'ignore',
129
148
  onRecentCompletion: 'ignore',
130
149
  registersPending: false,
150
+ onDeliveredAnswer: 'send',
131
151
  why: 'Blank-boot retries and hedges exist to dispatch a REAL transport request past a possibly wedged twin.',
132
152
  },
133
153
  IND_SKIP_DUPLICATE: {
@@ -135,6 +155,7 @@ const POLICIES = {
135
155
  onPendingTwin: 'skip',
136
156
  onRecentCompletion: 'skip',
137
157
  registersPending: true,
158
+ onDeliveredAnswer: 'send',
138
159
  why: 'Indicator policy differs from main: in-flight duplicates are skipped, not awaited, because the ' +
139
160
  'lazy wave / gap-recovery loop owns covering the span; a recent completion means the span was just served. ' +
140
161
  'CMETAIL adjudication 2026-09-02: that ownership assumption fails for types outside those healers, so a ' +
@@ -146,17 +167,37 @@ const POLICIES = {
146
167
  onPendingTwin: 'skip',
147
168
  onRecentCompletion: 'refresh',
148
169
  registersPending: true,
149
- why: 'Lazy-load and gap-recovery requests may re-request a recently completed range, but never bypass the ' +
150
- 'in-flight duplicate guard. A receipt is a claim, never proof of rows: a gap heal of a CLOSED window ' +
151
- 'stays home on its receipt only where every 50-bar piece holds a row on the pane or no main bar ' +
152
- '(COVERED_RECENT_COMPLETION_SKIP, the stamp-proof round 2026-10-08), and every other heal refreshes ' +
153
- 'past it. A lazy wave re-ask skips only the whole-span repeat (receipt plus a spanning row set).',
170
+ onDeliveredAnswer: 'send',
171
+ why: 'Gap-recovery, heal and repair requests (isGapRecovery) may re-request a recently completed range, but ' +
172
+ 'never bypass the in-flight duplicate guard. A receipt is a claim, never proof of rows: a gap heal of a ' +
173
+ 'CLOSED window stays home on its receipt only where every 50-bar piece holds a row on the pane or no main ' +
174
+ 'bar (COVERED_RECENT_COMPLETION_SKIP, the stamp-proof round 2026-10-08), and every other heal refreshes ' +
175
+ 'past it. Lazy pages (isLazyload alone) left this class for IND_LAZY_PAGE (2026-11-01).',
176
+ },
177
+ IND_LAZY_PAGE: {
178
+ name: 'IND_LAZY_PAGE',
179
+ onPendingTwin: 'skip',
180
+ onRecentCompletion: 'skip-fresh',
181
+ registersPending: true,
182
+ onDeliveredAnswer: 'skip',
183
+ why: 'A lazy page (isLazyload without isGapRecovery: the lazy wave, the row coverage keeper, the add-time ' +
184
+ 'fills) whose ALIGNED window a completion younger than the request registry fresh bound covers whole is ' +
185
+ 'served by that receipt and does not leave (adjudicated 2026-11-01, WRUN-PANBACK-2: the TPO Daily boot ' +
186
+ 'pair, a lazy page 0.36 s after its aligned primary completed, went out twice). The bound is the one the ' +
187
+ 'registry reads to call a repeat a duplicate rather than a refresh (cachedPaintMaxWriteAgeMs of the ' +
188
+ 'interval); a venue with none keeps the completion window. An older receipt refreshes as before, where a ' +
189
+ 'whole-span repeat still stays home on the receipt plus a spanning row set (COVERED_RECENT_COMPLETION_SKIP); ' +
190
+ 'an in-flight twin is skipped as before. Recovery, heal and repair asks keep IND_REPAIR_REFRESH. A page whose ' +
191
+ 'exact data key the overlay still holds stays home whatever window it was asked for and however old the ' +
192
+ 'receipt (onDeliveredAnswer, DELIVERED_ANSWER_SKIP, adjudicated 2026-11-02: the GEX curve payload carries ' +
193
+ 'no window, so every page carried a new ledger key while its wire key never moved).',
154
194
  },
155
195
  IND_POLL_BYPASS: {
156
196
  name: 'IND_POLL_BYPASS',
157
197
  onPendingTwin: 'ignore',
158
198
  onRecentCompletion: 'ignore',
159
199
  registersPending: false,
200
+ onDeliveredAnswer: 'send',
160
201
  why: 'Indicator polling sizes its own steady-state requests each tick; the ledger never gates it.',
161
202
  },
162
203
  HEATMAP_CACHE_ONLY_BYPASS: {
@@ -164,6 +205,7 @@ const POLICIES = {
164
205
  onPendingTwin: 'ignore',
165
206
  onRecentCompletion: 'ignore',
166
207
  registersPending: false,
208
+ onDeliveredAnswer: 'send',
167
209
  why: 'Cache-only heatmap reads serve from the local chunk cache; transport dedupe must not suppress them.',
168
210
  },
169
211
  IND_RETRY_BYPASS: {
@@ -171,6 +213,7 @@ const POLICIES = {
171
213
  onPendingTwin: 'ignore',
172
214
  onRecentCompletion: 'ignore',
173
215
  registersPending: false,
216
+ onDeliveredAnswer: 'send',
174
217
  why: 'The transport retry chain re-dispatches its own request; its twin IS the entry being retried.',
175
218
  },
176
219
  IND_SPLIT_FAMILY_OWNER_CHILD: {
@@ -178,6 +221,7 @@ const POLICIES = {
178
221
  onPendingTwin: 'ignore',
179
222
  onRecentCompletion: 'ignore',
180
223
  registersPending: false,
224
+ onDeliveredAnswer: 'send',
181
225
  why: 'A split-family child whose span equals the pre-split span its parent registered as pending (the ' +
182
226
  "planner's settled-tail cut leaves the newest unsettled piece as the parent's own ask). The pending " +
183
227
  'twin it sees IS its own family: skipping it left the span unserved and attached a re-arm receipt to ' +
@@ -192,6 +236,7 @@ const POLICIES = {
192
236
  onPendingTwin: 'ignore',
193
237
  onRecentCompletion: 'ignore',
194
238
  registersPending: false,
239
+ onDeliveredAnswer: 'send',
195
240
  why: 'Replay lane fetches deliver through their own collector (onReplayRows) and never paint the chart, ' +
196
241
  "so a ledger twin's completion can NEVER reach this consumer: a settings re-lane re-requests the " +
197
242
  'same deterministic chunk windows the replaced lane generation just fetched, and suppressing it ' +
@@ -204,6 +249,7 @@ const POLICIES = {
204
249
  onPendingTwin: 'skip',
205
250
  onRecentCompletion: 'refresh',
206
251
  registersPending: true,
252
+ onDeliveredAnswer: 'send',
207
253
  why: 'The one-shot 1s book seam top-up (heatmap-seam-topup.util.ts, adjudicated 2026-08-10) re-asks the ' +
208
254
  'structurally unowned [clipFloor .. first live apply] window once it ages past the 3-minute replay ' +
209
255
  'cap. Same verbs as IND_REPAIR_REFRESH (a heal must actually refresh, never bypass the in-flight ' +
@@ -216,6 +262,7 @@ const POLICIES = {
216
262
  onPendingTwin: 'skip',
217
263
  onRecentCompletion: 'skip',
218
264
  registersPending: true,
265
+ onDeliveredAnswer: 'send',
219
266
  why: 'Engine source fetches single-flight per source (kScriptSourceFetchInFlight) and consult the shared ' +
220
267
  'ledger. P6 key fix landed: entries are keyed by real chartIndex and completion keys carry the same ' +
221
268
  '(type, sourceName) as start keys, resolved on every terminal path; empty successful replies clear ' +
@@ -227,6 +274,7 @@ const POLICIES = {
227
274
  onPendingTwin: 'ignore',
228
275
  onRecentCompletion: 'ignore',
229
276
  registersPending: false,
277
+ onDeliveredAnswer: 'send',
230
278
  why: 'Replay-DOM window fetches (replayDomDriver.ts, adjudicated with Spec 2B/C) deliver through the ' +
231
279
  "driver's own collector into the pane worker's replay rings and never paint an overlay, so a ledger " +
232
280
  "twin's completion can never reach this consumer; like the replay buffer lane they neither consult " +
@@ -241,6 +289,7 @@ const POLICIES = {
241
289
  onPendingTwin: 'ignore',
242
290
  onRecentCompletion: 'ignore',
243
291
  registersPending: false,
292
+ onDeliveredAnswer: 'send',
244
293
  why: 'Tape session-SVP seed fetches (tape-svp-seed.service.ts, adjudicated with DOM new-viz F5) stream ' +
245
294
  '[sessionStart, enterCutoff) K_TRADES rows into a STAGING accumulator that merges atomically into ' +
246
295
  'the tape session stats on complete success and is discarded whole on any failure; they never paint ' +
@@ -257,6 +306,7 @@ const POLICIES = {
257
306
  onPendingTwin: 'ignore',
258
307
  onRecentCompletion: 'ignore',
259
308
  registersPending: false,
309
+ onDeliveredAnswer: 'send',
260
310
  why: 'Footprint panel own-lane fetches (footprint-panel-lane.service.ts, FOOTPRINT-PANEL) ask VOLUME_FOOTPRINT or ' +
261
311
  'AGGREGATED_VOLUME_FOOTPRINT snapshot windows under a fresh synthetic ovId per request and deliver into the ' +
262
312
  "panel lane's own store, never an overlay, so like the tape seed they neither consult nor write the " +
@@ -300,8 +350,10 @@ export function resolveFetchDedupePolicy(intent) {
300
350
  return POLICIES.IND_SPLIT_FAMILY_OWNER_CHILD;
301
351
  if (intent.isHeatmapSeamTopUp)
302
352
  return POLICIES.IND_SEAM_TOPUP;
303
- if (intent.isLazyload || intent.isGapRecovery)
353
+ if (intent.isGapRecovery)
304
354
  return POLICIES.IND_REPAIR_REFRESH;
355
+ if (intent.isLazyload)
356
+ return POLICIES.IND_LAZY_PAGE;
305
357
  return POLICIES.IND_SKIP_DUPLICATE;
306
358
  }
307
359
  export const FETCH_DEDUPE_POLICIES = Object.values(POLICIES);
@@ -354,6 +406,29 @@ export function isReceiptSettleEnabled(readExplicitlyOff) {
354
406
  return true;
355
407
  }
356
408
  }
409
+ // ── Kill switch: heals hold while the engine still holds a queued commit (HEAL-QUEUED-COMMIT, 2026-11-05) ──
410
+ //
411
+ // Same shape as the switches above: read ONCE per recovery poll cycle and once
412
+ // per wave-settled repair scan, carried as a boolean inside that unit of work.
413
+ // ON (default): the recovery poller and the repair scan hold while
414
+ // `engineQueuedOverlayWrites` reports a queued overlay write for the chart
415
+ // (bounded by the poller's busy budget and the scan's hold cap), and the poller
416
+ // vouches a range against the rows the engine holds before it dispatches it
417
+ // (a range the mounted rows cover is pruned, never fetched). OFF: today's
418
+ // dispatch, the stale-rows re-buy of the bucket a pan-time commit just landed.
419
+ const ENGINE_QUEUE_HOLD_HARD_KILL = false;
420
+ export const ENGINE_QUEUE_HOLD_FLAG_KEY = 'data-load-engine-queue-hold';
421
+ export function isEngineQueueHoldEnabled(readExplicitlyOff) {
422
+ if (ENGINE_QUEUE_HOLD_HARD_KILL)
423
+ return false;
424
+ try {
425
+ return !readExplicitlyOff(ENGINE_QUEUE_HOLD_FLAG_KEY);
426
+ }
427
+ catch {
428
+ // An unloaded or unavailable store reads ON (feature-gating.md, default-ON flags).
429
+ return true;
430
+ }
431
+ }
357
432
  /**
358
433
  * Cross-chart sharing eligibility (data-loading plan S11a, Codex C7), derived
359
434
  * from the RESOLVED policy and carried BESIDE the canonical payload to the
@@ -42,14 +42,30 @@ export declare function decimalPlaces(value: number): number;
42
42
  export declare function centeredFootprintBand(gridPrice: number, bandHeight: number, tickSize?: number | null): [number, number];
43
43
  /** Candle rows sampled for the tick inference (main rawData: [ts, o, h, l, c, ...]). */
44
44
  export declare const PRICE_TICK_INFERENCE_ROWS = 2000;
45
+ /**
46
+ * Share of a sample's distinct prices that may sit on a finer decimal place
47
+ * than the lattice the inference returns. A lattice puts at least half of its
48
+ * prices on its own decimal place (the odd multiples of 0.25, 0.05 and 1/64
49
+ * all end there), while prints off an exchange's lattice are rare: on a US
50
+ * stock tape the sub-penny and six-decimal executions (price improvement,
51
+ * midpoint and TRF prints) are a few per thousand. A GCD read over such
52
+ * prints is the decimal resolution of the odd print, not a tick, and it
53
+ * shrank as the sample grew: AAPL on the NASDAQ tape read 0.000004 at 252
54
+ * bars and 0.000001 at 500 (2026-11-05), the anchor keyed on it never
55
+ * settled, and every footprint board the cache held under one value was lost
56
+ * under the next. Prints finer than the lattice's place are set aside before
57
+ * the GCD; a thin sample (under 20 distinct prices) sets nothing aside.
58
+ */
59
+ export declare const PRICE_TICK_OUTLIER_SHARE = 0.05;
45
60
  /**
46
61
  * The exchange price tick as the chart's own candles reveal it: the greatest
47
62
  * common divisor of every OHLC value's distance to the first, computed in
48
- * whole units of the sample's decimal places and returned as a clean decimal.
49
- * No metadata carries a per-symbol tick, and the profile block catalog is not
50
- * one (Binance BTCUSDT: block 3.0, tick 0.1). Every traded price is a tick
51
- * multiple, so the estimate can only ever be the tick or a multiple of it (a
52
- * thin sample), never finer.
63
+ * whole units of the lattice's decimal place (`latticeDecimalPlaces`: the
64
+ * rare prints finer than it, PRICE_TICK_OUTLIER_SHARE, are set aside) and
65
+ * returned as a clean decimal. No metadata carries a per-symbol tick, and the
66
+ * profile block catalog is not one (Binance BTCUSDT: block 3.0, tick 0.1).
67
+ * Every traded price is a tick multiple, so the estimate can only ever be the
68
+ * tick or a multiple of it (a thin sample), never finer.
53
69
  *
54
70
  * Integer arithmetic, not the smallest float gap: at 85,000 a 0.01 gap
55
71
  * subtracts to 0.0099999999947 and snapping it to 9 significant digits kept
@@ -115,19 +115,53 @@ const PRICE_TICK_SIGNIFICANT_DIGITS = 12;
115
115
  * series with no lattice at all (split-adjusted 250 / 3), not a tick.
116
116
  */
117
117
  const PRICE_TICK_MIN_RELATIVE = 1e-10;
118
+ /**
119
+ * Share of a sample's distinct prices that may sit on a finer decimal place
120
+ * than the lattice the inference returns. A lattice puts at least half of its
121
+ * prices on its own decimal place (the odd multiples of 0.25, 0.05 and 1/64
122
+ * all end there), while prints off an exchange's lattice are rare: on a US
123
+ * stock tape the sub-penny and six-decimal executions (price improvement,
124
+ * midpoint and TRF prints) are a few per thousand. A GCD read over such
125
+ * prints is the decimal resolution of the odd print, not a tick, and it
126
+ * shrank as the sample grew: AAPL on the NASDAQ tape read 0.000004 at 252
127
+ * bars and 0.000001 at 500 (2026-11-05), the anchor keyed on it never
128
+ * settled, and every footprint board the cache held under one value was lost
129
+ * under the next. Prints finer than the lattice's place are set aside before
130
+ * the GCD; a thin sample (under 20 distinct prices) sets nothing aside.
131
+ */
132
+ export const PRICE_TICK_OUTLIER_SHARE = 0.05;
118
133
  function greatestCommonDivisor(a, b) {
119
134
  while (b)
120
135
  [a, b] = [b, a % b];
121
136
  return a;
122
137
  }
138
+ /**
139
+ * The decimal place the sample's lattice sits on: the coarsest place that
140
+ * leaves no more than PRICE_TICK_OUTLIER_SHARE of the distinct prices on a
141
+ * finer one. Null when even PRICE_TICK_MAX_DECIMALS leaves more (the series
142
+ * has no decimal lattice: AMM-priced tokens, split-adjusted stocks).
143
+ */
144
+ function latticeDecimalPlaces(placesByPrice) {
145
+ const finerThan = new Array(PRICE_TICK_MAX_DECIMALS + 1).fill(0);
146
+ for (const places of placesByPrice.values()) {
147
+ for (let k = 0; k < places && k <= PRICE_TICK_MAX_DECIMALS; k++)
148
+ finerThan[k] += 1;
149
+ }
150
+ const allowed = Math.floor(placesByPrice.size * PRICE_TICK_OUTLIER_SHARE);
151
+ for (let k = 0; k <= PRICE_TICK_MAX_DECIMALS; k++)
152
+ if (finerThan[k] <= allowed)
153
+ return k;
154
+ return null;
155
+ }
123
156
  /**
124
157
  * The exchange price tick as the chart's own candles reveal it: the greatest
125
158
  * common divisor of every OHLC value's distance to the first, computed in
126
- * whole units of the sample's decimal places and returned as a clean decimal.
127
- * No metadata carries a per-symbol tick, and the profile block catalog is not
128
- * one (Binance BTCUSDT: block 3.0, tick 0.1). Every traded price is a tick
129
- * multiple, so the estimate can only ever be the tick or a multiple of it (a
130
- * thin sample), never finer.
159
+ * whole units of the lattice's decimal place (`latticeDecimalPlaces`: the
160
+ * rare prints finer than it, PRICE_TICK_OUTLIER_SHARE, are set aside) and
161
+ * returned as a clean decimal. No metadata carries a per-symbol tick, and the
162
+ * profile block catalog is not one (Binance BTCUSDT: block 3.0, tick 0.1).
163
+ * Every traded price is a tick multiple, so the estimate can only ever be the
164
+ * tick or a multiple of it (a thin sample), never finer.
131
165
  *
132
166
  * Integer arithmetic, not the smallest float gap: at 85,000 a 0.01 gap
133
167
  * subtracts to 0.0099999999947 and snapping it to 9 significant digits kept
@@ -142,8 +176,8 @@ function greatestCommonDivisor(a, b) {
142
176
  export function inferPriceTickFromRows(rows, maxRows = PRICE_TICK_INFERENCE_ROWS, minRows = PRICE_TICK_INFERENCE_MIN_ROWS) {
143
177
  if (!rows || !(rows.length >= Math.max(1, minRows)))
144
178
  return null;
145
- const prices = [];
146
- let decimals = 0;
179
+ // Distinct prices in row order with their decimal places: a repeated price moves no GCD and no share.
180
+ const placesByPrice = new Map();
147
181
  const start = Math.max(0, rows.length - maxRows);
148
182
  for (let i = start; i < rows.length; i++) {
149
183
  const row = rows[i];
@@ -154,22 +188,27 @@ export function inferPriceTickFromRows(rows, maxRows = PRICE_TICK_INFERENCE_ROWS
154
188
  if (!positiveFinite(value))
155
189
  continue;
156
190
  const price = Number(value.toPrecision(PRICE_TICK_SIGNIFICANT_DIGITS));
157
- prices.push(price);
158
- decimals = Math.max(decimals, decimalPlaces(price));
191
+ if (!placesByPrice.has(price))
192
+ placesByPrice.set(price, decimalPlaces(price));
159
193
  }
160
194
  }
161
- if (prices.length < 2 || decimals > PRICE_TICK_MAX_DECIMALS)
195
+ if (placesByPrice.size < 2)
162
196
  return null;
163
- const scale = 10 ** decimals;
164
- const origin = Math.round(prices[0] * scale);
165
- if (!Number.isSafeInteger(origin))
197
+ const decimals = latticeDecimalPlaces(placesByPrice);
198
+ if (decimals === null)
166
199
  return null;
200
+ const scale = 10 ** decimals;
201
+ let origin = null;
167
202
  let units = 0;
168
203
  let maxPrice = 0;
169
- for (const price of prices) {
204
+ for (const [price, places] of placesByPrice) {
205
+ if (places > decimals)
206
+ continue;
170
207
  const scaled = Math.round(price * scale);
171
208
  if (!Number.isSafeInteger(scaled))
172
209
  return null;
210
+ if (origin === null)
211
+ origin = scaled;
173
212
  units = greatestCommonDivisor(units, Math.abs(scaled - origin));
174
213
  if (price > maxPrice)
175
214
  maxPrice = price;
@@ -18,11 +18,13 @@
18
18
  import { type LiveBucketVenue } from './live-bucket.util.js';
19
19
  /**
20
20
  * How a host merges what lands in one of its bars: `flow` sums the rows,
21
- * `level` keeps the last row, `candle` folds OHLCV rows into one candle, and
21
+ * `level` keeps the last row, `candle` folds OHLCV rows into one candle,
22
22
  * `cells` (rows of time-stamped cells: a trade tape, option prints) places
23
- * each CELL by its own instant, its offset rebased to the bar's open.
23
+ * each CELL by its own instant, its offset rebased to the bar's open, and
24
+ * `passthrough` places nothing: every row keeps its own timestamp (a profile
25
+ * a tool aggregates over a window rides rows finer than the host's bars).
24
26
  */
25
- export type IndexHostMerge = 'flow' | 'level' | 'candle' | 'cells';
27
+ export type IndexHostMerge = 'flow' | 'level' | 'candle' | 'cells' | 'passthrough';
26
28
  /** An index-mode host's bars as the placement reads them. */
27
29
  export interface IndexHostBars {
28
30
  /** The mounted main candles, ascending by timestamp (ms). */
@@ -97,7 +99,8 @@ export interface PlaceRowsInHostBarsOptions {
97
99
  * stamped on it keeps that row object, so a series already on the host grid
98
100
  * comes back as the exact timestamp filter returned it; every other bar's row
99
101
  * is new and is handed to `onMade`. `opts.rowSpanMs` places each row by its
100
- * last instant instead (`PlaceRowsInHostBarsOptions`).
102
+ * last instant instead (`PlaceRowsInHostBarsOptions`). `passthrough` returns
103
+ * the rows as handed, in a new array, and makes none.
101
104
  */
102
105
  export declare function placeRowsInHostBars(rows: readonly number[][], bars: IndexHostBars, merge: IndexHostMerge, onMade?: (row: number[]) => void, opts?: PlaceRowsInHostBarsOptions): number[][];
103
106
  /**
@@ -71,7 +71,10 @@ function mergeRowsOntoBar(barTs, rows, merge) {
71
71
  export function hostBarRowOf(barTs, rows, merge) {
72
72
  if (rows.length === 1 && rows[0][0] === barTs)
73
73
  return rows[0];
74
- return merge === 'level' ? [barTs, ...rows[rows.length - 1].slice(1)] : mergeRowsOntoBar(barTs, rows, merge);
74
+ // A passthrough series has no bar row; a door that still asks keeps the last (the live doors branch it first).
75
+ return merge === 'level' || merge === 'passthrough'
76
+ ? [barTs, ...rows[rows.length - 1].slice(1)]
77
+ : mergeRowsOntoBar(barTs, rows, merge);
75
78
  }
76
79
  const hasFiniteTs = (row) => {
77
80
  const ts = row?.[0];
@@ -423,9 +426,12 @@ function placeCellsInHostBars(sorted, bars, out, onMade) {
423
426
  * stamped on it keeps that row object, so a series already on the host grid
424
427
  * comes back as the exact timestamp filter returned it; every other bar's row
425
428
  * is new and is handed to `onMade`. `opts.rowSpanMs` places each row by its
426
- * last instant instead (`PlaceRowsInHostBarsOptions`).
429
+ * last instant instead (`PlaceRowsInHostBarsOptions`). `passthrough` returns
430
+ * the rows as handed, in a new array, and makes none.
427
431
  */
428
432
  export function placeRowsInHostBars(rows, bars, merge, onMade, opts) {
433
+ if (merge === 'passthrough')
434
+ return rows.slice();
429
435
  const main = bars.mainRows;
430
436
  const out = [];
431
437
  if (!rows.length || !main.length)