gloomberb 0.20.1 → 0.20.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (422) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +1 -1
  4. package/src/account/auth-model.ts +20 -1
  5. package/src/account/upgrade-dialog.tsx +8 -4
  6. package/src/api-client/askg.ts +7 -1
  7. package/src/api-client/auth.ts +27 -0
  8. package/src/api-client/catalysts.ts +2 -0
  9. package/src/api-client/company-kpis.ts +2 -1
  10. package/src/api-client/cot.ts +14 -2
  11. package/src/api-client/data.ts +3 -2
  12. package/src/api-client/earnings.ts +46 -3
  13. package/src/api-client/futures-curve.ts +17 -0
  14. package/src/api-client/index.ts +4 -1
  15. package/src/api-client/one-tap-reasons.ts +42 -0
  16. package/src/api-client/perps.ts +2 -1
  17. package/src/api-client/request.ts +3 -1
  18. package/src/api-client/research-activity.ts +16 -3
  19. package/src/api-client/types/filings-and-calls.ts +3 -0
  20. package/src/api-client/types/search.ts +3 -0
  21. package/src/app/keybindings/chord.ts +153 -9
  22. package/src/app/keybindings/index.ts +1 -1
  23. package/src/app/keybindings/labels.ts +49 -6
  24. package/src/app/runtime/desktop-deeplink.ts +73 -8
  25. package/src/app.tsx +7 -1
  26. package/src/architecture/core-builtin-allowlist.json +1 -2
  27. package/src/architecture/pane-tabs-allowlist.json +2 -1
  28. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  29. package/src/architecture/ui-literals-allowlist.json +8 -8
  30. package/src/brokers/broker-portfolio-sync.ts +1 -1
  31. package/src/cli/bank-section.ts +26 -12
  32. package/src/cli/commands/market.ts +266 -75
  33. package/src/cli/commands/ticker.ts +12 -7
  34. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  35. package/src/cli/desktop-pane-shot.ts +15 -0
  36. package/src/cli/entry.ts +5 -0
  37. package/src/cli/export-source.ts +7 -1
  38. package/src/cli/freshness.ts +0 -16
  39. package/src/cli/fx-pair.ts +64 -12
  40. package/src/cli/fx-quote-rate.ts +144 -0
  41. package/src/cli/glossary.ts +5 -0
  42. package/src/cli/history-back-adjust.ts +122 -0
  43. package/src/cli/history-rows.ts +114 -10
  44. package/src/cli/index.ts +4 -1
  45. package/src/cli/known-gaps.ts +45 -3
  46. package/src/cli/listing-arg.ts +48 -4
  47. package/src/cli/name-entries.ts +25 -5
  48. package/src/cli/pane-functions/catalog.ts +12 -2
  49. package/src/cli/pane-functions/dom.ts +4 -2
  50. package/src/cli/pane-functions/headless.ts +8 -5
  51. package/src/cli/pane-functions/index.ts +3 -0
  52. package/src/cli/pane-functions/resolver.ts +4 -1
  53. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  54. package/src/cli/pane-functions/screenshot-payload.ts +130 -66
  55. package/src/cli/pane-functions/screenshot-render.ts +14 -2
  56. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  57. package/src/cli/symbol-rows.ts +22 -2
  58. package/src/cli/ticker-resolution.ts +74 -17
  59. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  60. package/src/components/chart/composite/composite-chart.tsx +8 -1
  61. package/src/components/chart/composite/format.ts +16 -1
  62. package/src/components/chart/composite/legend.tsx +4 -3
  63. package/src/components/chart/composite/panel-labels.ts +2 -1
  64. package/src/components/chart/composite/panel-surface.tsx +33 -4
  65. package/src/components/chart/composite/time-scale.ts +1 -1
  66. package/src/components/chart/composite/toolbar.tsx +8 -4
  67. package/src/components/chart/composite/types.ts +17 -1
  68. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  69. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  70. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  71. package/src/components/chart-table/axis.ts +11 -0
  72. package/src/components/command-bar/assist/inventory.ts +3 -2
  73. package/src/components/command-bar/commands/collection-list.ts +3 -2
  74. package/src/components/command-bar/panel/layout.ts +8 -1
  75. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  76. package/src/components/command-bar/panel/state.ts +4 -0
  77. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  78. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  79. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  80. package/src/components/company-logo.tsx +2 -2
  81. package/src/components/data-table/view.tsx +11 -2
  82. package/src/components/feed-data-table/stack-view.tsx +20 -6
  83. package/src/components/feedback-dialog.tsx +3 -1
  84. package/src/components/form-modal/field-row.tsx +1 -1
  85. package/src/components/form-modal/routes.ts +1 -0
  86. package/src/components/index.ts +1 -1
  87. package/src/components/layout/header.tsx +12 -3
  88. package/src/components/layout/market-summary.ts +2 -1
  89. package/src/components/layout/pane/footer/index.tsx +9 -5
  90. package/src/components/layout/pane/footer/model.ts +26 -10
  91. package/src/components/layout/pane/footer/registration.tsx +60 -1
  92. package/src/components/layout/pane/header-tabs.tsx +17 -3
  93. package/src/components/layout/pane/header.tsx +5 -2
  94. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  95. package/src/components/layout/shell/active-drag.ts +38 -30
  96. package/src/components/layout/shell/drag/index.ts +51 -21
  97. package/src/components/layout/shell/menu.ts +3 -5
  98. package/src/components/layout/shell/pane/actions.ts +4 -1
  99. package/src/components/layout/shell/pane/ask.ts +5 -2
  100. package/src/components/layout/status-bar.tsx +59 -54
  101. package/src/components/markdown-text.tsx +35 -10
  102. package/src/components/onboarding/first-run-workspace.ts +25 -23
  103. package/src/components/onboarding/onboarding-keyboard.ts +6 -1
  104. package/src/components/onboarding/onboarding-wizard.tsx +12 -2
  105. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -3
  106. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  107. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  108. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  109. package/src/components/onboarding/wizard-positions.ts +8 -1
  110. package/src/components/pane-notice-seen.ts +125 -0
  111. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  112. package/src/components/pane-settings-dialog.tsx +7 -6
  113. package/src/components/sign-in-code-panel.tsx +3 -2
  114. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  115. package/src/components/ticker/list-table-view.tsx +39 -3
  116. package/src/components/ui/confirm-dialog.tsx +2 -1
  117. package/src/components/ui/data-table/index.tsx +4 -2
  118. package/src/components/ui/data-table/opentui/index.tsx +15 -5
  119. package/src/components/ui/data-table/types.ts +8 -0
  120. package/src/components/ui/external-link.tsx +4 -1
  121. package/src/components/ui/field-grid.tsx +1 -1
  122. package/src/components/ui/index.ts +2 -0
  123. package/src/components/ui/inline-quick-add.tsx +5 -0
  124. package/src/components/ui/multi-select/dialog.tsx +10 -9
  125. package/src/components/ui/pane-link-chip.tsx +354 -0
  126. package/src/components/ui/query-bar.tsx +22 -13
  127. package/src/components/ui/ratio-bar.tsx +24 -1
  128. package/src/components/ui/select-button.tsx +2 -1
  129. package/src/components/ui/shortcut-hint.tsx +6 -3
  130. package/src/components/ui/table-layout.ts +81 -0
  131. package/src/components/ui/tabs.tsx +45 -6
  132. package/src/components/use-pane-notice-footer.tsx +12 -4
  133. package/src/core/app-service-ports.ts +1 -1
  134. package/src/data/plugin-state-store.ts +44 -8
  135. package/src/docs/snapshot.json +53 -32
  136. package/src/i18n/es.ts +25 -6
  137. package/src/i18n/ja.ts +25 -5
  138. package/src/i18n/ko.ts +25 -5
  139. package/src/i18n/zh-cn.ts +25 -5
  140. package/src/i18n/zh-tw.ts +25 -5
  141. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  142. package/src/layout/pane-manager/gridlock.ts +47 -2
  143. package/src/layout-marketplace/api.ts +1 -0
  144. package/src/layout-marketplace/gallery.tsx +4 -3
  145. package/src/layout-marketplace/linked.ts +6 -4
  146. package/src/layout-marketplace/model.ts +3 -2
  147. package/src/market-data/futures-contract.ts +77 -31
  148. package/src/market-data/fx-closes.ts +5 -2
  149. package/src/market-data/hooks.tsx +23 -0
  150. package/src/market-data/market/change-basis.ts +72 -14
  151. package/src/market-data/market/format.ts +19 -11
  152. package/src/market-data/market/globex-day.ts +73 -0
  153. package/src/market-data/market/index-level.ts +10 -1
  154. package/src/market-data/quotes/intraday-bar.ts +1 -1
  155. package/src/market-data/quotes/session-split.ts +28 -0
  156. package/src/plugins/builtin/account-management/pane.tsx +1 -1
  157. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  158. package/src/plugins/builtin/analytics/index.tsx +10 -3
  159. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  160. package/src/plugins/builtin/analytics/risk-client.ts +4 -1
  161. package/src/plugins/builtin/analytics/risk-episodes.ts +422 -0
  162. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  163. package/src/plugins/builtin/analytics/risk-headless.ts +28 -10
  164. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  165. package/src/plugins/builtin/analytics/risk-model.ts +115 -26
  166. package/src/plugins/builtin/analytics/risk-pane.tsx +201 -23
  167. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  168. package/src/plugins/builtin/backtest/format.ts +14 -0
  169. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  170. package/src/plugins/builtin/backtest/report.ts +5 -3
  171. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  172. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  173. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  174. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  175. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  176. package/src/plugins/builtin/catalysts/model.ts +7 -2
  177. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  178. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  179. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  180. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  181. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  182. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  183. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  184. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  185. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  186. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  187. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  188. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  189. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  190. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  191. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  192. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  193. package/src/plugins/builtin/correlation/index.tsx +39 -167
  194. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  195. package/src/plugins/builtin/correlation/relationship/pane.tsx +6 -7
  196. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  197. package/src/plugins/builtin/cot/client.ts +8 -3
  198. package/src/plugins/builtin/cot/headless.ts +65 -12
  199. package/src/plugins/builtin/cot/pane.tsx +11 -5
  200. package/src/plugins/builtin/earnings/client.ts +40 -6
  201. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  202. package/src/plugins/builtin/earnings/headless.ts +47 -11
  203. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  204. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  205. package/src/plugins/builtin/earnings/history.tsx +23 -8
  206. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  207. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  208. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  209. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  210. package/src/plugins/builtin/econ/index.tsx +5 -4
  211. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  212. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  213. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  214. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  215. package/src/plugins/builtin/futures/index.tsx +32 -10
  216. package/src/plugins/builtin/futures/model.ts +93 -6
  217. package/src/plugins/builtin/futures/returns.ts +29 -7
  218. package/src/plugins/builtin/futures/table.tsx +59 -17
  219. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  220. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  221. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  222. package/src/plugins/builtin/futures-curve/model.ts +111 -15
  223. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  224. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  225. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  226. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  227. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  228. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  229. package/src/plugins/builtin/help/index.tsx +68 -61
  230. package/src/plugins/builtin/holders/format.ts +7 -2
  231. package/src/plugins/builtin/holders/pane.tsx +11 -3
  232. package/src/plugins/builtin/holders/report-header.ts +5 -4
  233. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  234. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  235. package/src/plugins/builtin/insider/signals-model.ts +4 -5
  236. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  237. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  238. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  239. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  240. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -0
  241. package/src/plugins/builtin/perps/headless.ts +73 -17
  242. package/src/plugins/builtin/perps/index.tsx +3 -1
  243. package/src/plugins/builtin/perps/model.ts +1 -1
  244. package/src/plugins/builtin/perps/pane.tsx +2 -0
  245. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  246. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +20 -1
  247. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  248. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +154 -0
  249. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +64 -22
  250. package/src/plugins/builtin/portfolio-list/cli/render.ts +18 -7
  251. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  252. package/src/plugins/builtin/portfolio-list/grid.tsx +56 -12
  253. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  254. package/src/plugins/builtin/portfolio-list/pane/index.tsx +42 -4
  255. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  256. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  257. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  258. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  259. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  260. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  261. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  262. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +118 -4
  263. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  264. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  265. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  266. package/src/plugins/builtin/portfolio-list/table.tsx +105 -6
  267. package/src/plugins/builtin/power/headless.ts +47 -9
  268. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  269. package/src/plugins/builtin/research-search/article.ts +12 -2
  270. package/src/plugins/builtin/research-search/data.ts +5 -2
  271. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  272. package/src/plugins/builtin/research-search/model.ts +47 -3
  273. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  274. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  275. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  276. package/src/plugins/builtin/risk-factors/pane.tsx +5 -3
  277. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  278. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  279. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  280. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  281. package/src/plugins/builtin/sec/forms.ts +19 -0
  282. package/src/plugins/builtin/sec/headless.ts +7 -11
  283. package/src/plugins/builtin/sec/index.tsx +11 -3
  284. package/src/plugins/builtin/shared/earnings-calendar.ts +6 -3
  285. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  286. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  287. package/src/plugins/builtin/shared/use-quote-board.ts +42 -27
  288. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  289. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  290. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  291. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  292. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  293. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  294. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  295. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  296. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  297. package/src/plugins/builtin/ticker-detail/headless-schema.ts +10 -1
  298. package/src/plugins/builtin/ticker-detail/headless.ts +8 -1
  299. package/src/plugins/builtin/ticker-detail/overview/components.tsx +2 -1
  300. package/src/plugins/builtin/ticker-detail/overview/model.ts +4 -2
  301. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +11 -8
  302. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  303. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  304. package/src/plugins/builtin/ticker-detail/settings.ts +4 -3
  305. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  306. package/src/plugins/host-resolver.ts +3 -2
  307. package/src/portfolio/column-values.ts +42 -8
  308. package/src/portfolio/futures-positions.ts +10 -2
  309. package/src/portfolio/mutations.ts +4 -3
  310. package/src/portfolio/period-pnl.ts +119 -0
  311. package/src/portfolio/positions-import/describe.ts +89 -0
  312. package/src/portfolio/positions-import/parse.ts +682 -0
  313. package/src/portfolio/positions-import/plan.ts +295 -0
  314. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  315. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  316. package/src/react/jsx-dev-fallback.ts +62 -0
  317. package/src/renderers/browser/cloud-transport.ts +1 -1
  318. package/src/renderers/browser/config-host.ts +3 -1
  319. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  320. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  321. package/src/renderers/browser/main.tsx +2 -1
  322. package/src/renderers/browser/research-entry.ts +12 -0
  323. package/src/renderers/cloudflare/http-proxy.ts +8 -2
  324. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  325. package/src/renderers/cloudflare/worker.ts +12 -3
  326. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  327. package/src/renderers/dom/desktop/controls.tsx +1 -1
  328. package/src/renderers/dom/desktop/dialog-actions.tsx +10 -24
  329. package/src/renderers/dom/desktop/icons.tsx +4 -2
  330. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  331. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  332. package/src/renderers/dom/host/box.tsx +2 -2
  333. package/src/renderers/dom/host/input.tsx +13 -0
  334. package/src/renderers/dom/key-event.ts +1 -0
  335. package/src/renderers/dom/styles.css +3 -0
  336. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  337. package/src/renderers/electrobun/bun/desktop/backend.ts +1 -0
  338. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  339. package/src/renderers/electrobun/bun/desktop/host-requests.ts +5 -4
  340. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  341. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  342. package/src/renderers/electrobun/bun/desktop/initialization.ts +3 -1
  343. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  344. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  345. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  346. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  347. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  348. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  349. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  350. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  351. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  352. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  353. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  354. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  355. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  356. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  357. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  358. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  359. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  360. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  361. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  362. package/src/renderers/electrobun/view/main.tsx +9 -4
  363. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  364. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  365. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  366. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  367. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  368. package/src/renderers/opentui/browser-open.ts +2 -1
  369. package/src/renderers/opentui/dialog-host.tsx +1 -1
  370. package/src/renderers/opentui/interaction-performance.ts +3 -1
  371. package/src/renderers/opentui/start.tsx +2 -1
  372. package/src/renderers/opentui/terminal-media.ts +11 -6
  373. package/src/renderers/opentui/ui-host.tsx +5 -8
  374. package/src/shares/open.ts +22 -1
  375. package/src/shares/pane.ts +2 -1
  376. package/src/sources/gloomberb-cloud/normalizers.ts +3 -0
  377. package/src/sync/analytics-payload.ts +194 -0
  378. package/src/sync/baseline.ts +19 -9
  379. package/src/sync/broker-identity.ts +171 -0
  380. package/src/sync/broker-instances.ts +137 -0
  381. package/src/sync/collections-contributor.ts +173 -0
  382. package/src/sync/config-contributor.ts +100 -0
  383. package/src/sync/config-merge.ts +229 -0
  384. package/src/sync/controller.ts +139 -28
  385. package/src/sync/core-contributors.ts +8 -1583
  386. package/src/sync/history-memo.ts +32 -0
  387. package/src/sync/layout-merge.ts +259 -0
  388. package/src/sync/sanitize.ts +114 -0
  389. package/src/sync/ticker-merge.ts +208 -0
  390. package/src/sync/ticker-payload.ts +81 -0
  391. package/src/sync/types.ts +15 -1
  392. package/src/telemetry/attention-setting.ts +1 -1
  393. package/src/telemetry/usage-counts.ts +16 -0
  394. package/src/test-support/preload.ts +5 -0
  395. package/src/theme/color-utils.ts +10 -0
  396. package/src/theme/font-scale.ts +34 -3
  397. package/src/theme/series-colors.ts +44 -0
  398. package/src/theme/themes.ts +2 -1
  399. package/src/tickers/batched-lookups.ts +263 -6
  400. package/src/tickers/company-name-listing.ts +44 -2
  401. package/src/tickers/company-name.ts +7 -2
  402. package/src/tickers/search/upsert.ts +16 -1
  403. package/src/time-series/base-series.ts +18 -4
  404. package/src/time-series/studies/indicators.ts +3 -1
  405. package/src/time-series/studies/resolve.ts +1 -1
  406. package/src/time-series/types.ts +6 -0
  407. package/src/types/financials.ts +18 -0
  408. package/src/types/headless.ts +11 -0
  409. package/src/ui/host.tsx +26 -3
  410. package/src/ui/index.tsx +1 -0
  411. package/src/utils/concurrency.ts +6 -0
  412. package/src/utils/currency-pair.ts +56 -4
  413. package/src/utils/datetime-format.ts +11 -0
  414. package/src/utils/decimal-comma.ts +9 -6
  415. package/src/utils/exchanges.ts +32 -0
  416. package/src/utils/fundamentals.ts +41 -0
  417. package/src/utils/markdown.ts +4 -2
  418. package/src/utils/pasted-lines.ts +14 -0
  419. package/src/utils/price-window.ts +2 -1
  420. package/src/utils/sec-filings.ts +17 -0
  421. package/src/utils/sec.ts +4 -23
  422. package/src/utils/shortcut-labels.ts +6 -30
