@orangecharts/wrun-chart-host 0.8.0 → 0.9.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 (145) hide show
  1. package/README.md +2 -1
  2. package/dist/constants/feature-flags.constants.d.ts +4 -0
  3. package/dist/constants/feature-flags.constants.js +27 -0
  4. package/dist/constants/marketCapabilities.constants.d.ts +14 -9
  5. package/dist/constants/marketCapabilities.constants.js +36 -13
  6. package/dist/constants/opra-compliance.constants.d.ts +14 -0
  7. package/dist/constants/opra-compliance.constants.js +14 -0
  8. package/dist/constants/option-venues.constants.d.ts +11 -6
  9. package/dist/constants/option-venues.constants.js +5 -2
  10. package/dist/host-env.d.ts +10 -4
  11. package/dist/host-ports.types.d.ts +39 -3
  12. package/dist/index.d.ts +1 -0
  13. package/dist/index.js +1 -0
  14. package/dist/interfaces/opra-realtime.interface.d.ts +13 -11
  15. package/dist/interfaces/opra-realtime.interface.js +10 -10
  16. package/dist/interfaces/wrun-runtime.interface.d.ts +34 -13
  17. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +53 -10
  18. package/dist/kscript-data/controls/live-trades-merge.util.js +81 -16
  19. package/dist/market-data/billing.interface.d.ts +138 -17
  20. package/dist/market-data/billing.interface.js +25 -8
  21. package/dist/market-data/venues/index.d.ts +3 -3
  22. package/dist/market-data/venues/opra.contract.copy.json +5 -3
  23. package/dist/market-data/venues/opra.d.ts +3 -3
  24. package/dist/market-data/venues/opra.js +5 -4
  25. package/dist/replay/replayLadder.js +3 -1
  26. package/dist/utility/chart/crypto-index.leaf.d.ts +2 -2
  27. package/dist/utility/chart/crypto-index.leaf.js +2 -2
  28. package/dist/utility/chart/index-mode-admission.util.js +9 -1
  29. package/dist/utility/chart/index-mode.util.d.ts +5 -2
  30. package/dist/utility/chart/index-mode.util.js +23 -13
  31. package/dist/utility/chart/kscript-venue-policy.util.d.ts +28 -21
  32. package/dist/utility/chart/kscript-venue-policy.util.js +30 -24
  33. package/dist/utility/chart/marketKind.util.d.ts +12 -10
  34. package/dist/utility/chart/marketKind.util.js +17 -7
  35. package/dist/utility/chart/om-panel-push-style.util.d.ts +7 -7
  36. package/dist/utility/chart/om-panel-push-style.util.js +17 -15
  37. package/dist/utility/chart/om-panel.util.js +6 -6
  38. package/dist/utility/chart/profile-block-size.util.d.ts +16 -0
  39. package/dist/utility/chart/profile-block-size.util.js +7 -0
  40. package/dist/utility/chart/quote-perp.leaf.d.ts +17 -0
  41. package/dist/utility/chart/quote-perp.leaf.js +20 -0
  42. package/dist/utility/chart/wrun-run-result.util.d.ts +5 -0
  43. package/dist/utility/chart/wrun-run-result.util.js +4 -1
  44. package/dist/utility/common/transformations.util.d.ts +7 -0
  45. package/dist/utility/common/transformations.util.js +11 -0
  46. package/dist/utility/options/option-venue.util.d.ts +3 -3
  47. package/dist/utility/options/option-venue.util.js +3 -3
  48. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.d.ts +1 -1
  49. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.js +2 -2
  50. package/dist/utility/wrun/run-schedule/wrun-prefix-feeds.util.d.ts +2 -2
  51. package/dist/utility/wrun/run-schedule/wrun-prefix-feeds.util.js +5 -1
  52. package/dist/utility/wrun/sources/row-lane-registry.js +3 -2
  53. package/dist/utility/wrun/sources/row-lanes/option_contract_state.d.ts +9 -3
  54. package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +13 -5
  55. package/dist/utility/wrun/sources/row-lanes/option_prints.d.ts +11 -0
  56. package/dist/utility/wrun/sources/row-lanes/option_prints.js +63 -9
  57. package/dist/utility/wrun/sources/row-lanes/option_strikes.d.ts +8 -0
  58. package/dist/utility/wrun/sources/row-lanes/option_strikes.js +12 -0
  59. package/dist/utility/wrun/sources/row-lanes/option_surface.d.ts +5 -2
  60. package/dist/utility/wrun/sources/row-lanes/option_surface.js +5 -2
  61. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +11 -5
  62. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +31 -10
  63. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.d.ts +33 -1
  64. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.js +95 -6
  65. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +25 -5
  66. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +55 -18
  67. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +146 -40
  68. package/dist/utility/wrun/wrun-batched-marks.util.d.ts +16 -3
  69. package/dist/utility/wrun/wrun-batched-marks.util.js +30 -19
  70. package/dist/utility/wrun/wrun-batched-readout.util.d.ts +37 -9
  71. package/dist/utility/wrun/wrun-batched-readout.util.js +61 -15
  72. package/dist/utility/wrun/wrun-canvas-readout.util.d.ts +4 -0
  73. package/dist/utility/wrun/wrun-cell-capacity.leaf.d.ts +66 -0
  74. package/dist/utility/wrun/wrun-cell-capacity.leaf.js +86 -0
  75. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +147 -9
  76. package/dist/utility/wrun/wrun-chart-market-facts.util.js +345 -11
  77. package/dist/utility/wrun/wrun-color-facts.util.d.ts +19 -9
  78. package/dist/utility/wrun/wrun-color-facts.util.js +24 -14
  79. package/dist/utility/wrun/wrun-color-settings.util.d.ts +15 -4
  80. package/dist/utility/wrun/wrun-color-settings.util.js +31 -12
  81. package/dist/utility/wrun/wrun-dollar-unit-port.leaf.d.ts +17 -0
  82. package/dist/utility/wrun/wrun-dollar-unit-port.leaf.js +9 -0
  83. package/dist/utility/wrun/wrun-download-meter.util.d.ts +92 -0
  84. package/dist/utility/wrun/wrun-download-meter.util.js +122 -0
  85. package/dist/utility/wrun/wrun-draft-overlay.util.d.ts +6 -1
  86. package/dist/utility/wrun/wrun-draft-overlay.util.js +23 -3
  87. package/dist/utility/wrun/wrun-frames.js +5 -5
  88. package/dist/utility/wrun/wrun-hosted-wire-caps.d.ts +2 -2
  89. package/dist/utility/wrun/wrun-hosted-wire-caps.js +7 -0
  90. package/dist/utility/wrun/wrun-hud-looks.util.d.ts +33 -17
  91. package/dist/utility/wrun/wrun-hud-looks.util.js +30 -16
  92. package/dist/utility/wrun/wrun-lifecycle-runtime.util.d.ts +8 -6
  93. package/dist/utility/wrun/wrun-lifecycle-runtime.util.js +8 -6
  94. package/dist/utility/wrun/wrun-lifecycle.contract.d.ts +4 -2
  95. package/dist/utility/wrun/wrun-live-intake.util.d.ts +6 -2
  96. package/dist/utility/wrun/wrun-live-intake.util.js +136 -21
  97. package/dist/utility/wrun/wrun-live-tick.util.js +91 -38
  98. package/dist/utility/wrun/wrun-market-size-contract-carry.leaf.d.ts +53 -0
  99. package/dist/utility/wrun/wrun-market-size-contract-carry.leaf.js +162 -0
  100. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +166 -48
  101. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +216 -33
  102. package/dist/utility/wrun/wrun-market-size-defaults.util.d.ts +51 -7
  103. package/dist/utility/wrun/wrun-market-size-defaults.util.js +314 -56
  104. package/dist/utility/wrun/wrun-option-prints.util.d.ts +41 -2
  105. package/dist/utility/wrun/wrun-option-prints.util.js +80 -13
  106. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.d.ts +3 -0
  107. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.js +3 -0
  108. package/dist/utility/wrun/wrun-option-strike-flow.util.d.ts +23 -0
  109. package/dist/utility/wrun/wrun-option-strike-flow.util.js +55 -0
  110. package/dist/utility/wrun/wrun-option-views.util.d.ts +51 -7
  111. package/dist/utility/wrun/wrun-option-views.util.js +151 -28
  112. package/dist/utility/wrun/wrun-options-stop.util.d.ts +2 -1
  113. package/dist/utility/wrun/wrun-options-stop.util.js +3 -2
  114. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +3 -0
  115. package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.d.ts +31 -14
  116. package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.js +22 -0
  117. package/dist/utility/wrun/wrun-overlay-recovery.util.d.ts +7 -0
  118. package/dist/utility/wrun/wrun-overlay-recovery.util.js +25 -1
  119. package/dist/utility/wrun/wrun-overlay-result.util.d.ts +7 -1
  120. package/dist/utility/wrun/wrun-overlay-result.util.js +2 -0
  121. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +34 -6
  122. package/dist/utility/wrun/wrun-overlay-run.util.js +416 -171
  123. package/dist/utility/wrun/wrun-pack-widths.leaf.d.ts +4 -4
  124. package/dist/utility/wrun/wrun-pack-widths.leaf.js +4 -4
  125. package/dist/utility/wrun/wrun-pack.util.d.ts +7 -3
  126. package/dist/utility/wrun/wrun-pack.util.js +20 -9
  127. package/dist/utility/wrun/wrun-panel-style.util.d.ts +27 -15
  128. package/dist/utility/wrun/wrun-panel-style.util.js +42 -20
  129. package/dist/utility/wrun/wrun-param-map.util.d.ts +7 -6
  130. package/dist/utility/wrun/wrun-param-map.util.js +8 -5
  131. package/dist/utility/wrun/wrun-param-values.util.d.ts +10 -2
  132. package/dist/utility/wrun/wrun-param-values.util.js +2 -0
  133. package/dist/utility/wrun/wrun-prefix-lanes.util.js +2 -2
  134. package/dist/utility/wrun/wrun-refusal.util.js +10 -1
  135. package/dist/utility/wrun/wrun-script-inputs.util.d.ts +7 -0
  136. package/dist/utility/wrun/wrun-source-rows.util.d.ts +4 -0
  137. package/dist/utility/wrun/wrun-source-rows.util.js +92 -40
  138. package/dist/utility/wrun/wrun-tape-source.util.d.ts +126 -50
  139. package/dist/utility/wrun/wrun-tape-source.util.js +193 -68
  140. package/dist/utility/wrun/wrun-volume-profile-lane.util.d.ts +7 -5
  141. package/dist/utility/wrun/wrun-volume-profile-lane.util.js +8 -6
  142. package/dist/workers/utils/volume-profile.worker.util.d.ts +4 -1
  143. package/dist/workers/utils/volume-profile.worker.util.js +5 -2
  144. package/dist/workers/wrun/wrun-abi-host.js +3 -2
  145. package/package.json +11 -11
