gloomberb 0.20.7 → 0.20.8

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 (611) hide show
  1. package/README.ja.md +74 -0
  2. package/README.md +2 -0
  3. package/README.zh-CN.md +2 -0
  4. package/package.json +6 -1
  5. package/src/account/auth-model.ts +22 -0
  6. package/src/api-client/auth.ts +7 -2
  7. package/src/api-client/awards.ts +5 -0
  8. package/src/api-client/bond-trades.ts +22 -0
  9. package/src/api-client/catalysts.ts +11 -1
  10. package/src/api-client/data.ts +30 -6
  11. package/src/api-client/debt-maturities.ts +7 -0
  12. package/src/api-client/equity-screener.ts +17 -0
  13. package/src/api-client/errors.ts +2 -0
  14. package/src/api-client/exchange-announcements.ts +14 -7
  15. package/src/api-client/fund-facts.ts +21 -3
  16. package/src/api-client/futures-curve.ts +14 -1
  17. package/src/api-client/geo.ts +10 -0
  18. package/src/api-client/hiring.ts +2 -0
  19. package/src/api-client/index.ts +3 -0
  20. package/src/api-client/insider-signals.ts +14 -0
  21. package/src/api-client/members.ts +30 -2
  22. package/src/api-client/money-markets.ts +11 -1
  23. package/src/api-client/paths.ts +6 -1
  24. package/src/api-client/perps.ts +2 -0
  25. package/src/api-client/request.ts +2 -1
  26. package/src/api-client/socket.ts +7 -0
  27. package/src/api-client/types/econ.ts +2 -1
  28. package/src/api-client/types/filings-and-calls.ts +6 -0
  29. package/src/api-client/types/market.ts +4 -0
  30. package/src/api-client/web-experiments.ts +5 -6
  31. package/src/app/runtime/update.ts +2 -1
  32. package/src/architecture/floating-promise-allowlist.json +33 -106
  33. package/src/capabilities/asset-data-inputs.ts +183 -0
  34. package/src/capabilities/factories.ts +8 -2
  35. package/src/cli/base-converter.ts +36 -2
  36. package/src/cli/commands/api.ts +2 -2
  37. package/src/cli/commands/command-utils.ts +18 -0
  38. package/src/cli/commands/hong-kong-movers.ts +50 -0
  39. package/src/cli/commands/market.ts +539 -130
  40. package/src/cli/commands/options-chain.ts +7 -1
  41. package/src/cli/commands/overview.ts +74 -14
  42. package/src/cli/commands/plugins.ts +7 -6
  43. package/src/cli/commands/search.ts +52 -9
  44. package/src/cli/commands/system.ts +15 -10
  45. package/src/cli/commands/ticker.ts +97 -44
  46. package/src/cli/content-figures.ts +45 -0
  47. package/src/cli/context.ts +5 -0
  48. package/src/cli/desktop-pane-shot-routes.ts +13 -4
  49. package/src/cli/desktop-pane-shot.ts +86 -12
  50. package/src/cli/earnings-calendar.ts +36 -5
  51. package/src/cli/export-source.ts +17 -3
  52. package/src/cli/fx-pair.ts +111 -11
  53. package/src/cli/glossary.ts +36 -2
  54. package/src/cli/help.ts +1 -1
  55. package/src/cli/history-export.ts +29 -11
  56. package/src/cli/history-rows.ts +130 -21
  57. package/src/cli/index.ts +8 -5
  58. package/src/cli/known-gaps.ts +45 -1
  59. package/src/cli/listing-arg.ts +366 -19
  60. package/src/cli/pane-functions/capabilities.ts +2 -2
  61. package/src/cli/pane-functions/catalog.ts +105 -9
  62. package/src/cli/pane-functions/discovery.ts +2 -0
  63. package/src/cli/pane-functions/dom.ts +46 -9
  64. package/src/cli/pane-functions/freshness.ts +7 -3
  65. package/src/cli/pane-functions/function-help.ts +9 -6
  66. package/src/cli/pane-functions/headless.ts +77 -6
  67. package/src/cli/pane-functions/index.ts +141 -23
  68. package/src/cli/pane-functions/options.ts +1 -3
  69. package/src/cli/pane-functions/plugin-code.ts +169 -0
  70. package/src/cli/pane-functions/report.ts +10 -0
  71. package/src/cli/pane-functions/resolver.ts +69 -21
  72. package/src/cli/pane-functions/screenshot-assessment.ts +82 -3
  73. package/src/cli/pane-functions/screenshot-data-evidence.ts +3 -1
  74. package/src/cli/pane-functions/screenshot-types.ts +6 -0
  75. package/src/cli/quote-answer.ts +49 -2
  76. package/src/cli/registry.ts +42 -4
  77. package/src/cli/report-tables.ts +26 -6
  78. package/src/cli/result.ts +13 -2
  79. package/src/cli/series-search.ts +17 -7
  80. package/src/cli/statement-filings.ts +22 -8
  81. package/src/cli/symbol-args.ts +9 -0
  82. package/src/cli/ticker-resolution.ts +3 -2
  83. package/src/cli/unknown-command.ts +111 -14
  84. package/src/components/chart/composite/format.ts +15 -1
  85. package/src/components/chart/composite/legend.tsx +101 -47
  86. package/src/components/chart/composite/panel-labels.ts +4 -4
  87. package/src/components/chart/composite/panel-surface.tsx +4 -6
  88. package/src/components/chart/composite/scene/build.ts +180 -0
  89. package/src/components/chart/composite/scene/cursor.ts +226 -0
  90. package/src/components/chart/composite/scene/domain.ts +170 -0
  91. package/src/components/chart/composite/scene/markers.ts +115 -0
  92. package/src/components/chart/composite/scene/panels.ts +85 -0
  93. package/src/components/chart/composite/scene/points.ts +169 -0
  94. package/src/components/chart/composite/scene/projection.ts +105 -0
  95. package/src/components/chart/composite/scene/timeline.ts +71 -0
  96. package/src/components/chart/composite/scene.ts +12 -1066
  97. package/src/components/chart/composite/types.ts +4 -2
  98. package/src/components/chart/curve/model.ts +2 -2
  99. package/src/components/chart-table/axis.ts +18 -6
  100. package/src/components/command-bar/layout-items/focused-pane.ts +3 -0
  101. package/src/components/command-bar/list/model.ts +9 -0
  102. package/src/components/command-bar/pane-templates/items.ts +61 -15
  103. package/src/components/command-bar/pane-templates/workflow.ts +16 -5
  104. package/src/components/command-bar/routes/root/plugin-install.ts +7 -46
  105. package/src/components/command-bar/routes/root/provider-search.ts +8 -5
  106. package/src/components/command-bar/routes/root/results.ts +6 -1
  107. package/src/components/command-bar/routes/root/runtime.ts +1 -0
  108. package/src/components/command-bar/routes/root/shortcut-feedback.ts +4 -1
  109. package/src/components/command-bar/routes/ticker-search/actions.ts +7 -5
  110. package/src/components/command-bar/routes/ticker-search/results.ts +51 -3
  111. package/src/components/command-bar/view-model.ts +12 -0
  112. package/src/components/command-bar/workflow/ops.ts +21 -4
  113. package/src/components/command-bar/workflow/ticker-listing-picker.ts +3 -1
  114. package/src/components/command-bar/workflow/tickers.ts +6 -2
  115. package/src/components/data-table/view.tsx +46 -1
  116. package/src/components/form-modal/confirm.tsx +3 -2
  117. package/src/components/form-modal/content.tsx +3 -2
  118. package/src/components/form-modal/field-row.tsx +2 -0
  119. package/src/components/form-modal/host.tsx +18 -3
  120. package/src/components/form-modal/remote-reads.test-helpers.ts +34 -0
  121. package/src/components/index.ts +1 -1
  122. package/src/components/layout/pane/title.ts +21 -5
  123. package/src/components/layout/shell/pane/layers.tsx +20 -14
  124. package/src/components/layout/shell/pane-occlusion.ts +21 -0
  125. package/src/components/onboarding/desks-step.tsx +7 -1
  126. package/src/components/onboarding/onboarding-keyboard.ts +48 -6
  127. package/src/components/onboarding/onboarding-wizard.tsx +47 -8
  128. package/src/components/onboarding/portfolio-step/positions-panel.tsx +17 -3
  129. package/src/components/onboarding/use-onboarding-progress.ts +57 -14
  130. package/src/components/onboarding/wizard-positions.ts +2 -0
  131. package/src/components/paged-rows.ts +11 -5
  132. package/src/components/ticker/list-table-view.tsx +24 -5
  133. package/src/components/toggle-list.tsx +44 -1
  134. package/src/components/ui/data-table/opentui/index.tsx +7 -6
  135. package/src/components/ui/data-table/opentui/model.ts +7 -3
  136. package/src/components/ui/data-table/types.ts +13 -2
  137. package/src/components/ui/fields.tsx +16 -4
  138. package/src/components/ui/query-bar.tsx +43 -9
  139. package/src/components/ui/table-layout.ts +56 -2
  140. package/src/core/app-services.ts +7 -2
  141. package/src/core/connection-health.ts +26 -0
  142. package/src/core/state/app/layout.ts +12 -4
  143. package/src/data/config/layout.ts +3 -1
  144. package/src/data/config/store/node.ts +4 -2
  145. package/src/docs/snapshot.json +756 -216
  146. package/src/i18n/es.ts +4 -1
  147. package/src/i18n/ja.ts +4 -1
  148. package/src/i18n/ko.ts +4 -1
  149. package/src/i18n/zh-cn.ts +4 -1
  150. package/src/i18n/zh-tw.ts +4 -1
  151. package/src/layout/pane-follow.ts +1 -1
  152. package/src/layout/pane-manager/gridlock.ts +18 -5
  153. package/src/layout/pane-manager/index.ts +1 -0
  154. package/src/layout/pane-manager/transient.ts +56 -0
  155. package/src/layout-marketplace/gallery.tsx +2 -1
  156. package/src/layout-marketplace/model.ts +4 -10
  157. package/src/market-data/commodity-names.ts +24 -0
  158. package/src/market-data/connection-follow.ts +9 -7
  159. package/src/market-data/coordinator/auxiliary.ts +4 -3
  160. package/src/market-data/coordinator/entries.ts +22 -1
  161. package/src/market-data/coordinator/financials.ts +2 -3
  162. package/src/market-data/coordinator/index.ts +67 -12
  163. package/src/market-data/coordinator/quotes.ts +2 -3
  164. package/src/market-data/fund-facts.ts +7 -1
  165. package/src/market-data/futures-board.ts +38 -4
  166. package/src/market-data/futures-contract.ts +5 -2
  167. package/src/market-data/fx-closes.ts +4 -1
  168. package/src/market-data/market/bar-period.ts +15 -0
  169. package/src/market-data/market/format.ts +4 -2
  170. package/src/market-data/market/freshness.ts +4 -0
  171. package/src/market-data/market/status.ts +23 -3
  172. package/src/market-data/options-alternatives.ts +21 -9
  173. package/src/market-data/published-futures-sessions.ts +9 -0
  174. package/src/market-data/quotes/balance-sheet-rate.ts +34 -0
  175. package/src/market-data/quotes/delisting.ts +26 -2
  176. package/src/market-data/quotes/freshness.ts +62 -0
  177. package/src/market-data/quotes/listing-enterprise-value.ts +250 -19
  178. package/src/market-data/quotes/regular-session-valuation.ts +8 -0
  179. package/src/market-data/realized-volatility.ts +3 -1
  180. package/src/market-data/request-types.ts +2 -0
  181. package/src/market-data/selectors.ts +1 -0
  182. package/src/news/aggregator.ts +3 -3
  183. package/src/plugins/builtin/account-management/delete-account.ts +78 -0
  184. package/src/plugins/builtin/account-management/pane.tsx +22 -19
  185. package/src/plugins/builtin/account-management/password-dialog.tsx +75 -0
  186. package/src/plugins/builtin/alerts/alert-log.ts +3 -2
  187. package/src/plugins/builtin/alerts/cli-forms.ts +1 -1
  188. package/src/plugins/builtin/alerts/cli.ts +72 -4
  189. package/src/plugins/builtin/alerts/format.ts +8 -2
  190. package/src/plugins/builtin/alerts/index.tsx +8 -5
  191. package/src/plugins/builtin/alerts/pane.tsx +5 -3
  192. package/src/plugins/builtin/alerts/research-builder.ts +12 -0
  193. package/src/plugins/builtin/analytics/index.tsx +3 -3
  194. package/src/plugins/builtin/analytics/risk-client.ts +14 -3
  195. package/src/plugins/builtin/analytics/risk-pane.tsx +3 -3
  196. package/src/plugins/builtin/attention/pane.tsx +1 -1
  197. package/src/plugins/builtin/attention/trending.tsx +1 -1
  198. package/src/plugins/builtin/awards/detail.tsx +4 -1
  199. package/src/plugins/builtin/awards/headless.ts +7 -3
  200. package/src/plugins/builtin/awards/model.ts +11 -0
  201. package/src/plugins/builtin/awards/pane.tsx +12 -5
  202. package/src/plugins/builtin/backtest/client.ts +7 -2
  203. package/src/plugins/builtin/backtest/headless.ts +2 -1
  204. package/src/plugins/builtin/backtest/pane.tsx +4 -2
  205. package/src/plugins/builtin/bond-calculator/pane.tsx +1 -1
  206. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  207. package/src/plugins/builtin/broker-trading/orders.tsx +2 -2
  208. package/src/plugins/builtin/buildout/company/pane.tsx +1 -1
  209. package/src/plugins/builtin/buildout/model/index.ts +2 -2
  210. package/src/plugins/builtin/catalysts/headless.ts +9 -6
  211. package/src/plugins/builtin/catalysts/model.ts +72 -10
  212. package/src/plugins/builtin/catalysts/pane.tsx +10 -7
  213. package/src/plugins/builtin/cds/pane.tsx +5 -3
  214. package/src/plugins/builtin/central-bank-rates/pane.tsx +3 -2
  215. package/src/plugins/builtin/chart-composer/catalog-series.ts +59 -0
  216. package/src/plugins/builtin/chart-composer/headless-schema.ts +2 -1
  217. package/src/plugins/builtin/chart-composer/headless.ts +104 -23
  218. package/src/plugins/builtin/chart-composer/index.tsx +6 -3
  219. package/src/plugins/builtin/chart-composer/legend-names.ts +19 -0
  220. package/src/plugins/builtin/chart-composer/pane.tsx +37 -10
  221. package/src/plugins/builtin/chart-composer/presets.ts +63 -6
  222. package/src/plugins/builtin/chart-composer/roll-events.ts +38 -0
  223. package/src/plugins/builtin/chart-composer/series-catalog.ts +12 -5
  224. package/src/plugins/builtin/chart-composer/series-expression.ts +8 -4
  225. package/src/plugins/builtin/chart-composer/series-listings.ts +33 -9
  226. package/src/plugins/builtin/chart-composer/use-series-catalog.ts +2 -2
  227. package/src/plugins/builtin/clinical-trials/client.ts +13 -0
  228. package/src/plugins/builtin/clinical-trials/index.tsx +1 -1
  229. package/src/plugins/builtin/clinical-trials/pane.tsx +77 -27
  230. package/src/plugins/builtin/clinical-trials/search.ts +117 -0
  231. package/src/plugins/builtin/cloud/askg/conversation-store.ts +17 -6
  232. package/src/plugins/builtin/cloud/askg/lock-note.ts +4 -2
  233. package/src/plugins/builtin/cloud/askg/manifest.ts +3 -2
  234. package/src/plugins/builtin/cloud/askg/pane.tsx +2 -2
  235. package/src/plugins/builtin/cloud/askg/sources.ts +3 -3
  236. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +7 -3
  237. package/src/plugins/builtin/cloud/team/acm-tab.tsx +1 -1
  238. package/src/plugins/builtin/cloud/team/pane.tsx +17 -10
  239. package/src/plugins/builtin/cloud/team/views.ts +15 -3
  240. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +105 -16
  241. package/src/plugins/builtin/cloud/thesis/board-pane.tsx +17 -2
  242. package/src/plugins/builtin/cloud/thesis/module.tsx +3 -2
  243. package/src/plugins/builtin/cloud/thesis/store.ts +17 -3
  244. package/src/plugins/builtin/commodities-energy/index.tsx +35 -3
  245. package/src/plugins/builtin/commodity-balances/index.tsx +1 -1
  246. package/src/plugins/builtin/company-attention/app-rank.tsx +1 -1
  247. package/src/plugins/builtin/company-attention/building.tsx +1 -1
  248. package/src/plugins/builtin/company-attention/model.ts +2 -1
  249. package/src/plugins/builtin/company-attention/moves.tsx +1 -1
  250. package/src/plugins/builtin/company-attention/pane.tsx +1 -1
  251. package/src/plugins/builtin/company-attention/signals.tsx +1 -1
  252. package/src/plugins/builtin/company-kpis/pane.tsx +1 -1
  253. package/src/plugins/builtin/correlation/headless.ts +7 -5
  254. package/src/plugins/builtin/correlation/history.ts +17 -6
  255. package/src/plugins/builtin/correlation/index.tsx +1 -1
  256. package/src/plugins/builtin/correlation/relationship/history.ts +1 -1
  257. package/src/plugins/builtin/correlation/relationship/pane.tsx +1 -1
  258. package/src/plugins/builtin/cot/headless.ts +10 -3
  259. package/src/plugins/builtin/cot/pane.tsx +2 -2
  260. package/src/plugins/builtin/cpi/pane.tsx +1 -1
  261. package/src/plugins/builtin/credit-boards/model.ts +1 -1
  262. package/src/plugins/builtin/credit-documents/pane.tsx +1 -1
  263. package/src/plugins/builtin/crypto-board/defi-view.tsx +2 -2
  264. package/src/plugins/builtin/crypto-board/defi.ts +9 -3
  265. package/src/plugins/builtin/crypto-board/headless.ts +19 -10
  266. package/src/plugins/builtin/crypto-board/model.ts +8 -0
  267. package/src/plugins/builtin/crypto-board/pane.tsx +11 -5
  268. package/src/plugins/builtin/crypto-board/series.ts +17 -3
  269. package/src/plugins/builtin/crypto-board/supply.ts +26 -3
  270. package/src/plugins/builtin/crypto-etf-flows/headless.ts +3 -2
  271. package/src/plugins/builtin/crypto-etf-flows/model.ts +13 -3
  272. package/src/plugins/builtin/crypto-etf-flows/pane.tsx +6 -3
  273. package/src/plugins/builtin/custom-view/pane.tsx +5 -5
  274. package/src/plugins/builtin/debt-maturities/client.ts +5 -0
  275. package/src/plugins/builtin/debt-maturities/headless.ts +3 -1
  276. package/src/plugins/builtin/debt-maturities/model.ts +1 -0
  277. package/src/plugins/builtin/debt-maturities/pane.tsx +1 -1
  278. package/src/plugins/builtin/dividend-yield/pane.tsx +1 -1
  279. package/src/plugins/builtin/doe/model.ts +1 -1
  280. package/src/plugins/builtin/doe/pane.tsx +1 -1
  281. package/src/plugins/builtin/earnings/board.tsx +2 -2
  282. package/src/plugins/builtin/earnings/history.tsx +1 -1
  283. package/src/plugins/builtin/earnings-calls/calendar.tsx +1 -1
  284. package/src/plugins/builtin/earnings-calls/data.ts +2 -1
  285. package/src/plugins/builtin/earnings-calls/headless.ts +15 -0
  286. package/src/plugins/builtin/earnings-calls/model.ts +68 -8
  287. package/src/plugins/builtin/earnings-calls/pane.tsx +29 -8
  288. package/src/plugins/builtin/earnings-calls/transcript-view.tsx +32 -2
  289. package/src/plugins/builtin/earnings-ripple/pane.tsx +1 -1
  290. package/src/plugins/builtin/econ/calendar-model.ts +94 -2
  291. package/src/plugins/builtin/econ/detail-view.tsx +15 -11
  292. package/src/plugins/builtin/econ/index.tsx +25 -9
  293. package/src/plugins/builtin/econ/types.ts +4 -1
  294. package/src/plugins/builtin/equity-screener/headless.ts +23 -7
  295. package/src/plugins/builtin/equity-screener/index.tsx +3 -0
  296. package/src/plugins/builtin/equity-screener/live.ts +39 -12
  297. package/src/plugins/builtin/equity-screener/model.ts +86 -5
  298. package/src/plugins/builtin/equity-screener/pane.tsx +20 -21
  299. package/src/plugins/builtin/equity-screener/results.ts +12 -3
  300. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -2
  301. package/src/plugins/builtin/estimate-revisions/pane.tsx +2 -2
  302. package/src/plugins/builtin/executives/pane.tsx +2 -2
  303. package/src/plugins/builtin/exposure/pane.tsx +1 -1
  304. package/src/plugins/builtin/fear-greed/data.ts +3 -1
  305. package/src/plugins/builtin/fear-greed/headless.ts +8 -2
  306. package/src/plugins/builtin/fear-greed/pane.tsx +8 -4
  307. package/src/plugins/builtin/filing-events/pane.tsx +1 -1
  308. package/src/plugins/builtin/futures/index.tsx +5 -4
  309. package/src/plugins/builtin/futures/model.ts +17 -9
  310. package/src/plugins/builtin/futures/returns.ts +2 -0
  311. package/src/plugins/builtin/futures/series.ts +44 -8
  312. package/src/plugins/builtin/futures/table.tsx +3 -3
  313. package/src/plugins/builtin/futures-curve/client.ts +1 -0
  314. package/src/plugins/builtin/futures-curve/headless.ts +14 -12
  315. package/src/plugins/builtin/futures-curve/index.tsx +7 -4
  316. package/src/plugins/builtin/futures-curve/model.ts +93 -7
  317. package/src/plugins/builtin/futures-curve/pane.tsx +18 -7
  318. package/src/plugins/builtin/fx-matrix/amount.ts +2 -1
  319. package/src/plugins/builtin/fx-matrix/index.tsx +9 -0
  320. package/src/plugins/builtin/gpu/changes.tsx +1 -1
  321. package/src/plugins/builtin/gpu/equities.tsx +1 -1
  322. package/src/plugins/builtin/gpu/pane.tsx +2 -2
  323. package/src/plugins/builtin/help/function-card.tsx +4 -2
  324. package/src/plugins/builtin/help/function-index.ts +12 -6
  325. package/src/plugins/builtin/help/index.tsx +1 -1
  326. package/src/plugins/builtin/holders/beneficial-view.tsx +1 -1
  327. package/src/plugins/builtin/holders/pane.tsx +1 -1
  328. package/src/plugins/builtin/insider/base-values.ts +55 -0
  329. package/src/plugins/builtin/insider/headless.ts +307 -83
  330. package/src/plugins/builtin/insider/index.tsx +65 -23
  331. package/src/plugins/builtin/insider/insiders.tsx +26 -16
  332. package/src/plugins/builtin/insider/model.ts +2 -2
  333. package/src/plugins/builtin/insider/signals-cells.tsx +4 -1
  334. package/src/plugins/builtin/insider/signals-model.ts +13 -5
  335. package/src/plugins/builtin/insider/signals.tsx +5 -3
  336. package/src/plugins/builtin/insider/tickers.tsx +466 -0
  337. package/src/plugins/builtin/ipo-calendar/pane.tsx +1 -1
  338. package/src/plugins/builtin/iv-history/client.ts +35 -4
  339. package/src/plugins/builtin/iv-history/headless.ts +10 -4
  340. package/src/plugins/builtin/iv-history/model.ts +85 -16
  341. package/src/plugins/builtin/iv-history/pane.tsx +2 -2
  342. package/src/plugins/builtin/iv-history/screen-pane.tsx +6 -3
  343. package/src/plugins/builtin/jobs/pane.tsx +5 -5
  344. package/src/plugins/builtin/macro-day/pane.tsx +1 -1
  345. package/src/plugins/builtin/macro-day/release-table.ts +5 -5
  346. package/src/plugins/builtin/macro-day/releases.ts +11 -9
  347. package/src/plugins/builtin/market-movers/headless.ts +6 -2
  348. package/src/plugins/builtin/market-movers/screener.ts +18 -4
  349. package/src/plugins/builtin/members/breadth-pane.tsx +3 -3
  350. package/src/plugins/builtin/members/client.ts +24 -2
  351. package/src/plugins/builtin/members/headless.ts +66 -9
  352. package/src/plugins/builtin/members/index.tsx +7 -6
  353. package/src/plugins/builtin/members/model.ts +89 -5
  354. package/src/plugins/builtin/members/pane.tsx +70 -21
  355. package/src/plugins/builtin/mna/distress/pane.tsx +2 -1
  356. package/src/plugins/builtin/mna/pane.tsx +1 -1
  357. package/src/plugins/builtin/money-markets/client.ts +43 -15
  358. package/src/plugins/builtin/money-markets/headless.ts +18 -11
  359. package/src/plugins/builtin/money-markets/index.tsx +7 -6
  360. package/src/plugins/builtin/money-markets/model.ts +20 -5
  361. package/src/plugins/builtin/money-markets/pane.tsx +28 -17
  362. package/src/plugins/builtin/news/wire/news/footer.ts +11 -1
  363. package/src/plugins/builtin/news/wire/news/table.tsx +15 -5
  364. package/src/plugins/builtin/notes/headless.ts +94 -0
  365. package/src/plugins/builtin/notes/index.tsx +3 -1
  366. package/src/plugins/builtin/notes/store.ts +10 -3
  367. package/src/plugins/builtin/options/footer.ts +8 -2
  368. package/src/plugins/builtin/options/open-interest-as-of.ts +12 -3
  369. package/src/plugins/builtin/options/view.tsx +10 -1
  370. package/src/plugins/builtin/options-calculator/pane.tsx +1 -1
  371. package/src/plugins/builtin/options-positioning/client.ts +35 -8
  372. package/src/plugins/builtin/options-positioning/headless.ts +17 -7
  373. package/src/plugins/builtin/options-positioning/index.tsx +10 -0
  374. package/src/plugins/builtin/options-positioning/pane.tsx +16 -7
  375. package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +1 -1
  376. package/src/plugins/builtin/options-scenario/pane.tsx +1 -1
  377. package/src/plugins/builtin/pe-band/pane.tsx +2 -2
  378. package/src/plugins/builtin/perps/cascade-tabs.tsx +2 -2
  379. package/src/plugins/builtin/perps/client.ts +54 -15
  380. package/src/plugins/builtin/perps/headless.ts +39 -13
  381. package/src/plugins/builtin/perps/index.tsx +2 -1
  382. package/src/plugins/builtin/perps/model.ts +43 -1
  383. package/src/plugins/builtin/perps/pane.tsx +35 -18
  384. package/src/plugins/builtin/portfolio-list/allocation-rows.ts +74 -0
  385. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  386. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +7 -3
  387. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +33 -3
  388. package/src/plugins/builtin/portfolio-list/cli/render.ts +149 -24
  389. package/src/plugins/builtin/portfolio-list/headless.ts +30 -9
  390. package/src/plugins/builtin/portfolio-list/income.ts +17 -8
  391. package/src/plugins/builtin/portfolio-list/index.tsx +4 -4
  392. package/src/plugins/builtin/portfolio-list/pane/fx-day-moves.ts +52 -0
  393. package/src/plugins/builtin/portfolio-list/pane/index.tsx +76 -9
  394. package/src/plugins/builtin/portfolio-list/pane/target-weights.tsx +178 -0
  395. package/src/plugins/builtin/portfolio-list/period-pnl.ts +44 -5
  396. package/src/plugins/builtin/portfolio-list/settings.ts +12 -6
  397. package/src/plugins/builtin/portfolio-list/summary/index.tsx +9 -4
  398. package/src/plugins/builtin/portfolio-list/summary/totals.ts +21 -2
  399. package/src/plugins/builtin/portfolio-list/table.tsx +33 -25
  400. package/src/plugins/builtin/power/gas.tsx +2 -2
  401. package/src/plugins/builtin/power/prices.tsx +2 -2
  402. package/src/plugins/builtin/primary-dealers/pane.tsx +10 -11
  403. package/src/plugins/builtin/rate-path/model.ts +9 -0
  404. package/src/plugins/builtin/rate-path/pane.tsx +6 -5
  405. package/src/plugins/builtin/realized-vol/fx-proxy.ts +27 -0
  406. package/src/plugins/builtin/realized-vol/headless.ts +8 -6
  407. package/src/plugins/builtin/realized-vol/pane.tsx +13 -7
  408. package/src/plugins/builtin/relative-rotation/pane.tsx +1 -1
  409. package/src/plugins/builtin/research/analyst-headless.ts +5 -1
  410. package/src/plugins/builtin/research/analyst-model.ts +7 -1
  411. package/src/plugins/builtin/research/analyst-pane.tsx +1 -1
  412. package/src/plugins/builtin/research/relative-valuation-basis.ts +44 -4
  413. package/src/plugins/builtin/research/relative-valuation-headless.ts +59 -14
  414. package/src/plugins/builtin/research/relative-valuation-model.ts +65 -26
  415. package/src/plugins/builtin/research/relative-valuation-pane.tsx +42 -17
  416. package/src/plugins/builtin/revenue-breakdown/pane.tsx +1 -1
  417. package/src/plugins/builtin/reverse-dcf/client.ts +34 -4
  418. package/src/plugins/builtin/reverse-dcf/headless.ts +30 -15
  419. package/src/plugins/builtin/reverse-dcf/model.ts +190 -29
  420. package/src/plugins/builtin/reverse-dcf/pane.tsx +35 -13
  421. package/src/plugins/builtin/risk-factors/pane.tsx +2 -2
  422. package/src/plugins/builtin/roadmap/pane.tsx +2 -2
  423. package/src/plugins/builtin/scanner/flow-pane.tsx +4 -4
  424. package/src/plugins/builtin/scanner/headless.ts +15 -1
  425. package/src/plugins/builtin/seasonality/pane.tsx +1 -1
  426. package/src/plugins/builtin/sec/fund-facts-view.tsx +5 -2
  427. package/src/plugins/builtin/sec/fund-facts.ts +41 -1
  428. package/src/plugins/builtin/sec/headless.ts +8 -4
  429. package/src/plugins/builtin/sec/index.tsx +41 -13
  430. package/src/plugins/builtin/shared/ticker-company.ts +111 -0
  431. package/src/plugins/builtin/shared/use-quote-board.ts +37 -2
  432. package/src/plugins/builtin/shared/volatility/live-session.ts +23 -0
  433. package/src/plugins/builtin/shared/volatility-indices.ts +2 -0
  434. package/src/plugins/builtin/short-interest/publications-pane.tsx +1 -1
  435. package/src/plugins/builtin/short-volume/pane.tsx +1 -1
  436. package/src/plugins/builtin/social-mentions/outliers.tsx +3 -3
  437. package/src/plugins/builtin/social-mentions/pane.tsx +2 -2
  438. package/src/plugins/builtin/supply-chain/graph-pane.tsx +1 -1
  439. package/src/plugins/builtin/supply-chain/pane.tsx +1 -1
  440. package/src/plugins/builtin/themes/pane.tsx +4 -4
  441. package/src/plugins/builtin/thirteenf/api.ts +1 -0
  442. package/src/plugins/builtin/thirteenf/format.ts +5 -0
  443. package/src/plugins/builtin/thirteenf/headless.ts +2 -2
  444. package/src/plugins/builtin/thirteenf/model.ts +128 -5
  445. package/src/plugins/builtin/thirteenf/overlap-pane.tsx +1 -1
  446. package/src/plugins/builtin/thirteenf/report-notes.ts +10 -3
  447. package/src/plugins/builtin/thirteenf/signals-pane.tsx +1 -1
  448. package/src/plugins/builtin/thirteenf/table.ts +2 -2
  449. package/src/plugins/builtin/thirteenf/types.ts +12 -0
  450. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +27 -14
  451. package/src/plugins/builtin/ticker-detail/data-panes/returns-history.ts +6 -3
  452. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +14 -0
  453. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +4 -1
  454. package/src/plugins/builtin/ticker-detail/financials/aggregation.ts +87 -19
  455. package/src/plugins/builtin/ticker-detail/financials/exchange-results.ts +54 -0
  456. package/src/plugins/builtin/ticker-detail/financials/model.ts +114 -9
  457. package/src/plugins/builtin/ticker-detail/financials/ratios.ts +37 -20
  458. package/src/plugins/builtin/ticker-detail/financials/tab.tsx +42 -19
  459. package/src/plugins/builtin/ticker-detail/headless-schema.ts +3 -2
  460. package/src/plugins/builtin/ticker-detail/headless.ts +90 -31
  461. package/src/plugins/builtin/ticker-detail/overview/model.ts +22 -15
  462. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +5 -2
  463. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +12 -7
  464. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +21 -0
  465. package/src/plugins/builtin/trace-bonds/client.ts +107 -10
  466. package/src/plugins/builtin/trace-bonds/detail.tsx +1 -1
  467. package/src/plugins/builtin/trace-bonds/headless.ts +20 -5
  468. package/src/plugins/builtin/trace-bonds/pane.tsx +15 -4
  469. package/src/plugins/builtin/treasury-auctions/hk-view.tsx +1 -1
  470. package/src/plugins/builtin/treasury-auctions/pane.tsx +1 -1
  471. package/src/plugins/builtin/treasury-daily/pane.tsx +2 -2
  472. package/src/plugins/builtin/vol-surface/charts.tsx +30 -5
  473. package/src/plugins/builtin/vol-surface/client.ts +40 -12
  474. package/src/plugins/builtin/vol-surface/events.ts +213 -0
  475. package/src/plugins/builtin/vol-surface/headless.ts +82 -13
  476. package/src/plugins/builtin/vol-surface/index.tsx +5 -1
  477. package/src/plugins/builtin/vol-surface/model.ts +42 -6
  478. package/src/plugins/builtin/vol-surface/pane.tsx +95 -23
  479. package/src/plugins/builtin/volatility/dvol.ts +14 -2
  480. package/src/plugins/builtin/volatility/headless.ts +3 -2
  481. package/src/plugins/builtin/volatility/index.tsx +1 -1
  482. package/src/plugins/builtin/volatility/pane.tsx +1 -1
  483. package/src/plugins/builtin/volatility/series.ts +7 -3
  484. package/src/plugins/builtin/world-venue-map/activity-series.ts +89 -0
  485. package/src/plugins/builtin/world-venue-map/chokepoint-report.ts +123 -0
  486. package/src/plugins/builtin/world-venue-map/evidence.ts +2 -0
  487. package/src/plugins/builtin/world-venue-map/geo-series.ts +35 -1
  488. package/src/plugins/builtin/world-venue-map/headless.ts +58 -9
  489. package/src/plugins/builtin/world-venue-map/index.ts +6 -3
  490. package/src/plugins/builtin/world-venue-map/layered-pane.tsx +6 -1
  491. package/src/plugins/builtin/world-venue-map/pane.tsx +4 -3
  492. package/src/plugins/builtin/yield-curve/index.tsx +12 -10
  493. package/src/plugins/builtin/yield-curve/swaps.tsx +1 -1
  494. package/src/plugins/extracted-plugins.ts +14 -10
  495. package/src/plugins/installer.ts +17 -1
  496. package/src/plugins/marketplace/feed.ts +14 -0
  497. package/src/plugins/marketplace/install-offer.ts +64 -0
  498. package/src/plugins/registry/contributions.ts +46 -8
  499. package/src/plugins/registry/index.ts +5 -0
  500. package/src/portfolio/collection-name.ts +38 -4
  501. package/src/portfolio/column-values.ts +32 -4
  502. package/src/portfolio/period-pnl.ts +4 -2
  503. package/src/react/async-resource.ts +24 -8
  504. package/src/remote/endpoint.ts +38 -12
  505. package/src/remote/secrets.ts +22 -6
  506. package/src/remote/server.ts +20 -4
  507. package/src/renderers/dom/data-table/index.tsx +2 -1
  508. package/src/renderers/dom/data-table/row.tsx +49 -7
  509. package/src/renderers/dom/desktop/controls.tsx +2 -0
  510. package/src/renderers/dom/desktop/query-bar.tsx +57 -7
  511. package/src/renderers/dom/host/surface-3d.tsx +46 -5
  512. package/src/renderers/dom/styles.css +17 -0
  513. package/src/renderers/electrobun/view/backend-rpc.ts +15 -21
  514. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +16 -61
  515. package/src/renderers/electrobun/view/cli-pane-shot-socket.ts +134 -0
  516. package/src/renderers/electrobun/view/host-route.ts +119 -0
  517. package/src/renderers/electrobun/view/rpc-timeout.ts +6 -5
  518. package/src/renderers/opentui/toast-host.tsx +6 -3
  519. package/src/renderers/opentui/ui-host.tsx +29 -5
  520. package/src/series/registry.ts +1 -0
  521. package/src/series/standalone-catalog.ts +40 -0
  522. package/src/series/types.ts +10 -0
  523. package/src/series/validate.ts +5 -0
  524. package/src/shares/portable-layout.ts +2 -7
  525. package/src/sources/gloomberb-cloud/dated-chunks.ts +133 -0
  526. package/src/sources/gloomberb-cloud/index.ts +46 -5
  527. package/src/sources/gloomberb-cloud/news.ts +15 -9
  528. package/src/sources/gloomberb-cloud/normalizers.ts +17 -0
  529. package/src/sources/history-coverage.ts +13 -0
  530. package/src/sources/history-result.ts +1 -0
  531. package/src/sources/provider-errors.ts +9 -0
  532. package/src/sources/provider-router/batches.ts +7 -3
  533. package/src/sources/provider-router/financial-routes.ts +3 -1
  534. package/src/sources/provider-router/history.ts +6 -4
  535. package/src/sources/provider-router/index.ts +5 -1
  536. package/src/sources/provider-router/primary.ts +4 -3
  537. package/src/sources/provider-router/retrieved-at.ts +12 -0
  538. package/src/team/store.ts +17 -4
  539. package/src/telemetry/crash-reports.ts +3 -1
  540. package/src/test-support/cli-context.ts +3 -2
  541. package/src/test-support/test-env.ts +7 -0
  542. package/src/theme/themes.ts +16 -9
  543. package/src/theme/tone-contrast.ts +29 -5
  544. package/src/tickers/company-name-listing.ts +31 -3
  545. package/src/tickers/company-name.ts +9 -0
  546. package/src/tickers/index-roots.ts +56 -4
  547. package/src/tickers/listing-name.ts +7 -2
  548. package/src/tickers/listing-venues.ts +17 -2
  549. package/src/tickers/search/home-listing.ts +2 -0
  550. package/src/tickers/search/index.ts +64 -11
  551. package/src/tickers/search/major-listings.json +595 -592
  552. package/src/tickers/search/ranking.ts +19 -1
  553. package/src/tickers/terminal-codes.ts +5 -3
  554. package/src/time-series/bar-aggregation.ts +3 -2
  555. package/src/time-series/base-series.ts +18 -1
  556. package/src/time-series/chart-data.ts +9 -6
  557. package/src/time-series/chart-seed.ts +11 -3
  558. package/src/time-series/currency-conversion.ts +1 -0
  559. package/src/time-series/date-window.ts +8 -0
  560. package/src/time-series/formula-months.ts +57 -0
  561. package/src/time-series/fundamentals/period-points.ts +3 -3
  562. package/src/time-series/fundamentals/source-statements.ts +5 -4
  563. package/src/time-series/leverage.ts +12 -4
  564. package/src/time-series/live-bars.ts +12 -7
  565. package/src/time-series/live-quotes.ts +6 -2
  566. package/src/time-series/market.ts +10 -3
  567. package/src/time-series/price-comparison.ts +106 -0
  568. package/src/time-series/range.ts +10 -0
  569. package/src/time-series/resolve-context.ts +7 -2
  570. package/src/time-series/resolve.ts +61 -5
  571. package/src/time-series/series-name.ts +2 -2
  572. package/src/time-series/series-presentation.ts +91 -2
  573. package/src/time-series/session-bar.ts +13 -7
  574. package/src/time-series/spec.ts +21 -2
  575. package/src/time-series/studies/formula.ts +262 -36
  576. package/src/time-series/studies/leverage.ts +9 -3
  577. package/src/time-series/studies/resolve.ts +7 -2
  578. package/src/time-series/types.ts +34 -0
  579. package/src/time-series/use-chart-resolution.ts +18 -1
  580. package/src/types/data-provider.ts +7 -0
  581. package/src/types/financials.ts +103 -1
  582. package/src/types/headless.ts +64 -3
  583. package/src/types/instrument.ts +6 -0
  584. package/src/types/plugin-context.ts +9 -0
  585. package/src/types/plugin-pane-templates.ts +6 -0
  586. package/src/types/plugin-panes.ts +7 -0
  587. package/src/types/price-history.ts +6 -0
  588. package/src/ui/host.tsx +3 -1
  589. package/src/ui/index.tsx +7 -2
  590. package/src/utils/cli-output.ts +21 -1
  591. package/src/utils/currency-units.ts +14 -0
  592. package/src/utils/datetime-format.ts +11 -0
  593. package/src/utils/exchange-announcements.ts +26 -3
  594. package/src/utils/exchange-notation.generated.ts +3 -4
  595. package/src/utils/exchange-results.ts +144 -0
  596. package/src/utils/exchanges.ts +10 -0
  597. package/src/utils/financial-statements.ts +212 -22
  598. package/src/utils/fire-and-forget.ts +1 -1
  599. package/src/utils/fiscal-period.ts +41 -3
  600. package/src/utils/format.ts +10 -6
  601. package/src/utils/fundamentals.ts +179 -12
  602. package/src/utils/futures-generic.ts +26 -0
  603. package/src/utils/lease-liabilities.ts +15 -5
  604. package/src/utils/lookup-token.ts +22 -0
  605. package/src/utils/max-drawdown.ts +25 -4
  606. package/src/utils/price-history-integrity.ts +56 -8
  607. package/src/utils/price-history.ts +6 -2
  608. package/src/utils/price-window.ts +38 -2
  609. package/src/utils/replace-file.ts +47 -0
  610. package/src/utils/rpc-timeout-error.ts +16 -2
  611. package/src/utils/untrusted-text.ts +14 -0
