gloomberb 0.20.7 → 0.20.8

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 (611) hide show
  1. package/README.ja.md +74 -0
  2. package/README.md +2 -0
  3. package/README.zh-CN.md +2 -0
  4. package/package.json +6 -1
  5. package/src/account/auth-model.ts +22 -0
  6. package/src/api-client/auth.ts +7 -2
  7. package/src/api-client/awards.ts +5 -0
  8. package/src/api-client/bond-trades.ts +22 -0
  9. package/src/api-client/catalysts.ts +11 -1
  10. package/src/api-client/data.ts +30 -6
  11. package/src/api-client/debt-maturities.ts +7 -0
  12. package/src/api-client/equity-screener.ts +17 -0
  13. package/src/api-client/errors.ts +2 -0
  14. package/src/api-client/exchange-announcements.ts +14 -7
  15. package/src/api-client/fund-facts.ts +21 -3
  16. package/src/api-client/futures-curve.ts +14 -1
  17. package/src/api-client/geo.ts +10 -0
  18. package/src/api-client/hiring.ts +2 -0
  19. package/src/api-client/index.ts +3 -0
  20. package/src/api-client/insider-signals.ts +14 -0
  21. package/src/api-client/members.ts +30 -2
  22. package/src/api-client/money-markets.ts +11 -1
  23. package/src/api-client/paths.ts +6 -1
  24. package/src/api-client/perps.ts +2 -0
  25. package/src/api-client/request.ts +2 -1
  26. package/src/api-client/socket.ts +7 -0
  27. package/src/api-client/types/econ.ts +2 -1
  28. package/src/api-client/types/filings-and-calls.ts +6 -0
  29. package/src/api-client/types/market.ts +4 -0
  30. package/src/api-client/web-experiments.ts +5 -6
  31. package/src/app/runtime/update.ts +2 -1
  32. package/src/architecture/floating-promise-allowlist.json +33 -106
  33. package/src/capabilities/asset-data-inputs.ts +183 -0
  34. package/src/capabilities/factories.ts +8 -2
  35. package/src/cli/base-converter.ts +36 -2
  36. package/src/cli/commands/api.ts +2 -2
  37. package/src/cli/commands/command-utils.ts +18 -0
  38. package/src/cli/commands/hong-kong-movers.ts +50 -0
  39. package/src/cli/commands/market.ts +539 -130
  40. package/src/cli/commands/options-chain.ts +7 -1
  41. package/src/cli/commands/overview.ts +74 -14
  42. package/src/cli/commands/plugins.ts +7 -6
  43. package/src/cli/commands/search.ts +52 -9
  44. package/src/cli/commands/system.ts +15 -10
  45. package/src/cli/commands/ticker.ts +97 -44
  46. package/src/cli/content-figures.ts +45 -0
  47. package/src/cli/context.ts +5 -0
  48. package/src/cli/desktop-pane-shot-routes.ts +13 -4
  49. package/src/cli/desktop-pane-shot.ts +86 -12
  50. package/src/cli/earnings-calendar.ts +36 -5
  51. package/src/cli/export-source.ts +17 -3
  52. package/src/cli/fx-pair.ts +111 -11
  53. package/src/cli/glossary.ts +36 -2
  54. package/src/cli/help.ts +1 -1
  55. package/src/cli/history-export.ts +29 -11
  56. package/src/cli/history-rows.ts +130 -21
  57. package/src/cli/index.ts +8 -5
  58. package/src/cli/known-gaps.ts +45 -1
  59. package/src/cli/listing-arg.ts +366 -19
  60. package/src/cli/pane-functions/capabilities.ts +2 -2
  61. package/src/cli/pane-functions/catalog.ts +105 -9
  62. package/src/cli/pane-functions/discovery.ts +2 -0
  63. package/src/cli/pane-functions/dom.ts +46 -9
  64. package/src/cli/pane-functions/freshness.ts +7 -3
  65. package/src/cli/pane-functions/function-help.ts +9 -6
  66. package/src/cli/pane-functions/headless.ts +77 -6
  67. package/src/cli/pane-functions/index.ts +141 -23
  68. package/src/cli/pane-functions/options.ts +1 -3
  69. package/src/cli/pane-functions/plugin-code.ts +169 -0
  70. package/src/cli/pane-functions/report.ts +10 -0
  71. package/src/cli/pane-functions/resolver.ts +69 -21
  72. package/src/cli/pane-functions/screenshot-assessment.ts +82 -3
  73. package/src/cli/pane-functions/screenshot-data-evidence.ts +3 -1
  74. package/src/cli/pane-functions/screenshot-types.ts +6 -0
  75. package/src/cli/quote-answer.ts +49 -2
  76. package/src/cli/registry.ts +42 -4
  77. package/src/cli/report-tables.ts +26 -6
  78. package/src/cli/result.ts +13 -2
  79. package/src/cli/series-search.ts +17 -7
  80. package/src/cli/statement-filings.ts +22 -8
  81. package/src/cli/symbol-args.ts +9 -0
  82. package/src/cli/ticker-resolution.ts +3 -2
  83. package/src/cli/unknown-command.ts +111 -14
  84. package/src/components/chart/composite/format.ts +15 -1
  85. package/src/components/chart/composite/legend.tsx +101 -47
  86. package/src/components/chart/composite/panel-labels.ts +4 -4
  87. package/src/components/chart/composite/panel-surface.tsx +4 -6
  88. package/src/components/chart/composite/scene/build.ts +180 -0
  89. package/src/components/chart/composite/scene/cursor.ts +226 -0
  90. package/src/components/chart/composite/scene/domain.ts +170 -0
  91. package/src/components/chart/composite/scene/markers.ts +115 -0
  92. package/src/components/chart/composite/scene/panels.ts +85 -0
  93. package/src/components/chart/composite/scene/points.ts +169 -0
  94. package/src/components/chart/composite/scene/projection.ts +105 -0
  95. package/src/components/chart/composite/scene/timeline.ts +71 -0
  96. package/src/components/chart/composite/scene.ts +12 -1066
  97. package/src/components/chart/composite/types.ts +4 -2
  98. package/src/components/chart/curve/model.ts +2 -2
  99. package/src/components/chart-table/axis.ts +18 -6
  100. package/src/components/command-bar/layout-items/focused-pane.ts +3 -0
  101. package/src/components/command-bar/list/model.ts +9 -0
  102. package/src/components/command-bar/pane-templates/items.ts +61 -15
  103. package/src/components/command-bar/pane-templates/workflow.ts +16 -5
  104. package/src/components/command-bar/routes/root/plugin-install.ts +7 -46
  105. package/src/components/command-bar/routes/root/provider-search.ts +8 -5
  106. package/src/components/command-bar/routes/root/results.ts +6 -1
  107. package/src/components/command-bar/routes/root/runtime.ts +1 -0
  108. package/src/components/command-bar/routes/root/shortcut-feedback.ts +4 -1
  109. package/src/components/command-bar/routes/ticker-search/actions.ts +7 -5
  110. package/src/components/command-bar/routes/ticker-search/results.ts +51 -3
  111. package/src/components/command-bar/view-model.ts +12 -0
  112. package/src/components/command-bar/workflow/ops.ts +21 -4
  113. package/src/components/command-bar/workflow/ticker-listing-picker.ts +3 -1
  114. package/src/components/command-bar/workflow/tickers.ts +6 -2
  115. package/src/components/data-table/view.tsx +46 -1
  116. package/src/components/form-modal/confirm.tsx +3 -2
  117. package/src/components/form-modal/content.tsx +3 -2
  118. package/src/components/form-modal/field-row.tsx +2 -0
  119. package/src/components/form-modal/host.tsx +18 -3
  120. package/src/components/form-modal/remote-reads.test-helpers.ts +34 -0
  121. package/src/components/index.ts +1 -1
  122. package/src/components/layout/pane/title.ts +21 -5
  123. package/src/components/layout/shell/pane/layers.tsx +20 -14
  124. package/src/components/layout/shell/pane-occlusion.ts +21 -0
  125. package/src/components/onboarding/desks-step.tsx +7 -1
  126. package/src/components/onboarding/onboarding-keyboard.ts +48 -6
  127. package/src/components/onboarding/onboarding-wizard.tsx +47 -8
  128. package/src/components/onboarding/portfolio-step/positions-panel.tsx +17 -3
  129. package/src/components/onboarding/use-onboarding-progress.ts +57 -14
  130. package/src/components/onboarding/wizard-positions.ts +2 -0
  131. package/src/components/paged-rows.ts +11 -5
  132. package/src/components/ticker/list-table-view.tsx +24 -5
  133. package/src/components/toggle-list.tsx +44 -1
  134. package/src/components/ui/data-table/opentui/index.tsx +7 -6
  135. package/src/components/ui/data-table/opentui/model.ts +7 -3
  136. package/src/components/ui/data-table/types.ts +13 -2
  137. package/src/components/ui/fields.tsx +16 -4
  138. package/src/components/ui/query-bar.tsx +43 -9
  139. package/src/components/ui/table-layout.ts +56 -2
  140. package/src/core/app-services.ts +7 -2
  141. package/src/core/connection-health.ts +26 -0
  142. package/src/core/state/app/layout.ts +12 -4
  143. package/src/data/config/layout.ts +3 -1
  144. package/src/data/config/store/node.ts +4 -2
  145. package/src/docs/snapshot.json +756 -216
  146. package/src/i18n/es.ts +4 -1
  147. package/src/i18n/ja.ts +4 -1
  148. package/src/i18n/ko.ts +4 -1
  149. package/src/i18n/zh-cn.ts +4 -1
  150. package/src/i18n/zh-tw.ts +4 -1
  151. package/src/layout/pane-follow.ts +1 -1
  152. package/src/layout/pane-manager/gridlock.ts +18 -5
  153. package/src/layout/pane-manager/index.ts +1 -0
  154. package/src/layout/pane-manager/transient.ts +56 -0
  155. package/src/layout-marketplace/gallery.tsx +2 -1
  156. package/src/layout-marketplace/model.ts +4 -10
  157. package/src/market-data/commodity-names.ts +24 -0
  158. package/src/market-data/connection-follow.ts +9 -7
  159. package/src/market-data/coordinator/auxiliary.ts +4 -3
  160. package/src/market-data/coordinator/entries.ts +22 -1
  161. package/src/market-data/coordinator/financials.ts +2 -3
  162. package/src/market-data/coordinator/index.ts +67 -12
  163. package/src/market-data/coordinator/quotes.ts +2 -3
  164. package/src/market-data/fund-facts.ts +7 -1
  165. package/src/market-data/futures-board.ts +38 -4
  166. package/src/market-data/futures-contract.ts +5 -2
  167. package/src/market-data/fx-closes.ts +4 -1
  168. package/src/market-data/market/bar-period.ts +15 -0
  169. package/src/market-data/market/format.ts +4 -2
  170. package/src/market-data/market/freshness.ts +4 -0
  171. package/src/market-data/market/status.ts +23 -3
  172. package/src/market-data/options-alternatives.ts +21 -9
  173. package/src/market-data/published-futures-sessions.ts +9 -0
  174. package/src/market-data/quotes/balance-sheet-rate.ts +34 -0
  175. package/src/market-data/quotes/delisting.ts +26 -2
  176. package/src/market-data/quotes/freshness.ts +62 -0
  177. package/src/market-data/quotes/listing-enterprise-value.ts +250 -19
  178. package/src/market-data/quotes/regular-session-valuation.ts +8 -0
  179. package/src/market-data/realized-volatility.ts +3 -1
  180. package/src/market-data/request-types.ts +2 -0
  181. package/src/market-data/selectors.ts +1 -0
  182. package/src/news/aggregator.ts +3 -3
  183. package/src/plugins/builtin/account-management/delete-account.ts +78 -0
  184. package/src/plugins/builtin/account-management/pane.tsx +22 -19
  185. package/src/plugins/builtin/account-management/password-dialog.tsx +75 -0
  186. package/src/plugins/builtin/alerts/alert-log.ts +3 -2
  187. package/src/plugins/builtin/alerts/cli-forms.ts +1 -1
  188. package/src/plugins/builtin/alerts/cli.ts +72 -4
  189. package/src/plugins/builtin/alerts/format.ts +8 -2
  190. package/src/plugins/builtin/alerts/index.tsx +8 -5
  191. package/src/plugins/builtin/alerts/pane.tsx +5 -3
  192. package/src/plugins/builtin/alerts/research-builder.ts +12 -0
  193. package/src/plugins/builtin/analytics/index.tsx +3 -3
  194. package/src/plugins/builtin/analytics/risk-client.ts +14 -3
  195. package/src/plugins/builtin/analytics/risk-pane.tsx +3 -3
  196. package/src/plugins/builtin/attention/pane.tsx +1 -1
  197. package/src/plugins/builtin/attention/trending.tsx +1 -1
  198. package/src/plugins/builtin/awards/detail.tsx +4 -1
  199. package/src/plugins/builtin/awards/headless.ts +7 -3
  200. package/src/plugins/builtin/awards/model.ts +11 -0
  201. package/src/plugins/builtin/awards/pane.tsx +12 -5
  202. package/src/plugins/builtin/backtest/client.ts +7 -2
  203. package/src/plugins/builtin/backtest/headless.ts +2 -1
  204. package/src/plugins/builtin/backtest/pane.tsx +4 -2
  205. package/src/plugins/builtin/bond-calculator/pane.tsx +1 -1
  206. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  207. package/src/plugins/builtin/broker-trading/orders.tsx +2 -2
  208. package/src/plugins/builtin/buildout/company/pane.tsx +1 -1
  209. package/src/plugins/builtin/buildout/model/index.ts +2 -2
  210. package/src/plugins/builtin/catalysts/headless.ts +9 -6
  211. package/src/plugins/builtin/catalysts/model.ts +72 -10
  212. package/src/plugins/builtin/catalysts/pane.tsx +10 -7
  213. package/src/plugins/builtin/cds/pane.tsx +5 -3
  214. package/src/plugins/builtin/central-bank-rates/pane.tsx +3 -2
  215. package/src/plugins/builtin/chart-composer/catalog-series.ts +59 -0
  216. package/src/plugins/builtin/chart-composer/headless-schema.ts +2 -1
  217. package/src/plugins/builtin/chart-composer/headless.ts +104 -23
  218. package/src/plugins/builtin/chart-composer/index.tsx +6 -3
  219. package/src/plugins/builtin/chart-composer/legend-names.ts +19 -0
  220. package/src/plugins/builtin/chart-composer/pane.tsx +37 -10
  221. package/src/plugins/builtin/chart-composer/presets.ts +63 -6
  222. package/src/plugins/builtin/chart-composer/roll-events.ts +38 -0
  223. package/src/plugins/builtin/chart-composer/series-catalog.ts +12 -5
  224. package/src/plugins/builtin/chart-composer/series-expression.ts +8 -4
  225. package/src/plugins/builtin/chart-composer/series-listings.ts +33 -9
  226. package/src/plugins/builtin/chart-composer/use-series-catalog.ts +2 -2
  227. package/src/plugins/builtin/clinical-trials/client.ts +13 -0
  228. package/src/plugins/builtin/clinical-trials/index.tsx +1 -1
  229. package/src/plugins/builtin/clinical-trials/pane.tsx +77 -27
  230. package/src/plugins/builtin/clinical-trials/search.ts +117 -0
  231. package/src/plugins/builtin/cloud/askg/conversation-store.ts +17 -6
  232. package/src/plugins/builtin/cloud/askg/lock-note.ts +4 -2
  233. package/src/plugins/builtin/cloud/askg/manifest.ts +3 -2
  234. package/src/plugins/builtin/cloud/askg/pane.tsx +2 -2
  235. package/src/plugins/builtin/cloud/askg/sources.ts +3 -3
  236. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +7 -3
  237. package/src/plugins/builtin/cloud/team/acm-tab.tsx +1 -1
  238. package/src/plugins/builtin/cloud/team/pane.tsx +17 -10
  239. package/src/plugins/builtin/cloud/team/views.ts +15 -3
  240. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +105 -16
  241. package/src/plugins/builtin/cloud/thesis/board-pane.tsx +17 -2
  242. package/src/plugins/builtin/cloud/thesis/module.tsx +3 -2
  243. package/src/plugins/builtin/cloud/thesis/store.ts +17 -3
  244. package/src/plugins/builtin/commodities-energy/index.tsx +35 -3
  245. package/src/plugins/builtin/commodity-balances/index.tsx +1 -1
  246. package/src/plugins/builtin/company-attention/app-rank.tsx +1 -1
  247. package/src/plugins/builtin/company-attention/building.tsx +1 -1
  248. package/src/plugins/builtin/company-attention/model.ts +2 -1
  249. package/src/plugins/builtin/company-attention/moves.tsx +1 -1
  250. package/src/plugins/builtin/company-attention/pane.tsx +1 -1
  251. package/src/plugins/builtin/company-attention/signals.tsx +1 -1
  252. package/src/plugins/builtin/company-kpis/pane.tsx +1 -1
  253. package/src/plugins/builtin/correlation/headless.ts +7 -5
  254. package/src/plugins/builtin/correlation/history.ts +17 -6
  255. package/src/plugins/builtin/correlation/index.tsx +1 -1
  256. package/src/plugins/builtin/correlation/relationship/history.ts +1 -1
  257. package/src/plugins/builtin/correlation/relationship/pane.tsx +1 -1
  258. package/src/plugins/builtin/cot/headless.ts +10 -3
  259. package/src/plugins/builtin/cot/pane.tsx +2 -2
  260. package/src/plugins/builtin/cpi/pane.tsx +1 -1
  261. package/src/plugins/builtin/credit-boards/model.ts +1 -1
  262. package/src/plugins/builtin/credit-documents/pane.tsx +1 -1
  263. package/src/plugins/builtin/crypto-board/defi-view.tsx +2 -2
  264. package/src/plugins/builtin/crypto-board/defi.ts +9 -3
  265. package/src/plugins/builtin/crypto-board/headless.ts +19 -10
  266. package/src/plugins/builtin/crypto-board/model.ts +8 -0
  267. package/src/plugins/builtin/crypto-board/pane.tsx +11 -5
  268. package/src/plugins/builtin/crypto-board/series.ts +17 -3
  269. package/src/plugins/builtin/crypto-board/supply.ts +26 -3
  270. package/src/plugins/builtin/crypto-etf-flows/headless.ts +3 -2
  271. package/src/plugins/builtin/crypto-etf-flows/model.ts +13 -3
  272. package/src/plugins/builtin/crypto-etf-flows/pane.tsx +6 -3
  273. package/src/plugins/builtin/custom-view/pane.tsx +5 -5
  274. package/src/plugins/builtin/debt-maturities/client.ts +5 -0
  275. package/src/plugins/builtin/debt-maturities/headless.ts +3 -1
  276. package/src/plugins/builtin/debt-maturities/model.ts +1 -0
  277. package/src/plugins/builtin/debt-maturities/pane.tsx +1 -1
  278. package/src/plugins/builtin/dividend-yield/pane.tsx +1 -1
  279. package/src/plugins/builtin/doe/model.ts +1 -1
  280. package/src/plugins/builtin/doe/pane.tsx +1 -1
  281. package/src/plugins/builtin/earnings/board.tsx +2 -2
  282. package/src/plugins/builtin/earnings/history.tsx +1 -1
  283. package/src/plugins/builtin/earnings-calls/calendar.tsx +1 -1
  284. package/src/plugins/builtin/earnings-calls/data.ts +2 -1
  285. package/src/plugins/builtin/earnings-calls/headless.ts +15 -0
  286. package/src/plugins/builtin/earnings-calls/model.ts +68 -8
  287. package/src/plugins/builtin/earnings-calls/pane.tsx +29 -8
  288. package/src/plugins/builtin/earnings-calls/transcript-view.tsx +32 -2
  289. package/src/plugins/builtin/earnings-ripple/pane.tsx +1 -1
  290. package/src/plugins/builtin/econ/calendar-model.ts +94 -2
  291. package/src/plugins/builtin/econ/detail-view.tsx +15 -11
  292. package/src/plugins/builtin/econ/index.tsx +25 -9
  293. package/src/plugins/builtin/econ/types.ts +4 -1
  294. package/src/plugins/builtin/equity-screener/headless.ts +23 -7
  295. package/src/plugins/builtin/equity-screener/index.tsx +3 -0
  296. package/src/plugins/builtin/equity-screener/live.ts +39 -12
  297. package/src/plugins/builtin/equity-screener/model.ts +86 -5
  298. package/src/plugins/builtin/equity-screener/pane.tsx +20 -21
  299. package/src/plugins/builtin/equity-screener/results.ts +12 -3
  300. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -2
  301. package/src/plugins/builtin/estimate-revisions/pane.tsx +2 -2
  302. package/src/plugins/builtin/executives/pane.tsx +2 -2
  303. package/src/plugins/builtin/exposure/pane.tsx +1 -1
  304. package/src/plugins/builtin/fear-greed/data.ts +3 -1
  305. package/src/plugins/builtin/fear-greed/headless.ts +8 -2
  306. package/src/plugins/builtin/fear-greed/pane.tsx +8 -4
  307. package/src/plugins/builtin/filing-events/pane.tsx +1 -1
  308. package/src/plugins/builtin/futures/index.tsx +5 -4
  309. package/src/plugins/builtin/futures/model.ts +17 -9
  310. package/src/plugins/builtin/futures/returns.ts +2 -0
  311. package/src/plugins/builtin/futures/series.ts +44 -8
  312. package/src/plugins/builtin/futures/table.tsx +3 -3
  313. package/src/plugins/builtin/futures-curve/client.ts +1 -0
  314. package/src/plugins/builtin/futures-curve/headless.ts +14 -12
  315. package/src/plugins/builtin/futures-curve/index.tsx +7 -4
  316. package/src/plugins/builtin/futures-curve/model.ts +93 -7
  317. package/src/plugins/builtin/futures-curve/pane.tsx +18 -7
  318. package/src/plugins/builtin/fx-matrix/amount.ts +2 -1
  319. package/src/plugins/builtin/fx-matrix/index.tsx +9 -0
  320. package/src/plugins/builtin/gpu/changes.tsx +1 -1
  321. package/src/plugins/builtin/gpu/equities.tsx +1 -1
  322. package/src/plugins/builtin/gpu/pane.tsx +2 -2
  323. package/src/plugins/builtin/help/function-card.tsx +4 -2
  324. package/src/plugins/builtin/help/function-index.ts +12 -6
  325. package/src/plugins/builtin/help/index.tsx +1 -1
  326. package/src/plugins/builtin/holders/beneficial-view.tsx +1 -1
  327. package/src/plugins/builtin/holders/pane.tsx +1 -1
  328. package/src/plugins/builtin/insider/base-values.ts +55 -0
  329. package/src/plugins/builtin/insider/headless.ts +307 -83
  330. package/src/plugins/builtin/insider/index.tsx +65 -23
  331. package/src/plugins/builtin/insider/insiders.tsx +26 -16
  332. package/src/plugins/builtin/insider/model.ts +2 -2
  333. package/src/plugins/builtin/insider/signals-cells.tsx +4 -1
  334. package/src/plugins/builtin/insider/signals-model.ts +13 -5
  335. package/src/plugins/builtin/insider/signals.tsx +5 -3
  336. package/src/plugins/builtin/insider/tickers.tsx +466 -0
  337. package/src/plugins/builtin/ipo-calendar/pane.tsx +1 -1
  338. package/src/plugins/builtin/iv-history/client.ts +35 -4
  339. package/src/plugins/builtin/iv-history/headless.ts +10 -4
  340. package/src/plugins/builtin/iv-history/model.ts +85 -16
  341. package/src/plugins/builtin/iv-history/pane.tsx +2 -2
  342. package/src/plugins/builtin/iv-history/screen-pane.tsx +6 -3
  343. package/src/plugins/builtin/jobs/pane.tsx +5 -5
  344. package/src/plugins/builtin/macro-day/pane.tsx +1 -1
  345. package/src/plugins/builtin/macro-day/release-table.ts +5 -5
  346. package/src/plugins/builtin/macro-day/releases.ts +11 -9
  347. package/src/plugins/builtin/market-movers/headless.ts +6 -2
  348. package/src/plugins/builtin/market-movers/screener.ts +18 -4
  349. package/src/plugins/builtin/members/breadth-pane.tsx +3 -3
  350. package/src/plugins/builtin/members/client.ts +24 -2
  351. package/src/plugins/builtin/members/headless.ts +66 -9
  352. package/src/plugins/builtin/members/index.tsx +7 -6
  353. package/src/plugins/builtin/members/model.ts +89 -5
  354. package/src/plugins/builtin/members/pane.tsx +70 -21
  355. package/src/plugins/builtin/mna/distress/pane.tsx +2 -1
  356. package/src/plugins/builtin/mna/pane.tsx +1 -1
  357. package/src/plugins/builtin/money-markets/client.ts +43 -15
  358. package/src/plugins/builtin/money-markets/headless.ts +18 -11
  359. package/src/plugins/builtin/money-markets/index.tsx +7 -6
  360. package/src/plugins/builtin/money-markets/model.ts +20 -5
  361. package/src/plugins/builtin/money-markets/pane.tsx +28 -17
  362. package/src/plugins/builtin/news/wire/news/footer.ts +11 -1
  363. package/src/plugins/builtin/news/wire/news/table.tsx +15 -5
  364. package/src/plugins/builtin/notes/headless.ts +94 -0
  365. package/src/plugins/builtin/notes/index.tsx +3 -1
  366. package/src/plugins/builtin/notes/store.ts +10 -3
  367. package/src/plugins/builtin/options/footer.ts +8 -2
  368. package/src/plugins/builtin/options/open-interest-as-of.ts +12 -3
  369. package/src/plugins/builtin/options/view.tsx +10 -1
  370. package/src/plugins/builtin/options-calculator/pane.tsx +1 -1
  371. package/src/plugins/builtin/options-positioning/client.ts +35 -8
  372. package/src/plugins/builtin/options-positioning/headless.ts +17 -7
  373. package/src/plugins/builtin/options-positioning/index.tsx +10 -0
  374. package/src/plugins/builtin/options-positioning/pane.tsx +16 -7
  375. package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +1 -1
  376. package/src/plugins/builtin/options-scenario/pane.tsx +1 -1
  377. package/src/plugins/builtin/pe-band/pane.tsx +2 -2
  378. package/src/plugins/builtin/perps/cascade-tabs.tsx +2 -2
  379. package/src/plugins/builtin/perps/client.ts +54 -15
  380. package/src/plugins/builtin/perps/headless.ts +39 -13
  381. package/src/plugins/builtin/perps/index.tsx +2 -1
  382. package/src/plugins/builtin/perps/model.ts +43 -1
  383. package/src/plugins/builtin/perps/pane.tsx +35 -18
  384. package/src/plugins/builtin/portfolio-list/allocation-rows.ts +74 -0
  385. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  386. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +7 -3
  387. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +33 -3
  388. package/src/plugins/builtin/portfolio-list/cli/render.ts +149 -24
  389. package/src/plugins/builtin/portfolio-list/headless.ts +30 -9
  390. package/src/plugins/builtin/portfolio-list/income.ts +17 -8
  391. package/src/plugins/builtin/portfolio-list/index.tsx +4 -4
  392. package/src/plugins/builtin/portfolio-list/pane/fx-day-moves.ts +52 -0
  393. package/src/plugins/builtin/portfolio-list/pane/index.tsx +76 -9
  394. package/src/plugins/builtin/portfolio-list/pane/target-weights.tsx +178 -0
  395. package/src/plugins/builtin/portfolio-list/period-pnl.ts +44 -5
  396. package/src/plugins/builtin/portfolio-list/settings.ts +12 -6
  397. package/src/plugins/builtin/portfolio-list/summary/index.tsx +9 -4
  398. package/src/plugins/builtin/portfolio-list/summary/totals.ts +21 -2
  399. package/src/plugins/builtin/portfolio-list/table.tsx +33 -25
  400. package/src/plugins/builtin/power/gas.tsx +2 -2
  401. package/src/plugins/builtin/power/prices.tsx +2 -2
  402. package/src/plugins/builtin/primary-dealers/pane.tsx +10 -11
  403. package/src/plugins/builtin/rate-path/model.ts +9 -0
  404. package/src/plugins/builtin/rate-path/pane.tsx +6 -5
  405. package/src/plugins/builtin/realized-vol/fx-proxy.ts +27 -0
  406. package/src/plugins/builtin/realized-vol/headless.ts +8 -6
  407. package/src/plugins/builtin/realized-vol/pane.tsx +13 -7
  408. package/src/plugins/builtin/relative-rotation/pane.tsx +1 -1
  409. package/src/plugins/builtin/research/analyst-headless.ts +5 -1
  410. package/src/plugins/builtin/research/analyst-model.ts +7 -1
  411. package/src/plugins/builtin/research/analyst-pane.tsx +1 -1
  412. package/src/plugins/builtin/research/relative-valuation-basis.ts +44 -4
  413. package/src/plugins/builtin/research/relative-valuation-headless.ts +59 -14
  414. package/src/plugins/builtin/research/relative-valuation-model.ts +65 -26
  415. package/src/plugins/builtin/research/relative-valuation-pane.tsx +42 -17
  416. package/src/plugins/builtin/revenue-breakdown/pane.tsx +1 -1
  417. package/src/plugins/builtin/reverse-dcf/client.ts +34 -4
  418. package/src/plugins/builtin/reverse-dcf/headless.ts +30 -15
  419. package/src/plugins/builtin/reverse-dcf/model.ts +190 -29
  420. package/src/plugins/builtin/reverse-dcf/pane.tsx +35 -13
  421. package/src/plugins/builtin/risk-factors/pane.tsx +2 -2
  422. package/src/plugins/builtin/roadmap/pane.tsx +2 -2
  423. package/src/plugins/builtin/scanner/flow-pane.tsx +4 -4
  424. package/src/plugins/builtin/scanner/headless.ts +15 -1
  425. package/src/plugins/builtin/seasonality/pane.tsx +1 -1
  426. package/src/plugins/builtin/sec/fund-facts-view.tsx +5 -2
  427. package/src/plugins/builtin/sec/fund-facts.ts +41 -1
  428. package/src/plugins/builtin/sec/headless.ts +8 -4
  429. package/src/plugins/builtin/sec/index.tsx +41 -13
  430. package/src/plugins/builtin/shared/ticker-company.ts +111 -0
  431. package/src/plugins/builtin/shared/use-quote-board.ts +37 -2
  432. package/src/plugins/builtin/shared/volatility/live-session.ts +23 -0
  433. package/src/plugins/builtin/shared/volatility-indices.ts +2 -0
  434. package/src/plugins/builtin/short-interest/publications-pane.tsx +1 -1
  435. package/src/plugins/builtin/short-volume/pane.tsx +1 -1
  436. package/src/plugins/builtin/social-mentions/outliers.tsx +3 -3
  437. package/src/plugins/builtin/social-mentions/pane.tsx +2 -2
  438. package/src/plugins/builtin/supply-chain/graph-pane.tsx +1 -1
  439. package/src/plugins/builtin/supply-chain/pane.tsx +1 -1
  440. package/src/plugins/builtin/themes/pane.tsx +4 -4
  441. package/src/plugins/builtin/thirteenf/api.ts +1 -0
  442. package/src/plugins/builtin/thirteenf/format.ts +5 -0
  443. package/src/plugins/builtin/thirteenf/headless.ts +2 -2
  444. package/src/plugins/builtin/thirteenf/model.ts +128 -5
  445. package/src/plugins/builtin/thirteenf/overlap-pane.tsx +1 -1
  446. package/src/plugins/builtin/thirteenf/report-notes.ts +10 -3
  447. package/src/plugins/builtin/thirteenf/signals-pane.tsx +1 -1
  448. package/src/plugins/builtin/thirteenf/table.ts +2 -2
  449. package/src/plugins/builtin/thirteenf/types.ts +12 -0
  450. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +27 -14
  451. package/src/plugins/builtin/ticker-detail/data-panes/returns-history.ts +6 -3
  452. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +14 -0
  453. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +4 -1
  454. package/src/plugins/builtin/ticker-detail/financials/aggregation.ts +87 -19
  455. package/src/plugins/builtin/ticker-detail/financials/exchange-results.ts +54 -0
  456. package/src/plugins/builtin/ticker-detail/financials/model.ts +114 -9
  457. package/src/plugins/builtin/ticker-detail/financials/ratios.ts +37 -20
  458. package/src/plugins/builtin/ticker-detail/financials/tab.tsx +42 -19
  459. package/src/plugins/builtin/ticker-detail/headless-schema.ts +3 -2
  460. package/src/plugins/builtin/ticker-detail/headless.ts +90 -31
  461. package/src/plugins/builtin/ticker-detail/overview/model.ts +22 -15
  462. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +5 -2
  463. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +12 -7
  464. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +21 -0
  465. package/src/plugins/builtin/trace-bonds/client.ts +107 -10
  466. package/src/plugins/builtin/trace-bonds/detail.tsx +1 -1
  467. package/src/plugins/builtin/trace-bonds/headless.ts +20 -5
  468. package/src/plugins/builtin/trace-bonds/pane.tsx +15 -4
  469. package/src/plugins/builtin/treasury-auctions/hk-view.tsx +1 -1
  470. package/src/plugins/builtin/treasury-auctions/pane.tsx +1 -1
  471. package/src/plugins/builtin/treasury-daily/pane.tsx +2 -2
  472. package/src/plugins/builtin/vol-surface/charts.tsx +30 -5
  473. package/src/plugins/builtin/vol-surface/client.ts +40 -12
  474. package/src/plugins/builtin/vol-surface/events.ts +213 -0
  475. package/src/plugins/builtin/vol-surface/headless.ts +82 -13
  476. package/src/plugins/builtin/vol-surface/index.tsx +5 -1
  477. package/src/plugins/builtin/vol-surface/model.ts +42 -6
  478. package/src/plugins/builtin/vol-surface/pane.tsx +95 -23
  479. package/src/plugins/builtin/volatility/dvol.ts +14 -2
  480. package/src/plugins/builtin/volatility/headless.ts +3 -2
  481. package/src/plugins/builtin/volatility/index.tsx +1 -1
  482. package/src/plugins/builtin/volatility/pane.tsx +1 -1
  483. package/src/plugins/builtin/volatility/series.ts +7 -3
  484. package/src/plugins/builtin/world-venue-map/activity-series.ts +89 -0
  485. package/src/plugins/builtin/world-venue-map/chokepoint-report.ts +123 -0
  486. package/src/plugins/builtin/world-venue-map/evidence.ts +2 -0
  487. package/src/plugins/builtin/world-venue-map/geo-series.ts +35 -1
  488. package/src/plugins/builtin/world-venue-map/headless.ts +58 -9
  489. package/src/plugins/builtin/world-venue-map/index.ts +6 -3
  490. package/src/plugins/builtin/world-venue-map/layered-pane.tsx +6 -1
  491. package/src/plugins/builtin/world-venue-map/pane.tsx +4 -3
  492. package/src/plugins/builtin/yield-curve/index.tsx +12 -10
  493. package/src/plugins/builtin/yield-curve/swaps.tsx +1 -1
  494. package/src/plugins/extracted-plugins.ts +14 -10
  495. package/src/plugins/installer.ts +17 -1
  496. package/src/plugins/marketplace/feed.ts +14 -0
  497. package/src/plugins/marketplace/install-offer.ts +64 -0
  498. package/src/plugins/registry/contributions.ts +46 -8
  499. package/src/plugins/registry/index.ts +5 -0
  500. package/src/portfolio/collection-name.ts +38 -4
  501. package/src/portfolio/column-values.ts +32 -4
  502. package/src/portfolio/period-pnl.ts +4 -2
  503. package/src/react/async-resource.ts +24 -8
  504. package/src/remote/endpoint.ts +38 -12
  505. package/src/remote/secrets.ts +22 -6
  506. package/src/remote/server.ts +20 -4
  507. package/src/renderers/dom/data-table/index.tsx +2 -1
  508. package/src/renderers/dom/data-table/row.tsx +49 -7
  509. package/src/renderers/dom/desktop/controls.tsx +2 -0
  510. package/src/renderers/dom/desktop/query-bar.tsx +57 -7
  511. package/src/renderers/dom/host/surface-3d.tsx +46 -5
  512. package/src/renderers/dom/styles.css +17 -0
  513. package/src/renderers/electrobun/view/backend-rpc.ts +15 -21
  514. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +16 -61
  515. package/src/renderers/electrobun/view/cli-pane-shot-socket.ts +134 -0
  516. package/src/renderers/electrobun/view/host-route.ts +119 -0
  517. package/src/renderers/electrobun/view/rpc-timeout.ts +6 -5
  518. package/src/renderers/opentui/toast-host.tsx +6 -3
  519. package/src/renderers/opentui/ui-host.tsx +29 -5
  520. package/src/series/registry.ts +1 -0
  521. package/src/series/standalone-catalog.ts +40 -0
  522. package/src/series/types.ts +10 -0
  523. package/src/series/validate.ts +5 -0
  524. package/src/shares/portable-layout.ts +2 -7
  525. package/src/sources/gloomberb-cloud/dated-chunks.ts +133 -0
  526. package/src/sources/gloomberb-cloud/index.ts +46 -5
  527. package/src/sources/gloomberb-cloud/news.ts +15 -9
  528. package/src/sources/gloomberb-cloud/normalizers.ts +17 -0
  529. package/src/sources/history-coverage.ts +13 -0
  530. package/src/sources/history-result.ts +1 -0
  531. package/src/sources/provider-errors.ts +9 -0
  532. package/src/sources/provider-router/batches.ts +7 -3
  533. package/src/sources/provider-router/financial-routes.ts +3 -1
  534. package/src/sources/provider-router/history.ts +6 -4
  535. package/src/sources/provider-router/index.ts +5 -1
  536. package/src/sources/provider-router/primary.ts +4 -3
  537. package/src/sources/provider-router/retrieved-at.ts +12 -0
  538. package/src/team/store.ts +17 -4
  539. package/src/telemetry/crash-reports.ts +3 -1
  540. package/src/test-support/cli-context.ts +3 -2
  541. package/src/test-support/test-env.ts +7 -0
  542. package/src/theme/themes.ts +16 -9
  543. package/src/theme/tone-contrast.ts +29 -5
  544. package/src/tickers/company-name-listing.ts +31 -3
  545. package/src/tickers/company-name.ts +9 -0
  546. package/src/tickers/index-roots.ts +56 -4
  547. package/src/tickers/listing-name.ts +7 -2
  548. package/src/tickers/listing-venues.ts +17 -2
  549. package/src/tickers/search/home-listing.ts +2 -0
  550. package/src/tickers/search/index.ts +64 -11
  551. package/src/tickers/search/major-listings.json +595 -592
  552. package/src/tickers/search/ranking.ts +19 -1
  553. package/src/tickers/terminal-codes.ts +5 -3
  554. package/src/time-series/bar-aggregation.ts +3 -2
  555. package/src/time-series/base-series.ts +18 -1
  556. package/src/time-series/chart-data.ts +9 -6
  557. package/src/time-series/chart-seed.ts +11 -3
  558. package/src/time-series/currency-conversion.ts +1 -0
  559. package/src/time-series/date-window.ts +8 -0
  560. package/src/time-series/formula-months.ts +57 -0
  561. package/src/time-series/fundamentals/period-points.ts +3 -3
  562. package/src/time-series/fundamentals/source-statements.ts +5 -4
  563. package/src/time-series/leverage.ts +12 -4
  564. package/src/time-series/live-bars.ts +12 -7
  565. package/src/time-series/live-quotes.ts +6 -2
  566. package/src/time-series/market.ts +10 -3
  567. package/src/time-series/price-comparison.ts +106 -0
  568. package/src/time-series/range.ts +10 -0
  569. package/src/time-series/resolve-context.ts +7 -2
  570. package/src/time-series/resolve.ts +61 -5
  571. package/src/time-series/series-name.ts +2 -2
  572. package/src/time-series/series-presentation.ts +91 -2
  573. package/src/time-series/session-bar.ts +13 -7
  574. package/src/time-series/spec.ts +21 -2
  575. package/src/time-series/studies/formula.ts +262 -36
  576. package/src/time-series/studies/leverage.ts +9 -3
  577. package/src/time-series/studies/resolve.ts +7 -2
  578. package/src/time-series/types.ts +34 -0
  579. package/src/time-series/use-chart-resolution.ts +18 -1
  580. package/src/types/data-provider.ts +7 -0
  581. package/src/types/financials.ts +103 -1
  582. package/src/types/headless.ts +64 -3
  583. package/src/types/instrument.ts +6 -0
  584. package/src/types/plugin-context.ts +9 -0
  585. package/src/types/plugin-pane-templates.ts +6 -0
  586. package/src/types/plugin-panes.ts +7 -0
  587. package/src/types/price-history.ts +6 -0
  588. package/src/ui/host.tsx +3 -1
  589. package/src/ui/index.tsx +7 -2
  590. package/src/utils/cli-output.ts +21 -1
  591. package/src/utils/currency-units.ts +14 -0
  592. package/src/utils/datetime-format.ts +11 -0
  593. package/src/utils/exchange-announcements.ts +26 -3
  594. package/src/utils/exchange-notation.generated.ts +3 -4
  595. package/src/utils/exchange-results.ts +144 -0
  596. package/src/utils/exchanges.ts +10 -0
  597. package/src/utils/financial-statements.ts +212 -22
  598. package/src/utils/fire-and-forget.ts +1 -1
  599. package/src/utils/fiscal-period.ts +41 -3
  600. package/src/utils/format.ts +10 -6
  601. package/src/utils/fundamentals.ts +179 -12
  602. package/src/utils/futures-generic.ts +26 -0
  603. package/src/utils/lease-liabilities.ts +15 -5
  604. package/src/utils/lookup-token.ts +22 -0
  605. package/src/utils/max-drawdown.ts +25 -4
  606. package/src/utils/price-history-integrity.ts +56 -8
  607. package/src/utils/price-history.ts +6 -2
  608. package/src/utils/price-window.ts +38 -2
  609. package/src/utils/replace-file.ts +47 -0
  610. package/src/utils/rpc-timeout-error.ts +16 -2
  611. package/src/utils/untrusted-text.ts +14 -0
