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
|
@@ -343,8 +343,21 @@ export function rankTickerSearchItems<T extends Pick<TickerSearchRankableItem, "
|
|
|
343
343
|
// stocks over funds (GLD) put a thinly traded company first.
|
|
344
344
|
const exactIssuerRank = new Map<string, number>();
|
|
345
345
|
const exactIssuerKey = (entry: RankedEntry) => getIssuerGroupKey(entry.item.detail) || `item:${entry.index}`;
|
|
346
|
+
// A lettered symbol is first its US listing, as the app resolves a bare symbol (`quote AAL` is American
|
|
347
|
+
// Airlines): the companies under it that trade on a US exchange, then those with a line the service marks as
|
|
348
|
+
// their home, the listed companies it knows abroad (ISP is Intesa). A word written as a name (`Aeon`) may be the
|
|
349
|
+
// company of that name, so no US line goes ahead for it. A code of digits is one market's code (Hong Kong,
|
|
350
|
+
// Tokyo, Taipei), and the mark says nothing between markets there: BYD's home is Shenzhen, not its Hong Kong
|
|
351
|
+
// 1211, so the server's order of markets stands.
|
|
352
|
+
const exactIssuerUs = new Set<string>();
|
|
353
|
+
const exactIssuerHome = new Set<string>();
|
|
354
|
+
const lettered = /\p{L}/u.test(query);
|
|
355
|
+
const usFirst = readsAsUsTicker(query);
|
|
346
356
|
for (const entry of filtered) {
|
|
347
|
-
if (entry.symbolMatchRank !== 4
|
|
357
|
+
if (entry.symbolMatchRank !== 4) continue;
|
|
358
|
+
if (usFirst && isUsLine(entry.item)) exactIssuerUs.add(exactIssuerKey(entry));
|
|
359
|
+
if (lettered && entry.item.homeListing === true) exactIssuerHome.add(exactIssuerKey(entry));
|
|
360
|
+
if (entry.item.providerRank == null) continue;
|
|
348
361
|
const key = exactIssuerKey(entry);
|
|
349
362
|
exactIssuerRank.set(key, Math.min(entry.item.providerRank, exactIssuerRank.get(key) ?? Number.POSITIVE_INFINITY));
|
|
350
363
|
}
|
|
@@ -450,6 +463,35 @@ export function rankTickerSearchItems<T extends Pick<TickerSearchRankableItem, "
|
|
|
450
463
|
if (aProviderRank !== bProviderRank) return aProviderRank - bProviderRank;
|
|
451
464
|
return compareFallbackEntries(a, b);
|
|
452
465
|
}
|
|
466
|
+
// A symbol typed whole asks for a listing under it, not a name. The companies listed under it go saved
|
|
467
|
+
// first, then the ones trading on a US exchange (`exactIssuerUs`), then the ones the service marks a home
|
|
468
|
+
// line of (`exactIssuerHome`), then in the server's order (`exactIssuerRank`). A company whose name only is
|
|
469
|
+
// or starts with the letters gets no head start (AXP Energy for AXP, CAT Strategic Metals for CAT), and a
|
|
470
|
+
// line with no name or venue of its own (a Toronto `JNJ` named JNJ, an old line of ISP) follows the
|
|
471
|
+
// companies.
|
|
472
|
+
if (aExactSymbolRank === 4) {
|
|
473
|
+
const aSaved = isSavedSearchItem(a.item);
|
|
474
|
+
const bSaved = isSavedSearchItem(b.item);
|
|
475
|
+
if (aSaved !== bSaved) return aSaved ? -1 : 1;
|
|
476
|
+
const aPlaceholder = isPlaceholderLine(a.item);
|
|
477
|
+
const bPlaceholder = isPlaceholderLine(b.item);
|
|
478
|
+
if (aPlaceholder !== bPlaceholder) return aPlaceholder ? 1 : -1;
|
|
479
|
+
const aUs = exactIssuerUs.has(exactIssuerKey(a));
|
|
480
|
+
const bUs = exactIssuerUs.has(exactIssuerKey(b));
|
|
481
|
+
if (aUs !== bUs) return aUs ? -1 : 1;
|
|
482
|
+
const aHome = exactIssuerHome.has(exactIssuerKey(a));
|
|
483
|
+
const bHome = exactIssuerHome.has(exactIssuerKey(b));
|
|
484
|
+
if (aHome !== bHome) return aHome ? -1 : 1;
|
|
485
|
+
const aIssuerRank = exactIssuerRank.get(exactIssuerKey(a)) ?? Number.POSITIVE_INFINITY;
|
|
486
|
+
const bIssuerRank = exactIssuerRank.get(exactIssuerKey(b)) ?? Number.POSITIVE_INFINITY;
|
|
487
|
+
if (aIssuerRank !== bIssuerRank) return aIssuerRank - bIssuerRank;
|
|
488
|
+
// Of one company's lines, its US line leads (RACE is Ferrari on NYSE, before Milan).
|
|
489
|
+
if (aUs && exactIssuerKey(a) === exactIssuerKey(b)) {
|
|
490
|
+
const aLine = isUsLine(a.item);
|
|
491
|
+
const bLine = isUsLine(b.item);
|
|
492
|
+
if (aLine !== bLine) return aLine ? -1 : 1;
|
|
493
|
+
}
|
|
494
|
+
}
|
|
453
495
|
if (b.companyRank !== a.companyRank) {
|
|
454
496
|
return b.companyRank - a.companyRank;
|
|
455
497
|
}
|
|
@@ -874,6 +916,31 @@ function namesUsCompany(
|
|
|
874
916
|
&& !!item.searchAliases?.some((alias) => compactSearchText(alias) === typed));
|
|
875
917
|
}
|
|
876
918
|
|
|
919
|
+
/**
|
|
920
|
+
* A search line that names no company or venue of its own: its name is its
|
|
921
|
+
* symbol or empty (an old line search keeps for a ticker, a Toronto `HD`
|
|
922
|
+
* named HD), or it lists on no exchange.
|
|
923
|
+
*/
|
|
924
|
+
export function isPlaceholderLine(item: Pick<TickerSearchRankableItem, "label" | "detail" | "kind"> & Partial<TickerSearchRankableItem>): boolean {
|
|
925
|
+
if (item.kind !== "search") return false;
|
|
926
|
+
const name = compactSearchText(item.detail.split("|")[0] || "");
|
|
927
|
+
return !name || name === compactSearchText(item.symbol || item.label) || !(item.exchangeLabel || item.primaryExchangeLabel);
|
|
928
|
+
}
|
|
929
|
+
|
|
930
|
+
/**
|
|
931
|
+
* A lettered symbol typed as a ticker (`AAL`, `aal`), which is its US listing when it has one, rather than a word
|
|
932
|
+
* written as a company's name (`Aeon`) or a code of digits.
|
|
933
|
+
*/
|
|
934
|
+
export function readsAsUsTicker(query: string): boolean {
|
|
935
|
+
const typed = query.trim();
|
|
936
|
+
return /\p{L}/u.test(typed) && !/^\p{Lu}\p{Ll}/u.test(typed);
|
|
937
|
+
}
|
|
938
|
+
|
|
939
|
+
/** A search line of a company's own on a US exchange that still trades: not a placeholder, OTC or Toronto line. */
|
|
940
|
+
function isUsLine(item: Pick<TickerSearchRankableItem, "label" | "detail" | "kind"> & Partial<TickerSearchRankableItem>): boolean {
|
|
941
|
+
return item.kind === "search" && !item.delisted && isUsListingExchange(listingVenue(item)) && !isPlaceholderLine(item);
|
|
942
|
+
}
|
|
943
|
+
|
|
877
944
|
function isDepositaryReceiptType(type?: string): boolean {
|
|
878
945
|
const normalized = normalizeSearchText(type || "");
|
|
879
946
|
return normalized.includes("DEPOSITARY") || ["ADR", "ADS", "GDR", "CDR", "BDR"].includes(normalized);
|
|
@@ -26,6 +26,10 @@ export interface TickerSearchRankableItem {
|
|
|
26
26
|
primaryExchangeLabel?: string;
|
|
27
27
|
providerRank?: number;
|
|
28
28
|
popularity?: number;
|
|
29
|
+
/** The service marks the row as its company's home line (`InstrumentSearchResult.homeListing`). */
|
|
30
|
+
homeListing?: boolean;
|
|
31
|
+
/** The service says the line no longer trades (`InstrumentSearchResult.delisting`). */
|
|
32
|
+
delisted?: boolean;
|
|
29
33
|
searchAliases?: string[];
|
|
30
34
|
/**
|
|
31
35
|
* The names the service sent the row for (`InstrumentSearchResult.searchAliases`: a trade name, or the name a
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { futuresContractByCode } from "../market-data/futures-board";
|
|
2
2
|
import { getListingSymbol, hongKongListingCode, tickerHasListingSuffix } from "../sources/listing-symbols";
|
|
3
3
|
import { isCurrencyCode } from "../utils/currency-pair";
|
|
4
|
-
import { isKnownExchangeCode, isUsListingExchange } from "../utils/exchanges";
|
|
4
|
+
import { canonicalExchange, isKnownExchangeCode, isPredictionMarketExchange, isSharedExchangeCode, isUsListingExchange } from "../utils/exchanges";
|
|
5
5
|
|
|
6
6
|
/**
|
|
7
7
|
* A listing written the way a market data terminal names it, read as the
|
|
@@ -473,6 +473,31 @@ export function readNearMissListing(raw: string): NearMissListing | null {
|
|
|
473
473
|
return tickerHasListingSuffix(symbol) ? { typed, symbol } : null;
|
|
474
474
|
}
|
|
475
475
|
|
|
476
|
+
/** `TYO:7203`, `LON:LSEG`, `NASDAQ:AAPL`: an exchange's code, a colon, then the symbol, as spreadsheets and quote sites write a listing. */
|
|
477
|
+
const VENUE_FIRST = /^([A-Z][A-Z0-9]{1,11}):([A-Z0-9][A-Z0-9.&-]{0,19})$/;
|
|
478
|
+
|
|
479
|
+
/**
|
|
480
|
+
* A listing written venue first, as Google Sheets and quote sites write it
|
|
481
|
+
* (`TYO:7203`, `LON:LSEG`, `NASDAQ:AAPL`), read as the symbol on that venue
|
|
482
|
+
* (`7203:JPX`, `LSEG:LSE`, `AAPL:NASDAQ`): the part before the colon is an
|
|
483
|
+
* exchange code the app knows and the part after it is none, so `SAN:EPA`,
|
|
484
|
+
* written symbol first, and `BATS:LSE`, whose symbol is also a venue's code,
|
|
485
|
+
* stay as typed, as does a ticker before a two-letter market code (`ICE:US`,
|
|
486
|
+
* `ASX:AU`, `BSE:IN`, `AMS:SW`), the code it is written symbol first with.
|
|
487
|
+
* A code that names several venues (`TSE:7203`) is kept for the listing to
|
|
488
|
+
* settle. A prediction market's id (`KALSHI:...`) is not a listing. Null for
|
|
489
|
+
* anything else.
|
|
490
|
+
*/
|
|
491
|
+
export function readVenueFirstListing(raw: string): NearMissListing | null {
|
|
492
|
+
const typed = raw.trim();
|
|
493
|
+
const match = VENUE_FIRST.exec(typed.toUpperCase());
|
|
494
|
+
if (!match) return null;
|
|
495
|
+
const [, code, symbol] = match as unknown as [string, string, string];
|
|
496
|
+
if (!isKnownExchangeCode(code) || isKnownExchangeCode(symbol) || isPredictionMarketExchange(code)) return null;
|
|
497
|
+
if (symbol.length === 2 && BLOOMBERG_MARKETS[symbol]) return null;
|
|
498
|
+
return { typed, symbol: `${symbol}:${isSharedExchangeCode(code) ? code : canonicalExchange(code)}` };
|
|
499
|
+
}
|
|
500
|
+
|
|
476
501
|
/** `Read WFC.N as WFC:NYSE.`, for a command's warnings. */
|
|
477
502
|
export function terminalCodeReadAs(code: Pick<TerminalListingCode, "typed" | "key">): string {
|
|
478
503
|
return `Read ${/\s/.test(code.typed) ? `"${code.typed}"` : code.typed} as ${code.key}.`;
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import type { ChartRequest, InstrumentRef } from "../market-data/request-types";
|
|
2
|
+
import type { QueryEntry } from "../market-data/result-types";
|
|
3
|
+
import { sessionCalendarTimeZone } from "../market-data/market/freshness";
|
|
4
|
+
import type { PricePoint } from "../types/financials";
|
|
5
|
+
import { zonedDateTimeParts } from "../utils/zoned-date-time";
|
|
6
|
+
|
|
7
|
+
const DAY_MS = 86_400_000;
|
|
8
|
+
|
|
9
|
+
/** The month now on the venue's calendar: a coin's, and a venue without a known zone's, in UTC. */
|
|
10
|
+
export function venueMonth(now: number, exchange: string): { year: number; month: number } {
|
|
11
|
+
const { year, month } = zonedDateTimeParts(now, sessionCalendarTimeZone(exchange) ?? "UTC");
|
|
12
|
+
return { year, month };
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* The trailing range of daily closes over `years` (one year or five), read
|
|
17
|
+
* when a source answers no dated history (`calendarMonthReturnsRequest` failed
|
|
18
|
+
* or came back empty). It starts days into the month before the window, so
|
|
19
|
+
* five years of month-end closes give 59 returns, not 60.
|
|
20
|
+
*/
|
|
21
|
+
export function trailingDailyClosesRequest(instrument: InstrumentRef, years: number): ChartRequest {
|
|
22
|
+
return { instrument, bufferRange: years <= 1 ? "1Y" : "5Y", granularity: "resolution", resolution: "1d" };
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* The daily closes `years` × 12 calendar-month returns are read from: from the
|
|
27
|
+
* first day of the month before the window's first month, so every month has
|
|
28
|
+
* the close it is measured from, to the end of the UTC day, so a day keeps one
|
|
29
|
+
* request. The window ends with the last month finished on the venue's
|
|
30
|
+
* calendar. KELLY's History tab, its report and its screenshots ask for it alike.
|
|
31
|
+
*/
|
|
32
|
+
export function calendarMonthReturnsRequest(instrument: InstrumentRef, years: number, now = Date.now()): ChartRequest {
|
|
33
|
+
const { year, month } = venueMonth(now, instrument.exchange ?? "");
|
|
34
|
+
return {
|
|
35
|
+
...trailingDailyClosesRequest(instrument, years),
|
|
36
|
+
granularity: "detail",
|
|
37
|
+
barSize: "1d",
|
|
38
|
+
startDate: new Date(Date.UTC(year, month - 1 - (years * 12 + 1), 1)),
|
|
39
|
+
endDate: new Date(Math.floor(now / DAY_MS) * DAY_MS + DAY_MS),
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/** Whether a dated history read is over and gave no closes, so the trailing range is read instead. */
|
|
44
|
+
export function historyReadUnanswered(entry: Pick<QueryEntry<PricePoint[]>, "phase" | "data" | "lastGoodData"> | null | undefined): boolean {
|
|
45
|
+
if (!entry || (entry.phase !== "ready" && entry.phase !== "error")) return false;
|
|
46
|
+
return !(entry.data ?? entry.lastGoodData)?.length;
|
|
47
|
+
}
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
import { dailyFxCloses, dailyFxLeg, FxHistoryError, fxCloseOnOrBefore, type FxCloses, type FxHistoryClient } from "../market-data/fx-closes";
|
|
2
|
+
import { resolveCurrencyUnit } from "../utils/currency-units";
|
|
3
|
+
import { logFailure } from "../utils/log-failure";
|
|
4
|
+
import type { ResolvedSeries, TimeSeriesPoint } from "./types";
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* A comparison in one currency (`fn CMP THYAO:BIST MSFT --currency USD`): each
|
|
8
|
+
* leg's prices converted at the daily FX close of their day, so a leg's return
|
|
9
|
+
* carries its currency's move against the one asked for.
|
|
10
|
+
*/
|
|
11
|
+
|
|
12
|
+
/** USD per unit of a currency at each completed daily close from `startDate` (YYYY-MM-DD) to today. */
|
|
13
|
+
export type LoadFxCloses = (currency: string, startDate: string) => Promise<FxCloses>;
|
|
14
|
+
|
|
15
|
+
const DAY_MS = 86_400_000;
|
|
16
|
+
|
|
17
|
+
/** Reads a currency's daily USD closes from `startDate` to today, as `loadFxCloses` wants them. */
|
|
18
|
+
export async function loadDailyFxCloses(currency: string, startDate: string, client: FxHistoryClient, now = new Date()): Promise<FxCloses> {
|
|
19
|
+
const leg = dailyFxLeg(currency);
|
|
20
|
+
if (!leg) throw new FxHistoryError("unavailable");
|
|
21
|
+
// Every weekday from a week before the start, so the first bar has the close before it.
|
|
22
|
+
const from = Date.parse(`${startDate}T00:00:00Z`) - 7 * DAY_MS;
|
|
23
|
+
const days = Math.max(14, Math.ceil((now.getTime() - from) / DAY_MS) + 2);
|
|
24
|
+
const response = await client.getCloudHistory(leg.instrument.symbol, leg.instrument.exchange ?? "", {
|
|
25
|
+
interval: "1day", startDate: new Date(from).toISOString().slice(0, 10), endDate: now.toISOString().slice(0, 10), outputsize: days,
|
|
26
|
+
});
|
|
27
|
+
return dailyFxCloses(response, leg, now, days + 10);
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
function scaled(value: number | null | undefined, factor: number): number | null | undefined {
|
|
31
|
+
return typeof value === "number" && Number.isFinite(value) ? value * factor : value;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* Prices in `from` units as prices in the target currency: each point's
|
|
36
|
+
* prices times USD per `from` over USD per target at the last completed close
|
|
37
|
+
* on or before its day (a USD side is 1), and over the sub-unit divisor of a
|
|
38
|
+
* price in pence or cents. A point with no close in the week before it is
|
|
39
|
+
* left out, not converted at another day's rate. Volume is left alone.
|
|
40
|
+
*/
|
|
41
|
+
function convertPricePoints(
|
|
42
|
+
points: readonly TimeSeriesPoint[],
|
|
43
|
+
{ dayOf, divisor = 1, fromCloses, toCloses }: {
|
|
44
|
+
dayOf: (point: TimeSeriesPoint) => string;
|
|
45
|
+
divisor?: number;
|
|
46
|
+
/** USD per unit of the prices' currency; null when it is USD. */
|
|
47
|
+
fromCloses: FxCloses | null;
|
|
48
|
+
/** USD per unit of the target; null when it is USD. */
|
|
49
|
+
toCloses: FxCloses | null;
|
|
50
|
+
},
|
|
51
|
+
): { points: TimeSeriesPoint[]; missing: number } {
|
|
52
|
+
let missing = 0;
|
|
53
|
+
const converted: TimeSeriesPoint[] = [];
|
|
54
|
+
for (const point of points) {
|
|
55
|
+
const day = dayOf(point);
|
|
56
|
+
const from = fromCloses ? fxCloseOnOrBefore(fromCloses, day)?.rate : 1;
|
|
57
|
+
const to = toCloses ? fxCloseOnOrBefore(toCloses, day)?.rate : 1;
|
|
58
|
+
if (from == null || to == null || !(to > 0)) {
|
|
59
|
+
missing += 1;
|
|
60
|
+
continue;
|
|
61
|
+
}
|
|
62
|
+
const factor = from / to / divisor;
|
|
63
|
+
converted.push({
|
|
64
|
+
...point,
|
|
65
|
+
value: scaled(point.value, factor) ?? null,
|
|
66
|
+
...point.rawValue !== undefined ? { rawValue: scaled(point.rawValue, factor) ?? null } : {},
|
|
67
|
+
...point.open !== undefined ? { open: scaled(point.open, factor) } : {},
|
|
68
|
+
...point.high !== undefined ? { high: scaled(point.high, factor) } : {},
|
|
69
|
+
...point.low !== undefined ? { low: scaled(point.low, factor) } : {},
|
|
70
|
+
...point.close !== undefined ? { close: scaled(point.close, factor) } : {},
|
|
71
|
+
});
|
|
72
|
+
}
|
|
73
|
+
return { points: converted, missing };
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
export interface CurrencySeriesOutcome {
|
|
77
|
+
series: ResolvedSeries;
|
|
78
|
+
/** Why the series stays in its own currency, or what it lost, when it does. */
|
|
79
|
+
notice?: string;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/** `TRY/share` as `USD/share`: the unit's currency, in its own spelling or its sub-unit's, replaced. */
|
|
83
|
+
function unitIn(unit: string, priceCurrency: string, target: string): string {
|
|
84
|
+
return unit.startsWith(priceCurrency) ? `${target}${unit.slice(priceCurrency.length)}` : unit;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/**
|
|
88
|
+
* A price series in the target currency, from its listing's daily FX closes
|
|
89
|
+
* and the target's. A series already in it is left as it is; one whose
|
|
90
|
+
* currency is unknown or whose closes cannot be read stays in its own
|
|
91
|
+
* currency, with the reason.
|
|
92
|
+
*/
|
|
93
|
+
export async function currencySeries(
|
|
94
|
+
series: ResolvedSeries,
|
|
95
|
+
{ target, priceCurrency, loadCloses, dayOf }: {
|
|
96
|
+
target: string;
|
|
97
|
+
priceCurrency: string | undefined;
|
|
98
|
+
loadCloses: LoadFxCloses | undefined;
|
|
99
|
+
dayOf: (point: TimeSeriesPoint) => string;
|
|
100
|
+
},
|
|
101
|
+
): Promise<CurrencySeriesOutcome> {
|
|
102
|
+
const unit = resolveCurrencyUnit(priceCurrency);
|
|
103
|
+
if (!unit.currency) return { series, notice: `price currency unknown; not converted to ${target}.` };
|
|
104
|
+
if (unit.currency === target && unit.divisor === 1) return { series };
|
|
105
|
+
const days = series.points.map(dayOf).filter(Boolean).sort();
|
|
106
|
+
if (!days.length) return { series };
|
|
107
|
+
const read = (currency: string) => currency === "USD" ? Promise.resolve(null)
|
|
108
|
+
: loadCloses ? loadCloses(currency, days[0]!) : Promise.reject(new FxHistoryError("unavailable"));
|
|
109
|
+
const [fromCloses, toCloses] = await Promise.all([
|
|
110
|
+
unit.currency === target ? null : read(unit.currency),
|
|
111
|
+
unit.currency === target ? null : read(target),
|
|
112
|
+
]).catch((error) => {
|
|
113
|
+
logFailure("currency-conversion", "Loading daily FX closes failed", null)(error);
|
|
114
|
+
return [undefined, undefined] as const;
|
|
115
|
+
});
|
|
116
|
+
if (fromCloses === undefined) return { series, notice: `${unit.currency}/${target} daily closes unavailable; left in ${unit.currency}.` };
|
|
117
|
+
const { points, missing } = convertPricePoints(series.points, { dayOf, divisor: unit.divisor, fromCloses, toCloses: toCloses ?? null });
|
|
118
|
+
const raw = priceCurrency!.trim();
|
|
119
|
+
return {
|
|
120
|
+
series: {
|
|
121
|
+
...series,
|
|
122
|
+
points,
|
|
123
|
+
unit: unitIn(series.unit, raw, target),
|
|
124
|
+
...series.rawUnit !== undefined ? { rawUnit: unitIn(series.rawUnit, raw, target) } : {},
|
|
125
|
+
unitGroup: series.unitGroup.replace(/:[^:]+$/, `:${target}`),
|
|
126
|
+
convertedFrom: unit.currency,
|
|
127
|
+
},
|
|
128
|
+
...(missing ? { notice: `${missing} bar${missing === 1 ? "" : "s"} with no ${unit.currency}/${target} close in the week before left out.` } : {}),
|
|
129
|
+
};
|
|
130
|
+
}
|
package/src/time-series/hooks.ts
CHANGED
|
@@ -6,6 +6,7 @@ import { useAssetData, useCapabilityInvoker } from "../plugins/runtime";
|
|
|
6
6
|
import { getSharedRegistry } from "../plugins/registry";
|
|
7
7
|
import { createChartSeriesResolver } from "../capabilities";
|
|
8
8
|
import { loadFuturesPriceUnit } from "../market-data/futures-contract";
|
|
9
|
+
import { loadDailyFxCloses } from "./currency-conversion";
|
|
9
10
|
import { useAppSelector } from "../state/app/context";
|
|
10
11
|
import type { FredSeriesRequest } from "../sources/gloomberb-cloud/fred-series";
|
|
11
12
|
import type { TickerRecord } from "../types/ticker";
|
|
@@ -83,6 +84,7 @@ export function useResolvedChartSpec(
|
|
|
83
84
|
resolveCapabilitySeries: createChartSeriesResolver(capabilityInvoker),
|
|
84
85
|
capabilityRefreshMs: registeredSeriesRefreshMs,
|
|
85
86
|
loadFuturesPriceUnit: (symbol: string) => loadFuturesPriceUnit(symbol),
|
|
87
|
+
loadFxCloses: (currency: string, startDate: string) => loadDailyFxCloses(currency, startDate, apiClient),
|
|
86
88
|
}), [capabilityInvoker, dataProvider]);
|
|
87
89
|
return useChartResolution(hydratedSpec, sources, { ...options, snapshot });
|
|
88
90
|
}
|
|
@@ -13,16 +13,34 @@ import {
|
|
|
13
13
|
const PRICE_COMPARISON_BASIS = "Price returns in each listing's currency; cash distributions and FX conversion excluded.";
|
|
14
14
|
const TOTAL_COMPARISON_BASIS = "Total returns in each listing's currency; cash distributions reinvested at the ex-date close, FX conversion excluded.";
|
|
15
15
|
|
|
16
|
+
/** `MSFT and THYAO:BIST from TRY`: the legs converted into the chart's currency, by the currency each was in. */
|
|
17
|
+
function convertedText(legs: ReadonlyArray<{ label: string; entry: ResolvedSeries | undefined }>): string | null {
|
|
18
|
+
const byCurrency = new Map<string, string[]>();
|
|
19
|
+
for (const { label, entry } of legs) {
|
|
20
|
+
if (entry?.convertedFrom) byCurrency.set(entry.convertedFrom, [...byCurrency.get(entry.convertedFrom) ?? [], label]);
|
|
21
|
+
}
|
|
22
|
+
if (!byCurrency.size) return null;
|
|
23
|
+
return [...byCurrency].map(([currency, labels]) => `${listLabels(labels)} from ${currency}`).join(", ");
|
|
24
|
+
}
|
|
25
|
+
|
|
16
26
|
/**
|
|
17
27
|
* What a comparison's returns are: price returns, or total returns when the
|
|
18
28
|
* chart asked for them, naming any leg whose distributions could not be read
|
|
19
|
-
* (it stays a price return, and the others do not wait for it).
|
|
29
|
+
* (it stays a price return, and the others do not wait for it). A chart in one
|
|
30
|
+
* currency names the legs converted into it.
|
|
20
31
|
*/
|
|
21
32
|
function comparisonBasis(spec: ChartSpec, legs: ReadonlyArray<{ label: string; entry: ResolvedSeries | undefined }>): string {
|
|
22
|
-
|
|
23
|
-
const priceOnly = legs.filter(({ entry }) => entry?.returnBasis === "price").map(({ label }) => label);
|
|
24
|
-
|
|
25
|
-
|
|
33
|
+
const target = spec.viewport.currency;
|
|
34
|
+
const priceOnly = spec.viewport.totalReturn === true ? legs.filter(({ entry }) => entry?.returnBasis === "price").map(({ label }) => label) : [];
|
|
35
|
+
const total = spec.viewport.totalReturn === true && !(priceOnly.length === legs.length && legs.length > 0);
|
|
36
|
+
if (!target) {
|
|
37
|
+
if (!total) return PRICE_COMPARISON_BASIS;
|
|
38
|
+
return priceOnly.length ? `${TOTAL_COMPARISON_BASIS} Price return for ${priceOnly.join(", ")}: distribution history unavailable.` : TOTAL_COMPARISON_BASIS;
|
|
39
|
+
}
|
|
40
|
+
const converted = convertedText(legs);
|
|
41
|
+
const basis = `${total ? "Total" : "Price"} returns in ${target}${converted ? `, ${converted} at each day's FX close` : ""}; ${
|
|
42
|
+
total ? "cash distributions reinvested at the ex-date close." : "cash distributions excluded."}`;
|
|
43
|
+
return total && priceOnly.length ? `${basis} Price return for ${priceOnly.join(", ")}: distribution history unavailable.` : basis;
|
|
26
44
|
}
|
|
27
45
|
|
|
28
46
|
export interface PriceComparison {
|
|
@@ -150,14 +168,19 @@ export function priceComparisonSeriesIds(spec: ChartSpec): string[] | null {
|
|
|
150
168
|
/**
|
|
151
169
|
* What a total-return chart's price levels are when it is not a comparison (the
|
|
152
170
|
* raw price axis): prices with cash distributions reinvested, not what the
|
|
153
|
-
* listing quotes.
|
|
171
|
+
* listing quotes. A chart in one currency names the legs converted into it.
|
|
172
|
+
* Null for a price chart in each listing's currency, and when no leg is a
|
|
173
|
+
* total return or was converted.
|
|
154
174
|
*/
|
|
155
|
-
export function
|
|
156
|
-
|
|
157
|
-
const
|
|
158
|
-
|
|
175
|
+
export function priceLevelsNotice(spec: ChartSpec, series: readonly ResolvedSeries[]): string | null {
|
|
176
|
+
const target = spec.viewport.currency;
|
|
177
|
+
const converted = target ? convertedText(series.map((entry) => ({ label: entry.label.replace(/ (?:Close|Price|Open|High|Low|Total return)$/, ""), entry }))) : null;
|
|
178
|
+
const conversion = converted ? `${converted} at each day's FX close` : null;
|
|
179
|
+
const legs = spec.viewport.totalReturn === true ? series.filter((entry) => entry.returnBasis !== undefined) : [];
|
|
180
|
+
if (!legs.some((entry) => entry.returnBasis === "total")) return conversion ? `Prices in ${target}: ${conversion}.` : null;
|
|
159
181
|
const priceOnly = legs.filter((entry) => entry.returnBasis === "price").map((entry) => entry.label);
|
|
160
|
-
return `Total return levels in each listing's currency: prices include cash distributions reinvested at the ex-date close, so they are not quoted prices;
|
|
182
|
+
return `Total return levels in ${target ?? "each listing's currency"}: prices include cash distributions reinvested at the ex-date close, so they are not quoted prices; ${
|
|
183
|
+
conversion ?? (target ? "none needed converting" : "FX conversion excluded")}.${
|
|
161
184
|
priceOnly.length ? ` Price only for ${priceOnly.join(", ")}: distribution history unavailable.` : ""}`;
|
|
162
185
|
}
|
|
163
186
|
|
|
@@ -6,6 +6,7 @@ import type { DataProvider, MarketDataRequestContext } from "../types/data-provi
|
|
|
6
6
|
import type { CorporateActionsData, EarningsAction, Quote, QuoteMetadata, TickerFinancials } from "../types/financials";
|
|
7
7
|
import type { EarningsHistoryPayload } from "../api-client/earnings";
|
|
8
8
|
import type { FredSeriesLoadResult, FredSeriesRequest } from "../sources/gloomberb-cloud/fred-series";
|
|
9
|
+
import type { LoadFxCloses } from "./currency-conversion";
|
|
9
10
|
import { chartQuoteOverrideKeyForSource } from "./live-quotes";
|
|
10
11
|
import { publicTickerKey } from "../utils/exchanges";
|
|
11
12
|
import type {
|
|
@@ -40,6 +41,8 @@ export interface ChartResolveSources {
|
|
|
40
41
|
* the terms do not say. Without it a future's price is in its currency alone.
|
|
41
42
|
*/
|
|
42
43
|
loadFuturesPriceUnit?: (symbol: string) => Promise<string | null>;
|
|
44
|
+
/** A currency's daily USD closes, for a chart converted into one currency (`viewport.currency`). */
|
|
45
|
+
loadFxCloses?: LoadFxCloses;
|
|
43
46
|
/** Provider-neutral boundary for plugin-owned chart series. */
|
|
44
47
|
resolveCapabilitySeries?: (
|
|
45
48
|
source: Extract<ChartSeriesSpec["source"], { kind: "capability" }>,
|
|
@@ -48,13 +48,15 @@ import { chartPriceHistoryIntegrityNotices } from "./market";
|
|
|
48
48
|
import { maxStudyWarmupPoints, resolveStudies } from "./studies/resolve";
|
|
49
49
|
import { clipSeriesToWindow } from "./alignment";
|
|
50
50
|
import { totalReturnSeries } from "./total-return";
|
|
51
|
+
import { currencySeries } from "./currency-conversion";
|
|
51
52
|
import {
|
|
52
53
|
bufferPriceComparison,
|
|
53
54
|
clipPriceComparison,
|
|
55
|
+
observationDate,
|
|
54
56
|
priceComparisonBoundsForSeries,
|
|
55
57
|
priceComparisonSeriesIds,
|
|
56
58
|
resolvePriceComparison,
|
|
57
|
-
|
|
59
|
+
priceLevelsNotice,
|
|
58
60
|
} from "./price-comparison";
|
|
59
61
|
import { chartQuoteOverrideKeyForSource } from "./live-quotes";
|
|
60
62
|
import { coinLegsAtSessionClose } from "./coin-session-close";
|
|
@@ -991,6 +993,16 @@ async function resolveChartSpecPass(
|
|
|
991
993
|
result = outcome.series;
|
|
992
994
|
if (outcome.notice) warnings.push(`${instrumentLabel(resolvedSource)}: ${outcome.notice}`);
|
|
993
995
|
}
|
|
996
|
+
// A chart in one currency converts each price at its day's FX close, after any distributions are reinvested in the listing's own.
|
|
997
|
+
const targetCurrency = spec.viewport.currency;
|
|
998
|
+
if (targetCurrency && totalReturnFieldId(source.fieldId)) {
|
|
999
|
+
const converted = await currencySeries(result, {
|
|
1000
|
+
target: targetCurrency, priceCurrency: merged.quote?.currency || quoteMetadata?.currency,
|
|
1001
|
+
loadCloses: sources.loadFxCloses, dayOf: (point) => observationDate(point.date.getTime(), result),
|
|
1002
|
+
});
|
|
1003
|
+
result = converted.series;
|
|
1004
|
+
if (converted.notice) warnings.push(`${instrumentLabel(resolvedSource)}: ${converted.notice}`);
|
|
1005
|
+
}
|
|
994
1006
|
if (marketField && history?.historyStart !== undefined && Number.isFinite(history.historyStart)) {
|
|
995
1007
|
result.historyStart = new Date(history.historyStart);
|
|
996
1008
|
}
|
|
@@ -1145,7 +1157,7 @@ async function resolveChartSpecPass(
|
|
|
1145
1157
|
);
|
|
1146
1158
|
if (priceComparison) warnings.push(priceComparison.notice);
|
|
1147
1159
|
// A raw-price chart of total returns is no comparison, and its levels say what they are instead.
|
|
1148
|
-
const returnBasisNotice = priceComparison ? null :
|
|
1160
|
+
const returnBasisNotice = priceComparison ? null : priceLevelsNotice(spec, rawSeries);
|
|
1149
1161
|
if (returnBasisNotice) warnings.push(returnBasisNotice);
|
|
1150
1162
|
warnings.push(...chartPriceHistoryIntegrityNotices(priceHistoryIntegrity));
|
|
1151
1163
|
warnings.push(...financialPeriodCoverageWarnings(financialPeriodCoverage(spec, resolved)));
|
package/src/time-series/spec.ts
CHANGED
|
@@ -334,6 +334,7 @@ export function normalizeChartSpec(value: unknown, fallback: ChartSpec = DEFAULT
|
|
|
334
334
|
: undefined,
|
|
335
335
|
...(viewport?.extendedHours === true ? { extendedHours: true } : {}),
|
|
336
336
|
...(viewport?.totalReturn === true ? { totalReturn: true } : {}),
|
|
337
|
+
...(typeof viewport?.currency === "string" && /^[A-Z]{3}$/.test(viewport.currency) ? { currency: viewport.currency } : {}),
|
|
337
338
|
},
|
|
338
339
|
panels,
|
|
339
340
|
series,
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { mergePriceHistoryIntegrity } from "../../utils/price-history-integrity";
|
|
2
2
|
import { isRealizedVolatilityEstimator, rollingRealizedVolatility } from "../../market-data/realized-volatility";
|
|
3
|
+
import { currencyPairInstrument } from "../../market-data/bars-per-year";
|
|
3
4
|
import { INDEX_MEMBERS_VOLUME_LABEL } from "../../market-data/market/index-level";
|
|
4
5
|
import { averageTrueRange } from "../trader-studies";
|
|
5
6
|
import type { ChartStudySpec, ResolvedSeries, TimeSeriesPoint } from "../types";
|
|
@@ -107,6 +108,8 @@ export function resolveRealizedVolatility(spec: ChartStudySpec, input: ResolvedS
|
|
|
107
108
|
// would turn two separated returns into adjacent observations.
|
|
108
109
|
const byDate = new Map(input.points.map((point) => [point.date.getTime(), point]));
|
|
109
110
|
const source = [...byDate.values()].sort((a, b) => a.date.getTime() - b.date.getTime());
|
|
111
|
+
// A currency pair's year is every weekday (260 bars), however short the range charted.
|
|
112
|
+
const instrument = currencyPairInstrument(input.listing?.symbol, input.listing?.exchange);
|
|
110
113
|
const calculated = rollingRealizedVolatility(source.map((point) => ({
|
|
111
114
|
date: point.date,
|
|
112
115
|
close: point.provenance?.priceHistoryIntegrity || point.provenance?.valuationPriceIssues?.length
|
|
@@ -114,7 +117,7 @@ export function resolveRealizedVolatility(spec: ChartStudySpec, input: ResolvedS
|
|
|
114
117
|
open: point.open ?? undefined,
|
|
115
118
|
high: point.high ?? undefined,
|
|
116
119
|
low: point.low ?? undefined,
|
|
117
|
-
})), { windows: [window], estimator });
|
|
120
|
+
})), { windows: [window], estimator, instrument });
|
|
118
121
|
const warmup = studyWarmupPoints(spec);
|
|
119
122
|
const points = calculated.map((point, index): TimeSeriesPoint => {
|
|
120
123
|
const original = source[index]!;
|
package/src/time-series/types.ts
CHANGED
|
@@ -115,6 +115,12 @@ export interface ChartViewportSpec {
|
|
|
115
115
|
* is reinvested at the close of its ex-date bar. Price returns otherwise.
|
|
116
116
|
*/
|
|
117
117
|
totalReturn?: boolean;
|
|
118
|
+
/**
|
|
119
|
+
* Security price series are converted into this currency (ISO code) at each
|
|
120
|
+
* day's FX close, so their returns carry their currency's move. Each in its
|
|
121
|
+
* listing's currency otherwise.
|
|
122
|
+
*/
|
|
123
|
+
currency?: string;
|
|
118
124
|
}
|
|
119
125
|
|
|
120
126
|
export interface ChartSpec {
|
|
@@ -196,6 +202,8 @@ export interface ResolvedSeries {
|
|
|
196
202
|
* source gave none to reinvest (`warning` says why).
|
|
197
203
|
*/
|
|
198
204
|
returnBasis?: "total" | "price";
|
|
205
|
+
/** The listing currency a price series was converted from into the chart's `viewport.currency`. */
|
|
206
|
+
convertedFrom?: string;
|
|
199
207
|
unitGroup: string;
|
|
200
208
|
/**
|
|
201
209
|
* The unit the legend states beside each value, read bare as FUT prints its
|
package/src/types/config.ts
CHANGED
|
@@ -132,6 +132,11 @@ export interface FloatingPaneEntry {
|
|
|
132
132
|
width: number;
|
|
133
133
|
height: number;
|
|
134
134
|
zIndex?: number;
|
|
135
|
+
/**
|
|
136
|
+
* Floating windows stacked as tabs share this key and one rect; the one
|
|
137
|
+
* in front (highest z) is shown (layout/pane-manager/floating-stack.ts).
|
|
138
|
+
*/
|
|
139
|
+
stack?: string;
|
|
135
140
|
}
|
|
136
141
|
|
|
137
142
|
interface DetachedPaneEntry {
|
|
@@ -371,8 +376,16 @@ export interface AppConfig {
|
|
|
371
376
|
* status bar, for a screen that is shown rather than worked at. Absent is off.
|
|
372
377
|
*/
|
|
373
378
|
presentationMode?: boolean;
|
|
379
|
+
/**
|
|
380
|
+
* The market the header shows. Absent until the user picks one: the
|
|
381
|
+
* benchmark of this machine's time zone. Kept on this machine only.
|
|
382
|
+
*/
|
|
383
|
+
headerMarket?: HeaderMarketChoice;
|
|
374
384
|
}
|
|
375
385
|
|
|
386
|
+
/** A benchmark the header offers, by its id (`hang-seng`), or any listing the user searched for. */
|
|
387
|
+
export type HeaderMarketChoice = { benchmark: string } | { symbol: string; exchange?: string };
|
|
388
|
+
|
|
376
389
|
export const TICKER_RESEARCH_PANE_ID = "ticker-research";
|
|
377
390
|
export const LEGACY_TICKER_DETAIL_PANE_ID = "ticker-detail";
|
|
378
391
|
export const CHART_COMPOSER_PANE_ID = "chart-composer";
|
|
@@ -27,6 +27,8 @@ export interface ContextMenuActionItem extends ContextMenuItemBase {
|
|
|
27
27
|
label: string;
|
|
28
28
|
onSelect?: () => void | Promise<void>;
|
|
29
29
|
submenu?: ContextMenuItem[];
|
|
30
|
+
/** The prompt the item answers (a pane's Approve), as `metadata.scope` on the menu drawn in the app. */
|
|
31
|
+
remoteScope?: string;
|
|
30
32
|
}
|
|
31
33
|
|
|
32
34
|
export interface ContextMenuRoleItem extends ContextMenuItemBase {
|
|
@@ -73,6 +73,30 @@ export interface SecFilingItem {
|
|
|
73
73
|
* the page the results or the news are on, not the cover page.
|
|
74
74
|
*/
|
|
75
75
|
pressReleaseUrl?: string;
|
|
76
|
+
/**
|
|
77
|
+
* What a Form 4 did, when Gloom Cloud read it for the list: whose shares,
|
|
78
|
+
* the main transaction and its shares and average price. A company's list
|
|
79
|
+
* holds the Form 4s it filed as an owner of other companies' shares, which
|
|
80
|
+
* only this names. Absent from other forms and from an older server.
|
|
81
|
+
*/
|
|
82
|
+
form4?: SecForm4Trade;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/** A Form 4's main transaction, the one moving the most shares. */
|
|
86
|
+
export interface SecForm4Trade {
|
|
87
|
+
/** The first reporting owner, as filed. */
|
|
88
|
+
ownerName: string;
|
|
89
|
+
issuerName: string;
|
|
90
|
+
issuerTicker: string | null;
|
|
91
|
+
issuerCik: string | null;
|
|
92
|
+
/** The SEC transaction code: P purchase, S sale, A award, G gift, F tax withholding, M exercise, ... */
|
|
93
|
+
code: string;
|
|
94
|
+
side: "buy" | "sell" | "acquired" | "disposed";
|
|
95
|
+
shares: number;
|
|
96
|
+
/** Share-weighted average price; null when no line gives one. */
|
|
97
|
+
price: number | null;
|
|
98
|
+
/** True when the transaction is in options or other derivatives (a form with no share lines): `shares` counts those. */
|
|
99
|
+
derivative?: boolean;
|
|
76
100
|
}
|
|
77
101
|
|
|
78
102
|
export interface SecFilingDocument {
|
|
@@ -140,12 +164,16 @@ export interface EarningsEvent {
|
|
|
140
164
|
revenueActual: number | null;
|
|
141
165
|
surprise: number | null;
|
|
142
166
|
timing: "BMO" | "AMC" | "TNS" | "";
|
|
167
|
+
/** When the results come out, as the company announced it (Berkshire's Saturday 13:00Z); absent when it named no time. */
|
|
168
|
+
releaseAt?: string | null;
|
|
143
169
|
}
|
|
144
170
|
|
|
145
171
|
/** The reads a provider may send in batches (`DataProvider.batchesReads`). */
|
|
146
172
|
export type BatchedReadMethod = "getPriceHistory" | "getOptionsChain";
|
|
147
173
|
|
|
148
174
|
export interface MarketDataRequestContext {
|
|
175
|
+
/** An options chain of the contracts adjusted for a corporate action (ETHA1), in place of the standard ones. */
|
|
176
|
+
adjustedOptions?: boolean;
|
|
149
177
|
brokerId?: string;
|
|
150
178
|
brokerInstanceId?: string;
|
|
151
179
|
instrument?: BrokerContractRef | null;
|