@orangecharts/wrun-chart-host 0.9.0 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (252) hide show
  1. package/README.md +2 -0
  2. package/dist/constants/feature-flags.constants.d.ts +15 -1
  3. package/dist/constants/feature-flags.constants.js +130 -24
  4. package/dist/constants/governed-exchanges.constants.d.ts +12 -0
  5. package/dist/constants/governed-exchanges.constants.js +16 -0
  6. package/dist/constants/opra-compliance.constants.d.ts +3 -2
  7. package/dist/constants/opra-compliance.constants.js +3 -2
  8. package/dist/constants/option-venues.constants.d.ts +2 -2
  9. package/dist/constants/scriptEditor/builtin-script-snippets.d.ts +26 -0
  10. package/dist/constants/scriptEditor/builtin-script-snippets.js +6 -0
  11. package/dist/constants/scriptEditor/technicalIndicatorScriptKeys.constants.d.ts +15 -0
  12. package/dist/constants/scriptEditor/technicalIndicatorScriptKeys.constants.js +17 -0
  13. package/dist/constants/venue-presets.constants.d.ts +20 -20
  14. package/dist/constants/venue-presets.constants.js +24 -26
  15. package/dist/host-env.d.ts +21 -5
  16. package/dist/host-env.js +6 -0
  17. package/dist/host-ports.types.d.ts +102 -19
  18. package/dist/index.d.ts +18 -0
  19. package/dist/index.js +18 -0
  20. package/dist/interfaces/cancel-reason.interface.d.ts +1 -1
  21. package/dist/interfaces/cme-realtime.interface.d.ts +16 -9
  22. package/dist/interfaces/cme-realtime.interface.js +6 -3
  23. package/dist/interfaces/kscript-diagnostics.interface.d.ts +12 -0
  24. package/dist/interfaces/opra-realtime.interface.d.ts +1 -5
  25. package/dist/interfaces/prediction-market.interface.d.ts +7 -0
  26. package/dist/interfaces/replay.interface.d.ts +8 -0
  27. package/dist/interfaces/stocks-realtime.interface.d.ts +57 -0
  28. package/dist/interfaces/stocks-realtime.interface.js +32 -0
  29. package/dist/interfaces/wrun-runtime.interface.d.ts +18 -2
  30. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +62 -94
  31. package/dist/kscript-data/controls/live-trades-merge.util.js +106 -171
  32. package/dist/market-data/billing.interface.d.ts +174 -36
  33. package/dist/market-data/billing.interface.js +58 -8
  34. package/dist/market-data/venue.d.ts +152 -7
  35. package/dist/market-data/venues/cme.contract.copy.json +66 -0
  36. package/dist/market-data/venues/cme.d.ts +126 -0
  37. package/dist/market-data/venues/cme.js +133 -0
  38. package/dist/market-data/venues/index.d.ts +294 -7
  39. package/dist/market-data/venues/index.js +49 -6
  40. package/dist/market-data/venues/opra.contract.copy.json +3 -2
  41. package/dist/market-data/venues/opra.d.ts +2 -2
  42. package/dist/market-data/venues/opra.js +5 -2
  43. package/dist/market-data/venues/stocks.contract.copy.json +64 -0
  44. package/dist/market-data/venues/stocks.d.ts +130 -0
  45. package/dist/market-data/venues/stocks.js +117 -0
  46. package/dist/settings-templates/footprint-rows.js +35 -2
  47. package/dist/settings-templates/form-rows.d.ts +2 -1
  48. package/dist/settings-templates/index.js +7 -3
  49. package/dist/settings-templates/indicator-fields.d.ts +5 -4
  50. package/dist/settings-templates/indicator-fields.js +79 -10
  51. package/dist/settings-templates/tool-rules.d.ts +32 -15
  52. package/dist/settings-templates/tool-rules.js +33 -11
  53. package/dist/settings-templates/tool-tables.generated.js +95 -31
  54. package/dist/utility/chart/book-live-bucket.util.d.ts +15 -0
  55. package/dist/utility/chart/book-live-bucket.util.js +47 -0
  56. package/dist/utility/chart/cme-cache-context.util.d.ts +5 -3
  57. package/dist/utility/chart/cme-cache-context.util.js +10 -6
  58. package/dist/utility/chart/cme-realtime.util.js +10 -0
  59. package/dist/utility/chart/cme-user-scripts-gate.util.d.ts +83 -0
  60. package/dist/utility/chart/cme-user-scripts-gate.util.js +142 -0
  61. package/dist/utility/chart/effective-chart-session.util.d.ts +14 -0
  62. package/dist/utility/chart/effective-chart-session.util.js +39 -0
  63. package/dist/utility/chart/host-bar-placement.util.d.ts +28 -0
  64. package/dist/utility/chart/host-bar-placement.util.js +170 -30
  65. package/dist/utility/chart/index-host-tier.util.d.ts +3 -1
  66. package/dist/utility/chart/index-host-tier.util.js +7 -2
  67. package/dist/utility/chart/index-mode-admission.util.js +30 -3
  68. package/dist/utility/chart/kscript-apply-fingerprint.util.js +1 -1
  69. package/dist/utility/chart/kscript-drawing-safe-area.util.d.ts +35 -11
  70. package/dist/utility/chart/kscript-drawing-safe-area.util.js +145 -35
  71. package/dist/utility/chart/kscript-live-coalesce.util.d.ts +9 -7
  72. package/dist/utility/chart/kscript-live-coalesce.util.js +13 -8
  73. package/dist/utility/chart/kscript-live-source-identity.util.d.ts +9 -0
  74. package/dist/utility/chart/kscript-live-source-identity.util.js +10 -1
  75. package/dist/utility/chart/kscript-provenance-keys.util.js +13 -0
  76. package/dist/utility/chart/kscript-standin-identity.leaf.d.ts +5 -1
  77. package/dist/utility/chart/kscript-titancharts-render-keys.constants.d.ts +32 -2
  78. package/dist/utility/chart/kscript-titancharts-render-keys.constants.js +45 -0
  79. package/dist/utility/chart/kscript-venue-policy.util.d.ts +156 -43
  80. package/dist/utility/chart/kscript-venue-policy.util.js +249 -59
  81. package/dist/utility/chart/live-bucket.util.d.ts +24 -8
  82. package/dist/utility/chart/live-bucket.util.js +85 -27
  83. package/dist/utility/chart/market-session-schedule.util.d.ts +10 -0
  84. package/dist/utility/chart/market-session-schedule.util.js +16 -0
  85. package/dist/utility/chart/marketKind.util.js +5 -0
  86. package/dist/utility/chart/mixed-mode.util.d.ts +7 -0
  87. package/dist/utility/chart/mixed-mode.util.js +14 -0
  88. package/dist/utility/chart/opra-read-access.leaf.d.ts +5 -3
  89. package/dist/utility/chart/opra-read-access.leaf.js +5 -3
  90. package/dist/utility/chart/opra-user-scripts-gate.util.d.ts +11 -16
  91. package/dist/utility/chart/opra-user-scripts-gate.util.js +12 -28
  92. package/dist/utility/chart/rth-session.util.d.ts +12 -10
  93. package/dist/utility/chart/rth-session.util.js +25 -21
  94. package/dist/utility/chart/trading-day.util.d.ts +17 -0
  95. package/dist/utility/chart/trading-day.util.js +59 -0
  96. package/dist/utility/chart/window-geometry.leaf.d.ts +8 -0
  97. package/dist/utility/chart/window-geometry.leaf.js +22 -6
  98. package/dist/utility/chart/window-owner.leaf.d.ts +23 -2
  99. package/dist/utility/chart/window-owner.leaf.js +45 -3
  100. package/dist/utility/chart/wrun-bar-session-facts.util.d.ts +33 -15
  101. package/dist/utility/chart/wrun-bar-session-facts.util.js +70 -20
  102. package/dist/utility/chart/wrun-run-result.util.d.ts +12 -0
  103. package/dist/utility/chart/wrun-run-result.util.js +141 -6
  104. package/dist/utility/intl-locale.util.js +5 -0
  105. package/dist/utility/options/option-bar-anchor.util.d.ts +145 -0
  106. package/dist/utility/options/option-bar-anchor.util.js +340 -0
  107. package/dist/utility/options/option-venue.util.d.ts +18 -0
  108. package/dist/utility/options/option-venue.util.js +27 -0
  109. package/dist/utility/scriptEditor/wrun-runtime-diagnostics.leaf.js +4 -0
  110. package/dist/utility/v2/gate-plane.util.d.ts +12 -3
  111. package/dist/utility/v2/gate-plane.util.js +30 -4
  112. package/dist/utility/v2/gate-session-latch.util.js +1 -1
  113. package/dist/utility/v2/stocks-governed.util.d.ts +16 -0
  114. package/dist/utility/v2/stocks-governed.util.js +34 -0
  115. package/dist/utility/wrun/derived-roots.leaf.d.ts +13 -0
  116. package/dist/utility/wrun/derived-roots.leaf.js +27 -0
  117. package/dist/utility/wrun/derived-roots.util.d.ts +205 -0
  118. package/dist/utility/wrun/derived-roots.util.js +451 -0
  119. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.d.ts +43 -7
  120. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.js +89 -19
  121. package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.d.ts +9 -4
  122. package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.js +47 -6
  123. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.d.ts +4 -2
  124. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.js +4 -2
  125. package/dist/utility/wrun/run-schedule/wrun-own-candles.util.d.ts +24 -3
  126. package/dist/utility/wrun/run-schedule/wrun-own-candles.util.js +46 -10
  127. package/dist/utility/wrun/sources/lanes/option_daily.js +5 -2
  128. package/dist/utility/wrun/sources/lanes/options_flow.js +5 -2
  129. package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +64 -19
  130. package/dist/utility/wrun/sources/opra-option-lanes.util.js +105 -35
  131. package/dist/utility/wrun/sources/row-lanes/option_contract_flow.js +2 -1
  132. package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +2 -1
  133. package/dist/utility/wrun/sources/row-lanes/option_prints.d.ts +3 -0
  134. package/dist/utility/wrun/sources/row-lanes/option_prints.js +19 -4
  135. package/dist/utility/wrun/sources/row-lanes/option_strike_flow.js +17 -4
  136. package/dist/utility/wrun/sources/row-lanes/option_strikes.d.ts +52 -13
  137. package/dist/utility/wrun/sources/row-lanes/option_strikes.js +88 -19
  138. package/dist/utility/wrun/sources/row-lanes/option_surface.js +2 -1
  139. package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +19 -0
  140. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +24 -9
  141. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +41 -10
  142. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.d.ts +111 -0
  143. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.js +133 -0
  144. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.d.ts +15 -3
  145. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.js +22 -3
  146. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +31 -0
  147. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +197 -13
  148. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +761 -27
  149. package/dist/utility/wrun/wrun-browser-sources.leaf.js +1 -2
  150. package/dist/utility/wrun/wrun-builtin-twin.util.d.ts +12 -0
  151. package/dist/utility/wrun/wrun-builtin-twin.util.js +21 -0
  152. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +60 -16
  153. package/dist/utility/wrun/wrun-chart-market-facts.util.js +113 -61
  154. package/dist/utility/wrun/wrun-color-settings.util.d.ts +9 -0
  155. package/dist/utility/wrun/wrun-color-settings.util.js +33 -0
  156. package/dist/utility/wrun/wrun-download-meter.util.d.ts +15 -0
  157. package/dist/utility/wrun/wrun-download-meter.util.js +14 -2
  158. package/dist/utility/wrun/wrun-download-plan.util.d.ts +99 -0
  159. package/dist/utility/wrun/wrun-download-plan.util.js +118 -0
  160. package/dist/utility/wrun/wrun-draft-legend-note.util.d.ts +11 -3
  161. package/dist/utility/wrun/wrun-draft-legend-note.util.js +26 -4
  162. package/dist/utility/wrun/wrun-frames.d.ts +27 -6
  163. package/dist/utility/wrun/wrun-frames.js +73 -10
  164. package/dist/utility/wrun/wrun-handles.util.d.ts +7 -3
  165. package/dist/utility/wrun/wrun-handles.util.js +9 -8
  166. package/dist/utility/wrun/wrun-hosted-wire.util.d.ts +7 -1
  167. package/dist/utility/wrun/wrun-hosted-wire.util.js +12 -2
  168. package/dist/utility/wrun/wrun-hud-looks.util.d.ts +18 -4
  169. package/dist/utility/wrun/wrun-hud-looks.util.js +45 -13
  170. package/dist/utility/wrun/wrun-input-requirements.leaf.d.ts +68 -0
  171. package/dist/utility/wrun/wrun-input-requirements.leaf.js +163 -7
  172. package/dist/utility/wrun/wrun-latest-snapshot.d.ts +11 -0
  173. package/dist/utility/wrun/wrun-leg-close.util.d.ts +59 -23
  174. package/dist/utility/wrun/wrun-leg-close.util.js +186 -28
  175. package/dist/utility/wrun/wrun-live-intake.util.d.ts +35 -15
  176. package/dist/utility/wrun/wrun-live-intake.util.js +243 -126
  177. package/dist/utility/wrun/wrun-live-tick.util.d.ts +13 -5
  178. package/dist/utility/wrun/wrun-live-tick.util.js +279 -99
  179. package/dist/utility/wrun/wrun-market-facts.util.d.ts +13 -3
  180. package/dist/utility/wrun/wrun-market-facts.util.js +13 -3
  181. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +60 -11
  182. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +70 -5
  183. package/dist/utility/wrun/wrun-market-size-defaults.util.js +31 -5
  184. package/dist/utility/wrun/wrun-opra-lane.util.d.ts +17 -4
  185. package/dist/utility/wrun/wrun-opra-lane.util.js +6 -4
  186. package/dist/utility/wrun/wrun-option-book-rows.util.d.ts +56 -0
  187. package/dist/utility/wrun/wrun-option-book-rows.util.js +96 -0
  188. package/dist/utility/wrun/wrun-option-strike-flow-forecast.util.d.ts +31 -0
  189. package/dist/utility/wrun/wrun-option-strike-flow-forecast.util.js +119 -0
  190. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.d.ts +23 -6
  191. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.js +47 -11
  192. package/dist/utility/wrun/wrun-option-strike-flow.util.d.ts +86 -19
  193. package/dist/utility/wrun/wrun-option-strike-flow.util.js +168 -62
  194. package/dist/utility/wrun/wrun-option-views.util.d.ts +323 -28
  195. package/dist/utility/wrun/wrun-option-views.util.js +484 -71
  196. package/dist/utility/wrun/wrun-options-chain.util.d.ts +3 -3
  197. package/dist/utility/wrun/wrun-options-chain.util.js +2 -0
  198. package/dist/utility/wrun/wrun-output-style.util.d.ts +6 -2
  199. package/dist/utility/wrun/wrun-output-style.util.js +20 -2
  200. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +32 -2
  201. package/dist/utility/wrun/wrun-overlay-drivers.util.js +13 -3
  202. package/dist/utility/wrun/wrun-overlay-lifecycle.util.d.ts +10 -1
  203. package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +52 -4
  204. package/dist/utility/wrun/wrun-overlay-recovery.util.js +3 -1
  205. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +160 -42
  206. package/dist/utility/wrun/wrun-overlay-run.util.js +1244 -209
  207. package/dist/utility/wrun/wrun-pane-format.util.d.ts +2 -1
  208. package/dist/utility/wrun/wrun-pane-format.util.js +7 -3
  209. package/dist/utility/wrun/wrun-panel-mount.util.d.ts +9 -0
  210. package/dist/utility/wrun/wrun-panel-mount.util.js +114 -19
  211. package/dist/utility/wrun/wrun-panel-style.util.d.ts +10 -9
  212. package/dist/utility/wrun/wrun-panel-style.util.js +58 -9
  213. package/dist/utility/wrun/wrun-param-map.util.d.ts +14 -11
  214. package/dist/utility/wrun/wrun-param-map.util.js +10 -5
  215. package/dist/utility/wrun/wrun-param-values.util.d.ts +14 -4
  216. package/dist/utility/wrun/wrun-param-values.util.js +4 -0
  217. package/dist/utility/wrun/wrun-pin-spelling.util.d.ts +15 -2
  218. package/dist/utility/wrun/wrun-pin-spelling.util.js +39 -14
  219. package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +50 -0
  220. package/dist/utility/wrun/wrun-refusal-surface.util.js +68 -0
  221. package/dist/utility/wrun/wrun-refusal.util.d.ts +3 -2
  222. package/dist/utility/wrun/wrun-refusal.util.js +22 -0
  223. package/dist/utility/wrun/wrun-refused-latest.util.d.ts +10 -0
  224. package/dist/utility/wrun/wrun-refused-latest.util.js +12 -0
  225. package/dist/utility/wrun/wrun-registry-errors.util.d.ts +26 -0
  226. package/dist/utility/wrun/wrun-registry-errors.util.js +34 -0
  227. package/dist/utility/wrun/wrun-replay-lane.util.js +3 -2
  228. package/dist/utility/wrun/wrun-row-source.d.ts +11 -0
  229. package/dist/utility/wrun/wrun-run-interval-session.util.d.ts +20 -6
  230. package/dist/utility/wrun/wrun-run-interval-session.util.js +22 -7
  231. package/dist/utility/wrun/wrun-run-interval.util.d.ts +43 -9
  232. package/dist/utility/wrun/wrun-run-interval.util.js +58 -15
  233. package/dist/utility/wrun/wrun-script-inputs.util.d.ts +45 -1
  234. package/dist/utility/wrun/wrun-script-inputs.util.js +112 -4
  235. package/dist/utility/wrun/wrun-setting-words.util.d.ts +7 -3
  236. package/dist/utility/wrun/wrun-setting-words.util.js +13 -5
  237. package/dist/utility/wrun/wrun-socket-row-source.d.ts +27 -2
  238. package/dist/utility/wrun/wrun-socket-row-source.js +118 -8
  239. package/dist/utility/wrun/wrun-source-rows.util.d.ts +29 -18
  240. package/dist/utility/wrun/wrun-source-rows.util.js +61 -27
  241. package/dist/utility/wrun/wrun-style-words.util.js +6 -4
  242. package/dist/utility/wrun/wrun-table-chrome.util.d.ts +3 -2
  243. package/dist/utility/wrun/wrun-table-chrome.util.js +19 -11
  244. package/dist/utility/wrun/wrun-tape-per-order.util.d.ts +2 -0
  245. package/dist/utility/wrun/wrun-tape-per-order.util.js +7 -0
  246. package/dist/utility/wrun/wrun-tape-source.util.d.ts +17 -9
  247. package/dist/utility/wrun/wrun-tape-source.util.js +20 -12
  248. package/dist/utils/replay/replay-buffer-math.d.ts +53 -2
  249. package/dist/utils/replay/replay-buffer-math.js +227 -20
  250. package/dist/workers/constants/socket-slots.d.ts +91 -6
  251. package/dist/workers/constants/socket-slots.js +85 -6
  252. package/package.json +5 -5
