gloomberb 0.20.1 → 0.20.2

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 (422) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +1 -1
  4. package/src/account/auth-model.ts +20 -1
  5. package/src/account/upgrade-dialog.tsx +8 -4
  6. package/src/api-client/askg.ts +7 -1
  7. package/src/api-client/auth.ts +27 -0
  8. package/src/api-client/catalysts.ts +2 -0
  9. package/src/api-client/company-kpis.ts +2 -1
  10. package/src/api-client/cot.ts +14 -2
  11. package/src/api-client/data.ts +3 -2
  12. package/src/api-client/earnings.ts +46 -3
  13. package/src/api-client/futures-curve.ts +17 -0
  14. package/src/api-client/index.ts +4 -1
  15. package/src/api-client/one-tap-reasons.ts +42 -0
  16. package/src/api-client/perps.ts +2 -1
  17. package/src/api-client/request.ts +3 -1
  18. package/src/api-client/research-activity.ts +16 -3
  19. package/src/api-client/types/filings-and-calls.ts +3 -0
  20. package/src/api-client/types/search.ts +3 -0
  21. package/src/app/keybindings/chord.ts +153 -9
  22. package/src/app/keybindings/index.ts +1 -1
  23. package/src/app/keybindings/labels.ts +49 -6
  24. package/src/app/runtime/desktop-deeplink.ts +73 -8
  25. package/src/app.tsx +7 -1
  26. package/src/architecture/core-builtin-allowlist.json +1 -2
  27. package/src/architecture/pane-tabs-allowlist.json +2 -1
  28. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  29. package/src/architecture/ui-literals-allowlist.json +8 -8
  30. package/src/brokers/broker-portfolio-sync.ts +1 -1
  31. package/src/cli/bank-section.ts +26 -12
  32. package/src/cli/commands/market.ts +266 -75
  33. package/src/cli/commands/ticker.ts +12 -7
  34. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  35. package/src/cli/desktop-pane-shot.ts +15 -0
  36. package/src/cli/entry.ts +5 -0
  37. package/src/cli/export-source.ts +7 -1
  38. package/src/cli/freshness.ts +0 -16
  39. package/src/cli/fx-pair.ts +64 -12
  40. package/src/cli/fx-quote-rate.ts +144 -0
  41. package/src/cli/glossary.ts +5 -0
  42. package/src/cli/history-back-adjust.ts +122 -0
  43. package/src/cli/history-rows.ts +114 -10
  44. package/src/cli/index.ts +4 -1
  45. package/src/cli/known-gaps.ts +45 -3
  46. package/src/cli/listing-arg.ts +48 -4
  47. package/src/cli/name-entries.ts +25 -5
  48. package/src/cli/pane-functions/catalog.ts +12 -2
  49. package/src/cli/pane-functions/dom.ts +4 -2
  50. package/src/cli/pane-functions/headless.ts +8 -5
  51. package/src/cli/pane-functions/index.ts +3 -0
  52. package/src/cli/pane-functions/resolver.ts +4 -1
  53. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  54. package/src/cli/pane-functions/screenshot-payload.ts +130 -66
  55. package/src/cli/pane-functions/screenshot-render.ts +14 -2
  56. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  57. package/src/cli/symbol-rows.ts +22 -2
  58. package/src/cli/ticker-resolution.ts +74 -17
  59. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  60. package/src/components/chart/composite/composite-chart.tsx +8 -1
  61. package/src/components/chart/composite/format.ts +16 -1
  62. package/src/components/chart/composite/legend.tsx +4 -3
  63. package/src/components/chart/composite/panel-labels.ts +2 -1
  64. package/src/components/chart/composite/panel-surface.tsx +33 -4
  65. package/src/components/chart/composite/time-scale.ts +1 -1
  66. package/src/components/chart/composite/toolbar.tsx +8 -4
  67. package/src/components/chart/composite/types.ts +17 -1
  68. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  69. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  70. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  71. package/src/components/chart-table/axis.ts +11 -0
  72. package/src/components/command-bar/assist/inventory.ts +3 -2
  73. package/src/components/command-bar/commands/collection-list.ts +3 -2
  74. package/src/components/command-bar/panel/layout.ts +8 -1
  75. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  76. package/src/components/command-bar/panel/state.ts +4 -0
  77. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  78. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  79. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  80. package/src/components/company-logo.tsx +2 -2
  81. package/src/components/data-table/view.tsx +11 -2
  82. package/src/components/feed-data-table/stack-view.tsx +20 -6
  83. package/src/components/feedback-dialog.tsx +3 -1
  84. package/src/components/form-modal/field-row.tsx +1 -1
  85. package/src/components/form-modal/routes.ts +1 -0
  86. package/src/components/index.ts +1 -1
  87. package/src/components/layout/header.tsx +12 -3
  88. package/src/components/layout/market-summary.ts +2 -1
  89. package/src/components/layout/pane/footer/index.tsx +9 -5
  90. package/src/components/layout/pane/footer/model.ts +26 -10
  91. package/src/components/layout/pane/footer/registration.tsx +60 -1
  92. package/src/components/layout/pane/header-tabs.tsx +17 -3
  93. package/src/components/layout/pane/header.tsx +5 -2
  94. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  95. package/src/components/layout/shell/active-drag.ts +38 -30
  96. package/src/components/layout/shell/drag/index.ts +51 -21
  97. package/src/components/layout/shell/menu.ts +3 -5
  98. package/src/components/layout/shell/pane/actions.ts +4 -1
  99. package/src/components/layout/shell/pane/ask.ts +5 -2
  100. package/src/components/layout/status-bar.tsx +59 -54
  101. package/src/components/markdown-text.tsx +35 -10
  102. package/src/components/onboarding/first-run-workspace.ts +25 -23
  103. package/src/components/onboarding/onboarding-keyboard.ts +6 -1
  104. package/src/components/onboarding/onboarding-wizard.tsx +12 -2
  105. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -3
  106. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  107. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  108. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  109. package/src/components/onboarding/wizard-positions.ts +8 -1
  110. package/src/components/pane-notice-seen.ts +125 -0
  111. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  112. package/src/components/pane-settings-dialog.tsx +7 -6
  113. package/src/components/sign-in-code-panel.tsx +3 -2
  114. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  115. package/src/components/ticker/list-table-view.tsx +39 -3
  116. package/src/components/ui/confirm-dialog.tsx +2 -1
  117. package/src/components/ui/data-table/index.tsx +4 -2
  118. package/src/components/ui/data-table/opentui/index.tsx +15 -5
  119. package/src/components/ui/data-table/types.ts +8 -0
  120. package/src/components/ui/external-link.tsx +4 -1
  121. package/src/components/ui/field-grid.tsx +1 -1
  122. package/src/components/ui/index.ts +2 -0
  123. package/src/components/ui/inline-quick-add.tsx +5 -0
  124. package/src/components/ui/multi-select/dialog.tsx +10 -9
  125. package/src/components/ui/pane-link-chip.tsx +354 -0
  126. package/src/components/ui/query-bar.tsx +22 -13
  127. package/src/components/ui/ratio-bar.tsx +24 -1
  128. package/src/components/ui/select-button.tsx +2 -1
  129. package/src/components/ui/shortcut-hint.tsx +6 -3
  130. package/src/components/ui/table-layout.ts +81 -0
  131. package/src/components/ui/tabs.tsx +45 -6
  132. package/src/components/use-pane-notice-footer.tsx +12 -4
  133. package/src/core/app-service-ports.ts +1 -1
  134. package/src/data/plugin-state-store.ts +44 -8
  135. package/src/docs/snapshot.json +53 -32
  136. package/src/i18n/es.ts +25 -6
  137. package/src/i18n/ja.ts +25 -5
  138. package/src/i18n/ko.ts +25 -5
  139. package/src/i18n/zh-cn.ts +25 -5
  140. package/src/i18n/zh-tw.ts +25 -5
  141. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  142. package/src/layout/pane-manager/gridlock.ts +47 -2
  143. package/src/layout-marketplace/api.ts +1 -0
  144. package/src/layout-marketplace/gallery.tsx +4 -3
  145. package/src/layout-marketplace/linked.ts +6 -4
  146. package/src/layout-marketplace/model.ts +3 -2
  147. package/src/market-data/futures-contract.ts +77 -31
  148. package/src/market-data/fx-closes.ts +5 -2
  149. package/src/market-data/hooks.tsx +23 -0
  150. package/src/market-data/market/change-basis.ts +72 -14
  151. package/src/market-data/market/format.ts +19 -11
  152. package/src/market-data/market/globex-day.ts +73 -0
  153. package/src/market-data/market/index-level.ts +10 -1
  154. package/src/market-data/quotes/intraday-bar.ts +1 -1
  155. package/src/market-data/quotes/session-split.ts +28 -0
  156. package/src/plugins/builtin/account-management/pane.tsx +1 -1
  157. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  158. package/src/plugins/builtin/analytics/index.tsx +10 -3
  159. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  160. package/src/plugins/builtin/analytics/risk-client.ts +4 -1
  161. package/src/plugins/builtin/analytics/risk-episodes.ts +422 -0
  162. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  163. package/src/plugins/builtin/analytics/risk-headless.ts +28 -10
  164. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  165. package/src/plugins/builtin/analytics/risk-model.ts +115 -26
  166. package/src/plugins/builtin/analytics/risk-pane.tsx +201 -23
  167. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  168. package/src/plugins/builtin/backtest/format.ts +14 -0
  169. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  170. package/src/plugins/builtin/backtest/report.ts +5 -3
  171. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  172. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  173. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  174. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  175. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  176. package/src/plugins/builtin/catalysts/model.ts +7 -2
  177. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  178. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  179. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  180. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  181. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  182. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  183. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  184. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  185. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  186. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  187. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  188. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  189. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  190. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  191. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  192. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  193. package/src/plugins/builtin/correlation/index.tsx +39 -167
  194. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  195. package/src/plugins/builtin/correlation/relationship/pane.tsx +6 -7
  196. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  197. package/src/plugins/builtin/cot/client.ts +8 -3
  198. package/src/plugins/builtin/cot/headless.ts +65 -12
  199. package/src/plugins/builtin/cot/pane.tsx +11 -5
  200. package/src/plugins/builtin/earnings/client.ts +40 -6
  201. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  202. package/src/plugins/builtin/earnings/headless.ts +47 -11
  203. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  204. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  205. package/src/plugins/builtin/earnings/history.tsx +23 -8
  206. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  207. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  208. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  209. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  210. package/src/plugins/builtin/econ/index.tsx +5 -4
  211. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  212. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  213. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  214. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  215. package/src/plugins/builtin/futures/index.tsx +32 -10
  216. package/src/plugins/builtin/futures/model.ts +93 -6
  217. package/src/plugins/builtin/futures/returns.ts +29 -7
  218. package/src/plugins/builtin/futures/table.tsx +59 -17
  219. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  220. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  221. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  222. package/src/plugins/builtin/futures-curve/model.ts +111 -15
  223. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  224. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  225. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  226. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  227. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  228. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  229. package/src/plugins/builtin/help/index.tsx +68 -61
  230. package/src/plugins/builtin/holders/format.ts +7 -2
  231. package/src/plugins/builtin/holders/pane.tsx +11 -3
  232. package/src/plugins/builtin/holders/report-header.ts +5 -4
  233. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  234. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  235. package/src/plugins/builtin/insider/signals-model.ts +4 -5
  236. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  237. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  238. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  239. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  240. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -0
  241. package/src/plugins/builtin/perps/headless.ts +73 -17
  242. package/src/plugins/builtin/perps/index.tsx +3 -1
  243. package/src/plugins/builtin/perps/model.ts +1 -1
  244. package/src/plugins/builtin/perps/pane.tsx +2 -0
  245. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  246. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +20 -1
  247. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  248. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +154 -0
  249. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +64 -22
  250. package/src/plugins/builtin/portfolio-list/cli/render.ts +18 -7
  251. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  252. package/src/plugins/builtin/portfolio-list/grid.tsx +56 -12
  253. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  254. package/src/plugins/builtin/portfolio-list/pane/index.tsx +42 -4
  255. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  256. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  257. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  258. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  259. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  260. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  261. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  262. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +118 -4
  263. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  264. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  265. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  266. package/src/plugins/builtin/portfolio-list/table.tsx +105 -6
  267. package/src/plugins/builtin/power/headless.ts +47 -9
  268. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  269. package/src/plugins/builtin/research-search/article.ts +12 -2
  270. package/src/plugins/builtin/research-search/data.ts +5 -2
  271. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  272. package/src/plugins/builtin/research-search/model.ts +47 -3
  273. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  274. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  275. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  276. package/src/plugins/builtin/risk-factors/pane.tsx +5 -3
  277. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  278. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  279. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  280. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  281. package/src/plugins/builtin/sec/forms.ts +19 -0
  282. package/src/plugins/builtin/sec/headless.ts +7 -11
  283. package/src/plugins/builtin/sec/index.tsx +11 -3
  284. package/src/plugins/builtin/shared/earnings-calendar.ts +6 -3
  285. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  286. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  287. package/src/plugins/builtin/shared/use-quote-board.ts +42 -27
  288. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  289. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  290. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  291. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  292. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  293. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  294. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  295. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  296. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  297. package/src/plugins/builtin/ticker-detail/headless-schema.ts +10 -1
  298. package/src/plugins/builtin/ticker-detail/headless.ts +8 -1
  299. package/src/plugins/builtin/ticker-detail/overview/components.tsx +2 -1
  300. package/src/plugins/builtin/ticker-detail/overview/model.ts +4 -2
  301. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +11 -8
  302. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  303. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  304. package/src/plugins/builtin/ticker-detail/settings.ts +4 -3
  305. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  306. package/src/plugins/host-resolver.ts +3 -2
  307. package/src/portfolio/column-values.ts +42 -8
  308. package/src/portfolio/futures-positions.ts +10 -2
  309. package/src/portfolio/mutations.ts +4 -3
  310. package/src/portfolio/period-pnl.ts +119 -0
  311. package/src/portfolio/positions-import/describe.ts +89 -0
  312. package/src/portfolio/positions-import/parse.ts +682 -0
  313. package/src/portfolio/positions-import/plan.ts +295 -0
  314. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  315. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  316. package/src/react/jsx-dev-fallback.ts +62 -0
  317. package/src/renderers/browser/cloud-transport.ts +1 -1
  318. package/src/renderers/browser/config-host.ts +3 -1
  319. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  320. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  321. package/src/renderers/browser/main.tsx +2 -1
  322. package/src/renderers/browser/research-entry.ts +12 -0
  323. package/src/renderers/cloudflare/http-proxy.ts +8 -2
  324. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  325. package/src/renderers/cloudflare/worker.ts +12 -3
  326. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  327. package/src/renderers/dom/desktop/controls.tsx +1 -1
  328. package/src/renderers/dom/desktop/dialog-actions.tsx +10 -24
  329. package/src/renderers/dom/desktop/icons.tsx +4 -2
  330. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  331. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  332. package/src/renderers/dom/host/box.tsx +2 -2
  333. package/src/renderers/dom/host/input.tsx +13 -0
  334. package/src/renderers/dom/key-event.ts +1 -0
  335. package/src/renderers/dom/styles.css +3 -0
  336. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  337. package/src/renderers/electrobun/bun/desktop/backend.ts +1 -0
  338. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  339. package/src/renderers/electrobun/bun/desktop/host-requests.ts +5 -4
  340. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  341. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  342. package/src/renderers/electrobun/bun/desktop/initialization.ts +3 -1
  343. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  344. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  345. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  346. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  347. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  348. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  349. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  350. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  351. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  352. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  353. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  354. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  355. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  356. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  357. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  358. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  359. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  360. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  361. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  362. package/src/renderers/electrobun/view/main.tsx +9 -4
  363. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  364. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  365. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  366. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  367. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  368. package/src/renderers/opentui/browser-open.ts +2 -1
  369. package/src/renderers/opentui/dialog-host.tsx +1 -1
  370. package/src/renderers/opentui/interaction-performance.ts +3 -1
  371. package/src/renderers/opentui/start.tsx +2 -1
  372. package/src/renderers/opentui/terminal-media.ts +11 -6
  373. package/src/renderers/opentui/ui-host.tsx +5 -8
  374. package/src/shares/open.ts +22 -1
  375. package/src/shares/pane.ts +2 -1
  376. package/src/sources/gloomberb-cloud/normalizers.ts +3 -0
  377. package/src/sync/analytics-payload.ts +194 -0
  378. package/src/sync/baseline.ts +19 -9
  379. package/src/sync/broker-identity.ts +171 -0
  380. package/src/sync/broker-instances.ts +137 -0
  381. package/src/sync/collections-contributor.ts +173 -0
  382. package/src/sync/config-contributor.ts +100 -0
  383. package/src/sync/config-merge.ts +229 -0
  384. package/src/sync/controller.ts +139 -28
  385. package/src/sync/core-contributors.ts +8 -1583
  386. package/src/sync/history-memo.ts +32 -0
  387. package/src/sync/layout-merge.ts +259 -0
  388. package/src/sync/sanitize.ts +114 -0
  389. package/src/sync/ticker-merge.ts +208 -0
  390. package/src/sync/ticker-payload.ts +81 -0
  391. package/src/sync/types.ts +15 -1
  392. package/src/telemetry/attention-setting.ts +1 -1
  393. package/src/telemetry/usage-counts.ts +16 -0
  394. package/src/test-support/preload.ts +5 -0
  395. package/src/theme/color-utils.ts +10 -0
  396. package/src/theme/font-scale.ts +34 -3
  397. package/src/theme/series-colors.ts +44 -0
  398. package/src/theme/themes.ts +2 -1
  399. package/src/tickers/batched-lookups.ts +263 -6
  400. package/src/tickers/company-name-listing.ts +44 -2
  401. package/src/tickers/company-name.ts +7 -2
  402. package/src/tickers/search/upsert.ts +16 -1
  403. package/src/time-series/base-series.ts +18 -4
  404. package/src/time-series/studies/indicators.ts +3 -1
  405. package/src/time-series/studies/resolve.ts +1 -1
  406. package/src/time-series/types.ts +6 -0
  407. package/src/types/financials.ts +18 -0
  408. package/src/types/headless.ts +11 -0
  409. package/src/ui/host.tsx +26 -3
  410. package/src/ui/index.tsx +1 -0
  411. package/src/utils/concurrency.ts +6 -0
  412. package/src/utils/currency-pair.ts +56 -4
  413. package/src/utils/datetime-format.ts +11 -0
  414. package/src/utils/decimal-comma.ts +9 -6
  415. package/src/utils/exchanges.ts +32 -0
  416. package/src/utils/fundamentals.ts +41 -0
  417. package/src/utils/markdown.ts +4 -2
  418. package/src/utils/pasted-lines.ts +14 -0
  419. package/src/utils/price-window.ts +2 -1
  420. package/src/utils/sec-filings.ts +17 -0
  421. package/src/utils/sec.ts +4 -23
  422. package/src/utils/shortcut-labels.ts +6 -30