@@ -75,6 +75,7 @@ import { useThrottledCursorSymbol } from "../use-throttled-cursor-symbol";
75
75
  import { useCursorNeighborPrefetch } from "../use-cursor-neighbor-prefetch";
76
76
  import { getSharedRegistry } from "../../../registry";
77
77
  import { usePluginAppActions, usePluginBrokerActions } from "../../../runtime";
78
+ import { useFxDayMoves } from "./fx-day-moves";
78
79
  import { isManualPortfolio } from "../../../../portfolio/mutations";
79
80
  import {
80
81
  cursorAfterRemoval,
@@ -114,12 +115,15 @@ import { usePurchaseDateCostFx } from "./purchase-date-fx";
114
115
  import { periodFxLine, periodPnlLabel, periodPnlNotices, usePanePeriodPnl } from "./period-pnl";
115
116
  import type { LoadedPeriodPnl } from "../period-pnl";
116
117
  import {
118
+ allocationFigures,
117
119
  allocationWeightBase,
118
120
  buildPortfolioAllocation,
119
121
  CASH_SYMBOL,
120
122
  hasTargetWeights,
121
123
  resolvePortfolioCash,
122
124
  } from "../../../../portfolio/allocation";
125
+ import { allocationSummaryRows, CASH_ROW_KEY } from "../allocation-rows";
126
+ import { useTargetWeightActions, type TargetRow } from "./target-weights";
123
127
 
124
128
  /** Columns that need the portfolio's total. */
125
129
  const ALLOCATION_COLUMN_IDS = new Set(["weight", "drift", "trade", "trade_value"]);
@@ -129,8 +133,12 @@ const ALLOCATION_COLUMN_IDS = new Set(["weight", "drift", "trade", "trade_value"
129
133
  const FOOTER_TOTALS_THROTTLE_MS = 250;
130
134
  const WEIGHT_TOTAL_THROTTLE_MS = 1_000;
131
135
  const DAY_MS = 86_400_000;
136
+ /** DRIFT sorts by its size, so its first click puts the largest drift on top. */
137
+ const firstSortDirection = (columnId: string) => columnId === "drift" ? "desc" as const : "asc" as const;
132
138
  /** One fallback for every render: a fresh `{}` would read as a changed value each time. */
133
139
  const NO_COLLECTION_SORTS: Record<string, CollectionSortPreference> = {};
140
+ /** What the pane's `cursorSummaryRow` holds while the cursor is on the CASH row. */
141
+ const CASH_SUMMARY_ROW = "cash";
134
142
 
135
143
  export function PortfolioListPane({ focused, width, height }: PaneProps) {
136
144
  const activateTicker = useTickerSourceActivate();
@@ -146,6 +154,18 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
146
154
 
147
155
  const [currentCollectionId, setCurrentCollectionId] = usePaneStateValue<string>("collectionId", paneCollection.collectionId ?? "");
148
156
  const [committedCursorSymbol, setCommittedCursorSymbol] = usePaneStateValue<string | null>("cursorSymbol", null);
157
+ // The CASH row's cursor has a key of its own: `cursorSymbol`, which followers, recent tickers and saved layouts
158
+ // read, only ever holds a ticker, and keeps the last one while the cursor is on cash.
159
+ const [cursorSummaryRow, setCursorSummaryRow] = usePaneStateValue<string | null>("cursorSummaryRow", null);
160
+ const committedCursorRow = cursorSummaryRow === CASH_SUMMARY_ROW ? CASH_ROW_KEY : committedCursorSymbol;
161
+ const commitCursorRow = useCallback((row: string | null) => {
162
+ if (row === CASH_ROW_KEY) {
163
+ setCursorSummaryRow(CASH_SUMMARY_ROW);
164
+ return;
165
+ }
166
+ setCursorSummaryRow(null);
167
+ setCommittedCursorSymbol(row);
168
+ }, [setCommittedCursorSymbol, setCursorSummaryRow]);
149
169
  const [collectionSorts, setCollectionSorts] = usePaneStateValue<Record<string, CollectionSortPreference>>("collectionSorts", NO_COLLECTION_SORTS);
150
170
  const [cashDrawerExpanded, setCashDrawerExpanded] = usePaneStateValue<boolean>("cashDrawerExpanded", false);
151
171
  const [, setViewMode] = usePaneSettingValue<PortfolioViewMode>("viewMode", "table");
@@ -158,7 +178,7 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
158
178
  setCursorSymbol,
159
179
  flushCursorSymbol,
160
180
  cancelPendingCursorSymbol,
161
- } = useThrottledCursorSymbol(committedCursorSymbol, setCommittedCursorSymbol);
181
+ } = useThrottledCursorSymbol(committedCursorRow, commitCursorRow);
162
182
 
163
183
  const paneSettings = useMemo(
164
184
  () => getPortfolioPaneSettings(paneInstance?.settings),
@@ -262,6 +282,8 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
262
282
  [accountState, cashLine, financialsMap, tickers, totalsCurrency],
263
283
  );
264
284
  const exchangeRates = useFxRatesMap(trackedCurrencies);
285
+ // The day's move of a holding in another currency holds that currency's move, as `portfolio show` counts it.
286
+ const fxDayMoves = useFxDayMoves(isPortfolioTab ? trackedCurrencies : [], totalsCurrency);
265
287
  const conversionCurrencies = trackedCurrencies.some((currency) => currency !== totalsCurrency) ? trackedCurrencies : [];
266
288
  const fxStatus = summarizeFxRates(conversionCurrencies, exchangeRates, (currency) => getSharedMarketDataCoordinator()?.getFxEntry(currency));
267
289
  const fxStatusText = fxStatusLabel(fxStatus);
@@ -309,9 +331,10 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
309
331
  activeCollectionId,
310
332
  valuationBasis,
311
333
  futuresTerms.terms,
334
+ fxDayMoves,
312
335
  ),
313
336
  [financialsMap],
314
- [activeCollectionId, exchangeRates, futuresTerms.terms, isPortfolioTab, tickers, totalsCurrency, valuationBasis],
337
+ [activeCollectionId, exchangeRates, futuresTerms.terms, fxDayMoves, isPortfolioTab, tickers, totalsCurrency, valuationBasis],
315
338
  FOOTER_TOTALS_THROTTLE_MS,
316
339
  );
