gloomberb 0.20.0 → 0.20.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (481) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +1 -1
  4. package/patches/electrobun-devkit@2.0.5.patch +268 -8
  5. package/src/account/auth-model.ts +20 -1
  6. package/src/account/upgrade-dialog.tsx +8 -4
  7. package/src/api-client/askg.ts +7 -1
  8. package/src/api-client/auth.ts +27 -0
  9. package/src/api-client/catalysts.ts +2 -0
  10. package/src/api-client/company-kpis.ts +2 -1
  11. package/src/api-client/cot.ts +14 -2
  12. package/src/api-client/crypto-markets.ts +20 -2
  13. package/src/api-client/data.ts +3 -2
  14. package/src/api-client/earnings.ts +46 -3
  15. package/src/api-client/fund-facts.ts +23 -1
  16. package/src/api-client/futures-curve.ts +17 -0
  17. package/src/api-client/index.ts +4 -1
  18. package/src/api-client/one-tap-reasons.ts +42 -0
  19. package/src/api-client/perps.ts +2 -1
  20. package/src/api-client/request.ts +3 -1
  21. package/src/api-client/research-activity.ts +16 -3
  22. package/src/api-client/types/filings-and-calls.ts +9 -0
  23. package/src/api-client/types/search.ts +3 -0
  24. package/src/app/keybindings/chord.ts +153 -9
  25. package/src/app/keybindings/index.ts +1 -1
  26. package/src/app/keybindings/labels.ts +49 -6
  27. package/src/app/runtime/desktop-deeplink.ts +73 -8
  28. package/src/app/runtime/plugin-seed.ts +119 -0
  29. package/src/app/runtime/startup.ts +45 -9
  30. package/src/app.tsx +8 -1
  31. package/src/architecture/core-builtin-allowlist.json +1 -2
  32. package/src/architecture/pane-tabs-allowlist.json +2 -1
  33. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  34. package/src/architecture/ui-literals-allowlist.json +8 -8
  35. package/src/brokers/broker-portfolio-sync.ts +1 -1
  36. package/src/cli/bank-section.ts +26 -12
  37. package/src/cli/board-coins.ts +38 -5
  38. package/src/cli/commands/crypto-hints.ts +8 -1
  39. package/src/cli/commands/market.ts +294 -100
  40. package/src/cli/commands/overview.ts +13 -6
  41. package/src/cli/commands/ticker.ts +73 -21
  42. package/src/cli/company-name-hint.ts +19 -0
  43. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  44. package/src/cli/desktop-pane-shot.ts +15 -0
  45. package/src/cli/entry.ts +15 -4
  46. package/src/cli/export-source.ts +7 -1
  47. package/src/cli/freshness.ts +0 -16
  48. package/src/cli/fx-pair.ts +64 -12
  49. package/src/cli/fx-quote-rate.ts +144 -0
  50. package/src/cli/glossary.ts +30 -0
  51. package/src/cli/helpers.ts +4 -2
  52. package/src/cli/history-back-adjust.ts +122 -0
  53. package/src/cli/history-rows.ts +114 -10
  54. package/src/cli/index.ts +4 -1
  55. package/src/cli/known-gaps.ts +45 -3
  56. package/src/cli/listing-arg.ts +48 -4
  57. package/src/cli/name-entries.ts +25 -5
  58. package/src/cli/not-a-ticker.ts +26 -1
  59. package/src/cli/pane-functions/catalog.ts +12 -2
  60. package/src/cli/pane-functions/dom.ts +4 -2
  61. package/src/cli/pane-functions/freshness.ts +45 -29
  62. package/src/cli/pane-functions/headless.ts +8 -5
  63. package/src/cli/pane-functions/index.ts +3 -0
  64. package/src/cli/pane-functions/market-session.ts +14 -5
  65. package/src/cli/pane-functions/resolver.ts +4 -1
  66. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  67. package/src/cli/pane-functions/screenshot-payload.ts +130 -66
  68. package/src/cli/pane-functions/screenshot-render.ts +14 -2
  69. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  70. package/src/cli/restore-plugins.ts +164 -51
  71. package/src/cli/symbol-rows.ts +22 -2
  72. package/src/cli/ticker-resolution.ts +74 -17
  73. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  74. package/src/components/chart/composite/composite-chart.tsx +8 -1
  75. package/src/components/chart/composite/format.ts +16 -1
  76. package/src/components/chart/composite/legend.tsx +4 -3
  77. package/src/components/chart/composite/panel-labels.ts +2 -1
  78. package/src/components/chart/composite/panel-surface.tsx +33 -4
  79. package/src/components/chart/composite/time-scale.ts +1 -1
  80. package/src/components/chart/composite/toolbar.tsx +8 -4
  81. package/src/components/chart/composite/types.ts +17 -1
  82. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  83. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  84. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  85. package/src/components/chart-table/axis.ts +11 -0
  86. package/src/components/chart-table/header.tsx +10 -1
  87. package/src/components/chart-table/layout.ts +14 -5
  88. package/src/components/command-bar/assist/inventory.ts +3 -2
  89. package/src/components/command-bar/commands/collection-list.ts +3 -2
  90. package/src/components/command-bar/panel/index.tsx +13 -0
  91. package/src/components/command-bar/panel/layout.ts +15 -1
  92. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  93. package/src/components/command-bar/panel/runtime.ts +1 -0
  94. package/src/components/command-bar/panel/state.ts +4 -0
  95. package/src/components/command-bar/panel/types.ts +2 -0
  96. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  97. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  98. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  99. package/src/components/company-logo.tsx +2 -2
  100. package/src/components/data-table/view.tsx +11 -2
  101. package/src/components/feed-data-table/stack-view.tsx +20 -6
  102. package/src/components/feedback-dialog.tsx +3 -1
  103. package/src/components/form-modal/field-row.tsx +1 -1
  104. package/src/components/form-modal/routes.ts +1 -0
  105. package/src/components/index.ts +1 -1
  106. package/src/components/layout/header.tsx +12 -3
  107. package/src/components/layout/market-summary.ts +2 -1
  108. package/src/components/layout/pane/footer/index.tsx +9 -5
  109. package/src/components/layout/pane/footer/model.ts +26 -10
  110. package/src/components/layout/pane/footer/registration.tsx +60 -1
  111. package/src/components/layout/pane/header-tabs.tsx +17 -3
  112. package/src/components/layout/pane/header.tsx +5 -2
  113. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  114. package/src/components/layout/shell/active-drag.ts +38 -30
  115. package/src/components/layout/shell/drag/index.ts +51 -21
  116. package/src/components/layout/shell/menu.ts +3 -5
  117. package/src/components/layout/shell/pane/actions.ts +4 -1
  118. package/src/components/layout/shell/pane/ask.ts +5 -2
  119. package/src/components/layout/status-bar.tsx +59 -54
  120. package/src/components/markdown-text.tsx +35 -10
  121. package/src/components/onboarding/first-run-workspace.ts +25 -23
  122. package/src/components/onboarding/onboarding-keyboard.ts +6 -1
  123. package/src/components/onboarding/onboarding-wizard.tsx +12 -2
  124. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -3
  125. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  126. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  127. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  128. package/src/components/onboarding/wizard-positions.ts +8 -1
  129. package/src/components/pane-notice-seen.ts +125 -0
  130. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  131. package/src/components/pane-settings-dialog.tsx +7 -6
  132. package/src/components/sign-in-code-panel.tsx +3 -2
  133. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  134. package/src/components/ticker/list-table-view.tsx +39 -3
  135. package/src/components/ui/confirm-dialog.tsx +2 -1
  136. package/src/components/ui/data-table/index.tsx +4 -2
  137. package/src/components/ui/data-table/opentui/index.tsx +15 -5
  138. package/src/components/ui/data-table/types.ts +8 -0
  139. package/src/components/ui/external-link.tsx +4 -1
  140. package/src/components/ui/field-grid.tsx +1 -1
  141. package/src/components/ui/index.ts +2 -0
  142. package/src/components/ui/inline-quick-add.tsx +5 -0
  143. package/src/components/ui/multi-select/dialog.tsx +10 -9
  144. package/src/components/ui/pane-link-chip.tsx +354 -0
  145. package/src/components/ui/query-bar.tsx +22 -13
  146. package/src/components/ui/ratio-bar.tsx +24 -1
  147. package/src/components/ui/select-button.tsx +2 -1
  148. package/src/components/ui/shortcut-hint.tsx +6 -3
  149. package/src/components/ui/table-layout.ts +81 -0
  150. package/src/components/ui/tabs.tsx +45 -6
  151. package/src/components/use-pane-notice-footer.tsx +12 -4
  152. package/src/core/app-service-ports.ts +1 -1
  153. package/src/data/plugin-state-store.ts +44 -8
  154. package/src/docs/snapshot.json +53 -32
  155. package/src/i18n/es.ts +28 -6
  156. package/src/i18n/ja.ts +28 -5
  157. package/src/i18n/ko.ts +28 -5
  158. package/src/i18n/zh-cn.ts +28 -5
  159. package/src/i18n/zh-tw.ts +28 -5
  160. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  161. package/src/layout/pane-manager/gridlock.ts +47 -2
  162. package/src/layout-marketplace/api.ts +1 -0
  163. package/src/layout-marketplace/gallery.tsx +4 -3
  164. package/src/layout-marketplace/linked.ts +6 -4
  165. package/src/layout-marketplace/model.ts +3 -2
  166. package/src/market-data/fund-facts.ts +7 -1
  167. package/src/market-data/futures-contract.ts +77 -31
  168. package/src/market-data/fx-closes.ts +5 -2
  169. package/src/market-data/hooks.tsx +23 -0
  170. package/src/market-data/market/change-basis.ts +92 -14
  171. package/src/market-data/market/format.ts +81 -13
  172. package/src/market-data/market/futures-week.ts +3 -1
  173. package/src/market-data/market/globex-day.ts +73 -0
  174. package/src/market-data/market/index-level.ts +10 -1
  175. package/src/market-data/quotes/intraday-bar.ts +1 -1
  176. package/src/market-data/quotes/session-split.ts +28 -0
  177. package/src/plugins/builtin/account-management/pane.tsx +1 -1
  178. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  179. package/src/plugins/builtin/analytics/index.tsx +10 -3
  180. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  181. package/src/plugins/builtin/analytics/risk-client.ts +4 -1
  182. package/src/plugins/builtin/analytics/risk-episodes.ts +422 -0
  183. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  184. package/src/plugins/builtin/analytics/risk-headless.ts +28 -10
  185. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  186. package/src/plugins/builtin/analytics/risk-model.ts +115 -26
  187. package/src/plugins/builtin/analytics/risk-pane.tsx +201 -23
  188. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  189. package/src/plugins/builtin/backtest/format.ts +14 -0
  190. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  191. package/src/plugins/builtin/backtest/report.ts +5 -3
  192. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  193. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  194. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  195. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  196. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  197. package/src/plugins/builtin/catalysts/model.ts +7 -2
  198. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  199. package/src/plugins/builtin/chart-composer/headless.ts +57 -17
  200. package/src/plugins/builtin/chart-composer/session-range.ts +82 -3
  201. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  202. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  203. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  204. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  205. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  206. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  207. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  208. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  209. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  210. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  211. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  212. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  213. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  214. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  215. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  216. package/src/plugins/builtin/correlation/compute.ts +8 -2
  217. package/src/plugins/builtin/correlation/headless.ts +10 -9
  218. package/src/plugins/builtin/correlation/history.ts +30 -0
  219. package/src/plugins/builtin/correlation/index.tsx +39 -167
  220. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  221. package/src/plugins/builtin/correlation/matrix/model.ts +10 -10
  222. package/src/plugins/builtin/correlation/relationship/model.ts +3 -6
  223. package/src/plugins/builtin/correlation/relationship/pane.tsx +7 -9
  224. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  225. package/src/plugins/builtin/cot/client.ts +8 -3
  226. package/src/plugins/builtin/cot/headless.ts +65 -12
  227. package/src/plugins/builtin/cot/pane.tsx +11 -5
  228. package/src/plugins/builtin/crypto-board/client.ts +6 -1
  229. package/src/plugins/builtin/crypto-board/defi-view.tsx +12 -1
  230. package/src/plugins/builtin/crypto-board/defi.ts +44 -7
  231. package/src/plugins/builtin/crypto-board/headless.ts +83 -12
  232. package/src/plugins/builtin/crypto-board/model.ts +30 -6
  233. package/src/plugins/builtin/crypto-board/pane.tsx +13 -2
  234. package/src/plugins/builtin/earnings/client.ts +40 -6
  235. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  236. package/src/plugins/builtin/earnings/headless.ts +47 -11
  237. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  238. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  239. package/src/plugins/builtin/earnings/history.tsx +23 -8
  240. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  241. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  242. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  243. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  244. package/src/plugins/builtin/econ/index.tsx +5 -4
  245. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  246. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  247. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  248. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  249. package/src/plugins/builtin/futures/index.tsx +32 -10
  250. package/src/plugins/builtin/futures/model.ts +93 -6
  251. package/src/plugins/builtin/futures/returns.ts +29 -7
  252. package/src/plugins/builtin/futures/table.tsx +59 -17
  253. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  254. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  255. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  256. package/src/plugins/builtin/futures-curve/model.ts +111 -15
  257. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  258. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  259. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  260. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  261. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  262. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  263. package/src/plugins/builtin/help/index.tsx +68 -61
  264. package/src/plugins/builtin/holders/format.ts +7 -2
  265. package/src/plugins/builtin/holders/pane.tsx +11 -3
  266. package/src/plugins/builtin/holders/report-header.ts +5 -4
  267. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  268. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  269. package/src/plugins/builtin/insider/signals-model.ts +4 -5
  270. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  271. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  272. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  273. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  274. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -0
  275. package/src/plugins/builtin/perps/headless.ts +81 -19
  276. package/src/plugins/builtin/perps/index.tsx +3 -1
  277. package/src/plugins/builtin/perps/model.ts +1 -1
  278. package/src/plugins/builtin/perps/pane.tsx +2 -0
  279. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  280. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +20 -1
  281. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  282. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +154 -0
  283. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +64 -22
  284. package/src/plugins/builtin/portfolio-list/cli/render.ts +18 -7
  285. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  286. package/src/plugins/builtin/portfolio-list/grid.tsx +56 -12
  287. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  288. package/src/plugins/builtin/portfolio-list/pane/index.tsx +42 -4
  289. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  290. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  291. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  292. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  293. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  294. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  295. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  296. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +118 -4
  297. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  298. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  299. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  300. package/src/plugins/builtin/portfolio-list/table.tsx +105 -6
  301. package/src/plugins/builtin/power/headless.ts +47 -9
  302. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  303. package/src/plugins/builtin/research-search/article.ts +12 -2
  304. package/src/plugins/builtin/research-search/data.ts +5 -2
  305. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  306. package/src/plugins/builtin/research-search/model.ts +47 -3
  307. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  308. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  309. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  310. package/src/plugins/builtin/risk-factors/index.tsx +2 -28
  311. package/src/plugins/builtin/risk-factors/lock-note.ts +58 -0
  312. package/src/plugins/builtin/risk-factors/pane.tsx +14 -5
  313. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  314. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  315. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  316. package/src/plugins/builtin/scanner/hilo-model.ts +4 -3
  317. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  318. package/src/plugins/builtin/sec/forms.ts +19 -0
  319. package/src/plugins/builtin/sec/fund-facts.ts +45 -11
  320. package/src/plugins/builtin/sec/headless.ts +37 -12
  321. package/src/plugins/builtin/sec/index.tsx +37 -8
  322. package/src/plugins/builtin/shared/earnings-calendar.ts +6 -3
  323. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  324. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  325. package/src/plugins/builtin/shared/pro-lock-note.ts +5 -1
  326. package/src/plugins/builtin/shared/use-quote-board.ts +42 -27
  327. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  328. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  329. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  330. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  331. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  332. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  333. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  334. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  335. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  336. package/src/plugins/builtin/ticker-detail/headless-schema.ts +10 -1
  337. package/src/plugins/builtin/ticker-detail/headless.ts +8 -1
  338. package/src/plugins/builtin/ticker-detail/overview/components.tsx +2 -1
  339. package/src/plugins/builtin/ticker-detail/overview/model.ts +18 -8
  340. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +11 -8
  341. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  342. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  343. package/src/plugins/builtin/ticker-detail/settings.ts +4 -3
  344. package/src/plugins/builtin/time-sales/headless.ts +23 -7
  345. package/src/plugins/builtin/time-sales/index.tsx +2 -2
  346. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  347. package/src/plugins/extracted-plugins.ts +49 -24
  348. package/src/plugins/host-resolver.ts +3 -2
  349. package/src/plugins/installer.ts +220 -31
  350. package/src/plugins/running-installs.ts +34 -0
  351. package/src/plugins/seed-progress.ts +72 -0
  352. package/src/portfolio/column-values.ts +42 -8
  353. package/src/portfolio/futures-positions.ts +10 -2
  354. package/src/portfolio/mutations.ts +4 -3
  355. package/src/portfolio/period-pnl.ts +119 -0
  356. package/src/portfolio/positions-import/describe.ts +89 -0
  357. package/src/portfolio/positions-import/parse.ts +682 -0
  358. package/src/portfolio/positions-import/plan.ts +295 -0
  359. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  360. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  361. package/src/react/jsx-dev-fallback.ts +62 -0
  362. package/src/renderers/browser/cloud-transport.ts +1 -1
  363. package/src/renderers/browser/config-host.ts +3 -1
  364. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  365. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  366. package/src/renderers/browser/main.tsx +2 -1
  367. package/src/renderers/browser/research-entry.ts +12 -0
  368. package/src/renderers/cloudflare/http-proxy.ts +8 -2
  369. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  370. package/src/renderers/cloudflare/worker.ts +12 -3
  371. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  372. package/src/renderers/dom/desktop/controls.tsx +1 -1
  373. package/src/renderers/dom/desktop/dialog-actions.tsx +10 -24
  374. package/src/renderers/dom/desktop/icons.tsx +4 -2
  375. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  376. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  377. package/src/renderers/dom/host/box.tsx +2 -2
  378. package/src/renderers/dom/host/input.tsx +13 -0
  379. package/src/renderers/dom/key-event.ts +1 -0
  380. package/src/renderers/dom/styles.css +3 -0
  381. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  382. package/src/renderers/electrobun/bun/desktop/backend.ts +15 -0
  383. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  384. package/src/renderers/electrobun/bun/desktop/host-requests.ts +19 -11
  385. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  386. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  387. package/src/renderers/electrobun/bun/desktop/initialization.ts +27 -15
  388. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  389. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  390. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  391. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  392. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  393. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  394. package/src/renderers/electrobun/bun/index.ts +5 -0
  395. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  396. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  397. package/src/renderers/electrobun/bun/window/context-menu-thread.ts +84 -0
  398. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  399. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  400. package/src/renderers/electrobun/bun/window/native-call-thread.ts +224 -0
  401. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  402. package/src/renderers/electrobun/bun/window/native-timing.ts +10 -0
  403. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  404. package/src/renderers/electrobun/bun/window/script-for-webview.ts +15 -0
  405. package/src/renderers/electrobun/bun/window/webview-script-thread.ts +82 -0
  406. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  407. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  408. package/src/renderers/electrobun/shared/protocol.ts +13 -2
  409. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  410. package/src/renderers/electrobun/view/backend-rpc.ts +7 -0
  411. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  412. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  413. package/src/renderers/electrobun/view/cli-pane-shot-frame.tsx +1 -1
  414. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  415. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  416. package/src/renderers/electrobun/view/main.tsx +13 -7
  417. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  418. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  419. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  420. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  421. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  422. package/src/renderers/opentui/browser-open.ts +2 -1
  423. package/src/renderers/opentui/dialog-host.tsx +1 -1
  424. package/src/renderers/opentui/interaction-performance.ts +3 -1
  425. package/src/renderers/opentui/start.tsx +5 -1
  426. package/src/renderers/opentui/terminal-media.ts +11 -6
  427. package/src/renderers/opentui/ui-host.tsx +5 -8
  428. package/src/shares/open.ts +22 -1
  429. package/src/shares/pane.ts +2 -1
  430. package/src/sources/gloomberb-cloud/normalizers.ts +3 -0
  431. package/src/sync/analytics-payload.ts +194 -0
  432. package/src/sync/baseline.ts +19 -9
  433. package/src/sync/broker-identity.ts +171 -0
  434. package/src/sync/broker-instances.ts +137 -0
  435. package/src/sync/collections-contributor.ts +173 -0
  436. package/src/sync/config-contributor.ts +100 -0
  437. package/src/sync/config-merge.ts +229 -0
  438. package/src/sync/controller.ts +139 -28
  439. package/src/sync/core-contributors.ts +8 -1583
  440. package/src/sync/history-memo.ts +32 -0
  441. package/src/sync/layout-merge.ts +259 -0
  442. package/src/sync/sanitize.ts +114 -0
  443. package/src/sync/ticker-merge.ts +208 -0
  444. package/src/sync/ticker-payload.ts +81 -0
  445. package/src/sync/types.ts +15 -1
  446. package/src/telemetry/attention-setting.ts +1 -1
  447. package/src/telemetry/stall-reports.ts +21 -4
  448. package/src/telemetry/usage-counts.ts +16 -0
  449. package/src/test-support/preload.ts +5 -0
  450. package/src/theme/color-utils.ts +10 -0
  451. package/src/theme/font-scale.ts +34 -3
  452. package/src/theme/series-colors.ts +44 -0
  453. package/src/theme/themes.ts +2 -1
  454. package/src/tickers/batched-lookups.ts +263 -6
  455. package/src/tickers/company-name-listing.ts +44 -2
  456. package/src/tickers/company-name.ts +7 -2
  457. package/src/tickers/search/upsert.ts +16 -1
  458. package/src/time-series/base-series.ts +18 -4
  459. package/src/time-series/studies/indicators.ts +3 -1
  460. package/src/time-series/studies/resolve.ts +1 -1
  461. package/src/time-series/types.ts +6 -0
  462. package/src/types/financials.ts +18 -0
  463. package/src/types/headless.ts +11 -0
  464. package/src/ui/host.tsx +26 -3
  465. package/src/ui/index.tsx +1 -0
  466. package/src/utils/concurrency.ts +6 -0
  467. package/src/utils/currency-pair.ts +56 -4
  468. package/src/utils/datetime-format.ts +11 -0
  469. package/src/utils/decimal-comma.ts +9 -6
  470. package/src/utils/exchanges.ts +32 -0
  471. package/src/utils/fundamentals.ts +41 -0
  472. package/src/utils/main-thread-stall.ts +21 -5
  473. package/src/utils/markdown.ts +4 -2
  474. package/src/utils/pasted-lines.ts +14 -0
  475. package/src/utils/perf-marks.ts +88 -9
  476. package/src/utils/price-window.ts +2 -1
  477. package/src/utils/reported-money.ts +9 -2
  478. package/src/utils/sec-filings.ts +17 -0
  479. package/src/utils/sec.ts +37 -25
  480. package/src/utils/shortcut-labels.ts +6 -30
  481. package/src/plugins/seed-notice.ts +0 -20