@@ -2,8 +2,9 @@ import { logFailure } from "../../utils/log-failure";
2
2
  import { formatShortDate, parseDisplayDate } from "../../utils/datetime-format";
3
3
  import { formatReportedMoney, REPORTING_CURRENCY_NOT_SOURCED } from "../../utils/reported-money";
4
4
  import {
5
- appTtmRate, computedEnterpriseValueNote, convertedPriceEarningsNote, enterpriseValueLabel, enterpriseValueReconciliationNote, epsConversionNote,
6
- fundamentalsCurrency, reportedEnterpriseValue, trailingEpsSourceNote, ttmAtAppRate, ttmConversionNote,
5
+ appTtmRate, BANK_ENTERPRISE_VALUE, computedEnterpriseValueNote, convertedPriceEarningsNote, enterpriseValueLabel, enterpriseValueReconciliationNote,
6
+ epsConversionNote, fundamentalsCurrency, isBankEnterpriseValue, reportedEnterpriseValue, trailingEpsSourceNote, ttmAtAppRate, ttmConversionNote,
7
+ withBankEnterpriseValue,
7
8
  } from "../../utils/fundamentals";
8
9
  import { latestFinancialPeriod } from "../../utils/latest-financial-period";
9
10
  import { burnsCash, cashRunway, SHORT_RUNWAY_HISTORY, formatRunwayMonths, offeringNote, offeringsAfter, runwayMethod, type CashRunway, type OfferingFiling, type RunwayEstimate } from "../../utils/cash-runway";
