gloomberb 0.20.0 → 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 (481) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +1 -1
  4. package/patches/electrobun-devkit@2.0.5.patch +268 -8
  5. package/src/account/auth-model.ts +20 -1
  6. package/src/account/upgrade-dialog.tsx +8 -4
  7. package/src/api-client/askg.ts +7 -1
  8. package/src/api-client/auth.ts +27 -0
  9. package/src/api-client/catalysts.ts +2 -0
  10. package/src/api-client/company-kpis.ts +2 -1
  11. package/src/api-client/cot.ts +14 -2
  12. package/src/api-client/crypto-markets.ts +20 -2
  13. package/src/api-client/data.ts +3 -2
  14. package/src/api-client/earnings.ts +46 -3
  15. package/src/api-client/fund-facts.ts +23 -1
  16. package/src/api-client/futures-curve.ts +17 -0
  17. package/src/api-client/index.ts +4 -1
  18. package/src/api-client/one-tap-reasons.ts +42 -0
  19. package/src/api-client/perps.ts +2 -1
  20. package/src/api-client/request.ts +3 -1
  21. package/src/api-client/research-activity.ts +16 -3
  22. package/src/api-client/types/filings-and-calls.ts +9 -0
  23. package/src/api-client/types/search.ts +3 -0
  24. package/src/app/keybindings/chord.ts +153 -9
  25. package/src/app/keybindings/index.ts +1 -1
  26. package/src/app/keybindings/labels.ts +49 -6
  27. package/src/app/runtime/desktop-deeplink.ts +73 -8
  28. package/src/app/runtime/plugin-seed.ts +119 -0
  29. package/src/app/runtime/startup.ts +45 -9
  30. package/src/app.tsx +8 -1
  31. package/src/architecture/core-builtin-allowlist.json +1 -2
  32. package/src/architecture/pane-tabs-allowlist.json +2 -1
  33. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  34. package/src/architecture/ui-literals-allowlist.json +8 -8
  35. package/src/brokers/broker-portfolio-sync.ts +1 -1
  36. package/src/cli/bank-section.ts +26 -12
  37. package/src/cli/board-coins.ts +38 -5
  38. package/src/cli/commands/crypto-hints.ts +8 -1
  39. package/src/cli/commands/market.ts +294 -100
  40. package/src/cli/commands/overview.ts +13 -6
  41. package/src/cli/commands/ticker.ts +73 -21
  42. package/src/cli/company-name-hint.ts +19 -0
  43. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  44. package/src/cli/desktop-pane-shot.ts +15 -0
  45. package/src/cli/entry.ts +15 -4
  46. package/src/cli/export-source.ts +7 -1
  47. package/src/cli/freshness.ts +0 -16
  48. package/src/cli/fx-pair.ts +64 -12
  49. package/src/cli/fx-quote-rate.ts +144 -0
  50. package/src/cli/glossary.ts +30 -0
  51. package/src/cli/helpers.ts +4 -2
  52. package/src/cli/history-back-adjust.ts +122 -0
  53. package/src/cli/history-rows.ts +114 -10
  54. package/src/cli/index.ts +4 -1
  55. package/src/cli/known-gaps.ts +45 -3
  56. package/src/cli/listing-arg.ts +48 -4
  57. package/src/cli/name-entries.ts +25 -5
  58. package/src/cli/not-a-ticker.ts +26 -1
  59. package/src/cli/pane-functions/catalog.ts +12 -2
  60. package/src/cli/pane-functions/dom.ts +4 -2
  61. package/src/cli/pane-functions/freshness.ts +45 -29
  62. package/src/cli/pane-functions/headless.ts +8 -5
  63. package/src/cli/pane-functions/index.ts +3 -0
  64. package/src/cli/pane-functions/market-session.ts +14 -5
  65. package/src/cli/pane-functions/resolver.ts +4 -1
  66. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  67. package/src/cli/pane-functions/screenshot-payload.ts +130 -66
  68. package/src/cli/pane-functions/screenshot-render.ts +14 -2
  69. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  70. package/src/cli/restore-plugins.ts +164 -51
  71. package/src/cli/symbol-rows.ts +22 -2
  72. package/src/cli/ticker-resolution.ts +74 -17
  73. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  74. package/src/components/chart/composite/composite-chart.tsx +8 -1
  75. package/src/components/chart/composite/format.ts +16 -1
  76. package/src/components/chart/composite/legend.tsx +4 -3
  77. package/src/components/chart/composite/panel-labels.ts +2 -1
  78. package/src/components/chart/composite/panel-surface.tsx +33 -4
  79. package/src/components/chart/composite/time-scale.ts +1 -1
  80. package/src/components/chart/composite/toolbar.tsx +8 -4
  81. package/src/components/chart/composite/types.ts +17 -1
  82. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  83. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  84. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  85. package/src/components/chart-table/axis.ts +11 -0
  86. package/src/components/chart-table/header.tsx +10 -1
  87. package/src/components/chart-table/layout.ts +14 -5
  88. package/src/components/command-bar/assist/inventory.ts +3 -2
  89. package/src/components/command-bar/commands/collection-list.ts +3 -2
  90. package/src/components/command-bar/panel/index.tsx +13 -0
  91. package/src/components/command-bar/panel/layout.ts +15 -1
  92. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  93. package/src/components/command-bar/panel/runtime.ts +1 -0
  94. package/src/components/command-bar/panel/state.ts +4 -0
  95. package/src/components/command-bar/panel/types.ts +2 -0
  96. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  97. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  98. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  99. package/src/components/company-logo.tsx +2 -2
  100. package/src/components/data-table/view.tsx +11 -2
  101. package/src/components/feed-data-table/stack-view.tsx +20 -6
  102. package/src/components/feedback-dialog.tsx +3 -1
  103. package/src/components/form-modal/field-row.tsx +1 -1
  104. package/src/components/form-modal/routes.ts +1 -0
  105. package/src/components/index.ts +1 -1
  106. package/src/components/layout/header.tsx +12 -3
  107. package/src/components/layout/market-summary.ts +2 -1
  108. package/src/components/layout/pane/footer/index.tsx +9 -5
  109. package/src/components/layout/pane/footer/model.ts +26 -10
  110. package/src/components/layout/pane/footer/registration.tsx +60 -1
  111. package/src/components/layout/pane/header-tabs.tsx +17 -3
  112. package/src/components/layout/pane/header.tsx +5 -2
  113. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  114. package/src/components/layout/shell/active-drag.ts +38 -30
  115. package/src/components/layout/shell/drag/index.ts +51 -21
  116. package/src/components/layout/shell/menu.ts +3 -5
  117. package/src/components/layout/shell/pane/actions.ts +4 -1
  118. package/src/components/layout/shell/pane/ask.ts +5 -2
  119. package/src/components/layout/status-bar.tsx +59 -54
  120. package/src/components/markdown-text.tsx +35 -10
  121. package/src/components/onboarding/first-run-workspace.ts +25 -23
  122. package/src/components/onboarding/onboarding-keyboard.ts +6 -1
  123. package/src/components/onboarding/onboarding-wizard.tsx +12 -2
  124. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -3
  125. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  126. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  127. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  128. package/src/components/onboarding/wizard-positions.ts +8 -1
  129. package/src/components/pane-notice-seen.ts +125 -0
  130. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  131. package/src/components/pane-settings-dialog.tsx +7 -6
  132. package/src/components/sign-in-code-panel.tsx +3 -2
  133. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  134. package/src/components/ticker/list-table-view.tsx +39 -3
  135. package/src/components/ui/confirm-dialog.tsx +2 -1
  136. package/src/components/ui/data-table/index.tsx +4 -2
  137. package/src/components/ui/data-table/opentui/index.tsx +15 -5
  138. package/src/components/ui/data-table/types.ts +8 -0
  139. package/src/components/ui/external-link.tsx +4 -1
  140. package/src/components/ui/field-grid.tsx +1 -1
  141. package/src/components/ui/index.ts +2 -0
  142. package/src/components/ui/inline-quick-add.tsx +5 -0
  143. package/src/components/ui/multi-select/dialog.tsx +10 -9
  144. package/src/components/ui/pane-link-chip.tsx +354 -0
  145. package/src/components/ui/query-bar.tsx +22 -13
  146. package/src/components/ui/ratio-bar.tsx +24 -1
  147. package/src/components/ui/select-button.tsx +2 -1
  148. package/src/components/ui/shortcut-hint.tsx +6 -3
  149. package/src/components/ui/table-layout.ts +81 -0
  150. package/src/components/ui/tabs.tsx +45 -6
  151. package/src/components/use-pane-notice-footer.tsx +12 -4
  152. package/src/core/app-service-ports.ts +1 -1
  153. package/src/data/plugin-state-store.ts +44 -8
  154. package/src/docs/snapshot.json +53 -32
  155. package/src/i18n/es.ts +28 -6
  156. package/src/i18n/ja.ts +28 -5
  157. package/src/i18n/ko.ts +28 -5
  158. package/src/i18n/zh-cn.ts +28 -5
  159. package/src/i18n/zh-tw.ts +28 -5
  160. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  161. package/src/layout/pane-manager/gridlock.ts +47 -2
  162. package/src/layout-marketplace/api.ts +1 -0
  163. package/src/layout-marketplace/gallery.tsx +4 -3
  164. package/src/layout-marketplace/linked.ts +6 -4
  165. package/src/layout-marketplace/model.ts +3 -2
  166. package/src/market-data/fund-facts.ts +7 -1
  167. package/src/market-data/futures-contract.ts +77 -31
  168. package/src/market-data/fx-closes.ts +5 -2
  169. package/src/market-data/hooks.tsx +23 -0
  170. package/src/market-data/market/change-basis.ts +92 -14
  171. package/src/market-data/market/format.ts +81 -13
  172. package/src/market-data/market/futures-week.ts +3 -1
  173. package/src/market-data/market/globex-day.ts +73 -0
  174. package/src/market-data/market/index-level.ts +10 -1
  175. package/src/market-data/quotes/intraday-bar.ts +1 -1
  176. package/src/market-data/quotes/session-split.ts +28 -0
  177. package/src/plugins/builtin/account-management/pane.tsx +1 -1
  178. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  179. package/src/plugins/builtin/analytics/index.tsx +10 -3
  180. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  181. package/src/plugins/builtin/analytics/risk-client.ts +4 -1
  182. package/src/plugins/builtin/analytics/risk-episodes.ts +422 -0
  183. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  184. package/src/plugins/builtin/analytics/risk-headless.ts +28 -10
  185. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  186. package/src/plugins/builtin/analytics/risk-model.ts +115 -26
  187. package/src/plugins/builtin/analytics/risk-pane.tsx +201 -23
  188. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  189. package/src/plugins/builtin/backtest/format.ts +14 -0
  190. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  191. package/src/plugins/builtin/backtest/report.ts +5 -3
  192. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  193. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  194. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  195. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  196. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  197. package/src/plugins/builtin/catalysts/model.ts +7 -2
  198. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  199. package/src/plugins/builtin/chart-composer/headless.ts +57 -17
  200. package/src/plugins/builtin/chart-composer/session-range.ts +82 -3
  201. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  202. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  203. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  204. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  205. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  206. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  207. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  208. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  209. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  210. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  211. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  212. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  213. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  214. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  215. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  216. package/src/plugins/builtin/correlation/compute.ts +8 -2
  217. package/src/plugins/builtin/correlation/headless.ts +10 -9
  218. package/src/plugins/builtin/correlation/history.ts +30 -0
  219. package/src/plugins/builtin/correlation/index.tsx +39 -167
  220. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  221. package/src/plugins/builtin/correlation/matrix/model.ts +10 -10
  222. package/src/plugins/builtin/correlation/relationship/model.ts +3 -6
  223. package/src/plugins/builtin/correlation/relationship/pane.tsx +7 -9
  224. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  225. package/src/plugins/builtin/cot/client.ts +8 -3
  226. package/src/plugins/builtin/cot/headless.ts +65 -12
  227. package/src/plugins/builtin/cot/pane.tsx +11 -5
  228. package/src/plugins/builtin/crypto-board/client.ts +6 -1
  229. package/src/plugins/builtin/crypto-board/defi-view.tsx +12 -1
  230. package/src/plugins/builtin/crypto-board/defi.ts +44 -7
  231. package/src/plugins/builtin/crypto-board/headless.ts +83 -12
  232. package/src/plugins/builtin/crypto-board/model.ts +30 -6
  233. package/src/plugins/builtin/crypto-board/pane.tsx +13 -2
  234. package/src/plugins/builtin/earnings/client.ts +40 -6
  235. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  236. package/src/plugins/builtin/earnings/headless.ts +47 -11
  237. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  238. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  239. package/src/plugins/builtin/earnings/history.tsx +23 -8
  240. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  241. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  242. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  243. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  244. package/src/plugins/builtin/econ/index.tsx +5 -4
  245. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  246. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  247. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  248. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  249. package/src/plugins/builtin/futures/index.tsx +32 -10
  250. package/src/plugins/builtin/futures/model.ts +93 -6
  251. package/src/plugins/builtin/futures/returns.ts +29 -7
  252. package/src/plugins/builtin/futures/table.tsx +59 -17
  253. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  254. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  255. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  256. package/src/plugins/builtin/futures-curve/model.ts +111 -15
  257. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  258. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  259. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  260. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  261. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  262. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  263. package/src/plugins/builtin/help/index.tsx +68 -61
  264. package/src/plugins/builtin/holders/format.ts +7 -2
  265. package/src/plugins/builtin/holders/pane.tsx +11 -3
  266. package/src/plugins/builtin/holders/report-header.ts +5 -4
  267. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  268. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  269. package/src/plugins/builtin/insider/signals-model.ts +4 -5
  270. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  271. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  272. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  273. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  274. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -0
  275. package/src/plugins/builtin/perps/headless.ts +81 -19
  276. package/src/plugins/builtin/perps/index.tsx +3 -1
  277. package/src/plugins/builtin/perps/model.ts +1 -1
  278. package/src/plugins/builtin/perps/pane.tsx +2 -0
  279. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  280. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +20 -1
  281. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  282. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +154 -0
  283. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +64 -22
  284. package/src/plugins/builtin/portfolio-list/cli/render.ts +18 -7
  285. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  286. package/src/plugins/builtin/portfolio-list/grid.tsx +56 -12
  287. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  288. package/src/plugins/builtin/portfolio-list/pane/index.tsx +42 -4
  289. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  290. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  291. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  292. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  293. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  294. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  295. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  296. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +118 -4
  297. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  298. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  299. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  300. package/src/plugins/builtin/portfolio-list/table.tsx +105 -6
  301. package/src/plugins/builtin/power/headless.ts +47 -9
  302. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  303. package/src/plugins/builtin/research-search/article.ts +12 -2
  304. package/src/plugins/builtin/research-search/data.ts +5 -2
  305. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  306. package/src/plugins/builtin/research-search/model.ts +47 -3
  307. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  308. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  309. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  310. package/src/plugins/builtin/risk-factors/index.tsx +2 -28
  311. package/src/plugins/builtin/risk-factors/lock-note.ts +58 -0
  312. package/src/plugins/builtin/risk-factors/pane.tsx +14 -5
  313. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  314. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  315. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  316. package/src/plugins/builtin/scanner/hilo-model.ts +4 -3
  317. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  318. package/src/plugins/builtin/sec/forms.ts +19 -0
  319. package/src/plugins/builtin/sec/fund-facts.ts +45 -11
  320. package/src/plugins/builtin/sec/headless.ts +37 -12
  321. package/src/plugins/builtin/sec/index.tsx +37 -8
  322. package/src/plugins/builtin/shared/earnings-calendar.ts +6 -3
  323. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  324. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  325. package/src/plugins/builtin/shared/pro-lock-note.ts +5 -1
  326. package/src/plugins/builtin/shared/use-quote-board.ts +42 -27
  327. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  328. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  329. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  330. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  331. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  332. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  333. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  334. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  335. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  336. package/src/plugins/builtin/ticker-detail/headless-schema.ts +10 -1
  337. package/src/plugins/builtin/ticker-detail/headless.ts +8 -1
  338. package/src/plugins/builtin/ticker-detail/overview/components.tsx +2 -1
  339. package/src/plugins/builtin/ticker-detail/overview/model.ts +18 -8
  340. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +11 -8
  341. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  342. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  343. package/src/plugins/builtin/ticker-detail/settings.ts +4 -3
  344. package/src/plugins/builtin/time-sales/headless.ts +23 -7
  345. package/src/plugins/builtin/time-sales/index.tsx +2 -2
  346. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  347. package/src/plugins/extracted-plugins.ts +49 -24
  348. package/src/plugins/host-resolver.ts +3 -2
  349. package/src/plugins/installer.ts +220 -31
  350. package/src/plugins/running-installs.ts +34 -0
  351. package/src/plugins/seed-progress.ts +72 -0
  352. package/src/portfolio/column-values.ts +42 -8
  353. package/src/portfolio/futures-positions.ts +10 -2
  354. package/src/portfolio/mutations.ts +4 -3
  355. package/src/portfolio/period-pnl.ts +119 -0
  356. package/src/portfolio/positions-import/describe.ts +89 -0
  357. package/src/portfolio/positions-import/parse.ts +682 -0
  358. package/src/portfolio/positions-import/plan.ts +295 -0
  359. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  360. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  361. package/src/react/jsx-dev-fallback.ts +62 -0
  362. package/src/renderers/browser/cloud-transport.ts +1 -1
  363. package/src/renderers/browser/config-host.ts +3 -1
  364. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  365. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  366. package/src/renderers/browser/main.tsx +2 -1
  367. package/src/renderers/browser/research-entry.ts +12 -0
  368. package/src/renderers/cloudflare/http-proxy.ts +8 -2
  369. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  370. package/src/renderers/cloudflare/worker.ts +12 -3
  371. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  372. package/src/renderers/dom/desktop/controls.tsx +1 -1
  373. package/src/renderers/dom/desktop/dialog-actions.tsx +10 -24
  374. package/src/renderers/dom/desktop/icons.tsx +4 -2
  375. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  376. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  377. package/src/renderers/dom/host/box.tsx +2 -2
  378. package/src/renderers/dom/host/input.tsx +13 -0
  379. package/src/renderers/dom/key-event.ts +1 -0
  380. package/src/renderers/dom/styles.css +3 -0
  381. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  382. package/src/renderers/electrobun/bun/desktop/backend.ts +15 -0
  383. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  384. package/src/renderers/electrobun/bun/desktop/host-requests.ts +19 -11
  385. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  386. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  387. package/src/renderers/electrobun/bun/desktop/initialization.ts +27 -15
  388. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  389. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  390. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  391. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  392. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  393. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  394. package/src/renderers/electrobun/bun/index.ts +5 -0
  395. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  396. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  397. package/src/renderers/electrobun/bun/window/context-menu-thread.ts +84 -0
  398. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  399. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  400. package/src/renderers/electrobun/bun/window/native-call-thread.ts +224 -0
  401. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  402. package/src/renderers/electrobun/bun/window/native-timing.ts +10 -0
  403. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  404. package/src/renderers/electrobun/bun/window/script-for-webview.ts +15 -0
  405. package/src/renderers/electrobun/bun/window/webview-script-thread.ts +82 -0
  406. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  407. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  408. package/src/renderers/electrobun/shared/protocol.ts +13 -2
  409. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  410. package/src/renderers/electrobun/view/backend-rpc.ts +7 -0
  411. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  412. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  413. package/src/renderers/electrobun/view/cli-pane-shot-frame.tsx +1 -1
  414. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  415. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  416. package/src/renderers/electrobun/view/main.tsx +13 -7
  417. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  418. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  419. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  420. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  421. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  422. package/src/renderers/opentui/browser-open.ts +2 -1
  423. package/src/renderers/opentui/dialog-host.tsx +1 -1
  424. package/src/renderers/opentui/interaction-performance.ts +3 -1
  425. package/src/renderers/opentui/start.tsx +5 -1
  426. package/src/renderers/opentui/terminal-media.ts +11 -6
  427. package/src/renderers/opentui/ui-host.tsx +5 -8
  428. package/src/shares/open.ts +22 -1
  429. package/src/shares/pane.ts +2 -1
  430. package/src/sources/gloomberb-cloud/normalizers.ts +3 -0
  431. package/src/sync/analytics-payload.ts +194 -0
  432. package/src/sync/baseline.ts +19 -9
  433. package/src/sync/broker-identity.ts +171 -0
  434. package/src/sync/broker-instances.ts +137 -0
  435. package/src/sync/collections-contributor.ts +173 -0
  436. package/src/sync/config-contributor.ts +100 -0
  437. package/src/sync/config-merge.ts +229 -0
  438. package/src/sync/controller.ts +139 -28
  439. package/src/sync/core-contributors.ts +8 -1583
  440. package/src/sync/history-memo.ts +32 -0
  441. package/src/sync/layout-merge.ts +259 -0
  442. package/src/sync/sanitize.ts +114 -0
  443. package/src/sync/ticker-merge.ts +208 -0
  444. package/src/sync/ticker-payload.ts +81 -0
  445. package/src/sync/types.ts +15 -1
  446. package/src/telemetry/attention-setting.ts +1 -1
  447. package/src/telemetry/stall-reports.ts +21 -4
  448. package/src/telemetry/usage-counts.ts +16 -0
  449. package/src/test-support/preload.ts +5 -0
  450. package/src/theme/color-utils.ts +10 -0
  451. package/src/theme/font-scale.ts +34 -3
  452. package/src/theme/series-colors.ts +44 -0
  453. package/src/theme/themes.ts +2 -1
  454. package/src/tickers/batched-lookups.ts +263 -6
  455. package/src/tickers/company-name-listing.ts +44 -2
  456. package/src/tickers/company-name.ts +7 -2
  457. package/src/tickers/search/upsert.ts +16 -1
  458. package/src/time-series/base-series.ts +18 -4
  459. package/src/time-series/studies/indicators.ts +3 -1
  460. package/src/time-series/studies/resolve.ts +1 -1
  461. package/src/time-series/types.ts +6 -0
  462. package/src/types/financials.ts +18 -0
  463. package/src/types/headless.ts +11 -0
  464. package/src/ui/host.tsx +26 -3
  465. package/src/ui/index.tsx +1 -0
  466. package/src/utils/concurrency.ts +6 -0
  467. package/src/utils/currency-pair.ts +56 -4
  468. package/src/utils/datetime-format.ts +11 -0
  469. package/src/utils/decimal-comma.ts +9 -6
  470. package/src/utils/exchanges.ts +32 -0
  471. package/src/utils/fundamentals.ts +41 -0
  472. package/src/utils/main-thread-stall.ts +21 -5
  473. package/src/utils/markdown.ts +4 -2
  474. package/src/utils/pasted-lines.ts +14 -0
  475. package/src/utils/perf-marks.ts +88 -9
  476. package/src/utils/price-window.ts +2 -1
  477. package/src/utils/reported-money.ts +9 -2
  478. package/src/utils/sec-filings.ts +17 -0
  479. package/src/utils/sec.ts +37 -25
  480. package/src/utils/shortcut-labels.ts +6 -30
  481. package/src/plugins/seed-notice.ts +0 -20