@@ -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,
@@ -4,7 +4,7 @@ import {
4
4
  } from "../../../components/chart/static/series";
5
5
  import { loadPortfolioOptionBook } from "./risk-options";
6
6
  import { resolveChartPalette } from "../../../components/chart/core/palette";
7
- import { useCallback, useMemo, useRef, useState, type RefObject } from "react";
7
+ import { useCallback, useEffect, useMemo, useRef, useState, type RefObject } from "react";
8
8
  import { Box, ScrollBox, useRendererHost, type ScrollBoxRenderable } from "../../../ui";
9
9
  import {
10
10
  chartTableChromeRows,
@@ -45,6 +45,7 @@ import type { PaneProps } from "../../../types/plugin";
45
45
  import { isAccessDenied } from "../../../api-client/errors";
46
46
  import { useResearchCloudSession } from "../shared/research-cloud-session";
47
47
  import { loadPortfolioRiskMarket } from "./risk-client";
48
+ import { loadRiskEpisodeHistory, riskEpisodeTargets, type RiskEpisodeState, type RiskEpisodeTarget } from "./risk-episodes";
48
49
  import { brokerPerformanceEvidence, parsePortfolioRiskEvidence } from "./risk-evidence";
49
50
  import { useBrokerPortfolioPerformance } from "./broker-performance";
50
51
  import { parseAssetShifts, parseFxShifts, riskCashLines } from "./risk-book";
@@ -74,6 +75,11 @@ import {
74
75
  resolvePortfolioId,
75
76
  resolveTemplatePortfolioId,
76
77
  } from "./portfolio-selection";
78
+ import { startBrokerAdd } from "../broker-manager/add-request";
79
+ import { CorrelationMatrixGrid, correlationMatrixFits, useCorrelationMatrixNavigation } from "../correlation/matrix/grid";
80
+ import { usePluginTickerActions } from "../../runtime";
81
+ import { TICKER_RESEARCH_PANE_ID } from "../../../types/config";
82
+ import { formatTickerListInput } from "../../../tickers/list";
77
83
 
78
84
  const titles = {
79
85
  risk: "Risk",
@@ -103,6 +109,34 @@ const LABEL_HEADERS: Record<RiskView, string> = {
103
109
  greeks: "Metric",
104
110
  };
105
111
  const EVIDENCE_VIEWS: ReadonlySet<RiskView> = new Set(["performance", "attribution", "greeks"]);
112
+ /**
113
+ * What an empty Performance, Attribution or Greeks view is missing, in plain
114
+ * words, and whether connecting a broker would bring it: a broker that reports
115
+ * account history supplies Performance, and a broker's option positions
116
+ * supply Greeks. No broker reports Attribution's sector book, so that view
117
+ * offers the import alone.
118
+ */
119
+ function evidenceNeed(
120
+ view: RiskView,
121
+ { brokerLinked, unvaluedOptions }: { brokerLinked: boolean; unvaluedOptions: boolean },
122
+ ): { title: string; message?: string; broker: boolean } {
123
+ if (view === "performance") {
124
+ const title = "Performance needs this account's daily values and the money paid in and out.";
125
+ return brokerLinked
126
+ ? { title, message: "Its broker does not report them; import them as evidence JSON instead.", broker: false }
127
+ : { title, message: "A connected broker that reports account history provides both.", broker: true };
128
+ }
129
+ if (view === "attribution")
130
+ return {
131
+ title: "Attribution needs sector weights and returns for this account and its benchmark.",
132
+ message: "No broker reports them; import them as evidence JSON.",
133
+ broker: false,
134
+ };
135
+ if (unvaluedOptions) return { title: "No option position in this portfolio could be valued.", broker: false };
136
+ return brokerLinked
137
+ ? { title: "No option positions in this portfolio.", broker: false }
138
+ : { title: "No option positions in this portfolio.", message: "A connected broker syncs option positions with the rest of the account.", broker: true };
139
+ }
106
140
  /** The risk view's tail rows, whose method the footer names. */
107
141
  const TAIL_ROW_IDS: ReadonlySet<string> = new Set(["var", "es"]);
108
142
  /** The views that read the basket's daily closes, and say to when; Holdings reads current marks. */
@@ -120,17 +154,25 @@ function sharedWordUnit(rows: RiskDisplayRow[]): string | null {
120
154
  }
121
155
  const bareValue = (row: RiskDisplayRow) => row.value == null ? "--" : row.value.toFixed(2);
122
156
  const HOLDINGS_SUMMARY_LABELS: Record<string, string> = { top: "Largest", "top-five": "Top five" };
157
+ const CASH_ASIDE = ", cash aside";
123
158
  /** The book concentration figures that lead the holdings view, as a summary band. */
124
159
  function holdingsSummaryItems(rows: RiskDisplayRow[]): StatItem[] {
160
+ // Every figure leaves the cash aside; the first one that says so says it for the band.
161
+ let cashSaid = false;
125
162
  return rows.map((row) => {
126
163
  // A snapshot saved before the shares named their base reads "% value".
127
164
  const share = row.unit === HOLDINGS_SHARE_UNIT || row.unit === "% value";
165
+ // The shares name what they divide.
166
+ let detail = share ? (row.unit === HOLDINGS_SHARE_UNIT ? `of holdings${CASH_ASIDE}` : "of market value") : row.detail;
167
+ if (detail.endsWith(CASH_ASIDE)) {
168
+ if (cashSaid) detail = detail.slice(0, -CASH_ASIDE.length);
169
+ cashSaid = true;
170
+ }
128
171
  return {
129
172
  id: row.id,
130
173
  label: HOLDINGS_SUMMARY_LABELS[row.id] ?? row.label,
131
174
  value: row.value == null ? "--" : share ? `${row.value.toFixed(2)}%` : row.value.toFixed(2),
132
- // The same note sits on both shares: what they divide.
133
- detail: share ? (row.unit === HOLDINGS_SHARE_UNIT ? "of holdings, cash aside" : "of market value") : row.detail,
175
+ detail,
134
176
  };
135
177
  });
136
178
  }
@@ -171,6 +213,47 @@ function rowHistorySeries(row: RiskDisplayRow): ChartTableChart["series"] | null
171
213
  { id: row.id, label: row.label, color: colors.positive },
172
214
  )];
