@orangecharts/wrun-chart-host 0.9.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 (252) hide show
  1. package/README.md +2 -0
  2. package/dist/constants/feature-flags.constants.d.ts +15 -1
  3. package/dist/constants/feature-flags.constants.js +130 -24
  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/opra-compliance.constants.d.ts +3 -2
  7. package/dist/constants/opra-compliance.constants.js +3 -2
  8. package/dist/constants/option-venues.constants.d.ts +2 -2
  9. package/dist/constants/scriptEditor/builtin-script-snippets.d.ts +26 -0
  10. package/dist/constants/scriptEditor/builtin-script-snippets.js +6 -0
  11. package/dist/constants/scriptEditor/technicalIndicatorScriptKeys.constants.d.ts +15 -0
  12. package/dist/constants/scriptEditor/technicalIndicatorScriptKeys.constants.js +17 -0
  13. package/dist/constants/venue-presets.constants.d.ts +20 -20
  14. package/dist/constants/venue-presets.constants.js +24 -26
  15. package/dist/host-env.d.ts +21 -5
  16. package/dist/host-env.js +6 -0
  17. package/dist/host-ports.types.d.ts +102 -19
  18. package/dist/index.d.ts +18 -0
  19. package/dist/index.js +18 -0
  20. package/dist/interfaces/cancel-reason.interface.d.ts +1 -1
  21. package/dist/interfaces/cme-realtime.interface.d.ts +16 -9
  22. package/dist/interfaces/cme-realtime.interface.js +6 -3
  23. package/dist/interfaces/kscript-diagnostics.interface.d.ts +12 -0
  24. package/dist/interfaces/opra-realtime.interface.d.ts +1 -5
  25. package/dist/interfaces/prediction-market.interface.d.ts +7 -0
  26. package/dist/interfaces/replay.interface.d.ts +8 -0
  27. package/dist/interfaces/stocks-realtime.interface.d.ts +57 -0
  28. package/dist/interfaces/stocks-realtime.interface.js +32 -0
  29. package/dist/interfaces/wrun-runtime.interface.d.ts +18 -2
  30. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +62 -94
  31. package/dist/kscript-data/controls/live-trades-merge.util.js +106 -171
  32. package/dist/market-data/billing.interface.d.ts +174 -36
  33. package/dist/market-data/billing.interface.js +58 -8
  34. package/dist/market-data/venue.d.ts +152 -7
  35. package/dist/market-data/venues/cme.contract.copy.json +66 -0
  36. package/dist/market-data/venues/cme.d.ts +126 -0
  37. package/dist/market-data/venues/cme.js +133 -0
  38. package/dist/market-data/venues/index.d.ts +294 -7
  39. package/dist/market-data/venues/index.js +49 -6
  40. package/dist/market-data/venues/opra.contract.copy.json +3 -2
  41. package/dist/market-data/venues/opra.d.ts +2 -2
  42. package/dist/market-data/venues/opra.js +5 -2
  43. package/dist/market-data/venues/stocks.contract.copy.json +64 -0
  44. package/dist/market-data/venues/stocks.d.ts +130 -0
  45. package/dist/market-data/venues/stocks.js +117 -0
  46. package/dist/settings-templates/footprint-rows.js +35 -2
  47. package/dist/settings-templates/form-rows.d.ts +2 -1
  48. package/dist/settings-templates/index.js +7 -3
  49. package/dist/settings-templates/indicator-fields.d.ts +5 -4
  50. package/dist/settings-templates/indicator-fields.js +79 -10
  51. package/dist/settings-templates/tool-rules.d.ts +32 -15
  52. package/dist/settings-templates/tool-rules.js +33 -11
  53. package/dist/settings-templates/tool-tables.generated.js +95 -31
  54. package/dist/utility/chart/book-live-bucket.util.d.ts +15 -0
  55. package/dist/utility/chart/book-live-bucket.util.js +47 -0
  56. package/dist/utility/chart/cme-cache-context.util.d.ts +5 -3
  57. package/dist/utility/chart/cme-cache-context.util.js +10 -6
  58. package/dist/utility/chart/cme-realtime.util.js +10 -0
  59. package/dist/utility/chart/cme-user-scripts-gate.util.d.ts +83 -0
  60. package/dist/utility/chart/cme-user-scripts-gate.util.js +142 -0
  61. package/dist/utility/chart/effective-chart-session.util.d.ts +14 -0
  62. package/dist/utility/chart/effective-chart-session.util.js +39 -0
  63. package/dist/utility/chart/host-bar-placement.util.d.ts +28 -0
  64. package/dist/utility/chart/host-bar-placement.util.js +170 -30
  65. package/dist/utility/chart/index-host-tier.util.d.ts +3 -1
  66. package/dist/utility/chart/index-host-tier.util.js +7 -2
  67. package/dist/utility/chart/index-mode-admission.util.js +30 -3
  68. package/dist/utility/chart/kscript-apply-fingerprint.util.js +1 -1
  69. package/dist/utility/chart/kscript-drawing-safe-area.util.d.ts +35 -11
  70. package/dist/utility/chart/kscript-drawing-safe-area.util.js +145 -35
  71. package/dist/utility/chart/kscript-live-coalesce.util.d.ts +9 -7
  72. package/dist/utility/chart/kscript-live-coalesce.util.js +13 -8
  73. package/dist/utility/chart/kscript-live-source-identity.util.d.ts +9 -0
  74. package/dist/utility/chart/kscript-live-source-identity.util.js +10 -1
  75. package/dist/utility/chart/kscript-provenance-keys.util.js +13 -0
  76. package/dist/utility/chart/kscript-standin-identity.leaf.d.ts +5 -1
  77. package/dist/utility/chart/kscript-titancharts-render-keys.constants.d.ts +32 -2
  78. package/dist/utility/chart/kscript-titancharts-render-keys.constants.js +45 -0
  79. package/dist/utility/chart/kscript-venue-policy.util.d.ts +156 -43
  80. package/dist/utility/chart/kscript-venue-policy.util.js +249 -59
  81. package/dist/utility/chart/live-bucket.util.d.ts +24 -8
  82. package/dist/utility/chart/live-bucket.util.js +85 -27
  83. package/dist/utility/chart/market-session-schedule.util.d.ts +10 -0
  84. package/dist/utility/chart/market-session-schedule.util.js +16 -0
  85. package/dist/utility/chart/marketKind.util.js +5 -0
  86. package/dist/utility/chart/mixed-mode.util.d.ts +7 -0
  87. package/dist/utility/chart/mixed-mode.util.js +14 -0
  88. package/dist/utility/chart/opra-read-access.leaf.d.ts +5 -3
  89. package/dist/utility/chart/opra-read-access.leaf.js +5 -3
  90. package/dist/utility/chart/opra-user-scripts-gate.util.d.ts +11 -16
  91. package/dist/utility/chart/opra-user-scripts-gate.util.js +12 -28
  92. package/dist/utility/chart/rth-session.util.d.ts +12 -10
  93. package/dist/utility/chart/rth-session.util.js +25 -21
  94. package/dist/utility/chart/trading-day.util.d.ts +17 -0
  95. package/dist/utility/chart/trading-day.util.js +59 -0
  96. package/dist/utility/chart/window-geometry.leaf.d.ts +8 -0
  97. package/dist/utility/chart/window-geometry.leaf.js +22 -6
  98. package/dist/utility/chart/window-owner.leaf.d.ts +23 -2
  99. package/dist/utility/chart/window-owner.leaf.js +45 -3
  100. package/dist/utility/chart/wrun-bar-session-facts.util.d.ts +33 -15
  101. package/dist/utility/chart/wrun-bar-session-facts.util.js +70 -20
  102. package/dist/utility/chart/wrun-run-result.util.d.ts +12 -0
  103. package/dist/utility/chart/wrun-run-result.util.js +141 -6
  104. package/dist/utility/intl-locale.util.js +5 -0
  105. package/dist/utility/options/option-bar-anchor.util.d.ts +145 -0
  106. package/dist/utility/options/option-bar-anchor.util.js +340 -0
  107. package/dist/utility/options/option-venue.util.d.ts +18 -0
  108. package/dist/utility/options/option-venue.util.js +27 -0
  109. package/dist/utility/scriptEditor/wrun-runtime-diagnostics.leaf.js +4 -0
  110. package/dist/utility/v2/gate-plane.util.d.ts +12 -3
  111. package/dist/utility/v2/gate-plane.util.js +30 -4
  112. package/dist/utility/v2/gate-session-latch.util.js +1 -1
  113. package/dist/utility/v2/stocks-governed.util.d.ts +16 -0
  114. package/dist/utility/v2/stocks-governed.util.js +34 -0
  115. package/dist/utility/wrun/derived-roots.leaf.d.ts +13 -0
  116. package/dist/utility/wrun/derived-roots.leaf.js +27 -0
  117. package/dist/utility/wrun/derived-roots.util.d.ts +205 -0
  118. package/dist/utility/wrun/derived-roots.util.js +451 -0
  119. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.d.ts +43 -7
  120. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.js +89 -19
  121. package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.d.ts +9 -4
  122. package/dist/utility/wrun/run-schedule/wrun-gate-reader-warm.util.js +47 -6
  123. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.d.ts +4 -2
  124. package/dist/utility/wrun/run-schedule/wrun-late-reads.util.js +4 -2
  125. package/dist/utility/wrun/run-schedule/wrun-own-candles.util.d.ts +24 -3
  126. package/dist/utility/wrun/run-schedule/wrun-own-candles.util.js +46 -10
  127. package/dist/utility/wrun/sources/lanes/option_daily.js +5 -2
  128. package/dist/utility/wrun/sources/lanes/options_flow.js +5 -2
  129. package/dist/utility/wrun/sources/opra-option-lanes.util.d.ts +64 -19
  130. package/dist/utility/wrun/sources/opra-option-lanes.util.js +105 -35
  131. package/dist/utility/wrun/sources/row-lanes/option_contract_flow.js +2 -1
  132. package/dist/utility/wrun/sources/row-lanes/option_contract_state.js +2 -1
  133. package/dist/utility/wrun/sources/row-lanes/option_prints.d.ts +3 -0
  134. package/dist/utility/wrun/sources/row-lanes/option_prints.js +19 -4
  135. package/dist/utility/wrun/sources/row-lanes/option_strike_flow.js +17 -4
  136. package/dist/utility/wrun/sources/row-lanes/option_strikes.d.ts +52 -13
  137. package/dist/utility/wrun/sources/row-lanes/option_strikes.js +88 -19
  138. package/dist/utility/wrun/sources/row-lanes/option_surface.js +2 -1
  139. package/dist/utility/wrun/sources/wrun-poll-lane.types.d.ts +19 -0
  140. package/dist/utility/wrun/sources/wrun-poll-lanes.util.d.ts +24 -9
  141. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +41 -10
  142. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.d.ts +111 -0
  143. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.js +133 -0
  144. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.d.ts +15 -3
  145. package/dist/utility/wrun/sources/wrun-row-lane-first-paint.util.js +22 -3
  146. package/dist/utility/wrun/sources/wrun-row-lane.types.d.ts +31 -0
  147. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +197 -13
  148. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +761 -27
  149. package/dist/utility/wrun/wrun-browser-sources.leaf.js +1 -2
  150. package/dist/utility/wrun/wrun-builtin-twin.util.d.ts +12 -0
  151. package/dist/utility/wrun/wrun-builtin-twin.util.js +21 -0
  152. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +60 -16
  153. package/dist/utility/wrun/wrun-chart-market-facts.util.js +113 -61
  154. package/dist/utility/wrun/wrun-color-settings.util.d.ts +9 -0
  155. package/dist/utility/wrun/wrun-color-settings.util.js +33 -0
  156. package/dist/utility/wrun/wrun-download-meter.util.d.ts +15 -0
  157. package/dist/utility/wrun/wrun-download-meter.util.js +14 -2
  158. package/dist/utility/wrun/wrun-download-plan.util.d.ts +99 -0
  159. package/dist/utility/wrun/wrun-download-plan.util.js +118 -0
  160. package/dist/utility/wrun/wrun-draft-legend-note.util.d.ts +11 -3
  161. package/dist/utility/wrun/wrun-draft-legend-note.util.js +26 -4
  162. package/dist/utility/wrun/wrun-frames.d.ts +27 -6
  163. package/dist/utility/wrun/wrun-frames.js +73 -10
  164. package/dist/utility/wrun/wrun-handles.util.d.ts +7 -3
  165. package/dist/utility/wrun/wrun-handles.util.js +9 -8
  166. package/dist/utility/wrun/wrun-hosted-wire.util.d.ts +7 -1
  167. package/dist/utility/wrun/wrun-hosted-wire.util.js +12 -2
  168. package/dist/utility/wrun/wrun-hud-looks.util.d.ts +18 -4
  169. package/dist/utility/wrun/wrun-hud-looks.util.js +45 -13
  170. package/dist/utility/wrun/wrun-input-requirements.leaf.d.ts +68 -0
  171. package/dist/utility/wrun/wrun-input-requirements.leaf.js +163 -7
  172. package/dist/utility/wrun/wrun-latest-snapshot.d.ts +11 -0
  173. package/dist/utility/wrun/wrun-leg-close.util.d.ts +59 -23
  174. package/dist/utility/wrun/wrun-leg-close.util.js +186 -28
  175. package/dist/utility/wrun/wrun-live-intake.util.d.ts +35 -15
  176. package/dist/utility/wrun/wrun-live-intake.util.js +243 -126
  177. package/dist/utility/wrun/wrun-live-tick.util.d.ts +13 -5
  178. package/dist/utility/wrun/wrun-live-tick.util.js +279 -99
  179. package/dist/utility/wrun/wrun-market-facts.util.d.ts +13 -3
  180. package/dist/utility/wrun/wrun-market-facts.util.js +13 -3
  181. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +60 -11
  182. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +70 -5
  183. package/dist/utility/wrun/wrun-market-size-defaults.util.js +31 -5
  184. package/dist/utility/wrun/wrun-opra-lane.util.d.ts +17 -4
  185. package/dist/utility/wrun/wrun-opra-lane.util.js +6 -4
  186. package/dist/utility/wrun/wrun-option-book-rows.util.d.ts +56 -0
  187. package/dist/utility/wrun/wrun-option-book-rows.util.js +96 -0
  188. package/dist/utility/wrun/wrun-option-strike-flow-forecast.util.d.ts +31 -0
  189. package/dist/utility/wrun/wrun-option-strike-flow-forecast.util.js +119 -0
  190. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.d.ts +23 -6
  191. package/dist/utility/wrun/wrun-option-strike-flow-lane.util.js +47 -11
  192. package/dist/utility/wrun/wrun-option-strike-flow.util.d.ts +86 -19
  193. package/dist/utility/wrun/wrun-option-strike-flow.util.js +168 -62
  194. package/dist/utility/wrun/wrun-option-views.util.d.ts +323 -28
  195. package/dist/utility/wrun/wrun-option-views.util.js +484 -71
  196. package/dist/utility/wrun/wrun-options-chain.util.d.ts +3 -3
  197. package/dist/utility/wrun/wrun-options-chain.util.js +2 -0
  198. package/dist/utility/wrun/wrun-output-style.util.d.ts +6 -2
  199. package/dist/utility/wrun/wrun-output-style.util.js +20 -2
  200. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +32 -2
  201. package/dist/utility/wrun/wrun-overlay-drivers.util.js +13 -3
  202. package/dist/utility/wrun/wrun-overlay-lifecycle.util.d.ts +10 -1
  203. package/dist/utility/wrun/wrun-overlay-lifecycle.util.js +52 -4
  204. package/dist/utility/wrun/wrun-overlay-recovery.util.js +3 -1
  205. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +160 -42
  206. package/dist/utility/wrun/wrun-overlay-run.util.js +1244 -209
  207. package/dist/utility/wrun/wrun-pane-format.util.d.ts +2 -1
  208. package/dist/utility/wrun/wrun-pane-format.util.js +7 -3
  209. package/dist/utility/wrun/wrun-panel-mount.util.d.ts +9 -0
  210. package/dist/utility/wrun/wrun-panel-mount.util.js +114 -19
  211. package/dist/utility/wrun/wrun-panel-style.util.d.ts +10 -9
  212. package/dist/utility/wrun/wrun-panel-style.util.js +58 -9
  213. package/dist/utility/wrun/wrun-param-map.util.d.ts +14 -11
  214. package/dist/utility/wrun/wrun-param-map.util.js +10 -5
  215. package/dist/utility/wrun/wrun-param-values.util.d.ts +14 -4
  216. package/dist/utility/wrun/wrun-param-values.util.js +4 -0
  217. package/dist/utility/wrun/wrun-pin-spelling.util.d.ts +15 -2
  218. package/dist/utility/wrun/wrun-pin-spelling.util.js +39 -14
  219. package/dist/utility/wrun/wrun-refusal-surface.util.d.ts +50 -0
  220. package/dist/utility/wrun/wrun-refusal-surface.util.js +68 -0
  221. package/dist/utility/wrun/wrun-refusal.util.d.ts +3 -2
  222. package/dist/utility/wrun/wrun-refusal.util.js +22 -0
  223. package/dist/utility/wrun/wrun-refused-latest.util.d.ts +10 -0
  224. package/dist/utility/wrun/wrun-refused-latest.util.js +12 -0
  225. package/dist/utility/wrun/wrun-registry-errors.util.d.ts +26 -0
  226. package/dist/utility/wrun/wrun-registry-errors.util.js +34 -0
  227. package/dist/utility/wrun/wrun-replay-lane.util.js +3 -2
  228. package/dist/utility/wrun/wrun-row-source.d.ts +11 -0
  229. package/dist/utility/wrun/wrun-run-interval-session.util.d.ts +20 -6
  230. package/dist/utility/wrun/wrun-run-interval-session.util.js +22 -7
  231. package/dist/utility/wrun/wrun-run-interval.util.d.ts +43 -9
  232. package/dist/utility/wrun/wrun-run-interval.util.js +58 -15
  233. package/dist/utility/wrun/wrun-script-inputs.util.d.ts +45 -1
  234. package/dist/utility/wrun/wrun-script-inputs.util.js +112 -4
  235. package/dist/utility/wrun/wrun-setting-words.util.d.ts +7 -3
  236. package/dist/utility/wrun/wrun-setting-words.util.js +13 -5
  237. package/dist/utility/wrun/wrun-socket-row-source.d.ts +27 -2
  238. package/dist/utility/wrun/wrun-socket-row-source.js +118 -8
  239. package/dist/utility/wrun/wrun-source-rows.util.d.ts +29 -18
  240. package/dist/utility/wrun/wrun-source-rows.util.js +61 -27
  241. package/dist/utility/wrun/wrun-style-words.util.js +6 -4
  242. package/dist/utility/wrun/wrun-table-chrome.util.d.ts +3 -2
  243. package/dist/utility/wrun/wrun-table-chrome.util.js +19 -11
  244. package/dist/utility/wrun/wrun-tape-per-order.util.d.ts +2 -0
  245. package/dist/utility/wrun/wrun-tape-per-order.util.js +7 -0
  246. package/dist/utility/wrun/wrun-tape-source.util.d.ts +17 -9
  247. package/dist/utility/wrun/wrun-tape-source.util.js +20 -12
  248. package/dist/utils/replay/replay-buffer-math.d.ts +53 -2
  249. package/dist/utils/replay/replay-buffer-math.js +227 -20
  250. package/dist/workers/constants/socket-slots.d.ts +91 -6
  251. package/dist/workers/constants/socket-slots.js +85 -6
  252. package/package.json +5 -5