@@ -0,0 +1,154 @@
1
+ import type { ReportFreshness } from "../../../../cli/pane-functions/freshness";
2
+ import { cliFreshnessFooter } from "../../../../cli/result";
3
+ import { renderReportGlossary, reportGlossary } from "../../../../cli/glossary";
4
+ import { formatMarketPriceWithCurrency, formatMarketQuantity, withCurrencyMinorDigits } from "../../../../market-data/market/format";
5
+ import { periodDayText } from "../../../../market-data/market/period-return";
6
+ import { formatAllocationMoney } from "../../../../portfolio/allocation";
7
+ import type { CostFxHistoryClient } from "../../../../portfolio/cost-fx";
8
+ import { futuresQuantityText, isFuturesTicker, type PortfolioFuturesTerms } from "../../../../portfolio/futures-positions";
9
+ import type { PeriodPnlRow } from "../../../../portfolio/period-pnl";
10
+ import type { DataProvider } from "../../../../types/data-provider";
11
+ import type { Quote } from "../../../../types/financials";
12
+ import { formatFxRate } from "../../../../cli/fx-pair";
13
+ import { quotedFxPair } from "../../../../utils/currency-pair";
14
+ import type { CliCommandContext } from "../../../../types/plugin";
15
+ import type { Portfolio, TickerRecord } from "../../../../types/ticker";
16
+ import { cliStyles, colorBySign, renderTable } from "../../../../utils/cli-output";
17
+ import type { PriceWindow } from "../../../../utils/price-window";
18
+ import { loadPeriodPnl, periodBasisText, periodBoughtText, periodSharedDay, periodUnpricedText, type LoadedPeriodPnl } from "../period-pnl";
19
+
20
+ const signedPercent = (value: number | null) => value == null || !Number.isFinite(value) ? "—"
21
+ : `${value > 0 ? "+" : value < 0 ? "-" : ""}${Math.abs(value).toFixed(2)}%`;
22
+
23
+ /** `Fri 23 Oct`, with the year when it is not this one. */
24
+ const dayText = (day: string, year: number) => periodDayText(day, year);
25
+
26
+ /**
27
+ * `portfolio show <name> --from <date> [--to <date>]`: P&L and contribution
28
+ * by position between two closes, then the FX line and the total, in the
29
+ * book's currency. JSON and CSV carry the same rows, the FX line and the
30
+ * total as rows of their own, as `portfolio show` exports its cash and total.
31
+ */
32
+ export async function showPeriodPnl({ ctx, portfolio, name, tickers, currency, window, provider, fxHistory, quotes, futures, source, listingLabel, explain = false }: {
33
+ ctx: CliCommandContext;
34
+ portfolio: Portfolio;
35
+ name: string;
36
+ tickers: readonly TickerRecord[];
37
+ currency: string;
38
+ window: PriceWindow;
39
+ provider: DataProvider;
40
+ fxHistory: CostFxHistoryClient;
41
+ quotes: ReadonlyMap<string, Quote | undefined>;
42
+ futures: ReadonlyMap<string, PortfolioFuturesTerms>;
43
+ source: string;
44
+ /** How `portfolio show` names a row: GC=F:CMX. */
45
+ listingLabel: (ticker: TickerRecord) => string;
46
+ /** `--explain`: follow the report with what its terms mean (Contribution). */
47
+ explain?: boolean;
48
+ }) {
49
+ const explained = explain ? reportGlossary("PF", "Contribution") : [];
50
+ const structured = ctx.cliOptions?.format != null && ctx.cliOptions.format !== "text";
51
+ const result: LoadedPeriodPnl = await loadPeriodPnl({ tickers, portfolioId: portfolio.id, currency, window, provider, fxHistory, quotes, futures, refresh: !!ctx.cliOptions?.refresh });
52
+ const bySymbol = new Map(tickers.map((ticker) => [ticker.metadata.ticker, ticker]));
53
+ const label = (symbol: string) => {
54
+ const ticker = bySymbol.get(symbol);
55
+ return ticker ? listingLabel(ticker) : symbol;
56
+ };
57
+ const shares = (symbol: string) => (bySymbol.get(symbol)?.metadata.positions ?? [])
58
+ .filter((position) => position.portfolio === portfolio.id).reduce((sum, position) => sum + position.shares, 0);
59
+ const year = new Date().getUTCFullYear();
60
+ const startDay = periodSharedDay(result.rows, "start");
61
+ const endDay = periodSharedDay(result.rows, "end");
62
+ const futuresHeld = result.rows.some((row) => { const ticker = bySymbol.get(row.symbol); return !!ticker && isFuturesTicker(ticker); });
63
+ const basisText = periodBasisText(result, { futuresHeld });
64
+ const asOf = result.rows.reduce<string | null>((latest, row) => row.end && (!latest || row.end.day > latest) ? row.end.day : latest, null);
65
+ const freshness: ReportFreshness = { source, asOf, status: "not-a-feed", basis: `daily closes, ${window.from} to ${window.to}`, retrievedAt: new Date().toISOString() };
66
+ const contributionNote = result.contributionBase == null ? null
67
+ : `Contribution is P&L over the book's ${result.contributionBasis === "gross" ? "gross exposure" : "value"} at the start, ${formatAllocationMoney(result.contributionBase, currency, { whole: true })}${result.contributionBasis === "gross" ? ", longs plus shorts at their absolute value, as the book holds a short" : ""}; cash excluded.`;
68
+ const fxRows = result.rows.filter((row) => row.rates);
69
+ const fxCurrencies = [...new Set(fxRows.map((row) => row.rates!.currency))].join(", ");
70
+
71
+ if (structured) {
72
+ const data = result.rows.map((row) => {
73
+ const ticker = bySymbol.get(row.symbol);
74
+ return {
75
+ symbol: row.symbol, listing: label(row.symbol), shares: shares(row.symbol), priceUnits: Number.isFinite(row.priceUnits) ? row.priceUnits : null,
76
+ ...(ticker && isFuturesTicker(ticker) ? { contractSize: futures.get(row.symbol)?.size?.size ?? null } : {}),
77
+ currency: row.currency, startDay: row.start?.day ?? null, startPrice: row.start?.price ?? null,
78
+ endDay: row.end?.day ?? null, endPrice: row.end?.price ?? null, endPartial: row.partialEnd,
79
+ changePercent: row.changePercent, startValue: row.startValue, pnl: row.pnl, fx: row.fx,
80
+ fxCurrency: row.rates?.currency ?? null, fxStart: row.rates?.start ?? null, fxEnd: row.rates?.end ?? null, contribution: row.contribution, baseCurrency: currency,
81
+ };
82
+ });
83
+ const extraRows: Record<string, unknown>[] = [
84
+ ...(fxRows.length ? [{ symbol: "FX", pnl: result.fx, contribution: result.fxContribution, baseCurrency: currency }] : []),
85
+ { symbol: "TOTAL", pnl: result.total, contribution: result.totalContribution, baseCurrency: currency },
86
+ ];
87
+ ctx.printResult({ data, metadata: {
88
+ portfolioId: portfolio.id, portfolioName: name, baseCurrency: currency, from: window.from, to: window.to,
89
+ startDay, endDay, basis: basisText, fx: result.fx, fxContribution: result.fxContribution, total: result.total, totalContribution: result.totalContribution,
90
+ contributionBase: result.contributionBase, contributionBasis: result.contributionBasis,
91
+ complete: result.unpriced.length === 0, unpricedSymbols: result.unpriced, unpriced: result.unpricedReasons, failures: result.failures,
92
+ boughtInWindowSymbols: result.boughtInWindow, latestPriceAt: result.latestPriceAt == null ? null : new Date(result.latestPriceAt).toISOString(),
93
+ ...(explain ? { glossary: explained.map(({ term, definition }) => ({ term, definition })) } : {}),
94
+ method: "Each holding's price move times the units held now (contracts times their size for a future), converted at the end's FX rate; the FX line is each holding's start value times its currency's move. Contribution divides by the book's value at the start, gross when it holds a short.",
95
+ }, freshness }, { rows: (rows) => [...(rows as Record<string, unknown>[]), ...extraRows] });
96
+ return;
97
+ }
98
+
99
+ const money = (value: number | null | undefined) => value == null || !Number.isFinite(value) ? "—"
100
+ : colorBySign(formatAllocationMoney(value, currency, { signed: true }), value);
101
+ // Padded to the currency's minor unit ($80.20, not $80.2), as `portfolio show` prints Last.
102
+ const price = (row: PeriodPnlRow, close: PeriodPnlRow["start"]) => close ? formatMarketPriceWithCurrency(close.price, row.currency,
103
+ withCurrencyMinorDigits({ assetCategory: bySymbol.get(row.symbol)?.metadata.assetCategory }, row.currency)) : "—";
104
+ const quantity = (symbol: string) => {
105
+ const ticker = bySymbol.get(symbol);
106
+ const units = formatMarketQuantity(shares(symbol), { assetCategory: ticker?.metadata.assetCategory });
107
+ return ticker && isFuturesTicker(ticker) ? futuresQuantityText(units, futures.get(symbol)?.size ?? null) : units;
108
+ };
109
+ const dated = !startDay || !endDay;
110
+ const rows = result.rows.map((row) => [
111
+ label(row.symbol), quantity(row.symbol),
112
+ ...dated ? [row.start ? dayText(row.start.day, year) : "—"] : [], price(row, row.start),
113
+ ...dated ? [row.end ? dayText(row.end.day, year) : "—"] : [], price(row, row.end),
114
+ row.changePercent == null ? "—" : colorBySign(signedPercent(row.changePercent), row.changePercent),
115
+ money(row.pnl), row.contribution == null ? "—" : colorBySign(signedPercent(row.contribution), row.contribution),
116
+ ]);
117
+ const blank = (count: number) => Array.from({ length: count }, () => "");
118
+ const lead = 3 + (dated ? 2 : 0) + 2;
119
+ if (fxRows.length) rows.push([`FX (${fxCurrencies})`, ...blank(lead - 1), money(result.fx), colorBySign(signedPercent(result.fxContribution), result.fxContribution ?? 0)]);
120
+ rows.push([cliStyles.bold("TOTAL"), ...blank(lead - 1), cliStyles.bold(money(result.total)),
121
+ result.totalContribution == null ? "—" : colorBySign(signedPercent(result.totalContribution), result.totalContribution)]);
122
+
123
+ console.log(cliStyles.bold(`${name} (${currency})`));
124
+ console.log(cliStyles.muted(basisText));
125
+ console.log("");
126
+ console.log(renderTable([
127
+ { header: "Ticker" },
128
+ { header: futuresHeld ? "Qty" : "Shares", align: "right" },
129
+ ...dated ? [{ header: "From", optional: true, dropPriority: 1 }] : [],
130
+ { header: "Start", align: "right", optional: true, dropPriority: 2 },
131
+ ...dated ? [{ header: "To", optional: true, dropPriority: 1 }] : [],
132
+ { header: "End", align: "right", optional: true, dropPriority: 2 },
133
+ { header: "Chg", align: "right", optional: true, dropPriority: 3 },
134
+ { header: "P&L", align: "right" },
135
+ { header: "Contribution", align: "right" },
136
+ ], rows));
137
+ console.log("");
138
+ const notes: string[] = [];
139
+ // As markets quote the pair, as `portfolio show` writes its FX line: USD/HKD 7.7531 on Fri 23 Oct, 7.7502 on Fri 30 Oct.
140
+ const rateText = (row: PeriodPnlRow) => {
141
+ const start = quotedFxPair(row.rates!.currency, currency, row.rates!.start);
142
+ const end = quotedFxPair(row.rates!.currency, currency, row.rates!.end);
143
+ return `${start.pair} ${formatFxRate(start.rate)} on ${dayText(row.start!.day, year)}, ${formatFxRate(end.rate)} on ${dayText(row.end!.day, year)}`;
144
+ };
145
+ if (fxRows.length) notes.push(`FX: ${[...new Set(fxRows.map(rateText))].join("; ")}. P&L converts at the end's rate; the FX line is the currency's move on the start value.`);
146
+ if (contributionNote) notes.push(contributionNote);
147
+ const unpricedText = periodUnpricedText(result, label);
148
+ if (unpricedText) notes.push(cliStyles.warning(unpricedText));
149
+ const boughtText = periodBoughtText(result, label);
150
+ if (boughtText) notes.push(boughtText);
151
+ for (const note of [...new Set(notes)]) console.log(note.startsWith("\u001b") ? note : cliStyles.muted(note));
152
+ console.log(`\n${cliFreshnessFooter(freshness)}`);
153
+ if (explain) console.log(`\n${renderReportGlossary("This report", explained)}`);
154
+ }
@@ -48,6 +48,7 @@ import { findCachedPortfolioAccount } from "../cached-account";
48
48
  import { apiClient } from "../../../../api-client";
