@orangecharts/wrun-chart-host 0.10.0 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (145) 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 +6 -1
  10. package/dist/index.js +6 -1
  11. package/dist/interfaces/cancel-reason.interface.d.ts +1 -1
  12. package/dist/interfaces/cme-realtime.interface.d.ts +16 -9
  13. package/dist/interfaces/cme-realtime.interface.js +6 -3
  14. package/dist/interfaces/kscript-diagnostics.interface.d.ts +6 -0
  15. package/dist/interfaces/opra-realtime.interface.d.ts +1 -5
  16. package/dist/interfaces/prediction-market.interface.d.ts +7 -0
  17. package/dist/interfaces/stocks-realtime.interface.d.ts +57 -0
  18. package/dist/interfaces/stocks-realtime.interface.js +32 -0
  19. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +48 -117
  20. package/dist/kscript-data/controls/live-trades-merge.util.js +97 -207
  21. package/dist/market-data/billing.interface.d.ts +86 -12
  22. package/dist/market-data/billing.interface.js +23 -4
  23. package/dist/market-data/venue.d.ts +65 -2
  24. package/dist/market-data/venues/index.d.ts +135 -5
  25. package/dist/market-data/venues/index.js +2 -1
  26. package/dist/market-data/venues/opra.contract.copy.json +3 -2
  27. package/dist/market-data/venues/opra.d.ts +2 -2
  28. package/dist/market-data/venues/opra.js +5 -2
  29. package/dist/market-data/venues/stocks.contract.copy.json +64 -0
  30. package/dist/market-data/venues/stocks.d.ts +130 -0
  31. package/dist/market-data/venues/stocks.js +117 -0
  32. package/dist/settings-templates/footprint-rows.js +35 -2
  33. package/dist/settings-templates/form-rows.d.ts +2 -1
  34. package/dist/settings-templates/indicator-fields.js +34 -4
  35. package/dist/settings-templates/tool-rules.d.ts +12 -5
  36. package/dist/settings-templates/tool-rules.js +11 -5
  37. package/dist/settings-templates/tool-tables.generated.js +4 -0
  38. package/dist/utility/chart/cme-cache-context.util.d.ts +5 -3
  39. package/dist/utility/chart/cme-cache-context.util.js +10 -6
  40. package/dist/utility/chart/cme-realtime.util.js +10 -0
  41. package/dist/utility/chart/cme-user-scripts-gate.util.d.ts +83 -0
  42. package/dist/utility/chart/cme-user-scripts-gate.util.js +142 -0
  43. package/dist/utility/chart/effective-chart-session.util.d.ts +14 -0
  44. package/dist/utility/chart/effective-chart-session.util.js +39 -0
  45. package/dist/utility/chart/host-bar-placement.util.d.ts +28 -0
  46. package/dist/utility/chart/host-bar-placement.util.js +170 -30
  47. package/dist/utility/chart/index-host-tier.util.d.ts +3 -1
  48. package/dist/utility/chart/index-host-tier.util.js +7 -2
  49. package/dist/utility/chart/index-mode-admission.util.js +25 -11
  50. package/dist/utility/chart/kscript-apply-fingerprint.util.js +1 -1
  51. package/dist/utility/chart/kscript-live-coalesce.util.d.ts +6 -9
  52. package/dist/utility/chart/kscript-live-coalesce.util.js +8 -9
  53. package/dist/utility/chart/kscript-live-source-identity.util.d.ts +9 -0
  54. package/dist/utility/chart/kscript-live-source-identity.util.js +10 -1
  55. package/dist/utility/chart/kscript-provenance-keys.util.js +7 -0
  56. package/dist/utility/chart/kscript-standin-identity.leaf.d.ts +3 -1
  57. package/dist/utility/chart/kscript-venue-policy.util.d.ts +115 -21
  58. package/dist/utility/chart/kscript-venue-policy.util.js +194 -40
  59. package/dist/utility/chart/live-bucket.util.d.ts +24 -8
  60. package/dist/utility/chart/live-bucket.util.js +85 -27
  61. package/dist/utility/chart/marketKind.util.js +5 -0
  62. package/dist/utility/chart/mixed-mode.util.d.ts +7 -0
  63. package/dist/utility/chart/mixed-mode.util.js +14 -0
  64. package/dist/utility/chart/opra-user-scripts-gate.util.d.ts +11 -16
  65. package/dist/utility/chart/opra-user-scripts-gate.util.js +12 -28
  66. package/dist/utility/chart/rth-session.util.d.ts +9 -8
  67. package/dist/utility/chart/rth-session.util.js +23 -20
  68. package/dist/utility/chart/trading-day.util.d.ts +17 -0
  69. package/dist/utility/chart/trading-day.util.js +59 -0
  70. package/dist/utility/chart/window-owner.leaf.d.ts +23 -2
  71. package/dist/utility/chart/window-owner.leaf.js +45 -3
  72. package/dist/utility/chart/wrun-bar-session-facts.util.d.ts +33 -15
  73. package/dist/utility/chart/wrun-bar-session-facts.util.js +70 -20
  74. package/dist/utility/intl-locale.util.js +5 -0
  75. package/dist/utility/scriptEditor/wrun-runtime-diagnostics.leaf.js +2 -0
  76. package/dist/utility/v2/gate-plane.util.d.ts +12 -3
  77. package/dist/utility/v2/gate-plane.util.js +30 -4
  78. package/dist/utility/v2/gate-session-latch.util.js +1 -1
  79. package/dist/utility/v2/stocks-governed.util.d.ts +16 -0
  80. package/dist/utility/v2/stocks-governed.util.js +34 -0
  81. package/dist/utility/wrun/derived-roots.leaf.d.ts +13 -0
  82. package/dist/utility/wrun/derived-roots.leaf.js +27 -0
  83. package/dist/utility/wrun/derived-roots.util.d.ts +1 -9
  84. package/dist/utility/wrun/derived-roots.util.js +3 -23
  85. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.d.ts +4 -3
  86. package/dist/utility/wrun/run-schedule/wrun-own-candles.util.d.ts +24 -3
  87. package/dist/utility/wrun/run-schedule/wrun-own-candles.util.js +46 -10
  88. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +2 -0
  89. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.d.ts +63 -16
  90. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.js +58 -14
  91. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +34 -11
  92. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +106 -30
  93. package/dist/utility/wrun/wrun-browser-sources.leaf.js +1 -2
  94. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +7 -4
  95. package/dist/utility/wrun/wrun-chart-market-facts.util.js +12 -8
  96. package/dist/utility/wrun/wrun-color-settings.util.d.ts +9 -0
  97. package/dist/utility/wrun/wrun-color-settings.util.js +33 -0
  98. package/dist/utility/wrun/wrun-handles.util.d.ts +7 -3
  99. package/dist/utility/wrun/wrun-handles.util.js +9 -8
  100. package/dist/utility/wrun/wrun-input-requirements.leaf.d.ts +68 -0
  101. package/dist/utility/wrun/wrun-input-requirements.leaf.js +163 -7
  102. package/dist/utility/wrun/wrun-leg-close.util.d.ts +59 -23
  103. package/dist/utility/wrun/wrun-leg-close.util.js +186 -28
  104. package/dist/utility/wrun/wrun-live-intake.util.d.ts +26 -12
  105. package/dist/utility/wrun/wrun-live-intake.util.js +219 -155
  106. package/dist/utility/wrun/wrun-live-tick.util.d.ts +9 -5
  107. package/dist/utility/wrun/wrun-live-tick.util.js +130 -94
  108. package/dist/utility/wrun/wrun-market-facts.util.d.ts +13 -3
  109. package/dist/utility/wrun/wrun-market-facts.util.js +13 -3
  110. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +20 -10
  111. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +10 -5
  112. package/dist/utility/wrun/wrun-option-book-rows.util.d.ts +56 -0
  113. package/dist/utility/wrun/wrun-option-book-rows.util.js +96 -0
  114. package/dist/utility/wrun/wrun-option-views.util.d.ts +281 -20
  115. package/dist/utility/wrun/wrun-option-views.util.js +391 -50
  116. package/dist/utility/wrun/wrun-options-chain.util.d.ts +3 -3
  117. package/dist/utility/wrun/wrun-options-chain.util.js +2 -0
  118. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +15 -2
  119. package/dist/utility/wrun/wrun-overlay-drivers.util.js +13 -3
  120. package/dist/utility/wrun/wrun-overlay-recovery.util.js +3 -1
  121. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +60 -11
  122. package/dist/utility/wrun/wrun-overlay-run.util.js +529 -113
  123. package/dist/utility/wrun/wrun-panel-mount.util.js +51 -6
  124. package/dist/utility/wrun/wrun-pin-spelling.util.d.ts +15 -2
  125. package/dist/utility/wrun/wrun-pin-spelling.util.js +27 -3
  126. package/dist/utility/wrun/wrun-refusal.util.d.ts +3 -2
  127. package/dist/utility/wrun/wrun-refusal.util.js +22 -0
  128. package/dist/utility/wrun/wrun-registry-errors.util.d.ts +26 -0
  129. package/dist/utility/wrun/wrun-registry-errors.util.js +34 -0
  130. package/dist/utility/wrun/wrun-replay-lane.util.js +3 -2
  131. package/dist/utility/wrun/wrun-run-interval-session.util.d.ts +20 -6
  132. package/dist/utility/wrun/wrun-run-interval-session.util.js +22 -7
  133. package/dist/utility/wrun/wrun-run-interval.util.d.ts +39 -7
  134. package/dist/utility/wrun/wrun-run-interval.util.js +49 -9
  135. package/dist/utility/wrun/wrun-socket-row-source.js +7 -2
  136. package/dist/utility/wrun/wrun-source-rows.util.d.ts +29 -22
  137. package/dist/utility/wrun/wrun-source-rows.util.js +62 -41
  138. package/dist/utility/wrun/wrun-tape-per-order.util.js +1 -20
  139. package/dist/utility/wrun/wrun-tape-source.util.d.ts +17 -9
  140. package/dist/utility/wrun/wrun-tape-source.util.js +20 -12
  141. package/dist/workers/constants/socket-slots.d.ts +91 -6
  142. package/dist/workers/constants/socket-slots.js +85 -6
  143. package/package.json +11 -11
  144. package/dist/kscript-data/controls/live-trades-order-gate.util.d.ts +0 -56
  145. 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';