@@ -0,0 +1,117 @@
1
+ /**
2
+ * The US stocks venue card (the consolidated tape: CTA for Tapes A and B, UTP for Tape C): the frontend descriptor of
3
+ * the $19 "Real-time US stocks" add-on on the venue-generic market-data plane (docs/features/market-data/plane.md, "US
4
+ * stocks on the plane"). Carried DARK: the registry lists it only while `us-equities-full` reads on
5
+ * (`FLAG_GATED_MARKET_DATA_VENUES`, `marketDataVenueIsServed`), so with the flag off nothing in the app reads it.
6
+ *
7
+ * OPRA's policy set (pay first, one product, a professional refused), with what the tape adds: two agreements, one per
8
+ * set of product groups (`agreements`: CTA's Exhibit B covers Tapes A and B, `NYSE_TAPE` and `NYSE_ARCA_TAPE`, the UTP
9
+ * Subscriber Agreement covers Tape C, `NASDAQ_TAPE`; the gate release's `agreements:` names and versions, `*-pending`
10
+ * until the texts ship), staff refused
11
+ * (ENTITLEMENT.md §7: no staff real time, the release's `internal_realtime: false`), and a declaration that records the
12
+ * Exhibit B Section 2 answers (a) to (k), the Paragraph 12 data and the UTP subscriber fields (`recordFields`,
13
+ * `legalNameFrom`). The question wording is NOT approved yet: the content module is marked so and the checkout stays
14
+ * shut while it is (src/components/dialogs/market-data/questionnaires/stocks.ts).
15
+ *
16
+ * Pinned against the contract copy beside this file (`stocks.contract.copy.json`, written from this card until orange's
17
+ * export replaces it) and the gate's release mirror (`gate-mirror.copy.yaml` beside the spec) by
18
+ * tests/packages/wrun-chart-host/market-data/venues/stocks.contract.spec.ts.
19
+ */
20
+ import { FeatureFlag } from '../../constants/feature-flags.constants.js';
21
+ import { STOCKS_GOVERNED_EXCHANGES, STOCKS_TAPE_OF_EXCHANGE } from '../../interfaces/stocks-realtime.interface.js';
22
+ // The product groups are the frontend's tape codes (the gate's wire names are the listing venues: the service and the
23
+ // gate mirror's copy name those, STOCKS_TAPE_WIRE_EXCHANGE maps them). CTA licenses Tapes A and B, UTP Tape C.
24
+ const CTA_TAPES = STOCKS_GOVERNED_EXCHANGES.filter((code) => STOCKS_TAPE_OF_EXCHANGE[code] !== 'C');
25
+ const UTP_TAPES = STOCKS_GOVERNED_EXCHANGES.filter((code) => STOCKS_TAPE_OF_EXCHANGE[code] === 'C');
26
+ export const STOCKS_VENUE = {
27
+ key: 'stocks',
28
+ displayName: 'US stocks',
29
+ // The three tapes, by their frontend codes (the gate release's `stocks.product_groups` name their listing venues).
30
+ productGroups: STOCKS_GOVERNED_EXCHANGES,
31
+ basePath: '/market-data/stocks',
32
+ // The one plan: every US stock trade in real time, all three tapes, billed monthly, non-professional subscribers
33
+ // only (Kyle 2026-10-29: $19 a month, raised from $15 the same day). Display price: the server's subscription price is authoritative once one exists.
34
+ products: [{ name: 'stocks_rt_1m', plan: 'p1', classifications: ['non_professional'], interval: '1m', priceUsd: 19 }],
35
+ planCard: { name: 'Real-time US stocks', level: 'ALL US VENUES', market: 'US stocks', region: '🇺🇸 USA' },
36
+ paymentItemPrefix: 'stocks_',
37
+ professionalPolicy: 'refuse',
38
+ // Staff get no real time on the tape (ENTITLEMENT.md §7; the release refuses internal rows): the server's refusal
39
+ // stands. No role is consulted here either way.
40
+ internalRolePolicy: 'refuse',
41
+ payFirst: true,
42
+ questionnaire: {
43
+ // `-pending` like the gate's agreement versions: the question wording is the public reference text until the
44
+ // exchange approves our subscriber screen. Bump on any change to the questions, their order or their wording.
45
+ formVersion: 'stocks-pending',
46
+ // CTA Exhibit B, Section 2, Paragraph 10 (a) to (k), in order: (a) personal, non-business use qualifies with Yes,
47
+ // every other question with No.
48
+ questions: [
49
+ { id: 'personal_non_business_use', qualifying: true },
50
+ { id: 'receives_for_business_or_entity', qualifying: false },
51
+ { id: 'registered_sec_cftc', qualifying: false },
52
+ { id: 'registered_other_regulator', qualifying: false },
53
+ { id: 'performs_registrable_functions', qualifying: false },
54
+ { id: 'provides_investment_advice', qualifying: false },
55
+ { id: 'asset_manager', qualifying: false },
56
+ { id: 'uses_others_capital', qualifying: false },
57
+ { id: 'trades_for_entity', qualifying: false },
58
+ { id: 'shares_trading_profits', qualifying: false },
59
+ { id: 'trading_benefits_received', qualifying: false },
60
+ ],
61
+ groups: [],
62
+ identityFields: ['legalName', 'employer', 'occupation', 'country', 'address'],
63
+ identityLimits: { legalName: 200, employer: 200, occupation: 200, country: 2, address: 300 },
64
+ // Exhibit B Paragraph 12 and the UTP subscriber fields the identity does not carry, under the names the gate's
65
+ // agreements require them by (the UTP fields `firstName`, `lastName`, `postalCode`, `employerPostalCode`; CTA's
66
+ // `paragraph12Titles` and `paragraph12Functions`). The middle name is optional (UTP); a field that does not apply
67
+ // reads None, as the employer field always has. Each name part stays within a third of the legal name's bound.
68
+ recordFields: [
69
+ { id: 'firstName', required: true, maxLength: 64 },
70
+ { id: 'middleName', required: false, maxLength: 64 },
71
+ { id: 'lastName', required: true, maxLength: 64 },
72
+ { id: 'postalCode', required: true, maxLength: 16 },
73
+ { id: 'employerAddress', required: true, maxLength: 300 },
74
+ { id: 'employerPostalCode', required: true, maxLength: 16 },
75
+ { id: 'paragraph12Titles', required: true, maxLength: 200 },
76
+ { id: 'paragraph12Functions', required: true, maxLength: 500 },
77
+ ],
78
+ legalNameFrom: ['firstName', 'middleName', 'lastName'],
79
+ // The gate's default attestation bound for this release (8784 h: a year and a day); neither plan asks a yearly
80
+ // re-attestation of its own.
81
+ validityDays: 366,
82
+ renewalWindowDays: 30,
83
+ },
84
+ // One agreement per plan (the gate release's `agreements:`): real time on a tape needs the assent to the agreement
85
+ // covering it, on the current declaration, at the version the server presents (K1's shape on each text route).
86
+ agreements: [
87
+ {
88
+ id: 'cta-exhibit-b',
89
+ productGroups: CTA_TAPES,
90
+ version: 'cta-exhibit-b-pending',
91
+ url: '/api/v1/market-data/stocks/agreements/cta-exhibit-b',
92
+ recordedAs: 'assent',
93
+ delayedRequiresAcceptance: false,
94
+ // Exhibit B's screen accepts Section 1, then Section 2 (split at the text's offset), and the gate records both.
95
+ sections: 2,
96
+ },
97
+ {
98
+ id: 'utp-subscriber',
99
+ productGroups: UTP_TAPES,
100
+ version: 'utp-subscriber-pending',
101
+ url: '/api/v1/market-data/stocks/agreements/utp-subscriber',
102
+ recordedAs: 'assent',
103
+ delayedRequiresAcceptance: false,
104
+ },
105
+ ],
106
+ // CTA and UTP define delayed data as 15 minutes after publication; the gate's window adds a 5 s margin (905 s).
107
+ delayMinutes: 15,
108
+ // The CTA Delayed Market Data Policy's exact statement: STOCKS_DELAY_STATEMENT in
109
+ // src/constants/stocks-compliance.constants.ts ("Delayed 15 minutes").
110
+ disclosure: { kind: 'verbatim' },
111
+ flagKey: FeatureFlag.UsEquitiesFull,
112
+ i18nNamespace: 'stocksRealtimeData',
113
+ storeId: 'stocksRealtime',
114
+ // For now the delay statement shows on a tape chart's delay chip and its source line only.
115
+ surfaces: ['contract-chart-delay-chip', 'chart-source-line'],
116
+ contractRevision: '2026-10-29.1',
117
+ };
@@ -28,6 +28,16 @@ const DISPLAY_MODE_WORDS = {
28
28
  ladder: 'dialogs.overlayStylesSettings.displayModeLadder',
29
29
  columns: 'indicators.settings.footprintLook.columns.mode',
30
30
  };
