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
@@ -50,6 +50,8 @@ import { importedFromText } from "./imported-from";
50
50
  import { describeCollections } from "../../../portfolio/collection-name";
51
51
  import { currentListingName } from "../../../tickers/listing-name";
52
52
  import { REPORT_ROWS } from "../shared/headless-options";
53
+ import { readPriceWindow, type PriceWindow } from "../../../utils/price-window";
54
+ import { loadPeriodPnl, periodBasisText, periodBoughtText, periodUnpricedText } from "./period-pnl";
53
55
 
54
56
  const DEFAULT_ROW_LIMIT = 50;
55
57
  const MAX_ROW_LIMIT = 200;
@@ -459,6 +461,107 @@ async function portfolioHoldings(
459
461
  };
460
462
  }
461
463
 
464
+ /** `fn PF --from`: a position's P&L between two closes and its share of the book, then the FX line and the total. */
465
+ const PERIOD_COLUMNS: HeadlessPaneColumn[] = [
466
+ { key: "symbol", header: "Ticker" },
467
+ { key: "shares", header: "Qty", align: "right", format: quantity },
468
+ { key: "startPrice", header: "Start", align: "right", format: unitMoney("priceCurrency"), description: "The close before the window, in the quote's currency." },
469
+ { key: "endPrice", header: "End", align: "right", format: unitMoney("priceCurrency"), description: "The last close in the window, in the quote's currency." },
470
+ { key: "changePercent", header: "Chg", align: "right", format: percent },
471
+ { key: "pnl", header: "P&L", align: "right", format: amount, description: "The price move times the units held now, in the portfolio's currency at the end's rate." },
472
+ { key: "contribution", header: "Contribution", align: "right", format: percent, description: "P&L over the book's value at the start, gross when it holds a short, in percent." },
473
+ ];
474
+
475
+ /**
476
+ * PF over a period (`--from`, `--to`): P&L and contribution by position
477
+ * between two closes, as `portfolio show --from` reads them, on the
478
+ * holdings held now, largest at the start first; the FX line and the total
479
+ * cover every position, whatever the limit.
480
+ */
481
+ async function portfolioPeriodHoldings(
482
+ target: Extract<CollectionMatch, { kind: "portfolio" }>,
483
+ limit: number,
484
+ ctx: HeadlessPaneContext,
485
+ window: PriceWindow,
486
+ ): Promise<HeadlessRowsResult> {
487
+ const resolved = await ctx.resolvePortfolio?.(target.id);
488
+ if (!resolved) throw new Error(`Holdings for ${target.id} are not available here.`);
489
+ const tickers = [...resolved.tickers].sort(bySymbol);
490
+ const currency = resolvePortfolioTotalsCurrency(target.portfolio, ctx.config.baseCurrency);
491
+ const futuresHeld = tickers.filter((ticker) => isFuturesTicker(ticker)
492
+ && ticker.metadata.positions.some((position) => position.portfolio === target.id && position.shares !== 0));
493
+ const [quotes, futures] = await Promise.all([
494
+ loadCollectionQuotes(tickers, target, ctx.marketData),
495
+ loadPortfolioFuturesTerms(futuresHeld, { settlement: true, sources: { history: dailyFuturesHistory(ctx.marketData) } }),
496
+ ]);
497
+ ctx.signal.throwIfAborted();
498
+ const result = await loadPeriodPnl({ tickers, portfolioId: target.id, currency, window, provider: ctx.marketData, fxHistory: ctx.apiClient, quotes, futures });
499
+ ctx.signal.throwIfAborted();
500
+ const bySymbolTicker = new Map(tickers.map((ticker) => [ticker.metadata.ticker, ticker]));
501
+ // Largest at the start first, as PF lists its positions; a holding without a start close after them.
502
+ const ordered = [...result.rows].sort((a, b) => Math.abs(b.startValue ?? -1) - Math.abs(a.startValue ?? -1) || a.symbol.localeCompare(b.symbol));
503
+ const rows: HeadlessPaneRow[] = ordered.slice(0, limit).map((row) => {
504
+ const ticker = bySymbolTicker.get(row.symbol);
505
+ const shares = ticker?.metadata.positions.filter((position) => position.portfolio === target.id).reduce((sum, position) => sum + position.shares, 0) ?? null;
506
+ return {
507
+ symbol: row.symbol,
508
+ exchange: ticker?.metadata.exchange || null,
509
+ assetCategory: ticker?.metadata.assetCategory ?? null,
510
+ shares,
511
+ ...(ticker && isFuturesTicker(ticker) ? { contractSize: futures.get(row.symbol)?.size?.size ?? null } : {}),
512
+ priceCurrency: row.currency,
513
+ startDay: row.start?.day ?? null,
514
+ startPrice: row.start?.price ?? null,
515
+ endDay: row.end?.day ?? null,
516
+ endPrice: row.end?.price ?? null,
517
+ changePercent: row.changePercent,
518
+ pnl: row.pnl,
519
+ fx: row.fx,
520
+ contribution: row.contribution,
521
+ };
522
+ });
523
+ const fxCurrencies = [...new Set(result.rows.flatMap((row) => row.rates ? [row.rates.currency] : []))];
524
+ if (fxCurrencies.length) rows.push({ symbol: `FX (${fxCurrencies.join(", ")})`, pnl: result.fx, contribution: result.fxContribution });
525
+ rows.push({ symbol: "TOTAL", pnl: result.total, contribution: result.totalContribution });
526
+ const futuresHeldNow = result.rows.some((row) => { const ticker = bySymbolTicker.get(row.symbol); return !!ticker && isFuturesTicker(ticker); });
527
+ const bought = periodBoughtText(result);
528
+ const notices = [
529
+ `${periodBasisText(result, { futuresHeld: futuresHeldNow })}, in ${currency}.`,
530
+ ...(result.contributionBase == null ? [] : [`Contribution is P&L over the book's ${result.contributionBasis === "gross" ? "gross exposure" : "value"} at the start, longs plus shorts at their absolute value when it holds a short; cash excluded.`]),
531
+ ...(bought ? [bought] : []),
532
+ ...(ordered.length > limit ? [`${ordered.length - limit} more position${ordered.length - limit === 1 ? "" : "s"} not shown; the FX line and the total include every position.`] : []),
533
+ ];
534
+ const unpricedText = periodUnpricedText(result);
535
+ const errors = unpricedText ? [unpricedText] : [];
536
+ return {
537
+ freshness: {
538
+ source: resolved.portfolio.brokerId || resolved.portfolio.brokerInstanceId ? "Your broker account and Gloom Cloud" : "Local portfolio and Gloom Cloud",
539
+ observedKey: "endDay",
540
+ status: "not-a-feed",
541
+ basis: `daily closes, ${window.from} to ${window.to}`,
542
+ },
543
+ columns: withListingLabels(PERIOD_COLUMNS, tickers),
544
+ rows,
545
+ complete: errors.length === 0,
546
+ ...(errors.length ? { errors } : {}),
547
+ metadata: {
548
+ collection: { kind: "portfolio", id: target.id, name: target.name },
549
+ currency,
550
+ from: window.from,
551
+ to: window.to,
552
+ fx: result.fx,
553
+ total: result.total,
554
+ totalContribution: result.totalContribution,
555
+ contributionBase: result.contributionBase,
556
+ contributionBasis: result.contributionBasis,
557
+ notices,
558
+ boughtInWindowSymbols: result.boughtInWindow,
559
+ // The whole reading, as the PF pane draws it over the same period (a capture's).
560
+ periodPnl: result,
561
+ },
562
+ };
563
+ }
564
+
462
565
  async function watchlistHoldings(
463
566
  target: Extract<CollectionMatch, { kind: "watchlist" }>,
464
567
  limit: number,
@@ -539,12 +642,37 @@ export const collectionHoldingsHeadless: HeadlessPaneDefinition<"rows"> = {
539
642
  settingKey: "valueAtClose",
540
643
  description: "Value the portfolio at the regular close, not the latest print: Value is Last times the shares.",
541
644
  },
645
+ {
646
+ key: "from",
647
+ type: "string",
648
+ defaultValue: "",
649
+ placeholder: "date",
650
+ settingKey: "pnlFrom",
651
+ example: "--from 2026-10-26 --to 2026-10-30",
652
+ description: "P&L and contribution by position from the close before this date, as portfolio show --from reads them, instead of P&L since cost.",
653
+ },
654
+ {
655
+ key: "to",
656
+ type: "string",
657
+ defaultValue: "",
658
+ placeholder: "date",
659
+ settingKey: "pnlTo",
660
+ description: "The period's last day, with from; the latest close when left out.",
661
+ },
542
662
  ],