@@ -195,6 +197,7 @@ export * from './utility/market-events/earnings-scope.util.js';
195
197
  export * from './utility/market-events/zoned-clock.util.js';
196
198
  export * from './utility/number-format.util.js';
197
199
  export * from './utility/options/cme-options-root.util.js';
200
+ export * from './utility/options/option-bar-anchor.util.js';
198
201
  export * from './utility/options/option-book.util.js';
199
202
  export * from './utility/options/option-symbol.util.js';
200
203
  export * from './utility/options/option-trade-date.util.js';
@@ -211,6 +214,7 @@ export * from './utility/v2/gate-plane.util.js';
211
214
  export * from './utility/v2/gate-session-latch.util.js';
212
215
  export * from './utility/v2/governed-tier.leaf.js';
213
216
  export * from './utility/v2/opra-governed.util.js';
217
+ export * from './utility/v2/stocks-governed.util.js';
214
218
  export * from './utility/watchlist/import/import-request.leaf.js';
215
219
  export * from './utility/watchlist/import/tradingview-symbols.leaf.js';
216
220
  export * from './utility/wrun-alert-params.leaf.js';
@@ -324,6 +328,7 @@ export * from './utility/wrun/wrun-oi-lane.util.js';
324
328
  export * from './utility/wrun/wrun-opra-flow.leaf.js';
