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.
- package/README.md +16 -26
- package/README.zh-CN.md +21 -65
- package/package.json +1 -1
- package/patches/electrobun-devkit@2.0.5.patch +268 -8
- package/src/account/auth-model.ts +20 -1
- package/src/account/upgrade-dialog.tsx +8 -4
- package/src/api-client/askg.ts +7 -1
- package/src/api-client/auth.ts +27 -0
- package/src/api-client/catalysts.ts +2 -0
- package/src/api-client/company-kpis.ts +2 -1
- package/src/api-client/cot.ts +14 -2
- package/src/api-client/crypto-markets.ts +20 -2
- package/src/api-client/data.ts +3 -2
- package/src/api-client/earnings.ts +46 -3
- package/src/api-client/fund-facts.ts +23 -1
- package/src/api-client/futures-curve.ts +17 -0
- package/src/api-client/index.ts +4 -1
- package/src/api-client/one-tap-reasons.ts +42 -0
- package/src/api-client/perps.ts +2 -1
- package/src/api-client/request.ts +3 -1
- package/src/api-client/research-activity.ts +16 -3
- package/src/api-client/types/filings-and-calls.ts +9 -0
- package/src/api-client/types/search.ts +3 -0
- package/src/app/keybindings/chord.ts +153 -9
- package/src/app/keybindings/index.ts +1 -1
- package/src/app/keybindings/labels.ts +49 -6
- package/src/app/runtime/desktop-deeplink.ts +73 -8
- package/src/app/runtime/plugin-seed.ts +119 -0
- package/src/app/runtime/startup.ts +45 -9
- package/src/app.tsx +8 -1
- package/src/architecture/core-builtin-allowlist.json +1 -2
- package/src/architecture/pane-tabs-allowlist.json +2 -1
- package/src/architecture/shortcut-labels-allowlist.json +11 -0
- package/src/architecture/ui-literals-allowlist.json +8 -8
- package/src/brokers/broker-portfolio-sync.ts +1 -1
- package/src/cli/bank-section.ts +26 -12
- package/src/cli/board-coins.ts +38 -5
- package/src/cli/commands/crypto-hints.ts +8 -1
- package/src/cli/commands/market.ts +294 -100
- package/src/cli/commands/overview.ts +13 -6
- package/src/cli/commands/ticker.ts +73 -21
- package/src/cli/company-name-hint.ts +19 -0
- package/src/cli/desktop-pane-shot-browser.ts +47 -31
- package/src/cli/desktop-pane-shot.ts +15 -0
- package/src/cli/entry.ts +15 -4
- package/src/cli/export-source.ts +7 -1
- package/src/cli/freshness.ts +0 -16
- package/src/cli/fx-pair.ts +64 -12
- package/src/cli/fx-quote-rate.ts +144 -0
- package/src/cli/glossary.ts +30 -0
- package/src/cli/helpers.ts +4 -2
- package/src/cli/history-back-adjust.ts +122 -0
- package/src/cli/history-rows.ts +114 -10
- package/src/cli/index.ts +4 -1
- package/src/cli/known-gaps.ts +45 -3
- package/src/cli/listing-arg.ts +48 -4
- package/src/cli/name-entries.ts +25 -5
- package/src/cli/not-a-ticker.ts +26 -1
- package/src/cli/pane-functions/catalog.ts +12 -2
- package/src/cli/pane-functions/dom.ts +4 -2
- package/src/cli/pane-functions/freshness.ts +45 -29
- package/src/cli/pane-functions/headless.ts +8 -5
- package/src/cli/pane-functions/index.ts +3 -0
- package/src/cli/pane-functions/market-session.ts +14 -5
- package/src/cli/pane-functions/resolver.ts +4 -1
- package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
- package/src/cli/pane-functions/screenshot-payload.ts +130 -66
- package/src/cli/pane-functions/screenshot-render.ts +14 -2
- package/src/cli/pane-functions/screenshot-types.ts +4 -0
- package/src/cli/restore-plugins.ts +164 -51
- package/src/cli/symbol-rows.ts +22 -2
- package/src/cli/ticker-resolution.ts +74 -17
- package/src/components/chart/composite/axis-overlays.tsx +13 -3
- package/src/components/chart/composite/composite-chart.tsx +8 -1
- package/src/components/chart/composite/format.ts +16 -1
- package/src/components/chart/composite/legend.tsx +4 -3
- package/src/components/chart/composite/panel-labels.ts +2 -1
- package/src/components/chart/composite/panel-surface.tsx +33 -4
- package/src/components/chart/composite/time-scale.ts +1 -1
- package/src/components/chart/composite/toolbar.tsx +8 -4
- package/src/components/chart/composite/types.ts +17 -1
- package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
- package/src/components/chart/composite/use-composite-viewport.ts +31 -8
- package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
- package/src/components/chart-table/axis.ts +11 -0
- package/src/components/chart-table/header.tsx +10 -1
- package/src/components/chart-table/layout.ts +14 -5
- package/src/components/command-bar/assist/inventory.ts +3 -2
- package/src/components/command-bar/commands/collection-list.ts +3 -2
- package/src/components/command-bar/panel/index.tsx +13 -0
- package/src/components/command-bar/panel/layout.ts +15 -1
- package/src/components/command-bar/panel/prompt-width.ts +34 -0
- package/src/components/command-bar/panel/runtime.ts +1 -0
- package/src/components/command-bar/panel/state.ts +4 -0
- package/src/components/command-bar/panel/types.ts +2 -0
- package/src/components/command-bar/routes/root/search-providers.ts +3 -2
- package/src/components/command-bar/routes/root/search-report.ts +2 -2
- package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
- package/src/components/company-logo.tsx +2 -2
- package/src/components/data-table/view.tsx +11 -2
- package/src/components/feed-data-table/stack-view.tsx +20 -6
- package/src/components/feedback-dialog.tsx +3 -1
- package/src/components/form-modal/field-row.tsx +1 -1
- package/src/components/form-modal/routes.ts +1 -0
- package/src/components/index.ts +1 -1
- package/src/components/layout/header.tsx +12 -3
- package/src/components/layout/market-summary.ts +2 -1
- package/src/components/layout/pane/footer/index.tsx +9 -5
- package/src/components/layout/pane/footer/model.ts +26 -10
- package/src/components/layout/pane/footer/registration.tsx +60 -1
- package/src/components/layout/pane/header-tabs.tsx +17 -3
- package/src/components/layout/pane/header.tsx +5 -2
- package/src/components/layout/pane/pane-tabs.tsx +57 -3
- package/src/components/layout/shell/active-drag.ts +38 -30
- package/src/components/layout/shell/drag/index.ts +51 -21
- package/src/components/layout/shell/menu.ts +3 -5
- package/src/components/layout/shell/pane/actions.ts +4 -1
- package/src/components/layout/shell/pane/ask.ts +5 -2
- package/src/components/layout/status-bar.tsx +59 -54
- package/src/components/markdown-text.tsx +35 -10
- package/src/components/onboarding/first-run-workspace.ts +25 -23
- package/src/components/onboarding/onboarding-keyboard.ts +6 -1
- package/src/components/onboarding/onboarding-wizard.tsx +12 -2
- package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -3
- package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
- package/src/components/onboarding/use-onboarding-progress.ts +11 -4
- package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
- package/src/components/onboarding/wizard-positions.ts +8 -1
- package/src/components/pane-notice-seen.ts +125 -0
- package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
- package/src/components/pane-settings-dialog.tsx +7 -6
- package/src/components/sign-in-code-panel.tsx +3 -2
- package/src/components/speedometer-gauge/terminal.tsx +30 -9
- package/src/components/ticker/list-table-view.tsx +39 -3
- package/src/components/ui/confirm-dialog.tsx +2 -1
- package/src/components/ui/data-table/index.tsx +4 -2
- package/src/components/ui/data-table/opentui/index.tsx +15 -5
- package/src/components/ui/data-table/types.ts +8 -0
- package/src/components/ui/external-link.tsx +4 -1
- package/src/components/ui/field-grid.tsx +1 -1
- package/src/components/ui/index.ts +2 -0
- package/src/components/ui/inline-quick-add.tsx +5 -0
- package/src/components/ui/multi-select/dialog.tsx +10 -9
- package/src/components/ui/pane-link-chip.tsx +354 -0
- package/src/components/ui/query-bar.tsx +22 -13
- package/src/components/ui/ratio-bar.tsx +24 -1
- package/src/components/ui/select-button.tsx +2 -1
- package/src/components/ui/shortcut-hint.tsx +6 -3
- package/src/components/ui/table-layout.ts +81 -0
- package/src/components/ui/tabs.tsx +45 -6
- package/src/components/use-pane-notice-footer.tsx +12 -4
- package/src/core/app-service-ports.ts +1 -1
- package/src/data/plugin-state-store.ts +44 -8
- package/src/docs/snapshot.json +53 -32
- package/src/i18n/es.ts +28 -6
- package/src/i18n/ja.ts +28 -5
- package/src/i18n/ko.ts +28 -5
- package/src/i18n/zh-cn.ts +28 -5
- package/src/i18n/zh-tw.ts +28 -5
- package/src/layout/pane-manager/gridlock-inference.ts +2 -1
- package/src/layout/pane-manager/gridlock.ts +47 -2
- package/src/layout-marketplace/api.ts +1 -0
- package/src/layout-marketplace/gallery.tsx +4 -3
- package/src/layout-marketplace/linked.ts +6 -4
- package/src/layout-marketplace/model.ts +3 -2
- package/src/market-data/fund-facts.ts +7 -1
- package/src/market-data/futures-contract.ts +77 -31
- package/src/market-data/fx-closes.ts +5 -2
- package/src/market-data/hooks.tsx +23 -0
- package/src/market-data/market/change-basis.ts +92 -14
- package/src/market-data/market/format.ts +81 -13
- package/src/market-data/market/futures-week.ts +3 -1
- package/src/market-data/market/globex-day.ts +73 -0
- package/src/market-data/market/index-level.ts +10 -1
- package/src/market-data/quotes/intraday-bar.ts +1 -1
- package/src/market-data/quotes/session-split.ts +28 -0
- package/src/plugins/builtin/account-management/pane.tsx +1 -1
- package/src/plugins/builtin/analytics/account-returns.ts +1 -1
- package/src/plugins/builtin/analytics/index.tsx +10 -3
- package/src/plugins/builtin/analytics/pane-model.ts +1 -1
- package/src/plugins/builtin/analytics/risk-client.ts +4 -1
- package/src/plugins/builtin/analytics/risk-episodes.ts +422 -0
- package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
- package/src/plugins/builtin/analytics/risk-headless.ts +28 -10
- package/src/plugins/builtin/analytics/risk-math.ts +1 -1
- package/src/plugins/builtin/analytics/risk-model.ts +115 -26
- package/src/plugins/builtin/analytics/risk-pane.tsx +201 -23
- package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
- package/src/plugins/builtin/backtest/format.ts +14 -0
- package/src/plugins/builtin/backtest/pane.tsx +3 -3
- package/src/plugins/builtin/backtest/report.ts +5 -3
- package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
- package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
- package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
- package/src/plugins/builtin/buildout/company/model.ts +14 -2
- package/src/plugins/builtin/catalysts/detail.tsx +2 -2
- package/src/plugins/builtin/catalysts/model.ts +7 -2
- package/src/plugins/builtin/catalysts/pane.tsx +2 -2
- package/src/plugins/builtin/chart-composer/headless.ts +57 -17
- package/src/plugins/builtin/chart-composer/session-range.ts +82 -3
- package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
- package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
- package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
- package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
- package/src/plugins/builtin/cloud/askg/host.ts +57 -0
- package/src/plugins/builtin/cloud/askg/model.ts +45 -5
- package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
- package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
- package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
- package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
- package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
- package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
- package/src/plugins/builtin/cloud/plugin.tsx +7 -1
- package/src/plugins/builtin/company-kpis/client.ts +4 -3
- package/src/plugins/builtin/company-kpis/model.ts +34 -3
- package/src/plugins/builtin/correlation/compute.ts +8 -2
- package/src/plugins/builtin/correlation/headless.ts +10 -9
- package/src/plugins/builtin/correlation/history.ts +30 -0
- package/src/plugins/builtin/correlation/index.tsx +39 -167
- package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
- package/src/plugins/builtin/correlation/matrix/model.ts +10 -10
- package/src/plugins/builtin/correlation/relationship/model.ts +3 -6
- package/src/plugins/builtin/correlation/relationship/pane.tsx +7 -9
- package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
- package/src/plugins/builtin/cot/client.ts +8 -3
- package/src/plugins/builtin/cot/headless.ts +65 -12
- package/src/plugins/builtin/cot/pane.tsx +11 -5
- package/src/plugins/builtin/crypto-board/client.ts +6 -1
- package/src/plugins/builtin/crypto-board/defi-view.tsx +12 -1
- package/src/plugins/builtin/crypto-board/defi.ts +44 -7
- package/src/plugins/builtin/crypto-board/headless.ts +83 -12
- package/src/plugins/builtin/crypto-board/model.ts +30 -6
- package/src/plugins/builtin/crypto-board/pane.tsx +13 -2
- package/src/plugins/builtin/earnings/client.ts +40 -6
- package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
- package/src/plugins/builtin/earnings/headless.ts +47 -11
- package/src/plugins/builtin/earnings/history-model.ts +136 -24
- package/src/plugins/builtin/earnings/history-table.ts +42 -10
- package/src/plugins/builtin/earnings/history.tsx +23 -8
- package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
- package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
- package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
- package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
- package/src/plugins/builtin/econ/index.tsx +5 -4
- package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
- package/src/plugins/builtin/equity-screener/headless.ts +2 -1
- package/src/plugins/builtin/filing-events/feed.ts +56 -18
- package/src/plugins/builtin/filing-events/pane.tsx +8 -2
- package/src/plugins/builtin/futures/index.tsx +32 -10
- package/src/plugins/builtin/futures/model.ts +93 -6
- package/src/plugins/builtin/futures/returns.ts +29 -7
- package/src/plugins/builtin/futures/table.tsx +59 -17
- package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
- package/src/plugins/builtin/futures-curve/client.ts +12 -2
- package/src/plugins/builtin/futures-curve/headless.ts +58 -17
- package/src/plugins/builtin/futures-curve/model.ts +111 -15
- package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
- package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
- package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
- package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
- package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
- package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
- package/src/plugins/builtin/help/index.tsx +68 -61
- package/src/plugins/builtin/holders/format.ts +7 -2
- package/src/plugins/builtin/holders/pane.tsx +11 -3
- package/src/plugins/builtin/holders/report-header.ts +5 -4
- package/src/plugins/builtin/holders/report-rows.ts +4 -1
- package/src/plugins/builtin/holders/treemap.tsx +5 -3
- package/src/plugins/builtin/insider/signals-model.ts +4 -5
- package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
- package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
- package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
- package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
- package/src/plugins/builtin/kelly-sizer/headless.ts +4 -0
- package/src/plugins/builtin/perps/headless.ts +81 -19
- package/src/plugins/builtin/perps/index.tsx +3 -1
- package/src/plugins/builtin/perps/model.ts +1 -1
- package/src/plugins/builtin/perps/pane.tsx +2 -0
- package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
- package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +20 -1
- package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
- package/src/plugins/builtin/portfolio-list/cli/period-report.ts +154 -0
- package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +64 -22
- package/src/plugins/builtin/portfolio-list/cli/render.ts +18 -7
- package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
- package/src/plugins/builtin/portfolio-list/grid.tsx +56 -12
- package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
- package/src/plugins/builtin/portfolio-list/pane/index.tsx +42 -4
- package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
- package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
- package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
- package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
- package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
- package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
- package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
- package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +118 -4
- package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
- package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
- package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
- package/src/plugins/builtin/portfolio-list/table.tsx +105 -6
- package/src/plugins/builtin/power/headless.ts +47 -9
- package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
- package/src/plugins/builtin/research-search/article.ts +12 -2
- package/src/plugins/builtin/research-search/data.ts +5 -2
- package/src/plugins/builtin/research-search/document-view.tsx +1 -1
- package/src/plugins/builtin/research-search/model.ts +47 -3
- package/src/plugins/builtin/research-search/pane.tsx +3 -2
- package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
- package/src/plugins/builtin/risk-factors/headless.ts +3 -2
- package/src/plugins/builtin/risk-factors/index.tsx +2 -28
- package/src/plugins/builtin/risk-factors/lock-note.ts +58 -0
- package/src/plugins/builtin/risk-factors/pane.tsx +14 -5
- package/src/plugins/builtin/scanner/flow-model.ts +17 -13
- package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
- package/src/plugins/builtin/scanner/flow-session.ts +2 -9
- package/src/plugins/builtin/scanner/hilo-model.ts +4 -3
- package/src/plugins/builtin/sec/filing-display.tsx +0 -5
- package/src/plugins/builtin/sec/forms.ts +19 -0
- package/src/plugins/builtin/sec/fund-facts.ts +45 -11
- package/src/plugins/builtin/sec/headless.ts +37 -12
- package/src/plugins/builtin/sec/index.tsx +37 -8
- package/src/plugins/builtin/shared/earnings-calendar.ts +6 -3
- package/src/plugins/builtin/shared/earnings-report.ts +1 -1
- package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
- package/src/plugins/builtin/shared/pro-lock-note.ts +5 -1
- package/src/plugins/builtin/shared/use-quote-board.ts +42 -27
- package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
- package/src/plugins/builtin/supply-chain/headless.ts +20 -10
- package/src/plugins/builtin/supply-chain/model.ts +117 -20
- package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
- package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
- package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
- package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
- package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
- package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
- package/src/plugins/builtin/ticker-detail/headless-schema.ts +10 -1
- package/src/plugins/builtin/ticker-detail/headless.ts +8 -1
- package/src/plugins/builtin/ticker-detail/overview/components.tsx +2 -1
- package/src/plugins/builtin/ticker-detail/overview/model.ts +18 -8
- package/src/plugins/builtin/ticker-detail/overview-tab.tsx +11 -8
- package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
- package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
- package/src/plugins/builtin/ticker-detail/settings.ts +4 -3
- package/src/plugins/builtin/time-sales/headless.ts +23 -7
- package/src/plugins/builtin/time-sales/index.tsx +2 -2
- package/src/plugins/builtin/volatility/charts.tsx +2 -2
- package/src/plugins/extracted-plugins.ts +49 -24
- package/src/plugins/host-resolver.ts +3 -2
- package/src/plugins/installer.ts +220 -31
- package/src/plugins/running-installs.ts +34 -0
- package/src/plugins/seed-progress.ts +72 -0
- package/src/portfolio/column-values.ts +42 -8
- package/src/portfolio/futures-positions.ts +10 -2
- package/src/portfolio/mutations.ts +4 -3
- package/src/portfolio/period-pnl.ts +119 -0
- package/src/portfolio/positions-import/describe.ts +89 -0
- package/src/portfolio/positions-import/parse.ts +682 -0
- package/src/portfolio/positions-import/plan.ts +295 -0
- package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
- package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
- package/src/react/jsx-dev-fallback.ts +62 -0
- package/src/renderers/browser/cloud-transport.ts +1 -1
- package/src/renderers/browser/config-host.ts +3 -1
- package/src/renderers/browser/deeplink-bridge.ts +8 -1
- package/src/renderers/browser/http-proxy-transport.ts +9 -2
- package/src/renderers/browser/main.tsx +2 -1
- package/src/renderers/browser/research-entry.ts +12 -0
- package/src/renderers/cloudflare/http-proxy.ts +8 -2
- package/src/renderers/cloudflare/proxy-session.ts +1 -0
- package/src/renderers/cloudflare/worker.ts +12 -3
- package/src/renderers/dom/desktop/audio-player.tsx +2 -2
- package/src/renderers/dom/desktop/controls.tsx +1 -1
- package/src/renderers/dom/desktop/dialog-actions.tsx +10 -24
- package/src/renderers/dom/desktop/icons.tsx +4 -2
- package/src/renderers/dom/desktop/query-bar.tsx +23 -19
- package/src/renderers/dom/dom-host-providers.tsx +7 -2
- package/src/renderers/dom/host/box.tsx +2 -2
- package/src/renderers/dom/host/input.tsx +13 -0
- package/src/renderers/dom/key-event.ts +1 -0
- package/src/renderers/dom/styles.css +3 -0
- package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
- package/src/renderers/electrobun/bun/desktop/backend.ts +15 -0
- package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
- package/src/renderers/electrobun/bun/desktop/host-requests.ts +19 -11
- package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
- package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
- package/src/renderers/electrobun/bun/desktop/initialization.ts +27 -15
- package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
- package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
- package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
- package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
- package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
- package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
- package/src/renderers/electrobun/bun/index.ts +5 -0
- package/src/renderers/electrobun/bun/window/attention.ts +1 -0
- package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
- package/src/renderers/electrobun/bun/window/context-menu-thread.ts +84 -0
- package/src/renderers/electrobun/bun/window/create.ts +1 -0
- package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
- package/src/renderers/electrobun/bun/window/native-call-thread.ts +224 -0
- package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
- package/src/renderers/electrobun/bun/window/native-timing.ts +10 -0
- package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
- package/src/renderers/electrobun/bun/window/script-for-webview.ts +15 -0
- package/src/renderers/electrobun/bun/window/webview-script-thread.ts +82 -0
- package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
- package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
- package/src/renderers/electrobun/shared/protocol.ts +13 -2
- package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
- package/src/renderers/electrobun/view/backend-rpc.ts +7 -0
- package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
- package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
- package/src/renderers/electrobun/view/cli-pane-shot-frame.tsx +1 -1
- package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
- package/src/renderers/electrobun/view/http-fetch.ts +2 -1
- package/src/renderers/electrobun/view/main.tsx +13 -7
- package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
- package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
- package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
- package/src/renderers/electrobun/view/ui-host.tsx +3 -2
- package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
- package/src/renderers/opentui/browser-open.ts +2 -1
- package/src/renderers/opentui/dialog-host.tsx +1 -1
- package/src/renderers/opentui/interaction-performance.ts +3 -1
- package/src/renderers/opentui/start.tsx +5 -1
- package/src/renderers/opentui/terminal-media.ts +11 -6
- package/src/renderers/opentui/ui-host.tsx +5 -8
- package/src/shares/open.ts +22 -1
- package/src/shares/pane.ts +2 -1
- package/src/sources/gloomberb-cloud/normalizers.ts +3 -0
- package/src/sync/analytics-payload.ts +194 -0
- package/src/sync/baseline.ts +19 -9
- package/src/sync/broker-identity.ts +171 -0
- package/src/sync/broker-instances.ts +137 -0
- package/src/sync/collections-contributor.ts +173 -0
- package/src/sync/config-contributor.ts +100 -0
- package/src/sync/config-merge.ts +229 -0
- package/src/sync/controller.ts +139 -28
- package/src/sync/core-contributors.ts +8 -1583
- package/src/sync/history-memo.ts +32 -0
- package/src/sync/layout-merge.ts +259 -0
- package/src/sync/sanitize.ts +114 -0
- package/src/sync/ticker-merge.ts +208 -0
- package/src/sync/ticker-payload.ts +81 -0
- package/src/sync/types.ts +15 -1
- package/src/telemetry/attention-setting.ts +1 -1
- package/src/telemetry/stall-reports.ts +21 -4
- package/src/telemetry/usage-counts.ts +16 -0
- package/src/test-support/preload.ts +5 -0
- package/src/theme/color-utils.ts +10 -0
- package/src/theme/font-scale.ts +34 -3
- package/src/theme/series-colors.ts +44 -0
- package/src/theme/themes.ts +2 -1
- package/src/tickers/batched-lookups.ts +263 -6
- package/src/tickers/company-name-listing.ts +44 -2
- package/src/tickers/company-name.ts +7 -2
- package/src/tickers/search/upsert.ts +16 -1
- package/src/time-series/base-series.ts +18 -4
- package/src/time-series/studies/indicators.ts +3 -1
- package/src/time-series/studies/resolve.ts +1 -1
- package/src/time-series/types.ts +6 -0
- package/src/types/financials.ts +18 -0
- package/src/types/headless.ts +11 -0
- package/src/ui/host.tsx +26 -3
- package/src/ui/index.tsx +1 -0
- package/src/utils/concurrency.ts +6 -0
- package/src/utils/currency-pair.ts +56 -4
- package/src/utils/datetime-format.ts +11 -0
- package/src/utils/decimal-comma.ts +9 -6
- package/src/utils/exchanges.ts +32 -0
- package/src/utils/fundamentals.ts +41 -0
- package/src/utils/main-thread-stall.ts +21 -5
- package/src/utils/markdown.ts +4 -2
- package/src/utils/pasted-lines.ts +14 -0
- package/src/utils/perf-marks.ts +88 -9
- package/src/utils/price-window.ts +2 -1
- package/src/utils/reported-money.ts +9 -2
- package/src/utils/sec-filings.ts +17 -0
- package/src/utils/sec.ts +37 -25
- package/src/utils/shortcut-labels.ts +6 -30
- 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
|
-
|
|
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:
|
|
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
|
-
|
|
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: "--
|
|
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
|
-
|
|
1018
|
-
|
|
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,
|
|
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
|
-
|
|
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:
|
|
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
|
-
|
|
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
|
-
|
|
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 =
|
|
124
|
-
?
|
|
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,
|
|
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
|
-
() =>
|
|
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,
|