@@ -6,9 +6,8 @@ import { priceHistoryIntegrityNotices, chartPriceHistoryIntegrityNotices } from
6
6
  import type { HeadlessPaneContext, HeadlessPaneDefinition, HeadlessPaneFreshness, HeadlessSeries, HeadlessSeriesResult } from "../../../types/headless";
7
7
  import type { CapabilitySeriesSource, ChartResolutionResult, ChartSeriesSource, ChartSeriesSpec, ChartSpec, ChartViewportSpec, ResolvedSeries } from "../../../time-series/types";
8
8
  import { resolveGeoChartSeries } from "../world-venue-map/geo-series";
9
- import { CHART_FIELD_IDS, GEO_SERIES_CAPABILITY_ID, parseSeriesExpression } from "./series-expression";
10
- import { buildSeriesSpec } from "./chart-spec-edit";
11
- import { getSharedRegistry } from "../../registry";
9
+ import { GEO_SERIES_CAPABILITY_ID, parseSeriesExpression } from "./series-expression";
10
+ import { bareCatalogCandidate, registryCatalogLookups, withCatalogLabel, type CatalogSeriesLookups } from "./catalog-series";
12
11
  import { notATickerSymbol } from "../../../sources/provider-errors";
13
12
  import { resolveChartSpecData } from "../../../time-series/resolve";
