gloomberb 0.20.1 → 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/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/data.ts +3 -2
- package/src/api-client/earnings.ts +46 -3
- 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 +3 -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.tsx +7 -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/commands/market.ts +266 -75
- package/src/cli/commands/ticker.ts +12 -7
- package/src/cli/desktop-pane-shot-browser.ts +47 -31
- package/src/cli/desktop-pane-shot.ts +15 -0
- package/src/cli/entry.ts +5 -0
- 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 +5 -0
- 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/pane-functions/catalog.ts +12 -2
- package/src/cli/pane-functions/dom.ts +4 -2
- package/src/cli/pane-functions/headless.ts +8 -5
- package/src/cli/pane-functions/index.ts +3 -0
- 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/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/command-bar/assist/inventory.ts +3 -2
- package/src/components/command-bar/commands/collection-list.ts +3 -2
- package/src/components/command-bar/panel/layout.ts +8 -1
- package/src/components/command-bar/panel/prompt-width.ts +34 -0
- package/src/components/command-bar/panel/state.ts +4 -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 +25 -6
- package/src/i18n/ja.ts +25 -5
- package/src/i18n/ko.ts +25 -5
- package/src/i18n/zh-cn.ts +25 -5
- package/src/i18n/zh-tw.ts +25 -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/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 +72 -14
- package/src/market-data/market/format.ts +19 -11
- 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/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/index.tsx +39 -167
- package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
- package/src/plugins/builtin/correlation/relationship/pane.tsx +6 -7
- 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/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 +73 -17
- 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/pane.tsx +5 -3
- 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/sec/filing-display.tsx +0 -5
- package/src/plugins/builtin/sec/forms.ts +19 -0
- package/src/plugins/builtin/sec/headless.ts +7 -11
- package/src/plugins/builtin/sec/index.tsx +11 -3
- 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/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 +4 -2
- 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/volatility/charts.tsx +2 -2
- package/src/plugins/host-resolver.ts +3 -2
- 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 +1 -0
- package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
- package/src/renderers/electrobun/bun/desktop/host-requests.ts +5 -4
- 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 +3 -1
- 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/window/attention.ts +1 -0
- package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -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-min-size.ts +1 -1
- package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -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/view/app-badge-host.ts +2 -1
- 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-mutations.ts +36 -0
- package/src/renderers/electrobun/view/http-fetch.ts +2 -1
- package/src/renderers/electrobun/view/main.tsx +9 -4
- 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 +2 -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/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/markdown.ts +4 -2
- package/src/utils/pasted-lines.ts +14 -0
- package/src/utils/price-window.ts +2 -1
- package/src/utils/sec-filings.ts +17 -0
- package/src/utils/sec.ts +4 -23
- package/src/utils/shortcut-labels.ts +6 -30
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import { ADR_PAIR_TAB_ID } from "./adr-pair/model";
|
|
2
|
+
|
|
3
|
+
/** What the grouping reads of a research tab. */
|
|
4
|
+
export interface TickerResearchTabSummary {
|
|
5
|
+
id: string;
|
|
6
|
+
name: string;
|
|
7
|
+
order: number;
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
interface TickerResearchGroupDef {
|
|
11
|
+
id: string;
|
|
12
|
+
name: string;
|
|
13
|
+
/** Research tab ids, in the order the group offers them. */
|
|
14
|
+
views: readonly string[];
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* Ticker Research's top strip, in order. Each group offers its views as
|
|
19
|
+
* choices under the strip; a view is still known by its own tab id everywhere
|
|
20
|
+
* else (saved layouts, a locked pane, `?tab=`, `--tab`, links between tabs,
|
|
21
|
+
* the views people stay on), so the grouping is only how the strip reads.
|
|
22
|
+
*
|
|
23
|
+
* Trade is Chart with the ticket beside it, and closing the ticket goes back
|
|
24
|
+
* to Chart (`ResearchTradeWorkspace`), so it is Chart's second view. ADR vs
|
|
25
|
+
* Home, the receipt's price against its home line, is the last of
|
|
26
|
+
* Financials. Both show only for some tickers, so each comes after the views
|
|
27
|
+
* every ticker has. A plugin's own tab is in no group: it gets its own top
|
|
28
|
+
* tab after these (`groupTickerResearchTabs`).
|
|
29
|
+
*/
|
|
30
|
+
const TICKER_RESEARCH_GROUPS: readonly TickerResearchGroupDef[] = [
|
|
31
|
+
{ id: "overview", name: "Overview", views: ["overview"] },
|
|
32
|
+
{ id: "chart", name: "Chart", views: ["chart", "broker-trade"] },
|
|
33
|
+
{ id: "financials", name: "Financials", views: ["financials", "revenue", "equity-diagnostic", "dividend-yield", ADR_PAIR_TAB_ID] },
|
|
34
|
+
{ id: "analysts", name: "Analysts", views: ["analyst-research", "earnings-calls"] },
|
|
35
|
+
{ id: "options", name: "Options", views: ["options"] },
|
|
36
|
+
{ id: "events", name: "Events", views: ["corporate-actions", "catalysts", "mna"] },
|
|
37
|
+
{ id: "filings", name: "Filings", views: ["sec", "filing-events", "risk-factors"] },
|
|
38
|
+
{ id: "ownership", name: "Ownership", views: ["holders", "insider", "thirteenf", "congress", "short-interest"] },
|
|
39
|
+
{ id: "people", name: "People", views: ["executives", "jobs", "hiring-momentum"] },
|
|
40
|
+
{ id: "buzz", name: "Buzz", views: ["news", "ticker-tweets", "app-attention"] },
|
|
41
|
+
{ id: "notes", name: "Notes", views: ["thesis", "notes"] },
|
|
42
|
+
];
|
|
43
|
+
|
|
44
|
+
/** One top tab: a group with the views this ticker has, or a view of its own. */
|
|
45
|
+
export interface TickerResearchTabGroup {
|
|
46
|
+
id: string;
|
|
47
|
+
name: string;
|
|
48
|
+
/** At least one; with more, the group shows them as choices. */
|
|
49
|
+
views: TickerResearchTabSummary[];
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/** A plugin's tab id, kept apart from the group ids. */
|
|
53
|
+
const OWN_GROUP_PREFIX = "tab:";
|
|
54
|
+
|
|
55
|
+
/**
|
|
56
|
+
* The top tabs for the views a ticker has (`buildVisibleTickerResearchTabs`):
|
|
57
|
+
* a group with none of them is left out, and a plugin's tab that belongs to
|
|
58
|
+
* no group is a top tab of its own after the built-in ones, by its `order`.
|
|
59
|
+
*/
|
|
60
|
+
export function groupTickerResearchTabs(tabs: readonly TickerResearchTabSummary[]): TickerResearchTabGroup[] {
|
|
61
|
+
const byId = new Map(tabs.map((tab) => [tab.id, tab]));
|
|
62
|
+
const grouped = new Set<string>();
|
|
63
|
+
const groups: TickerResearchTabGroup[] = [];
|
|
64
|
+
for (const group of TICKER_RESEARCH_GROUPS) {
|
|
65
|
+
const views = group.views.flatMap((id) => byId.get(id) ?? []);
|
|
66
|
+
for (const view of views) grouped.add(view.id);
|
|
67
|
+
if (views.length > 0) groups.push({ id: group.id, name: group.name, views });
|
|
68
|
+
}
|
|
69
|
+
const own = tabs.filter((tab) => !grouped.has(tab.id)).sort((left, right) => left.order - right.order);
|
|
70
|
+
for (const tab of own) groups.push({ id: `${OWN_GROUP_PREFIX}${tab.id}`, name: tab.name, views: [tab] });
|
|
71
|
+
return groups;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/** The group a view is shown in. */
|
|
75
|
+
export function findTickerResearchGroup(groups: readonly TickerResearchTabGroup[], viewId: string): TickerResearchTabGroup | undefined {
|
|
76
|
+
return groups.find((group) => group.views.some((view) => view.id === viewId));
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* Views a group never reopens on. Trade is the order ticket, opened on
|
|
81
|
+
* purpose (`b`/`s`, Overview's order links, choosing it), so coming back to
|
|
82
|
+
* Chart shows the chart.
|
|
83
|
+
*/
|
|
84
|
+
const NOT_REOPENED = new Set(["broker-trade"]);
|
|
85
|
+
|
|
86
|
+
/** The view a group opens on: the one last chosen in it while it is there, else its first. */
|
|
87
|
+
export function tickerResearchGroupView(group: TickerResearchTabGroup, remembered: string | undefined): string {
|
|
88
|
+
return remembered && !NOT_REOPENED.has(remembered) && group.views.some((view) => view.id === remembered) ? remembered : group.views[0]!.id;
|
|
89
|
+
}
|
|
@@ -6,8 +6,7 @@ import type { PriceSparklinePeriod } from "../../../components/price-sparkline/v
|
|
|
6
6
|
import { getSharedRegistry } from "../../registry";
|
|
7
7
|
import { formatTickerListInput, MAX_TICKER_LIST_SIZE, parseTickerListInput } from "../../../tickers/list";
|
|
8
8
|
import { resolveTickerInstrumentKind } from "../../../tickers/instrument-kind";
|
|
9
|
-
|
|
10
|
-
type TickerResearchTabSummary = { id: string; name: string; order: number };
|
|
9
|
+
import { groupTickerResearchTabs, type TickerResearchTabSummary } from "./research-groups";
|
|
11
10
|
|
|
12
11
|
export interface TickerResearchPaneSettings {
|
|
13
12
|
hideTabs: boolean;
|
|
@@ -49,9 +48,11 @@ function getAvailableSettingsTabs(): TickerResearchTabSummary[] {
|
|
|
49
48
|
? [...registry.tickerResearchTabs.values()].map((tab) => ({ id: tab.id, name: tab.name, order: tab.order }))
|
|
50
49
|
: [];
|
|
51
50
|
|
|
52
|
-
|
|
51
|
+
const tabs = pluginTabs
|
|
53
52
|
.sort((left, right) => left.order - right.order)
|
|
54
53
|
.filter((tab, index, allTabs) => allTabs.findIndex((candidate) => candidate.id === tab.id) === index);
|
|
54
|
+
// In the order the strip shows them: group by group.
|
|
55
|
+
return groupTickerResearchTabs(tabs).flatMap((group) => group.views);
|
|
55
56
|
}
|
|
56
57
|
|
|
57
58
|
export function buildTickerResearchSettingsDef(settings: TickerResearchPaneSettings): PaneSettingsDef {
|
|
@@ -25,8 +25,8 @@ export function VolatilityHistoryChart({ term, width, height, focused = false }:
|
|
|
25
25
|
}
|
|
26
26
|
return <CompositeChart series={series} legendSeries={legendSeries} panels={HISTORY_PANELS} width={width} height={height}
|
|
27
27
|
focused={focused} navigable={false} showLegend showTimeAxis remoteKind="vix-history"
|
|
28
|
-
formatValue={(value, entry) => entry.unitGroup === "ratio" ? value.toFixed(2) : formatCompositeSeriesValue(value, entry)}
|
|
29
|
-
formatAxisValue={(value, domain) => domain.unitGroup === "ratio" ? value.toFixed(2) : value.toFixed(0)}
|
|
28
|
+
formatValue={(value, entry) => entry.unitGroup === "ratio" ? `${value.toFixed(2)}x` : formatCompositeSeriesValue(value, entry)}
|
|
29
|
+
formatAxisValue={(value, domain) => domain.unitGroup === "ratio" ? `${value.toFixed(2)}x` : value.toFixed(0)}
|
|
30
30
|
colors={{ background: palette.bgColor, grid: palette.gridColor, crosshair: palette.crosshairColor, text: colors.text,
|
|
31
31
|
textDim: palette.axisColor, negative: colors.negative }} />;
|
|
32
32
|
}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { PLUGIN_HOST_RESOLVER_IMPORTERS } from "./host-modules";
|
|
2
|
+
import { jsxDevFromJsx } from "../react/jsx-dev-fallback";
|
|
2
3
|
|
|
3
4
|
/**
|
|
4
5
|
* Serves `gloomberb/*` and `react` to external plugins from inside the
|
|
@@ -28,7 +29,7 @@ const JSX_RUNTIME = "react/jsx-runtime";
|
|
|
28
29
|
|
|
29
30
|
let installed = false;
|
|
30
31
|
|
|
31
|
-
type JsxFactory =
|
|
32
|
+
type JsxFactory = Parameters<typeof jsxDevFromJsx>[0];
|
|
32
33
|
|
|
33
34
|
/**
|
|
34
35
|
* A packaged host is built with `--production`, so its React is the
|
|
@@ -42,7 +43,7 @@ async function jsxDevRuntimeExports(): Promise<Record<string, unknown>> {
|
|
|
42
43
|
const dev = { ...(await PLUGIN_HOST_RESOLVER_IMPORTERS[JSX_DEV_RUNTIME]!()) } as Record<string, unknown>;
|
|
43
44
|
if (typeof dev.jsxDEV === "function") return dev;
|
|
44
45
|
const prod = (await PLUGIN_HOST_RESOLVER_IMPORTERS[JSX_RUNTIME]!()) as { jsx: JsxFactory };
|
|
45
|
-
return { ...dev, jsxDEV: (
|
|
46
|
+
return { ...dev, jsxDEV: jsxDevFromJsx(prod.jsx) };
|
|
46
47
|
}
|
|
47
48
|
|
|
48
49
|
/** True when this process can register runtime resolvers. */
|
|
@@ -6,6 +6,7 @@ import type { ColumnConfig } from "../types/config";
|
|
|
6
6
|
import type { AnalystResearchData, CorporateActionsData, MarketState, Quote, TickerFinancials } from "../types/financials";
|
|
7
7
|
import type { EarningsEvent } from "../types/data-provider";
|
|
8
8
|
import type { TickerRecord } from "../types/ticker";
|
|
9
|
+
import type { PeriodPnlRow } from "./period-pnl";
|
|
9
10
|
import { colors, priceColor, shownPriceColor } from "../theme/colors";
|
|
10
11
|
import { formatQuoteAgeWithSource, resolveQuoteAgeTimestamp } from "../market-data/quotes/time";
|
|
11
12
|
import { delistingStateLabel } from "../market-data/quotes/delisting";
|
|
@@ -36,6 +37,7 @@ import { formatOptionTicker } from "../utils/options";
|
|
|
36
37
|
import { distributionHistory, forwardYieldMayHaveLapsed, lapsedDividend } from "../utils/forward-dividend";
|
|
37
38
|
import { classifyInstrumentType } from "../tickers/instrument-kind";
|
|
38
39
|
import { isIndexLevel, reportedQuoteVolume } from "../market-data/market/index-level";
|
|
40
|
+
import { futuresQuoteFromSettle } from "../market-data/market/change-basis";
|
|
39
41
|
import { perpetualDisplaySymbol, perpetualListing } from "../tickers/perpetual-listing";
|
|
40
42
|
import { premiumToUnderlying, type PerpetualPremiumRow } from "../market-data/perpetual-premium";
|
|
41
43
|
import { currentListingName } from "../tickers/listing-name";
|
|
@@ -115,6 +117,31 @@ export interface ColumnContext {
|
|
|
115
117
|
futuresTerms?: ReadonlyMap<string, PortfolioFuturesTerms>;
|
|
116
118
|
/** Moves whenever `futuresTerms` does. */
|
|
117
119
|
futuresTermsVersion?: number;
|
|
120
|
+
/**
|
|
121
|
+
* P&L over a period instead of since cost (the pane's P&L From): P&L shows
|
|
122
|
+
* each row's P&L between the two closes and P&L% its contribution to the
|
|
123
|
+
* book. Rows are missing while the closes load (`pending`). `fx` is the
|
|
124
|
+
* currencies' move on the start values, the line under the rows that makes
|
|
125
|
+
* them add up to the header's total.
|
|
126
|
+
*/
|
|
127
|
+
periodPnl?: { rows: ReadonlyMap<string, PeriodPnlRow>; pending: boolean; fx?: { currencies: string; pnl: number; contribution: number | null } | null };
|
|
128
|
+
/** Moves whenever `periodPnl` does. */
|
|
129
|
+
periodPnlVersion?: number;
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/** A row's P&L or contribution over the pane's period: `…` while the closes load, `—` without both. */
|
|
133
|
+
function periodPnlCell(period: NonNullable<ColumnContext["periodPnl"]>, symbol: string, field: "pnl" | "contribution"): { text: string; color?: string } {
|
|
134
|
+
const row = period.rows.get(symbol);
|
|
135
|
+
if (!row) return { text: period.pending ? "…" : "—" };
|
|
136
|
+
return periodPnlFigure(row[field], field);
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/** A period's P&L (`pnl`) or contribution figure as the P&L and P&L% cells show it, the FX line's included. */
|
|
140
|
+
export function periodPnlFigure(value: number | null | undefined, field: "pnl" | "contribution"): { text: string; color?: string; value?: number } {
|
|
141
|
+
if (value == null || !Number.isFinite(value)) return { text: "—" };
|
|
142
|
+
return field === "pnl"
|
|
143
|
+
? { text: formatCompactAmount(value, { signed: true }), color: priceColor(value), value }
|
|
144
|
+
: { text: formatPercentRaw(value), color: shownPriceColor(value, 2), value };
|
|
118
145
|
}
|
|
119
146
|
|
|
120
147
|
/** A row's stock perpetual as PERP% and FUND 8H read it; rates are fractions. */
|
|
@@ -477,13 +504,15 @@ export function getColumnValue(
|
|
|
477
504
|
financials: TickerFinancials | undefined,
|
|
478
505
|
ctx: ColumnContext,
|
|
479
506
|
): { text: string; color?: string; value?: number | null; pnlBasis?: PortfolioPositionPnl["basis"] } {
|
|
480
|
-
const
|
|
507
|
+
const sent = financials?.quote;
|
|
481
508
|
|
|
482
509
|
const fundamentals = financials?.fundamentals;
|
|
483
|
-
const quoteCurrency =
|
|
510
|
+
const quoteCurrency = sent?.currency || ticker.metadata.currency || "USD";
|
|
484
511
|
|
|
485
|
-
const { position: positionMetrics, base: baseMetrics } = rowPositionMetrics(ticker, ctx, quoteCurrency,
|
|
512
|
+
const { position: positionMetrics, base: baseMetrics } = rowPositionMetrics(ticker, ctx, quoteCurrency, sent);
|
|
486
513
|
const futures = positionMetrics.isFuture ? ctx.futuresTerms?.get(ticker.metadata.ticker) : undefined;
|
|
514
|
+
// A future's move as FUT and `quote` measure it with its terms.
|
|
515
|
+
const quote = futuresQuoteFromSettle(sent, futures);
|
|
487
516
|
// The latest print, which the quote columns read, and the price the position is valued at.
|
|
488
517
|
const liveQuote = getPortfolioQuoteDisplay(positionMetrics, quote);
|
|
489
518
|
const activeQuote = getPortfolioValuationDisplay(positionMetrics, quote, ctx.valuationBasis, futures?.settlement);
|
|
@@ -662,11 +691,13 @@ export function getColumnValue(
|
|
|
662
691
|
}
|
|
663
692
|
return { text: "—" };
|
|
664
693
|
case "pnl": {
|
|
694
|
+
if (ctx.periodPnl) return periodPnlCell(ctx.periodPnl, ticker.metadata.ticker, "pnl");
|
|
665
695
|
const pnl = positionPnl.value;
|
|
666
696
|
return pnl === null ? { text: "—", pnlBasis: positionPnl.basis }
|
|
667
697
|
: { text: formatCompactAmount(pnl, { signed: true }), color: priceColor(pnl), pnlBasis: positionPnl.basis };
|
|
668
698
|
}
|
|
669
699
|
case "pnl_pct": {
|
|
700
|
+
if (ctx.periodPnl) return periodPnlCell(ctx.periodPnl, ticker.metadata.ticker, "contribution");
|
|
670
701
|
const percent = portfolioPnlPercent(positionPnl.value, baseMetrics.totalCost);
|
|
671
702
|
return percent === null ? { text: "—" } : { text: formatPercentRaw(percent), color: shownPriceColor(percent, 2) };
|
|
672
703
|
}
|
|
@@ -750,13 +781,15 @@ export function getSortValue(
|
|
|
750
781
|
financials: TickerFinancials | undefined,
|
|
751
782
|
ctx: ColumnContext,
|
|
752
783
|
): number | string | null {
|
|
753
|
-
const
|
|
784
|
+
const sent = financials?.quote;
|
|
754
785
|
|
|
755
786
|
const fundamentals = financials?.fundamentals;
|
|
756
|
-
const quoteCurrency =
|
|
787
|
+
const quoteCurrency = sent?.currency || ticker.metadata.currency || "USD";
|
|
757
788
|
|
|
758
|
-
const { position: positionMetrics, base: baseMetrics } = rowPositionMetrics(ticker, ctx, quoteCurrency,
|
|
789
|
+
const { position: positionMetrics, base: baseMetrics } = rowPositionMetrics(ticker, ctx, quoteCurrency, sent);
|
|
759
790
|
const futures = positionMetrics.isFuture ? ctx.futuresTerms?.get(ticker.metadata.ticker) : undefined;
|
|
791
|
+
// A future's move as FUT and `quote` measure it with its terms.
|
|
792
|
+
const quote = futuresQuoteFromSettle(sent, futures);
|
|
760
793
|
const liveQuote = getPortfolioQuoteDisplay(positionMetrics, quote);
|
|
761
794
|
const activeQuote = getPortfolioValuationDisplay(positionMetrics, quote, ctx.valuationBasis, futures?.settlement);
|
|
762
795
|
const displayQuote = tradedQuoteDisplay(positionMetrics, liveQuote, quote);
|
|
@@ -860,9 +893,10 @@ export function getSortValue(
|
|
|
860
893
|
}
|
|
861
894
|
return null;
|
|
862
895
|
case "pnl":
|
|
863
|
-
return positionPnl.value;
|
|
896
|
+
return ctx.periodPnl ? ctx.periodPnl.rows.get(ticker.metadata.ticker)?.pnl ?? null : positionPnl.value;
|
|
864
897
|
case "pnl_pct":
|
|
865
|
-
return
|
|
898
|
+
return ctx.periodPnl ? ctx.periodPnl.rows.get(ticker.metadata.ticker)?.contribution ?? null
|
|
899
|
+
: portfolioPnlPercent(positionPnl.value, baseMetrics.totalCost);
|
|
866
900
|
case "mark_delta":
|
|
867
901
|
return liveQuote && brokerMarkPrice != null && liveQuote.price !== 0 && positionMetrics.priceBasis === (quote?.priceBasis ?? "per-unit") && positionCurrency === quoteCurrency
|
|
868
902
|
? ((brokerMarkPrice - liveQuote.price) / Math.abs(liveQuote.price)) * 100
|
|
@@ -42,6 +42,9 @@ export interface PortfolioFuturesTerms {
|
|
|
42
42
|
settlement: FuturesSettlement | null;
|
|
43
43
|
/** A different contract that is currently front, when the terms name one. */
|
|
44
44
|
front?: Pick<NonNullable<FuturesContractTermsPayload["front"]>, "contract" | "contractSymbol">;
|
|
45
|
+
/** The tick and the month the settlement is of, which a move is checked against (futuresQuoteFromSettle), as FUT and `quote` check it. */
|
|
46
|
+
spec?: { tick: number } | null;
|
|
47
|
+
deliveryMonth?: string | null;
|
|
45
48
|
}
|
|
46
49
|
|
|
47
50
|
/** A grain or a soft quotes in US cents, so a dollar point value is a hundred of its price units. */
|
|
@@ -169,7 +172,7 @@ export function previousFuturesSettlement(
|
|
|
169
172
|
|
|
170
173
|
/** What a portfolio reads from a future's terms, with the settlement before the latest when the history has it. */
|
|
171
174
|
export function portfolioFuturesTerms(
|
|
172
|
-
terms: (Pick<FuturesContractTermsPayload, "spec" | "settlement"> & Partial<Pick<FuturesContractTermsPayload, "front" | "contract">>) | null | undefined,
|
|
175
|
+
terms: (Pick<FuturesContractTermsPayload, "spec" | "settlement"> & Partial<Pick<FuturesContractTermsPayload, "front" | "contract" | "deliveryMonth">>) | null | undefined,
|
|
173
176
|
history?: readonly PricePoint[] | null,
|
|
174
177
|
): PortfolioFuturesTerms {
|
|
175
178
|
const settlement = terms?.settlement && Number.isFinite(terms.settlement.price) && terms.settlement.price > 0
|
|
@@ -180,7 +183,12 @@ export function portfolioFuturesTerms(
|
|
|
180
183
|
}
|
|
181
184
|
: null;
|
|
182
185
|
const front = terms?.front && terms.front.contract !== terms.contract ? terms.front : undefined;
|
|
183
|
-
|
|
186
|
+
const tick = terms?.spec?.tick;
|
|
187
|
+
return {
|
|
188
|
+
size: futuresContractSize(terms?.spec), settlement, ...(front ? { front } : {}),
|
|
189
|
+
...(tick != null && Number.isFinite(tick) && tick > 0 ? { spec: { tick } } : {}),
|
|
190
|
+
...(terms?.deliveryMonth ? { deliveryMonth: terms.deliveryMonth } : {}),
|
|
191
|
+
};
|
|
184
192
|
}
|
|
185
193
|
|
|
186
194
|
/**
|
|
@@ -31,7 +31,8 @@ export interface RemoveTickerFromPortfolioResult {
|
|
|
31
31
|
export interface SetManualPortfolioPositionInput {
|
|
32
32
|
/** Signed: a negative number is a short. A future counts contracts. */
|
|
33
33
|
shares: number;
|
|
34
|
-
|
|
34
|
+
/** Null when the cost is not known (a broker export that gives none): the lot is saved without one. */
|
|
35
|
+
avgCost: number | null;
|
|
35
36
|
currency: string;
|
|
36
37
|
/**
|
|
37
38
|
* A future's contract multiplier from its terms (futuresContractSize). Left
|
|
@@ -436,7 +437,7 @@ export function setManualPortfolioPosition(
|
|
|
436
437
|
const nextCurrency = normalizeHeldCurrencyCode(input.currency);
|
|
437
438
|
const sharesError = validatePositionShares(input.shares, positionQuantityLabel(ticker));
|
|
438
439
|
if (sharesError) throw new Error(sharesError);
|
|
439
|
-
if (!Number.isFinite(input.avgCost)) {
|
|
440
|
+
if (input.avgCost !== null && !Number.isFinite(input.avgCost)) {
|
|
440
441
|
throw new Error("Average cost must be a valid number.");
|
|
441
442
|
}
|
|
442
443
|
if (!nextCurrency) {
|
|
@@ -469,7 +470,7 @@ export function setManualPortfolioPosition(
|
|
|
469
470
|
nextPositions.push({
|
|
470
471
|
portfolio: portfolioId,
|
|
471
472
|
shares: input.shares,
|
|
472
|
-
avgCost: input.avgCost,
|
|
473
|
+
...(input.avgCost !== null ? { avgCost: input.avgCost } : {}),
|
|
473
474
|
currency: nextCurrency,
|
|
474
475
|
broker: "manual",
|
|
475
476
|
...(dateAcquired ? { dateAcquired } : {}),
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A book's P&L between two closes, by position: what `portfolio show --from
|
|
3
|
+
* --to` prints and the PF pane's period P&L shows. Each holding is valued at
|
|
4
|
+
* the close before the window starts and at its last close in the window, as
|
|
5
|
+
* RETURN measures a ticker over the same dates, so the two always agree. A
|
|
6
|
+
* future's closes are its settlements, and a contract counts its size. A short
|
|
7
|
+
* gains when the price falls. A holding in another currency earns its price
|
|
8
|
+
* move at the end's FX rate, and the currency's own move on its start value
|
|
9
|
+
* is the separate FX line, so price and currency are never mixed in one figure.
|
|
10
|
+
* A price in a minor unit (pence, US cents) counts in its major currency.
|
|
11
|
+
*/
|
|
12
|
+
import { sameCurrency } from "./position-metrics";
|
|
13
|
+
import { heldCurrencyUnit } from "../utils/currency-units";
|
|
14
|
+
|
|
15
|
+
/** A holding's close on a day: a share's regular close, a future's settlement. */
|
|
16
|
+
export interface PeriodClose {
|
|
17
|
+
/** The session's local date. */
|
|
18
|
+
day: string;
|
|
19
|
+
price: number;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export interface PeriodPnlHolding {
|
|
23
|
+
symbol: string;
|
|
24
|
+
/** Signed price units held: shares, or contracts times their size; negative for a short. */
|
|
25
|
+
priceUnits: number;
|
|
26
|
+
/** The currency the price is quoted in. */
|
|
27
|
+
currency: string;
|
|
28
|
+
/** The close before the window, and the last one in it; null when the history has none. */
|
|
29
|
+
start: PeriodClose | null;
|
|
30
|
+
end: PeriodClose | null;
|
|
31
|
+
/** The end is today's session still trading, not a close. */
|
|
32
|
+
partialEnd?: boolean;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/** One unit of a major currency (GBP, never GBp) in the book's currency on a day; null when no close of the pair could be read. */
|
|
36
|
+
export type PeriodFxRate = (currency: string, day: string) => number | null;
|
|
37
|
+
|
|
38
|
+
export interface PeriodPnlRow {
|
|
39
|
+
symbol: string;
|
|
40
|
+
priceUnits: number;
|
|
41
|
+
currency: string;
|
|
42
|
+
start: PeriodClose | null;
|
|
43
|
+
end: PeriodClose | null;
|
|
44
|
+
partialEnd: boolean;
|
|
45
|
+
/** The price's move over the window, in percent. */
|
|
46
|
+
changePercent: number | null;
|
|
47
|
+
/** The position's value at the start, signed, in the book's currency at the start's rate. */
|
|
48
|
+
startValue: number | null;
|
|
49
|
+
/** The price move times the units held, in the book's currency at the end's rate. */
|
|
50
|
+
pnl: number | null;
|
|
51
|
+
/** The currency's move on the start value; 0 for a holding in the book's currency. */
|
|
52
|
+
fx: number | null;
|
|
53
|
+
/** The start and end rates of a holding in another currency, and the major currency they convert (GBP for a price in pence). */
|
|
54
|
+
rates: { currency: string; start: number; end: number } | null;
|
|
55
|
+
/** The price P&L over the book's start value (`PeriodPnl.contributionBase`), in percent; the FX line carries the currency's. */
|
|
56
|
+
contribution: number | null;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
export interface PeriodPnl {
|
|
60
|
+
rows: PeriodPnlRow[];
|
|
61
|
+
/** The FX line: every holding's currency move, together. */
|
|
62
|
+
fx: number;
|
|
63
|
+
fxContribution: number | null;
|
|
64
|
+
/** Price P&L and FX together, over the holdings that have both closes. */
|
|
65
|
+
total: number;
|
|
66
|
+
totalContribution: number | null;
|
|
67
|
+
/**
|
|
68
|
+
* What contribution divides by: the book's value at the start, as its
|
|
69
|
+
* weights are, net for a long-only book and gross (longs plus shorts at
|
|
70
|
+
* their absolute value) for one that holds a short.
|
|
71
|
+
*/
|
|
72
|
+
contributionBase: number | null;
|
|
73
|
+
contributionBasis: "net" | "gross";
|
|
74
|
+
/** Holdings without a close at one end of the window, or without a rate for their currency. */
|
|
75
|
+
unpriced: string[];
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
const finite = (value: number | null | undefined): value is number => value != null && Number.isFinite(value);
|
|
79
|
+
|
|
80
|
+
/** The major currency a holding's price converts through, and what one unit of its price is worth in the book's currency's unit before FX. */
|
|
81
|
+
export function periodCurrency(currency: string, bookCurrency: string): { currency: string; own: boolean; scale: number } {
|
|
82
|
+
const unit = heldCurrencyUnit(currency);
|
|
83
|
+
const book = heldCurrencyUnit(bookCurrency);
|
|
84
|
+
return { currency: unit.currency || currency, own: sameCurrency(currency, bookCurrency), scale: (book.divisor || 1) / (unit.divisor || 1) };
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
export function periodPnl(holdings: readonly PeriodPnlHolding[], bookCurrency: string, rate: PeriodFxRate): PeriodPnl {
|
|
88
|
+
const unpriced: string[] = [];
|
|
89
|
+
const valued = holdings.map((holding) => {
|
|
90
|
+
const { start, end } = holding;
|
|
91
|
+
// A price in pence counts a hundredth of a pound, converted at GBP's rate.
|
|
92
|
+
const { currency: major, own, scale } = periodCurrency(holding.currency, bookCurrency);
|
|
93
|
+
const startRate = start ? (own ? 1 : rate(major, start.day)) : null;
|
|
94
|
+
const endRate = end ? (own ? 1 : rate(major, end.day)) : null;
|
|
95
|
+
const priced = !!start && !!end && finite(startRate) && finite(endRate);
|
|
96
|
+
if (!priced) unpriced.push(holding.symbol);
|
|
97
|
+
const startValue = start && finite(startRate) ? holding.priceUnits * start.price * scale * startRate : null;
|
|
98
|
+
return {
|
|
99
|
+
symbol: holding.symbol, priceUnits: holding.priceUnits, currency: holding.currency, start, end, partialEnd: !!holding.partialEnd,
|
|
100
|
+
changePercent: start && end && start.price !== 0 ? (end.price / start.price - 1) * 100 : null,
|
|
101
|
+
startValue,
|
|
102
|
+
pnl: priced ? holding.priceUnits * (end!.price - start!.price) * scale * endRate! : null,
|
|
103
|
+
fx: priced ? holding.priceUnits * start!.price * scale * (endRate! - startRate!) : null,
|
|
104
|
+
rates: priced && !own ? { currency: major, start: startRate!, end: endRate! } : null,
|
|
105
|
+
};
|
|
106
|
+
});
|
|
107
|
+
const starts = valued.flatMap((row) => finite(row.startValue) && finite(row.pnl) ? [row.startValue] : []);
|
|
108
|
+
const shorts = starts.some((value) => value < 0);
|
|
109
|
+
const base = starts.length ? starts.reduce((sum, value) => sum + (shorts ? Math.abs(value) : value), 0) : null;
|
|
110
|
+
const contributionBase = finite(base) && base > 0 ? base : null;
|
|
111
|
+
const rows = valued.map((row): PeriodPnlRow => ({
|
|
112
|
+
...row,
|
|
113
|
+
contribution: contributionBase && finite(row.pnl) ? (row.pnl / contributionBase) * 100 : null,
|
|
114
|
+
}));
|
|
115
|
+
const fx = rows.reduce((sum, row) => sum + (finite(row.fx) ? row.fx : 0), 0);
|
|
116
|
+
const total = rows.reduce((sum, row) => sum + (finite(row.pnl) && finite(row.fx) ? row.pnl + row.fx : 0), 0);
|
|
117
|
+
const share = (value: number) => contributionBase ? (value / contributionBase) * 100 : null;
|
|
118
|
+
return { rows, fx, fxContribution: share(fx), total, totalContribution: share(total), contributionBase, contributionBasis: shorts ? "gross" : "net", unpriced };
|
|
119
|
+
}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The words a positions import is shown in, the same in `portfolio import`
|
|
3
|
+
* and in the app's preview: where the file comes from, the portfolio it
|
|
4
|
+
* makes, and each row's shares, cost and status.
|
|
5
|
+
*/
|
|
6
|
+
import { formatMarketCost, formatMarketCostWithCurrency, formatMarketQuantity, withCurrencyMinorDigits } from "../../market-data/market/format";
|
|
7
|
+
import { POSITIONS_LAYOUT_NAMES, type PositionsLayoutId } from "./parse";
|
|
8
|
+
import { sameCost, type PositionsImportRow } from "./plan";
|
|
9
|
+
|
|
10
|
+
/** The rows a preview lists of each kind; past this many, a line counts the rest. */
|
|
11
|
+
export const PREVIEW_ROWS_SHOWN = 100;
|
|
12
|
+
|
|
13
|
+
/** The broker a recognised export comes from, which names the portfolio it makes. */
|
|
14
|
+
const LAYOUT_PORTFOLIO_NAMES: Readonly<Record<Exclude<PositionsLayoutId, "generic">, string>> = {
|
|
15
|
+
fidelity: "Fidelity",
|
|
16
|
+
schwab: "Schwab",
|
|
17
|
+
vanguard: "Vanguard",
|
|
18
|
+
etrade: "E*TRADE",
|
|
19
|
+
merrill: "Merrill",
|
|
20
|
+
};
|
|
21
|
+
|
|
22
|
+
/** The file's name without its folder; null for standard input. */
|
|
23
|
+
function fileBaseName(path: string | null): string | null {
|
|
24
|
+
if (!path || path === "-") return null;
|
|
25
|
+
return path.split(/[\\/]/).pop() || null;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/** The portfolio a file makes when none is named: the broker's name, else the file's. */
|
|
29
|
+
export function defaultImportPortfolioName(layout: PositionsLayoutId, path: string | null): string {
|
|
30
|
+
if (layout !== "generic") return LAYOUT_PORTFOLIO_NAMES[layout];
|
|
31
|
+
return fileBaseName(path)?.replace(/\.[^.]+$/, "").trim() || "Imported positions";
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/** Where the positions come from, after "from": "the Fidelity positions export", "holdings.csv". */
|
|
35
|
+
export function positionsImportSource(layout: PositionsLayoutId, path: string | null): string {
|
|
36
|
+
if (layout !== "generic") return `the ${POSITIONS_LAYOUT_NAMES[layout]}`;
|
|
37
|
+
return fileBaseName(path) ?? "standard input";
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
export function positionsImportShares(row: PositionsImportRow): string {
|
|
41
|
+
return formatMarketQuantity(row.shares, { assetCategory: row.ticker.metadata.assetCategory });
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Per share in the position's currency: as PF's Avg Cost prints it (158.57,
|
|
46
|
+
* the currency in its own column), or with the currency's sign as `portfolio
|
|
47
|
+
* show` prints it ($158.57). A cost the holding keeps says so, and none is a
|
|
48
|
+
* dash.
|
|
49
|
+
*/
|
|
50
|
+
export function positionsImportCost(row: PositionsImportRow, { withCurrency = false }: { withCurrency?: boolean } = {}): string {
|
|
51
|
+
if (row.avgCost === null) return "—";
|
|
52
|
+
const options = { assetCategory: row.ticker.metadata.assetCategory };
|
|
53
|
+
const cost = withCurrency
|
|
54
|
+
? formatMarketCostWithCurrency(row.avgCost, row.currency, options)
|
|
55
|
+
: formatMarketCost(row.avgCost, withCurrencyMinorDigits(options, row.currency));
|
|
56
|
+
return row.keptCost ? `${cost} (kept)` : cost;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Whether the rows need a currency column: some are in another currency
|
|
61
|
+
* than the portfolio totals in. A portfolio with no positions yet takes its
|
|
62
|
+
* first position's, so one currency across the rows needs none.
|
|
63
|
+
*/
|
|
64
|
+
export function positionsImportShowsCurrency(rows: readonly PositionsImportRow[], portfolioCurrency: string | null): boolean {
|
|
65
|
+
const currencies = new Set(rows.map((row) => row.currency));
|
|
66
|
+
return currencies.size > 1 || (portfolioCurrency !== null && currencies.size === 1 && !currencies.has(portfolioCurrency));
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/** What the import does to a holding: new, its lots made one, its shares, cost or date changed, or nothing. */
|
|
70
|
+
export function positionsImportStatus(row: PositionsImportRow): string {
|
|
71
|
+
if (row.heldShares === null) return "new";
|
|
72
|
+
if (row.heldLots > 1) return `${row.heldLots} lots → 1`;
|
|
73
|
+
if (row.heldShares !== row.shares) return `was ${formatMarketQuantity(row.heldShares)}`;
|
|
74
|
+
if (!row.keptCost && row.avgCost !== null && (row.heldAvgCost === null || !sameCost(row.heldAvgCost, row.avgCost))) return "new cost";
|
|
75
|
+
if (row.dateAcquired && row.dateAcquired !== row.heldDate) return "new date";
|
|
76
|
+
return "unchanged";
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/** The line under a skipped list cut at `PREVIEW_ROWS_SHOWN`, or null when it lists them all. */
|
|
80
|
+
export function moreSkippedLine(total: number): string | null {
|
|
81
|
+
const more = total - PREVIEW_ROWS_SHOWN;
|
|
82
|
+
return more > 0 ? `and ${more.toLocaleString("en-US")} more row${more === 1 ? "" : "s"} skipped` : null;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/** The line under a positions list cut at `PREVIEW_ROWS_SHOWN`: the rest are imported all the same. */
|
|
86
|
+
export function morePositionsLine(total: number): string | null {
|
|
87
|
+
const more = total - PREVIEW_ROWS_SHOWN;
|
|
88
|
+
return more > 0 ? `and ${more.toLocaleString("en-US")} more position${more === 1 ? "" : "s"}, imported with these` : null;
|
|
89
|
+
}
|