543
663
  columns: POSITION_COLUMNS,
544
664
  describe: (args) => (args.rawArgument ? `Holdings | ${args.rawArgument}` : "Holdings"),
545
665
  async load(args, ctx) {
546
666
  const target = resolveTarget(args.rawArgument, ctx);
547
667
  const limit = rowLimit(args.options.limit);
668
+ const from = typeof args.options.from === "string" && args.options.from.trim() ? args.options.from.trim() : undefined;
669
+ const to = typeof args.options.to === "string" && args.options.to.trim() ? args.options.to.trim() : undefined;
670
+ const window = readPriceWindow(from, to);
671
+ if (window) {
672
+ if (target.kind !== "portfolio") throw new Error("--from reads a portfolio's P&L between two closes; a watchlist holds no positions.");
673
+ if (args.options.close === true) throw new Error("--from values each position at its closes already; leave out --close.");
674
+ return portfolioPeriodHoldings(target, limit, ctx, window);
675
+ }
548
676
  return target.kind === "portfolio"
549
677
  ? portfolioHoldings(target, limit, ctx, args.options.close === true ? "regular-close" : "latest-print")
550
678
  : watchlistHoldings(target, limit, ctx);
@@ -13,10 +13,10 @@ import {
13
13
  type TickerListVisibleRange,
14
14
  } from "../../../../components";
15
15
  import { useTickerSourceActivate } from "../../../../react/ticker-source";
16
- import { useFxRatesMap, useTickerFinancialsMap } from "../../../../market-data/hooks";
16
+ import { useAnsweredSnapshots, useFxRatesMap, useTickerFinancialsMap } from "../../../../market-data/hooks";
17
17
  import { buildPortfolioFinancialsMap } from "../../../../market-data/portfolio-financials";
18
18
  import { useAppActive, useAppVisible, usePaneVisible } from "../../../../state/app/activity";
19
- import { tf } from "../../../../i18n";
19
+ import { t, tf } from "../../../../i18n";
20
20
  import { useDialog } from "../../../../ui/dialog";
21
21
  import {
22
22
  useAppDispatch,
@@ -82,6 +82,7 @@ import {
82
82
  tickerRemovalSummary,
83
83
  } from "./remove-ticker";
84
84
  import { QUICK_ADD_KEY, QuickAddTickerInput, type QuickAddCollectionKind } from "../quick-add";
85
+ import { usePositionsImport } from "../positions-import";
85
86
  import { delistingLabel } from "../../../../market-data/quotes/delisting";
86
87
  import {
87
88
  buildTrackedCurrencies,
@@ -109,6 +110,8 @@ import { withPurchaseDateCostFx } from "../../../../portfolio/cost-fx";
109
110
  import { usePortfolioFuturesTerms } from "./futures-terms";
110
111
  import { useFuturesFrontNotes } from "./futures-front";
111
112
  import { usePurchaseDateCostFx } from "./purchase-date-fx";
113
+ import { periodFxLine, periodPnlLabel, periodPnlNotices, usePanePeriodPnl } from "./period-pnl";
114
+ import type { LoadedPeriodPnl } from "../period-pnl";
112
115
  import {
113
116
  allocationWeightBase,
114
117
  buildPortfolioAllocation,
@@ -201,10 +204,26 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
201
204
  portfolioId: isPortfolioTab ? activeCollectionId : undefined,
202
205
  }), [activeCollectionId, isPortfolioTab]);
203
206
  const marketFinancialsMap = useTickerFinancialsMap(tickers, financialsInstrumentOptions);
207
+ // Until a row's snapshot answers, a dash in its company columns may still fill in: PF hides none yet.
208
+ const answeredSnapshots = useAnsweredSnapshots(tickers, financialsInstrumentOptions);
204
209
  const financialsMap = useMemo(
205
210
  () => buildPortfolioFinancialsMap(tickers, cachedFinancials, marketFinancialsMap, financialsInstrumentOptions),
206
211
  [tickers, cachedFinancials, marketFinancialsMap, financialsInstrumentOptions],
207
212
  );
213
+ // P&L between two closes (the pane's P&L From), as portfolio show --from reads it; since cost without one.
214
+ const periodPnl = usePanePeriodPnl({
215
+ from: paneSettings.pnlFrom,
216
+ to: paneSettings.pnlTo,
217
+ enabled: isPortfolioTab,
218
+ portfolioId: activeCollectionId,
219
+ tickers: collectionTickers,
220
+ currency: totalsCurrency,
221
+ futures: futuresTerms.terms,
222
+ futuresVersion: futuresTerms.version,
223
+ financialsMap,
224
+ snapshot: (paneInstance?.settings?.periodPnlSnapshot ?? null) as LoadedPeriodPnl | null,
225
+ });
226
+ const periodColumns = periodPnl?.window ? periodPnl : null;
208
227
  const valueFlashingEnabled = useAppSelector((state) => state.config.valueFlashingEnabled);
209
228
  const flashSymbols = useQuoteFlashMap(financialsMap, valueFlashingEnabled);
210
229
 
@@ -312,11 +331,13 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
312
331
  perpetualsVersion: perpetuals.version,
313
332
  futuresTerms: futuresTerms.terms,
314
333
  futuresTermsVersion: futuresTerms.version,
334
+ ...(periodColumns ? { periodPnl: { rows: periodColumns.rows, pending: periodColumns.pending, fx: periodFxLine(periodColumns.result) }, periodPnlVersion: periodColumns.version } : {}),
315
335
  }), [
316
336
  activeCollectionId,
317
337
  exchangeRates,
318
338
  futuresTerms,
319
339
  isPortfolioTab,
340
+ periodColumns,
320
341
  perpetuals,
321
342
  portfolioTargets,
322
343
  portfolioWeightBase,
@@ -426,7 +447,12 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
426
447
  manualCash,
427
448
  brokerPortfolio,
428
449
  valuationBasis,
429
- }), [brokerPortfolio, config.baseCurrency, convertAccountValue, isPortfolioTab, manualCash, portfolioSummaryTotals, summaryAccountState, totalsCurrency, valuationBasis]);
450
+ period: periodColumns ? {
451
+ label: periodPnlLabel(periodColumns),
452
+ total: periodColumns.result?.total ?? null,
453
+ contribution: periodColumns.result?.totalContribution ?? null,
454
+ } : null,
455
+ }), [brokerPortfolio, config.baseCurrency, convertAccountValue, isPortfolioTab, manualCash, periodColumns, portfolioSummaryTotals, summaryAccountState, totalsCurrency, valuationBasis]);
430
456
  // The header row sits in the pane's one-cell side padding, like the table.
