@orangecharts/wrun-chart-host 0.1.0 → 0.3.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 (337) hide show
  1. package/README.md +39 -6
  2. package/dist/constants/common.constants.d.ts +15 -0
  3. package/dist/constants/common.constants.js +23 -0
  4. package/dist/constants/data-source.constants.d.ts +1 -0
  5. package/dist/constants/data-source.constants.js +1 -0
  6. package/dist/constants/economic.constants.d.ts +39 -0
  7. package/dist/constants/economic.constants.js +77 -0
  8. package/dist/constants/etf-covered-coins.constants.d.ts +1 -0
  9. package/dist/constants/etf-covered-coins.constants.js +9 -0
  10. package/dist/constants/feature-flags.constants.d.ts +60 -0
  11. package/dist/constants/feature-flags.constants.js +308 -0
  12. package/dist/constants/feature-limits.constants.d.ts +134 -0
  13. package/dist/constants/feature-limits.constants.js +155 -0
  14. package/dist/constants/marketCapabilities.constants.d.ts +87 -0
  15. package/dist/constants/marketCapabilities.constants.js +213 -0
  16. package/dist/constants/option-venues.constants.d.ts +100 -0
  17. package/dist/constants/option-venues.constants.js +167 -0
  18. package/dist/constants/overlay-data.constants.d.ts +53 -0
  19. package/dist/constants/overlay-data.constants.js +80 -0
  20. package/dist/constants/pane-grid.constants.d.ts +15 -0
  21. package/dist/constants/pane-grid.constants.js +17 -0
  22. package/dist/constants/venue-presets.constants.d.ts +10 -0
  23. package/dist/constants/venue-presets.constants.js +22 -0
  24. package/dist/enums/chart.enum.d.ts +68 -0
  25. package/dist/enums/chart.enum.js +70 -0
  26. package/dist/helpers/data.helpers.d.ts +2 -0
  27. package/dist/helpers/data.helpers.js +14 -0
  28. package/dist/host-env.d.ts +161 -5
  29. package/dist/host-ports.types.d.ts +446 -0
  30. package/dist/host-ports.types.js +1 -0
  31. package/dist/index.d.ts +131 -0
  32. package/dist/index.js +131 -0
  33. package/dist/indicators/controls/technical-script/technical-script-input-rendering.d.ts +86 -0
  34. package/dist/indicators/controls/technical-script/technical-script-input-rendering.js +179 -0
  35. package/dist/interfaces/asset-venue.interface.d.ts +91 -0
  36. package/dist/interfaces/asset-venue.interface.js +1 -0
  37. package/dist/interfaces/cancel-reason.interface.d.ts +24 -0
  38. package/dist/interfaces/cancel-reason.interface.js +2 -0
  39. package/dist/interfaces/catalog-display.interface.d.ts +3 -0
  40. package/dist/interfaces/catalog-display.interface.js +1 -0
  41. package/dist/interfaces/cme-realtime.interface.d.ts +251 -0
  42. package/dist/interfaces/cme-realtime.interface.js +46 -0
  43. package/dist/interfaces/feed.interface.d.ts +80 -0
  44. package/dist/interfaces/feed.interface.js +7 -0
  45. package/dist/interfaces/market-kind.interface.d.ts +8 -0
  46. package/dist/interfaces/market-kind.interface.js +1 -0
  47. package/dist/interfaces/opra-realtime.interface.d.ts +224 -0
  48. package/dist/interfaces/opra-realtime.interface.js +105 -0
  49. package/dist/interfaces/option-instrument.interface.d.ts +32 -0
  50. package/dist/interfaces/option-instrument.interface.js +1 -0
  51. package/dist/interfaces/options-chain-scope.interface.d.ts +29 -0
  52. package/dist/interfaces/options-chain-scope.interface.js +7 -0
  53. package/dist/interfaces/prediction-market.interface.d.ts +88 -0
  54. package/dist/interfaces/prediction-market.interface.js +8 -0
  55. package/dist/interfaces/wrun-runtime.interface.d.ts +5 -0
  56. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +185 -0
  57. package/dist/kscript-data/controls/live-trades-merge.util.js +357 -0
  58. package/dist/settings-templates/frvp-fields.d.ts +27 -0
  59. package/dist/settings-templates/frvp-fields.js +108 -0
  60. package/dist/settings-templates/index.d.ts +119 -0
  61. package/dist/settings-templates/index.js +442 -0
  62. package/dist/settings-templates/indicator-fields.d.ts +56 -0
  63. package/dist/settings-templates/indicator-fields.js +793 -0
  64. package/dist/settings-templates/tool-rules.d.ts +59 -0
  65. package/dist/settings-templates/tool-rules.js +49 -0
  66. package/dist/settings-templates/tool-tables.generated.d.ts +2 -0
  67. package/dist/settings-templates/tool-tables.generated.js +1668 -0
  68. package/dist/utility/blk-market.util.d.ts +5 -0
  69. package/dist/utility/blk-market.util.js +12 -0
  70. package/dist/utility/chart/chart-load-phase.util.d.ts +32 -0
  71. package/dist/utility/chart/chart-load-phase.util.js +78 -0
  72. package/dist/utility/chart/cme-cache-context.util.d.ts +108 -0
  73. package/dist/utility/chart/cme-cache-context.util.js +166 -0
  74. package/dist/utility/chart/cme-session-bucket.util.d.ts +82 -0
  75. package/dist/utility/chart/cme-session-bucket.util.js +343 -0
  76. package/dist/utility/chart/cme-trade-calendar.util.d.ts +26 -0
  77. package/dist/utility/chart/cme-trade-calendar.util.js +147 -0
  78. package/dist/utility/chart/continuous-contracts.util.d.ts +138 -0
  79. package/dist/utility/chart/continuous-contracts.util.js +374 -0
  80. package/dist/utility/chart/feed-interval.util.d.ts +119 -0
  81. package/dist/utility/chart/feed-interval.util.js +321 -0
  82. package/dist/utility/chart/fetch-dedupe-policy.util.d.ts +110 -0
  83. package/dist/utility/chart/fetch-dedupe-policy.util.js +407 -0
  84. package/dist/utility/chart/footprint-band.util.d.ts +76 -0
  85. package/dist/utility/chart/footprint-band.util.js +205 -0
  86. package/dist/utility/chart/footprint-cell-identity.util.d.ts +82 -0
  87. package/dist/utility/chart/footprint-cell-identity.util.js +346 -0
  88. package/dist/utility/chart/formula-calendar.util.d.ts +27 -0
  89. package/dist/utility/chart/formula-calendar.util.js +59 -0
  90. package/dist/utility/chart/history-wall.util.d.ts +67 -0
  91. package/dist/utility/chart/history-wall.util.js +87 -0
  92. package/dist/utility/chart/index-mode.util.d.ts +66 -0
  93. package/dist/utility/chart/index-mode.util.js +360 -0
  94. package/dist/utility/chart/indicator-coverage-planner.util.d.ts +217 -0
  95. package/dist/utility/chart/indicator-coverage-planner.util.js +443 -0
  96. package/dist/utility/chart/indicator-coverage-state.util.d.ts +33 -0
  97. package/dist/utility/chart/indicator-coverage-state.util.js +110 -0
  98. package/dist/utility/chart/indicator-gap-detector.util.d.ts +127 -0
  99. package/dist/utility/chart/indicator-gap-detector.util.js +260 -0
  100. package/dist/utility/chart/indicator-gap-repair.util.d.ts +88 -0
  101. package/dist/utility/chart/indicator-gap-repair.util.js +177 -0
  102. package/dist/utility/chart/indicator-inflight-registry.util.d.ts +26 -0
  103. package/dist/utility/chart/indicator-inflight-registry.util.js +254 -0
  104. package/dist/utility/chart/interval-registry.util.d.ts +23 -0
  105. package/dist/utility/chart/interval-registry.util.js +83 -0
  106. package/dist/utility/chart/kscript-main-grid-stages.util.d.ts +21 -0
  107. package/dist/utility/chart/kscript-main-grid-stages.util.js +332 -0
  108. package/dist/utility/chart/legacy-exchange.leaf.d.ts +11 -0
  109. package/dist/utility/chart/legacy-exchange.leaf.js +43 -0
  110. package/dist/utility/chart/live-bucket.util.d.ts +66 -0
  111. package/dist/utility/chart/live-bucket.util.js +165 -0
  112. package/dist/utility/chart/market-session-schedule.util.d.ts +91 -0
  113. package/dist/utility/chart/market-session-schedule.util.js +337 -0
  114. package/dist/utility/chart/marketKind.util.d.ts +181 -0
  115. package/dist/utility/chart/marketKind.util.js +371 -0
  116. package/dist/utility/chart/om-panel.util.js +6 -0
  117. package/dist/utility/chart/om-widget.util.d.ts +4 -0
  118. package/dist/utility/chart/opra-read-access.leaf.d.ts +26 -0
  119. package/dist/utility/chart/opra-read-access.leaf.js +25 -0
  120. package/dist/utility/chart/prediction-identity.util.d.ts +159 -0
  121. package/dist/utility/chart/prediction-identity.util.js +236 -0
  122. package/dist/utility/chart/rth-session.util.d.ts +352 -0
  123. package/dist/utility/chart/rth-session.util.js +926 -0
  124. package/dist/utility/chart/titan-constants.pin.d.ts +43 -0
  125. package/dist/utility/chart/titan-constants.pin.js +50 -0
  126. package/dist/utility/chart/us-equities-session.util.d.ts +127 -0
  127. package/dist/utility/chart/us-equities-session.util.js +251 -0
  128. package/dist/utility/chart/wrun-bar-session-facts.util.d.ts +100 -0
  129. package/dist/utility/chart/wrun-bar-session-facts.util.js +354 -0
  130. package/dist/utility/chart/wrun-run-result.util.js +10 -0
  131. package/dist/utility/chart/wrun-wire-ref.util.d.ts +23 -0
  132. package/dist/utility/chart/wrun-wire-ref.util.js +16 -0
  133. package/dist/utility/common/safe-math-eval.d.ts +18 -0
  134. package/dist/utility/common/safe-math-eval.js +160 -0
  135. package/dist/utility/common/time.util.d.ts +134 -0
  136. package/dist/utility/common/time.util.js +428 -0
  137. package/dist/utility/common/transformations.util.d.ts +126 -0
  138. package/dist/utility/common/transformations.util.js +711 -0
  139. package/dist/utility/common/visible-timeout.util.d.ts +17 -0
  140. package/dist/utility/common/visible-timeout.util.js +75 -0
  141. package/dist/utility/exchange-normalization.util.d.ts +8 -0
  142. package/dist/utility/exchange-normalization.util.js +32 -0
  143. package/dist/utility/intl-locale.util.d.ts +2 -0
  144. package/dist/utility/intl-locale.util.js +28 -0
  145. package/dist/utility/number-format.util.d.ts +14 -1
  146. package/dist/utility/number-format.util.js +50 -19
  147. package/dist/utility/options/option-symbol.util.d.ts +28 -0
  148. package/dist/utility/options/option-symbol.util.js +176 -0
  149. package/dist/utility/options/option-trade-units.util.d.ts +190 -0
  150. package/dist/utility/options/option-trade-units.util.js +283 -0
  151. package/dist/utility/options/option-venue.util.d.ts +75 -0
  152. package/dist/utility/options/option-venue.util.js +85 -0
  153. package/dist/utility/pool-symbol.leaf.d.ts +34 -0
  154. package/dist/utility/pool-symbol.leaf.js +95 -0
  155. package/dist/utility/scriptEditor/wrun-runtime-diagnostics.leaf.d.ts +109 -0
  156. package/dist/utility/scriptEditor/wrun-runtime-diagnostics.leaf.js +302 -0
  157. package/dist/utility/symbol-selection/contract-expiry.util.d.ts +39 -0
  158. package/dist/utility/symbol-selection/contract-expiry.util.js +111 -0
  159. package/dist/utility/v2/gate-plane.util.d.ts +58 -0
  160. package/dist/utility/v2/gate-plane.util.js +99 -0
  161. package/dist/utility/v2/gate-session-latch.util.d.ts +22 -0
  162. package/dist/utility/v2/gate-session-latch.util.js +34 -0
  163. package/dist/utility/watchlist/import/tradingview-symbols.leaf.d.ts +76 -0
  164. package/dist/utility/watchlist/import/tradingview-symbols.leaf.js +221 -0
  165. package/dist/utility/wrun/sources/host-grid-landing.d.ts +15 -0
  166. package/dist/utility/wrun/sources/host-grid-landing.js +26 -0
  167. package/dist/utility/wrun/sources/lanes/bitfinex_funding.d.ts +27 -0
  168. package/dist/utility/wrun/sources/lanes/bitfinex_funding.js +85 -0
  169. package/dist/utility/wrun/sources/lanes/economic.d.ts +27 -0
  170. package/dist/utility/wrun/sources/lanes/economic.js +79 -0
  171. package/dist/utility/wrun/sources/lanes/etf_holdings.d.ts +35 -0
  172. package/dist/utility/wrun/sources/lanes/etf_holdings.js +165 -0
  173. package/dist/utility/wrun/sources/lanes/etf_premium.d.ts +19 -0
  174. package/dist/utility/wrun/sources/lanes/etf_premium.js +114 -0
  175. package/dist/utility/wrun/sources/lanes/ethena_positions.d.ts +30 -0
  176. package/dist/utility/wrun/sources/lanes/ethena_positions.js +51 -0
  177. package/dist/utility/wrun/sources/lanes/index.d.ts +2 -0
  178. package/dist/utility/wrun/sources/lanes/index.js +32 -0
  179. package/dist/utility/wrun/sources/lanes/long_short_ratio.d.ts +17 -0
  180. package/dist/utility/wrun/sources/lanes/long_short_ratio.js +47 -0
  181. package/dist/utility/wrun/sources/lanes/option_daily.d.ts +30 -0
  182. package/dist/utility/wrun/sources/lanes/option_daily.js +53 -0
  183. package/dist/utility/wrun/sources/lanes/option_stats_10m.d.ts +23 -0
  184. package/dist/utility/wrun/sources/lanes/option_stats_10m.js +20 -0
  185. package/dist/utility/wrun/sources/lanes/options_flow.d.ts +50 -0
  186. package/dist/utility/wrun/sources/lanes/options_flow.js +155 -0
  187. package/dist/utility/wrun/sources/lanes/options_oi.d.ts +29 -0
  188. package/dist/utility/wrun/sources/lanes/options_oi.js +59 -0
  189. package/dist/utility/wrun/sources/lanes/options_volume.d.ts +38 -0
  190. package/dist/utility/wrun/sources/lanes/options_volume.js +63 -0
  191. package/dist/utility/wrun/sources/lanes/series.d.ts +67 -0
  192. package/dist/utility/wrun/sources/lanes/series.js +321 -0
  193. package/dist/utility/wrun/sources/lanes/token_supply.d.ts +30 -0
  194. package/dist/utility/wrun/sources/lanes/token_supply.js +145 -0
  195. package/dist/utility/wrun/sources/lanes/treasury_balance.d.ts +25 -0
  196. package/dist/utility/wrun/sources/lanes/treasury_balance.js +47 -0
  197. package/dist/utility/wrun/sources/lanes/volatility_index.d.ts +21 -0
  198. package/dist/utility/wrun/sources/lanes/volatility_index.js +11 -0
  199. package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +196 -0
  200. package/dist/utility/wrun/sources/opra-option-lanes.util.js +446 -0
  201. package/dist/utility/wrun/sources/registry.d.ts +21 -0
  202. package/dist/utility/wrun/sources/registry.js +207 -0
  203. package/dist/utility/wrun/sources/row-lane-registry.d.ts +28 -0
  204. package/dist/utility/wrun/sources/row-lane-registry.js +230 -0
  205. package/dist/utility/wrun/sources/row-lanes/index.d.ts +2 -0
  206. package/dist/utility/wrun/sources/row-lanes/index.js +12 -0
  207. package/dist/utility/wrun/sources/row-lanes/option_contract_flow.d.ts +2 -0
  208. package/dist/utility/wrun/sources/row-lanes/option_contract_flow.js +38 -0
  209. package/dist/utility/wrun/sources/row-lanes/option_contract_state.d.ts +6 -0
  210. package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +70 -0
  211. package/dist/utility/wrun/sources/row-lanes/option_prints.d.ts +4 -0
  212. package/dist/utility/wrun/sources/row-lanes/option_prints.js +191 -0
  213. package/dist/utility/wrun/sources/row-lanes/option_strikes.d.ts +13 -0
  214. package/dist/utility/wrun/sources/row-lanes/option_strikes.js +137 -0
  215. package/dist/utility/wrun/sources/row-lanes/option_surface.d.ts +38 -0
  216. package/dist/utility/wrun/sources/row-lanes/option_surface.js +150 -0
  217. package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +275 -0
  218. package/dist/utility/wrun/sources/wrun-poll-lane.types.js +26 -0
  219. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +224 -0
  220. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +394 -0
  221. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +283 -0
  222. package/dist/utility/wrun/sources/wrun-row-lane.types.js +16 -0
  223. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +205 -0
  224. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +469 -0
  225. package/dist/utility/wrun/wrun-browser-sources.leaf.d.ts +28 -0
  226. package/dist/utility/wrun/wrun-browser-sources.leaf.js +66 -0
  227. package/dist/utility/wrun/wrun-cloud-record.util.d.ts +65 -0
  228. package/dist/utility/wrun/wrun-cloud-record.util.js +121 -0
  229. package/dist/utility/wrun/wrun-color-settings.util.js +1 -1
  230. package/dist/utility/wrun/wrun-daily-lane.util.d.ts +95 -0
  231. package/dist/utility/wrun/wrun-daily-lane.util.js +297 -0
  232. package/dist/utility/wrun/wrun-deadline.util.d.ts +52 -0
  233. package/dist/utility/wrun/wrun-deadline.util.js +82 -0
  234. package/dist/utility/wrun/wrun-etf-flow-lane.util.d.ts +94 -0
  235. package/dist/utility/wrun/wrun-etf-flow-lane.util.js +224 -0
  236. package/dist/utility/wrun/wrun-etf-funds.util.d.ts +82 -0
  237. package/dist/utility/wrun/wrun-etf-funds.util.js +242 -0
  238. package/dist/utility/wrun/wrun-failure-cause.d.ts +39 -0
  239. package/dist/utility/wrun/wrun-failure-cause.js +94 -0
  240. package/dist/utility/wrun/wrun-frames.d.ts +28 -3
  241. package/dist/utility/wrun/wrun-frames.js +132 -52
  242. package/dist/utility/wrun/wrun-hosted-wire-caps.d.ts +167 -4
  243. package/dist/utility/wrun/wrun-hosted-wire-caps.js +47 -2
  244. package/dist/utility/wrun/wrun-hosted-wire.util.d.ts +5 -2
  245. package/dist/utility/wrun/wrun-hosted-wire.util.js +4 -2
  246. package/dist/utility/wrun/wrun-lane-refusal.leaf.d.ts +22 -0
  247. package/dist/utility/wrun/wrun-lane-refusal.leaf.js +32 -0
  248. package/dist/utility/wrun/wrun-lane-warmup.util.d.ts +18 -0
  249. package/dist/utility/wrun/wrun-lane-warmup.util.js +112 -0
  250. package/dist/utility/wrun/wrun-leg-close.util.d.ts +57 -0
  251. package/dist/utility/wrun/wrun-leg-close.util.js +187 -0
  252. package/dist/utility/wrun/wrun-leg-fetch.util.d.ts +144 -0
  253. package/dist/utility/wrun/wrun-leg-fetch.util.js +212 -0
  254. package/dist/utility/wrun/wrun-leg-stream-classes.d.ts +73 -0
  255. package/dist/utility/wrun/wrun-leg-stream-classes.js +86 -0
  256. package/dist/utility/wrun/wrun-levels-child.util.d.ts +101 -6
  257. package/dist/utility/wrun/wrun-levels-child.util.js +335 -157
  258. package/dist/utility/wrun/wrun-memory-clamp.util.d.ts +33 -0
  259. package/dist/utility/wrun/wrun-memory-clamp.util.js +146 -0
  260. package/dist/utility/wrun/wrun-odds-template-market.util.d.ts +51 -0
  261. package/dist/utility/wrun/wrun-odds-template-market.util.js +251 -0
  262. package/dist/utility/wrun/wrun-opra-flow.leaf.d.ts +65 -0
  263. package/dist/utility/wrun/wrun-opra-flow.leaf.js +94 -0
  264. package/dist/utility/wrun/wrun-opra-lane.util.d.ts +47 -0
  265. package/dist/utility/wrun/wrun-opra-lane.util.js +58 -0
  266. package/dist/utility/wrun/wrun-opra-stats.leaf.d.ts +30 -0
  267. package/dist/utility/wrun/wrun-opra-stats.leaf.js +96 -0
  268. package/dist/utility/wrun/wrun-opra-underlying.util.d.ts +12 -0
  269. package/dist/utility/wrun/wrun-opra-underlying.util.js +1 -0
  270. package/dist/utility/wrun/wrun-option-contract-flow.util.d.ts +142 -0
  271. package/dist/utility/wrun/wrun-option-contract-flow.util.js +451 -0
  272. package/dist/utility/wrun/wrun-option-knobs.util.d.ts +43 -0
  273. package/dist/utility/wrun/wrun-option-knobs.util.js +81 -0
  274. package/dist/utility/wrun/wrun-option-prints.util.d.ts +144 -0
  275. package/dist/utility/wrun/wrun-option-prints.util.js +356 -0
  276. package/dist/utility/wrun/wrun-option-summary-lane.util.d.ts +102 -0
  277. package/dist/utility/wrun/wrun-option-summary-lane.util.js +143 -0
  278. package/dist/utility/wrun/wrun-options-chain.util.d.ts +308 -0
  279. package/dist/utility/wrun/wrun-options-chain.util.js +502 -0
  280. package/dist/utility/wrun/wrun-overlay-identity.util.d.ts +9 -4
  281. package/dist/utility/wrun/wrun-overlay-identity.util.js +16 -6
  282. package/dist/utility/wrun/wrun-pack.util.d.ts +6 -2
  283. package/dist/utility/wrun/wrun-pack.util.js +13 -3
  284. package/dist/utility/wrun/wrun-param-map.util.d.ts +298 -0
  285. package/dist/utility/wrun/wrun-param-map.util.js +581 -0
  286. package/dist/utility/wrun/wrun-param-values.util.d.ts +8 -0
  287. package/dist/utility/wrun/wrun-param-values.util.js +8 -0
  288. package/dist/utility/wrun/wrun-pin-spelling.util.d.ts +149 -0
  289. package/dist/utility/wrun/wrun-pin-spelling.util.js +523 -0
  290. package/dist/utility/wrun/wrun-pin-venues.util.d.ts +116 -0
  291. package/dist/utility/wrun/wrun-pin-venues.util.js +320 -0
  292. package/dist/utility/wrun/wrun-pinned-interval.util.d.ts +20 -0
  293. package/dist/utility/wrun/wrun-pinned-interval.util.js +47 -0
  294. package/dist/utility/wrun/wrun-present-bits.util.d.ts +37 -0
  295. package/dist/utility/wrun/wrun-present-bits.util.js +73 -0
  296. package/dist/utility/wrun/wrun-protocol-pending.util.d.ts +33 -0
  297. package/dist/utility/wrun/wrun-protocol-pending.util.js +57 -0
  298. package/dist/utility/wrun/wrun-refusal.util.d.ts +95 -7
  299. package/dist/utility/wrun/wrun-refusal.util.js +314 -18
  300. package/dist/utility/wrun/wrun-registry-errors.util.d.ts +1 -14
  301. package/dist/utility/wrun/wrun-registry-errors.util.js +0 -16
  302. package/dist/utility/wrun/wrun-render-select.util.js +1 -0
  303. package/dist/utility/wrun/wrun-row-market.util.d.ts +29 -0
  304. package/dist/utility/wrun/wrun-row-market.util.js +92 -0
  305. package/dist/utility/wrun/wrun-row-source.d.ts +158 -0
  306. package/dist/utility/wrun/wrun-row-source.js +75 -0
  307. package/dist/utility/wrun/wrun-run-health.util.d.ts +155 -0
  308. package/dist/utility/wrun/wrun-run-health.util.js +273 -0
  309. package/dist/utility/wrun/wrun-socket-row-source.d.ts +439 -0
  310. package/dist/utility/wrun/wrun-socket-row-source.js +1689 -0
  311. package/dist/utility/wrun/wrun-socket-session-losses.util.d.ts +18 -0
  312. package/dist/utility/wrun/wrun-socket-session-losses.util.js +25 -0
  313. package/dist/utility/wrun/wrun-source-rows.util.d.ts +911 -0
  314. package/dist/utility/wrun/wrun-source-rows.util.js +2597 -0
  315. package/dist/utility/wrun/wrun-symbol-code.util.d.ts +32 -0
  316. package/dist/utility/wrun/wrun-symbol-code.util.js +56 -0
  317. package/dist/utility/wrun/wrun-tape-source.util.d.ts +82 -0
  318. package/dist/utility/wrun/wrun-tape-source.util.js +151 -0
  319. package/dist/utility/wrun/wrun-tier-grid.util.d.ts +137 -0
  320. package/dist/utility/wrun/wrun-tier-grid.util.js +279 -0
  321. package/dist/utility/wrun/wrun-trades-lane.util.d.ts +52 -0
  322. package/dist/utility/wrun/wrun-trades-lane.util.js +58 -0
  323. package/dist/utility/wrun/wrun-volume-profile-lane.util.d.ts +41 -0
  324. package/dist/utility/wrun/wrun-volume-profile-lane.util.js +66 -0
  325. package/dist/utility/wrun-display-name.util.d.ts +33 -0
  326. package/dist/utility/wrun-display-name.util.js +64 -0
  327. package/dist/workers/constants/kscript-transport-codes.d.ts +15 -0
  328. package/dist/workers/constants/kscript-transport-codes.js +15 -0
  329. package/dist/workers/constants/socket-slots.d.ts +574 -0
  330. package/dist/workers/constants/socket-slots.js +539 -0
  331. package/dist/workers/utils/number.worker.util.d.ts +5 -0
  332. package/dist/workers/utils/number.worker.util.js +10 -0
  333. package/dist/workers/utils/time.worker.util.d.ts +12 -0
  334. package/dist/workers/utils/time.worker.util.js +24 -0
  335. package/dist/workers/utils/volume-profile.worker.util.d.ts +200 -0
  336. package/dist/workers/utils/volume-profile.worker.util.js +631 -0
  337. package/package.json +10 -4