173
215
  }
216
+ /**
217
+ * The basket's members, largest weight first, and each pair's correlation by
218
+ * symbol, for the heat matrix. Null when two members share a symbol (two
219
+ * listings of one name), which only the list of pairs tells apart.
220
+ */
221
+ function basketCorrelationMatrix(model: PortfolioRiskModel): {
222
+ symbols: string[];
223
+ correlation: (row: string, column: string) => number | null;
224
+ } | null {
225
+ const members = model.holdings.filter((row) => row.weight != null).sort((left, right) => right.weight! - left.weight!);
226
+ const symbols = members.map((row) => row.symbol);
227
+ if (new Set(symbols).size !== symbols.length) return null;
228
+ const ids = new Map(members.map((row) => [row.symbol, row.id]));
229
+ const pairs = new Map<string, number | null>();
230
+ for (const row of model.correlation) {
231
+ pairs.set(`${row.left}\u0000${row.right}`, row.value);
232
+ pairs.set(`${row.right}\u0000${row.left}`, row.value);
233
+ }
234
+ return {
235
+ symbols,
236
+ correlation: (row, column) => row === column ? 1 : pairs.get(`${ids.get(row)}\u0000${ids.get(column)}`) ?? null,
237
+ };
238
+ }
239
+ /**
240
+ * An evidence view with nothing in it: what it needs, the broker route where a
241
+ * broker brings it, then the import. A saved snapshot says only what it
242
+ * lacked: nothing can be added to it.
243
+ */
244
+ function EvidenceEmptyState({ need, onImport }: { need: ReturnType<typeof evidenceNeed>; onImport: (() => void) | null }) {
245
+ return (
246
+ <PaneStatusBody
247
+ empty
248
+ emptyTitle={need.title}
249
+ emptyMessage={onImport ? need.message : undefined}
250
+ actions={onImport ? <>
251
+ {need.broker ? <Button label="Add Broker Account" compact onPress={startBrokerAdd} /> : null}
252
+ <Button label="Import evidence" variant="secondary" compact onPress={onImport} />
253
+ </> : undefined}
254
+ />
255
+ );
256
+ }
174
257
  // No column: rows keep the model order (return, risk, tail), which reads better than A-Z.
