gloomberb 0.20.2 → 0.20.4

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 (471) hide show
  1. package/README.md +1 -1
  2. package/README.zh-CN.md +1 -1
  3. package/package.json +2 -1
  4. package/src/account/auth-dialog.tsx +17 -0
  5. package/src/account/auth-form.tsx +13 -8
  6. package/src/account/upgrade-dialog.tsx +1 -1
  7. package/src/api-client/central-bank-rates.ts +5 -0
  8. package/src/api-client/data.ts +23 -4
  9. package/src/api-client/debt-maturities.ts +45 -2
  10. package/src/api-client/earnings.ts +4 -2
  11. package/src/api-client/errors.ts +21 -11
  12. package/src/api-client/fx-interventions.ts +64 -0
  13. package/src/api-client/index.ts +2 -0
  14. package/src/api-client/paths.ts +9 -1
  15. package/src/api-client/release-summaries.ts +21 -0
  16. package/src/api-client/social-mentions.ts +47 -0
  17. package/src/api-client/types/econ.ts +4 -0
  18. package/src/app/keybindings/actions.ts +2 -2
  19. package/src/app/pane-runtime/ticker-open-runtime.ts +245 -66
  20. package/src/app.tsx +11 -1
  21. package/src/cli/command-options.ts +2 -1
  22. package/src/cli/commands/market.ts +188 -30
  23. package/src/cli/commands/news-search.ts +1 -3
  24. package/src/cli/commands/options-chain.ts +23 -6
  25. package/src/cli/commands/overview.ts +13 -5
  26. package/src/cli/commands/plugins.ts +76 -23
  27. package/src/cli/commands/search.ts +25 -6
  28. package/src/cli/commands/system.ts +19 -3
  29. package/src/cli/commands/ticker.ts +64 -21
  30. package/src/cli/fx-quote-rate.ts +49 -1
  31. package/src/cli/glossary.ts +95 -15
  32. package/src/cli/history-rows.ts +9 -25
  33. package/src/cli/index.ts +14 -46
  34. package/src/cli/known-gaps.ts +3 -3
  35. package/src/cli/listing-arg.ts +78 -18
  36. package/src/cli/name-entries.ts +3 -2
  37. package/src/cli/not-a-ticker.ts +6 -2
  38. package/src/cli/pane-functions/capabilities.ts +12 -1
  39. package/src/cli/pane-functions/function-help.ts +26 -14
  40. package/src/cli/pane-functions/headless.ts +3 -1
  41. package/src/cli/pane-functions/index.ts +32 -4
  42. package/src/cli/pane-functions/market-session.ts +8 -3
  43. package/src/cli/pane-functions/resolver.ts +18 -11
  44. package/src/cli/pane-functions/screenshot-payload.ts +36 -6
  45. package/src/cli/pane-functions/screenshot-render.ts +4 -0
  46. package/src/cli/quote-answer.ts +10 -0
  47. package/src/cli/report-tables.ts +40 -8
  48. package/src/cli/result.ts +21 -9
  49. package/src/cli/spreadsheet-hint.ts +43 -0
  50. package/src/cli/symbol-list.ts +58 -4
  51. package/src/cli/symbol-rows.ts +49 -2
  52. package/src/cli/ticker-resolution.ts +98 -5
  53. package/src/cli/types.ts +2 -0
  54. package/src/cli/unknown-command.ts +88 -0
  55. package/src/components/chart/composite/axis-overlays.tsx +22 -0
  56. package/src/components/chart/composite/composite-chart.tsx +54 -13
  57. package/src/components/chart/composite/event-captions.ts +109 -0
  58. package/src/components/chart/composite/event-guides.ts +74 -0
  59. package/src/components/chart/composite/rasterizer.ts +2 -0
  60. package/src/components/chart/composite/text-renderer.ts +2 -0
  61. package/src/components/chart/composite/types.ts +31 -0
  62. package/src/components/command-bar/assist/model.ts +6 -1
  63. package/src/components/command-bar/commands/direct/index.ts +9 -1
  64. package/src/components/command-bar/commands/registry.ts +18 -0
  65. package/src/components/command-bar/layout-items/focused-pane.ts +5 -5
  66. package/src/components/command-bar/pane-actions.ts +30 -13
  67. package/src/components/command-bar/panel/index.tsx +6 -3
  68. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  69. package/src/components/command-bar/panel/types.ts +3 -0
  70. package/src/components/command-bar/routes/header-market.ts +108 -0
  71. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  72. package/src/components/command-bar/routes/root/provider-search.ts +192 -33
  73. package/src/components/command-bar/routes/root/results.ts +3 -0
  74. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  75. package/src/components/command-bar/routes/ticker-search/results.ts +104 -6
  76. package/src/components/command-bar/routes/ticker-search/route.ts +3 -2
  77. package/src/components/command-bar/routing/list-state.ts +38 -0
  78. package/src/components/command-bar/selection-hint.ts +28 -0
  79. package/src/components/command-bar/surface/index.tsx +41 -3
  80. package/src/components/command-bar/view-model.ts +15 -0
  81. package/src/components/command-bar/workflow/tickers.ts +3 -2
  82. package/src/components/company-logo.tsx +20 -2
  83. package/src/components/data-table/export.ts +13 -8
  84. package/src/components/feedback-dialog.tsx +2 -1
  85. package/src/components/form-modal/field-row.tsx +2 -1
  86. package/src/components/input-search-bar.tsx +2 -2
  87. package/src/components/layout/detached-pane-shell.tsx +1 -1
  88. package/src/components/layout/double-escape-close.ts +8 -5
  89. package/src/components/layout/floating-pane.tsx +5 -1
  90. package/src/components/layout/header.tsx +75 -44
  91. package/src/components/layout/market-summary.ts +322 -116
  92. package/src/components/layout/pane/footer/index.tsx +44 -19
  93. package/src/components/layout/pane/footer/model.ts +52 -20
  94. package/src/components/layout/pane/header.tsx +3 -2
  95. package/src/components/layout/shell/action-menu-overlay.tsx +10 -5
  96. package/src/components/layout/shell/active-drag.ts +149 -105
  97. package/src/components/layout/shell/chrome.ts +15 -15
  98. package/src/components/layout/shell/drag/drop-zones.ts +162 -0
  99. package/src/components/layout/shell/drag/index.ts +47 -218
  100. package/src/components/layout/shell/drag/live.ts +10 -3
  101. package/src/components/layout/shell/drag/overlays.tsx +182 -5
  102. package/src/components/layout/shell/drag/runtime.ts +29 -6
  103. package/src/components/layout/shell/drag/shared-edges.ts +156 -0
  104. package/src/components/layout/shell/index.tsx +11 -6
  105. package/src/components/layout/shell/menu.ts +11 -2
  106. package/src/components/layout/shell/native/pointer-runtime.ts +25 -0
  107. package/src/components/layout/shell/native/window-state.ts +2 -2
  108. package/src/components/layout/shell/pane/layers.tsx +71 -7
  109. package/src/components/layout/shell/terminal-pointer-runtime.ts +18 -9
  110. package/src/components/layout/shell/window-mode/index.ts +8 -10
  111. package/src/components/layout/status-bar.tsx +8 -7
  112. package/src/components/layout/status-widget-space.ts +8 -0
  113. package/src/components/layout/window-edit/mode.ts +39 -7
  114. package/src/components/layout/window-edit/presentation.ts +1 -1
  115. package/src/components/markdown-editor.tsx +2 -2
  116. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  117. package/src/components/onboarding/onboarding-keyboard.ts +19 -6
  118. package/src/components/onboarding/onboarding-wizard.tsx +69 -14
  119. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  120. package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
  121. package/src/components/price-sparkline/model.ts +26 -10
  122. package/src/components/ticker/list-table-view.tsx +29 -4
  123. package/src/components/ui/button.tsx +15 -2
  124. package/src/components/ui/choice-dialog.tsx +1 -0
  125. package/src/components/ui/column-grid.tsx +18 -9
  126. package/src/components/ui/data-table/index.tsx +5 -4
  127. package/src/components/ui/data-table/opentui/index.tsx +2 -1
  128. package/src/components/ui/data-table/types.ts +18 -0
  129. package/src/components/ui/delayed-mark.tsx +3 -2
  130. package/src/components/ui/field-grid.tsx +0 -2
  131. package/src/components/ui/fields.tsx +7 -4
  132. package/src/components/ui/inline-quick-add.tsx +2 -2
  133. package/src/components/ui/key-hint-words.ts +153 -0
  134. package/src/components/ui/key-hints.tsx +73 -0
  135. package/src/components/ui/list-view.tsx +7 -12
  136. package/src/components/ui/loading.tsx +10 -3
  137. package/src/components/ui/menu.tsx +9 -3
  138. package/src/components/ui/message-composer.tsx +2 -2
  139. package/src/components/ui/quote.ts +14 -1
  140. package/src/components/ui/shortcut-hint.tsx +28 -3
  141. package/src/components/ui/tabs.tsx +7 -0
  142. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  143. package/src/core/state/app/command-bar-launch.ts +3 -0
  144. package/src/data/config/layout.ts +5 -2
  145. package/src/data/config/store/normalize.ts +6 -0
  146. package/src/docs/snapshot.json +149 -74
  147. package/src/i18n/es.ts +33 -9
  148. package/src/i18n/ja.ts +33 -9
  149. package/src/i18n/ko.ts +33 -9
  150. package/src/i18n/zh-cn.ts +33 -9
  151. package/src/i18n/zh-tw.ts +33 -9
  152. package/src/layout/pane-manager/floating-actions.ts +17 -0
  153. package/src/layout/pane-manager/floating-stack.ts +187 -0
  154. package/src/layout/pane-manager/floating.ts +4 -2
  155. package/src/layout/pane-manager/gridlock.ts +16 -1
  156. package/src/layout/pane-manager/index.ts +11 -0
  157. package/src/layout/pane-manager/layout-state.ts +10 -3
  158. package/src/market-data/bars-per-year.ts +27 -9
  159. package/src/market-data/coordinator/quotes.ts +22 -3
  160. package/src/market-data/futures-board.ts +126 -1
  161. package/src/market-data/futures-contract.ts +21 -6
  162. package/src/market-data/fx-interventions.ts +270 -0
  163. package/src/market-data/market/change-basis.ts +2 -2
  164. package/src/market-data/market/dated-previous-close.ts +163 -47
  165. package/src/market-data/market/format.ts +14 -3
  166. package/src/market-data/market/freshness.ts +24 -7
  167. package/src/market-data/market/header-market.ts +154 -0
  168. package/src/market-data/market/index-level.ts +29 -0
  169. package/src/market-data/market/index-session-venues.ts +44 -0
  170. package/src/market-data/market/status.ts +7 -2
  171. package/src/market-data/market/venue-session.ts +72 -0
  172. package/src/market-data/model-dividend-yield.ts +23 -8
  173. package/src/market-data/options-alternatives.ts +39 -4
  174. package/src/market-data/published-apac-sessions.ts +40 -2
  175. package/src/market-data/quotes/export-identity.ts +76 -0
  176. package/src/market-data/quotes/freshness.ts +22 -0
  177. package/src/market-data/quotes/time.ts +42 -1
  178. package/src/market-data/realized-volatility.ts +11 -7
  179. package/src/market-data/tax-equivalent.ts +145 -27
  180. package/src/news/news-model.ts +44 -2
  181. package/src/plugins/builtin/account-management/pane.tsx +2 -2
  182. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  183. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  184. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  185. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  186. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  187. package/src/plugins/builtin/alerts/cli.ts +223 -32
  188. package/src/plugins/builtin/alerts/command.ts +33 -6
  189. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  190. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  191. package/src/plugins/builtin/alerts/events.ts +9 -0
  192. package/src/plugins/builtin/alerts/format.ts +39 -15
  193. package/src/plugins/builtin/alerts/headless.ts +30 -18
  194. package/src/plugins/builtin/alerts/history.ts +1 -0
  195. package/src/plugins/builtin/alerts/index.tsx +86 -12
  196. package/src/plugins/builtin/alerts/live.ts +2 -1
  197. package/src/plugins/builtin/alerts/move-checks.ts +161 -0
  198. package/src/plugins/builtin/alerts/move.ts +181 -0
  199. package/src/plugins/builtin/alerts/pane.tsx +50 -22
  200. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  201. package/src/plugins/builtin/alerts/price.ts +17 -0
  202. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  203. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  204. package/src/plugins/builtin/alerts/storage.ts +22 -7
  205. package/src/plugins/builtin/alerts/types.ts +25 -0
  206. package/src/plugins/builtin/analytics/risk-client.ts +60 -39
  207. package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
  208. package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
  209. package/src/plugins/builtin/analytics/risk-model.ts +68 -1
  210. package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
  211. package/src/plugins/builtin/backtest/engine.ts +4 -2
  212. package/src/plugins/builtin/backtest/window.ts +3 -1
  213. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  214. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  215. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  216. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  217. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  218. package/src/plugins/builtin/changelog/index.tsx +292 -101
  219. package/src/plugins/builtin/changelog/versions.ts +293 -0
  220. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  221. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  222. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  223. package/src/plugins/builtin/chart-composer/intervention-events.ts +105 -0
  224. package/src/plugins/builtin/chart-composer/pane.tsx +21 -7
  225. package/src/plugins/builtin/chat/message/render-state.ts +2 -5
  226. package/src/plugins/builtin/cloud/askg/attached-pane.tsx +10 -5
  227. package/src/plugins/builtin/cloud/askg/controller.ts +141 -5
  228. package/src/plugins/builtin/cloud/askg/executor.ts +113 -4
  229. package/src/plugins/builtin/cloud/askg/manifest.ts +28 -13
  230. package/src/plugins/builtin/cloud/askg/model.ts +14 -4
  231. package/src/plugins/builtin/cloud/askg/pane.tsx +70 -46
  232. package/src/plugins/builtin/cloud/askg/turn-parts.tsx +70 -0
  233. package/src/plugins/builtin/cloud/terminal-relay/engine.ts +50 -130
  234. package/src/plugins/builtin/cloud/terminal-relay/policy.ts +327 -7
  235. package/src/plugins/builtin/cloud/terminal-relay/prompts.tsx +2 -1
  236. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +47 -6
  237. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  238. package/src/plugins/builtin/commodities-energy/index.tsx +1 -3
  239. package/src/plugins/builtin/commodities-energy/view-state.ts +3 -0
  240. package/src/plugins/builtin/cot/headless.ts +14 -2
  241. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  242. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  243. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  244. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  245. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  246. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  247. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  248. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  249. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  250. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  251. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  252. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  253. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  254. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  255. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  256. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  257. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  258. package/src/plugins/builtin/earnings/index.tsx +2 -2
  259. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  260. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  261. package/src/plugins/builtin/econ/figures.ts +13 -0
  262. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  263. package/src/plugins/builtin/econ/index.tsx +5 -3
  264. package/src/plugins/builtin/econ/types.ts +5 -0
  265. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  266. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  267. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  268. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  269. package/src/plugins/builtin/futures/index.tsx +25 -4
  270. package/src/plugins/builtin/futures/model.ts +28 -32
  271. package/src/plugins/builtin/futures/series.ts +4 -3
  272. package/src/plugins/builtin/futures/table.tsx +17 -10
  273. package/src/plugins/builtin/futures/use-board-terms.ts +3 -3
  274. package/src/plugins/builtin/futures-curve/model.ts +3 -10
  275. package/src/plugins/builtin/help/function-card.tsx +2 -1
  276. package/src/plugins/builtin/help/function-index.ts +1 -0
  277. package/src/plugins/builtin/help/index.tsx +3 -3
  278. package/src/plugins/builtin/help/keybindings-editor.tsx +18 -4
  279. package/src/plugins/builtin/insider/client.ts +31 -14
  280. package/src/plugins/builtin/insider/signals-model.ts +2 -7
  281. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  282. package/src/plugins/builtin/iv-history/model.ts +33 -23
  283. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  284. package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
  285. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  286. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  287. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  288. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  289. package/src/plugins/builtin/layout-manager/index.tsx +8 -8
  290. package/src/plugins/builtin/news/headless.ts +2 -2
  291. package/src/plugins/builtin/news/index.tsx +10 -16
  292. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  293. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  294. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  295. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  296. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  297. package/src/plugins/builtin/options/analytics.ts +7 -2
  298. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  299. package/src/plugins/builtin/options/table.ts +3 -2
  300. package/src/plugins/builtin/options/view.tsx +11 -9
  301. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  302. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  303. package/src/plugins/builtin/perps/client.ts +5 -4
  304. package/src/plugins/builtin/perps/headless.ts +134 -124
  305. package/src/plugins/builtin/perps/markets-section.tsx +7 -4
  306. package/src/plugins/builtin/perps/model.ts +8 -4
  307. package/src/plugins/builtin/perps/open-market.ts +4 -4
  308. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  309. package/src/plugins/builtin/plugin-marketplace/pane.tsx +11 -11
  310. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  311. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
  312. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
  313. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
  314. package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
  315. package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
  316. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  317. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
  318. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  319. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
  320. package/src/plugins/builtin/portfolio-list/summary/index.tsx +3 -1
  321. package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
  322. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  323. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  324. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  325. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  326. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  327. package/src/plugins/builtin/research/event-model.ts +9 -1
  328. package/src/plugins/builtin/research/event-sources.ts +22 -0
  329. package/src/plugins/builtin/research/headless.ts +3 -3
  330. package/src/plugins/builtin/sec/headless.ts +48 -6
  331. package/src/plugins/builtin/sec/index.tsx +6 -4
  332. package/src/plugins/builtin/sec/model.ts +4 -1
  333. package/src/plugins/builtin/shared/cloud-upgrade.ts +27 -3
  334. package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
  335. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  336. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  337. package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
  338. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  339. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  340. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  341. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  342. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  343. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  344. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  345. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  346. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  347. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  348. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  349. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  350. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  351. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  352. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  353. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  354. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  355. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  356. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  357. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  358. package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
  359. package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
  360. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  361. package/src/plugins/builtin/ticker-detail/overview/components.tsx +67 -6
  362. package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
  363. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  364. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  365. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +69 -19
  366. package/src/plugins/builtin/ticker-detail/pane.tsx +7 -2
  367. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  368. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  369. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  370. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  371. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  372. package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
  373. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  374. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  375. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  376. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  377. package/src/plugins/builtin/world-indices/client.ts +2 -0
  378. package/src/plugins/compat.ts +15 -0
  379. package/src/plugins/host-link.ts +6 -1
  380. package/src/plugins/installer.ts +53 -3
  381. package/src/portfolio/column-values.ts +14 -4
  382. package/src/portfolio/listed-symbol.ts +78 -0
  383. package/src/portfolio/real-return.ts +172 -0
  384. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  385. package/src/remote/resources.ts +12 -1
  386. package/src/remote/schema.ts +1 -0
  387. package/src/remote/semantic-helpers.ts +29 -1
  388. package/src/remote/semantic-tree.tsx +32 -15
  389. package/src/renderers/browser/config-host.ts +56 -15
  390. package/src/renderers/browser/main.tsx +3 -1
  391. package/src/renderers/browser/ui-host.tsx +1 -0
  392. package/src/renderers/cloudflare/http-proxy.ts +1 -0
  393. package/src/renderers/cloudflare/worker.ts +16 -1
  394. package/src/renderers/dom/boot-frame.ts +2 -2
  395. package/src/renderers/dom/data-table/row.tsx +4 -1
  396. package/src/renderers/dom/desktop/controls.tsx +4 -4
  397. package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
  398. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  399. package/src/renderers/dom/host/input.tsx +4 -1
  400. package/src/renderers/dom/host/tabs.tsx +10 -1
  401. package/src/renderers/dom/styles.css +73 -19
  402. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  403. package/src/renderers/opentui/host.tsx +2 -1
  404. package/src/renderers/share/layout-view.tsx +1 -1
  405. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  406. package/src/sources/gloomberb-cloud/index.ts +31 -2
  407. package/src/sources/gloomberb-cloud/news.ts +35 -12
  408. package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
  409. package/src/sources/provider-router/cached-routes.ts +19 -7
  410. package/src/state/opening-ticker-panes.ts +47 -0
  411. package/src/state/pane-table-export-registry.ts +19 -6
  412. package/src/test-support/cli-context.ts +2 -0
  413. package/src/test-support/preload.ts +8 -1
  414. package/src/theme/colors.ts +9 -1
  415. package/src/theme/themes.ts +62 -15
  416. package/src/theme/tone-contrast.ts +40 -0
  417. package/src/theme/ui-tokens.ts +23 -3
  418. package/src/tickers/batched-lookups.ts +57 -8
  419. package/src/tickers/company-name-listing.ts +156 -14
  420. package/src/tickers/company-name.ts +30 -6
  421. package/src/tickers/instrument-kind.ts +23 -3
  422. package/src/tickers/list.ts +7 -0
  423. package/src/tickers/search/home-listing.ts +31 -9
  424. package/src/tickers/search/index.ts +13 -3
  425. package/src/tickers/search/listing-index.ts +558 -0
  426. package/src/tickers/search/major-listings.chunk.ts +10 -0
  427. package/src/tickers/search/major-listings.json +3346 -0
  428. package/src/tickers/search/ranking.ts +68 -1
  429. package/src/tickers/search/types.ts +4 -0
  430. package/src/tickers/terminal-codes.ts +26 -1
  431. package/src/time-series/calendar-month-returns.ts +47 -0
  432. package/src/time-series/currency-conversion.ts +130 -0
  433. package/src/time-series/hooks.ts +2 -0
  434. package/src/time-series/price-comparison.ts +34 -11
  435. package/src/time-series/resolve-context.ts +3 -0
  436. package/src/time-series/resolve.ts +14 -2
  437. package/src/time-series/spec.ts +1 -0
  438. package/src/time-series/studies/indicators.ts +4 -1
  439. package/src/time-series/types.ts +8 -0
  440. package/src/types/config.ts +13 -0
  441. package/src/types/context-menu.ts +2 -0
  442. package/src/types/data-provider.ts +28 -0
  443. package/src/types/financials.ts +20 -2
  444. package/src/types/headless.ts +12 -0
  445. package/src/types/plugin-commands.ts +140 -0
  446. package/src/types/plugin-context.ts +125 -0
  447. package/src/types/plugin-contributions.ts +55 -0
  448. package/src/types/plugin-definition.ts +234 -0
  449. package/src/types/plugin-notifications.ts +38 -0
  450. package/src/types/plugin-pane-settings.ts +114 -0
  451. package/src/types/plugin-pane-templates.ts +160 -0
  452. package/src/types/plugin-panes.ts +221 -0
  453. package/src/types/plugin-reports.ts +35 -0
  454. package/src/types/plugin-shared.ts +14 -0
  455. package/src/types/plugin-state.ts +71 -0
  456. package/src/types/plugin.ts +14 -1169
  457. package/src/ui/host.tsx +8 -0
  458. package/src/ui/index.tsx +14 -3
  459. package/src/updater/github-releases.ts +23 -0
  460. package/src/utils/cli-output.ts +22 -9
  461. package/src/utils/datetime-format.ts +17 -3
  462. package/src/utils/display-number.ts +15 -0
  463. package/src/utils/double-escape-close.ts +61 -16
  464. package/src/utils/float32-price.ts +24 -0
  465. package/src/utils/forward-dividend.ts +81 -16
  466. package/src/utils/fx-market-hours.ts +11 -0
  467. package/src/utils/plugin-proxy-hosts.json +2 -1
  468. package/src/utils/price-history.ts +7 -6
  469. package/src/utils/report-timing.ts +62 -0
  470. package/src/utils/sec-filings.ts +32 -0
  471. package/src/utils/utc-time.ts +5 -0
