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
@@ -37,6 +37,7 @@ import {
37
37
  import { dailyFuturesHistory, loadPortfolioFuturesTerms, type PortfolioFuturesSources } from "../../../../portfolio/futures-terms";
38
38
  import { loadPurchaseDateCostFx, withPurchaseDateCostFx, type CostFxHistoryClient, type PurchaseDateCostFx } from "../../../../portfolio/cost-fx";
39
39
  import { apiClient } from "../../../../api-client";
40
+ import { canonicalExchange, isUsListingExchange } from "../../../../utils/exchanges";
40
41
  import { formatUtcDayTime, parseReportTime } from "../../../../utils/utc-time";
41
42
  import { quoteFreshnessFields } from "../../shared/report-freshness";
42
43
  import { resolvePortfolioTotalsCurrency } from "../summary/totals";
@@ -44,6 +45,7 @@ import {
44
45
  EXTENDED_SESSION_LABELS,
45
46
  exchangeShortName,
46
47
  getActiveQuoteDisplay,
48
+ getCompletedRegularSessionDisplay,
47
49
  getExtendedSessionDisplay,
48
50
  quoteHeadlineTime,
49
51
  type ActiveQuoteDisplay,
@@ -89,7 +91,7 @@ import {
89
91
  } from "../../../../portfolio/allocation";
90
92
  import { findCachedPortfolioAccount } from "../cached-account";
91
93
  import { importedFromText } from "../imported-from";
92
- import { findNamedCollection, watchlistMemberSymbol } from "../../../../portfolio/collection-name";
94
+ import { findNamedCollection, watchlistMemberSymbol, type CollectionNameOptions } from "../../../../portfolio/collection-name";
93
95
  import { isoDateToday } from "../../../../utils/calendar-date";
94
96
  import { lastTradeDate } from "../../../../tickers/listing-fate";
95
97
  import type { PriceWindow } from "../../../../utils/price-window";
@@ -224,6 +226,8 @@ export interface ShowCollectionOptions {
224
226
  drip?: { years: number; withholding: number };
225
227
  /** How long every holding's dividend read may take together; a test shortens it. */
226
228
  dividendDeadlineMs?: number;
229
+ /** Fails in its own words when no collection has the name, before the generic "not found". */
230
+ onMissing?: (config: AppConfig) => void;
227
231
  /** Where futures' terms and settlements are read; Gloom Cloud's terms and the data provider's daily bars by default. */
228
232
  futuresSources?: PortfolioFuturesSources;
229
233
  /** Where the FX closes of the lots' purchase dates are read; Gloom Cloud by default. */
@@ -260,11 +264,20 @@ export type CollectionMatch =
260
264
  | { kind: "portfolio"; id: string; name: string; portfolio: Portfolio }
261
265
  | { kind: "watchlist"; id: string; name: string };
262
266
 
263
- export function findCollection(config: AppConfig, name: string): CollectionMatch | null {
267
+ export function findCollection(config: AppConfig, name: string, { prefix = false }: CollectionNameOptions = {}): CollectionMatch | null {
264
268
  const portfolio = findNamedCollection(config.portfolios, name);
265
269
  if (portfolio) return { kind: "portfolio", id: portfolio.id, name: portfolio.name, portfolio };
266
270
  const watchlist = findNamedCollection(config.watchlists, name);
267
- return watchlist ? { kind: "watchlist", id: watchlist.id, name: watchlist.name } : null;
271
+ if (watchlist) return { kind: "watchlist", id: watchlist.id, name: watchlist.name };
272
+ if (!prefix) return null;
273
+ // The start of one name, among portfolios and watchlists together: `PF family` is Family Office.
274
+ const started = findNamedCollection<{ id: string; name: string; kind: "portfolio" | "watchlist" }>([
275
+ ...config.portfolios.map((entry) => ({ id: entry.id, name: entry.name, kind: "portfolio" as const })),
276
+ ...config.watchlists.map((entry) => ({ id: entry.id, name: entry.name, kind: "watchlist" as const })),
277
+ ], name, { prefix: true });
278
+ if (!started) return null;
279
+ const book = started.kind === "portfolio" ? config.portfolios.find((entry) => entry.id === started.id) : undefined;
280
+ return book ? { kind: "portfolio", id: book.id, name: book.name, portfolio: book } : { kind: "watchlist", id: started.id, name: started.name };
268
281
  }
269
282
 
270
283
  type CollectionQuote = Awaited<ReturnType<DataProvider["getQuote"]>>;
@@ -351,8 +364,10 @@ interface PortfolioPositionValue {
351
364
  /**
352
365
  * The position's move over the day of that price, in the portfolio's
353
366
  * currency, and its value at the close before; null when either is unknown.
367
+ * A holding in another currency is worth its value before at the previous
368
+ * FX close, so the move holds the currency's own (`fx`, 0 in the book's).
354
369
  */
355
- dayMove: { change: number; previousValue: number } | null;
370
+ dayMove: { change: number; previousValue: number; fx: number } | null;
356
371
  /** The `portfolio show --json` row. */
357
372
  row: Record<string, unknown>;
358
373
  /** A future's contract size and settlement from its terms; null for any other holding. */
@@ -458,6 +473,7 @@ export async function valuePortfolioPositions({
458
473
  basis = "latest-print",
459
474
  futures,
460
475
  purchaseDateFx,
476
+ previousRate,
461
477
  }: {
462
478
  tickers: readonly TickerRecord[];
463
479
  quotes: ReadonlyMap<string, CollectionQuote>;
@@ -465,6 +481,12 @@ export async function valuePortfolioPositions({
465
481
  currency: string;
466
482
  baseCurrency: string;
467
483
  toBase: (value: number, fromCurrency: string) => Promise<number>;
484
+ /**
485
+ * One unit of a currency in `currency` at the previous daily FX close (BaseConverter.previousRate): the day's move
486
+ * of a holding in another currency then holds the currency's move too. Without it, or with no close, the day's
487
+ * move is the price's alone, at today's rate.
488
+ */
489
+ previousRate?: (fromCurrency: string) => Promise<number | null>;
468
490
  basis?: PortfolioValuationBasis;
469
491
  /** Each future's contract size and settlement (loadPortfolioFuturesTerms), by symbol. */
470
492
  futures?: ReadonlyMap<string, PortfolioFuturesTerms>;
@@ -561,8 +583,7 @@ export async function valuePortfolioPositions({
561
583
  // A listing that no longer trades does not move, as the pane's Day counts it: its last session's change is not today's.
562
584
  const change = quote?.delisting ? 0 : valuationQuote?.change;
563
585
  const dayMove = valuationQuote && change != null && Number.isFinite(change)
564
- ? { change: await toBase(metrics.totalPriceUnits * change, quoteCurrency),
565
- previousValue: await toBase(metrics.grossPriceUnits * (valuationQuote.price - change), quoteCurrency) }
586
+ ? await positionDayMove(metrics, valuationQuote.price, change, quoteCurrency, toBase, previousRate)
566
587
  : null;
567
588
  values.push({ ticker, quote, activeQuote, headline, extended, position, metrics, pnl, futures: futuresTerms, ...(costFx !== undefined ? { costFx } : {}),
568
589
  dayMove: dayMove && Number.isFinite(dayMove.change) && Number.isFinite(dayMove.previousValue) ? dayMove : null,
@@ -589,6 +610,34 @@ export async function valuePortfolioPositions({
589
610
  unknownContractSize, unsettled, costAtTodaysRate, costFxUndated, costFxUnread, exposure };
590
611
  }
591
612
 
613
+ /**
614
+ * A position's move over the day in the portfolio's currency: the price's
615
+ * move at today's rate, and for a holding in another currency the currency's
616
+ * move on its value at the close before (that value at the previous FX close
617
+ * against today's rate). With no previous FX close the move is the price's.
618
+ * A future's contract value is no money held: the currency moves only its
619
+ * P&L, the price's move at today's rate, never its notional.
620
+ */
621
+ async function positionDayMove(
622
+ metrics: Pick<ReturnType<typeof getPortfolioPositionMetrics>, "totalPriceUnits" | "grossPriceUnits" | "isFuture">,
623
+ price: number,
624
+ change: number,
625
+ quoteCurrency: string,
626
+ toBase: (value: number, fromCurrency: string) => Promise<number>,
627
+ previousRate?: (fromCurrency: string) => Promise<number | null>,
628
+ ): Promise<{ change: number; previousValue: number; fx: number }> {
629
+ const previousPrice = price - change;
630
+ const rate = await toBase(1, quoteCurrency);
631
+ const before = previousRate && !metrics.isFuture ? await previousRate(quoteCurrency) : null;
632
+ const previous = before != null && Number.isFinite(before) && before > 0 ? before : rate;
633
+ const fx = metrics.totalPriceUnits * previousPrice * (rate - previous);
634
+ return {
635
+ change: await toBase(metrics.totalPriceUnits * change, quoteCurrency) + fx,
636
+ previousValue: metrics.grossPriceUnits * previousPrice * previous,
637
+ fx,
638
+ };
639
+ }
640
+
592
641
  /**
593
642
  * The holdings' move over the day of the prices they are valued at, in the
594
643
  * portfolio's currency, and that move against their value at the close
@@ -601,9 +650,10 @@ export async function valuePortfolioPositions({
601
650
  export function portfolioDayMove(
602
651
  valuation: Pick<PortfolioValuation, "positions" | "basis">,
603
652
  now = Date.now(),
604
- ): { change: number; changePercent: number | null; basis: string | null } | null {
653
+ ): { change: number; changePercent: number | null; basis: string | null; fx: number } | null {
605
654
  let change = 0;
606
655
  let previousValue = 0;
656
+ let fx = 0;
607
657
  const bases: Array<QuoteChangeBasis | null> = [];
608
658
  const session = valuation.basis === "regular-close" ? "regular" : "active";
609
659
  for (const entry of valuation.positions) {
@@ -611,12 +661,14 @@ export function portfolioDayMove(
611
661
  if (!entry.dayMove) return null;
612
662
  change += entry.dayMove.change;
613
663
  previousValue += entry.dayMove.previousValue;
664
+ fx += entry.dayMove.fx;
614
665
  if (!entry.quote?.delisting) bases.push(quoteChangeBasis(entry.quote, { session, terms: entry.futures }));
615
666
  }
616
667
  return {
617
668
  change,
618
669
  changePercent: previousValue !== 0 ? (change / previousValue) * 100 : null,
619
670
  basis: combinedChangeBasisLabel(bases, now),
671
+ fx,
620
672
  };
621
673
  }
622
674
 
@@ -630,11 +682,15 @@ export function dayMoveLine(
630
682
  currency: string,
631
683
  color: (text: string, value: number) => string = (text) => text,
632
684
  muted: (text: string) => string = (text) => text,
685
+ // A book with cash: the percent is the holdings' move, which the cash does not dilute, and says so.
686
+ { cashExcluded = false }: { cashExcluded?: boolean } = {},
633
687
  ): string {
634
688
  if (!move) return "Day's move: unavailable";
635
- const percent = move.changePercent != null ? ` (${formatPercentRaw(move.changePercent)})` : "";
689
+ const percent = move.changePercent != null ? ` (${formatPercentRaw(move.changePercent)}${cashExcluded ? " of the holdings, cash excluded" : ""})` : "";
636
690
  const basis = move.basis ? ` ${muted(move.basis)}` : "";
637
- return `Day's move: ${color(`${formatAllocationMoney(move.change, currency, { signed: true })}${percent}`, move.change)}${basis}`;
691
+ // A holding in another currency moves with it too: how much of the move that is.
692
+ const fx = Math.abs(move.fx) >= 0.005 ? `, FX ${color(formatAllocationMoney(move.fx, currency, { signed: true }), move.fx)} of it` : "";
693
+ return `Day's move: ${color(`${formatAllocationMoney(move.change, currency, { signed: true })}${percent}`, move.change)}${basis}${fx}`;
638
694
  }
639
695
 
640
696
  /**
@@ -786,7 +842,7 @@ function portfolioValuationFreshness(
786
842
  citeOldest: true,
787
843
  // A book across markets names each one's session and open: an HKEX book holding one US fund is not dated by the US day alone.
788
844
  datesEachVenue: true,
789
- ...(note ? { note: `priced at ${valuationBasisLabel(valuation.basis, { futures: holdsFutures(valuation) })}` } : {}),
845
+ ...(note ? { note: `priced at ${valuationBasisText(valuation.basis, holdsFutures(valuation), marketsStillTrading(valuation))}` } : {}),
790
846
  }, undefined, now);
791
847
  }
792
848
 
@@ -795,9 +851,56 @@ export function holdsFutures(valuation: Pick<PortfolioValuation, "positions">):
795
851
  return valuation.positions.some((entry) => entry.position && entry.futures);
796
852
  }
797
853
 
798
- /** `Priced at the latest print, extended hours included`: the line under a portfolio's title. */
799
- function valuationBasisLine(basis: PortfolioValuationBasis, futures: boolean): string {
800
- return `Priced at ${valuationBasisLabel(basis, { futures })}`;
854
+ /**
855
+ * `Priced at the latest print, extended hours included`: the line under a
856
+ * portfolio's title. At the close, a book with markets still trading names
857
+ * them, and the markets at their close: `Priced at the regular
858
+ * close: BIST at its close; US still trading, at the latest print`.
859
+ */
860
+ function valuationBasisLine(
861
+ basis: PortfolioValuationBasis,
862
+ futures: boolean,
863
+ markets: { closed: string[]; trading: string[] } | null = null,
864
+ ): string {
865
+ return `Priced at ${valuationBasisText(basis, futures, markets)}`;
866
+ }
867
+
868
+ /** What a book is priced at, after "Priced at", with the markets still trading at the close (`marketsStillTrading`). */
869
+ export function valuationBasisText(
870
+ basis: PortfolioValuationBasis,
871
+ futures: boolean,
872
+ markets: { closed: string[]; trading: string[] } | null = null,
873
+ ): string {
874
+ const label = valuationBasisLabel(basis, { futures });
875
+ if (basis !== "regular-close" || !markets?.trading.length) return label;
876
+ const closed = markets.closed.length ? `${joinWords(markets.closed)} at ${markets.closed.length === 1 ? "its" : "their"} close; ` : "";
877
+ return `${label}: ${closed}${joinWords(markets.trading)} still trading, at the latest print`;
878
+ }
879
+
880
+ /** `US`, `US and BIST`, `US, LSE and BIST`. */
881
+ function joinWords(words: readonly string[]): string {
882
+ return words.length <= 1 ? words.join("") : `${words.slice(0, -1).join(", ")} and ${words.at(-1)}`;
883
+ }
884
+
885
+ /**
886
+ * The markets of a book's holdings, US listings as one, split into those
887
+ * whose regular session is over, which the close values, and those still in
888
+ * it, whose rows are at the latest print until their close; futures, at the
889
+ * settle, and options, at their mark, are neither. In the order the rows
890
+ * first name them.
891
+ */
892
+ export function marketsStillTrading(valuation: Pick<PortfolioValuation, "positions">): { closed: string[]; trading: string[] } {
893
+ const states = new Map<string, boolean>();
894
+ for (const { quote, metrics, position, futures } of valuation.positions) {
895
+ if (!position || !quote || futures || metrics?.valuesAtMark) continue;
896
+ const exchange = canonicalExchange(quote.listingExchangeName || quote.exchangeName);
897
+ if (!exchange) continue;
898
+ const market = isUsListingExchange(exchange) ? "US" : exchange;
899
+ const trading = getCompletedRegularSessionDisplay(quote) == null && quote.marketState === "REGULAR";
900
+ states.set(market, (states.get(market) ?? false) || trading);
901
+ }
902
+ const markets = [...states];
903
+ return { closed: markets.filter(([, trading]) => !trading).map(([market]) => market), trading: markets.filter(([, trading]) => trading).map(([market]) => market) };
801
904
  }
802
905
 
803
906
  /** What a row's price is when it is not a print or a close: a future's settlement, or a venue's nominal price. */
@@ -837,7 +940,7 @@ async function showCollectionWithMarketData(
837
940
  name: string,
838
941
  ctx: CliCommandContext,
839
942
  { config, store, dataProvider, persistence }: MarketContext,
840
- { explain = false, basis = "latest-print", drip, dividendDeadlineMs = DIVIDEND_READ_DEADLINE_MS, futuresSources, costFxHistory = apiClient, period, real = false, cpi }: ShowCollectionOptions,
943
+ { explain = false, basis = "latest-print", drip, dividendDeadlineMs = DIVIDEND_READ_DEADLINE_MS, futuresSources, costFxHistory = apiClient, period, real = false, cpi, onMissing }: ShowCollectionOptions,
841
944
  outcome: { readsLeftBehind: boolean } = { readsLeftBehind: false },
842
945
  ) {
843
946
  const tickers = (await store.loadAllTickers()).sort((left, right) =>
@@ -846,6 +949,7 @@ async function showCollectionWithMarketData(
846
949
  const collection = findCollection(config, name);
847
950
 
848
951
  if (!collection) {
952
+ onMissing?.(config);
849
953
  ctx.fail(
850
954
  `Collection "${name}" was not found.`,
851
955
  `Available: ${[...config.portfolios.map((portfolio) => portfolio.name), ...config.watchlists.map((watchlist) => watchlist.name)].join(", ")}`,
@@ -914,17 +1018,21 @@ async function showCollectionWithMarketData(
914
1018
  // A watchlist's stale rows, named under the closing line that counts them.
915
1019
  let staleNote: string | null = null;
916
1020
 
1021
+ const valuation = matchedPortfolio
1022
+ ? await valuePortfolioPositions({ tickers: filtered, quotes, portfolioId: id, currency, baseCurrency: config.baseCurrency, toBase, basis, futures, purchaseDateFx,
1023
+ previousRate: toBase.previousRate })
1024
+ : null;
1025
+
917
1026
  if (!structured) {
918
1027
  console.log(cliStyles.bold(displayName + (isPortfolio ? ` (${currency})` : "")));
919
1028
  console.log(cliStyles.muted(`${filtered.length} ticker${filtered.length === 1 ? "" : "s"}`));
920
1029
  const imported = matchedPortfolio ? importedFromText(matchedPortfolio) : null;
921
1030
  if (imported) console.log(cliStyles.muted(imported));
922
- if (isPortfolio) console.log(cliStyles.muted(valuationBasisLine(basis, futuresHeld.length > 0)));
1031
+ if (isPortfolio) console.log(cliStyles.muted(valuationBasisLine(basis, futuresHeld.length > 0, valuation ? marketsStillTrading(valuation) : null)));
923
1032
  console.log("");
924
1033
  }
925
1034
 
926
- if (matchedPortfolio) {
927
- const valuation = await valuePortfolioPositions({ tickers: filtered, quotes, portfolioId: id, currency, baseCurrency: config.baseCurrency, toBase, basis, futures, purchaseDateFx });
1035
+ if (matchedPortfolio && valuation) {
928
1036
  // Exports carry no header line, so their source line names the basis.
929
1037
  freshness = portfolioValuationFreshness(valuation, source, { note: structured });
930
1038
  const {
@@ -960,6 +1068,21 @@ async function showCollectionWithMarketData(
960
1068
  const hedged = allocation.weightBasis === "gross";
961
1069
  const yieldBase = hedged ? allocation.weightBase : exposure.net;
962
1070
  const portfolioYield = totalIncome != null && yieldBase != null && yieldBase > 0 ? (totalIncome / yieldBase) * 100 : null;
1071
+ // With a holding's income unknown, TOTAL still adds up those it has, and the note under the table names the
1072
+ // holdings it leaves out. Its yield is over the same base less what those are worth, so a holding that pays
1073
+ // nothing (a coin, a non-payer) still counts. The export keeps annualIncome null and knownAnnualIncome.
1074
+ const partialIncome = totalIncome == null && income.knownHoldings > 0;
1075
+ const leftOutValue = partialIncome
1076
+ ? valued.reduce((sum, entry) => {
1077
+ const value = entry.position && entry.metrics && income.gaps.has(entry.ticker.metadata.ticker) ? entry.row.marketValue : null;
1078
+ return typeof value === "number" && Number.isFinite(value) ? sum + (hedged ? Math.abs(value) : value) : sum;
1079
+ }, 0)
1080
+ : 0;
1081
+ const knownBase = partialIncome && yieldBase != null ? yieldBase - leftOutValue : null;
1082
+ const totalIncomeShown = partialIncome ? income.knownIncome : totalIncome;
1083
+ const totalYieldShown = partialIncome
1084
+ ? knownBase != null && knownBase > 0 ? (income.knownIncome / knownBase) * 100 : null
1085
+ : portfolioYield;
963
1086
  const incomeUnavailable = [...income.gaps].map(([symbol, gap]) => ({ symbol, ...gap }));
964
1087
  const showTargets = allocation.targetSum != null;
965
1088
  // Never dropped on a narrow terminal, so --explain reads the terms off them.
@@ -1094,6 +1217,7 @@ async function showCollectionWithMarketData(
1094
1217
  // Only on a book that holds a short: its weights are shares of `weightBase`, its gross exposure, not of the total.
1095
1218
  ...(allocation.weightBasis === "gross" ? { weightBasis: allocation.weightBasis, weightBase: allocation.weightBase } : {}),
1096
1219
  dayChange: dayMove?.change ?? null, dayChangePercent: dayMove?.changePercent ?? null, dayChangeBasis: dayMove?.basis ?? null,
1220
+ dayChangeFx: dayMove?.fx ?? null,
1097
1221
  unpricedCount: allocation.unpriced.length, unpricedSymbols: allocation.unpriced,
1098
1222
  totalUnrealizedPnl: totalPnlValue,
1099
1223
  annualIncome: totalIncome, knownAnnualIncome: income.knownIncome, portfolioYield,
@@ -1209,7 +1333,7 @@ async function showCollectionWithMarketData(
1209
1333
  cliStyles.bold(wholeMoney(total)),
1210
1334
  formatAllocationWeight(totalWeight(allocation)),
1211
1335
  ...(showTargets ? [formatAllocationWeight(allocation.targetSum), "", "", ""] : []),
1212
- ...(showIncome ? [cliStyles.bold(money(totalIncome)), formatIncomeYield(portfolioYield)] : []),
1336
+ ...(showIncome ? [cliStyles.bold(money(totalIncomeShown)), formatIncomeYield(totalYieldShown)] : []),
1213
1337
  totalPnlValue == null ? "—" : colorBySign(money(totalPnlValue, { signed: true }), totalPnlValue),
1214
1338
  "",
1215
1339
  ]);
@@ -1227,21 +1351,22 @@ async function showCollectionWithMarketData(
1227
1351
  ...extendedSessions.map((session) => ({ header: EXTENDED_SESSION_LABELS[session], align: "right" as const, optional: true, dropPriority: 3 })),
1228
1352
  { header: quantityHeader, align: "right" },
1229
1353
  { header: "Avg Cost", align: "right", optional: true, dropPriority: 3 },
1230
- { header: "Value", align: "right" },
1231
- ...allocationHeaders.map((header) => ({ header, align: "right" as const })),
1354
+ // Value, trade value, income and P&L are in the portfolio's currency, and their headers name it.
1355
+ { header: `Value (${currency})`, align: "right" },
1356
+ ...allocationHeaders.map((header) => ({ header: header === "Trade Value" ? `${header} (${currency})` : header, align: "right" as const })),
1232
1357
  // A year of trailing dividends on the shares held, dropped after the quote and before P&L.
1233
1358
  ...(showIncome ? [
1234
- { header: "Income", align: "right" as const, optional: true, dropPriority: 0.5 },
1359
+ { header: `Income (${currency})`, align: "right" as const, optional: true, dropPriority: 0.5 },
1235
1360
  { header: "Yield", align: "right" as const, optional: true, dropPriority: 0.5 },
1236
1361
  ] : []),
1237
- { header: "P&L", align: "right", optional: true },
1362
+ { header: `P&L (${currency})`, align: "right", optional: true },
1238
1363
  // When each row's price is from, so a Friday close never hides behind a newer row.
1239
1364
  { header: "As of (UTC)" },
1240
1365
  ],
1241
1366
  rows,
1242
1367
  ));
1243
1368
  console.log("");
1244
- if (valued.some((entry) => entry.position)) console.log(dayMoveLine(dayMove, currency, colorBySign, cliStyles.muted));
1369
+ if (valued.some((entry) => entry.position)) console.log(dayMoveLine(dayMove, currency, colorBySign, cliStyles.muted, { cashExcluded: !!cashExport }));
1245
1370
  if (valued.some((entry) => entry.position)) console.log(exposureLine(exposure, currency));
1246
1371
  // The rates the holdings in another currency are valued at, dated, so a stale one is seen beside the value it moves.
1247
1372
  const fxLine = fxRatesLine(toBase.conversions(), { warning: cliStyles.warning });
@@ -1283,7 +1408,7 @@ async function showCollectionWithMarketData(
1283
1408
  }
1284
1409
  if (unsized(unavailableCost).length > 0) notes.push(cliStyles.muted(`Cost unavailable for ${named(unsized(unavailableCost))}.`));
1285
1410
  if (unsized(unavailablePnl).length > 0) notes.push(cliStyles.muted(`P&L unavailable for ${named(unsized(unavailablePnl))}.`));
1286
- const incomeNote = incomeGapNote(income, { name: named, money: (value) => money(value), deadlineMs: dividendDeadlineMs });
1411
+ const incomeNote = incomeGapNote(income, { name: named, deadlineMs: dividendDeadlineMs });
1287
1412
  if (incomeNote) notes.push(cliStyles.muted(incomeNote));
1288
1413
  for (const note of notes) console.log(note);
1289
1414
  if (drip) {
@@ -20,7 +20,9 @@ import {
20
20
  listingLabel,
21
21
  loadCollectionQuotes,
22
22
  holdsFutures,
23
+ marketsStillTrading,
23
24
  portfolioDayMove,
25
+ valuationBasisText,
24
26
  valuationTimeText,
25
27
  valuePortfolioAllocation,
26
28
  valuePortfolioPositions,
@@ -28,7 +30,7 @@ import {
28
30
  type CollectionMatch,
29
31
  type PortfolioValuation,
30
32
  } from "./cli/render";
31
- import { valuationBasisLabel, type PortfolioValuationBasis } from "../../../portfolio/valuation-basis";
33
+ import type { PortfolioValuationBasis } from "../../../portfolio/valuation-basis";
32
34
  import { futuresQuantityText, isFuturesTicker } from "../../../portfolio/futures-positions";
33
35
  import { dailyFuturesHistory, loadPortfolioFuturesTerms } from "../../../portfolio/futures-terms";
34
36
  import { loadPurchaseDateCostFx } from "../../../portfolio/cost-fx";
@@ -107,6 +109,14 @@ const POSITION_COLUMNS: HeadlessPaneColumn[] = [
107
109
  { key: "weight", header: "Weight", align: "right", format: weight, description: "Percent of the total value, cash included; unpriced holdings are left out." },
108
110
  ];
109
111
 
112
+ /** Columns whose amounts are in the portfolio's currency, whatever the listing's. */
113
+ const BOOK_CURRENCY_KEYS: ReadonlySet<string> = new Set(["marketValue", "unrealizedPnl", "tradeValue", "pnl"]);
114
+
115
+ /** `columns` with the portfolio's currency in the header of each column in it: Mkt Val (CAD) beside a USD Last. */
116
+ function withBookCurrency(columns: HeadlessPaneColumn[], currency: string): HeadlessPaneColumn[] {
117
+ return columns.map((column) => BOOK_CURRENCY_KEYS.has(column.key) ? { ...column, header: `${column.header} (${currency})` } : column);
118
+ }
119
+
110
120
  /** The weight of a book that holds a short: a share of its gross exposure. */
111
121
  const GROSS_WEIGHT_DESCRIPTION = "Percent of gross exposure, longs plus shorts at their absolute value, as the book holds a short; negative for a short, cash and unpriced holdings left out.";
112
122
 
@@ -209,7 +219,7 @@ function resolveTarget(rawArgument: string, ctx: HeadlessPaneContext): Collectio
209
219
  if (watchlist) return { kind: "watchlist", id: watchlist.id, name: watchlist.name };
210
220
  throw new Error("No portfolios or watchlists are set up.");
211
221
  }
212
- const match = findCollection(config, raw);
222
+ const match = findCollection(config, raw, { prefix: true });
213
223
  if (match) return match;
214
224
  const collections = [...config.portfolios, ...config.watchlists];
215
225
  throw new Error(
@@ -320,6 +330,7 @@ async function portfolioHoldings(
320
330
  basis,
321
331
  futures,
322
332
  purchaseDateFx,
333
+ previousRate: toBase.previousRate,
323
334
  });
324
335
  const { allocation, cash } = await valuePortfolioAllocation({ valuation, portfolio: resolved.portfolio, account: resolved.account, toBase });
325
336
  ctx.signal.throwIfAborted();
@@ -408,7 +419,7 @@ async function portfolioHoldings(
408
419
  const notices = [
409
420
  ...(imported ? [imported] : []),
410
421
  // At the close, Mkt Val is Last times the shares; the day's move from the close before gets its own line.
411
- ...(basis === "regular-close" ? [dayMoveLine(dayMove, currency)] : []),
422
+ ...(basis === "regular-close" ? [dayMoveLine(dayMove, currency, undefined, undefined, { cashExcluded: !!allocation.cash })] : []),
412
423
  ...(held.length > 0 ? [exposureLine(valuation.exposure, currency)] : []),
413
424
  ...[weightBasisLine(allocation, currency)].filter((line): line is string => !!line),
414
425
  ...(rows.length > limit
@@ -423,7 +434,7 @@ async function portfolioHoldings(
423
434
  ? POSITION_COLUMNS.map((column) => column.key === "weight" ? { ...column, description: GROSS_WEIGHT_DESCRIPTION } : column)
424
435
  : POSITION_COLUMNS;
425
436
  const columns = withListingLabels(
426
- withExtendedColumns([...positionColumns, ...(showTargets ? TARGET_COLUMNS : []), VALUATION_TIME_COLUMN], extendedSessions),
437
+ withExtendedColumns(withBookCurrency([...positionColumns, ...(showTargets ? TARGET_COLUMNS : []), VALUATION_TIME_COLUMN], currency), extendedSessions),
427
438
  tickers,
428
439
  );
429
440
  const lotted = withPositionLines(shown, columns, allocationBySymbol);
@@ -434,7 +445,7 @@ async function portfolioHoldings(
434
445
  source: broker ? "Your broker account and Gloom Cloud" : "Local portfolio and Gloom Cloud",
435
446
  observedKey: "valuationAsOf",
436
447
  citeOldest: true,
437
- note: `priced at ${valuationBasisLabel(basis, { futures: holdsFutures(valuation) })}`,
448
+ note: `priced at ${valuationBasisText(basis, holdsFutures(valuation), marketsStillTrading(valuation))}`,
438
449
  },
439
450
  columns,
440
451
  rows: shown,
@@ -458,7 +469,8 @@ async function portfolioHoldings(
458
469
  cash: allocation.cash ? finite(allocation.cash.value) : null,
459
470
  total: allocation.total,
460
471
  // At the regular close, the holdings' move from the close before.
461
- ...(basis === "regular-close" ? { dayChange: dayMove?.change ?? null, dayChangePercent: dayMove?.changePercent ?? null, dayChangeBasis: dayMove?.basis ?? null } : {}),
472
+ ...(basis === "regular-close" ? { dayChange: dayMove?.change ?? null, dayChangePercent: dayMove?.changePercent ?? null, dayChangeBasis: dayMove?.basis ?? null,
473
+ dayChangeFx: dayMove?.fx ?? null } : {}),
462
474
  },
463
475
  // Only on a book that holds a short: its weights are shares of `weightBase`, its gross exposure, not of the total.
464
476
  ...(allocation.weightBasis === "gross" ? { weightBasis: allocation.weightBasis, weightBase: allocation.weightBase } : {}),
@@ -549,7 +561,7 @@ async function portfolioPeriodHoldings(
549
561
  status: "not-a-feed",
550
562
  basis: `daily closes, ${window.from} to ${window.to}`,
551
563
  },
552
- columns: withListingLabels(PERIOD_COLUMNS, tickers),
564
+ columns: withListingLabels(withBookCurrency(PERIOD_COLUMNS, currency), tickers),
553
565
  rows,
554
566
  complete: errors.length === 0,
555
567
  ...(errors.length ? { errors } : {}),
@@ -683,8 +695,17 @@ export const collectionHoldingsHeadless: HeadlessPaneDefinition<"rows"> = {
683
695
  if (args.options.close === true) throw new Error("--from values each position at its closes already; leave out --close.");
684
696
  return portfolioPeriodHoldings(target, limit, ctx, window);
685
697
  }
686
- return target.kind === "portfolio"
698
+ const result = await (target.kind === "portfolio"
687
699
  ? portfolioHoldings(target, limit, ctx, args.options.close === true ? "regular-close" : "latest-print")
688
- : watchlistHoldings(target, limit, ctx);
700
+ : watchlistHoldings(target, limit, ctx));
701
+ if (args.rawArgument.trim() || result.rows.length > 0) return result;
702
+ // Left out, PF reads the first collection; an empty one says which it was and how to name another.
703
+ return { ...result, empty: emptyDefaultText(target, ctx) };
689
704
  },
690
705
  };
706
+
707
+ /** `The first portfolio, Main, holds nothing. Name one: gloom fn PF <portfolio or watchlist>, such as Plan (plan).` */
708
+ function emptyDefaultText(target: CollectionMatch, ctx: HeadlessPaneContext): string {
709
+ const others = [...ctx.config.portfolios, ...ctx.config.watchlists].filter((collection) => collection.id !== target.id);
710
+ return `The first ${target.kind}, ${target.name}, holds nothing. Name one: gloom fn PF <portfolio or watchlist>${others.length ? `, such as ${describeCollections(others)}` : ""}.`;
711
+ }
@@ -6,14 +6,19 @@ import { isNetworkFailure } from "../../../utils/network-failure";
6
6
  import { regularSessionValuationPrice } from "../../../market-data/quotes/regular-session-valuation";
7
7
  import { resolveTickerInstrumentKind } from "../../../tickers/instrument-kind";
8
8
  import { mapWithConcurrency } from "../../../utils/concurrency";
9
+ import { MARKET_REQUEST_TIMEOUT_MS } from "../../../api-client/request";
9
10
  import type { DataProvider } from "../../../types/data-provider";
10
11
  import type { Quote } from "../../../types/financials";
11
12
  import type { TickerRecord } from "../../../types/ticker";
12
13
 
13
14
  /** Dividend reads `portfolio show` makes at once. */
14
15
  const DIVIDEND_CONCURRENCY = 8;
15
- /** How long `portfolio show` waits for every holding's dividends together before it prints without the rest. */
16
- export const DIVIDEND_READ_DEADLINE_MS = 4_000;
16
+ /**
17
+ * How long `portfolio show` waits for every holding's dividends together
18
+ * before it prints without the rest: the time a price read gets, as a cold
19
+ * read of a fund's distributions (TLT's) takes longer than a quote.
20
+ */
21
+ export const DIVIDEND_READ_DEADLINE_MS = MARKET_REQUEST_TIMEOUT_MS;
17
22
  /** How far `--drip` projects, in whole years. */
18
23
  export const DRIP_MAX_YEARS = 5;
19
24
  export const DRIP_DEFAULT_YEARS = 5;
@@ -229,11 +234,13 @@ const UNREAD_WORDS: Record<"timed-out" | "sign-in" | "offline" | "failed", (seco
229
234
  /**
230
235
  * The one line `portfolio show` says about income it cannot show, naming
231
236
  * each cause and its holdings: no dividend history, no exchange rate, or
232
- * dividends not read. Null when every holding's income is known.
237
+ * dividends not read. With some holdings' income known, TOTAL adds those up
238
+ * and the line names the holdings it leaves out. Null when every holding's
239
+ * income is known.
233
240
  */
234
241
  export function incomeGapNote(
235
242
  income: PortfolioIncome,
236
- { name, money, deadlineMs = DIVIDEND_READ_DEADLINE_MS }: { name: (symbols: string[]) => string; money: (value: number) => string; deadlineMs?: number },
243
+ { name, deadlineMs = DIVIDEND_READ_DEADLINE_MS }: { name: (symbols: string[]) => string; deadlineMs?: number },
237
244
  ): string | null {
238
245
  if (income.gaps.size === 0) return null;
239
246
  const groups = new Map<string, string[]>();
@@ -243,10 +250,12 @@ export function incomeGapNote(
243
250
  : UNREAD_WORDS[gap.why](Number((deadlineMs / 1000).toFixed(2)));
244
251
  groups.set(key, [...(groups.get(key) ?? []), symbol]);
245
252
  }
246
- const causes = [...groups].map(([cause, symbols]) => `${cause} for ${name(symbols)}`).join("; ");
247
- if (income.knownHoldings === 0) return `Income ${showsIncomeColumns(income) ? "unavailable" : "not shown"}: ${causes}.`;
248
- const others = income.knownHoldings;
249
- return `Income unavailable: ${causes}. The other ${others === 1 ? "holding pays" : `${others} holdings pay`} ${money(income.knownIncome)} a year.`;
253
+ if (income.knownHoldings === 0) {
254
+ const causes = [...groups].map(([cause, symbols]) => `${cause} for ${name(symbols)}`).join("; ");
255
+ return `Income ${showsIncomeColumns(income) ? "unavailable" : "not shown"}: ${causes}.`;
256
+ }
257
+ const left = [...groups].map(([cause, symbols]) => `${name(symbols)} (${cause})`).join("; ");
258
+ return `TOTAL income and yield leave out ${left}.`;
250
259
  }
251
260
 
252
261
  /** `--years`: a whole number of years from 1 to DRIP_MAX_YEARS. */
@@ -30,7 +30,7 @@ function resolveCollectionIdForKind(context: PaneTemplateContext, kind: "portfol
30
30
 
31
31
  /** `PF Nope`: no portfolio or watchlist has that name or id, so the bar names those that do. */
32
32
  function unknownCollectionArg(arg: string, context: PaneTemplateContext): ShortcutArgError | null {
33
- return unknownCollectionArgError(arg, [...context.config.portfolios, ...context.config.watchlists], "portfolio or watchlist");
33
+ return unknownCollectionArgError(arg, [...context.config.portfolios, ...context.config.watchlists], "portfolio or watchlist", undefined, { prefix: true });
34
34
  }
35
35
 
36
36
  function createCollectionPaneInstance(
@@ -38,8 +38,8 @@ function createCollectionPaneInstance(
38
38
  kind?: "portfolio" | "watchlist",
39
39
  argument?: string,
40
40
  ): PaneTemplateInstanceConfig | null {
41
- // `PF Retirement` (or `shot PF Retirement`) opens the collection it names.
42
- const named = argument?.trim() ? findCollection(context.config, argument) : null;
41
+ // `PF Retirement` (or `shot PF Retirement`) opens the collection it names, or the one whose name starts so (`PF ret`).
42
+ const named = argument?.trim() ? findCollection(context.config, argument, { prefix: true }) : null;
43
43
  const collectionId = named && (!kind || named.kind === kind)
44
44
  ? named.id
45
45
  : kind ? resolveCollectionIdForKind(context, kind) : resolveCollectionPaneId(context);
@@ -96,7 +96,7 @@ export const portfolioListModule: PluginModule = {
96
96
  "portfolio", "watchlist", "collection", "pane", "list",
97
97
  "portfolio rebalance", "allocation drift", "target weights", "asset allocation", "cash balance",
98
98
  ],
99
- // The argument is the report's: `PF Book` opens Book, by name or id in any case.
99
+ // The argument is the report's: `PF Book` opens Book, by name or id in any case, or the start of one name.
100
100
  shortcut: { prefix: "PF", argError: unknownCollectionArg },
101
101
  headless: collectionHoldingsHeadless,
102
102
  canCreate: (context) => resolveCollectionPaneId(context) !== null,
@@ -0,0 +1,52 @@
1
+ import { useEffect, useState } from "react";
2
+ import { fxQuoteRateMove, readFxQuoteRate } from "../../../../cli/fx-quote-rate";
3
+ import { heldCurrencyUnit } from "../../../../utils/currency-units";
4
+ import { logFailure } from "../../../../utils/log-failure";
5
+ import { useAssetData } from "../../../runtime";
6
+
7
+ /** How often the pairs' moves are read again; the move a book's day holds drifts with the FX market. */
8
+ const FX_DAY_MOVE_REFRESH_MS = 5 * 60_000;
9
+
10
+ const NO_MOVES: ReadonlyMap<string, number> = new Map();
11
+
12
+ /**
13
+ * Each currency's move on the day against the book's, as a factor (1.001 for
14
+ * +0.1%), read as `fx` reads a pair's from its previous daily close, so the
15
+ * pane's Day's move holds a foreign holding's currency move as `portfolio
16
+ * show` does (`calculatePortfolioSummaryTotals`). A currency whose pair has no
17
+ * close to read against is left out, and moves with its price alone.
18
+ */
19
+ export function useFxDayMoves(currencies: readonly string[], totalsCurrency: string): ReadonlyMap<string, number> {
20
+ const dataProvider = useAssetData();
21
+ const [moves, setMoves] = useState<ReadonlyMap<string, number>>(NO_MOVES);
22
+ const key = [...new Set(currencies.filter((currency) => heldCurrencyUnit(currency).currency !== heldCurrencyUnit(totalsCurrency).currency))]
23
+ .sort().join(",");
24
+ useEffect(() => {
25
+ const getQuotesBatch = dataProvider?.getQuotesBatch?.bind(dataProvider);
26
+ if (!getQuotesBatch || !key) {
27
+ setMoves(NO_MOVES);
28
+ return;
29
+ }
30
+ let cancelled = false;
31
+ const read = async () => {
32
+ const into = heldCurrencyUnit(totalsCurrency).currency;
33
+ const read = await Promise.all(key.split(",").map(async (currency) => {
34
+ const rate = await readFxQuoteRate(heldCurrencyUnit(currency).currency, into, getQuotesBatch)
35
+ .catch(logFailure("portfolio-list.fx-day-moves", "Could not read the FX move on the day", null));
36
+ const move = rate && "rate" in rate ? fxQuoteRateMove(rate) : null;
37
+ return move ? [[currency, 1 + move.percent / 100] as const] : [];
38
+ }));
39
+ if (!cancelled) setMoves(new Map(read.flat()));
40
+ };
41
+ const refresh = () => {
42
+ read().catch(logFailure("portfolio-list.fx-day-moves", "Could not read the FX moves on the day"));
43
+ };
44
+ refresh();
45
+ const timer = setInterval(refresh, FX_DAY_MOVE_REFRESH_MS);
46
+ return () => {
47
+ cancelled = true;
48
+ clearInterval(timer);
49
+ };
50
+ }, [dataProvider, key, totalsCurrency]);
51
+ return moves;
52
+ }