14
13
  import { mergePriceHistoryWindows, priceHistoryAcquisitionIdentity, priceHistoryTailAcquisition } from "../../../time-series/history-acquisition";
@@ -25,6 +24,7 @@ import type { ChartResolution } from "../../../time-series/range";
25
24
  import { intradaySessionDates, intradaySessionTimeZone, loadIntradayWindow, resolveIntradayRequest, type IntradayRequest, type IntradayWindow, type LoadedIntradayWindow } from "./session-history";
26
25
  import { sessionRangeReport, usBarCoverageNotice } from "./session-range";
27
26
  import { createSnapshotDataProvider, snapshotInstrumentKey, type SnapshotMarketData } from "../../../market-data/snapshot-provider";
27
+ import type { DataProvider } from "../../../types/data-provider";
28
28
  import type { InstrumentRef } from "../../../market-data/request-types";
29
29
  import type { HistorySession } from "../../../types/price-history";
30
30
  import type { TickerFinancials, PricePoint, Quote } from "../../../types/financials";
@@ -32,6 +32,7 @@ import { chartQuoteOverrideKeyForTarget, getLiveChartQuoteTargets } from "../../
32
32
  import { createChartSeriesResolver } from "../../../capabilities";
33
33
  import { uncoveredCapabilityMessage } from "../../../capabilities/chart-series";