package/README.md CHANGED
@@ -128,8 +128,9 @@ What each published version holds. A host installs a version with the peers of i
128
128
 
129
129
  | Version | Peers | What changed |
130
130
  | --- | --- | --- |
131
+ | 0.9.0 | `@orangecharts/indicator-kit` 0.91.1, `@orangecharts/orange-v2-pb-common` 12.72.0, `dayjs` 1.11.23, `lodash-es` 4.18.1 | OPTLOAD G5 folds on `option_contract_state`: an input may declare `totals` and `strike_change` (Top Contracts' totals) beside its projections. They plan and ride the lane's ask as view fields like a projection (`wrunOptionViewsOfSource`; `wrunOptionViewsOf` reads them back), and the input's block is the view block its words size (`wrunOptionInputTupleWidth`: each class tuple `[0, ...13 values]`, then each fold row `[layout, ...cells]`, every row padded to 16). An instance's rows are sized the same way on the fetch path: `wrunOptionLaneTupleWidth` reads a view block's width off the views it asks (`<prefix>Views`, the kit's `wrunAskTupleWidth`), where it knew only the strike kit fold. A host's chain transport reads such an answer's fold entries as that block, and on a plane that serves no views answers it from the kit's reference (`wrunOptionViewAnswer`; web: the `k-option-contract-state` worker on a crypto chain). `wrunOptionViewUnread` (new) names what still refuses by name before any read (`wrun_option_view_unread`): an `options_chain` fold, and `oi_board`, which follows the chart's close that the state lane does not send. Peers unchanged. The package commits landed since 0.8.0 ride along (`git log a5411df71f.. -- packages/wrun-chart-host` in the web repo). |
131
132
  | 0.8.0 | `@orangecharts/indicator-kit` 0.91.1, `@orangecharts/orange-v2-pb-common` 12.72.0, `dayjs` 1.11.23, `lodash-es` 4.18.1 | The footprint's Classic Presets and Columns for a host's settings form, from one source with both web footprint dialogs. Two modules move from the web app: `utility/chart/footprint-sierra-look.util` (`withFootprintSierraLook`, the Classic Presets patch) and `utility/chart/footprint-columns.util` (the 12 column kinds, the four presets, `withFootprintColumn`, `withFootprintColumnsPreset` and their reads). Three are new: `utility/chart/footprint-display-mode.util` (the cell-grid family, the bar width each mode draws at, `FOOTPRINT_DISPLAY_MODES`, `footprintDisplayModeShown` and `withFootprintDisplayMode`), `settings-templates/form-rows` (the row shape: `action` and `choice` rows with words as locale keys) and `settings-templates/footprint-rows` (`footprintFormRows`, `FOOTPRINT_FORM_SLOTS`). All five join the entry. The package commits landed since 0.7.0 ride along (`git log 1a636a0542.. -- packages/wrun-chart-host` in the web repo), among them the market-scaled size defaults (`utility/wrun/wrun-market-size-defaults.leaf` and `.util`), the candle volume unit leaf and the CME options root. The kit peer moves from 0.88.0 to 0.91.1. The registry also holds 0.7.1 (2026-10-21, 0.7.0's peers), which this table does not describe. |
132
- | 0.7.0 | `@orangecharts/indicator-kit` 0.88.0, `@orangecharts/orange-v2-pb-common` 12.72.0, `dayjs` 1.11.23, `lodash-es` 4.18.1 | The options lanes of OPTIONS-PORT P7: `options_flow` becomes a chain lane, and with `option_prints` and `option_contract_flow` it reads the chart's option chain on a crypto option venue and on a CME futures chart as well as on OPRA; option contract flow plans to one source answer budget every layer reads (`utility/chart/kscript-source-answer-budget.leaf`). The run schedule (`utility/wrun/run-schedule/`, six modules): each lane group is sent at its own plan, held or in-flight reads are reused, and a host's door can dial the chart's gate reader before an add (`warmWrunSheetGateReaders`) or when a surface opens (`warmWrunChartGateReaderOnIntent`). Row lanes ask end-exclusive (`WrunSourceFetchOptions.endExclusive`) and keep held bars over budget markers; panel rows paint with missing readings, and a lane is asked only within its reach (`WrunWarmupEvidence.sourceReachFromTs`, the `source-reach` backfill outcome). Trading-day opens are solved as titan solves them across DST edges, and each zone's offset is read once a day (`utility/chart/ny-calendar.util`). Crypto indices chart as main symbols (`utility/chart/crypto-index.leaf`); the symbol comparison keeps its user label as instance state in the settings templates; a run no longer loads the kit on the main thread (`utility/wrun/wrun-kit-run-tables.util`). Every failed run names its cause: `WRUN_FAILURE_CAUSES` gains eight words (`package-withdrawn`, `package-hosted`, `compile-failed`, `twin-declined` and `integration-error` for what stopped a package before it ran; `source-budget`, `source-failed` and `source-declined` for a source lane the ladder gave up on), a package the registry no longer serves shows "no longer available from its publisher" with Remove and never Retry, and a source chip names the feed and what happened (the words under `wrun.unavailable` and `kscript.legend.card.removeIndicator`, which a host's word table needs). A lane's budget counts from its dispatch until the transport reports the request's wire send (`WrunSourceFetchOptions.onSent`, optional: a transport that never reports keeps the dispatch budget), then from the send, 60 s at most from the dispatch; the ladder never ends a lane while a late read is out, and the record it ends on names its cause and the episode that armed it (a restore, a person's add, a live rebuild). The transient grace holds a failure only for an overlay a rerun driver runs, unless the host declares that it reruns the overlay itself (`holdWrunTransientRefusal(target, onExpire, { hostReruns: true })`, `WrunTransientHoldOptions`; off by default): the mobile app's protected run heal does, so its Marketplace indicators load through an outage instead of showing their chip at once. `onWrunOverlayRunSettled` announces a run of a standing overlay only: a run that settles after its overlay's teardown (typically dropped by the teardown's cancel of its pending row-source ask) is the ring's alone, so a same-id remount no longer reads its predecessor's dropped run as its own first run. OPTLOAD G5: an `options_chain` or `option_contract_state` input may declare chain page views (`page_view`, `page_views`; `utility/wrun/wrun-option-views.util`), which ride the lane's ask as view fields for the host's chain transport to send in one chain summary read; a fold view refuses by name (`wrun_option_view_unread`) and a view param's `"@<param>"` handle is painted like `ticks_per_bar`. On the OPRA plane both lanes hold the plane's chain by coin instead of reading the chain directory (`wrunHeldOpraPlaneChain`). One loader view widens: the module `transport.loadV2Service()` answers gains `warmGateReaderFor(exchange)` and `warmGateReaderOnIntent(exchange, surface)`; the env keeps its 133 members, and no package code reads `transport.loadWrunKit` any more. 11 modules join, all in the entry, and `utility/wrun/wrun-opra-underlying.util` goes with its `WrunOpraUnderlyingContext`: 416 dist modules (406 at 0.6.0), 33 by subpath only. `utility/wrun/sources/opra-option-lanes.util` drops `resolveWrunOpraLaneUnderlying` and `resolveWrunLaneOpraChain`; a lane resolves its chain through `resolveWrunLaneChainChart` and `decideWrunLaneChain`. The kit peer moves from 0.87.0 to 0.88.0 and the protocol enums peer from 12.69.0 to 12.72.0. |
133
+ | 0.7.0 | `@orangecharts/indicator-kit` 0.88.0, `@orangecharts/orange-v2-pb-common` 12.72.0, `dayjs` 1.11.23, `lodash-es` 4.18.1 | The options lanes of OPTIONS-PORT P7: `options_flow` becomes a chain lane, and with `option_prints` and `option_contract_flow` it reads the chart's option chain on a crypto option venue and on a CME futures chart as well as on OPRA; option contract flow plans to one source answer budget every layer reads (`utility/chart/kscript-source-answer-budget.leaf`). The run schedule (`utility/wrun/run-schedule/`, six modules): each lane group is sent at its own plan, held or in-flight reads are reused, and a host's door can dial the chart's gate reader before an add (`warmWrunSheetGateReaders`) or when a surface opens (`warmWrunChartGateReaderOnIntent`). Row lanes ask end-exclusive (`WrunSourceFetchOptions.endExclusive`) and keep held bars over budget markers; panel rows paint with missing readings, and a lane is asked only within its reach (`WrunWarmupEvidence.sourceReachFromTs`, the `source-reach` backfill outcome). Trading-day opens are solved as titan solves them across DST edges, and each zone's offset is read once a day (`utility/chart/ny-calendar.util`). Crypto indices chart as main symbols (`utility/chart/crypto-index.leaf`); the symbol comparison keeps its user label as instance state in the settings templates; a run no longer loads the kit on the main thread (`utility/wrun/wrun-kit-run-tables.util`). Every failed run names its cause: `WRUN_FAILURE_CAUSES` gains eight words (`package-withdrawn`, `package-hosted`, `compile-failed`, `twin-declined` and `integration-error` for what stopped a package before it ran; `source-budget`, `source-failed` and `source-declined` for a source lane the ladder gave up on), a package the registry no longer serves shows "no longer available from its publisher" with Remove and never Retry, and a source chip names the feed and what happened (the words under `wrun.unavailable` and `kscript.legend.card.removeIndicator`, which a host's word table needs). A lane's budget counts from its dispatch until the transport reports the request's wire send (`WrunSourceFetchOptions.onSent`, optional: a transport that never reports keeps the dispatch budget), then from the send, 60 s at most from the dispatch; the ladder never ends a lane while a late read is out, and the record it ends on names its cause and the episode that armed it (a restore, a person's add, a live rebuild). The transient grace holds a failure only for an overlay a rerun driver runs, unless the host declares that it reruns the overlay itself (`holdWrunTransientRefusal(target, onExpire, { hostReruns: true })`, `WrunTransientHoldOptions`; off by default): the mobile app's protected run heal does, so its Marketplace indicators load through an outage instead of showing their chip at once. `onWrunOverlayRunSettled` announces a run of a standing overlay only: a run that settles after its overlay's teardown (typically dropped by the teardown's cancel of its pending row-source ask) is the ring's alone, so a same-id remount no longer reads its predecessor's dropped run as its own first run. OPTLOAD G5: an `options_chain` or `option_contract_state` input may declare chain page views (`page_view`, `page_views`; `utility/wrun/wrun-option-views.util`), which ride the lane's ask as view fields for the host's chain transport to send in one chain summary read; a fold view refuses by name (`wrun_option_view_unread`; 0.9.0 reads `option_contract_state`'s) and a view param's `"@<param>"` handle is painted like `ticks_per_bar`. On the OPRA plane both lanes hold the plane's chain by coin instead of reading the chain directory (`wrunHeldOpraPlaneChain`). One loader view widens: the module `transport.loadV2Service()` answers gains `warmGateReaderFor(exchange)` and `warmGateReaderOnIntent(exchange, surface)`; the env keeps its 133 members, and no package code reads `transport.loadWrunKit` any more. 11 modules join, all in the entry, and `utility/wrun/wrun-opra-underlying.util` goes with its `WrunOpraUnderlyingContext`: 416 dist modules (406 at 0.6.0), 33 by subpath only. `utility/wrun/sources/opra-option-lanes.util` drops `resolveWrunOpraLaneUnderlying` and `resolveWrunLaneOpraChain`; a lane resolves its chain through `resolveWrunLaneChainChart` and `decideWrunLaneChain`. The kit peer moves from 0.87.0 to 0.88.0 and the protocol enums peer from 12.69.0 to 12.72.0. |
133
134
  | 0.6.0 | `@orangecharts/indicator-kit` 0.87.0, `@orangecharts/orange-v2-pb-common` 12.69.0, `dayjs` 1.11.23, `lodash-es` 4.18.1 | The shared engine protocol: a module's bytes cross `postMessage` (the mobile app's portability rule) and the engine worker hashes them (`utility/wrun/wrun-sha256.leaf`), checks the sheet's pin, clamps, prepares and compiles them, caching up to 16 compiled modules per worker, so the main thread neither hashes nor compiles. `compileModule` becomes `loadModule`, which answers an opaque `WrunModuleHandle` (key, sha256, ABI, imports as `{ module, name }` pairs; no bytes); every full run and live-start carries the module's key, ABI and bytes (copied, never transferred), and the worker reuses its cached module or compiles the bytes on a miss, so a respawned worker compiles again. A request runs on two 20 s clocks, the start ceiling from the post (queue plus compile) and the run deadline from the worker's `running`; `loadModule` rejects a failed compile as a `WebAssembly.CompileError` with the worker's words and a pin mismatch with the words it had before 0.6.0. The `run` namespace goes with its three loaders (`run.loadOverlayLifecycleDoor`, `run.loadRefusalSurface`, `run.loadSeriesStream`, retired at 0.5.0), `WrunHostRun` and their three loader views in `host-ports.types`: 131 members by the contract's count, 133 with 0.5.0's two optional ones. Peers unchanged. |
134
135
  | 0.5.0 | `@orangecharts/indicator-kit` 0.87.0, `@orangecharts/orange-v2-pb-common` 12.69.0, `dayjs` 1.11.23, `lodash-es` 4.18.1 | Phase 2: the live session (the live tick, intake, hidden-tab hold, coin lane live channels, series stream), the drivers and the heal ladder (the lifecycle door, `utility/wrun/wrun-overlay-lifecycle.lazy` by subpath, its runtime and the recovery ladders), the prefix runs, the engine (`workers/wrun/wrun-abi-host`, `workers/wrun/wrun-engine-handler`, the browser host), the host facts and the executor (`utility/wrun/wrun-overlay-run.util`, by subpath) with its row sources: 135 modules, 398 in all. The env gains the 84 phase 2 members, the `ui` and `engine` namespaces and the optional `clock.watchHostSuspended` and `chart.commonStore`; the three `run` loaders turn optional (gone at 0.6.0). The panel mount reads a host's planned pane heights on every cell and retranslates an unchanged child in place, keeping a reader's expanded pane through a retire. The entry no longer serves `utility/wrun/wrun-overlay-identity.util` (by subpath; above). The kit peer moves from 0.86.3 to 0.87.0 (`option_multiplier`); the other peers are unchanged. |
135
136
  | 0.4.0 | `@orangecharts/indicator-kit` 0.86.3, `@orangecharts/orange-v2-pb-common` 12.69.0, `dayjs` 1.11.23, `lodash-es` 4.18.1 | Phase 1b: the panel mount (`utility/wrun/wrun-panel-mount.util`, by subpath) and its door (`utility/wrun/wrun-panel-mount.lazy`), the run interval rules (`utility/chart/indicator-run-interval.util`) with the builtin script snippets they type against, the pause dim and six leaves (the window owner and window geometry rules, the date-labelled interval rule, the HTML escape, the run interval projection and plot gate types): 11 modules, 262 in all. The mount reads the host through the env: the 12 members reserved until 0.4.0, `t` and `diagnostics.debug`. Peers unchanged. |
@@ -6,7 +6,9 @@ export declare const FeatureFlag: {
6
6
  readonly OmBoard: "om-board";
7
7
  readonly ScriptOffers: "script-offers";
8
8
  readonly PaperTrading: "paper-trading";
9
+ readonly LighterExecution: "lighter-execution";
9
10
  readonly TradingHub: "trading-hub";
11
+ readonly AppearanceModes: "appearance-modes";
10
12
  readonly DataLoadHealRegister: "data-load-heal-register";
11
13
  readonly CollabSyncV2: "collab-sync-v2";
12
14
  readonly DataLoadCrossChartJoin: "data-load-cross-chart-join";
@@ -26,6 +28,7 @@ export declare const FeatureFlag: {
26
28
  readonly PrepaidPlusCn: "prepaid-plus-cn";
27
29
  readonly ApiConsole: "api-console";
28
30
  readonly Opra: "opra";
31
+ readonly VariationalMarkets: "variational-markets";
29
32
  readonly OptionsPanel: "options-panel";
30
33
  readonly OpraUserScripts: "opra-user-scripts";
31
34
  readonly OpraAlerts: "opra-alerts";
@@ -42,6 +45,7 @@ export declare const FeatureFlag: {
42
45
  readonly KscriptPauseSuspendsPaint: "kscript-pause-suspends-paint";
43
46
  readonly Feeds: "feeds";
44
47
  readonly SynopticStreams: "synoptic-streams";
48
+ readonly StoreBuiltinRows: "store-builtin-rows";
45
49
  };
46
50
  export type FeatureFlagKey = (typeof FeatureFlag)[keyof typeof FeatureFlag];
47
51
  export declare const FEATURE_FLAG_KEYS: FeatureFlagKey[];
@@ -48,6 +48,13 @@ export const FeatureFlag = {
48
48
  // build switch `PAPER_TRADING_ENABLED` takes only the paper venue out of a build, never the
49
49
  // exchange venues.
50
50
  PaperTrading: 'paper-trading',
51
+ // Lighter execution (docs/features/cex-execution/README.md, "Lighter"): the one exchange venue whose
52
+ // trading key is minted in the browser and registered by the wallet. Its own key, read through `isOn`
53
+ // by `isCexVenueFlagOn`: unminted, absent and guest all read off, so production ships it dark while the
54
+ // paper trading key, which lights the other dark venues, stays on for everyone; the dev/internal
55
+ // localStorage override lights it locally (`kiyo.flag-overrides` -> `{"lighter-execution": true}`).
56
+ // Mint it enabled to open it up. A key this browser already holds keeps trading after it turns off.
57
+ LighterExecution: 'lighter-execution',
51
58
  // The trading hub (docs/features/trading-hub/README.md): one Trade door beside the avatar that
52
59
  // folds the desktop's linking, accounts and trade settings into one dialog. Rides the master
53
60
  // trading flag AND this key, read through `isOn` (`isTradingHubOn`): unminted, absent and guest
@@ -55,6 +62,13 @@ export const FeatureFlag = {
55
62
  // bypass, the dev/internal localStorage override lights it locally (`kiyo.flag-overrides` ->
56
63
  // `{"trading-hub": true}`). Mint it enabled to open it up. Phones keep today's surfaces either way.
57
64
  TradingHub: 'trading-hub',
65
+ // The Gray and Cream appearances (docs/features/ui/theming.md, "Appearance modes"): two more segments in the
66
+ // desktop Preferences mode switch, Gray beside Dark and Cream beside Light, plus their Super Search rows.
67
+ // Read through `isOn` (`isAppearanceModesOn`): unminted, absent and guest all read off, so production ships it
68
+ // dark and a saved Gray shows as Dark, a saved Cream as Light; an internal role reads it on through the
69
+ // server's bypass, the dev/internal localStorage override lights it locally (`kiyo.flag-overrides` ->
70
+ // `{"appearance-modes": true}`). Mint it enabled to open it up. Phones keep Dark and Light either way.
71
+ AppearanceModes: 'appearance-modes',
58
72
  // Collab-sync kill switch (Phase 1: DEFAULT ON; the flag exists only to
59
73
  // force the legacy lanes back, by minting it disabled in the admin panel
60
74
  // plus a page reload). Mode is generation-pinned per collab session
@@ -192,6 +206,13 @@ export const FeatureFlag = {
192
206
  // affordance, contract charts and the purchase screens. Minted dark; the data tier itself is the
193
207
  // OPRA gate's and never flips with this flag (employees stay delayed like everyone).
194
208
  Opra: 'opra',
209
+ // Variational (VARIATIONAL perpetuals, VARIATIONAL_SWAP swaps) in pickers, search, recents, popular rows
210
+ // and watchlist import: a flag-gated venue (exchange-visibility.util FLAG_GATED_EXCHANGES), read through
211
+ // `isOn`, so unminted, absent and guest all read off and every surface ships it dark. An internal role
212
+ // reads it on through the server's bypass once it is minted; the dev/internal override lights it
213
+ // locally (`kiyo.flag-overrides` -> `{"variational-markets": true}`). A chart already on the venue
214
+ // still loads (docs/features/data/quote-perp-venues.md). Mint it enabled to release the venue.
215
+ VariationalMarkets: 'variational-markets',
195
216
  // The Options panel (the Options front door): the ticker bar's Options button, the panel itself and every door
196
217
  // to it, read through `isOptionsPanelOn()` (src/utility/options/options-panel-gate.util.ts) with `isOn`:
197
218
  // unminted, absent and guest all read off, so production ships it dark; minted disabled, an internal role reads
@@ -300,6 +321,12 @@ export const FeatureFlag = {
300
321
  // production ships it dark; minted disabled, an internal role reads it on; the dev/internal localStorage
301
322
  // override lights it locally. Mint it enabled to open it up.
302
323
  SynopticStreams: 'synoptic-streams',
324
+ // The indicator store's native Official rows from the registry's builtin listings
325
+ // (docs/features/indicators/indicator-catalog.md): on, a builtin row lists its native control (Add mounts it by
326
+ // type), tharamine's row only for a type no builtin row covers, and the Official side orders by `boost`. Off,
327
+ // builtin rows are dropped and the store is as before. Read through `isOn`: unminted, absent and guest read off,
328
+ // so production ships it dark; flip it off to roll back (saved charts store the control type).
329
+ StoreBuiltinRows: 'store-builtin-rows',
303
330
  };
304
331
  export const FEATURE_FLAG_KEYS = Object.values(FeatureFlag);
305
332
  /**
@@ -55,21 +55,26 @@ export interface IMarketCapabilities {
55
55
  * surface available and no execution.
56
56
  */
57
57
  export declare const CME_FUTURES_CAPABILITIES: IMarketCapabilities;
58
+ /**
59
+ * US equity and index options over the OPRA entitlement gate (the `'options'`
60
+ * kind). Session markets served by the same reader/live-feed pipeline as CME
61
+ * (period fetch, TRADE data sided by the feed) with trades, volume and market
62
+ * stats, but no order book (OPRA is top of book only and the feed publishes no
63
+ * book types) and no volume profile: the gateway retired VOLUME_PROFILE_AGG,
64
+ * TPO_AGG and TRADE_VOLUME_BY_SIZE_AGG on option contracts 2026-10-21, and
65
+ * every OPRA chart is an option contract, so the Fixed Range Volume Profile
66
+ * tool stands down (tradfi.constants OPTION_CONTRACT_ORDER_FLOW_INDICATORS
67
+ * refuses the indicators). CME futures keep the tool; an exact CME option
68
+ * shares their capability record and its mode refuses the profile instead.
69
+ * Alerts are refused on the plane by policy, so the alert symbol mode is moot.
70
+ */
71
+ export declare const OPRA_OPTIONS_CAPABILITIES: IMarketCapabilities;
58
72
  /**
59
73
  * On-chain pools served by blk (`isBlkExchange`: every SOLANA_ONCHAIN market). They classify as the
60
74
  * crypto kind (uniform bars, period fetch, a trade tape and market stats), but blk serves no order book
61
75
  * and no volume profile, so the book surfaces (the Orderbook tab, its block-size prefetch) and the
62
76
  * Fixed Range Volume Profile tool stand down. `getCapabilities` returns this for those exchanges.
63
77
  */
64
- /**
65
- * US equity and index options over the OPRA entitlement gate (the `'options'`
66
- * kind). Session markets served by the same reader/live-feed pipeline as CME
67
- * (period fetch, TRADE data sided by the feed) with trades, volume, market
68
- * stats and the volume-profile surfaces, but no order book: OPRA is top of
69
- * book only and the feed publishes no book types. Alerts are refused on the
70
- * plane by policy, so the alert symbol mode is moot.
71
- */
72
- export declare const OPRA_OPTIONS_CAPABILITIES: IMarketCapabilities;
73
78
  export declare const ONCHAIN_POOL_CAPABILITIES: IMarketCapabilities;
74
79
  export declare const MARKET_CAPABILITIES: Record<VenueMarketKind, IMarketCapabilities>;
75
80
  /** Every market kind (the FE `'futures'` kind included). Derived from
@@ -27,19 +27,18 @@ export const CME_FUTURES_CAPABILITIES = {
27
27
  // ones (cmeSessionBucketMs).
28
28
  allowsCalendarIntervals: true,
29
29
  };
30
- /**
31
- * On-chain pools served by blk (`isBlkExchange`: every SOLANA_ONCHAIN market). They classify as the
32
- * crypto kind (uniform bars, period fetch, a trade tape and market stats), but blk serves no order book
33
- * and no volume profile, so the book surfaces (the Orderbook tab, its block-size prefetch) and the
34
- * Fixed Range Volume Profile tool stand down. `getCapabilities` returns this for those exchanges.
35
- */
36
30
  /**
37
31
  * US equity and index options over the OPRA entitlement gate (the `'options'`
38
32
  * kind). Session markets served by the same reader/live-feed pipeline as CME
39
- * (period fetch, TRADE data sided by the feed) with trades, volume, market
40
- * stats and the volume-profile surfaces, but no order book: OPRA is top of
41
- * book only and the feed publishes no book types. Alerts are refused on the
42
- * plane by policy, so the alert symbol mode is moot.
33
+ * (period fetch, TRADE data sided by the feed) with trades, volume and market
34
+ * stats, but no order book (OPRA is top of book only and the feed publishes no
35
+ * book types) and no volume profile: the gateway retired VOLUME_PROFILE_AGG,
36
+ * TPO_AGG and TRADE_VOLUME_BY_SIZE_AGG on option contracts 2026-10-21, and
37
+ * every OPRA chart is an option contract, so the Fixed Range Volume Profile
38
+ * tool stands down (tradfi.constants OPTION_CONTRACT_ORDER_FLOW_INDICATORS
39
+ * refuses the indicators). CME futures keep the tool; an exact CME option
40
+ * shares their capability record and its mode refuses the profile instead.
41
+ * Alerts are refused on the plane by policy, so the alert symbol mode is moot.
43
42
  */
44
43
  export const OPRA_OPTIONS_CAPABILITIES = {
45
44
  barTimestamps: 'irregular',
@@ -47,11 +46,17 @@ export const OPRA_OPTIONS_CAPABILITIES = {
47
46
  supportsVolumeStats: true,
48
47
  supportsTradesFeed: true,
49
48
  supportsMarketStats: true,
50
- supportsFRVP: true,
49
+ supportsFRVP: false,
51
50
  supportsOrderbook: false,
52
51
  alertSymbolMode: 'coin',
53
52
  allowsCalendarIntervals: false,
54
53
  };
54
+ /**
55
+ * On-chain pools served by blk (`isBlkExchange`: every SOLANA_ONCHAIN market). They classify as the
56
+ * crypto kind (uniform bars, period fetch, a trade tape and market stats), but blk serves no order book
57
+ * and no volume profile, so the book surfaces (the Orderbook tab, its block-size prefetch) and the
58
+ * Fixed Range Volume Profile tool stand down. `getCapabilities` returns this for those exchanges.
59
+ */
55
60
  export const ONCHAIN_POOL_CAPABILITIES = {
56
61
  barTimestamps: 'uniform',
57
62
  fetchMode: 'period',
@@ -181,8 +186,8 @@ export const MARKET_CAPABILITIES = {
181
186
  options: OPRA_OPTIONS_CAPABILITIES,
182
187
  // The crypto-wide indices (CRYPTOCAP: BTC.D, TOTAL, ...). Value candles on
183
188
  // the period fetch, 24/7 on uniform bars like crypto, at every interval from
184
- // 1m up (the calendar ones included; nothing below 1m, checkIsBlockedOn1s),
185
- // but no trades, volume, book or profile behind them, and no alert engine lane.
189
+ // 1s up (the calendar ones included), but no trades, volume, book or profile
190
+ // behind them, and no alert engine lane.
186
191
  cryptoIndex: {
187
192
  barTimestamps: 'uniform',
188
193
  fetchMode: 'period',
@@ -195,6 +200,24 @@ export const MARKET_CAPABILITIES = {
195
200
  alertSymbolMode: 'coin',
196
201
  allowsCalendarIntervals: true,
197
202
  },
203
+ // Perpetual venues that publish quotes, never trades (Variational,
204
+ // quote-perp.leaf). Quote candles (TICKER_AGG) on the period fetch, 24/7 on
205
+ // uniform bars like crypto, from 1m up (the gateway serves no sub-minute
206
+ // TICKER_AGG tier), with funding and open interest beside them but no
207
+ // trades, volume, book or profile. No alert engine lane is proven for the
208
+ // venue, so alerts stay closed (an armed one would save and never fire).
209
+ quotePerp: {
210
+ barTimestamps: 'uniform',
211
+ fetchMode: 'period',
212
+ supportsVolumeStats: false,
213
+ supportsTradesFeed: false,
214
+ supportsMarketStats: false,
215
+ supportsFRVP: false,
216
+ supportsOrderbook: false,
217
+ supportsAlerts: false,
218
+ alertSymbolMode: 'slug',
219
+ allowsCalendarIntervals: true,
220
+ },
198
221
  };
199
222
  // =============================================================================
200
223
  // MarketKind shorthand sets — for `IIndicatorControl.marketKinds` declarations.
@@ -17,3 +17,17 @@
17
17
  * the watchlist cell tooltip, and the purchase page's live delayed price.
18
18
  */
19
19
  export declare const OPRA_DELAY_NOTICE = "OPRA data delayed 15 minutes";
20
+ /**
21
+ * The agreement notice. Source: the filed Attachment C (6) to the OPRA Vendor Agreement and the filed display screen 2:
22
+ * the notice shown prominently each time a subscriber accesses the service, its last words a link to the agreement the
23
+ * subscriber accepted. Every OPRA-bearing view of an entitled real-time subscriber carries it as a persistent strip
24
+ * (the chain page, an OPRA contract chart, a chart holding an OPRA overlay: OpraAgreementNotice.vue).
25
+ */
26
+ export declare const OPRA_AGREEMENT_NOTICE = "YOUR RECEIPT AND USE OF THIS SERVICE IS SUBJECT TO THE TERMS AND CONDITIONS OF YOUR AGREEMENT WITH THALAMUS TECHNOLOGIES, INC. TO VIEW THE TERMS AND CONDITIONS OF THIS AGREEMENT, PLEASE CLICK HERE.";
27
+ /** The words of the agreement notice that link to the accepted agreement: the notice's own words, never a label. */
28
+ export declare const OPRA_AGREEMENT_NOTICE_LINK = "CLICK HERE";
29
+ /**
30
+ * The agreement step's assent button. Source: the B-1 form itself, which asks the subscriber to indicate agreement by
31
+ * clicking the button of these words at the end: the button reads them exactly, in every locale.
32
+ */
33
+ export declare const OPRA_ASSENT_BUTTON = "I AGREE";
@@ -17,3 +17,17 @@
17
17
  * the watchlist cell tooltip, and the purchase page's live delayed price.
18
18
  */
19
19
  export const OPRA_DELAY_NOTICE = 'OPRA data delayed 15 minutes';
20
+ /**
21
+ * The agreement notice. Source: the filed Attachment C (6) to the OPRA Vendor Agreement and the filed display screen 2:
22
+ * the notice shown prominently each time a subscriber accesses the service, its last words a link to the agreement the
23
+ * subscriber accepted. Every OPRA-bearing view of an entitled real-time subscriber carries it as a persistent strip
24
+ * (the chain page, an OPRA contract chart, a chart holding an OPRA overlay: OpraAgreementNotice.vue).
25
+ */
26
+ export const OPRA_AGREEMENT_NOTICE = 'YOUR RECEIPT AND USE OF THIS SERVICE IS SUBJECT TO THE TERMS AND CONDITIONS OF YOUR AGREEMENT WITH THALAMUS TECHNOLOGIES, INC. TO VIEW THE TERMS AND CONDITIONS OF THIS AGREEMENT, PLEASE CLICK HERE.';
27
+ /** The words of the agreement notice that link to the accepted agreement: the notice's own words, never a label. */
28
+ export const OPRA_AGREEMENT_NOTICE_LINK = 'CLICK HERE';
29
+ /**
30
+ * The agreement step's assent button. Source: the B-1 form itself, which asks the subscriber to indicate agreement by
31
+ * clicking the button of these words at the end: the button reads them exactly, in every locale.
32
+ */
33
+ export const OPRA_ASSENT_BUTTON = 'I AGREE';
@@ -61,9 +61,9 @@ export interface OptionVenue {
61
61
  greeksEstimated?: boolean;
62
62
  /**
63
63
  * The chain stamps each expiry at the contract's true expiry instant (OPRA: 16:00 New York, 09:30 for the
64
- * AM-settled roots), not a bare UTC-midnight date (CME's registry today). The heatmap's charm and vanna
65
- * read time to expiry, so they are offered and kept only on a plane whose row says so: set it on a
66
- * governed row the day its registry stamps instants (planeServesExpiryInstants).
64
+ * AM-settled roots; the CME group: the registry's expiration instant), not a bare UTC-midnight date. The
65
+ * heatmap's charm and vanna read time to expiry, so they are offered and kept only on a plane whose row says
66
+ * so (planeServesExpiryInstants); a quote still stamped at UTC midnight prices neither (isDateOnlyExpiry).
67
67
  */
68
68
  expiryInstants?: boolean;
69
69
  /** Chain fields the venue never serves (OPRA publishes no settlement), folded into the hidden set. */
@@ -74,11 +74,16 @@ export interface OptionVenue {
74
74
  knownUnderlyings?: readonly OptionKnownUnderlying[];
75
75
  families?: readonly OptionVenueFamily[];
76
76
  chainWindowSec?: number;
77
- /** The venue streams OPTION_SUMMARY on the live feed, so a chain's underlying follows it between summary polls. */
77
+ /**
78
+ * The venue streams OPTION_SUMMARY on the live feed, so a chain's quotes and underlying follow it between summary
79
+ * polls: the crypto venues on the plain socket, CME and OPRA on the gate's live-feed slot of the tier the account
80
+ * is served (a delayed chain takes only frames as old as its delay, see useOptionChainSummaryBrowser).
81
+ */
78
82
  liveSummary?: boolean;
79
83
  /**
80
- * The chain page's summary poll for this venue. Omitted polls at `OPTION_CHAIN_SUMMARY_POLL_MS` (3 s, Deribit and
81
- * CME); the other plain venues publish every 15 to 60 s, so a 3 s poll mostly re-reads the same quotes.
84
+ * A plain venue's summary poll on the chain page. Omitted polls at `OPTION_CHAIN_SUMMARY_POLL_MS` (3 s, Deribit);
85
+ * the other plain venues publish every 15 to 60 s, so a 3 s poll mostly re-reads the same quotes. A governed venue
86
+ * sets none: its chain polls at its tier's pace (3 s real-time, `DELAYED_CHAIN_POLL_MS` delayed).
82
87
  */
83
88
  chainPollMs?: number;
84
89
  /** The venue's trade-date clock (the data plane's `option_venue_clocks`; option-trade-date.util). Omitted: UTC. */
@@ -59,6 +59,10 @@ export const OPTION_VENUES = [
59
59
  lane: 'governed',
60
60
  plane: 'cme',
61
61
  gated: false,
62
+ liveSummary: true,
63
+ // The registry stamps each expiry at its expiration instant (metadata-instrument's full expiration): 0
64
+ // midnight stamps among the live CME, CBOT, NYMEX and COMEX option contracts on 2026-10-22.
65
+ expiryInstants: true,
62
66
  // The Globex trade date (17:00 Chicago opens the next); the crypto futures roll at 16:00, weekends on Monday.
63
67
  tradeDateClock: {
64
68
  zone: 'America/Chicago',
@@ -93,8 +97,7 @@ export const OPTION_VENUES = [
93
97
  expiryInstants: true,
94
98
  unavailableFields: ['settlementPrice', 'settlementDate'],
95
99
  delayMinutes: OPRA_DELAY_MINUTES,
96
- // The delayed tier re-reads the same quotes for 15 minutes; 3 s polls would only burn the reader.
97
- chainPollMs: 15_000,
100
+ liveSummary: true,
98
101
  tradeDateClock: { zone: 'America/New_York', rule: { offsetHours: 0 } },
99
102
  },
100
103
  {
@@ -10,7 +10,7 @@
10
10
  * bundle that splits it, a spec that resets its module registry) reads the one the realm's entry set.
11
11
  */
12
12
  import type * as WrunKitHost from '@orangecharts/indicator-kit/host';
13
- import type { WrunAttemptOutcome, WrunAttemptStageMs, WrunAttemptToken, WrunChartHandle, WrunChartModeModule, WrunChartPaintMode, WrunChartPaintOptions, WrunChartPaintTarget, WrunChartRoutingModule, WrunChartStoreModule, WrunChartStoreView, WrunCommonStoreModule, WrunConsoleRefusalRun, WrunContinuousContractsModule, WrunContrastGuardContext, WrunDataFetchingModule, WrunDeclaredDepthAsk, WrunDeribitOptionsModule, WrunEditorShellModule, WrunEndOfDataMarkerReason, WrunEngineWorker, WrunEngineWorkerOptions, WrunFailureShow, WrunFeedStreamApi, WrunFeedsServiceModule, WrunHiddenLiveDrainOutcome, WrunHostOverlayRef, WrunIndicatorRegistryModule, WrunIndicatorTypesModule, WrunInputRequirement, WrunIntegrateOptions, WrunIntegrateResult, WrunKitModule, WrunKScriptErrorEnvelopeModule, WrunLegendHoverModule, WrunLiveCoalesceFlush, WrunLiveCoalesceTickDecision, WrunLiveFeedServiceModule, WrunLiveRefreshGateDecision, WrunMarketEventsStoreModule, WrunMetadataServiceModule, WrunOffchartGridHeightsModule, WrunOptionChainServiceModule, WrunOptionsChainVenuesModule, WrunOptionsChartSourceModule, WrunOptionsGateModule, WrunOptionsOverlayProvenanceModule, WrunOverlayMeasureResult, WrunPackEnsureInput, WrunPackEnsureResult, WrunPaneBudgetRankingModule, WrunPlotGateChart, WrunPlotGateRefusal, WrunPriceMarkerTarget, WrunRefreshRowsOptions, WrunRefreshRowsResult, WrunRefusalActionsModule, WrunSearchPayloadToMarketsRequestModule, WrunSignalSheetView, WrunSignalSoundCheck, WrunSocketChartRows, WrunSocketLoadSignals, WrunSocketTransport, WrunSocketTransportModule, WrunSourceCountMetadataLike, WrunSourceDegradeEntry, WrunSourceFetchOptions, WrunStandInTarget, WrunStandInWriteArgs, WrunStandInWriteOutcome, WrunSymbolDisplayModule, WrunTitanChartsModule, WrunTpoBlockCatalogModule, WrunTwinsRosterModule, WrunV2ServiceModule, WrunVenueLegsArgs, WrunVenueLegsResult, WrunWarmupBackfillAsk, WrunWarmupBackfillOutcome } from './host-ports.types.js';
13
+ import type { WrunAttemptOutcome, WrunAttemptStageMs, WrunAttemptToken, WrunChartHandle, WrunChartModeModule, WrunChartPaintMode, WrunChartPaintOptions, WrunChartPaintTarget, WrunChartRoutingModule, WrunChartStoreModule, WrunChartStoreView, WrunCommonStoreModule, WrunConsoleRefusalRun, WrunContinuousContractsModule, WrunContrastGuardContext, WrunDataFetchingModule, WrunDeclaredDepthAsk, WrunDeribitOptionsModule, WrunEditorShellModule, WrunEndOfDataMarkerReason, WrunEngineWorker, WrunEngineWorkerOptions, WrunFailureShow, WrunFeedStreamApi, WrunFeedsServiceModule, WrunHiddenLiveDrainOutcome, WrunHostOverlayRef, WrunIndicatorRegistryModule, WrunIndicatorTypesModule, WrunInputRequirement, WrunIntegrateOptions, WrunIntegrateResult, WrunKitModule, WrunKScriptErrorEnvelopeModule, WrunLegendHoverModule, WrunLiveCoalesceFlush, WrunLiveCoalesceTickDecision, WrunLiveFeedServiceModule, WrunLiveRefreshGateDecision, WrunMarketEventsStoreModule, WrunMetadataServiceModule, WrunOffchartGridHeightsModule, WrunOptionChainServiceModule, WrunOptionsChainVenuesModule, WrunOptionsChartSourceModule, WrunOptionsGateModule, WrunOptionsOverlayProvenanceModule, WrunOverlayMeasureResult, WrunPackEnsureInput, WrunPackEnsureResult, WrunPaneBudgetRankingModule, WrunPlotGateChart, WrunPlotGateRefusal, WrunPriceMarkerTarget, WrunRefreshRowsOptions, WrunRefreshRowsResult, WrunRefusalActionsModule, WrunSearchPayloadToMarketsRequestModule, WrunSignalSheetView, WrunSignalSoundCheck, WrunSocketChartRows, WrunSocketLoadSignals, WrunSocketTransport, WrunSocketTransportModule, WrunSourceCountMetadataLike, WrunSourceDegradeEntry, WrunSourceFetchOptions, WrunStandInTarget, WrunStandInWriteArgs, WrunStandInWriteOutcome, WrunSymbolDisplayModule, WrunTitanChartsModule, WrunTpoBlockCatalogModule, WrunTwinsRosterModule, WrunV2ServiceModule, WrunVenueLegsArgs, WrunVenueLegsResult, WrunWarmupBackfillAsk, WrunWarmupBackfillOutcome, WrunDownloadSummary } from './host-ports.types.js';
14
14
  import type { CmeServedAccess } from './interfaces/cme-realtime.interface.js';
15
15
  import type { WrunDrawSkips, WrunOutputRow } from './interfaces/wrun-runtime.interface.js';
16
16
  import type { WrunLatestSnapshot } from './utility/wrun/wrun-latest-snapshot.js';
@@ -105,6 +105,9 @@ export interface WrunChartHostDiagnostics {
105
105
  markAttemptRunStart(token: WrunAttemptToken | null): void;
106
106
  /** 0.5.0, run. web: noteWrunAttemptStageMs(token, stage, ms) (same file :276). */
107
107
  noteAttemptStageMs(token: WrunAttemptToken | null, stage: keyof WrunAttemptStageMs, ms: number): void;
108
+ /** Run. web: noteWrunAttemptDownload(token, summary) (same file): one run's download (wrun-download-meter.util), once
109
+ * per run; the attempt sums its runs' until it settles. */
110
+ noteAttemptDownload(token: WrunAttemptToken | null, summary: WrunDownloadSummary): void;
108
111
  /** 0.5.0, run. web: settleWrunAttempt(token, outcome) (same file :296). */
109
112
  settleAttempt(token: WrunAttemptToken | null | undefined, outcome: WrunAttemptOutcome): void;
110
113
  /** 0.5.0, boot. web: registerMemoryCensusCacheProvider(name, provider) (utility/chart/memory-census.util.ts:101; the
@@ -304,11 +307,13 @@ export interface WrunHostChart {
304
307
  attempt: number;
305
308
  terminal?: boolean;
306
309
  }, nowMs?: number): void;
307
- /** 0.5.0, run. web: markKScriptSourcePending(guardKey, source, nowMs) (same file :264). */
310
+ /** 0.5.0, run. web: markKScriptSourcePending(guardKey, source, nowMs) (same file :264). `filling`: the source drew
311
+ * its first slice and its older bars are still loading (the registry's still filling chip, shown at once). */
308
312
  markSourcePending(guardKey: string, source: {
309
313
  sourceName: string;
310
314
  sourceType: string;
311
315
  landedBefore?: boolean;
316
+ filling?: boolean;
312
317
  }, nowMs?: number): void;
313
318
  /** 0.5.0, run. web: markKScriptSourceRecovered(guardKey, sourceName) (same file :355). */
314
319
  markSourceRecovered(guardKey: string, sourceName: string): void;
@@ -470,8 +475,9 @@ export interface WrunHostTransport {
470
475
  loadFeedStream(): Promise<WrunFeedStreamApi>;
471
476
  /** 0.5.0, run. web: dataFetch(chartIndex, type, payload, from, toOrPeriod, metadata, sourceName, isPolling, options)
472
477
  * (instances/titan-charts.ts:16337, answers Promise<any>); the live tick (:3707, :3784, :4152) and the executor
473
- * (:3233, :7352, :11931, :12013) already pass `as never` for the payload and the metadata. */
474
- fetchSource(chartIndex: number, type: string, payload: unknown, from: number, toOrPeriod: number, metadata: unknown, sourceName: string, isPolling?: boolean, options?: WrunSourceFetchOptions): Promise<unknown>;
478
+ * (:3233, :7352, :11931, :12013) already pass `as never` for the payload and the metadata. The options are required
479
+ * and carry the call's download meter (`WrunSourceFetchOptions.meter`): every call counts what it downloads. */
480
+ fetchSource(chartIndex: number, type: string, payload: unknown, from: number, toOrPeriod: number, metadata: unknown, sourceName: string, isPolling: boolean, options: WrunSourceFetchOptions): Promise<unknown>;
475
481
  /** 0.5.0, boot loader. web: import('@/services/v2.service') viewed as { default: { fetchData } } (executor :10491, in
476
482
  * one Promise.all with loadDataFetching, both `.catch(() => undefined)`). */
477
483
  loadV2Service(): Promise<WrunV2ServiceModule>;
@@ -328,6 +328,10 @@ export interface WrunStreamCompletionInfo {
328
328
  nativeProfileBlockSize?: number;
329
329
  frvpFetchMeta?: WrunFrvpFetchMeta;
330
330
  serverTookMs?: number;
331
+ /** What the worker's FETCH_DATA downloaded (the owner's totals: every subscriber of a shared request hears them). */
332
+ wireBytes?: number;
333
+ wireFrames?: number;
334
+ wirePoints?: number;
331
335
  }
332
336
  /** The options a main candle fetch passes (web: sentry.interface.ts `V2StreamHandlers` and `V2FetchOptions`,
333
337
  * v2.service.ts `V2SharedFetchOptions`): the handlers in method syntax, so a handler that names web's completion type
@@ -364,6 +368,14 @@ export interface WrunV2ServiceModule {
364
368
  fetchData(indicator: string, payload: never, chartIndex: number, options: WrunMainCandleFetchOptions): Promise<void>;
365
369
  warmGateReaderFor(exchange: string): void;
366
370
  warmGateReaderOnIntent(exchange: string, surface: WrunGateReaderIntentSurface): Promise<WrunGateReaderIntentWarm>;
371
+ /** CHANGED (next release, optional): one series read answered whole (web: v2.service `sendSeriesOneShot`, the
372
+ * worker's `readSeries` over the app's series descriptor, a typed `never` here as `fetchData`'s payload is: the
373
+ * descriptor is the app's). Read by the C-DOLLAR stored unit (wrun-chart-market-facts.util
374
+ * `warmWrunMarketStoredUnit`: a market's newest TRADE_LARGE print, a v2-only read); a host that binds none proves no
375
+ * stored unit, so a raw floor's carry is dropped there by name. */
376
+ sendSeriesOneShot?(descriptor: never, options?: {
377
+ timeoutMs?: number;
378
+ }): Promise<readonly unknown[]>;
367
379
  };
368
380
  }
369
381
  /** A markets request as the app hands it to the worker (web: workers/messages/indicator-v2.messages.ts
@@ -402,6 +414,14 @@ export interface WrunMetadataServiceModule {
402
414
  getBlockSizes(params: WrunBlockSizesParams, options?: {
403
415
  readCache?: boolean;
404
416
  }): Promise<number[]>;
417
+ /** CHANGED (next release, optional): one market's instrument registry record (StreamRegistryMetadatas: its
418
+ * `contractMultiplier`, `inverse`, `pointValue` and `normalizedSymbol` among the fields), null when the registry
419
+ * holds none. Read by the C-DOLLAR trade units (wrun-chart-market-facts.util `warmWrunMarketTradeUnits`, fresh); a
420
+ * host that binds none reads no registry units, so a dollar tape on a CME contract and the carry of a raw floor
421
+ * prove nothing there. web: metadata.service `getSymbolMetadata`. */
422
+ getSymbolMetadata?(exchange: string, symbol: string, options?: {
423
+ fresh?: boolean;
424
+ }): Promise<Record<string, unknown> | null>;
405
425
  };
406
426
  }
407
427
  /** The gate planes an option chain lists on (workers/constants/socket-slots.ts `GateProvider`) and a crypto option
@@ -856,14 +876,28 @@ export interface WrunPackEnsureResult {
856
876
  /** The chart a plot gate notice belongs to, why a plot kind cannot draw, and one plot kind the gate refused
857
877
  * (utility/wrun/wrun-plot-gate.types.ts, moved in phase 1b). */
858
878
  export type { WrunPlotGateChart, WrunPlotGateCause, WrunPlotGateRefusal } from './utility/wrun/wrun-plot-gate.types.js';
879
+ /** The download meter a source fetch charges, and the summary a run hands the add's attempt
880
+ * (utility/wrun/wrun-download-meter.util.ts). */
881
+ import type { WrunDownloadMeterPort, WrunDownloadSummary } from './utility/wrun/wrun-download-meter.util.js';
882
+ export type { WrunDownloadMeterPort, WrunDownloadSummary };
859
883
  /** A source fetch's wire verdict (web: instances/titan-charts.ts `KScriptSourceFetchVerdict`). */
860
884
  export interface WrunSourceFetchVerdict {
861
885
  complete: boolean;
862
886
  servedEmpty: boolean;
863
887
  source: 'wire' | 'row-cache' | 'replay-cache' | 'composed' | 'main-rows' | 'resident-split';
888
+ /** Wire bytes, frames and points this acquisition downloaded for the asker: the owner of a wire request; 0 for a
889
+ * follower and every cache. Set on the verdict a download charge carries (`WrunDownloadCharge`); absent where the
890
+ * host has no stamp, and the meter then charges the answer's cell bytes. */
891
+ wireBytes?: number;
892
+ wireFrames?: number;
893
+ wirePoints?: number;
864
894
  }
865
895
  /** A source fetch's options (web: the options of instances/titan-charts.ts `dataFetch`). */
866
896
  export interface WrunSourceFetchOptions {
897
+ /** The download meter the call charges (wrun-download-meter.util): the run's own, or the live session's. Required,
898
+ * so a call site that asks the wire without counting what it downloads does not typecheck. The web port hands it to
899
+ * dataFetch beside the options, never inside them. */
900
+ meter: WrunDownloadMeterPort;
867
901
  preferPackedOrderbookWorker?: boolean;
868
902
  latestAnchorBars?: number;
869
903
  retryAttempt?: number;
@@ -1103,14 +1137,16 @@ export type WrunAttemptStageMs = Partial<Record<'queueMs' | 'resolveMs' | 'downl
1103
1137
  /** The closed failure vocabulary analytics receives (web: wrun-attempt-envelope.util.ts `WrunAttemptFailureReason`). */
1104
1138
  export type WrunAttemptFailureReason = 'refused' | 'source-unavailable' | 'no-bars' | 'chart-gone' | 'compute-error' | 'integration-error' | 'timeout' | 'cancelled' | 'other';
1105
1139
  /** A failed attempt's outcome: its reason and, when the rejection carries a refusal record, the record's class (web:
1106
- * wrun-attempt-envelope.util.ts `WrunAttemptFailure`). */
1140
+ * wrun-attempt-envelope.util.ts `WrunAttemptFailure`). Never `cancelled`: the host names every cancel's drop. */
1107
1141
  export type WrunAttemptFailure = {
1108
- reason: WrunAttemptFailureReason;
1142
+ reason: Exclude<WrunAttemptFailureReason, 'cancelled'>;
1109
1143
  refusal?: WrunRefusalClass;
1110
1144
  };
1111
- /** How an attempt settled (web: `settleWrunAttempt`'s outcome). */
1145
+ /** How an attempt settled (web: `settleWrunAttempt`'s outcome). `firstSlice`: the result drew a row lane's
1146
+ * first-paint slice alone, its older bars still loading (the time is the time to the first result). */
1112
1147
  export type WrunAttemptOutcome = {
1113
1148
  ok: true;
1149
+ firstSlice?: true;
1114
1150
  } | ({
1115
1151
  ok: false;
1116
1152
  } & (WrunAttemptFailure | {
package/dist/index.d.ts CHANGED
@@ -263,6 +263,7 @@ export * from './utility/wrun/wrun-daily-lane.util.js';
263
263
  export * from './utility/wrun/wrun-deadline.util.js';
264
264
  export * from './utility/wrun/wrun-debug-output.util.js';
265
265
  export * from './utility/wrun/wrun-declared-warmup.util.js';
266
+ export * from './utility/wrun/wrun-download-meter.util.js';
266
267
  export * from './utility/wrun/wrun-draft-legend-note.util.js';
267
268
  export * from './utility/wrun/wrun-draft-overlay.util.js';
268
269
  export * from './utility/wrun/wrun-draw-skipped.leaf.js';
package/dist/index.js CHANGED
@@ -266,6 +266,7 @@ export * from './utility/wrun/wrun-daily-lane.util.js';
266
266
  export * from './utility/wrun/wrun-deadline.util.js';
267
267
  export * from './utility/wrun/wrun-debug-output.util.js';
268
268
  export * from './utility/wrun/wrun-declared-warmup.util.js';
269
+ export * from './utility/wrun/wrun-download-meter.util.js';
269
270
  export * from './utility/wrun/wrun-draft-legend-note.util.js';
270
271
  export * from './utility/wrun/wrun-draft-overlay.util.js';
271
272
  export * from './utility/wrun/wrun-draw-skipped.leaf.js';
@@ -80,14 +80,14 @@ export type AcceptOpraDataTermsDto = AcceptMarketDataDataTermsDto;
80
80
  /** POST /opra/subscription/cancel and DELETE /opra/subscription/cancel -> 200 body. */
81
81
  export type OpraCancelResponseDto = MarketDataCancelResponseDto;
82
82
  /**
83
- * The OPRA subscriber agreement version this build presents and posts. Bump on ANY change to the
84
- * agreement text the dialog shows or links: a new version is a new acceptance, and the store reads a
85
- * record of any other version as not accepted. RELEASE BLOCKER (named, do not bury): the agreement
86
- * text, this version id and the link below need the compliance sign-off before the flag is lit.
83
+ * The agreement version orange's contract export names (the card's pin, checked by the contract parity spec). It is
84
+ * NOT the current version: the server serves the current agreement text, its version and its hash
85
+ * (`GET /opra/agreement`, contract K1), the agreement step renders and posts exactly that, and the store reads an
86
+ * acceptance as current only against it (`isMarketDataAgreementCurrent`).
87
87
  */
88
- export declare const OPRA_SUBSCRIBER_AGREEMENT_VERSION: "opra-subscriber-2026-10";
89
- /** Where the agreement step links for OPRA's own subscriber terms (see the release blocker above). */
90
- export declare const OPRA_SUBSCRIBER_AGREEMENT_URL: "https://www.opraplan.com/";
88
+ export declare const OPRA_SUBSCRIBER_AGREEMENT_VERSION: "opra-b1-2026-10-22";
89
+ /** The agreement link orange's contract export names (the card's pin). No surface links it: the text is served. */
90
+ export declare const OPRA_SUBSCRIBER_AGREEMENT_URL: "/api/v1/opra/agreement";
91
91
  /**
92
92
  * OPRA's non-professional qualification, one stable machine id per question: these ids key the
93
93
  * submitted `answers` record and are never swapped for translated question text. `qualifying` is the
@@ -126,8 +126,8 @@ export declare const OPRA_ATTESTATION_RENEW_WINDOW_DAYS: 30;
126
126
  /**
127
127
  * A declaration on the current form (a new question set means a new declaration) whose validity has not
128
128
  * ended at `now`, either classification. The client owns expiry: `now` is the caller's clock (the store's
129
- * last evaluation), never an implied Date.now(). A record without `expiresAt` never expires here; one whose
130
- * `expiresAt` does not parse reads expired (ask again rather than trust it).
129
+ * last evaluation), never an implied Date.now(). A record without `expiresAt`, or one whose `expiresAt`
130
+ * does not parse, reads lapsed (ask again rather than trust it).
131
131
  */
132
132
  export declare function isOpraAttestationLive(attestation: OpraAttestation | null | undefined, now: number): boolean;
133
133
  /** A non-professional declaration on the current form, still valid at `now`: the account may buy real-time. */
@@ -139,8 +139,10 @@ export declare function isOpraProfessionalDeclaration(attestation: OpraAttestati
139
139
  * inside the renewal window before it; null otherwise (no expiry named, further off, or already lapsed).
140
140
  */
141
141
  export declare function opraAttestationRenewBy(attestation: OpraAttestation | null | undefined, now: number): string | null;
142
- /** An acceptance counts only for the version this build presents, never for an older text. */
143
- export declare function isOpraAgreementCurrent(agreement: OpraAgreement | null | undefined): boolean;
142
+ /** An acceptance counts only for the version the server presents now (`current`, its K1 answer). */
143
+ export declare function isOpraAgreementCurrent(current: {
144
+ version: string;
145
+ } | null | undefined, agreement: OpraAgreement | null | undefined): boolean;
144
146
  /**
145
147
  * Normalized checkout outcome. 'redirect' = leave for Stripe. 'refused' = the server declined (or the
146
148
  * store answered a professional account itself); 'professional_unavailable' is terminal, never a re-price.
@@ -24,13 +24,13 @@ export const OPRA_IDENTITY_FIELD_MAX_LENGTH = OPRA_VENUE.questionnaire.identityL
24
24
  /** The server's bound on the one-line `address`, trimmed. */
25
25
  export const OPRA_ADDRESS_FIELD_MAX_LENGTH = OPRA_VENUE.questionnaire.identityLimits.address;
26
26
  /**
27
- * The OPRA subscriber agreement version this build presents and posts. Bump on ANY change to the
28
- * agreement text the dialog shows or links: a new version is a new acceptance, and the store reads a
29
- * record of any other version as not accepted. RELEASE BLOCKER (named, do not bury): the agreement
30
- * text, this version id and the link below need the compliance sign-off before the flag is lit.
27
+ * The agreement version orange's contract export names (the card's pin, checked by the contract parity spec). It is
28
+ * NOT the current version: the server serves the current agreement text, its version and its hash
29
+ * (`GET /opra/agreement`, contract K1), the agreement step renders and posts exactly that, and the store reads an
30
+ * acceptance as current only against it (`isMarketDataAgreementCurrent`).
31
31
  */
32
32
  export const OPRA_SUBSCRIBER_AGREEMENT_VERSION = OPRA_VENUE.agreement.version;
33
- /** Where the agreement step links for OPRA's own subscriber terms (see the release blocker above). */
33
+ /** The agreement link orange's contract export names (the card's pin). No surface links it: the text is served. */
34
34
  export const OPRA_SUBSCRIBER_AGREEMENT_URL = OPRA_VENUE.agreement.url;
35
35
  /**
36
36
  * OPRA's non-professional qualification, one stable machine id per question: these ids key the
@@ -51,8 +51,8 @@ export const OPRA_ATTESTATION_RENEW_WINDOW_DAYS = OPRA_VENUE.questionnaire.renew
51
51
  /**
52
52
  * A declaration on the current form (a new question set means a new declaration) whose validity has not
53
53
  * ended at `now`, either classification. The client owns expiry: `now` is the caller's clock (the store's
54
- * last evaluation), never an implied Date.now(). A record without `expiresAt` never expires here; one whose
55
- * `expiresAt` does not parse reads expired (ask again rather than trust it).
54
+ * last evaluation), never an implied Date.now(). A record without `expiresAt`, or one whose `expiresAt`
55
+ * does not parse, reads lapsed (ask again rather than trust it).
56
56
  */
57
57
  export function isOpraAttestationLive(attestation, now) {
58
58
  return isMarketDataAttestationLive(OPRA_VENUE, attestation, now);
@@ -72,9 +72,9 @@ export function isOpraProfessionalDeclaration(attestation, now) {
72
72
  export function opraAttestationRenewBy(attestation, now) {
73
73
  return marketDataAttestationRenewBy(OPRA_VENUE, attestation, now);
74
74
  }
75
- /** An acceptance counts only for the version this build presents, never for an older text. */
76
- export function isOpraAgreementCurrent(agreement) {
77
- return isMarketDataAgreementCurrent(OPRA_VENUE, agreement);
75
+ /** An acceptance counts only for the version the server presents now (`current`, its K1 answer). */
76
+ export function isOpraAgreementCurrent(current, agreement) {
77
+ return isMarketDataAgreementCurrent(current, agreement);
78
78
  }
79
79
  /** The venue-generic billing error (market-data/billing.interface.ts): one class for every venue's calls. */
80
80
  export const OpraBillingError = MarketDataBillingError;