431
457
  const summaryWidth = Math.max(0, width - 2);
432
458
  const summaryLayout = useMemo(() => layoutPortfolioSummaryHeader(summarySegments, summaryWidth, {
@@ -664,6 +690,15 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
664
690
  }
665
691
  }, [appStateRef, dialog, dispatch, notify, removalCollection, selectedTicker, setCursorSymbol]);
666
692
 
693
+ // A broker's positions export, previewed and then saved to a portfolio; the new one is shown.
694
+ const positionsImport = usePositionsImport({
695
+ activePortfolio: currentPortfolio,
696
+ onImported: setCurrentCollectionId,
697
+ });
698
+ usePaneMenuItems("portfolio-list-import", () => [
699
+ { id: "import-positions", label: t("Import Positions…"), onSelect: positionsImport.start },
700
+ ], [positionsImport.start]);
701
+
667
702
  // The cursor row's perpetual, for the keyboard: the pane menu opens what clicking its cell opens. A row that is a
668
703
  // perpetual market opens its own, as Enter does.
669
704
  const cursorPerpetual = showsPerpetuals && cursorSymbol ? perpetuals.markets.get(cursorSymbol) ?? null : null;
@@ -759,7 +794,7 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
759
794
  const delistedNotice = selectedDelisting ? `${cursorSymbol}: ${delistingLabel(selectedDelisting)}.` : undefined;