325
329
  export * from './utility/wrun/wrun-opra-lane.util.js';
326
330
  export * from './utility/wrun/wrun-opra-stats.leaf.js';
331
+ export * from './utility/wrun/wrun-option-book-rows.util.js';
327
332
  export * from './utility/wrun/wrun-option-contract-flow.util.js';
328
333
  export * from './utility/wrun/wrun-option-knobs.util.js';
329
334
  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';
@@ -198,6 +200,7 @@ export * from './utility/market-events/earnings-scope.util.js';
198
200
  export * from './utility/market-events/zoned-clock.util.js';
199
201
  export * from './utility/number-format.util.js';
200
202
  export * from './utility/options/cme-options-root.util.js';
203
+ export * from './utility/options/option-bar-anchor.util.js';
201
204
  export * from './utility/options/option-book.util.js';
202
205
  export * from './utility/options/option-symbol.util.js';
203
206
  export * from './utility/options/option-trade-date.util.js';
@@ -214,6 +217,7 @@ export * from './utility/v2/gate-plane.util.js';
214
217
  export * from './utility/v2/gate-session-latch.util.js';
215
218
  export * from './utility/v2/governed-tier.leaf.js';
216
219
  export * from './utility/v2/opra-governed.util.js';
220
+ export * from './utility/v2/stocks-governed.util.js';
217
221
  export * from './utility/watchlist/import/import-request.leaf.js';
