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
|
@@ -2,8 +2,9 @@ import { logFailure } from "../../utils/log-failure";
|
|
|
2
2
|
import { formatShortDate, parseDisplayDate } from "../../utils/datetime-format";
|
|
3
3
|
import { formatReportedMoney, REPORTING_CURRENCY_NOT_SOURCED } from "../../utils/reported-money";
|
|
4
4
|
import {
|
|
5
|
-
appTtmRate, computedEnterpriseValueNote, convertedPriceEarningsNote, enterpriseValueLabel, enterpriseValueReconciliationNote,
|
|
6
|
-
fundamentalsCurrency, reportedEnterpriseValue, trailingEpsSourceNote, ttmAtAppRate, ttmConversionNote,
|
|
5
|
+
appTtmRate, BANK_ENTERPRISE_VALUE, computedEnterpriseValueNote, convertedPriceEarningsNote, enterpriseValueLabel, enterpriseValueReconciliationNote,
|
|
6
|
+
epsConversionNote, fundamentalsCurrency, isBankEnterpriseValue, reportedEnterpriseValue, trailingEpsSourceNote, ttmAtAppRate, ttmConversionNote,
|
|
7
|
+
withBankEnterpriseValue,
|
|
7
8
|
} from "../../utils/fundamentals";
|
|
8
9
|
import { latestFinancialPeriod } from "../../utils/latest-financial-period";
|
|
9
10
|
import { burnsCash, cashRunway, SHORT_RUNWAY_HISTORY, formatRunwayMonths, offeringNote, offeringsAfter, runwayMethod, type CashRunway, type OfferingFiling, type RunwayEstimate } from "../../utils/cash-runway";
|
|
@@ -40,7 +41,7 @@ import {
|
|
|
40
41
|
quoteMarketStateLabel,
|
|
41
42
|
} from "../../market-data/market/status";
|
|
42
43
|
import type { FuturesContractTermsPayload } from "../../api-client/futures-curve";
|
|
43
|
-
import { changeBasisJson, quoteChangeBasis, quotePreviousCloseDate, quoteSettleText } from "../../market-data/market/change-basis";
|
|
44
|
+
import { changeBasisJson, futuresQuoteFromSettle, quoteChangeBasis, quotePreviousCloseDate, quoteSettleText } from "../../market-data/market/change-basis";
|
|
44
45
|
import {
|
|
45
46
|
futuresContractLines, futuresPricePer, isFuturesInstrument, loadFuturesContractTerms, loadUsdPerMmbtu, usdPerMmbtuText, type UsdPerMmbtu,
|
|
46
47
|
} from "../../market-data/futures-contract";
|
|
@@ -582,6 +583,8 @@ function unsourcedCurrencyNote(metrics: readonly FundamentalsMetric[]): string |
|
|
|
582
583
|
* withdrawn, N/M at or below zero as a P/E over a loss is.
|
|
583
584
|
*/
|
|
584
585
|
function enterpriseValueFigure(figure: MetricFigure, fundamentals: TickerFinancials["fundamentals"]): MetricFigure {
|
|
586
|
+
// A bank's: its deposits are funding, not debt.
|
|
587
|
+
if (isBankEnterpriseValue(fundamentals)) return { text: BANK_ENTERPRISE_VALUE, value: "N/M", unit: figure.unit };
|
|
585
588
|
const label = enterpriseValueLabel(fundamentals);
|
|
586
589
|
if (label === "not-meaningful") return { ...multipleFigure(NOT_MEANINGFUL), unit: figure.unit };
|
|
587
590
|
if (label === "unavailable") return { text: "unavailable", value: null, unit: figure.unit };
|
|
@@ -789,7 +792,7 @@ function fundamentalsMetrics(
|
|
|
789
792
|
const receipt = fundamentals?.sharesOutstanding != null && sharesOutstandingInReceipts(quote, fundamentals, profile?.description);
|
|
790
793
|
return [
|
|
791
794
|
{ label: "Market Cap", ...marketCap },
|
|
792
|
-
{ label: "Enterprise Value", ...enterpriseValueFigure(enterpriseValue, fundamentals) },
|
|
795
|
+
{ label: "Enterprise Value", ...enterpriseValueFigure(enterpriseValue, withBankEnterpriseValue(fundamentals, profile)) },
|
|
793
796
|
// A multiple over a loss is N/M, even beside a positive one the source served from an older period.
|
|
794
797
|
{ label: "P/E (TTM)", ...multipleFigure(priceEarningsOnEarnings(fundamentals?.trailingPE, fundamentals?.eps)) },
|
|
795
798
|
// Next fiscal year's consensus, named by its year: `Forward P/E FY27`.
|
|
@@ -905,7 +908,8 @@ function fundamentalsNotes(
|
|
|
905
908
|
? convertedPriceEarningsNote(fundamentals, quoteCurrency)
|
|
906
909
|
: undefined;
|
|
907
910
|
// Why the EV is labelled, withdrawn or N/M; for an insurer's, what Gloom Cloud computed it from.
|
|
908
|
-
|
|
911
|
+
// A bank's EV line says why it is n/m.
|
|
912
|
+
const enterpriseValue = shown("Enterprise Value") && !metrics.some((metric) => metric.text === BANK_ENTERPRISE_VALUE)
|
|
909
913
|
? enterpriseValueReconciliationNote(fundamentals) ?? computedEnterpriseValueNote(fundamentals)
|
|
910
914
|
: undefined;
|
|
911
915
|
// A cap Gloom Cloud withheld says why, as RV and EQS do.
|
|
@@ -1228,7 +1232,8 @@ export async function buildTickerReport({
|
|
|
1228
1232
|
/** What `recentSecFilings` left out. */
|
|
1229
1233
|
hiddenSecFilings?: HiddenFilings;
|
|
1230
1234
|
}): Promise<string> {
|
|
1231
|
-
|
|
1235
|
+
// A future's move that nothing confirms is measured from its last confirmed settlement, as `quote` reads it.
|
|
1236
|
+
const quote = futuresQuoteFromSettle(financials.quote, futuresContract);
|
|
1232
1237
|
const fundamentals = financials.fundamentals;
|
|
1233
1238
|
const priceReturns = computeTickerPriceReturns(financials, tickerFile?.metadata.assetCategory);
|
|
1234
1239
|
const profile = financials.profile;
|
|
@@ -1510,7 +1515,7 @@ function buildTickerStructuredData({
|
|
|
1510
1515
|
recentSecFilings: RecentFiling[];
|
|
1511
1516
|
hiddenSecFilings: HiddenFilings;
|
|
1512
1517
|
}) {
|
|
1513
|
-
const quote = financials.quote;
|
|
1518
|
+
const quote = futuresQuoteFromSettle(financials.quote, futuresContract);
|
|
1514
1519
|
const priceReturns = computeTickerPriceReturns(financials, tickerFile?.metadata.assetCategory);
|
|
1515
1520
|
const identity = listingIdentity(listing, quote);
|
|
1516
1521
|
// Market cap and the multiples at the regular session price, as the text report gives them.
|
|
@@ -1,5 +1,3 @@
|
|
|
1
|
-
import { spawn } from "node:child_process";
|
|
2
|
-
import type { Readable, Writable } from "node:stream";
|
|
3
1
|
import { mkdir } from "fs/promises";
|
|
4
2
|
import { join } from "path";
|
|
5
3
|
import { logFailure } from "../utils/log-failure";
|
|
@@ -182,46 +180,64 @@ interface LaunchedChrome {
|
|
|
182
180
|
stderr(): Promise<string>;
|
|
183
181
|
}
|
|
184
182
|
|
|
185
|
-
/**
|
|
183
|
+
/** Hands `onText` what `stream` carries, as text, until it ends; a read that fails ends it too. */
|
|
184
|
+
async function drain(stream: ReadableStream<Uint8Array>, onText: (text: string) => void): Promise<void> {
|
|
185
|
+
const decoder = new TextDecoder();
|
|
186
|
+
const reader = stream.getReader();
|
|
187
|
+
try {
|
|
188
|
+
for (;;) {
|
|
189
|
+
const { done, value } = await reader.read();
|
|
190
|
+
if (done) return;
|
|
191
|
+
onText(decoder.decode(value, { stream: true }));
|
|
192
|
+
}
|
|
193
|
+
} catch {
|
|
194
|
+
// Intentional ignore: a read that fails says the browser has gone, as the end of the stream does.
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
/**
|
|
199
|
+
* Chrome with DevTools on fds 3 (to the browser) and 4 (from it): messages are JSON, each ended by a NUL.
|
|
200
|
+
*
|
|
201
|
+
* The pipes are the browser's stdin and stdout, which `sh` moves to fds 3 and 4 and replaces with /dev/null, so
|
|
202
|
+
* the browser is started by `Bun.spawn` like every other child. Handed to it through `node:child_process`
|
|
203
|
+
* (`stdio: [..., "pipe", "pipe"]`), Bun closes those descriptors more than once as the browser exits, and goes on
|
|
204
|
+
* to use them. By then another child's pipes can hold the same numbers, and that child sees its own pipes closed
|
|
205
|
+
* under it: a stdout that cannot be registered (EBADF), a read that never ends, or a second browser start that
|
|
206
|
+
* finds its connection closed. `exec` keeps the browser's pid the child's, so `kill` reaches the browser itself.
|
|
207
|
+
*/
|
|
186
208
|
function launchOverPipe(chrome: string, args: string[]): LaunchedChrome {
|
|
187
|
-
const child = spawn(
|
|
188
|
-
|
|
189
|
-
|
|
209
|
+
const child = Bun.spawn(
|
|
210
|
+
["sh", "-c", 'exec "$0" "$@" 3<&0 4>&1 </dev/null >/dev/null', chrome, ...args, "--remote-debugging-pipe", "about:blank"],
|
|
211
|
+
{ stdin: "pipe", stdout: "pipe", stderr: "pipe" },
|
|
212
|
+
);
|
|
190
213
|
// Read to the end, so a chatty browser never blocks on a full pipe; only the start is kept.
|
|
191
214
|
let stderrText = "";
|
|
192
|
-
const
|
|
193
|
-
|
|
194
|
-
fromStderr.on("data", (chunk: string) => {
|
|
195
|
-
if (stderrText.length < STDERR_KEPT_BYTES) stderrText += chunk.slice(0, STDERR_KEPT_BYTES - stderrText.length);
|
|
215
|
+
const stderrDone = drain(child.stderr, (text) => {
|
|
216
|
+
if (stderrText.length < STDERR_KEPT_BYTES) stderrText += text.slice(0, STDERR_KEPT_BYTES - stderrText.length);
|
|
196
217
|
});
|
|
197
|
-
const
|
|
198
|
-
|
|
199
|
-
|
|
218
|
+
const connection = new CdpConnection((text) => {
|
|
219
|
+
child.stdin.write(`${text}\0`);
|
|
220
|
+
// Writes after the browser has gone fail; the connection already says it closed.
|
|
221
|
+
Promise.resolve(child.stdin.flush()).catch(() => connection.close());
|
|
200
222
|
});
|
|
201
|
-
const
|
|
202
|
-
const fromChrome = child.stdio[4] as Readable;
|
|
203
|
-
const connection = new CdpConnection((text) => toChrome.write(`${text}\0`));
|
|
223
|
+
const closed = () => connection.close();
|
|
204
224
|
let buffered = "";
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
buffered += chunk;
|
|
225
|
+
void drain(child.stdout, (text) => {
|
|
226
|
+
buffered += text;
|
|
208
227
|
for (let end = buffered.indexOf("\0"); end >= 0; end = buffered.indexOf("\0")) {
|
|
209
228
|
const message = buffered.slice(0, end);
|
|
210
229
|
buffered = buffered.slice(end + 1);
|
|
211
230
|
connection.receive(message);
|
|
212
231
|
}
|
|
213
|
-
});
|
|
214
|
-
const
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
else child.once("exit", () => resolve());
|
|
223
|
-
});
|
|
224
|
-
child.once("exit", closed);
|
|
232
|
+
}).then(closed);
|
|
233
|
+
const exited = (async () => {
|
|
234
|
+
try {
|
|
235
|
+
await child.exited;
|
|
236
|
+
} catch {
|
|
237
|
+
// Intentional ignore: a browser that cannot be waited for has gone, and the connection says so.
|
|
238
|
+
}
|
|
239
|
+
})();
|
|
240
|
+
void exited.then(closed);
|
|
225
241
|
return {
|
|
226
242
|
connection,
|
|
227
243
|
stop: async () => {
|
|
@@ -90,6 +90,10 @@ export interface DesktopPaneShotPayload {
|
|
|
90
90
|
tapeSnapshots?: TapeCapture[];
|
|
91
91
|
/** What each scanner pane's feed answered the capture process, which the page replays since its own socket cannot ask. */
|
|
92
92
|
scannerSnapshots?: ScannerCapture[];
|
|
93
|
+
/** Rows of a list whose read failed: shown without figures, and named on the capture's status line. */
|
|
94
|
+
unreadRows?: string[];
|
|
95
|
+
/** Why each of `unreadRows` did not load, as the source answered. */
|
|
96
|
+
unreadReasons?: Record<string, string>;
|
|
93
97
|
valuationSeries: Array<[string, DatedObservation[]]>;
|
|
94
98
|
statSeries: Array<[string, DatedObservation[]]>;
|
|
95
99
|
chartModel?: ChartResolutionResult;
|
|
@@ -128,6 +132,8 @@ interface DesktopPaneShotRenderedCell {
|
|
|
128
132
|
instant?: string;
|
|
129
133
|
/** The full-precision number behind a cell whose text rounds it (a trade of -9.4596), from the same export value. */
|
|
130
134
|
value?: number;
|
|
135
|
+
/** A column only the JSON and CSV carry (DataTable `reportColumns`): the text report leaves it out. Only in `reportRows`. */
|
|
136
|
+
reportOnly?: true;
|
|
131
137
|
}
|
|
132
138
|
|
|
133
139
|
export interface DesktopPaneShotRenderedRow {
|
|
@@ -213,6 +219,15 @@ const SHOT_MODE_CSS = [
|
|
|
213
219
|
const SHOT_READY_TIMEOUT_MS = 45_000;
|
|
214
220
|
const DEFAULT_DEVICE_SCALE_FACTOR = 2;
|
|
215
221
|
|
|
222
|
+
/**
|
|
223
|
+
* Starts building the capture's page while its data is read: the build is
|
|
224
|
+
* the same for every capture, and `renderDesktopPaneScreenshot` waits on it.
|
|
225
|
+
* A build that fails is retried there, and reported.
|
|
226
|
+
*/
|
|
227
|
+
export function prepareDesktopPaneShotView(): void {
|
|
228
|
+
loadShotView().catch(() => { /* Intentional ignore: the render loads the view again and reports its failure. */ });
|
|
229
|
+
}
|
|
230
|
+
|
|
216
231
|
export async function renderDesktopPaneScreenshot(
|
|
217
232
|
payload: DesktopPaneShotPayload,
|
|
218
233
|
outputPath: string,
|
package/src/cli/entry.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import "./opentui-libc";
|
|
2
|
+
import { installJsxDevFallback } from "../react/jsx-dev-fallback";
|
|
2
3
|
import { inferCliErrorOptions, printCliError } from "./errors";
|
|
3
4
|
import { isCliHelpFlag } from "./options";
|
|
4
5
|
import { cliAsciiEnabled, plainByDefault, setCliPlainOverride } from "../utils/cli-output";
|
|
@@ -19,6 +20,10 @@ import {
|
|
|
19
20
|
smokeShotView,
|
|
20
21
|
} from "./native-smoke";
|
|
21
22
|
|
|
23
|
+
// Before the first module with JSX loads, which is never one of the imports
|
|
24
|
+
// above: every command reaches those through a dynamic import.
|
|
25
|
+
installJsxDevFallback();
|
|
26
|
+
|
|
22
27
|
async function launchOpenTuiApp(cliLaunchRequest: CliLaunchRequest | null = null): Promise<void> {
|
|
23
28
|
// Before anything in the app can reach for the render library, so a temp
|
|
24
29
|
// folder that cannot run it is worked around (or named) first.
|
package/src/cli/export-source.ts
CHANGED
|
@@ -71,6 +71,12 @@ export interface ExportIdentity {
|
|
|
71
71
|
currencyOrUnit?: string | null;
|
|
72
72
|
/** The bar interval or observation frequency actually returned: `1d`, `1mo`, `daily`, `monthly`. */
|
|
73
73
|
interval?: string | null;
|
|
74
|
+
/**
|
|
75
|
+
* Who this row is cited to, where a table's rows come from different
|
|
76
|
+
* publishers (each venue's own contract): blank leaves the closing lines'
|
|
77
|
+
* source, which names them all.
|
|
78
|
+
*/
|
|
79
|
+
source?: string | null;
|
|
74
80
|
/**
|
|
75
81
|
* When this row was observed, where a table's rows are dated apart (each
|
|
76
82
|
* ticker's price in a ranking): an ISO date or instant. Null leaves `as_of`
|
|
@@ -102,7 +108,7 @@ export function exportIdentityCells(freshness: ReportFreshness, identity: Export
|
|
|
102
108
|
identity.symbolOrSeries?.trim() ?? "",
|
|
103
109
|
identity.currencyOrUnit?.trim() ?? "",
|
|
104
110
|
identity.interval?.trim() ?? "",
|
|
105
|
-
source.name,
|
|
111
|
+
identity.source?.trim() || source.name,
|
|
106
112
|
identity.asOf !== undefined ? rowAsOf(identity.asOf) : source.observationDate ?? "",
|
|
107
113
|
];
|
|
108
114
|
}
|
package/src/cli/freshness.ts
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
import type { Quote, TickerFinancials } from "../types/financials";
|
|
2
2
|
import type { HeadlessPaneFreshness, HeadlessPaneRow } from "../types/headless";
|
|
3
3
|
import { deriveHeadlessFreshness, type ReportFreshness } from "./pane-functions/freshness";
|
|
4
|
-
import { fxPairObservation, fxRateObservations, type FxRateTiming } from "../plugins/builtin/shared/fx-rate-freshness";
|
|
5
4
|
import { quoteObservation, REPORTED_DATA } from "../plugins/builtin/shared/report-freshness";
|
|
6
5
|
import { latestReportedPeriod } from "../utils/latest-financial-period";
|
|
7
6
|
|
|
@@ -38,21 +37,6 @@ export function quotesFreshness(
|
|
|
38
37
|
return rows.length > 0 ? rowsFreshness(rows, declared, undefined, now) : undefined;
|
|
39
38
|
}
|
|
40
39
|
|
|
41
|
-
/**
|
|
42
|
-
* A currency pair crossed from the loaded USD rates of its legs, dated as the
|
|
43
|
-
* FX matrix dates its rates (`fn FXC`): as old as its oldest dated leg, as
|
|
44
|
-
* held back as its most delayed, stale when any leg is, and read against the
|
|
45
|
-
* FX week. A pair with no loaded leg (a code priced in itself) cites nothing.
|
|
46
|
-
*/
|
|
47
|
-
export function fxPairFreshness(
|
|
48
|
-
legs: ReadonlyMap<string, { rate: number; timing: FxRateTiming }>,
|
|
49
|
-
now = Date.now(),
|
|
50
|
-
): ReportFreshness | undefined {
|
|
51
|
-
const rates = new Map([...legs].map(([currency, leg]) => [currency, leg.rate] as const));
|
|
52
|
-
const observation = fxPairObservation(fxRateObservations([...legs.keys()], rates, (currency) => ({ entry: legs.get(currency)?.timing }), now));
|
|
53
|
-
return observation ? rowsFreshness([observation], undefined, undefined, now) : undefined;
|
|
54
|
-
}
|
|
55
|
-
|
|
56
40
|
/**
|
|
57
41
|
* Fundamentals: reported figures, not a feed. Dated by when the statistics
|
|
58
42
|
* block was observed, with the newest statement period they run through
|
package/src/cli/fx-pair.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { currencyMinorDigits } from "../market-data/market/format";
|
|
2
2
|
import { parseTypedNumber, readConvertedAmount } from "../utils/decimal-comma";
|
|
3
3
|
import { currenciesNamed } from "../utils/currency-names";
|
|
4
|
+
import { currencyPairSpelling, fxFigureText, fxRateDigits, quotedFxPair } from "../utils/currency-pair";
|
|
4
5
|
|
|
5
6
|
/**
|
|
6
7
|
* What `gloom fx` is asked for. A bare code is one unit of it in the base
|
|
@@ -47,15 +48,31 @@ function readCurrencyName(typed: string, retry: (code: string) => string): { cod
|
|
|
47
48
|
return { error: `${typed} names several currencies: ${choices}. Write one as its code, such as fx ${retry(named[0]!.code)}.` };
|
|
48
49
|
}
|
|
49
50
|
|
|
51
|
+
/**
|
|
52
|
+
* A pair written as `quote` takes one, without a slash: EURUSD, eur-usd,
|
|
53
|
+
* EURUSD=X, EURUSD:CCY and JPY=X (USD/JPY). Null for anything else.
|
|
54
|
+
*/
|
|
55
|
+
function spelledPair(text: string): FxRequest | null {
|
|
56
|
+
if (/^[A-Z]{3}$/.test(text)) return null;
|
|
57
|
+
const spelling = currencyPairSpelling(text);
|
|
58
|
+
const match = spelling ? /^([A-Z]{3})([A-Z]{3})=X$/.exec(spelling.symbol) : null;
|
|
59
|
+
return match ? { currency: match[1]!, baseCurrency: match[2]! } : null;
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/** Whether `fx` reads the argument as a pair spelled without its slash (`spelledPair`). */
|
|
63
|
+
function isSpelledFxPair(raw: string): boolean {
|
|
64
|
+
return spelledPair(raw.trim().toUpperCase()) != null;
|
|
65
|
+
}
|
|
66
|
+
|
|
50
67
|
/** The request, or the sentence saying what is wrong with the argument. */
|
|
51
68
|
export function parseFxRequest(raw: string, baseCurrency: string): FxRequest | { error: string } {
|
|
52
69
|
const typed = raw.trim().split("/").map((part) => part.trim());
|
|
53
70
|
const text = raw.trim().toUpperCase();
|
|
54
71
|
const parts = typed.map((part) => part.toUpperCase());
|
|
55
72
|
if (parts.length > 2 || parts.some((part) => !part)) return { error: `"${raw}" is not a currency or a pair such as USD/NGN.` };
|
|
56
|
-
//
|
|
57
|
-
const
|
|
58
|
-
if (
|
|
73
|
+
// The pair spellings `quote` takes: EURUSD, eur-usd, EURUSD=X.
|
|
74
|
+
const spelled = parts.length === 1 ? spelledPair(text) : null;
|
|
75
|
+
if (spelled) return spelled;
|
|
59
76
|
// A name (peso, yen, Swiss franc) is a currency's code. Three letters that are a code stay one: only a name that is no code reads as one.
|
|
60
77
|
const readAs: string[] = [];
|
|
61
78
|
for (const [index, part] of parts.entries()) {
|
|
@@ -96,10 +113,10 @@ function joinNameWords(args: readonly string[]): readonly string[] {
|
|
|
96
113
|
/**
|
|
97
114
|
* `fx` arguments: a currency or a pair (`EUR`, `USD/NGN`), or an amount and
|
|
98
115
|
* what to convert it from and to (`1234.5 EUR/USD`, `1234,5 EUR USD`). The
|
|
99
|
-
* amount is an amount of the first currency
|
|
100
|
-
*
|
|
101
|
-
*
|
|
102
|
-
*
|
|
116
|
+
* amount is an amount of the first currency (`readConvertedAmount`):
|
|
117
|
+
* `1.234,5` and `1,234.5` are 1234.5. A lone comma or dot before exactly three
|
|
118
|
+
* digits (`1,234`, `1.234`) is refused naming both readings, as `alerts add`
|
|
119
|
+
* refuses `1,234`.
|
|
103
120
|
* An amount and one currency converts to USD (`toUsdByDefault`). The error
|
|
104
121
|
* sentence otherwise.
|
|
105
122
|
*/
|
|
@@ -127,10 +144,10 @@ export function parseFxArgs(words: readonly string[], baseCurrency: string): FxA
|
|
|
127
144
|
const pair = typed.length === 2 && typed.every((arg) => /^[A-Za-z]{3}$/.test(arg)) ? typed.join("/").toUpperCase() : "EUR/USD";
|
|
128
145
|
return { error: `fx takes one currency or pair; got ${typed.join(" ")}. Write a pair as ${pair}, or convert an amount as fx 1234.5 ${pair}.` };
|
|
129
146
|
}
|
|
130
|
-
const toUsdByDefault = codes.length === 1 && !codes[0]!.includes("/");
|
|
147
|
+
const toUsdByDefault = codes.length === 1 && !codes[0]!.includes("/") && !isSpelledFxPair(codes[0]!);
|
|
131
148
|
const request = parseFxRequest(codes.join("/"), "USD");
|
|
132
149
|
if ("error" in request) return request;
|
|
133
|
-
//
|
|
150
|
+
// 1,234 and 1.234 could each be either reading, whatever the currency.
|
|
134
151
|
let amount: number;
|
|
135
152
|
try {
|
|
136
153
|
amount = readConvertedAmount(first, "The amount", request.currency);
|
|
@@ -183,7 +200,42 @@ export function formatFxRate(rate: number): string {
|
|
|
183
200
|
return fixed.includes(".") ? fixed.replace(/\.?0+$/, "") : fixed;
|
|
184
201
|
}
|
|
185
202
|
|
|
186
|
-
/**
|
|
187
|
-
|
|
188
|
-
|
|
203
|
+
/** The pair as markets quote it (USD/JPY for JPY/USD), its rate, and whether that is the direction asked for. */
|
|
204
|
+
function marketQuote(request: FxRequest, rate: number): { pair: string; rate: number; currency: string; direct: boolean } {
|
|
205
|
+
const quoted = quotedFxPair(request.currency, request.baseCurrency, rate);
|
|
206
|
+
return { pair: quoted.pair, rate: quoted.rate, currency: quoted.pair.slice(4), direct: quoted.pair === `${request.currency}/${request.baseCurrency}` };
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
/** A quote a rate is read from: its pair as markets write it and its figure as the source sent it (USD/JPY 157.848). */
|
|
210
|
+
export interface FxQuotedFigure {
|
|
211
|
+
pair: string;
|
|
212
|
+
figure: number;
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
/** The dollar pairs a cross is read from, each as sent: `via USD: USD/ZAR 16.13650, USD/NGN 1328.39`. */
|
|
216
|
+
export function describeFxLegs(legs: readonly FxQuotedFigure[]): string {
|
|
217
|
+
return `via USD: ${legs.map(({ pair, figure }) => `${pair} ${fxFigureText(figure, pair.slice(4))}`).join(", ")}`;
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
/**
|
|
221
|
+
* Both directions on one line: `1 NGN = 0.000752791 USD (USD/NGN 1328.39)`.
|
|
222
|
+
* The side that is the pair as markets quote it is that quote's figure as
|
|
223
|
+
* sent, with at least the pair's decimals (EUR/USD 1.12650, USD/JPY
|
|
224
|
+
* 157.848, IDR/JPY 0.0096120): the rate a conversion multiplies or divides
|
|
225
|
+
* by, never a rounded one. The other side is its inverse to six significant
|
|
226
|
+
* digits. A cross (no `quoted` figure of its own) shows the pair's decimals,
|
|
227
|
+
* and the dollar pairs it is read from are named beside it (`describeFxLegs`).
|
|
228
|
+
*/
|
|
229
|
+
export function describeFxRate(request: FxRequest, rate: number, quoted?: FxQuotedFigure): string {
|
|
230
|
+
const head = `1 ${request.currency} =`, pair = `${request.baseCurrency}/${request.currency}`;
|
|
231
|
+
if (request.currency === request.baseCurrency || !isUsableRate(rate)) {
|
|
232
|
+
return `${head} ${formatFxRate(rate)} ${request.baseCurrency} (${pair} ${formatFxRate(1 / rate)})`;
|
|
233
|
+
}
|
|
234
|
+
const market = marketQuote(request, rate);
|
|
235
|
+
const quotedText = quoted && quoted.pair === market.pair && isUsableRate(quoted.figure)
|
|
236
|
+
? fxFigureText(quoted.figure, market.currency)
|
|
237
|
+
: market.rate.toFixed(fxRateDigits(market.currency, market.rate));
|
|
238
|
+
const left = market.direct ? quotedText : formatFxRate(rate);
|
|
239
|
+
const right = market.direct ? formatFxRate(1 / rate) : quotedText;
|
|
240
|
+
return `${head} ${left} ${request.baseCurrency} (${pair} ${right})`;
|
|
189
241
|
}
|
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
import type { QuoteBatchOptions, QuoteBatchResult, QuoteSubscriptionTarget } from "../types/data-provider";
|
|
2
|
+
import type { Quote } from "../types/financials";
|
|
3
|
+
import { isQuoteStaleForCurrentSession } from "../market-data/quotes/freshness";
|
|
4
|
+
import { dollarPairListing, fxFigureAsSent, quotedFxPair } from "../utils/currency-pair";
|
|
5
|
+
import { fxFreshUntil } from "../utils/fx-market-hours";
|
|
6
|
+
import { quoteObservation } from "../plugins/builtin/shared/report-freshness";
|
|
7
|
+
import { isUsableRate, type FxQuotedFigure } from "./fx-pair";
|
|
8
|
+
|
|
9
|
+
/** A listing a rate is read from, and whether its price is the rate's inverse. */
|
|
10
|
+
export interface FxQuoteLeg {
|
|
11
|
+
symbol: string;
|
|
12
|
+
invert: boolean;
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* A pair's own listing, as markets quote it: EURJPY=X for EUR/JPY and,
|
|
17
|
+
* inverted, for JPY/EUR; USDSGD=X for USD/SGD.
|
|
18
|
+
*/
|
|
19
|
+
export function fxPairListing(currency: string, baseCurrency: string): FxQuoteLeg {
|
|
20
|
+
const [base, quote] = quotedFxPair(currency, baseCurrency, 1).pair.split("/") as [string, string];
|
|
21
|
+
return { symbol: `${base}${quote}=X`, invert: base !== currency };
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
/** A currency's dollar pair, read as USD per unit: EURUSD=X, or USDJPY=X inverted. */
|
|
25
|
+
function dollarLeg(code: string): FxQuoteLeg {
|
|
26
|
+
const symbol = dollarPairListing(code);
|
|
27
|
+
return { symbol, invert: symbol.startsWith("USD") };
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** The rate `fx` answers with and the quotes behind it, each as `quote` reads it. */
|
|
31
|
+
export interface FxQuoteRate {
|
|
32
|
+
/** `baseCurrency` per unit of `currency`, from the quotes' figures as sent: never rounded. */
|
|
33
|
+
rate: number;
|
|
34
|
+
/** The pair's own quote, or the two dollar pairs it is crossed from, each with its pair and figure as sent. */
|
|
35
|
+
quotes: ({ symbol: string; quote: Quote } & FxQuotedFigure)[];
|
|
36
|
+
/** Crossed through the dollar: the pair has no quote of its own. */
|
|
37
|
+
viaUsd: boolean;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
export interface FxQuoteMiss {
|
|
41
|
+
/** The currencies no quote priced. */
|
|
42
|
+
missing: string[];
|
|
43
|
+
/** The reasons the quotes that did not come back gave, first the pair's own. */
|
|
44
|
+
errors: unknown[];
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/** The figure a leg's quote was sent as (EURJPY=X 177.811), or null for none. */
|
|
48
|
+
function legFigure(quote: Quote | null | undefined): number | null {
|
|
49
|
+
const price = quote?.price;
|
|
50
|
+
return isUsableRate(price) ? fxFigureAsSent(price) : null;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function legRate(leg: FxQuoteLeg, quote: Quote | null | undefined): number | null {
|
|
54
|
+
const figure = legFigure(quote);
|
|
55
|
+
if (figure == null) return null;
|
|
56
|
+
const rate = leg.invert ? 1 / figure : figure;
|
|
57
|
+
return isUsableRate(rate) ? rate : null;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/** A leg's quote with its pair as markets write it (EURJPY=X is EUR/JPY) and its figure as sent. */
|
|
61
|
+
function quotedLeg(leg: FxQuoteLeg, quote: Quote): { symbol: string; quote: Quote } & FxQuotedFigure {
|
|
62
|
+
return { symbol: leg.symbol, quote, pair: `${leg.symbol.slice(0, 3)}/${leg.symbol.slice(3, 6)}`, figure: legFigure(quote)! };
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* The rate of `currency` in `baseCurrency` from the quotes `quote` and the FX
|
|
67
|
+
* board read, in one batch: the pair's own quote (EURJPY=X for EUR/JPY),
|
|
68
|
+
* else, for a pair with no quote or one that went stale while both dollar
|
|
69
|
+
* pairs are current, the cross of the dollar pairs (EURUSD=X and USDJPY=X),
|
|
70
|
+
* said as such. A pair with a dollar side is its own dollar pair. Null for a
|
|
71
|
+
* currency priced in itself; the currencies no quote priced when neither
|
|
72
|
+
* reading has a price.
|
|
73
|
+
*/
|
|
74
|
+
export async function readFxQuoteRate(
|
|
75
|
+
currency: string,
|
|
76
|
+
baseCurrency: string,
|
|
77
|
+
getQuotesBatch: (targets: QuoteSubscriptionTarget[], options?: QuoteBatchOptions) => Promise<QuoteBatchResult[]>,
|
|
78
|
+
options: { forceRefresh?: boolean; now?: number } = {},
|
|
79
|
+
): Promise<FxQuoteRate | FxQuoteMiss | null> {
|
|
80
|
+
if (currency === baseCurrency) return null;
|
|
81
|
+
const now = options.now ?? Date.now();
|
|
82
|
+
const own = fxPairListing(currency, baseCurrency);
|
|
83
|
+
const crossed = currency !== "USD" && baseCurrency !== "USD";
|
|
84
|
+
const legs = crossed ? [dollarLeg(currency), dollarLeg(baseCurrency)] : [];
|
|
85
|
+
const asked = [own, ...legs];
|
|
86
|
+
const results = await getQuotesBatch(
|
|
87
|
+
asked.map((leg) => ({ symbol: leg.symbol, exchange: "" })),
|
|
88
|
+
{ forceRefresh: options.forceRefresh === true, revalidate: true },
|
|
89
|
+
);
|
|
90
|
+
const resultOf = (leg: FxQuoteLeg, index: number) => results.find((result) => result.target.symbol === leg.symbol) ?? results[index];
|
|
91
|
+
const read = asked.map((leg, index) => {
|
|
92
|
+
const result = resultOf(leg, index);
|
|
93
|
+
const quote = result?.quote ?? null;
|
|
94
|
+
return { leg, quote, rate: legRate(leg, quote), error: result?.error };
|
|
95
|
+
});
|
|
96
|
+
const [pair, from, into] = read as [typeof read[number], ...typeof read];
|
|
97
|
+
const current = (entry: typeof read[number] | undefined) => entry?.rate != null && !isQuoteStaleForCurrentSession(entry.quote!, now);
|
|
98
|
+
const legsCurrent = crossed && current(from) && current(into);
|
|
99
|
+
if (pair.rate != null && (!legsCurrent || current(pair))) {
|
|
100
|
+
return { rate: pair.rate, quotes: [quotedLeg(pair.leg, pair.quote!)], viaUsd: false };
|
|
101
|
+
}
|
|
102
|
+
if (crossed && from?.rate != null && into?.rate != null) {
|
|
103
|
+
return {
|
|
104
|
+
rate: from.rate / into.rate,
|
|
105
|
+
quotes: [quotedLeg(from.leg, from.quote!), quotedLeg(into.leg, into.quote!)],
|
|
106
|
+
viaUsd: true,
|
|
107
|
+
};
|
|
108
|
+
}
|
|
109
|
+
const missing = crossed
|
|
110
|
+
? [currency, baseCurrency].filter((_code, index) => read[index + 1]?.rate == null)
|
|
111
|
+
: [currency === "USD" ? baseCurrency : currency];
|
|
112
|
+
return { missing, errors: read.flatMap((entry) => entry.rate == null && entry.error != null ? [entry.error] : []) };
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
/** How long past its feed's delay a weekday FX rate stays current, counted while the FX market trades. */
|
|
116
|
+
const FX_STALE_AFTER_DELAY_MS = 15 * 60_000;
|
|
117
|
+
|
|
118
|
+
/**
|
|
119
|
+
* Whether an FX quote has aged past its feed's delay and fifteen minutes,
|
|
120
|
+
* counting only the hours the FX market trades (`fxFreshUntil`): Friday's
|
|
121
|
+
* close stays current over the weekend, a rate that stopped on a weekday
|
|
122
|
+
* goes stale, whatever the service said of it.
|
|
123
|
+
*/
|
|
124
|
+
function fxQuoteAgedOut(observation: { updatedAt: number; delayMinutes?: number }, now = Date.now()): boolean {
|
|
125
|
+
if (!Number.isFinite(observation.updatedAt)) return false;
|
|
126
|
+
return fxFreshUntil(observation.updatedAt, (observation.delayMinutes ?? 0) * 60_000 + FX_STALE_AFTER_DELAY_MS) <= now;
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/**
|
|
130
|
+
* The one observation a rate is dated by, as `quote` dates a quote: the
|
|
131
|
+
* pair's own quote, or for a cross the older of its two, stale when either
|
|
132
|
+
* is (as the service says, or aged out: `fxQuoteAgedOut`) and as held back as
|
|
133
|
+
* the more delayed.
|
|
134
|
+
*/
|
|
135
|
+
export function fxQuoteRateObservation(rate: FxQuoteRate, now = Date.now()): ReturnType<typeof quoteObservation> {
|
|
136
|
+
const observations = rate.quotes.map(({ quote }) => quoteObservation(quote, now));
|
|
137
|
+
const oldest = observations.reduce((older, observation) => observation.updatedAt < older.updatedAt ? observation : older);
|
|
138
|
+
const delays = observations.flatMap((observation) => observation.delayMinutes ?? []);
|
|
139
|
+
return {
|
|
140
|
+
...oldest,
|
|
141
|
+
stale: observations.some((observation) => observation.stale === true || fxQuoteAgedOut(observation, now)),
|
|
142
|
+
...(delays.length > 0 ? { delayMinutes: Math.max(...delays) } : {}),
|
|
143
|
+
};
|
|
144
|
+
}
|
package/src/cli/glossary.ts
CHANGED
|
@@ -400,6 +400,11 @@ export const GLOSSARY: readonly GlossaryEntry[] = [
|
|
|
400
400
|
definition: "A holding's share of the portfolio's total value, cash included, in percent. A holding without a price is left out of the total. "
|
|
401
401
|
+ "In a book that holds a short, its signed value's share of gross exposure instead, longs plus shorts at their absolute value, so a short weighs negative and cash has no weight.",
|
|
402
402
|
},
|
|
403
|
+
{
|
|
404
|
+
term: "Contribution", aliases: ["contrib", "period contribution", "contribution to return"], functions: ["PF"], shown: ["Contribution", "CONTRIB"],
|
|
405
|
+
definition: "Over a period (portfolio show --from, fn PF --from), a position's P&L between the two closes as a share of the book's value at the start, in percent; "
|
|
406
|
+
+ "of its gross exposure instead, longs plus shorts at their absolute value, when the book holds a short. The positions, the FX line and the total add up.",
|
|
407
|
+
},
|
|
403
408
|
{
|
|
404
409
|
term: "Target", aliases: ["target weight", "target weights", "targets", "target allocation"], functions: ["PF"],
|
|
405
410
|
definition: "The weight you want a holding to have, set with portfolio target set. Targets need not add up to 100%; the report says what is unallocated.",
|