gloomberb 0.20.2 → 0.20.3

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 (362) 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-form.tsx +13 -8
  5. package/src/account/upgrade-dialog.tsx +1 -1
  6. package/src/api-client/central-bank-rates.ts +5 -0
  7. package/src/api-client/data.ts +17 -4
  8. package/src/api-client/debt-maturities.ts +45 -2
  9. package/src/api-client/earnings.ts +4 -2
  10. package/src/api-client/errors.ts +21 -11
  11. package/src/api-client/index.ts +1 -0
  12. package/src/api-client/paths.ts +9 -1
  13. package/src/api-client/social-mentions.ts +47 -0
  14. package/src/api-client/types/econ.ts +4 -0
  15. package/src/app.tsx +11 -1
  16. package/src/cli/command-options.ts +2 -1
  17. package/src/cli/commands/market.ts +111 -29
  18. package/src/cli/commands/options-chain.ts +23 -6
  19. package/src/cli/commands/overview.ts +13 -5
  20. package/src/cli/commands/plugins.ts +49 -18
  21. package/src/cli/commands/search.ts +25 -6
  22. package/src/cli/commands/ticker.ts +4 -2
  23. package/src/cli/fx-quote-rate.ts +49 -1
  24. package/src/cli/glossary.ts +95 -15
  25. package/src/cli/history-rows.ts +9 -25
  26. package/src/cli/index.ts +6 -38
  27. package/src/cli/known-gaps.ts +3 -3
  28. package/src/cli/listing-arg.ts +78 -18
  29. package/src/cli/name-entries.ts +3 -2
  30. package/src/cli/not-a-ticker.ts +6 -2
  31. package/src/cli/pane-functions/capabilities.ts +12 -1
  32. package/src/cli/pane-functions/function-help.ts +23 -11
  33. package/src/cli/pane-functions/headless.ts +3 -1
  34. package/src/cli/pane-functions/index.ts +32 -4
  35. package/src/cli/pane-functions/market-session.ts +8 -3
  36. package/src/cli/pane-functions/resolver.ts +18 -11
  37. package/src/cli/pane-functions/screenshot-payload.ts +36 -6
  38. package/src/cli/pane-functions/screenshot-render.ts +4 -0
  39. package/src/cli/quote-answer.ts +10 -0
  40. package/src/cli/report-tables.ts +22 -2
  41. package/src/cli/result.ts +7 -3
  42. package/src/cli/spreadsheet-hint.ts +43 -0
  43. package/src/cli/symbol-list.ts +58 -4
  44. package/src/cli/symbol-rows.ts +49 -2
  45. package/src/cli/ticker-resolution.ts +98 -5
  46. package/src/cli/unknown-command.ts +88 -0
  47. package/src/components/command-bar/assist/model.ts +6 -1
  48. package/src/components/command-bar/commands/direct/index.ts +9 -1
  49. package/src/components/command-bar/commands/registry.ts +18 -0
  50. package/src/components/command-bar/pane-actions.ts +30 -13
  51. package/src/components/command-bar/panel/index.tsx +6 -3
  52. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  53. package/src/components/command-bar/panel/types.ts +3 -0
  54. package/src/components/command-bar/routes/header-market.ts +108 -0
  55. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  56. package/src/components/command-bar/routes/root/provider-search.ts +190 -32
  57. package/src/components/command-bar/routes/root/results.ts +3 -0
  58. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  59. package/src/components/command-bar/routes/ticker-search/results.ts +53 -6
  60. package/src/components/command-bar/routing/list-state.ts +38 -0
  61. package/src/components/command-bar/selection-hint.ts +28 -0
  62. package/src/components/command-bar/surface/index.tsx +41 -3
  63. package/src/components/command-bar/view-model.ts +15 -0
  64. package/src/components/command-bar/workflow/tickers.ts +3 -2
  65. package/src/components/company-logo.tsx +20 -2
  66. package/src/components/data-table/export.ts +13 -8
  67. package/src/components/feedback-dialog.tsx +2 -1
  68. package/src/components/form-modal/field-row.tsx +2 -1
  69. package/src/components/input-search-bar.tsx +2 -2
  70. package/src/components/layout/double-escape-close.ts +8 -5
  71. package/src/components/layout/header.tsx +75 -44
  72. package/src/components/layout/market-summary.ts +322 -116
  73. package/src/components/layout/pane/footer/index.tsx +26 -8
  74. package/src/components/layout/pane/footer/model.ts +46 -20
  75. package/src/components/layout/pane/header.tsx +3 -2
  76. package/src/components/layout/shell/chrome.ts +15 -15
  77. package/src/components/layout/status-bar.tsx +8 -7
  78. package/src/components/layout/status-widget-space.ts +8 -0
  79. package/src/components/markdown-editor.tsx +2 -2
  80. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  81. package/src/components/onboarding/onboarding-keyboard.ts +15 -6
  82. package/src/components/onboarding/onboarding-wizard.tsx +61 -11
  83. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  84. package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
  85. package/src/components/price-sparkline/model.ts +26 -10
  86. package/src/components/ticker/list-table-view.tsx +29 -4
  87. package/src/components/ui/button.tsx +13 -2
  88. package/src/components/ui/column-grid.tsx +18 -9
  89. package/src/components/ui/data-table/index.tsx +1 -1
  90. package/src/components/ui/data-table/opentui/index.tsx +2 -1
  91. package/src/components/ui/data-table/types.ts +18 -0
  92. package/src/components/ui/delayed-mark.tsx +3 -2
  93. package/src/components/ui/field-grid.tsx +0 -2
  94. package/src/components/ui/fields.tsx +7 -4
  95. package/src/components/ui/inline-quick-add.tsx +2 -2
  96. package/src/components/ui/key-hint-words.ts +153 -0
  97. package/src/components/ui/key-hints.tsx +73 -0
  98. package/src/components/ui/menu.tsx +3 -1
  99. package/src/components/ui/message-composer.tsx +2 -2
  100. package/src/components/ui/shortcut-hint.tsx +28 -3
  101. package/src/components/ui/tabs.tsx +7 -0
  102. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  103. package/src/core/state/app/command-bar-launch.ts +3 -0
  104. package/src/data/config/store/normalize.ts +6 -0
  105. package/src/docs/snapshot.json +120 -69
  106. package/src/i18n/es.ts +24 -1
  107. package/src/i18n/ja.ts +24 -1
  108. package/src/i18n/ko.ts +24 -1
  109. package/src/i18n/zh-cn.ts +24 -1
  110. package/src/i18n/zh-tw.ts +24 -1
  111. package/src/layout/pane-manager/gridlock.ts +11 -0
  112. package/src/market-data/bars-per-year.ts +27 -9
  113. package/src/market-data/coordinator/quotes.ts +22 -3
  114. package/src/market-data/futures-board.ts +80 -0
  115. package/src/market-data/futures-contract.ts +9 -3
  116. package/src/market-data/market/change-basis.ts +2 -2
  117. package/src/market-data/market/dated-previous-close.ts +163 -47
  118. package/src/market-data/market/format.ts +14 -3
  119. package/src/market-data/market/freshness.ts +24 -7
  120. package/src/market-data/market/header-market.ts +154 -0
  121. package/src/market-data/market/index-level.ts +29 -0
  122. package/src/market-data/market/index-session-venues.ts +44 -0
  123. package/src/market-data/market/status.ts +7 -2
  124. package/src/market-data/market/venue-session.ts +72 -0
  125. package/src/market-data/model-dividend-yield.ts +23 -8
  126. package/src/market-data/options-alternatives.ts +39 -4
  127. package/src/market-data/published-apac-sessions.ts +40 -2
  128. package/src/market-data/quotes/export-identity.ts +76 -0
  129. package/src/market-data/quotes/freshness.ts +22 -0
  130. package/src/market-data/quotes/time.ts +42 -1
  131. package/src/market-data/realized-volatility.ts +11 -7
  132. package/src/market-data/tax-equivalent.ts +145 -27
  133. package/src/plugins/builtin/account-management/pane.tsx +2 -2
  134. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  135. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  136. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  137. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  138. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  139. package/src/plugins/builtin/alerts/cli.ts +224 -33
  140. package/src/plugins/builtin/alerts/command.ts +33 -6
  141. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  142. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  143. package/src/plugins/builtin/alerts/events.ts +9 -0
  144. package/src/plugins/builtin/alerts/format.ts +40 -15
  145. package/src/plugins/builtin/alerts/headless.ts +31 -18
  146. package/src/plugins/builtin/alerts/history.ts +1 -0
  147. package/src/plugins/builtin/alerts/index.tsx +86 -12
  148. package/src/plugins/builtin/alerts/live.ts +2 -1
  149. package/src/plugins/builtin/alerts/move-checks.ts +155 -0
  150. package/src/plugins/builtin/alerts/move.ts +160 -0
  151. package/src/plugins/builtin/alerts/pane.tsx +52 -22
  152. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  153. package/src/plugins/builtin/alerts/price.ts +17 -0
  154. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  155. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  156. package/src/plugins/builtin/alerts/storage.ts +20 -7
  157. package/src/plugins/builtin/alerts/types.ts +13 -0
  158. package/src/plugins/builtin/analytics/risk-client.ts +60 -39
  159. package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
  160. package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
  161. package/src/plugins/builtin/analytics/risk-model.ts +68 -1
  162. package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
  163. package/src/plugins/builtin/backtest/engine.ts +4 -2
  164. package/src/plugins/builtin/backtest/window.ts +3 -1
  165. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  166. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  167. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  168. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  169. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  170. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  171. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  172. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  173. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  174. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  175. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  176. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  177. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  178. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  179. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  180. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  181. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  182. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  183. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  184. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  185. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  186. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  187. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  188. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  189. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  190. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  191. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  192. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  193. package/src/plugins/builtin/econ/figures.ts +13 -0
  194. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  195. package/src/plugins/builtin/econ/index.tsx +5 -3
  196. package/src/plugins/builtin/econ/types.ts +5 -0
  197. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  198. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  199. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  200. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  201. package/src/plugins/builtin/futures/table.tsx +1 -1
  202. package/src/plugins/builtin/futures-curve/model.ts +3 -10
  203. package/src/plugins/builtin/help/function-card.tsx +2 -1
  204. package/src/plugins/builtin/help/function-index.ts +1 -0
  205. package/src/plugins/builtin/insider/client.ts +31 -14
  206. package/src/plugins/builtin/insider/signals-model.ts +2 -7
  207. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  208. package/src/plugins/builtin/iv-history/model.ts +33 -23
  209. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  210. package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
  211. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  212. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  213. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  214. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  215. package/src/plugins/builtin/news/index.tsx +7 -13
  216. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  217. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  218. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  219. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  220. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  221. package/src/plugins/builtin/options/analytics.ts +7 -2
  222. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  223. package/src/plugins/builtin/options/table.ts +3 -2
  224. package/src/plugins/builtin/options/view.tsx +11 -9
  225. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  226. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  227. package/src/plugins/builtin/perps/client.ts +5 -4
  228. package/src/plugins/builtin/perps/headless.ts +134 -124
  229. package/src/plugins/builtin/perps/markets-section.tsx +2 -2
  230. package/src/plugins/builtin/perps/model.ts +8 -4
  231. package/src/plugins/builtin/perps/open-market.ts +4 -4
  232. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  233. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  234. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
  235. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
  236. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
  237. package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
  238. package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
  239. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  240. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
  241. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  242. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
  243. package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
  244. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  245. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  246. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  247. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  248. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  249. package/src/plugins/builtin/sec/headless.ts +48 -6
  250. package/src/plugins/builtin/sec/index.tsx +6 -4
  251. package/src/plugins/builtin/sec/model.ts +4 -1
  252. package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
  253. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  254. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  255. package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
  256. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  257. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  258. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  259. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  260. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  261. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  262. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  263. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  264. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  265. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  266. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  267. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  268. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  269. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  270. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  271. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  272. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  273. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  274. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  275. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  276. package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
  277. package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
  278. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  279. package/src/plugins/builtin/ticker-detail/overview/components.tsx +13 -1
  280. package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
  281. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  282. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  283. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +41 -6
  284. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  285. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  286. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  287. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  288. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  289. package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
  290. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  291. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  292. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  293. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  294. package/src/plugins/builtin/world-indices/client.ts +2 -0
  295. package/src/plugins/compat.ts +15 -0
  296. package/src/plugins/host-link.ts +6 -1
  297. package/src/plugins/installer.ts +8 -3
  298. package/src/portfolio/column-values.ts +14 -4
  299. package/src/portfolio/listed-symbol.ts +78 -0
  300. package/src/portfolio/real-return.ts +172 -0
  301. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  302. package/src/renderers/browser/config-host.ts +56 -15
  303. package/src/renderers/browser/main.tsx +3 -1
  304. package/src/renderers/browser/ui-host.tsx +1 -0
  305. package/src/renderers/cloudflare/http-proxy.ts +1 -0
  306. package/src/renderers/dom/boot-frame.ts +2 -2
  307. package/src/renderers/dom/data-table/row.tsx +4 -1
  308. package/src/renderers/dom/desktop/controls.tsx +4 -4
  309. package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
  310. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  311. package/src/renderers/dom/host/input.tsx +4 -1
  312. package/src/renderers/dom/host/tabs.tsx +10 -1
  313. package/src/renderers/dom/styles.css +33 -13
  314. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  315. package/src/renderers/opentui/host.tsx +2 -1
  316. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  317. package/src/sources/gloomberb-cloud/index.ts +31 -2
  318. package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
  319. package/src/sources/provider-router/cached-routes.ts +19 -7
  320. package/src/state/pane-table-export-registry.ts +19 -6
  321. package/src/test-support/preload.ts +5 -1
  322. package/src/theme/colors.ts +9 -1
  323. package/src/theme/themes.ts +62 -15
  324. package/src/theme/tone-contrast.ts +40 -0
  325. package/src/theme/ui-tokens.ts +23 -3
  326. package/src/tickers/batched-lookups.ts +57 -8
  327. package/src/tickers/company-name-listing.ts +156 -14
  328. package/src/tickers/company-name.ts +30 -6
  329. package/src/tickers/list.ts +7 -0
  330. package/src/tickers/search/home-listing.ts +31 -9
  331. package/src/tickers/search/index.ts +13 -3
  332. package/src/tickers/search/listing-index.ts +558 -0
  333. package/src/tickers/search/major-listings.chunk.ts +10 -0
  334. package/src/tickers/search/major-listings.json +3346 -0
  335. package/src/tickers/search/ranking.ts +68 -1
  336. package/src/tickers/search/types.ts +4 -0
  337. package/src/tickers/terminal-codes.ts +26 -1
  338. package/src/time-series/calendar-month-returns.ts +47 -0
  339. package/src/time-series/currency-conversion.ts +130 -0
  340. package/src/time-series/hooks.ts +2 -0
  341. package/src/time-series/price-comparison.ts +34 -11
  342. package/src/time-series/resolve-context.ts +3 -0
  343. package/src/time-series/resolve.ts +14 -2
  344. package/src/time-series/spec.ts +1 -0
  345. package/src/time-series/studies/indicators.ts +4 -1
  346. package/src/time-series/types.ts +8 -0
  347. package/src/types/config.ts +8 -0
  348. package/src/types/data-provider.ts +28 -0
  349. package/src/types/financials.ts +20 -2
  350. package/src/types/headless.ts +12 -0
  351. package/src/ui/host.tsx +8 -0
  352. package/src/utils/datetime-format.ts +17 -3
  353. package/src/utils/display-number.ts +15 -0
  354. package/src/utils/double-escape-close.ts +61 -16
  355. package/src/utils/float32-price.ts +24 -0
  356. package/src/utils/forward-dividend.ts +81 -16
  357. package/src/utils/fx-market-hours.ts +11 -0
  358. package/src/utils/plugin-proxy-hosts.json +2 -1
  359. package/src/utils/price-history.ts +7 -6
  360. package/src/utils/report-timing.ts +62 -0
  361. package/src/utils/sec-filings.ts +32 -0
  362. package/src/utils/utc-time.ts +5 -0