317
340
 
@@ -323,6 +346,7 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
323
346
  homeMarket,
324
347
  baseCurrency: totalsCurrency,
325
348
  exchangeRates,
349
+ fxDayMoves,
326
350
  valuationBasis,
327
351
  portfolioWeightBase,
328
352
  portfolioWeightBasis,
@@ -339,6 +363,7 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
339
363
  }), [
340
364
  activeCollectionId,
341
365
  exchangeRates,
366
+ fxDayMoves,
342
367
  futuresTerms,
343
368
  homeMarket,
344
369
  isPortfolioTab,
@@ -410,7 +435,6 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
410
435
  });
411
436
 
412
437
  const selectedIdx = sortedTickers.findIndex((ticker) => ticker.metadata.ticker === cursorSymbol);
413
- const safeSelectedIdx = selectedIdx >= 0 ? selectedIdx : 0;
414
438
 
415
439
  const prefetchInstrument = useCallback((instrument: InstrumentRef) => {
416
440
  getSharedMarketDataCoordinator()?.warmTickerGaps(instrument);
@@ -443,6 +467,20 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
443
467
  });
444
468
  return allocation.cash ? { ...allocation.cash, total: allocation.total } : null;
445
469
  }, [accountState, cashLine, cashValue, isPortfolioTab, portfolioSummaryTotals, portfolioTargets]);