@@ -0,0 +1,279 @@
1
+ /**
2
+ * The host-grid rules of the per-bar wrun source classes (UW-PARITY source contract v2, global rule 9),
3
+ * pure: which backend tier builds each host bar, and how a tier's rows land on the host chart's bars.
4
+ *
5
+ * The tier rule. A per-bar class is stored at a few backend tiers (a 1m aggregate kept 7 days, a 5m one kept
6
+ * 30, an hourly and a daily one kept for good: each lane names its own). A host bar is built from the
7
+ * FINEST tier that fits it (`wrunTierFitsBar`: its width divides the bar, and the bar's open sits on the
8
+ * tier's grid, so the bar is a whole number of the tier's buckets) and still retains it. The grids: a stock
9
+ * chart's anchored bars open at 09:30 New York (13:30Z or 14:30Z, so 1m, 5m and 30m buckets fit a 1h bar and an
10
+ * hourly one does not); an OPRA contract chart's bars, and every daily or calendar bar, open on UTC. A bar no
11
+ * fitting tier retains any more is PARTIAL: bit 14 of its tuples' `present` mask, or one marker tuple when it
12
+ * holds none (wrun-present-bits.util). The fit is read off the bar's own open, so a DST move needs no table.
13
+ *
14
+ * The coarsest choice (`WrunTierChoice`, a lane's opt-in; every other lane keeps the finest). A lane whose fold reads
15
+ * the same per-bar values from any fitting tier (a per-contract sum: the backend rolls each tier up from the 1m one)
16
+ * reads each bar from the COARSEST fitting tier that retains it and already serves the whole bar, so a 5m bar reads
17
+ * one 5m bucket instead of five 1m ones and a sealed daily bar one day bucket instead of its minutes. A tier with a
18
+ * `servedLagMs` (an hourly or daily aggregate materialized after its buckets close, a governed tier waiting out a
19
+ * delayed read's window) serves a bar only once the bar has ended that long ago, so the forming bar, and a bar that
20
+ * closed inside the lag, read the next finer tier that serves them (the finest when none does). Which bars are
21
+ * partial does not change.
22
+ *
23
+ * The landing. A tier's rows are stamped at their bucket opens; each lands on the host bar holding it
24
+ * (`liveBucketStartMs` over the chart's bar-grid venue, `liveBucketVenueOf(metadata)`: the 09:30-anchored
25
+ * bucket of a regular-session stock chart, the UTC floor elsewhere; an off-session row lands nowhere), and the
26
+ * bar's rows fold by the class's landing: a FLOW sums (every tuple of a celled flow is kept, in time order; a
27
+ * scalar column sums its finite values), a SNAPSHOT takes the newest SEALED row of the bar (a row whose tier
28
+ * bucket has closed by the clock: a forming bucket is never read as the bar's state).
29
+ */
30
+ import { barEndMs, calendarMonthsOfMs } from '../chart/calendar-interval.util.js';
31
+ import { liveBucketStartMs } from '../chart/live-bucket.util.js';
32
+ import { wrunPartialMarkerTuple, wrunTuplesMarkedPartial } from './wrun-present-bits.util.js';
33
+ const DAY_MS = 86_400_000;
34
+ /** The span a tier must divide: the bar's own, or a day for a calendar bar (its span is no fixed number). */
35
+ function divisionSpanMs(barMs) {
36
+ return calendarMonthsOfMs(barMs) !== null ? DAY_MS : barMs;
37
+ }
38
+ /** Whether a tier fits a host bar: its width divides the bar's span (a day for a calendar bar) and the bar's
39
+ * open sits on the tier's UTC grid, so the bar is a whole number of the tier's buckets. */
40
+ export function wrunTierFitsBar(tier, barOpenMs, barMs) {
41
+ const span = divisionSpanMs(barMs);
42
+ if (!(tier.ms > 0) || !(span > 0) || !Number.isFinite(barOpenMs))
43
+ return false;
44
+ return span % tier.ms === 0 && barOpenMs % tier.ms === 0;
45
+ }
46
+ /** Whether a tier still holds a host bar whole at `nowMs`: kept for good, or the bar opened inside the
47
+ * retention. */
48
+ function tierRetainsBar(tier, barOpenMs, nowMs) {
49
+ return tier.retentionMs === undefined || barOpenMs >= nowMs - tier.retentionMs;
50
+ }
51
+ /** The tiers that fit a host bar, finest first. */
52
+ function fittingTiers(tiers, barOpenMs, barMs) {
53
+ return tiers.filter((tier) => wrunTierFitsBar(tier, barOpenMs, barMs)).sort((a, b) => a.ms - b.ms);
54
+ }
55
+ /** The finest tier that fits a host bar (the one its live bar is built from), or undefined when none fits
56
+ * (a bar finer than every tier, or one whose open sits on no tier's grid). */
57
+ export function wrunFinestTier(tiers, barOpenMs, barMs) {
58
+ return fittingTiers(tiers, barOpenMs, barMs)[0];
59
+ }
60
+ /** The coarsest of a bar's retaining tiers (finest first) that already serves the whole bar: a tier with a
61
+ * `servedLagMs` serves it once the bar ended that long ago. None serving: the finest (the finest choice's tier). */
62
+ function coarsestServingTier(retaining, barOpenMs, barMs, nowMs) {
63
+ const barEnd = barEndMs(barOpenMs, barMs);
64
+ for (let at = retaining.length - 1; at > 0; at -= 1) {
65
+ const lag = retaining[at].servedLagMs;
66
+ if (lag === undefined || barEnd + lag <= nowMs)
67
+ return retaining[at];
68
+ }
69
+ return retaining[0];
70
+ }
71
+ /** The tier rule over a host grid's bar opens (ascending): each bar's fitting tier that still retains it (the
72
+ * finest, or with `choice: 'coarsest'` the coarsest that already serves the bar), else partial. */
73
+ export function wrunBarTiers(args) {
74
+ return args.barOpens.map((barOpenMs) => {
75
+ const fitting = fittingTiers(args.tiers, barOpenMs, args.barMs);
76
+ const retaining = fitting.filter((tier) => tierRetainsBar(tier, barOpenMs, args.nowMs));
77
+ if (retaining.length > 0) {
78
+ const tier = args.choice === 'coarsest' ? coarsestServingTier(retaining, barOpenMs, args.barMs, args.nowMs) : retaining[0];
79
+ return { barOpenMs, tier, partial: false };
80
+ }
81
+ return fitting.length > 0 ? { barOpenMs, tier: fitting[0], partial: true } : { barOpenMs, partial: true };
82
+ });
83
+ }
84
+ /** The asks a tier plan needs: each run of consecutive bars that read the same tier, as one segment (a
85
+ * partial bar asks nothing, it is marked instead). */
86
+ export function wrunTierSegments(barTiers, barMs) {
87
+ const segments = [];
88
+ let open;
89
+ for (const bar of barTiers) {
90
+ if (bar.partial || bar.tier === undefined) {
91
+ open = undefined;
92
+ continue;
93
+ }
94
+ const endMs = barEndMs(bar.barOpenMs, barMs);
95
+ if (open !== undefined && open.tier.key === bar.tier.key) {
96
+ open.toMs = endMs;
97
+ continue;
98
+ }
99
+ open = { tier: bar.tier, fromMs: bar.barOpenMs, toMs: endMs };
100
+ segments.push(open);
101
+ }
102
+ return segments;
103
+ }
104
+ /** Where a host-grid lane asks its tier rows through, for a chart window whose last bar opens at
105
+ * `lastBarOpenMs`: that bar's END (`barEndMs`: its calendar close on a calendar chart, whose length is an
106
+ * average), so the buckets inside the forming bar are asked too (a bar join asks the last open alone: its rows
107
+ * are stamped at the chart's opens). */
108
+ export function wrunHostGridFetchTo(lastBarOpenMs, intervalMs) {
109
+ return intervalMs > 0 ? barEndMs(lastBarOpenMs, intervalMs) : lastBarOpenMs;
110
+ }
111
+ /**
112
+ * The asks a host-grid lane makes over a chart window: with no tiers, ONE ask from the first bar's open to the
113
+ * last bar's end; with tiers, one ask per run of bars on one tier (`wrunBarTiers` under the lane's `choice`, then
114
+ * `wrunTierSegments`), and the bars no fitting tier retains, which ask nothing and are partial. `barOpens` are the
115
+ * host bars of the window, ascending (`liveBucketStartsInRange` over the chart's bar grid).
116
+ */
117
+ export function wrunHostGridAsks(args) {
118
+ const { barOpens, intervalMs } = args;
119
+ if (barOpens.length === 0)
120
+ return { asks: [], partialBars: [] };
121
+ if (args.tiers === undefined || args.tiers.length === 0) {
122
+ return {
123
+ asks: [{ fromMs: barOpens[0], toMs: wrunHostGridFetchTo(barOpens[barOpens.length - 1], intervalMs) }],
124
+ partialBars: [],
125
+ };
126
+ }
127
+ const bars = wrunBarTiers({
128
+ tiers: args.tiers,
129
+ barOpens,
130
+ barMs: intervalMs,
131
+ nowMs: args.nowMs,
132
+ choice: args.choice,
133
+ });
134
+ return {
135
+ asks: wrunTierSegments(bars, intervalMs),
136
+ partialBars: bars.filter((bar) => bar.partial).map((bar) => bar.barOpenMs),
137
+ };
138
+ }
139
+ /**
140
+ * The asks that read again, one tier coarser, the host bars a snapshot's tier answered nothing for (OPTIONS-PORT D12:
141
+ * a CME surface keeps its settlement DAY rows while its 5m tier fills only inside a session where rows exist, so a
142
+ * daily bar whose 5m answer is empty reads its DAY row, never nothing). Each bar `asks` covered at a tier that holds no
143
+ * landed row (`landedBars`) is read from the next coarser tier that fits it and still retains it; one ask per run of
144
+ * such consecutive bars on one tier (a bar holding a row, or with no coarser tier, ends the run). Empty when every
145
+ * asked bar landed a row or none has a coarser tier (an intraday bar under a day tier).
146
+ */
147
+ export function wrunHostGridFallbackAsks(args) {
148
+ const bars = args.barOpens.map((barOpenMs) => {
149
+ const asked = args.asks.find((ask) => ask.tier !== undefined && barOpenMs >= ask.fromMs && barOpenMs < ask.toMs);
150
+ const finer = asked?.tier;
151
+ if (finer === undefined || args.landedBars.has(barOpenMs))
152
+ return { barOpenMs, partial: true };
153
+ const coarser = fittingTiers(args.tiers, barOpenMs, args.intervalMs).find((tier) => tier.ms > finer.ms && tierRetainsBar(tier, barOpenMs, args.nowMs));
154
+ // A bar with nothing coarser to read ends the run like a landed one (`wrunTierSegments` asks no partial bar).
155
+ return coarser === undefined ? { barOpenMs, partial: true } : { barOpenMs, tier: coarser, partial: false };
156
+ });
157
+ return wrunTierSegments(bars, args.intervalMs);
158
+ }
159
+ /** The host bar a tier row stamped `tsMs` lands on (`liveBucketStartMs` over the chart's bar-grid venue),
160
+ * or null when it lands on none (off session on an anchored grid). */
161
+ export function wrunHostBarOf(tsMs, intervalMs, barGrid) {
162
+ if (!Number.isFinite(tsMs) || !(intervalMs > 0))
163
+ return null;
164
+ return liveBucketStartMs(tsMs, intervalMs, barGrid ?? undefined);
165
+ }
166
+ /** A tier row is sealed once its bucket has closed by the clock (`tierMs` absent: every row is). */
167
+ function sealed(tsMs, tierMs, nowMs) {
168
+ return tierMs === undefined || !(tierMs > 0) || tsMs + tierMs <= nowMs;
169
+ }
170
+ /** Rows grouped by the host bar each lands on, ascending, every group's rows in time order. */
171
+ function groupByHostBar(rows, intervalMs, barGrid) {
172
+ const groups = new Map();
173
+ for (const row of rows) {
174
+ const ts = Number(row[0]);
175
+ const bar = wrunHostBarOf(ts, intervalMs, barGrid);
176
+ if (bar === null)
177
+ continue;
178
+ const group = groups.get(bar);
179
+ if (group === undefined)
180
+ groups.set(bar, [row]);
181
+ else
182
+ group.push(row);
183
+ }
184
+ return [...groups.entries()]
185
+ .sort((a, b) => a[0] - b[0])
186
+ .map(([barOpenMs, group]) => ({ barOpenMs, rows: group.sort((a, b) => Number(a[0]) - Number(b[0])) }));
187
+ }
188
+ /**
189
+ * Scalar lane rows `[ts, ...columns]` at a tier landed on the host bars `[barOpen, ...columns]`, ascending:
190
+ * a flow sums each column's finite values (a column with none in the bar stays null: the `missing` policy
191
+ * speaks for it, never a made-up 0), a snapshot takes the newest sealed row of the bar whole (a bar holding
192
+ * no sealed row yet has none).
193
+ */
194
+ export function wrunLandScalarRowsOnHostBars(rows, landing, grid) {
195
+ const landed = [];
196
+ for (const group of groupByHostBar(rows, grid.intervalMs, grid.barGrid)) {
197
+ if (landing === 'snapshot') {
198
+ const newest = [...group.rows].reverse().find((row) => sealed(Number(row[0]), grid.tierMs, grid.nowMs));
199
+ if (newest === undefined)
200
+ continue;
201
+ landed.push([group.barOpenMs, ...Array.from(newest).slice(1).map(cellOrNull)]);
202
+ continue;
203
+ }
204
+ const width = Math.max(...group.rows.map((row) => row.length));
205
+ const sums = new Array(Math.max(0, width - 1)).fill(null);
206
+ for (const row of group.rows) {
207
+ for (let column = 1; column < row.length; column += 1) {
208
+ const value = cellOrNull(row[column]);
209
+ if (value === null)
210
+ continue;
211
+ sums[column - 1] = (sums[column - 1] ?? 0) + value;
212
+ }
213
+ }
214
+ landed.push([group.barOpenMs, ...sums]);
215
+ }
216
+ return landed;
217
+ }
218
+ function cellOrNull(cell) {
219
+ if (cell === null || cell === undefined)
220
+ return null;
221
+ const value = Number(cell);
222
+ return Number.isFinite(value) ? value : null;
223
+ }
224
+ /**
225
+ * Celled lane rows `[ts, tuple, tuple, ...]` at a tier landed on the host bars `[barOpen, ...tuples]`,
226
+ * ascending: a flow keeps every tuple of the bar's rows in time order, a snapshot the newest sealed row's
227
+ * tuples (a bar holding no sealed row yet has none). `fold` replaces the default per bar (a lane summing per
228
+ * contract); a bar it folds to no tuple carries none.
229
+ */
230
+ export function wrunLandCellRowsOnHostBars(rows, landing, grid, fold) {
231
+ const landed = [];
232
+ for (const group of groupByHostBar(rows, grid.intervalMs, grid.barGrid)) {
233
+ let tuples;
234
+ if (fold !== undefined) {
235
+ tuples = fold(group);
236
+ }
237
+ else if (landing === 'snapshot') {
238
+ const newest = [...group.rows].reverse().find((row) => sealed(Number(row[0]), grid.tierMs, grid.nowMs));
239
+ if (newest === undefined)
240
+ continue;
241
+ tuples = newest.slice(1);
242
+ }
243
+ else {
244
+ tuples = group.rows.flatMap((row) => row.slice(1));
245
+ }
246
+ if (tuples.length === 0)
247
+ continue;
248
+ landed.push([group.barOpenMs, ...tuples]);
249
+ }
250
+ return landed;
251
+ }
252
+ /**
253
+ * Celled host-bar rows `[barOpen, ...tuples]` with the PARTIAL bars marked (rule 1, bit 14): every tuple of a
254
+ * partial bar carries the bit, and a partial bar holding no row gets one with a single marker tuple (every value
255
+ * 0, bit 14 alone), so a package never reads a bar the backend no longer holds as a quiet one. `partialBars`
256
+ * are host bar opens; `width` counts the `present` column. Ascending.
257
+ */
258
+ export function wrunCellRowsWithPartialBars(rows, partialBars, width) {
259
+ const partial = new Set(partialBars);
260
+ if (partial.size === 0)
261
+ return rows.map((row) => [...row]);
262
+ const out = [];
263
+ const seen = new Set();
264
+ for (const row of rows) {
265
+ const ts = Number(row[0]);
266
+ if (!partial.has(ts)) {
267
+ out.push([...row]);
268
+ continue;
269
+ }
270
+ seen.add(ts);
271
+ const tuples = row.slice(1).filter((cell) => Array.isArray(cell));
272
+ out.push([ts, ...(tuples.length > 0 ? wrunTuplesMarkedPartial(tuples, width) : [wrunPartialMarkerTuple(width)])]);
273
+ }
274
+ for (const ts of partial) {
275
+ if (!seen.has(ts) && Number.isFinite(ts))
276
+ out.push([ts, wrunPartialMarkerTuple(width)]);
277
+ }
278
+ return out.sort((a, b) => Number(a[0]) - Number(b[0]));
279
+ }
@@ -0,0 +1,52 @@
1
+ /**
2
+ * The trades lanes a wrun sheet declares (frozen authoring contract C1.4): a
3
+ * `trades` input may declare `currency: "USD"`, the kScript
4
+ * `buy_sell_volume(currency="USD")` request. Each quote the sheet's trades
5
+ * inputs read is ONE buy_sell_volume lane, fetched once into its own row
6
+ * buffer: the coin lane (`trades`, no currency or `"Coin"`) asks as it always
7
+ * did, and the dollar lane (`trades_usd`) asks with `{ currency: "USD" }` as
8
+ * its payload extras, so the K_BUY_SELL_VOLUME control builds the request that
9
+ * kScript source builds ("USD" quotes the volumes in dollars, anything else in
10
+ * coins) and the replay cache keys it apart from the coin lane. The live
11
+ * context keeps each lane's payload as its acquisition: the push intake folds
12
+ * a trade's volume x close under a USD one and the reconcile re-asks the same
13
+ * quote, so history and live land in the same unit, lane by lane.
14
+ *
15
+ * A package may read both quotes (the Bar Statistics template's units select
16
+ * reads `buy_sell_volume(currency="USD")` under USD and the coin request under
17
+ * Coin, and the kScript engine fetches both declared requests): its twin
18
+ * declares one trades input pair per unit, and each input reads its own lane.
19
+ *
20
+ * A trades input pinned to another market (kit 0.77.0) reads a leg lane per
21
+ * (quote, market), `trades@BYBIT|BTCUSDT`: its fetch key, live lane and
22
+ * `tradeLegRows` key (docs: wrun-typed-inputs.md, "Coin legs").
23
+ */
24
+ import type { WrunInputSource } from '../../interfaces/wrun-runtime.interface.js';
25
+ /** A trades lane: one per quote. */
26
+ export type WrunTradesLane = 'trades' | 'trades_usd';
27
+ /** A trades lane's payload extras: present only on the dollar lane. */
28
+ export interface WrunTradesLaneExtras {
29
+ currency: 'USD';
30
+ }
31
+ export interface WrunTradesLaneSpec {
32
+ /** The fetch-key suffix: the full run's, and the live reconcile's under its live prefix. */
33
+ key: 'bsv' | 'bsvusd';
34
+ /** The payload extras the lane is asked with (none: coins). */
35
+ extras?: WrunTradesLaneExtras;
36
+ }
37
+ export declare const WRUN_TRADES_LANES: Readonly<Record<WrunTradesLane, WrunTradesLaneSpec>>;
38
+ /** The lane a trades input reads: the dollar lane for `currency: "USD"`, the coin lane otherwise. */
39
+ export declare function wrunTradesLaneOf(source: Pick<WrunInputSource, 'currency'>): WrunTradesLane;
40
+ export type WrunTradesLegLane = `${WrunTradesLane}@${string}`;
41
+ export interface WrunTradesLeg {
42
+ lane: WrunTradesLane;
43
+ exchange: string;
44
+ symbol: string;
45
+ }
46
+ /** The leg lane of a trades input pinned to one whole market, else undefined. */
47
+ export declare function wrunTradesLegLaneOf(source: Pick<WrunInputSource, 'currency' | 'exchange' | 'symbol'>): WrunTradesLegLane | undefined;
48
+ /** A leg lane id read apart (no exchange holds `|`, no quote `@`), else undefined. */
49
+ export declare function wrunTradesLegOf(lane: string): WrunTradesLeg | undefined;
50
+ export declare function isWrunTradesLegLane(value: unknown): value is WrunTradesLegLane;
51
+ /** A leg lane's payload extras: its market, its quote's own, and `pinnedMarket` (its market's series on any chart). */
52
+ export declare function wrunTradesLegExtras(lane: WrunTradesLegLane): Record<string, unknown>;
@@ -0,0 +1,58 @@
1
+ /**
2
+ * The trades lanes a wrun sheet declares (frozen authoring contract C1.4): a
3
+ * `trades` input may declare `currency: "USD"`, the kScript
4
+ * `buy_sell_volume(currency="USD")` request. Each quote the sheet's trades
5
+ * inputs read is ONE buy_sell_volume lane, fetched once into its own row
6
+ * buffer: the coin lane (`trades`, no currency or `"Coin"`) asks as it always
7
+ * did, and the dollar lane (`trades_usd`) asks with `{ currency: "USD" }` as
8
+ * its payload extras, so the K_BUY_SELL_VOLUME control builds the request that
9
+ * kScript source builds ("USD" quotes the volumes in dollars, anything else in
10
+ * coins) and the replay cache keys it apart from the coin lane. The live
11
+ * context keeps each lane's payload as its acquisition: the push intake folds
12
+ * a trade's volume x close under a USD one and the reconcile re-asks the same
13
+ * quote, so history and live land in the same unit, lane by lane.
14
+ *
15
+ * A package may read both quotes (the Bar Statistics template's units select
16
+ * reads `buy_sell_volume(currency="USD")` under USD and the coin request under
17
+ * Coin, and the kScript engine fetches both declared requests): its twin
18
+ * declares one trades input pair per unit, and each input reads its own lane.
19
+ *
20
+ * A trades input pinned to another market (kit 0.77.0) reads a leg lane per
21
+ * (quote, market), `trades@BYBIT|BTCUSDT`: its fetch key, live lane and
22
+ * `tradeLegRows` key (docs: wrun-typed-inputs.md, "Coin legs").
23
+ */
24
+ export const WRUN_TRADES_LANES = {
25
+ trades: { key: 'bsv' },
26
+ trades_usd: { key: 'bsvusd', extras: { currency: 'USD' } },
27
+ };
28
+ /** The lane a trades input reads: the dollar lane for `currency: "USD"`, the coin lane otherwise. */
29
+ export function wrunTradesLaneOf(source) {
30
+ return source.currency === 'USD' ? 'trades_usd' : 'trades';
31
+ }
32
+ /** The leg lane of a trades input pinned to one whole market, else undefined. */
33
+ export function wrunTradesLegLaneOf(source) {
34
+ const { exchange, symbol } = source;
35
+ if (typeof exchange !== 'string' || exchange === '' || typeof symbol !== 'string' || symbol === '')
36
+ return undefined;
37
+ return `${wrunTradesLaneOf(source)}@${exchange}|${symbol}`;
38
+ }
39
+ /** A leg lane id read apart (no exchange holds `|`, no quote `@`), else undefined. */
40
+ export function wrunTradesLegOf(lane) {
41
+ const at = lane.indexOf('@');
42
+ const quote = lane.slice(0, at);
43
+ if (at <= 0 || (quote !== 'trades' && quote !== 'trades_usd'))
44
+ return undefined;
45
+ const market = lane.slice(at + 1);
46
+ const bar = market.indexOf('|');
47
+ if (bar <= 0 || bar === market.length - 1)
48
+ return undefined;
49
+ return { lane: quote, exchange: market.slice(0, bar), symbol: market.slice(bar + 1) };
50
+ }
51
+ export function isWrunTradesLegLane(value) {
52
+ return typeof value === 'string' && wrunTradesLegOf(value) !== undefined;
53
+ }
54
+ /** A leg lane's payload extras: its market, its quote's own, and `pinnedMarket` (its market's series on any chart). */
55
+ export function wrunTradesLegExtras(lane) {
56
+ const leg = wrunTradesLegOf(lane);
57
+ return { symbol: leg.symbol, exchange: leg.exchange, ...WRUN_TRADES_LANES[leg.lane].extras, pinnedMarket: true };
58
+ }
@@ -0,0 +1,41 @@
1
+ /**
2
+ * The volume-profile lane a wrun sheet declares: a `volume_profile` input
3
+ * source may name `ticks_per_bar` (the price ticks one bucket spans) and
4
+ * `currency` (the quote its volumes are in), the two settings a kScript
5
+ * volume_profile source carries as `ticksPerBar` and `currency`. The run asks
6
+ * the K_VOLUME_PROFILE lane with them as the lane's payload extras, so the
7
+ * control builds the request a kScript source with those settings builds
8
+ * (`normalizeTicksPerBar`; "USD" quotes dollars, anything else coins) and the
9
+ * fetch worker re-buckets the history at the block size x ticks per bar. The
10
+ * live context keeps that payload as the lane's acquisition: the delta fold
11
+ * reads its lattice (block size x ticksPerBar) and its quote guard from it,
12
+ * and the live leg subscribes the same quote, so history and live land on the
13
+ * same cells. A sheet declaring neither key rides the chart's own lane as
14
+ * before (no extras: one tick per bucket, in coins). An input bound to a
15
+ * setting (C1.3: `ticks_per_bar_param`, or the reference verbatim,
16
+ * `ticks_per_bar: "@<param>"`) reaches here with the param's current value
17
+ * already written into `ticks_per_bar` by the paint seam
18
+ * (`wrunSheetWithSettings`), so this reader never looks at settings; a
19
+ * reference still standing names no declared param and refuses by name.
20
+ *
21
+ * One package reads one profile lane (the run fetches it once): inputs that
22
+ * declare two different lanes refuse by name before any fetch. An input
23
+ * declaring neither key reads the declared lane, the parity harness's rule
24
+ * (tools/parity/tranche8-official/harness/vpk8.ts vpLaneOfSheet).
25
+ */
26
+ import type { WrunIndicatorMetadata } from '../../interfaces/wrun-runtime.interface.js';
27
+ export declare const WRUN_VOLUME_PROFILE_ONE_LANE_CODE = "wrun_volume_profile_one_lane";
28
+ /** A bucket size still holding an `"@<param>"` reference after the paint seam: it names no declared param. */
29
+ export declare const WRUN_VOLUME_PROFILE_TICKS_PARAM_CODE = "wrun_volume_profile_ticks_param";
30
+ /** A declared lane as the K_VOLUME_PROFILE source payload keys it, normalized
31
+ * the way the control normalizes a kScript source's settings. */
32
+ export interface WrunVolumeProfileLaneExtras {
33
+ ticksPerBar: number;
34
+ currency: 'USD' | 'Coin';
35
+ }
36
+ /** The lane payload extras the sheet's volume_profile inputs declare;
37
+ * undefined when none declares `ticks_per_bar` or `currency`. Throws, naming
38
+ * the inputs, when two inputs declare different lanes, and naming the input
39
+ * when its bucket size is a `"@<param>"` reference the paint seam could not
40
+ * resolve (no declared param of that name). */
41
+ export declare function wrunVolumeProfileLaneExtras(metadata: Pick<WrunIndicatorMetadata, 'inputs' | 'inputSources'>): WrunVolumeProfileLaneExtras | undefined;
@@ -0,0 +1,66 @@
1
+ /**
2
+ * The volume-profile lane a wrun sheet declares: a `volume_profile` input
3
+ * source may name `ticks_per_bar` (the price ticks one bucket spans) and
4
+ * `currency` (the quote its volumes are in), the two settings a kScript
5
+ * volume_profile source carries as `ticksPerBar` and `currency`. The run asks
6
+ * the K_VOLUME_PROFILE lane with them as the lane's payload extras, so the
7
+ * control builds the request a kScript source with those settings builds
8
+ * (`normalizeTicksPerBar`; "USD" quotes dollars, anything else coins) and the
9
+ * fetch worker re-buckets the history at the block size x ticks per bar. The
10
+ * live context keeps that payload as the lane's acquisition: the delta fold
11
+ * reads its lattice (block size x ticksPerBar) and its quote guard from it,
12
+ * and the live leg subscribes the same quote, so history and live land on the
13
+ * same cells. A sheet declaring neither key rides the chart's own lane as
14
+ * before (no extras: one tick per bucket, in coins). An input bound to a
15
+ * setting (C1.3: `ticks_per_bar_param`, or the reference verbatim,
16
+ * `ticks_per_bar: "@<param>"`) reaches here with the param's current value
17
+ * already written into `ticks_per_bar` by the paint seam
18
+ * (`wrunSheetWithSettings`), so this reader never looks at settings; a
19
+ * reference still standing names no declared param and refuses by name.
20
+ *
21
+ * One package reads one profile lane (the run fetches it once): inputs that
22
+ * declare two different lanes refuse by name before any fetch. An input
23
+ * declaring neither key reads the declared lane, the parity harness's rule
24
+ * (tools/parity/tranche8-official/harness/vpk8.ts vpLaneOfSheet).
25
+ */
26
+ import { normalizeTicksPerBar } from '../../workers/utils/volume-profile.worker.util.js';
27
+ export const WRUN_VOLUME_PROFILE_ONE_LANE_CODE = 'wrun_volume_profile_one_lane';
28
+ /** A bucket size still holding an `"@<param>"` reference after the paint seam: it names no declared param. */
29
+ export const WRUN_VOLUME_PROFILE_TICKS_PARAM_CODE = 'wrun_volume_profile_ticks_param';
30
+ function describeLane(lane) {
31
+ return `ticksPerBar ${lane.ticksPerBar} in ${lane.currency === 'USD' ? 'USD' : 'coins'}`;
32
+ }
33
+ /** The lane payload extras the sheet's volume_profile inputs declare;
34
+ * undefined when none declares `ticks_per_bar` or `currency`. Throws, naming
35
+ * the inputs, when two inputs declare different lanes, and naming the input
36
+ * when its bucket size is a `"@<param>"` reference the paint seam could not
37
+ * resolve (no declared param of that name). */
38
+ export function wrunVolumeProfileLaneExtras(metadata) {
39
+ let declared;
40
+ for (const input of metadata.inputs) {
41
+ const source = metadata.inputSources[input.name];
42
+ if (source?.source !== 'volume_profile')
43
+ continue;
44
+ if (source.ticks_per_bar === undefined && source.currency === undefined)
45
+ continue;
46
+ if (typeof source.ticks_per_bar === 'string' && source.ticks_per_bar.startsWith('@')) {
47
+ throw new Error(`volume_profile input '${input.name}' ticks_per_bar '${source.ticks_per_bar}' names no declared param ` +
48
+ `(${WRUN_VOLUME_PROFILE_TICKS_PARAM_CODE}): bind the bucket size to a declared int param`);
49
+ }
50
+ const lane = {
51
+ ticksPerBar: normalizeTicksPerBar(source.ticks_per_bar),
52
+ currency: source.currency === 'USD' ? 'USD' : 'Coin',
53
+ };
54
+ if (declared !== undefined &&
55
+ (declared.lane.ticksPerBar !== lane.ticksPerBar || declared.lane.currency !== lane.currency)) {
56
+ throw new Error(`volume_profile inputs declare two lanes (${declared.inputs.join(', ')}: ${describeLane(declared.lane)}; ` +
57
+ `${input.name}: ${describeLane(lane)}) (${WRUN_VOLUME_PROFILE_ONE_LANE_CODE}): one package reads one ` +
58
+ 'profile lane, so declare the same ticks_per_bar and currency on every volume_profile input');
59
+ }
60
+ declared =
61
+ declared === undefined
62
+ ? { lane, inputs: [input.name] }
63
+ : { ...declared, inputs: [...declared.inputs, input.name] };
64
+ }
65
+ return declared?.lane;
66
+ }
@@ -0,0 +1,33 @@
1
+ /**
2
+ * The one rule for the name a wrun Indicator goes by, shared by the web app and the mobile app.
3
+ * Whatever a reader holds for a package (the registry's title, the manifest's `display_name`, the
4
+ * sheet's `name`, a chart row's saved `customName`), it shows the first one that is a name and never
5
+ * a stand-in for one:
6
+ *
7
+ * - the editor's untitled placeholder: "Untitled", "Untitled indicator", "Untitled script",
8
+ * "Untitled tab" or "Untitled study", in any case, with or without a count ("Untitled indicator
9
+ * (2)", "Untitled script 2"). The editor titles every new tab that way, and a package first
10
+ * published before the 2026-10-05 publish fix still carries its tab's title as its registry
11
+ * title, its manifest's and its sheet's name;
12
+ * - the package's address (`@scope/name`), in any case, with or without the `@` and a `@version`;
13
+ * - the address's name part in its exact slug form, case and all, while it holds a `-` or `_`
14
+ * (`trend-line`, `session_oi`).
15
+ *
16
+ * Every other title is the author's. The publish derives the address from the typed title, so a
17
+ * title typed in lowercase ("trend line" for `@larsson/trend-line`, "supertrend" for
18
+ * `@kyle/supertrend`) looks like its own slug and is still the name the author gave; a title with
19
+ * capitals is theirs too ("RSI" for `@om-core/rsi`).
20
+ *
21
+ * Pure and dependency-free: every reader on both apps that turns a package into a title goes
22
+ * through `pickWrunDisplayName`, so a placeholder never reaches a legend, an objects tree, a
23
+ * catalog row or a frozen chart row as a name.
24
+ */
25
+ /**
26
+ * Whether a title stands in for a name: not a string, blank once trimmed, one of the editor's
27
+ * untitled placeholders, or (with the package's `address`) that address or its name part (see the
28
+ * file note).
29
+ */
30
+ export declare function isPlaceholderWrunTitle(title: unknown, address?: string | null): boolean;
31
+ /** The first candidate that is a name (`isPlaceholderWrunTitle` false for the package's `address`),
32
+ * trimmed; else `fallback`, as given. */
33
+ export declare function pickWrunDisplayName(candidates: ReadonlyArray<unknown>, fallback: string, address?: string | null): string;
@@ -0,0 +1,64 @@
1
+ /**
2
+ * The one rule for the name a wrun Indicator goes by, shared by the web app and the mobile app.
3
+ * Whatever a reader holds for a package (the registry's title, the manifest's `display_name`, the
4
+ * sheet's `name`, a chart row's saved `customName`), it shows the first one that is a name and never
5
+ * a stand-in for one:
6
+ *
7
+ * - the editor's untitled placeholder: "Untitled", "Untitled indicator", "Untitled script",
8
+ * "Untitled tab" or "Untitled study", in any case, with or without a count ("Untitled indicator
9
+ * (2)", "Untitled script 2"). The editor titles every new tab that way, and a package first
10
+ * published before the 2026-10-05 publish fix still carries its tab's title as its registry
11
+ * title, its manifest's and its sheet's name;
12
+ * - the package's address (`@scope/name`), in any case, with or without the `@` and a `@version`;
13
+ * - the address's name part in its exact slug form, case and all, while it holds a `-` or `_`
14
+ * (`trend-line`, `session_oi`).
15
+ *
16
+ * Every other title is the author's. The publish derives the address from the typed title, so a
17
+ * title typed in lowercase ("trend line" for `@larsson/trend-line`, "supertrend" for
18
+ * `@kyle/supertrend`) looks like its own slug and is still the name the author gave; a title with
19
+ * capitals is theirs too ("RSI" for `@om-core/rsi`).
20
+ *
21
+ * Pure and dependency-free: every reader on both apps that turns a package into a title goes
22
+ * through `pickWrunDisplayName`, so a placeholder never reaches a legend, an objects tree, a
23
+ * catalog row or a frozen chart row as a name.
24
+ */
25
+ /** The editor's untitled placeholders: "Untitled", an optional kind word, an optional count. */
26
+ const UNTITLED_PLACEHOLDER_RE = /^untitled(\s+(indicator|script|tab|study))?(\s*\(?\d+\)?)?$/i;
27
+ /** An address without its leading `@` and its `@version`, as written: `@larsson/trend-line@1.2.0`
28
+ * reads `larsson/trend-line`. */
29
+ function bareAddress(text) {
30
+ const bare = text.trim().replace(/^@/, '');
31
+ const versionAt = bare.indexOf('@');
32
+ return versionAt === -1 ? bare : bare.slice(0, versionAt);
33
+ }
34
+ /**
35
+ * Whether a title stands in for a name: not a string, blank once trimmed, one of the editor's
36
+ * untitled placeholders, or (with the package's `address`) that address or its name part (see the
37
+ * file note).
38
+ */
39
+ export function isPlaceholderWrunTitle(title, address) {
40
+ if (typeof title !== 'string')
41
+ return true;
42
+ const name = title.trim();
43
+ if (name === '' || UNTITLED_PLACEHOLDER_RE.test(name))
44
+ return true;
45
+ if (typeof address !== 'string')
46
+ return false;
47
+ const bare = bareAddress(address);
48
+ if (bare === '')
49
+ return false;
50
+ // The full address ignores case; its name part, below, counts only in its exact slug form.
51
+ if (bareAddress(name).toLowerCase() === bare.toLowerCase())
52
+ return true;
53
+ const slug = bare.slice(bare.lastIndexOf('/') + 1);
54
+ return /[-_]/.test(slug) && name === slug;
55
+ }
56
+ /** The first candidate that is a name (`isPlaceholderWrunTitle` false for the package's `address`),
57
+ * trimmed; else `fallback`, as given. */
58
+ export function pickWrunDisplayName(candidates, fallback, address) {
59
+ for (const candidate of candidates) {
60
+ if (!isPlaceholderWrunTitle(candidate, address))
61
+ return candidate.trim();
62
+ }
63
+ return fallback;
64
+ }
@@ -0,0 +1,15 @@
1
+ /**
2
+ * The words a kScript socket failure leaves the worker with (the message prefix of the Error the ask rejects with),
3
+ * read by the main thread's failure mapping (wrun-socket-row-source wrunSocketAskFailure). Stable codes, never a raw
4
+ * socket Event or a free sentence, so the mapping and the failure cause never depend on wording.
5
+ */
6
+ /** The socket closed while the ask was on it (sent, unanswered). */
7
+ export declare const KSCRIPT_TRANSPORT_DISCONNECTED = "KSCRIPT_TRANSPORT_DISCONNECTED";
8
+ /** The dial failed before the ask could go: nothing was sent. */
9
+ export declare const KSCRIPT_TRANSPORT_DIAL_FAILED = "KSCRIPT_TRANSPORT_DIAL_FAILED";
10
+ /** The keepalive's pong never came, so the worker retired the socket: the asks sent on it are lost. */
11
+ export declare const KSCRIPT_TRANSPORT_STALE = "KSCRIPT_TRANSPORT_STALE";
12
+ /** No run permission was available in time: nothing was sent. */
13
+ export declare const KSCRIPT_CAPABILITY_UNAVAILABLE = "KSCRIPT_CAPABILITY_UNAVAILABLE";
14
+ /** The data worker restarted with the ask on the old worker: whatever it sent is gone with that worker's socket. */
15
+ export declare const KSCRIPT_WORKER_RESTARTED = "KSCRIPT_WORKER_RESTARTED";
@@ -0,0 +1,15 @@
1
+ /**
2
+ * The words a kScript socket failure leaves the worker with (the message prefix of the Error the ask rejects with),
3
+ * read by the main thread's failure mapping (wrun-socket-row-source wrunSocketAskFailure). Stable codes, never a raw
4
+ * socket Event or a free sentence, so the mapping and the failure cause never depend on wording.
5
+ */
6
+ /** The socket closed while the ask was on it (sent, unanswered). */
7
+ export const KSCRIPT_TRANSPORT_DISCONNECTED = 'KSCRIPT_TRANSPORT_DISCONNECTED';
8
+ /** The dial failed before the ask could go: nothing was sent. */
9
+ export const KSCRIPT_TRANSPORT_DIAL_FAILED = 'KSCRIPT_TRANSPORT_DIAL_FAILED';
10
+ /** The keepalive's pong never came, so the worker retired the socket: the asks sent on it are lost. */
11
+ export const KSCRIPT_TRANSPORT_STALE = 'KSCRIPT_TRANSPORT_STALE';
12
+ /** No run permission was available in time: nothing was sent. */
13
+ export const KSCRIPT_CAPABILITY_UNAVAILABLE = 'KSCRIPT_CAPABILITY_UNAVAILABLE';
14
+ /** The data worker restarted with the ask on the old worker: whatever it sent is gone with that worker's socket. */
15
+ export const KSCRIPT_WORKER_RESTARTED = 'KSCRIPT_WORKER_RESTARTED';