@@ -1,8 +1,11 @@
1
1
  import type { DataProvider } from "../../../types/data-provider";
2
+ import { chunked } from "../../../utils/concurrency";
2
3
  import type { Quote } from "../../../types/financials";
3
4
  import { getActiveQuoteDisplay } from "../../../market-data/market/status";
5
+ import { isPenceQuotedLine } from "../../../market-data/market/format";
4
6
  import { isQuoteStaleForCurrentSession } from "../../../market-data/quotes/freshness";
5
7
  import { canonicalExchange } from "../../../utils/exchanges";
8
+ import { readMove } from "./move";
6
9
  import type { AlertRule } from "./types";
7
10
 
8
11
  export function normalizeAlertSymbol(value: string | null | undefined): string {
@@ -22,7 +25,45 @@ export async function resolveAlertQuote(
22
25
  symbol: string,
23
26
  exchange = "",
24
27
  ): Promise<Quote> {
25
- const quote = await marketData.getQuote(symbol, exchange);
28
+ return alertQuote(await marketData.getQuote(symbol, exchange), symbol);
29
+ }
30
+
31
+ /** Listings quoted in one request of the alert poll: as many as a signed-out caller's batch may read. */
32
+ const ALERT_QUOTE_BATCH = 100;
33
+
34
+ /**
35
+ * Quotes for many listings, a hundred to a request and one request after
36
+ * another, each read as `resolveAlertQuote` reads one: five hundred move
37
+ * rules are five requests a check, not five hundred. A listing with no
38
+ * quote gets why, as a string. Without batches, each is asked on its own.
39
+ */
40
+ export async function resolveAlertQuotes(
41
+ marketData: Pick<DataProvider, "getQuote" | "getQuotesBatch">,
42
+ targets: ReadonlyArray<{ symbol: string; exchange: string }>,
43
+ ): Promise<Array<Quote | string>> {
44
+ const asked = targets.map((target) => ({ symbol: target.symbol, exchange: target.exchange }));
45
+ const one = (target: { symbol: string; exchange: string }) => resolveAlertQuote(marketData, target.symbol, target.exchange)
46
+ .catch((error: unknown) => createQuoteErrorMessage(target.symbol, error));
47
+ if (!marketData.getQuotesBatch) return Promise.all(asked.map(one));
48
+ const answers: Array<Quote | string> = [];
49
+ for (const chunk of chunked(asked, ALERT_QUOTE_BATCH)) {
50
+ const results = await marketData.getQuotesBatch(chunk).catch((error: unknown) => chunk.map((target) => ({ target, quote: null, error })));
51
+ answers.push(...chunk.map((target) => {
52
+ const result = results.find((entry) => entry.target === target)
53
+ ?? results.find((entry) => entry.target.symbol === target.symbol && (entry.target.exchange ?? "") === target.exchange);
54
+ if (!result?.quote) return createQuoteErrorMessage(target.symbol, result?.error instanceof Error ? result.error : result?.error ? new Error(String(result.error)) : undefined);
55
+ try {
56
+ return alertQuote(result.quote, target.symbol);
57
+ } catch (error) {
58
+ return createQuoteErrorMessage(target.symbol, error);
59
+ }
60
+ }));
61
+ }
62
+ return answers;
63
+ }
64
+
65
+ /** A quote an alert may be judged on, at the price its active session shows; throws for a stale one or one with no price. */
66
+ function alertQuote(quote: Quote, symbol: string): Quote {
26
67
  // A last known price is not the price now: it must neither trigger an alert nor set its baseline.
27
68
  if (isQuoteStaleForCurrentSession(quote)) throw new Error(`The quote for "${symbol}" is stale.`);
28
69
  const display = getActiveQuoteDisplay(quote);
@@ -49,6 +90,7 @@ export function quoteAlertFields(
49
90
  | "lastQuoteProviderId"
50
91
  | "lastQuoteCurrency"
51
92
  | "lastQuoteExchange"
93
+ | "lastQuotePence"
52
94
  > & { lastCheckError?: undefined } {
53
95
  const exchange = quote.listingExchangeName || quote.exchangeName;
54
96
  return {
@@ -59,10 +101,21 @@ export function quoteAlertFields(
59
101
  lastQuoteProviderId: quote.providerId,
60
102
  ...(quote.currency ? { lastQuoteCurrency: quote.currency } : {}),
61
103
  ...(exchange ? { lastQuoteExchange: canonicalExchange(exchange) } : {}),
104
+ // A London line in pence writes its levels in pence; a quote that is not clears it.
105
+ lastQuotePence: isPenceQuotedLine(quote) || undefined,
62
106
  lastCheckError: undefined,
63
107
  };
64
108
  }
65
109
 
110
+ /**
111
+ * A move rule's fields from a quote: those a price rule takes, with the
112
+ * reading the quote's move (in percent) and the close it is measured from.
113
+ */
114
+ export function moveQuoteFields(quote: Quote, checkedAt = Date.now()): ReturnType<typeof quoteAlertFields> & Pick<AlertRule, "lastMoveBasis"> {
115
+ const reading = readMove(quote, checkedAt);
116
+ return { ...quoteAlertFields(quote, checkedAt), lastCheckedPrice: reading?.percent, lastMoveBasis: reading?.basis };
117
+ }
118
+
66
119
  export function quoteErrorAlertFields(
67
120
  error: string,
68
121
  checkedAt = Date.now(),
@@ -89,10 +142,38 @@ const priceText = (value: number) => value.toLocaleString("en-US", Math.abs(valu
89
142
  * Null when the target is near enough, or there is no positive last price to
90
143
  * measure it against.
91
144
  */
92
- export function farTargetMessage(symbol: string, target: number, last: number | null | undefined, coinNote: string | null): string | null {
145
+ export function farTargetMessage(symbol: string, target: number, last: number | null | undefined, coinNote: string | null, pence = false): string | null {
93
146
  if (last == null || !Number.isFinite(last) || last <= 0) return null;
94
147
  const above = target > last * MAX_TARGET_RATIO;
95
148
  if (!above && target >= last / MAX_TARGET_RATIO) return null;
96
149
  const how = above ? `more than ${MAX_TARGET_RATIO} times` : `under 1/${MAX_TARGET_RATIO} of`;
97
- return `A target of ${priceText(target)} is ${how} ${symbol}'s last price of ${priceText(last)}. ${coinNote ?? "Check the price and the symbol."}`;
150
+ // A London line quoted in pence says both in pence, the unit its quote shows (7,000p, 119.4p).
151
+ const text = (value: number) => pence ? `${priceText(Number((value * 100).toPrecision(12)))}p` : priceText(value);
152
+ return `A target of ${text(target)} is ${how} ${symbol}'s last price of ${text(last)}. ${coinNote ?? "Check the price and the symbol."}`;
153
+ }
154
+
155
+ /**
156
+ * A level read in the unit its line's quote shows. On a London line quoted
157
+ * in pence, `70p` is £0.70, and so is a bare 70 when 70 in pounds is ten
158
+ * times off the price and 70p is not (VOD at 119.4p); the note says how it
159
+ * was read. Pence on a line not quoted in them is refused, naming its unit.
160
+ */
161
+ export function levelInQuoteUnit(
162
+ level: { price: number; pence?: boolean; typed?: string },
163
+ quote: Pick<Quote, "currency" | "providerPriceDivisor" | "price">,
164
+ listing: string,
165
+ ): { price: number; pence: boolean; note: string | null } {
166
+ const pence = isPenceQuotedLine(quote);
167
+ if (level.pence && !pence) {
168
+ const currency = quote.currency?.trim().toUpperCase() || "";
169
+ // A London line priced in pounds takes the level in pounds; anywhere else, pence mean nothing.
170
+ if (currency !== "GBP") throw new Error(`${listing} trades in ${currency || "its own currency"}; pence (p) only apply to London prices.`);
171
+ const typed = Number((level.price * 100).toPrecision(12));
172
+ throw new Error(`${listing} is quoted in pounds (GBP), not pence: type ${typed / 100} for ${typed}p.`);
173
+ }
174
+ if (!pence || level.pence) return { price: level.price, pence, note: null };
175
+ const inPence = Number((level.price / 100).toPrecision(12));
176
+ if (!farTargetMessage(listing, level.price, quote.price, null) || farTargetMessage(listing, inPence, quote.price, null)) return { price: level.price, pence, note: null };
177
+ const typed = level.typed ?? String(level.price);
178
+ return { price: inPence, pence, note: `Read ${typed} as ${typed}p: ${listing} is quoted in pence.` };
98
179
  }
@@ -161,7 +161,7 @@ export function startScheduledEventAlerts(
161
161
  let updated = rule;
162
162
  const date = followedDate(rule, scheduled, dates, ruleToday, calendar, at);
163
163
  if (date !== (rule.eventDate ?? null)) {
164
- const { eventDate: _previous, ...rest } = rule;
164
+ const { eventDate: _previous, eventTime: _time, ...rest } = rule;
165
165
  updated = date ? { ...rest, eventDate: date } : rest;
166
166
  changed = true;
167
167
  }
@@ -171,6 +171,12 @@ export function startScheduledEventAlerts(
171
171
  // The release's row on the day followed: its time, and its figures once out.
172
172
  const row = calendar && updated.eventDate && followsRelease(target) ? releaseRowOn(target, updated.eventDate, calendar) : null;
173
173
  const time = row ? releaseInstant(row) : null;
174
+ // A release's print time, kept beside its day for the Events tab and `fn ALRT`.
175
+ const eventTime = time != null && rule.kind === "calendar_event" ? new Date(time).toISOString().replace(/\.000Z$/, "Z") : null;
176
+ if (eventTime && updated.eventTime !== eventTime) {
177
+ updated = { ...updated, eventTime };
178
+ changed = true;
179
+ }
174
180
  if (updated.eventDate && scheduledPhase(updated.eventDate, scheduled.leadDays, updated.firedFor, ruleToday, scheduled.trigger) === "due") {
175
181
  // A results alert goes off once the report it waits for has its actual EPS.
176
182
  const result = scheduled.trigger === "results" && target.kind === "earnings"
@@ -8,6 +8,8 @@ import {
8
8
  } from "./alert-engine";
9
9
  import { ALERTS_KEY, ALERTS_PLUGIN_ID } from "./constants";
10
10
  import { readEventAlertStores } from "./events";
11
+ import { MOVE_ALERTS_KEY } from "./move";
12
+ import { moveRuleOnly } from "./move-checks";
11
13
  import type { AlertRule } from "./types";
12
14
 
13
15
  export function loadAlerts(ctx: GloomPluginContext): AlertRule[] {
@@ -22,11 +24,18 @@ export async function saveAlerts(
22
24
  ): Promise<void> {
23
25
  const stores = readLevelAlertStores((key) => ctx.configState.get<unknown>(key));
24
26
  // An unreadable list is never written over; one that has nothing to write does not hold up the others.
27
+ // Prices and moves are judged on quotes; valuation, technical and relative strength rules on their own readings.
28
+ const quoted = (key: string) => key === ALERTS_KEY || key === MOVE_ALERTS_KEY;
25
29
  const entries = Object.entries(writeLevelAlertStores(alerts)).filter(([key, value]) => (scope === "all"
26
- || (scope === "price" ? key === ALERTS_KEY : key !== ALERTS_KEY)) && !(stores.errors[key] && value === "[]"));
30
+ || (scope === "price" ? quoted(key) : !quoted(key))) && !(stores.errors[key] && value === "[]"));
27
31
  for (const [key] of entries) if (stores.errors[key]) throw new Error(stores.errors[key]!);
28
32
  for (const [key, value] of entries) {
29
- if (ctx.configState.get<unknown>(key) !== value) await ctx.configState.set(key, value);
33
+ const current = ctx.configState.get<unknown>(key);
34
+ // A list never written that stays empty (moves, on a profile without them) is left unwritten.
35
+ if (current === value || (current == null && value === "[]")) continue;
36
+ // Move rules that read as the ones to write are left as written, whatever the order of their fields: a check changes no rule.
37
+ if (key === MOVE_ALERTS_KEY && !stores.errors[key] && serializeAlerts(deserializeAlerts(current).map(moveRuleOnly)) === value) continue;
38
+ await ctx.configState.set(key, value);
30
39
  }
31
40
  }
32
41
 
@@ -53,14 +62,18 @@ export function readLevelAlertStores(get: (key: string) => unknown): { alerts: A
53
62
  const rows = error ? [] : deserializeAlerts(raw);
54
63
  if (rows.some(a => levelAlertStoreKey(a) !== key)) error = "Saved alerts contain a rule in the wrong list. Original data has been kept.";
55
64
  errors[key] = key === METRIC_ALERTS_KEY ? error?.replaceAll("price alerts", "valuation and technical alerts") ?? null
56
- : key === RELATIVE_ALERTS_KEY ? error?.replaceAll("price alerts", "relative strength alerts") ?? null : error;
65
+ : key === RELATIVE_ALERTS_KEY ? error?.replaceAll("price alerts", "relative strength alerts") ?? null
66
+ : key === MOVE_ALERTS_KEY ? error?.replaceAll("price alerts", "move alerts") ?? null : error;
57
67
  if (!error) alerts.push(...rows);
58
68
  }
59
69
  return { alerts, errors, error: Object.values(errors).filter(Boolean).join(" ") || null };
60
70
  }
61
71
  export function writeLevelAlertStores(alerts: AlertRule[]): Record<string, string> {
62
- return Object.fromEntries(LEVEL_ALERT_KEYS.map(key => [key, serializeAlerts(alerts.filter(a => levelAlertStoreKey(a) === key))]));
72
+ // A move rule is written as the rule alone: its readings are this device's (`MOVE_CHECKS_KEY`), so a check never changes the list.
73
+ return Object.fromEntries(LEVEL_ALERT_KEYS.map(key => [key, serializeAlerts(alerts.filter(a => levelAlertStoreKey(a) === key)
74
+ .map((alert) => alert.move ? moveRuleOnly(alert) : alert))]));
63
75
  }
64
- /** Price, valuation/technical and relative strength rules each keep their own synced list. */
65
- const LEVEL_ALERT_KEYS = [ALERTS_KEY, METRIC_ALERTS_KEY, RELATIVE_ALERTS_KEY] as const;
66
- export const levelAlertStoreKey = (alert: Pick<AlertRule, "metric">): string => alert.metric ? metricAlertsKey(alert.metric) : ALERTS_KEY;
76
+ /** Price, valuation/technical, relative strength and move rules each keep their own synced list. */
77
+ const LEVEL_ALERT_KEYS = [ALERTS_KEY, METRIC_ALERTS_KEY, RELATIVE_ALERTS_KEY, MOVE_ALERTS_KEY] as const;
78
+ export const levelAlertStoreKey = (alert: Pick<AlertRule, "metric" | "move">): string =>
79
+ alert.metric ? metricAlertsKey(alert.metric) : alert.move ? MOVE_ALERTS_KEY : ALERTS_KEY;
@@ -1,4 +1,5 @@
1
1
  import type { QuoteDataSource } from "../../../types/financials";
2
+ import type { QuoteChangeBasis } from "../../../market-data/market/change-basis";
2
3
 
3
4
  export type AlertCondition = "above" | "below" | "crosses";
4
5
  export type AlertStatus = "active" | "triggered" | "expired";
@@ -10,6 +11,16 @@ export interface AlertRule {
10
11
  condition: AlertCondition;
11
12
  targetPrice: number;
12
13
  metric?: import("./metric-model").AlertMetric;
14
+ /**
15
+ * A move from the previous close rather than a price level: `targetPrice` is
16
+ * the move in percent, `above` a rise, `below` a fall and `crosses` either.
17
+ * Kept in its own synced list (`MOVE_ALERTS_KEY`).
18
+ */
19
+ move?: boolean;
20
+ /** The session a move rule last went off in (the close it was measured from); it arms again in the next one. */
21
+ moveSession?: string;
22
+ /** What the last move read was measured from, as its quote's change line names it. */
23
+ lastMoveBasis?: QuoteChangeBasis;
13
24
  lastDailyClose?: string;
14
25
  lastCheckedTarget?: number;
15
26
  createdAt: number;
@@ -27,5 +38,7 @@ export interface AlertRule {
27
38
  lastQuoteCurrency?: string;
28
39
  /** The venue that quote was from (ARCA), which names the listing of a rule set by symbol alone. */
29
40
  lastQuoteExchange?: string;
41
+ /** That quote was of a London line in pence (117.35p), whose levels are written in pence. */
42
+ lastQuotePence?: boolean;
30
43
  message?: string;
31
44
  }
@@ -377,6 +377,62 @@ export async function fetchPortfolioRiskMarket(
377
377
  ...factors,
378
378
  ]).values(),
379
379
  ];
380
+ const start = new Date(now);
381
+ start.setUTCMonth(start.getUTCMonth() - 18);
382
+ start.setUTCDate(1);
383
+ const today = now.toISOString().slice(0, 10);
384
+ const startDate = start.toISOString().slice(0, 10),
385
+ endDate = new Date(Date.parse(today) - 86_400_000)
386
+ .toISOString()
387
+ .slice(0, 10);
388
+ const historyParams = {
389
+ interval: "1day",
390
+ startDate,
391
+ // validateRiskHistory drops today's bar; ending on yesterday
392
+ // loses yesterday's close for most listings.
393
+ endDate: today,
394
+ outputsize: 1000,
395
+ rangeKey: "2Y",
396
+ } as const;
397
+ const account = accountCurrency === "USD" ? null : accountCurrency;
398
+ // Every daily history is read once per listing, under one key: a factor proxy's is the holding's of the same
399
+ // listing however the book names its venue (SPY, ARCA:SPY), and the account currency's pair is its FX leg's.
400
+ const dailyHistories = new Map<string, ReturnType<RiskCloudClient["getCloudHistory"]>>();
401
+ const historyOf = (symbol: string, exchange: string) => {
402
+ const key = `${canonicalExchange(exchange)}:${normalizeSymbol(symbol)}`;
403
+ let loading = dailyHistories.get(key);
404
+ if (!loading) {
405
+ dailyHistories.set(key, loading = client.getCloudHistory(symbol, exchange, historyParams, signal ? { signal } : undefined));
406
+ loading.catch(() => {
407
+ // Intentional ignore: the failure is raised where the history is read.
408
+ });
409
+ }
410
+ return loading;
411
+ };
412
+ // What needs no quote goes out with the quotes, not after them: the factor proxies' histories, and the account
413
+ // currency's rate and daily closes.
414
+ for (const instrument of factors.values()) void historyOf(instrument.symbol, instrument.exchange || "");
415
+ const accountConversion = account ? riskConversion(account) : null;
416
+ if (accountConversion && accountConversion.divisor === 1)
417
+ void historyOf(accountConversion.leg.instrument.symbol, accountConversion.leg.instrument.exchange ?? "");
418
+ const accountRate = account ? client.getCloudExchangeRate(account) : null;
419
+ accountRate?.catch(() => {
420
+ // Intentional ignore: the failure is raised where the rate is read.
421
+ });
422
+ // The Treasury yield and the VIX, which settle rather than fail.
423
+ const fredWork = Promise.allSettled(
424
+ ["DGS10", "VIXCLS"].map(async (id) =>
425
+ validateFred(
426
+ await client.getCloudFredSeries(id, {
427
+ startDate,
428
+ endDate,
429
+ limit: 1000,
430
+ sortOrder: "asc",
431
+ }, signal ? { signal } : undefined),
432
+ id,
433
+ ),
434
+ ),
435
+ );
380
436
  const quotes = new Map<string, CloudQuotePayload>();
381
437
  const listings = new Map<string, { price: number; currency: string }>();
382
438
  // Listings quoted in another currency that convert to USD, and why the others do not.
@@ -441,7 +497,6 @@ export async function fetchPortfolioRiskMarket(
441
497
  }
442
498
  // Current rates value a foreign holding: its rank, its mark, and its size when left out.
443
499
  // The account currency's comes first: it values every holding.
444
- const account = accountCurrency === "USD" ? null : accountCurrency;
445
500
  const fxCurrencies = [
446
501
  ...new Set(
447
502
  [...(account ? [account] : []), ...[...entries.values()].flatMap((row) => {
@@ -457,7 +512,7 @@ export async function fetchPortfolioRiskMarket(
457
512
  ].slice(0, MAX_FX_CURRENCIES);
458
513
  const fx = await Promise.allSettled(
459
514
  fxCurrencies.map(async (currency) => {
460
- const response = await client.getCloudExchangeRate(currency);
515
+ const response = await (currency === account && accountRate ? accountRate : client.getCloudExchangeRate(currency));
461
516
  const rate = response.status === "success" || response.status === "partial"
462
517
  ? response.data?.rate
463
518
  : undefined;
@@ -501,23 +556,6 @@ export async function fetchPortfolioRiskMarket(
501
556
  const instruments = [
502
557
  ...new Map([...factors, ...[...entries.values()].map((row) => [row.id, row.instrument] as const)]).entries(),
503
558
  ];
504
- const start = new Date(now);
505
- start.setUTCMonth(start.getUTCMonth() - 18);
506
- start.setUTCDate(1);
507
- const today = now.toISOString().slice(0, 10);
508
- const startDate = start.toISOString().slice(0, 10),
509
- endDate = new Date(Date.parse(today) - 86_400_000)
510
- .toISOString()
511
- .slice(0, 10);
512
- const historyParams = {
513
- interval: "1day",
514
- startDate,
515
- // validateRiskHistory drops today's bar; ending on yesterday
516
- // loses yesterday's close for most listings.
517
- endDate: today,
518
- outputsize: 1000,
519
- rangeKey: "2Y",
520
- } as const;
521
559
  const histories: RiskMarketHistory[] = instruments.map(([id, instrument]) => {
522
560
  const quote = quotes.get(id) ?? null,
523
561
  listing = listings.get(id) ?? null;
@@ -548,7 +586,7 @@ export async function fetchPortfolioRiskMarket(
548
586
  let closes: FxCloses;
549
587
  try {
550
588
  closes = validateFxHistory(
551
- await client.getCloudHistory(symbol, exchange ?? "", historyParams, signal ? { signal } : undefined),
589
+ await historyOf(symbol, exchange ?? ""),
552
590
  conversion.leg,
553
591
  now,
554
592
  );
@@ -597,12 +635,7 @@ export async function fetchPortfolioRiskMarket(
597
635
  { instrument, quote } = entry;
598
636
  try {
599
637
  const fxCloses = conversion ? await fxHistory(conversion) : null;
600
- const response = await client.getCloudHistory(
601
- instrument.symbol,
602
- instrument.exchange || quote?.listingExchangeName || "",
603
- historyParams,
604
- signal ? { signal } : undefined,
605
- );
638
+ const response = await historyOf(instrument.symbol, instrument.exchange || quote?.listingExchangeName || "");
606
639
  const { latestClose, fxBridged, ...resolved } = validateRiskHistory(
607
640
  response,
608
641
  instrument,
@@ -644,19 +677,7 @@ export async function fetchPortfolioRiskMarket(
644
677
  );
645
678
  const [, fred, accountFx] = await Promise.all([
646
679
  historyWork,
647
- Promise.allSettled(
648
- ["DGS10", "VIXCLS"].map(async (id) =>
649
- validateFred(
650
- await client.getCloudFredSeries(id, {
651
- startDate,
652
- endDate,
653
- limit: 1000,
654
- sortOrder: "asc",
655
- }, signal ? { signal } : undefined),
656
- id,
657
- ),
658
- ),
659
- ),
680
+ fredWork,
660
681
  accountWork,
661
682
  ]);
662
683
  signal?.throwIfAborted();
@@ -160,6 +160,24 @@ export function cloudEpisodeReader(client: EpisodeClient = apiClient): EpisodeRe
160
160
  };
161
161
  }
162
162
 
163
+ /**
164
+ * A reader that asks for each listing's and currency's closes once: a read
165
+ * started early is the one a later load of the same closes waits on.
166
+ */
167
+ export function onceEpisodeReader(reader: EpisodeReader): EpisodeReader {
168
+ const instruments = new Map<string, Promise<EpisodeClosesById>>();
169
+ const currencies = new Map<string, Promise<EpisodeClosesById>>();
170
+ const once = (reads: Map<string, Promise<EpisodeClosesById>>, key: string, read: () => Promise<EpisodeClosesById>) => {
171
+ let pending = reads.get(key);
172
+ if (!pending) reads.set(key, pending = read());
173
+ return pending;
174
+ };
175
+ return {
176
+ instrument: (instrument, signal) => once(instruments, riskInstrumentId(instrument), () => reader.instrument(instrument, signal)),
177
+ currency: (currency, signal) => once(currencies, currency, () => reader.currency(currency, signal)),
178
+ };
179
+ }
180
+
163
181
  /**
164
182
  * The closes the episode replays read: SPY's, every target's, and the daily
165
183
  * FX closes of each currency a target quotes in and of a non-USD account,
@@ -2,7 +2,7 @@ import { loadPortfolioOptionBook } from "./risk-options";
2
2
  import type { HeadlessPaneDefinition } from "../../../types/plugin";
3
3
  import { fetchPortfolioRiskMarket, RISK_HISTORY_LIMIT } from "./risk-client";
4
4
  import { parsePortfolioRiskEvidence } from "./risk-evidence";
5
- import { cloudEpisodeReader, fetchRiskEpisodeHistory, riskEpisodeTargets } from "./risk-episodes";
5
+ import { cloudEpisodeReader, fetchRiskEpisodeHistory, onceEpisodeReader, riskEpisodeTargets } from "./risk-episodes";
6
6
  import { describeCollections } from "../../../portfolio/collection-name";
7
7
  import { shellWord } from "../../../utils/shell-word";
8
8
  import { formatShocks, parseAssetShifts, parseFxShifts, riskCashLines } from "./risk-book";
@@ -30,6 +30,9 @@ import {
30
30
  type RiskView,
31
31
  } from "./risk-model";
32
32
 
33
+ /** Holdings up to which a report's episode closes are read with its recent ones, not after them. */
34
+ const EPISODE_WARM_LIMIT = 30;
35
+
33
36
  const RISK_COLUMNS = [
34
37
  { key: "label", header: "Metric" },
35
38
  { key: "value", header: "Value", align: "right" as const },
@@ -295,6 +298,19 @@ export const portfolioRiskHeadless: HeadlessPaneDefinition<"bundle"> = {
295
298
  const localOnly =
296
299
  ["performance", "attribution", "greeks"].includes(view) &&
297
300
  evidence != null;
301
+ // The episodes read years-old closes of each holding, so only a report that prints Stress loads them.
302
+ const wantsEpisodes = !localOnly && (!requestedView || requestedView === "stress");
303
+ const episodeReader = onceEpisodeReader(cloudEpisodeReader(ctx.apiClient));
304
+ // A small book's are read alongside its recent closes rather than after them; those the basket leaves out
305
+ // go unused. A bigger book waits for the basket, so it reads no closes it does not replay.
306
+ const warming = wantsEpisodes && tickers.length <= EPISODE_WARM_LIMIT
307
+ ? fetchRiskEpisodeHistory(
308
+ tickers.map((ticker) => ({ instrument: { symbol: ticker.metadata.ticker, exchange: ticker.metadata.exchange }, currency: null })),
309
+ local.portfolio.currency, episodeReader, ctx.signal,
310
+ ).catch(() => {
311
+ // Intentional ignore: the replayed load below reads the same closes and reports their failures.
312
+ })
313
+ : undefined;
298
314
  const [prices, brokerOptions] = await Promise.all([
299
315
  localOnly
300
316
  ? Promise.resolve({
@@ -316,13 +332,13 @@ export const portfolioRiskHeadless: HeadlessPaneDefinition<"bundle"> = {
316
332
  ? Promise.resolve(undefined)
317
333
  : loadPortfolioOptionBook(tickers, local.portfolio),
318
334
  ]);
319
- // The episodes read years-old closes of each holding, so only a report that prints Stress loads them.
320
- const episodeTargets = !localOnly && (!requestedView || requestedView === "stress")
335
+ const episodeTargets = wantsEpisodes
321
336
  ? riskEpisodeTargets(prices, tickers.map((ticker) => ({ symbol: ticker.metadata.ticker, exchange: ticker.metadata.exchange })))
322
337
  : [];
323
338
  const episodes = episodeTargets.length
324
- ? await fetchRiskEpisodeHistory(episodeTargets, local.portfolio.currency, cloudEpisodeReader(ctx.apiClient), ctx.signal)
339
+ ? await fetchRiskEpisodeHistory(episodeTargets, local.portfolio.currency, episodeReader, ctx.signal)
325
340
  : undefined;
341
+ void warming;
326
342
  const market = { ...prices, brokerOptions, ...(episodes ? { episodes } : {}) };
327
343
  if (ctx.signal.aborted) throw new Error("Portfolio risk load cancelled");
328
344
  const model = buildPortfolioRisk(
@@ -170,6 +170,52 @@ export interface RiskDisplayRow {
170
170
  * the evidence: the basket share an episode replays by beta proxy ("22% proxy").
171
171
  */
172
172
  marker?: string;
173
+ /** Factor rows only: how much of the basket's daily moves the factor explains over the last 60 sessions; null without a fit. */
174
+ rSquared?: number | null;
175
+ }
176
+
177
+ /** Below this R² a factor explains too little of the basket's moves for its beta to be read as an exposure. */
178
+ const WEAK_FACTOR_FIT = 0.1;
179
+
180
+ /** "Factors are US ETF proxies; ASELS, THYAO and 4 more trade outside the US and are measured against them." */
181
+ function usFactorProxyNote(symbols: readonly string[]): string {
182
+ const sorted = [...symbols].sort();
183
+ const named = sorted.length <= 6 ? sorted : [...sorted.slice(0, 5), `${sorted.length - 5} more`];
184
+ const list = named.length > 1 ? `${named.slice(0, -1).join(", ")} and ${named.at(-1)}` : named[0] ?? "";
185
+ return `Factors are US ETF proxies; ${list} ${sorted.length === 1 ? "trades" : "trade"} outside the US and ${sorted.length === 1 ? "is" : "are"} measured against them.`;
186
+ }
187
+
188
+ /** "76% USD, 24% TRY": each currency's share of the values given, largest first; currencies under half a percent left out. */
189
+ function bookCurrencyShares(lines: ReadonlyArray<{ currency: string; value: number | null }>): string {
190
+ const totals = new Map<string, number>();
191
+ for (const line of lines) {
192
+ if (line.value == null || !Number.isFinite(line.value) || line.value <= 0) continue;
193
+ const currency = resolveCurrencyUnit(line.currency).currency;
194
+ totals.set(currency, (totals.get(currency) ?? 0) + line.value);
195
+ }
196
+ const total = [...totals.values()].reduce((sum, value) => sum + value, 0);
197
+ if (!(total > 0)) return "no valued holdings";
198
+ return [...totals]
199
+ .sort((a, b) => b[1] - a[1])
200
+ .filter(([, value]) => value / total >= 0.005)
201
+ .map(([currency, value]) => `${Math.round((value / total) * 100)}% ${currency}`)
202
+ .join(", ");
203
+ }
204
+
205
+ /** A factor row's evidence without its fit, for a table that gives the fit a column of its own. */
206
+ export function withoutFactorFit(detail: string): string {
207
+ return detail.replace(/; R² (?:--|[0-9.]+(?:, weak fit)?)/, "");
208
+ }
209
+
210
+ /** Whether a fit is weak as it reads to two decimals: 0.0999 shows as 0.10 and is not. */
211
+ export function isWeakFactorFit(rSquared: number | null | undefined): boolean {
212
+ return rSquared != null && Number.isFinite(rSquared) && Number(rSquared.toFixed(2)) < WEAK_FACTOR_FIT;
213
+ }
214
+
215
+ /** "R² 0.28", or "R² 0.03, weak fit" below WEAK_FACTOR_FIT; "R² --" without a fit. */
216
+ export function factorFitText(rSquared: number | null | undefined): string {
217
+ if (rSquared == null || !Number.isFinite(rSquared)) return "R² --";
218
+ return `R² ${rSquared.toFixed(2)}${isWeakFactorFit(rSquared) ? ", weak fit" : ""}`;
173
219
  }
174
220
  /** The tail-loss rows, which also read in money on the covered basket. */
175
221
  const TAIL_ROW_IDS: ReadonlySet<string> = new Set(["var", "es"]);
@@ -847,6 +893,8 @@ export function buildPortfolioRisk(
847
893
  "Converted holdings are matched to the US close of the same date; where their market closes at another time, correlations and betas to US holdings read lower than they are.",
848
894
  ]
849
895
  : []),
896
+ // The factors are US ETFs: holdings listed elsewhere are measured against them, there being no local factor model.
897
+ ...(converted ? [usFactorProxyNote(members.filter((row) => row.convertedFrom != null).map((row) => row.symbol))] : []),
850
898
  // A pair's daily closes skip Good Friday, Easter Monday, 25 Dec and 1 Jan; returns across them use the close before.
851
899
  ...fxBridgeNotes(members),
852
900
  ];
@@ -924,6 +972,18 @@ export function buildPortfolioRisk(
924
972
  const metrics = filed
925
973
  ? sinceBasketRisk(sample, filed, RISK_BENCHMARK)
926
974
  : rollingBasketRisk(sample, undefined, RISK_BENCHMARK);
975
+ // USD/account currency over each basket session, from the account's daily closes (USD per unit): the dollar's move in it.
976
+ const dollarMoves = account && !account.error
977
+ ? spy.flatMap((point) => {
978
+ const start = accountClose(point.startDateKey)?.rate, end = accountClose(point.dateKey)?.rate;
979
+ return start && end ? [{ startDateKey: point.startDateKey, dateKey: point.dateKey, value: start / end - 1 }] : [];
980
+ })
981
+ : [];
982
+ // The book's share in each currency it is exposed to, holdings at their listing's currency and cash at its own.
983
+ const currencyShares = bookCurrencyShares([
984
+ ...holdings.map((row) => ({ currency: row.convertedFrom ?? row.currency, value: row.marketValue })),
985
+ ...cashHoldings.map((row) => ({ currency: row.currency, value: row.value == null ? null : Math.abs(row.value) })),
986
+ ]);
927
987
  // Factor proxies stay in USD: a beta is the account-currency move per unit of the factor as it trades.
928
988
  const factors = [
929
989
  { id: "market", label: "Market (SPY)", series: spy },
@@ -953,6 +1013,10 @@ export function buildPortfolioRisk(
953
1013
  label: "Credit (HYG - IEF)",
954
1014
  series: subtractReturns(proxy("HYG"), proxy("IEF")),
955
1015
  },
1016
+ // A non-USD account's book moves with the dollar against its currency: its beta to USD/account currency.
1017
+ ...(account && !account.error && dollarMoves.length
1018
+ ? [{ id: "currency", label: `Currency (USD/${portfolio.currency})`, series: dollarMoves }]
1019
+ : []),
956
1020
  ].map((factor) => ({
957
1021
  ...rollingBeta(basket, factor.series, factor.label, factor.id),
958
1022
  regression: regressReturns(basket.slice(-60), factor.series),
@@ -1092,7 +1156,10 @@ export function buildPortfolioRisk(
1092
1156
  factors: factors.map((row) => ({
1093
1157
  ...row,
1094
1158
  percentile: row.rank.percentile,
1095
- detail: `${row.samples} sessions; R² ${row.regression?.rSquared?.toFixed(2) ?? "--"}; independent ETF proxy`,
1159
+ rSquared: row.regression?.rSquared ?? null,
1160
+ detail: row.id === "currency"
1161
+ ? `${currencyShares} of book; ${row.samples} sessions; ${factorFitText(row.regression?.rSquared)}; daily ${account?.pair ?? "FX"} closes`
1162
+ : `${row.samples} sessions; ${factorFitText(row.regression?.rSquared)}; independent ETF proxy`,
1096
1163
  })),
1097
1164
  // Largest current value first, left-out holdings and each currency's cash in place; unvalued ones last.
1098
1165
  holdings: [
@@ -67,6 +67,8 @@ import {
67
67
  riskReturnsCurrency,
68
68
  riskValue,
69
69
  RISK_VIEWS,
70
+ isWeakFactorFit,
71
+ withoutFactorFit,
70
72
  type PortfolioRiskModel,
71
73
  type RiskDisplayRow,
72
74
  type RiskView,
@@ -763,6 +765,7 @@ export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
763
765
  };
764
766
  }, [chartRow, marketLoading, model, sharedUnit, view]);
765
767
  const attributionParts = view === "attribution" && rows.some((row) => row.allocation != null);
768
+ const factorFits = rows.some((row) => row.rSquared !== undefined);
766
769
  const valueHeader = attributionParts
767
770
  ? "Total pp"
768
771
  : sharedUnit
@@ -786,6 +789,10 @@ export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
786
789
  ...(attributionParts
787
790
  ? ATTRIBUTION_PARTS.map((part) => ({ id: part.id, label: part.label, width: 11, align: "right" as const }))
788
791
  : []),
792
+ // A factor's beta reads with how much of the basket it explains; a weak fit says so.
793
+ ...(factorFits
794
+ ? [{ id: "rSquared", label: "R²", width: 9, align: "right" as const }]
795
+ : []),
789
796
  ...(showPercentile
790
797
  ? [{ id: "percentile", label: "Pctl 1Y", width: 8, align: "right" as const }]
791
798
  : []),
@@ -805,7 +812,7 @@ export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
805
812
  ]
806
813
  : []),
807
814
  ],
808
- [width, view, valueHeader, sharedUnit, attributionParts, footerEvidence, showPercentile, sharedDate, rows],
815
+ [width, view, valueHeader, sharedUnit, attributionParts, factorFits, footerEvidence, showPercentile, sharedDate, rows],
809
816
  );
810
817
  const selectView = (value: string) => {
811
818
  setView(value);
@@ -956,17 +963,22 @@ export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
956
963
  // Without the evidence column an episode says beside its label how much of it is proxied.
957
964
  if (column.id === "label")
958
965
  return { text: row.marker && !columns.some((entry) => entry.id === "detail") ? `${row.label} (${row.marker})` : row.label };
966
+ const weakFit = isWeakFactorFit(row.rSquared);
959
967
  if (column.id === "value")
960
968
  return row.leftOut
961
969
  ? { text: "left out", value: null, color: colors.textMuted }
962
- : { text: sharedUnit || attributionParts ? bareValue(row) : riskValue(row) };
970
+ : { text: sharedUnit || attributionParts ? bareValue(row) : riskValue(row), ...(weakFit ? { color: colors.textMuted } : {}) };
971
+ if (column.id === "rSquared")
972
+ return row.rSquared == null
973
+ ? { text: "--" }
974
+ : { text: `${weakFit ? "weak " : ""}${row.rSquared.toFixed(2)}`, value: row.rSquared, ...(weakFit ? { color: colors.textMuted } : {}) };
963
975
  if (column.id === "percentile") return { text: riskPercentile(row) };
964
976
  if (column.id === "asOf") return { text: row.asOf?.slice(0, 10) ?? "--" };
965
977
  if (column.id === "allocation" || column.id === "selection" || column.id === "interaction") {
966
978
  const part = row[column.id];
967
979
  return { text: part == null ? "--" : part.toFixed(2) };
968
980
  }
969
- return { text: row.detail };
981
+ return { text: factorFits ? withoutFactorFit(row.detail) : row.detail };
970
982
  }}
971
983
  selectedTextOverridesCellColor
972
984
  onActivate={(row) => setOpen(row.id)}
@@ -1,4 +1,4 @@
1
- import { barsPerYear, type BarsPerYear } from "../../../market-data/bars-per-year";
1
+ import { barsPerYear, type BarsPerYear, type BarsPerYearInstrument } from "../../../market-data/bars-per-year";
2
2
  import { evaluateRule, ruleWarmup, type BacktestBar, type Rule } from "./rules";
3
3
 
4
4
  const DAY_MS = 86_400_000;
@@ -8,6 +8,8 @@ export interface BacktestOptions {
8
8
  lookbackYears: number | null;
9
9
  /** Cost per side in basis points, applied to each fill price. */
10
10
  costBps: number;
11
+ /** What the bars are of, where that sets the year: a currency pair's is 260 bars, whatever the range (`barsPerYear`). */
12
+ instrument?: BarsPerYearInstrument;
11
13
  }
12
14
  export interface BacktestTrade {
13
15
  entryDate: string;
@@ -159,7 +161,7 @@ export function runBacktest(
159
161
  };
160
162
  });
161
163
  // A one-year window is as many bars as the series has in a year, so it spans a calendar year for 24/7 assets too.
162
- const yearBars = barsPerYear(dates);
164
+ const yearBars = barsPerYear(dates, options.instrument);
163
165
  let beat = 0, windows = 0;
164
166
  for (let index = yearBars; index < strategy.length; index += 1) {
165
167
  windows += 1;