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
|
@@ -13,6 +13,7 @@ import { isProviderBusy } from "../../../../sources/provider-errors";
|
|
|
13
13
|
import { splitSymbolArgs } from "../../../../cli/symbol-args";
|
|
14
14
|
import { readNameEntryGroups } from "../../../../cli/name-entries";
|
|
15
15
|
import { mapWithConcurrency } from "../../../../utils/concurrency";
|
|
16
|
+
import { quotedListingName } from "../../../../tickers/listing-name";
|
|
16
17
|
import {
|
|
17
18
|
describeFormerIssuer,
|
|
18
19
|
describeTickerChange,
|
|
@@ -166,6 +167,14 @@ function exchangeFromResolved(resolved: ResolvedTickerSearch): string | undefine
|
|
|
166
167
|
: resolved.ticker.metadata.exchange;
|
|
167
168
|
}
|
|
168
169
|
|
|
170
|
+
/** A search row named as its listing's own quote names it, when the quote prices that listing and names it otherwise. */
|
|
171
|
+
function withQuotedListingName(resolved: ResolvedTickerSearch, quote: Quote | null): ResolvedTickerSearch {
|
|
172
|
+
if (resolved.kind !== "provider") return resolved;
|
|
173
|
+
const result = resolved.result;
|
|
174
|
+
const name = quotedListingName(result.exchange === "SMART" ? result.primaryExchange || result.exchange : result.exchange, quote);
|
|
175
|
+
return name && name !== result.name ? { ...resolved, result: { ...result, name } } : resolved;
|
|
176
|
+
}
|
|
177
|
+
|
|
169
178
|
export function tickerNameFromValidation(
|
|
170
179
|
validation: Extract<QuickAddValidation, { status: "ready" | "duplicate" }>,
|
|
171
180
|
): string {
|
|
@@ -231,35 +240,38 @@ export async function resolveQuickAddValidation({
|
|
|
231
240
|
const changes = startTickerChangeLookup(registry.marketData, query);
|
|
232
241
|
|
|
233
242
|
try {
|
|
234
|
-
const
|
|
243
|
+
const found = await resolveTickerSearch({
|
|
235
244
|
query,
|
|
236
245
|
activeTicker: null,
|
|
237
246
|
tickers,
|
|
238
247
|
dataProvider: registry.marketData,
|
|
239
248
|
});
|
|
240
|
-
if (!
|
|
249
|
+
if (!found) {
|
|
241
250
|
const payload = await changes.settle();
|
|
242
251
|
const line = tickerChangeLine(describeTickerChange(query, payload, null)) ?? describeFormerIssuer(query, payload, null)?.note;
|
|
243
252
|
return { status: "missing", query, message: line ?? "No exact ticker match" };
|
|
244
253
|
}
|
|
245
254
|
|
|
246
|
-
const symbol =
|
|
247
|
-
const ticker = tickerForResolved(
|
|
255
|
+
const symbol = found.symbol;
|
|
256
|
+
const ticker = tickerForResolved(found, tickers);
|
|
248
257
|
const cachedQuote = ticker ? financials.get(ticker.metadata.ticker)?.quote ?? null : null;
|
|
249
258
|
// A listing its own quote vouched for comes with it.
|
|
250
|
-
let quote = cachedQuote ?? (
|
|
259
|
+
let quote = cachedQuote ?? (found.kind === "provider" ? found.quote ?? null : null);
|
|
251
260
|
if (!quote) {
|
|
252
261
|
try {
|
|
253
262
|
quote = await registry.marketData.getQuote(
|
|
254
263
|
symbol,
|
|
255
|
-
exchangeFromResolved(
|
|
256
|
-
quoteContextFromResolved(
|
|
264
|
+
exchangeFromResolved(found),
|
|
265
|
+
quoteContextFromResolved(found),
|
|
257
266
|
);
|
|
258
267
|
} catch (error) {
|
|
259
268
|
logFailure("portfolio-list.quick-add.resolution", "Read quick-add quote failed")(error);
|
|
260
269
|
quote = null;
|
|
261
270
|
}
|
|
262
271
|
}
|
|
272
|
+
// The listing's own quote names it, over a search row that names another listing's company:
|
|
273
|
+
// search's BA on LSE read "The Boeing Company" while its quote is BAE Systems, and the row was saved so.
|
|
274
|
+
const resolved = withQuotedListingName(found, quote);
|
|
263
275
|
|
|
264
276
|
// A listing abroad is not the US symbol the changes are of.
|
|
265
277
|
const venue = resolved.kind === "provider" && resolved.result.exchange === "SMART"
|
|
@@ -528,7 +528,9 @@ export function renderSummarySegments(segments: PortfolioSummarySegment[], width
|
|
|
528
528
|
<Box key={segment.id} flexDirection="row">
|
|
529
529
|
{segmentIndex > 0 && <Text fg={colors.textDim}>{" "}</Text>}
|
|
530
530
|
{segment.parts.map((part, partIndex) => (
|
|
531
|
-
|
|
531
|
+
// A row too narrow for its segment cuts the muted basis ("vs Thu 5 Nov close"), never the
|
|
532
|
+
// label or the figure: "Avg +1." read as a different number than +1.02%.
|
|
533
|
+
<Box key={`${segment.id}:${partIndex}`} flexDirection="row" flexShrink={part.tone === "muted" ? 1 : 0}>
|
|
532
534
|
{partIndex > 0 && <Text fg={colors.textDim}>{" "}</Text>}
|
|
533
535
|
<Text
|
|
534
536
|
fg={part.color ?? (part.tone === "label" || part.tone === "muted" ? colors.textDim : colors.text)}
|
|
@@ -17,15 +17,29 @@ import { objectVersion } from "../../../utils/object-version";
|
|
|
17
17
|
import { columnContextVersion, PERPETUAL_COLUMN_IDS } from "./cell-version";
|
|
18
18
|
import { getColumnValue, type ColumnContext } from "./metrics";
|
|
19
19
|
import { periodPnlFigure, tickerDisplayName } from "../../../portfolio/column-values";
|
|
20
|
+
import { listedSymbol } from "../../../portfolio/listed-symbol";
|
|
20
21
|
import { displayWidth } from "../../../utils/format";
|
|
21
22
|
import { dropColumnsToFit } from "../../../components/ui/table-layout";
|
|
22
23
|
import { sinceLastSeenTint, type SinceLastSeenRecap } from "./since-last-seen";
|
|
23
24
|
import { portfolioPnlLabel } from "../../../portfolio/position-metrics";
|
|
24
25
|
import { PORTFOLIO_ROW_MENU_KEYS } from "./row-actions";
|
|
25
26
|
import { isFuturesTicker } from "../../../portfolio/futures-positions";
|
|
27
|
+
import { resolveCurrencyUnit } from "../../../utils/currency-units";
|
|
26
28
|
|
|
27
29
|
export type { QuoteFlashDirection };
|
|
28
30
|
|
|
31
|
+
/**
|
|
32
|
+
* The market cap column, whose caps read in the book's currency, under a
|
|
33
|
+
* header that names it when a row's price is in another (`Mkt Cap TRY` beside
|
|
34
|
+
* BRK.B's dollars), wide enough for it; as it was when every price is in that
|
|
35
|
+
* currency, pence in pounds included.
|
|
36
|
+
*/
|
|
37
|
+
export function marketCapColumn(column: ColumnConfig, currency: string, listed: ReadonlyArray<string | null | undefined>): ColumnConfig {
|
|
38
|
+
if (!listed.some((code) => !!code && resolveCurrencyUnit(code).currency !== currency)) return column;
|
|
39
|
+
const label = `${column.label} ${currency}`;
|
|
40
|
+
return { ...column, label, width: Math.max(column.width, displayWidth(label)) };
|
|
41
|
+
}
|
|
42
|
+
|
|
29
43
|
/** The market-state dot and the space after it, before each symbol in the Ticker column. */
|
|
30
44
|
const TICKER_DOT_WIDTH = 2;
|
|
31
45
|
/**
|
|
@@ -185,6 +199,7 @@ export function PortfolioTickerTable({
|
|
|
185
199
|
rootHeight,
|
|
186
200
|
width,
|
|
187
201
|
answeredSnapshots,
|
|
202
|
+
exportName,
|
|
188
203
|
}: {
|
|
189
204
|
columns: ColumnConfig[];
|
|
190
205
|
focused?: boolean;
|
|
@@ -217,6 +232,8 @@ export function PortfolioTickerTable({
|
|
|
217
232
|
width?: number;
|
|
218
233
|
/** Rows whose financial snapshot answered: until then a company column's dash may still fill in. */
|
|
219
234
|
answeredSnapshots?: ReadonlySet<string>;
|
|
235
|
+
/** The list's name, which names its exported file. */
|
|
236
|
+
exportName?: string;
|
|
220
237
|
}) {
|
|
221
238
|
const cellCacheRef = useRef(createRowValueCache<string, ReturnType<typeof getColumnValue> & TickerTableCell>(5000));
|
|
222
239
|
const openPerpetualRef = useRef(onOpenPerpetual);
|
|
@@ -262,15 +279,23 @@ export function PortfolioTickerTable({
|
|
|
262
279
|
(widest, ticker) => Math.max(widest, displayWidth(resolveCell(sharesColumn, ticker, tableFinancialsMap.get(ticker.metadata.ticker)).text)),
|
|
263
280
|
sharesColumn.width,
|
|
264
281
|
)) : 0;
|
|
265
|
-
// The Ticker column grows to its longest symbol, so ETH-USD
|
|
282
|
+
// The Ticker column grows to its longest symbol, so ETH-USD and BA:LSE show whole beside their market-state dot.
|
|
266
283
|
const tickerWidth = useMemo(() => Math.min(MAX_TICKER_COLUMN_WIDTH, sortedTickers.reduce(
|
|
267
|
-
(widest, ticker) => Math.max(widest, TICKER_DOT_WIDTH + displayWidth(tickerDisplayName(ticker))),
|
|
284
|
+
(widest, ticker) => Math.max(widest, TICKER_DOT_WIDTH + displayWidth(listedSymbol(ticker, tickerDisplayName(ticker), columnContext.homeMarket))),
|
|
268
285
|
0,
|
|
269
|
-
)), [sortedTickers]);
|
|
286
|
+
)), [columnContext.homeMarket, sortedTickers]);
|
|
270
287
|
// A book that holds a short weighs its positions against gross exposure, and the header says so.
|
|
271
288
|
const grossWeights = columnContext.portfolioWeightBasis === "gross";
|
|
289
|
+
// Market caps read in the book's currency: beside a price in another, the header names it (Mkt Cap TRY by a USD price).
|
|
290
|
+
const capCurrency = columnContext.baseCurrency;
|
|
291
|
+
// One code, the first other currency or none, so a quote's tick does not rebuild the columns.
|
|
292
|
+
const otherListedCurrency = useMemo(() => columns.some((column) => column.id === "market_cap")
|
|
293
|
+
? sortedTickers.map((ticker) => tableFinancialsMap.get(ticker.metadata.ticker)?.quote?.currency ?? ticker.metadata.currency)
|
|
294
|
+
.find((code) => !!code && resolveCurrencyUnit(code).currency !== capCurrency) ?? null
|
|
295
|
+
: null, [capCurrency, columns, sortedTickers, tableFinancialsMap]);
|
|
272
296
|
const sizedColumns = useMemo(() => columns.map((column) => column.id === "shares" && hasNonShareQuantity
|
|
273
297
|
? { ...column, label: "QTY", ...(sharesWidth > column.width ? { width: sharesWidth } : {}) }
|
|
298
|
+
: column.id === "market_cap" ? marketCapColumn(column, capCurrency, [otherListedCurrency])
|
|
274
299
|
: column.id === "weight" && grossWeights ? { ...column, label: GROSS_WEIGHT_LABEL }
|
|
275
300
|
: column.id === "ticker" && tickerWidth > column.width ? { ...column, width: tickerWidth }
|
|
276
301
|
: column.id === "pnl_pct" && period ? { ...column, label: CONTRIBUTION_LABEL }
|
|
@@ -278,7 +303,7 @@ export function PortfolioTickerTable({
|
|
|
278
303
|
...column,
|
|
279
304
|
label: column.id === "pnl_pct" ? pnlLabel.replace("P&L", "%") : pnlLabel,
|
|
280
305
|
} : column).map((column) => hasFrontReference && column.id === noteColumnId ? { ...column, flexGrow: 1 } : column),
|
|
281
|
-
[columns, grossWeights, hasFrontReference, hasNonShareQuantity, noteColumnId, period, pnlLabel, sharesWidth, tickerWidth]);
|
|
306
|
+
[capCurrency, columns, grossWeights, hasFrontReference, hasNonShareQuantity, noteColumnId, otherListedCurrency, period, pnlLabel, sharesWidth, tickerWidth]);
|
|
282
307
|
// Read again as the rows' data moves, from the cells the rows show; the columns change only when what is hidden does.
|
|
283
308
|
// The company columns hidden last time, per list, stay hidden while a row added since settles.
|
|
284
309
|
const hiddenCompanyRef = useRef<{ list: string | undefined; ids: ReadonlySet<string> }>({ list: undefined, ids: new Set() });
|
|
@@ -343,6 +368,7 @@ export function PortfolioTickerTable({
|
|
|
343
368
|
addTickerShortcut={addTickerShortcut}
|
|
344
369
|
summaryRows={summaryRows}
|
|
345
370
|
rootHeight={rootHeight}
|
|
371
|
+
exportName={exportName}
|
|
346
372
|
/>
|
|
347
373
|
);
|
|
348
374
|
}
|
|
@@ -24,8 +24,26 @@ export interface RealizedVolEvidenceStatus {
|
|
|
24
24
|
/** The windows the history is too short for: their series have no values, and the capture is whole without them. */
|
|
25
25
|
shortWindows?: number[];
|
|
26
26
|
currentIv: { value: number; date: string; label: string; source: string | null; expiration: number } | null;
|
|
27
|
+
/**
|
|
28
|
+
* An FX pair or currency future: it has no option chain, so no ATM IV is
|
|
29
|
+
* missing from a whole capture. The currency fund's IV30 that stands in is
|
|
30
|
+
* the IV point drawn, when there is one (`proxyIv`, in percent).
|
|
31
|
+
*/
|
|
32
|
+
fxPair?: boolean;
|
|
33
|
+
proxyIv?: { fund: string; value: number; date: string } | null;
|
|
34
|
+
/** The proxy's IV30 is over 5 sessions behind the pair's last bar: no current IV, so the capture is not whole. */
|
|
35
|
+
proxyStale?: boolean;
|
|
27
36
|
}
|
|
28
37
|
|
|
38
|
+
/** The IV point the history view draws: the ATM IV, or for an FX pair the proxy fund's IV30. */
|
|
39
|
+
function ivPoint(status: Pick<RealizedVolEvidenceStatus, "showIv" | "currentIv" | "proxyIv">): { value: number; date: string } | null {
|
|
40
|
+
return status.showIv ? status.currentIv ?? status.proxyIv ?? null : null;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/** Whether a capture still needs an ATM IV it does not have; an FX pair never has one. */
|
|
44
|
+
const missingIv = (status: Pick<RealizedVolEvidenceStatus, "showIv" | "currentIv" | "fxPair">) =>
|
|
45
|
+
status.showIv && status.currentIv == null && status.fxPair !== true;
|
|
46
|
+
|
|
29
47
|
/** A series a short history leaves without values: a selected window it is too short for. */
|
|
30
48
|
function shortSeries(id: string, shortWindows: readonly number[] | undefined): boolean {
|
|
31
49
|
return /^hv-\d+$/.test(id) && (shortWindows ?? []).includes(Number(id.slice(3)));
|
|
@@ -49,7 +67,7 @@ export function realizedVolSemanticEvidence(series: readonly ResolvedSeries[], s
|
|
|
49
67
|
complete: !status.loading && !status.stale && status.errors.length === 0 && !!status.asOf
|
|
50
68
|
&& plotted.length > 0 && plotted.some((entry) => entry.points.some((point) => isFiniteNumber(point.value)))
|
|
51
69
|
&& plotted.every((entry) => shortSeries(entry.id, status.shortWindows) || entry.points.some((point) => isFiniteNumber(point.value)))
|
|
52
|
-
&& (
|
|
70
|
+
&& !missingIv(status) && status.proxyStale !== true,
|
|
53
71
|
};
|
|
54
72
|
}
|
|
55
73
|
|
|
@@ -68,13 +86,18 @@ function readRealizedVolEvidence(value: unknown): RealizedVolEvidence | null {
|
|
|
68
86
|
|| !isStringArray(value.errors)
|
|
69
87
|
|| (value.shortWindows !== undefined && (!Array.isArray(value.shortWindows) || !value.shortWindows.every(isFiniteNumber)))
|
|
70
88
|
|| (value.ivErrors !== undefined && !isStringArray(value.ivErrors))
|
|
89
|
+
|| (value.fxPair !== undefined && typeof value.fxPair !== "boolean")
|
|
90
|
+
|| (value.proxyStale !== undefined && typeof value.proxyStale !== "boolean")
|
|
91
|
+
|| (value.proxyIv != null && (!isRecord(value.proxyIv) || typeof value.proxyIv.fund !== "string"
|
|
92
|
+
|| !isFiniteNumber(value.proxyIv.value) || !isDateString(value.proxyIv.date)))
|
|
71
93
|
|| !Array.isArray(value.series) || !value.series.every((entry) => isRecord(entry) && typeof entry.id === "string"
|
|
72
94
|
&& typeof entry.unit === "string" && Array.isArray(entry.points) && entry.points.every((point) => isRecord(point)
|
|
73
95
|
&& isDateString(point.date) && (point.value === null || isFiniteNumber(point.value))))) return null;
|
|
74
96
|
const evidence = value as unknown as RealizedVolEvidence;
|
|
75
97
|
// The IV point is drawn only when there is one: a chart without it matches its data, and is incomplete for it.
|
|
98
|
+
const point = ivPoint(evidence);
|
|
76
99
|
const required = evidence.view === "graph" ? [...evidence.windows.map((window) => `hv-${window}`), "price",
|
|
77
|
-
...(
|
|
100
|
+
...(point ? ["current-iv"] : [])] : ["min", "max", "mean", "current"];
|
|
78
101
|
if (!required.length || (evidence.view === "graph" && !evidence.windows.length)
|
|
79
102
|
|| evidence.series.length !== required.length || new Set(evidence.series.map((entry) => entry.id)).size !== required.length
|
|
80
103
|
|| required.some((id) => !evidence.series.some((entry) => entry.id === id))) return null;
|
|
@@ -82,12 +105,12 @@ function readRealizedVolEvidence(value: unknown): RealizedVolEvidence | null {
|
|
|
82
105
|
if (count <= 0 || count !== evidence.plottedValueCount) return null;
|
|
83
106
|
if (evidence.currentIv != null && (!isRecord(evidence.currentIv) || !isFiniteNumber(evidence.currentIv.value)
|
|
84
107
|
|| !isDateString(evidence.currentIv.date) || !isFiniteNumber(evidence.currentIv.expiration))) return null;
|
|
85
|
-
if (evidence.view === "graph" &&
|
|
108
|
+
if (evidence.view === "graph" && point) {
|
|
86
109
|
const points = evidence.series.find((entry) => entry.id === "current-iv")!.points;
|
|
87
|
-
if (points.length !== 1 || points[0]!.date !==
|
|
110
|
+
if (points.length !== 1 || points[0]!.date !== point.date || points[0]!.value !== point.value) return null;
|
|
88
111
|
}
|
|
89
112
|
if (evidence.complete && (evidence.loading || evidence.stale || evidence.errors.length > 0
|
|
90
|
-
|| (evidence
|
|
113
|
+
|| missingIv(evidence) || evidence.proxyStale === true
|
|
91
114
|
|| evidence.series.some((entry) => !shortSeries(entry.id, evidence.shortWindows) && !entry.points.some((point) => isFiniteNumber(point.value))))) return null;
|
|
92
115
|
return evidence;
|
|
93
116
|
}
|
|
@@ -95,7 +118,7 @@ function readRealizedVolEvidence(value: unknown): RealizedVolEvidence | null {
|
|
|
95
118
|
/** Drawn, current and whole but for the current IV, whose errors are the only ones. */
|
|
96
119
|
function missingOnlyIv(evidence: RealizedVolEvidence): boolean {
|
|
97
120
|
const ivErrors = new Set(evidence.ivErrors ?? []);
|
|
98
|
-
return evidence.view === "graph" && evidence
|
|
121
|
+
return evidence.view === "graph" && missingIv(evidence)
|
|
99
122
|
&& !evidence.loading && !evidence.stale && evidence.plottedValueCount > 0
|
|
100
123
|
&& evidence.errors.every((error) => ivErrors.has(error))
|
|
101
124
|
&& evidence.series.every((entry) => shortSeries(entry.id, evidence.shortWindows) || entry.points.some((point) => isFiniteNumber(point.value)));
|
|
@@ -123,6 +146,10 @@ export const realizedVolScreenshotEvidence: PaneScreenshotEvidenceHook<RealizedV
|
|
|
123
146
|
if (evidence?.complete && !evidence.loading) return [];
|
|
124
147
|
// The volatility drawn whole and only the IV point missing: the capture names the IV, not the symbol.
|
|
125
148
|
if (evidence && missingOnlyIv(evidence)) return [`${symbol ?? evidence.symbol} current ATM IV`];
|
|
149
|
+
// An FX pair whose proxy IV30 is stale: what is missing is a current IV30 of the fund.
|
|
150
|
+
if (evidence?.proxyStale && evidence.proxyIv && !evidence.loading && !evidence.stale && evidence.errors.length === 0) {
|
|
151
|
+
return [`${evidence.proxyIv.fund} current IV30`];
|
|
152
|
+
}
|
|
126
153
|
return [symbol ?? "realized volatility"];
|
|
127
154
|
},
|
|
128
155
|
};
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
import { apiClient } from "../../../api-client";
|
|
2
|
+
import type { BarsPerYearInstrument } from "../../../market-data/bars-per-year";
|
|
3
|
+
import { fxVolatilityPair, fxVolatilityProxyFund } from "../../../market-data/options-alternatives";
|
|
4
|
+
import type { PricePoint } from "../../../types/financials";
|
|
5
|
+
import { abortError } from "../../../utils/async-deadline";
|
|
6
|
+
import { errorMessage } from "../../../utils/errors";
|
|
7
|
+
import { loadIvHistory, type ImpliedVolatilityApi, type IvHistoryPayload, type IvMethod } from "../iv-history/client";
|
|
8
|
+
import { staleness } from "../iv-history/model";
|
|
9
|
+
import { realizedVolatilityResult } from "../shared/volatility";
|
|
10
|
+
import { createSurfaceDependencies, loadVolatilitySurface, type SurfaceLoaderDependencies } from "../vol-surface/client";
|
|
11
|
+
import type { SurfaceSnapshot } from "../vol-surface/model";
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* An FX pair has no option chain here, and OTC FX volatility is not served:
|
|
15
|
+
* the options of a currency fund that holds one side of it (USDJPY: FXY) are
|
|
16
|
+
* the listed proxy. A thin one: the fund's chains often price an ATM level on
|
|
17
|
+
* one or two expiries, and its IV reads above interbank FX volatility. So the
|
|
18
|
+
* proxy is shown with its date, how many of the fund's expiries priced, and
|
|
19
|
+
* how far its IV30 sits above the pair's own realized volatility.
|
|
20
|
+
*/
|
|
21
|
+
export interface FxVolProxy {
|
|
22
|
+
/** The pair the symbol is (USDJPY for USDJPY=X or 6J=F). */
|
|
23
|
+
pair: string;
|
|
24
|
+
/** The fund whose options stand in (FXY). */
|
|
25
|
+
fund: string;
|
|
26
|
+
/** The fund's stored 30-day IV on its latest ranked close; null when there is none. */
|
|
27
|
+
iv30: { value: number; date: string; method: IvMethod } | null;
|
|
28
|
+
/** The fund's listed expiries that price an ATM IV now, of those read; null when its chains could not be read. */
|
|
29
|
+
expiries: { usable: number; read: number } | null;
|
|
30
|
+
/** What could not be read, said once: the proxy's history or its chains. */
|
|
31
|
+
error: string | null;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
export interface FxVolProxyDependencies {
|
|
35
|
+
iv: ImpliedVolatilityApi;
|
|
36
|
+
surface: SurfaceLoaderDependencies;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
const CANCELLED = "FX volatility proxy load was cancelled";
|
|
40
|
+
const usableAtm = (value: number | null) => value != null && Number.isFinite(value) && value > 0;
|
|
41
|
+
|
|
42
|
+
/** The fund's 30-day IV on the close its rank is read on, else its newest reading with one. */
|
|
43
|
+
function proxyIv30(payload: IvHistoryPayload): FxVolProxy["iv30"] {
|
|
44
|
+
const ranked = payload.stats?.iv30;
|
|
45
|
+
if (ranked && Number.isFinite(ranked.value) && ranked.value > 0) return { value: ranked.value, date: ranked.date, method: ranked.method };
|
|
46
|
+
const row = [...payload.series ?? []].reverse().find((point) => usableAtm(point.iv30));
|
|
47
|
+
return row ? { value: row.iv30!, date: row.sessionDate, method: row.method } : null;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/** The fund's spot for its chains: the newest stored reading's. */
|
|
51
|
+
function proxySpot(payload: IvHistoryPayload): number | null {
|
|
52
|
+
if (payload.latest?.spot && payload.latest.spot > 0) return payload.latest.spot;
|
|
53
|
+
return [...payload.series ?? []].reverse().find((point) => point.spot != null && point.spot > 0)?.spot ?? null;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/** How many expiries read price an ATM IV that is not stale or failed. */
|
|
57
|
+
function usableExpiries(surface: SurfaceSnapshot): FxVolProxy["expiries"] {
|
|
58
|
+
if (!surface.expiries.length) return null;
|
|
59
|
+
return { usable: surface.expiries.filter((expiry) => usableAtm(expiry.atmIV) && !expiry.stale && !expiry.error).length,
|
|
60
|
+
read: surface.expiries.length };
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/** Null for a symbol that is no FX pair or currency future, or a pair no single fund stands in for. */
|
|
64
|
+
export async function loadFxVolProxy(
|
|
65
|
+
request: { symbol: string; exchange?: string; signal?: AbortSignal },
|
|
66
|
+
dependencies: FxVolProxyDependencies = { iv: apiClient, surface: createSurfaceDependencies() },
|
|
67
|
+
): Promise<FxVolProxy | null> {
|
|
68
|
+
const pair = fxVolatilityPair(request.symbol, request.exchange);
|
|
69
|
+
const fund = pair ? fxVolatilityProxyFund(pair) : null;
|
|
70
|
+
if (!pair || !fund) return null;
|
|
71
|
+
if (request.signal?.aborted) throw abortError(CANCELLED);
|
|
72
|
+
let payload: IvHistoryPayload;
|
|
73
|
+
try {
|
|
74
|
+
payload = await loadIvHistory(fund, { signal: request.signal, days: 40 }, dependencies.iv);
|
|
75
|
+
} catch (error) {
|
|
76
|
+
if (request.signal?.aborted) throw abortError(CANCELLED);
|
|
77
|
+
return { pair, fund, iv30: null, expiries: null, error: `${fund} IV history: ${errorMessage(error)}` };
|
|
78
|
+
}
|
|
79
|
+
const iv30 = proxyIv30(payload);
|
|
80
|
+
const spot = proxySpot(payload);
|
|
81
|
+
let expiries: FxVolProxy["expiries"] = null;
|
|
82
|
+
let error: string | null = null;
|
|
83
|
+
if (spot != null) {
|
|
84
|
+
try {
|
|
85
|
+
expiries = usableExpiries(await loadVolatilitySurface({ instrument: { symbol: fund }, spot, signal: request.signal }, dependencies.surface));
|
|
86
|
+
} catch (failure) {
|
|
87
|
+
if (request.signal?.aborted) throw abortError(CANCELLED);
|
|
88
|
+
error = `${fund} options: ${errorMessage(failure)}`;
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
return { pair, fund, iv30, expiries, error: error ?? (iv30 ? null : `${fund} has no IV30 yet`) };
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
/** The day of a bar, UTC. */
|
|
95
|
+
const barDay = (point: PricePoint) => new Date(point.date).toISOString().slice(0, 10);
|
|
96
|
+
|
|
97
|
+
export interface FxProxyReading {
|
|
98
|
+
/** The pair's close-to-close HV20 on the proxy's IV30 close; null when the IV30 is stale or missing. */
|
|
99
|
+
hv20: number | null;
|
|
100
|
+
/** IV30 less that HV20; null as HV20 is. */
|
|
101
|
+
spread: number | null;
|
|
102
|
+
/**
|
|
103
|
+
* The IV30 is over 5 of the fund's sessions behind the pair's last bar, as HIVG
|
|
104
|
+
* counts a stale reading: FXB's IV30 of 18 May beside a November cone.
|
|
105
|
+
*/
|
|
106
|
+
stale: boolean;
|
|
107
|
+
/** What a stale IV30 says: "FXB has no IV30 since 2026-05-18". */
|
|
108
|
+
note: string | null;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/**
|
|
112
|
+
* The proxy's IV30 read against the pair: its age against the pair's last bar
|
|
113
|
+
* (stale over 5 sessions, iv-history's `staleness`), and while it is current,
|
|
114
|
+
* the pair's 20-bar realized volatility on the IV30's close and the IV30 less
|
|
115
|
+
* it, HIVG's IV30 - HV20 with the fund's IV against the pair's own moves.
|
|
116
|
+
* Close to close, whatever the pane's estimator, as HIVG reads it, and over
|
|
117
|
+
* the pair's year (`instrument`: 260 bars for USDJPY=X, 252 for 6J=F). A stale
|
|
118
|
+
* IV30 is no reading of the pair now: IV30 - HV20 is left out.
|
|
119
|
+
*/
|
|
120
|
+
export function fxProxyIvLessRv(proxy: FxVolProxy | null, history: readonly PricePoint[], instrument: BarsPerYearInstrument = {}): FxProxyReading {
|
|
121
|
+
if (!proxy?.iv30) return { hv20: null, spread: null, stale: false, note: null };
|
|
122
|
+
const through = proxy.iv30.date;
|
|
123
|
+
const lastBar = history.length ? history.map(barDay).sort().at(-1)! : null;
|
|
124
|
+
if (staleness(through, lastBar).stale) {
|
|
125
|
+
return { hv20: null, spread: null, stale: true, note: `${proxy.fund} has no IV30 since ${through}` };
|
|
126
|
+
}
|
|
127
|
+
const upTo = history.filter((point) => barDay(point) <= through);
|
|
128
|
+
const hv20 = upTo.length ? realizedVolatilityResult(upTo, 20, "close-to-close", instrument).value : null;
|
|
129
|
+
return { hv20, spread: hv20 == null ? null : proxy.iv30.value - hv20, stale: false, note: null };
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/** "FXY IV30", the label the proxy reads under in the pane, the chart legend and the report. */
|
|
133
|
+
export const fxProxyLabel = (proxy: Pick<FxVolProxy, "fund">) => `${proxy.fund} IV30`;
|
|
134
|
+
/** What the proxy is, said once: "FXY options, a thin ETF proxy". */
|
|
135
|
+
export const fxProxyNote = (proxy: Pick<FxVolProxy, "fund">) => `${proxy.fund} options, a thin ETF proxy`;
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { barsPerYearLabel } from "../../../market-data/bars-per-year";
|
|
1
|
+
import { barsPerYearLabel, currencyPairInstrument } from "../../../market-data/bars-per-year";
|
|
2
2
|
import type { HeadlessPaneDefinition } from "../../../types/plugin";
|
|
3
3
|
import { createSurfaceDependencies } from "../vol-surface/client";
|
|
4
4
|
import { resolveHeadlessInstrument } from "../shared/headless-market-data";
|
|
@@ -7,6 +7,30 @@ import { atmIvObservedLabel, projectRealizedVolatility, type CurrentAtmIvSnapsho
|
|
|
7
7
|
import { ESTIMATOR_OPTIONS, selectedWindows } from "./settings";
|
|
8
8
|
import { DAILY_CLOSES } from "../shared/report-freshness";
|
|
9
9
|
import { listingAbroadVenue } from "../../../utils/sec";
|
|
10
|
+
import { fxVolatilityPair } from "../../../market-data/options-alternatives";
|
|
11
|
+
import { fxProxyIvLessRv, fxProxyLabel, fxProxyNote, loadFxVolProxy, type FxProxyReading, type FxVolProxy } from "./fx-proxy";
|
|
12
|
+
import type { HeadlessBundleSection } from "../../../types/headless";
|
|
13
|
+
|
|
14
|
+
const percent = (value: number | null | undefined) => value == null ? "--" : `${(value * 100).toFixed(2)}%`;
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* An FX pair's IV section: the fund whose options stand in, its IV30 and the
|
|
18
|
+
* close it is from, how many of its expiries price, and IV30 less the pair's
|
|
19
|
+
* HV20 on that close. There is no ATM IV of the pair's own to show.
|
|
20
|
+
*/
|
|
21
|
+
function fxProxySection(proxy: FxVolProxy, reading: FxProxyReading): HeadlessBundleSection {
|
|
22
|
+
const { hv20, spread, stale } = reading;
|
|
23
|
+
return { title: "FX vol proxy", entries: [
|
|
24
|
+
{ label: "Proxy", value: proxy.fund, formatted: fxProxyNote(proxy) },
|
|
25
|
+
{ label: fxProxyLabel(proxy), value: proxy.iv30?.value ?? null, formatted: percent(proxy.iv30?.value) },
|
|
26
|
+
{ label: "Close", value: proxy.iv30?.date ?? null,
|
|
27
|
+
formatted: proxy.iv30 ? `${proxy.iv30.date}${proxy.iv30.method === "quote-mid" ? " (quote mid)" : ""}${stale ? ", stale" : ""}` : "--" },
|
|
28
|
+
{ label: "Expiries with ATM IV", value: proxy.expiries?.usable ?? null,
|
|
29
|
+
formatted: proxy.expiries ? `${proxy.expiries.usable} of ${proxy.expiries.read}` : "--" },
|
|
30
|
+
{ label: "Pair HV20", value: hv20, formatted: percent(hv20) },
|
|
31
|
+
{ label: "IV30 - HV20", value: spread, formatted: spread == null ? "--" : `${spread >= 0 ? "+" : ""}${(spread * 100).toFixed(2)} pts` },
|
|
32
|
+
] };
|
|
33
|
+
}
|
|
10
34
|
|
|
11
35
|
export function realizedVolHeadless(initialView: "graph" | "cone"): HeadlessPaneDefinition<"bundle"> {
|
|
12
36
|
return {
|
|
@@ -30,8 +54,10 @@ export function realizedVolHeadless(initialView: "graph" | "cone"): HeadlessPane
|
|
|
30
54
|
const instrument = await resolveHeadlessInstrument(ctx, args.symbols[0]!);
|
|
31
55
|
// Options are US listings'; SAN:EPA has none, and bare SAN's chain is another company's.
|
|
32
56
|
const abroad = listingAbroadVenue(args.symbols[0]!) != null;
|
|
57
|
+
// An FX pair or currency future has no chain of its own: a currency fund's options stand in, labelled so.
|
|
58
|
+
const fx = fxVolatilityPair(instrument.symbol, instrument.exchange) != null;
|
|
33
59
|
const currentIv = async (): Promise<CurrentAtmIvSnapshot | null> => {
|
|
34
|
-
if (!args.options.showIv) return null;
|
|
60
|
+
if (!args.options.showIv || fx) return null;
|
|
35
61
|
if (abroad) return { reference: null, error: null, warnings: [], noOptionChain: true };
|
|
36
62
|
try {
|
|
37
63
|
const quote = await ctx.marketData.getQuote(instrument.symbol, instrument.exchange);
|
|
@@ -43,14 +69,19 @@ export function realizedVolHeadless(initialView: "graph" | "cone"): HeadlessPane
|
|
|
43
69
|
return { reference: null, warnings: [], error: `Current ATM IV: ${error instanceof Error ? error.message : String(error)}` };
|
|
44
70
|
}
|
|
45
71
|
};
|
|
46
|
-
const
|
|
72
|
+
const fxProxy = async (): Promise<FxVolProxy | null> => !args.options.showIv || !fx ? null
|
|
73
|
+
: loadFxVolProxy({ symbol: instrument.symbol, exchange: instrument.exchange, signal: ctx.signal },
|
|
74
|
+
{ iv: ctx.apiClient, surface: createSurfaceDependencies(ctx.marketData, ctx.apiClient) });
|
|
75
|
+
const [history, iv, proxy] = await Promise.all([
|
|
47
76
|
loadRealizedVolatilityHistory({ instrument, signal: ctx.signal }, createRealizedVolatilityDependencies(ctx.marketData)), currentIv(),
|
|
77
|
+
fxProxy(),
|
|
48
78
|
]);
|
|
49
79
|
ctx.signal.throwIfAborted();
|
|
50
|
-
const model = projectRealizedVolatility(history.history, { symbol: instrument.symbol,
|
|
80
|
+
const model = projectRealizedVolatility(history.history, { symbol: instrument.symbol, exchange: instrument.exchange,
|
|
51
81
|
estimator: ESTIMATOR_OPTIONS.find(({ value }) => value === args.options.estimator)?.value,
|
|
52
82
|
windows, lookbackYears: Number(args.options.lookbackYears) === 2 ? 2 : 1 });
|
|
53
83
|
const errors = [history.error, iv?.error].filter((value): value is string => !!value);
|
|
84
|
+
const proxyReading = proxy ? fxProxyIvLessRv(proxy, history.history, currencyPairInstrument(instrument.symbol, instrument.exchange)) : null;
|
|
54
85
|
// The cone rows are as of the last daily bar, not of when the report ran.
|
|
55
86
|
const lastBar = model.asOf && Number.isFinite(model.asOf.getTime()) ? model.asOf.toISOString().slice(0, 10) : null;
|
|
56
87
|
return {
|
|
@@ -65,7 +96,7 @@ export function realizedVolHeadless(initialView: "graph" | "cone"): HeadlessPane
|
|
|
65
96
|
{ key: "percentile", header: "Percentile", format: (value) => typeof value === "number" ? `${value.toFixed(1)}%` : "--" },
|
|
66
97
|
{ key: "sampleSize", header: "Samples" },
|
|
67
98
|
], rows: model.cone.map((row) => ({ ...row })) },
|
|
68
|
-
{ title: "Current IV", entries: [
|
|
99
|
+
...proxy && proxyReading ? [fxProxySection(proxy, proxyReading)] : fx ? [] : [{ title: "Current IV", entries: [
|
|
69
100
|
{ label: "ATM IV", value: iv?.reference?.value ?? null, formatted: iv?.reference ? `${(iv.reference.value * 100).toFixed(2)}%` : "--" },
|
|
70
101
|
{ label: "Expiry", value: iv?.reference?.expiration ?? null,
|
|
71
102
|
formatted: iv?.reference ? new Date(iv.reference.expiration * 1000).toISOString().slice(0, 10) : "--" },
|
|
@@ -74,15 +105,20 @@ export function realizedVolHeadless(initialView: "graph" | "cone"): HeadlessPane
|
|
|
74
105
|
// To the minute, as the pane reads it; the JSON keeps the chain's read time whole.
|
|
75
106
|
{ label: "Observed", value: iv?.reference?.date.toISOString() ?? null,
|
|
76
107
|
formatted: iv?.reference ? atmIvObservedLabel(iv.reference.date) : "--" },
|
|
77
|
-
] },
|
|
108
|
+
] }],
|
|
78
109
|
],
|
|
79
110
|
// A short history is whole: the windows it is too short for have no estimate yet, and the note says when it starts.
|
|
80
111
|
complete: model.cone.every((row) => row.current != null || model.shortWindows.includes(row.window))
|
|
81
112
|
&& model.warnings.length === 0 && !history.stale && errors.length === 0
|
|
82
|
-
&& (!args.options.showIv || iv?.reference != null || iv?.noOptionChain === true)
|
|
113
|
+
&& (!args.options.showIv || fx || iv?.reference != null || iv?.noOptionChain === true)
|
|
114
|
+
// A proxy IV30 over 5 sessions old is no current IV for the pair.
|
|
115
|
+
&& !proxyReading?.stale,
|
|
83
116
|
unavailableSymbols: model.history.length ? [] : [instrument.symbol], errors,
|
|
84
|
-
|
|
117
|
+
// A proxy that could not be read leaves the pair's own volatility whole: said, not failed.
|
|
118
|
+
notes: [barsPerYearLabel(model.barsPerYear), ...model.historyNote ? [model.historyNote] : [], ...proxy?.error ? [proxy.error] : [],
|
|
119
|
+
...proxyReading?.note ? [proxyReading.note] : []],
|
|
85
120
|
metadata: { unit: "decimal annualized volatility", annualization: model.barsPerYear, model, currentIv: iv,
|
|
121
|
+
...proxy ? { fxVolProxy: { ...proxy, ...proxyReading } } : {},
|
|
86
122
|
...(abroad && args.options.showIv ? { notices: [`Options data covers US listings only, so ${args.symbols[0]} has no current IV.`] } : {}),
|
|
87
123
|
source: history.source, stale: history.stale, fetchedAt: history.fetchedAt,
|
|
88
124
|
methodology: "docs/research-data.md#shared-volatility-calculations" },
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { barsPerYear, type BarsPerYear } from "../../../market-data/bars-per-year";
|
|
1
|
+
import { barsPerYear, currencyPairInstrument, type BarsPerYear } from "../../../market-data/bars-per-year";
|
|
2
2
|
import type { PricePoint } from "../../../types/financials";
|
|
3
3
|
import {
|
|
4
4
|
REALIZED_VOLATILITY_WINDOWS, realizedVolatilityCadenceIssue, realizedVolatilityResult, rollingRealizedVolatility, volatilityCone,
|
|
@@ -48,6 +48,8 @@ function windowsText(windows: readonly number[]): string {
|
|
|
48
48
|
|
|
49
49
|
export interface RealizedVolatilityProjectionOptions {
|
|
50
50
|
symbol: string;
|
|
51
|
+
/** The listing's exchange: a CCY listing is a currency pair, annualised at 260 bars as USDJPY=X is. */
|
|
52
|
+
exchange?: string;
|
|
51
53
|
estimator?: RealizedVolatilityEstimator;
|
|
52
54
|
lookbackYears?: 1 | 2;
|
|
53
55
|
windows?: readonly number[];
|
|
@@ -67,6 +69,8 @@ export function projectRealizedVolatility(
|
|
|
67
69
|
): RealizedVolatilityModel {
|
|
68
70
|
const estimator = options.estimator ?? "close-to-close";
|
|
69
71
|
const lookbackYears = options.lookbackYears === 2 ? 2 : 1;
|
|
72
|
+
// A currency pair's year is every weekday, however much of its history is loaded.
|
|
73
|
+
const instrument = currencyPairInstrument(options.symbol, options.exchange);
|
|
70
74
|
const windows = [...new Set(options.windows ?? REALIZED_VOLATILITY_WINDOWS)]
|
|
71
75
|
.filter((window) => REALIZED_VOLATILITY_WINDOWS.some((standard) => standard === window));
|
|
72
76
|
const warnings: string[] = [];
|
|
@@ -98,13 +102,13 @@ export function projectRealizedVolatility(
|
|
|
98
102
|
if (cadenceIssue) warnings.push(cadenceIssue);
|
|
99
103
|
const series = cadenceIssue
|
|
100
104
|
? history.map((point) => ({ date: point.date, values: Object.fromEntries(windows.map((window) => [window, null])) }))
|
|
101
|
-
: rollingRealizedVolatility(history, { windows, estimator });
|
|
102
|
-
const cone = volatilityCone(cadenceIssue ? [] : history, { estimator, lookbackYears });
|
|
105
|
+
: rollingRealizedVolatility(history, { windows, estimator, instrument });
|
|
106
|
+
const cone = volatilityCone(cadenceIssue ? [] : history, { estimator, lookbackYears, instrument });
|
|
103
107
|
const visible = history.filter((point) => point.date.getTime() > cutoff);
|
|
104
108
|
const visibleSeries = series.filter((point) => point.date.getTime() > cutoff);
|
|
105
109
|
if (history.length > 0 && history[0]!.date.getTime() > cutoff) shortLookback = true;
|
|
106
110
|
for (const window of history.length > 0 && !cadenceIssue ? REALIZED_VOLATILITY_WINDOWS : []) {
|
|
107
|
-
const result = realizedVolatilityResult(history, window, estimator);
|
|
111
|
+
const result = realizedVolatilityResult(history, window, estimator, instrument);
|
|
108
112
|
if (result.reason === "insufficient-history") shortWindows.push(window);
|
|
109
113
|
else if (result.reason) warnings.push(`HV${window} unavailable: ${result.reason.replaceAll("-", " ")}`);
|
|
110
114
|
}
|
|
@@ -122,7 +126,7 @@ export function projectRealizedVolatility(
|
|
|
122
126
|
? `${windowsText(shortWindows)} need${shortWindows.length === 1 ? "s" : ""} more`
|
|
123
127
|
: "the long windows' cone covers part of the lookback"}`;
|
|
124
128
|
return { symbol: options.symbol.trim().toUpperCase(), estimator, lookbackYears, windows,
|
|
125
|
-
history: visible, series: visibleSeries, cone, asOf, barsPerYear: barsPerYear(history.map((point) => point.date)),
|
|
129
|
+
history: visible, series: visibleSeries, cone, asOf, barsPerYear: barsPerYear(history.map((point) => point.date), instrument),
|
|
126
130
|
warnings: [...new Set(warnings)], shortWindows, historyNote, formingNote };
|
|
127
131
|
}
|
|
128
132
|
|