760
795
  usePaneNoticeFooter({
761
796
  registrationId: "portfolio-list-notices",
762
- notices: [...summaryNotices, delistedNotice, capNotice, multiplierNotice].filter((notice): notice is string => !!notice),
797
+ notices: [...summaryNotices, ...periodPnlNotices(periodPnl), delistedNotice, capNotice, multiplierNotice].filter((notice): notice is string => !!notice),
763
798
  focused: focused && !quickAddFocused,
764
799
  });
765
800
  const contentHeight = Math.max(1, height - headerHeight - summaryHeight - drawerHeight - quickAddHeight);
@@ -816,6 +851,8 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
816
851
  addTickerShortcut={showQuickAdd ? QUICK_ADD_KEY : undefined}
817
852
  onOpenPerpetual={showsPerpetuals ? openPerpMarket : undefined}
818
853
  rootHeight={contentHeight}
854
+ width={width}
855
+ answeredSnapshots={answeredSnapshots}
819
856
  />
820
857
  ) : (
821
858
  <PortfolioGrid
@@ -834,6 +871,7 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
834
871
  )}
835
872
 
836
873
  {quickAddRow}
874
+ {positionsImport.picker}
837
875
 
838
876
  {drawerHeight > 0 && accountState && (
839
877
  <Box height={drawerHeight} paddingX={1}>
@@ -0,0 +1,124 @@
1
+ import { useEffect, useMemo, useRef, useState } from "react";
2
+ import { apiClient } from "../../../../api-client";
3
+ import type { PortfolioFuturesTerms } from "../../../../portfolio/futures-positions";
4
+ import type { PeriodPnlRow } from "../../../../portfolio/period-pnl";
5
+ import type { Quote, TickerFinancials } from "../../../../types/financials";
6
+ import type { TickerRecord } from "../../../../types/ticker";
7
+ import { errorMessage } from "../../../../utils/errors";
8
+ import { readPriceWindow, type PriceWindow } from "../../../../utils/price-window";
9
+ import { useAssetData } from "../../../runtime";
10
+ import { loadPeriodPnl, periodBoughtText, periodUnpricedText, type LoadedPeriodPnl } from "../period-pnl";
11
+
12
+ export interface PanePeriodPnl {
13
+ window: PriceWindow | null;
14
+ /** The dates did not read as a window, or the closes did not load. */
15
+ error: string | null;
16
+ /** Null while the closes load. */
17
+ result: LoadedPeriodPnl | null;
18
+ rows: ReadonlyMap<string, PeriodPnlRow>;
19
+ pending: boolean;
20
+ /** Moves whenever `rows` does. */
21
+ version: number;
22
+ }
23
+
24
+ const NO_ROWS: ReadonlyMap<string, PeriodPnlRow> = new Map();
25
+
26
+ const dayMonth = (day: string) => new Date(`${day}T00:00:00Z`).toLocaleDateString("en-GB", { day: "numeric", month: "short", timeZone: "UTC" });
27
+
28
+ /** The day every priced row shares at one end, else the window's own date. */
29
+ function sharedDay(result: LoadedPeriodPnl, end: "start" | "end", fallback: string): string {
30
+ const days = new Set(result.rows.flatMap((row) => row[end] ? [row[end]!.day] : []));
31
+ return days.size === 1 ? [...days][0]! : fallback;
32
+ }
33
+
34
+ /** The header's P&L label over a period, from close to close: `P&L 23 Oct–30 Oct`. */
35
+ export function periodPnlLabel(period: PanePeriodPnl): string {
36
+ if (!period.window) return "P&L";
37
+ const start = period.result ? sharedDay(period.result, "start", period.window.from) : period.window.from;
38
+ const end = period.result ? sharedDay(period.result, "end", period.window.to) : period.window.to;
39
+ return `P&L ${dayMonth(start)}–${dayMonth(end)}`;
40
+ }
41
+
42
+ /** The FX line under the rows (`FX (HKD)`), so they add up to the header's total; null when every holding is in the book's currency. */
43
+ export function periodFxLine(result: LoadedPeriodPnl | null): { currencies: string; pnl: number; contribution: number | null } | null {
44
+ const currencies = [...new Set((result?.rows ?? []).flatMap((row) => row.rates ? [row.rates.currency] : []))];
45
+ return result && currencies.length ? { currencies: currencies.join(", "), pnl: result.fx, contribution: result.fxContribution } : null;
46
+ }
47
+
48
+ /** What the period's P&L leaves out or could not read, and the holdings bought inside it, for the pane's notices. */
49
+ export function periodPnlNotices(period: PanePeriodPnl | null): string[] {
50
+ if (!period) return [];
51
+ if (period.error) return [`P&L period: ${period.error}`];
52
+ if (!period.result) return [];
53
+ return [periodUnpricedText(period.result), periodBoughtText(period.result)].filter((notice): notice is string => !!notice);
54
+ }
55
+
56
+ /** The pane's P&L From and To as `portfolio show --from --to` reads them, or why they do not read. */
57
+ function readPanePeriod(from: string, to: string, now = new Date()): { window: PriceWindow | null; error: string | null } {
58
+ if (!from) return { window: null, error: null };
59
+ try {
60
+ return { window: readPriceWindow(from, to || undefined, now, undefined, { from: "P&L From", to: "P&L To" }), error: null };
61
+ } catch (error) {
62
+ return { window: null, error: errorMessage(error) };
63
+ }
64
+ }
65
+
66
+ /**
67
+ * The PF pane's P&L over a period: each holding's closes before and in the
68
+ * window, read once per window and set of holdings, as `portfolio show
69
+ * --from` reads them. Null for P&L since cost (no P&L From).
70
+ */
71
+ export function usePanePeriodPnl({ from, to, enabled, portfolioId, tickers, currency, futures, futuresVersion, financialsMap, snapshot }: {
72
+ from: string;
73
+ to: string;
74
+ enabled: boolean;
75
+ portfolioId: string;
76
+ tickers: readonly TickerRecord[];
77
+ currency: string;
78
+ futures: ReadonlyMap<string, PortfolioFuturesTerms>;
79
+ futuresVersion: number;
80
+ financialsMap: ReadonlyMap<string, TickerFinancials>;
81
+ /** The reading already made for this window (a capture's, from the report): nothing is loaded. */
82
+ snapshot?: LoadedPeriodPnl | null;
83
+ }): PanePeriodPnl | null {
84
+ const provider = useAssetData();
85
+ const { window, error: windowError } = useMemo(() => readPanePeriod(enabled ? from : "", to), [enabled, from, to]);
86
+ // The holdings, their quantities and the currency each is priced in (its quote's, once it arrives): a quote tick does
87
+ // not read the closes again, but a quote that changes a holding's currency does, so pence are never read as pounds.
88
+ const holdings = useMemo(() => tickers.flatMap((ticker) => {
89
+ const shares = ticker.metadata.positions.filter((position) => position.portfolio === portfolioId).reduce((sum, position) => sum + position.shares, 0);
90
+ const priced = financialsMap.get(ticker.metadata.ticker)?.quote?.currency || ticker.metadata.currency || "";
91
+ return shares ? [`${ticker.metadata.ticker}:${shares}:${priced}`] : [];
92
+ }).sort().join(","), [financialsMap, portfolioId, tickers]);
93
+ const given = snapshot && window && snapshot.window.from === window.from && snapshot.window.to === window.to ? snapshot : null;
94
+ const key = window && !given ? `${portfolioId}|${currency}|${window.from}|${window.to}|${holdings}|${futuresVersion}` : "";
95
+ const inputs = useRef({ tickers, futures, financialsMap });
96
+ inputs.current = { tickers, futures, financialsMap };
97
+ const [state, setState] = useState<{ key: string; result: LoadedPeriodPnl | null; error: string | null; version: number }>({ key: "", result: null, error: null, version: 0 });
98
+
99
+ useEffect(() => {
100
+ if (!key || !window || !provider) return;
101
+ let cancelled = false;
102
+ const { tickers: held, futures: terms, financialsMap: financials } = inputs.current;
103
+ const quotes = new Map<string, Quote | undefined>(held.map((ticker) => [ticker.metadata.ticker, financials.get(ticker.metadata.ticker)?.quote]));
104
+ void loadPeriodPnl({ tickers: held, portfolioId, currency, window, provider, fxHistory: apiClient, quotes, futures: terms })
105
+ .then((result) => { if (!cancelled) setState((last) => ({ key, result, error: null, version: last.version + 1 })); },
106
+ (error: unknown) => { if (!cancelled) setState((last) => ({ key, result: null, error: errorMessage(error), version: last.version + 1 })); });
107
+ return () => { cancelled = true; };
108
+ }, [currency, key, portfolioId, provider, window]);
109
+
110
+ return useMemo(() => {
111
+ if (!enabled || (!window && !windowError)) return null;
112
+ if (given) return { window, error: null, result: given, rows: new Map(given.rows.map((row) => [row.symbol, row])), pending: false, version: 1 };
113
+ const settled = state.key === key && !!key;
114
+ const result = settled ? state.result : null;
115
+ return {
116
+ window,
117
+ error: windowError ?? (settled ? state.error : null) ?? (provider ? null : "Market data unavailable"),
118
+ result,
119
+ rows: result ? new Map(result.rows.map((row) => [row.symbol, row])) : NO_ROWS,
120
+ pending: !!window && !!provider && !settled,
121
+ version: settled ? state.version : 0,
122
+ };
123
+ }, [enabled, given, key, provider, state, window, windowError]);
124
+ }
@@ -0,0 +1,179 @@
1
+ import type { Quote } from "../../../types/financials";
2
+ import { loadCostFxRate, type CostFxHistoryClient } from "../../../portfolio/cost-fx";
3
+ import { withFuturesContractSize, isFuturesTicker, type PortfolioFuturesTerms } from "../../../portfolio/futures-positions";
4
+ import { periodCurrency, periodPnl, type PeriodClose, type PeriodPnl, type PeriodPnlHolding, type PeriodPnlRow } from "../../../portfolio/period-pnl";
5
+ import { getPortfolioPositionMetrics } from "../../../portfolio/position-metrics";
6
+ import { barSessionDay, periodDayText } from "../../../market-data/market/period-return";
7
+ import { quoteHeadlineTime } from "../../../market-data/market/status";
8
+ import { formatUtcDayTime } from "../../../utils/utc-time";
9
+ import { cleanFloat32Price } from "../../../cli/history-rows";
10
+ import type { DataProvider } from "../../../types/data-provider";
11
+ import type { TickerRecord } from "../../../types/ticker";
12
+ import { mapWithConcurrency } from "../../../utils/concurrency";
13
+ import { errorMessage } from "../../../utils/errors";
14
+ import { logFailure } from "../../../utils/log-failure";
15
+ import type { PriceWindow } from "../../../utils/price-window";
16
+ import type { ChartResolutionSupport } from "../../../time-series/resolution";
17
+ import { loadReturnSeries } from "../ticker-detail/data-panes/returns-history";
18
+ import { buildReturnRows, isTodayReturnRow, returnBaseCloseDay } from "../ticker-detail/data-panes/returns-model";
19
+
20
+ /** Holdings whose daily closes are read at once: `portfolio show --from`, `fn PF --from` and `shot PF` alike. */
21
+ const PERIOD_HISTORY_READS = 6;
22
+
23
+ /**
24
+ * Daily bars over any window: a day or two would otherwise be read in hourly
25
+ * bars (a future from a Globex hour, not its settlement) and more than five
26
+ * years in weekly ones (a window from a Wednesday starting the Friday before).
27
+ */
28
+ const DAILY_CLOSES: readonly ChartResolutionSupport[] = [{ resolution: "1d", maxRange: "ALL" }];
29
+
30
+ export interface LoadedPeriodPnl extends PeriodPnl {
31
+ window: PriceWindow;
32
+ /** Holdings whose closes could not be read, with why. */
33
+ failures: { symbol: string; error: string }[];
34
+ /** Why each holding in `unpriced` has no P&L: the source's answer, no close at one end, no FX close, no contract size. */
35
+ unpricedReasons: { symbol: string; reason: string }[];
36
+ /** Holdings whose lots are dated inside the window: their P&L runs from the start close all the same. */
37
+ boughtInWindow: string[];
38
+ /** When the window ends today with a session still trading: the latest price's time, in ms. */
39
+ latestPriceAt: number | null;
40
+ }
41
+
42
+ /**
43
+ * A holding's close before the window and its last close in it, read as
44
+ * RETURN reads a window (its base close and its last row) but always in daily
45
+ * bars, so the P&L runs close to close, a future's from settlement to
46
+ * settlement, however short or long the window. Over the windows RETURN reads
47
+ * in daily bars too, the two agree to the cent.
48
+ */
49
+ async function windowCloses(provider: DataProvider, ticker: TickerRecord, window: PriceWindow, now: number, refresh: boolean) {
50
+ const series = await loadReturnSeries(provider, {
51
+ symbol: ticker.metadata.ticker, exchange: ticker.metadata.exchange ?? "", range: "1M", resolution: "1d", support: DAILY_CLOSES, now, window, forceRefresh: refresh,
52
+ });
53
+ const rows = buildReturnRows(series.points, series.visibleFrom, series.visibleTo).filter((row) => row.price !== null);
54
+ // Newest first, as RETURN lists them.
55
+ const last = rows[0];
56
+ const venue = series.venue || undefined;
57
+ const baseDay = rows.length ? returnBaseCloseDay(series.points, series.visibleFrom, series.resolution, venue, now) : null;
58
+ if (!last || last.price === null || last.cumulativeChange === null || !baseDay) return { start: null, end: null, partialEnd: false };
59
+ // Bars stored as float32 read back as 63.150001525878906; the closes are the prices `history` prints.
60
+ const start: PeriodClose = { day: baseDay, price: cleanFloat32Price(last.price - last.cumulativeChange) };
61
+ const end: PeriodClose = { day: barSessionDay(last.timestamp, venue), price: cleanFloat32Price(last.price) };
62
+ // Today's session still trading, by the venue's calendar or by the source, which marks a forming bar (a future's
63
+ // day before its settlement) partial and a closed one it has not settled yet unsettled: its close is a last trade.
64
+ const lastPoint = series.points.find((point) => new Date(point.date).getTime() === last.timestamp);
65
+ const partialEnd = isTodayReturnRow(last, series.resolution, venue, now) || !!lastPoint?.partial || !!lastPoint?.unsettled;
66
+ return { start, end, partialEnd };
67
+ }
68
+
69
+ /**
70
+ * A portfolio's P&L by position between the close before `window.from` and
71
+ * the last close on or before `window.to`, in `currency`, on the holdings it
72
+ * holds now. A future counts its contracts at the size its terms give.
73
+ */
74
+ export async function loadPeriodPnl({
75
+ tickers, portfolioId, currency, window, provider, fxHistory, quotes, futures, now = Date.now(), refresh = false,
76
+ }: {
77
+ tickers: readonly TickerRecord[];
78
+ portfolioId: string;
79
+ currency: string;
80
+ window: PriceWindow;
81
+ provider: DataProvider;
82
+ fxHistory: CostFxHistoryClient;
83
+ quotes?: ReadonlyMap<string, Quote | undefined>;
84
+ futures?: ReadonlyMap<string, PortfolioFuturesTerms>;
85
+ now?: number;
86
+ refresh?: boolean;
87
+ }): Promise<LoadedPeriodPnl> {
88
+ const held = tickers.filter((ticker) => ticker.metadata.positions.some((position) => position.portfolio === portfolioId && position.shares !== 0));
89
+ const failures: LoadedPeriodPnl["failures"] = [];
90
+ const sizeUnknown = new Set<string>();
91
+ const latestTimes: number[] = [];
92
+ const boughtInWindow = held.filter((ticker) => ticker.metadata.positions.some((position) => position.portfolio === portfolioId
93
+ && position.shares !== 0 && !!position.dateAcquired && position.dateAcquired >= window.from)).map((ticker) => ticker.metadata.ticker);
94
+ const holdings = await mapWithConcurrency(held, PERIOD_HISTORY_READS, async (ticker): Promise<PeriodPnlHolding> => {
95
+ const symbol = ticker.metadata.ticker;
96
+ const quote = quotes?.get(symbol) ?? null;
97
+ const sized = isFuturesTicker(ticker) ? withFuturesContractSize(ticker, futures?.get(symbol)?.size) : ticker;
98
+ const quoteCurrency = quote?.currency || ticker.metadata.currency || currency;
99
+ const metrics = getPortfolioPositionMetrics(sized, portfolioId, quoteCurrency, undefined, quote);
100
+ const closes = await windowCloses(provider, ticker, window, now, refresh).catch((error: unknown) => {
101
+ failures.push({ symbol, error: errorMessage(error) });
102
+ return { start: null, end: null, partialEnd: false };
103
+ });
104
+ // A future without a contract size has no value a contract: it stays unpriced rather than counted at one unit.
105
+ const units = metrics.unknownContractSize ? Number.NaN : metrics.totalPriceUnits;
106
+ if (metrics.unknownContractSize) sizeUnknown.add(symbol);
107
+ if (closes.partialEnd && quote) latestTimes.push(quoteHeadlineTime(quote));
108
+ return { symbol, priceUnits: units, currency: quoteCurrency, ...closes };
109
+ });
110
+ // Each major currency's FX close on each day a holding in it starts or ends on: GBP's for a price in pence.
111
+ const needed = new Map<string, { from: string; day: string }>();
112
+ for (const holding of holdings) {
113
+ const { currency: major, own } = periodCurrency(holding.currency, currency);
114
+ if (own) continue;
115
+ for (const close of [holding.start, holding.end]) if (close) needed.set(`${major}|${close.day}`, { from: major, day: close.day });
116
+ }
117
+ const rates = new Map(await mapWithConcurrency([...needed], 4, async ([key, { from, day }]) =>
118
+ [key, await loadCostFxRate(from, currency, day, fxHistory, new Date(now))
119
+ .then((reading) => reading.rate)
120
+ .catch(logFailure("portfolio.period-pnl", "Reading a window's FX close failed", null))] as const));
121
+ const rate = (from: string, day: string) => rates.get(`${from}|${day}`) ?? null;
122
+ const result = periodPnl(holdings.map((holding) => Number.isFinite(holding.priceUnits) ? holding : { ...holding, start: null }), currency, rate);
123
+ const failed = new Map(failures.map((failure) => [failure.symbol, failure.error]));
124
+ const unpricedReasons = holdings.filter((holding) => result.unpriced.includes(holding.symbol)).map((holding) => {
125
+ const { currency: major, own } = periodCurrency(holding.currency, currency);
126
+ const missingRate = !own ? [holding.start, holding.end].find((close) => close && rate(major, close.day) == null) : undefined;
127
+ const reason = failed.has(holding.symbol) ? failed.get(holding.symbol)!.replace(/\.+$/, "")
128
+ : sizeUnknown.has(holding.symbol) ? "contract size unknown"
129
+ : !holding.start ? `no close before ${window.from}`
130
+ : !holding.end ? `no close from ${window.from} to ${window.to}`
131
+ : missingRate ? `no ${major} FX close on ${missingRate.day}`
132
+ : "no close at one end of the window";
133
+ return { symbol: holding.symbol, reason };
134
+ }).sort((a, b) => a.symbol.localeCompare(b.symbol));
135
+ return {
136
+ ...result, window, failures: failures.sort((a, b) => a.symbol.localeCompare(b.symbol)), unpricedReasons, boughtInWindow,
137
+ latestPriceAt: latestTimes.length ? Math.max(...latestTimes) : null,
138
+ };
139
+ }
140
+
141
+ /** The one day every priced row shares at an end of the window, or null when they differ (a holiday on one venue). */
142
+ export function periodSharedDay(rows: readonly PeriodPnlRow[], end: "start" | "end"): string | null {
143
+ const days = new Set(rows.flatMap((row) => row[end] ? [row[end]!.day] : []));
144
+ return days.size === 1 ? [...days][0]! : null;
145
+ }
146
+
147
+ /**
148
+ * What a period's P&L runs between, as every report of it says first:
149
+ * `P&L from the close of Fri 23 Oct to the close of Fri 30 Oct`, or `to the
150
+ * latest price (Thu 5 Nov 15:42 UTC)` when the window ends in a session still
151
+ * trading.
152
+ */
153
+ export function periodBasisText(result: LoadedPeriodPnl, { futuresHeld, now = Date.now() }: { futuresHeld: boolean; now?: number }): string {
154
+ const year = new Date(now).getUTCFullYear();
155
+ const startDay = periodSharedDay(result.rows, "start");
156
+ const endDay = periodSharedDay(result.rows, "end");
157
+ const partial = result.rows.some((row) => row.partialEnd);
158
+ const start = startDay ? `the close of ${periodDayText(startDay, year)}` : "each holding's last close before the start";
159
+ const end = partial
160
+ ? `the latest price${result.latestPriceAt != null ? ` (${formatUtcDayTime({ time: result.latestPriceAt, dateOnly: false }, now)} UTC)` : ""}`
161
+ : endDay ? `the close of ${periodDayText(endDay, year)}` : "each holding's last close in the window";
162
+ // A future runs from its settlement; to a settlement too unless the window ends on its latest price.
163
+ const futures = !futuresHeld ? "" : partial ? ", futures from their settlements" : ", futures at their settlements";
164
+ return `P&L from ${start} to ${end}${futures}, on the holdings held now`;
165
+ }
166
+
167
+ /** `No P&L for GC=F (contract size unknown), 2382 (no close before 2020-03-18). The total leaves them out.` Null when every holding has one. */
168
+ export function periodUnpricedText(result: LoadedPeriodPnl, label: (symbol: string) => string = (symbol) => symbol): string | null {
169
+ if (!result.unpricedReasons.length) return null;
170
+ const named = result.unpricedReasons.map(({ symbol, reason }) => `${label(symbol)} (${reason})`).join(", ");
171
+ return `No P&L for ${named}. The total leaves ${result.unpricedReasons.length === 1 ? "it" : "them"} out.`;
172
+ }
173
+
174
+ /** The holdings bought inside the window, whose P&L still runs from the start close: named, never left to look like a full period. */
175
+ export function periodBoughtText(result: LoadedPeriodPnl, label: (symbol: string) => string = (symbol) => symbol): string | null {
176
+ const count = result.boughtInWindow.length;
177
+ if (!count) return null;
178
+ return `Bought inside the window: ${result.boughtInWindow.map(label).join(", ")}. ${count === 1 ? "Its" : "Their"} P&L runs from the start close, as if held all along.`;
179
+ }