49
49
  import { importSource, notionalPositions, rankThirteenFLines, type ThirteenFImportLine } from "./import-13f";
50
50
  import { importedFromText } from "../imported-from";
51
+ import { importPositionsFileCommand, POSITIONS_IMPORT_HELP, POSITIONS_IMPORT_USAGE, type PositionsImportOptions } from "./import-positions";
51
52
  import { savedListingCoinNote } from "../../../../cli/commands/crypto-hints";
52
53
  import { findNamedCollection } from "../../../../portfolio/collection-name";
53
54
  import { ambiguousQuantityProblem } from "../../../../portfolio/position-quantity";
@@ -74,9 +75,10 @@ import {
74
75
  requirePortfolio,
75
76
  takeCollectionName,
76
77
  } from "./shared";
77
- import { addOneSymbol, addSymbols, FILE_OPTION, printSymbolRows, progressNotice, removeSymbols, requireSymbolList, retryNotice, shellWord, SYMBOL_LIST_HELP } from "./bulk-symbols";
78
+ import { addOneSymbol, addSymbols, FILE_OPTION, listAddLookups, printSymbolRows, progressNotice, removeSymbols, requireSymbolList, retryNotice, shellWord, SYMBOL_LIST_HELP } from "./bulk-symbols";
78
79
  import { readNameEntries } from "../../../../cli/name-entries";
