@orangecharts/wrun-chart-host 0.8.0 → 0.10.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 (246) hide show
  1. package/README.md +3 -1
  2. package/dist/constants/feature-flags.constants.d.ts +9 -0
  3. package/dist/constants/feature-flags.constants.js +86 -16
  4. package/dist/constants/marketCapabilities.constants.d.ts +14 -9
  5. package/dist/constants/marketCapabilities.constants.js +36 -13
  6. package/dist/constants/opra-compliance.constants.d.ts +15 -0
  7. package/dist/constants/opra-compliance.constants.js +15 -0
  8. package/dist/constants/option-venues.constants.d.ts +11 -6
  9. package/dist/constants/option-venues.constants.js +5 -2
  10. package/dist/constants/scriptEditor/builtin-script-snippets.d.ts +26 -0
  11. package/dist/constants/scriptEditor/builtin-script-snippets.js +6 -0
  12. package/dist/constants/scriptEditor/technicalIndicatorScriptKeys.constants.d.ts +15 -0
  13. package/dist/constants/scriptEditor/technicalIndicatorScriptKeys.constants.js +17 -0
  14. package/dist/constants/venue-presets.constants.d.ts +20 -20
  15. package/dist/constants/venue-presets.constants.js +24 -26
  16. package/dist/host-env.d.ts +39 -9
  17. package/dist/host-env.js +6 -0
  18. package/dist/host-ports.types.d.ts +108 -18
  19. package/dist/index.d.ts +14 -0
  20. package/dist/index.js +14 -0
  21. package/dist/interfaces/kscript-diagnostics.interface.d.ts +6 -0
  22. package/dist/interfaces/opra-realtime.interface.d.ts +13 -11
  23. package/dist/interfaces/opra-realtime.interface.js +10 -10
  24. package/dist/interfaces/replay.interface.d.ts +8 -0
  25. package/dist/interfaces/wrun-runtime.interface.d.ts +52 -15
  26. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +94 -14
  27. package/dist/kscript-data/controls/live-trades-merge.util.js +132 -22
  28. package/dist/kscript-data/controls/live-trades-order-gate.util.d.ts +56 -0
  29. package/dist/kscript-data/controls/live-trades-order-gate.util.js +107 -0
  30. package/dist/market-data/billing.interface.d.ts +227 -42
  31. package/dist/market-data/billing.interface.js +60 -12
  32. package/dist/market-data/venue.d.ts +88 -6
  33. package/dist/market-data/venues/cme.contract.copy.json +66 -0
  34. package/dist/market-data/venues/cme.d.ts +126 -0
  35. package/dist/market-data/venues/cme.js +133 -0
  36. package/dist/market-data/venues/index.d.ts +165 -8
  37. package/dist/market-data/venues/index.js +48 -6
  38. package/dist/market-data/venues/opra.contract.copy.json +5 -3
  39. package/dist/market-data/venues/opra.d.ts +3 -3
  40. package/dist/market-data/venues/opra.js +5 -4
  41. package/dist/replay/replayLadder.js +3 -1
  42. package/dist/settings-templates/index.js +7 -3
  43. package/dist/settings-templates/indicator-fields.d.ts +5 -4
  44. package/dist/settings-templates/indicator-fields.js +45 -6
  45. package/dist/settings-templates/tool-rules.d.ts +27 -17
  46. package/dist/settings-templates/tool-rules.js +27 -11
  47. package/dist/settings-templates/tool-tables.generated.js +91 -31
  48. package/dist/utility/chart/book-live-bucket.util.d.ts +15 -0
  49. package/dist/utility/chart/book-live-bucket.util.js +47 -0
  50. package/dist/utility/chart/crypto-index.leaf.d.ts +2 -2
  51. package/dist/utility/chart/crypto-index.leaf.js +2 -2
  52. package/dist/utility/chart/index-mode-admission.util.js +24 -3
  53. package/dist/utility/chart/index-mode.util.d.ts +5 -2
  54. package/dist/utility/chart/index-mode.util.js +23 -13
  55. package/dist/utility/chart/kscript-drawing-safe-area.util.d.ts +35 -11
  56. package/dist/utility/chart/kscript-drawing-safe-area.util.js +145 -35
  57. package/dist/utility/chart/kscript-live-coalesce.util.d.ts +7 -2
  58. package/dist/utility/chart/kscript-live-coalesce.util.js +9 -3
  59. package/dist/utility/chart/kscript-provenance-keys.util.js +6 -0
  60. package/dist/utility/chart/kscript-standin-identity.leaf.d.ts +3 -1
  61. package/dist/utility/chart/kscript-titancharts-render-keys.constants.d.ts +32 -2
  62. package/dist/utility/chart/kscript-titancharts-render-keys.constants.js +45 -0
  63. package/dist/utility/chart/kscript-venue-policy.util.d.ts +53 -27
  64. package/dist/utility/chart/kscript-venue-policy.util.js +74 -32
  65. package/dist/utility/chart/market-session-schedule.util.d.ts +10 -0
  66. package/dist/utility/chart/market-session-schedule.util.js +16 -0
  67. package/dist/utility/chart/marketKind.util.d.ts +12 -10
  68. package/dist/utility/chart/marketKind.util.js +17 -7
  69. package/dist/utility/chart/om-panel-push-style.util.d.ts +7 -7
  70. package/dist/utility/chart/om-panel-push-style.util.js +17 -15
  71. package/dist/utility/chart/om-panel.util.js +6 -6
  72. package/dist/utility/chart/opra-read-access.leaf.d.ts +5 -3
  73. package/dist/utility/chart/opra-read-access.leaf.js +5 -3
  74. package/dist/utility/chart/profile-block-size.util.d.ts +16 -0
  75. package/dist/utility/chart/profile-block-size.util.js +7 -0
  76. package/dist/utility/chart/quote-perp.leaf.d.ts +17 -0
  77. package/dist/utility/chart/quote-perp.leaf.js +20 -0
  78. package/dist/utility/chart/rth-session.util.d.ts +3 -2
  79. package/dist/utility/chart/rth-session.util.js +2 -1
  80. package/dist/utility/chart/window-geometry.leaf.d.ts +8 -0
  81. package/dist/utility/chart/window-geometry.leaf.js +22 -6
  82. package/dist/utility/chart/wrun-run-result.util.d.ts +17 -0
  83. package/dist/utility/chart/wrun-run-result.util.js +145 -7
  84. package/dist/utility/common/transformations.util.d.ts +7 -0
  85. package/dist/utility/common/transformations.util.js +11 -0
  86. package/dist/utility/options/option-bar-anchor.util.d.ts +145 -0
  87. package/dist/utility/options/option-bar-anchor.util.js +340 -0
  88. package/dist/utility/options/option-venue.util.d.ts +21 -3
  89. package/dist/utility/options/option-venue.util.js +30 -3
  90. package/dist/utility/scriptEditor/wrun-runtime-diagnostics.leaf.js +2 -0
  91. package/dist/utility/wrun/derived-roots.util.d.ts +213 -0
  92. package/dist/utility/wrun/derived-roots.util.js +471 -0
  93. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.d.ts +41 -6
  94. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.js +89 -19
  95. package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.d.ts +9 -4
  96. package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.js +47 -6
  97. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.d.ts +5 -3
  98. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.js +6 -4
  99. package/dist/utility/wrun/run-schedule/wrun-prefix-feeds.util.d.ts +2 -2
  100. package/dist/utility/wrun/run-schedule/wrun-prefix-feeds.util.js +5 -1
  101. package/dist/utility/wrun/sources/lanes/option_daily.js +5 -2
  102. package/dist/utility/wrun/sources/lanes/options_flow.js +5 -2
  103. package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +64 -19
  104. package/dist/utility/wrun/sources/opra-option-lanes.util.js +105 -35
  105. package/dist/utility/wrun/sources/row-lane-registry.js +3 -2
  106. package/dist/utility/wrun/sources/row-lanes/option_contract_flow.js +2 -1
  107. package/dist/utility/wrun/sources/row-lanes/option_contract_state.d.ts +9 -3
  108. package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +15 -6
  109. package/dist/utility/wrun/sources/row-lanes/option_prints.d.ts +14 -0
  110. package/dist/utility/wrun/sources/row-lanes/option_prints.js +82 -13
  111. package/dist/utility/wrun/sources/row-lanes/option_strike_flow.js +17 -4
  112. package/dist/utility/wrun/sources/row-lanes/option_strikes.d.ts +55 -8
  113. package/dist/utility/wrun/sources/row-lanes/option_strikes.js +95 -14
  114. package/dist/utility/wrun/sources/row-lanes/option_surface.d.ts +5 -2
  115. package/dist/utility/wrun/sources/row-lanes/option_surface.js +7 -3
  116. package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +19 -0
  117. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +35 -14
  118. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +70 -20
  119. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.d.ts +64 -0
  120. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.js +89 -0
  121. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.d.ts +45 -1
  122. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.js +114 -6
  123. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +56 -5
  124. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +224 -26
  125. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +822 -58
  126. package/dist/utility/wrun/wrun-batched-marks.util.d.ts +16 -3
  127. package/dist/utility/wrun/wrun-batched-marks.util.js +30 -19
  128. package/dist/utility/wrun/wrun-batched-readout.util.d.ts +37 -9
  129. package/dist/utility/wrun/wrun-batched-readout.util.js +61 -15
  130. package/dist/utility/wrun/wrun-builtin-twin.util.d.ts +12 -0
  131. package/dist/utility/wrun/wrun-builtin-twin.util.js +21 -0
  132. package/dist/utility/wrun/wrun-canvas-readout.util.d.ts +4 -0
  133. package/dist/utility/wrun/wrun-cell-capacity.leaf.d.ts +66 -0
  134. package/dist/utility/wrun/wrun-cell-capacity.leaf.js +86 -0
  135. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +192 -13
  136. package/dist/utility/wrun/wrun-chart-market-facts.util.js +437 -55
  137. package/dist/utility/wrun/wrun-color-facts.util.d.ts +19 -9
  138. package/dist/utility/wrun/wrun-color-facts.util.js +24 -14
  139. package/dist/utility/wrun/wrun-color-settings.util.d.ts +15 -4
  140. package/dist/utility/wrun/wrun-color-settings.util.js +31 -12
  141. package/dist/utility/wrun/wrun-dollar-unit-port.leaf.d.ts +17 -0
  142. package/dist/utility/wrun/wrun-dollar-unit-port.leaf.js +9 -0
  143. package/dist/utility/wrun/wrun-download-meter.util.d.ts +107 -0
  144. package/dist/utility/wrun/wrun-download-meter.util.js +134 -0
  145. package/dist/utility/wrun/wrun-download-plan.util.d.ts +99 -0
  146. package/dist/utility/wrun/wrun-download-plan.util.js +118 -0
  147. package/dist/utility/wrun/wrun-draft-legend-note.util.d.ts +11 -3
  148. package/dist/utility/wrun/wrun-draft-legend-note.util.js +26 -4
  149. package/dist/utility/wrun/wrun-draft-overlay.util.d.ts +6 -1
  150. package/dist/utility/wrun/wrun-draft-overlay.util.js +23 -3
  151. package/dist/utility/wrun/wrun-frames.d.ts +27 -6
  152. package/dist/utility/wrun/wrun-frames.js +78 -15
  153. package/dist/utility/wrun/wrun-hosted-wire-caps.d.ts +2 -2
  154. package/dist/utility/wrun/wrun-hosted-wire-caps.js +7 -0
  155. package/dist/utility/wrun/wrun-hosted-wire.util.d.ts +7 -1
  156. package/dist/utility/wrun/wrun-hosted-wire.util.js +12 -2
  157. package/dist/utility/wrun/wrun-hud-looks.util.d.ts +51 -21
  158. package/dist/utility/wrun/wrun-hud-looks.util.js +74 -28
  159. package/dist/utility/wrun/wrun-latest-snapshot.d.ts +11 -0
  160. package/dist/utility/wrun/wrun-lifecycle-runtime.util.d.ts +8 -6
  161. package/dist/utility/wrun/wrun-lifecycle-runtime.util.js +8 -6
  162. package/dist/utility/wrun/wrun-lifecycle.contract.d.ts +4 -2
  163. package/dist/utility/wrun/wrun-live-intake.util.d.ts +19 -9
  164. package/dist/utility/wrun/wrun-live-intake.util.js +213 -45
  165. package/dist/utility/wrun/wrun-live-tick.util.d.ts +4 -0
  166. package/dist/utility/wrun/wrun-live-tick.util.js +246 -49
  167. package/dist/utility/wrun/wrun-market-size-contract-carry.leaf.d.ts +53 -0
  168. package/dist/utility/wrun/wrun-market-size-contract-carry.leaf.js +162 -0
  169. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +205 -48
  170. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +277 -34
  171. package/dist/utility/wrun/wrun-market-size-defaults.util.d.ts +51 -7
  172. package/dist/utility/wrun/wrun-market-size-defaults.util.js +340 -56
  173. package/dist/utility/wrun/wrun-opra-lane.util.d.ts +17 -4
  174. package/dist/utility/wrun/wrun-opra-lane.util.js +6 -4
  175. package/dist/utility/wrun/wrun-option-prints.util.d.ts +41 -2
  176. package/dist/utility/wrun/wrun-option-prints.util.js +80 -13
  177. package/dist/utility/wrun/wrun-option-strike-flow-forecast.util.d.ts +31 -0
  178. package/dist/utility/wrun/wrun-option-strike-flow-forecast.util.js +119 -0
  179. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.d.ts +26 -6
  180. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.js +50 -11
  181. package/dist/utility/wrun/wrun-option-strike-flow.util.d.ts +109 -19
  182. package/dist/utility/wrun/wrun-option-strike-flow.util.js +222 -61
  183. package/dist/utility/wrun/wrun-option-views.util.d.ts +96 -18
  184. package/dist/utility/wrun/wrun-option-views.util.js +246 -51
  185. package/dist/utility/wrun/wrun-options-stop.util.d.ts +2 -1
  186. package/dist/utility/wrun/wrun-options-stop.util.js +3 -2
  187. package/dist/utility/wrun/wrun-output-style.util.d.ts +6 -2
  188. package/dist/utility/wrun/wrun-output-style.util.js +20 -2
  189. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +20 -0
  190. package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.d.ts +31 -14
  191. package/dist/utility/wrun/wrun-overlay-lifecycle.lazy.js +22 -0
  192. package/dist/utility/wrun/wrun-overlay-lifecycle.util.d.ts +10 -1
  193. package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +52 -4
  194. package/dist/utility/wrun/wrun-overlay-recovery.util.d.ts +7 -0
  195. package/dist/utility/wrun/wrun-overlay-recovery.util.js +25 -1
  196. package/dist/utility/wrun/wrun-overlay-result.util.d.ts +7 -1
  197. package/dist/utility/wrun/wrun-overlay-result.util.js +2 -0
  198. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +134 -37
  199. package/dist/utility/wrun/wrun-overlay-run.util.js +1118 -254
  200. package/dist/utility/wrun/wrun-pack-widths.leaf.d.ts +4 -4
  201. package/dist/utility/wrun/wrun-pack-widths.leaf.js +4 -4
  202. package/dist/utility/wrun/wrun-pack.util.d.ts +7 -3
  203. package/dist/utility/wrun/wrun-pack.util.js +20 -9
  204. package/dist/utility/wrun/wrun-pane-format.util.d.ts +2 -1
  205. package/dist/utility/wrun/wrun-pane-format.util.js +7 -3
  206. package/dist/utility/wrun/wrun-panel-mount.util.d.ts +9 -0
  207. package/dist/utility/wrun/wrun-panel-mount.util.js +63 -13
  208. package/dist/utility/wrun/wrun-panel-style.util.d.ts +37 -24
  209. package/dist/utility/wrun/wrun-panel-style.util.js +100 -29
  210. package/dist/utility/wrun/wrun-param-map.util.d.ts +15 -11
  211. package/dist/utility/wrun/wrun-param-map.util.js +13 -5
  212. package/dist/utility/wrun/wrun-param-values.util.d.ts +21 -3
  213. package/dist/utility/wrun/wrun-param-values.util.js +6 -0
  214. package/dist/utility/wrun/wrun-pin-spelling.util.js +12 -11
  215. package/dist/utility/wrun/wrun-prefix-lanes.util.js +2 -2
  216. package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +50 -0
  217. package/dist/utility/wrun/wrun-refusal-surface.util.js +68 -0
  218. package/dist/utility/wrun/wrun-refusal.util.js +10 -1
  219. package/dist/utility/wrun/wrun-refused-latest.util.d.ts +10 -0
  220. package/dist/utility/wrun/wrun-refused-latest.util.js +12 -0
  221. package/dist/utility/wrun/wrun-row-source.d.ts +11 -0
  222. package/dist/utility/wrun/wrun-run-interval.util.d.ts +4 -2
  223. package/dist/utility/wrun/wrun-run-interval.util.js +9 -6
  224. package/dist/utility/wrun/wrun-script-inputs.util.d.ts +52 -1
  225. package/dist/utility/wrun/wrun-script-inputs.util.js +112 -4
  226. package/dist/utility/wrun/wrun-setting-words.util.d.ts +7 -3
  227. package/dist/utility/wrun/wrun-setting-words.util.js +13 -5
  228. package/dist/utility/wrun/wrun-socket-row-source.d.ts +27 -2
  229. package/dist/utility/wrun/wrun-socket-row-source.js +113 -8
  230. package/dist/utility/wrun/wrun-source-rows.util.d.ts +9 -1
  231. package/dist/utility/wrun/wrun-source-rows.util.js +108 -43
  232. package/dist/utility/wrun/wrun-style-words.util.js +6 -4
  233. package/dist/utility/wrun/wrun-table-chrome.util.d.ts +3 -2
  234. package/dist/utility/wrun/wrun-table-chrome.util.js +19 -11
  235. package/dist/utility/wrun/wrun-tape-per-order.util.d.ts +2 -0
  236. package/dist/utility/wrun/wrun-tape-per-order.util.js +26 -0
  237. package/dist/utility/wrun/wrun-tape-source.util.d.ts +126 -50
  238. package/dist/utility/wrun/wrun-tape-source.util.js +193 -68
  239. package/dist/utility/wrun/wrun-volume-profile-lane.util.d.ts +7 -5
  240. package/dist/utility/wrun/wrun-volume-profile-lane.util.js +8 -6
  241. package/dist/utils/replay/replay-buffer-math.d.ts +53 -2
  242. package/dist/utils/replay/replay-buffer-math.js +227 -20
  243. package/dist/workers/utils/volume-profile.worker.util.d.ts +4 -1
  244. package/dist/workers/utils/volume-profile.worker.util.js +5 -2
  245. package/dist/workers/wrun/wrun-abi-host.js +3 -2
  246. package/package.json +5 -5