175
258
  const DEFAULT_SORT = { column: "", direction: "asc" as const };
176
259
  const EMPTY_MODEL: PortfolioRiskModel | null = null;
@@ -236,7 +319,7 @@ function RiskDetail({
236
319
  export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
237
320
  const instance = usePaneInstance(),
238
321
  renderer = useRendererHost();
239
- const { showPane } = usePluginAppActions();
322
+ const { showPane, createPaneFromTemplate } = usePluginAppActions();
240
323
  const portfolios = useAppSelector((state) => state.config.portfolios),
241
324
  tickers = useAppSelector((state) => state.tickers),
242
325
  brokerAccounts = useAppSelector((state) => state.brokerAccounts);
@@ -353,17 +436,41 @@ export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
353
436
  clearOnError: isAccessDenied,
354
437
  });
355
438
  useAutoRefresh(resource.updatedAt, resource.load);
439
+ // The Stress view's episodes read years-old closes of each holding, so they
440
+ // load only there, once the market load says which holdings the basket takes.
441
+ const episodeTargetsKey = useMemo(() => {
442
+ if (frozen || view !== "stress" || !resource.data) return null;
443
+ const held = localTickers.map((ticker) => ({ symbol: ticker.metadata.ticker, exchange: ticker.metadata.exchange }));
444
+ const targets = riskEpisodeTargets(resource.data, held);
445
+ return targets.length ? JSON.stringify(targets) : null;
446
+ }, [frozen, localTickers, resource.data, view]);
447
+ const episodeLoader = useMemo(
448
+ () => (episodeTargetsKey && portfolio
449
+ ? () => loadRiskEpisodeHistory(JSON.parse(episodeTargetsKey) as RiskEpisodeTarget[], portfolio.currency)
450
+ : null),
451
+ [episodeTargetsKey, portfolio?.currency, session.requestKey],
452
+ );
453
+ const episodeResource = useAsyncResource(episodeLoader, { clearOnError: isAccessDenied, keepPreviousData: true });
454
+ // A reload reads the kept closes again and asks only for those that failed
455
+ // (a rate limit on a large book), so it follows the market data's cadence.
456
+ useAutoRefresh(episodeResource.updatedAt, episodeResource.load);
457
+ const episodeState = useMemo<RiskEpisodeState | undefined>(
458
+ () => (!episodeLoader ? undefined : episodeResource.data ?? { pending: true, error: episodeResource.error }),
459
+ [episodeLoader, episodeResource.data, episodeResource.error],
460
+ );
356
461
  const derived = useMemo(() => {
357
462
  if (frozen) return { model: frozen, error: null };
358
463
  if (!portfolio || (!resource.data && !evidenceText.trim() && !brokerEvidence))
359
464
  return { model: null, error: null };
360
- const market = resource.data ?? {
361
- histories: [],
362
- yields: null,
363
- volatility: null,
364
- warnings: [],
365
- fetchedAt: new Date().toISOString(),
366
- };
465
+ const market = resource.data
466
+ ? { ...resource.data, ...(episodeState ? { episodes: episodeState } : {}) }
467
+ : {
468
+ histories: [],
469
+ yields: null,
470
+ volatility: null,
471
+ warnings: [],
472
+ fetchedAt: new Date().toISOString(),
473
+ };
367
474
  try {
368
475
  return {
369
476
  model: buildPortfolioRisk(
@@ -394,6 +501,7 @@ export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
394
501
  portfolio,
395
502
  localTickers,
396
503
  resource.data,
504
+ episodeState,
397
505
  evidenceText,
398
506
  brokerEvidence,
399
507
  equity,
@@ -447,6 +555,9 @@ export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
447
555
  [basketBody, stressShortfall, model, view, sort],
448
556
  );
449
557
  const openRow = rows.find((row) => row.id === open);
558
+ const evidenceMissing = EVIDENCE_VIEWS.has(view) && rows.length === 0;
559
+ // A broker linked to the portfolio may still be sending its account history.
560
+ const evidenceLoading = evidenceMissing && view === "performance" && brokerPerformance.loading;
450
561
  const detailScrollRef = useRef<ScrollBoxRenderable | null>(null);
451
562
  // Columns that say the same thing on every row belong in the footer, not repeated per row.
452
563
  const showPercentile = rows.some((row) => row.percentile != null);
@@ -528,7 +639,7 @@ export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
528
639
  const coverageText = !model || !BASKET_VIEWS.has(view) || basketBody
529
640
  ? null
530
641
  : stressShortfall
531
- ? `Index, 10Y and VIX scenarios: ${stressShortfall.title.replace(/\.$/, "").replace(/^[A-Z](?=[a-z])/, (letter) => letter.toLowerCase())}`
642
+ ? `Index, 10Y, VIX and episode scenarios: ${stressShortfall.title.replace(/\.$/, "").replace(/^[A-Z](?=[a-z])/, (letter) => letter.toLowerCase())}`
532
643
  : riskCoverageLine(model.coverage);
533
644
  const asOfDate = (stressShortfall ? rows : model?.rows[view])?.find((row) => row.asOf)?.asOf?.slice(0, 10) ?? null;
534
645
  // The views estimated from returns name the currency a non-USD account's returns were converted into.
@@ -541,7 +652,8 @@ export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
541
652
  ...(coverageText ? [coverageText] : []),
542
653
  ...(asOfDate && footerEvidence ? [footerEvidence] : []),
543
654
  // The coverage names the currency of its basket value; a non-USD account's returns say what they converted into.
544
- ...(returnsCurrency ? [returnsCurrency] : coverageText ? [] : [model.portfolio.currency]),
655
+ // An evidence view with nothing in it has no amounts for a currency to describe.
656
+ ...(returnsCurrency ? [returnsCurrency] : coverageText || evidenceMissing ? [] : [model.portfolio.currency]),
545
657
  ...(EVIDENCE_VIEWS.has(view) && model.evidence ? [model.evidence.source] : []),
546
658
  ]),
547
659
  ].join(" · ") || null;
@@ -560,7 +672,7 @@ export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
560
672
  "portfolio-risk",
561
673
  () => ({
562
674
  info: [
563
- ...(resource.loading
675
+ ...(resource.loading || (view === "stress" && episodeResource.loading)
564
676
  ? [
565
677
  {
566
678
  id: "loading",
@@ -589,7 +701,7 @@ export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
589
701
  ],
590
702
  hints,
591
703
  }),
592
- [resource.loading, asOfText, sourceText, actionStatus, hints],
704
+ [resource.loading, view, episodeResource.loading, asOfText, sourceText, actionStatus, hints],
593
705
  );
594
706
  useShortcut(
595
707
  (event) => {
@@ -607,7 +719,11 @@ export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
607
719
  event.preventDefault();
608
720
  event.stopPropagation();
609
721
  hint.onPress();
610
- } else if (event.name === "r" && !frozen) void resource.reload();
722
+ } else if (event.name === "r" && !frozen) {
723
+ void resource.reload();
724
+ // The episodes too: a read that failed is asked again.
725
+ if (view === "stress") void episodeResource.reload();
726
+ }
611
727
  },
612
728
  { enabled: focused, scope: "portfolio-risk", phase: "before" },
613
729
  );
@@ -706,7 +822,31 @@ export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
706
822
  compact: true,
707
823
  } : null);