470
+ // Under the holdings of a book with cash entered by hand or targets, its CASH and TOTAL rows, as
471
+ // `portfolio show` prints them: cash takes a target and a trade like a holding, so the trades add up.
472
+ const showsAllocationRows = isPortfolioTab && viewMode === "table" && !paneSettings.hideCash
473
+ && (cashLine?.source === "manual" || hasTargetWeights(currentPortfolio));
474
+ const allocationRows = useMemo(() => {
475
+ if (!showsAllocationRows) return undefined;
476
+ const allocation = buildPortfolioAllocation({
477
+ holdings: portfolioSummaryTotals.allocationHoldings ?? [],
478
+ cashValue: cashValue ?? (cashLine ? Number.NaN : null),
479
+ targets: portfolioTargets,
480
+ });
481
+ return allocationSummaryRows(allocation, { cashCurrency: cashLine?.currency, currency: totalsCurrency });
482
+ }, [cashLine, cashValue, portfolioSummaryTotals, portfolioTargets, showsAllocationRows, totalsCurrency]);
483
+ const cashRowShown = !!allocationRows?.some((row) => row.id === "cash");
446
484
  const summarySegments = useMemo(() => buildPortfolioSummarySegments({
447
485
  totals: portfolioSummaryTotals,
448
486
  accountState: summaryAccountState,
@@ -453,12 +491,13 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
453
491
  manualCash,
454
492
  brokerPortfolio,
455
493
  valuationBasis,
494
+ cashInTable: cashRowShown,
456
495
  period: periodColumns ? {
457
496
  label: periodPnlLabel(periodColumns),
458
497
  total: periodColumns.result?.total ?? null,
459
498
  contribution: periodColumns.result?.totalContribution ?? null,
460
499
  } : null,
461
- }), [brokerPortfolio, config.baseCurrency, convertAccountValue, isPortfolioTab, manualCash, periodColumns, portfolioSummaryTotals, summaryAccountState, totalsCurrency, valuationBasis]);
500
+ }), [brokerPortfolio, cashRowShown, config.baseCurrency, convertAccountValue, isPortfolioTab, manualCash, periodColumns, portfolioSummaryTotals, summaryAccountState, totalsCurrency, valuationBasis]);
462
501
  // The header row sits in the pane's one-cell side padding, like the table.
