@orangecharts/wrun-chart-host 0.3.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (362) hide show
  1. package/README.md +23 -6
  2. package/dist/constants/exchange-names.leaf.d.ts +8 -0
  3. package/dist/constants/exchange-names.leaf.js +101 -0
  4. package/dist/constants/kscript-data-interval-restrictions.constants.d.ts +15 -0
  5. package/dist/constants/kscript-data-interval-restrictions.constants.js +40 -0
  6. package/dist/constants/opra-compliance.constants.d.ts +19 -0
  7. package/dist/constants/opra-compliance.constants.js +19 -0
  8. package/dist/constants/replay-ladder.leaf.d.ts +30 -0
  9. package/dist/constants/replay-ladder.leaf.js +99 -0
  10. package/dist/constants/scriptEditor/builtin-script-snippets.d.ts +133 -0
  11. package/dist/constants/scriptEditor/builtin-script-snippets.js +451 -0
  12. package/dist/constants/scriptEditor/cme-official-scripts.constants.d.ts +168 -0
  13. package/dist/constants/scriptEditor/cme-official-scripts.constants.js +398 -0
  14. package/dist/constants/scriptEditor/converted-script-id.leaf.d.ts +8 -0
  15. package/dist/constants/scriptEditor/converted-script-id.leaf.js +10 -0
  16. package/dist/constants/scriptEditor/execution.constants.d.ts +4 -0
  17. package/dist/constants/scriptEditor/execution.constants.js +14 -0
  18. package/dist/constants/wrun-prefix-safe.constants.d.ts +23 -0
  19. package/dist/constants/wrun-prefix-safe.constants.js +26 -0
  20. package/dist/host-env.d.ts +321 -24
  21. package/dist/host-env.js +15 -0
  22. package/dist/host-ports.types.d.ts +857 -35
  23. package/dist/index.d.ts +149 -2
  24. package/dist/index.js +149 -2
  25. package/dist/instances/script-engine-worker-ohlcv-transfer.d.ts +31 -0
  26. package/dist/instances/script-engine-worker-ohlcv-transfer.js +164 -0
  27. package/dist/interfaces/market-event.interface.d.ts +231 -0
  28. package/dist/interfaces/market-event.interface.js +15 -0
  29. package/dist/interfaces/opra-realtime.interface.d.ts +70 -134
  30. package/dist/interfaces/opra-realtime.interface.js +34 -59
  31. package/dist/interfaces/replay.interface.d.ts +285 -0
  32. package/dist/interfaces/replay.interface.js +1 -0
  33. package/dist/kscript-data/controls/live-ohlcv-merge.util.d.ts +1 -0
  34. package/dist/kscript-data/controls/live-ohlcv-merge.util.js +93 -0
  35. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +5 -1
  36. package/dist/kscript-data/controls/live-trades-merge.util.js +2 -2
  37. package/dist/market-data/billing.interface.d.ts +219 -0
  38. package/dist/market-data/billing.interface.js +58 -0
  39. package/dist/market-data/venue-governed.util.d.ts +2 -0
  40. package/dist/market-data/venue-governed.util.js +10 -0
  41. package/dist/market-data/venue.d.ts +122 -0
  42. package/dist/market-data/venue.js +1 -0
  43. package/dist/market-data/venues/index.d.ts +97 -0
  44. package/dist/market-data/venues/index.js +33 -0
  45. package/dist/market-data/venues/opra.contract.copy.json +35 -0
  46. package/dist/market-data/venues/opra.d.ts +70 -0
  47. package/dist/market-data/venues/opra.js +74 -0
  48. package/dist/replay/replayIndicatorRows.d.ts +31 -0
  49. package/dist/replay/replayIndicatorRows.js +117 -0
  50. package/dist/replay/replayLadder.d.ts +85 -0
  51. package/dist/replay/replayLadder.js +388 -0
  52. package/dist/utility/auth/server-clock.util.d.ts +81 -0
  53. package/dist/utility/auth/server-clock.util.js +238 -0
  54. package/dist/utility/chart/builtin-identity.util.d.ts +18 -0
  55. package/dist/utility/chart/builtin-identity.util.js +51 -0
  56. package/dist/utility/chart/cache-alignment.util.d.ts +454 -0
  57. package/dist/utility/chart/cache-alignment.util.js +926 -0
  58. package/dist/utility/chart/chart-data-fetch-generation.util.d.ts +15 -0
  59. package/dist/utility/chart/chart-data-fetch-generation.util.js +22 -0
  60. package/dist/utility/chart/chart-mount-epoch.util.d.ts +5 -0
  61. package/dist/utility/chart/chart-mount-epoch.util.js +29 -0
  62. package/dist/utility/chart/chart-time-domain.util.d.ts +12 -0
  63. package/dist/utility/chart/chart-time-domain.util.js +23 -0
  64. package/dist/utility/chart/color-customization.leaf.d.ts +10 -0
  65. package/dist/utility/chart/color-customization.leaf.js +16 -0
  66. package/dist/utility/chart/date-labelled-interval.leaf.d.ts +15 -0
  67. package/dist/utility/chart/date-labelled-interval.leaf.js +19 -0
  68. package/dist/utility/chart/footprint-tick-grid.util.d.ts +106 -0
  69. package/dist/utility/chart/footprint-tick-grid.util.js +167 -0
  70. package/dist/utility/chart/gesture-timing.leaf.d.ts +29 -0
  71. package/dist/utility/chart/gesture-timing.leaf.js +29 -0
  72. package/dist/utility/chart/governed-contract-coin.util.d.ts +22 -0
  73. package/dist/utility/chart/governed-contract-coin.util.js +39 -0
  74. package/dist/utility/chart/host-bar-placement.util.d.ts +107 -0
  75. package/dist/utility/chart/host-bar-placement.util.js +447 -0
  76. package/dist/utility/chart/index-host-tier.util.d.ts +31 -0
  77. package/dist/utility/chart/index-host-tier.util.js +118 -0
  78. package/dist/utility/chart/index-mode-admission.util.d.ts +34 -0
  79. package/dist/utility/chart/index-mode-admission.util.js +67 -0
  80. package/dist/utility/chart/indicator-error-message.util.d.ts +35 -0
  81. package/dist/utility/chart/indicator-error-message.util.js +44 -0
  82. package/dist/utility/chart/indicator-run-interval.util.d.ts +130 -0
  83. package/dist/utility/chart/indicator-run-interval.util.js +268 -0
  84. package/dist/utility/chart/kscript-apply-fingerprint.util.d.ts +65 -0
  85. package/dist/utility/chart/kscript-apply-fingerprint.util.js +357 -0
  86. package/dist/utility/chart/kscript-chart-flush.leaf.d.ts +22 -0
  87. package/dist/utility/chart/kscript-chart-flush.leaf.js +13 -0
  88. package/dist/utility/chart/kscript-data-interval-restriction.leaf.d.ts +6 -0
  89. package/dist/utility/chart/kscript-data-interval-restriction.leaf.js +27 -0
  90. package/dist/utility/chart/kscript-integration-decision.leaf.d.ts +89 -0
  91. package/dist/utility/chart/kscript-integration-decision.leaf.js +80 -0
  92. package/dist/utility/chart/kscript-live-coalesce.util.d.ts +76 -0
  93. package/dist/utility/chart/kscript-live-coalesce.util.js +156 -0
  94. package/dist/utility/chart/kscript-live-rest-pace.util.d.ts +34 -0
  95. package/dist/utility/chart/kscript-live-rest-pace.util.js +134 -0
  96. package/dist/utility/chart/kscript-live-source-identity.util.d.ts +98 -0
  97. package/dist/utility/chart/kscript-live-source-identity.util.js +121 -0
  98. package/dist/utility/chart/kscript-mounted-plot-set.leaf.d.ts +48 -0
  99. package/dist/utility/chart/kscript-mounted-plot-set.leaf.js +145 -0
  100. package/dist/utility/chart/kscript-perf-tracker.util.d.ts +243 -0
  101. package/dist/utility/chart/kscript-perf-tracker.util.js +522 -0
  102. package/dist/utility/chart/kscript-run-interval-projection.util.d.ts +43 -0
  103. package/dist/utility/chart/kscript-run-interval-projection.util.js +471 -0
  104. package/dist/utility/chart/kscript-run-result-equality.util.d.ts +38 -0
  105. package/dist/utility/chart/kscript-run-result-equality.util.js +89 -0
  106. package/dist/utility/chart/kscript-settings-revision.leaf.d.ts +2 -0
  107. package/dist/utility/chart/kscript-settings-revision.leaf.js +12 -0
  108. package/dist/utility/chart/kscript-source-degrade.leaf.d.ts +63 -0
  109. package/dist/utility/chart/kscript-source-degrade.leaf.js +68 -0
  110. package/dist/utility/chart/kscript-source-retention.util.d.ts +134 -0
  111. package/dist/utility/chart/kscript-source-retention.util.js +218 -0
  112. package/dist/utility/chart/kscript-standin-identity.leaf.d.ts +57 -0
  113. package/dist/utility/chart/kscript-standin-identity.leaf.js +61 -0
  114. package/dist/utility/chart/kscript-titancharts-preparation.util.d.ts +15 -0
  115. package/dist/utility/chart/kscript-titancharts-preparation.util.js +376 -0
  116. package/dist/utility/chart/kscript-titancharts-render-keys.constants.d.ts +9 -0
  117. package/dist/utility/chart/kscript-titancharts-render-keys.constants.js +130 -0
  118. package/dist/utility/chart/kscript-venue-policy.util.d.ts +217 -0
  119. package/dist/utility/chart/kscript-venue-policy.util.js +324 -0
  120. package/dist/utility/chart/live-cadence.util.d.ts +38 -0
  121. package/dist/utility/chart/live-cadence.util.js +37 -0
  122. package/dist/utility/chart/live-feed-series-match.leaf.d.ts +13 -0
  123. package/dist/utility/chart/live-feed-series-match.leaf.js +21 -0
  124. package/dist/utility/chart/local-engine-self-heal-backoff.util.d.ts +46 -0
  125. package/dist/utility/chart/local-engine-self-heal-backoff.util.js +46 -0
  126. package/dist/utility/chart/local-engine-uninit.leaf.d.ts +21 -0
  127. package/dist/utility/chart/local-engine-uninit.leaf.js +22 -0
  128. package/dist/utility/chart/local-kscript-source-revalidation.util.d.ts +62 -0
  129. package/dist/utility/chart/local-kscript-source-revalidation.util.js +123 -0
  130. package/dist/utility/chart/local-kscript-warmup-depth.util.d.ts +214 -0
  131. package/dist/utility/chart/local-kscript-warmup-depth.util.js +376 -0
  132. package/dist/utility/chart/local-technical-script-live-apply-coalescer.util.d.ts +85 -0
  133. package/dist/utility/chart/local-technical-script-live-apply-coalescer.util.js +197 -0
  134. package/dist/utility/chart/local-technical-script-range.leaf.d.ts +72 -0
  135. package/dist/utility/chart/local-technical-script-range.leaf.js +126 -0
  136. package/dist/utility/chart/mixed-mode.util.d.ts +167 -0
  137. package/dist/utility/chart/mixed-mode.util.js +139 -0
  138. package/dist/utility/chart/ohlcv-row-readiness.util.d.ts +36 -0
  139. package/dist/utility/chart/ohlcv-row-readiness.util.js +90 -0
  140. package/dist/utility/chart/opra-user-scripts-gate.util.d.ts +19 -0
  141. package/dist/utility/chart/opra-user-scripts-gate.util.js +32 -0
  142. package/dist/utility/chart/overlay-execution-guard-key.leaf.d.ts +8 -0
  143. package/dist/utility/chart/overlay-execution-guard-key.leaf.js +10 -0
  144. package/dist/utility/chart/price-precision.util.d.ts +40 -0
  145. package/dist/utility/chart/price-precision.util.js +70 -0
  146. package/dist/utility/chart/profile-block-size.util.d.ts +64 -0
  147. package/dist/utility/chart/profile-block-size.util.js +141 -0
  148. package/dist/utility/chart/protected-kscript-degenerate-rows.leaf.d.ts +11 -0
  149. package/dist/utility/chart/protected-kscript-degenerate-rows.leaf.js +29 -0
  150. package/dist/utility/chart/protected-kscript-empty-output.util.d.ts +28 -0
  151. package/dist/utility/chart/protected-kscript-empty-output.util.js +84 -0
  152. package/dist/utility/chart/run-interval-unservable.leaf.d.ts +9 -0
  153. package/dist/utility/chart/run-interval-unservable.leaf.js +20 -0
  154. package/dist/utility/chart/run-interval-warmup.leaf.d.ts +19 -0
  155. package/dist/utility/chart/run-interval-warmup.leaf.js +35 -0
  156. package/dist/utility/chart/titan-constants.pin.d.ts +9 -5
  157. package/dist/utility/chart/titan-constants.pin.js +18 -5
  158. package/dist/utility/chart/warmup-backfill-retry.leaf.d.ts +9 -0
  159. package/dist/utility/chart/warmup-backfill-retry.leaf.js +9 -0
  160. package/dist/utility/chart/window-geometry.leaf.d.ts +119 -0
  161. package/dist/utility/chart/window-geometry.leaf.js +391 -0
  162. package/dist/utility/chart/window-owner.leaf.d.ts +19 -0
  163. package/dist/utility/chart/window-owner.leaf.js +24 -0
  164. package/dist/utility/chart/wrun-bar-session-facts.util.d.ts +11 -2
  165. package/dist/utility/chart/wrun-bar-session-facts.util.js +10 -3
  166. package/dist/utility/chart/wrun-run-result.util.d.ts +5 -1
  167. package/dist/utility/chart/wrun-run-result.util.js +20 -14
  168. package/dist/utility/common/data-processing.util.d.ts +138 -0
  169. package/dist/utility/common/data-processing.util.js +346 -0
  170. package/dist/utility/common/visible-timeout.util.d.ts +13 -4
  171. package/dist/utility/common/visible-timeout.util.js +23 -8
  172. package/dist/utility/exchange-format.leaf.d.ts +1 -0
  173. package/dist/utility/exchange-format.leaf.js +47 -0
  174. package/dist/utility/html-escape.leaf.d.ts +11 -0
  175. package/dist/utility/html-escape.leaf.js +20 -0
  176. package/dist/utility/market-events/earnings-scope.util.d.ts +60 -0
  177. package/dist/utility/market-events/earnings-scope.util.js +92 -0
  178. package/dist/utility/market-events/market-events.util.d.ts +147 -0
  179. package/dist/utility/market-events/market-events.util.js +392 -0
  180. package/dist/utility/market-events/zoned-clock.util.d.ts +1 -0
  181. package/dist/utility/market-events/zoned-clock.util.js +11 -0
  182. package/dist/utility/options/option-venue-disclosure.util.d.ts +43 -0
  183. package/dist/utility/options/option-venue-disclosure.util.js +56 -0
  184. package/dist/utility/scriptEditor/package-semver.util.d.ts +51 -0
  185. package/dist/utility/scriptEditor/package-semver.util.js +120 -0
  186. package/dist/utility/scriptEditor/temp-script-id.util.d.ts +18 -0
  187. package/dist/utility/scriptEditor/temp-script-id.util.js +25 -0
  188. package/dist/utility/symbol-selection/markets-request-from-symbols.leaf.d.ts +20 -0
  189. package/dist/utility/symbol-selection/markets-request-from-symbols.leaf.js +81 -0
  190. package/dist/utility/v2/governed-tier.leaf.d.ts +103 -0
  191. package/dist/utility/v2/governed-tier.leaf.js +113 -0
  192. package/dist/utility/watchlist/import/import-request.leaf.d.ts +10 -0
  193. package/dist/utility/watchlist/import/import-request.leaf.js +10 -0
  194. package/dist/utility/wrun/sources/lanes/option_daily.d.ts +43 -15
  195. package/dist/utility/wrun/sources/lanes/option_daily.js +78 -20
  196. package/dist/utility/wrun/sources/lanes/option_stats_10m.d.ts +14 -10
  197. package/dist/utility/wrun/sources/lanes/option_stats_10m.js +5 -4
  198. package/dist/utility/wrun/sources/lanes/series.js +2 -2
  199. package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +22 -3
  200. package/dist/utility/wrun/sources/opra-option-lanes.util.js +38 -7
  201. package/dist/utility/wrun/sources/registry.js +31 -1
  202. package/dist/utility/wrun/sources/row-lane-registry.js +5 -5
  203. package/dist/utility/wrun/sources/row-lanes/option_contract_state.d.ts +49 -0
  204. package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +75 -20
  205. package/dist/utility/wrun/sources/row-lanes/option_strikes.d.ts +49 -0
  206. package/dist/utility/wrun/sources/row-lanes/option_strikes.js +57 -47
  207. package/dist/utility/wrun/sources/row-lanes/option_surface.d.ts +36 -4
  208. package/dist/utility/wrun/sources/row-lanes/option_surface.js +6 -12
  209. package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +37 -3
  210. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +128 -2
  211. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +233 -51
  212. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +0 -8
  213. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +26 -24
  214. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +85 -104
  215. package/dist/utility/wrun/wrun-alert-outputs.registry.d.ts +166 -0
  216. package/dist/utility/wrun/wrun-alert-outputs.registry.js +219 -0
  217. package/dist/utility/wrun/wrun-bar-count.util.d.ts +83 -0
  218. package/dist/utility/wrun/wrun-bar-count.util.js +259 -0
  219. package/dist/utility/wrun/wrun-chart-context-names.util.d.ts +84 -0
  220. package/dist/utility/wrun/wrun-chart-context-names.util.js +186 -0
  221. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +253 -0
  222. package/dist/utility/wrun/wrun-chart-market-facts.util.js +731 -0
  223. package/dist/utility/wrun/wrun-cloud-opra-stamp.util.d.ts +28 -0
  224. package/dist/utility/wrun/wrun-cloud-opra-stamp.util.js +45 -0
  225. package/dist/utility/wrun/wrun-coin-lane-live.util.d.ts +18 -0
  226. package/dist/utility/wrun/wrun-coin-lane-live.util.js +47 -0
  227. package/dist/utility/wrun/wrun-deadline.util.js +2 -1
  228. package/dist/utility/wrun/wrun-debug-output.util.d.ts +39 -0
  229. package/dist/utility/wrun/wrun-debug-output.util.js +63 -0
  230. package/dist/utility/wrun/wrun-declared-warmup.util.d.ts +113 -0
  231. package/dist/utility/wrun/wrun-declared-warmup.util.js +181 -0
  232. package/dist/utility/wrun/wrun-draft-legend-note.util.d.ts +43 -0
  233. package/dist/utility/wrun/wrun-draft-legend-note.util.js +158 -0
  234. package/dist/utility/wrun/wrun-draft-overlay.util.d.ts +181 -0
  235. package/dist/utility/wrun/wrun-draft-overlay.util.js +357 -0
  236. package/dist/utility/wrun/wrun-draw-skipped.leaf.d.ts +16 -0
  237. package/dist/utility/wrun/wrun-draw-skipped.leaf.js +16 -0
  238. package/dist/utility/wrun/wrun-earnings-facts.util.d.ts +42 -0
  239. package/dist/utility/wrun/wrun-earnings-facts.util.js +131 -0
  240. package/dist/utility/wrun/wrun-first-run-depth.util.d.ts +32 -0
  241. package/dist/utility/wrun/wrun-first-run-depth.util.js +118 -0
  242. package/dist/utility/wrun/wrun-gate-plane-readers.util.d.ts +24 -0
  243. package/dist/utility/wrun/wrun-gate-plane-readers.util.js +31 -0
  244. package/dist/utility/wrun/wrun-held-lanes.util.d.ts +32 -0
  245. package/dist/utility/wrun/wrun-held-lanes.util.js +94 -0
  246. package/dist/utility/wrun/wrun-host-visible-clock.util.d.ts +2 -0
  247. package/dist/utility/wrun/wrun-host-visible-clock.util.js +17 -0
  248. package/dist/utility/wrun/wrun-host.service.d.ts +266 -0
  249. package/dist/utility/wrun/wrun-host.service.js +655 -0
  250. package/dist/utility/wrun/wrun-inert-legend.util.d.ts +33 -0
  251. package/dist/utility/wrun/wrun-inert-legend.util.js +125 -0
  252. package/dist/utility/wrun/wrun-input-requirements.leaf.d.ts +155 -0
  253. package/dist/utility/wrun/wrun-input-requirements.leaf.js +450 -0
  254. package/dist/utility/wrun/wrun-integration-route.util.d.ts +51 -0
  255. package/dist/utility/wrun/wrun-integration-route.util.js +59 -0
  256. package/dist/utility/wrun/wrun-latest-history.leaf.d.ts +8 -0
  257. package/dist/utility/wrun/wrun-latest-history.leaf.js +8 -0
  258. package/dist/utility/wrun/wrun-legend-hover.lazy.d.ts +12 -0
  259. package/dist/utility/wrun/wrun-legend-hover.lazy.js +96 -0
  260. package/dist/utility/wrun/wrun-lifecycle-runtime.util.d.ts +21 -0
  261. package/dist/utility/wrun/wrun-lifecycle-runtime.util.js +21 -0
  262. package/dist/utility/wrun/wrun-live-hidden-hold.util.d.ts +23 -0
  263. package/dist/utility/wrun/wrun-live-hidden-hold.util.js +13 -0
  264. package/dist/utility/wrun/wrun-live-intake.util.d.ts +374 -0
  265. package/dist/utility/wrun/wrun-live-intake.util.js +2027 -0
  266. package/dist/utility/wrun/wrun-live-patch.util.d.ts +116 -0
  267. package/dist/utility/wrun/wrun-live-patch.util.js +523 -0
  268. package/dist/utility/wrun/wrun-live-tick.util.d.ts +619 -0
  269. package/dist/utility/wrun/wrun-live-tick.util.js +4974 -0
  270. package/dist/utility/wrun/wrun-loading-owner.util.d.ts +58 -0
  271. package/dist/utility/wrun/wrun-loading-owner.util.js +89 -0
  272. package/dist/utility/wrun/wrun-official-scope.leaf.d.ts +29 -0
  273. package/dist/utility/wrun/wrun-official-scope.leaf.js +36 -0
  274. package/dist/utility/wrun/wrun-oi-lane.util.d.ts +27 -0
  275. package/dist/utility/wrun/wrun-oi-lane.util.js +42 -0
  276. package/dist/utility/wrun/wrun-opra-stats.leaf.d.ts +29 -10
  277. package/dist/utility/wrun/wrun-opra-stats.leaf.js +29 -10
  278. package/dist/utility/wrun/wrun-options-stop.util.d.ts +52 -0
  279. package/dist/utility/wrun/wrun-options-stop.util.js +123 -0
  280. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +719 -0
  281. package/dist/utility/wrun/wrun-overlay-drivers.util.js +1180 -0
  282. package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.d.ts +50 -0
  283. package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.js +131 -0
  284. package/dist/utility/wrun/wrun-overlay-lifecycle.util.d.ts +118 -0
  285. package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +466 -0
  286. package/dist/utility/wrun/wrun-overlay-metadata.util.d.ts +45 -0
  287. package/dist/utility/wrun/wrun-overlay-metadata.util.js +112 -0
  288. package/dist/utility/wrun/wrun-overlay-recovery.util.d.ts +114 -0
  289. package/dist/utility/wrun/wrun-overlay-recovery.util.js +971 -0
  290. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +858 -0
  291. package/dist/utility/wrun/wrun-overlay-run.util.js +11013 -0
  292. package/dist/utility/wrun/wrun-panel-mount.lazy.d.ts +10 -0
  293. package/dist/utility/wrun/wrun-panel-mount.lazy.js +68 -0
  294. package/dist/utility/wrun/wrun-panel-mount.util.d.ts +392 -0
  295. package/dist/utility/wrun/wrun-panel-mount.util.js +2346 -0
  296. package/dist/utility/wrun/wrun-param-map.util.d.ts +19 -4
  297. package/dist/utility/wrun/wrun-param-map.util.js +40 -47
  298. package/dist/utility/wrun/wrun-param-values.util.d.ts +9 -3
  299. package/dist/utility/wrun/wrun-param-values.util.js +5 -5
  300. package/dist/utility/wrun/wrun-pause-dim.util.d.ts +52 -0
  301. package/dist/utility/wrun/wrun-pause-dim.util.js +153 -0
  302. package/dist/utility/wrun/wrun-plot-gate.types.d.ts +23 -0
  303. package/dist/utility/wrun/wrun-plot-gate.types.js +7 -0
  304. package/dist/utility/wrun/wrun-prefix-cohort.util.d.ts +93 -0
  305. package/dist/utility/wrun/wrun-prefix-cohort.util.js +484 -0
  306. package/dist/utility/wrun/wrun-prefix-lanes.util.d.ts +114 -0
  307. package/dist/utility/wrun/wrun-prefix-lanes.util.js +486 -0
  308. package/dist/utility/wrun/wrun-prefix-proof.util.d.ts +317 -0
  309. package/dist/utility/wrun/wrun-prefix-proof.util.js +630 -0
  310. package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +73 -0
  311. package/dist/utility/wrun/wrun-refusal-surface.util.js +380 -0
  312. package/dist/utility/wrun/wrun-refusal-text.util.d.ts +15 -0
  313. package/dist/utility/wrun/wrun-refusal-text.util.js +40 -0
  314. package/dist/utility/wrun/wrun-replay-lane.util.d.ts +139 -0
  315. package/dist/utility/wrun/wrun-replay-lane.util.js +520 -0
  316. package/dist/utility/wrun/wrun-replay-rows.util.d.ts +21 -0
  317. package/dist/utility/wrun/wrun-replay-rows.util.js +172 -0
  318. package/dist/utility/wrun/wrun-row-source-factory.d.ts +53 -0
  319. package/dist/utility/wrun/wrun-row-source-factory.js +435 -0
  320. package/dist/utility/wrun/wrun-run-cells.util.d.ts +36 -0
  321. package/dist/utility/wrun/wrun-run-cells.util.js +46 -0
  322. package/dist/utility/wrun/wrun-run-interval-projection.types.d.ts +14 -0
  323. package/dist/utility/wrun/wrun-run-interval-projection.types.js +1 -0
  324. package/dist/utility/wrun/wrun-run-interval-session.util.d.ts +133 -0
  325. package/dist/utility/wrun/wrun-run-interval-session.util.js +121 -0
  326. package/dist/utility/wrun/wrun-run-interval.util.d.ts +98 -0
  327. package/dist/utility/wrun/wrun-run-interval.util.js +207 -0
  328. package/dist/utility/wrun/wrun-run-retained.util.d.ts +122 -0
  329. package/dist/utility/wrun/wrun-run-retained.util.js +255 -0
  330. package/dist/utility/wrun/wrun-sandbox-row-source.d.ts +184 -0
  331. package/dist/utility/wrun/wrun-sandbox-row-source.js +444 -0
  332. package/dist/utility/wrun/wrun-script-inputs.util.js +4 -4
  333. package/dist/utility/wrun/wrun-series-stream.util.d.ts +86 -0
  334. package/dist/utility/wrun/wrun-series-stream.util.js +537 -0
  335. package/dist/utility/wrun/wrun-sheet-remembered.util.d.ts +21 -0
  336. package/dist/utility/wrun/wrun-sheet-remembered.util.js +36 -0
  337. package/dist/utility/wrun/wrun-signal-sound-reasons.leaf.d.ts +7 -0
  338. package/dist/utility/wrun/wrun-signal-sound-reasons.leaf.js +12 -0
  339. package/dist/utility/wrun/wrun-socket-row-source.js +4 -2
  340. package/dist/utility/wrun/wrun-source-rows.util.d.ts +175 -3
  341. package/dist/utility/wrun/wrun-source-rows.util.js +294 -8
  342. package/dist/utility/wrun/wrun-stats-strip.util.d.ts +46 -0
  343. package/dist/utility/wrun/wrun-stats-strip.util.js +87 -0
  344. package/dist/utility/wrun/wrun-table-chrome.util.d.ts +163 -0
  345. package/dist/utility/wrun/wrun-table-chrome.util.js +557 -0
  346. package/dist/utility/wrun/wrun-text-params.util.d.ts +11 -6
  347. package/dist/utility/wrun/wrun-text-params.util.js +19 -30
  348. package/dist/utility/wrun/wrun-transient-rerun.util.d.ts +64 -0
  349. package/dist/utility/wrun/wrun-transient-rerun.util.js +317 -0
  350. package/dist/utility/wrun/wrun-twin-lookback.util.d.ts +10 -0
  351. package/dist/utility/wrun/wrun-twin-lookback.util.js +43 -0
  352. package/dist/utility/wrun/wrun-warmup-head-store.util.d.ts +41 -0
  353. package/dist/utility/wrun/wrun-warmup-head-store.util.js +120 -0
  354. package/dist/utility/wrun-alert-params.leaf.d.ts +24 -0
  355. package/dist/utility/wrun-alert-params.leaf.js +24 -0
  356. package/dist/utils/replay/replay-buffer-math.d.ts +148 -0
  357. package/dist/utils/replay/replay-buffer-math.js +684 -0
  358. package/dist/workers/wrun/wrun-abi-host.d.ts +190 -0
  359. package/dist/workers/wrun/wrun-abi-host.js +1201 -0
  360. package/dist/workers/wrun/wrun-engine-handler.d.ts +37 -0
  361. package/dist/workers/wrun/wrun-engine-handler.js +211 -0
  362. package/package.json +3 -3