708
824
  const rootHeight = Math.max(3, height - tabRows);
709
- const evidenceMissing = EVIDENCE_VIEWS.has(view) && rows.length === 0;
825
+ // Correlation shows the heat matrix CORR draws while every holding fits the
826
+ // pane under the portfolio bar; a larger basket lists its pairs, strongest first.
827
+ const basketMatrix = useMemo(
828
+ () => (view === "correlation" && model && !basketBody ? basketCorrelationMatrix(model) : null),
829
+ [basketBody, model, view],
830
+ );
831
+ const matrixShown = !!basketMatrix && correlationMatrixFits(basketMatrix.symbols, width, rootHeight - 1);
832
+ // The matrix has no row detail: a pair opened from the list closes once the matrix takes its place.
833
+ useEffect(() => {
834
+ if (matrixShown && open) setOpen(null);
835
+ }, [matrixShown, open, setOpen]);
836
+ const matrixSymbols = matrixShown ? basketMatrix!.symbols : [];
837
+ const { pinTicker, navigateTicker } = usePluginTickerActions();
838
+ const openMatrixSymbol = useCallback((symbol: string) => {
839
+ if (tickers.has(symbol)) pinTicker(symbol, { floating: true, paneType: TICKER_RESEARCH_PANE_ID });
840
+ else navigateTicker(symbol);
841
+ }, [navigateTicker, pinTicker, tickers]);
842
+ // CORR's cursor, hover and keys; a pair opens in GR, as it does from CORR.
843
+ const matrixNavigation = useCorrelationMatrixNavigation({
844
+ symbols: matrixSymbols,
845
+ focused: focused && matrixShown,
846
+ scope: "portfolio-risk:matrix",
847
+ onOpenPair: (pair) => createPaneFromTemplate("relationship-graph-pane", { symbols: pair, arg: formatTickerListInput(pair) }),
848
+ onOpenSymbol: openMatrixSymbol,
849
+ });
710
850
  if (!portfolio)