@@ -343,8 +343,21 @@ export function rankTickerSearchItems<T extends Pick<TickerSearchRankableItem, "
343
343
  // stocks over funds (GLD) put a thinly traded company first.
344
344
  const exactIssuerRank = new Map<string, number>();
345
345
  const exactIssuerKey = (entry: RankedEntry) => getIssuerGroupKey(entry.item.detail) || `item:${entry.index}`;
346
+ // A lettered symbol is first its US listing, as the app resolves a bare symbol (`quote AAL` is American
347
+ // Airlines): the companies under it that trade on a US exchange, then those with a line the service marks as
348
+ // their home, the listed companies it knows abroad (ISP is Intesa). A word written as a name (`Aeon`) may be the
349
+ // company of that name, so no US line goes ahead for it. A code of digits is one market's code (Hong Kong,
350
+ // Tokyo, Taipei), and the mark says nothing between markets there: BYD's home is Shenzhen, not its Hong Kong
351
+ // 1211, so the server's order of markets stands.
352
+ const exactIssuerUs = new Set<string>();
353
+ const exactIssuerHome = new Set<string>();
354
+ const lettered = /\p{L}/u.test(query);
355
+ const usFirst = readsAsUsTicker(query);
346
356
  for (const entry of filtered) {
347
- if (entry.symbolMatchRank !== 4 || entry.item.providerRank == null) continue;
357
+ if (entry.symbolMatchRank !== 4) continue;
358
+ if (usFirst && isUsLine(entry.item)) exactIssuerUs.add(exactIssuerKey(entry));
359
+ if (lettered && entry.item.homeListing === true) exactIssuerHome.add(exactIssuerKey(entry));
360
+ if (entry.item.providerRank == null) continue;
348
361
  const key = exactIssuerKey(entry);
349
362
  exactIssuerRank.set(key, Math.min(entry.item.providerRank, exactIssuerRank.get(key) ?? Number.POSITIVE_INFINITY));
350
363
  }