218
222
  export * from './utility/watchlist/import/tradingview-symbols.leaf.js';
219
223
  export * from './utility/wrun-alert-params.leaf.js';
@@ -327,6 +331,7 @@ export * from './utility/wrun/wrun-oi-lane.util.js';
327
331
  export * from './utility/wrun/wrun-opra-flow.leaf.js';
328
332
  export * from './utility/wrun/wrun-opra-lane.util.js';
329
333
  export * from './utility/wrun/wrun-opra-stats.leaf.js';
334
+ export * from './utility/wrun/wrun-option-book-rows.util.js';
330
335
  export * from './utility/wrun/wrun-option-contract-flow.util.js';
331
336
  export * from './utility/wrun/wrun-option-knobs.util.js';
332
337
  export * from './utility/wrun/wrun-option-prints.util.js';
@@ -19,6 +19,6 @@ export interface CancelReasonSelection {
19
19
  comment: string;
20
20
  }
21
21
  /** The product a cancel ends, as the `billing:cancel` event names it. */
22
- export type CancelProduct = 'plus' | 'api' | 'cme' | 'opra';
22
+ export type CancelProduct = 'plus' | 'api' | 'cme' | 'opra' | 'stocks';
23
23
  /** The server's comment limit, in UTF-16 code units (what a textarea's maxlength and a JS length count). */
24
24
  export declare const CANCEL_COMMENT_MAX_LENGTH = 500;
@@ -171,25 +171,32 @@ export type CmeServedAccessByExchange = Record<string, CmeServedAccess>;
171
171
  /** Attestation validity is derived at read time from expiresAt, never cached. */
172
172
  export declare function isCmeAttestationValid(attestation: CmeAttestation | null, now?: number): boolean;
173
173
  /**
174
- * Stable, transport-free error surface for billing calls. 'attestation_rejected'
175
- * covers the checkout 403 gates (missing OR expired attestation); callers
176
- * re-fetch attestation state to learn which, rather than matching message text.
177
- * 'invoice_owed' is the checkout refusal while Stripe is still collecting a CME
178
- * invoice (the renewal is in retries): a retry gets the same answer until that
179
- * invoice is paid, so it carries the pay link instead of reading as a conflict.
174
+ * Stable, transport-free error surface for billing calls. The kind says what a
175
+ * flow can do next, never what a page says: the words for a refusal come from
176
+ * the purchase-refusal resolver (docs/features/billing/purchase-refusals.md),
177
+ * which reads `cause`, the failure as it arrived (the server's tagged answer,
178
+ * or the transport's). 'refused': the server answered and refused, so what the
179
+ * account holds may differ from what the page shows (the store reads it
180
+ * again). 'unauthorized': a 401 or an expired session. 'server': a 5xx or a
181
+ * rate limit, where a retry can succeed. 'network': no answer. 'aborted': the
182
+ * caller's own abort, which is no refusal at all.
180
183
  */
181
- export type CmeBillingErrorKind = 'attestation_rejected' | 'conflict' | 'invoice_owed' | 'unauthorized' | 'network' | 'aborted' | 'server';
184
+ export type CmeBillingErrorKind = 'refused' | 'unauthorized' | 'network' | 'aborted' | 'server';
182
185
  export declare class CmeBillingError extends Error {
183
186
  readonly kind: CmeBillingErrorKind;
184
187
  readonly status: number | null;
185
- /** Raw backend message: diagnostic/fallback content only, never primary UI copy. */
188
+ /** Raw backend message: diagnostic content only, never UI copy. */
186
189
  readonly diagnosticMessage: string | null;
187
- /** Stripe's hosted invoice on an 'invoice_owed' refusal; null when Stripe published none, and on every other kind. */
190
+ /**
191
+ * Stripe's hosted invoice on the owed-invoice refusal (SUBSCRIPTION_INVOICE_OWED); null when Stripe published
192
+ * none, and on every other failure.
193
+ */
188
194
  readonly invoiceUrl: string | null;
189
195
  constructor(kind: CmeBillingErrorKind, options?: {
190
196
  status?: number | null;
191
197
  diagnosticMessage?: string | null;
192
198
  invoiceUrl?: string | null;
199
+ cause?: unknown;
193
200
  });
194
201
  }