463
502
  const summaryWidth = Math.max(0, width - 2);
464
503
  const summaryLayout = useMemo(() => layoutPortfolioSummaryHeader(summarySegments, summaryWidth, {
@@ -517,7 +556,10 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
517
556
  }, [activeCollectionId, collectionSorts, setCollectionSorts]);
518
557
 
519
558
  const handleHeaderClick = useCallback((columnId: string) => {
520
- setSortPreference(nextHeaderSort(activeSort, columnId, { resetTo: { columnId: null, direction: "asc" } }));
559
+ setSortPreference(nextHeaderSort(activeSort, columnId, {
560
+ firstDirection: firstSortDirection,
561
+ resetTo: { columnId: null, direction: "asc" },
562
+ }));
521
563
  }, [activeSort.columnId, activeSort.direction, setSortPreference]);
522
564
 
523
565
  const openTickerFloating = useCallback((symbol: string, options?: { newPane?: boolean }) => {
@@ -558,13 +600,14 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
558
600
  if (isEnter && event.shift && !event.ctrl && !event.meta && !event.alt) {
559
601
  event.preventDefault?.();
560
602
  event.stopPropagation?.();
561
- const ticker = sortedTickers[safeSelectedIdx];
603
+ // The cash row opens nothing.
604
+ const ticker = selectedIdx >= 0 ? sortedTickers[selectedIdx] : undefined;
562
605
  if (ticker) openTickerInNewPane(ticker);
563
606
  return true;
564
607
  }
565
608
 
566
609
  return false;
567
- }, [dismissSinceLastSeen, focused, openTickerInNewPane, safeSelectedIdx, sortedTickers]);
610
+ }, [dismissSinceLastSeen, focused, openTickerInNewPane, selectedIdx, sortedTickers]);
568
611
 