@@ -450,6 +463,35 @@ export function rankTickerSearchItems<T extends Pick<TickerSearchRankableItem, "
450
463
  if (aProviderRank !== bProviderRank) return aProviderRank - bProviderRank;
451
464
  return compareFallbackEntries(a, b);
452
465
  }
466
+ // A symbol typed whole asks for a listing under it, not a name. The companies listed under it go saved
467
+ // first, then the ones trading on a US exchange (`exactIssuerUs`), then the ones the service marks a home
468
+ // line of (`exactIssuerHome`), then in the server's order (`exactIssuerRank`). A company whose name only is
469
+ // or starts with the letters gets no head start (AXP Energy for AXP, CAT Strategic Metals for CAT), and a
470
+ // line with no name or venue of its own (a Toronto `JNJ` named JNJ, an old line of ISP) follows the
471
+ // companies.
472
+ if (aExactSymbolRank === 4) {
473
+ const aSaved = isSavedSearchItem(a.item);
474
+ const bSaved = isSavedSearchItem(b.item);
475
+ if (aSaved !== bSaved) return aSaved ? -1 : 1;
476
+ const aPlaceholder = isPlaceholderLine(a.item);
477
+ const bPlaceholder = isPlaceholderLine(b.item);
478
+ if (aPlaceholder !== bPlaceholder) return aPlaceholder ? 1 : -1;
479
+ const aUs = exactIssuerUs.has(exactIssuerKey(a));
480
+ const bUs = exactIssuerUs.has(exactIssuerKey(b));
481
+ if (aUs !== bUs) return aUs ? -1 : 1;
482
+ const aHome = exactIssuerHome.has(exactIssuerKey(a));
483
+ const bHome = exactIssuerHome.has(exactIssuerKey(b));
484
+ if (aHome !== bHome) return aHome ? -1 : 1;
485
+ const aIssuerRank = exactIssuerRank.get(exactIssuerKey(a)) ?? Number.POSITIVE_INFINITY;
486
+ const bIssuerRank = exactIssuerRank.get(exactIssuerKey(b)) ?? Number.POSITIVE_INFINITY;
487
+ if (aIssuerRank !== bIssuerRank) return aIssuerRank - bIssuerRank;
488
+ // Of one company's lines, its US line leads (RACE is Ferrari on NYSE, before Milan).
489
+ if (aUs && exactIssuerKey(a) === exactIssuerKey(b)) {
490
+ const aLine = isUsLine(a.item);
491
+ const bLine = isUsLine(b.item);
492
+ if (aLine !== bLine) return aLine ? -1 : 1;
493
+ }
494
+ }
453
495
  if (b.companyRank !== a.companyRank) {
454
496
  return b.companyRank - a.companyRank;
455
497
  }