31
+ /** The line under each display mode in the picker (web: createFootprintDisplayModeOptions). */
32
+ const DISPLAY_MODE_HINT_WORDS = {
33
+ 'split-bar': 'indicators.settings.footprintLook.modeSplitHint',
34
+ 'stacked-bar-delta': 'indicators.settings.footprintLook.modeDeltaHint',
35
+ 'stacked-bar': 'indicators.settings.footprintLook.modeTotalHint',
36
+ cluster: 'indicators.settings.footprintLook.modeClusterHint',
37
+ 'imbalance-only': 'indicators.settings.footprintLook.modeImbalanceOnlyHint',
38
+ ladder: 'indicators.settings.footprintLook.modeLadderHint',
39
+ columns: 'indicators.settings.footprintLook.modeColumnsHint',
40
+ };
31
41
  const PRESET_WORDS = {
32
42
  bidAskDelta: 'indicators.settings.footprintLook.columns.presetBidAskDelta',
33
43
  deltaVolumeBar: 'indicators.settings.footprintLook.columns.presetDeltaVolumeBar',
@@ -48,6 +58,21 @@ const KIND_WORDS = {
48
58
  volumeBarLeading: 'indicators.settings.footprintLook.columns.kinds.volumeBarLeading',
49
59
  splitBar: 'indicators.settings.footprintLook.columns.kinds.splitBar',
50
60
  };
61
+ /** The line under each column kind in the picker (web: FootprintColumnsPicker.vue). */
62
+ const KIND_HINT_WORDS = {
63
+ bidAsk: 'indicators.settings.footprintLook.columns.kinds.bidAskHint',
64
+ delta: 'indicators.settings.footprintLook.columns.kinds.deltaHint',
65
+ deltaColored: 'indicators.settings.footprintLook.columns.kinds.deltaColoredHint',
66
+ diagonalDelta: 'indicators.settings.footprintLook.columns.kinds.diagonalDeltaHint',
67
+ deltaPct: 'indicators.settings.footprintLook.columns.kinds.deltaPctHint',
68
+ volume: 'indicators.settings.footprintLook.columns.kinds.volumeHint',
69
+ buy: 'indicators.settings.footprintLook.columns.kinds.buyHint',
70
+ sell: 'indicators.settings.footprintLook.columns.kinds.sellHint',
71
+ volumeBar: 'indicators.settings.footprintLook.columns.kinds.volumeBarHint',
72
+ deltaBar: 'indicators.settings.footprintLook.columns.kinds.deltaBarHint',
73
+ volumeBarLeading: 'indicators.settings.footprintLook.columns.kinds.volumeBarLeadingHint',
74
+ splitBar: 'indicators.settings.footprintLook.columns.kinds.splitBarHint',
75
+ };
51
76
  const OFF_WORDS = 'indicators.settings.options.off';
52
77
  const words = (key, params) => params ? { key, params } : { key };
53
78
  /**
@@ -79,7 +104,11 @@ function displayModeRow(model) {
79
104
  label: words('indicators.settings.displayMode'),
80
105
  tooltip: words('dialogs.overlayStylesSettings.displayModeTooltip'),
81
106
  look: 'select',
82
- options: FOOTPRINT_DISPLAY_MODES.map((value) => ({ value, label: words(DISPLAY_MODE_WORDS[value]) })),
107
+ options: FOOTPRINT_DISPLAY_MODES.map((value) => ({
108
+ value,
109
+ label: words(DISPLAY_MODE_WORDS[value]),
110
+ hint: words(DISPLAY_MODE_HINT_WORDS[value]),
111
+ })),
83
112
  value: footprintDisplayModeShown(model),
84
113
  }, (current, value) => withFootprintDisplayMode(current, value));
85
114
  }
@@ -101,7 +130,11 @@ function columnsPresetsRow(model) {
101
130
  /** One select per drawn column, and one more reading Off while there is room. */
102
131
  function columnRows(model) {
103
132
  const columns = footprintColumnsShown(model);
104
- const kindOptions = () => FOOTPRINT_COLUMN_KINDS.map((kind) => ({ value: kind, label: words(KIND_WORDS[kind]) }));
133
+ const kindOptions = () => FOOTPRINT_COLUMN_KINDS.map((kind) => ({
134
+ value: kind,
135
+ label: words(KIND_WORDS[kind]),
136
+ hint: words(KIND_HINT_WORDS[kind]),
137
+ }));
105
138
  return Array.from({ length: Math.min(FOOTPRINT_COLUMNS_MAX, columns.length + 1) }, (_, index) => choiceRow({
106
139
  id: `column-${index + 1}`,
107
140
  label: words('indicators.settings.footprintLook.columns.column', { n: index + 1 }),
@@ -21,10 +21,11 @@ export interface SettingsFormWords {
21
21
  readonly key: string;
22
22
  readonly params?: Readonly<Record<string, string | number>>;
23
23
  }
24
- /** One option of a choice row: the value a pick writes, and its words. */
24
+ /** One option of a choice row: the value a pick writes, its words, and the short line a picker draws under it. */
25
25
  export interface SettingsFormOption {
26
26
  readonly value: string;
27
27
  readonly label: SettingsFormWords;
28
+ readonly hint?: SettingsFormWords;
28
29
  }
29
30
  /** The settings bag a row reads and writes (an overlay's settings). */
30
31
  export type SettingsFormModel = Record<string, unknown>;
@@ -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,24 @@ 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],
778
+ // The TPO open and close block markers (2026-10-30), declared after the fixture in their own change.
779
+ ['highlightOpen', PREFERENCE],
780
+ ['openBlockColor', PREFERENCE],
781
+ ['highlightClose', PREFERENCE],
782
+ ['closeBlockColor', PREFERENCE],
764
783
  ];
765
784
  /**
766
785
  * FEED (live series, docs/features/indicators/feeds.md): the rest of the C4 record beside `address`, `scope` and
@@ -778,19 +797,21 @@ const FEED_FIELDS = [
778
797
  ['pane', PREFERENCE],
779
798
  ];
780
799
  /**
781
- * The metric profiles (metric-profile.util): the render keys the save door derives from `scope` and the member's look
800
+ * The metric profiles (metric-profile.util): the render keys the save door derives from `scope` and the row's display
782
801
  * (stampMetricProfileScopeDerived) beyond the shared ones: the Current period fold (`profileWindow: 'all'`,
783
802
  * `periodMarkers`) and the look every scope draws (the Open Interest Profile's `deltaLayout`, every member's
784
803
  * `levelBasis`). The door writes them into the row, so the restore pick must keep them or every boot spends a
785
- * reconcile save. Scoped to the family for the Delta Profile's reason: the Developing Session Profile stamps
786
- * `profileWindow: 'data'` on every mount. The engine-only keys (`periodStartMs`, `headerTemplate`, `pocLabel`) stay
787
- * out: two of them are translated text.
804
+ * reconcile save. The display itself (`rowDisplay`, the Display field: Net or Split on the Open Interest Profile, absent
805
+ * for the default) is the user's preference the look follows. Scoped to the family for the Delta Profile's reason: the
806
+ * Developing Session Profile stamps `profileWindow: 'data'` on every mount. The engine-only keys (`periodStartMs`,
807
+ * `headerTemplate`, `pocLabel`) stay out: two of them are translated text.
788
808
  */
789
809
  const METRIC_PROFILE_FIELDS = [
790
810
  ['profileWindow', PREFERENCE],
791
811
  ['periodMarkers', PREFERENCE],
792
812
  ['deltaLayout', PREFERENCE],
793
813
  ['levelBasis', PREFERENCE],
814
+ ['rowDisplay', PREFERENCE],
794
815
  ];
795
816
  /**
796
817
  * The Symbol Comparison overlays (new price scale, same % scale, new pane): the name the user gave the series (`label`,
@@ -799,6 +820,46 @@ const METRIC_PROFILE_FIELDS = [
799
820
  * generic, and declared for every overlay it would start persisting other natives' engine keys.
800
821
  */
801
822
  const SYMBOL_COMPARISON_FIELDS = [['label', INSTANCE]];
823
+ /**
824
+ * The Options Heatmap's node layer and cell look: Node levels, Node %, Node change, Style (Volumetric beads or Classic
825
+ * tiles) and Low nodes, preferences its settings dialog writes. Off every list, each save dropped them and a reload read
826
+ * each one's default. Scoped to the type, because the names are generic: declared for every overlay they would start
827
+ * persisting other natives' engine keys (the book heatmaps keep their own `cellShape` in `meta`). The data source
828
+ * (`dataSource`, the internal Server strike rows switch, OPTIONS-HEATMAP-STRIKE-SURFACE plan 2.4) is kept the same
829
+ * way: an explicit choice survives a reload, and an overlay that never chose keeps no value, so it reads the default.
830
+ */
831
+ /**
832
+ * The Chain pick of Options GEX and Options Heatmap (a derived root: QQQ on an NQ chart), replacing the shared `chain`
833
+ * (a DEX pool's, instance state): a preference a reset clears, kept for the market it was picked on, since another
834
+ * market's chart offers other roots.
835
+ */
836
+ const DERIVED_CHAIN_PICK = { lanes: ['row', 'template', 'default'], marketBound: true };
837
+ const OPTIONS_HEATMAP_FIELDS = [
838
+ ['chain', DERIVED_CHAIN_PICK],
839
+ ['showNodes', PREFERENCE],
840
+ ['nodePct', PREFERENCE],
841
+ ['velocityWindow', PREFERENCE],
842
+ ['cellShape', PREFERENCE],
843
+ ['lowNodes', PREFERENCE],
844
+ ['dataSource', PREFERENCE],
845
+ // The node look knobs (NODE-KNOBS 2026-10-28): the smallest, the biggest and the faintest node, percent sliders.
846
+ ['nodeMinSize', PREFERENCE],
847
+ ['nodeMaxSize', PREFERENCE],
848
+ ['nodeMinOpacity', PREFERENCE],
849
+ // 'user' once the user picked the basis in the settings dialog: a governed host's market switch and restore reset
850
+ // only a naive basis the old switch forced (the control's `governedBasisReset`), so the mark travels with `basis`.
851
+ ['basisSource', PREFERENCE],
852
+ ];
853
+ /**
854
+ * The Options GEX profile's Top node pill (its settings dialog's Key levels rows), scoped like the heatmap's above, and
855
+ * the look of a level's axis tag (`axisTagLook`, 'quiet' | 'words', EM-LOOK 2026-10-26), unset until the user picks one.
856
+ */
857
+ const OPTIONS_GEX_FIELDS = [
858
+ ['chain', DERIVED_CHAIN_PICK],
859
+ ['showTopNode', PREFERENCE],
860
+ ['topNodeColor', PREFERENCE],
861
+ ['axisTagLook', PREFERENCE],
862
+ ];
802
863
  /** The VRVP own-window scope rows (see INDICATOR_TYPE_FIELDS below). */
803
864
  const VISIBLE_RANGE_PROFILE_FIELDS = [
804
865
  ['profileWindow', PREFERENCE],
@@ -827,6 +888,8 @@ export const INDICATOR_TYPE_FIELDS = {
827
888
  AGGREGATED_VISIBLE_RANGE_VOLUME_PROFILE: VISIBLE_RANGE_PROFILE_FIELDS,
828
889
  OPEN_INTEREST_PROFILE: METRIC_PROFILE_FIELDS,
829
890
  LIQUIDATION_PROFILE: METRIC_PROFILE_FIELDS,
891
+ OPTIONS_HEATMAP: OPTIONS_HEATMAP_FIELDS,
892
+ OPTIONS_GEX: OPTIONS_GEX_FIELDS,
830
893
  SYMBOL_COMPARISON_SCALE: SYMBOL_COMPARISON_FIELDS,
831
894
  SYMBOL_COMPARISON_PCT_SCALE: SYMBOL_COMPARISON_FIELDS,
832
895
  SYMBOL_COMPARISON_PANE: SYMBOL_COMPARISON_FIELDS,
@@ -842,8 +905,6 @@ export const INDICATOR_TYPE_FIELDS = {
842
905
  ['sides', META_PREFERENCE],
843
906
  ['period', META_PREFERENCE],
844
907
  ],
845
- /** The margin category (AggregatedVolumeSettings.vue `meta.categoryTypes`). */
846
- AGGREGATED_VOLUME: [['categoryTypes', META_PREFERENCE]],
847
908
  /**
848
909
  * The asset type (SectorVolumeSettings.vue `meta.assetType`) is a preference. The exchanges are derived: the asset
849
910
  * type handler writes its table's entry, but a fresh instance stamps the chart's own venue (initializeOverlay), so a
@@ -878,4 +939,12 @@ export const INDICATOR_TYPE_FIELDS = {
878
939
  * (EtfDistributionYieldSettings.vue `meta.showPayouts`), is a preference.
879
940
  */
880
941
  ETF_DISTRIBUTION_YIELD: [['showPayouts', META_PREFERENCE]],
942
+ /**
943
+ * Moving Average Ribbon: its line slots (MaRibbonSettings.vue `meta.lines`: each slot's average, length and switch)
944
+ * are a preference; the Style page's names (`meta.plots`) are derived from them at every mount.
945
+ */
946
+ MA_RIBBON: [
947
+ ['lines', META_PREFERENCE],
948
+ ['plots', META_DERIVED],
949
+ ],
881
950
  };
@@ -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,12 @@ 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, the fib pair's log-scale levels), each with
72
+ * the default the engine seeds (titan's tool classes), so a template, a seed and Save as default see every key. A
73
+ * key belongs in the registry: an extra stays here only while the registry cannot carry it as the editors show it
74
+ * (the price label flag is the `highlight` field under a per-type label), or until the registry lists it (the fib
75
+ * pair's). A position's line width and style moved into the registry with chart-schema 0.5.1, and the generator
76
+ * refuses an extra the registry lists.
59
77
  */
60
78
  readonly heldExtras: {
61
79
  readonly HorizontalLine: {
@@ -64,24 +82,23 @@ export declare const TOOL_TEMPLATE_RULES: {
64
82
  readonly HorizontalRay: {
65
83
  readonly highlight: true;
66
84
  };
67
- readonly LongPosition: {
68
- readonly lineWidth: 2;
69
- readonly lineStyle: "solid";
85
+ readonly FibonacciRetracement: {
86
+ readonly levelsOnLogScale: false;
70
87
  };
71
- readonly ShortPosition: {
72
- readonly lineWidth: 2;
73
- readonly lineStyle: "solid";
88
+ readonly FibonacciTrend: {
89
+ readonly levelsOnLogScale: false;
74
90
  };
75
91
  };
76
92
  /**
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.
93
+ * Style keys Save as default never keeps, and so neither does web's style memory (src/store/tool-style-memory.ts
94
+ * keeps the default lane): `rotation` is one placed drawing's geometry, and the position tools' financial inputs
95
+ * would carry one account's numbers into the next drawing. A template still carries them: it is applied on purpose,
96
+ * onto one drawing.
80
97
  */
81
98
  readonly defaultExcludedKeys: readonly ["rotation", "accountSize", "risk", "riskDisplayMode", "lotSize"];
82
99
  /**
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.
100
+ * Types whose Save as default keeps nothing, and so neither does web's style memory: an Image is placed by a dialog
101
+ * that owns its source and opacity at confirm time.
85
102
  */
86
103
  readonly defaultExcludedTypes: readonly ["Image"];
87
104
  };
@@ -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 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
  instanceKeys: ['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
+ instanceKeysByType: {
37
+ GhostFeed: ['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,24 +68,32 @@ export const TOOL_TEMPLATE_RULES = {
54
68
  intervalBoundTypes: ['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, the fib pair's log-scale levels), each with
72
+ * the default the engine seeds (titan's tool classes), so a template, a seed and Save as default see every key. A
73
+ * key belongs in the registry: an extra stays here only while the registry cannot carry it as the editors show it
74
+ * (the price label flag is the `highlight` field under a per-type label), or until the registry lists it (the fib
75
+ * pair's). A position's line width and style moved into the registry with chart-schema 0.5.1, and the generator
76
+ * refuses an extra the registry lists.
59
77
  */
60
78
  heldExtras: {
61
79
  HorizontalLine: { highlight: true },
62
80
  HorizontalRay: { highlight: true },
63
- LongPosition: { lineWidth: 2, lineStyle: 'solid' },
64
- ShortPosition: { lineWidth: 2, lineStyle: 'solid' },
81
+ // "Fib levels based on log scale" (feedback 1815): titan from 3dcd6689 (the release after 0.0.4-alpha.1211) spaces
82
+ // the levels in log10 of the price while it is on; chart-schema 0.8.0's FIB_STYLE does not list it yet, and the
83
+ // generator refuses these two once it does.
84
+ FibonacciRetracement: { levelsOnLogScale: false },
85
+ FibonacciTrend: { levelsOnLogScale: false },
65
86
  },
66
87
  /**
67
- * Style keys Save as default never keeps (web src/store/tool-style-memory.ts NON_STYLE_KEYS): `rotation` is one
68
- * placed drawing's geometry, and the position tools' financial inputs would carry one account's numbers into the
69
- * next drawing. A template still carries them: it is applied on purpose, onto one drawing.
88
+ * Style keys Save as default never keeps, and so neither does web's style memory (src/store/tool-style-memory.ts
89
+ * keeps the default lane): `rotation` is one placed drawing's geometry, and the position tools' financial inputs
90
+ * would carry one account's numbers into the next drawing. A template still carries them: it is applied on purpose,
91
+ * onto one drawing.
70
92
  */
71
93
  defaultExcludedKeys: ['rotation', 'accountSize', 'risk', 'riskDisplayMode', 'lotSize'],
72
94
  /**
73
- * Types whose Save as default keeps nothing (web src/store/tool-style-memory.ts NON_MEMORY_TOOL_TYPES): an Image is
74
- * placed by a dialog that owns its source and opacity at confirm time.
95
+ * Types whose Save as default keeps nothing, and so neither does web's style memory: an Image is placed by a dialog
96
+ * that owns its source and opacity at confirm time.
75
97
  */
76
98
  defaultExcludedTypes: ['Image'],
77
99
  };