@@ -63,9 +63,10 @@
63
63
  */
64
64
  import type { WrunDegradedLane, WrunRunReason, WrunRunWindow } from './wrun-lifecycle.contract.js';
65
65
  import { type WrunIntegrationRoute } from './wrun-integration-route.util.js';
66
- import type { OverlayRunInterval } from '../chart/indicator-run-interval.util.js';
66
+ import { type OverlayRunInterval, type RunBarCalendar } from '../chart/indicator-run-interval.util.js';
67
67
  import { type WrunPrefixFeedClause } from './run-schedule/wrun-prefix-feeds.util.js';
68
68
  import { type WrunCandleGroup, type WrunFillPair, type WrunRunResult } from '../chart/wrun-run-result.util.js';
69
+ import { type WrunRowLaneBudgetCut } from './sources/wrun-row-lanes.util.js';
69
70
  import { type WrunEarningsMarket } from './wrun-earnings-facts.util.js';
70
71
  import { type WrunRunHealth } from './wrun-run-health.util.js';
71
72
  import { type WrunChartNames } from './wrun-chart-context.util.js';
@@ -73,9 +74,12 @@ import { type WrunFactsMarket } from './wrun-chart-market-facts.util.js';
73
74
  import { type WrunStrategyBarInput } from './wrun-host.service.js';