34
34
  import { loadFuturesContractTerms, loadFuturesPriceUnit } from "../../../market-data/futures-contract";
35
+ import { formulaContractNote, formulaRollNote } from "../../../time-series/studies/formula";
35
36
  import { loadDailyFxCloses } from "../../../time-series/currency-conversion";
36
37
  import { canonicalExchange, isKnownExchangeCode, isUsListingExchange, parsePublicTickerKey, publicTickerKey } from "../../../utils/exchanges";
37
38
  import { zonedDateKey, zonedDateTimeParts } from "../../../utils/zoned-date-time";
@@ -46,6 +47,7 @@ import { paneSchemas } from "./headless-schema";
46
47
  import { barHistoryFreshness, DAILY_CLOSES, quoteObservation, REPORTED_DATA } from "../shared/report-freshness";
47
48
  import type { BarPeriodToDate } from "../../../market-data/market/bar-period";
48
49
  import { closedHistoryBarDay, formingHistoryBar } from "../ticker-detail/data-panes/history-bars";
50
+ import { quoteTradingDay } from "../../../market-data/quotes/day-range";
49
51
  import { inferSeriesFrequency } from "../../../series/csv";
50
52
  import { isDatasetChart } from "../../../time-series/spec";
51
53
  import { loadFundFacts } from "../sec/fund-facts";
