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
@@ -2,6 +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
6
  import { describeCollections } from "../../../portfolio/collection-name";
6
7
  import { shellWord } from "../../../utils/shell-word";
7
8
  import { formatShocks, parseAssetShifts, parseFxShifts, riskCashLines } from "./risk-book";
@@ -9,6 +10,7 @@ import {
9
10
  BASKET_VIEWS,
10
11
  BOOK_TOTAL_ROW_ID,
11
12
  buildPortfolioRisk,
13
+ isShockRow,
12
14
  portfolioRiskRequests,
13
15
  portfolioRiskTickers,
14
16
  riskCoverageLine,
@@ -171,6 +173,7 @@ export const portfolioRiskHeadless: HeadlessPaneDefinition<"bundle"> = {
171
173
  `Fixed-current-weight equity basket over the holdings that qualify, largest ${RISK_HISTORY_LIMIT} by value, in the account's currency; foreign listings convert to USD at daily FX closes, and a non-USD account's returns then convert into its currency at its own daily FX closes; metadata.coverage states the covered share of the book (cash included) and each holding and currency's cash left out.`,
172
174
  "--since filed buys the 13F's own weights at the filing-date close and holds them (--weights current holds today's weights fixed instead).",
173
175
  "--fx-shift and --asset-shift reprice every holding and the cash at once; the index, 10Y and VIX shifts are separate basket regressions.",
176
+ "The stress view also replays four past selloffs on today's basket at its current weights, from daily closes (Covid 19 Feb to 23 Mar 2020, rate shock 3 Jan to 12 Oct 2022, carry unwind 31 Jul to 5 Aug 2024, tariffs 2 Apr to 8 Apr 2025); a holding with no closes over a window moves by its trailing beta to SPY, named in the row with its share of the book.",
174
177
  "No account performance inferred.",
175
178
  "ETF price-return factor proxies.",
176
179
  "Historical percentiles need 20 rolling samples.",
@@ -313,7 +316,14 @@ export const portfolioRiskHeadless: HeadlessPaneDefinition<"bundle"> = {
313
316
  ? Promise.resolve(undefined)
314
317
  : loadPortfolioOptionBook(tickers, local.portfolio),
315
318
  ]);
316
- const market = { ...prices, brokerOptions };
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")
321
+ ? riskEpisodeTargets(prices, tickers.map((ticker) => ({ symbol: ticker.metadata.ticker, exchange: ticker.metadata.exchange })))
322
+ : [];
323
+ const episodes = episodeTargets.length
324
+ ? await fetchRiskEpisodeHistory(episodeTargets, local.portfolio.currency, cloudEpisodeReader(ctx.apiClient), ctx.signal)
325
+ : undefined;
326
+ const market = { ...prices, brokerOptions, ...(episodes ? { episodes } : {}) };
317
327
  if (ctx.signal.aborted) throw new Error("Portfolio risk load cancelled");
318
328
  const model = buildPortfolioRisk(
319
329
  local.portfolio,
@@ -360,19 +370,27 @@ export const portfolioRiskHeadless: HeadlessPaneDefinition<"bundle"> = {
360
370
  ? model.book != null && covered
361
371
  : view === "factors"
362
372
  ? covered && model.factors.every((row) => row.value != null)
363
- : model.complete;
364
- // A basket view with too little covered shows no estimate, and the report says why rather than leaving dashes.
373
+ : view === "stress"
374
+ // Every basket scenario has a value and no episode stands in a proxy for closes that failed to load.
375
+ ? model.complete
376
+ && model.rows.stress.every((row) => isShockRow(row) || row.value != null)
377
+ && !(model.episodes ?? []).some((row) => row.proxied.some((proxy) => proxy.failed))
378
+ : model.complete;
379
+ // A basket view with too little covered shows no estimate. The report opens with why, and leaves out
380
+ // the tables it would have filled with dashes; what does not need the basket (holdings, the given shocks) stays.
365
381
  const shortfall = BASKET_VIEWS.has(view as RiskView) ? coverageLine(model.coverage).error : undefined;
382
+ const views = (requestedView ? [requestedView] : RISK_VIEWS).map((view) => ({ view, rows: model.rows[view] }));
383
+ const shown = (shortfall
384
+ ? views.map(({ view, rows }) => ({ view, rows: view === "holdings" ? rows : rows.filter((row) => row.value != null) }))
385
+ .filter(({ rows }) => rows.length > 0)
386
+ : views).map(({ view, rows }) => ({ view, rows: rows.map(displayRow) }));
366
387
  return {
367
388
  complete,
368
- errors: [...(shortfall ? [shortfall] : []), ...model.warnings],
389
+ errors: model.warnings,
369
390
  notes: [...riskCoverageNotices(model.coverage), ...model.notes.filter((note) => note !== fallback)],
370
- sections: (requestedView ? [requestedView] : RISK_VIEWS).map((view) => ({
371
- title: view,
372
- columns: RISK_COLUMNS,
373
- rows: model.rows[view].map(displayRow),
374
- })),
375
- metadata: { coverage: coverageSummary(model.coverage), model, benchmark: model.benchmark, window: model.window, notices },
391
+ sections: shown.map(({ view, rows }) => ({ title: view, columns: RISK_COLUMNS, rows })),
392
+ metadata: { coverage: coverageSummary(model.coverage), model, benchmark: model.benchmark, window: model.window,
393
+ notices: [...(shortfall ? [shortfall] : []), ...notices] },
376
394
  };
377
395
  },
378
396
  compact(result, args) {
@@ -2,7 +2,7 @@ import {
2
2
  historyStatistics,
3
3
  type HistoryStatistics,
4
4
  } from "../../../components/chart/curve/model";
5
- import type { DatedReturn } from "./metrics";
5
+ import type { DatedReturn } from "../../../portfolio/return-metrics";
6
6
 
7
7
  export interface RiskSamplePoint extends DatedReturn {
8
8
  benchmark: number;
@@ -10,11 +10,12 @@ import type { Quote } from "../../../types/financials";
10
10
  import type { CloudQuotePayload } from "../../../api-client/types";
11
11
  import { getCompletedRegularSessionDisplay } from "../../../market-data/market/status";
12
12
  import { quoteTradingDay } from "../../../market-data/quotes/day-range";
13
- import type { DatedReturn } from "./metrics";
13
+ import type { DatedReturn } from "../../../portfolio/return-metrics";
14
+ import { episodeEvidence, episodeIssues, episodeProxyMarker, episodeWindowText, replayEpisodes, RISK_EPISODES } from "./risk-episodes";
14
15
  import {
15
16
  computeWeightedPortfolioReturns,
16
17
  syntheticPositionUnsupportedReason,
17
- } from "./metrics";
18
+ } from "../../../portfolio/return-metrics";
18
19
  import {
19
20
  buyAndHoldReturns,
20
21
  concentration,
@@ -164,6 +165,11 @@ export interface RiskDisplayRow {
164
165
  amountBase?: number;
165
166
  /** What a tail loss in money is taken on: the basket's value and share of the book, and what it leaves out. */
166
167
  basis?: string;
168
+ /**
169
+ * The caveat a narrow pane puts beside the label when it has no room for
170
+ * the evidence: the basket share an episode replays by beta proxy ("22% proxy").
171
+ */
172
+ marker?: string;
167
173
  }
168
174
  /** The tail-loss rows, which also read in money on the covered basket. */
169
175
  const TAIL_ROW_IDS: ReadonlySet<string> = new Set(["var", "es"]);
@@ -320,6 +326,27 @@ export function portfolioRiskTickers(
320
326
  positions(ticker, portfolioId).length > 0,
321
327
  );
322
328
  }
329
+ /** Below this share of gross exposure, a book's net value is too small to state its basket per (a market-neutral book). */
330
+ const NET_BASIS_MIN_SHARE = 0.1;
331
+ const basketNetNote = (net: number, currency: string) =>
332
+ `Basket returns, volatility, betas, stresses and tail losses are per the book's net value, longs less shorts (${formatNumber(net, 0)} ${currency}), as a fund states them.`;
333
+ const BASKET_GROSS_NOTE = "Basket returns, volatility, betas and stresses are per gross exposure, longs plus shorts at their absolute value: the book's net value is under 10% of it.";
334
+
335
+ /**
336
+ * What a basket's returns, read per its gross value, are multiplied by to read
337
+ * per its net value: gross over net, 1 for a long-only basket; 1 and `gross`
338
+ * when the net is under a tenth of the gross (or short), which no fund states
339
+ * its risk per.
340
+ */
341
+ function basketNetScale(values: readonly number[]): { factor: number; basis: "net" | "gross" } {
342
+ const gross = values.reduce((sum, value) => sum + Math.abs(value), 0);
343
+ const net = values.reduce((sum, value) => sum + value, 0);
344
+ if (!(gross > 0)) return { factor: 1, basis: "net" };
345
+ return net >= NET_BASIS_MIN_SHARE * gross ? { factor: gross / net, basis: "net" } : { factor: 1, basis: "gross" };
346
+ }
347
+
348
+ /** The basket takes a short at its signed current weight; futures, options and crypto stay out with their reason. */
349
+ const BASKET_TAKES = { shorts: true } as const;
323
350
  const signedQuantity = (lots: TickerRecord["metadata"]["positions"]) =>
324
351
  lots.reduce(
325
352
  (sum, row) => sum + (row.side === "short" ? -Math.abs(row.shares) : row.shares),
@@ -345,7 +372,7 @@ export function portfolioRiskRequests(
345
372
  currency,
346
373
  snapshotValue: snapshot,
347
374
  unsupported:
348
- syntheticPositionUnsupportedReason(ticker, "USD", portfolioId) != null ||
375
+ syntheticPositionUnsupportedReason(ticker, "USD", portfolioId, BASKET_TAKES) != null ||
349
376
  lots.some((row) => !Number.isFinite(row.shares)),
350
377
  };
351
378
  });
@@ -670,7 +697,7 @@ export function buildPortfolioRisk(
670
697
  quote?.currency ?? close?.currency ?? history?.listing?.currency ?? ticker.metadata.currency;
671
698
  const foreign = !convertedFrom && listingCurrency !== "USD";
672
699
  const usdError =
673
- syntheticPositionUnsupportedReason(ticker, "USD", portfolio.id) ??
700
+ syntheticPositionUnsupportedReason(ticker, "USD", portfolio.id, BASKET_TAKES) ??
674
701
  (lots.some((row) => !Number.isFinite(row.shares))
675
702
  ? "Invalid position quantity"
676
703
  : null) ??
@@ -681,7 +708,7 @@ export function buildPortfolioRisk(
681
708
  : null) ??
682
709
  // A foreign listing that did not convert says why: no pair, stale or gapped FX.
683
710
  (foreign
684
- ? (history?.error ?? syntheticPositionUnsupportedReason(ticker, listingCurrency, portfolio.id))
711
+ ? (history?.error ?? syntheticPositionUnsupportedReason(ticker, listingCurrency, portfolio.id, BASKET_TAKES))
685
712
  : null) ??
686
713
  history?.error ??
687
714
  (!history ? "Daily history unavailable" : null);
@@ -696,20 +723,21 @@ export function buildPortfolioRisk(
696
723
  Number.isFinite(mark.price) &&
697
724
  mark.price > 0 &&
698
725
  priceDate &&
699
- (!syntheticPositionUnsupportedReason(
726
+ !syntheticPositionUnsupportedReason(
700
727
  ticker,
701
728
  mark.currency,
702
729
  portfolio.id,
703
- ) ||
704
- error?.startsWith("Short positions"))
730
+ BASKET_TAKES,
731
+ )
705
732
  ? quantity * mark.price
706
733
  : null;
707
734
  const accountValue = marked == null || !account ? marked : accountRate! > 0 ? marked / accountRate! : null;
708
735
  const value = accountValue != null && Number.isFinite(accountValue) ? accountValue : null;
709
736
  const returns = inAccount?.returns ?? history?.returns ?? [];
737
+ // A short's value is negative: it is marked, and enters the basket at its signed weight.
710
738
  const leftOut =
711
739
  error ??
712
- (value == null || value <= 0
740
+ (value == null || value === 0
713
741
  ? "No current USD mark"
714
742
  : returns.length < 60
715
743
  ? "Fewer than 60 daily returns"
@@ -754,7 +782,8 @@ export function buildPortfolioRisk(
754
782
  // Cash counts in the book the coverage is a share of, at its gross value as a short does.
755
783
  const cashGross = cashHoldings.reduce((sum, row) => sum + Math.abs(row.value ?? 0), 0);
756
784
  const marketValue = holdingsValue + cashGross;
757
- const coveredValue = qualifying.reduce((sum, row) => sum + row.value!, 0);
785
+ // A short covers its gross value, as it counts in the book.
786
+ const coveredValue = qualifying.reduce((sum, row) => sum + Math.abs(row.value!), 0);
758
787
  const share = marketValue > 0 ? coveredValue / marketValue : null;
759
788
  // Whether the basket is most of what is invested: cash is no holding the basket could have taken.
760
789
  const holdingsShare = holdingsValue > 0 ? coveredValue / holdingsValue : null;
@@ -793,9 +822,11 @@ export function buildPortfolioRisk(
793
822
  // Weights renormalize over the covered basket; nothing outside it is approximated into it.
794
823
  const members = sufficient ? qualifying : [];
795
824
  const basketWeights = members.length ? concentration(members) : null;
796
- for (const holding of members)
797
- holding.weight =
798
- basketWeights?.rows.find((row) => row.id === holding.id)?.weight ?? null;
825
+ // Each a share of the basket's gross value, signed as its position: a short is a negative weight.
826
+ for (const holding of members) {
827
+ const weight = basketWeights?.rows.find((row) => row.id === holding.id)?.weight;
828
+ holding.weight = weight == null ? null : Math.sign(holding.value!) * weight;
829
+ }
799
830
  // Concentration needs a value, not a return history: it reads every holding that has one, left out of the basket or not.
800
831
  const book = concentration(
801
832
  valued.filter((row) => row.marketValue! > 0).map((row) => ({ id: row.id, value: row.marketValue })),
@@ -828,10 +859,18 @@ export function buildPortfolioRisk(
828
859
  : [],
829
860
  ),
830
861
  ];
862
+ // A hedged basket's returns are stated per its net value, longs less shorts, as a fund states them (a 130/30
863
+ // book's beta reads about 1.0); only a book whose net is under a tenth of its gross is read per gross exposure.
864
+ // A long-only basket's net is its gross: nothing changes.
865
+ const basketScale = basketNetScale(members.map((row) => row.value ?? 0));
866
+ if (basketScale.basis === "gross") notes.push(BASKET_GROSS_NOTE);
867
+ else if (basketScale.factor !== 1)
868
+ notes.push(basketNetNote(coverage.coveredValue / basketScale.factor, coverage.currency));
831
869
  const basket = members.length
832
870
  ? computeWeightedPortfolioReturns(
833
871
  members.map((row) => ({ weight: row.weight!, returns: row.returns })),
834
- )
872
+ { signed: true },
873
+ ).map((point) => ({ ...point, value: point.value * basketScale.factor }))
835
874
  : [];
836
875
  const proxy = (symbol: string) => {
837
876
  const instrument = RISK_FACTOR_INSTRUMENTS.find(
@@ -960,6 +999,30 @@ export function buildPortfolioRisk(
960
999
  value: regression ? regression.beta * stress.shock * 100 : null,
961
1000
  };
962
1001
  });
1002
+ // Past selloffs replayed on today's basket at its current weights, each
1003
+ // holding from its own daily closes or, without them, by its beta to SPY.
1004
+ const episodeState = market.episodes;
1005
+ const episodes = episodeState && !("pending" in episodeState) && members.length
1006
+ ? replayEpisodes(
1007
+ episodeState,
1008
+ members.map((row) => ({
1009
+ id: row.id,
1010
+ symbol: row.symbol,
1011
+ weight: row.weight ?? 0,
1012
+ value: row.value ?? 0,
1013
+ convertedFrom: row.convertedFrom,
1014
+ returns: row.returns,
1015
+ })),
1016
+ { spyReturns: spy, accountCurrency: portfolio.currency, bookValue: marketValue },
1017
+ // Per the net value, as the basket's returns are; its proxied shares stay shares of the gross basket.
1018
+ ).map((replay) => replay.value == null ? replay : { ...replay, value: replay.value * basketScale.factor })
1019
+ : null;
1020
+ if (episodes) {
1021
+ const issues = episodeIssues(episodes);
1022
+ notes.push(...issues.notes);
1023
+ warnings.push(...issues.warnings);
1024
+ } else if (episodeState && "pending" in episodeState && episodeState.error && members.length)
1025
+ warnings.push(`Historical episodes: daily closes did not load: ${episodeState.error}`);
963
1026
  // The given currency and price shocks reprice every line of the book, cash included, at once.
964
1027
  const bookLines: RiskBookLine[] = [
965
1028
  ...holdings.map((row) => ({
@@ -1007,8 +1070,10 @@ export function buildPortfolioRisk(
1007
1070
  warnings.push(...(greeks?.warnings ?? []));
1008
1071
  const rows: Record<RiskView, RiskDisplayRow[]> = {
1009
1072
  risk: metrics.map((row) => {
1010
- // VaR and expected shortfall are a one-day loss on the covered basket's current value, in the portfolio currency.
1073
+ // VaR and expected shortfall are a one-day loss on the covered basket's current value, in the portfolio currency:
1074
+ // its net value when the returns are stated per net (the gross over the scale), else its gross.
1011
1075
  const tail = TAIL_ROW_IDS.has(row.id) && row.value != null && coverage.coveredValue > 0;
1076
+ const tailBase = coverage.coveredValue / basketScale.factor;
1012
1077
  return {
1013
1078
  ...row,
1014
1079
  percentile: row.rank.percentile,
@@ -1016,9 +1081,9 @@ export function buildPortfolioRisk(
1016
1081
  detail: TAIL_ROW_IDS.has(row.id) ? riskTailMethod(row.samples, row.value != null) : `${row.samples} sessions`,
1017
1082
  ...(tail
1018
1083
  ? {
1019
- amount: (row.value! / 100) * coverage.coveredValue,
1084
+ amount: (row.value! / 100) * tailBase,
1020
1085
  amountCurrency: coverage.currency,
1021
- amountBase: coverage.coveredValue,
1086
+ amountBase: tailBase,
1022
1087
  basis: riskCoverageLine(coverage) ?? undefined,
1023
1088
  }
1024
1089
  : {}),
@@ -1071,15 +1136,18 @@ export function buildPortfolioRisk(
1071
1136
  ]
1072
1137
  .sort((a, b) => (b.size ?? -1) - (a.size ?? -1))
1073
1138
  .map(({ row }) => row),
1074
- correlation: correlation.map((row) => ({
1075
- id: `${row.left}/${row.right}`,
1076
- label: row.label,
1077
- value: row.value,
1078
- unit: "correlation",
1079
- percentile: null,
1080
- asOf: row.asOf ?? null,
1081
- detail: `${row.samples ?? 0} matched daily returns`,
1082
- })),
1139
+ // Strongest first, either sign: the pairs that move the basket together or against each other lead.
1140
+ correlation: correlation
1141
+ .map((row) => ({
1142
+ id: `${row.left}/${row.right}`,
1143
+ label: row.label,
1144
+ value: row.value,
1145
+ unit: "correlation",
1146
+ percentile: null,
1147
+ asOf: row.asOf ?? null,
1148
+ detail: `${row.samples ?? 0} matched daily returns`,
1149
+ }))
1150
+ .sort((left, right) => (right.value == null ? -1 : Math.abs(right.value)) - (left.value == null ? -1 : Math.abs(left.value))),
1083
1151
  stress: [
1084
1152
  // A regression scenario moves the basket by its beta; it is a share of the basket, not of the book.
1085
1153
  ...stresses.map((row) => ({
@@ -1091,6 +1159,26 @@ export function buildPortfolioRisk(
1091
1159
  asOf: row.regression?.asOf ?? null,
1092
1160
  detail: `% of basket; ${row.regression?.samples ?? 0} sessions; R² ${row.regression?.rSquared?.toFixed(2) ?? "--"}; ${row.source}`,
1093
1161
  })),
1162
+ // Dated as the index scenario is: the weights and betas are today's, the window is in the label and the evidence.
1163
+ ...(episodeState
1164
+ ? RISK_EPISODES.map((episode, index): RiskDisplayRow => {
1165
+ const replay = episodes?.[index];
1166
+ const waiting = "pending" in episodeState
1167
+ ? (episodeState.error ? `daily closes did not load: ${episodeState.error}` : "loading daily closes")
1168
+ : "no basket to replay";
1169
+ const marker = replay ? episodeProxyMarker(replay) : null;
1170
+ return {
1171
+ id: `episode:${episode.id}`,
1172
+ label: episode.label,
1173
+ value: replay?.value == null ? null : replay.value * 100,
1174
+ unit: "%",
1175
+ percentile: null,
1176
+ asOf: stresses[0]?.regression?.asOf ?? basket.at(-1)?.dateKey ?? null,
1177
+ detail: replay ? episodeEvidence(replay, portfolio.currency) : `% of basket; ${waiting}; ${episodeWindowText(episode)} closes`,
1178
+ ...(marker ? { marker } : {}),
1179
+ };
1180
+ })
1181
+ : []),
1094
1182
  ...(repricing ? repricingRows(repricing, portfolio.currency, market.fetchedAt) : []),
1095
1183
  ],
1096
1184
  performance: performance
@@ -1235,6 +1323,7 @@ export function buildPortfolioRisk(
1235
1323
  factors,
1236
1324
  correlation,
1237
1325
  stresses,
1326
+ episodes,
1238
1327
  performance,
1239
1328
  attribution,
1240
1329
  greeks,