@@ -0,0 +1,145 @@
1
+ /**
2
+ * Whether a run result fits the plot set an overlay has mounted (a leaf of
3
+ * utility/chart/kscript-titancharts-integration.util.ts; P2/inventory.md section 1.1): the plot-set growth a range
4
+ * refresh cannot merge, and the output matching it rests on (an output's key and plot type, its rows, a run result's
5
+ * output entries, the incoming outputs a live refresh plan matches against the mount). The wrun executor's integration
6
+ * route reads the fit. Pure: it reads package modules only (the run-result shape, the container key, the main-grid
7
+ * stages' plot type), no state, so it moves into the chart-host package with the phase 2 closure; the titan adapter
8
+ * imports the shared helpers back and re-exports the two fit functions.
9
+ */
10
+ import { isRecord } from './kscript-run-result-shape.util.js';
11
+ import { KSCRIPT_CONTAINER_OUTPUT_KEY } from './kscript-titancharts-container.util.js';
12
+ import { plotTypeOf } from './kscript-main-grid-stages.util.js';
13
+ export function outputRows(output) {
14
+ if (!isRecord(output))
15
+ return undefined;
16
+ for (const candidate of [output.data, output.rawData, output.activeData]) {
17
+ if (Array.isArray(candidate))
18
+ return candidate;
19
+ }
20
+ return undefined;
21
+ }
22
+ function mountedOutputKey(output, fallbackKey, options = {}) {
23
+ if (!isRecord(output))
24
+ return fallbackKey;
25
+ const includeId = options.includeId !== false;
26
+ for (const value of [
27
+ output.plotId,
28
+ includeId ? output.id : undefined,
29
+ output.key,
30
+ output.outputKey,
31
+ output.mainPlotKey,
32
+ output.plotKey,
33
+ ]) {
34
+ if (typeof value === 'string' && value.trim())
35
+ return value;
36
+ }
37
+ return fallbackKey;
38
+ }
39
+ export function outputDescriptor(output, fallbackKey, options = {}) {
40
+ return {
41
+ key: mountedOutputKey(output, fallbackKey, options),
42
+ plotType: isRecord(output) ? plotTypeOf(output) : undefined,
43
+ };
44
+ }
45
+ function descriptorsMatchByKey(current, incoming) {
46
+ if (!current.key || !incoming.key || current.key !== incoming.key)
47
+ return false;
48
+ if (current.plotType && incoming.plotType && current.plotType !== incoming.plotType)
49
+ return false;
50
+ return true;
51
+ }
52
+ export function runResultOutputEntries(runResult) {
53
+ if (!isRecord(runResult) || !isRecord(runResult.outputs))
54
+ return [];
55
+ return Object.entries(runResult.outputs).filter((entry) => isRecord(entry[1]));
56
+ }
57
+ export function buildIncomingLiveRefreshOutputs(runResult) {
58
+ return runResultOutputEntries(runResult).flatMap(([key, output]) => {
59
+ const descriptor = outputDescriptor(output, key);
60
+ if (!descriptor.key)
61
+ return [];
62
+ return [
63
+ {
64
+ key,
65
+ output,
66
+ descriptor,
67
+ rows: outputRows(output),
68
+ },
69
+ ];
70
+ });
71
+ }
72
+ export function findIncomingLiveRefreshOutput(outputByKey, mountedOutput, options = {}) {
73
+ const mountedDescriptor = outputDescriptor(mountedOutput, undefined, options);
74
+ if (!mountedDescriptor.key)
75
+ return undefined;
76
+ const incoming = outputByKey.get(mountedDescriptor.key);
77
+ if (!incoming || !descriptorsMatchByKey(mountedDescriptor, incoming.descriptor))
78
+ return undefined;
79
+ return incoming;
80
+ }
81
+ /**
82
+ * Incoming outputs (keys) the mounted-rows fast path cannot patch: no mounted
83
+ * row (parent or nested) matches their key / plot type, so a rows refresh would
84
+ * drop them. The local-run route treats a non-empty answer as plot-set growth
85
+ * and takes the remount (the field case: an order-book script whose fill
86
+ * plots only appear once the degraded book source lands). Same matching as
87
+ * the refresh plan, so the answer is exactly "what the plan would drop".
88
+ */
89
+ export function kscriptRunResultOutputsWithoutMountedRow(meta, runResult) {
90
+ const incoming = buildIncomingLiveRefreshOutputs(runResult);
91
+ if (incoming.length === 0)
92
+ return [];
93
+ const outputByKey = new Map(incoming.map((entry) => [entry.descriptor.key, entry]));
94
+ const matched = new Set();
95
+ const parent = findIncomingLiveRefreshOutput(outputByKey, meta, { includeId: false });
96
+ if (parent)
97
+ matched.add(parent.descriptor.key);
98
+ if (Array.isArray(meta.nestedMeta)) {
99
+ for (const nested of meta.nestedMeta) {
100
+ if (!isRecord(nested))
101
+ continue;
102
+ const hit = findIncomingLiveRefreshOutput(outputByKey, nested);
103
+ if (hit)
104
+ matched.add(hit.descriptor.key);
105
+ }
106
+ }
107
+ // The synthetic container output is the parent's own key, never a user
108
+ // plot: it must not read as growth on a legacy-mounted parent.
109
+ return incoming
110
+ .filter((entry) => !matched.has(entry.descriptor.key) && entry.key !== KSCRIPT_CONTAINER_OUTPUT_KEY)
111
+ .map((entry) => entry.key)
112
+ .sort();
113
+ }
114
+ /**
115
+ * The prepared outputs of a run result no mounted row matches (container and
116
+ * known-unmountable keys aside): the plot-set GROWTH a range refresh cannot
117
+ * merge. Judged against the mount, never against the previous result: the
118
+ * engine's live tick posts only the outputs that changed, so the last
119
+ * integrated result is not the plot set (2026-09-14 field dump: one page
120
+ * remount per reload from that comparison).
121
+ */
122
+ export function mountedPlotSetGrowth(meta, runResult, ignoreOutputKeys) {
123
+ return kscriptRunResultOutputsWithoutMountedRow(meta, runResult).filter((key) => !(ignoreOutputKeys?.has(key) ?? false));
124
+ }
125
+ /**
126
+ * Whether a run result fits the MOUNTED plot set: none of its outputs lacks a
127
+ * mounted row (mountedPlotSetGrowth), and a result carrying no plot outputs
128
+ * fits a mount carrying no plots (drawings-only scripts). Growth only: a
129
+ * mounted plot the run stopped carrying (an hline a script prints on some
130
+ * windows only) keeps its rows through a merge exactly as it does through a
131
+ * live tick, and a script whose only plot is a known-unmountable anchor line
132
+ * (drawings-only scripts) has nothing to grow. Requiring every mounted plot
133
+ * in the result remounted both on every page (2026-09-14 05:26 dump).
134
+ */
135
+ export function mountedPlotSetMatchesRunResult(meta, runResult, ignoreOutputKeys) {
136
+ if (!isRecord(runResult))
137
+ return false;
138
+ if (runResultOutputEntries(runResult).length === 0) {
139
+ // A drawings-only script posts no plot outputs at all: nothing to grow
140
+ // when nothing is mounted (2026-09-14 14:40 dump: one page remount per
141
+ // reload for Big Trades under the "no outputs never fits" rule).
142
+ return !Array.isArray(meta.nestedMeta) || meta.nestedMeta.length === 0;
143
+ }
144
+ return mountedPlotSetGrowth(meta, runResult, ignoreOutputKeys).length === 0;
145
+ }
@@ -0,0 +1,243 @@
1
+ /**
2
+ * Per-indicator kScript performance tracker.
3
+ *
4
+ * Records what is exactly attributable to one overlay on this device:
5
+ * - main-thread integration duration per applied update (bracketed by the
6
+ * overlay execution guard's measure calls),
7
+ * - main-thread render cost as ms of chart paint per second (read from
8
+ * titan's paint budget, or drained from its per-plot draw accounting, by
9
+ * the render-cost sampler), and
10
+ * - the counted volume of the run output it shipped (rows / series / bytes
11
+ * estimated from row shape, never by serializing the payload).
12
+ *
13
+ * Each signal keeps its own sliding-window median with cold-start exclusion
14
+ * and enter/exit hysteresis; the overlay is "slow" when EITHER signal
15
+ * convicts, and `slowCause` names which. The chart store surfaces the slow
16
+ * state as a legend diagnostic; the hard auto-pause stays owned by the
17
+ * overlay execution guard's breaker. Network/data-fetch time is deliberately
18
+ * never recorded here.
19
+ *
20
+ * Keys are overlay execution guard keys (`${chartIndex}:${indicatorId}`).
21
+ * This module must stay dependency-free (the guard imports it).
22
+ *
23
+ * Relationship to the gesture-apply cost EMA (gesture-apply-budget.util.ts):
24
+ * both observe main-thread apply cost per overlay, but they answer different
25
+ * questions with different lifecycles. The EMA is a fast-decaying pacing
26
+ * signal for the gesture scheduler (reset on gesture boundaries); this module
27
+ * is a windowed-median verdict with hysteresis for USER-FACING attribution,
28
+ * reset with the overlay's guard state. Merging them would couple scheduler
29
+ * pacing to legend UX; keep them separate on purpose.
30
+ *
31
+ * Samples pool live-tick applies with pan/historical applies (endMeasure has
32
+ * no stage tag). The median plus an enter threshold ABOVE the documented
33
+ * normal apply band (50-70 ms wake-herd merges, see GESTURE_APPLY_UNKNOWN_COST_MS)
34
+ * keeps burst pan applies from convicting a healthy overlay; per-stage
35
+ * sampling is a possible follow-up if field data shows false positives.
36
+ */
37
+ export declare const KSCRIPT_PERF_SLOW_ENTER_MEDIAN_MS = 80;
38
+ export declare const KSCRIPT_PERF_SLOW_EXIT_MEDIAN_MS = 50;
39
+ export declare const KSCRIPT_PERF_SAMPLE_WINDOW_MS = 60000;
40
+ export declare const KSCRIPT_PERF_MIN_SAMPLES = 5;
41
+ /** A slow verdict may retire on fewer samples than it took to convict. */
42
+ export declare const KSCRIPT_PERF_EXIT_MIN_SAMPLES = 3;
43
+ export declare const KSCRIPT_PERF_COLD_START_SKIP = 2;
44
+ export declare const KSCRIPT_PERF_MAX_SAMPLES = 24;
45
+ /**
46
+ * The chart apply budget's window (D11, GUARDS-12): every LIVE apply sample
47
+ * past the cold start is also kept in its key's ledger for this long, so the
48
+ * shed ladder can sum the main-thread live apply time of a chart's scripts per
49
+ * second (kscriptChartApplyLoad). The median ring above keeps 24 samples of
50
+ * every kind; this ledger keeps every live apply of the window.
51
+ */
52
+ export declare const KSCRIPT_CHART_APPLY_WINDOW_MS = 10000;
53
+ /**
54
+ * Render-cost thresholds, in ms of main-thread paint per second attributable
55
+ * to one indicator (a 1000 ms/s budget shared by everything on the page).
56
+ *
57
+ * Calibration from the two QA perf dumps that motivated the signal (per-drain
58
+ * sums over titan's per-plot draw accounting, normalized by drain spacing):
59
+ * - panning session, Liquidation Bands (8 deltaFillSpline plots):
60
+ * median 198.8 ms/s, p90 611.1, max 688.6 -> must convict.
61
+ * - same panning session, next-heaviest indicator: median 14.4 ms/s,
62
+ * max 38.0 -> must stay silent.
63
+ * - idle session, same script: median 7.8 ms/s, lone spike 73.9
64
+ * -> must stay silent.
65
+ * Enter at 100 ms/s sits 2x under the guilty median and 2.6x above the worst
66
+ * single innocent sample, so an innocent windowed median can never cross it.
67
+ *
68
+ * The exit threshold is wider than the apply signal's band because paint
69
+ * cost is pan-gated and bursty: the panning session contained a ~6 drain
70
+ * lull whose windowed median dipped to 46.3 ms/s before the storm resumed.
71
+ * Exiting there would flap the verdict and re-arm the toast mid-session, so
72
+ * exit sits BELOW inter-burst lull medians (46.3) and comfortably above
73
+ * genuine idle medians (7.8), which still retire the verdict promptly.
74
+ */
75
+ export declare const KSCRIPT_RENDER_SLOW_ENTER_MS_PER_SEC = 100;
76
+ export declare const KSCRIPT_RENDER_SLOW_EXIT_MS_PER_SEC = 30;
77
+ /**
78
+ * Display damping for the convicted paint rate. The chip communicates
79
+ * magnitude, not a live meter: re-rendering the legend for every median
80
+ * wiggle would rewrite Pinia diagnostics and force a titan legend refresh at
81
+ * drain cadence during the very pan storms being convicted. While convicted,
82
+ * the displayed rate is an anchor that re-anchors on a 2x WORSENING (the
83
+ * label must keep pace with a growing storm) but only on a 4x improvement:
84
+ * calibration lull medians dip 2-3x below the anchor without the episode
85
+ * ending, and a warning may briefly overstate but must not flap. Replaying
86
+ * the panning dump: 2 legend writes across the whole burst (conviction at
87
+ * ~140 ms, one re-anchor to ~330 ms).
88
+ */
89
+ export declare const KSCRIPT_RENDER_DISPLAY_REANCHOR_UP_RATIO = 2;
90
+ export declare const KSCRIPT_RENDER_DISPLAY_REANCHOR_DOWN_RATIO = 4;
91
+ export type KScriptPerfLevel = 'healthy' | 'slow';
92
+ export type KScriptPerfSlowCause = 'apply' | 'render' | 'both';
93
+ export interface KScriptPerfVolume {
94
+ rows: number;
95
+ series: number;
96
+ bytesEstimate: number;
97
+ /** Rows in the run window (outputRows.length). */
98
+ bars?: number;
99
+ /** Heatmap cells mounted (rows x levels over the heatmap children). */
100
+ cells?: number;
101
+ }
102
+ export interface KScriptPerfStats {
103
+ level: KScriptPerfLevel;
104
+ /** True only on the statsFor() call that flipped the level. */
105
+ transitioned: boolean;
106
+ /** Which signal(s) hold the slow verdict; null while healthy. */
107
+ slowCause: KScriptPerfSlowCause | null;
108
+ medianMs: number | null;
109
+ worstMs: number | null;
110
+ sampleCount: number;
111
+ /** Windowed median of ms-of-paint-per-second charged to this indicator. */
112
+ renderMsPerSecond: number | null;
113
+ /**
114
+ * The same windowed median, never damped: `renderMsPerSecond` holds the
115
+ * display anchor while render-convicted, and a decision (the shed ladder,
116
+ * kscript-perf-shed.util) must read the measured rate instead.
117
+ */
118
+ renderFreshMsPerSecond: number | null;
119
+ renderSampleCount: number;
120
+ volume: KScriptPerfVolume | null;
121
+ lastSampleAt: number | null;
122
+ }
123
+ /**
124
+ * One apply sample (the guard's measure, a wrun host build). `live`: the apply integrated a live tick (a local
125
+ * kScript's live update or its commit, a protected or hosted live frame, a wrun live tick). Every sample feeds the
126
+ * windowed median; only live ones also enter the chart's apply ledger (kscriptChartApplyLoad): a mount, a history
127
+ * page, a wake resync, a timeframe switch or a settings recompute is a one-off the chart sum must not pace.
128
+ */
129
+ export declare function recordKScriptPerfSample(key: string, ms: number, at?: number, live?: boolean): void;
130
+ /** One key's apply load inside the chart window. */
131
+ export interface KScriptChartApplyShare {
132
+ key: string;
133
+ /** Apply ms the key's samples carried in the window. */
134
+ ms: number;
135
+ /** The applies that carried them. */
136
+ applies: number;
137
+ }
138
+ /** A chart's apply load: what the chart apply budget (kscript-perf-shed.util) judges. */
139
+ export interface KScriptChartApplyLoad {
140
+ /** Apply ms per second over the window, the listed keys summed. */
141
+ msPerSecond: number;
142
+ /** Every listed key with an apply in the window, the costliest first. */
143
+ keys: KScriptChartApplyShare[];
144
+ }
145
+ /**
146
+ * The live apply load of one chart's keys (`includeKey` admits them, the
147
+ * ladder passes its paceable scripts) over the last
148
+ * KSCRIPT_CHART_APPLY_WINDOW_MS: the live applies this tracker sampled (past
149
+ * each key's cold start, outside a user settings burst), summed. The sum always divides by the whole window, so a window
150
+ * that is not full yet understates and never overstates. A key's reset drops
151
+ * its share at once (a step up the ladder starts it over).
152
+ */
153
+ export declare function kscriptChartApplyLoad(chartIndex: number, now?: number, includeKey?: (key: string) => boolean): KScriptChartApplyLoad;
154
+ /**
155
+ * One render sample, in ms of paint per second. `windowMs`: the rate is a mean over that span ending
156
+ * at `at` (the engine paint budget's rolling 10 s, paint-budget-arm.util); while that span reaches
157
+ * back before the entry's first render sample it still carries paint from before the add or the
158
+ * reset that started the entry (the mount, the previous shed rung's tier), so it is cold start too.
159
+ * Without it (a drained window) the count-only cold start below is the whole rule.
160
+ */
161
+ export declare function recordKScriptRenderCostSample(key: string, msPerSecond: number, at?: number, windowMs?: number): void;
162
+ export interface KScriptRenderCostFoldResult {
163
+ /** Indicators that received a render sample from this snapshot. */
164
+ recordedIndicatorIds: string[];
165
+ /** Snapshot keys whose owner segment matched no known overlay id. */
166
+ unmatchedOwnerKeys: number;
167
+ /** Draw cost carried by those unmatched keys, in ms. */
168
+ unmatchedOwnerMs: number;
169
+ }
170
+ /**
171
+ * Fold one drained per-plot draw-cost snapshot into render-cost samples.
172
+ *
173
+ * Snapshot keys are titan draw-accounting keys whose first `:` segment is the
174
+ * owning overlay id. Titan's container-native apply path mounts kScript
175
+ * nested plots as `<indicatorId>:<plotKey>` (nestedPlotObjectId), so their
176
+ * draw-cost keys read `<indicatorId>:<plotKey>:<renderer>`; native overlays
177
+ * read `<id>:<renderer>`. Titan's non-container-native apply path
178
+ * (updateMetadataWithRunResult -> applyRunResult without containerNative)
179
+ * keeps RAW output keys (or generated ids) as nested ids, so its draw-cost
180
+ * keys carry no indicator prefix and match nothing here.
181
+ *
182
+ * That is why absence is sample-STARVATION, never a zero sample: an
183
+ * indicator whose keys are unprefixed still paints, and manufacturing zeros
184
+ * for it would actively retire an earned verdict. Starved verdicts decay
185
+ * through window expiry instead. The orphaned cost stays observable through
186
+ * the unmatched-owner counters (owners matching neither a kScript indicator
187
+ * nor any other known overlay id).
188
+ *
189
+ * `sampleWindowMs`: every value is a rate averaged over that span (the engine
190
+ * paint budget's rolling window, read with `elapsedMs` 1000), passed on to
191
+ * recordKScriptRenderCostSample's windowed cold start.
192
+ */
193
+ export declare function recordKScriptRenderCostFromSnapshot(chartIndex: number, snapshot: Record<string, {
194
+ ms: number;
195
+ calls: number;
196
+ }>, elapsedMs: number, indicatorIds: readonly string[], at?: number, otherKnownOwnerIds?: readonly string[], sampleWindowMs?: number): KScriptRenderCostFoldResult;
197
+ export declare function recordKScriptPerfVolume(key: string, volume: KScriptPerfVolume | null): void;
198
+ /**
199
+ * Merge the parts of a run's volume that no canonical result carries (the bars of the run
200
+ * window, the heatmap cells mounted) into the key's last recorded volume. A key with no volume
201
+ * yet gets a zero-row one, so an extra recorded before the run's own volume is never lost.
202
+ */
203
+ export declare function recordKScriptPerfVolumeExtras(key: string, extras: {
204
+ bars?: number;
205
+ cells?: number;
206
+ }): void;
207
+ export declare function kscriptPerfStatsFor(key: string, now?: number): KScriptPerfStats;
208
+ /**
209
+ * Warning-toast gate, owned here so every tracker reset path also resets the
210
+ * latches. Two latches stack:
211
+ * - the EPISODE latch (slowToastConsumed) grants at most one toast per slow
212
+ * episode regardless of which signals convict, re-armed on recovery;
213
+ * - the MOUNT latch (renderSlowToastConsumed) additionally suppresses
214
+ * render-only re-convictions for the overlay's whole mount: 1 Hz sampling
215
+ * recovers on every pan/idle boundary, so an episodic latch alone would
216
+ * re-toast ordinary panning every couple of minutes. Only a tracker reset
217
+ * (remove, resume, chart teardown) re-arms it.
218
+ * An apply conviction is always new information and only defers to the
219
+ * episode latch, keeping shipped apply behavior unchanged.
220
+ */
221
+ export declare function consumeKScriptPerfSlowToastGate(key: string): boolean;
222
+ export declare function resetKScriptPerfTracking(key: string): void;
223
+ /** Guard keys are `${chartIndex}:${indicatorId}`; the trailing ':' keeps chart 1 from matching chart 10. */
224
+ export declare function resetKScriptPerfTrackingForChart(chartIndex: number): void;
225
+ export declare function resetAllKScriptPerfTracking(): void;
226
+ /**
227
+ * Counted volume of a run result's plot outputs. Reads array lengths and one
228
+ * sample row per output; never serializes. Bytes assume 8 bytes per value,
229
+ * which is the right order of magnitude for numeric plot rows crossing the
230
+ * worker boundary. `bars` is the run window's bar count: the result's own
231
+ * count (`barCount`, `bars`), else its timeline (`combinedTimes`), else its
232
+ * longest plot output (one row per bar). A canvas-only result (a browser-run
233
+ * Indicator's heatmaps, profiles and matrices ride `childOverlays`, never
234
+ * `outputs`) is measured too, with no plot rows; only a result with nothing
235
+ * to measure at all answers null, so a failed run's summary never replaces
236
+ * the last good volume.
237
+ */
238
+ export declare function measureKScriptRunResultVolume(runResult: unknown): KScriptPerfVolume | null;
239
+ /** "~240 ms" style bucket so legend text stays stable between minor median moves. */
240
+ export declare function formatKScriptPerfMedian(medianMs: number): string;
241
+ /** Same "~200 ms" bucketing for the paint-per-second rate. */
242
+ export declare function formatKScriptPerfRenderRate(msPerSecond: number): string;
243
+ export declare function formatKScriptPerfSummary(stats: KScriptPerfStats): string;