@@ -7,6 +7,12 @@ import type { PriceBasis } from "../../types/instrument";
7
7
  */
8
8
  export const INDEX_POINTS_UNIT = "points";
9
9
 
10
+ /**
11
+ * What a chart calls an index's volume: the combined volume of its members,
12
+ * which no source gives a unit of its own.
13
+ */
14
+ export const INDEX_MEMBERS_VOLUME_LABEL = "Members' volume";
15
+
10
16
  /** How a report line names that unit: `history` heads an index's bars with it, `ticker` its quote. */
11
17
  export const INDEX_POINTS_LABEL = "Index points";
12
18
 
@@ -41,13 +47,16 @@ export function priceSeriesUnit(currency: string, instrumentType: string | null
41
47
  * A quote's volume where it counts one. An index and a crypto venue's
42
48
  * perpetual price carry 0 for a volume nobody counts, which is not a session
43
49
  * without trades: null for those, as for a quote with no volume. A broad
44
- * index whose source sums its members' volume (^GSPC) keeps it.
50
+ * index whose source sums its members' volume (^GSPC) keeps it. A currency
51
+ * pair trades over the counter, where no one counts a volume: null whatever
52
+ * its quote carries.
45
53
  */
46
54
  export function reportedQuoteVolume(
47
55
  quote: { volume?: number | null; instrumentType?: string | null; name?: string | null } | null | undefined,
48
56
  ): number | null {
49
57
  const volume = quote?.volume;
50
58
  if (volume == null || !Number.isFinite(volume)) return null;
59
+ if (classifyInstrumentType(quote!.instrumentType) === "currency") return null;
51
60
  if (volume === 0 && (isIndexLevel(quote!.instrumentType) || isCryptoVenuePerpetual(quote!.instrumentType, quote!.name))) return null;
52
61
  return volume;
53
62
  }
@@ -19,7 +19,7 @@ export function readStaleReason(value: unknown): string | undefined {
19
19
  }
20
20
 
21
21
  /** `06:30–06:35 UTC bar close, quotes paused`: what a price taken from a bar is, and why. */
22
- export function intradayBarText(bar: QuoteIntradayBar): string {
22
+ function intradayBarText(bar: QuoteIntradayBar): string {
23
23
  const clock = (time: number) => new Date(time).toISOString().slice(11, 16);
24
24
  return `${clock(bar.start)}–${clock(bar.start + bar.minutes * 60_000)} UTC bar close, quotes paused`;
25
25
  }
@@ -0,0 +1,28 @@
1
+ import type { QuoteSessionSplit } from "../../types/financials";
2
+
3
+ const positive = (value: unknown): value is number => typeof value === "number" && Number.isFinite(value) && value > 0;
4
+
5
+ /** Gloom Cloud's `sessionSplit` when it reads as one; anything else is no split. */
6
+ export function readSessionSplit(value: unknown, divisor = 1): QuoteSessionSplit | undefined {
7
+ if (!value || typeof value !== "object") return undefined;
8
+ const { exDate, priceFactor, sourcePreviousClose } = value as Record<string, unknown>;
9
+ if (typeof exDate !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(exDate) || !positive(priceFactor) || priceFactor === 1
10
+ || !positive(sourcePreviousClose)) return undefined;
11
+ return { exDate, priceFactor, sourcePreviousClose: sourcePreviousClose / divisor };
12
+ }
13
+
14
+ /**
15
+ * A split as shares before and after: "3-for-1" for a price factor of 1/3,
16
+ * "1-for-10 reverse" for 10, "3-for-2" for 2/3. Null for a factor no pair of
17
+ * whole share counts up to 1,000 gives.
18
+ */
19
+ export function splitRatioText(priceFactor: number): string | null {
20
+ if (!positive(priceFactor) || priceFactor === 1) return null;
21
+ for (let before = 1; before <= 1000; before++) {
22
+ const after = Math.round(before / priceFactor);
23
+ if (after >= 1 && Math.abs((after * priceFactor) / before - 1) < 1e-6) {
24
+ return `${after}-for-${before}${after < before ? " reverse" : ""}`;
25
+ }
26
+ }
27
+ return null;
28
+ }
@@ -77,7 +77,7 @@ import {
77
77
  buildPortfolioChartTargets,
78
78
  buildPortfolioReturnSeries,
79
79
  } from "../analytics/pane-model";
80
- import { computeDatedBeta, hasPortfolioPosition } from "../analytics/metrics";
80
+ import { computeDatedBeta, hasPortfolioPosition } from "../../../portfolio/return-metrics";
81
81
  import { buildTrackedCurrencies } from "../portfolio-list/pane/data";
82
82
  import { accountDailyReturns } from "../analytics/account-returns";
83
83
  import { useBrokerPortfolioPerformance } from "../analytics/broker-performance";
@@ -3,7 +3,7 @@ import type { BrokerPortfolioPerformance } from "../../../types/trading";
3
3
  import { formatNumber } from "../../../utils/format";
4
4
  import type { PriceHistoryIntegrity } from "../../../utils/price-history-integrity";
5
5
  import { formatReturn } from "./display";
6
- import { alignedAssetReturns, computeDatedBeta, computeSharpeRatio, type DatedReturn } from "./metrics";
6
+ import { alignedAssetReturns, computeDatedBeta, computeSharpeRatio, type DatedReturn } from "../../../portfolio/return-metrics";
7
7
  import type { AnalyticsMetricRow } from "./view";
8
8
 
9
9
  const MIN_ACCOUNT_RETURNS = 10;
@@ -3,6 +3,7 @@ import { PortfolioRiskPane } from "./risk-pane";
3
3
  import { portfolioRiskHeadless } from "./risk-headless";
4
4
  import { NO_HOLDINGS_HINT } from "./risk-model";
5
5
  import { portfolioRiskCache } from "./risk-client";
6
+ import { riskEpisodeCache } from "./risk-episodes";
6
7
  import { Box, Text } from "../../../ui";
7
8
  import { useCallback, useEffect, useMemo, useState } from "react";
8
9
  import {
@@ -44,7 +45,7 @@ import {
44
45
  import {
45
46
  computeSharpeRatio,
46
47
  hasPortfolioPosition,
47
- } from "./metrics";
48
+ } from "../../../portfolio/return-metrics";
48
49
  import {
49
50
  buildAnalyticsRiskRows,
50
51
  buildAnalyticsSummaryRows,
@@ -478,8 +479,14 @@ export const portfolioAnalyticsModule: PluginModule = {
478
479
  },
479
480
  ],
480
481
 
481
- setup(ctx) { portfolioRiskCache.attach(ctx.persistence); },
482
- dispose() { portfolioRiskCache.reset(); },
482
+ setup(ctx) {
483
+ portfolioRiskCache.attach(ctx.persistence);
484
+ riskEpisodeCache.attach(ctx.persistence);
485
+ },
486
+ dispose() {
487
+ portfolioRiskCache.reset();
488
+ riskEpisodeCache.reset();
489
+ },
483
490
  paneTemplates: ["PORT", "MARS"].map(prefix => ({
484
491
  id: prefix === "PORT" ? "analytics-pane" : "analytics-mars-pane",
485
492
  paneId: "analytics",
@@ -31,7 +31,7 @@ import {
31
31
  type DatedReturn,
32
32
  type WeightedReturnSeries,
33
33
  type ReturnHistoryResult,
34
- } from "./metrics";
34
+ } from "../../../portfolio/return-metrics";
35
35
  import { getPortfolioPositionValue } from "./sector-model";
36
36
  import type { AnalyticsMetricRow } from "./view";
37
37
  import { qualifySharpeCadence, qualifyReturnTimestamps, type SharpeCadenceResult, type ReturnTimestampResult, type TimestampHistory } from "./sharpe-cadence";
@@ -11,8 +11,9 @@ import { loadCloudResource } from "../shared/cloud-resource";
11
11
  import { canonicalExchange, normalizeSymbol } from "../../../utils/exchanges";
12
12
  import { resolveCurrencyUnit } from "../../../utils/currency-units";
13
13
  import type { PricePoint } from "../../../types/financials";
14
- import { resolveDatedReturns, type DatedReturn } from "./metrics";
14
+ import { resolveDatedReturns, type DatedReturn } from "../../../portfolio/return-metrics";
15
15
  import { qualifySharpeCadence } from "./sharpe-cadence";
16
+ import type { RiskEpisodeState } from "./risk-episodes";
16
17
  import { evidenceDay } from "./risk-evidence";
17
18
  import { FX_LIVE_RATE_MAX_DEVIATION } from "../../../market-data/coordinator/fx-legs";
18
19
  import {
@@ -77,6 +78,8 @@ export interface RiskMarketSnapshot {
77
78
  fxRates?: Record<string, number>;
78
79
  /** For an account not in USD: the daily closes its returns convert at, or why they cannot. */
79
80
  accountFx?: AccountFx;
81
+ /** The closes the Stress view's historical episodes replay, loaded apart from the rest and only for that view. */
82
+ episodes?: RiskEpisodeState;
80
83
  }
81
84
  /**
82
85
  * The most holdings one load requests daily history for, largest current USD
@@ -0,0 +1,422 @@
1
+ import { apiClient } from "../../../api-client";
2
+ import { isAccessDenied } from "../../../api-client/errors";
3
+ import type { CloudMarketResponse, CloudPricePointPayload } from "../../../api-client/types";
4
+ import { createPluginCache } from "../../../data/plugin-cache";
5
+ import { formatNumber } from "../../../utils/format";
6
+ import { loadCloudResource } from "../shared/cloud-resource";
7
+ import type { DatedReturn } from "../../../portfolio/return-metrics";
8
+ import { regressReturns } from "./risk-math";
9
+ import { accountFxPair, riskConversion } from "./risk-fx";
10
+ import { riskInstrumentId, RISK_FACTOR_INSTRUMENTS, type RiskInstrument, type RiskMarketSnapshot } from "./risk-client";
11
+
12
+ /**
13
+ * A market episode the Stress view replays on today's holdings: from the last
14
+ * close before the shock to the S&P 500's lowest close of the move.
15
+ */
16
+ export interface RiskEpisode {
17
+ id: string;
18
+ label: string;
19
+ /** The close the replay starts from. */
20
+ start: string;
21
+ /** The close it ends at: SPY's lowest of the move. */
22
+ end: string;
23
+ }
24
+
25
+ export const RISK_EPISODES: readonly RiskEpisode[] = [
26
+ // The record close before the selloff to the low of the crash.
27
+ { id: "covid-2020", label: "Covid crash 2020", start: "2020-02-19", end: "2020-03-23" },
28
+ // The record close of 3 Jan 2022 to the low of the bear market the Fed's hikes brought.
29
+ { id: "rates-2022", label: "Rate shock 2022", start: "2022-01-03", end: "2022-10-12" },
30
+ // The Bank of Japan's hike on 31 Jul 2024 to the 5 Aug low, when the yen carry trade unwound.
31
+ { id: "carry-2024", label: "Carry unwind 2024", start: "2024-07-31", end: "2024-08-05" },
32
+ // The close before the 2 Apr 2025 tariff announcement, after the bell, to the 8 Apr low.
33
+ { id: "tariffs-2025", label: "Tariff drop 2025", start: "2025-04-02", end: "2025-04-08" },
34
+ ];
35
+
36
+ /** A boundary close: the last one on or before the day asked for. */
37
+ interface DatedClose {
38
+ date: string;
39
+ close: number;
40
+ }
41
+ /** An episode's two closes, in the listing's own currency (an FX pair's in USD per unit). */
42
+ interface EpisodeCloses {
43
+ start: DatedClose;
44
+ end: DatedClose;
45
+ }
46
+
47
+ /**
48
+ * The closes the replays read, kept small enough to cache: each instrument's
49
+ * and each currency's at the start and end of every episode it traded
50
+ * through. An episode missing from an instrument's entry is one it has no
51
+ * closes for (listed later, or halted across a boundary).
52
+ */
53
+ export interface RiskEpisodeHistory {
54
+ /** By instrument (riskInstrumentId), then episode. */
55
+ closes: Record<string, Record<string, EpisodeCloses>>;
56
+ /** USD per unit, by currency then episode. */
57
+ fx: Record<string, Record<string, EpisodeCloses>>;
58
+ /** Why an instrument's or a currency's closes did not load, by its id or code. */
59
+ errors: Record<string, string>;
60
+ }
61
+
62
+ /** The episode closes as the model reads them, or what they are waiting on: still loading, or the load's failure. */
63
+ export type RiskEpisodeState = RiskEpisodeHistory | { pending: true; error: string | null };
64
+
65
+ /** A holding to replay: its listing, and the currency it quotes in when that is not USD. */
66
+ export interface RiskEpisodeTarget {
67
+ instrument: RiskInstrument;
68
+ /** The listing currency as quoted (GBp, JPY); null for a USD listing. */
69
+ currency: string | null;
70
+ }
71
+
72
+ const DAY_MS = 86_400_000;
73
+ /** A boundary close may be this many days before its date: a weekend, a holiday or a market's own closure. */
74
+ const BOUNDARY_DAYS = 7;
75
+ const EPISODE_CONCURRENCY = 4;
76
+ const SPY = RISK_FACTOR_INSTRUMENTS[0]!;
77
+
78
+ /** The one window every episode fits in, with room for a start date's close a holiday before it. */
79
+ function episodeSpan(): { startDate: string; endDate: string } {
80
+ const starts = RISK_EPISODES.map((episode) => episode.start).sort();
81
+ const ends = RISK_EPISODES.map((episode) => episode.end).sort();
82
+ const first = new Date(Date.parse(`${starts[0]}T00:00:00Z`) - (BOUNDARY_DAYS + 3) * DAY_MS);
83
+ return { startDate: first.toISOString().slice(0, 10), endDate: ends.at(-1)! };
84
+ }
85
+
86
+ function closeOnOrBefore(dates: readonly string[], closes: ReadonlyMap<string, number>, day: string): DatedClose | null {
87
+ let low = 0, high = dates.length - 1, found = -1;
88
+ while (low <= high) {
89
+ const middle = (low + high) >> 1;
90
+ if (dates[middle]! <= day) {
91
+ found = middle;
92
+ low = middle + 1;
93
+ } else high = middle - 1;
94
+ }
95
+ if (found < 0) return null;
96
+ const date = dates[found]!;
97
+ if (Date.parse(`${day}T00:00:00Z`) - Date.parse(`${date}T00:00:00Z`) > BOUNDARY_DAYS * DAY_MS) return null;
98
+ return { date, close: closes.get(date)! };
99
+ }
100
+
101
+ /**
102
+ * Each episode's closes from a series of daily closes: the last on or before
103
+ * its start and its end, at most a week before each. A series that starts
104
+ * after an episode's start (listed later) has none for it, and neither does
105
+ * one with no close in the week before a boundary.
106
+ */
107
+ export function episodeCloses(points: readonly { date: string; close: number }[]): Record<string, EpisodeCloses> {
108
+ const closes = new Map<string, number>();
109
+ for (const point of points) closes.set(point.date.slice(0, 10), point.close);
110
+ const dates = [...closes.keys()].sort();
111
+ const result: Record<string, EpisodeCloses> = {};
112
+ for (const episode of RISK_EPISODES) {
113
+ const start = closeOnOrBefore(dates, closes, episode.start);
114
+ const end = closeOnOrBefore(dates, closes, episode.end);
115
+ if (start && end && end.date > start.date) result[episode.id] = { start, end };
116
+ }
117
+ return result;
118
+ }
119
+
120
+ /** Positive daily closes from a history answer; an answer without any is a series with none. */
121
+ function dailyCloses(response: CloudMarketResponse<CloudPricePointPayload[]>): { date: string; close: number }[] {
122
+ // An empty answer is a listing with no closes in the span (listed after it); the replays proxy it.
123
+ if (response.status === "empty") return [];
124
+ if ((response.status !== "success" && response.status !== "partial") || !Array.isArray(response.data))
125
+ throw new Error(response.reasonCode ?? "Daily history unavailable");
126
+ return response.data.flatMap((row) => {
127
+ const time = typeof row?.date === "string" ? Date.parse(row.date) : Number.NaN;
128
+ return Number.isFinite(time) && Number.isFinite(row.close) && row.close > 0
129
+ ? [{ date: new Date(time).toISOString().slice(0, 10), close: row.close }]
130
+ : [];
131
+ });
132
+ }
133
+
134
+ type EpisodeClient = Pick<typeof apiClient, "getCloudHistory">;
135
+ type EpisodeClosesById = Record<string, EpisodeCloses>;
136
+
137
+ /** How the replays read one listing's or one currency's closes: straight from Gloom Cloud, or through the cache. */
138
+ export interface EpisodeReader {
139
+ instrument(instrument: RiskInstrument, signal?: AbortSignal): Promise<EpisodeClosesById>;
140
+ /** USD per unit of the currency. */
141
+ currency(currency: string, signal?: AbortSignal): Promise<EpisodeClosesById>;
142
+ }
143
+
144
+ /**
145
+ * Reads each listing's closes over the one span every episode fits in, one
146
+ * request each, and a currency's from its daily FX pair, as USD per unit.
147
+ */
148
+ export function cloudEpisodeReader(client: EpisodeClient = apiClient): EpisodeReader {
149
+ const params = { interval: "1day", ...episodeSpan(), outputsize: 1500 } as const;
150
+ return {
151
+ async instrument(instrument, signal) {
152
+ return episodeCloses(dailyCloses(await client.getCloudHistory(instrument.symbol, instrument.exchange, params, signal ? { signal } : undefined)));
153
+ },
154
+ async currency(currency, signal) {
155
+ const leg = riskConversion(currency)?.leg;
156
+ if (!leg) throw new Error(`No daily FX pair for ${currency}`);
157
+ const points = dailyCloses(await client.getCloudHistory(leg.instrument.symbol, leg.instrument.exchange ?? "", params, signal ? { signal } : undefined));
158
+ return episodeCloses(points.map((point) => ({ ...point, close: leg.invert ? 1 / point.close : point.close })));
159
+ },
160
+ };
161
+ }
162
+
163
+ /**
164
+ * The closes the episode replays read: SPY's, every target's, and the daily
165
+ * FX closes of each currency a target quotes in and of a non-USD account,
166
+ * four reads at a time. A read that fails is named in `errors`, and the
167
+ * replays move that holding by proxy; the signal stops the load.
168
+ */
169
+ export async function fetchRiskEpisodeHistory(
170
+ targets: readonly RiskEpisodeTarget[],
171
+ accountCurrency = "USD",
172
+ reader: EpisodeReader = cloudEpisodeReader(),
173
+ signal?: AbortSignal,
174
+ ): Promise<RiskEpisodeHistory> {
175
+ signal?.throwIfAborted();
176
+ const instruments = [...new Map([SPY, ...targets.map((target) => target.instrument)].map((row) => [riskInstrumentId(row), row])).entries()];
177
+ const currencies = [...new Set([
178
+ ...targets.flatMap((target) => target.currency ? [riskConversion(target.currency)?.currency ?? target.currency] : []),
179
+ ...(accountCurrency === "USD" ? [] : [accountCurrency]),
180
+ ])].filter((currency) => currency !== "USD");
181
+ const history: RiskEpisodeHistory = { closes: {}, fx: {}, errors: {} };
182
+ const read = async (key: string, into: Record<string, EpisodeClosesById>, load: () => Promise<EpisodeClosesById>) => {
183
+ try {
184
+ into[key] = await load();
185
+ } catch (error) {
186
+ if (isAccessDenied(error) || signal?.aborted) throw error;
187
+ history.errors[key] = error instanceof Error ? error.message : "Daily closes unavailable";
188
+ }
189
+ };
190
+ const jobs: Array<() => Promise<void>> = [
191
+ ...instruments.map(([id, instrument]) => () => read(id, history.closes, () => reader.instrument(instrument, signal))),
192
+ ...currencies.map((currency) => () => read(currency, history.fx, () => reader.currency(currency, signal))),
193
+ ];
194
+ let next = 0;
195
+ await Promise.all(Array.from({ length: Math.min(EPISODE_CONCURRENCY, jobs.length) }, async () => {
196
+ while (next < jobs.length) {
197
+ signal?.throwIfAborted();
198
+ await jobs[next++]!();
199
+ }
200
+ }));
201
+ signal?.throwIfAborted();
202
+ return history;
203
+ }
204
+
205
+ /**
206
+ * One listing's or currency's episode closes. Closes from years ago do not
207
+ * change, and a ratio of two is the same after a later split adjusts both, so
208
+ * they keep for a month; a read that failed is not kept and is asked again.
209
+ */
210
+ export const riskEpisodeCache = createPluginCache<EpisodeClosesById>({
211
+ kind: "portfolio-risk-episodes",
212
+ source: "gloom-cloud",
213
+ schemaVersion: 1,
214
+ policy: { staleMs: 7 * DAY_MS, expireMs: 30 * DAY_MS },
215
+ });
216
+
217
+ /** The episodes' dates are part of every key, so a changed window reads its closes afresh. */
218
+ const EPISODE_KEY = RISK_EPISODES.map((episode) => `${episode.start}:${episode.end}`).join(",");
219
+
220
+ /**
221
+ * The pane's load: each listing and currency through the cache, so a new
222
+ * holding reads only its own closes, and loading again asks only for the
223
+ * ones that failed.
224
+ */
225
+ export function loadRiskEpisodeHistory(
226
+ targets: readonly RiskEpisodeTarget[],
227
+ accountCurrency: string,
228
+ ): Promise<RiskEpisodeHistory> {
229
+ const cloud = cloudEpisodeReader();
230
+ const cached = (key: string, load: () => Promise<EpisodeClosesById>) =>
231
+ loadCloudResource(riskEpisodeCache, `${key}|${EPISODE_KEY}`, load).then((result) => result.payload);
232
+ return fetchRiskEpisodeHistory(targets, accountCurrency, {
233
+ instrument: (instrument, signal) => cached(riskInstrumentId(instrument), () => cloud.instrument(instrument, signal)),
234
+ currency: (currency, signal) => cached(`fx:${currency}`, () => cloud.currency(currency, signal)),
235
+ });
236
+ }
237
+
238
+ /** A basket member as a replay weighs it. */
239
+ export interface EpisodeMember {
240
+ id: string;
241
+ symbol: string;
242
+ /** Its share of the basket, which the replay weighs it by. */
243
+ weight: number;
244
+ /** Its current value in the account currency, for its share of the book. */
245
+ value: number;
246
+ /** The listing currency its closes convert from; null for a USD listing. */
247
+ convertedFrom: string | null;
248
+ /** Daily returns in the account currency, which its proxy beta reads. */
249
+ returns: readonly DatedReturn[];
250
+ }
251
+
252
+ export interface EpisodeReplay {
253
+ episode: RiskEpisode;
254
+ /** The basket's return over the window, a fraction; null when the episode could not be replayed. */
255
+ value: number | null;
256
+ /** SPY's own move over the window, in USD. */
257
+ spy: number | null;
258
+ /**
259
+ * Members replayed by their beta to SPY: that beta (1 when `assumed`, the
260
+ * trailing returns pairing with too few of SPY's), their share of the
261
+ * basket the value is a percent of (`weight`) and of the book, and `failed`
262
+ * when their closes did not load rather than not exist.
263
+ */
264
+ proxied: Array<{ id: string; symbol: string; beta: number; assumed: boolean; weight: number; bookShare: number | null; failed: boolean }>;
265
+ /** Why the episode has no value. */
266
+ unavailable: string | null;
267
+ }
268
+
269
+ /** "19 Feb to 23 Mar 2020". */
270
+ export function episodeWindowText(episode: RiskEpisode): string {
271
+ const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
272
+ const day = (date: string) => `${Number(date.slice(8, 10))} ${MONTHS[Number(date.slice(5, 7)) - 1]}`;
273
+ return `${day(episode.start)}${episode.start.slice(0, 4) === episode.end.slice(0, 4) ? "" : ` ${episode.start.slice(0, 4)}`} to ${day(episode.end)} ${episode.end.slice(0, 4)}`;
274
+ }
275
+
276
+ const signedPercent = (value: number) => `${value > 0 ? "+" : ""}${(value * 100).toFixed(1)}%`;
277
+ const shareText = (share: number) => (share < 0.001 ? "under 0.1%" : `${formatNumber(share * 100, share < 0.1 ? 1 : 0)}%`);
278
+ /** A share in whole percent, for a row label: "22%", "<1%". */
279
+ const wholeShareText = (share: number) => (share < 0.005 ? "<1%" : `${Math.round(share * 100)}%`);
280
+
281
+ /**
282
+ * Replays each episode on today's basket at its current weights: every
283
+ * member moves as it moved between the episode's two closes, converted at the
284
+ * FX closes of the same dates when it quotes in another currency, and the
285
+ * basket's move is the weighted sum. A member with no closes across the
286
+ * window (listed later, or its history did not load) moves by its beta to SPY
287
+ * from its trailing daily returns, the regression the index scenario reads,
288
+ * times SPY's move; it is named with its share of the basket and stays in
289
+ * it. The closes are split-adjusted prices, so a replay is a price return:
290
+ * dividends paid over the window are not in it. A non-USD account's returns
291
+ * convert at its pair's closes of the same dates.
292
+ */
293
+ export function replayEpisodes(
294
+ history: RiskEpisodeHistory,
295
+ members: readonly EpisodeMember[],
296
+ {
297
+ spyReturns,
298
+ accountCurrency,
299
+ bookValue,
300
+ }: { spyReturns: readonly DatedReturn[]; accountCurrency: string; bookValue: number },
301
+ ): EpisodeReplay[] {
302
+ const spyId = riskInstrumentId(SPY);
303
+ const betas = new Map(members.map((member) => [member.id, regressReturns(member.returns.slice(-126), spyReturns)?.beta ?? null]));
304
+ return RISK_EPISODES.map((episode): EpisodeReplay => {
305
+ const empty = (unavailable: string): EpisodeReplay => ({ episode, value: null, spy: null, proxied: [], unavailable });
306
+ const spyCloses = history.closes[spyId]?.[episode.id];
307
+ if (!spyCloses) return empty(history.errors[spyId] ? `SPY daily closes did not load: ${history.errors[spyId]}` : "SPY has no daily closes over the window");
308
+ const spy = spyCloses.end.close / spyCloses.start.close - 1;
309
+ const accountFx = accountCurrency === "USD" ? null : history.fx[accountCurrency]?.[episode.id];
310
+ if (accountCurrency !== "USD" && !accountFx)
311
+ return empty(`${accountFxPair(accountCurrency) ?? accountCurrency} has no daily closes over the window`);
312
+ // A USD move restated in the account currency: its value over the USD price of one unit, at both closes.
313
+ const toAccount = (usd: number) => (accountFx ? (1 + usd) * (accountFx.start.close / accountFx.end.close) - 1 : usd);
314
+ const proxied: EpisodeReplay["proxied"] = [];
315
+ let value = 0;
316
+ for (const member of members) {
317
+ const closes = history.closes[member.id]?.[episode.id];
318
+ const fxCurrency = member.convertedFrom ? riskConversion(member.convertedFrom)?.currency ?? member.convertedFrom : null;
319
+ const fx = fxCurrency ? history.fx[fxCurrency]?.[episode.id] : null;
320
+ let move: number;
321
+ if (closes && (!fxCurrency || fx)) {
322
+ const usd = (closes.end.close * (fx?.end.close ?? 1)) / (closes.start.close * (fx?.start.close ?? 1)) - 1;
323
+ move = toAccount(usd);
324
+ } else {
325
+ // Beta from the account-currency returns on SPY's USD returns, as the index scenario reads it.
326
+ const measured = betas.get(member.id);
327
+ const beta = measured ?? 1;
328
+ const failed = history.errors[member.id] != null || (!!fxCurrency && history.errors[fxCurrency] != null);
329
+ proxied.push({
330
+ id: member.id,
331
+ symbol: member.symbol,
332
+ beta,
333
+ assumed: measured == null,
334
+ weight: member.weight,
335
+ bookShare: bookValue > 0 ? Math.abs(member.value) / bookValue : null,
336
+ failed,
337
+ });
338
+ move = beta * spy;
339
+ }
340
+ value += member.weight * move;
341
+ }
342
+ return { episode, value, spy, proxied, unavailable: null };
343
+ });
344
+ }
345
+
346
+ /** The basket share a replay moves by beta proxy, for a row label where its evidence does not show: "22% proxy". */
347
+ export function episodeProxyMarker(replay: EpisodeReplay): string | null {
348
+ const weight = replay.proxied.reduce((sum, row) => sum + Math.abs(row.weight), 0);
349
+ return replay.proxied.length ? `${wholeShareText(weight)} proxy` : null;
350
+ }
351
+
352
+ /**
353
+ * What a replay row says beside its value, a percent of the basket: what is
354
+ * proxied and its share of that basket first, so a narrow column still shows
355
+ * it, then the window, SPY's own move over it, and that it is a price return.
356
+ */
357
+ export function episodeEvidence(replay: EpisodeReplay, accountCurrency: string): string {
358
+ if (replay.unavailable) return `% of basket; ${replay.unavailable}; ${episodeWindowText(replay.episode)} closes`;
359
+ const proxies = replay.proxied;
360
+ // The gross share, as the row's marker gives it: a short is a part of the basket too, said as a short.
361
+ const weight = proxies.reduce((sum, row) => sum + Math.abs(row.weight), 0);
362
+ const name = (row: EpisodeReplay["proxied"][number]) => row.weight < 0 ? `${row.symbol} (short)` : row.symbol;
363
+ const names = proxies.length > 3 ? `${proxies.slice(0, 2).map(name).join(", ")} and ${proxies.length - 2} more` : proxies.map(name).join(", ");
364
+ return [
365
+ "% of basket",
366
+ ...(proxies.length ? [`${names} by beta proxy, ${shareText(weight)} of basket`] : []),
367
+ `${episodeWindowText(replay.episode)} closes`,
368
+ `SPY ${signedPercent(replay.spy!)}${accountCurrency === "USD" ? "" : " in USD"}`,
369
+ "price return",
370
+ ].join("; ");
371
+ }
372
+
373
+ /**
374
+ * What the replays leave to say beside their rows: a note per holding a
375
+ * replay moves by proxy because it has no closes over the window (its
376
+ * episodes, its shares of the basket and the book, and its beta), and as
377
+ * warnings what failed to load: a holding's closes, which a proxy then
378
+ * stands in for, or SPY's or the account pair's, which leave an episode
379
+ * without a value.
380
+ */
381
+ export function episodeIssues(replays: readonly EpisodeReplay[]): { notes: string[]; warnings: string[] } {
382
+ const byHolding = new Map<string, EpisodeReplay["proxied"][number] & { episodes: string[] }>();
383
+ for (const replay of replays)
384
+ for (const row of replay.proxied) {
385
+ const entry = byHolding.get(row.id) ?? { ...row, episodes: [] };
386
+ entry.episodes.push(replay.episode.label);
387
+ byHolding.set(row.id, entry);
388
+ }
389
+ const notes: string[] = [];
390
+ const warnings: string[] = [];
391
+ for (const row of byHolding.values()) {
392
+ // A short's share of the gross basket, as the replay's marker counts it, with the side said: never a negative share.
393
+ const shares = `${row.weight < 0 ? "short, " : ""}${shareText(Math.abs(row.weight))} of the basket${row.bookShare == null ? "" : `, ${shareText(row.bookShare)} of the book`}`;
394
+ const episodes = row.episodes.join(", ");
395
+ const beta = row.assumed ? "an assumed beta of 1 to SPY, too few of its returns pairing with SPY's" : `its beta of ${row.beta.toFixed(2)} to SPY`;
396
+ const moves = `${row.episodes.length === 1 ? "that replay moves" : "those replays move"} it by ${beta}`;
397
+ if (row.failed) warnings.push(`${row.symbol} (${shares}): daily closes for ${episodes} did not load; ${moves}.`);
398
+ else notes.push(`${row.symbol} (${shares}) has no daily closes across ${episodes}; ${moves}.`);
399
+ }
400
+ // One line per reason: SPY failing leaves every episode without a value for the same one.
401
+ const unavailable = new Map<string, string[]>();
402
+ for (const replay of replays)
403
+ if (replay.unavailable) unavailable.set(replay.unavailable, [...(unavailable.get(replay.unavailable) ?? []), replay.episode.label]);
404
+ for (const [reason, episodes] of unavailable)
405
+ warnings.push(`${episodes.length === replays.length ? "Historical episodes" : episodes.join(", ")}: ${reason}.`);
406
+ return { notes, warnings };
407
+ }
408
+
409
+ /**
410
+ * The holdings a replay reads closes for: each held one whose daily history
411
+ * loaded with enough returns for the basket, and the currency it converts
412
+ * from. A held factor ETF counts; the factor proxies alone do not.
413
+ */
414
+ export function riskEpisodeTargets(
415
+ market: Pick<RiskMarketSnapshot, "histories">,
416
+ held: readonly RiskInstrument[],
417
+ ): RiskEpisodeTarget[] {
418
+ const ids = new Set(held.map(riskInstrumentId));
419
+ return market.histories
420
+ .filter((row) => ids.has(riskInstrumentId(row.instrument)) && !row.error && row.returns.length >= 60)
421
+ .map((row) => ({ instrument: row.instrument, currency: row.converted?.currency ?? null }));
422
+ }
@@ -4,7 +4,7 @@ import { dailyFxCloses, FxHistoryError, type FxCloses } from "../../../market-da
4
4
  import { getPublishedUsEquityCalendarDay } from "../../../market-data/published-us-sessions";
5
5
  import type { PricePoint } from "../../../types/financials";
6
6
  import { resolveCurrencyUnit } from "../../../utils/currency-units";
7
- import type { DatedReturn } from "./metrics";
7
+ import type { DatedReturn } from "../../../portfolio/return-metrics";
8
8
 
9
9
  export type { FxCloses };
10
10