@@ -266,7 +268,14 @@ export async function loadChartPaneModel(
266
268
  ...(valuationPriceIssues.length ? { valuationPriceIssues } : {}),
267
269
  ...(periodCoverage.length ? { periodCoverage } : {}),
268
270
  notices: [...chart.coverageNotices ?? [], ...chart.returnBasisNotice ? [chart.returnBasisNotice] : [], ...chart.warnings.filter((warning) => warning === FINANCIAL_VINTAGE_NOTICE || warning === SEC_EPS_BASIS_NOTICE || warning === chart.priceComparison?.notice
269
- || chart.delistings?.some((delisting) => delisting.notice === warning)), ...integrityNotices],
271
+ || warning === chart.splitNotice || chart.delistings?.some((delisting) => delisting.notice === warning)), ...integrityNotices,
272
+ // A futures formula says which months its legs are in and when they rolled, as `history` says a front month's rolls.
273
+ ...chart.series.flatMap((series) => {
274
+ if (!series.formulaLegs) return [];
275
+ const roll = formulaRollNote(series);
276
+ const months = formulaContractNote(series);
277
+ return roll || months ? [`${series.label}: ${[roll, months].filter(Boolean).join("; ")}${months ? "" : "."}`] : [];
278
+ })],
270
279
  priceComparison: chart.priceComparison ?? null,
271
280
  summaries: chart.series.filter((series) => !series.profile).map((series) => ({ id: series.id, ...summarizeResolvedSeries(series) })),
272
281
  },
@@ -488,6 +497,20 @@ function newestBar(entry: HeadlessSeries & Partial<Pick<ResolvedSeries, "history
488
497
  return { day: new Date(time).toISOString().slice(0, 10), venue: entry.timeBasis?.exchange || entry.listing?.exchange || undefined };
489
498
  }
490
499
 
500
+ /**
501
+ * A series whose newest weekly or monthly bar is still forming, with the day
502
+ * its latest value is from (`latestDate`): the trading day of the quote the
503
+ * bar ends on. As it was for any other series, or with no such quote.
504
+ */
505
+ function withLatestQuoteDay(series: HeadlessSeries, quote: Quote | undefined): HeadlessSeries {
506
+ const entry = series as HeadlessSeries & Partial<Pick<ResolvedSeries, "historyResolution" | "timeBasis" | "listing">>;
507
+ const bar = newestBar(entry);
508
+ if (!quote || !bar || (entry.historyResolution !== "1wk" && entry.historyResolution !== "1mo")) return series;
509
+ if (!formingHistoryBar(entry.historyResolution, bar.day, bar.venue, Date.now())) return series;
510
+ const day = quoteTradingDay(quote) ?? (Number.isFinite(quote.lastUpdated) ? new Date(quote.lastUpdated).toISOString().slice(0, 10) : null);
511
+ return day && day >= bar.day ? { ...series, latestDate: day } : series;
512
+ }
513
+
491
514
  /**
492
515
  * The day the newest complete daily, weekly or monthly bar of the chart closed
493
516
  * on, the latest across its series: a week of bars dated Mon 12 Oct 2026 is
@@ -688,22 +711,50 @@ export async function bareCatalogSeries(
688
711
  readListing: () => Promise<unknown>,
689
712
  context: Pick<HeadlessPaneContext, "marketData" | "catalogSeriesName" | "catalogSeriesNamed">,
690
713
  ): Promise<ChartSeriesSpec | null> {
691
- const { source } = series;
692
- if (source.kind !== "security" || source.instrument.exchange || source.instrument.instrument || source.fieldId !== CHART_FIELD_IDS.price) return null;
693
- const id = source.instrument.symbol.trim().toUpperCase();
694
- const expression = `FRED:${id}`;
695
- const fredLabel = /^[A-Z0-9]+$/.test(id)
696
- ? context.catalogSeriesName?.(expression) ?? getSharedRegistry()?.series?.findByExpression(expression)?.definition.name
697
- : undefined;
698
- const named = fredLabel ? undefined : context.catalogSeriesNamed?.(id);
699
- const parsed = named ? parseSeriesExpression(named.expression) : null;
700
- const label = fredLabel ?? (parsed ? named?.name : undefined);
701
- if (!label || await readListing()) return null;
714
+ const catalog = bareCatalogCandidate(series, headlessCatalogLookups(context));
715
+ if (!catalog || series.source.kind !== "security" || await readListing()) return null;
716
+ const id = series.source.instrument.symbol.trim().toUpperCase();
702
717
  const failure = await Promise.resolve().then(() => context.marketData.getQuote(id, ""))
703
718
  .then((quote) => quote ? null : `Not a ticker: ${id}.`, (error: unknown) => error instanceof Error ? error.message : String(error));
704
- if (!failure || !notATickerSymbol(failure)) return null;
705
- const spec = parsed ? buildSeriesSpec({ ...parsed, label }, 0) : buildSeriesSpec({ kind: "economic", provider: "fred", seriesId: id, label }, 0);
706
- return { ...spec, id: series.id, transform: series.transform, axis: series.axis, panelId: series.panelId };
719
+ return failure && notATickerSymbol(failure) ? catalog : null;
720
+ }
721
+
722
+ /** The catalog `fn` reads, the app's registry before it where one is loaded, as the pane reads it (registryCatalogLookups). */
723
+ function headlessCatalogLookups(context: Pick<HeadlessPaneContext, "catalogSeriesName" | "catalogSeriesNamed">): CatalogSeriesLookups {
724
+ const registry = registryCatalogLookups();
725
+ return {
726
+ catalogSeriesName: (expression) => context.catalogSeriesName?.(expression) ?? registry.catalogSeriesName?.(expression),
727
+ catalogSeriesNamed: (word) => context.catalogSeriesNamed?.(word) ?? registry.catalogSeriesNamed?.(word),
728
+ };
729
+ }
730
+
731
+ /** The reads of a listing's quote, profile and bars, each taking the symbol first and its venue second. */
732
+ const LISTING_READS = new Set<string>([
733
+ "getQuote", "getQuoteMetadata", "getTickerFinancials", "getCorporateActions", "getPriceHistory", "getPriceHistoryWithMetadata",
734
+ "getPriceHistoryForResolution", "getPriceHistoryForResolutionWithMetadata", "getDetailedPriceHistory", "getDetailedPriceHistoryWithMetadata",
735
+ ]);
736
+
737
+ /**
738
+ * The data source with each bare symbol `quote` read as no ticker answered at
739
+ * once with the error its quote failed with: `fn G uniswap` says "Not a
740
+ * ticker" without asking again for its quote, profile and bars, each a miss.
741
+ * A symbol on a named venue is asked as usual.
742
+ */
743
+ function withoutNonTickers(provider: DataProvider, notTickers: ReadonlyMap<string, Error>): DataProvider {
744
+ return new Proxy(provider, {
745
+ get(target, property) {
746
+ // Every method runs on the provider itself, as the snapshot provider runs its fallback's.
747
+ const value = Reflect.get(target, property, target) as unknown;
748
+ if (typeof value !== "function") return value;
749
+ const method = (value as (...input: unknown[]) => unknown).bind(target);
750
+ if (typeof property !== "string" || !LISTING_READS.has(property)) return method;
751
+ return (...args: unknown[]) => {
752
+ const [symbol, exchange] = args;
753
+ const error = typeof symbol === "string" && !exchange ? notTickers.get(symbol.trim().toUpperCase()) : undefined;
754
+ return error ? Promise.reject(error) : method(...args);
755
+ };
756
+ },
757
+ });
707
758
  }
708
759
 