@@ -3,8 +3,18 @@
3
3
  * exchange deal adds its card here; the purchase flow, the payment return and the openers find a venue by its key or
4
4
  * by a payment line item, never by a venue literal. The finders over an explicit list (`findVenueBy*`) are the same
5
5
  * rules the bound finders apply to the registry, for a spec that serves a venue of its own beside the registered ones.
6
+ *
7
+ * Two lists. `MARKET_DATA_VENUES` is served in every session. `FLAG_GATED_MARKET_DATA_VENUES` is carried dark: a card
8
+ * there is listed only while its `flagKey` reads on, through ONE selector (`marketDataVenueIsServed`), so a venue whose
9
+ * generic flow replaces a flow of its own (CME behind `cme-engine`) changes nothing while its flag is off: the bound
10
+ * finders never return it, the payment return never takes its venue branch and its doors stay shut. The flag reader is
11
+ * the app's, published into this dependency-free module when the app's market-data store module loads
12
+ * (`publishMarketDataVenueFlags`); unpublished, a read that throws (no store in this realm: a worker, a bare spec) or a
13
+ * card with no flag all read dark.
6
14
  */
15
+ import type { FeatureFlagKey } from '../../constants/feature-flags.constants.js';
7
16
  import type { MarketDataVenue } from '../venue.js';