195
202
  export interface CmeBillingRepository {
@@ -31,12 +31,15 @@ export function isCmeAttestationValid(attestation, now = Date.now()) {
31
31
  export class CmeBillingError extends Error {
32
32
  kind;
33
33
  status;
34
- /** Raw backend message: diagnostic/fallback content only, never primary UI copy. */
34
+ /** Raw backend message: diagnostic content only, never UI copy. */
35
35
  diagnosticMessage;
36
- /** Stripe's hosted invoice on an 'invoice_owed' refusal; null when Stripe published none, and on every other kind. */
36
+ /**
37
+ * Stripe's hosted invoice on the owed-invoice refusal (SUBSCRIPTION_INVOICE_OWED); null when Stripe published
38
+ * none, and on every other failure.
39
+ */
37
40
  invoiceUrl;
38
41
  constructor(kind, options) {
39
- super(`cme billing error: ${kind}`);
42
+ super(`cme billing error: ${kind}`, options?.cause === undefined ? undefined : { cause: options.cause });
40
43
  this.name = 'CmeBillingError';
41
44
  this.kind = kind;
42
45
  this.status = options?.status ?? null;
@@ -27,6 +27,12 @@ export interface RuntimeDiagnostic {
27
27
  * run carrying the OPRA mark). The editor console shows it, and every console export strips it.
28
28
  */
29
29
  opra?: true;
30
+ /**
31
+ * The row was computed over CME data by a CME chart study (the `cme-user-scripts` gate, the display boundary): the
32
+ * run that reported it read the CME plane (its own fact from before it computed: the wrun runtime trap of a run on a
33
+ * CME chart). Read beside `opra`: the editor console shows it, and every console export strips it.
34
+ */
35
+ cme?: true;
30
36
  }
31
37
  /** `details` of a FE_KSCRIPT_PERF_SLOW row: what the chip and the compact card show. */
32
38
  export interface KScriptPerfSlowDetails {
@@ -149,11 +149,7 @@ export declare function isOpraAgreementCurrent(current: {
149
149
  * 'busy' = a checkout is already in flight, or the guest wall took the click.
150
150
  */
151
151
  export type OpraCheckoutResult = MarketDataCheckoutResult;
152
- /**
153
- * Transport-free failure surface for the OPRA billing calls. Unlike CME, a 403 is NOT an attestation
154
- * gate (refusals ride the 200 checkout body), so it never routes back into the declaration.
155
- * 'invoice_owed' is the tagged 409 while Stripe still collects an invoice on the line.
156
- */
152
+ /** The OPRA billing calls' failure kinds: the venue-generic ones (market-data/billing.interface.ts). */
157
153
  export type OpraBillingErrorKind = MarketDataBillingErrorKind;
158
154
  /** The venue-generic billing error (market-data/billing.interface.ts): one class for every venue's calls. */
159
155
  export declare const OpraBillingError: typeof MarketDataBillingError;
@@ -71,6 +71,13 @@ export interface PolymarketMetadata {
71
71
  line?: number;
72
72
  sourceEventSlug?: string;
73
73
  }>;
74
+ /**
75
+ * Set on an event the symbol dialog's Predict tab listed from the gateway's preview page
76
+ * (`MARKETS_PROJECTION_GROUPS_PREVIEW`): `predictionMarkets` holds the event's leading sub-markets only. The pick
77
+ * reads the full event before the metadata leaves the dialog and clears it (`hydratePredictionPreview`); a failed
78
+ * read keeps it, so the list is never stored as the whole event without saying so.
79
+ */
80
+ predictionMarketsPreview?: true;
74
81
  fetchedAt?: string;
75
82
  lastUpdated?: string;
76
83
  parentEventId?: string;