711
851
  return (
712
852
  <EmptyState
@@ -726,6 +866,37 @@ export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
726
866
  />
727
867
  </Box>
728
868
  );
869
+ if (matrixShown)
870
+ return (
871
+ <Box width={width} height={height} flexDirection="column">
872
+ {tabStrip}
873
+ <Box width={width} height={rootHeight} flexDirection="column" overflow="hidden">
874
+ <QueryBar
875
+ width={width}
876
+ filters={[{
877
+ id: "portfolio",
878
+ label: "Portfolio",
879
+ value: portfolio.id,
880
+ options: portfolios.length
881
+ ? portfolios.map((row) => ({ value: row.id, label: row.name }))
882
+ : [{ value: portfolio.id, label: portfolio.name }],
883
+ onChange: (id: string) => {
884
+ setPortfolio(id);
885
+ setOpen(null);
886
+ },
887
+ }]}
888
+ />
889
+ <CorrelationMatrixGrid
890
+ symbols={matrixSymbols}
891
+ width={width}
892
+ height={rootHeight - 1}
893
+ correlation={basketMatrix!.correlation}
894
+ {...matrixNavigation.grid}
895
+ onOpenSymbol={openMatrixSymbol}
896
+ />
897
+ </Box>
898
+ </Box>
899
+ );
729
900
  return (
730
901
  <Box width={width} height={height} flexDirection="column">
731
902
  {tabStrip}
@@ -782,7 +953,9 @@ export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
782
953
  })