17
+ /** The venues served in every session. */
8
18
  export declare const MARKET_DATA_VENUES: readonly [{
9
19
  readonly key: "opra";
10
20
  readonly displayName: "OPRA";
@@ -61,8 +71,8 @@ export declare const MARKET_DATA_VENUES: readonly [{
61
71
  readonly renewalWindowDays: 30;
62
72
  };
63
73
  readonly agreement: {
64
- readonly version: "opra-subscriber-2026-10";
65
- readonly url: "https://www.opraplan.com/";
74
+ readonly version: "opra-b1-2026-10-22";
75
+ readonly url: "/api/v1/opra/agreement";
66
76
  readonly delayedRequiresAcceptance: false;
67
77
  };
68
78
  readonly delayMinutes: 15;
@@ -73,10 +83,138 @@ export declare const MARKET_DATA_VENUES: readonly [{
73
83
  readonly i18nNamespace: "opraRealtimeData";
74
84
  readonly storeId: "opraRealtime";
75
85
  readonly surfaces: readonly ["chain-page-subtitle", "chain-price-pill", "chain-table-marker", "chain-strike-preview", "chain-index-notice", "flow-tape", "terminal-options-tab", "options-overlay-legends", "indicator-legend-notes", "contract-chart-delay-chip", "contract-chart-delay-card", "chart-source-line", "watchlist-panel", "watchlist-cell-tooltip", "board", "purchase-live-price"];
76
- readonly contractRevision: "2026-10-20.1";
86
+ readonly contractRevision: "2026-10-22.1";
77
87
  }];
78
- /** A registered venue's key. */
79
- export type MarketDataVenueKey = (typeof MARKET_DATA_VENUES)[number]['key'];
88
+ /** The venues carried dark: each is listed only while its `flagKey` reads on (`marketDataVenueIsServed`). */
89
+ export declare const FLAG_GATED_MARKET_DATA_VENUES: readonly [{
90
+ readonly key: "cme";
91
+ readonly displayName: "CME Group";
92
+ readonly productGroups: readonly ["CME", "CBOT", "NYMEX", "COMEX"];
93
+ readonly basePath: "/market-data/cme";
94
+ readonly products: readonly [{
95
+ readonly name: "cme_bundle_l1_1m";
96
+ readonly key: "l1";
97
+ readonly plan: "p1";
98
+ readonly level: 1;
99
+ readonly classifications: readonly ["non_professional"];
100
+ readonly interval: "1m";
101
+ readonly priceUsd: 7;
102
+ readonly planCard: {
103
+ readonly name: "Real-time L1";
104
+ readonly level: "LEVEL 1";
105
+ readonly market: "CME";
106
+ readonly markets: readonly ["CME", "CBOT", "COMEX", "NYMEX"];
107
+ readonly region: "🇺🇸 USA";
108
+ readonly descPath: "subscription.l1Desc";
109
+ };
110
+ }, {
111
+ readonly name: "cme_bundle_depth_1m";
112
+ readonly key: "depth";
113
+ readonly plan: "p2";
114
+ readonly level: 2;
115
+ readonly classifications: readonly ["non_professional"];
116
+ readonly interval: "1m";
117
+ readonly priceUsd: 45;
118
+ readonly planCard: {
119
+ readonly name: "Real-time depth";
120
+ readonly level: "LEVEL 2";
121
+ readonly market: "CME";
122
+ readonly markets: readonly ["CME", "CBOT", "COMEX", "NYMEX"];
123
+ readonly region: "🇺🇸 USA";
124
+ readonly descPath: "subscription.depthDesc";
125
+ };
126
+ }, {
127
+ readonly name: "cme_bundle_depth_pro_1m";
128
+ readonly key: "depth_pro";
129
+ readonly plan: "p2";
130
+ readonly level: 3;
131
+ readonly classifications: readonly ["professional"];
132
+ readonly interval: "1m";
133
+ readonly priceUsd: 538;
134
+ readonly planCard: {
135
+ readonly name: "Real-time depth";
136
+ readonly level: "LEVEL 2";
137
+ readonly market: "CME";
138
+ readonly markets: readonly ["CME", "CBOT", "COMEX", "NYMEX"];
139
+ readonly region: "🇺🇸 USA";
140
+ readonly descPath: "subscription.depthDesc";
141
+ };
142
+ }];
143
+ readonly planCard: {
144
+ readonly name: "Real-time L1";
145
+ readonly level: "LEVEL 1";
146
+ readonly market: "CME";
147
+ readonly markets: readonly ["CME", "CBOT", "COMEX", "NYMEX"];
148
+ readonly region: "🇺🇸 USA";
149
+ readonly descPath: "subscription.l1Desc";
150
+ };
151
+ readonly paymentItemPrefix: "cme_";
152
+ readonly professionalPolicy: "sell";
153
+ readonly internalRolePolicy: "report";
154
+ readonly payFirst: false;
155
+ readonly planChanges: {
156
+ readonly downgradeAtPeriodEnd: true;
157
+ readonly prorateUpgrades: true;
158
+ };
159
+ readonly offers: true;
160
+ readonly questionnaire: {
161
+ readonly formVersion: "v1";
162
+ readonly acceptedFormVersions: readonly ["v1", ""];
163
+ readonly presentation: "two-way";
164
+ readonly questions: readonly [{
165
+ readonly id: "individual_own_account";
166
+ readonly qualifying: true;
167
+ }, {
168
+ readonly id: "personal_non_business_use";
169
+ readonly qualifying: true;
170
+ }, {
171
+ readonly id: "not_registered_or_qualified";
172
+ readonly qualifying: true;
173
+ }, {
174
+ readonly id: "not_advisor_or_asset_manager";
175
+ readonly qualifying: true;
176
+ }, {
177
+ readonly id: "no_redistribution_or_business_application";
178
+ readonly qualifying: true;
179
+ }];
180
+ readonly groups: readonly [];
181
+ readonly addendum: {
182
+ readonly id: "ila_subscriber_addendum_2026_06_accepted";
183
+ readonly version: "v1";
184
+ };
185
+ readonly postalAddress: {
186
+ readonly answerId: "postal_address";
187
+ };
188
+ readonly identityFields: readonly ["legalName", "employer", "occupation", "country", "address"];
189
+ readonly identityLimits: {
190
+ readonly legalName: 200;
191
+ readonly employer: 200;
192
+ readonly occupation: 200;
193
+ readonly country: 2;
194
+ readonly address: 300;
195
+ };
196
+ readonly validityDays: 365;
197
+ readonly renewalWindowDays: 30;
198
+ };
199
+ readonly agreement: {
200
+ readonly recordedAs: "registration";
201
+ readonly version: "cme-data-terms-v1";
202
+ readonly url: "/api/v1/market-data/cme/agreement";
203
+ readonly delayedRequiresAcceptance: true;
204
+ };
205
+ readonly delayMinutes: 10;
206
+ readonly disclosure: {
207
+ readonly kind: "translated";
208
+ };
209
+ readonly flagKey: "cme-engine";
210
+ readonly i18nNamespace: "cmeRealtimeData";
211
+ readonly storeId: "cmeMarketData";
212
+ readonly surfaces: readonly ["contract-chart-delay-chip", "contract-chart-delay-card", "chart-source-line", "watchlist-panel", "watchlist-cell-tooltip", "purchase-live-price"];
213
+ readonly contractRevision: "2026-10-23.1";
214
+ }];
215
+ type CarriedMarketDataVenue = (typeof MARKET_DATA_VENUES)[number] | (typeof FLAG_GATED_MARKET_DATA_VENUES)[number];
216
+ /** A registered venue's key: a card the build carries, served now or dark. */
217
+ export type MarketDataVenueKey = CarriedMarketDataVenue['key'];
80
218
  /** A registered venue: the descriptor, its key narrowed to the registered keys. */
81
219
  export type RegisteredMarketDataVenue = MarketDataVenue & {
82
220
  readonly key: MarketDataVenueKey;
@@ -89,9 +227,28 @@ export declare function findVenueByKey<V extends MarketDataVenue>(venues: readon
89
227
  * for an item no venue names.
90
228
  */
91
229
  export declare function findVenueByPaymentProduct<V extends MarketDataVenue>(venues: readonly V[], item: unknown): V | null;
92
- /** The registered venue with this key, or null. */
230
+ /**
231
+ * Called by the app's market-data store module when it loads (src/store/market-data.ts), and by specs: the flag reader
232
+ * the dark cards ride (the app's override-aware `isOn`). Null unpublishes: every dark card reads dark again.
233
+ */
234
+ export declare function publishMarketDataVenueFlags(reader: ((flag: FeatureFlagKey) => boolean) | null): void;
235
+ /**
236
+ * THE flag-aware selector: whether the venue-generic plane serves the venue in this session. A card of
237
+ * `MARKET_DATA_VENUES` always; a dark card only while the published reader says its flag is on; anything else never.
238
+ * The bound finders below list exactly the venues it serves, and every app door, reader, store definition and the
239
+ * payment return asks it (directly or through them), so one flag decides every surface of a dark venue at once.
240
+ */
241
+ export declare function marketDataVenueIsServed(key: unknown): boolean;
242
+ /** The venues the registry lists now: every served card, then each dark card whose flag reads on. */
243
+ export declare function servedMarketDataVenues(): readonly RegisteredMarketDataVenue[];
244
+ /** The served venue with this key, or null (a dark card reads null while its flag is off). */
93
245
  export declare function venueByKey(key: unknown): RegisteredMarketDataVenue | null;
94
- /** The registered venue with this key; a key no card has throws (a programming error, never an account's state). */
246
+ /**
247
+ * The card of a registered venue key, served or dark; a key no card has throws (a programming error, never an
248
+ * account's state). A caller that holds a venue key already (a mounted venue dialog, a store being defined) reads its
249
+ * card here; whether the venue is served is the selector's question, asked at the doors.
250
+ */
95
251
  export declare function requireVenueByKey(key: unknown): RegisteredMarketDataVenue;
96
- /** The registered venue a payment line item belongs to (`findVenueByPaymentProduct` over the registry), or null. */
252
+ /** The served venue a payment line item belongs to (`findVenueByPaymentProduct` over the served venues), or null. */
97
253
  export declare function venueByPaymentProduct(item: unknown): RegisteredMarketDataVenue | null;
254
+ export {};
@@ -1,5 +1,11 @@
1
+ import { CME_VENUE } from './cme.js';
1
2
  import { OPRA_VENUE } from './opra.js';
3
+ /** The venues served in every session. */
2
4
  export const MARKET_DATA_VENUES = [OPRA_VENUE];
5
+ /** The venues carried dark: each is listed only while its `flagKey` reads on (`marketDataVenueIsServed`). */
6
+ export const FLAG_GATED_MARKET_DATA_VENUES = [CME_VENUE];
7
+ /** Every card the build carries, served or dark, for the card lookup (`requireVenueByKey`). */
8
+ const CARRIED_VENUES = [...MARKET_DATA_VENUES, ...FLAG_GATED_MARKET_DATA_VENUES];
3
9
  /** The venue in `venues` with this key, or null. */
4
10
  export function findVenueByKey(venues, key) {
5
11
  return venues.find((venue) => venue.key === key) ?? null;
@@ -16,18 +22,54 @@ export function findVenueByPaymentProduct(venues, item) {
16
22
  venues.find((venue) => item.startsWith(venue.paymentItemPrefix)) ??
17
23
  null);
18
24
  }
19
- /** The registered venue with this key, or null. */
25
+ let flagReader = null;
26
+ /**
27
+ * Called by the app's market-data store module when it loads (src/store/market-data.ts), and by specs: the flag reader
28
+ * the dark cards ride (the app's override-aware `isOn`). Null unpublishes: every dark card reads dark again.
29
+ */
30
+ export function publishMarketDataVenueFlags(reader) {
31
+ flagReader = reader;
32
+ }
33
+ /**
34
+ * THE flag-aware selector: whether the venue-generic plane serves the venue in this session. A card of
35
+ * `MARKET_DATA_VENUES` always; a dark card only while the published reader says its flag is on; anything else never.
36
+ * The bound finders below list exactly the venues it serves, and every app door, reader, store definition and the
37
+ * payment return asks it (directly or through them), so one flag decides every surface of a dark venue at once.
38
+ */
39
+ export function marketDataVenueIsServed(key) {
40
+ if (MARKET_DATA_VENUES.some((venue) => venue.key === key))
41
+ return true;
42
+ const gated = FLAG_GATED_MARKET_DATA_VENUES.find((venue) => venue.key === key);
43
+ if (!gated || gated.flagKey === null)
44
+ return false;
45
+ try {
46
+ return flagReader?.(gated.flagKey) === true;
47
+ }
48
+ catch {
49
+ return false;
50
+ }
51
+ }
52
+ /** The venues the registry lists now: every served card, then each dark card whose flag reads on. */
53
+ export function servedMarketDataVenues() {
54
+ const lit = FLAG_GATED_MARKET_DATA_VENUES.filter((venue) => marketDataVenueIsServed(venue.key));
55
+ return lit.length === 0 ? MARKET_DATA_VENUES : [...MARKET_DATA_VENUES, ...lit];
56
+ }
57
+ /** The served venue with this key, or null (a dark card reads null while its flag is off). */
20
58
  export function venueByKey(key) {
21
- return findVenueByKey(MARKET_DATA_VENUES, key);
59
+ return findVenueByKey(servedMarketDataVenues(), key);
22
60
  }
23
- /** The registered venue with this key; a key no card has throws (a programming error, never an account's state). */
61
+ /**
62
+ * The card of a registered venue key, served or dark; a key no card has throws (a programming error, never an
63
+ * account's state). A caller that holds a venue key already (a mounted venue dialog, a store being defined) reads its
64
+ * card here; whether the venue is served is the selector's question, asked at the doors.
65
+ */
24
66
  export function requireVenueByKey(key) {
25
- const venue = venueByKey(key);
67
+ const venue = findVenueByKey(CARRIED_VENUES, key);
26
68
  if (!venue)
27
69
  throw new Error(`market-data: no registered venue "${String(key)}"`);
28
70
  return venue;
29
71
  }
30
- /** The registered venue a payment line item belongs to (`findVenueByPaymentProduct` over the registry), or null. */
72
+ /** The served venue a payment line item belongs to (`findVenueByPaymentProduct` over the served venues), or null. */
31
73
  export function venueByPaymentProduct(item) {
32
- return findVenueByPaymentProduct(MARKET_DATA_VENUES, item);
74
+ return findVenueByPaymentProduct(servedMarketDataVenues(), item);
33
75
  }
@@ -1,5 +1,5 @@
1
1
  {
2
- "revision": "2026-10-20.1",
2
+ "revision": "2026-10-22.1",
3
3
  "key": "opra",
4
4
  "productGroups": ["OPRA"],
5
5
  "products": [
@@ -27,8 +27,10 @@
27
27
  ],
28
28
  "identityLimits": { "text": 200, "address": 300 },
29
29
  "agreement": {
30
- "version": "opra-subscriber-2026-10",
31
- "url": "https://www.opraplan.com/"
30
+ "version": "opra-b1-2026-10-22",
31
+ "sha256": "105d1b2d6a89cc9416f2d2ebb18e97bed7973e4d2c39353cc55315421b958814",
32
+ "addendumVersion": "opra-b1-addendum-2026-10-22",
33
+ "url": "/api/v1/opra/agreement"
32
34
  },
33
35
  "delaySeconds": 900,
34
36
  "basePath": "/opra"
@@ -54,8 +54,8 @@ export declare const OPRA_VENUE: {
54
54
  readonly renewalWindowDays: 30;
55
55
  };
56
56
  readonly agreement: {
57
- readonly version: "opra-subscriber-2026-10";
58
- readonly url: "https://www.opraplan.com/";
57
+ readonly version: "opra-b1-2026-10-22";
58
+ readonly url: "/api/v1/opra/agreement";
59
59
  readonly delayedRequiresAcceptance: false;
60
60
  };
61
61
  readonly delayMinutes: 15;
@@ -66,5 +66,5 @@ export declare const OPRA_VENUE: {
66
66
  readonly i18nNamespace: "opraRealtimeData";
67
67
  readonly storeId: "opraRealtime";
68
68
  readonly surfaces: readonly ["chain-page-subtitle", "chain-price-pill", "chain-table-marker", "chain-strike-preview", "chain-index-notice", "flow-tape", "terminal-options-tab", "options-overlay-legends", "indicator-legend-notes", "contract-chart-delay-chip", "contract-chart-delay-card", "chart-source-line", "watchlist-panel", "watchlist-cell-tooltip", "board", "purchase-live-price"];
69
- readonly contractRevision: "2026-10-20.1";
69
+ readonly contractRevision: "2026-10-22.1";
70
70
  };
@@ -41,9 +41,10 @@ export const OPRA_VENUE = {
41
41
  validityDays: 365,
42
42
  renewalWindowDays: 30,
43
43
  },
44
- // RELEASE BLOCKER (named, do not bury): the agreement text, its version id and the link need the compliance
45
- // sign-off before the `opra` flag is lit.
46
- agreement: { version: 'opra-subscriber-2026-10', url: 'https://www.opraplan.com/', delayedRequiresAcceptance: false },
44
+ // The agreement orange's export names (OPRA's B-1 and its addendum, populated): its text, hash and addendum are
45
+ // served by `url` (contract K1) and an assent names them (K2). The current version is always the server's answer,
46
+ // never this pin (isMarketDataAgreementCurrent).
47
+ agreement: { version: 'opra-b1-2026-10-22', url: '/api/v1/opra/agreement', delayedRequiresAcceptance: false },
47
48
  // OPRA defines delayed data as at least 15 minutes old; the gate's delayed window matches (900 s).
48
49
  delayMinutes: 15,
49
50
  // The Vendor Agreement's exact phrase (Exhibit A section 14): OPRA_DELAY_NOTICE in
@@ -70,5 +71,5 @@ export const OPRA_VENUE = {
70
71
  'board',
71
72
  'purchase-live-price',
72
73
  ],
73
- contractRevision: '2026-10-20.1',
74
+ contractRevision: '2026-10-22.1',
74
75
  };
@@ -1,6 +1,7 @@
1
1
  // Replay fidelity ladder: measured retention and request-shaping constants.
2
2
  import { RAIL_TFS, RAIL_TF_BOOK_EDGE_SEC, RAIL_TF_BUCKET_SEC, RAIL_TF_EDGE_SEC, REPLAY_LADDER_EDGES_SEC, REPLAY_STEP_TFS, REPLAY_STEP_TF_BOOK_EDGE_SEC, REPLAY_STEP_TF_BUCKET_SEC, REPLAY_STEP_TF_EDGE_SEC, } from '../constants/replay-ladder.leaf.js';
3
3
  import { FEATURE_LIMITS, GATEWAY_TIER_MAX_BARS } from '../constants/feature-limits.constants.js';
4
+ import { checkIsCryptoIndex } from '../utility/chart/crypto-index.leaf.js';
4
5
  import { checkIsBlockedOn1s } from '../utility/chart/index-mode.util.js';
5
6
  import { standardIntervalMsAtOrBelow } from '../utility/chart/interval-registry.util.js';
6
7
  const orderedCoveringTfs = ['1m', '5m', '15m', '1h', '1d'];
@@ -295,7 +296,8 @@ export function clampReplayReach(requestedMs, domain, resolution, maxBars, inten
295
296
  export function reconcileReplayResolution(ageSec, chartIntervalMs, exchange) {
296
297
  const age = Math.max(0, ageSec);
297
298
  const playbackTf = coarseRailTfForAge(age, chartIntervalMs);
298
- const tickAvailable = age <= REPLAY_LADDER_EDGES_SEC.tick && !checkIsBlockedOn1s(exchange);
299
+ // Tick replay steps through trades: a crypto index serves 1s candles but has no trades behind them.
300
+ const tickAvailable = age <= REPLAY_LADDER_EDGES_SEC.tick && !checkIsBlockedOn1s(exchange) && !checkIsCryptoIndex(exchange);
299
301
  const candidates = replayResolutionFallbackCandidatesForChartInterval(chartIntervalMs);
300
302
  const chartResolution = replayResolutionForChartInterval(chartIntervalMs);
301
303
  const available = candidates.filter((resolution) => resolution.kind === 'tick' ? tickAvailable : REPLAY_STEP_TF_EDGE_SEC[resolution.tf] >= age);
@@ -73,6 +73,8 @@ const RESERVED_INPUT_NAMES = new Set(RESERVED_SCRIPT_INPUT_NAMES);
73
73
  /** Names an object prototype reserves: never a field, whatever a script declares (a write would reach the prototype). */
74
74
  const PROTOTYPE_NAMES = new Set(['__proto__', 'constructor', 'prototype']);
75
75
  const TOOL_INSTANCE_KEYS = TOOL_TEMPLATE_RULES.instanceKeys;
76
+ /** Per type, the values its engine computes for one drawing (a GhostFeed's seeded volatility): instance state too. */
77
+ const TYPE_INSTANCE_KEYS = TOOL_TEMPLATE_RULES.instanceKeysByType;
76
78
  const LABEL_KEY = TOOL_TEMPLATE_RULES.text.key;
77
79
  const INTERVAL_BOUND_TYPES = new Set(TOOL_TEMPLATE_RULES.intervalBoundTypes);
78
80
  const DEFAULT_EXCLUDED_KEYS = new Set(TOOL_TEMPLATE_RULES.defaultExcludedKeys);
@@ -123,8 +125,9 @@ function indicatorSpecs(type) {
123
125
  /**
124
126
  * A drawing type's fields, from the generated tables: its style (registry defaultStyle and held extras) and "Show on"
125
127
  * in the template lane, its style minus the geometry and financial inputs in the default lane, a label type's label
126
- * in the template lane only, and the per-drawing instance keys. The FRVP's are its own table (box and profile). A type
127
- * the registry does not know declares only the instance keys: nothing of it is taken from a template.
128
+ * in the template lane only, and the per-drawing instance keys, the type's own included (a GhostFeed's seeded average
129
+ * high-low and variance: in its style, in no lane). The FRVP's are its own table (box and profile). A type the
130
+ * registry does not know declares only the instance keys: nothing of it is taken from a template.
128
131
  */
129
132
  function toolSpecs(type) {
130
133
  if (type === FRVP_TOOL_TYPE)
@@ -133,7 +136,8 @@ function toolSpecs(type) {
133
136
  const templateKeys = new Set(ownRecord(TOOL_TEMPLATE_KEYS, type) ?? []);
134
137
  const keepsDefaults = !DEFAULT_EXCLUDED_TYPES.has(type);
135
138
  const labelled = templateKeys.has(LABEL_KEY);
136
- const instanceKeys = labelled ? TOOL_INSTANCE_KEYS.filter((key) => key !== LABEL_KEY) : TOOL_INSTANCE_KEYS;
139
+ const shared = labelled ? TOOL_INSTANCE_KEYS.filter((key) => key !== LABEL_KEY) : TOOL_INSTANCE_KEYS;
140
+ const instanceKeys = [...shared, ...(ownRecord(TYPE_INSTANCE_KEYS, type) ?? [])];
137
141
  const specs = [];
138
142
  for (const key of new Set([...Object.keys(style ?? {}), ...templateKeys])) {
139
143
  if (key === VISIBLE_INTERVALS_KEY || instanceKeys.includes(key))
@@ -7,11 +7,12 @@
7
7
  * Moved here from the web app, content unchanged: the persistence list settingsToSave and its type lists
8
8
  * (src/constants/indicator.constants.ts), the instance keys and the template meta allowlists
9
9
  * (src/utility/chart/indicator-defaults-apply.util.ts), the volatile keys (src/utility/chart/settings-templates.util.ts).
10
- * Three changes are decisions of the plan, not drift: `runMode` is row-only instance state (A11); seven meta
10
+ * Three changes are decisions of the plan, not drift: `runMode` is row-only instance state (A11); six meta
11
11
  * preferences a settings dialog writes are template-lane (decision 6: the Bitfinex position side, the Put/Call mode,
12
- * the Turnover sides and period, the Aggregated Volume margin category, the Sector Volume asset type and the Insurance
13
- * fund group), the ETF pick stays identity; and "all" is a declared value (`visibleIntervalsMs: []` is All intervals,
14
- * `maxNakedLevels: 0` is all levels, decision 3), which a capture writes where the engine holds none.
12
+ * the Turnover sides and period, the Sector Volume asset type and the Insurance fund group; the Aggregated Volume
13
+ * margin category was a seventh until its row, which nothing read, left on 2026-10-25), the ETF pick stays identity;
14
+ * and "all" is a declared value (`visibleIntervalsMs: []` is All intervals, `maxNakedLevels: 0` is all levels,
15
+ * decision 3), which a capture writes where the engine holds none.
15
16
  *
16
17
  * A row is `[key, field]`: the field's owner (the settings bag when it names none, else `meta`, the bag's `meta`
17
18
  * object), its lanes, whether it is instance state (which instance this is: never written by a template or a saved
@@ -7,11 +7,12 @@
7
7
  * Moved here from the web app, content unchanged: the persistence list settingsToSave and its type lists
8
8
  * (src/constants/indicator.constants.ts), the instance keys and the template meta allowlists
9
9
  * (src/utility/chart/indicator-defaults-apply.util.ts), the volatile keys (src/utility/chart/settings-templates.util.ts).
10
- * Three changes are decisions of the plan, not drift: `runMode` is row-only instance state (A11); seven meta
10
+ * Three changes are decisions of the plan, not drift: `runMode` is row-only instance state (A11); six meta
11
11
  * preferences a settings dialog writes are template-lane (decision 6: the Bitfinex position side, the Put/Call mode,
12
- * the Turnover sides and period, the Aggregated Volume margin category, the Sector Volume asset type and the Insurance
13
- * fund group), the ETF pick stays identity; and "all" is a declared value (`visibleIntervalsMs: []` is All intervals,
14
- * `maxNakedLevels: 0` is all levels, decision 3), which a capture writes where the engine holds none.
12
+ * the Turnover sides and period, the Sector Volume asset type and the Insurance fund group; the Aggregated Volume
13
+ * margin category was a seventh until its row, which nothing read, left on 2026-10-25), the ETF pick stays identity;
14
+ * and "all" is a declared value (`visibleIntervalsMs: []` is All intervals, `maxNakedLevels: 0` is all levels,
15
+ * decision 3), which a capture writes where the engine holds none.
15
16
  *
16
17
  * A row is `[key, field]`: the field's owner (the settings bag when it names none, else `meta`, the bag's `meta`
17
18
  * object), its lanes, whether it is instance state (which instance this is: never written by a template or a saved
@@ -761,6 +762,19 @@ export const INDICATOR_COMMON_FIELDS = [
761
762
  ['showValueAreaBand', PREFERENCE],
762
763
  ['candleMarker', PREFERENCE],
763
764
  ['footprintColumns', PREFERENCE],
765
+ // The Aggregated Volume Footprint's Trim empty tail rows (settings no-op audit, 2026-10-25): its template stamps
766
+ // the key on, and a row the user switched off must keep it off through a reload.
767
+ ['trimZeroTails', PREFERENCE],
768
+ // A window's projection stamps (window-cell.util, 2026-10-23), declared after the fixture in their own change: the
769
+ // chart Indicator a window door copied the owner from (`{ overlayId, chartIndex }`), and the mark of a window that
770
+ // shows its tables alone (the window an add opens beside its chart Indicator). The row keeps both (a reload keeps
771
+ // the window a projection); a template or saved default never carries them onto another instance.
772
+ ['wrunWindowSourceId', INSTANCE],
773
+ ['wrunWindowTablesOnly', INSTANCE],
774
+ // The Pane page's Scale mode (PaneSettingsComponent, settings audit 2026-10-25): false is Manual, absent is Auto
775
+ // (the restore reads `settings.isAutoScale ?? true`). Without the row every save dropped it, so Manual read Auto
776
+ // after a reload.
777
+ ['isAutoScale', PREFERENCE],
764
778
  ];
765
779
  /**
766
780
  * FEED (live series, docs/features/indicators/feeds.md): the rest of the C4 record beside `address`, `scope` and
@@ -799,6 +813,31 @@ const METRIC_PROFILE_FIELDS = [
799
813
  * generic, and declared for every overlay it would start persisting other natives' engine keys.
800
814
  */
801
815
  const SYMBOL_COMPARISON_FIELDS = [['label', INSTANCE]];
816
+ /**
817
+ * The Options Heatmap's node layer and cell look: Node levels, Node %, Node change, Style (Volumetric beads or Classic
818
+ * tiles) and Low nodes, preferences its settings dialog writes. Off every list, each save dropped them and a reload read
819
+ * each one's default. Scoped to the type, because the names are generic: declared for every overlay they would start
820
+ * persisting other natives' engine keys (the book heatmaps keep their own `cellShape` in `meta`). The data source
821
+ * (`dataSource`, the internal Server strike rows switch, OPTIONS-HEATMAP-STRIKE-SURFACE plan 2.4) is kept the same
822
+ * way: an explicit choice survives a reload, and an overlay that never chose keeps no value, so it reads the default.
823
+ */
824
+ const OPTIONS_HEATMAP_FIELDS = [
825
+ ['showNodes', PREFERENCE],
826
+ ['nodePct', PREFERENCE],
827
+ ['velocityWindow', PREFERENCE],
828
+ ['cellShape', PREFERENCE],
829
+ ['lowNodes', PREFERENCE],
830
+ ['dataSource', PREFERENCE],
831
+ ];
832
+ /**
833
+ * The Options GEX profile's Top node pill (its settings dialog's Key levels rows), scoped like the heatmap's above, and
834
+ * the look of a level's axis tag (`axisTagLook`, 'quiet' | 'words', EM-LOOK 2026-10-26), unset until the user picks one.
835
+ */
836
+ const OPTIONS_GEX_FIELDS = [
837
+ ['showTopNode', PREFERENCE],
838
+ ['topNodeColor', PREFERENCE],
839
+ ['axisTagLook', PREFERENCE],
840
+ ];
802
841
  /** The VRVP own-window scope rows (see INDICATOR_TYPE_FIELDS below). */
803
842
  const VISIBLE_RANGE_PROFILE_FIELDS = [
804
843
  ['profileWindow', PREFERENCE],
@@ -827,6 +866,8 @@ export const INDICATOR_TYPE_FIELDS = {
827
866
  AGGREGATED_VISIBLE_RANGE_VOLUME_PROFILE: VISIBLE_RANGE_PROFILE_FIELDS,
828
867
  OPEN_INTEREST_PROFILE: METRIC_PROFILE_FIELDS,
829
868
  LIQUIDATION_PROFILE: METRIC_PROFILE_FIELDS,
869
+ OPTIONS_HEATMAP: OPTIONS_HEATMAP_FIELDS,
870
+ OPTIONS_GEX: OPTIONS_GEX_FIELDS,
830
871
  SYMBOL_COMPARISON_SCALE: SYMBOL_COMPARISON_FIELDS,
831
872
  SYMBOL_COMPARISON_PCT_SCALE: SYMBOL_COMPARISON_FIELDS,
832
873
  SYMBOL_COMPARISON_PANE: SYMBOL_COMPARISON_FIELDS,
@@ -842,8 +883,6 @@ export const INDICATOR_TYPE_FIELDS = {
842
883
  ['sides', META_PREFERENCE],
843
884
  ['period', META_PREFERENCE],
844
885
  ],
845
- /** The margin category (AggregatedVolumeSettings.vue `meta.categoryTypes`). */
846
- AGGREGATED_VOLUME: [['categoryTypes', META_PREFERENCE]],
847
886
  /**
848
887
  * The asset type (SectorVolumeSettings.vue `meta.assetType`) is a preference. The exchanges are derived: the asset
849
888
  * type handler writes its table's entry, but a fresh instance stamps the chart's own venue (initializeOverlay), so a
@@ -5,8 +5,8 @@
5
5
  *
6
6
  * - TOOL_DEFAULT_STYLE[type]: the registry defaultStyle, then the held extras below with their declared defaults;
7
7
  * - TOOL_TEMPLATE_KEYS[type]: those keys, then the text of a type whose text is a label (the text rule, textRoleOf),
8
- * then `visibleIntervalsMs` unless the type is interval-bound, never an instance key or a cached compute key
9
- * (`settingsKeysToStrip`).
8
+ * then `visibleIntervalsMs` unless the type is interval-bound, never an instance key (the type's own too,
9
+ * `instanceKeysByType`) or a cached compute key (`settingsKeysToStrip`).
10
10
  *
11
11
  * The text rule is the hosts' too: a host's text box reads it through toolTextRole (settings-templates/index.ts), so
12
12
  * the box and the template tables give every type one answer.
@@ -22,6 +22,20 @@ export declare const TOOL_TEMPLATE_RULES: {
22
22
  * a type whose text is a label (the text rule, `text`) carries it in its template.
23
23
  */
24
24
  readonly instanceKeys: readonly ["isLocked", "isHidden", "zPriority", "name", "text"];
25
+ /**
26
+ * Values the engine computes for one drawing and writes into its settings, by type (titan's tool classes): a
27
+ * GhostFeed seeds its average high-low and variance from the candles of the symbol it is drawn on, in that market's
28
+ * price units, and skips the seed while the drawing holds an averageHL (ghostFeed.ts seedInputs). The registry lists
29
+ * them at 0, the engine's "not seeded yet", so a new drawing seeds its own. They are instance state like
30
+ * `instanceKeys`: no template carries or writes them, Save as default and the style memory keep neither (web
31
+ * src/store/tool-style-memory.ts keeps the default lane), and a template applied to a drawing leaves its own. Until
32
+ * 2026-10-25 they rode both lanes, so a GhostFeed drawn after one on BTC drew BTC's volatility on any symbol.
33
+ * tests/packages/wrun-chart-host/settings-templates/tool-tables.engine-reads.spec.ts fails on a key the engine writes
34
+ * that a lane carries unless this list names it or the spec waives it as a pick the user made.
35
+ */
36
+ readonly instanceKeysByType: {
37
+ readonly GhostFeed: readonly ["averageHL", "variance"];
38
+ };
25
39
  /**
26
40
  * The text rule: which drawing types hold a free text (`key`), and what that text is. It is the one rule for every
27
41
  * surface: the template tables (the generator) and the settings panel's text box (web
@@ -54,8 +68,11 @@ export declare const TOOL_TEMPLATE_RULES: {
54
68
  readonly intervalBoundTypes: readonly ["GhostFeed", "BarPattern", "GannSquareFixed"];
55
69
  /**
56
70
  * Keys the engine reads but the registry defaultStyle does not list (web src/components/objects/tool-prop-sections.ts
57
- * HELD_EXTRA_FIELDS: the price label flag of a horizontal line or ray, a position's line width and style), each with
58
- * the default the engine seeds (titan's tool classes), so a template, a seed and Save as default see every key.
71
+ * HELD_EXTRA_FIELDS: the price label flag of a horizontal line or ray), each with the default the engine seeds
72
+ * (titan's tool classes), so a template, a seed and Save as default see every key. A key belongs in the registry:
73
+ * an extra stays here only while the registry cannot carry it as the editors show it (the price label flag is the
74
+ * `highlight` field under a per-type label). A position's line width and style moved into the registry with
75
+ * chart-schema 0.5.1, and the generator refuses an extra the registry lists.
59
76
  */
60
77
  readonly heldExtras: {
61
78
  readonly HorizontalLine: {
@@ -64,24 +81,17 @@ export declare const TOOL_TEMPLATE_RULES: {
64
81
  readonly HorizontalRay: {
65
82
  readonly highlight: true;
66
83
  };
67
- readonly LongPosition: {
68
- readonly lineWidth: 2;
69
- readonly lineStyle: "solid";
70
- };
71
- readonly ShortPosition: {
72
- readonly lineWidth: 2;
73
- readonly lineStyle: "solid";
74
- };
75
84
  };
76
85
  /**
77
- * Style keys Save as default never keeps (web src/store/tool-style-memory.ts NON_STYLE_KEYS): `rotation` is one
78
- * placed drawing's geometry, and the position tools' financial inputs would carry one account's numbers into the
79
- * next drawing. A template still carries them: it is applied on purpose, onto one drawing.
86
+ * Style keys Save as default never keeps, and so neither does web's style memory (src/store/tool-style-memory.ts
87
+ * keeps the default lane): `rotation` is one placed drawing's geometry, and the position tools' financial inputs
88
+ * would carry one account's numbers into the next drawing. A template still carries them: it is applied on purpose,
89
+ * onto one drawing.
80
90
  */
81
91
  readonly defaultExcludedKeys: readonly ["rotation", "accountSize", "risk", "riskDisplayMode", "lotSize"];
82
92
  /**
83
- * Types whose Save as default keeps nothing (web src/store/tool-style-memory.ts NON_MEMORY_TOOL_TYPES): an Image is
84
- * placed by a dialog that owns its source and opacity at confirm time.
93
+ * Types whose Save as default keeps nothing, and so neither does web's style memory: an Image is placed by a dialog
94
+ * that owns its source and opacity at confirm time.
85
95
  */
86
96
  readonly defaultExcludedTypes: readonly ["Image"];
87
97
  };