79
80
  import { DRIP_DEFAULT_YEARS, DRIP_MAX_YEARS, parseDripYears, parseWithholding } from "../income";
81
+ import { readPriceWindow, type PriceWindow } from "../../../../utils/price-window";
80
82
 
81
83
  const ADD_USAGE = "Usage: gloom portfolio add <portfolio> <symbols...> [--file <path>]";
82
84
  const CREATE_USAGE = "Usage: gloom portfolio create <name> [--currency <code>]";
@@ -84,7 +86,7 @@ const POSITION_USAGE = "Usage: gloom portfolio position set <portfolio> <ticker>
84
86
  const REMOVE_USAGE = "Usage: gloom portfolio remove <portfolio> <symbols...> [--file <path>]";
85
87
  const CASH_USAGE = "Usage: gloom portfolio cash set <portfolio> <amount> [currency] | portfolio cash clear <portfolio>";
86
88
  const TARGET_USAGE = "Usage: gloom portfolio target set <portfolio> <symbol|CASH> <weight%> | target clear <portfolio> [symbol] | target show <portfolio>";
87
- const IMPORT_USAGE = "Usage: gloom portfolio import --13f <CIK|fund name> [--top N] [--name <portfolio>] [--notional <amount>] [--replace]";
89
+ const IMPORT_USAGE = "Usage: gloom portfolio import <file> [--name <portfolio>] [--merge | --replace] [--dry-run] | portfolio import --13f <CIK|fund name> [--top N] [--name <portfolio>] [--notional <amount>] [--replace]";
88
90
  const IMPORT_DEFAULT_TOP = 10;