783
954
  }
784
955
  renderCell={(row, column) => {
785
- if (column.id === "label") return { text: row.label };
956
+ // Without the evidence column an episode says beside its label how much of it is proxied.
957
+ if (column.id === "label")
958
+ return { text: row.marker && !columns.some((entry) => entry.id === "detail") ? `${row.label} (${row.marker})` : row.label };
786
959
  if (column.id === "value")
787
960
  return row.leftOut
788
961
  ? { text: "left out", value: null, color: colors.textMuted }
@@ -823,12 +996,17 @@ export function PortfolioRiskPane({ focused, width, height }: PaneProps) {
823
996
  emptyMessage={basketBody.message || undefined}
824
997
  actions={basketBody.noHoldings ? <Button label="Open Portfolio" compact onPress={() => showPane("portfolio-list")} /> : undefined}
825
998
  />
999
+ ) : evidenceLoading ? (
1000
+ <PaneStatusBody loading loadingLabel="Loading account history" />
826
1001
  ) : evidenceMissing ? (
827
- <PaneStatusBody
828
- empty
829
- emptyTitle="This view needs dated local evidence."
830
- emptyMessage={frozen ? undefined : "Copy version 1 evidence JSON, then import it from the clipboard."}
831
- actions={frozen ? undefined : <Button label="Import evidence" compact onPress={() => void importEvidence()} />}
1002
+ <EvidenceEmptyState
1003
+ // Each view's own state, so Enter starts on its first action.
1004
+ key={view}
1005
+ need={evidenceNeed(view, {
1006
+ brokerLinked: !!portfolio.brokerInstanceId,
1007
+ unvaluedOptions: (model.greeks?.warnings.length ?? 0) > 0,
1008
+ })}
1009
+ onImport={frozen ? null : () => void importEvidence()}
832
1010
  />
833
1011
  ) : undefined
834
1012
  }
@@ -1,7 +1,7 @@
1
1
  import type { PricePoint } from "../../../types/financials";
2
2
  import { canonicalExchange, resolveExchangeTimeZone } from "../../../utils/exchanges";
3
3
  import { getPricePointTimestamp } from "../../../utils/price-history";
4
- import type { DatedReturn } from "./metrics";
4
+ import type { DatedReturn } from "../../../portfolio/return-metrics";
5
5
  import { getPublishedUsEquityCalendarDay, getPublishedUsEquityCalendarYears, getPublishedUsEquitySession, PUBLISHED_US_EQUITY_SESSION_BASIS } from "../../../market-data/published-us-sessions";
6
6
 
7
7
  const DAY_MS = 86_400_000;
@@ -1,4 +1,5 @@
1
1
  import type { BacktestResult } from "./engine";
2
+ import { currencyPairCode, fxRateDigits } from "../../../utils/currency-pair";
2
3
 
3
4
  export type StatValue = { value: number | null; kind: "signed" | "percent" | "ratio" | "count" };
4
5
  export interface SummaryRow {
@@ -50,3 +51,16 @@ export function formatStat(stat: StatValue | null): string {
50
51
  if (kind === "percent") return `${value.toFixed(1)}%`;
51
52
  return `${value > 0 ? "+" : ""}${value.toFixed(1)}%`;
52
53
  }
54
+
55
+ /**
56
+ * A trade's price at its instrument's precision, as the pane and `fn BT`
57
+ * print it: a currency pair's (EURUSD=X 1.12625, USDJPY=X 157.848), any
58
+ * other price to the cent, or to four significant digits below one unit.
59
+ * `--` for a trade still open.
60
+ */
61
+ export function formatTradePrice(value: number | null | undefined, symbol: string): string {
62
+ if (value == null || !Number.isFinite(value)) return "--";
63
+ const pair = currencyPairCode(symbol);
64
+ if (pair) return value.toFixed(fxRateDigits(pair.slice(3), value));
65
+ return Math.abs(value) >= 1 ? value.toFixed(2) : value.toPrecision(4);
66
+ }