569
612
  useEffect(() => {
570
613
  if (activeCollectionId !== currentCollectionId) {
@@ -579,11 +622,13 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
579
622
  return;
580
623
  }
581
624
 
582
- const hasSelection = cursorSymbol && sortedTickers.some((ticker) => ticker.metadata.ticker === cursorSymbol);
625
+ // The cash row takes the cursor too, while it is shown.
626
+ const hasSelection = cursorSymbol && ((cursorSymbol === CASH_ROW_KEY && cashRowShown)
627
+ || sortedTickers.some((ticker) => ticker.metadata.ticker === cursorSymbol));
583
628
  if (!hasSelection) {
584
629
  setCursorSymbol(sortedTickers[0]!.metadata.ticker, { immediate: true });
585
630
  }
586
- }, [cursorSymbol, setCursorSymbol, sortedTickers]);
631
+ }, [cashRowShown, cursorSymbol, setCursorSymbol, sortedTickers]);
587
632
 
588
633
  const effectiveStreamWindow = useMemo(() => (
589
634
  viewMode === "grid"
@@ -717,6 +762,21 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
717
762
  onSelect: () => openPerpMarket(cursorMarket.marketId) }]
718
763
  : null, [cursorMarket, cursorPerpetual, openPerpMarket]);
719
764
 
