gloomberb 0.20.2 → 0.20.4
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 +1 -1
- package/README.zh-CN.md +1 -1
- package/package.json +2 -1
- package/src/account/auth-dialog.tsx +17 -0
- package/src/account/auth-form.tsx +13 -8
- package/src/account/upgrade-dialog.tsx +1 -1
- package/src/api-client/central-bank-rates.ts +5 -0
- package/src/api-client/data.ts +23 -4
- package/src/api-client/debt-maturities.ts +45 -2
- package/src/api-client/earnings.ts +4 -2
- package/src/api-client/errors.ts +21 -11
- package/src/api-client/fx-interventions.ts +64 -0
- package/src/api-client/index.ts +2 -0
- package/src/api-client/paths.ts +9 -1
- package/src/api-client/release-summaries.ts +21 -0
- package/src/api-client/social-mentions.ts +47 -0
- package/src/api-client/types/econ.ts +4 -0
- package/src/app/keybindings/actions.ts +2 -2
- package/src/app/pane-runtime/ticker-open-runtime.ts +245 -66
- package/src/app.tsx +11 -1
- package/src/cli/command-options.ts +2 -1
- package/src/cli/commands/market.ts +188 -30
- package/src/cli/commands/news-search.ts +1 -3
- package/src/cli/commands/options-chain.ts +23 -6
- package/src/cli/commands/overview.ts +13 -5
- package/src/cli/commands/plugins.ts +76 -23
- package/src/cli/commands/search.ts +25 -6
- package/src/cli/commands/system.ts +19 -3
- package/src/cli/commands/ticker.ts +64 -21
- package/src/cli/fx-quote-rate.ts +49 -1
- package/src/cli/glossary.ts +95 -15
- package/src/cli/history-rows.ts +9 -25
- package/src/cli/index.ts +14 -46
- package/src/cli/known-gaps.ts +3 -3
- package/src/cli/listing-arg.ts +78 -18
- package/src/cli/name-entries.ts +3 -2
- package/src/cli/not-a-ticker.ts +6 -2
- package/src/cli/pane-functions/capabilities.ts +12 -1
- package/src/cli/pane-functions/function-help.ts +26 -14
- package/src/cli/pane-functions/headless.ts +3 -1
- package/src/cli/pane-functions/index.ts +32 -4
- package/src/cli/pane-functions/market-session.ts +8 -3
- package/src/cli/pane-functions/resolver.ts +18 -11
- package/src/cli/pane-functions/screenshot-payload.ts +36 -6
- package/src/cli/pane-functions/screenshot-render.ts +4 -0
- package/src/cli/quote-answer.ts +10 -0
- package/src/cli/report-tables.ts +40 -8
- package/src/cli/result.ts +21 -9
- package/src/cli/spreadsheet-hint.ts +43 -0
- package/src/cli/symbol-list.ts +58 -4
- package/src/cli/symbol-rows.ts +49 -2
- package/src/cli/ticker-resolution.ts +98 -5
- package/src/cli/types.ts +2 -0
- package/src/cli/unknown-command.ts +88 -0
- package/src/components/chart/composite/axis-overlays.tsx +22 -0
- package/src/components/chart/composite/composite-chart.tsx +54 -13
- package/src/components/chart/composite/event-captions.ts +109 -0
- package/src/components/chart/composite/event-guides.ts +74 -0
- package/src/components/chart/composite/rasterizer.ts +2 -0
- package/src/components/chart/composite/text-renderer.ts +2 -0
- package/src/components/chart/composite/types.ts +31 -0
- package/src/components/command-bar/assist/model.ts +6 -1
- package/src/components/command-bar/commands/direct/index.ts +9 -1
- package/src/components/command-bar/commands/registry.ts +18 -0
- package/src/components/command-bar/layout-items/focused-pane.ts +5 -5
- package/src/components/command-bar/pane-actions.ts +30 -13
- package/src/components/command-bar/panel/index.tsx +6 -3
- package/src/components/command-bar/panel/prompt-binding.ts +4 -0
- package/src/components/command-bar/panel/types.ts +3 -0
- package/src/components/command-bar/routes/header-market.ts +108 -0
- package/src/components/command-bar/routes/root/command-items.ts +5 -0
- package/src/components/command-bar/routes/root/provider-search.ts +192 -33
- package/src/components/command-bar/routes/root/results.ts +3 -0
- package/src/components/command-bar/routes/root/runtime.ts +28 -5
- package/src/components/command-bar/routes/ticker-search/results.ts +104 -6
- package/src/components/command-bar/routes/ticker-search/route.ts +3 -2
- package/src/components/command-bar/routing/list-state.ts +38 -0
- package/src/components/command-bar/selection-hint.ts +28 -0
- package/src/components/command-bar/surface/index.tsx +41 -3
- package/src/components/command-bar/view-model.ts +15 -0
- package/src/components/command-bar/workflow/tickers.ts +3 -2
- package/src/components/company-logo.tsx +20 -2
- package/src/components/data-table/export.ts +13 -8
- package/src/components/feedback-dialog.tsx +2 -1
- package/src/components/form-modal/field-row.tsx +2 -1
- package/src/components/input-search-bar.tsx +2 -2
- package/src/components/layout/detached-pane-shell.tsx +1 -1
- package/src/components/layout/double-escape-close.ts +8 -5
- package/src/components/layout/floating-pane.tsx +5 -1
- package/src/components/layout/header.tsx +75 -44
- package/src/components/layout/market-summary.ts +322 -116
- package/src/components/layout/pane/footer/index.tsx +44 -19
- package/src/components/layout/pane/footer/model.ts +52 -20
- package/src/components/layout/pane/header.tsx +3 -2
- package/src/components/layout/shell/action-menu-overlay.tsx +10 -5
- package/src/components/layout/shell/active-drag.ts +149 -105
- package/src/components/layout/shell/chrome.ts +15 -15
- package/src/components/layout/shell/drag/drop-zones.ts +162 -0
- package/src/components/layout/shell/drag/index.ts +47 -218
- package/src/components/layout/shell/drag/live.ts +10 -3
- package/src/components/layout/shell/drag/overlays.tsx +182 -5
- package/src/components/layout/shell/drag/runtime.ts +29 -6
- package/src/components/layout/shell/drag/shared-edges.ts +156 -0
- package/src/components/layout/shell/index.tsx +11 -6
- package/src/components/layout/shell/menu.ts +11 -2
- package/src/components/layout/shell/native/pointer-runtime.ts +25 -0
- package/src/components/layout/shell/native/window-state.ts +2 -2
- package/src/components/layout/shell/pane/layers.tsx +71 -7
- package/src/components/layout/shell/terminal-pointer-runtime.ts +18 -9
- package/src/components/layout/shell/window-mode/index.ts +8 -10
- package/src/components/layout/status-bar.tsx +8 -7
- package/src/components/layout/status-widget-space.ts +8 -0
- package/src/components/layout/window-edit/mode.ts +39 -7
- package/src/components/layout/window-edit/presentation.ts +1 -1
- package/src/components/markdown-editor.tsx +2 -2
- package/src/components/onboarding/account-step/form-panel.tsx +0 -3
- package/src/components/onboarding/onboarding-keyboard.ts +19 -6
- package/src/components/onboarding/onboarding-wizard.tsx +69 -14
- package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
- package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
- package/src/components/price-sparkline/model.ts +26 -10
- package/src/components/ticker/list-table-view.tsx +29 -4
- package/src/components/ui/button.tsx +15 -2
- package/src/components/ui/choice-dialog.tsx +1 -0
- package/src/components/ui/column-grid.tsx +18 -9
- package/src/components/ui/data-table/index.tsx +5 -4
- package/src/components/ui/data-table/opentui/index.tsx +2 -1
- package/src/components/ui/data-table/types.ts +18 -0
- package/src/components/ui/delayed-mark.tsx +3 -2
- package/src/components/ui/field-grid.tsx +0 -2
- package/src/components/ui/fields.tsx +7 -4
- package/src/components/ui/inline-quick-add.tsx +2 -2
- package/src/components/ui/key-hint-words.ts +153 -0
- package/src/components/ui/key-hints.tsx +73 -0
- package/src/components/ui/list-view.tsx +7 -12
- package/src/components/ui/loading.tsx +10 -3
- package/src/components/ui/menu.tsx +9 -3
- package/src/components/ui/message-composer.tsx +2 -2
- package/src/components/ui/quote.ts +14 -1
- package/src/components/ui/shortcut-hint.tsx +28 -3
- package/src/components/ui/tabs.tsx +7 -0
- package/src/components/ui/text-prompt-dialog.tsx +2 -1
- package/src/core/state/app/command-bar-launch.ts +3 -0
- package/src/data/config/layout.ts +5 -2
- package/src/data/config/store/normalize.ts +6 -0
- package/src/docs/snapshot.json +149 -74
- package/src/i18n/es.ts +33 -9
- package/src/i18n/ja.ts +33 -9
- package/src/i18n/ko.ts +33 -9
- package/src/i18n/zh-cn.ts +33 -9
- package/src/i18n/zh-tw.ts +33 -9
- package/src/layout/pane-manager/floating-actions.ts +17 -0
- package/src/layout/pane-manager/floating-stack.ts +187 -0
- package/src/layout/pane-manager/floating.ts +4 -2
- package/src/layout/pane-manager/gridlock.ts +16 -1
- package/src/layout/pane-manager/index.ts +11 -0
- package/src/layout/pane-manager/layout-state.ts +10 -3
- package/src/market-data/bars-per-year.ts +27 -9
- package/src/market-data/coordinator/quotes.ts +22 -3
- package/src/market-data/futures-board.ts +126 -1
- package/src/market-data/futures-contract.ts +21 -6
- package/src/market-data/fx-interventions.ts +270 -0
- package/src/market-data/market/change-basis.ts +2 -2
- package/src/market-data/market/dated-previous-close.ts +163 -47
- package/src/market-data/market/format.ts +14 -3
- package/src/market-data/market/freshness.ts +24 -7
- package/src/market-data/market/header-market.ts +154 -0
- package/src/market-data/market/index-level.ts +29 -0
- package/src/market-data/market/index-session-venues.ts +44 -0
- package/src/market-data/market/status.ts +7 -2
- package/src/market-data/market/venue-session.ts +72 -0
- package/src/market-data/model-dividend-yield.ts +23 -8
- package/src/market-data/options-alternatives.ts +39 -4
- package/src/market-data/published-apac-sessions.ts +40 -2
- package/src/market-data/quotes/export-identity.ts +76 -0
- package/src/market-data/quotes/freshness.ts +22 -0
- package/src/market-data/quotes/time.ts +42 -1
- package/src/market-data/realized-volatility.ts +11 -7
- package/src/market-data/tax-equivalent.ts +145 -27
- package/src/news/news-model.ts +44 -2
- package/src/plugins/builtin/account-management/pane.tsx +2 -2
- package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
- package/src/plugins/builtin/alerts/alert-log.ts +6 -2
- package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
- package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
- package/src/plugins/builtin/alerts/cli-move.ts +234 -0
- package/src/plugins/builtin/alerts/cli.ts +223 -32
- package/src/plugins/builtin/alerts/command.ts +33 -6
- package/src/plugins/builtin/alerts/event-rows.ts +18 -4
- package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
- package/src/plugins/builtin/alerts/events.ts +9 -0
- package/src/plugins/builtin/alerts/format.ts +39 -15
- package/src/plugins/builtin/alerts/headless.ts +30 -18
- package/src/plugins/builtin/alerts/history.ts +1 -0
- package/src/plugins/builtin/alerts/index.tsx +86 -12
- package/src/plugins/builtin/alerts/live.ts +2 -1
- package/src/plugins/builtin/alerts/move-checks.ts +161 -0
- package/src/plugins/builtin/alerts/move.ts +181 -0
- package/src/plugins/builtin/alerts/pane.tsx +50 -22
- package/src/plugins/builtin/alerts/price-text.ts +62 -0
- package/src/plugins/builtin/alerts/price.ts +17 -0
- package/src/plugins/builtin/alerts/quotes.ts +84 -3
- package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
- package/src/plugins/builtin/alerts/storage.ts +22 -7
- package/src/plugins/builtin/alerts/types.ts +25 -0
- package/src/plugins/builtin/analytics/risk-client.ts +60 -39
- package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
- package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
- package/src/plugins/builtin/analytics/risk-model.ts +68 -1
- package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
- package/src/plugins/builtin/backtest/engine.ts +4 -2
- package/src/plugins/builtin/backtest/window.ts +3 -1
- package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
- package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
- package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
- package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
- package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
- package/src/plugins/builtin/changelog/index.tsx +292 -101
- package/src/plugins/builtin/changelog/versions.ts +293 -0
- package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
- package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
- package/src/plugins/builtin/chart-composer/headless.ts +2 -0
- package/src/plugins/builtin/chart-composer/intervention-events.ts +105 -0
- package/src/plugins/builtin/chart-composer/pane.tsx +21 -7
- package/src/plugins/builtin/chat/message/render-state.ts +2 -5
- package/src/plugins/builtin/cloud/askg/attached-pane.tsx +10 -5
- package/src/plugins/builtin/cloud/askg/controller.ts +141 -5
- package/src/plugins/builtin/cloud/askg/executor.ts +113 -4
- package/src/plugins/builtin/cloud/askg/manifest.ts +28 -13
- package/src/plugins/builtin/cloud/askg/model.ts +14 -4
- package/src/plugins/builtin/cloud/askg/pane.tsx +70 -46
- package/src/plugins/builtin/cloud/askg/turn-parts.tsx +70 -0
- package/src/plugins/builtin/cloud/terminal-relay/engine.ts +50 -130
- package/src/plugins/builtin/cloud/terminal-relay/policy.ts +327 -7
- package/src/plugins/builtin/cloud/terminal-relay/prompts.tsx +2 -1
- package/src/plugins/builtin/cloud/terminal-relay/redact.ts +47 -6
- package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
- package/src/plugins/builtin/commodities-energy/index.tsx +1 -3
- package/src/plugins/builtin/commodities-energy/view-state.ts +3 -0
- package/src/plugins/builtin/cot/headless.ts +14 -2
- package/src/plugins/builtin/crypto-board/headless.ts +82 -17
- package/src/plugins/builtin/crypto-board/index.tsx +24 -2
- package/src/plugins/builtin/crypto-board/model.ts +5 -2
- package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
- package/src/plugins/builtin/debt-maturities/client.ts +111 -6
- package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
- package/src/plugins/builtin/debt-maturities/model.ts +97 -14
- package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
- package/src/plugins/builtin/debt-maturities/series.ts +3 -1
- package/src/plugins/builtin/dividend-yield/client.ts +22 -6
- package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
- package/src/plugins/builtin/dividend-yield/model.ts +5 -2
- package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
- package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
- package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
- package/src/plugins/builtin/dividend-yield/types.ts +2 -0
- package/src/plugins/builtin/dividend-yield/view.ts +3 -0
- package/src/plugins/builtin/earnings/index.tsx +2 -2
- package/src/plugins/builtin/econ/calendar-model.ts +21 -3
- package/src/plugins/builtin/econ/detail-view.tsx +5 -3
- package/src/plugins/builtin/econ/figures.ts +13 -0
- package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
- package/src/plugins/builtin/econ/index.tsx +5 -3
- package/src/plugins/builtin/econ/types.ts +5 -0
- package/src/plugins/builtin/equity-screener/footer.ts +45 -0
- package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
- package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
- package/src/plugins/builtin/fixed-income/model.ts +1 -0
- package/src/plugins/builtin/futures/index.tsx +25 -4
- package/src/plugins/builtin/futures/model.ts +28 -32
- package/src/plugins/builtin/futures/series.ts +4 -3
- package/src/plugins/builtin/futures/table.tsx +17 -10
- package/src/plugins/builtin/futures/use-board-terms.ts +3 -3
- package/src/plugins/builtin/futures-curve/model.ts +3 -10
- package/src/plugins/builtin/help/function-card.tsx +2 -1
- package/src/plugins/builtin/help/function-index.ts +1 -0
- package/src/plugins/builtin/help/index.tsx +3 -3
- package/src/plugins/builtin/help/keybindings-editor.tsx +18 -4
- package/src/plugins/builtin/insider/client.ts +31 -14
- package/src/plugins/builtin/insider/signals-model.ts +2 -7
- package/src/plugins/builtin/iv-history/headless.ts +1 -2
- package/src/plugins/builtin/iv-history/model.ts +33 -23
- package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
- package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
- package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
- package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
- package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
- package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
- package/src/plugins/builtin/layout-manager/index.tsx +8 -8
- package/src/plugins/builtin/news/headless.ts +2 -2
- package/src/plugins/builtin/news/index.tsx +10 -16
- package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
- package/src/plugins/builtin/news/ticker-news.ts +35 -0
- package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
- package/src/plugins/builtin/news/wire/news/row.ts +49 -0
- package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
- package/src/plugins/builtin/options/analytics.ts +7 -2
- package/src/plugins/builtin/options/live-quotes.ts +6 -1
- package/src/plugins/builtin/options/table.ts +3 -2
- package/src/plugins/builtin/options/view.tsx +11 -9
- package/src/plugins/builtin/options-scenario/client.ts +3 -0
- package/src/plugins/builtin/options-scenario/headless.ts +1 -1
- package/src/plugins/builtin/perps/client.ts +5 -4
- package/src/plugins/builtin/perps/headless.ts +134 -124
- package/src/plugins/builtin/perps/markets-section.tsx +7 -4
- package/src/plugins/builtin/perps/model.ts +8 -4
- package/src/plugins/builtin/perps/open-market.ts +4 -4
- package/src/plugins/builtin/perps/venue-markets.ts +3 -6
- package/src/plugins/builtin/plugin-marketplace/pane.tsx +11 -11
- package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
- package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
- package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
- package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
- package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
- package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
- package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
- package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
- package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
- package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
- package/src/plugins/builtin/portfolio-list/summary/index.tsx +3 -1
- package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
- package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
- package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
- package/src/plugins/builtin/realized-vol/headless.ts +44 -8
- package/src/plugins/builtin/realized-vol/model.ts +9 -5
- package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
- package/src/plugins/builtin/research/event-model.ts +9 -1
- package/src/plugins/builtin/research/event-sources.ts +22 -0
- package/src/plugins/builtin/research/headless.ts +3 -3
- package/src/plugins/builtin/sec/headless.ts +48 -6
- package/src/plugins/builtin/sec/index.tsx +6 -4
- package/src/plugins/builtin/sec/model.ts +4 -1
- package/src/plugins/builtin/shared/cloud-upgrade.ts +27 -3
- package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
- package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
- package/src/plugins/builtin/shared/report-freshness.ts +3 -1
- package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
- package/src/plugins/builtin/shared/volatility/options.ts +63 -2
- package/src/plugins/builtin/social-mentions/headless.ts +72 -3
- package/src/plugins/builtin/social-mentions/index.tsx +8 -4
- package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
- package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
- package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
- package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
- package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
- package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
- package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
- package/src/plugins/builtin/thirteenf/api.ts +36 -2
- package/src/plugins/builtin/thirteenf/data.ts +4 -1
- package/src/plugins/builtin/thirteenf/headless.ts +14 -6
- package/src/plugins/builtin/thirteenf/model.ts +56 -1
- package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
- package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
- package/src/plugins/builtin/thirteenf/table.ts +2 -1
- package/src/plugins/builtin/thirteenf/types.ts +6 -0
- package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
- package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
- package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
- package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
- package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
- package/src/plugins/builtin/ticker-detail/overview/components.tsx +67 -6
- package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
- package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
- package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
- package/src/plugins/builtin/ticker-detail/overview-tab.tsx +69 -19
- package/src/plugins/builtin/ticker-detail/pane.tsx +7 -2
- package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
- package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
- package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
- package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
- package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
- package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
- package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
- package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
- package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
- package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
- package/src/plugins/builtin/world-indices/client.ts +2 -0
- package/src/plugins/compat.ts +15 -0
- package/src/plugins/host-link.ts +6 -1
- package/src/plugins/installer.ts +53 -3
- package/src/portfolio/column-values.ts +14 -4
- package/src/portfolio/listed-symbol.ts +78 -0
- package/src/portfolio/real-return.ts +172 -0
- package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
- package/src/remote/resources.ts +12 -1
- package/src/remote/schema.ts +1 -0
- package/src/remote/semantic-helpers.ts +29 -1
- package/src/remote/semantic-tree.tsx +32 -15
- package/src/renderers/browser/config-host.ts +56 -15
- package/src/renderers/browser/main.tsx +3 -1
- package/src/renderers/browser/ui-host.tsx +1 -0
- package/src/renderers/cloudflare/http-proxy.ts +1 -0
- package/src/renderers/cloudflare/worker.ts +16 -1
- package/src/renderers/dom/boot-frame.ts +2 -2
- package/src/renderers/dom/data-table/row.tsx +4 -1
- package/src/renderers/dom/desktop/controls.tsx +4 -4
- package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
- package/src/renderers/dom/dom-ui-host.tsx +3 -1
- package/src/renderers/dom/host/input.tsx +4 -1
- package/src/renderers/dom/host/tabs.tsx +10 -1
- package/src/renderers/dom/styles.css +73 -19
- package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
- package/src/renderers/opentui/host.tsx +2 -1
- package/src/renderers/share/layout-view.tsx +1 -1
- package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
- package/src/sources/gloomberb-cloud/index.ts +31 -2
- package/src/sources/gloomberb-cloud/news.ts +35 -12
- package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
- package/src/sources/provider-router/cached-routes.ts +19 -7
- package/src/state/opening-ticker-panes.ts +47 -0
- package/src/state/pane-table-export-registry.ts +19 -6
- package/src/test-support/cli-context.ts +2 -0
- package/src/test-support/preload.ts +8 -1
- package/src/theme/colors.ts +9 -1
- package/src/theme/themes.ts +62 -15
- package/src/theme/tone-contrast.ts +40 -0
- package/src/theme/ui-tokens.ts +23 -3
- package/src/tickers/batched-lookups.ts +57 -8
- package/src/tickers/company-name-listing.ts +156 -14
- package/src/tickers/company-name.ts +30 -6
- package/src/tickers/instrument-kind.ts +23 -3
- package/src/tickers/list.ts +7 -0
- package/src/tickers/search/home-listing.ts +31 -9
- package/src/tickers/search/index.ts +13 -3
- package/src/tickers/search/listing-index.ts +558 -0
- package/src/tickers/search/major-listings.chunk.ts +10 -0
- package/src/tickers/search/major-listings.json +3346 -0
- package/src/tickers/search/ranking.ts +68 -1
- package/src/tickers/search/types.ts +4 -0
- package/src/tickers/terminal-codes.ts +26 -1
- package/src/time-series/calendar-month-returns.ts +47 -0
- package/src/time-series/currency-conversion.ts +130 -0
- package/src/time-series/hooks.ts +2 -0
- package/src/time-series/price-comparison.ts +34 -11
- package/src/time-series/resolve-context.ts +3 -0
- package/src/time-series/resolve.ts +14 -2
- package/src/time-series/spec.ts +1 -0
- package/src/time-series/studies/indicators.ts +4 -1
- package/src/time-series/types.ts +8 -0
- package/src/types/config.ts +13 -0
- package/src/types/context-menu.ts +2 -0
- package/src/types/data-provider.ts +28 -0
- package/src/types/financials.ts +20 -2
- package/src/types/headless.ts +12 -0
- package/src/types/plugin-commands.ts +140 -0
- package/src/types/plugin-context.ts +125 -0
- package/src/types/plugin-contributions.ts +55 -0
- package/src/types/plugin-definition.ts +234 -0
- package/src/types/plugin-notifications.ts +38 -0
- package/src/types/plugin-pane-settings.ts +114 -0
- package/src/types/plugin-pane-templates.ts +160 -0
- package/src/types/plugin-panes.ts +221 -0
- package/src/types/plugin-reports.ts +35 -0
- package/src/types/plugin-shared.ts +14 -0
- package/src/types/plugin-state.ts +71 -0
- package/src/types/plugin.ts +14 -1169
- package/src/ui/host.tsx +8 -0
- package/src/ui/index.tsx +14 -3
- package/src/updater/github-releases.ts +23 -0
- package/src/utils/cli-output.ts +22 -9
- package/src/utils/datetime-format.ts +17 -3
- package/src/utils/display-number.ts +15 -0
- package/src/utils/double-escape-close.ts +61 -16
- package/src/utils/float32-price.ts +24 -0
- package/src/utils/forward-dividend.ts +81 -16
- package/src/utils/fx-market-hours.ts +11 -0
- package/src/utils/plugin-proxy-hosts.json +2 -1
- package/src/utils/price-history.ts +7 -6
- package/src/utils/report-timing.ts +62 -0
- package/src/utils/sec-filings.ts +32 -0
- package/src/utils/utc-time.ts +5 -0
|
@@ -36,6 +36,12 @@ export interface MarketFormatOptions extends AssetDisplayContext {
|
|
|
36
36
|
quotedUnitDivisor?: number;
|
|
37
37
|
/** Write the currency's code after a money price (259.36 USD) instead of its sign ($259.36): a report for a base currency other than USD. */
|
|
38
38
|
currencyCode?: boolean;
|
|
39
|
+
/**
|
|
40
|
+
* A futures contract's tick, the smallest move its price makes: the price
|
|
41
|
+
* prints to the tick's decimals, 0.0063535 for the yen's 0.0000005 and
|
|
42
|
+
* 1.11570 for the euro's 0.00005, never fewer.
|
|
43
|
+
*/
|
|
44
|
+
tick?: number;
|
|
39
45
|
/** A price that holds still for the session, such as the previous close. With
|
|
40
46
|
* `fixedFractionDigits`, the kind's decimal ceiling is read at this price
|
|
41
47
|
* instead of at the value, so a live price keeps its decimals as it moves. */
|
|
@@ -389,6 +395,11 @@ export function formatThirtySeconds(value: number): string {
|
|
|
389
395
|
return `${sign}${points}-${String(Math.floor(rest / 8)).padStart(2, "0")}${EIGHTHS[rest % 8]}`;
|
|
390
396
|
}
|
|
391
397
|
|
|
398
|
+
/** The decimals a contract's tick is written with (0.0000005 is 7, 0.25 is 2); undefined without one. */
|
|
399
|
+
function tickFractionDigits(tick: number | undefined): number | undefined {
|
|
400
|
+
return tick != null && Number.isFinite(tick) && tick > 0 ? writtenFractionDigits(tick, 10) : undefined;
|
|
401
|
+
}
|
|
402
|
+
|
|
392
403
|
export function formatMarketPrice(value: number | undefined, options: MarketFormatOptions = {}): string {
|
|
393
404
|
if (value === undefined || value === null || Number.isNaN(value)) return "—";
|
|
394
405
|
const basis = resolvePriceBasis(options.priceBasis, options.assetCategory);
|
|
@@ -410,7 +421,7 @@ export function formatMarketPrice(value: number | undefined, options: MarketForm
|
|
|
410
421
|
? getBasePriceMaxFractionDigits(kind, value, options.currency) + quotedUnitDigits
|
|
411
422
|
: marketPriceFractionDigitCeiling(reference, options) + quotedUnitDigits;
|
|
412
423
|
let digits = Math.max(0, Math.min(fixedFractionDigits, maxFractionDigits));
|
|
413
|
-
const tick = kind === "equity" || kind === "other" ? listingTickDigits(options.listingTickTable, reference ?? value) :
|
|
424
|
+
const tick = kind === "equity" || kind === "other" ? listingTickDigits(options.listingTickTable, reference ?? value) : tickFractionDigits(options.tick);
|
|
414
425
|
if (tick !== undefined) digits = Math.max(digits, tick);
|
|
415
426
|
// A live price keeps its instrument's decimals, but a trade finer than the
|
|
416
427
|
// session prices showed (a half-yen print after whole-yen closes) is not
|
|
@@ -422,8 +433,8 @@ export function formatMarketPrice(value: number | undefined, options: MarketForm
|
|
|
422
433
|
? fitted
|
|
423
434
|
: scientificPrice(value, options.maxWidth);
|
|
424
435
|
}
|
|
425
|
-
// A listing whose tick is finer than its currency's minor unit keeps the tick's decimals (an HKEX ETF's 5.325).
|
|
426
|
-
const tick = kind === "equity" || kind === "other" ? listingTickDigits(options.listingTickTable, value) :
|
|
436
|
+
// A listing whose tick is finer than its currency's minor unit keeps the tick's decimals (an HKEX ETF's 5.325), as a contract does its own.
|
|
437
|
+
const tick = kind === "equity" || kind === "other" ? listingTickDigits(options.listingTickTable, value) : tickFractionDigits(options.tick);
|
|
427
438
|
const baseFractionDigits = getBasePriceMaxFractionDigits(kind, value, options.currency);
|
|
428
439
|
const minimumFractionDigits = Math.max(
|
|
429
440
|
0,
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type { MarketState, QuoteIndexSession } from "../../types/financials";
|
|
2
2
|
import { canonicalExchange, EXCHANGE_TIME_ZONES, isUsListingExchange } from "../../utils/exchanges";
|
|
3
|
-
import { hasPublishedApacCalendar, isPublishedApacClosure } from "../published-apac-sessions";
|
|
3
|
+
import { hasPublishedApacCalendar, isPublishedApacClosure, publishedApacEarlyClose } from "../published-apac-sessions";
|
|
4
4
|
import { hasPublishedCnCalendar, isPublishedCnClosure } from "../published-cn-sessions";
|
|
5
5
|
import { hasPublishedFuturesCalendar, isPublishedFuturesClosure, isPublishedFuturesVenue } from "../published-futures-sessions";
|
|
6
6
|
import { hasPublishedJpxCalendar, isPublishedJpxClosure } from "../published-jpx-sessions";
|
|
@@ -343,8 +343,10 @@ function localWeekday(date: string): number | null {
|
|
|
343
343
|
return day == null ? null : new Date(day * MS_PER_DAY).getUTCDay();
|
|
344
344
|
}
|
|
345
345
|
|
|
346
|
-
/** The local close of the venue's regular session on `date`, in minutes of the day. */
|
|
346
|
+
/** The local close of the venue's regular session on `date`, in minutes of the day, a published half day's included. */
|
|
347
347
|
function regularCloseMinutes(exchange: string, date: string): number | undefined {
|
|
348
|
+
const early = publishedApacEarlyClose(exchange, date);
|
|
349
|
+
if (early !== undefined) return early;
|
|
348
350
|
const weekday = localWeekday(date);
|
|
349
351
|
return (weekday == null ? undefined : WEEKDAY_CLOSE_MINUTES[exchange]?.[weekday]) ?? REGULAR_CLOSE_MINUTES[exchange];
|
|
350
352
|
}
|
|
@@ -602,18 +604,33 @@ export function isMiddayBreakPrint(
|
|
|
602
604
|
now: number,
|
|
603
605
|
feedLagMs: number,
|
|
604
606
|
): boolean {
|
|
607
|
+
if (!Number.isFinite(timestampMs) || timestampMs > now) return false;
|
|
608
|
+
const pause = middayBreakOn(exchange, now);
|
|
609
|
+
if (!pause) return false;
|
|
610
|
+
return now >= pause.start && now <= pause.end + feedLagMs + MIDDAY_BREAK_MARGIN_MS
|
|
611
|
+
&& timestampMs >= pause.start - MIDDAY_BREAK_MARGIN_MS;
|
|
612
|
+
}
|
|
613
|
+
|
|
614
|
+
/**
|
|
615
|
+
* The venue's midday break on the local day `now` falls in (HKEX pauses
|
|
616
|
+
* 12:00 to 13:00), whatever the time of day: when it starts and when the
|
|
617
|
+
* afternoon session opens. Null for a venue that trades through the day, on a
|
|
618
|
+
* day outside its trading week, and on a half day that closes before the
|
|
619
|
+
* afternoon session would open (HKEX's Christmas Eve).
|
|
620
|
+
*/
|
|
621
|
+
export function middayBreakOn(exchange: string | undefined, now: number): { start: number; end: number } | null {
|
|
605
622
|
const canonical = canonicalExchange(exchange);
|
|
606
623
|
const pause = MIDDAY_BREAKS[canonical];
|
|
607
624
|
const timeZone = pause?.timeZone ?? EXCHANGE_TIME_ZONES[canonical];
|
|
608
|
-
if (!pause || !timeZone || !Number.isFinite(
|
|
625
|
+
if (!pause || !timeZone || !Number.isFinite(now)) return null;
|
|
609
626
|
const { year, month, day } = zonedDateTimeParts(now, timeZone);
|
|
610
627
|
const weekday = new Date(Date.UTC(year, month - 1, day)).getUTCDay();
|
|
611
|
-
if (!isTradingWeekday(canonical, weekday)) return
|
|
628
|
+
if (!isTradingWeekday(canonical, weekday)) return null;
|
|
612
629
|
const [start, end] = weekday === 5 && pause.friday ? pause.friday : pause.weekdays;
|
|
630
|
+
const close = regularCloseMinutes(canonical, `${year}-${String(month).padStart(2, "0")}-${String(day).padStart(2, "0")}`);
|
|
631
|
+
if (close !== undefined && close <= end) return null;
|
|
613
632
|
const at = (minutes: number) => zonedWallClockToUtcMs(timeZone, year, month, day, Math.floor(minutes / 60), minutes % 60, 0);
|
|
614
|
-
|
|
615
|
-
return now >= breakStart && now <= at(end) + feedLagMs + MIDDAY_BREAK_MARGIN_MS
|
|
616
|
-
&& timestampMs >= breakStart - MIDDAY_BREAK_MARGIN_MS;
|
|
633
|
+
return { start: at(start), end: at(end) };
|
|
617
634
|
}
|
|
618
635
|
|
|
619
636
|
function usSessionState(timestampMs: number): UsSessionState {
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
import type { HeaderMarketChoice } from "../../types/config";
|
|
2
|
+
import { isRecord } from "../../utils/guards";
|
|
3
|
+
|
|
4
|
+
/** A market the header strip offers by name. */
|
|
5
|
+
export interface HeaderBenchmark {
|
|
6
|
+
id: string;
|
|
7
|
+
/** What the strip calls it: `S&P 500`, never its ETF. */
|
|
8
|
+
name: string;
|
|
9
|
+
symbol: string;
|
|
10
|
+
/** The venue whose hours and holidays the strip's market state follows. */
|
|
11
|
+
venue: string;
|
|
12
|
+
/**
|
|
13
|
+
* A listing that tracks it, shown under its own symbol when the benchmark
|
|
14
|
+
* itself has no usable quote for this account or source.
|
|
15
|
+
*/
|
|
16
|
+
fallback?: string;
|
|
17
|
+
/** Other names the picker finds it by. */
|
|
18
|
+
keywords: string;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
export const HEADER_BENCHMARKS: readonly HeaderBenchmark[] = [
|
|
22
|
+
{ id: "sp500", name: "S&P 500", symbol: "^GSPC", venue: "NYSE", fallback: "SPY", keywords: "SPX US" },
|
|
23
|
+
{ id: "nasdaq100", name: "Nasdaq 100", symbol: "^NDX", venue: "NASDAQ", fallback: "QQQ", keywords: "NDX US" },
|
|
24
|
+
{ id: "dow", name: "Dow", symbol: "^DJI", venue: "NYSE", fallback: "DIA", keywords: "Dow Jones DJIA US" },
|
|
25
|
+
{ id: "hang-seng", name: "Hang Seng", symbol: "^HSI", venue: "HKEX", fallback: "2800.HK", keywords: "HSI Hong Kong" },
|
|
26
|
+
{ id: "csi300", name: "CSI 300", symbol: "000300.SS", venue: "SSE", fallback: "510300.SS", keywords: "China Shanghai Shenzhen" },
|
|
27
|
+
{ id: "nikkei225", name: "Nikkei 225", symbol: "^N225", venue: "JPX", fallback: "1321.T", keywords: "NKY Japan Tokyo" },
|
|
28
|
+
{ id: "sti", name: "STI", symbol: "^STI", venue: "SGX", fallback: "ES3.SI", keywords: "Straits Times Singapore" },
|
|
29
|
+
{ id: "ftse100", name: "FTSE 100", symbol: "^FTSE", venue: "LSE", fallback: "ISF.L", keywords: "UKX UK London" },
|
|
30
|
+
{ id: "dax", name: "DAX", symbol: "^GDAXI", venue: "XETRA", fallback: "EXS1.DE", keywords: "Germany Frankfurt Europe" },
|
|
31
|
+
{ id: "btc", name: "BTC", symbol: "BTC-USD", venue: "CCC", keywords: "Bitcoin crypto" },
|
|
32
|
+
];
|
|
33
|
+
|
|
34
|
+
const DEFAULT_BENCHMARK_ID = "sp500";
|
|
35
|
+
const BENCHMARKS_BY_ID = new Map(HEADER_BENCHMARKS.map((benchmark) => [benchmark.id, benchmark]));
|
|
36
|
+
|
|
37
|
+
/** Zones of continental Europe, whose default is the DAX. */
|
|
38
|
+
const DAX_ZONES = [
|
|
39
|
+
"Amsterdam", "Andorra", "Athens", "Belgrade", "Berlin", "Bratislava", "Brussels", "Bucharest", "Budapest", "Busingen",
|
|
40
|
+
"Chisinau", "Copenhagen", "Gibraltar", "Helsinki", "Kiev", "Kyiv", "Lisbon", "Ljubljana", "Luxembourg", "Madrid", "Malta",
|
|
41
|
+
"Mariehamn", "Monaco", "Oslo", "Paris", "Podgorica", "Prague", "Riga", "Rome", "San_Marino", "Sarajevo", "Skopje", "Sofia",
|
|
42
|
+
"Stockholm", "Tallinn", "Tirane", "Vaduz", "Vatican", "Vienna", "Vilnius", "Warsaw", "Zagreb", "Zurich",
|
|
43
|
+
].map((city) => `Europe/${city}`);
|
|
44
|
+
|
|
45
|
+
/** The benchmark a machine's time zone starts the header on; every other zone gets the S&P 500. */
|
|
46
|
+
const ZONE_BENCHMARKS: Readonly<Record<string, string>> = {
|
|
47
|
+
"Asia/Hong_Kong": "hang-seng",
|
|
48
|
+
Hongkong: "hang-seng",
|
|
49
|
+
"Asia/Macau": "hang-seng",
|
|
50
|
+
"Asia/Singapore": "sti",
|
|
51
|
+
Singapore: "sti",
|
|
52
|
+
"Asia/Shanghai": "csi300",
|
|
53
|
+
"Asia/Chongqing": "csi300",
|
|
54
|
+
"Asia/Harbin": "csi300",
|
|
55
|
+
"Asia/Urumqi": "csi300",
|
|
56
|
+
PRC: "csi300",
|
|
57
|
+
"Asia/Tokyo": "nikkei225",
|
|
58
|
+
Japan: "nikkei225",
|
|
59
|
+
"Europe/London": "ftse100",
|
|
60
|
+
"Europe/Belfast": "ftse100",
|
|
61
|
+
"Europe/Guernsey": "ftse100",
|
|
62
|
+
"Europe/Isle_of_Man": "ftse100",
|
|
63
|
+
"Europe/Jersey": "ftse100",
|
|
64
|
+
GB: "ftse100",
|
|
65
|
+
...Object.fromEntries(DAX_ZONES.map((zone) => [zone, "dax"])),
|
|
66
|
+
};
|
|
67
|
+
|
|
68
|
+
/** The benchmark the header shows before the user picks one, from the machine's time zone. */
|
|
69
|
+
export function defaultHeaderBenchmark(timeZone: string | null | undefined): HeaderBenchmark {
|
|
70
|
+
const id = (timeZone && ZONE_BENCHMARKS[timeZone]) || DEFAULT_BENCHMARK_ID;
|
|
71
|
+
return BENCHMARKS_BY_ID.get(id)!;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/** The zone this machine (or browser) reads local times in, as the header's default market follows it. */
|
|
75
|
+
export function systemTimeZone(): string | undefined {
|
|
76
|
+
try {
|
|
77
|
+
return Intl.DateTimeFormat().resolvedOptions().timeZone || undefined;
|
|
78
|
+
} catch { /* Intentional ignore: a runtime without a zone database starts on the default benchmark. */ return undefined; }
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
/** What the header shows, resolved from the saved choice. */
|
|
82
|
+
export interface HeaderMarketTarget {
|
|
83
|
+
/** Identifies the target for effects keyed on it. */
|
|
84
|
+
key: string;
|
|
85
|
+
/** What the strip calls the quote: a benchmark's name, or a listing's symbol. */
|
|
86
|
+
label: string;
|
|
87
|
+
symbol: string;
|
|
88
|
+
exchange: string;
|
|
89
|
+
/** The venue whose hours the market state follows; null for a listing, whose quote names its own. */
|
|
90
|
+
venue: string | null;
|
|
91
|
+
/** The listing shown when the benchmark itself has no usable quote. */
|
|
92
|
+
fallback: { label: string; symbol: string; exchange: string } | null;
|
|
93
|
+
/** The benchmark, when the target is one. */
|
|
94
|
+
benchmarkId: string | null;
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
function benchmarkTarget(benchmark: HeaderBenchmark): HeaderMarketTarget {
|
|
98
|
+
return {
|
|
99
|
+
key: `benchmark:${benchmark.id}`,
|
|
100
|
+
label: benchmark.name,
|
|
101
|
+
symbol: benchmark.symbol,
|
|
102
|
+
exchange: "",
|
|
103
|
+
venue: benchmark.venue,
|
|
104
|
+
fallback: benchmark.fallback ? { label: benchmark.fallback, symbol: benchmark.fallback, exchange: "" } : null,
|
|
105
|
+
benchmarkId: benchmark.id,
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* The benchmark a listing is, when it is one the header offers: `^HSI`
|
|
111
|
+
* searched for is the Hang Seng, on whichever venue its search row named.
|
|
112
|
+
*/
|
|
113
|
+
export function headerBenchmarkForListing(symbol: string): HeaderBenchmark | null {
|
|
114
|
+
const normalized = symbol.trim().toUpperCase();
|
|
115
|
+
return HEADER_BENCHMARKS.find((benchmark) => benchmark.symbol === normalized) ?? null;
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
/** The header's market: the user's choice, or the benchmark of `timeZone` while they have made none. */
|
|
119
|
+
export function resolveHeaderMarket(choice: HeaderMarketChoice | undefined, timeZone: string | null | undefined): HeaderMarketTarget {
|
|
120
|
+
if (choice && "benchmark" in choice) {
|
|
121
|
+
const benchmark = BENCHMARKS_BY_ID.get(choice.benchmark);
|
|
122
|
+
if (benchmark) return benchmarkTarget(benchmark);
|
|
123
|
+
} else if (choice?.symbol) {
|
|
124
|
+
const benchmark = headerBenchmarkForListing(choice.symbol);
|
|
125
|
+
if (benchmark) return benchmarkTarget(benchmark);
|
|
126
|
+
const exchange = choice.exchange ?? "";
|
|
127
|
+
return {
|
|
128
|
+
key: `listing:${choice.symbol}:${exchange}`,
|
|
129
|
+
label: choice.symbol,
|
|
130
|
+
symbol: choice.symbol,
|
|
131
|
+
exchange,
|
|
132
|
+
venue: null,
|
|
133
|
+
fallback: null,
|
|
134
|
+
benchmarkId: null,
|
|
135
|
+
};
|
|
136
|
+
}
|
|
137
|
+
return benchmarkTarget(defaultHeaderBenchmark(timeZone));
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
/**
|
|
141
|
+
* A saved choice as this build reads it: a benchmark it offers, or a listing
|
|
142
|
+
* with a symbol. Anything else is no choice, and the header starts on the
|
|
143
|
+
* time zone's benchmark again.
|
|
144
|
+
*/
|
|
145
|
+
export function sanitizeHeaderMarketChoice(value: unknown): HeaderMarketChoice | undefined {
|
|
146
|
+
if (!isRecord(value)) return undefined;
|
|
147
|
+
if (typeof value.benchmark === "string") {
|
|
148
|
+
return BENCHMARKS_BY_ID.has(value.benchmark) ? { benchmark: value.benchmark } : undefined;
|
|
149
|
+
}
|
|
150
|
+
const symbol = typeof value.symbol === "string" ? value.symbol.trim() : "";
|
|
151
|
+
if (!symbol) return undefined;
|
|
152
|
+
const exchange = typeof value.exchange === "string" ? value.exchange.trim() : "";
|
|
153
|
+
return exchange ? { symbol, exchange } : { symbol };
|
|
154
|
+
}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { classifyInstrumentType, isCryptoVenuePerpetual } from "../../tickers/instrument-kind";
|
|
2
2
|
import type { PriceBasis } from "../../types/instrument";
|
|
3
|
+
import type { MarketState, Quote } from "../../types/financials";
|
|
3
4
|
|
|
4
5
|
/**
|
|
5
6
|
* The unit an index level is in, as a chart's axis and series name it. A
|
|
@@ -19,6 +20,9 @@ export const INDEX_POINTS_LABEL = "Index points";
|
|
|
19
20
|
/** How an export names it, in `currency_or_unit` and a `unit` field. */
|
|
20
21
|
export const INDEX_POINTS_EXPORT_UNIT = "index points";
|
|
21
22
|
|
|
23
|
+
/** How an export names a Cboe yield index's unit (^TNX at 4.859 is a yield in percent), in `quote` and `history` alike. */
|
|
24
|
+
export const YIELD_INDEX_EXPORT_UNIT = "pct";
|
|
25
|
+
|
|
22
26
|
/**
|
|
23
27
|
* An index level is points, not money: ^GSPC at 7,805.45 or ^VIX at 19.99 has
|
|
24
28
|
* no currency to name, wherever it is shown, though its quote names the
|
|
@@ -28,6 +32,31 @@ export function isIndexLevel(instrumentType: string | null | undefined): boolean
|
|
|
28
32
|
return classifyInstrumentType(instrumentType) === "index";
|
|
29
33
|
}
|
|
30
34
|
|
|
35
|
+
/**
|
|
36
|
+
* A bar's volume as an index level reports it. An index's 0 is a volume its
|
|
37
|
+
* source does not count (^HSI's hourly bars, a day built from its quote),
|
|
38
|
+
* never a session without trades: none, as `quote` leaves it blank. An index
|
|
39
|
+
* whose source sums its members' volume (^GSPC) keeps it, as any other bar does.
|
|
40
|
+
*/
|
|
41
|
+
export function indexBarVolume(volume: number | null | undefined, instrumentType: string | null | undefined): number | null {
|
|
42
|
+
if (volume == null || !Number.isFinite(volume)) return null;
|
|
43
|
+
return volume === 0 && isIndexLevel(instrumentType) ? null : volume;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* The market state an index level's quote is read in. An index is computed in
|
|
48
|
+
* its regular session only: a source's POST beside no after-hours print is that
|
|
49
|
+
* session's final close (^VIX and ^TNX after Cboe's close), so it reads CLOSED,
|
|
50
|
+
* as the status cell and the source line say it. Any other quote keeps its state.
|
|
51
|
+
*/
|
|
52
|
+
export function indexLevelMarketState(quote: Pick<Quote, "marketState" | "instrumentType" | "postMarketPrice">): MarketState | undefined {
|
|
53
|
+
const state = quote.marketState;
|
|
54
|
+
if ((state === "POST" || state === "POSTPOST") && isIndexLevel(quote.instrumentType) && !(quote.postMarketPrice != null && quote.postMarketPrice > 0)) {
|
|
55
|
+
return "CLOSED";
|
|
56
|
+
}
|
|
57
|
+
return state;
|
|
58
|
+
}
|
|
59
|
+
|
|
31
60
|
/** The currency a quote's price is in: none for an index level, nor for a quote that names none. */
|
|
32
61
|
export function quotePriceCurrency(quote: { currency?: string | null; instrumentType?: string | null } | null | undefined): string | null {
|
|
33
62
|
if (!quote || isIndexLevel(quote.instrumentType)) return null;
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The venue whose trading days and hours an index's bars follow, for the
|
|
3
|
+
* bare index symbols quoted outside the US. A bare symbol is otherwise read
|
|
4
|
+
* as its US listing, so the Hang Seng's hourly bars, which end at 16:10 Hong
|
|
5
|
+
* Kong time, were judged against New York's close and refused as behind:
|
|
6
|
+
* `history ^HSI --range 1W` answered "No history provider available".
|
|
7
|
+
* Venues are the ones the session tables know (freshness.ts).
|
|
8
|
+
*/
|
|
9
|
+
const INDEX_SESSION_VENUES: Readonly<Record<string, string>> = {
|
|
10
|
+
"^HSI": "HKEX",
|
|
11
|
+
"^HSCE": "HKEX",
|
|
12
|
+
"^HSTECH": "HKEX",
|
|
13
|
+
"^N225": "JPX",
|
|
14
|
+
"^KS11": "KRX",
|
|
15
|
+
"^KQ11": "KOSDAQ",
|
|
16
|
+
"^TWII": "TWSE",
|
|
17
|
+
"^AXJO": "ASX",
|
|
18
|
+
"^AORD": "ASX",
|
|
19
|
+
"^NSEI": "NSE",
|
|
20
|
+
"^NSEBANK": "NSE",
|
|
21
|
+
"^BSESN": "BSE",
|
|
22
|
+
"^STI": "SGX",
|
|
23
|
+
"^NZ50": "NZX",
|
|
24
|
+
"^FTSE": "LSE",
|
|
25
|
+
"^FTMC": "LSE",
|
|
26
|
+
"^GDAXI": "XETRA",
|
|
27
|
+
"^STOXX50E": "XETRA",
|
|
28
|
+
"^FCHI": "EPA",
|
|
29
|
+
"^AEX": "AMS",
|
|
30
|
+
"^BFX": "BRU",
|
|
31
|
+
"^SSMI": "SWX",
|
|
32
|
+
"^ATX": "VIE",
|
|
33
|
+
"^OMX": "SFB",
|
|
34
|
+
"^OMXH25": "HEL",
|
|
35
|
+
"^OMXC25": "CPH",
|
|
36
|
+
"^PSI20": "LIS",
|
|
37
|
+
"^GSPTSE": "TSX",
|
|
38
|
+
"^MXX": "BMV",
|
|
39
|
+
};
|
|
40
|
+
|
|
41
|
+
/** The venue a bare index symbol's sessions follow; null for any other symbol and for US indices. */
|
|
42
|
+
export function indexSessionVenue(symbol: string | null | undefined): string | null {
|
|
43
|
+
return symbol ? INDEX_SESSION_VENUES[symbol.trim().toUpperCase()] ?? null : null;
|
|
44
|
+
}
|
|
@@ -3,10 +3,11 @@ import { blendHex, colors, priceColor, type ThemeColors } from "../../theme/colo
|
|
|
3
3
|
import { isFiniteNumber } from "../../utils/guards";
|
|
4
4
|
import { canonicalExchange, isKnownExchangeCode } from "../../utils/exchanges";
|
|
5
5
|
import { quoteTradingDay } from "../quotes/day-range";
|
|
6
|
-
import { isQuoteBeforeLatestSession } from "../quotes/freshness";
|
|
6
|
+
import { awaitingFirstDelayedPrint, isQuoteBeforeLatestSession } from "../quotes/freshness";
|
|
7
7
|
import { delistingLabel, delistingStateLabel } from "../quotes/delisting";
|
|
8
8
|
import { preMarketOpenOn, regularSessionCloseOn, venueSessionOnOrBefore } from "./freshness";
|
|
9
9
|
import { futuresWeekendClosure } from "./futures-week";
|
|
10
|
+
import { indexLevelMarketState } from "./index-level";
|
|
10
11
|
|
|
11
12
|
const CLOSED_CHANGE_MUTING_RATIO = 0.55;
|
|
12
13
|
const US_SESSION_TIME = new Intl.DateTimeFormat("en-US", {
|
|
@@ -106,7 +107,11 @@ function closeLabel(date: string): string {
|
|
|
106
107
|
*/
|
|
107
108
|
function quoteMarketState(quote: Quote | null | undefined, now = Date.now()): MarketState | undefined {
|
|
108
109
|
if (!quote?.marketState) return undefined;
|
|
109
|
-
|
|
110
|
+
if (futuresWeekendClosure(quote.listingExchangeName || quote.exchangeName, now)) return "CLOSED";
|
|
111
|
+
// The session follows the venue's calendar: LSE is open at 08:09, though its delayed feed has not printed in it yet.
|
|
112
|
+
if (quote.marketState !== "REGULAR" && awaitingFirstDelayedPrint(quote, now)) return "REGULAR";
|
|
113
|
+
// An index's final close is a close, not an after-hours session.
|
|
114
|
+
return indexLevelMarketState(quote);
|
|
110
115
|
}
|
|
111
116
|
|
|
112
117
|
/**
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
import { canonicalExchange, isUsListingExchange } from "../../utils/exchanges";
|
|
2
|
+
import { zonedDateKey } from "../../utils/zoned-date-time";
|
|
3
|
+
import {
|
|
4
|
+
hasPublishedSessionCalendar,
|
|
5
|
+
isAlwaysOpenExchange,
|
|
6
|
+
isRegularSessionTime,
|
|
7
|
+
isTradingWeekday,
|
|
8
|
+
isVenueTradingDay,
|
|
9
|
+
middayBreakOn,
|
|
10
|
+
nextRegularSessionOpen,
|
|
11
|
+
regularSessionCloseOn,
|
|
12
|
+
} from "./freshness";
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* Where a venue's trading day stands: in its regular session, paused for
|
|
16
|
+
* lunch, in a US listing's pre-market or after-hours, closed for the night
|
|
17
|
+
* or a weekend, or closed on a weekday for a published holiday.
|
|
18
|
+
*/
|
|
19
|
+
export type VenueSessionPhase = "open" | "lunch" | "pre-market" | "after-hours" | "closed" | "holiday";
|
|
20
|
+
|
|
21
|
+
export interface VenueSessionNow {
|
|
22
|
+
phase: VenueSessionPhase;
|
|
23
|
+
/** The venue's own zone, which its hours are read in. */
|
|
24
|
+
timeZone: string;
|
|
25
|
+
/** While open: when the regular session closes, a published early close included. */
|
|
26
|
+
closesAt?: number;
|
|
27
|
+
/** Otherwise: when the regular session opens next, or the afternoon session after a lunch break. */
|
|
28
|
+
opensAt?: number;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** A US listing's after-hours session runs four hours past the regular close (to 20:00, 17:00 after a 13:00 close). */
|
|
32
|
+
const US_AFTER_HOURS_MS = 4 * 60 * 60_000;
|
|
33
|
+
/** The US pre-market opens at 04:00 New York, five and a half hours before the regular open. */
|
|
34
|
+
const US_PRE_MARKET_MS = 5.5 * 60 * 60_000;
|
|
35
|
+
|
|
36
|
+
/**
|
|
37
|
+
* A venue's session at `now`, from its own hours and published calendar
|
|
38
|
+
* (`freshness`): its regular open and close, its midday break and half
|
|
39
|
+
* days, its weekend and holidays, and for a US listing the pre-market and
|
|
40
|
+
* after-hours around the regular session. Null for a venue whose hours the
|
|
41
|
+
* app does not know, for one that trades around the clock, and on a day of a
|
|
42
|
+
* year whose closures the venue has not published: a holiday there would
|
|
43
|
+
* read as a session (LSE and XETRA publish none here). When the next open
|
|
44
|
+
* falls in such a year, it is left out.
|
|
45
|
+
*/
|
|
46
|
+
export function venueSessionNow(exchange: string | undefined, now: number): VenueSessionNow | null {
|
|
47
|
+
const venue = canonicalExchange(exchange);
|
|
48
|
+
if (!venue || isAlwaysOpenExchange(venue) || !Number.isFinite(now)) return null;
|
|
49
|
+
const next = nextRegularSessionOpen(venue, now);
|
|
50
|
+
if (!next) return null;
|
|
51
|
+
const { timeZone } = next;
|
|
52
|
+
const today = zonedDateKey(now, timeZone);
|
|
53
|
+
if (!hasPublishedSessionCalendar(venue, today)) return null;
|
|
54
|
+
if (isRegularSessionTime(venue, now)) {
|
|
55
|
+
const pause = middayBreakOn(venue, now);
|
|
56
|
+
if (pause && now >= pause.start && now < pause.end) return { phase: "lunch", timeZone, opensAt: pause.end };
|
|
57
|
+
const closesAt = regularSessionCloseOn(venue, today);
|
|
58
|
+
return { phase: "open", timeZone, ...(closesAt != null && closesAt > now ? { closesAt } : {}) };
|
|
59
|
+
}
|
|
60
|
+
// The walk to the next open never spans more than two years, so both ends published covers every day between.
|
|
61
|
+
const opening = hasPublishedSessionCalendar(venue, next.date) ? { opensAt: next.open } : {};
|
|
62
|
+
if (!isVenueTradingDay(venue, today)) {
|
|
63
|
+
const weekday = new Date(`${today}T00:00:00Z`).getUTCDay();
|
|
64
|
+
return { phase: isTradingWeekday(venue, weekday) ? "holiday" : "closed", timeZone, ...opening };
|
|
65
|
+
}
|
|
66
|
+
if (isUsListingExchange(venue)) {
|
|
67
|
+
if (next.date === today && now >= next.open - US_PRE_MARKET_MS) return { phase: "pre-market", timeZone, ...opening };
|
|
68
|
+
const closed = regularSessionCloseOn(venue, today);
|
|
69
|
+
if (closed != null && now >= closed && now < closed + US_AFTER_HOURS_MS) return { phase: "after-hours", timeZone, ...opening };
|
|
70
|
+
}
|
|
71
|
+
return { phase: "closed", timeZone, ...opening };
|
|
72
|
+
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type { CorporateActionsData, Fundamentals } from "../types/financials";
|
|
2
2
|
import { abortable, settleWithin } from "../utils/async-deadline";
|
|
3
|
-
import { distributionHistory, forwardYieldMayHaveLapsed, lapsedDividend, lastPaidNote, NO_CURRENT_DIVIDEND } from "../utils/forward-dividend";
|
|
3
|
+
import { distributionHistory, forwardYieldMayHaveLapsed, historyEndsText, lapsedDividend, lastPaidNote, NO_CURRENT_DIVIDEND } from "../utils/forward-dividend";
|
|
4
4
|
|
|
5
5
|
/**
|
|
6
6
|
* How long a distribution history must go without a dividend before it says a
|
|
@@ -29,6 +29,10 @@ const HISTORY_DEADLINE_MS = 5_000;
|
|
|
29
29
|
* paid 2026-02-27, whose stated 12.91% annualized a payment that did not
|
|
30
30
|
* recur. `lastPaid` dates it.
|
|
31
31
|
*
|
|
32
|
+
* A monthly payer's history that ends (lapsedDividend's `historyEnds`) says
|
|
33
|
+
* nothing of whether it still pays: a stated yield stands, with `historyEnds`
|
|
34
|
+
* the last ex-date its history holds, and none stated stays unknown.
|
|
35
|
+
*
|
|
32
36
|
* Null when none says: an unknown yield is never taken as 0.
|
|
33
37
|
*/
|
|
34
38
|
export interface ModelDividendYield {
|
|
@@ -37,6 +41,8 @@ export interface ModelDividendYield {
|
|
|
37
41
|
basis: "stated" | "none-paid" | "stopped";
|
|
38
42
|
/** The last distribution's ex-date (YYYY-MM-DD) of a `stopped` dividend; null when unknown. */
|
|
39
43
|
lastPaid?: string | null;
|
|
44
|
+
/** A `stated` yield's last ex-date (YYYY-MM-DD) in a monthly payer's history that ends there. */
|
|
45
|
+
historyEnds?: string | null;
|
|
40
46
|
}
|
|
41
47
|
|
|
42
48
|
/** What the yield is read from: the fundamentals' yield, its basis, and the ex-date of the distribution it annualizes. */
|
|
@@ -61,10 +67,16 @@ function paysNoDividend(actions: CorporateActionsData, now: number): boolean {
|
|
|
61
67
|
&& !(actions.declaredDividends ?? []).some((dividend) => recent(dividend.exDate));
|
|
62
68
|
}
|
|
63
69
|
|
|
64
|
-
/**
|
|
65
|
-
|
|
70
|
+
/**
|
|
71
|
+
* 0, dated by the last distribution, when the current history shows the
|
|
72
|
+
* dividend dated `asOf` stopped (lapsedDividend); `stated`, with the day it
|
|
73
|
+
* ends, when a monthly payer's history ends; else `stated`.
|
|
74
|
+
*/
|
|
75
|
+
function checkedDividend(stated: ModelDividendYield | null, asOf: string | undefined, actions: CorporateActionsData, now: number): ModelDividendYield | null {
|
|
66
76
|
const lapse = lapsedDividend(asOf, distributionHistory(actions, new Date(now)), new Date(now));
|
|
67
|
-
|
|
77
|
+
if (!lapse) return stated;
|
|
78
|
+
if (lapse.historyEnds) return stated ? { ...stated, historyEnds: lapse.lastPaid } : null;
|
|
79
|
+
return { value: 0, basis: "stopped", lastPaid: lapse.lastPaid };
|
|
68
80
|
}
|
|
69
81
|
|
|
70
82
|
interface DividendHistoryOptions {
|
|
@@ -96,9 +108,9 @@ export async function loadModelDividendYield(
|
|
|
96
108
|
const read = await abortable(settleWithin(Promise.resolve().then(loadActions), timeoutMs), signal, "Dividend history read was cancelled");
|
|
97
109
|
const actions = currentHistory(read, symbol) ? read : null;
|
|
98
110
|
if (!actions) return statedYield;
|
|
99
|
-
if (statedYield) return
|
|
111
|
+
if (statedYield) return checkedDividend(statedYield, stated?.exDividendDate, actions, now);
|
|
100
112
|
if (paysNoDividend(actions, now)) return { value: 0, basis: "none-paid" };
|
|
101
|
-
return
|
|
113
|
+
return checkedDividend(null, stated?.exDividendDate, actions, now);
|
|
102
114
|
}
|
|
103
115
|
|
|
104
116
|
/** What a yield the history shows none paid is, beside the 0%: `no dividend in the last 15 months`. */
|
|
@@ -107,9 +119,12 @@ const NO_DIVIDEND_PAID = "no dividend in the last 15 months";
|
|
|
107
119
|
/**
|
|
108
120
|
* What a yield read as 0 is, beside the 0%: `no dividend in the last 15
|
|
109
121
|
* months`, or `no current dividend, last paid 2026-02-27` in the words every
|
|
110
|
-
* pane reads a stopped dividend in
|
|
122
|
+
* pane reads a stopped dividend in; beside a stated yield whose monthly
|
|
123
|
+
* history ends, `distribution history ends 2026-09-01`. Null for any other
|
|
124
|
+
* stated yield.
|
|
111
125
|
*/
|
|
112
|
-
export function modelDividendYieldNote(dividend: Pick<ModelDividendYield, "basis" | "lastPaid"> | null | undefined): string | null {
|
|
126
|
+
export function modelDividendYieldNote(dividend: Pick<ModelDividendYield, "basis" | "lastPaid" | "historyEnds"> | null | undefined): string | null {
|
|
127
|
+
if (dividend?.basis === "stated" && dividend.historyEnds) return historyEndsText(dividend.historyEnds);
|
|
113
128
|
if (dividend?.basis === "none-paid") return NO_DIVIDEND_PAID;
|
|
114
129
|
if (dividend?.basis !== "stopped") return null;
|
|
115
130
|
const lastPaid = lastPaidNote({ lastPaid: dividend.lastPaid ?? null });
|
|
@@ -67,9 +67,14 @@ export function isOptionsUnavailableError(error: unknown): boolean {
|
|
|
67
67
|
return /\boptions provider available for\b/i.test(message);
|
|
68
68
|
}
|
|
69
69
|
|
|
70
|
-
/**
|
|
70
|
+
/**
|
|
71
|
+
* "Options are not available for GC=F.": the dead end itself, before any
|
|
72
|
+
* follow-up. A CME currency future says what is not served: "Options on CME
|
|
73
|
+
* yen futures (6J=F) are not served." CME lists them; this app does not.
|
|
74
|
+
*/
|
|
71
75
|
export function optionsUnavailableTitle(symbol: string): string {
|
|
72
|
-
|
|
76
|
+
const typed = symbol.trim().toUpperCase();
|
|
77
|
+
return currencyFutureName(typed) ? fxVolatilityLead(typed) : `Options are not available for ${typed}.`;
|
|
73
78
|
}
|
|
74
79
|
|
|
75
80
|
/**
|
|
@@ -139,6 +144,19 @@ const FX_FUTURES_PAIRS: Readonly<Record<string, string>> = {
|
|
|
139
144
|
"6E": "EURUSD", "6J": "USDJPY", "6B": "GBPUSD", "6A": "AUDUSD", "6C": "USDCAD", "6S": "USDCHF", "6N": "NZDUSD", "6M": "USDMXN",
|
|
140
145
|
};
|
|
141
146
|
|
|
147
|
+
/** What each CME currency future is a future on, as a sentence names it. */
|
|
148
|
+
const FX_FUTURES_CURRENCIES: Readonly<Record<string, string>> = {
|
|
149
|
+
"6E": "euro", "6J": "yen", "6B": "pound", "6A": "Australian dollar", "6C": "Canadian dollar", "6S": "Swiss franc",
|
|
150
|
+
"6N": "New Zealand dollar", "6M": "Mexican peso",
|
|
151
|
+
};
|
|
152
|
+
|
|
153
|
+
/** "yen" for a CME currency future (6J=F, 6JZ26, 6J1); null for anything else. */
|
|
154
|
+
function currencyFutureName(symbol: string): string | null {
|
|
155
|
+
if (currencyPairCode(symbol)) return null;
|
|
156
|
+
const root = futuresRoot(symbol, (candidate) => !!FX_FUTURES_PAIRS[candidate]);
|
|
157
|
+
return root ? FX_FUTURES_CURRENCIES[root] ?? null : null;
|
|
158
|
+
}
|
|
159
|
+
|
|
142
160
|
/** The US-listed currency funds whose options stand in for an FX pair's volatility, by the currency they hold. */
|
|
143
161
|
const FX_VOL_FUNDS: Readonly<Record<string, string>> = { EUR: "FXE", JPY: "FXY", GBP: "FXB" };
|
|
144
162
|
/** The fund that holds the dollar against a basket, for a pair none of the single-currency funds holds. */
|
|
@@ -163,6 +181,17 @@ function fxVolatilityFunds(pair: string): string[] {
|
|
|
163
181
|
return held.length > 0 ? held : FX_VOL_FUND_LIST;
|
|
164
182
|
}
|
|
165
183
|
|
|
184
|
+
/**
|
|
185
|
+
* The one fund whose options stand in for a pair's volatility: the fund that
|
|
186
|
+
* holds its euro, yen or pound (USDJPY: FXY), else the dollar fund for a
|
|
187
|
+
* dollar pair (AUDUSD: UUP). Null for a cross two funds hold, or none.
|
|
188
|
+
*/
|
|
189
|
+
export function fxVolatilityProxyFund(pair: string): string | null {
|
|
190
|
+
const funds = fxVolatilityFunds(pair);
|
|
191
|
+
if (funds === FX_VOL_FUND_LIST) return pair.includes("USD") ? DOLLAR_FUND : null;
|
|
192
|
+
return funds.length === 1 ? funds[0]! : null;
|
|
193
|
+
}
|
|
194
|
+
|
|
166
195
|
/**
|
|
167
196
|
* What exists instead for the volatility of an FX pair or currency future,
|
|
168
197
|
* worded as one line for the CLI: OTC FX volatility is not served, the
|
|
@@ -178,10 +207,16 @@ function fxVolatilityAnswer(code: string, symbol: string): string | null {
|
|
|
178
207
|
const funds = fxVolatilityFunds(pair);
|
|
179
208
|
// VCA screens every fund; the others read the pair's own, or the dollar's when it has none.
|
|
180
209
|
const read = code === "VCA" ? funds.join(",") : funds === FX_VOL_FUND_LIST ? DOLLAR_FUND : funds[0]!;
|
|
181
|
-
return
|
|
210
|
+
return `${fxVolatilityLead(typed)} Currency-ETF options are the listed proxy: `
|
|
182
211
|
+ `${funds.join(", ")} (gloom fn ${code} ${read}). Realized volatility: gloom fn HVT ${typed}.`;
|
|
183
212
|
}
|
|
184
213
|
|
|
214
|
+
/** What is not served: options on a CME currency future, which CME lists, or OTC volatility for a spot pair. */
|
|
215
|
+
function fxVolatilityLead(typed: string): string {
|
|
216
|
+
const currency = currencyFutureName(typed);
|
|
217
|
+
return currency ? `Options on CME ${currency} futures (${typed}) are not served.` : `OTC FX volatility is not covered for ${typed}.`;
|
|
218
|
+
}
|
|
219
|
+
|
|
185
220
|
/**
|
|
186
221
|
* The same for a pane, which has no commands to give: what is not covered,
|
|
187
222
|
* the funds whose options stand in, and HVT for realized volatility.
|
|
@@ -189,7 +224,7 @@ function fxVolatilityAnswer(code: string, symbol: string): string | null {
|
|
|
189
224
|
export function fxVolatilityNote(symbol: string, exchange?: string): string | null {
|
|
190
225
|
const pair = fxVolatilityPair(symbol, exchange);
|
|
191
226
|
if (!pair) return null;
|
|
192
|
-
return
|
|
227
|
+
return `${fxVolatilityLead(symbol.trim().toUpperCase())} Currency-ETF options are the listed proxy: `
|
|
193
228
|
+ `${fxVolatilityFunds(pair).join(", ")}. HVT shows the pair's realized volatility.`;
|
|
194
229
|
}
|
|
195
230
|
|