@@ -40,7 +41,7 @@ import {
40
41
  quoteMarketStateLabel,
41
42
  } from "../../market-data/market/status";
42
43
  import type { FuturesContractTermsPayload } from "../../api-client/futures-curve";
43
- import { changeBasisJson, quoteChangeBasis, quotePreviousCloseDate, quoteSettleText } from "../../market-data/market/change-basis";
44
+ import { changeBasisJson, futuresQuoteFromSettle, quoteChangeBasis, quotePreviousCloseDate, quoteSettleText } from "../../market-data/market/change-basis";
44
45
  import {
45
46
  futuresContractLines, futuresPricePer, isFuturesInstrument, loadFuturesContractTerms, loadUsdPerMmbtu, usdPerMmbtuText, type UsdPerMmbtu,
46
47
  } from "../../market-data/futures-contract";
@@ -582,6 +583,8 @@ function unsourcedCurrencyNote(metrics: readonly FundamentalsMetric[]): string |
582
583
  * withdrawn, N/M at or below zero as a P/E over a loss is.
583
584
  */
584
585
  function enterpriseValueFigure(figure: MetricFigure, fundamentals: TickerFinancials["fundamentals"]): MetricFigure {
586
+ // A bank's: its deposits are funding, not debt.
587
+ if (isBankEnterpriseValue(fundamentals)) return { text: BANK_ENTERPRISE_VALUE, value: "N/M", unit: figure.unit };
585
588
  const label = enterpriseValueLabel(fundamentals);
586
589
  if (label === "not-meaningful") return { ...multipleFigure(NOT_MEANINGFUL), unit: figure.unit };
587
590
  if (label === "unavailable") return { text: "unavailable", value: null, unit: figure.unit };
@@ -789,7 +792,7 @@ function fundamentalsMetrics(
789
792
  const receipt = fundamentals?.sharesOutstanding != null && sharesOutstandingInReceipts(quote, fundamentals, profile?.description);
790
793
  return [
791
794
  { label: "Market Cap", ...marketCap },
792
- { label: "Enterprise Value", ...enterpriseValueFigure(enterpriseValue, fundamentals) },
795
+ { label: "Enterprise Value", ...enterpriseValueFigure(enterpriseValue, withBankEnterpriseValue(fundamentals, profile)) },
793
796
  // A multiple over a loss is N/M, even beside a positive one the source served from an older period.
794
797
  { label: "P/E (TTM)", ...multipleFigure(priceEarningsOnEarnings(fundamentals?.trailingPE, fundamentals?.eps)) },
795
798
  // Next fiscal year's consensus, named by its year: `Forward P/E FY27`.
@@ -905,7 +908,8 @@ function fundamentalsNotes(
905
908
  ? convertedPriceEarningsNote(fundamentals, quoteCurrency)
906
909
  : undefined;
907
910
  // Why the EV is labelled, withdrawn or N/M; for an insurer's, what Gloom Cloud computed it from.
908
- const enterpriseValue = shown("Enterprise Value")
911
+ // A bank's EV line says why it is n/m.
912
+ const enterpriseValue = shown("Enterprise Value") && !metrics.some((metric) => metric.text === BANK_ENTERPRISE_VALUE)
909
913
  ? enterpriseValueReconciliationNote(fundamentals) ?? computedEnterpriseValueNote(fundamentals)
910
914
  : undefined;
911
915
  // A cap Gloom Cloud withheld says why, as RV and EQS do.
@@ -1228,7 +1232,8 @@ export async function buildTickerReport({
1228
1232
  /** What `recentSecFilings` left out. */
1229
1233
  hiddenSecFilings?: HiddenFilings;
1230
1234
  }): Promise<string> {
1231
- const quote = financials.quote;
1235
+ // A future's move that nothing confirms is measured from its last confirmed settlement, as `quote` reads it.
1236
+ const quote = futuresQuoteFromSettle(financials.quote, futuresContract);
1232
1237
  const fundamentals = financials.fundamentals;
1233
1238
  const priceReturns = computeTickerPriceReturns(financials, tickerFile?.metadata.assetCategory);
1234
1239
  const profile = financials.profile;
@@ -1510,7 +1515,7 @@ function buildTickerStructuredData({
1510
1515
  recentSecFilings: RecentFiling[];
1511
1516
  hiddenSecFilings: HiddenFilings;
1512
1517
  }) {
1513
- const quote = financials.quote;
1518
+ const quote = futuresQuoteFromSettle(financials.quote, futuresContract);
1514
1519
  const priceReturns = computeTickerPriceReturns(financials, tickerFile?.metadata.assetCategory);
1515
1520
  const identity = listingIdentity(listing, quote);
1516
1521
  // Market cap and the multiples at the regular session price, as the text report gives them.
@@ -1,5 +1,3 @@
1
- import { spawn } from "node:child_process";
2
- import type { Readable, Writable } from "node:stream";
3
1
  import { mkdir } from "fs/promises";
4
2
  import { join } from "path";
5
3
  import { logFailure } from "../utils/log-failure";
@@ -182,46 +180,64 @@ interface LaunchedChrome {
182
180
  stderr(): Promise<string>;
183
181
  }
184
182
 
185
- /** Chrome with DevTools on fds 3 (to the browser) and 4 (from it): messages are JSON, each ended by a NUL. */
183
+ /** Hands `onText` what `stream` carries, as text, until it ends; a read that fails ends it too. */
184
+ async function drain(stream: ReadableStream<Uint8Array>, onText: (text: string) => void): Promise<void> {
185
+ const decoder = new TextDecoder();
186
+ const reader = stream.getReader();
187
+ try {
188
+ for (;;) {
189
+ const { done, value } = await reader.read();
190
+ if (done) return;
191
+ onText(decoder.decode(value, { stream: true }));
192
+ }
193
+ } catch {
194
+ // Intentional ignore: a read that fails says the browser has gone, as the end of the stream does.
195
+ }
196
+ }
197
+
198
+ /**
199
+ * Chrome with DevTools on fds 3 (to the browser) and 4 (from it): messages are JSON, each ended by a NUL.
200
+ *
201
+ * The pipes are the browser's stdin and stdout, which `sh` moves to fds 3 and 4 and replaces with /dev/null, so
202
+ * the browser is started by `Bun.spawn` like every other child. Handed to it through `node:child_process`
203
+ * (`stdio: [..., "pipe", "pipe"]`), Bun closes those descriptors more than once as the browser exits, and goes on
204
+ * to use them. By then another child's pipes can hold the same numbers, and that child sees its own pipes closed
205
+ * under it: a stdout that cannot be registered (EBADF), a read that never ends, or a second browser start that
206
+ * finds its connection closed. `exec` keeps the browser's pid the child's, so `kill` reaches the browser itself.
207
+ */
186
208
  function launchOverPipe(chrome: string, args: string[]): LaunchedChrome {
187
- const child = spawn(chrome, [...args, "--remote-debugging-pipe", "about:blank"], {
188
- stdio: ["ignore", "ignore", "pipe", "pipe", "pipe"],
189
- });
209
+ const child = Bun.spawn(
210
+ ["sh", "-c", 'exec "$0" "$@" 3<&0 4>&1 </dev/null >/dev/null', chrome, ...args, "--remote-debugging-pipe", "about:blank"],
211
+ { stdin: "pipe", stdout: "pipe", stderr: "pipe" },
212
+ );
190
213
  // Read to the end, so a chatty browser never blocks on a full pipe; only the start is kept.
191
214
  let stderrText = "";
192
- const fromStderr = child.stderr!;
193
- fromStderr.setEncoding("utf8");
194
- fromStderr.on("data", (chunk: string) => {
195
- if (stderrText.length < STDERR_KEPT_BYTES) stderrText += chunk.slice(0, STDERR_KEPT_BYTES - stderrText.length);
215
+ const stderrDone = drain(child.stderr, (text) => {
216
+ if (stderrText.length < STDERR_KEPT_BYTES) stderrText += text.slice(0, STDERR_KEPT_BYTES - stderrText.length);
196
217
  });
197
- const stderrDone = new Promise<void>((resolve) => {
198
- fromStderr.once("close", () => resolve());
199
- fromStderr.once("error", () => resolve());
218
+ const connection = new CdpConnection((text) => {
219
+ child.stdin.write(`${text}\0`);
220
+ // Writes after the browser has gone fail; the connection already says it closed.
221
+ Promise.resolve(child.stdin.flush()).catch(() => connection.close());
200
222
  });
201
- const toChrome = child.stdio[3] as Writable;
202
- const fromChrome = child.stdio[4] as Readable;
203
- const connection = new CdpConnection((text) => toChrome.write(`${text}\0`));
223
+ const closed = () => connection.close();
204
224
  let buffered = "";
205
- fromChrome.setEncoding("utf8");
206
- fromChrome.on("data", (chunk: string) => {
207
- buffered += chunk;
225
+ void drain(child.stdout, (text) => {
226
+ buffered += text;
208
227
  for (let end = buffered.indexOf("\0"); end >= 0; end = buffered.indexOf("\0")) {
209
228
  const message = buffered.slice(0, end);
210
229
  buffered = buffered.slice(end + 1);
211
230
  connection.receive(message);
212
231
  }
213
- });
214
- const closed = () => connection.close();
215
- fromChrome.on("close", closed);
216
- fromChrome.on("error", closed);
217
- // Writes after the browser has gone fail; the connection already says it closed.
218
- toChrome.on("error", closed);
219
- child.on("error", closed);
220
- const exited = new Promise<void>((resolve) => {
221
- if (child.exitCode !== null || child.signalCode !== null) resolve();
222
- else child.once("exit", () => resolve());
223
- });
224
- child.once("exit", closed);
232
+ }).then(closed);
233
+ const exited = (async () => {
234
+ try {
235
+ await child.exited;
236
+ } catch {
237
+ // Intentional ignore: a browser that cannot be waited for has gone, and the connection says so.
238
+ }
239
+ })();
240
+ void exited.then(closed);
225
241
  return {
226
242
  connection,
227
243
  stop: async () => {
@@ -90,6 +90,10 @@ export interface DesktopPaneShotPayload {
90
90
  tapeSnapshots?: TapeCapture[];
91
91
  /** What each scanner pane's feed answered the capture process, which the page replays since its own socket cannot ask. */
92
92
  scannerSnapshots?: ScannerCapture[];
93
+ /** Rows of a list whose read failed: shown without figures, and named on the capture's status line. */
94
+ unreadRows?: string[];
95
+ /** Why each of `unreadRows` did not load, as the source answered. */
96
+ unreadReasons?: Record<string, string>;
93
97
  valuationSeries: Array<[string, DatedObservation[]]>;
94
98
  statSeries: Array<[string, DatedObservation[]]>;
95
99
  chartModel?: ChartResolutionResult;
@@ -128,6 +132,8 @@ interface DesktopPaneShotRenderedCell {
128
132
  instant?: string;
129
133
  /** The full-precision number behind a cell whose text rounds it (a trade of -9.4596), from the same export value. */
130
134
  value?: number;
135
+ /** A column only the JSON and CSV carry (DataTable `reportColumns`): the text report leaves it out. Only in `reportRows`. */
136
+ reportOnly?: true;
131
137
  }
132
138
 
133
139
  export interface DesktopPaneShotRenderedRow {
@@ -213,6 +219,15 @@ const SHOT_MODE_CSS = [
213
219
  const SHOT_READY_TIMEOUT_MS = 45_000;
214
220
  const DEFAULT_DEVICE_SCALE_FACTOR = 2;
215
221
 
222
+ /**
223
+ * Starts building the capture's page while its data is read: the build is
224
+ * the same for every capture, and `renderDesktopPaneScreenshot` waits on it.
225
+ * A build that fails is retried there, and reported.
226
+ */
227
+ export function prepareDesktopPaneShotView(): void {
228
+ loadShotView().catch(() => { /* Intentional ignore: the render loads the view again and reports its failure. */ });
229
+ }
230
+
216
231
  export async function renderDesktopPaneScreenshot(
217
232
  payload: DesktopPaneShotPayload,
218
233
  outputPath: string,
package/src/cli/entry.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  import "./opentui-libc";
2
+ import { installJsxDevFallback } from "../react/jsx-dev-fallback";
2
3
  import { inferCliErrorOptions, printCliError } from "./errors";
3
4
  import { isCliHelpFlag } from "./options";
4
5
  import { cliAsciiEnabled, plainByDefault, setCliPlainOverride } from "../utils/cli-output";
@@ -19,6 +20,10 @@ import {
19
20
  smokeShotView,
20
21
  } from "./native-smoke";
21
22
 
23
+ // Before the first module with JSX loads, which is never one of the imports
24
+ // above: every command reaches those through a dynamic import.
25
+ installJsxDevFallback();
26
+
22
27
  async function launchOpenTuiApp(cliLaunchRequest: CliLaunchRequest | null = null): Promise<void> {
23
28
  // Before anything in the app can reach for the render library, so a temp
24
29
  // folder that cannot run it is worked around (or named) first.
@@ -71,6 +71,12 @@ export interface ExportIdentity {
71
71
  currencyOrUnit?: string | null;
72
72
  /** The bar interval or observation frequency actually returned: `1d`, `1mo`, `daily`, `monthly`. */
73
73
  interval?: string | null;
74
+ /**
75
+ * Who this row is cited to, where a table's rows come from different
76
+ * publishers (each venue's own contract): blank leaves the closing lines'
77
+ * source, which names them all.
78
+ */
79
+ source?: string | null;
74
80
  /**
75
81
  * When this row was observed, where a table's rows are dated apart (each
76
82
  * ticker's price in a ranking): an ISO date or instant. Null leaves `as_of`
@@ -102,7 +108,7 @@ export function exportIdentityCells(freshness: ReportFreshness, identity: Export
102
108
  identity.symbolOrSeries?.trim() ?? "",
103
109
  identity.currencyOrUnit?.trim() ?? "",
104
110
  identity.interval?.trim() ?? "",
105
- source.name,
111
+ identity.source?.trim() || source.name,
106
112
  identity.asOf !== undefined ? rowAsOf(identity.asOf) : source.observationDate ?? "",
107
113
  ];
108
114
  }
@@ -1,7 +1,6 @@
1
1
  import type { Quote, TickerFinancials } from "../types/financials";
2
2
  import type { HeadlessPaneFreshness, HeadlessPaneRow } from "../types/headless";
3
3
  import { deriveHeadlessFreshness, type ReportFreshness } from "./pane-functions/freshness";
4
- import { fxPairObservation, fxRateObservations, type FxRateTiming } from "../plugins/builtin/shared/fx-rate-freshness";
5
4
  import { quoteObservation, REPORTED_DATA } from "../plugins/builtin/shared/report-freshness";
6
5
  import { latestReportedPeriod } from "../utils/latest-financial-period";
7
6
 
@@ -38,21 +37,6 @@ export function quotesFreshness(
38
37
  return rows.length > 0 ? rowsFreshness(rows, declared, undefined, now) : undefined;
39
38
  }
40
39
 
41
- /**
42
- * A currency pair crossed from the loaded USD rates of its legs, dated as the
43
- * FX matrix dates its rates (`fn FXC`): as old as its oldest dated leg, as
44
- * held back as its most delayed, stale when any leg is, and read against the
45
- * FX week. A pair with no loaded leg (a code priced in itself) cites nothing.
46
- */
47
- export function fxPairFreshness(
48
- legs: ReadonlyMap<string, { rate: number; timing: FxRateTiming }>,
49
- now = Date.now(),
50
- ): ReportFreshness | undefined {
51
- const rates = new Map([...legs].map(([currency, leg]) => [currency, leg.rate] as const));
52
- const observation = fxPairObservation(fxRateObservations([...legs.keys()], rates, (currency) => ({ entry: legs.get(currency)?.timing }), now));
53
- return observation ? rowsFreshness([observation], undefined, undefined, now) : undefined;
54
- }
55
-
56
40
  /**
57
41
  * Fundamentals: reported figures, not a feed. Dated by when the statistics
58
42
  * block was observed, with the newest statement period they run through
@@ -1,6 +1,7 @@
1
1
  import { currencyMinorDigits } from "../market-data/market/format";
2
2
  import { parseTypedNumber, readConvertedAmount } from "../utils/decimal-comma";
3
3
  import { currenciesNamed } from "../utils/currency-names";
4
+ import { currencyPairSpelling, fxFigureText, fxRateDigits, quotedFxPair } from "../utils/currency-pair";
4
5
 
5
6
  /**
6
7
  * What `gloom fx` is asked for. A bare code is one unit of it in the base
@@ -47,15 +48,31 @@ function readCurrencyName(typed: string, retry: (code: string) => string): { cod
47
48
  return { error: `${typed} names several currencies: ${choices}. Write one as its code, such as fx ${retry(named[0]!.code)}.` };
48
49
  }
49
50
 
51
+ /**
52
+ * A pair written as `quote` takes one, without a slash: EURUSD, eur-usd,
53
+ * EURUSD=X, EURUSD:CCY and JPY=X (USD/JPY). Null for anything else.
54
+ */
55
+ function spelledPair(text: string): FxRequest | null {
56
+ if (/^[A-Z]{3}$/.test(text)) return null;
57
+ const spelling = currencyPairSpelling(text);
58
+ const match = spelling ? /^([A-Z]{3})([A-Z]{3})=X$/.exec(spelling.symbol) : null;
59
+ return match ? { currency: match[1]!, baseCurrency: match[2]! } : null;
60
+ }
61
+
62
+ /** Whether `fx` reads the argument as a pair spelled without its slash (`spelledPair`). */
63
+ function isSpelledFxPair(raw: string): boolean {
64
+ return spelledPair(raw.trim().toUpperCase()) != null;
65
+ }
66
+
50
67
  /** The request, or the sentence saying what is wrong with the argument. */
51
68
  export function parseFxRequest(raw: string, baseCurrency: string): FxRequest | { error: string } {
52
69
  const typed = raw.trim().split("/").map((part) => part.trim());
53
70
  const text = raw.trim().toUpperCase();
54
71
  const parts = typed.map((part) => part.toUpperCase());
55
72
  if (parts.length > 2 || parts.some((part) => !part)) return { error: `"${raw}" is not a currency or a pair such as USD/NGN.` };
56
- // EURUSD is the pair typed without its slash: say how to write it.
57
- const joined = parts.length === 1 && /^[A-Z]{6}$/.test(text) && isKnownCurrency(text.slice(0, 3)) && isKnownCurrency(text.slice(3));
58
- if (joined) return { error: `${text} is not a currency code; write the pair as ${text.slice(0, 3)}/${text.slice(3)}.` };
73
+ // The pair spellings `quote` takes: EURUSD, eur-usd, EURUSD=X.
74
+ const spelled = parts.length === 1 ? spelledPair(text) : null;
75
+ if (spelled) return spelled;
59
76
  // A name (peso, yen, Swiss franc) is a currency's code. Three letters that are a code stay one: only a name that is no code reads as one.
60
77
  const readAs: string[] = [];
61
78
  for (const [index, part] of parts.entries()) {
@@ -96,10 +113,10 @@ function joinNameWords(args: readonly string[]): readonly string[] {
96
113
  /**
97
114
  * `fx` arguments: a currency or a pair (`EUR`, `USD/NGN`), or an amount and
98
115
  * what to convert it from and to (`1234.5 EUR/USD`, `1234,5 EUR USD`). The
99
- * amount is an amount of the first currency and reads as cash does
100
- * (`readConvertedAmount`): `1.234,5` and `1,234.5` are 1234.5, and `1.234` is
101
- * 1234 unless that currency has three decimals. A comma before exactly three
102
- * digits (`1,234`) is refused naming both readings, as `alerts add` refuses it.
116
+ * amount is an amount of the first currency (`readConvertedAmount`):
117
+ * `1.234,5` and `1,234.5` are 1234.5. A lone comma or dot before exactly three
118
+ * digits (`1,234`, `1.234`) is refused naming both readings, as `alerts add`
119
+ * refuses `1,234`.
103
120
  * An amount and one currency converts to USD (`toUsdByDefault`). The error
104
121
  * sentence otherwise.
105
122
  */
@@ -127,10 +144,10 @@ export function parseFxArgs(words: readonly string[], baseCurrency: string): FxA
127
144
  const pair = typed.length === 2 && typed.every((arg) => /^[A-Za-z]{3}$/.test(arg)) ? typed.join("/").toUpperCase() : "EUR/USD";
128
145
  return { error: `fx takes one currency or pair; got ${typed.join(" ")}. Write a pair as ${pair}, or convert an amount as fx 1234.5 ${pair}.` };
129
146
  }
130
- const toUsdByDefault = codes.length === 1 && !codes[0]!.includes("/");
147
+ const toUsdByDefault = codes.length === 1 && !codes[0]!.includes("/") && !isSpelledFxPair(codes[0]!);
131
148
  const request = parseFxRequest(codes.join("/"), "USD");
132
149
  if ("error" in request) return request;
133
- // The amount is in the currency converted from, so its units say what 1.234 means; 1,234 could be either.
150
+ // 1,234 and 1.234 could each be either reading, whatever the currency.
134
151
  let amount: number;
135
152
  try {
136
153
  amount = readConvertedAmount(first, "The amount", request.currency);
@@ -183,7 +200,42 @@ export function formatFxRate(rate: number): string {
183
200
  return fixed.includes(".") ? fixed.replace(/\.?0+$/, "") : fixed;
184
201
  }
185
202
 
186
- /** Both directions on one line: `1 NGN = 0.000752791 USD (USD/NGN 1328.39)`. */
187
- export function describeFxRate(request: FxRequest, rate: number): string {
188
- return `1 ${request.currency} = ${formatFxRate(rate)} ${request.baseCurrency} (${request.baseCurrency}/${request.currency} ${formatFxRate(1 / rate)})`;
203
+ /** The pair as markets quote it (USD/JPY for JPY/USD), its rate, and whether that is the direction asked for. */
204
+ function marketQuote(request: FxRequest, rate: number): { pair: string; rate: number; currency: string; direct: boolean } {
205
+ const quoted = quotedFxPair(request.currency, request.baseCurrency, rate);
206
+ return { pair: quoted.pair, rate: quoted.rate, currency: quoted.pair.slice(4), direct: quoted.pair === `${request.currency}/${request.baseCurrency}` };
207
+ }
208
+
209
+ /** A quote a rate is read from: its pair as markets write it and its figure as the source sent it (USD/JPY 157.848). */
210
+ export interface FxQuotedFigure {
211
+ pair: string;
212
+ figure: number;
213
+ }
214
+
215
+ /** The dollar pairs a cross is read from, each as sent: `via USD: USD/ZAR 16.13650, USD/NGN 1328.39`. */
216
+ export function describeFxLegs(legs: readonly FxQuotedFigure[]): string {
217
+ return `via USD: ${legs.map(({ pair, figure }) => `${pair} ${fxFigureText(figure, pair.slice(4))}`).join(", ")}`;
218
+ }
219
+
220
+ /**
221
+ * Both directions on one line: `1 NGN = 0.000752791 USD (USD/NGN 1328.39)`.
222
+ * The side that is the pair as markets quote it is that quote's figure as
223
+ * sent, with at least the pair's decimals (EUR/USD 1.12650, USD/JPY
224
+ * 157.848, IDR/JPY 0.0096120): the rate a conversion multiplies or divides
225
+ * by, never a rounded one. The other side is its inverse to six significant
226
+ * digits. A cross (no `quoted` figure of its own) shows the pair's decimals,
227
+ * and the dollar pairs it is read from are named beside it (`describeFxLegs`).
228
+ */
229
+ export function describeFxRate(request: FxRequest, rate: number, quoted?: FxQuotedFigure): string {
230
+ const head = `1 ${request.currency} =`, pair = `${request.baseCurrency}/${request.currency}`;
231
+ if (request.currency === request.baseCurrency || !isUsableRate(rate)) {
232
+ return `${head} ${formatFxRate(rate)} ${request.baseCurrency} (${pair} ${formatFxRate(1 / rate)})`;
233
+ }
234
+ const market = marketQuote(request, rate);
235
+ const quotedText = quoted && quoted.pair === market.pair && isUsableRate(quoted.figure)
236
+ ? fxFigureText(quoted.figure, market.currency)
237
+ : market.rate.toFixed(fxRateDigits(market.currency, market.rate));
238
+ const left = market.direct ? quotedText : formatFxRate(rate);
239
+ const right = market.direct ? formatFxRate(1 / rate) : quotedText;
240
+ return `${head} ${left} ${request.baseCurrency} (${pair} ${right})`;
189
241
  }
@@ -0,0 +1,144 @@
1
+ import type { QuoteBatchOptions, QuoteBatchResult, QuoteSubscriptionTarget } from "../types/data-provider";
2
+ import type { Quote } from "../types/financials";
3
+ import { isQuoteStaleForCurrentSession } from "../market-data/quotes/freshness";
4
+ import { dollarPairListing, fxFigureAsSent, quotedFxPair } from "../utils/currency-pair";
5
+ import { fxFreshUntil } from "../utils/fx-market-hours";
6
+ import { quoteObservation } from "../plugins/builtin/shared/report-freshness";
7
+ import { isUsableRate, type FxQuotedFigure } from "./fx-pair";
8
+
9
+ /** A listing a rate is read from, and whether its price is the rate's inverse. */
10
+ export interface FxQuoteLeg {
11
+ symbol: string;
12
+ invert: boolean;
13
+ }
14
+
15
+ /**
16
+ * A pair's own listing, as markets quote it: EURJPY=X for EUR/JPY and,
17
+ * inverted, for JPY/EUR; USDSGD=X for USD/SGD.
18
+ */
19
+ export function fxPairListing(currency: string, baseCurrency: string): FxQuoteLeg {
20
+ const [base, quote] = quotedFxPair(currency, baseCurrency, 1).pair.split("/") as [string, string];
21
+ return { symbol: `${base}${quote}=X`, invert: base !== currency };
22
+ }
23
+
24
+ /** A currency's dollar pair, read as USD per unit: EURUSD=X, or USDJPY=X inverted. */
25
+ function dollarLeg(code: string): FxQuoteLeg {
26
+ const symbol = dollarPairListing(code);
27
+ return { symbol, invert: symbol.startsWith("USD") };
28
+ }
29
+
30
+ /** The rate `fx` answers with and the quotes behind it, each as `quote` reads it. */
31
+ export interface FxQuoteRate {
32
+ /** `baseCurrency` per unit of `currency`, from the quotes' figures as sent: never rounded. */
33
+ rate: number;
34
+ /** The pair's own quote, or the two dollar pairs it is crossed from, each with its pair and figure as sent. */
35
+ quotes: ({ symbol: string; quote: Quote } & FxQuotedFigure)[];
36
+ /** Crossed through the dollar: the pair has no quote of its own. */
37
+ viaUsd: boolean;
38
+ }
39
+
40
+ export interface FxQuoteMiss {
41
+ /** The currencies no quote priced. */
42
+ missing: string[];
43
+ /** The reasons the quotes that did not come back gave, first the pair's own. */
44
+ errors: unknown[];
45
+ }
46
+
47
+ /** The figure a leg's quote was sent as (EURJPY=X 177.811), or null for none. */
48
+ function legFigure(quote: Quote | null | undefined): number | null {
49
+ const price = quote?.price;
50
+ return isUsableRate(price) ? fxFigureAsSent(price) : null;
51
+ }
52
+
53
+ function legRate(leg: FxQuoteLeg, quote: Quote | null | undefined): number | null {
54
+ const figure = legFigure(quote);
55
+ if (figure == null) return null;
56
+ const rate = leg.invert ? 1 / figure : figure;
57
+ return isUsableRate(rate) ? rate : null;
58
+ }
59
+
60
+ /** A leg's quote with its pair as markets write it (EURJPY=X is EUR/JPY) and its figure as sent. */
61
+ function quotedLeg(leg: FxQuoteLeg, quote: Quote): { symbol: string; quote: Quote } & FxQuotedFigure {
62
+ return { symbol: leg.symbol, quote, pair: `${leg.symbol.slice(0, 3)}/${leg.symbol.slice(3, 6)}`, figure: legFigure(quote)! };
63
+ }
64
+
65
+ /**
66
+ * The rate of `currency` in `baseCurrency` from the quotes `quote` and the FX
67
+ * board read, in one batch: the pair's own quote (EURJPY=X for EUR/JPY),
68
+ * else, for a pair with no quote or one that went stale while both dollar
69
+ * pairs are current, the cross of the dollar pairs (EURUSD=X and USDJPY=X),
70
+ * said as such. A pair with a dollar side is its own dollar pair. Null for a
71
+ * currency priced in itself; the currencies no quote priced when neither
72
+ * reading has a price.
73
+ */
74
+ export async function readFxQuoteRate(
75
+ currency: string,
76
+ baseCurrency: string,
77
+ getQuotesBatch: (targets: QuoteSubscriptionTarget[], options?: QuoteBatchOptions) => Promise<QuoteBatchResult[]>,
78
+ options: { forceRefresh?: boolean; now?: number } = {},
79
+ ): Promise<FxQuoteRate | FxQuoteMiss | null> {
80
+ if (currency === baseCurrency) return null;
81
+ const now = options.now ?? Date.now();
82
+ const own = fxPairListing(currency, baseCurrency);
83
+ const crossed = currency !== "USD" && baseCurrency !== "USD";
84
+ const legs = crossed ? [dollarLeg(currency), dollarLeg(baseCurrency)] : [];
85
+ const asked = [own, ...legs];
86
+ const results = await getQuotesBatch(
87
+ asked.map((leg) => ({ symbol: leg.symbol, exchange: "" })),
88
+ { forceRefresh: options.forceRefresh === true, revalidate: true },
89
+ );
90
+ const resultOf = (leg: FxQuoteLeg, index: number) => results.find((result) => result.target.symbol === leg.symbol) ?? results[index];
91
+ const read = asked.map((leg, index) => {
92
+ const result = resultOf(leg, index);
93
+ const quote = result?.quote ?? null;
94
+ return { leg, quote, rate: legRate(leg, quote), error: result?.error };
95
+ });
96
+ const [pair, from, into] = read as [typeof read[number], ...typeof read];
97
+ const current = (entry: typeof read[number] | undefined) => entry?.rate != null && !isQuoteStaleForCurrentSession(entry.quote!, now);
98
+ const legsCurrent = crossed && current(from) && current(into);
99
+ if (pair.rate != null && (!legsCurrent || current(pair))) {
100
+ return { rate: pair.rate, quotes: [quotedLeg(pair.leg, pair.quote!)], viaUsd: false };
101
+ }
102
+ if (crossed && from?.rate != null && into?.rate != null) {
103
+ return {
104
+ rate: from.rate / into.rate,
105
+ quotes: [quotedLeg(from.leg, from.quote!), quotedLeg(into.leg, into.quote!)],
106
+ viaUsd: true,
107
+ };
108
+ }
109
+ const missing = crossed
110
+ ? [currency, baseCurrency].filter((_code, index) => read[index + 1]?.rate == null)
111
+ : [currency === "USD" ? baseCurrency : currency];
112
+ return { missing, errors: read.flatMap((entry) => entry.rate == null && entry.error != null ? [entry.error] : []) };
113
+ }
114
+
115
+ /** How long past its feed's delay a weekday FX rate stays current, counted while the FX market trades. */
116
+ const FX_STALE_AFTER_DELAY_MS = 15 * 60_000;
117
+
118
+ /**
119
+ * Whether an FX quote has aged past its feed's delay and fifteen minutes,
120
+ * counting only the hours the FX market trades (`fxFreshUntil`): Friday's
121
+ * close stays current over the weekend, a rate that stopped on a weekday
122
+ * goes stale, whatever the service said of it.
123
+ */
124
+ function fxQuoteAgedOut(observation: { updatedAt: number; delayMinutes?: number }, now = Date.now()): boolean {
125
+ if (!Number.isFinite(observation.updatedAt)) return false;
126
+ return fxFreshUntil(observation.updatedAt, (observation.delayMinutes ?? 0) * 60_000 + FX_STALE_AFTER_DELAY_MS) <= now;
127
+ }
128
+
129
+ /**
130
+ * The one observation a rate is dated by, as `quote` dates a quote: the
131
+ * pair's own quote, or for a cross the older of its two, stale when either
132
+ * is (as the service says, or aged out: `fxQuoteAgedOut`) and as held back as
133
+ * the more delayed.
134
+ */
135
+ export function fxQuoteRateObservation(rate: FxQuoteRate, now = Date.now()): ReturnType<typeof quoteObservation> {
136
+ const observations = rate.quotes.map(({ quote }) => quoteObservation(quote, now));
137
+ const oldest = observations.reduce((older, observation) => observation.updatedAt < older.updatedAt ? observation : older);
138
+ const delays = observations.flatMap((observation) => observation.delayMinutes ?? []);
139
+ return {
140
+ ...oldest,
141
+ stale: observations.some((observation) => observation.stale === true || fxQuoteAgedOut(observation, now)),
142
+ ...(delays.length > 0 ? { delayMinutes: Math.max(...delays) } : {}),
143
+ };
144
+ }
@@ -400,6 +400,11 @@ export const GLOSSARY: readonly GlossaryEntry[] = [
400
400
  definition: "A holding's share of the portfolio's total value, cash included, in percent. A holding without a price is left out of the total. "
401
401
  + "In a book that holds a short, its signed value's share of gross exposure instead, longs plus shorts at their absolute value, so a short weighs negative and cash has no weight.",
402
402
  },
403
+ {
404
+ term: "Contribution", aliases: ["contrib", "period contribution", "contribution to return"], functions: ["PF"], shown: ["Contribution", "CONTRIB"],
405
+ definition: "Over a period (portfolio show --from, fn PF --from), a position's P&L between the two closes as a share of the book's value at the start, in percent; "
406
+ + "of its gross exposure instead, longs plus shorts at their absolute value, when the book holds a short. The positions, the FX line and the total add up.",
407
+ },
403
408
  {
404
409
  term: "Target", aliases: ["target weight", "target weights", "targets", "target allocation"], functions: ["PF"],
405
410
  definition: "The weight you want a holding to have, set with portfolio target set. Targets need not add up to 100%; the report says what is unallocated.",