@orangecharts/wrun-chart-host 0.10.0 → 0.11.1

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 (152) hide show
  1. package/README.md +1 -0
  2. package/dist/constants/feature-flags.constants.d.ts +9 -0
  3. package/dist/constants/feature-flags.constants.js +67 -4
  4. package/dist/constants/governed-exchanges.constants.d.ts +12 -0
  5. package/dist/constants/governed-exchanges.constants.js +16 -0
  6. package/dist/constants/option-venues.constants.d.ts +2 -2
  7. package/dist/host-env.d.ts +1 -9
  8. package/dist/host-ports.types.d.ts +36 -7
  9. package/dist/index.d.ts +7 -1
  10. package/dist/index.js +7 -1
  11. package/dist/indicators/controls/tpo-session.util.d.ts +36 -13
  12. package/dist/indicators/controls/tpo-session.util.js +217 -236
  13. package/dist/interfaces/cancel-reason.interface.d.ts +1 -1
  14. package/dist/interfaces/cme-realtime.interface.d.ts +16 -9
  15. package/dist/interfaces/cme-realtime.interface.js +6 -3
  16. package/dist/interfaces/kscript-diagnostics.interface.d.ts +6 -0
  17. package/dist/interfaces/opra-realtime.interface.d.ts +1 -5
  18. package/dist/interfaces/prediction-market.interface.d.ts +7 -0
  19. package/dist/interfaces/stocks-realtime.interface.d.ts +57 -0
  20. package/dist/interfaces/stocks-realtime.interface.js +32 -0
  21. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +48 -117
  22. package/dist/kscript-data/controls/live-trades-merge.util.js +97 -207
  23. package/dist/market-data/billing.interface.d.ts +86 -12
  24. package/dist/market-data/billing.interface.js +23 -4
  25. package/dist/market-data/venue.d.ts +65 -2
  26. package/dist/market-data/venues/index.d.ts +135 -5
  27. package/dist/market-data/venues/index.js +2 -1
  28. package/dist/market-data/venues/opra.contract.copy.json +3 -2
  29. package/dist/market-data/venues/opra.d.ts +2 -2
  30. package/dist/market-data/venues/opra.js +5 -2
  31. package/dist/market-data/venues/stocks.contract.copy.json +64 -0
  32. package/dist/market-data/venues/stocks.d.ts +130 -0
  33. package/dist/market-data/venues/stocks.js +117 -0
  34. package/dist/settings-templates/footprint-rows.js +35 -2
  35. package/dist/settings-templates/form-rows.d.ts +2 -1
  36. package/dist/settings-templates/indicator-fields.js +34 -4
  37. package/dist/settings-templates/tool-rules.d.ts +12 -5
  38. package/dist/settings-templates/tool-rules.js +11 -5
  39. package/dist/settings-templates/tool-tables.generated.js +4 -0
  40. package/dist/utility/chart/cme-cache-context.util.d.ts +5 -3
  41. package/dist/utility/chart/cme-cache-context.util.js +10 -6
  42. package/dist/utility/chart/cme-realtime.util.js +10 -0
  43. package/dist/utility/chart/cme-user-scripts-gate.util.d.ts +83 -0
  44. package/dist/utility/chart/cme-user-scripts-gate.util.js +142 -0
  45. package/dist/utility/chart/effective-chart-session.util.d.ts +14 -0
  46. package/dist/utility/chart/effective-chart-session.util.js +39 -0
  47. package/dist/utility/chart/host-bar-placement.util.d.ts +28 -0
  48. package/dist/utility/chart/host-bar-placement.util.js +170 -30
  49. package/dist/utility/chart/index-host-tier.util.d.ts +3 -1
  50. package/dist/utility/chart/index-host-tier.util.js +7 -2
  51. package/dist/utility/chart/index-mode-admission.util.js +25 -11
  52. package/dist/utility/chart/kscript-apply-fingerprint.util.js +1 -1
  53. package/dist/utility/chart/kscript-live-coalesce.util.d.ts +6 -9
  54. package/dist/utility/chart/kscript-live-coalesce.util.js +8 -9
  55. package/dist/utility/chart/kscript-live-source-identity.util.d.ts +9 -0
  56. package/dist/utility/chart/kscript-live-source-identity.util.js +10 -1
  57. package/dist/utility/chart/kscript-provenance-keys.util.js +7 -0
  58. package/dist/utility/chart/kscript-standin-identity.leaf.d.ts +3 -1
  59. package/dist/utility/chart/kscript-venue-policy.util.d.ts +115 -21
  60. package/dist/utility/chart/kscript-venue-policy.util.js +194 -40
  61. package/dist/utility/chart/live-bucket.util.d.ts +24 -8
  62. package/dist/utility/chart/live-bucket.util.js +85 -27
  63. package/dist/utility/chart/market-sessions.util.d.ts +83 -0
  64. package/dist/utility/chart/market-sessions.util.js +220 -0
  65. package/dist/utility/chart/marketKind.util.js +5 -0
  66. package/dist/utility/chart/mixed-mode.util.d.ts +7 -0
  67. package/dist/utility/chart/mixed-mode.util.js +14 -0
  68. package/dist/utility/chart/opra-user-scripts-gate.util.d.ts +11 -16
  69. package/dist/utility/chart/opra-user-scripts-gate.util.js +12 -28
  70. package/dist/utility/chart/rth-session.util.d.ts +9 -8
  71. package/dist/utility/chart/rth-session.util.js +23 -20
  72. package/dist/utility/chart/session-interval.util.d.ts +2 -1
  73. package/dist/utility/chart/session-interval.util.js +1 -3
  74. package/dist/utility/chart/trading-day.util.d.ts +17 -0
  75. package/dist/utility/chart/trading-day.util.js +59 -0
  76. package/dist/utility/chart/window-owner.leaf.d.ts +23 -2
  77. package/dist/utility/chart/window-owner.leaf.js +45 -3
  78. package/dist/utility/chart/wrun-bar-session-facts.util.d.ts +33 -15
  79. package/dist/utility/chart/wrun-bar-session-facts.util.js +70 -20
  80. package/dist/utility/intl-locale.util.js +5 -0
  81. package/dist/utility/scriptEditor/wrun-runtime-diagnostics.leaf.js +2 -0
  82. package/dist/utility/v2/gate-plane.util.d.ts +12 -3
  83. package/dist/utility/v2/gate-plane.util.js +30 -4
  84. package/dist/utility/v2/gate-session-latch.util.js +1 -1
  85. package/dist/utility/v2/stocks-governed.util.d.ts +16 -0
  86. package/dist/utility/v2/stocks-governed.util.js +34 -0
  87. package/dist/utility/wrun/derived-roots.leaf.d.ts +13 -0
  88. package/dist/utility/wrun/derived-roots.leaf.js +27 -0
  89. package/dist/utility/wrun/derived-roots.util.d.ts +1 -9
  90. package/dist/utility/wrun/derived-roots.util.js +3 -23
  91. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.d.ts +4 -3
  92. package/dist/utility/wrun/run-schedule/wrun-own-candles.util.d.ts +24 -3
  93. package/dist/utility/wrun/run-schedule/wrun-own-candles.util.js +46 -10
  94. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +2 -0
  95. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.d.ts +63 -16
  96. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.js +58 -14
  97. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +34 -11
  98. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +106 -30
  99. package/dist/utility/wrun/wrun-browser-sources.leaf.js +1 -2
  100. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +7 -4
  101. package/dist/utility/wrun/wrun-chart-market-facts.util.js +12 -8
  102. package/dist/utility/wrun/wrun-color-settings.util.d.ts +9 -0
  103. package/dist/utility/wrun/wrun-color-settings.util.js +33 -0
  104. package/dist/utility/wrun/wrun-handles.util.d.ts +7 -3
  105. package/dist/utility/wrun/wrun-handles.util.js +9 -8
  106. package/dist/utility/wrun/wrun-input-requirements.leaf.d.ts +68 -0
  107. package/dist/utility/wrun/wrun-input-requirements.leaf.js +163 -7
  108. package/dist/utility/wrun/wrun-leg-close.util.d.ts +59 -23
  109. package/dist/utility/wrun/wrun-leg-close.util.js +186 -28
  110. package/dist/utility/wrun/wrun-live-intake.util.d.ts +26 -12
  111. package/dist/utility/wrun/wrun-live-intake.util.js +219 -155
  112. package/dist/utility/wrun/wrun-live-tick.util.d.ts +9 -5
  113. package/dist/utility/wrun/wrun-live-tick.util.js +130 -94
  114. package/dist/utility/wrun/wrun-market-facts.util.d.ts +13 -3
  115. package/dist/utility/wrun/wrun-market-facts.util.js +13 -3
  116. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +20 -10
  117. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +10 -5
  118. package/dist/utility/wrun/wrun-option-book-rows.util.d.ts +56 -0
  119. package/dist/utility/wrun/wrun-option-book-rows.util.js +96 -0
  120. package/dist/utility/wrun/wrun-option-views.util.d.ts +281 -20
  121. package/dist/utility/wrun/wrun-option-views.util.js +391 -50
  122. package/dist/utility/wrun/wrun-options-chain.util.d.ts +3 -3
  123. package/dist/utility/wrun/wrun-options-chain.util.js +2 -0
  124. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +15 -2
  125. package/dist/utility/wrun/wrun-overlay-drivers.util.js +13 -3
  126. package/dist/utility/wrun/wrun-overlay-recovery.util.js +3 -1
  127. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +60 -11
  128. package/dist/utility/wrun/wrun-overlay-run.util.js +529 -113
  129. package/dist/utility/wrun/wrun-panel-mount.util.js +51 -6
  130. package/dist/utility/wrun/wrun-pin-spelling.util.d.ts +15 -2
  131. package/dist/utility/wrun/wrun-pin-spelling.util.js +27 -3
  132. package/dist/utility/wrun/wrun-refusal.util.d.ts +3 -2
  133. package/dist/utility/wrun/wrun-refusal.util.js +22 -0
  134. package/dist/utility/wrun/wrun-registry-errors.util.d.ts +26 -0
  135. package/dist/utility/wrun/wrun-registry-errors.util.js +34 -0
  136. package/dist/utility/wrun/wrun-replay-lane.util.js +3 -2
  137. package/dist/utility/wrun/wrun-run-interval-session.util.d.ts +20 -6
  138. package/dist/utility/wrun/wrun-run-interval-session.util.js +22 -7
  139. package/dist/utility/wrun/wrun-run-interval.util.d.ts +39 -7
  140. package/dist/utility/wrun/wrun-run-interval.util.js +49 -9
  141. package/dist/utility/wrun/wrun-socket-row-source.js +7 -2
  142. package/dist/utility/wrun/wrun-source-rows.util.d.ts +29 -22
  143. package/dist/utility/wrun/wrun-source-rows.util.js +62 -41
  144. package/dist/utility/wrun/wrun-tape-per-order.util.js +1 -20
  145. package/dist/utility/wrun/wrun-tape-source.util.d.ts +17 -9
  146. package/dist/utility/wrun/wrun-tape-source.util.js +20 -12
  147. package/dist/utility/wrun/wrun-volume-profile.util.js +37 -29
  148. package/dist/workers/constants/socket-slots.d.ts +91 -6
  149. package/dist/workers/constants/socket-slots.js +85 -6
  150. package/package.json +5 -5
  151. package/dist/kscript-data/controls/live-trades-order-gate.util.d.ts +0 -56
  152. package/dist/kscript-data/controls/live-trades-order-gate.util.js +0 -107