89
91
  const IMPORT_MAX_TOP = 100;
90
92
  const IMPORT_DEFAULT_NOTIONAL = 100_000;
@@ -247,7 +249,9 @@ async function addTickerToPortfolioCommand(
247
249
  async function addToPortfolioCommand(args: string[], file: string | undefined, exchange: string | undefined, ctx: CliCommandContext) {
248
250
  await withCollectionMarketData(ctx, async (market) => {
249
251
  const { portfolio, rest } = requirePortfolioArgs(market.config, args, file, "add", ADD_USAGE, ctx);
250
- const list = await requireSymbolList(ctx, rest, file, ADD_USAGE, (entries) => readNameEntries(entries, market.dataProvider));
252
+ // Reading the names and looking the symbols up share their answers, so nothing is asked twice.
253
+ const lookups = await listAddLookups(market.dataProvider);
254
+ const list = await requireSymbolList(ctx, rest, file, ADD_USAGE, (entries) => readNameEntries(entries, lookups));
251
255
  if (list.single) {
252
256
  await addTickerToPortfolioCommand(portfolio, list.single, list.notes, exchange, ctx, market);
253
257
  return;
@@ -258,7 +262,7 @@ async function addToPortfolioCommand(args: string[], file: string | undefined, e
258
262
  symbols: list.symbols,
259
263
  exchange,
260
264
  store: market.store,
261
- dataProvider: market.dataProvider,
265
+ dataProvider: lookups,
262
266
  reject: cashRefusal(portfolio, exchange),
263
267
  suggest: true,
264
268
  dryRun,
@@ -763,14 +767,7 @@ function parseImportOptions(args: string[], ctx: CliCommandContext): ThirteenFIm
763
767
  const name = takeImportValue(args, "--name", ctx);
764
768
  const notional = takeImportValue(args, "--notional", ctx);
765
769
  const replace = takeFlag(args, "--replace");
766
- // `portfolio import holdings.csv` is a list of symbols, which add reads.
767
- const path = args.find((arg) => /\.(csv|tsv|txt)$/i.test(arg));
768
- if (!query && path) {
769
- ctx.fail(
770
- `portfolio import reads a manager's 13F filing. To add the symbols in ${path}, run: gloom portfolio add <portfolio> --file ${path}`,
771
- IMPORT_USAGE,
772
- );
773
- }
770
+ if (takeFlag(args, "--merge")) ctx.fail("--merge is an option of portfolio import <file>; a 13F import fills an empty portfolio or replaces one with --replace.", IMPORT_USAGE);
774
771
  if (!query) ctx.fail("portfolio import needs a manager: --13f <CIK|fund name>.", IMPORT_USAGE);
775
772
  if (args.length > 0) {
776
773
  ctx.fail(`portfolio import takes its manager and portfolio as options; got ${args.join(" ")}.`, `Quote a name with spaces, as in --13f "Berkshire Hathaway".\n${IMPORT_USAGE}`);
@@ -788,6 +785,23 @@ function parseImportOptions(args: string[], ctx: CliCommandContext): ThirteenFIm
788
785
  return { query, top: count, name: name || undefined, notional: amount, replace };
789
786
  }
790
787
 
788
+ /** `portfolio import <file>`: the file, the portfolio to fill and how; a 13F's options are refused. */
789
+ function parsePositionsImportOptions(args: string[], ctx: CliCommandContext): PositionsImportOptions {
790
+ const name = takeImportValue(args, "--name", ctx);
791
+ const merge = takeFlag(args, "--merge");
792
+ const replace = takeFlag(args, "--replace");
793
+ if (merge && replace) ctx.fail("Give --merge or --replace, not both.", POSITIONS_IMPORT_USAGE);
794
+ const thirteenF = args.find((arg) => /^--(?:top|notional)(?:=|$)/.test(arg));
795
+ if (thirteenF) ctx.fail(`${thirteenF.split("=")[0]} is an option of portfolio import --13f.`, IMPORT_USAGE);
796
+ const flag = args.find((arg) => arg.startsWith("--"));
797
+ if (flag) ctx.fail(`Unknown option ${flag.split("=")[0]} for portfolio import.`, POSITIONS_IMPORT_USAGE);
798
+ if (args.length === 0) ctx.fail("portfolio import needs a positions file (CSV), or a manager with --13f <CIK|fund name>.", IMPORT_USAGE);
799
+ if (args.length > 1) {
800
+ ctx.fail(`portfolio import reads one file; got ${args.join(" ")}.`, `Quote a path with spaces, and name the portfolio with --name.\n${POSITIONS_IMPORT_USAGE}`);
801
+ }
802
+ return { path: args[0]!, name: name || undefined, mode: merge ? "merge" : replace ? "replace" : null };
803
+ }
804
+
791
805
  /**
792
806
  * A manual portfolio from a manager's latest 13F: its largest common-stock
793
807
  * lines that resolve to a listing, weighted by reported value, as a notional
@@ -901,7 +915,7 @@ async function importThirteenFCommand(options: ThirteenFImportOptions, ctx: CliC
901
915
  });
902
916
  }
903
917
 
904
- const IMPORT_FLAGS = new Set(["--13f", "--top", "--name", "--notional", "--replace"]);
918
+ const IMPORT_FLAGS = new Set(["--13f", "--top", "--name", "--notional", "--replace", "--merge"]);
905
919
 
906
920
  /** The actions `portfolio` takes; any other first word names a portfolio to show. */
907
921
  const KNOWN_ACTIONS = new Set(["list", "show", "create", "delete", "rm", "add", "remove", "position", "cash", "target", "targets", "import"]);
@@ -914,6 +928,7 @@ const VALUE_HELP = {
914
928
  "--close prices the book at the regular close instead: Value is Last times the shares, P&L, weights and the total follow, and the day's move from the close before is printed under the table. A future is priced at its exchange settlement, dated by its session, as quote states it.",
915
929
  "A short is a negative position: its value, cost and P&L are negative, and the Exposure line under the table adds up the longs, the shorts, net and gross.",
916
930
  "A future is held in contracts: Qty reads 1,000 × 100 oz, and Value is the contracts times the contract size times the price. A future whose contract size is unknown is not valued.",
931
+ "--from <date> [--to <date>] prints the P&L between two closes instead: each holding from the close before --from to its last close on or before --to (today when left out), as RETURN measures the same dates, on the holdings held now. A short gains when the price falls; a future counts its contracts at their size, between settlements. A holding in another currency earns its move at the end's FX rate, and the FX line is the currency's move on its start value. Contribution is each P&L over the book's value at the start (gross when it holds a short).",
917
932
  ],
918
933
  };
919
934
 
@@ -958,6 +973,7 @@ export const portfolioCliCommand: CliCommandDef = {
958
973
  usage: [
959
974
  "portfolio [list]",
960
975
  "portfolio show <name> [--close] [--explain] [--drip [--years 1-5] [--withholding <pct>]]",
976
+ "portfolio show <name> --from <date> [--to <date>]",
961
977
  "portfolio create <name> [--currency <code>]",
962
978
  "portfolio delete <name>",
963
979
  "portfolio add <portfolio> <symbols...> [--file <path>]",
@@ -968,24 +984,28 @@ export const portfolioCliCommand: CliCommandDef = {
968
984
  "portfolio target set <portfolio> <symbol|CASH> <weight%>",
969
985
  "portfolio target clear <portfolio> [symbol|CASH]",
970
986
  "portfolio target show <portfolio>",
987
+ "portfolio import <file> [--name <portfolio>] [--merge | --replace] [--dry-run]",
971
988
  "portfolio import --13f <CIK|fund name> [--top N] [--name <portfolio>] [--notional <amount>] [--replace]",
972
989
  ],
973
990
  options: [
974
991
  EXCHANGE_OPTION,
975
992
  FILE_OPTION,
976
993
  { flags: "--close", description: "show: value the book at the regular close (futures at the settlement), not the latest print" },
994
+ { flags: "--from <date>", description: "show: P&L and contribution by position from the close before this date (a year or a date)" },
995
+ { flags: "--to <date>", description: "show --from: to the last close on or before this date (default today)" },
977
996
  { flags: "--drip", description: "show: project the shares and income reinvested dividends add, year by year" },
978
997
  { flags: "--years <1-5>", description: `show --drip: how many years to project (default ${DRIP_DEFAULT_YEARS})` },
979
998
  { flags: "--withholding <pct>", description: "show --drip: tax withheld from each dividend, in percent (default 0)" },
980
999
  { flags: "--13f <CIK|name>", description: "portfolio import: the 13F manager whose latest filing to import" },
981
1000
  { flags: "--top <n>", description: `portfolio import: how many of its largest common-stock lines (default ${IMPORT_DEFAULT_TOP}, at most ${IMPORT_MAX_TOP})` },
982
- { flags: "--name <portfolio>", description: "portfolio import: the portfolio to create or fill (default: the manager's name and 13F)" },
1001
+ { flags: "--name <portfolio>", description: "portfolio import: the portfolio to create or fill (default: the broker's name for a file, the manager's name and 13F for --13f)" },
983
1002
  { flags: "--notional <amount>", description: "portfolio import: the USD total the shares add up to at the filing's prices (default 100,000)" },
984
- { flags: "--replace", description: "portfolio import: replace the positions of an existing portfolio of that name" },
1003
+ { flags: "--merge", description: "portfolio import <file>: update a portfolio that holds tickers with the file's positions, keeping the rest" },
1004
+ { flags: "--replace", description: "portfolio import: replace the positions of an existing portfolio of that name (a file's: remove holdings it does not list)" },
985
1005
  { flags: "--currency <code>", description: "portfolio create: the currency the portfolio totals in, whatever the base currency (a name's last word in capitals, such as THB, is read as one too)" },
986
1006
  { flags: "--date <purchase date>", description: `position set: the day it was bought, as ${DATE_OPTION_EXAMPLES}; a holding in another currency converts its cost at that day's FX close` },
987
1007
  { flags: "--cost-fx <rate>", description: "position set: the rate a holding in another currency was bought at, in the portfolio's currency per unit of the holding's (32.15 TRY per USD)" },
988
- { flags: "--explain", description: "portfolio show: follow the report with what its terms mean (Weight, Target, Drift, Trade); gloom catalog glossary lists every term" },
1008
+ { flags: "--explain", description: "portfolio show: follow the report with what its terms mean (Weight, Target, Drift, Trade; Contribution with --from); gloom catalog glossary lists every term" },
989
1009
  ],
990
1010
  examples: [
991
1011
  "portfolio show Research",
@@ -1006,16 +1026,25 @@ export const portfolioCliCommand: CliCommandDef = {
1006
1026
  "portfolio show Research --csv",
1007
1027
  "portfolio show Research --explain",
1008
1028
  "portfolio show Research --drip --years 3 --withholding 15",
1029
+ "portfolio show Research --from 2026-10-26 --to 2026-10-30",
1030
+ "portfolio import Portfolio_Positions.csv --dry-run",
1031
+ "portfolio import ~/Downloads/positions.csv --name Research --merge",
1009
1032
  "portfolio import --13f 0001067983 --top 10",
1010
1033
  ],
1011
- sections: [VALUE_HELP, POSITION_HELP, INCOME_HELP, AMOUNTS_HELP, SYMBOL_LIST_HELP],
1034
+ sections: [VALUE_HELP, POSITION_HELP, INCOME_HELP, AMOUNTS_HELP, SYMBOL_LIST_HELP, POSITIONS_IMPORT_HELP],
1012
1035
  },
1013
1036
  execute: async (rawArgs, ctx) => {
1014
1037
  const args = [...rawArgs];
1015
1038
  const action = args[0];
1016
1039
  if (action === "import") {
1017
- if (ctx.cliOptions.dryRun) ctx.fail("portfolio import has no --dry-run; it creates or fills the portfolio when it runs.");
1018
- await importThirteenFCommand(parseImportOptions(args.slice(1), ctx), ctx);
1040
+ const rest = args.slice(1);
1041
+ // A 13F names its manager with --13f; anything else is a broker's positions file.
1042
+ if (!rest.some((arg) => arg === "--13f" || arg.startsWith("--13f="))) {
1043
+ await importPositionsFileCommand(parsePositionsImportOptions(rest, ctx), ctx);
1044
+ return;
1045
+ }
1046
+ if (ctx.cliOptions.dryRun) ctx.fail("portfolio import --13f has no --dry-run; it creates or fills the portfolio when it runs.");
1047
+ await importThirteenFCommand(parseImportOptions(rest, ctx), ctx);
1019
1048
  return;
1020
1049
  }
1021
1050
  const exchange = takeOption(args, "--exchange");
@@ -1026,8 +1055,21 @@ export const portfolioCliCommand: CliCommandDef = {
1026
1055
  const hasWithholding = args.some((arg) => arg === "--withholding" || arg.startsWith("--withholding="));
1027
1056
  const yearsText = hasYears ? takeOption(args, "--years") ?? "" : undefined;
1028
1057
  const withholdingText = hasWithholding ? takeOption(args, "--withholding") ?? "" : undefined;
1058
+ const hasFrom = args.some((arg) => arg === "--from" || arg.startsWith("--from="));
1059
+ const hasTo = args.some((arg) => arg === "--to" || arg.startsWith("--to="));
1060
+ const fromText = hasFrom ? takeOption(args, "--from") ?? "" : undefined;
1061
+ const toText = hasTo ? takeOption(args, "--to") ?? "" : undefined;
1029
1062
  // A bare name shows the portfolio, as `show` does.
1030
1063
  const shows = action === "show" || (action != null && !KNOWN_ACTIONS.has(action));
1064
+ const periodUsage = "Usage: gloom portfolio show <name> --from <date> [--to <date>]";
1065
+ if ((hasFrom || hasTo) && !shows) ctx.fail(`${hasFrom ? "--from" : "--to"} is an option of portfolio show, not portfolio ${action ?? "list"}.`, periodUsage);
1066
+ let period: PriceWindow | undefined;
1067
+ try {
1068
+ period = readPriceWindow(fromText, toText) ?? undefined;
1069
+ } catch (error) {
1070
+ ctx.fail(error instanceof Error ? error.message : String(error), periodUsage);
1071
+ }
1072
+ if (period && (close || dripFlag)) ctx.fail(`--from measures P&L between two closes; it does not take ${close ? "--close" : "--drip"}.`, periodUsage);
1031
1073
  if (explain && !shows) {
1032
1074
  ctx.fail(
1033
1075
  `--explain is an option of portfolio show, not portfolio ${action ?? "list"}.`,
@@ -1078,8 +1120,8 @@ export const portfolioCliCommand: CliCommandDef = {
1078
1120
 
1079
1121
  if (action === "show") {
1080
1122
  const name = args.slice(1).join(" ");
1081
- if (!name) ctx.fail("Usage: gloom portfolio show <name> [--close] [--explain] [--drip]");
1082
- await showCollection(name, ctx, { explain, basis, drip });
1123
+ if (!name) ctx.fail("Usage: gloom portfolio show <name> [--close] [--explain] [--drip] [--from <date> [--to <date>]]");
1124
+ await showCollection(name, ctx, { explain, basis, drip, ...(period ? { period } : {}) });
1083
1125
  return;
1084
1126
  }
1085
1127
 
@@ -1147,6 +1189,6 @@ export const portfolioCliCommand: CliCommandDef = {
1147
1189
  ctx.fail(TARGET_USAGE);
1148
1190
  }
1149
1191
 
1150
- await showCollection(args.join(" "), ctx, { explain, basis, drip });
1192
+ await showCollection(args.join(" "), ctx, { explain, basis, drip, ...(period ? { period } : {}) });
1151
1193
  },
1152
1194
  };
@@ -15,7 +15,7 @@ import {
15
15
  import { formatCompact, formatPercentRaw } from "../../../../utils/format";
16
16
  import { currencyPriceMinDigits, formatMarketCostWithCurrency, formatMarketPrice, formatMarketPriceWithCurrency, formatMarketQuantity, quoteFormatOptions } from "../../../../market-data/market/format";
17
17
  import { resolvePriceBasis } from "../../../../market-data/market/price-basis";
18
- import { combinedChangeBasisLabel, quoteChangeBasis, type QuoteChangeBasis } from "../../../../market-data/market/change-basis";
18
+ import { combinedChangeBasisLabel, futuresQuoteFromSettle, quoteChangeBasis, type QuoteChangeBasis } from "../../../../market-data/market/change-basis";
19
19
  import { getPortfolioPositionMetrics, lotCostAtTodaysRate, lotCostFxRate, resolvePortfolioMarketValue, resolvePortfolioPositionPnl } from "../../../../portfolio/position-metrics";
20
20
  import {
21
21
  getPortfolioValuationDisplay,
@@ -60,7 +60,7 @@ import { resolveTickerInstrumentKind } from "../../../../tickers/instrument-kind
60
60
  import { perpetualListing } from "../../../../tickers/perpetual-listing";
61
61
  import { loadPerpetualMarket } from "../../../../sources/gloomberb-cloud/perpetuals";
62
62
  import { listedMarketCapitalization, selectMarketCapitalization } from "../../../../utils/market-capitalization";
63
- import { chunked, mapWithConcurrency } from "../../../../utils/concurrency";
63
+ import { chunked, LIST_FINANCIALS_CONCURRENCY, mapWithConcurrency } from "../../../../utils/concurrency";
64
64
  import { liveMarketCapitalization } from "../../../../market-data/quotes/live-valuation";
65
65
  import { delistingLabel } from "../../../../market-data/quotes/delisting";
66
66
  import { instrumentFromTicker } from "../../../../market-data/request-types";
@@ -90,6 +90,8 @@ import { importedFromText } from "../imported-from";
90
90
  import { findNamedCollection } from "../../../../portfolio/collection-name";
91
91
  import { isoDateToday } from "../../../../utils/calendar-date";
92
92
  import { lastTradeDate } from "../../../../tickers/listing-fate";
93
+ import type { PriceWindow } from "../../../../utils/price-window";
94
+ import { showPeriodPnl } from "./period-report";
93
95
  import { DIVIDEND_READ_DEADLINE_MS, incomeGapNote, loadHoldingDividends, portfolioIncome, projectDrip, showsIncomeColumns, type DripYear, type HoldingDividend } from "../income";
94
96
 
95
97
  /** Money prices pad to the currency's minor unit ($337.90, not $337.9), as the ticker view does. */
@@ -209,6 +211,8 @@ export interface ShowCollectionOptions {
209
211
  futuresSources?: PortfolioFuturesSources;
210
212
  /** Where the FX closes of the lots' purchase dates are read; Gloom Cloud by default. */
211
213
  costFxHistory?: CostFxHistoryClient;
214
+ /** `--from`/`--to`: P&L and contribution by position between two closes, in place of the valuation. */
215
+ period?: PriceWindow;
212
216
  }
213
217
 
214
218
  export async function showCollection(name: string, ctx: CliCommandContext, options: ShowCollectionOptions = {}) {
@@ -424,8 +428,9 @@ export async function valuePortfolioPositions({
424
428
  const known = (value: number | null | undefined): number | null => value != null && Number.isFinite(value) ? value : null;
425
429
 
426
430
  for (const ticker of purchaseDateFx ? withPurchaseDateCostFx(tickers, purchaseDateFx, currency, id) : tickers) {
427
- const quote = quotes.get(ticker.metadata.ticker);
428
431
  const futuresTerms = isFuturesTicker(ticker) ? futures?.get(ticker.metadata.ticker) ?? { size: null, settlement: null } : null;
432
+ // A future's move as FUT and `quote` measure it with its terms.
433
+ const quote = futuresQuoteFromSettle(quotes.get(ticker.metadata.ticker), futuresTerms);
429
434
  // A lot entered without its contract size takes the one the terms state; the entries keep the saved record.
430
435
  const sized = withFuturesContractSize(ticker, futuresTerms?.size);
431
436
  const positions = sized.metadata.positions.filter((position) => position.portfolio === id && position.shares !== 0);
@@ -752,7 +757,7 @@ async function showCollectionWithMarketData(
752
757
  name: string,
753
758
  ctx: CliCommandContext,
754
759
  { config, store, dataProvider, persistence }: MarketContext,
755
- { explain = false, basis = "latest-print", drip, dividendDeadlineMs = DIVIDEND_READ_DEADLINE_MS, futuresSources, costFxHistory = apiClient }: ShowCollectionOptions,
760
+ { explain = false, basis = "latest-print", drip, dividendDeadlineMs = DIVIDEND_READ_DEADLINE_MS, futuresSources, costFxHistory = apiClient, period }: ShowCollectionOptions,
756
761
  ) {
757
762
  const tickers = (await store.loadAllTickers()).sort((left, right) =>
758
763
  left.metadata.ticker.localeCompare(right.metadata.ticker)
@@ -773,6 +778,9 @@ async function showCollectionWithMarketData(
773
778
  if (!matchedPortfolio && drip) {
774
779
  ctx.fail(`--drip projects a portfolio's dividends; "${collection.name}" is a watchlist.`, "Usage: gloom portfolio show <portfolio> --drip");
775
780
  }
781
+ if (!matchedPortfolio && period) {
782
+ ctx.fail(`--from measures a portfolio's P&L; "${collection.name}" is a watchlist.`, "Usage: gloom portfolio show <portfolio> --from <date> [--to <date>]");
783
+ }
776
784
  const isPortfolio = !!matchedPortfolio;
777
785
  const id = collection.id;
778
786
  const displayName = collection.name;
@@ -809,6 +817,11 @@ async function showCollectionWithMarketData(
809
817
  const broker = !!(matchedPortfolio?.brokerId || matchedPortfolio?.brokerInstanceId);
810
818
  const source = !isPortfolio ? "Local watchlist and Gloom Cloud"
811
819
  : broker ? "Your broker account and Gloom Cloud" : "Local portfolio and Gloom Cloud";
820
+ if (matchedPortfolio && period) {
821
+ await showPeriodPnl({ ctx, portfolio: matchedPortfolio, name: displayName, tickers: filtered, currency, window: period, provider: dataProvider,
822
+ fxHistory: costFxHistory, quotes, futures: futures ?? new Map(), source, listingLabel, explain });
823
+ return;
824
+ }
812
825
  let freshness = isPortfolio ? undefined : quotesFreshness(quotes.values(), { source });
813
826
  // A watchlist's stale rows, named under the closing line that counts them.
814
827
  let staleNote: string | null = null;
@@ -1302,8 +1315,6 @@ interface WatchlistRowValue {
1302
1315
 
1303
1316
  /** Financials requested at once, the most the app asks for at a time. */
1304
1317
  const FINANCIALS_BATCH_SIZE = 64;
1305
- /** Financials asked for one at a time, at most this many at once, from a source without batches. */
1306
- const FINANCIALS_CONCURRENCY = 8;
1307
1318
 
1308
1319
  /**
1309
1320
  * The financials of the listings whose quote carries no market cap, through
@@ -1329,7 +1340,7 @@ async function loadMarketCapFinancials(
1329
1340
  }));
1330
1341
  return financials;
1331
1342
  }
1332
- await mapWithConcurrency(targets, FINANCIALS_CONCURRENCY, async (target) => {
1343
+ await mapWithConcurrency(targets, LIST_FINANCIALS_CONCURRENCY, async (target) => {
1333
1344
  const value = await dataProvider.getTickerFinancials(target.symbol, target.exchange).catch(logFailure("portfolio-list.cli.render", "Load market cap financials failed", null));
1334
1345
  if (value) financials.set(target.symbol, value);
1335
1346
  });
@@ -22,7 +22,7 @@ import {
22
22
  } from "../../../../portfolio/mutations";
23
23
  import { showCollection } from "./render";
24
24
  import { listingFields, misplacedSymbolList, refuseDryRun, takeCollectionName } from "./shared";
25
- import { addOneSymbol, addSymbols, FILE_OPTION, printSymbolRows, progressNotice, removeSymbols, requireSymbolList, retryNotice, shellWord, SYMBOL_LIST_HELP } from "./bulk-symbols";
25
+ import { addOneSymbol, addSymbols, FILE_OPTION, listAddLookups, printSymbolRows, progressNotice, removeSymbols, requireSymbolList, retryNotice, shellWord, SYMBOL_LIST_HELP } from "./bulk-symbols";
26
26
  import { readNameEntries } from "../../../../cli/name-entries";
27
27
  import { CLI_COMMAND_GROUPS } from "../../../../cli/help";
28
28
 
@@ -110,7 +110,9 @@ async function addTickerToWatchlistCommand(
110
110
  async function addToWatchlistCommand(args: string[], file: string | undefined, exchange: string | undefined, ctx: CliCommandContext) {
111
111
  await withCollectionMarketData(ctx, async (market) => {
112
112
  const { watchlist, rest } = requireWatchlistArgs(market.config, args, file, "add", ADD_USAGE, ctx);
113
- const list = await requireSymbolList(ctx, rest, file, ADD_USAGE, (entries) => readNameEntries(entries, market.dataProvider));
113
+ // Reading the names and looking the symbols up share their answers, so nothing is asked twice.
114
+ const lookups = await listAddLookups(market.dataProvider);
115
+ const list = await requireSymbolList(ctx, rest, file, ADD_USAGE, (entries) => readNameEntries(entries, lookups));
114
116
  if (list.single) {
115
117
  await addTickerToWatchlistCommand(watchlist, list.single, list.notes, exchange, ctx, market);
116
118
  return;
@@ -121,7 +123,7 @@ async function addToWatchlistCommand(args: string[], file: string | undefined, e
121
123
  symbols: list.symbols,
122
124
  exchange,
123
125
  store: market.store,
124
- dataProvider: market.dataProvider,
126
+ dataProvider: lookups,
125
127
  onRetry: retryNotice(ctx),
126
128
  onProgress: progressNotice(ctx),
127
129
  retry,
@@ -27,6 +27,7 @@ import { useThrottledMemo } from "./use-throttled-memo";
27
27
  // move on the reorder cadence, so a tick does not reshuffle the layout.
28
28
  const GRID_TILE_THROTTLE_MS = 250;
29
29
 
30
+ const PRICE_COLUMN: ColumnConfig = { id: "price", label: "Last", width: 10, align: "right" };
30
31
  const MARKET_CAP_COLUMN: ColumnConfig = { id: "market_cap", label: "Mkt Cap", width: 10, align: "right" };
31
32
  const MARKET_VALUE_COLUMN: ColumnConfig = { id: "mkt_value", label: "Mkt Value", width: 10, align: "right" };
32
33
  const CHANGE_PCT_COLUMN: ColumnConfig = { id: "change_pct", label: "Change", width: 8, align: "right" };
@@ -61,6 +62,20 @@ function positionAdjustedChangePercent(
61
62
  : null;
62
63
  }
63
64
 
65
+ /**
66
+ * A portfolio's ticker it holds no position in: one followed, as setup adds a
67
+ * holding entered without shares. Its tile reads like a watchlist entry.
68
+ */
69
+ function isFollowedOnly(
70
+ ticker: TickerRecord,
71
+ financials: TickerFinancials | undefined,
72
+ context: ColumnContext,
73
+ isPortfolioTab: boolean,
74
+ ): boolean {
75
+ return isPortfolioTab
76
+ && getPortfolioPositionMetrics(ticker, context.activeTab, quoteCurrency(ticker, financials)).positionCount === 0;
77
+ }
78
+
64
79
  function tileWeight(
65
80
  ticker: TickerRecord,
66
81
  financials: TickerFinancials | undefined,
@@ -75,7 +90,35 @@ function tileWeight(
75
90
  return Math.max(1, Math.abs(weight));
76
91
  }
77
92
 
78
- const TILE_COLUMN_IDS = [MARKET_CAP_COLUMN, MARKET_VALUE_COLUMN, CHANGE_PCT_COLUMN, DAY_PNL_COLUMN, VOLUME_COLUMN, WEIGHT_COLUMN]
93
+ /**
94
+ * Each tile's area: a holding's market value, else what a watchlist sizes by.
95
+ * A followed ticker beside holdings takes the smallest holding's area, since
96
+ * its market cap would bury every position the portfolio values.
97
+ */
98
+ function gridTileWeights(
99
+ tickers: TickerRecord[],
100
+ financialsMap: Map<string, TickerFinancials>,
101
+ context: ColumnContext,
102
+ isPortfolioTab: boolean,
103
+ ): Map<string, number> {
104
+ const weights = new Map<string, number>();
105
+ const followed: string[] = [];
106
+ let smallestHeld = Number.POSITIVE_INFINITY;
107
+ for (const ticker of tickers) {
108
+ const symbol = ticker.metadata.ticker;
109
+ const financials = financialsMap.get(symbol);
110
+ const weight = tileWeight(ticker, financials, context, isPortfolioTab);
111
+ weights.set(symbol, weight);
112
+ if (isFollowedOnly(ticker, financials, context, isPortfolioTab)) followed.push(symbol);
113
+ else smallestHeld = Math.min(smallestHeld, weight);
114
+ }
115
+ if (Number.isFinite(smallestHeld)) {
116
+ for (const symbol of followed) weights.set(symbol, smallestHeld);
117
+ }
118
+ return weights;
119
+ }
120
+
121
+ const TILE_COLUMN_IDS = [PRICE_COLUMN, MARKET_CAP_COLUMN, MARKET_VALUE_COLUMN, CHANGE_PCT_COLUMN, DAY_PNL_COLUMN, VOLUME_COLUMN, WEIGHT_COLUMN]
79
122
  .map((column) => column.id);
80
123
 
81
124
  function tileVersion(
@@ -114,22 +157,26 @@ function buildPortfolioGridItem(
114
157
  layoutWeight: number | undefined,
115
158
  ): MetricTreemapItem<TickerRecord> {
116
159
  const symbol = ticker.metadata.ticker;
117
- const primaryColumn = isPortfolioTab ? MARKET_VALUE_COLUMN : MARKET_CAP_COLUMN;
118
- const primary = getColumnValue(primaryColumn, ticker, financials, context).text;
119
160
  const change = getColumnValue(CHANGE_PCT_COLUMN, ticker, financials, context).text;
120
- const secondary = isPortfolioTab
161
+ // As the watchlist table lists it, by its price and day's move: a position's
162
+ // value, day P&L and weight would be a dash on every line.
163
+ const followed = isFollowedOnly(ticker, financials, context, isPortfolioTab);
164
+ const held = isPortfolioTab && !followed;
165
+ const primaryColumn = followed ? PRICE_COLUMN : isPortfolioTab ? MARKET_VALUE_COLUMN : MARKET_CAP_COLUMN;
166
+ const primary = getColumnValue(primaryColumn, ticker, financials, context).text;
167
+ const secondary = held
121
168
  ? `${getColumnValue(DAY_PNL_COLUMN, ticker, financials, context).text} ${change}`
122
169
  : change;
123
- const tertiary = isPortfolioTab
124
- ? getColumnValue(WEIGHT_COLUMN, ticker, financials, context).text
125
- : getColumnValue(VOLUME_COLUMN, ticker, financials, context).text;
170
+ const tertiary = followed
171
+ ? null
172
+ : getColumnValue(held ? WEIGHT_COLUMN : VOLUME_COLUMN, ticker, financials, context).text;
126
173
 
127
174
  return {
128
175
  id: symbol,
129
176
  // As the table's Ticker column names it: an option reads as its contract, not its OCC code.
130
177
  label: tickerDisplayName(ticker),
131
178
  weight: layoutWeight ?? tileWeight(ticker, financials, context, isPortfolioTab),
132
- colorValue: positionAdjustedChangePercent(ticker, financials, context, isPortfolioTab),
179
+ colorValue: positionAdjustedChangePercent(ticker, financials, context, held),
133
180
  primaryText: primary,
134
181
  secondaryText: secondary,
135
182
  tertiaryText: tertiary,
@@ -171,10 +218,7 @@ export function PortfolioGrid({
171
218
  const recordsKey = sortedTickers.map((ticker) => objectVersion(ticker)).join(",");
172
219
  const structureDeps = [isPortfolioTab, recordsKey, columnContext.activeTab, columnContext.baseCurrency];
173
220
  const layoutWeights = useThrottledMemo(
174
- () => new Map(sortedTickers.map((ticker) => [
175
- ticker.metadata.ticker,
176
- tileWeight(ticker, financialsMap.get(ticker.metadata.ticker), columnContext, isPortfolioTab),
177
- ])),
221
+ () => gridTileWeights(sortedTickers, financialsMap, columnContext, isPortfolioTab),
178
222
  [financialsMap, columnContext],
179
223
  structureDeps,
180
224
  PORTFOLIO_REORDER_THROTTLE_MS,