709
760
  /**
@@ -738,10 +789,14 @@ function onExchange(spec: ChartSpec, exchange: string): ChartSpec {
738
789
  : { ...series, source: { ...series.source, instrument: { ...series.source.instrument, exchange: canonicalExchange(code) } } }) };
739
790
  }
740
791
 
792
+ /** The price charts, which draw a currency pair as any listing; the fundamentals and estimates graphs take companies. */
793
+ const PRICE_CHARTS: ReadonlySet<string> = new Set(["graph-price-pane", "graph-intraday-price-pane", "comparison-chart-pane"]);
794
+
741
795
  export function chartHeadless(template: keyof typeof paneSchemas): HeadlessPaneDefinition<"series"> {
742
796
  return {
743
797
  ...paneSchemas[template],
744
798
  shape: "series",
799
+ ...(PRICE_CHARTS.has(template) ? { currencyPairs: true } : {}),
745
800
  async load(args, context) {
746
801
  const intradayHistories: ChartPaneModel["snapshot"]["intradayHistories"] = [];
747
802
  const closingPrintsPending: string[] = [];
@@ -760,8 +815,17 @@ export function chartHeadless(template: keyof typeof paneSchemas): HeadlessPaneD
760
815
  // as `quote BDI` does, instead of charting whichever line a source picked.
761
816
  const reads = new Map<string, ReturnType<typeof readSeriesListing>>();
762
817
  const listings = new Map<string, Promise<Awaited<ReturnType<NonNullable<typeof context.resolveListing>>> | null>>();
818
+ // A symbol `quote` reads as no ticker, with the error its quote failed with: its series fail with it at once.
819
+ const notTickers = new Map<string, Error>();
763
820
  const readListing = (symbol: string) => {
764
- if (!listings.has(symbol)) listings.set(symbol, context.resolveListing?.(symbol, (key) => argumentWithListing(args.rawArgument, symbol, key)) ?? Promise.resolve(null));
821
+ if (!listings.has(symbol)) {
822
+ listings.set(symbol, (context.resolveListing?.(symbol, (key) => argumentWithListing(args.rawArgument, symbol, key)) ?? Promise.resolve(null))
823
+ .then((read) => {
824
+ if (!read?.notATicker) return read;
825
+ notTickers.set(symbol.trim().toUpperCase(), read.notATicker);
826
+ return null;
827
+ }));
828
+ }
765
829
  return listings.get(symbol)!;
766
830
  };
767
831
  const readSeriesListing = async (symbol: string): Promise<{ symbol: string; exchange?: string } | null> => {
@@ -772,8 +836,15 @@ export function chartHeadless(template: keyof typeof paneSchemas): HeadlessPaneD
772
836
  let spec = context.resolveInstrument || context.resolveListing ? {
773
837
  ...parsed,
774
838
  series: await Promise.all(parsed.series.map(async (series) => {
775
- if (series.source.kind !== "security" || series.source.instrument.exchange) return series;
776
- const { symbol } = series.source.instrument;
839
+ if (series.source.kind !== "security") return series;
840
+ const { symbol, exchange } = series.source.instrument;
841
+ if (exchange) {
842
+ // An index's key typed on its publisher's venue code (^NDX:NIM), which the parser takes for any index, is checked as
843
+ // `quote` checks it: ^NDX:XYZ says where ^NDX is. A broker's contract or a venue the app lists is charted as named.
844
+ const typedIndexKey = symbol.startsWith("^") && !series.source.instrument.instrument && !isKnownExchangeCode(exchange);
845
+ if (typedIndexKey) await readListing(publicTickerKey(symbol, exchange));
846
+ return series;
847
+ }
777
848
  // A FRED id (DFII10) or a series alias (hashrate) no ticker answers to is that series; an intraday chart has none.
778
849
  const catalog = template === "graph-intraday-price-pane" ? null : await bareCatalogSeries(series, () => readListing(symbol), context);
779
850
  if (catalog) return catalog;
@@ -782,6 +853,11 @@ export function chartHeadless(template: keyof typeof paneSchemas): HeadlessPaneD
782
853
  return instrument ? { ...series, source: { ...series.source, instrument: { ...series.source.instrument, ...instrument } } } : series;
783
854
  })),
784
855
  } : parsed;
856
+ // A FRED series reads by the catalog's short name however it was typed (FRED:DFII10 beside GC=F), as it does alone.
857
+ const catalogLookups = headlessCatalogLookups(context);
858
+ if (spec.series.some((series) => withCatalogLabel(series, catalogLookups) !== series)) {
859
+ spec = { ...spec, series: spec.series.map((series) => withCatalogLabel(series, catalogLookups)) };
860
+ }
785
861
  if (template === "graph-intraday-price-pane" && !spec.viewport.dateWindow) {
786
862
  const instruments = new Map(spec.series.flatMap(({ source }) => source.kind === "security"
787
863
  ? [[snapshotInstrumentKey(source.instrument), source.instrument] as const] : []));
@@ -854,11 +930,13 @@ export function chartHeadless(template: keyof typeof paneSchemas): HeadlessPaneD
854
930
  intradayHistories: histories,
855
931
  }, context.marketData) };
856
932
  }
857
- const model = await loadChartPaneModel(spec, context);
933
+ const model = await loadChartPaneModel(spec, notTickers.size ? { ...context, marketData: withoutNonTickers(context.marketData, notTickers) } : context);
858
934
  // What became of the company that had a bare symbol (GOGL), and a bare coin ticker charted as another listing
859
935
  // (ETH, the Grayscale fund), are said as `quote` says them.
860
936
  const readListings = await Promise.all(listings.values());
861
- const listingNotes = [...readListings.flatMap((read) => read?.successorNote ?? []), ...readListings.flatMap((read) => read?.coinNote ?? [])];
937
+ // So are a code read as another listing (NDX, the Nasdaq-100) and the index or future a code a security owns is typed for (GOLD).
938
+ const listingNotes = [...readListings.flatMap((read) => read?.readAs ?? []), ...readListings.flatMap((read) => read?.successorNote ?? []),
939
+ ...readListings.flatMap((read) => read?.coinNote ?? []), ...readListings.flatMap((read) => read?.ownedNotes ?? [])];
862
940
  if (listingNotes.length) model.warnings = [...model.warnings ?? [], ...listingNotes];
863
941
  if (template === "graph-intraday-price-pane" && !intradayHistories.length && model.chart.viewport) {
864
942
  const { start, end } = model.chart.viewport;
@@ -928,6 +1006,9 @@ export function chartHeadless(template: keyof typeof paneSchemas): HeadlessPaneD
928
1006
  if (quote && Number.isFinite(quote.lastUpdated)) quotes.set(entry.id, quote);
929
1007
  }
930
1008
  }
1009
+ // A week or month still forming is dated by its value's own day, its quote's: ^NDX's November bar by Mon 9 Nov's close,
1010
+ // not the 1st the bar starts on, beside a coin's that runs to today.
1011
+ model.series = model.series.map((series) => withLatestQuoteDay(series, quotes.get(series.id)));
931
1012
  model.freshness = chartFreshness(model.series, model.spec, model.chart.priceComparison, quotes);