74
75
  import { type WrunRefusalAttemptToken, type WrunRefusalContext, type WrunRefusalSeed } from './wrun-refusal.util.js';
75
76
  import { type WrunHostFillContext } from './wrun-script-inputs.util.js';
77
+ import { type WrunDownloadSummary } from './wrun-download-meter.util.js';
76
78
  import type { WrunLatestSnapshot } from './wrun-latest-snapshot.js';
77
79
  import { wrunChartMarketIdentity, type WrunOverlayLiveContext, type WrunWarmupMiss } from './wrun-overlay-drivers.util.js';
80
+ import { type KScriptProvenanceSettingsLike } from '../chart/kscript-venue-policy.util.js';
78
81
  import type { WrunLegCandleClose } from '@orangecharts/indicator-kit/host';
82
+ import { type WrunPassRowSource } from './wrun-row-source-factory.js';
79
83
  import { type WrunPinnedLeg, type WrunPinnedWire } from './wrun-source-rows.util.js';
80
84
  import { type WrunOptionsChainRefusal } from './wrun-options-chain.util.js';
81
85
  import { type WrunRunIntervalProjection } from './wrun-run-interval-session.util.js';
@@ -108,6 +112,14 @@ export declare const WRUN_ODDS_SEED_LEG_BARS = 1440;
108
112
  * Cold, the gateway answered a 290-bar Polymarket window in 2.6 to 4.6 s and