package/README.md CHANGED
@@ -128,6 +128,7 @@ 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.11.0 | `@orangecharts/indicator-kit` 0.105.0, `@orangecharts/orange-v2-pb-common` 12.78.0, `dayjs` 1.11.23, `lodash-es` 4.18.1 | D-DEDUPE phase 1b, the book folds on `options_chain`: an input's `page_view` / `page_views` may name the data plane's folds of the chain page's whole book (`numbers`, `vol_term`, `smile`, `surface`, `strike_profile`; kit scaffold 105), the numbers the built-in options panes draw. `utility/wrun/wrun-option-views.util` copies the kit's book tables, pinned to it (`WRUN_OPTION_BOOK_VIEWS`, `WRUN_OPTION_BOOK_VIEW_ROW_WIDTHS`, `WRUN_OPTION_BOOK_EXPIRIES_TAKES`, `WRUN_OPTION_BOOK_SCOPE_TAKES`, and `WRUN_OPTION_BOOK_SHARED_KNOBS`, the knobs a view of the block shares with a book fold) and rules (`wrunOptionViewWordsRowWidth`, `wrunOptionViewRowWidthsOf`, `wrunOptionViewsReadBlock`, `wrunOptionBookViewIssue`); the answer's half, `utility/wrun/wrun-option-book-rows.util` (`WRUN_OPTION_BOOK_LAYOUTS`, `WRUN_OPTION_BOOK_LAYOUT_WIDTHS`, `WRUN_OPTION_BOOK_STAMP_VERSION`, `wrunOptionBookViewRows`, `wrunOptionIsBookLayout`), loads with a host's chain transport alone, out of what the chart parses before its first candle; `wrunOptionViewSpec` answers a book word's spec, `WrunOptionKnobSpec` takes `zero` (a book fold's part turned off) and `WrunOptionView.view` widens to `WrunOptionPageViewWord`. A book fold plans (`wrunOptionViewsOfSource` judges its knobs by the kit's rules, `wrun_option_knob_invalid`; `wrunOptionViewUnread` still refuses the folds of the block, which read the chart's close), and its ask carries each view's declared params alone: `wrunOptionViewLaneFields` and `wrunOptionViewAskFieldsOf` drop the expiries word and the max-contracts size from an ask of book folds alone, and keep them for a mixed ask's views of the block. The input's block is the view block at the widest of its words (`wrunOptionInputTupleWidth`, `wrunOptionLaneTupleWidth`: 11, 12, 13 or 16 values a row). `wrunOptionViewsUnion` refuses by name one lane's inputs that read a book fold and different views (`wrun_option_book_views_one_ask`: the lane asks their union once, and a book row names no input) and a union of more than 16 views (`wrun_option_views_too_many`, the data plane's most). A host's chain transport lays an answer's book entries out with `wrunOptionBookViewRows` (one book stamp row, then each fold's rows; its refusals by name) and asks a book fold at no bar (web: the `k-options-chain` worker, keyed as the built-in panes and the Options panel head key the same folds, one read for all). The kit peer moves from 0.103.1 to 0.105.0. The package commits landed since 0.10.0 ride along (`git log 357b44995c.. -- packages/wrun-chart-host` in the web repo). |
131
132
  | 0.10.0 | `@orangecharts/indicator-kit` 0.103.1, `@orangecharts/orange-v2-pb-common` 12.78.0, `dayjs` 1.11.23, `lodash-es` 4.18.1 | OPRA on the package side: stock perps and tokenized stocks read their stock's OPRA chain (`derived-roots.util`, `sources/opra-option-lanes.util`, `wrun-chart-gate-reader.util`); the OPRA plane's user-script decision (`kscript-venue-policy.util` `isOpraUserScriptRun`, the `opra-user-scripts` flag, `opra-user-scripts-gate.util`, `opra-read-access.leaf`, `wrun-opra-lane.util`); the OPRA registration path is gone (the gate registers delayed access itself on the first refusal, a refused read ends as the gated `opra-registration` outcome); the OPRA agreement notice shows once per app open; the chart's OPRA reader is dialled at chart load. `FeatureFlag` gains `Opra`, `OpraUserScripts` and `OpraAlerts`. Options: CME option reads group on the gateway's session and regular-hours anchors and name the chain's venue at every grouping call, and weekend rows of CME products that trade around the clock stay; the strike kit's gamma curve row; strike velocity wire decode; Options GEX levels in the chart's ink; the Options Heatmap's nodes look, dealer-flow metrics and first-paint reads (crypto, CME, OPRA); Skylit-parity node levels, boards and flow score; one numbers convention across the options panes; the heatmap's crypto arm can read the server strike rows (internal switch). wrun runs: every byte a run downloads is counted and reported on the attempt, an over-budget indicator reads its newest bars first and stops near 1 MB, one download budget per add, a folded read is bounded by its share; Big Trades floors CME charts in contracts and sizes in dollars or the market's own unit, and judges the size floor per aggressor order behind one switch; a row lane draws its newest sessions first; a colour member's `when` gate reaches its swatch and a row's `when` gate reads one clause over another row's value; house look and dismissal for HUD cards and panels; the order-flow family is refused on option contract charts; a gate reader that stops delivering is re-asked. Tools: Path line width and style, tool tables regenerated from chart-schema 0.5.2. The kit peer moves from 0.91.1 to 0.103.1 and the protocol enums peer from 12.73.0 (what npm's 0.9.0 declares; the 0.9.0 row says 12.72.0) to 12.78.0. The package commits landed since 0.9.0 ride along (`git log a840defa10.. -- packages/wrun-chart-host` in the web repo). |