932
1013
  if (closingPrintsPending.length) {
933
1014
  model.freshness = { ...model.freshness, note: [model.freshness.note, CLOSING_PRINT_PENDING_TEXT].filter(Boolean).join(", ") };
@@ -7,7 +7,7 @@ import type {
7
7
  import { CHART_COMPOSER_PANE_ID, type PaneInstanceConfig } from "../../../types/config";
8
8
  import type { TickerRecord } from "../../../types/ticker";
9
9
  import { parseTickerListInput } from "../../../tickers/list";
10
- import { canonicalExchange, parsePublicTickerKey, publicTickerKey } from "../../../utils/exchanges";
10
+ import { canonicalExchange, canonicalTickerKey, parsePublicTickerKey, publicTickerKey } from "../../../utils/exchanges";
11
11
  import { tickerInstrumentLabel } from "../../../tickers/instrument-label";
12
12
  import type { ChartSpec } from "../../../time-series/types";
13
13
  import { ChartComposerPane, ChartComposerResearchTab } from "./pane";
@@ -141,12 +141,15 @@ function capabilityTitlePart(
141
141
 
142
142
  function chartTitle(spec: ChartSpec, prefix = "G"): string {
143
143
  const pricedTickers = new Set(spec.series.flatMap((series) => series.source.kind === "security"
144
- ? [publicTickerKey(series.source.instrument.symbol, series.source.instrument.exchange).toUpperCase(), series.source.instrument.symbol.toUpperCase()]
144
+ ? [publicTickerKey(series.source.instrument.symbol, series.source.instrument.exchange).toUpperCase(),
145
+ canonicalTickerKey(series.source.instrument.symbol, series.source.instrument.exchange).toUpperCase(),
146
+ series.source.instrument.symbol.toUpperCase()]
145
147
  : []));
146
148
  const groups = new Set<string>();
147
149
  const parts = spec.series.flatMap((series) => {
148
150
  if (series.source.kind === "security") {
149
- return [tickerInstrumentLabel(publicTickerKey(series.source.instrument.symbol, series.source.instrument.exchange), series.source.instrument.instrument)];
151
+ // The venue's own code (9992:HKEX), as the series' legend names it, never the saved key (9992:XHKG).
152
+ return [tickerInstrumentLabel(canonicalTickerKey(series.source.instrument.symbol, series.source.instrument.exchange), series.source.instrument.instrument)];
150
153
  }
151
154
  if (series.source.kind === "economic") return [`FRED:${series.source.seriesId}`];
152
155
  const label = series.label?.trim() || registeredSeriesName(series.source) || series.source.seriesId;
@@ -0,0 +1,19 @@
1
+ /**
2
+ * A security series' legend label with its company named once beside it
3
+ * ("AAPL Price · Apple"), and the shorter label the legend falls back to when
4
+ * the company is drawn once (`8058 Mitsubishi`). A name that starts with the
5
+ * ticker names it once: CF in a comparison is "CF Industries", never
6
+ * "CF CF Industries".
7
+ */
8
+ export function companyLegendLabels(
9
+ label: string,
10
+ symbol: string | null,
11
+ company: string,
12
+ onlySeriesOfSymbol: boolean,
13
+ ): { label: string; compactLabel?: string } {
14
+ const tickerLed = !!symbol && company.toUpperCase().startsWith(`${symbol.toUpperCase()} `);
15
+ return {
16
+ label: tickerLed && label === symbol ? company : `${label} · ${company}`,
17
+ ...(symbol && onlySeriesOfSymbol ? { compactLabel: tickerLed ? company : `${symbol} ${company}` } : {}),
18
+ };
19
+ }
@@ -27,6 +27,8 @@ import type { CompositeChartLevels, CompositeLevelEdit } from "../../../componen
27
27
  import type { FxInterventionsPayload } from "../../../api-client/fx-interventions";
28
28
  import { loadFxInterventions } from "../../../market-data/fx-interventions";
29
29
  import { chartInterventionPair, chartInterventions, rawPriceEntry } from "./intervention-events";
30
+ import { formulaRollEvents, isRollEvent } from "./roll-events";
31
+ import type { CompositeChartEvent } from "../../../components/chart/composite/types";
30
32
  import type { PaneProps, TickerResearchTabProps } from "../../../types/plugin";
31
33
  import type { ChartResolution, TimeRange } from "../../../components/chart/core/types";
32
34
  import type { ChartSpec, ResolvedSeries } from "../../../time-series/types";
@@ -61,7 +63,8 @@ import { isUsListingExchange, parsePublicTickerKey, publicTickerKey } from "../.
61
63
  import { getTimeSeriesField, isMarketFieldId } from "../../../time-series/field-catalog";
62
64
  import { isDatasetChart, isOhlcSeriesStyle } from "../../../time-series/spec";
63
65
  import { useThemeColors } from "../../../theme/theme-context";
64
- import { priceComparisonSeriesIds } from "../../../time-series/price-comparison";
66
+ import { comparisonLegCurrencies, priceComparisonSeriesIds } from "../../../time-series/price-comparison";
67
+ import { companyLegendLabels } from "./legend-names";
65
68
  import { seriesMessageName, studyMessageName } from "../../../time-series/series-name";
66
69
  import { CHART_COMPOSER_PANE_ID } from "../../../types/config";
67
70
  import { useRemoteUiNode } from "../../../remote/semantic-tree";
@@ -405,8 +408,10 @@ function ChartComposerSurface({
405
408
  });
406
409
  currentResolutionRef.current = resolution.resolution ?? currentResolutionRef.current;
407
410
  // Intervals only resample market series. Quarterly revenue or a P/E line
408
- // looks the same at every interval, so such a chart offers AUTO alone.
409
- const hasMarketSeries = spec.series.some((entry) => (
411
+ // looks the same at every interval, so such a chart offers AUTO alone. A bare
412
+ // symbol read as a FRED series (DFII10) counts as that series once it is read.
413
+ const chartedSeries = listings.pending ? spec.series : listings.spec.series;
414
+ const hasMarketSeries = chartedSeries.some((entry) => (
410
415
  entry.source.kind === "security" && isMarketFieldId(entry.source.fieldId)
411
416
  ));
412
417
  // Bars built from a future's clock-aligned bars must not straddle its session's open.
@@ -477,6 +482,13 @@ function ChartComposerSurface({
477
482
  const legendSeries = useMemo(() => {
478
483
  // Each security series names its company once, beside its label: "AAPL Price · Apple".
479
484
  const named = new Set<string>();
485
+ // A company drawn once falls back to its ticker and name ("8058 Mitsubishi") before the legend cuts either.
486
+ const seriesPerSymbol = new Map<string, number>();
487
+ for (const series of spec.series) {
488
+ if (series.source.kind !== "security") continue;
489
+ const symbol = series.source.instrument.symbol;
490
+ seriesPerSymbol.set(symbol, (seriesPerSymbol.get(symbol) ?? 0) + 1);
491
+ }
480
492
  const resolved = (resolution.legendSeries ?? []).map((entry) => {
481
493
  const authored = spec.series.find((series) => series.id === entry.id);
482
494
  if (authored?.source.kind === "security" && authored.source.fieldId.startsWith("valuation.")) {
@@ -488,14 +500,21 @@ function ChartComposerSurface({
488
500
  const company = name ? shortCompanyName(name) : "";
489
501
  if (!company || named.has(company)) return entry;
490
502
  named.add(company);
491
- return { ...entry, label: `${entry.label} · ${company}` };
503
+ const symbol = authored?.source.kind === "security" ? authored.source.instrument.symbol : null;
504
+ return { ...entry, ...companyLegendLabels(entry.label, symbol, company, !!symbol && seriesPerSymbol.get(symbol) === 1) };
505
+ });
506
+ // Returns compared across currencies, or converted into one, say each leg's currency beside its return.
507
+ const legCurrencies = comparisonLegCurrencies(resolved, resolution.priceComparison?.seriesIds, spec.viewport.currency);
508
+ const captioned = legCurrencies.size === 0 ? resolved : resolved.map((entry) => {
509
+ const currency = legCurrencies.get(entry.id);
510
+ return currency && !entry.statedUnit ? { ...entry, statedUnit: `in ${currency}` } : entry;
492
511
  });
493
- const resolvedIds = new Set(resolved.map((entry) => entry.id));
512
+ const resolvedIds = new Set(captioned.map((entry) => entry.id));
494
513
  const missing = spec.series.filter((entry) => !resolvedIds.has(entry.id));
495
- if (missing.length === 0) return candleColour(resolved);
514
+ if (missing.length === 0) return candleColour(captioned);
496
515
  const bySpecOrder = new Map(spec.series.map((entry, index) => [entry.id, index] as const));
497
516
  return candleColour([
498
- ...resolved,
517
+ ...captioned,
499
518
  ...missing.map((entry): ResolvedSeries => ({
500
519
  id: entry.id,
501
520
  label: chartSeriesLabel(entry),
@@ -513,7 +532,7 @@ function ChartComposerSurface({
513
532
  points: [],
514
533
  })),
515
534
  ].sort((a, b) => (bySpecOrder.get(a.id) ?? Number.MAX_SAFE_INTEGER) - (bySpecOrder.get(b.id) ?? Number.MAX_SAFE_INTEGER)));
516
- }, [candleColour, listings.names, nameSeries, resolution.legendSeries, spec.series]);
535
+ }, [candleColour, listings.names, nameSeries, resolution.legendSeries, resolution.priceComparison?.seriesIds, spec.series, spec.viewport.currency]);
517
536
  const plottedSeries = useMemo(
518
537
  () => candleColour(projectVisibleChartSeries(
519
538
  spec,
@@ -621,6 +640,14 @@ function ChartComposerSurface({
621
640
  () => wantsInterventions ? chartInterventions(spec, chartSeries, interventions) : null,
622
641
  [chartSeries, interventions, spec, wantsInterventions],
623
642
  );
643
+ // A futures formula marks the days its legs roll, as `history` marks a front month's.
644
+ const chartEvents = useMemo(() => {
645
+ const rolls = formulaRollEvents(chartSeries);
646
+ if (rolls.length === 0) return interventionMarks;
647
+ const merge = (events: readonly CompositeChartEvent[]) => events.every(isRollEvent) ? ["Rolls"]
648
+ : events.some(isRollEvent) ? [] : interventionMarks?.merge(events) ?? [];
649
+ return { events: [...interventionMarks?.events ?? [], ...rolls], merge };
650
+ }, [chartSeries, interventionMarks]);
624
651
  const [interactionCaptured, setInteractionCapturedState] = useState(false);
625
652
  // Typing in quick-add must not freeze the plot: it only takes the keyboard.
626
653
  const [modalCaptured, setModalCaptured] = useState(false);
@@ -1354,8 +1381,8 @@ function ChartComposerSurface({
1354
1381
  timePick={timePick}
1355
1382
  pricePick={pricePick}
1356
1383
  levels={chartLevels}
1357
- events={interventionMarks?.events}
1358
- mergeEventCaptions={interventionMarks?.merge}
1384
+ events={chartEvents?.events}
1385
+ mergeEventCaptions={chartEvents?.merge}
1359
1386
  rangeStatisticsSeriesId={rangeStatisticsSeriesId}
1360
1387
  emptyMessage={emptyMessage}
1361
1388
  emptyDetail={emptyDetail}
@@ -20,9 +20,11 @@ import {
20
20
  } from "./series-expression";
21
21
  import { setBuiltinStudies, setPairStudies, type PairStudySelection } from "./studies";
22
22
  import { looksLikeFormula, parseFormulaExpression, type ParsedFormula } from "./formula";
23
+ import { FORMULA_NAME, FORMULA_ROLLS_WITH } from "../../../time-series/studies/formula";
23
24
  import type { SeriesCatalogSuggestion } from "./series-catalog";
24
25
  import { getSharedRegistry } from "../../registry";
25
26
  import { seriesCatalogEntry } from "../../../series/registry";
27
+ import { standaloneSeriesCatalogEntries } from "../../../series/standalone-catalog";
26
28
 
27
29
  function chartSpec(
28
30
  series: ChartSeriesSpec[],
@@ -102,9 +104,23 @@ function withFactorPanels(panels: ChartSpec["panels"], factors: readonly ChartSe
102
104
  ];
103
105
  }
104
106
 
107
+ /**
108
+ * A catalog formula's name, and the leg every other leg takes its delivery
109
+ * month from (`CL=F` in the 3-2-1 crack), as its catalog entry gives them.
110
+ */
111
+ interface CatalogFormula {
112
+ name: string;
113
+ rollsWith?: string;
114
+ }
115
+
105
116
  /** The study that weighs a formula's legs and scales the sum, charted as the given series, in the Formula panel. */
106
- function formulaStudy(formula: ParsedFormula, inputSeriesIds: string[]): ChartStudySpec {
117
+ function formulaStudy(formula: ParsedFormula, inputSeriesIds: string[], catalog?: CatalogFormula): ChartStudySpec {
107
118
  const parameters: ChartStudySpec["parameters"] = { divisor: formula.divisor };
119
+ if (catalog) {
120
+ parameters[FORMULA_NAME] = catalog.name;
121
+ const leader = catalog.rollsWith ? formula.legs.findIndex((leg) => leg.text.toUpperCase() === catalog.rollsWith!.toUpperCase()) : -1;
122
+ if (leader >= 0) parameters[FORMULA_ROLLS_WITH] = leader + 1;
123
+ }
108
124
  formula.legs.forEach((leg, index) => {
109
125
  parameters[`weight${index + 1}`] = leg.weight;
110
126
  if (leg.perBarrel) parameters[`perBarrel${index + 1}`] = 1;
@@ -118,7 +134,7 @@ function formulaStudy(formula: ParsedFormula, inputSeriesIds: string[]): ChartSt
118
134
  }
119
135
 
120
136
  /** A formula's legs and factors as series, with the study that sums them in the Formula panel. */
121
- function formulaChartPreset(formula: ParsedFormula): ChartSpec {
137
+ function formulaChartPreset(formula: ParsedFormula, catalog?: CatalogFormula): ChartSpec {
122
138
  const legs = buildCustomSeries([...formula.legs, ...formula.factors].map((entry) => entry.series));
123
139
  const series: ChartSeriesSpec[] = [];
124
140
  legs.forEach((entry, index) => {
@@ -126,7 +142,7 @@ function formulaChartPreset(formula: ParsedFormula): ChartSpec {
126
142
  ? placeFormulaLeg(formula, index, entry)
127
143
  : placeFormulaFactor({ panels: [], series, studies: [] }, entry));
128
144
  });
129
- const spec = chartSpec(series, { studies: [formulaStudy(formula, series.map((entry) => entry.id))] });
145
+ const spec = chartSpec(series, { studies: [formulaStudy(formula, series.map((entry) => entry.id), catalog)] });
130
146
  return { ...spec, panels: withFactorPanels(spec.panels, series.slice(formula.legs.length)) };
131
147
  }
132
148
 
@@ -134,7 +150,7 @@ function formulaChartPreset(formula: ParsedFormula): ChartSpec {
134
150
  * The chart with a formula added: a leg already charted is reused, the rest
135
151
  * join the series, and the formula replaces the one the chart had.
136
152
  */
137
- function appendChartFormula(spec: ChartSpec, expression: string): { spec: ChartSpec; series: ChartSeriesSpec } {
153
+ function appendChartFormula(spec: ChartSpec, expression: string, catalog?: CatalogFormula): { spec: ChartSpec; series: ChartSeriesSpec } {
138
154
  const formula = parseFormulaExpression(expression);
139
155
  if (!formula) throw new Error(`"${expression}" is not a formula.`);
140
156
  const key = (series: ChartSeriesSpec) => formatSeriesExpression(series).toLowerCase();
@@ -157,7 +173,7 @@ function appendChartFormula(spec: ChartSpec, expression: string): { spec: ChartS
157
173
  next = { ...appended.spec, series: appended.spec.series.map((series) => series.id === placed.id ? placed : series) };
158
174
  return placed;
159
175
  });
160
- const studies = [...next.studies, formulaStudy(formula, inputs.map((series) => series.id))];
176
+ const studies = [...next.studies, formulaStudy(formula, inputs.map((series) => series.id), catalog)];
161
177
  const known = new Set(next.panels.map((panel) => panel.id));
162
178
  return {
163
179
  spec: {
@@ -180,7 +196,10 @@ export function appendCatalogSuggestion(
180
196
  spec: ChartSpec,
181
197
  suggestion: SeriesCatalogSuggestion,
182
198
  ): { spec: ChartSpec; series: ChartSeriesSpec } {
183
- if (suggestion.formula !== undefined) return appendChartFormula(spec, suggestion.formula);
199
+ if (suggestion.formula !== undefined) {
200
+ return appendChartFormula(spec, suggestion.formula, suggestion.seriesName
201
+ ? { name: suggestion.seriesName, ...(suggestion.rollsWith ? { rollsWith: suggestion.rollsWith } : {}) } : undefined);
202
+ }
184
203
  if (suggestion.lines || suggestion.placement) {
185
204
  return appendPlacedSeries(spec, suggestion.lines ?? [suggestion.expression!], {
186
205
  name: suggestion.seriesName ?? suggestion.label,
@@ -227,12 +246,18 @@ export function buildRegisteredSeriesChart(
227
246
  * or a formula (`42*HO=F - CL=F`).
228
247
  */
229
248
  export function buildCustomChartPreset(expression: string, fallbackSymbol?: string | null): ChartSpec {
249
+ // A catalog series by its name (`3-2-1 crack spread`), which would read as a list of tickers.
250
+ const named = /\s/.test(expression.trim()) && !looksLikeFormula(expression) ? catalogSeriesChart(expression) : null;
251
+ if (named) return named;
230
252
  const derived = derivedPair(expression);
231
253
  if (derived) return setPairStudies(chartSpec(buildCustomSeries(derived.series)), [derived.formula]);
232
254
  let parsed: ParsedSeriesExpression[];
233
255
  try {
234
256
  parsed = parseChartExpression(expression);
235
257
  } catch (error) {
258
+ // A catalog series by its id (`fut:crack-321`) or name, which no series reads as.
259
+ const catalog = catalogSeriesChart(expression);
260
+ if (catalog) return catalog;
236
261
  // Text a list cannot read, written as a formula, gets the formula's own error.
237
262
  if (!looksLikeFormula(expression)) throw error;
238
263
  const formula = parseFormulaExpression(expression);
@@ -245,6 +270,38 @@ export function buildCustomChartPreset(expression: string, fallbackSymbol?: stri
245
270
  return chartSpec(buildCustomSeries(parsed));
246
271
  }
247
272
 
273
+ /** A name as typed, without case or punctuation: `3:2:1 Crack Spread` is `321crackspread`. */
274
+ function compactName(value: string): string {
275
+ return value.toLowerCase().replace(/[^a-z0-9]+/g, "");
276
+ }
277
+
278
+ /**
279
+ * The chart of a catalog series typed by its id (`fut:crack-321`) or its name
280
+ * (`3-2-1 crack spread`, in any case or punctuation): a formula with its legs,
281
+ * named as the catalog names it and priced in one delivery month when the
282
+ * entry rolls its legs together; any other series under its name. Null when
283
+ * no series has the id or name, or the series needs a ticker to chart.
284
+ */
285
+ function catalogSeriesChart(text: string): ChartSpec | null {
286
+ const wanted = text.trim();
287
+ if (!wanted) return null;
288
+ const compact = compactName(wanted);
289
+ const entries = (getSharedRegistry()?.series?.catalog() ?? standaloneSeriesCatalogEntries()).filter((entry) => !entry.input);
290
+ const entry = entries.find((candidate) => candidate.id.toLowerCase() === wanted.toLowerCase())
291
+ ?? (compact ? entries.find((candidate) => compactName(candidate.name) === compact) : undefined);
292
+ if (!entry) return null;
293
+ let formula: ParsedFormula | null = null;
294
+ try {
295
+ formula = parseFormulaExpression(entry.expression);
296
+ } catch {
297
+ // Intentional ignore: an entry whose expression is no formula charts as the series it names.
298
+ }
299
+ if (formula) return formulaChartPreset(formula, { name: entry.name, ...(entry.rollsWith ? { rollsWith: entry.rollsWith } : {}) });
300
+ if (entry.lines?.length || entry.placement) return buildRegisteredSeriesChart({ name: entry.name, template: entry.expression, placement: entry.placement, lines: entry.lines });
301
+ const parsed = parseSeriesExpression(entry.expression);
302
+ return parsed ? chartSpec(buildCustomSeries([{ ...parsed, label: entry.name }])) : null;
303
+ }
304
+
248
305
  /**
249
306
  * A registered series typed alone (`CAP:studies:rsi/AAPL`) that says where it is
250
307
  * drawn or draws several lines charts as CAT opens it. Naming one line
@@ -0,0 +1,38 @@
1
+ import type { CompositeChartEvent } from "../../../components/chart/composite/types";
2
+ import type { ResolvedSeries } from "../../../time-series/types";
3
+
4
+ const ROLL_ID = ":roll:";
5
+
6
+ /**
7
+ * A futures formula's rolls as chart events: a guide on each point a leg
8
+ * rolls on, captioned with the contracts it rolls to (`Roll to RBZ26 HOZ26
9
+ * CLZ26`), else `Roll`. A crack priced in one delivery month rolls every leg
10
+ * on its leader's day, so it has one guide per roll. Two formulas rolling on
11
+ * the same point share its guide.
12
+ */
13
+ export function formulaRollEvents(series: readonly ResolvedSeries[]): CompositeChartEvent[] {
14
+ const events = new Map<number, CompositeChartEvent>();
15
+ for (const entry of series) {
16
+ if (!entry.formulaLegs) continue;
17
+ entry.points.forEach((point, index) => {
18
+ if (!point.roll || !point.legs?.length) return;
19
+ const time = point.date.getTime();
20
+ if (events.has(time)) return;
21
+ const before = entry.points[index - 1]?.legs;
22
+ const rolled = point.legs.flatMap((leg, position) => (
23
+ leg.contract && leg.contract !== before?.[position]?.contract ? [leg.contract] : []
24
+ ));
25
+ events.set(time, {
26
+ id: `${entry.id}${ROLL_ID}${time}`,
27
+ time,
28
+ captions: rolled.length ? [`Roll to ${rolled.join(" ")}`, "Roll"] : ["Roll"],
29
+ });
30
+ });
31
+ }
32
+ return [...events.values()];
33
+ }
34
+
35
+ /** Whether a chart event is a formula's roll (`formulaRollEvents`). */
36
+ export function isRollEvent(event: Pick<CompositeChartEvent, "id">): boolean {
37
+ return event.id.includes(ROLL_ID);
38
+ }
@@ -10,6 +10,7 @@ import type { TimeSeriesFieldDefinition } from "../../../time-series/types";
10
10
  import type { SeriesCatalogEntry, SeriesPlacement } from "../../../series/types";
11
11
  import {
12
12
  canonicalExchange,
13
+ canonicalTickerKey,
13
14
  parsePublicTickerKey,
14
15
  publicTickerKey,
15
16
  } from "../../../utils/exchanges";
@@ -43,6 +44,8 @@ export type SeriesCatalogSuggestion = SeriesCatalogSuggestionText & (
43
44
  ) & {
44
45
  /** A registered series' own name, and where it asks to be drawn for the ticker it was filled in for. */
45
46
  seriesName?: string;
47
+ /** A catalog formula's leg the others take their delivery month from (`CL=F`), as its entry gives it. */
48
+ rollsWith?: string;
46
49
  placement?: SeriesPlacement;
47
50
  symbol?: string;
48
51
  };
@@ -267,9 +270,11 @@ function exactExpressionSuggestion(query: string): SeriesCatalogSuggestion | nul
267
270
  }
268
271
  const field = getTimeSeriesField(expression.fieldId);
269
272
  const instrument = publicTickerKey(expression.symbol, expression.exchange);
273
+ // Shown with the venue's code (9992:HKEX), as chart titles name it; the id keeps the stored key.
274
+ const shown = canonicalTickerKey(expression.symbol, expression.exchange);
270
275
  return {
271
276
  id: `${instrument}:${expression.fieldId}`,
272
- label: expression.label ?? `${instrument} · ${field?.label ?? expression.fieldId}`,
277
+ label: expression.label ?? `${shown} · ${field?.label ?? expression.fieldId}`,
273
278
  description: field
274
279
  ? `${fieldCategory(field)} · ${fieldFrequency(field)}`
275
280
  : "Security series",
@@ -334,7 +339,7 @@ function registeredSeriesSuggestions(
334
339
  text = tickerQuery;
335
340
  }
336
341
  if (!matchesAliasQuery(text, entry.name, entry.expression, entry.id, entry.group ?? "", ...(entry.tags ?? []))) continue;
337
- const prefix = symbol ? `${symbol} · ` : "";
342
+ const prefix = symbol ? `${canonicalTickerKey(instrument.symbol, instrument.exchange)} · ` : "";
338
343
  if (entry.lines?.length) {
339
344
  const lines = entry.lines.flatMap((line) => {
340
345
  const parsed = parseSeriesExpression(fill(line.expression));
@@ -358,7 +363,8 @@ function registeredSeriesSuggestions(
358
363
  if (formula !== undefined) {
359
364
  // A formula runs long: its name leads, and the formula is in the description.
360
365
  const formulaDescription = [formula, unit, entry.frequency].filter(Boolean).join(" · ");
361
- return { id: `formula:${formula}`, label: entry.name, description: formulaDescription, detail, formula };
366
+ return { id: `formula:${formula}`, label: entry.name, description: formulaDescription, detail, formula,
367
+ seriesName: entry.name, ...(entry.rollsWith ? { rollsWith: entry.rollsWith } : {}) };
362
368
  }
363
369
  const placed = {
364
370
  seriesName: entry.name,
@@ -447,7 +453,8 @@ export function buildSeriesCatalogSuggestions(
447
453
  }
448
454
  const fieldLimit = instruments.length > 1 && !analysis.metricQuery ? 1 : rankedFields.length;
449
455
  for (const instrument of instruments) {
450
- const instrumentLabel = publicTickerKey(instrument.symbol, instrument.exchange);
456
+ const instrumentKey = publicTickerKey(instrument.symbol, instrument.exchange);
457
+ const instrumentLabel = canonicalTickerKey(instrument.symbol, instrument.exchange);
451
458
  for (const { field } of rankedFields.slice(0, fieldLimit)) {
452
459
  const expression: ParsedSeriesExpression = {
453
460
  kind: "security",
@@ -456,7 +463,7 @@ export function buildSeriesCatalogSuggestions(
456
463
  fieldId: field.id,
457
464
  };
458
465
  const suggestion: SeriesCatalogSuggestion = {
459
- id: `${instrumentLabel}:${field.id}`,
466
+ id: `${instrumentKey}:${field.id}`,
460
467
  label: `${instrumentLabel} · ${field.label}`,
461
468
  description: [
462
469
  instrument.name,