@@ -874,6 +916,31 @@ function namesUsCompany(
874
916
  && !!item.searchAliases?.some((alias) => compactSearchText(alias) === typed));
875
917
  }
876
918
 
919
+ /**
920
+ * A search line that names no company or venue of its own: its name is its
921
+ * symbol or empty (an old line search keeps for a ticker, a Toronto `HD`
922
+ * named HD), or it lists on no exchange.
923
+ */
924
+ export function isPlaceholderLine(item: Pick<TickerSearchRankableItem, "label" | "detail" | "kind"> & Partial<TickerSearchRankableItem>): boolean {
925
+ if (item.kind !== "search") return false;
926
+ const name = compactSearchText(item.detail.split("|")[0] || "");
927
+ return !name || name === compactSearchText(item.symbol || item.label) || !(item.exchangeLabel || item.primaryExchangeLabel);
928
+ }
929
+
930
+ /**
931
+ * A lettered symbol typed as a ticker (`AAL`, `aal`), which is its US listing when it has one, rather than a word
932
+ * written as a company's name (`Aeon`) or a code of digits.
933
+ */
934
+ export function readsAsUsTicker(query: string): boolean {
935
+ const typed = query.trim();
936
+ return /\p{L}/u.test(typed) && !/^\p{Lu}\p{Ll}/u.test(typed);
937
+ }
938
+
939
+ /** A search line of a company's own on a US exchange that still trades: not a placeholder, OTC or Toronto line. */
940
+ function isUsLine(item: Pick<TickerSearchRankableItem, "label" | "detail" | "kind"> & Partial<TickerSearchRankableItem>): boolean {
941
+ return item.kind === "search" && !item.delisted && isUsListingExchange(listingVenue(item)) && !isPlaceholderLine(item);
942
+ }
943
+
877
944
  function isDepositaryReceiptType(type?: string): boolean {
878
945
  const normalized = normalizeSearchText(type || "");
879
946
  return normalized.includes("DEPOSITARY") || ["ADR", "ADS", "GDR", "CDR", "BDR"].includes(normalized);
@@ -26,6 +26,10 @@ export interface TickerSearchRankableItem {
26
26
  primaryExchangeLabel?: string;
27
27
  providerRank?: number;
28
28
  popularity?: number;
29
+ /** The service marks the row as its company's home line (`InstrumentSearchResult.homeListing`). */
30
+ homeListing?: boolean;
31
+ /** The service says the line no longer trades (`InstrumentSearchResult.delisting`). */
32
+ delisted?: boolean;
29
33
  searchAliases?: string[];
30
34
  /**
31
35
  * The names the service sent the row for (`InstrumentSearchResult.searchAliases`: a trade name, or the name a
@@ -1,7 +1,7 @@
1
1
  import { futuresContractByCode } from "../market-data/futures-board";
2
2
  import { getListingSymbol, hongKongListingCode, tickerHasListingSuffix } from "../sources/listing-symbols";
3
3
  import { isCurrencyCode } from "../utils/currency-pair";
4
- import { isKnownExchangeCode, isUsListingExchange } from "../utils/exchanges";
4
+ import { canonicalExchange, isKnownExchangeCode, isPredictionMarketExchange, isSharedExchangeCode, isUsListingExchange } from "../utils/exchanges";
5
5
 
6
6
  /**
7
7
  * A listing written the way a market data terminal names it, read as the
@@ -473,6 +473,31 @@ export function readNearMissListing(raw: string): NearMissListing | null {
473
473
  return tickerHasListingSuffix(symbol) ? { typed, symbol } : null;
474
474
  }
475
475
 
476
+ /** `TYO:7203`, `LON:LSEG`, `NASDAQ:AAPL`: an exchange's code, a colon, then the symbol, as spreadsheets and quote sites write a listing. */
477
+ const VENUE_FIRST = /^([A-Z][A-Z0-9]{1,11}):([A-Z0-9][A-Z0-9.&-]{0,19})$/;
478
+
479
+ /**
480
+ * A listing written venue first, as Google Sheets and quote sites write it
481
+ * (`TYO:7203`, `LON:LSEG`, `NASDAQ:AAPL`), read as the symbol on that venue
482
+ * (`7203:JPX`, `LSEG:LSE`, `AAPL:NASDAQ`): the part before the colon is an
483
+ * exchange code the app knows and the part after it is none, so `SAN:EPA`,
484
+ * written symbol first, and `BATS:LSE`, whose symbol is also a venue's code,
485
+ * stay as typed, as does a ticker before a two-letter market code (`ICE:US`,
486
+ * `ASX:AU`, `BSE:IN`, `AMS:SW`), the code it is written symbol first with.
487
+ * A code that names several venues (`TSE:7203`) is kept for the listing to
488
+ * settle. A prediction market's id (`KALSHI:...`) is not a listing. Null for
489
+ * anything else.
490
+ */
491
+ export function readVenueFirstListing(raw: string): NearMissListing | null {
492
+ const typed = raw.trim();
493
+ const match = VENUE_FIRST.exec(typed.toUpperCase());
494
+ if (!match) return null;
495
+ const [, code, symbol] = match as unknown as [string, string, string];
496
+ if (!isKnownExchangeCode(code) || isKnownExchangeCode(symbol) || isPredictionMarketExchange(code)) return null;
497
+ if (symbol.length === 2 && BLOOMBERG_MARKETS[symbol]) return null;
498
+ return { typed, symbol: `${symbol}:${isSharedExchangeCode(code) ? code : canonicalExchange(code)}` };
499
+ }
500
+
476
501
  /** `Read WFC.N as WFC:NYSE.`, for a command's warnings. */
477
502
  export function terminalCodeReadAs(code: Pick<TerminalListingCode, "typed" | "key">): string {
478
503
  return `Read ${/\s/.test(code.typed) ? `"${code.typed}"` : code.typed} as ${code.key}.`;
@@ -0,0 +1,47 @@
1
+ import type { ChartRequest, InstrumentRef } from "../market-data/request-types";
2
+ import type { QueryEntry } from "../market-data/result-types";
3
+ import { sessionCalendarTimeZone } from "../market-data/market/freshness";
4
+ import type { PricePoint } from "../types/financials";
5
+ import { zonedDateTimeParts } from "../utils/zoned-date-time";
6
+
7
+ const DAY_MS = 86_400_000;
8
+
9
+ /** The month now on the venue's calendar: a coin's, and a venue without a known zone's, in UTC. */
10
+ export function venueMonth(now: number, exchange: string): { year: number; month: number } {
11
+ const { year, month } = zonedDateTimeParts(now, sessionCalendarTimeZone(exchange) ?? "UTC");
12
+ return { year, month };
13
+ }
14
+
15
+ /**
16
+ * The trailing range of daily closes over `years` (one year or five), read
17
+ * when a source answers no dated history (`calendarMonthReturnsRequest` failed
18
+ * or came back empty). It starts days into the month before the window, so
19
+ * five years of month-end closes give 59 returns, not 60.
20
+ */
21
+ export function trailingDailyClosesRequest(instrument: InstrumentRef, years: number): ChartRequest {
22
+ return { instrument, bufferRange: years <= 1 ? "1Y" : "5Y", granularity: "resolution", resolution: "1d" };
23
+ }
24
+
25
+ /**
26
+ * The daily closes `years` × 12 calendar-month returns are read from: from the
27
+ * first day of the month before the window's first month, so every month has
28
+ * the close it is measured from, to the end of the UTC day, so a day keeps one
29
+ * request. The window ends with the last month finished on the venue's
30
+ * calendar. KELLY's History tab, its report and its screenshots ask for it alike.
31
+ */
32
+ export function calendarMonthReturnsRequest(instrument: InstrumentRef, years: number, now = Date.now()): ChartRequest {
33
+ const { year, month } = venueMonth(now, instrument.exchange ?? "");
34
+ return {
35
+ ...trailingDailyClosesRequest(instrument, years),
36
+ granularity: "detail",
37
+ barSize: "1d",
38
+ startDate: new Date(Date.UTC(year, month - 1 - (years * 12 + 1), 1)),
39
+ endDate: new Date(Math.floor(now / DAY_MS) * DAY_MS + DAY_MS),
40
+ };
41
+ }
42
+
43
+ /** Whether a dated history read is over and gave no closes, so the trailing range is read instead. */
44
+ export function historyReadUnanswered(entry: Pick<QueryEntry<PricePoint[]>, "phase" | "data" | "lastGoodData"> | null | undefined): boolean {
45
+ if (!entry || (entry.phase !== "ready" && entry.phase !== "error")) return false;
46
+ return !(entry.data ?? entry.lastGoodData)?.length;
47
+ }
@@ -0,0 +1,130 @@
1
+ import { dailyFxCloses, dailyFxLeg, FxHistoryError, fxCloseOnOrBefore, type FxCloses, type FxHistoryClient } from "../market-data/fx-closes";
2
+ import { resolveCurrencyUnit } from "../utils/currency-units";
3
+ import { logFailure } from "../utils/log-failure";
4
+ import type { ResolvedSeries, TimeSeriesPoint } from "./types";
5
+
6
+ /**
7
+ * A comparison in one currency (`fn CMP THYAO:BIST MSFT --currency USD`): each
8
+ * leg's prices converted at the daily FX close of their day, so a leg's return
9
+ * carries its currency's move against the one asked for.
10
+ */
11
+
12
+ /** USD per unit of a currency at each completed daily close from `startDate` (YYYY-MM-DD) to today. */
13
+ export type LoadFxCloses = (currency: string, startDate: string) => Promise<FxCloses>;
14
+
15
+ const DAY_MS = 86_400_000;
16
+
17
+ /** Reads a currency's daily USD closes from `startDate` to today, as `loadFxCloses` wants them. */
18
+ export async function loadDailyFxCloses(currency: string, startDate: string, client: FxHistoryClient, now = new Date()): Promise<FxCloses> {
19
+ const leg = dailyFxLeg(currency);
20
+ if (!leg) throw new FxHistoryError("unavailable");
21
+ // Every weekday from a week before the start, so the first bar has the close before it.
22
+ const from = Date.parse(`${startDate}T00:00:00Z`) - 7 * DAY_MS;
23
+ const days = Math.max(14, Math.ceil((now.getTime() - from) / DAY_MS) + 2);
24
+ const response = await client.getCloudHistory(leg.instrument.symbol, leg.instrument.exchange ?? "", {
25
+ interval: "1day", startDate: new Date(from).toISOString().slice(0, 10), endDate: now.toISOString().slice(0, 10), outputsize: days,
26
+ });
27
+ return dailyFxCloses(response, leg, now, days + 10);
28
+ }
29
+
30
+ function scaled(value: number | null | undefined, factor: number): number | null | undefined {
31
+ return typeof value === "number" && Number.isFinite(value) ? value * factor : value;
32
+ }
33
+
34
+ /**
35
+ * Prices in `from` units as prices in the target currency: each point's
36
+ * prices times USD per `from` over USD per target at the last completed close
37
+ * on or before its day (a USD side is 1), and over the sub-unit divisor of a
38
+ * price in pence or cents. A point with no close in the week before it is
39
+ * left out, not converted at another day's rate. Volume is left alone.
40
+ */
41
+ function convertPricePoints(
42
+ points: readonly TimeSeriesPoint[],
43
+ { dayOf, divisor = 1, fromCloses, toCloses }: {
44
+ dayOf: (point: TimeSeriesPoint) => string;
45
+ divisor?: number;
46
+ /** USD per unit of the prices' currency; null when it is USD. */
47
+ fromCloses: FxCloses | null;
48
+ /** USD per unit of the target; null when it is USD. */
49
+ toCloses: FxCloses | null;
50
+ },
51
+ ): { points: TimeSeriesPoint[]; missing: number } {
52
+ let missing = 0;
53
+ const converted: TimeSeriesPoint[] = [];
54
+ for (const point of points) {
55
+ const day = dayOf(point);
56
+ const from = fromCloses ? fxCloseOnOrBefore(fromCloses, day)?.rate : 1;
57
+ const to = toCloses ? fxCloseOnOrBefore(toCloses, day)?.rate : 1;
58
+ if (from == null || to == null || !(to > 0)) {
59
+ missing += 1;
60
+ continue;
61
+ }
62
+ const factor = from / to / divisor;
63
+ converted.push({
64
+ ...point,
65
+ value: scaled(point.value, factor) ?? null,
66
+ ...point.rawValue !== undefined ? { rawValue: scaled(point.rawValue, factor) ?? null } : {},
67
+ ...point.open !== undefined ? { open: scaled(point.open, factor) } : {},
68
+ ...point.high !== undefined ? { high: scaled(point.high, factor) } : {},
69
+ ...point.low !== undefined ? { low: scaled(point.low, factor) } : {},
70
+ ...point.close !== undefined ? { close: scaled(point.close, factor) } : {},
71
+ });
72
+ }
73
+ return { points: converted, missing };
74
+ }
75
+
76
+ export interface CurrencySeriesOutcome {
77
+ series: ResolvedSeries;
78
+ /** Why the series stays in its own currency, or what it lost, when it does. */
79
+ notice?: string;
80
+ }
81
+
82
+ /** `TRY/share` as `USD/share`: the unit's currency, in its own spelling or its sub-unit's, replaced. */
83
+ function unitIn(unit: string, priceCurrency: string, target: string): string {
84
+ return unit.startsWith(priceCurrency) ? `${target}${unit.slice(priceCurrency.length)}` : unit;
85
+ }
86
+
87
+ /**
88
+ * A price series in the target currency, from its listing's daily FX closes
89
+ * and the target's. A series already in it is left as it is; one whose
90
+ * currency is unknown or whose closes cannot be read stays in its own
91
+ * currency, with the reason.
92
+ */
93
+ export async function currencySeries(
94
+ series: ResolvedSeries,
95
+ { target, priceCurrency, loadCloses, dayOf }: {
96
+ target: string;
97
+ priceCurrency: string | undefined;
98
+ loadCloses: LoadFxCloses | undefined;
99
+ dayOf: (point: TimeSeriesPoint) => string;
100
+ },
101
+ ): Promise<CurrencySeriesOutcome> {
102
+ const unit = resolveCurrencyUnit(priceCurrency);
103
+ if (!unit.currency) return { series, notice: `price currency unknown; not converted to ${target}.` };
104
+ if (unit.currency === target && unit.divisor === 1) return { series };
105
+ const days = series.points.map(dayOf).filter(Boolean).sort();
106
+ if (!days.length) return { series };
107
+ const read = (currency: string) => currency === "USD" ? Promise.resolve(null)
108
+ : loadCloses ? loadCloses(currency, days[0]!) : Promise.reject(new FxHistoryError("unavailable"));
109
+ const [fromCloses, toCloses] = await Promise.all([
110
+ unit.currency === target ? null : read(unit.currency),
111
+ unit.currency === target ? null : read(target),
112
+ ]).catch((error) => {
113
+ logFailure("currency-conversion", "Loading daily FX closes failed", null)(error);
114
+ return [undefined, undefined] as const;
115
+ });
116
+ if (fromCloses === undefined) return { series, notice: `${unit.currency}/${target} daily closes unavailable; left in ${unit.currency}.` };
117
+ const { points, missing } = convertPricePoints(series.points, { dayOf, divisor: unit.divisor, fromCloses, toCloses: toCloses ?? null });
118
+ const raw = priceCurrency!.trim();
119
+ return {
120
+ series: {
121
+ ...series,
122
+ points,
123
+ unit: unitIn(series.unit, raw, target),
124
+ ...series.rawUnit !== undefined ? { rawUnit: unitIn(series.rawUnit, raw, target) } : {},
125
+ unitGroup: series.unitGroup.replace(/:[^:]+$/, `:${target}`),
126
+ convertedFrom: unit.currency,
127
+ },
128
+ ...(missing ? { notice: `${missing} bar${missing === 1 ? "" : "s"} with no ${unit.currency}/${target} close in the week before left out.` } : {}),
129
+ };
130
+ }
@@ -6,6 +6,7 @@ import { useAssetData, useCapabilityInvoker } from "../plugins/runtime";
6
6
  import { getSharedRegistry } from "../plugins/registry";
7
7
  import { createChartSeriesResolver } from "../capabilities";
8
8
  import { loadFuturesPriceUnit } from "../market-data/futures-contract";
9
+ import { loadDailyFxCloses } from "./currency-conversion";
9
10
  import { useAppSelector } from "../state/app/context";
10
11
  import type { FredSeriesRequest } from "../sources/gloomberb-cloud/fred-series";
11
12
  import type { TickerRecord } from "../types/ticker";
@@ -83,6 +84,7 @@ export function useResolvedChartSpec(
83
84
  resolveCapabilitySeries: createChartSeriesResolver(capabilityInvoker),
84
85
  capabilityRefreshMs: registeredSeriesRefreshMs,
85
86
  loadFuturesPriceUnit: (symbol: string) => loadFuturesPriceUnit(symbol),
87
+ loadFxCloses: (currency: string, startDate: string) => loadDailyFxCloses(currency, startDate, apiClient),
86
88
  }), [capabilityInvoker, dataProvider]);
87
89
  return useChartResolution(hydratedSpec, sources, { ...options, snapshot });
88
90
  }