132
133
  | 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). |
133
134
  | 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. |
@@ -4,10 +4,16 @@ export declare const FeatureFlag: {
4
4
  readonly RobinhoodTrading: "robinhood-trading";
5
5
  readonly PulseMain: "pulse-main";
6
6
  readonly OmBoard: "om-board";
7
+ readonly ChartClips: "chart-clips";
7
8
  readonly ScriptOffers: "script-offers";
8
9
  readonly PaperTrading: "paper-trading";
9
10
  readonly LighterExecution: "lighter-execution";
11
+ readonly FuturesTrading: "futures-trading";
12
+ readonly FuturesByofChart: "futures-byof-chart";
13
+ readonly FuturesByofDepth: "futures-byof-depth";
14
+ readonly FuturesByofHistory: "futures-byof-history";
10
15
  readonly CoinbaseDerivativesExecution: "coinbase-derivatives-execution";
16
+ readonly PolymarketExecution: "polymarket-execution";
11
17
  readonly TradingHub: "trading-hub";
12
18
  readonly TradingVolume: "trading-volume";
13
19
  readonly DataLoadHealRegister: "data-load-heal-register";
@@ -18,6 +24,7 @@ export declare const FeatureFlag: {
18
24
  readonly FreeTrial: "free-trial";
19
25
  readonly MyAccess: "my-access";
20
26
  readonly KscriptTwinConvert: "kscript-twin-convert";
27
+ readonly KscriptSunset: "kscript-sunset";
21
28
  readonly WrunRegistryDev: "wrun-registry-dev";
22
29
  readonly RegistrySession: "registry-session";
23
30
  readonly SharingHub: "sharing-hub";
@@ -30,10 +37,12 @@ export declare const FeatureFlag: {
30
37
  readonly PrepaidPlusCn: "prepaid-plus-cn";
31
38
  readonly ApiConsole: "api-console";
32
39
  readonly Opra: "opra";
40
+ readonly UsEquitiesFull: "us-equities-full";
33
41
  readonly CmeEngine: "cme-engine";
34
42
  readonly VariationalMarkets: "variational-markets";
35
43
  readonly OptionsPanel: "options-panel";
36
44
  readonly OpraUserScripts: "opra-user-scripts";
45
+ readonly CmeUserScripts: "cme-user-scripts";
37
46
  readonly OpraAlerts: "opra-alerts";
38
47
  readonly PlusUsdcAutopay: "plus-usdc-autopay";
39
48
  readonly EmsHyperliquid: "ems-hyperliquid";
@@ -31,6 +31,14 @@ export const FeatureFlag = {
31
31
  // (useOmBoardFlag): unminted, absent and guest all read off, so production ships it dark; an
32
32
  // internal role reads it on, the dev override lights it locally. Mint it enabled to open it up.
33
33
  OmBoard: 'om-board',
34
+ // Chart clips (docs/features/academy/clips.md): the Record glyph (top bar, replay bar), the clip door a voiced
35
+ // Replay card opens (the player on the reader's chart, the poster player on the Board) and the clip chips read the
36
+ // Board's key AND this one through `isOn` (useChartClipsFlag): unminted, absent and guest all read off, so
37
+ // production ships it dark with the Board on or off; a minted doc lets an internal role preview it, the dev/internal
38
+ // localStorage override lights it locally (`kiyo.flag-overrides` -> `{"chart-clips": true}`). Mint it enabled to
39
+ // open it up. Off, a voiced card is a silent Replay card (the replay opens without the voice and the track). Orange's
40
+ // upload route stays behind `om-board`.
41
+ ChartClips: 'chart-clips',
34
42
  // Author-side script offers ONLY (the "Offer to a client" entry in the
35
43
  // publish dialog's grant strip). The operator inbox, placements, and
36
44
  // notification renderers are clientId-gated and data-dormant, so they ship
@@ -54,6 +62,21 @@ export const FeatureFlag = {
54
62
  // localStorage override lights it locally (`kiyo.flag-overrides` -> `{"lighter-execution": true}`).
55
63
  // Mint it enabled to open it up. A key this browser already holds keeps trading after it turns off.
56
64
  LighterExecution: 'lighter-execution',
65
+ // Futures order entry through the user's own Rithmic-enabled broker account (connect dialog, order
66
+ // ticket, working orders and positions, and the live quote from the user's own feed); the credential
67
+ // lives only in the browser tab. Read through `isOn`: unminted, absent and guest all read off; the
68
+ // dev/internal localStorage override lights it locally (`kiyo.flag-overrides` -> `{"futures-trading": true}`).
69
+ FuturesTrading: 'futures-trading',
70
+ // Bring-your-own-feed Part 2, one key per kind of data so each ships when Rithmic permits it (all on
71
+ // top of `futures-trading`; the localStorage override lights them for building and testing):
72
+ // - live candles from the user's own Rithmic trades (trades are permitted, Rithmic 2026-10-27);
73
+ FuturesByofChart: 'futures-byof-chart',
74
+ // - the order book (depth) from the session, for the DOM ladder, order book panel and bid/ask
75
+ // lines; awaiting Rithmic's permission, so dark;
76
+ FuturesByofDepth: 'futures-byof-depth',
77
+ // - the newest gap of a delayed chart filled from Rithmic's history plant; historical data is
78
+ // outside what Rithmic has permitted (conformance Q13), so dark until it is.
79
+ FuturesByofHistory: 'futures-byof-history',
57
80
  // Coinbase derivatives execution (the Deribit engine for non-US accounts; Kyle 2026-10-23 took it
58
81
  // off the paper trading key to hide it). Its own key, read through `isOn` by `isCexVenueFlagOn`, in
59
82
  // Lighter's shape: unminted, absent and guest all read off, internal roles included (no document,
@@ -62,6 +85,13 @@ export const FeatureFlag = {
62
85
  // `{"coinbase-derivatives-execution": true}`). Mint it enabled to open it up. A key this browser
63
86
  // already holds keeps trading, and keeps its card to manage it.
64
87
  CoinbaseDerivativesExecution: 'coinbase-derivatives-execution',
88
+ // Polymarket execution (docs/features/polymarket-execution/README.md): the prediction-market venue, a
89
+ // lane of its own beside the exchange seam. Its own key, read through `isOn` by
90
+ // `isPolymarketExecutionOn`: unminted, absent and guest all read off, so production ships it dark; the
91
+ // dev/internal localStorage override lights it locally (`kiyo.flag-overrides` ->
92
+ // `{"polymarket-execution": true}`). Mint it enabled to open it up. A linked account this browser
93
+ // already holds keeps trading after it turns off.
94
+ PolymarketExecution: 'polymarket-execution',
65
95
  // The trading hub (docs/features/trading-hub/README.md): one Trade door beside the avatar that
66
96
  // folds the desktop's linking, accounts and trade settings into one dialog. Rides the master
67
97
  // trading flag AND this key, read through `isOn` (`isTradingHubOn`): unminted, absent and guest
@@ -128,6 +158,12 @@ export const FeatureFlag = {
128
158
  // a converted row reverts to its original row at its NEXT boot (the flag is
129
159
  // read at the boot tail, never mid-session), one reconcile save per chart.
130
160
  KscriptTwinConvert: 'kscript-twin-convert',
161
+ // KSCRIPT-SUNSET (Kyle 2026-10-29): the one flag doc of the kScript retirement. UNMINTED = the "Retires in
162
+ // {n} days" chip shows for everyone before KSCRIPT_RETIRED_AT and the cut lands on the date; minted with a
163
+ // percent = the chip's ladder only (the cut is never laddered); minted `enabled: false` = the kill (today's
164
+ // behaviour byte for byte while the engine still ships; read through isExplicitlyOff, handed to
165
+ // utility/chart/kscript-sunset.util by the chart store). No DEV_FORCED_FLAGS and no GUEST_DEFAULT_FLAGS entry.
166
+ KscriptSunset: 'kscript-sunset',
131
167
  // Developer tools of the Indicators tab (add a package by exact name, this
132
168
  // browser's publish receipts). Read ONLY through the dev/internal
133
169
  // localStorage override (`kiyo.flag-overrides` -> `{"wrun-registry-dev": true}`,
@@ -220,6 +256,15 @@ export const FeatureFlag = {
220
256
  // affordance, contract charts and the purchase screens. Minted dark; the data tier itself is the
221
257
  // OPRA gate's and never flips with this flag (employees stay delayed like everyone).
222
258
  Opra: 'opra',
259
+ // The US stocks tape on the chart (docs/features/data/us-stocks-tape.md): order flow from the tape on a US stock
260
+ // chart (footprint, profiles, TPO, the CVD family read the ticker's tape market, utility/stocks/stock-tape-overlay.util),
261
+ // time and sales, the exchange list, the $19 add-on surfaces, and the price alert redirect onto the free lane
262
+ // (src/utility/alerts/stocks-alert-target.util.ts). Minted dark; read through `usEquitiesFullEnabled()` /
263
+ // `useUsEquitiesFull()` (src/utility/stocks/us-equities-flag.util.ts) with `isOn`, so unminted, absent and guest
264
+ // read off and production ships it dark; with it off nothing in the app changes. The data tier is the stocks gate's
265
+ // (905 s delayed for everyone today) and never flips with this flag. QA:
266
+ // `localStorage.setItem('kiyo.flag-overrides', '{"us-equities-full":true}')`.
267
+ UsEquitiesFull: 'us-equities-full',
223
268
  // CME real-time on the venue-generic market-data flow (ENTITLEMENT-PLANE Program B; docs/features/market-data/
224
269
  // plane.md, "CME on the plane"). While lit, the market-data registry lists the CME card
225
270
  // (`marketDataVenueIsServed('cme')`), the one CME purchase overlay mounts as the generic flow on
@@ -255,8 +300,24 @@ export const FeatureFlag = {
255
300
  // over OPRA data are marked and every copy of console text strips them). To be minted dark (admin panel);
256
301
  // read with `isOn` (absent, unloaded and guest read off): `opraUserScriptsEnabled()` (opra-options-gate.util)
257
302
  // on the main thread, the published gate (opra-user-scripts-gate.util) in the venue policy.
258
- // QA: `localStorage.setItem('kiyo.flag-overrides', '{"opra-user-scripts":true}')`.
303
+ // LAUNCHED 2026-10-27: the gate answers open on every build (opra-user-scripts-gate.util); this record
304
+ // is retired and read by nothing.
259
305
  OpraUserScripts: 'opra-user-scripts',
306
+ // User-authored chart studies on CME (wrun CME Chart Studies), the browser lane only. While lit, a script the
307
+ // browser runs that the viewer wrote or added from the community (a kScript user script or editor draft, an
308
+ // Indicator draft, a community package) reads CME futures data at the viewer's own entitlement: the display wall,
309
+ // the data wall and the engine policy lift for it on the CME plane only (kscript-venue-policy.util
310
+ // `isCmeUserScriptRun`, the one decision), and only for a viewer the CME plane serves (signed in, not a guest, the
311
+ // CME data terms not blocked; delayed and real-time both count, the tier is the gate's). Both facts reach the
312
+ // worker-safe venue policy through cme-user-scripts-gate.util (closed in a worker, for a guest and before a reader
313
+ // is handed over). What stays refused whatever it says: hosted (Cloud) runs and protected scripts, indicator alerts
314
+ // (price alerts are unchanged), strategies and backtests, the export of a study's results (console copies, clips),
315
+ // agent reads (chart_read and the MCP withhold the stamped study) and the publish cover's capture of a chart that
316
+ // carries CME data. A move of the flag, the account, the terms, the served access or the session stops a running
317
+ // study in place and keeps its source and settings. To be minted dark (admin panel); read with `isOn` (absent,
318
+ // unloaded and guest read off) and never read server-side: kscript-backend denies CME to every user run whatever it
319
+ // says. QA: `localStorage.setItem('kiyo.flag-overrides', '{"cme-user-scripts":true}')`.
320
+ CmeUserScripts: 'cme-user-scripts',
260
321
  // Alerts on US options (UW-PARITY H3, the OPRA server lanes): while lit, a viewer the OPRA gate serves real-time
261
322
  // can set a price alert or an Indicator alert on a US option contract, which the alerts engine evaluates on its
262
323
  // OPRA lane (the contract's own candles, for the alert's owner alone). Off: today's refusal on every alert door.
@@ -365,9 +426,11 @@ export const FeatureFlag = {
365
426
  OptionsAccessPrewarm: 'options-access-prewarm',
366
427
  // The indicator download budget's cut (OPTLOAD W3 R2, docs/features/kscript/wrun/wrun-browser-runtime.md, "The download
367
428
  // budget"): a browser-run Indicator whose projected download passes 1 MB per 252 bars reads its newest bars first and
368
- // stops near the budget, the older bars partial, with the "Newest bars only" chip. Off: whole asks always, the meter
369
- // still counts. Read through `isOn`: unminted, absent and guest all read off, so production ships it dark until Kyle
370
- // switches it on; the dev/internal localStorage override lights it for a rig (`kiyo.flag-overrides` ->
429
+ // stops near the budget, the older bars partial, with the "Newest bars only" chip, and the download plan that decides
430
+ // it. Off: no cut and no plan, the meter still counts. Only the cut rides this flag: an add's record of the bars it
431
+ // landed whole and final (wrun-row-lane-add-memo.util), which its later runs, its live start and every live reconcile
432
+ // reuse, is kept flag on or off. Read through `isOn`: unminted, absent and guest all read off, so production ships it
433
+ // dark until Kyle switches it on; the dev/internal localStorage override lights it for a rig (`kiyo.flag-overrides` ->
371
434
  // `{"wrun-download-budget-cut": true}`).
372
435
  WrunDownloadBudgetCut: 'wrun-download-budget-cut',
373
436
  };
@@ -9,3 +9,15 @@
9
9
  export declare const CME_GOVERNED_EXCHANGES: readonly string[];
10
10
  /** Every OPRA-governed exchange code (one consolidated venue by design). */
11
11
  export declare const OPRA_GOVERNED_EXCHANGES: readonly string[];
12
+ /**
13
+ * Every exchange code the US stocks entitlement gate governs, as the FRONTEND names the three SIP tapes: `NYSE_TAPE`
14
+ * (Tape A), `NYSE_ARCA_TAPE` (Tape B), `NASDAQ_TAPE` (Tape C), in the gate release's order. The gate keys each tape by
15
+ * its listing venue's `Exchange` enum member (`NYSE` 70, `NYSE_ARCA` 71, `NASDAQ` 72), but those plain codes are already
16
+ * the free lane's LISTING-VENUE codes in this app (a Polygon-fed stock chart carries `NASDAQ` as its exchange or display
17
+ * venue: `POLYGON_VENUES`, `EXCHANGE_TO_KIND`, `LEGACY_VENUE_TO_QUERY_EXCHANGE`), so the tape codes carry a suffix and
18
+ * `STOCKS_TAPE_WIRE_EXCHANGE` translates them at the wire alone (stocks-governed.util). The web constant is
19
+ * `STOCKS_GOVERNED_EXCHANGES` in src/interfaces/stocks-realtime.interface.ts.
20
+ */
21
+ export declare const STOCKS_GOVERNED_EXCHANGES: readonly string[];
22
+ /** The gate's wire name of each tape code: the listing venue, an `Exchange` enum member the tape is keyed by. */
23
+ export declare const STOCKS_TAPE_WIRE_EXCHANGE: Readonly<Record<string, string>>;
@@ -9,3 +9,19 @@
9
9
  export const CME_GOVERNED_EXCHANGES = ['CME', 'CBOT', 'NYMEX', 'COMEX', 'GLOBEX'];
10
10
  /** Every OPRA-governed exchange code (one consolidated venue by design). */
11
11
  export const OPRA_GOVERNED_EXCHANGES = ['OPRA'];
12
+ /**
13
+ * Every exchange code the US stocks entitlement gate governs, as the FRONTEND names the three SIP tapes: `NYSE_TAPE`
14
+ * (Tape A), `NYSE_ARCA_TAPE` (Tape B), `NASDAQ_TAPE` (Tape C), in the gate release's order. The gate keys each tape by
15
+ * its listing venue's `Exchange` enum member (`NYSE` 70, `NYSE_ARCA` 71, `NASDAQ` 72), but those plain codes are already
16
+ * the free lane's LISTING-VENUE codes in this app (a Polygon-fed stock chart carries `NASDAQ` as its exchange or display
17
+ * venue: `POLYGON_VENUES`, `EXCHANGE_TO_KIND`, `LEGACY_VENUE_TO_QUERY_EXCHANGE`), so the tape codes carry a suffix and
18
+ * `STOCKS_TAPE_WIRE_EXCHANGE` translates them at the wire alone (stocks-governed.util). The web constant is
19
+ * `STOCKS_GOVERNED_EXCHANGES` in src/interfaces/stocks-realtime.interface.ts.
20
+ */
21
+ export const STOCKS_GOVERNED_EXCHANGES = ['NYSE_TAPE', 'NYSE_ARCA_TAPE', 'NASDAQ_TAPE'];
22
+ /** The gate's wire name of each tape code: the listing venue, an `Exchange` enum member the tape is keyed by. */
23
+ export const STOCKS_TAPE_WIRE_EXCHANGE = {
24
+ NYSE_TAPE: 'NYSE',
25
+ NYSE_ARCA_TAPE: 'NYSE_ARCA',
26
+ NASDAQ_TAPE: 'NASDAQ',
27
+ };
@@ -1,5 +1,5 @@
1
1
  import type { OptionSettlementFamily } from '../utility/options/option-symbol.util.js';
2
- import type { GateProvider } from '../workers/constants/socket-slots.js';
2
+ import type { OptionsGateProvider } from '../workers/constants/socket-slots.js';
3
3
  /**
4
4
  * One settlement family a venue lists as its own product. `quoteAsset` names the pair (`BTC/USDC`);
5
5
  * omitted, the contract is quoted and settled in the root coin itself and the pair is the root.
@@ -37,7 +37,7 @@ export interface OptionVenue {
37
37
  exchanges: readonly string[];
38
38
  lane: 'governed' | 'plain';
39
39
  /** Governed rows name their entitlement-gate plane: the socket slots, served-access rows and delay default they ride. */
40
- plane?: GateProvider;
40
+ plane?: OptionsGateProvider;
41
41
  gated: boolean;
42
42
  /**
43
43
  * Which gate lights a gated row: the crypto providers share `crypto-options` (signed in); OPRA has its
@@ -182,15 +182,7 @@ export interface WrunChartHostEnv {
182
182
  * once per pass, and only for a run that carries a table on a normal cell (wrunHostLeavesTablesToWindow). web:
183
183
  * answered from the layout's window cells. */
184
184
  tablesShownInWindow?: (chartIndex: number, overlayId: string) => boolean;
185
- /** Optional (next release). The per-order floor's switch: whether the CME Group venues' tapes are judged per
186
- * aggressor ORDER, history and live together (the gateway's `minAmountPerOrder` read answers every fill of an order
187
- * whose total reached the floor, the fills below it included; the live raw prints pass the order gate,
188
- * kscript-data/controls/live-trades-order-gate.util). True: a tape on such a venue asks the per-order history read,
189
- * gates its live prints per order, folds and adapts them with no per-fill floor, and Big Trades' contracts floor
190
- * follows the product root (`wrunTapePerOrder`, utility/wrun/wrun-tape-per-order.util, the one reader). Absent or
191
- * false (the sandbox worker's env, the phone app's host copy): the behaviour before the member, exactly (the floored
192
- * reads, each fill judged by the floor). web: a getter over its build flag (`environment.WRUN_TAPE_PER_ORDER`,
193
- * VITE_WRUN_TAPE_PER_ORDER, off by default) until the instrument registry names the plane (`largeTradePerOrder`). */
185
+ /** Optional. The per-order switch (`wrunTapePerOrder` is its one reader); absent reads off, as the sandbox and phone app ship. */
194
186
  tapePerOrder?: boolean;
195
187
  }
196
188
  /** The mounted chart and the host's chart store, as package code reads and writes them. */
@@ -29,7 +29,7 @@ import type { WrunRefusal, WrunRefusalClass, WrunRefusalOverlayTarget } from './
29
29
  import type { WrunRowSourceIdentity } from './utility/wrun/wrun-row-source.js';
30
30
  import type { WrunSocketTransport } from './utility/wrun/wrun-socket-row-source.js';
31
31
  import type { WrunColorTheme } from './utility/wrun/wrun-style-words.util.js';
32
- import type { GateProvider as WrunGateProvider } from './workers/constants/socket-slots.js';
32
+ import type { GateProvider as WrunGateProvider, OptionsGateProvider as WrunOptionsGateProvider } from './workers/constants/socket-slots.js';
33
33
  export type { WrunRowSourceIdentity, WrunRowSourcePatch, WrunRowSourceRecord, WrunRowWindow, } from './utility/wrun/wrun-row-source.js';
34
34
  export type { WrunSocketAsk, WrunSocketAskKind, WrunSocketChartRows, WrunSocketLoadSignals, WrunSocketTransport, } from './utility/wrun/wrun-socket-row-source.js';
35
35
  /** The overlay a hosted port acts for. */
@@ -151,9 +151,13 @@ export interface WrunChartStoreView {
151
151
  hasVisibleDrawings?: boolean;
152
152
  }): void;
153
153
  /** CHANGED: the lines with the provenance of the run that printed them (web: console-run-output.leaf
154
- * `IndicatorOutputProvenance`): `opra` when the run read OPRA, its own fact from before it computed. Required. */
154
+ * `IndicatorOutputProvenance`): `opra` when the run read OPRA, its own fact from before it computed. Required.
155
+ * CHANGED (next release): `cme` when the run is a CME user study (the `cme-user-scripts` gate opened the CME plane
156
+ * to it), its own fact from before it computed; optional, so every writer that names OPRA alone compiles as before
157
+ * and reads unmarked for CME. */
155
158
  setIndicatorPrintOutputs(chartIndex: number, indicatorId: string, printOutputsInput: unknown, provenance: {
156
159
  opra: boolean;
160
+ cme?: boolean;
157
161
  }): void;
158
162
  setIndicatorRunOutputSummary(chartIndex: number, indicatorId: string, runResult: WrunKScriptRunResultLike | null): void;
159
163
  setKScriptLoadingIndicator(chartIndex: number, indicatorId: string, loading: boolean): void;
@@ -258,12 +262,16 @@ export interface WrunMainCandleRequestIdentity {
258
262
  category?: number;
259
263
  }
260
264
  /** The identity a chart's mounted main rows were loaded for, the fields the package reads (web: ohlcv-cache.types.ts
261
- * `MainDataRequestIdentity`; one way, web's carries the pool, session and adjustment fields too). */
265
+ * `MainDataRequestIdentity`; one way, web's carries the pool and adjustment fields too). */
262
266
  export interface WrunLoadedMainIdentity {
263
267
  readonly exchange: string | null;
264
268
  readonly symbol: string | null;
265
269
  readonly interval: string | null;
266
270
  readonly transformations: string | null;
271
+ /** The chart's persisted session word the rows were loaded under: the identity compare reads the session the chart
272
+ * rides from it (`wrunChartMarketIdentity`'s fifth term, effectiveChartSessionType), so a host that leaves it out
273
+ * compares as the market's default session. */
274
+ readonly sessionType?: unknown;
267
275
  }
268
276
  /** A lazy-load check's target range (web: utility/chart/viewport-pan-tracking.util.ts `LazyLoadTargetRange`). */
269
277
  export interface WrunLazyLoadTargetRange {
@@ -417,7 +425,14 @@ export interface WrunMarketsRawPage {
417
425
  pageCount?: number;
418
426
  incomplete?: boolean;
419
427
  failedSources?: readonly unknown[];
428
+ pendingSources?: readonly unknown[];
420
429
  vetoed?: true;
430
+ /** A batched read's lost pairs (web: `MarketsRawPage.unansweredPairs`): their absence proves nothing. */
431
+ unansweredPairs?: ReadonlyArray<{
432
+ exchange: unknown;
433
+ rawSymbol?: string;
434
+ normalizedSymbol?: string;
435
+ }>;
421
436
  }
422
437
  /** CHANGED 0.5.0: loader view of the metadata service: the one market query lanes ask, and the raw catalog page and the
423
438
  * block sizes a run reads. */
@@ -446,7 +461,7 @@ export interface WrunMetadataServiceModule {
446
461
  }
447
462
  /** The gate planes an option chain lists on (workers/constants/socket-slots.ts `GateProvider`) and a crypto option
448
463
  * chain's source (utility/options/option-venue.util.ts `OptionSource`): both modules moved in phase 1a. */
449
- export type { WrunGateProvider, WrunOptionSource };
464
+ export type { WrunGateProvider, WrunOptionsGateProvider, WrunOptionSource };
450
465
  /** The chart facts the options chart source reads (web: indicators/controls/optionsChartSource.ts `OptionsChartMetadata`;
451
466
  * its `category` is the protocol package's enum, unknown here). */
452
467
  export type WrunOptionsChartMetadata = {
@@ -457,7 +472,7 @@ export type WrunOptionsChartMetadata = {
457
472
  } | null | undefined;
458
473
  /** Where an options control reads its chain (web: optionsChartSource.ts `OptionsChartSource`). */
459
474
  export type WrunOptionsChartSource = {
460
- venue: WrunGateProvider;
475
+ venue: WrunOptionsGateProvider;
461
476
  exchange: string;
462
477
  underlying: string;
463
478
  } | {
@@ -470,7 +485,7 @@ export type WrunOptionsChartSource = {
470
485
  /** Loader view of the options chart source. */
471
486
  export interface WrunOptionsChartSourceModule {
472
487
  /** `plane`: a run's frozen decision (the plane its head decided), so no lane of the run decides again. */
473
- resolveOptionsChartSource(metadata: WrunOptionsChartMetadata, plane?: WrunGateProvider | null): Promise<WrunOptionsChartSource>;
488
+ resolveOptionsChartSource(metadata: WrunOptionsChartMetadata, plane?: WrunOptionsGateProvider | null): Promise<WrunOptionsChartSource>;
474
489
  }
475
490
  /** Why a chart whose options list on OPRA reads none: the reason the gate folds into `governedOptionPlane`'s null
476
491
  * (web: utility/options/opra-options-gate.util.ts `OpraOptionPlaneStop`). */
@@ -497,7 +512,7 @@ export interface WrunChartOptionsMarket extends WrunChartOptionsMarketRef {
497
512
  * CHANGED (next release): the plane decisions take `WrunChartOptionsMarketRef` (the `symbol` key required), and two
498
513
  * optional ports read the stock twin seam; a host that binds neither reads every chart's options off its own market. */
499
514
  export interface WrunOptionsGateModule {
500
- governedOptionPlane(metadata: WrunChartOptionsMarketRef | null | undefined): WrunGateProvider | null;
515
+ governedOptionPlane(metadata: WrunChartOptionsMarketRef | null | undefined): WrunOptionsGateProvider | null;
501
516
  opraOptionPlaneStop(metadata: WrunChartOptionsMarketRef | null | undefined): OpraOptionPlaneStop | undefined;
502
517
  opraFlagDecidesChartOptions(metadata: WrunChartOptionsMarketRef | null | undefined): boolean;
503
518
  awaitOpraFlagHydration(timeoutMs?: number): Promise<void>;
@@ -507,6 +522,16 @@ export interface WrunOptionsGateModule {
507
522
  * `armOpraUserScriptsRejudge`: the first time the flag turns on, every chart's walled user-script overlays are
508
523
  * judged again). A host that binds none leaves such a run walled until its next run. */
509
524
  armOpraUserScriptsRejudge?(): void;
525
+ /** NEW (next release, optional): the bounded wait for the flag map a run the `cme-user-scripts` gate may open the
526
+ * CME plane to waits on before a CME wall reads it, the twin of `awaitOpraUserScriptsFlagHydration` (web:
527
+ * `awaitCmeUserScriptsFlagHydration`). A host that binds none judges by the map as it stands, closed until it
528
+ * lands. */
529
+ awaitCmeUserScriptsFlagHydration?(timeoutMs?: number): Promise<void>;
530
+ /** NEW (next release, optional): arm the late re-judgment of the CME user-study overlays a CME wall judged closed,
531
+ * called by a run head whose bounded `cme-user-scripts` wait ran out with the flag dark, the twin of
532
+ * `armOpraUserScriptsRejudge` (web: `armCmeUserScriptsRejudge`: the first time the gate opens, every chart's walled
533
+ * CME user studies are judged again). A host that binds none leaves such a run walled until its next run. */
534
+ armCmeUserScriptsRejudge?(): void;
510
535
  /** NEW (next release, optional): the market whose options a chart reads (web: `chartOptionsMarket`, the input itself
511
536
  * for every market but a known stock twin under a lit opra flag). */
512
537
  chartOptionsMarket?(market: WrunChartOptionsMarketRef): WrunChartOptionsMarket;
@@ -1063,6 +1088,10 @@ export interface WrunStandInChart {
1063
1088
  transformations?: unknown;
1064
1089
  /** The signed-in account the chart is viewed by (none reads as the guest). */
1065
1090
  account?: string | null;
1091
+ /** The chart's persisted session and back-adjustment: with the venue they name the candle set the picture is drawn
1092
+ * on (web: `kscriptStandInCandlesOf`, the candle cache's own key fork on CME and Polygon equities). */
1093
+ sessionType?: unknown;
1094
+ adjusted?: unknown;
1066
1095
  }
1067
1096
  /** The engine surface a stand-in uses: the adapter's chart view plus mount, removal, batch and the load state (web:
1068
1097
  * kscript-standin.util.ts `KScriptStandInTarget`). */
package/dist/index.d.ts CHANGED
@@ -46,13 +46,13 @@ export * from './interfaces/replay.interface.js';
46
46
  export * from './interfaces/wrun-runtime.interface.js';
47
47
  export * from './kscript-data/controls/live-ohlcv-merge.util.js';
48
48
  export * from './kscript-data/controls/live-trades-merge.util.js';
49
- export * from './kscript-data/controls/live-trades-order-gate.util.js';
50
49
  export * from './market-data/billing.interface.js';
51
50
  export * from './market-data/venue.js';
52
51
  export * from './market-data/venue-governed.util.js';
53
52
  export * from './market-data/venues/cme.js';
54
53
  export * from './market-data/venues/index.js';
55
54
  export * from './market-data/venues/opra.js';
55
+ export * from './market-data/venues/stocks.js';
56
56
  export * from './replay/replayIndicatorRows.js';
57
57
  export * from './settings-templates/footprint-rows.js';
58
58
  export * from './settings-templates/form-rows.js';
@@ -77,10 +77,12 @@ export * from './utility/chart/cme-cache-context.util.js';
77
77
  export * from './utility/chart/cme-realtime.util.js';
78
78
  export * from './utility/chart/cme-session-bucket.util.js';
79
79
  export * from './utility/chart/cme-trade-calendar.util.js';
80
+ export * from './utility/chart/cme-user-scripts-gate.util.js';
80
81
  export * from './utility/chart/color-customization.leaf.js';
81
82
  export * from './utility/chart/continuous-contracts.util.js';
82
83
  export * from './utility/chart/crypto-index.leaf.js';
83
84
  export * from './utility/chart/date-labelled-interval.leaf.js';
85
+ export * from './utility/chart/effective-chart-session.util.js';
84
86
  export * from './utility/chart/feed-interval.util.js';
85
87
  export * from './utility/chart/fetch-dedupe-policy.util.js';
86
88
  export * from './utility/chart/footprint-band.util.js';
@@ -145,6 +147,7 @@ export * from './utility/chart/local-kscript-warmup-depth.util.js';
145
147
  export * from './utility/chart/local-technical-script-live-apply-coalescer.util.js';
146
148
  export * from './utility/chart/local-technical-script-range.leaf.js';
147
149
  export * from './utility/chart/market-session-schedule.util.js';
150
+ export * from './utility/chart/market-sessions.util.js';
148
151
  export * from './utility/chart/marketKind.util.js';
149
152
  export * from './utility/chart/mixed-mode.util.js';
150
153
  export * from './utility/chart/ny-calendar.util.js';
@@ -195,6 +198,7 @@ export * from './utility/market-events/earnings-scope.util.js';
195
198
  export * from './utility/market-events/zoned-clock.util.js';
196
199
  export * from './utility/number-format.util.js';
197
200
  export * from './utility/options/cme-options-root.util.js';
201
+ export * from './utility/options/option-bar-anchor.util.js';
198
202
  export * from './utility/options/option-book.util.js';
199
203
  export * from './utility/options/option-symbol.util.js';
200
204
  export * from './utility/options/option-trade-date.util.js';
@@ -211,6 +215,7 @@ export * from './utility/v2/gate-plane.util.js';
211
215
  export * from './utility/v2/gate-session-latch.util.js';
212
216
  export * from './utility/v2/governed-tier.leaf.js';
213
217
  export * from './utility/v2/opra-governed.util.js';
218
+ export * from './utility/v2/stocks-governed.util.js';
214
219
  export * from './utility/watchlist/import/import-request.leaf.js';
215
220
  export * from './utility/watchlist/import/tradingview-symbols.leaf.js';
216
221
  export * from './utility/wrun-alert-params.leaf.js';
@@ -324,6 +329,7 @@ export * from './utility/wrun/wrun-oi-lane.util.js';
324
329
  export * from './utility/wrun/wrun-opra-flow.leaf.js';
325
330
  export * from './utility/wrun/wrun-opra-lane.util.js';
326
331
  export * from './utility/wrun/wrun-opra-stats.leaf.js';
332
+ export * from './utility/wrun/wrun-option-book-rows.util.js';
327
333
  export * from './utility/wrun/wrun-option-contract-flow.util.js';
328
334
  export * from './utility/wrun/wrun-option-knobs.util.js';
329
335
  export * from './utility/wrun/wrun-option-prints.util.js';
package/dist/index.js CHANGED
@@ -49,13 +49,13 @@ export * from './interfaces/replay.interface.js';
49
49
  export * from './interfaces/wrun-runtime.interface.js';
50
50
  export * from './kscript-data/controls/live-ohlcv-merge.util.js';
51
51
  export * from './kscript-data/controls/live-trades-merge.util.js';
52
- export * from './kscript-data/controls/live-trades-order-gate.util.js';
53
52
  export * from './market-data/billing.interface.js';
54
53
  export * from './market-data/venue.js';
55
54
  export * from './market-data/venue-governed.util.js';
56
55
  export * from './market-data/venues/cme.js';
57
56
  export * from './market-data/venues/index.js';
58
57
  export * from './market-data/venues/opra.js';
58
+ export * from './market-data/venues/stocks.js';
59
59
  export * from './replay/replayIndicatorRows.js';
60
60
  export * from './settings-templates/footprint-rows.js';
61
61
  export * from './settings-templates/form-rows.js';
@@ -80,10 +80,12 @@ export * from './utility/chart/cme-cache-context.util.js';
80
80
  export * from './utility/chart/cme-realtime.util.js';
81
81
  export * from './utility/chart/cme-session-bucket.util.js';
82
82
  export * from './utility/chart/cme-trade-calendar.util.js';
83
+ export * from './utility/chart/cme-user-scripts-gate.util.js';
83
84
  export * from './utility/chart/color-customization.leaf.js';
84
85
  export * from './utility/chart/continuous-contracts.util.js';
85
86
  export * from './utility/chart/crypto-index.leaf.js';
86
87
  export * from './utility/chart/date-labelled-interval.leaf.js';
88
+ export * from './utility/chart/effective-chart-session.util.js';
87
89
  export * from './utility/chart/feed-interval.util.js';
88
90
  export * from './utility/chart/fetch-dedupe-policy.util.js';
89
91
  export * from './utility/chart/footprint-band.util.js';
@@ -148,6 +150,7 @@ export * from './utility/chart/local-kscript-warmup-depth.util.js';
148
150
  export * from './utility/chart/local-technical-script-live-apply-coalescer.util.js';
149
151
  export * from './utility/chart/local-technical-script-range.leaf.js';
150
152
  export * from './utility/chart/market-session-schedule.util.js';
153
+ export * from './utility/chart/market-sessions.util.js';
151
154
  export * from './utility/chart/marketKind.util.js';
152
155
  export * from './utility/chart/mixed-mode.util.js';
153
156
  export * from './utility/chart/ny-calendar.util.js';
@@ -198,6 +201,7 @@ export * from './utility/market-events/earnings-scope.util.js';
198
201
  export * from './utility/market-events/zoned-clock.util.js';
199
202
  export * from './utility/number-format.util.js';
200
203
  export * from './utility/options/cme-options-root.util.js';
204
+ export * from './utility/options/option-bar-anchor.util.js';
201
205
  export * from './utility/options/option-book.util.js';
202
206
  export * from './utility/options/option-symbol.util.js';
203
207
  export * from './utility/options/option-trade-date.util.js';
@@ -214,6 +218,7 @@ export * from './utility/v2/gate-plane.util.js';
214
218
  export * from './utility/v2/gate-session-latch.util.js';
215
219
  export * from './utility/v2/governed-tier.leaf.js';
216
220
  export * from './utility/v2/opra-governed.util.js';
221
+ export * from './utility/v2/stocks-governed.util.js';
217
222
  export * from './utility/watchlist/import/import-request.leaf.js';
218
223
  export * from './utility/watchlist/import/tradingview-symbols.leaf.js';
219
224
  export * from './utility/wrun-alert-params.leaf.js';
@@ -327,6 +332,7 @@ export * from './utility/wrun/wrun-oi-lane.util.js';
327
332
  export * from './utility/wrun/wrun-opra-flow.leaf.js';
328
333
  export * from './utility/wrun/wrun-opra-lane.util.js';
329
334
  export * from './utility/wrun/wrun-opra-stats.leaf.js';
335
+ export * from './utility/wrun/wrun-option-book-rows.util.js';
330
336
  export * from './utility/wrun/wrun-option-contract-flow.util.js';
331
337
  export * from './utility/wrun/wrun-option-knobs.util.js';
332
338
  export * from './utility/wrun/wrun-option-prints.util.js';
@@ -1,14 +1,29 @@
1
+ import type { MarketSplitSliceId } from '../../utility/chart/market-sessions.util.js';
1
2
  export type TpoTimeRange = {
2
3
  start_time?: unknown;
3
4
  end_time?: unknown;
4
5
  timezone?: unknown;
6
+ /** Weeks and months on UTC, not the range's clock: the gateway cuts its own TradingHour sessions so. Never sent. */
7
+ periodCalendar?: 'UTC';
5
8
  };
9
+ /** A range as the table and the wire spell it: wall times and the clock they are read on. */
10
+ export interface TpoClockRange {
11
+ readonly start_time: string;
12
+ readonly end_time: string;
13
+ readonly timezone: string;
14
+ readonly periodCalendar?: 'UTC';
15
+ }
6
16
  export interface TpoSessionWindow {
7
17
  startSec: number;
8
18
  endSec: number;
9
19
  fullSession: boolean;
10
20
  }
11
- export declare const TPO_TRADING_HOUR_TIME_RANGES: Record<string, TpoTimeRange>;
21
+ /** The presets that are market sessions: hours from market-sessions.util, sent as a range, never a fixed-UTC enum. */
22
+ export declare const TPO_MARKET_SESSION_PRESETS: readonly string[];
23
+ /** Every choice's daily window: the gateway's own sessions (BuildWhereTradingHour serves these rows), the markets'. */
24
+ export declare const TPO_TRADING_HOUR_TIME_RANGES: Readonly<Record<string, TpoClockRange>>;
25
+ /** A range's wall times and clock alone, as the wire and the cache key carry it. */
26
+ export declare function tpoWireTimeRange(range: TpoTimeRange): TpoTimeRange;
12
27
  /** Settings projection every TPO time-range decision reads. */
13
28
  export interface TpoTimeRangeSettings {
14
29
  customTimeRange?: unknown;
@@ -25,12 +40,19 @@ export interface TpoTimeRangeSettings {
25
40
  * active custom sessions each keep their existing behavior.
26
41
  */
27
42
  export declare function resolveTradingDayTpoTimeRange(settings: TpoTimeRangeSettings | null | undefined): TpoTimeRange | undefined;
28
- /**
29
- * Precedence: explicit custom range, then the trading-day anchored range
30
- * (which itself yields to non-'All Hours' trading hours and custom
31
- * sessions), then the trading-hour preset table.
32
- */
33
- export declare function resolveTpoSettingsTimeRange(settings: TpoTimeRangeSettings): TpoTimeRange | undefined;
43
+ /** The trading-hour choice the settings hold: no choice is All Hours, as every TPO payload sends it. */
44
+ export declare function tpoTradingHourOf(settings: {
45
+ tradingHour?: unknown;
46
+ } | null | undefined): string;
47
+ /** A choice's window, venue day aside: a preset's table row (never the range saved beside it), else the saved range. */
48
+ export declare function tpoTradingHourTimeRange(tradingHour: string, savedRange: unknown): TpoTimeRange | undefined;
49
+ /** The one window a TPO cuts its sessions to, for every reader: a saved range beside a preset holds its old hours. */
50
+ export declare function resolveTpoSettingsTimeRange(settings: TpoTimeRangeSettings, options?: {
51
+ venueTradingDay?: boolean;
52
+ }): TpoTimeRange | undefined;
53
+ /** The IANA zone a range's clock names: 'ET' is New York, nothing is UTC. */
54
+ export declare function tpoTimeZone(value: unknown): string;
55
+ /** The daily window `timestamp` reads, on the range's own zone clock: device-independent, daylight saving included. */
34
56
  export declare function resolveTpoTimeRangeWindow(timestamp: number, customTimeRange?: TpoTimeRange): TpoSessionWindow | undefined;
35
57
  export declare function containsTpoWindowTime(timestamp: number, window: TpoSessionWindow): boolean;
36
58
  export declare function getTpoSessionStart(timestamp: number, sessionType: string, customTimeRange?: TpoTimeRange): number;
@@ -45,9 +67,9 @@ export declare function generateTpoLetters(blockIds: number[], _sessionType: str
45
67
  export type TpoSessionRole = 'day' | 'evening';
46
68
  /**
47
69
  * The clock a custom-session set is written in: UTC, or New York wall time
48
- * ('ET', daylight saving included). The gateway's custom-time-range path
49
- * serves only these two (tsdb-gateway tpo_agg.go sessionCustomTimeRange
50
- * degrades every other zone to plain UTC days), so Chicago is not offered.
70
+ * ('ET', daylight saving included). The editor offers these two; the
71
+ * gateway's custom-time-range path degrades a zone it does not serve to plain
72
+ * UTC days (tsdb-gateway tpo_agg.go sessionCustomTimeRange).
51
73
  */
52
74
  export type TpoCustomSessionsTimezone = 'UTC' | 'ET';
53
75
  export interface TpoCustomSessionSegment {
@@ -68,9 +90,10 @@ export interface TpoCustomSessionsSettings {
68
90
  /** Absent reads UTC: every set saved before the New York clock. */
69
91
  timezone?: TpoCustomSessionsTimezone;
70
92
  }
71
- /** Editable starting template (Asia / London / New York / Close, UTC) — a
72
- * default for the editor, never a hard-coded behavior. */
73
- export declare const DEFAULT_TPO_CUSTOM_SESSION_SEGMENTS: readonly TpoCustomSessionSegment[];
93
+ /** The editor's starting set: the day split's slices on its clock, named by `labelOf`; hours from the split only. */
94
+ export declare function defaultTpoCustomSessionSegments(labelOf: (id: MarketSplitSliceId) => string): TpoCustomSessionSegment[];
95
+ /** The starting set's clock, the split's own: New York, stored as 'ET'. */
96
+ export declare const DEFAULT_TPO_CUSTOM_SESSIONS_TIMEZONE: TpoCustomSessionsTimezone;
74
97
  interface NormalizedTpoSegment extends TpoCustomSessionSegment {
75
98
  startMinute: number;
76
99
  /** Minutes past the START day's midnight: above 1440 for the segment that