765
+ // The cursor row's target weight: a holding's, or the cash line's on the CASH row.
766
+ const targetRow = useMemo<TargetRow | null>(() => {
767
+ if (!isPortfolioTab || !currentPortfolio) return null;
768
+ if (cursorSymbol === CASH_ROW_KEY) {
769
+ return cashRowShown ? { cash: true, symbol: CASH_SYMBOL, label: "Cash", weight: cashWeight(cashValue, portfolioWeightBase, portfolioWeightBasis) } : null;
770
+ }
771
+ if (!selectedTicker) return null;
772
+ const symbol = selectedTicker.metadata.ticker;
773
+ const holding = weightHoldings?.find((entry) => entry.symbol === symbol);
774
+ const weight = holding ? allocationFigures(holding, portfolioWeightBase, null).weight : null;
775
+ return { cash: false, symbol, label: symbol, weight };
776
+ }, [cashRowShown, cashValue, currentPortfolio, cursorSymbol, isPortfolioTab, portfolioWeightBase, portfolioWeightBasis, selectedTicker, weightHoldings]);
777
+ const listedSymbols = useMemo(() => new Set(collectionTickers.map((ticker) => ticker.metadata.ticker)), [collectionTickers]);
778
+ useTargetWeightActions({ portfolio: currentPortfolio, row: targetRow, listedSymbols, enabled: focused && viewMode === "table" && !quickAddFocused });
779
+
720
780
  usePaneFooter("portfolio-list", () => ({
721
781
  info: [
722
782
  ...offlineBrokerFooter.asOf,
@@ -860,6 +920,7 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
860
920
  width={width}
861
921
  answeredSnapshots={answeredSnapshots}
862
922
  exportName={activeCollectionEntry?.name}
923
+ allocationRows={allocationRows}
863
924
  />
864
925
  ) : (
865
926
  <PortfolioGrid
@@ -896,6 +957,12 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
896
957
  );
897
958
  }
898
959
 
960
+ /** The cash line's weight, as its row shows it: none against a hedged book's gross exposure. */
961
+ function cashWeight(cashValue: number | null, weightBase: number | undefined, basis: "total" | "gross" | undefined): number | null {
962
+ if (cashValue == null || basis === "gross") return null;
963
+ return allocationFigures({ held: true, marketValue: cashValue, units: 0, unitPrice: null }, weightBase, null).weight;
964
+ }
965
+
899
966
  /** The quotes of the rows, in order, for the delayed clock, which stops at the first late one. */
900
967
  function* rowQuotes(tickers: readonly TickerRecord[], financialsMap: ReadonlyMap<string, TickerFinancials>) {
901
968
  for (const ticker of tickers) yield financialsMap.get(ticker.metadata.ticker)?.quote;
@@ -0,0 +1,178 @@
1
+ import { useCallback, useRef } from "react";
2
+ import { TextPromptDialog, usePaneFooter } from "../../../../components";
3
+ import { tf } from "../../../../i18n";
4
+ import {
5
+ CASH_SYMBOL,
6
+ describeTargetSum,
7
+ formatAllocationWeight,
8
+ holdingTarget,
9
+ parseTargetWeight,
10
+ } from "../../../../portfolio/allocation";
11
+ import { clearPortfolioTargetWeights, setPortfolioTargetWeight } from "../../../../portfolio/mutations";
12
+ import { syncConfigActiveLayoutState, useAppDispatch, useAppStateRef } from "../../../../state/app/context";
13
+ import { scheduleConfigSave } from "../../../../state/config-save-scheduler";
14
+ import type { AppConfig } from "../../../../types/config";
15
+ import type { Portfolio } from "../../../../types/ticker";
16
+ import { useDialog } from "../../../../ui/dialog";
17
+ import { logFailure } from "../../../../utils/log-failure";
18
+ import { usePluginAppActions } from "../../../runtime";
19
+
20
+ /** `t` sets the cursor row's target weight, Shift+T clears it: the pane menu shows both beside them. */
21
+ const SET_TARGET_KEY = "t";
22
+ const CLEAR_TARGET_KEY = "T";
23
+
24
+ /** The row a target goes on: a holding by its key, or the cash line. */
25
+ export interface TargetRow {
26
+ /** The CASH row, the cash line; never a holding, whatever its symbol. */
27
+ cash: boolean;
28
+ /** The key the target is saved under: the ticker's, or CASH. */
29
+ symbol: string;
30
+ /** How the row reads in a message: AAPL, or Cash. */
31
+ label: string;
32
+ /** Its weight now, in percent, when known. */
33
+ weight: number | null;
34
+ }
35
+
36
+ /** "AAPL in Family Office: weight 10.6%, target 8.0%." The dialog's first line. */
37
+ function describeRow(row: TargetRow, portfolio: Portfolio): string {
38
+ const target = row.cash ? portfolio.targetWeights?.[CASH_SYMBOL] : holdingTarget(portfolio.targetWeights, row.symbol);
39
+ const parts = [
40
+ row.weight != null ? `weight ${formatAllocationWeight(row.weight)}` : null,
41
+ target != null ? `target ${formatAllocationWeight(target)}` : "no target",
42
+ ].filter(Boolean);
43
+ return `${row.label} in ${portfolio.name}: ${parts.join(", ")}.`;
44
+ }
45
+
46
+ /** The note under a change when the targets of the listed rows and cash do not add up to the whole. */
47
+ function targetSumNote(config: AppConfig, portfolioId: string, listed: ReadonlySet<string>): string | null {
48
+ const portfolio = config.portfolios.find((entry) => entry.id === portfolioId);
49
+ let sum: number | null = null;
50
+ for (const [symbol, weight] of Object.entries(portfolio?.targetWeights ?? {})) {
51
+ if (symbol === CASH_SYMBOL || listed.has(symbol)) sum = (sum ?? 0) + weight;
52
+ }
53
+ return describeTargetSum(sum);
54
+ }
55
+
56
+ /**
57
+ * Setting and clearing the cursor row's target weight from PF, cash
58
+ * included: `t` asks for the weight and Shift+T clears it, both in the pane
59
+ * menu too. The same mutations `portfolio target set` and `target clear` save.
60
+ * Nothing is offered without a portfolio or a row.
61
+ */
62
+ export function useTargetWeightActions({
63
+ portfolio,
64
+ row,
65
+ listedSymbols,
66
+ enabled,
67
+ }: {
68
+ portfolio: Portfolio | null;
69
+ row: TargetRow | null;
70
+ /** The book's rows by key, which the targets' sum counts. */
71
+ listedSymbols: ReadonlySet<string>;
72
+ enabled: boolean;
73
+ }) {
74
+ const dialog = useDialog();
75
+ const dispatch = useAppDispatch();
76
+ const stateRef = useAppStateRef();
77
+ const { notify } = usePluginAppActions();
78
+ const busyRef = useRef(false);
79
+ const latest = useRef({ portfolio, row, listedSymbols });
80
+ latest.current = { portfolio, row, listedSymbols };
81
+
82
+ // With the panes' live state in the layout, so the config keeps the cursor where the target was set.
83
+ const save = useCallback((config: AppConfig) => {
84
+ const state = stateRef.current;
85
+ const synced = syncConfigActiveLayoutState(config, state.paneState, state.focusedPaneId);
86
+ dispatch({ type: "SET_CONFIG", config: synced });
87
+ scheduleConfigSave(synced);
88
+ }, [dispatch, stateRef]);
89
+
90
+ // A holding whose symbol is CASH: targets keep that key for the cash line, so it can take none.
91
+ const refuseCashNamedHolding = useCallback((target: TargetRow, book: Portfolio) => {
92
+ if (target.cash || target.symbol !== CASH_SYMBOL) return false;
93
+ notify({ type: "info", body: tf("The holding CASH takes no target: a target on CASH is the cash line's in {portfolio}.", { portfolio: book.name }) });
94
+ return true;
95
+ }, [notify]);
96
+
97
+ const setTarget = useCallback(async () => {
98
+ const { portfolio: book, row: target, listedSymbols: listed } = latest.current;
99
+ if (!book || !target || busyRef.current || refuseCashNamedHolding(target, book)) return;
100
+ busyRef.current = true;
101
+ try {
102
+ const current = target.cash ? book.targetWeights?.[CASH_SYMBOL] : holdingTarget(book.targetWeights, target.symbol);
103
+ const typed = await dialog.prompt<string>({
104
+ content: (context) => (
105
+ <TextPromptDialog
106
+ {...context}
107
+ title="Set Target Weight"
108
+ body={[describeRow(target, book)]}
109
+ label="Target"
110
+ initialValue={current != null ? formatAllocationWeight(current).replace(/%$/, "") : ""}
111
+ placeholder="12.5%"
112
+ confirmLabel="Set"
113
+ />
114
+ ),
115
+ });
116
+ if (typed == null || !typed.trim()) return;
117
+ let weight: number;
118
+ try {
119
+ weight = parseTargetWeight(typed);
120
+ } catch (error) {
121
+ notify({ type: "error", body: error instanceof Error ? error.message : String(error) });
122
+ return;
123
+ }
124
+ // The config as it is now, in case a sync changed it while the dialog was open.
125
+ const next = setPortfolioTargetWeight(stateRef.current.config, book.id, target.symbol, weight);
126
+ save(next);
127
+ const note = targetSumNote(next, book.id, listed);
128
+ const values = { row: target.label, portfolio: book.name, weight: formatAllocationWeight(weight) };
129
+ notify({
130
+ type: "success",
131
+ body: [target.cash
132
+ ? tf("Set the cash target in {portfolio} to {weight}.", values)
133
+ : tf("Set the target for {row} in {portfolio} to {weight}.", values), note].filter(Boolean).join(" "),
134
+ });
135
+ } finally {
136
+ busyRef.current = false;
137
+ }
138
+ }, [dialog, notify, refuseCashNamedHolding, save, stateRef]);
139
+
140
+ // A dialog or save that fails says why, in the notice and the log.
141
+ const promptTarget = useCallback(() => {
142
+ setTarget().catch((error: unknown) => {
143
+ notify({ type: "error", body: error instanceof Error ? error.message : String(error) });
144
+ logFailure("portfolio-list.targets", "Set target weight failed")(error);
145
+ });
146
+ }, [notify, setTarget]);
147
+
148
+ const clearTarget = useCallback(() => {
149
+ const { portfolio: book, row: target, listedSymbols: listed } = latest.current;
150
+ if (!book || !target || refuseCashNamedHolding(target, book)) return;
151
+ const { config: next, removed } = clearPortfolioTargetWeights(stateRef.current.config, book.id, target.symbol);
152
+ const cash = target.cash;
153
+ const values = { row: target.label, portfolio: book.name };
154
+ if (removed.length === 0) {
155
+ notify({ type: "info", body: cash ? tf("{portfolio} has no cash target.", values) : tf("{portfolio} has no target for {row}.", values) });
156
+ return;
157
+ }
158
+ save(next);
159
+ const note = targetSumNote(next, book.id, listed);
160
+ notify({
161
+ type: "success",
162
+ body: [cash ? tf("Cleared the cash target in {portfolio}.", values) : tf("Cleared the target for {row} in {portfolio}.", values), note]
163
+ .filter(Boolean).join(" "),
164
+ });
165
+ }, [notify, refuseCashNamedHolding, save, stateRef]);
166
+
167
+ const offered = enabled && !!portfolio && !!row;
168
+ usePaneFooter("portfolio-list-targets", () => offered ? {
169
+ menu: [
170
+ { id: "set-target", label: "Set Target Weight…", accelerator: SET_TARGET_KEY, onSelect: promptTarget },
171
+ { id: "clear-target", label: "Clear Target", accelerator: `Shift+${CLEAR_TARGET_KEY}`, onSelect: clearTarget },
172
+ ],
173
+ keys: [
174
+ { id: "set-target", key: SET_TARGET_KEY, label: "", title: "Set Target Weight", onPress: promptTarget },
175
+ { id: "clear-target", key: CLEAR_TARGET_KEY, label: "", title: "Clear Target", onPress: clearTarget },
176
+ ],
177
+ } : null, [clearTarget, offered, promptTarget]);
178
+ }
@@ -10,6 +10,8 @@ import { cleanFloat32Price } from "../../../cli/history-rows";
10
10
  import type { DataProvider } from "../../../types/data-provider";
11
11
  import type { TickerRecord } from "../../../types/ticker";
12
12
  import { mapWithConcurrency } from "../../../utils/concurrency";
13
+ import { heldCurrencyUnit } from "../../../utils/currency-units";
14
+ import { fxPrintTradingDay, fxTradingDayAt } from "../../../utils/fx-market-hours";
13
15
  import { errorMessage } from "../../../utils/errors";
14
16
  import { logFailure } from "../../../utils/log-failure";
15
17
  import type { PriceWindow } from "../../../utils/price-window";
@@ -19,6 +21,7 @@ import { buildReturnRows, isTodayReturnRow, returnBaseCloseDay } from "../ticker
19
21
 
20
22
  /** Holdings whose daily closes are read at once: `portfolio show --from`, `fn PF --from` and `shot PF` alike. */
21
23
  const PERIOD_HISTORY_READS = 6;
24
+ const DAY_MS = 86_400_000;
22
25
 
23
26
  /**
24
27
  * Daily bars over any window: a day or two would otherwise be read in hourly
@@ -37,6 +40,11 @@ export interface LoadedPeriodPnl extends PeriodPnl {
37
40
  boughtInWindow: string[];
38
41
  /** When the window ends today with a session still trading: the latest price's time, in ms. */
39
42
  latestPriceAt: number | null;
43
+ /**
44
+ * The end rates read from the latest FX print, as `${currency}|${day}`: a window
45
+ * ending on the FX trading day in progress, which has no FX close yet.
46
+ */
47
+ latestFx: string[];
40
48
  }
41
49
 
42
50
  /**
@@ -105,7 +113,7 @@ export async function loadPeriodPnl({
105
113
  const units = metrics.unknownContractSize ? Number.NaN : metrics.totalPriceUnits;
106
114
  if (metrics.unknownContractSize) sizeUnknown.add(symbol);
107
115
  if (closes.partialEnd && quote) latestTimes.push(quoteHeadlineTime(quote));
108
- return { symbol, priceUnits: units, currency: quoteCurrency, ...closes };
116
+ return { symbol, priceUnits: units, currency: quoteCurrency, ...(metrics.isFuture ? { future: true } : {}), ...closes };
109
117
  });
110
118
  // 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
119
  const needed = new Map<string, { from: string; day: string }>();
@@ -114,10 +122,27 @@ export async function loadPeriodPnl({
114
122
  if (own) continue;
115
123
  for (const close of [holding.start, holding.end]) if (close) needed.set(`${major}|${close.day}`, { from: major, day: close.day });
116
124
  }
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));
125
+ // An end on the FX trading day in progress has no FX close for that day yet, and the day before's would leave the
126
+ // day's currency move out: it converts at the latest rate, the one the book is valued at live. So does an end on
127
+ // the FX day just closed (17:00 New York) while the daily series has yet to post its close.
128
+ const fxDay = fxPrintTradingDay(now);
129
+ const lastClosedFxDay = fxTradingDayAt(now - DAY_MS);
130
+ const latestFx: string[] = [];
131
+ const latest = async (key: string, from: string) => {
132
+ const rate = await latestFxRate(provider, from, currency);
133
+ if (rate != null) latestFx.push(key);
134
+ return rate;
135
+ };
136
+ const rates = new Map(await mapWithConcurrency([...needed], 4, async ([key, { from, day }]) => {
137
+ if (fxDay != null && day >= fxDay) {
138
+ const rate = await latest(key, from);
139
+ if (rate != null) return [key, rate] as const;
140
+ }
141
+ const reading = await loadCostFxRate(from, currency, day, fxHistory, new Date(now))
142
+ .catch(logFailure("portfolio.period-pnl", "Reading a window's FX close failed", null));
143
+ const unposted = lastClosedFxDay != null && day >= lastClosedFxDay && (!reading || reading.date < day);
144
+ return [key, (unposted ? await latest(key, from) : null) ?? reading?.rate ?? null] as const;
145
+ }));
121
146
  const rate = (from: string, day: string) => rates.get(`${from}|${day}`) ?? null;
122
147
  const result = periodPnl(holdings.map((holding) => Number.isFinite(holding.priceUnits) ? holding : { ...holding, start: null }), currency, rate);
123
148
  const failed = new Map(failures.map((failure) => [failure.symbol, failure.error]));
@@ -135,9 +160,23 @@ export async function loadPeriodPnl({
135
160
  return {
136
161
  ...result, window, failures: failures.sort((a, b) => a.symbol.localeCompare(b.symbol)), unpricedReasons, boughtInWindow,
137
162
  latestPriceAt: latestTimes.length ? Math.max(...latestTimes) : null,
163
+ latestFx: latestFx.sort(),
138
164
  };
139
165
  }
140
166
 
167
+ /**
168
+ * One unit of `from` (a major currency) in `into` at the latest FX print, as
169
+ * the live book converts it: both dollar rates the data provider holds. Null
170
+ * when either is unusable.
171
+ */
172
+ async function latestFxRate(provider: Pick<DataProvider, "getExchangeRate">, from: string, into: string): Promise<number | null> {
173
+ const intoUnit = heldCurrencyUnit(into);
174
+ const [fromUsd, intoUsd] = await Promise.all([from, intoUnit.currency].map((code) => code === "USD" ? Promise.resolve(1)
175
+ : provider.getExchangeRate(code).catch(logFailure("portfolio.period-pnl", "Reading the latest FX rate failed", null))));
176
+ const rate = fromUsd != null && intoUsd != null && intoUsd > 0 ? (fromUsd / intoUsd) * intoUnit.divisor : Number.NaN;
177
+ return Number.isFinite(rate) && rate > 0 ? rate : null;
178
+ }
179
+
141
180
  /** The one day every priced row shares at an end of the window, or null when they differ (a holiday on one venue). */
142
181
  export function periodSharedDay(rows: readonly PeriodPnlRow[], end: "start" | "end"): string | null {
143
182
  const days = new Set(rows.flatMap((row) => row[end] ? [row[end]!.day] : []));
@@ -181,18 +181,24 @@ function resolveCollectionOptions(entries: CollectionEntry[]): PaneSettingOption
181
181
 
182
182
  /** Columns that read a portfolio's target weights. */
183
183
  const TARGET_COLUMN_IDS = new Set(["target_weight", "drift", "trade", "trade_value"]);
184
- /** What a portfolio with targets shows when the pane's columns name none of them. */
185
- const REBALANCE_COLUMN_IDS = ["weight", "target_weight", "drift", "trade"];
184
+ /**
185
+ * What a portfolio with targets shows when the pane's columns name none of
186
+ * them: TRADE in units and TRADE VAL in money, where the cash line's trade
187
+ * shows and the trades add up to nothing.
188
+ */
189
+ const REBALANCE_COLUMN_IDS = ["weight", "target_weight", "drift", "trade", "trade_value"];
186
190
 
187
191
  /**
188
- * A portfolio with target weights shows WEIGHT, TGT WT, DRIFT and TRADE beside
189
- * its market value, unless the pane's columns already pick target columns.
192
+ * A portfolio with target weights shows WEIGHT, TGT WT, DRIFT, TRADE and
193
+ * TRADE VAL right after TICKER, where a rebalance reads them first, unless
194
+ * the pane's columns already pick target columns. A WEIGHT the columns place
195
+ * keeps its place, with the others after it.
190
196
  */
191
197
  function withTargetColumns(columnIds: string[]): string[] {
192
198
  if (columnIds.some((id) => TARGET_COLUMN_IDS.has(id))) return columnIds;
193
199
  const missing = REBALANCE_COLUMN_IDS.filter((id) => !columnIds.includes(id));
194
- const anchor = columnIds.includes("weight") ? columnIds.indexOf("weight") : columnIds.indexOf("mkt_value");
195
- const at = anchor >= 0 ? anchor + 1 : columnIds.length;
200
+ const anchor = columnIds.includes("weight") ? columnIds.indexOf("weight") : columnIds.indexOf("ticker");
201
+ const at = anchor + 1;
196
202
  return [...columnIds.slice(0, at), ...missing, ...columnIds.slice(at)];
197
203
  }
198
204
 
@@ -246,8 +246,11 @@ export function buildPortfolioSummarySegments({
246
246
  brokerPortfolio = false,
247
247
  valuationBasis,
248
248
  period = null,
249
+ cashInTable = false,
249
250
  }: {
250
251
  totals: PortfolioSummaryTotals;
252
+ /** The table shows the cash as its own row (with its target and trade), so the header leaves it out. */
253
+ cashInTable?: boolean;
251
254
  /**
252
255
  * P&L between two closes (the pane's P&L From) in place of P&L since cost:
253
256
  * its label names the closes, the total takes in the FX line, and the
@@ -333,8 +336,8 @@ export function buildPortfolioSummarySegments({
333
336
  }
334
337
 
335
338
  // A broker account always states its cash, so a missing balance reads as unknown rather than zero.
336
- if (broker && !manualCash) candidates.push(accountValue("cash", "Cash", account?.totalCashValue ?? Number.NaN)!);
337
- if (manualCash) {
339
+ if (broker && !manualCash && !cashInTable) candidates.push(accountValue("cash", "Cash", account?.totalCashValue ?? Number.NaN)!);
340
+ if (manualCash && !cashInTable) {
338
341
  const drift = formatAllocationDrift(manualCash.drift);
339
342
  candidates.push(createSummarySegment("cash", [
340
343
  { text: "Cash", tone: "label" },
@@ -354,10 +357,12 @@ export function buildPortfolioSummarySegments({
354
357
  { text: `(${formatPercentRaw(period.contribution ?? Number.NaN)})`, tone: "muted", color: period.contribution == null ? undefined : shownPriceColor(period.contribution, 2) },
355
358
  ]));
356
359
  }
360
+ // Beside cash entered by hand, which the Total counts, each percent says what it is of: the holdings, and their cost.
361
+ const holdingsOnly = !!manualCash && !broker;
357
362
  candidates.push(createSummarySegment("day", [
358
363
  { text: "Day", tone: "label" },
359
364
  { text: money(accountMetrics.dailyPnl, true), tone: "value", color: priceColor(accountMetrics.dailyPnl), bold: true },
360
- { text: `(${formatPercentRaw(accountMetrics.dailyPnlPct)})`, tone: "muted", color: shownPriceColor(accountMetrics.dailyPnlPct, 2) },
365
+ { text: `(${formatPercentRaw(accountMetrics.dailyPnlPct)}${holdingsOnly ? " ex cash" : ""})`, tone: "muted", color: shownPriceColor(accountMetrics.dailyPnlPct, 2) },
361
366
  // The broker's own day is from its account's close, not the quotes': it names none.
362
367
  ...(accountMetrics.brokerDay || !Number.isFinite(accountMetrics.dailyPnl) ? [] : dayBasisPart(totals)),
363
368
  ]));
@@ -367,7 +372,7 @@ export function buildPortfolioSummarySegments({
367
372
  : !Number.isFinite(account?.unrealizedPnl)
368
373
  && totals.unrealizedPnlBasis === "mixed" ? "Mixed P&L" : "P&L", tone: "label" },
369
374
  { text: money(accountMetrics.unrealizedPnl, true), tone: "value", color: priceColor(accountMetrics.unrealizedPnl), bold: true },
370
- { text: `(${formatPercentRaw(accountMetrics.unrealizedPnlPct)})`, tone: "muted", color: shownPriceColor(accountMetrics.unrealizedPnlPct, 2) },
375
+ { text: `(${formatPercentRaw(accountMetrics.unrealizedPnlPct)}${holdingsOnly ? " on cost" : ""})`, tone: "muted", color: shownPriceColor(accountMetrics.unrealizedPnlPct, 2) },
371
376
  ]));
372
377
 
373
378
  // A book with shorts splits its gross into the two sides, after the headline numbers.
@@ -109,6 +109,14 @@ export function calculatePortfolioSummaryTotals(
109
109
  valuationBasis: PortfolioValuationBasis = "latest-print",
110
110
  /** Each future's contract size and settlement by symbol, as the rows read them. */
111
111
  futuresTerms?: ReadonlyMap<string, PortfolioFuturesTerms>,
112
+ /**
113
+ * Each held currency's move on the day against `totalsCurrency`, as a
114
+ * factor (1.001 for +0.1%), from its pair's previous daily close as `fx`
115
+ * reads it: a holding in another currency was worth its value before at
116
+ * that close's rate, so the day's move holds the currency's own, as
117
+ * `portfolio show` counts it. A currency not here moves with its price alone.
118
+ */
119
+ fxDayMoves?: ReadonlyMap<string, number>,
112
120
  ): PortfolioSummaryTotals {
113
121
  let totalMktValue = 0;
114
122
  let netMktValue = 0;
@@ -137,6 +145,13 @@ export function calculatePortfolioSummaryTotals(
137
145
  if (Number.isFinite(value) && !Number.isFinite(converted)) unavailableConversions.add(`${currency}/${totalsCurrency}`);
138
146
  return converted;
139
147
  };
148
+ // The currency's move on the day, where it is known and the holding is in another currency.
149
+ const fxMove = (currency: string) => {
150
+ const factor = currency === totalsCurrency ? undefined : fxDayMoves?.get(currency);
151
+ return factor != null && Number.isFinite(factor) && factor > 0 ? factor : null;
152
+ };
153
+ // A value at the previous close, at that close's rate where the move on the day is known.
154
+ const toBaseBefore = (value: number, currency: string) => toBase(value, currency) / (fxMove(currency) ?? 1);
140
155
 
141
156
  for (const ticker of tickers) {
142
157
  const financials = financialsMap.get(ticker.metadata.ticker);
@@ -222,8 +237,12 @@ export function calculatePortfolioSummaryTotals(
222
237
  // A listing that no longer trades does not move: its last session's change is not today's.
223
238
  const previousClose = quote?.delisting ? activeQuote.price
224
239
  : activeQuote.change != null ? activeQuote.price - activeQuote.change : Number.NaN;
225
- totalPrevValue += toBaseQuote(grossPriceUnits * previousClose);
226
- signedDailyPnl += toBaseQuote(totalPriceUnits * (activeQuote.price - previousClose));
240
+ // A future's notional is no money held: the currency moves its P&L alone, never the contract's value.
241
+ const currencyMoves = !positionMetrics.isFuture && fxMove(quoteCurrency) != null;
242
+ totalPrevValue += currencyMoves ? toBaseBefore(grossPriceUnits * previousClose, quoteCurrency) : toBaseQuote(grossPriceUnits * previousClose);
243
+ signedDailyPnl += currencyMoves
244
+ ? toBaseQuote(totalPriceUnits * activeQuote.price) - toBaseBefore(totalPriceUnits * previousClose, quoteCurrency)
245
+ : toBaseQuote(totalPriceUnits * (activeQuote.price - previousClose));
227
246
  // The move valued: the latest print's from the daily reference, the regular close's from the session before it.
228
247
  if (!quote?.delisting) {
229
248
  dayBases.push(quoteChangeBasis(quote, {