109
113
  * the serial 1440-bar seed that followed it in up to 12.5 s. */
110
114
  export declare const WRUN_ODDS_SHORT_SEED_LEG_BARS = 250;
115
+ /** A candle ask's rows market when the chart's rows came from another (the full run's door and the tick's agree). */
116
+ export declare function wrunCandleAskSource(chartMetadata: unknown, provenance: KScriptProvenanceSettingsLike | undefined): {
117
+ source: {
118
+ exchange: string;
119
+ symbol: string;
120
+ } | null;
121
+ walled: boolean;
122
+ };
111
123
  /**
112
124
  * A pinned leg's fetch payload extras over the current-market placeholders:
113
125
  * its market (absent = the chart's own), plus the K_OHLCV prediction flag
@@ -244,6 +256,10 @@ export type WrunRunStage = 'head' | 'lanes' | 'compute' | 'integrate' | 'prefix'
244
256
  */
245
257
  export declare function surfaceWrunRunFailureOnLegend(chartIndex: number, indicatorId: string, error: unknown, context?: {
246
258
  outputNames?: readonly string[];
259
+ /** The run's console provenance (`computed.opra`): its runtime trap row carries the row mark. */
260
+ opra?: boolean;
261
+ /** The same for the CME plane (`computed.cme`): its runtime trap row carries the CME mark. */
262
+ cme?: boolean;
247
263
  /** The run's refusal context (the run pass builds it from the chart it ran on). */
248
264
  refusalContext?: WrunRefusalContext;
249
265
  /** The attempt token the run resolved before its first await; absent or null: no toast. */
@@ -274,6 +290,54 @@ export declare function wrunRefusalContextFor(input: {
274
290
  settings: unknown;
275
291
  chartMetadata: WrunRefusalChartMetadata;
276
292
  }): Promise<WrunRefusalContext>;
293
+ /** A row lane's read its row budget cut (`onBudgetCut`, wrun-row-lanes.util): the newest bars that fit read whole,
294
+ * the older ones partial, so the run drew fewer bars of that lane than the chart shows. */
295
+ export declare const WRUN_ROW_BUDGET_CUT_CODE = "WRUN_ROW_BUDGET_CUT";
296
+ /** The rows the run seam owns for its row budget cuts: replaced by every full run, cleared by a run that cut nothing. */
297
+ export declare const WRUN_ROW_BUDGET_ROW_CODES: ReadonlySet<string>;
298
+ /** The legend's localized sentence of a cut over its facts (`{ n }`, the bars kept, its plural choice). */
299
+ export declare const WRUN_ROW_BUDGET_CUT_NOTE_KEY = "wrun.rowBudget.cut";
300
+ /**
301
+ * The legend note rows of a run's row budget cuts, one per row lane instance its budget cut: warnings in the run-owned
302
+ * set `WRUN_ROW_BUDGET_ROW_CODES`, `message` the technical words (Copy details, the console), `details` the facts the
303
+ * legend's sentence reads (`WRUN_ROW_BUDGET_CUT_NOTE_KEY`: `{ n }`) beside the lane and the cut. A note, never a
304
+ * refusal: the run drew its newest bars, and without it a package that drew 30 bars of a long chart (Strike
305
+ * Footprint) said nothing about why. Empty for no cut, which is what clears the rows of an earlier run.
306
+ */
307
+ export declare function wrunRowBudgetCutDiagnostics(cuts: Iterable<WrunRowLaneBudgetCut>): RuntimeDiagnostic[];
308
+ /** The indicator download budget's two chips (OPTLOAD W3 R2), the source chip family's run-owned codes
309
+ * (kscript-source-degrade.util `FE_SOURCE_TRIMMED_CODE`, `FE_SOURCE_HEAVY_CODE`, spelled here because the package
310
+ * names no web module; tests/utility/wrun/wrun-overlay-run.download-budget.spec.ts pins them equal): replaced by every
311
+ * full run, cleared by a run that kept its budget. */
312
+ export declare const WRUN_DOWNLOAD_TRIMMED_CODE = "FE_SOURCE_TRIMMED";
313
+ export declare const WRUN_DOWNLOAD_HEAVY_CODE = "FE_SOURCE_HEAVY";
314
+ export declare const WRUN_DOWNLOAD_BUDGET_ROW_CODES: ReadonlySet<string>;
315
+ /** Bytes as the download chips write them, 1,000,000 a MB: "1 MB", "1.2 MB", "17 MB". */
316
+ export declare function wrunDownloadMbText(bytes: number): string;
317
+ /** A feed as a download chip names it: its label (the console's words), and the i18n key the legend says it in. */
318
+ export interface WrunDownloadFeed {
319
+ label: string;
320
+ key?: string;
321
+ }
322
+ /**
323
+ * The download budget's legend rows of one full run (R2), info rows in the run-owned set
324
+ * `WRUN_DOWNLOAD_BUDGET_ROW_CODES`, still text in the source chip family's coverage group (never a spinner, never a
325
+ * toast; runtime-diagnostics.util words them from `details`, the feeds by `feedKeys` where a lane has feed words):
326
+ * - `FE_SOURCE_TRIMMED` ("Newest bars only"), when the budget cut a read: the feeds it cut, the oldest bar all of them
327
+ * still read (`date`, `keptFromTs`: the newest of the cuts' oldest kept bars) and the budget;
328
+ * - `FE_SOURCE_HEAVY` ("Large download"), when the run downloaded more than its budget and cut nothing (one snapshot):
329
+ * the feed that downloaded the most, the size and the budget.
330
+ * Empty with the flag off, or for a run that kept its budget: what clears an earlier run's rows.
331
+ */
332
+ export declare function wrunDownloadBudgetDiagnostics(args: {
333
+ on: boolean;
334
+ cuts: Iterable<WrunRowLaneBudgetCut>;
335
+ summary: WrunDownloadSummary | undefined;
336
+ feedOf: (laneKeyOrType: string) => WrunDownloadFeed;
337
+ }): RuntimeDiagnostic[];
338
+ /** Whether the download budget's cut is on (`FeatureFlag.WrunDownloadBudgetCut`); a host whose flag store is not up
339
+ * reads off. */
340
+ export declare function wrunDownloadBudgetCutOn(): boolean;
277
341
  /**
278
342
  * The run health the chart's surfaces read (the chip policy, FE-RUN): an output a viewer cannot
279
343
  * see is not watched (`legend: false` and a sheet `visible: false`, which `wrunRunHealth` skips,
@@ -423,8 +487,9 @@ export declare function wrunRowSourcePatchOf(previous: Readonly<Record<string, u
423
487
  * the session its batch came from went with it.
424
488
  */
425
489
  export declare function holdWrunSocketSessionLost(chartIndex: number, indicatorId: string, status: 'reconnected' | 'session-swept'): void;
426
- /** Specs only: forget every held source (none is released), the socket's losses and the pending asks (none is
427
- * cancelled). */
490
+ /** Spec seam: hold `source` as the overlay's row source (as a landed cloud run does), so a spec can reach what
491
+ * reads the held source without running one. */
492
+ export declare function __holdWrunRowSourceForTests(indicatorId: string, source: WrunPassRowSource): void;
428
493
  export declare function __resetWrunHeldRowSourcesForTests(): void;
429
494
  /** One overlay's row-source retention as the memory census reads it (memory spec 4.4). */
430
495
  export interface WrunRowSourceCensusEntry {
@@ -458,14 +523,17 @@ interface WrunRunChartOwner {
458
523
  /**
459
524
  * A replay run's run bars as of its cutoff (WRUN-PARITY-REST B1): the run
460
525
  * bars the window fetched hold every bucket in full, the one the playhead is
461
- * in included. The bucket holding the newest completed chart bar is folded
462
- * from the completed chart bars inside it (the replay's own candle fold,
463
- * `aggregateOhlcvRows`) until the cutoff bar closes it, the buckets before it
464
- * stay as fetched, and none after it is kept: a run bar shows only what the
465
- * replay revealed, the live rule (live, the forming run bar folds the candles
466
- * as they trade and the closed one is the fetched one).
467
- */
468
- export declare function wrunReplayRunBars(runBars: ReadonlyArray<ArrayLike<number>>, chartRows: ReadonlyArray<ArrayLike<number>>, cutoffTs: number, runIntervalMs: number, chartIntervalMs: number): ArrayLike<number>[];
526
+ * in included. It keeps the bars open by the cutoff bar (the newest completed
527
+ * chart bar), none after, each span read on the run's calendar (runBarSpan:
528
+ * an RTH hour opens at its session-anchored stamp, a CME trade date at the
529
+ * evening open before its 00:00Z stamp). The newest one is folded from the
530
+ * completed chart bars inside its span until the cutoff bar closes it, and
531
+ * the bars before it stay as fetched: a run bar shows only what the replay
532
+ * revealed, the live rule (live, the forming run bar folds the candles as
533
+ * they trade and the closed one is the fetched one). A forming bar with no
534
+ * revealed chart bar is left out, as live opens one on its first trade.
535
+ */
536
+ export declare function wrunReplayRunBars(runBars: ReadonlyArray<ArrayLike<number>>, chartRows: ReadonlyArray<ArrayLike<number>>, cutoffTs: number, run: RunBarCalendar, chartIntervalMs: number): ArrayLike<number>[];
469
537
  /** The candles of a pinned leg that have CLOSED by `nowMs` (a candle
470
538
  * stamped `ts` closes at `ts + legMs`, or where its host's `closeMs` puts
471
539
  * it: a CME session bar, `wrunLegCandleClose`), in the answer's order; the
@@ -675,32 +743,10 @@ export interface WrunLaneSendAnchor {
675
743
  * nothing: the budget's late read is the whole answer already.
676
744
  */
677
745
  export declare function runWrunSourceLanes(thunks: WrunSourceLaneThunks, policy?: WrunSourceLanePolicy): Promise<WrunSourceLaneRun>;
678
- /**
679
- * The host-filled values a run's `market.*` params read (WRUN-INPUTS-PLAN
680
- * 1.1, `host_fill`): `tickSize` = the instrument tick the pane's engine
681
- * holds (`getPriceTick`, CME venues today), else the tick the chart's own
682
- * candles reveal (`wrunInferredMainTick`: Binance BTCUSDT reads 0.1, so a
683
- * `ticks` offset moves by ticks off CME too); absent when neither knows one,
684
- * which the kit helpers read as unavailable. `pricePrecision` = the decimals
685
- * the chart's MAIN price scale prints at (the engine tick's own decimals
686
- * when it holds one, else the axis-step rule; HIP-4 overrides both), the
687
- * same resolution `calculatePricePrecision` makes for the axis: an inferred
688
- * tick never moves it. Feature-detected on the engine: a pin without the
689
- * tick API, or a bare test double, yields no engine tick.
690
- * The chart words (`intervalSec` = `intervalMs` / 1000, the run clock's
691
- * interval; `bgColor` / `fgColor` = the pane theme's background and axis
692
- * text colour, packed) ride beside them (wrunChartContextHostFill); an
693
- * unknown interval or a theme-less engine leaves them absent. The main
694
- * scale's `priceStep` is the axis label spacing (it moves with zoom), never
695
- * a price unit: it only picks the axis precision here. With `market` (the
696
- * chart metadata), the market's facts ride too (`kind`, `pointValue`, `zone`,
697
- * `quoteIsUsd`, `sessionOpen`: wrunMarketFactsFor, over the directory row a
698
- * run of a package declaring `kind` or `quote_is_usd` awaited first). With
699
- * `earnings` (the chart metadata, passed for a sheet that declares an
700
- * earnings fact), the issuer's earnings facts ride too (`earningsNextMs`,
701
- * `earningsPrevMs`, `earningsSession`: wrunEarningsFactsFor, over the earnings
702
- * window a run of such a package warmed first).
703
- */
746
+ /** The chart metadata as a batch the cloud computed reads its facts (`integrateWrunRowSourceBatch`): the chart's own
747
+ * market's, named outright so no browser run's decision on the chart stands in (`wrunDecidedOptionsExchange`). The
748
+ * server resolves the chain of the chart market it is sent (follow-up: the backend's stock twin rule). */
749
+ export declare function wrunCloudFactsMarket(chartMetadata: WrunFactsMarket | undefined): WrunFactsMarket | undefined;
704
750
  export declare function wrunHostFillContextFor(tc: unknown, chartExchange: unknown, intervalMs?: number, market?: WrunFactsMarket, earnings?: WrunEarningsMarket): WrunHostFillContext;
705
751
  /**
706
752
  * The latest-values snapshot of a run's rows (wrun-hud-state, U10's frozen
@@ -723,18 +769,45 @@ export declare function wrunLatestSnapshotOf(metadata: Pick<WrunIndicatorMetadat
723
769
  * left out.
724
770
  */
725
771
  export declare function wrunOutputRowsOnChartBars(outputRows: ReadonlyArray<WrunOutputRow>, chart: unknown, run: Pick<OverlayRunInterval, 'intervalMs' | 'waitForClose' | 'sessionLattice'>): WrunOutputRow[];
772
+ /**
773
+ * Whose rows a presentation publishes (`presentWrunIntegration`), as a refused full run's snapshot
774
+ * (wrun-refusal-surface.util `wrunRefusedLatestSnapshotOf`) reads them: `run` for the verdicts that supersede every
775
+ * earlier one (contract C3: a full run's integrate, the cloud batch's, a reseed's), which replace it; `republish` for
776
+ * the rows a full run's live session carries on (a tick, a canvas refine, a landed pan page), which never do. Those
777
+ * rows belong to the computation the refusal superseded (another market, other settings), and the run's refusal
778
+ * still stands on the legend beside them, so their numbers would contradict its chip.
779
+ */
780
+ export type WrunLatestPublishOrigin = 'run' | 'republish';
781
+ /** What an integrate applied, as the snapshot's empty targets read it (wrunSnapshotEmptyTargets): the result's
782
+ * `emptyTargets`, and whether its rows were a window of the loaded range (`partial`: the mount keeps its rows
783
+ * outside it). */
784
+ export interface WrunAppliedEmptiness {
785
+ emptyTargets?: ReadonlyArray<string>;
786
+ partial?: boolean;
787
+ }
788
+ /**
789
+ * The Style targets the latest-values snapshot names as drawing nothing (WrunLatestSnapshot.emptyTargets, the Style
790
+ * page's silent lines): the applied result's own, judged over the whole loaded range. A result computed over a
791
+ * window of it (`partial`) speaks for that window only, and the mount keeps its rows outside, so it can clear a
792
+ * target (values in the window) but never mark one: the previous snapshot's targets it still finds empty. A
793
+ * republish that built no result (`applied` absent) carries the previous snapshot's forward.
794
+ */
795
+ export declare function wrunSnapshotEmptyTargets(previous: ReadonlyArray<string> | undefined, applied: WrunAppliedEmptiness | undefined): string[];
726
796
  /**
727
797
  * What follows every successful integrate, the full run's, the reseed's and
728
798
  * the tick's (after the lower-pane children mounted): the nested output
729
799
  * visibility the sheet (`visible: false`) and the Style page's Visible rows
730
800
  * ask for (U9's `applyWrunOutputVisibility`, parent and children), and the
731
801
  * latest-values snapshot the HUD layer, the legend and the hover inspector
732
- * read (`publishWrunLatestValues`), then the Indicator store's seen note for
733
- * a registry Indicator (`noteWrunRegistryRun`: once a page and day, the maker's
734
- * private reach; both row sources pass here). Presentation only: a failure here
735
- * is logged, never a second failure over a run that rendered.
802
+ * read (`publishWrunLatestValues`; a republish leaves a refused full run's
803
+ * snapshot as it is, `WrunLatestPublishOrigin`) with the applied result's
804
+ * `emptyTargets` (the Style page dims those lines), then the Indicator store's
805
+ * seen note for a registry Indicator (`noteWrunRegistryRun`: once a page and
806
+ * day, the maker's private reach; both row sources pass here). Presentation
807
+ * only: a failure here is logged, never a second failure over a run that
808
+ * rendered.
736
809
  */
737
- export declare function presentWrunIntegration(chartIndex: number, indicatorId: string, metadata: WrunIndicatorMetadata, settings: unknown, outputRows: ReadonlyArray<WrunOutputRow>, chart?: unknown, initArgs?: ReadonlyArray<number>, chartNames?: WrunChartNames, runInterval?: OverlayRunInterval | null): void;
810
+ export declare function presentWrunIntegration(chartIndex: number, indicatorId: string, metadata: WrunIndicatorMetadata, settings: unknown, outputRows: ReadonlyArray<WrunOutputRow>, chart?: unknown, initArgs?: ReadonlyArray<number>, chartNames?: WrunChartNames, runInterval?: OverlayRunInterval | null, origin?: WrunLatestPublishOrigin, applied?: WrunAppliedEmptiness): void;
738
811
  /**
739
812
  * The canvas fill a run integrates with: for a sheet that declares a TPO,
740
813
  * the block the catalog mirror holds for the chart market (a mirror miss, a
@@ -756,6 +829,35 @@ export declare function wrunSessionCanvasFillOf(session: object | undefined): Wr
756
829
  * times the apply inside it for the breaker alone (`sample: false`). The
757
830
  * slow verdict reaches the existing toast with cause `apply`. */
758
831
  export declare function recordWrunHostBuildMs(chartIndex: number | undefined, indicatorId: string, ms: number, live?: boolean): void;
832
+ /**
833
+ * A repaint of the mounted session under a new sheet: the style-only save's
834
+ * door (wrun-style-patch.util) for the paint its in-place plot patch cannot
835
+ * reach. A `skip` target's Visible row (the selection builds the target again
836
+ * from the session's rows, whose frames the module writes whatever the sheet
837
+ * hides, or leaves it out), the colour of a level, a renderer or a batched
838
+ * section, a band, a fill, a box, a segment, and every look the adapter
839
+ * derives from an output's colour. The caller swaps the new sheet into the
840
+ * context first (`context.metadata`); this integrates the session's own rows
841
+ * and buffers under it with the canvas fill the session was drawn with (no
842
+ * worker call, no fetch: reintegrateWrunSession) and presents the result as
843
+ * a republish, under the overlay's session lock. A full run in flight
844
+ * replaces the session when it lands, so the repaint stands down and the
845
+ * save's rerun joins that run. False (the save keeps its rerun): no live
846
+ * session, the context replaced or suspended, a full run in flight, the
847
+ * reseed's gates refuse the chart (replay, protection, the pane budget, the
848
+ * pause, the market), no candle to land on, or a failed integrate (the
849
+ * session then owes its repaint, as after a failed tick). `preview` (a
850
+ * settings gesture's frame, under the previewed sheet) writes nothing to the
851
+ * overlay's settings. A replay session stands down too: only its lane bounds
852
+ * its candles at the replay's cutoff (the run and the tick paths), so the save
853
+ * reruns there. A session whose row source holds its own session (a cloud
854
+ * run) repaints with the cells that source keeps (`cellRowsOf`, as its full
855
+ * run and its frames read them); a sheet drawing price canvases whose cells
856
+ * neither such a source nor the context's lane buffers hold stands down.
857
+ */
858
+ export declare function repaintWrunSessionUnderSheet(indicatorId: string, context: WrunOverlayLiveContext, options?: {
859
+ preview?: boolean;
860
+ }): Promise<boolean>;
759
861
  /** Drop an overlay's canvas run state (its refine latches, its run serial):
760
862
  * called from the live tick lane's teardown hook beside the canvas cache. */
761
863
  export declare function forgetWrunOverlayCanvasState(indicatorId: string): void;
@@ -882,6 +984,10 @@ export type WrunIntegrateOptions = WrunOverlayResultOptions & {
882
984
  window?: WrunRunWindow;
883
985
  /** The full run's route facts; absent, the result remounts (a reseed, a direct caller). */
884
986
  integration?: WrunIntegrationFacts;
987
+ /** A settings gesture's preview (the style patch's session repaint, wrun-style-preview.util): the overlay's
988
+ * settings are never written (no legend palette, no stats strip stamp), so nothing a preview paints reaches its
989
+ * engine copy; the gesture's commit or the cancel's repaint stamps them. */
990
+ keepOverlaySettings?: boolean;
885
991
  };
886
992
  export interface WrunIntegrateOutcome {
887
993
  /** The result (its tables placed when it applied). */
@@ -891,6 +997,18 @@ export interface WrunIntegrateOutcome {
891
997
  * route skip or a sparse run the mounted rows outrank. */
892
998
  applied: boolean;
893
999
  }
1000
+ /**
1001
+ * The result a mounted overlay shows now, as it was built, with the window it was computed over (the
1002
+ * workspace switch's stand-in capture stores it, kscript-standin-switch.util): the live tick's last
1003
+ * applied build (`liveApplied`), else the result this lane's last full integrate applied while its
1004
+ * rows are still the ones mounted (the mount memo: a tick's whole integrate, a blank or a stand-in
1005
+ * replaces them), else undefined. While a repaint is owed the chart lags the session, so nothing on
1006
+ * it is known to show: undefined. Nothing is rebuilt or patched here.
1007
+ */
1008
+ export declare function wrunMountedRunResultOf(indicatorId: string, meta: Record<string, unknown>): {
1009
+ runResult: WrunRunResult;
1010
+ window?: WrunRunWindow;
1011
+ } | undefined;
894
1012
  /**
895
1013
  * The chart's integration budget over the parent and its lower panes (`applyWrunIntegrationBudgetPolicy`,
896
1014
  * wrun-integration-budget.util): rows past the kScript preflight's 400k refuse with the kScript path's diagnostic