@@ -13,16 +13,34 @@ import {
13
13
  const PRICE_COMPARISON_BASIS = "Price returns in each listing's currency; cash distributions and FX conversion excluded.";
14
14
  const TOTAL_COMPARISON_BASIS = "Total returns in each listing's currency; cash distributions reinvested at the ex-date close, FX conversion excluded.";
15
15
 
16
+ /** `MSFT and THYAO:BIST from TRY`: the legs converted into the chart's currency, by the currency each was in. */
17
+ function convertedText(legs: ReadonlyArray<{ label: string; entry: ResolvedSeries | undefined }>): string | null {
18
+ const byCurrency = new Map<string, string[]>();
19
+ for (const { label, entry } of legs) {
20
+ if (entry?.convertedFrom) byCurrency.set(entry.convertedFrom, [...byCurrency.get(entry.convertedFrom) ?? [], label]);
21
+ }
22
+ if (!byCurrency.size) return null;
23
+ return [...byCurrency].map(([currency, labels]) => `${listLabels(labels)} from ${currency}`).join(", ");
24
+ }
25
+
16
26
  /**
17
27
  * What a comparison's returns are: price returns, or total returns when the
18
28
  * chart asked for them, naming any leg whose distributions could not be read
19
- * (it stays a price return, and the others do not wait for it).
29
+ * (it stays a price return, and the others do not wait for it). A chart in one
30
+ * currency names the legs converted into it.
20
31
  */
21
32
  function comparisonBasis(spec: ChartSpec, legs: ReadonlyArray<{ label: string; entry: ResolvedSeries | undefined }>): string {
22
- if (spec.viewport.totalReturn !== true) return PRICE_COMPARISON_BASIS;
23
- const priceOnly = legs.filter(({ entry }) => entry?.returnBasis === "price").map(({ label }) => label);
24
- if (priceOnly.length === legs.length && legs.length > 0) return PRICE_COMPARISON_BASIS;
25
- return priceOnly.length ? `${TOTAL_COMPARISON_BASIS} Price return for ${priceOnly.join(", ")}: distribution history unavailable.` : TOTAL_COMPARISON_BASIS;
33
+ const target = spec.viewport.currency;
34
+ const priceOnly = spec.viewport.totalReturn === true ? legs.filter(({ entry }) => entry?.returnBasis === "price").map(({ label }) => label) : [];
35
+ const total = spec.viewport.totalReturn === true && !(priceOnly.length === legs.length && legs.length > 0);
36
+ if (!target) {
37
+ if (!total) return PRICE_COMPARISON_BASIS;
38
+ return priceOnly.length ? `${TOTAL_COMPARISON_BASIS} Price return for ${priceOnly.join(", ")}: distribution history unavailable.` : TOTAL_COMPARISON_BASIS;
39
+ }
40
+ const converted = convertedText(legs);
41
+ const basis = `${total ? "Total" : "Price"} returns in ${target}${converted ? `, ${converted} at each day's FX close` : ""}; ${
42
+ total ? "cash distributions reinvested at the ex-date close." : "cash distributions excluded."}`;
43
+ return total && priceOnly.length ? `${basis} Price return for ${priceOnly.join(", ")}: distribution history unavailable.` : basis;
26
44
  }
27
45
 
28
46
  export interface PriceComparison {
@@ -150,14 +168,19 @@ export function priceComparisonSeriesIds(spec: ChartSpec): string[] | null {
150
168
  /**
151
169
  * What a total-return chart's price levels are when it is not a comparison (the
152
170
  * raw price axis): prices with cash distributions reinvested, not what the
153
- * listing quotes. Null for a price chart, and when no leg is a total return.
171
+ * listing quotes. A chart in one currency names the legs converted into it.
172
+ * Null for a price chart in each listing's currency, and when no leg is a
173
+ * total return or was converted.
154
174
  */
155
- export function totalReturnLevelsNotice(spec: ChartSpec, series: readonly ResolvedSeries[]): string | null {
156
- if (spec.viewport.totalReturn !== true) return null;
157
- const legs = series.filter((entry) => entry.returnBasis !== undefined);
158
- if (!legs.some((entry) => entry.returnBasis === "total")) return null;
175
+ export function priceLevelsNotice(spec: ChartSpec, series: readonly ResolvedSeries[]): string | null {
176
+ const target = spec.viewport.currency;
177
+ const converted = target ? convertedText(series.map((entry) => ({ label: entry.label.replace(/ (?:Close|Price|Open|High|Low|Total return)$/, ""), entry }))) : null;
178
+ const conversion = converted ? `${converted} at each day's FX close` : null;
179
+ const legs = spec.viewport.totalReturn === true ? series.filter((entry) => entry.returnBasis !== undefined) : [];
180
+ if (!legs.some((entry) => entry.returnBasis === "total")) return conversion ? `Prices in ${target}: ${conversion}.` : null;
159
181
  const priceOnly = legs.filter((entry) => entry.returnBasis === "price").map((entry) => entry.label);
160
- return `Total return levels in each listing's currency: prices include cash distributions reinvested at the ex-date close, so they are not quoted prices; FX conversion excluded.${
182
+ return `Total return levels in ${target ?? "each listing's currency"}: prices include cash distributions reinvested at the ex-date close, so they are not quoted prices; ${
183
+ conversion ?? (target ? "none needed converting" : "FX conversion excluded")}.${
161
184
  priceOnly.length ? ` Price only for ${priceOnly.join(", ")}: distribution history unavailable.` : ""}`;
162
185
  }
163
186
 
@@ -6,6 +6,7 @@ import type { DataProvider, MarketDataRequestContext } from "../types/data-provi
6
6
  import type { CorporateActionsData, EarningsAction, Quote, QuoteMetadata, TickerFinancials } from "../types/financials";
7
7
  import type { EarningsHistoryPayload } from "../api-client/earnings";
8
8
  import type { FredSeriesLoadResult, FredSeriesRequest } from "../sources/gloomberb-cloud/fred-series";
9
+ import type { LoadFxCloses } from "./currency-conversion";
9
10
  import { chartQuoteOverrideKeyForSource } from "./live-quotes";
10
11
  import { publicTickerKey } from "../utils/exchanges";
11
12
  import type {
@@ -40,6 +41,8 @@ export interface ChartResolveSources {
40
41
  * the terms do not say. Without it a future's price is in its currency alone.
41
42
  */
42
43
  loadFuturesPriceUnit?: (symbol: string) => Promise<string | null>;
44
+ /** A currency's daily USD closes, for a chart converted into one currency (`viewport.currency`). */
45
+ loadFxCloses?: LoadFxCloses;
43
46
  /** Provider-neutral boundary for plugin-owned chart series. */
44
47
  resolveCapabilitySeries?: (
45
48
  source: Extract<ChartSeriesSpec["source"], { kind: "capability" }>,
@@ -48,13 +48,15 @@ import { chartPriceHistoryIntegrityNotices } from "./market";
48
48
  import { maxStudyWarmupPoints, resolveStudies } from "./studies/resolve";
49
49
  import { clipSeriesToWindow } from "./alignment";
50
50
  import { totalReturnSeries } from "./total-return";
51
+ import { currencySeries } from "./currency-conversion";
51
52
  import {
52
53
  bufferPriceComparison,
53
54
  clipPriceComparison,
55
+ observationDate,
54
56
  priceComparisonBoundsForSeries,
55
57
  priceComparisonSeriesIds,
56
58
  resolvePriceComparison,
57
- totalReturnLevelsNotice,
59
+ priceLevelsNotice,
58
60
  } from "./price-comparison";
59
61
  import { chartQuoteOverrideKeyForSource } from "./live-quotes";
60
62
  import { coinLegsAtSessionClose } from "./coin-session-close";
@@ -991,6 +993,16 @@ async function resolveChartSpecPass(
991
993
  result = outcome.series;
992
994
  if (outcome.notice) warnings.push(`${instrumentLabel(resolvedSource)}: ${outcome.notice}`);
993
995
  }
996
+ // A chart in one currency converts each price at its day's FX close, after any distributions are reinvested in the listing's own.
997
+ const targetCurrency = spec.viewport.currency;
998
+ if (targetCurrency && totalReturnFieldId(source.fieldId)) {
999
+ const converted = await currencySeries(result, {
1000
+ target: targetCurrency, priceCurrency: merged.quote?.currency || quoteMetadata?.currency,
1001
+ loadCloses: sources.loadFxCloses, dayOf: (point) => observationDate(point.date.getTime(), result),
1002
+ });
1003
+ result = converted.series;
1004
+ if (converted.notice) warnings.push(`${instrumentLabel(resolvedSource)}: ${converted.notice}`);
1005
+ }
994
1006
  if (marketField && history?.historyStart !== undefined && Number.isFinite(history.historyStart)) {
995
1007
  result.historyStart = new Date(history.historyStart);
996
1008
  }
@@ -1145,7 +1157,7 @@ async function resolveChartSpecPass(
1145
1157
  );
1146
1158
  if (priceComparison) warnings.push(priceComparison.notice);
1147
1159
  // A raw-price chart of total returns is no comparison, and its levels say what they are instead.
1148
- const returnBasisNotice = priceComparison ? null : totalReturnLevelsNotice(spec, rawSeries);
1160
+ const returnBasisNotice = priceComparison ? null : priceLevelsNotice(spec, rawSeries);
1149
1161
  if (returnBasisNotice) warnings.push(returnBasisNotice);
1150
1162
  warnings.push(...chartPriceHistoryIntegrityNotices(priceHistoryIntegrity));
1151
1163
  warnings.push(...financialPeriodCoverageWarnings(financialPeriodCoverage(spec, resolved)));
@@ -334,6 +334,7 @@ export function normalizeChartSpec(value: unknown, fallback: ChartSpec = DEFAULT
334
334
  : undefined,
335
335
  ...(viewport?.extendedHours === true ? { extendedHours: true } : {}),
336
336
  ...(viewport?.totalReturn === true ? { totalReturn: true } : {}),
337
+ ...(typeof viewport?.currency === "string" && /^[A-Z]{3}$/.test(viewport.currency) ? { currency: viewport.currency } : {}),
337
338
  },
338
339
  panels,
339
340
  series,
@@ -1,5 +1,6 @@
1
1
  import { mergePriceHistoryIntegrity } from "../../utils/price-history-integrity";
2
2
  import { isRealizedVolatilityEstimator, rollingRealizedVolatility } from "../../market-data/realized-volatility";
3
+ import { currencyPairInstrument } from "../../market-data/bars-per-year";
3
4
  import { INDEX_MEMBERS_VOLUME_LABEL } from "../../market-data/market/index-level";
4
5
  import { averageTrueRange } from "../trader-studies";
5
6
  import type { ChartStudySpec, ResolvedSeries, TimeSeriesPoint } from "../types";
@@ -107,6 +108,8 @@ export function resolveRealizedVolatility(spec: ChartStudySpec, input: ResolvedS
107
108
  // would turn two separated returns into adjacent observations.
108
109
  const byDate = new Map(input.points.map((point) => [point.date.getTime(), point]));
109
110
  const source = [...byDate.values()].sort((a, b) => a.date.getTime() - b.date.getTime());
111
+ // A currency pair's year is every weekday (260 bars), however short the range charted.
112
+ const instrument = currencyPairInstrument(input.listing?.symbol, input.listing?.exchange);
110
113
  const calculated = rollingRealizedVolatility(source.map((point) => ({
111
114
  date: point.date,
112
115
  close: point.provenance?.priceHistoryIntegrity || point.provenance?.valuationPriceIssues?.length
@@ -114,7 +117,7 @@ export function resolveRealizedVolatility(spec: ChartStudySpec, input: ResolvedS
114
117
  open: point.open ?? undefined,
115
118
  high: point.high ?? undefined,
116
119
  low: point.low ?? undefined,
117
- })), { windows: [window], estimator });
120
+ })), { windows: [window], estimator, instrument });
118
121
  const warmup = studyWarmupPoints(spec);
119
122
  const points = calculated.map((point, index): TimeSeriesPoint => {
120
123
  const original = source[index]!;
@@ -115,6 +115,12 @@ export interface ChartViewportSpec {
115
115
  * is reinvested at the close of its ex-date bar. Price returns otherwise.
116
116
  */
117
117
  totalReturn?: boolean;
118
+ /**
119
+ * Security price series are converted into this currency (ISO code) at each
120
+ * day's FX close, so their returns carry their currency's move. Each in its
121
+ * listing's currency otherwise.
122
+ */
123
+ currency?: string;
118
124
  }
119
125
 
120
126
  export interface ChartSpec {
@@ -196,6 +202,8 @@ export interface ResolvedSeries {
196
202
  * source gave none to reinvest (`warning` says why).
197
203
  */
198
204
  returnBasis?: "total" | "price";
205
+ /** The listing currency a price series was converted from into the chart's `viewport.currency`. */
206
+ convertedFrom?: string;
199
207
  unitGroup: string;
200
208
  /**
201
209
  * The unit the legend states beside each value, read bare as FUT prints its
@@ -132,6 +132,11 @@ export interface FloatingPaneEntry {
132
132
  width: number;
133
133
  height: number;
134
134
  zIndex?: number;
135
+ /**
136
+ * Floating windows stacked as tabs share this key and one rect; the one
137
+ * in front (highest z) is shown (layout/pane-manager/floating-stack.ts).
138
+ */
139
+ stack?: string;
135
140
  }
136
141
 
137
142
  interface DetachedPaneEntry {
@@ -371,8 +376,16 @@ export interface AppConfig {
371
376
  * status bar, for a screen that is shown rather than worked at. Absent is off.
372
377
  */
373
378
  presentationMode?: boolean;
379
+ /**
380
+ * The market the header shows. Absent until the user picks one: the
381
+ * benchmark of this machine's time zone. Kept on this machine only.
382
+ */
383
+ headerMarket?: HeaderMarketChoice;
374
384
  }
375
385
 
386
+ /** A benchmark the header offers, by its id (`hang-seng`), or any listing the user searched for. */
387
+ export type HeaderMarketChoice = { benchmark: string } | { symbol: string; exchange?: string };
388
+
376
389
  export const TICKER_RESEARCH_PANE_ID = "ticker-research";
377
390
  export const LEGACY_TICKER_DETAIL_PANE_ID = "ticker-detail";
378
391
  export const CHART_COMPOSER_PANE_ID = "chart-composer";
@@ -27,6 +27,8 @@ export interface ContextMenuActionItem extends ContextMenuItemBase {
27
27
  label: string;
28
28
  onSelect?: () => void | Promise<void>;
29
29
  submenu?: ContextMenuItem[];
30
+ /** The prompt the item answers (a pane's Approve), as `metadata.scope` on the menu drawn in the app. */
31
+ remoteScope?: string;
30
32
  }
31
33
 
32
34
  export interface ContextMenuRoleItem extends ContextMenuItemBase {
@@ -73,6 +73,30 @@ export interface SecFilingItem {
73
73
  * the page the results or the news are on, not the cover page.
74
74
  */
75
75
  pressReleaseUrl?: string;
76
+ /**
77
+ * What a Form 4 did, when Gloom Cloud read it for the list: whose shares,
78
+ * the main transaction and its shares and average price. A company's list
79
+ * holds the Form 4s it filed as an owner of other companies' shares, which
80
+ * only this names. Absent from other forms and from an older server.
81
+ */
82
+ form4?: SecForm4Trade;
83
+ }
84
+
85
+ /** A Form 4's main transaction, the one moving the most shares. */
86
+ export interface SecForm4Trade {
87
+ /** The first reporting owner, as filed. */
88
+ ownerName: string;
89
+ issuerName: string;
90
+ issuerTicker: string | null;
91
+ issuerCik: string | null;
92
+ /** The SEC transaction code: P purchase, S sale, A award, G gift, F tax withholding, M exercise, ... */
93
+ code: string;
94
+ side: "buy" | "sell" | "acquired" | "disposed";
95
+ shares: number;
96
+ /** Share-weighted average price; null when no line gives one. */
97
+ price: number | null;
98
+ /** True when the transaction is in options or other derivatives (a form with no share lines): `shares` counts those. */
99
+ derivative?: boolean;
76
100
  }
77
101
 
78
102
  export interface SecFilingDocument {
@@ -140,12 +164,16 @@ export interface EarningsEvent {
140
164
  revenueActual: number | null;
141
165
  surprise: number | null;
142
166
  timing: "BMO" | "AMC" | "TNS" | "";
167
+ /** When the results come out, as the company announced it (Berkshire's Saturday 13:00Z); absent when it named no time. */
168
+ releaseAt?: string | null;
143
169
  }
144
170
 
145
171
  /** The reads a provider may send in batches (`DataProvider.batchesReads`). */
146
172
  export type BatchedReadMethod = "getPriceHistory" | "getOptionsChain";
147
173
 
148
174
  export interface MarketDataRequestContext {
175
+ /** An options chain of the contracts adjusted for a corporate action (ETHA1), in place of the standard ones. */
176
+ adjustedOptions?: boolean;
149
177
  brokerId?: string;
150
178
  brokerInstanceId?: string;
151
179
  instrument?: BrokerContractRef | null;