gloomberb 0.20.7 → 0.20.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ja.md +74 -0
- package/README.md +2 -0
- package/README.zh-CN.md +2 -0
- package/package.json +6 -1
- package/src/account/auth-model.ts +22 -0
- package/src/api-client/auth.ts +7 -2
- package/src/api-client/awards.ts +5 -0
- package/src/api-client/bond-trades.ts +22 -0
- package/src/api-client/catalysts.ts +11 -1
- package/src/api-client/data.ts +30 -6
- package/src/api-client/debt-maturities.ts +7 -0
- package/src/api-client/equity-screener.ts +17 -0
- package/src/api-client/errors.ts +2 -0
- package/src/api-client/exchange-announcements.ts +14 -7
- package/src/api-client/fund-facts.ts +21 -3
- package/src/api-client/futures-curve.ts +14 -1
- package/src/api-client/geo.ts +10 -0
- package/src/api-client/hiring.ts +2 -0
- package/src/api-client/index.ts +3 -0
- package/src/api-client/insider-signals.ts +14 -0
- package/src/api-client/members.ts +30 -2
- package/src/api-client/money-markets.ts +11 -1
- package/src/api-client/paths.ts +6 -1
- package/src/api-client/perps.ts +2 -0
- package/src/api-client/request.ts +2 -1
- package/src/api-client/socket.ts +7 -0
- package/src/api-client/types/econ.ts +2 -1
- package/src/api-client/types/filings-and-calls.ts +6 -0
- package/src/api-client/types/market.ts +4 -0
- package/src/api-client/web-experiments.ts +5 -6
- package/src/app/runtime/update.ts +2 -1
- package/src/architecture/floating-promise-allowlist.json +33 -106
- package/src/capabilities/asset-data-inputs.ts +183 -0
- package/src/capabilities/factories.ts +8 -2
- package/src/cli/base-converter.ts +36 -2
- package/src/cli/commands/api.ts +2 -2
- package/src/cli/commands/command-utils.ts +18 -0
- package/src/cli/commands/hong-kong-movers.ts +50 -0
- package/src/cli/commands/market.ts +539 -130
- package/src/cli/commands/options-chain.ts +7 -1
- package/src/cli/commands/overview.ts +74 -14
- package/src/cli/commands/plugins.ts +7 -6
- package/src/cli/commands/search.ts +52 -9
- package/src/cli/commands/system.ts +15 -10
- package/src/cli/commands/ticker.ts +97 -44
- package/src/cli/content-figures.ts +45 -0
- package/src/cli/context.ts +5 -0
- package/src/cli/desktop-pane-shot-routes.ts +13 -4
- package/src/cli/desktop-pane-shot.ts +86 -12
- package/src/cli/earnings-calendar.ts +36 -5
- package/src/cli/export-source.ts +17 -3
- package/src/cli/fx-pair.ts +111 -11
- package/src/cli/glossary.ts +36 -2
- package/src/cli/help.ts +1 -1
- package/src/cli/history-export.ts +29 -11
- package/src/cli/history-rows.ts +130 -21
- package/src/cli/index.ts +8 -5
- package/src/cli/known-gaps.ts +45 -1
- package/src/cli/listing-arg.ts +366 -19
- package/src/cli/pane-functions/capabilities.ts +2 -2
- package/src/cli/pane-functions/catalog.ts +105 -9
- package/src/cli/pane-functions/discovery.ts +2 -0
- package/src/cli/pane-functions/dom.ts +46 -9
- package/src/cli/pane-functions/freshness.ts +7 -3
- package/src/cli/pane-functions/function-help.ts +9 -6
- package/src/cli/pane-functions/headless.ts +77 -6
- package/src/cli/pane-functions/index.ts +141 -23
- package/src/cli/pane-functions/options.ts +1 -3
- package/src/cli/pane-functions/plugin-code.ts +169 -0
- package/src/cli/pane-functions/report.ts +10 -0
- package/src/cli/pane-functions/resolver.ts +69 -21
- package/src/cli/pane-functions/screenshot-assessment.ts +82 -3
- package/src/cli/pane-functions/screenshot-data-evidence.ts +3 -1
- package/src/cli/pane-functions/screenshot-types.ts +6 -0
- package/src/cli/quote-answer.ts +49 -2
- package/src/cli/registry.ts +42 -4
- package/src/cli/report-tables.ts +26 -6
- package/src/cli/result.ts +13 -2
- package/src/cli/series-search.ts +17 -7
- package/src/cli/statement-filings.ts +22 -8
- package/src/cli/symbol-args.ts +9 -0
- package/src/cli/ticker-resolution.ts +3 -2
- package/src/cli/unknown-command.ts +111 -14
- package/src/components/chart/composite/format.ts +15 -1
- package/src/components/chart/composite/legend.tsx +101 -47
- package/src/components/chart/composite/panel-labels.ts +4 -4
- package/src/components/chart/composite/panel-surface.tsx +4 -6
- package/src/components/chart/composite/scene/build.ts +180 -0
- package/src/components/chart/composite/scene/cursor.ts +226 -0
- package/src/components/chart/composite/scene/domain.ts +170 -0
- package/src/components/chart/composite/scene/markers.ts +115 -0
- package/src/components/chart/composite/scene/panels.ts +85 -0
- package/src/components/chart/composite/scene/points.ts +169 -0
- package/src/components/chart/composite/scene/projection.ts +105 -0
- package/src/components/chart/composite/scene/timeline.ts +71 -0
- package/src/components/chart/composite/scene.ts +12 -1066
- package/src/components/chart/composite/types.ts +4 -2
- package/src/components/chart/curve/model.ts +2 -2
- package/src/components/chart-table/axis.ts +18 -6
- package/src/components/command-bar/layout-items/focused-pane.ts +3 -0
- package/src/components/command-bar/list/model.ts +9 -0
- package/src/components/command-bar/pane-templates/items.ts +61 -15
- package/src/components/command-bar/pane-templates/workflow.ts +16 -5
- package/src/components/command-bar/routes/root/plugin-install.ts +7 -46
- package/src/components/command-bar/routes/root/provider-search.ts +8 -5
- package/src/components/command-bar/routes/root/results.ts +6 -1
- package/src/components/command-bar/routes/root/runtime.ts +1 -0
- package/src/components/command-bar/routes/root/shortcut-feedback.ts +4 -1
- package/src/components/command-bar/routes/ticker-search/actions.ts +7 -5
- package/src/components/command-bar/routes/ticker-search/results.ts +51 -3
- package/src/components/command-bar/view-model.ts +12 -0
- package/src/components/command-bar/workflow/ops.ts +21 -4
- package/src/components/command-bar/workflow/ticker-listing-picker.ts +3 -1
- package/src/components/command-bar/workflow/tickers.ts +6 -2
- package/src/components/data-table/view.tsx +46 -1
- package/src/components/form-modal/confirm.tsx +3 -2
- package/src/components/form-modal/content.tsx +3 -2
- package/src/components/form-modal/field-row.tsx +2 -0
- package/src/components/form-modal/host.tsx +18 -3
- package/src/components/form-modal/remote-reads.test-helpers.ts +34 -0
- package/src/components/index.ts +1 -1
- package/src/components/layout/pane/title.ts +21 -5
- package/src/components/layout/shell/pane/layers.tsx +20 -14
- package/src/components/layout/shell/pane-occlusion.ts +21 -0
- package/src/components/onboarding/desks-step.tsx +7 -1
- package/src/components/onboarding/onboarding-keyboard.ts +48 -6
- package/src/components/onboarding/onboarding-wizard.tsx +47 -8
- package/src/components/onboarding/portfolio-step/positions-panel.tsx +17 -3
- package/src/components/onboarding/use-onboarding-progress.ts +57 -14
- package/src/components/onboarding/wizard-positions.ts +2 -0
- package/src/components/paged-rows.ts +11 -5
- package/src/components/ticker/list-table-view.tsx +24 -5
- package/src/components/toggle-list.tsx +44 -1
- package/src/components/ui/data-table/opentui/index.tsx +7 -6
- package/src/components/ui/data-table/opentui/model.ts +7 -3
- package/src/components/ui/data-table/types.ts +13 -2
- package/src/components/ui/fields.tsx +16 -4
- package/src/components/ui/query-bar.tsx +43 -9
- package/src/components/ui/table-layout.ts +56 -2
- package/src/core/app-services.ts +7 -2
- package/src/core/connection-health.ts +26 -0
- package/src/core/state/app/layout.ts +12 -4
- package/src/data/config/layout.ts +3 -1
- package/src/data/config/store/node.ts +4 -2
- package/src/docs/snapshot.json +756 -216
- package/src/i18n/es.ts +4 -1
- package/src/i18n/ja.ts +4 -1
- package/src/i18n/ko.ts +4 -1
- package/src/i18n/zh-cn.ts +4 -1
- package/src/i18n/zh-tw.ts +4 -1
- package/src/layout/pane-follow.ts +1 -1
- package/src/layout/pane-manager/gridlock.ts +18 -5
- package/src/layout/pane-manager/index.ts +1 -0
- package/src/layout/pane-manager/transient.ts +56 -0
- package/src/layout-marketplace/gallery.tsx +2 -1
- package/src/layout-marketplace/model.ts +4 -10
- package/src/market-data/commodity-names.ts +24 -0
- package/src/market-data/connection-follow.ts +9 -7
- package/src/market-data/coordinator/auxiliary.ts +4 -3
- package/src/market-data/coordinator/entries.ts +22 -1
- package/src/market-data/coordinator/financials.ts +2 -3
- package/src/market-data/coordinator/index.ts +67 -12
- package/src/market-data/coordinator/quotes.ts +2 -3
- package/src/market-data/fund-facts.ts +7 -1
- package/src/market-data/futures-board.ts +38 -4
- package/src/market-data/futures-contract.ts +5 -2
- package/src/market-data/fx-closes.ts +4 -1
- package/src/market-data/market/bar-period.ts +15 -0
- package/src/market-data/market/format.ts +4 -2
- package/src/market-data/market/freshness.ts +4 -0
- package/src/market-data/market/status.ts +23 -3
- package/src/market-data/options-alternatives.ts +21 -9
- package/src/market-data/published-futures-sessions.ts +9 -0
- package/src/market-data/quotes/balance-sheet-rate.ts +34 -0
- package/src/market-data/quotes/delisting.ts +26 -2
- package/src/market-data/quotes/freshness.ts +62 -0
- package/src/market-data/quotes/listing-enterprise-value.ts +250 -19
- package/src/market-data/quotes/regular-session-valuation.ts +8 -0
- package/src/market-data/realized-volatility.ts +3 -1
- package/src/market-data/request-types.ts +2 -0
- package/src/market-data/selectors.ts +1 -0
- package/src/news/aggregator.ts +3 -3
- package/src/plugins/builtin/account-management/delete-account.ts +78 -0
- package/src/plugins/builtin/account-management/pane.tsx +22 -19
- package/src/plugins/builtin/account-management/password-dialog.tsx +75 -0
- package/src/plugins/builtin/alerts/alert-log.ts +3 -2
- package/src/plugins/builtin/alerts/cli-forms.ts +1 -1
- package/src/plugins/builtin/alerts/cli.ts +72 -4
- package/src/plugins/builtin/alerts/format.ts +8 -2
- package/src/plugins/builtin/alerts/index.tsx +8 -5
- package/src/plugins/builtin/alerts/pane.tsx +5 -3
- package/src/plugins/builtin/alerts/research-builder.ts +12 -0
- package/src/plugins/builtin/analytics/index.tsx +3 -3
- package/src/plugins/builtin/analytics/risk-client.ts +14 -3
- package/src/plugins/builtin/analytics/risk-pane.tsx +3 -3
- package/src/plugins/builtin/attention/pane.tsx +1 -1
- package/src/plugins/builtin/attention/trending.tsx +1 -1
- package/src/plugins/builtin/awards/detail.tsx +4 -1
- package/src/plugins/builtin/awards/headless.ts +7 -3
- package/src/plugins/builtin/awards/model.ts +11 -0
- package/src/plugins/builtin/awards/pane.tsx +12 -5
- package/src/plugins/builtin/backtest/client.ts +7 -2
- package/src/plugins/builtin/backtest/headless.ts +2 -1
- package/src/plugins/builtin/backtest/pane.tsx +4 -2
- package/src/plugins/builtin/bond-calculator/pane.tsx +1 -1
- package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
- package/src/plugins/builtin/broker-trading/orders.tsx +2 -2
- package/src/plugins/builtin/buildout/company/pane.tsx +1 -1
- package/src/plugins/builtin/buildout/model/index.ts +2 -2
- package/src/plugins/builtin/catalysts/headless.ts +9 -6
- package/src/plugins/builtin/catalysts/model.ts +72 -10
- package/src/plugins/builtin/catalysts/pane.tsx +10 -7
- package/src/plugins/builtin/cds/pane.tsx +5 -3
- package/src/plugins/builtin/central-bank-rates/pane.tsx +3 -2
- package/src/plugins/builtin/chart-composer/catalog-series.ts +59 -0
- package/src/plugins/builtin/chart-composer/headless-schema.ts +2 -1
- package/src/plugins/builtin/chart-composer/headless.ts +104 -23
- package/src/plugins/builtin/chart-composer/index.tsx +6 -3
- package/src/plugins/builtin/chart-composer/legend-names.ts +19 -0
- package/src/plugins/builtin/chart-composer/pane.tsx +37 -10
- package/src/plugins/builtin/chart-composer/presets.ts +63 -6
- package/src/plugins/builtin/chart-composer/roll-events.ts +38 -0
- package/src/plugins/builtin/chart-composer/series-catalog.ts +12 -5
- package/src/plugins/builtin/chart-composer/series-expression.ts +8 -4
- package/src/plugins/builtin/chart-composer/series-listings.ts +33 -9
- package/src/plugins/builtin/chart-composer/use-series-catalog.ts +2 -2
- package/src/plugins/builtin/clinical-trials/client.ts +13 -0
- package/src/plugins/builtin/clinical-trials/index.tsx +1 -1
- package/src/plugins/builtin/clinical-trials/pane.tsx +77 -27
- package/src/plugins/builtin/clinical-trials/search.ts +117 -0
- package/src/plugins/builtin/cloud/askg/conversation-store.ts +17 -6
- package/src/plugins/builtin/cloud/askg/lock-note.ts +4 -2
- package/src/plugins/builtin/cloud/askg/manifest.ts +3 -2
- package/src/plugins/builtin/cloud/askg/pane.tsx +2 -2
- package/src/plugins/builtin/cloud/askg/sources.ts +3 -3
- package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +7 -3
- package/src/plugins/builtin/cloud/team/acm-tab.tsx +1 -1
- package/src/plugins/builtin/cloud/team/pane.tsx +17 -10
- package/src/plugins/builtin/cloud/team/views.ts +15 -3
- package/src/plugins/builtin/cloud/terminal-relay/redact.ts +105 -16
- package/src/plugins/builtin/cloud/thesis/board-pane.tsx +17 -2
- package/src/plugins/builtin/cloud/thesis/module.tsx +3 -2
- package/src/plugins/builtin/cloud/thesis/store.ts +17 -3
- package/src/plugins/builtin/commodities-energy/index.tsx +35 -3
- package/src/plugins/builtin/commodity-balances/index.tsx +1 -1
- package/src/plugins/builtin/company-attention/app-rank.tsx +1 -1
- package/src/plugins/builtin/company-attention/building.tsx +1 -1
- package/src/plugins/builtin/company-attention/model.ts +2 -1
- package/src/plugins/builtin/company-attention/moves.tsx +1 -1
- package/src/plugins/builtin/company-attention/pane.tsx +1 -1
- package/src/plugins/builtin/company-attention/signals.tsx +1 -1
- package/src/plugins/builtin/company-kpis/pane.tsx +1 -1
- package/src/plugins/builtin/correlation/headless.ts +7 -5
- package/src/plugins/builtin/correlation/history.ts +17 -6
- package/src/plugins/builtin/correlation/index.tsx +1 -1
- package/src/plugins/builtin/correlation/relationship/history.ts +1 -1
- package/src/plugins/builtin/correlation/relationship/pane.tsx +1 -1
- package/src/plugins/builtin/cot/headless.ts +10 -3
- package/src/plugins/builtin/cot/pane.tsx +2 -2
- package/src/plugins/builtin/cpi/pane.tsx +1 -1
- package/src/plugins/builtin/credit-boards/model.ts +1 -1
- package/src/plugins/builtin/credit-documents/pane.tsx +1 -1
- package/src/plugins/builtin/crypto-board/defi-view.tsx +2 -2
- package/src/plugins/builtin/crypto-board/defi.ts +9 -3
- package/src/plugins/builtin/crypto-board/headless.ts +19 -10
- package/src/plugins/builtin/crypto-board/model.ts +8 -0
- package/src/plugins/builtin/crypto-board/pane.tsx +11 -5
- package/src/plugins/builtin/crypto-board/series.ts +17 -3
- package/src/plugins/builtin/crypto-board/supply.ts +26 -3
- package/src/plugins/builtin/crypto-etf-flows/headless.ts +3 -2
- package/src/plugins/builtin/crypto-etf-flows/model.ts +13 -3
- package/src/plugins/builtin/crypto-etf-flows/pane.tsx +6 -3
- package/src/plugins/builtin/custom-view/pane.tsx +5 -5
- package/src/plugins/builtin/debt-maturities/client.ts +5 -0
- package/src/plugins/builtin/debt-maturities/headless.ts +3 -1
- package/src/plugins/builtin/debt-maturities/model.ts +1 -0
- package/src/plugins/builtin/debt-maturities/pane.tsx +1 -1
- package/src/plugins/builtin/dividend-yield/pane.tsx +1 -1
- package/src/plugins/builtin/doe/model.ts +1 -1
- package/src/plugins/builtin/doe/pane.tsx +1 -1
- package/src/plugins/builtin/earnings/board.tsx +2 -2
- package/src/plugins/builtin/earnings/history.tsx +1 -1
- package/src/plugins/builtin/earnings-calls/calendar.tsx +1 -1
- package/src/plugins/builtin/earnings-calls/data.ts +2 -1
- package/src/plugins/builtin/earnings-calls/headless.ts +15 -0
- package/src/plugins/builtin/earnings-calls/model.ts +68 -8
- package/src/plugins/builtin/earnings-calls/pane.tsx +29 -8
- package/src/plugins/builtin/earnings-calls/transcript-view.tsx +32 -2
- package/src/plugins/builtin/earnings-ripple/pane.tsx +1 -1
- package/src/plugins/builtin/econ/calendar-model.ts +94 -2
- package/src/plugins/builtin/econ/detail-view.tsx +15 -11
- package/src/plugins/builtin/econ/index.tsx +25 -9
- package/src/plugins/builtin/econ/types.ts +4 -1
- package/src/plugins/builtin/equity-screener/headless.ts +23 -7
- package/src/plugins/builtin/equity-screener/index.tsx +3 -0
- package/src/plugins/builtin/equity-screener/live.ts +39 -12
- package/src/plugins/builtin/equity-screener/model.ts +86 -5
- package/src/plugins/builtin/equity-screener/pane.tsx +20 -21
- package/src/plugins/builtin/equity-screener/results.ts +12 -3
- package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -2
- package/src/plugins/builtin/estimate-revisions/pane.tsx +2 -2
- package/src/plugins/builtin/executives/pane.tsx +2 -2
- package/src/plugins/builtin/exposure/pane.tsx +1 -1
- package/src/plugins/builtin/fear-greed/data.ts +3 -1
- package/src/plugins/builtin/fear-greed/headless.ts +8 -2
- package/src/plugins/builtin/fear-greed/pane.tsx +8 -4
- package/src/plugins/builtin/filing-events/pane.tsx +1 -1
- package/src/plugins/builtin/futures/index.tsx +5 -4
- package/src/plugins/builtin/futures/model.ts +17 -9
- package/src/plugins/builtin/futures/returns.ts +2 -0
- package/src/plugins/builtin/futures/series.ts +44 -8
- package/src/plugins/builtin/futures/table.tsx +3 -3
- package/src/plugins/builtin/futures-curve/client.ts +1 -0
- package/src/plugins/builtin/futures-curve/headless.ts +14 -12
- package/src/plugins/builtin/futures-curve/index.tsx +7 -4
- package/src/plugins/builtin/futures-curve/model.ts +93 -7
- package/src/plugins/builtin/futures-curve/pane.tsx +18 -7
- package/src/plugins/builtin/fx-matrix/amount.ts +2 -1
- package/src/plugins/builtin/fx-matrix/index.tsx +9 -0
- package/src/plugins/builtin/gpu/changes.tsx +1 -1
- package/src/plugins/builtin/gpu/equities.tsx +1 -1
- package/src/plugins/builtin/gpu/pane.tsx +2 -2
- package/src/plugins/builtin/help/function-card.tsx +4 -2
- package/src/plugins/builtin/help/function-index.ts +12 -6
- package/src/plugins/builtin/help/index.tsx +1 -1
- package/src/plugins/builtin/holders/beneficial-view.tsx +1 -1
- package/src/plugins/builtin/holders/pane.tsx +1 -1
- package/src/plugins/builtin/insider/base-values.ts +55 -0
- package/src/plugins/builtin/insider/headless.ts +307 -83
- package/src/plugins/builtin/insider/index.tsx +65 -23
- package/src/plugins/builtin/insider/insiders.tsx +26 -16
- package/src/plugins/builtin/insider/model.ts +2 -2
- package/src/plugins/builtin/insider/signals-cells.tsx +4 -1
- package/src/plugins/builtin/insider/signals-model.ts +13 -5
- package/src/plugins/builtin/insider/signals.tsx +5 -3
- package/src/plugins/builtin/insider/tickers.tsx +466 -0
- package/src/plugins/builtin/ipo-calendar/pane.tsx +1 -1
- package/src/plugins/builtin/iv-history/client.ts +35 -4
- package/src/plugins/builtin/iv-history/headless.ts +10 -4
- package/src/plugins/builtin/iv-history/model.ts +85 -16
- package/src/plugins/builtin/iv-history/pane.tsx +2 -2
- package/src/plugins/builtin/iv-history/screen-pane.tsx +6 -3
- package/src/plugins/builtin/jobs/pane.tsx +5 -5
- package/src/plugins/builtin/macro-day/pane.tsx +1 -1
- package/src/plugins/builtin/macro-day/release-table.ts +5 -5
- package/src/plugins/builtin/macro-day/releases.ts +11 -9
- package/src/plugins/builtin/market-movers/headless.ts +6 -2
- package/src/plugins/builtin/market-movers/screener.ts +18 -4
- package/src/plugins/builtin/members/breadth-pane.tsx +3 -3
- package/src/plugins/builtin/members/client.ts +24 -2
- package/src/plugins/builtin/members/headless.ts +66 -9
- package/src/plugins/builtin/members/index.tsx +7 -6
- package/src/plugins/builtin/members/model.ts +89 -5
- package/src/plugins/builtin/members/pane.tsx +70 -21
- package/src/plugins/builtin/mna/distress/pane.tsx +2 -1
- package/src/plugins/builtin/mna/pane.tsx +1 -1
- package/src/plugins/builtin/money-markets/client.ts +43 -15
- package/src/plugins/builtin/money-markets/headless.ts +18 -11
- package/src/plugins/builtin/money-markets/index.tsx +7 -6
- package/src/plugins/builtin/money-markets/model.ts +20 -5
- package/src/plugins/builtin/money-markets/pane.tsx +28 -17
- package/src/plugins/builtin/news/wire/news/footer.ts +11 -1
- package/src/plugins/builtin/news/wire/news/table.tsx +15 -5
- package/src/plugins/builtin/notes/headless.ts +94 -0
- package/src/plugins/builtin/notes/index.tsx +3 -1
- package/src/plugins/builtin/notes/store.ts +10 -3
- package/src/plugins/builtin/options/footer.ts +8 -2
- package/src/plugins/builtin/options/open-interest-as-of.ts +12 -3
- package/src/plugins/builtin/options/view.tsx +10 -1
- package/src/plugins/builtin/options-calculator/pane.tsx +1 -1
- package/src/plugins/builtin/options-positioning/client.ts +35 -8
- package/src/plugins/builtin/options-positioning/headless.ts +17 -7
- package/src/plugins/builtin/options-positioning/index.tsx +10 -0
- package/src/plugins/builtin/options-positioning/pane.tsx +16 -7
- package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +1 -1
- package/src/plugins/builtin/options-scenario/pane.tsx +1 -1
- package/src/plugins/builtin/pe-band/pane.tsx +2 -2
- package/src/plugins/builtin/perps/cascade-tabs.tsx +2 -2
- package/src/plugins/builtin/perps/client.ts +54 -15
- package/src/plugins/builtin/perps/headless.ts +39 -13
- package/src/plugins/builtin/perps/index.tsx +2 -1
- package/src/plugins/builtin/perps/model.ts +43 -1
- package/src/plugins/builtin/perps/pane.tsx +35 -18
- package/src/plugins/builtin/portfolio-list/allocation-rows.ts +74 -0
- package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
- package/src/plugins/builtin/portfolio-list/cli/period-report.ts +7 -3
- package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +33 -3
- package/src/plugins/builtin/portfolio-list/cli/render.ts +149 -24
- package/src/plugins/builtin/portfolio-list/headless.ts +30 -9
- package/src/plugins/builtin/portfolio-list/income.ts +17 -8
- package/src/plugins/builtin/portfolio-list/index.tsx +4 -4
- package/src/plugins/builtin/portfolio-list/pane/fx-day-moves.ts +52 -0
- package/src/plugins/builtin/portfolio-list/pane/index.tsx +76 -9
- package/src/plugins/builtin/portfolio-list/pane/target-weights.tsx +178 -0
- package/src/plugins/builtin/portfolio-list/period-pnl.ts +44 -5
- package/src/plugins/builtin/portfolio-list/settings.ts +12 -6
- package/src/plugins/builtin/portfolio-list/summary/index.tsx +9 -4
- package/src/plugins/builtin/portfolio-list/summary/totals.ts +21 -2
- package/src/plugins/builtin/portfolio-list/table.tsx +33 -25
- package/src/plugins/builtin/power/gas.tsx +2 -2
- package/src/plugins/builtin/power/prices.tsx +2 -2
- package/src/plugins/builtin/primary-dealers/pane.tsx +10 -11
- package/src/plugins/builtin/rate-path/model.ts +9 -0
- package/src/plugins/builtin/rate-path/pane.tsx +6 -5
- package/src/plugins/builtin/realized-vol/fx-proxy.ts +27 -0
- package/src/plugins/builtin/realized-vol/headless.ts +8 -6
- package/src/plugins/builtin/realized-vol/pane.tsx +13 -7
- package/src/plugins/builtin/relative-rotation/pane.tsx +1 -1
- package/src/plugins/builtin/research/analyst-headless.ts +5 -1
- package/src/plugins/builtin/research/analyst-model.ts +7 -1
- package/src/plugins/builtin/research/analyst-pane.tsx +1 -1
- package/src/plugins/builtin/research/relative-valuation-basis.ts +44 -4
- package/src/plugins/builtin/research/relative-valuation-headless.ts +59 -14
- package/src/plugins/builtin/research/relative-valuation-model.ts +65 -26
- package/src/plugins/builtin/research/relative-valuation-pane.tsx +42 -17
- package/src/plugins/builtin/revenue-breakdown/pane.tsx +1 -1
- package/src/plugins/builtin/reverse-dcf/client.ts +34 -4
- package/src/plugins/builtin/reverse-dcf/headless.ts +30 -15
- package/src/plugins/builtin/reverse-dcf/model.ts +190 -29
- package/src/plugins/builtin/reverse-dcf/pane.tsx +35 -13
- package/src/plugins/builtin/risk-factors/pane.tsx +2 -2
- package/src/plugins/builtin/roadmap/pane.tsx +2 -2
- package/src/plugins/builtin/scanner/flow-pane.tsx +4 -4
- package/src/plugins/builtin/scanner/headless.ts +15 -1
- package/src/plugins/builtin/seasonality/pane.tsx +1 -1
- package/src/plugins/builtin/sec/fund-facts-view.tsx +5 -2
- package/src/plugins/builtin/sec/fund-facts.ts +41 -1
- package/src/plugins/builtin/sec/headless.ts +8 -4
- package/src/plugins/builtin/sec/index.tsx +41 -13
- package/src/plugins/builtin/shared/ticker-company.ts +111 -0
- package/src/plugins/builtin/shared/use-quote-board.ts +37 -2
- package/src/plugins/builtin/shared/volatility/live-session.ts +23 -0
- package/src/plugins/builtin/shared/volatility-indices.ts +2 -0
- package/src/plugins/builtin/short-interest/publications-pane.tsx +1 -1
- package/src/plugins/builtin/short-volume/pane.tsx +1 -1
- package/src/plugins/builtin/social-mentions/outliers.tsx +3 -3
- package/src/plugins/builtin/social-mentions/pane.tsx +2 -2
- package/src/plugins/builtin/supply-chain/graph-pane.tsx +1 -1
- package/src/plugins/builtin/supply-chain/pane.tsx +1 -1
- package/src/plugins/builtin/themes/pane.tsx +4 -4
- package/src/plugins/builtin/thirteenf/api.ts +1 -0
- package/src/plugins/builtin/thirteenf/format.ts +5 -0
- package/src/plugins/builtin/thirteenf/headless.ts +2 -2
- package/src/plugins/builtin/thirteenf/model.ts +128 -5
- package/src/plugins/builtin/thirteenf/overlap-pane.tsx +1 -1
- package/src/plugins/builtin/thirteenf/report-notes.ts +10 -3
- package/src/plugins/builtin/thirteenf/signals-pane.tsx +1 -1
- package/src/plugins/builtin/thirteenf/table.ts +2 -2
- package/src/plugins/builtin/thirteenf/types.ts +12 -0
- package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +27 -14
- package/src/plugins/builtin/ticker-detail/data-panes/returns-history.ts +6 -3
- package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +14 -0
- package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +4 -1
- package/src/plugins/builtin/ticker-detail/financials/aggregation.ts +87 -19
- package/src/plugins/builtin/ticker-detail/financials/exchange-results.ts +54 -0
- package/src/plugins/builtin/ticker-detail/financials/model.ts +114 -9
- package/src/plugins/builtin/ticker-detail/financials/ratios.ts +37 -20
- package/src/plugins/builtin/ticker-detail/financials/tab.tsx +42 -19
- package/src/plugins/builtin/ticker-detail/headless-schema.ts +3 -2
- package/src/plugins/builtin/ticker-detail/headless.ts +90 -31
- package/src/plugins/builtin/ticker-detail/overview/model.ts +22 -15
- package/src/plugins/builtin/ticker-detail/overview-tab.tsx +5 -2
- package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +12 -7
- package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +21 -0
- package/src/plugins/builtin/trace-bonds/client.ts +107 -10
- package/src/plugins/builtin/trace-bonds/detail.tsx +1 -1
- package/src/plugins/builtin/trace-bonds/headless.ts +20 -5
- package/src/plugins/builtin/trace-bonds/pane.tsx +15 -4
- package/src/plugins/builtin/treasury-auctions/hk-view.tsx +1 -1
- package/src/plugins/builtin/treasury-auctions/pane.tsx +1 -1
- package/src/plugins/builtin/treasury-daily/pane.tsx +2 -2
- package/src/plugins/builtin/vol-surface/charts.tsx +30 -5
- package/src/plugins/builtin/vol-surface/client.ts +40 -12
- package/src/plugins/builtin/vol-surface/events.ts +213 -0
- package/src/plugins/builtin/vol-surface/headless.ts +82 -13
- package/src/plugins/builtin/vol-surface/index.tsx +5 -1
- package/src/plugins/builtin/vol-surface/model.ts +42 -6
- package/src/plugins/builtin/vol-surface/pane.tsx +95 -23
- package/src/plugins/builtin/volatility/dvol.ts +14 -2
- package/src/plugins/builtin/volatility/headless.ts +3 -2
- package/src/plugins/builtin/volatility/index.tsx +1 -1
- package/src/plugins/builtin/volatility/pane.tsx +1 -1
- package/src/plugins/builtin/volatility/series.ts +7 -3
- package/src/plugins/builtin/world-venue-map/activity-series.ts +89 -0
- package/src/plugins/builtin/world-venue-map/chokepoint-report.ts +123 -0
- package/src/plugins/builtin/world-venue-map/evidence.ts +2 -0
- package/src/plugins/builtin/world-venue-map/geo-series.ts +35 -1
- package/src/plugins/builtin/world-venue-map/headless.ts +58 -9
- package/src/plugins/builtin/world-venue-map/index.ts +6 -3
- package/src/plugins/builtin/world-venue-map/layered-pane.tsx +6 -1
- package/src/plugins/builtin/world-venue-map/pane.tsx +4 -3
- package/src/plugins/builtin/yield-curve/index.tsx +12 -10
- package/src/plugins/builtin/yield-curve/swaps.tsx +1 -1
- package/src/plugins/extracted-plugins.ts +14 -10
- package/src/plugins/installer.ts +17 -1
- package/src/plugins/marketplace/feed.ts +14 -0
- package/src/plugins/marketplace/install-offer.ts +64 -0
- package/src/plugins/registry/contributions.ts +46 -8
- package/src/plugins/registry/index.ts +5 -0
- package/src/portfolio/collection-name.ts +38 -4
- package/src/portfolio/column-values.ts +32 -4
- package/src/portfolio/period-pnl.ts +4 -2
- package/src/react/async-resource.ts +24 -8
- package/src/remote/endpoint.ts +38 -12
- package/src/remote/secrets.ts +22 -6
- package/src/remote/server.ts +20 -4
- package/src/renderers/dom/data-table/index.tsx +2 -1
- package/src/renderers/dom/data-table/row.tsx +49 -7
- package/src/renderers/dom/desktop/controls.tsx +2 -0
- package/src/renderers/dom/desktop/query-bar.tsx +57 -7
- package/src/renderers/dom/host/surface-3d.tsx +46 -5
- package/src/renderers/dom/styles.css +17 -0
- package/src/renderers/electrobun/view/backend-rpc.ts +15 -21
- package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +16 -61
- package/src/renderers/electrobun/view/cli-pane-shot-socket.ts +134 -0
- package/src/renderers/electrobun/view/host-route.ts +119 -0
- package/src/renderers/electrobun/view/rpc-timeout.ts +6 -5
- package/src/renderers/opentui/toast-host.tsx +6 -3
- package/src/renderers/opentui/ui-host.tsx +29 -5
- package/src/series/registry.ts +1 -0
- package/src/series/standalone-catalog.ts +40 -0
- package/src/series/types.ts +10 -0
- package/src/series/validate.ts +5 -0
- package/src/shares/portable-layout.ts +2 -7
- package/src/sources/gloomberb-cloud/dated-chunks.ts +133 -0
- package/src/sources/gloomberb-cloud/index.ts +46 -5
- package/src/sources/gloomberb-cloud/news.ts +15 -9
- package/src/sources/gloomberb-cloud/normalizers.ts +17 -0
- package/src/sources/history-coverage.ts +13 -0
- package/src/sources/history-result.ts +1 -0
- package/src/sources/provider-errors.ts +9 -0
- package/src/sources/provider-router/batches.ts +7 -3
- package/src/sources/provider-router/financial-routes.ts +3 -1
- package/src/sources/provider-router/history.ts +6 -4
- package/src/sources/provider-router/index.ts +5 -1
- package/src/sources/provider-router/primary.ts +4 -3
- package/src/sources/provider-router/retrieved-at.ts +12 -0
- package/src/team/store.ts +17 -4
- package/src/telemetry/crash-reports.ts +3 -1
- package/src/test-support/cli-context.ts +3 -2
- package/src/test-support/test-env.ts +7 -0
- package/src/theme/themes.ts +16 -9
- package/src/theme/tone-contrast.ts +29 -5
- package/src/tickers/company-name-listing.ts +31 -3
- package/src/tickers/company-name.ts +9 -0
- package/src/tickers/index-roots.ts +56 -4
- package/src/tickers/listing-name.ts +7 -2
- package/src/tickers/listing-venues.ts +17 -2
- package/src/tickers/search/home-listing.ts +2 -0
- package/src/tickers/search/index.ts +64 -11
- package/src/tickers/search/major-listings.json +595 -592
- package/src/tickers/search/ranking.ts +19 -1
- package/src/tickers/terminal-codes.ts +5 -3
- package/src/time-series/bar-aggregation.ts +3 -2
- package/src/time-series/base-series.ts +18 -1
- package/src/time-series/chart-data.ts +9 -6
- package/src/time-series/chart-seed.ts +11 -3
- package/src/time-series/currency-conversion.ts +1 -0
- package/src/time-series/date-window.ts +8 -0
- package/src/time-series/formula-months.ts +57 -0
- package/src/time-series/fundamentals/period-points.ts +3 -3
- package/src/time-series/fundamentals/source-statements.ts +5 -4
- package/src/time-series/leverage.ts +12 -4
- package/src/time-series/live-bars.ts +12 -7
- package/src/time-series/live-quotes.ts +6 -2
- package/src/time-series/market.ts +10 -3
- package/src/time-series/price-comparison.ts +106 -0
- package/src/time-series/range.ts +10 -0
- package/src/time-series/resolve-context.ts +7 -2
- package/src/time-series/resolve.ts +61 -5
- package/src/time-series/series-name.ts +2 -2
- package/src/time-series/series-presentation.ts +91 -2
- package/src/time-series/session-bar.ts +13 -7
- package/src/time-series/spec.ts +21 -2
- package/src/time-series/studies/formula.ts +262 -36
- package/src/time-series/studies/leverage.ts +9 -3
- package/src/time-series/studies/resolve.ts +7 -2
- package/src/time-series/types.ts +34 -0
- package/src/time-series/use-chart-resolution.ts +18 -1
- package/src/types/data-provider.ts +7 -0
- package/src/types/financials.ts +103 -1
- package/src/types/headless.ts +64 -3
- package/src/types/instrument.ts +6 -0
- package/src/types/plugin-context.ts +9 -0
- package/src/types/plugin-pane-templates.ts +6 -0
- package/src/types/plugin-panes.ts +7 -0
- package/src/types/price-history.ts +6 -0
- package/src/ui/host.tsx +3 -1
- package/src/ui/index.tsx +7 -2
- package/src/utils/cli-output.ts +21 -1
- package/src/utils/currency-units.ts +14 -0
- package/src/utils/datetime-format.ts +11 -0
- package/src/utils/exchange-announcements.ts +26 -3
- package/src/utils/exchange-notation.generated.ts +3 -4
- package/src/utils/exchange-results.ts +144 -0
- package/src/utils/exchanges.ts +10 -0
- package/src/utils/financial-statements.ts +212 -22
- package/src/utils/fire-and-forget.ts +1 -1
- package/src/utils/fiscal-period.ts +41 -3
- package/src/utils/format.ts +10 -6
- package/src/utils/fundamentals.ts +179 -12
- package/src/utils/futures-generic.ts +26 -0
- package/src/utils/lease-liabilities.ts +15 -5
- package/src/utils/lookup-token.ts +22 -0
- package/src/utils/max-drawdown.ts +25 -4
- package/src/utils/price-history-integrity.ts +56 -8
- package/src/utils/price-history.ts +6 -2
- package/src/utils/price-window.ts +38 -2
- package/src/utils/replace-file.ts +47 -0
- package/src/utils/rpc-timeout-error.ts +16 -2
- package/src/utils/untrusted-text.ts +14 -0
|
@@ -37,6 +37,7 @@ import {
|
|
|
37
37
|
import { dailyFuturesHistory, loadPortfolioFuturesTerms, type PortfolioFuturesSources } from "../../../../portfolio/futures-terms";
|
|
38
38
|
import { loadPurchaseDateCostFx, withPurchaseDateCostFx, type CostFxHistoryClient, type PurchaseDateCostFx } from "../../../../portfolio/cost-fx";
|
|
39
39
|
import { apiClient } from "../../../../api-client";
|
|
40
|
+
import { canonicalExchange, isUsListingExchange } from "../../../../utils/exchanges";
|
|
40
41
|
import { formatUtcDayTime, parseReportTime } from "../../../../utils/utc-time";
|
|
41
42
|
import { quoteFreshnessFields } from "../../shared/report-freshness";
|
|
42
43
|
import { resolvePortfolioTotalsCurrency } from "../summary/totals";
|
|
@@ -44,6 +45,7 @@ import {
|
|
|
44
45
|
EXTENDED_SESSION_LABELS,
|
|
45
46
|
exchangeShortName,
|
|
46
47
|
getActiveQuoteDisplay,
|
|
48
|
+
getCompletedRegularSessionDisplay,
|
|
47
49
|
getExtendedSessionDisplay,
|
|
48
50
|
quoteHeadlineTime,
|
|
49
51
|
type ActiveQuoteDisplay,
|
|
@@ -89,7 +91,7 @@ import {
|
|
|
89
91
|
} from "../../../../portfolio/allocation";
|
|
90
92
|
import { findCachedPortfolioAccount } from "../cached-account";
|
|
91
93
|
import { importedFromText } from "../imported-from";
|
|
92
|
-
import { findNamedCollection, watchlistMemberSymbol } from "../../../../portfolio/collection-name";
|
|
94
|
+
import { findNamedCollection, watchlistMemberSymbol, type CollectionNameOptions } from "../../../../portfolio/collection-name";
|
|
93
95
|
import { isoDateToday } from "../../../../utils/calendar-date";
|
|
94
96
|
import { lastTradeDate } from "../../../../tickers/listing-fate";
|
|
95
97
|
import type { PriceWindow } from "../../../../utils/price-window";
|
|
@@ -224,6 +226,8 @@ export interface ShowCollectionOptions {
|
|
|
224
226
|
drip?: { years: number; withholding: number };
|
|
225
227
|
/** How long every holding's dividend read may take together; a test shortens it. */
|
|
226
228
|
dividendDeadlineMs?: number;
|
|
229
|
+
/** Fails in its own words when no collection has the name, before the generic "not found". */
|
|
230
|
+
onMissing?: (config: AppConfig) => void;
|
|
227
231
|
/** Where futures' terms and settlements are read; Gloom Cloud's terms and the data provider's daily bars by default. */
|
|
228
232
|
futuresSources?: PortfolioFuturesSources;
|
|
229
233
|
/** Where the FX closes of the lots' purchase dates are read; Gloom Cloud by default. */
|
|
@@ -260,11 +264,20 @@ export type CollectionMatch =
|
|
|
260
264
|
| { kind: "portfolio"; id: string; name: string; portfolio: Portfolio }
|
|
261
265
|
| { kind: "watchlist"; id: string; name: string };
|
|
262
266
|
|
|
263
|
-
export function findCollection(config: AppConfig, name: string): CollectionMatch | null {
|
|
267
|
+
export function findCollection(config: AppConfig, name: string, { prefix = false }: CollectionNameOptions = {}): CollectionMatch | null {
|
|
264
268
|
const portfolio = findNamedCollection(config.portfolios, name);
|
|
265
269
|
if (portfolio) return { kind: "portfolio", id: portfolio.id, name: portfolio.name, portfolio };
|
|
266
270
|
const watchlist = findNamedCollection(config.watchlists, name);
|
|
267
|
-
|
|
271
|
+
if (watchlist) return { kind: "watchlist", id: watchlist.id, name: watchlist.name };
|
|
272
|
+
if (!prefix) return null;
|
|
273
|
+
// The start of one name, among portfolios and watchlists together: `PF family` is Family Office.
|
|
274
|
+
const started = findNamedCollection<{ id: string; name: string; kind: "portfolio" | "watchlist" }>([
|
|
275
|
+
...config.portfolios.map((entry) => ({ id: entry.id, name: entry.name, kind: "portfolio" as const })),
|
|
276
|
+
...config.watchlists.map((entry) => ({ id: entry.id, name: entry.name, kind: "watchlist" as const })),
|
|
277
|
+
], name, { prefix: true });
|
|
278
|
+
if (!started) return null;
|
|
279
|
+
const book = started.kind === "portfolio" ? config.portfolios.find((entry) => entry.id === started.id) : undefined;
|
|
280
|
+
return book ? { kind: "portfolio", id: book.id, name: book.name, portfolio: book } : { kind: "watchlist", id: started.id, name: started.name };
|
|
268
281
|
}
|
|
269
282
|
|
|
270
283
|
type CollectionQuote = Awaited<ReturnType<DataProvider["getQuote"]>>;
|
|
@@ -351,8 +364,10 @@ interface PortfolioPositionValue {
|
|
|
351
364
|
/**
|
|
352
365
|
* The position's move over the day of that price, in the portfolio's
|
|
353
366
|
* currency, and its value at the close before; null when either is unknown.
|
|
367
|
+
* A holding in another currency is worth its value before at the previous
|
|
368
|
+
* FX close, so the move holds the currency's own (`fx`, 0 in the book's).
|
|
354
369
|
*/
|
|
355
|
-
dayMove: { change: number; previousValue: number } | null;
|
|
370
|
+
dayMove: { change: number; previousValue: number; fx: number } | null;
|
|
356
371
|
/** The `portfolio show --json` row. */
|
|
357
372
|
row: Record<string, unknown>;
|
|
358
373
|
/** A future's contract size and settlement from its terms; null for any other holding. */
|
|
@@ -458,6 +473,7 @@ export async function valuePortfolioPositions({
|
|
|
458
473
|
basis = "latest-print",
|
|
459
474
|
futures,
|
|
460
475
|
purchaseDateFx,
|
|
476
|
+
previousRate,
|
|
461
477
|
}: {
|
|
462
478
|
tickers: readonly TickerRecord[];
|
|
463
479
|
quotes: ReadonlyMap<string, CollectionQuote>;
|
|
@@ -465,6 +481,12 @@ export async function valuePortfolioPositions({
|
|
|
465
481
|
currency: string;
|
|
466
482
|
baseCurrency: string;
|
|
467
483
|
toBase: (value: number, fromCurrency: string) => Promise<number>;
|
|
484
|
+
/**
|
|
485
|
+
* One unit of a currency in `currency` at the previous daily FX close (BaseConverter.previousRate): the day's move
|
|
486
|
+
* of a holding in another currency then holds the currency's move too. Without it, or with no close, the day's
|
|
487
|
+
* move is the price's alone, at today's rate.
|
|
488
|
+
*/
|
|
489
|
+
previousRate?: (fromCurrency: string) => Promise<number | null>;
|
|
468
490
|
basis?: PortfolioValuationBasis;
|
|
469
491
|
/** Each future's contract size and settlement (loadPortfolioFuturesTerms), by symbol. */
|
|
470
492
|
futures?: ReadonlyMap<string, PortfolioFuturesTerms>;
|
|
@@ -561,8 +583,7 @@ export async function valuePortfolioPositions({
|
|
|
561
583
|
// A listing that no longer trades does not move, as the pane's Day counts it: its last session's change is not today's.
|
|
562
584
|
const change = quote?.delisting ? 0 : valuationQuote?.change;
|
|
563
585
|
const dayMove = valuationQuote && change != null && Number.isFinite(change)
|
|
564
|
-
?
|
|
565
|
-
previousValue: await toBase(metrics.grossPriceUnits * (valuationQuote.price - change), quoteCurrency) }
|
|
586
|
+
? await positionDayMove(metrics, valuationQuote.price, change, quoteCurrency, toBase, previousRate)
|
|
566
587
|
: null;
|
|
567
588
|
values.push({ ticker, quote, activeQuote, headline, extended, position, metrics, pnl, futures: futuresTerms, ...(costFx !== undefined ? { costFx } : {}),
|
|
568
589
|
dayMove: dayMove && Number.isFinite(dayMove.change) && Number.isFinite(dayMove.previousValue) ? dayMove : null,
|
|
@@ -589,6 +610,34 @@ export async function valuePortfolioPositions({
|
|
|
589
610
|
unknownContractSize, unsettled, costAtTodaysRate, costFxUndated, costFxUnread, exposure };
|
|
590
611
|
}
|
|
591
612
|
|
|
613
|
+
/**
|
|
614
|
+
* A position's move over the day in the portfolio's currency: the price's
|
|
615
|
+
* move at today's rate, and for a holding in another currency the currency's
|
|
616
|
+
* move on its value at the close before (that value at the previous FX close
|
|
617
|
+
* against today's rate). With no previous FX close the move is the price's.
|
|
618
|
+
* A future's contract value is no money held: the currency moves only its
|
|
619
|
+
* P&L, the price's move at today's rate, never its notional.
|
|
620
|
+
*/
|
|
621
|
+
async function positionDayMove(
|
|
622
|
+
metrics: Pick<ReturnType<typeof getPortfolioPositionMetrics>, "totalPriceUnits" | "grossPriceUnits" | "isFuture">,
|
|
623
|
+
price: number,
|
|
624
|
+
change: number,
|
|
625
|
+
quoteCurrency: string,
|
|
626
|
+
toBase: (value: number, fromCurrency: string) => Promise<number>,
|
|
627
|
+
previousRate?: (fromCurrency: string) => Promise<number | null>,
|
|
628
|
+
): Promise<{ change: number; previousValue: number; fx: number }> {
|
|
629
|
+
const previousPrice = price - change;
|
|
630
|
+
const rate = await toBase(1, quoteCurrency);
|
|
631
|
+
const before = previousRate && !metrics.isFuture ? await previousRate(quoteCurrency) : null;
|
|
632
|
+
const previous = before != null && Number.isFinite(before) && before > 0 ? before : rate;
|
|
633
|
+
const fx = metrics.totalPriceUnits * previousPrice * (rate - previous);
|
|
634
|
+
return {
|
|
635
|
+
change: await toBase(metrics.totalPriceUnits * change, quoteCurrency) + fx,
|
|
636
|
+
previousValue: metrics.grossPriceUnits * previousPrice * previous,
|
|
637
|
+
fx,
|
|
638
|
+
};
|
|
639
|
+
}
|
|
640
|
+
|
|
592
641
|
/**
|
|
593
642
|
* The holdings' move over the day of the prices they are valued at, in the
|
|
594
643
|
* portfolio's currency, and that move against their value at the close
|
|
@@ -601,9 +650,10 @@ export async function valuePortfolioPositions({
|
|
|
601
650
|
export function portfolioDayMove(
|
|
602
651
|
valuation: Pick<PortfolioValuation, "positions" | "basis">,
|
|
603
652
|
now = Date.now(),
|
|
604
|
-
): { change: number; changePercent: number | null; basis: string | null } | null {
|
|
653
|
+
): { change: number; changePercent: number | null; basis: string | null; fx: number } | null {
|
|
605
654
|
let change = 0;
|
|
606
655
|
let previousValue = 0;
|
|
656
|
+
let fx = 0;
|
|
607
657
|
const bases: Array<QuoteChangeBasis | null> = [];
|
|
608
658
|
const session = valuation.basis === "regular-close" ? "regular" : "active";
|
|
609
659
|
for (const entry of valuation.positions) {
|
|
@@ -611,12 +661,14 @@ export function portfolioDayMove(
|
|
|
611
661
|
if (!entry.dayMove) return null;
|
|
612
662
|
change += entry.dayMove.change;
|
|
613
663
|
previousValue += entry.dayMove.previousValue;
|
|
664
|
+
fx += entry.dayMove.fx;
|
|
614
665
|
if (!entry.quote?.delisting) bases.push(quoteChangeBasis(entry.quote, { session, terms: entry.futures }));
|
|
615
666
|
}
|
|
616
667
|
return {
|
|
617
668
|
change,
|
|
618
669
|
changePercent: previousValue !== 0 ? (change / previousValue) * 100 : null,
|
|
619
670
|
basis: combinedChangeBasisLabel(bases, now),
|
|
671
|
+
fx,
|
|
620
672
|
};
|
|
621
673
|
}
|
|
622
674
|
|
|
@@ -630,11 +682,15 @@ export function dayMoveLine(
|
|
|
630
682
|
currency: string,
|
|
631
683
|
color: (text: string, value: number) => string = (text) => text,
|
|
632
684
|
muted: (text: string) => string = (text) => text,
|
|
685
|
+
// A book with cash: the percent is the holdings' move, which the cash does not dilute, and says so.
|
|
686
|
+
{ cashExcluded = false }: { cashExcluded?: boolean } = {},
|
|
633
687
|
): string {
|
|
634
688
|
if (!move) return "Day's move: unavailable";
|
|
635
|
-
const percent = move.changePercent != null ? ` (${formatPercentRaw(move.changePercent)})` : "";
|
|
689
|
+
const percent = move.changePercent != null ? ` (${formatPercentRaw(move.changePercent)}${cashExcluded ? " of the holdings, cash excluded" : ""})` : "";
|
|
636
690
|
const basis = move.basis ? ` ${muted(move.basis)}` : "";
|
|
637
|
-
|
|
691
|
+
// A holding in another currency moves with it too: how much of the move that is.
|
|
692
|
+
const fx = Math.abs(move.fx) >= 0.005 ? `, FX ${color(formatAllocationMoney(move.fx, currency, { signed: true }), move.fx)} of it` : "";
|
|
693
|
+
return `Day's move: ${color(`${formatAllocationMoney(move.change, currency, { signed: true })}${percent}`, move.change)}${basis}${fx}`;
|
|
638
694
|
}
|
|
639
695
|
|
|
640
696
|
/**
|
|
@@ -786,7 +842,7 @@ function portfolioValuationFreshness(
|
|
|
786
842
|
citeOldest: true,
|
|
787
843
|
// A book across markets names each one's session and open: an HKEX book holding one US fund is not dated by the US day alone.
|
|
788
844
|
datesEachVenue: true,
|
|
789
|
-
...(note ? { note: `priced at ${
|
|
845
|
+
...(note ? { note: `priced at ${valuationBasisText(valuation.basis, holdsFutures(valuation), marketsStillTrading(valuation))}` } : {}),
|
|
790
846
|
}, undefined, now);
|
|
791
847
|
}
|
|
792
848
|
|
|
@@ -795,9 +851,56 @@ export function holdsFutures(valuation: Pick<PortfolioValuation, "positions">):
|
|
|
795
851
|
return valuation.positions.some((entry) => entry.position && entry.futures);
|
|
796
852
|
}
|
|
797
853
|
|
|
798
|
-
/**
|
|
799
|
-
|
|
800
|
-
|
|
854
|
+
/**
|
|
855
|
+
* `Priced at the latest print, extended hours included`: the line under a
|
|
856
|
+
* portfolio's title. At the close, a book with markets still trading names
|
|
857
|
+
* them, and the markets at their close: `Priced at the regular
|
|
858
|
+
* close: BIST at its close; US still trading, at the latest print`.
|
|
859
|
+
*/
|
|
860
|
+
function valuationBasisLine(
|
|
861
|
+
basis: PortfolioValuationBasis,
|
|
862
|
+
futures: boolean,
|
|
863
|
+
markets: { closed: string[]; trading: string[] } | null = null,
|
|
864
|
+
): string {
|
|
865
|
+
return `Priced at ${valuationBasisText(basis, futures, markets)}`;
|
|
866
|
+
}
|
|
867
|
+
|
|
868
|
+
/** What a book is priced at, after "Priced at", with the markets still trading at the close (`marketsStillTrading`). */
|
|
869
|
+
export function valuationBasisText(
|
|
870
|
+
basis: PortfolioValuationBasis,
|
|
871
|
+
futures: boolean,
|
|
872
|
+
markets: { closed: string[]; trading: string[] } | null = null,
|
|
873
|
+
): string {
|
|
874
|
+
const label = valuationBasisLabel(basis, { futures });
|
|
875
|
+
if (basis !== "regular-close" || !markets?.trading.length) return label;
|
|
876
|
+
const closed = markets.closed.length ? `${joinWords(markets.closed)} at ${markets.closed.length === 1 ? "its" : "their"} close; ` : "";
|
|
877
|
+
return `${label}: ${closed}${joinWords(markets.trading)} still trading, at the latest print`;
|
|
878
|
+
}
|
|
879
|
+
|
|
880
|
+
/** `US`, `US and BIST`, `US, LSE and BIST`. */
|
|
881
|
+
function joinWords(words: readonly string[]): string {
|
|
882
|
+
return words.length <= 1 ? words.join("") : `${words.slice(0, -1).join(", ")} and ${words.at(-1)}`;
|
|
883
|
+
}
|
|
884
|
+
|
|
885
|
+
/**
|
|
886
|
+
* The markets of a book's holdings, US listings as one, split into those
|
|
887
|
+
* whose regular session is over, which the close values, and those still in
|
|
888
|
+
* it, whose rows are at the latest print until their close; futures, at the
|
|
889
|
+
* settle, and options, at their mark, are neither. In the order the rows
|
|
890
|
+
* first name them.
|
|
891
|
+
*/
|
|
892
|
+
export function marketsStillTrading(valuation: Pick<PortfolioValuation, "positions">): { closed: string[]; trading: string[] } {
|
|
893
|
+
const states = new Map<string, boolean>();
|
|
894
|
+
for (const { quote, metrics, position, futures } of valuation.positions) {
|
|
895
|
+
if (!position || !quote || futures || metrics?.valuesAtMark) continue;
|
|
896
|
+
const exchange = canonicalExchange(quote.listingExchangeName || quote.exchangeName);
|
|
897
|
+
if (!exchange) continue;
|
|
898
|
+
const market = isUsListingExchange(exchange) ? "US" : exchange;
|
|
899
|
+
const trading = getCompletedRegularSessionDisplay(quote) == null && quote.marketState === "REGULAR";
|
|
900
|
+
states.set(market, (states.get(market) ?? false) || trading);
|
|
901
|
+
}
|
|
902
|
+
const markets = [...states];
|
|
903
|
+
return { closed: markets.filter(([, trading]) => !trading).map(([market]) => market), trading: markets.filter(([, trading]) => trading).map(([market]) => market) };
|
|
801
904
|
}
|
|
802
905
|
|
|
803
906
|
/** What a row's price is when it is not a print or a close: a future's settlement, or a venue's nominal price. */
|
|
@@ -837,7 +940,7 @@ async function showCollectionWithMarketData(
|
|
|
837
940
|
name: string,
|
|
838
941
|
ctx: CliCommandContext,
|
|
839
942
|
{ config, store, dataProvider, persistence }: MarketContext,
|
|
840
|
-
{ explain = false, basis = "latest-print", drip, dividendDeadlineMs = DIVIDEND_READ_DEADLINE_MS, futuresSources, costFxHistory = apiClient, period, real = false, cpi }: ShowCollectionOptions,
|
|
943
|
+
{ explain = false, basis = "latest-print", drip, dividendDeadlineMs = DIVIDEND_READ_DEADLINE_MS, futuresSources, costFxHistory = apiClient, period, real = false, cpi, onMissing }: ShowCollectionOptions,
|
|
841
944
|
outcome: { readsLeftBehind: boolean } = { readsLeftBehind: false },
|
|
842
945
|
) {
|
|
843
946
|
const tickers = (await store.loadAllTickers()).sort((left, right) =>
|
|
@@ -846,6 +949,7 @@ async function showCollectionWithMarketData(
|
|
|
846
949
|
const collection = findCollection(config, name);
|
|
847
950
|
|
|
848
951
|
if (!collection) {
|
|
952
|
+
onMissing?.(config);
|
|
849
953
|
ctx.fail(
|
|
850
954
|
`Collection "${name}" was not found.`,
|
|
851
955
|
`Available: ${[...config.portfolios.map((portfolio) => portfolio.name), ...config.watchlists.map((watchlist) => watchlist.name)].join(", ")}`,
|
|
@@ -914,17 +1018,21 @@ async function showCollectionWithMarketData(
|
|
|
914
1018
|
// A watchlist's stale rows, named under the closing line that counts them.
|
|
915
1019
|
let staleNote: string | null = null;
|
|
916
1020
|
|
|
1021
|
+
const valuation = matchedPortfolio
|
|
1022
|
+
? await valuePortfolioPositions({ tickers: filtered, quotes, portfolioId: id, currency, baseCurrency: config.baseCurrency, toBase, basis, futures, purchaseDateFx,
|
|
1023
|
+
previousRate: toBase.previousRate })
|
|
1024
|
+
: null;
|
|
1025
|
+
|
|
917
1026
|
if (!structured) {
|
|
918
1027
|
console.log(cliStyles.bold(displayName + (isPortfolio ? ` (${currency})` : "")));
|
|
919
1028
|
console.log(cliStyles.muted(`${filtered.length} ticker${filtered.length === 1 ? "" : "s"}`));
|
|
920
1029
|
const imported = matchedPortfolio ? importedFromText(matchedPortfolio) : null;
|
|
921
1030
|
if (imported) console.log(cliStyles.muted(imported));
|
|
922
|
-
if (isPortfolio) console.log(cliStyles.muted(valuationBasisLine(basis, futuresHeld.length > 0)));
|
|
1031
|
+
if (isPortfolio) console.log(cliStyles.muted(valuationBasisLine(basis, futuresHeld.length > 0, valuation ? marketsStillTrading(valuation) : null)));
|
|
923
1032
|
console.log("");
|
|
924
1033
|
}
|
|
925
1034
|
|
|
926
|
-
if (matchedPortfolio) {
|
|
927
|
-
const valuation = await valuePortfolioPositions({ tickers: filtered, quotes, portfolioId: id, currency, baseCurrency: config.baseCurrency, toBase, basis, futures, purchaseDateFx });
|
|
1035
|
+
if (matchedPortfolio && valuation) {
|
|
928
1036
|
// Exports carry no header line, so their source line names the basis.
|
|
929
1037
|
freshness = portfolioValuationFreshness(valuation, source, { note: structured });
|
|
930
1038
|
const {
|
|
@@ -960,6 +1068,21 @@ async function showCollectionWithMarketData(
|
|
|
960
1068
|
const hedged = allocation.weightBasis === "gross";
|
|
961
1069
|
const yieldBase = hedged ? allocation.weightBase : exposure.net;
|
|
962
1070
|
const portfolioYield = totalIncome != null && yieldBase != null && yieldBase > 0 ? (totalIncome / yieldBase) * 100 : null;
|
|
1071
|
+
// With a holding's income unknown, TOTAL still adds up those it has, and the note under the table names the
|
|
1072
|
+
// holdings it leaves out. Its yield is over the same base less what those are worth, so a holding that pays
|
|
1073
|
+
// nothing (a coin, a non-payer) still counts. The export keeps annualIncome null and knownAnnualIncome.
|
|
1074
|
+
const partialIncome = totalIncome == null && income.knownHoldings > 0;
|
|
1075
|
+
const leftOutValue = partialIncome
|
|
1076
|
+
? valued.reduce((sum, entry) => {
|
|
1077
|
+
const value = entry.position && entry.metrics && income.gaps.has(entry.ticker.metadata.ticker) ? entry.row.marketValue : null;
|
|
1078
|
+
return typeof value === "number" && Number.isFinite(value) ? sum + (hedged ? Math.abs(value) : value) : sum;
|
|
1079
|
+
}, 0)
|
|
1080
|
+
: 0;
|
|
1081
|
+
const knownBase = partialIncome && yieldBase != null ? yieldBase - leftOutValue : null;
|
|
1082
|
+
const totalIncomeShown = partialIncome ? income.knownIncome : totalIncome;
|
|
1083
|
+
const totalYieldShown = partialIncome
|
|
1084
|
+
? knownBase != null && knownBase > 0 ? (income.knownIncome / knownBase) * 100 : null
|
|
1085
|
+
: portfolioYield;
|
|
963
1086
|
const incomeUnavailable = [...income.gaps].map(([symbol, gap]) => ({ symbol, ...gap }));
|
|
964
1087
|
const showTargets = allocation.targetSum != null;
|
|
965
1088
|
// Never dropped on a narrow terminal, so --explain reads the terms off them.
|
|
@@ -1094,6 +1217,7 @@ async function showCollectionWithMarketData(
|
|
|
1094
1217
|
// Only on a book that holds a short: its weights are shares of `weightBase`, its gross exposure, not of the total.
|
|
1095
1218
|
...(allocation.weightBasis === "gross" ? { weightBasis: allocation.weightBasis, weightBase: allocation.weightBase } : {}),
|
|
1096
1219
|
dayChange: dayMove?.change ?? null, dayChangePercent: dayMove?.changePercent ?? null, dayChangeBasis: dayMove?.basis ?? null,
|
|
1220
|
+
dayChangeFx: dayMove?.fx ?? null,
|
|
1097
1221
|
unpricedCount: allocation.unpriced.length, unpricedSymbols: allocation.unpriced,
|
|
1098
1222
|
totalUnrealizedPnl: totalPnlValue,
|
|
1099
1223
|
annualIncome: totalIncome, knownAnnualIncome: income.knownIncome, portfolioYield,
|
|
@@ -1209,7 +1333,7 @@ async function showCollectionWithMarketData(
|
|
|
1209
1333
|
cliStyles.bold(wholeMoney(total)),
|
|
1210
1334
|
formatAllocationWeight(totalWeight(allocation)),
|
|
1211
1335
|
...(showTargets ? [formatAllocationWeight(allocation.targetSum), "", "", ""] : []),
|
|
1212
|
-
...(showIncome ? [cliStyles.bold(money(
|
|
1336
|
+
...(showIncome ? [cliStyles.bold(money(totalIncomeShown)), formatIncomeYield(totalYieldShown)] : []),
|
|
1213
1337
|
totalPnlValue == null ? "—" : colorBySign(money(totalPnlValue, { signed: true }), totalPnlValue),
|
|
1214
1338
|
"",
|
|
1215
1339
|
]);
|
|
@@ -1227,21 +1351,22 @@ async function showCollectionWithMarketData(
|
|
|
1227
1351
|
...extendedSessions.map((session) => ({ header: EXTENDED_SESSION_LABELS[session], align: "right" as const, optional: true, dropPriority: 3 })),
|
|
1228
1352
|
{ header: quantityHeader, align: "right" },
|
|
1229
1353
|
{ header: "Avg Cost", align: "right", optional: true, dropPriority: 3 },
|
|
1230
|
-
|
|
1231
|
-
|
|
1354
|
+
// Value, trade value, income and P&L are in the portfolio's currency, and their headers name it.
|
|
1355
|
+
{ header: `Value (${currency})`, align: "right" },
|
|
1356
|
+
...allocationHeaders.map((header) => ({ header: header === "Trade Value" ? `${header} (${currency})` : header, align: "right" as const })),
|
|
1232
1357
|
// A year of trailing dividends on the shares held, dropped after the quote and before P&L.
|
|
1233
1358
|
...(showIncome ? [
|
|
1234
|
-
{ header:
|
|
1359
|
+
{ header: `Income (${currency})`, align: "right" as const, optional: true, dropPriority: 0.5 },
|
|
1235
1360
|
{ header: "Yield", align: "right" as const, optional: true, dropPriority: 0.5 },
|
|
1236
1361
|
] : []),
|
|
1237
|
-
{ header:
|
|
1362
|
+
{ header: `P&L (${currency})`, align: "right", optional: true },
|
|
1238
1363
|
// When each row's price is from, so a Friday close never hides behind a newer row.
|
|
1239
1364
|
{ header: "As of (UTC)" },
|
|
1240
1365
|
],
|
|
1241
1366
|
rows,
|
|
1242
1367
|
));
|
|
1243
1368
|
console.log("");
|
|
1244
|
-
if (valued.some((entry) => entry.position)) console.log(dayMoveLine(dayMove, currency, colorBySign, cliStyles.muted));
|
|
1369
|
+
if (valued.some((entry) => entry.position)) console.log(dayMoveLine(dayMove, currency, colorBySign, cliStyles.muted, { cashExcluded: !!cashExport }));
|
|
1245
1370
|
if (valued.some((entry) => entry.position)) console.log(exposureLine(exposure, currency));
|
|
1246
1371
|
// The rates the holdings in another currency are valued at, dated, so a stale one is seen beside the value it moves.
|
|
1247
1372
|
const fxLine = fxRatesLine(toBase.conversions(), { warning: cliStyles.warning });
|
|
@@ -1283,7 +1408,7 @@ async function showCollectionWithMarketData(
|
|
|
1283
1408
|
}
|
|
1284
1409
|
if (unsized(unavailableCost).length > 0) notes.push(cliStyles.muted(`Cost unavailable for ${named(unsized(unavailableCost))}.`));
|
|
1285
1410
|
if (unsized(unavailablePnl).length > 0) notes.push(cliStyles.muted(`P&L unavailable for ${named(unsized(unavailablePnl))}.`));
|
|
1286
|
-
const incomeNote = incomeGapNote(income, { name: named,
|
|
1411
|
+
const incomeNote = incomeGapNote(income, { name: named, deadlineMs: dividendDeadlineMs });
|
|
1287
1412
|
if (incomeNote) notes.push(cliStyles.muted(incomeNote));
|
|
1288
1413
|
for (const note of notes) console.log(note);
|
|
1289
1414
|
if (drip) {
|
|
@@ -20,7 +20,9 @@ import {
|
|
|
20
20
|
listingLabel,
|
|
21
21
|
loadCollectionQuotes,
|
|
22
22
|
holdsFutures,
|
|
23
|
+
marketsStillTrading,
|
|
23
24
|
portfolioDayMove,
|
|
25
|
+
valuationBasisText,
|
|
24
26
|
valuationTimeText,
|
|
25
27
|
valuePortfolioAllocation,
|
|
26
28
|
valuePortfolioPositions,
|
|
@@ -28,7 +30,7 @@ import {
|
|
|
28
30
|
type CollectionMatch,
|
|
29
31
|
type PortfolioValuation,
|
|
30
32
|
} from "./cli/render";
|
|
31
|
-
import {
|
|
33
|
+
import type { PortfolioValuationBasis } from "../../../portfolio/valuation-basis";
|
|
32
34
|
import { futuresQuantityText, isFuturesTicker } from "../../../portfolio/futures-positions";
|
|
33
35
|
import { dailyFuturesHistory, loadPortfolioFuturesTerms } from "../../../portfolio/futures-terms";
|
|
34
36
|
import { loadPurchaseDateCostFx } from "../../../portfolio/cost-fx";
|
|
@@ -107,6 +109,14 @@ const POSITION_COLUMNS: HeadlessPaneColumn[] = [
|
|
|
107
109
|
{ key: "weight", header: "Weight", align: "right", format: weight, description: "Percent of the total value, cash included; unpriced holdings are left out." },
|
|
108
110
|
];
|
|
109
111
|
|
|
112
|
+
/** Columns whose amounts are in the portfolio's currency, whatever the listing's. */
|
|
113
|
+
const BOOK_CURRENCY_KEYS: ReadonlySet<string> = new Set(["marketValue", "unrealizedPnl", "tradeValue", "pnl"]);
|
|
114
|
+
|
|
115
|
+
/** `columns` with the portfolio's currency in the header of each column in it: Mkt Val (CAD) beside a USD Last. */
|
|
116
|
+
function withBookCurrency(columns: HeadlessPaneColumn[], currency: string): HeadlessPaneColumn[] {
|
|
117
|
+
return columns.map((column) => BOOK_CURRENCY_KEYS.has(column.key) ? { ...column, header: `${column.header} (${currency})` } : column);
|
|
118
|
+
}
|
|
119
|
+
|
|
110
120
|
/** The weight of a book that holds a short: a share of its gross exposure. */
|
|
111
121
|
const GROSS_WEIGHT_DESCRIPTION = "Percent of gross exposure, longs plus shorts at their absolute value, as the book holds a short; negative for a short, cash and unpriced holdings left out.";
|
|
112
122
|
|
|
@@ -209,7 +219,7 @@ function resolveTarget(rawArgument: string, ctx: HeadlessPaneContext): Collectio
|
|
|
209
219
|
if (watchlist) return { kind: "watchlist", id: watchlist.id, name: watchlist.name };
|
|
210
220
|
throw new Error("No portfolios or watchlists are set up.");
|
|
211
221
|
}
|
|
212
|
-
const match = findCollection(config, raw);
|
|
222
|
+
const match = findCollection(config, raw, { prefix: true });
|
|
213
223
|
if (match) return match;
|
|
214
224
|
const collections = [...config.portfolios, ...config.watchlists];
|
|
215
225
|
throw new Error(
|
|
@@ -320,6 +330,7 @@ async function portfolioHoldings(
|
|
|
320
330
|
basis,
|
|
321
331
|
futures,
|
|
322
332
|
purchaseDateFx,
|
|
333
|
+
previousRate: toBase.previousRate,
|
|
323
334
|
});
|
|
324
335
|
const { allocation, cash } = await valuePortfolioAllocation({ valuation, portfolio: resolved.portfolio, account: resolved.account, toBase });
|
|
325
336
|
ctx.signal.throwIfAborted();
|
|
@@ -408,7 +419,7 @@ async function portfolioHoldings(
|
|
|
408
419
|
const notices = [
|
|
409
420
|
...(imported ? [imported] : []),
|
|
410
421
|
// At the close, Mkt Val is Last times the shares; the day's move from the close before gets its own line.
|
|
411
|
-
...(basis === "regular-close" ? [dayMoveLine(dayMove, currency)] : []),
|
|
422
|
+
...(basis === "regular-close" ? [dayMoveLine(dayMove, currency, undefined, undefined, { cashExcluded: !!allocation.cash })] : []),
|
|
412
423
|
...(held.length > 0 ? [exposureLine(valuation.exposure, currency)] : []),
|
|
413
424
|
...[weightBasisLine(allocation, currency)].filter((line): line is string => !!line),
|
|
414
425
|
...(rows.length > limit
|
|
@@ -423,7 +434,7 @@ async function portfolioHoldings(
|
|
|
423
434
|
? POSITION_COLUMNS.map((column) => column.key === "weight" ? { ...column, description: GROSS_WEIGHT_DESCRIPTION } : column)
|
|
424
435
|
: POSITION_COLUMNS;
|
|
425
436
|
const columns = withListingLabels(
|
|
426
|
-
withExtendedColumns([...positionColumns, ...(showTargets ? TARGET_COLUMNS : []), VALUATION_TIME_COLUMN], extendedSessions),
|
|
437
|
+
withExtendedColumns(withBookCurrency([...positionColumns, ...(showTargets ? TARGET_COLUMNS : []), VALUATION_TIME_COLUMN], currency), extendedSessions),
|
|
427
438
|
tickers,
|
|
428
439
|
);
|
|
429
440
|
const lotted = withPositionLines(shown, columns, allocationBySymbol);
|
|
@@ -434,7 +445,7 @@ async function portfolioHoldings(
|
|
|
434
445
|
source: broker ? "Your broker account and Gloom Cloud" : "Local portfolio and Gloom Cloud",
|
|
435
446
|
observedKey: "valuationAsOf",
|
|
436
447
|
citeOldest: true,
|
|
437
|
-
note: `priced at ${
|
|
448
|
+
note: `priced at ${valuationBasisText(basis, holdsFutures(valuation), marketsStillTrading(valuation))}`,
|
|
438
449
|
},
|
|
439
450
|
columns,
|
|
440
451
|
rows: shown,
|
|
@@ -458,7 +469,8 @@ async function portfolioHoldings(
|
|
|
458
469
|
cash: allocation.cash ? finite(allocation.cash.value) : null,
|
|
459
470
|
total: allocation.total,
|
|
460
471
|
// At the regular close, the holdings' move from the close before.
|
|
461
|
-
...(basis === "regular-close" ? { dayChange: dayMove?.change ?? null, dayChangePercent: dayMove?.changePercent ?? null, dayChangeBasis: dayMove?.basis ?? null
|
|
472
|
+
...(basis === "regular-close" ? { dayChange: dayMove?.change ?? null, dayChangePercent: dayMove?.changePercent ?? null, dayChangeBasis: dayMove?.basis ?? null,
|
|
473
|
+
dayChangeFx: dayMove?.fx ?? null } : {}),
|
|
462
474
|
},
|
|
463
475
|
// Only on a book that holds a short: its weights are shares of `weightBase`, its gross exposure, not of the total.
|
|
464
476
|
...(allocation.weightBasis === "gross" ? { weightBasis: allocation.weightBasis, weightBase: allocation.weightBase } : {}),
|
|
@@ -549,7 +561,7 @@ async function portfolioPeriodHoldings(
|
|
|
549
561
|
status: "not-a-feed",
|
|
550
562
|
basis: `daily closes, ${window.from} to ${window.to}`,
|
|
551
563
|
},
|
|
552
|
-
columns: withListingLabels(PERIOD_COLUMNS, tickers),
|
|
564
|
+
columns: withListingLabels(withBookCurrency(PERIOD_COLUMNS, currency), tickers),
|
|
553
565
|
rows,
|
|
554
566
|
complete: errors.length === 0,
|
|
555
567
|
...(errors.length ? { errors } : {}),
|
|
@@ -683,8 +695,17 @@ export const collectionHoldingsHeadless: HeadlessPaneDefinition<"rows"> = {
|
|
|
683
695
|
if (args.options.close === true) throw new Error("--from values each position at its closes already; leave out --close.");
|
|
684
696
|
return portfolioPeriodHoldings(target, limit, ctx, window);
|
|
685
697
|
}
|
|
686
|
-
|
|
698
|
+
const result = await (target.kind === "portfolio"
|
|
687
699
|
? portfolioHoldings(target, limit, ctx, args.options.close === true ? "regular-close" : "latest-print")
|
|
688
|
-
: watchlistHoldings(target, limit, ctx);
|
|
700
|
+
: watchlistHoldings(target, limit, ctx));
|
|
701
|
+
if (args.rawArgument.trim() || result.rows.length > 0) return result;
|
|
702
|
+
// Left out, PF reads the first collection; an empty one says which it was and how to name another.
|
|
703
|
+
return { ...result, empty: emptyDefaultText(target, ctx) };
|
|
689
704
|
},
|
|
690
705
|
};
|
|
706
|
+
|
|
707
|
+
/** `The first portfolio, Main, holds nothing. Name one: gloom fn PF <portfolio or watchlist>, such as Plan (plan).` */
|
|
708
|
+
function emptyDefaultText(target: CollectionMatch, ctx: HeadlessPaneContext): string {
|
|
709
|
+
const others = [...ctx.config.portfolios, ...ctx.config.watchlists].filter((collection) => collection.id !== target.id);
|
|
710
|
+
return `The first ${target.kind}, ${target.name}, holds nothing. Name one: gloom fn PF <portfolio or watchlist>${others.length ? `, such as ${describeCollections(others)}` : ""}.`;
|
|
711
|
+
}
|
|
@@ -6,14 +6,19 @@ import { isNetworkFailure } from "../../../utils/network-failure";
|
|
|
6
6
|
import { regularSessionValuationPrice } from "../../../market-data/quotes/regular-session-valuation";
|
|
7
7
|
import { resolveTickerInstrumentKind } from "../../../tickers/instrument-kind";
|
|
8
8
|
import { mapWithConcurrency } from "../../../utils/concurrency";
|
|
9
|
+
import { MARKET_REQUEST_TIMEOUT_MS } from "../../../api-client/request";
|
|
9
10
|
import type { DataProvider } from "../../../types/data-provider";
|
|
10
11
|
import type { Quote } from "../../../types/financials";
|
|
11
12
|
import type { TickerRecord } from "../../../types/ticker";
|
|
12
13
|
|
|
13
14
|
/** Dividend reads `portfolio show` makes at once. */
|
|
14
15
|
const DIVIDEND_CONCURRENCY = 8;
|
|
15
|
-
/**
|
|
16
|
-
|
|
16
|
+
/**
|
|
17
|
+
* How long `portfolio show` waits for every holding's dividends together
|
|
18
|
+
* before it prints without the rest: the time a price read gets, as a cold
|
|
19
|
+
* read of a fund's distributions (TLT's) takes longer than a quote.
|
|
20
|
+
*/
|
|
21
|
+
export const DIVIDEND_READ_DEADLINE_MS = MARKET_REQUEST_TIMEOUT_MS;
|
|
17
22
|
/** How far `--drip` projects, in whole years. */
|
|
18
23
|
export const DRIP_MAX_YEARS = 5;
|
|
19
24
|
export const DRIP_DEFAULT_YEARS = 5;
|
|
@@ -229,11 +234,13 @@ const UNREAD_WORDS: Record<"timed-out" | "sign-in" | "offline" | "failed", (seco
|
|
|
229
234
|
/**
|
|
230
235
|
* The one line `portfolio show` says about income it cannot show, naming
|
|
231
236
|
* each cause and its holdings: no dividend history, no exchange rate, or
|
|
232
|
-
* dividends not read.
|
|
237
|
+
* dividends not read. With some holdings' income known, TOTAL adds those up
|
|
238
|
+
* and the line names the holdings it leaves out. Null when every holding's
|
|
239
|
+
* income is known.
|
|
233
240
|
*/
|
|
234
241
|
export function incomeGapNote(
|
|
235
242
|
income: PortfolioIncome,
|
|
236
|
-
{ name,
|
|
243
|
+
{ name, deadlineMs = DIVIDEND_READ_DEADLINE_MS }: { name: (symbols: string[]) => string; deadlineMs?: number },
|
|
237
244
|
): string | null {
|
|
238
245
|
if (income.gaps.size === 0) return null;
|
|
239
246
|
const groups = new Map<string, string[]>();
|
|
@@ -243,10 +250,12 @@ export function incomeGapNote(
|
|
|
243
250
|
: UNREAD_WORDS[gap.why](Number((deadlineMs / 1000).toFixed(2)));
|
|
244
251
|
groups.set(key, [...(groups.get(key) ?? []), symbol]);
|
|
245
252
|
}
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
253
|
+
if (income.knownHoldings === 0) {
|
|
254
|
+
const causes = [...groups].map(([cause, symbols]) => `${cause} for ${name(symbols)}`).join("; ");
|
|
255
|
+
return `Income ${showsIncomeColumns(income) ? "unavailable" : "not shown"}: ${causes}.`;
|
|
256
|
+
}
|
|
257
|
+
const left = [...groups].map(([cause, symbols]) => `${name(symbols)} (${cause})`).join("; ");
|
|
258
|
+
return `TOTAL income and yield leave out ${left}.`;
|
|
250
259
|
}
|
|
251
260
|
|
|
252
261
|
/** `--years`: a whole number of years from 1 to DRIP_MAX_YEARS. */
|
|
@@ -30,7 +30,7 @@ function resolveCollectionIdForKind(context: PaneTemplateContext, kind: "portfol
|
|
|
30
30
|
|
|
31
31
|
/** `PF Nope`: no portfolio or watchlist has that name or id, so the bar names those that do. */
|
|
32
32
|
function unknownCollectionArg(arg: string, context: PaneTemplateContext): ShortcutArgError | null {
|
|
33
|
-
return unknownCollectionArgError(arg, [...context.config.portfolios, ...context.config.watchlists], "portfolio or watchlist");
|
|
33
|
+
return unknownCollectionArgError(arg, [...context.config.portfolios, ...context.config.watchlists], "portfolio or watchlist", undefined, { prefix: true });
|
|
34
34
|
}
|
|
35
35
|
|
|
36
36
|
function createCollectionPaneInstance(
|
|
@@ -38,8 +38,8 @@ function createCollectionPaneInstance(
|
|
|
38
38
|
kind?: "portfolio" | "watchlist",
|
|
39
39
|
argument?: string,
|
|
40
40
|
): PaneTemplateInstanceConfig | null {
|
|
41
|
-
// `PF Retirement` (or `shot PF Retirement`) opens the collection it names.
|
|
42
|
-
const named = argument?.trim() ? findCollection(context.config, argument) : null;
|
|
41
|
+
// `PF Retirement` (or `shot PF Retirement`) opens the collection it names, or the one whose name starts so (`PF ret`).
|
|
42
|
+
const named = argument?.trim() ? findCollection(context.config, argument, { prefix: true }) : null;
|
|
43
43
|
const collectionId = named && (!kind || named.kind === kind)
|
|
44
44
|
? named.id
|
|
45
45
|
: kind ? resolveCollectionIdForKind(context, kind) : resolveCollectionPaneId(context);
|
|
@@ -96,7 +96,7 @@ export const portfolioListModule: PluginModule = {
|
|
|
96
96
|
"portfolio", "watchlist", "collection", "pane", "list",
|
|
97
97
|
"portfolio rebalance", "allocation drift", "target weights", "asset allocation", "cash balance",
|
|
98
98
|
],
|
|
99
|
-
// The argument is the report's: `PF Book` opens Book, by name or id in any case.
|
|
99
|
+
// The argument is the report's: `PF Book` opens Book, by name or id in any case, or the start of one name.
|
|
100
100
|
shortcut: { prefix: "PF", argError: unknownCollectionArg },
|
|
101
101
|
headless: collectionHoldingsHeadless,
|
|
102
102
|
canCreate: (context) => resolveCollectionPaneId(context) !== null,
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import { useEffect, useState } from "react";
|
|
2
|
+
import { fxQuoteRateMove, readFxQuoteRate } from "../../../../cli/fx-quote-rate";
|
|
3
|
+
import { heldCurrencyUnit } from "../../../../utils/currency-units";
|
|
4
|
+
import { logFailure } from "../../../../utils/log-failure";
|
|
5
|
+
import { useAssetData } from "../../../runtime";
|
|
6
|
+
|
|
7
|
+
/** How often the pairs' moves are read again; the move a book's day holds drifts with the FX market. */
|
|
8
|
+
const FX_DAY_MOVE_REFRESH_MS = 5 * 60_000;
|
|
9
|
+
|
|
10
|
+
const NO_MOVES: ReadonlyMap<string, number> = new Map();
|
|
11
|
+
|
|
12
|
+
/**
|
|
13
|
+
* Each currency's move on the day against the book's, as a factor (1.001 for
|
|
14
|
+
* +0.1%), read as `fx` reads a pair's from its previous daily close, so the
|
|
15
|
+
* pane's Day's move holds a foreign holding's currency move as `portfolio
|
|
16
|
+
* show` does (`calculatePortfolioSummaryTotals`). A currency whose pair has no
|
|
17
|
+
* close to read against is left out, and moves with its price alone.
|
|
18
|
+
*/
|
|
19
|
+
export function useFxDayMoves(currencies: readonly string[], totalsCurrency: string): ReadonlyMap<string, number> {
|
|
20
|
+
const dataProvider = useAssetData();
|
|
21
|
+
const [moves, setMoves] = useState<ReadonlyMap<string, number>>(NO_MOVES);
|
|
22
|
+
const key = [...new Set(currencies.filter((currency) => heldCurrencyUnit(currency).currency !== heldCurrencyUnit(totalsCurrency).currency))]
|
|
23
|
+
.sort().join(",");
|
|
24
|
+
useEffect(() => {
|
|
25
|
+
const getQuotesBatch = dataProvider?.getQuotesBatch?.bind(dataProvider);
|
|
26
|
+
if (!getQuotesBatch || !key) {
|
|
27
|
+
setMoves(NO_MOVES);
|
|
28
|
+
return;
|
|
29
|
+
}
|
|
30
|
+
let cancelled = false;
|
|
31
|
+
const read = async () => {
|
|
32
|
+
const into = heldCurrencyUnit(totalsCurrency).currency;
|
|
33
|
+
const read = await Promise.all(key.split(",").map(async (currency) => {
|
|
34
|
+
const rate = await readFxQuoteRate(heldCurrencyUnit(currency).currency, into, getQuotesBatch)
|
|
35
|
+
.catch(logFailure("portfolio-list.fx-day-moves", "Could not read the FX move on the day", null));
|
|
36
|
+
const move = rate && "rate" in rate ? fxQuoteRateMove(rate) : null;
|
|
37
|
+
return move ? [[currency, 1 + move.percent / 100] as const] : [];
|
|
38
|
+
}));
|
|
39
|
+
if (!cancelled) setMoves(new Map(read.flat()));
|
|
40
|
+
};
|
|
41
|
+
const refresh = () => {
|
|
42
|
+
read().catch(logFailure("portfolio-list.fx-day-moves", "Could not read the FX moves on the day"));
|
|
43
|
+
};
|
|
44
|
+
refresh();
|
|
45
|
+
const timer = setInterval(refresh, FX_DAY_MOVE_REFRESH_MS);
|
|
46
|
+
return () => {
|
|
47
|
+
cancelled = true;
|
|
48
|
+
clearInterval(timer);
|
|
49
|
+
};
|
|
50
|
+
}, [dataProvider, key, totalsCurrency]);
|
|
51
|
+
return moves;
|
|
52
|
+
}
|