gloomberb 0.20.1 → 0.20.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -26
- package/README.zh-CN.md +21 -65
- package/package.json +1 -1
- package/src/account/auth-model.ts +20 -1
- package/src/account/upgrade-dialog.tsx +8 -4
- package/src/api-client/askg.ts +7 -1
- package/src/api-client/auth.ts +27 -0
- package/src/api-client/catalysts.ts +2 -0
- package/src/api-client/company-kpis.ts +2 -1
- package/src/api-client/cot.ts +14 -2
- package/src/api-client/data.ts +3 -2
- package/src/api-client/earnings.ts +46 -3
- package/src/api-client/futures-curve.ts +17 -0
- package/src/api-client/index.ts +4 -1
- package/src/api-client/one-tap-reasons.ts +42 -0
- package/src/api-client/perps.ts +2 -1
- package/src/api-client/request.ts +3 -1
- package/src/api-client/research-activity.ts +16 -3
- package/src/api-client/types/filings-and-calls.ts +3 -0
- package/src/api-client/types/search.ts +3 -0
- package/src/app/keybindings/chord.ts +153 -9
- package/src/app/keybindings/index.ts +1 -1
- package/src/app/keybindings/labels.ts +49 -6
- package/src/app/runtime/desktop-deeplink.ts +73 -8
- package/src/app.tsx +7 -1
- package/src/architecture/core-builtin-allowlist.json +1 -2
- package/src/architecture/pane-tabs-allowlist.json +2 -1
- package/src/architecture/shortcut-labels-allowlist.json +11 -0
- package/src/architecture/ui-literals-allowlist.json +8 -8
- package/src/brokers/broker-portfolio-sync.ts +1 -1
- package/src/cli/bank-section.ts +26 -12
- package/src/cli/commands/market.ts +266 -75
- package/src/cli/commands/ticker.ts +12 -7
- package/src/cli/desktop-pane-shot-browser.ts +47 -31
- package/src/cli/desktop-pane-shot.ts +15 -0
- package/src/cli/entry.ts +5 -0
- package/src/cli/export-source.ts +7 -1
- package/src/cli/freshness.ts +0 -16
- package/src/cli/fx-pair.ts +64 -12
- package/src/cli/fx-quote-rate.ts +144 -0
- package/src/cli/glossary.ts +5 -0
- package/src/cli/history-back-adjust.ts +122 -0
- package/src/cli/history-rows.ts +114 -10
- package/src/cli/index.ts +4 -1
- package/src/cli/known-gaps.ts +45 -3
- package/src/cli/listing-arg.ts +48 -4
- package/src/cli/name-entries.ts +25 -5
- package/src/cli/pane-functions/catalog.ts +12 -2
- package/src/cli/pane-functions/dom.ts +4 -2
- package/src/cli/pane-functions/headless.ts +8 -5
- package/src/cli/pane-functions/index.ts +3 -0
- package/src/cli/pane-functions/resolver.ts +4 -1
- package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
- package/src/cli/pane-functions/screenshot-payload.ts +130 -66
- package/src/cli/pane-functions/screenshot-render.ts +14 -2
- package/src/cli/pane-functions/screenshot-types.ts +4 -0
- package/src/cli/symbol-rows.ts +22 -2
- package/src/cli/ticker-resolution.ts +74 -17
- package/src/components/chart/composite/axis-overlays.tsx +13 -3
- package/src/components/chart/composite/composite-chart.tsx +8 -1
- package/src/components/chart/composite/format.ts +16 -1
- package/src/components/chart/composite/legend.tsx +4 -3
- package/src/components/chart/composite/panel-labels.ts +2 -1
- package/src/components/chart/composite/panel-surface.tsx +33 -4
- package/src/components/chart/composite/time-scale.ts +1 -1
- package/src/components/chart/composite/toolbar.tsx +8 -4
- package/src/components/chart/composite/types.ts +17 -1
- package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
- package/src/components/chart/composite/use-composite-viewport.ts +31 -8
- package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
- package/src/components/chart-table/axis.ts +11 -0
- package/src/components/command-bar/assist/inventory.ts +3 -2
- package/src/components/command-bar/commands/collection-list.ts +3 -2
- package/src/components/command-bar/panel/layout.ts +8 -1
- package/src/components/command-bar/panel/prompt-width.ts +34 -0
- package/src/components/command-bar/panel/state.ts +4 -0
- package/src/components/command-bar/routes/root/search-providers.ts +3 -2
- package/src/components/command-bar/routes/root/search-report.ts +2 -2
- package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
- package/src/components/company-logo.tsx +2 -2
- package/src/components/data-table/view.tsx +11 -2
- package/src/components/feed-data-table/stack-view.tsx +20 -6
- package/src/components/feedback-dialog.tsx +3 -1
- package/src/components/form-modal/field-row.tsx +1 -1
- package/src/components/form-modal/routes.ts +1 -0
- package/src/components/index.ts +1 -1
- package/src/components/layout/header.tsx +12 -3
- package/src/components/layout/market-summary.ts +2 -1
- package/src/components/layout/pane/footer/index.tsx +9 -5
- package/src/components/layout/pane/footer/model.ts +26 -10
- package/src/components/layout/pane/footer/registration.tsx +60 -1
- package/src/components/layout/pane/header-tabs.tsx +17 -3
- package/src/components/layout/pane/header.tsx +5 -2
- package/src/components/layout/pane/pane-tabs.tsx +57 -3
- package/src/components/layout/shell/active-drag.ts +38 -30
- package/src/components/layout/shell/drag/index.ts +51 -21
- package/src/components/layout/shell/menu.ts +3 -5
- package/src/components/layout/shell/pane/actions.ts +4 -1
- package/src/components/layout/shell/pane/ask.ts +5 -2
- package/src/components/layout/status-bar.tsx +59 -54
- package/src/components/markdown-text.tsx +35 -10
- package/src/components/onboarding/first-run-workspace.ts +25 -23
- package/src/components/onboarding/onboarding-keyboard.ts +6 -1
- package/src/components/onboarding/onboarding-wizard.tsx +12 -2
- package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -3
- package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
- package/src/components/onboarding/use-onboarding-progress.ts +11 -4
- package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
- package/src/components/onboarding/wizard-positions.ts +8 -1
- package/src/components/pane-notice-seen.ts +125 -0
- package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
- package/src/components/pane-settings-dialog.tsx +7 -6
- package/src/components/sign-in-code-panel.tsx +3 -2
- package/src/components/speedometer-gauge/terminal.tsx +30 -9
- package/src/components/ticker/list-table-view.tsx +39 -3
- package/src/components/ui/confirm-dialog.tsx +2 -1
- package/src/components/ui/data-table/index.tsx +4 -2
- package/src/components/ui/data-table/opentui/index.tsx +15 -5
- package/src/components/ui/data-table/types.ts +8 -0
- package/src/components/ui/external-link.tsx +4 -1
- package/src/components/ui/field-grid.tsx +1 -1
- package/src/components/ui/index.ts +2 -0
- package/src/components/ui/inline-quick-add.tsx +5 -0
- package/src/components/ui/multi-select/dialog.tsx +10 -9
- package/src/components/ui/pane-link-chip.tsx +354 -0
- package/src/components/ui/query-bar.tsx +22 -13
- package/src/components/ui/ratio-bar.tsx +24 -1
- package/src/components/ui/select-button.tsx +2 -1
- package/src/components/ui/shortcut-hint.tsx +6 -3
- package/src/components/ui/table-layout.ts +81 -0
- package/src/components/ui/tabs.tsx +45 -6
- package/src/components/use-pane-notice-footer.tsx +12 -4
- package/src/core/app-service-ports.ts +1 -1
- package/src/data/plugin-state-store.ts +44 -8
- package/src/docs/snapshot.json +53 -32
- package/src/i18n/es.ts +25 -6
- package/src/i18n/ja.ts +25 -5
- package/src/i18n/ko.ts +25 -5
- package/src/i18n/zh-cn.ts +25 -5
- package/src/i18n/zh-tw.ts +25 -5
- package/src/layout/pane-manager/gridlock-inference.ts +2 -1
- package/src/layout/pane-manager/gridlock.ts +47 -2
- package/src/layout-marketplace/api.ts +1 -0
- package/src/layout-marketplace/gallery.tsx +4 -3
- package/src/layout-marketplace/linked.ts +6 -4
- package/src/layout-marketplace/model.ts +3 -2
- package/src/market-data/futures-contract.ts +77 -31
- package/src/market-data/fx-closes.ts +5 -2
- package/src/market-data/hooks.tsx +23 -0
- package/src/market-data/market/change-basis.ts +72 -14
- package/src/market-data/market/format.ts +19 -11
- package/src/market-data/market/globex-day.ts +73 -0
- package/src/market-data/market/index-level.ts +10 -1
- package/src/market-data/quotes/intraday-bar.ts +1 -1
- package/src/market-data/quotes/session-split.ts +28 -0
- package/src/plugins/builtin/account-management/pane.tsx +1 -1
- package/src/plugins/builtin/analytics/account-returns.ts +1 -1
- package/src/plugins/builtin/analytics/index.tsx +10 -3
- package/src/plugins/builtin/analytics/pane-model.ts +1 -1
- package/src/plugins/builtin/analytics/risk-client.ts +4 -1
- package/src/plugins/builtin/analytics/risk-episodes.ts +422 -0
- package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
- package/src/plugins/builtin/analytics/risk-headless.ts +28 -10
- package/src/plugins/builtin/analytics/risk-math.ts +1 -1
- package/src/plugins/builtin/analytics/risk-model.ts +115 -26
- package/src/plugins/builtin/analytics/risk-pane.tsx +201 -23
- package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
- package/src/plugins/builtin/backtest/format.ts +14 -0
- package/src/plugins/builtin/backtest/pane.tsx +3 -3
- package/src/plugins/builtin/backtest/report.ts +5 -3
- package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
- package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
- package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
- package/src/plugins/builtin/buildout/company/model.ts +14 -2
- package/src/plugins/builtin/catalysts/detail.tsx +2 -2
- package/src/plugins/builtin/catalysts/model.ts +7 -2
- package/src/plugins/builtin/catalysts/pane.tsx +2 -2
- package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
- package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
- package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
- package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
- package/src/plugins/builtin/cloud/askg/host.ts +57 -0
- package/src/plugins/builtin/cloud/askg/model.ts +45 -5
- package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
- package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
- package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
- package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
- package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
- package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
- package/src/plugins/builtin/cloud/plugin.tsx +7 -1
- package/src/plugins/builtin/company-kpis/client.ts +4 -3
- package/src/plugins/builtin/company-kpis/model.ts +34 -3
- package/src/plugins/builtin/correlation/index.tsx +39 -167
- package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
- package/src/plugins/builtin/correlation/relationship/pane.tsx +6 -7
- package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
- package/src/plugins/builtin/cot/client.ts +8 -3
- package/src/plugins/builtin/cot/headless.ts +65 -12
- package/src/plugins/builtin/cot/pane.tsx +11 -5
- package/src/plugins/builtin/earnings/client.ts +40 -6
- package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
- package/src/plugins/builtin/earnings/headless.ts +47 -11
- package/src/plugins/builtin/earnings/history-model.ts +136 -24
- package/src/plugins/builtin/earnings/history-table.ts +42 -10
- package/src/plugins/builtin/earnings/history.tsx +23 -8
- package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
- package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
- package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
- package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
- package/src/plugins/builtin/econ/index.tsx +5 -4
- package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
- package/src/plugins/builtin/equity-screener/headless.ts +2 -1
- package/src/plugins/builtin/filing-events/feed.ts +56 -18
- package/src/plugins/builtin/filing-events/pane.tsx +8 -2
- package/src/plugins/builtin/futures/index.tsx +32 -10
- package/src/plugins/builtin/futures/model.ts +93 -6
- package/src/plugins/builtin/futures/returns.ts +29 -7
- package/src/plugins/builtin/futures/table.tsx +59 -17
- package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
- package/src/plugins/builtin/futures-curve/client.ts +12 -2
- package/src/plugins/builtin/futures-curve/headless.ts +58 -17
- package/src/plugins/builtin/futures-curve/model.ts +111 -15
- package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
- package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
- package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
- package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
- package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
- package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
- package/src/plugins/builtin/help/index.tsx +68 -61
- package/src/plugins/builtin/holders/format.ts +7 -2
- package/src/plugins/builtin/holders/pane.tsx +11 -3
- package/src/plugins/builtin/holders/report-header.ts +5 -4
- package/src/plugins/builtin/holders/report-rows.ts +4 -1
- package/src/plugins/builtin/holders/treemap.tsx +5 -3
- package/src/plugins/builtin/insider/signals-model.ts +4 -5
- package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
- package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
- package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
- package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
- package/src/plugins/builtin/kelly-sizer/headless.ts +4 -0
- package/src/plugins/builtin/perps/headless.ts +73 -17
- package/src/plugins/builtin/perps/index.tsx +3 -1
- package/src/plugins/builtin/perps/model.ts +1 -1
- package/src/plugins/builtin/perps/pane.tsx +2 -0
- package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
- package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +20 -1
- package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
- package/src/plugins/builtin/portfolio-list/cli/period-report.ts +154 -0
- package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +64 -22
- package/src/plugins/builtin/portfolio-list/cli/render.ts +18 -7
- package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
- package/src/plugins/builtin/portfolio-list/grid.tsx +56 -12
- package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
- package/src/plugins/builtin/portfolio-list/pane/index.tsx +42 -4
- package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
- package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
- package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
- package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
- package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
- package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
- package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
- package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +118 -4
- package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
- package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
- package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
- package/src/plugins/builtin/portfolio-list/table.tsx +105 -6
- package/src/plugins/builtin/power/headless.ts +47 -9
- package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
- package/src/plugins/builtin/research-search/article.ts +12 -2
- package/src/plugins/builtin/research-search/data.ts +5 -2
- package/src/plugins/builtin/research-search/document-view.tsx +1 -1
- package/src/plugins/builtin/research-search/model.ts +47 -3
- package/src/plugins/builtin/research-search/pane.tsx +3 -2
- package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
- package/src/plugins/builtin/risk-factors/headless.ts +3 -2
- package/src/plugins/builtin/risk-factors/pane.tsx +5 -3
- package/src/plugins/builtin/scanner/flow-model.ts +17 -13
- package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
- package/src/plugins/builtin/scanner/flow-session.ts +2 -9
- package/src/plugins/builtin/sec/filing-display.tsx +0 -5
- package/src/plugins/builtin/sec/forms.ts +19 -0
- package/src/plugins/builtin/sec/headless.ts +7 -11
- package/src/plugins/builtin/sec/index.tsx +11 -3
- package/src/plugins/builtin/shared/earnings-calendar.ts +6 -3
- package/src/plugins/builtin/shared/earnings-report.ts +1 -1
- package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
- package/src/plugins/builtin/shared/use-quote-board.ts +42 -27
- package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
- package/src/plugins/builtin/supply-chain/headless.ts +20 -10
- package/src/plugins/builtin/supply-chain/model.ts +117 -20
- package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
- package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
- package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
- package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
- package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
- package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
- package/src/plugins/builtin/ticker-detail/headless-schema.ts +10 -1
- package/src/plugins/builtin/ticker-detail/headless.ts +8 -1
- package/src/plugins/builtin/ticker-detail/overview/components.tsx +2 -1
- package/src/plugins/builtin/ticker-detail/overview/model.ts +4 -2
- package/src/plugins/builtin/ticker-detail/overview-tab.tsx +11 -8
- package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
- package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
- package/src/plugins/builtin/ticker-detail/settings.ts +4 -3
- package/src/plugins/builtin/volatility/charts.tsx +2 -2
- package/src/plugins/host-resolver.ts +3 -2
- package/src/portfolio/column-values.ts +42 -8
- package/src/portfolio/futures-positions.ts +10 -2
- package/src/portfolio/mutations.ts +4 -3
- package/src/portfolio/period-pnl.ts +119 -0
- package/src/portfolio/positions-import/describe.ts +89 -0
- package/src/portfolio/positions-import/parse.ts +682 -0
- package/src/portfolio/positions-import/plan.ts +295 -0
- package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
- package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
- package/src/react/jsx-dev-fallback.ts +62 -0
- package/src/renderers/browser/cloud-transport.ts +1 -1
- package/src/renderers/browser/config-host.ts +3 -1
- package/src/renderers/browser/deeplink-bridge.ts +8 -1
- package/src/renderers/browser/http-proxy-transport.ts +9 -2
- package/src/renderers/browser/main.tsx +2 -1
- package/src/renderers/browser/research-entry.ts +12 -0
- package/src/renderers/cloudflare/http-proxy.ts +8 -2
- package/src/renderers/cloudflare/proxy-session.ts +1 -0
- package/src/renderers/cloudflare/worker.ts +12 -3
- package/src/renderers/dom/desktop/audio-player.tsx +2 -2
- package/src/renderers/dom/desktop/controls.tsx +1 -1
- package/src/renderers/dom/desktop/dialog-actions.tsx +10 -24
- package/src/renderers/dom/desktop/icons.tsx +4 -2
- package/src/renderers/dom/desktop/query-bar.tsx +23 -19
- package/src/renderers/dom/dom-host-providers.tsx +7 -2
- package/src/renderers/dom/host/box.tsx +2 -2
- package/src/renderers/dom/host/input.tsx +13 -0
- package/src/renderers/dom/key-event.ts +1 -0
- package/src/renderers/dom/styles.css +3 -0
- package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
- package/src/renderers/electrobun/bun/desktop/backend.ts +1 -0
- package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
- package/src/renderers/electrobun/bun/desktop/host-requests.ts +5 -4
- package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
- package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
- package/src/renderers/electrobun/bun/desktop/initialization.ts +3 -1
- package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
- package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
- package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
- package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
- package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
- package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
- package/src/renderers/electrobun/bun/window/attention.ts +1 -0
- package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
- package/src/renderers/electrobun/bun/window/create.ts +1 -0
- package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
- package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
- package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
- package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
- package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
- package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
- package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
- package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
- package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
- package/src/renderers/electrobun/view/http-fetch.ts +2 -1
- package/src/renderers/electrobun/view/main.tsx +9 -4
- package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
- package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
- package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
- package/src/renderers/electrobun/view/ui-host.tsx +3 -2
- package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
- package/src/renderers/opentui/browser-open.ts +2 -1
- package/src/renderers/opentui/dialog-host.tsx +1 -1
- package/src/renderers/opentui/interaction-performance.ts +3 -1
- package/src/renderers/opentui/start.tsx +2 -1
- package/src/renderers/opentui/terminal-media.ts +11 -6
- package/src/renderers/opentui/ui-host.tsx +5 -8
- package/src/shares/open.ts +22 -1
- package/src/shares/pane.ts +2 -1
- package/src/sources/gloomberb-cloud/normalizers.ts +3 -0
- package/src/sync/analytics-payload.ts +194 -0
- package/src/sync/baseline.ts +19 -9
- package/src/sync/broker-identity.ts +171 -0
- package/src/sync/broker-instances.ts +137 -0
- package/src/sync/collections-contributor.ts +173 -0
- package/src/sync/config-contributor.ts +100 -0
- package/src/sync/config-merge.ts +229 -0
- package/src/sync/controller.ts +139 -28
- package/src/sync/core-contributors.ts +8 -1583
- package/src/sync/history-memo.ts +32 -0
- package/src/sync/layout-merge.ts +259 -0
- package/src/sync/sanitize.ts +114 -0
- package/src/sync/ticker-merge.ts +208 -0
- package/src/sync/ticker-payload.ts +81 -0
- package/src/sync/types.ts +15 -1
- package/src/telemetry/attention-setting.ts +1 -1
- package/src/telemetry/usage-counts.ts +16 -0
- package/src/test-support/preload.ts +5 -0
- package/src/theme/color-utils.ts +10 -0
- package/src/theme/font-scale.ts +34 -3
- package/src/theme/series-colors.ts +44 -0
- package/src/theme/themes.ts +2 -1
- package/src/tickers/batched-lookups.ts +263 -6
- package/src/tickers/company-name-listing.ts +44 -2
- package/src/tickers/company-name.ts +7 -2
- package/src/tickers/search/upsert.ts +16 -1
- package/src/time-series/base-series.ts +18 -4
- package/src/time-series/studies/indicators.ts +3 -1
- package/src/time-series/studies/resolve.ts +1 -1
- package/src/time-series/types.ts +6 -0
- package/src/types/financials.ts +18 -0
- package/src/types/headless.ts +11 -0
- package/src/ui/host.tsx +26 -3
- package/src/ui/index.tsx +1 -0
- package/src/utils/concurrency.ts +6 -0
- package/src/utils/currency-pair.ts +56 -4
- package/src/utils/datetime-format.ts +11 -0
- package/src/utils/decimal-comma.ts +9 -6
- package/src/utils/exchanges.ts +32 -0
- package/src/utils/fundamentals.ts +41 -0
- package/src/utils/markdown.ts +4 -2
- package/src/utils/pasted-lines.ts +14 -0
- package/src/utils/price-window.ts +2 -1
- package/src/utils/sec-filings.ts +17 -0
- package/src/utils/sec.ts +4 -23
- package/src/utils/shortcut-labels.ts +6 -30
|
@@ -4,6 +4,7 @@ import type { DataProvider } from "../../../types/data-provider";
|
|
|
4
4
|
import { isNoSourceAnswer } from "../../../sources/provider-errors";
|
|
5
5
|
import type { PricePoint } from "../../../types/financials";
|
|
6
6
|
import { logFailure } from "../../../utils/log-failure";
|
|
7
|
+
import { PERIOD_BASE_MAX_GAP_DAYS, periodBaseDay } from "../../../market-data/market/period-return";
|
|
7
8
|
import { coalescedBump } from "./coalesced-bump";
|
|
8
9
|
import { readsInBatches } from "../../../market-data/batched-reads";
|
|
9
10
|
import { boardReadGate } from "./board-reads";
|
|
@@ -11,9 +12,10 @@ import type { BoardQuoteMap } from "../shared/use-quote-board";
|
|
|
11
12
|
import type { FuturesContract } from "../../../market-data/futures-board";
|
|
12
13
|
import {
|
|
13
14
|
frontContractCandidates,
|
|
14
|
-
|
|
15
|
+
frontContractPeriodReturns,
|
|
15
16
|
NO_FUTURES_RETURNS,
|
|
16
17
|
pickFrontContract,
|
|
18
|
+
type FuturesReturnBases,
|
|
17
19
|
type FuturesReturnValues,
|
|
18
20
|
} from "./returns";
|
|
19
21
|
|
|
@@ -21,6 +23,8 @@ interface FrontReturnsState {
|
|
|
21
23
|
/** A candidate contract's history is still loading. */
|
|
22
24
|
loading: boolean;
|
|
23
25
|
values: FuturesReturnValues;
|
|
26
|
+
/** The day each return's base close is from, once the contract's history is read. */
|
|
27
|
+
bases?: FuturesReturnBases;
|
|
24
28
|
}
|
|
25
29
|
|
|
26
30
|
export type FrontReturnsMap = ReadonlyMap<string, FrontReturnsState>;
|
|
@@ -44,9 +48,32 @@ const HISTORY_RETRY_MS = 60_000;
|
|
|
44
48
|
*/
|
|
45
49
|
const historyCache = createTtlCache<readonly PricePoint[] | null>({ ttlMs: HISTORY_TTL_MS, rejectionMs: HISTORY_RETRY_MS });
|
|
46
50
|
|
|
51
|
+
const DAY_MS = 86_400_000;
|
|
52
|
+
function dayOf(point: PricePoint): string | null {
|
|
53
|
+
const time = new Date(point.date as Date | string | number).getTime();
|
|
54
|
+
return Number.isFinite(time) ? new Date(time).toISOString().slice(0, 10) : null;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* A year's read starts on the day a year back, so when that day did not trade
|
|
59
|
+
* (a weekend, a holiday) it holds no close on or before it, and the 1Y return
|
|
60
|
+
* has no base. The weeks before it are read too, for a contract that traded
|
|
61
|
+
* from the start of the year; one listed since has no close a year back to find.
|
|
62
|
+
*/
|
|
63
|
+
async function withYearBackClose(provider: DataProvider, symbol: string, points: PricePoint[]): Promise<PricePoint[]> {
|
|
64
|
+
const read = provider.getDetailedPriceHistoryWithMetadata;
|
|
65
|
+
const first = points[0] ? dayOf(points[0]) : null;
|
|
66
|
+
const yearBack = periodBaseDay(new Date().toISOString().slice(0, 10), "1Y");
|
|
67
|
+
if (!read || !first || first <= yearBack || Date.parse(`${first}T00:00:00Z`) - Date.parse(`${yearBack}T00:00:00Z`) > 7 * DAY_MS) return points;
|
|
68
|
+
const start = new Date(Date.parse(`${yearBack}T00:00:00Z`) - PERIOD_BASE_MAX_GAP_DAYS * DAY_MS);
|
|
69
|
+
const earlier = await read.call(provider, symbol, "", start, new Date(`${first}T00:00:00Z`), "1d")
|
|
70
|
+
.then((result) => result.points.filter((point) => (dayOf(point) ?? first) < first), logFailure("futures", "Read a futures contract's close a year back failed", []));
|
|
71
|
+
return earlier.length > 0 ? [...earlier, ...points] : points;
|
|
72
|
+
}
|
|
73
|
+
|
|
47
74
|
/** `batch`: asked with every other row's, from a source that batches them (`DataProvider.batchesReads`). */
|
|
48
75
|
function readHistory(provider: DataProvider, symbol: string, batch: boolean): Promise<readonly PricePoint[] | null> {
|
|
49
|
-
return provider.getPriceHistory(symbol, "", "1Y", batch ? { batch } : undefined).then((points) => points.length > 0 ? points : null, (error: unknown) => {
|
|
76
|
+
return provider.getPriceHistory(symbol, "", "1Y", batch ? { batch } : undefined).then(async (points) => points.length > 0 ? withYearBackClose(provider, symbol, points) : null, (error: unknown) => {
|
|
50
77
|
if (isNoSourceAnswer(error)) return null;
|
|
51
78
|
throw error;
|
|
52
79
|
});
|
|
@@ -127,10 +154,9 @@ export function useFrontContractReturns(
|
|
|
127
154
|
const available = loaded.flatMap((entry) => entry.history ? [{ symbol: entry.symbol, history: entry.history }] : []);
|
|
128
155
|
const front = pickFrontContract(available, quote?.price);
|
|
129
156
|
const history = available.find((entry) => entry.symbol === front)?.history;
|
|
130
|
-
result.set(contract.symbol,
|
|
131
|
-
loading: false,
|
|
132
|
-
|
|
133
|
-
});
|
|
157
|
+
result.set(contract.symbol, history
|
|
158
|
+
? { loading: false, ...frontContractPeriodReturns(history, quote?.price, quote?.lastUpdated) }
|
|
159
|
+
: { loading: false, values: NO_FUTURES_RETURNS });
|
|
134
160
|
}
|
|
135
161
|
return result;
|
|
136
162
|
// `version` re-reads the history cache as loads land.
|
|
@@ -19,6 +19,13 @@ const rank = (value: unknown) => value === null || typeof value === "number" &&
|
|
|
19
19
|
const optionalDate = (value: unknown) => value === undefined || value === null || date(value);
|
|
20
20
|
/** Contract terms the pane computes with; a curve from before the server sent them has none. */
|
|
21
21
|
const validSpec = (spec: unknown) => spec === undefined || spec === null || isFuturesContractSpec(spec);
|
|
22
|
+
/** A contract's spot in its print's minute; absent from other roots and older servers. */
|
|
23
|
+
function validContractSpot(spot: unknown): boolean {
|
|
24
|
+
if (spot === undefined || spot === null) return true;
|
|
25
|
+
if (typeof spot !== "object") return false;
|
|
26
|
+
const { symbol, price, minute } = spot as Record<string, unknown>;
|
|
27
|
+
return typeof symbol === "string" && typeof price === "number" && Number.isFinite(price) && price > 0 && timestamp(minute);
|
|
28
|
+
}
|
|
22
29
|
|
|
23
30
|
export function validateFuturesCurve(data: FuturesCurvePayload, root: string): FuturesCurvePayload {
|
|
24
31
|
if (!data || data.root !== root || !Array.isArray(data.contracts) || !Array.isArray(data.ghosts)
|
|
@@ -39,7 +46,7 @@ export function validateFuturesCurve(data: FuturesCurvePayload, root: string): F
|
|
|
39
46
|
|| row.asOf !== null && !timestamp(row.asOf)
|
|
40
47
|
|| ![row.volume, row.openInterest, row.delayMinutes].every((value) => finiteOrNull(value) && (value === null || value >= 0))
|
|
41
48
|
|| row.settlement !== undefined && !finiteOrNull(row.settlement) || !optionalDate(row.lastTrade) || !optionalDate(row.firstNotice)
|
|
42
|
-
|| row.inDelivery !== undefined && typeof row.inDelivery !== "boolean") {
|
|
49
|
+
|| row.inDelivery !== undefined && typeof row.inDelivery !== "boolean" || !validContractSpot(row.spot)) {
|
|
43
50
|
throw new Error("The server returned an invalid futures contract");
|
|
44
51
|
}
|
|
45
52
|
symbols.add(row.symbol);
|
|
@@ -57,7 +64,10 @@ export function validateFuturesCurve(data: FuturesCurvePayload, root: string): F
|
|
|
57
64
|
|| ![slope.percentile, slope.rollPercentile].every(rank) || !Number.isInteger(slope.samples) || slope.samples < 0
|
|
58
65
|
|| slope.asOf !== null && !timestamp(slope.asOf)
|
|
59
66
|
|| slope.basis != null && slope.basis !== "last" && slope.basis !== "settle"
|
|
60
|
-
|| slope.thinSymbol != null && typeof slope.thinSymbol !== "string"
|
|
67
|
+
|| slope.thinSymbol != null && typeof slope.thinSymbol !== "string"
|
|
68
|
+
|| slope.skippedSymbols != null && !(Array.isArray(slope.skippedSymbols) && slope.skippedSymbols.every((symbol) => typeof symbol === "string"))) {
|
|
69
|
+
throw new Error("The server returned an invalid futures spread");
|
|
70
|
+
}
|
|
61
71
|
return data;
|
|
62
72
|
}
|
|
63
73
|
|
|
@@ -5,7 +5,7 @@ import { formatPercentRaw } from "../../../utils/format";
|
|
|
5
5
|
import { DATE_OPTION_EXAMPLES } from "../../../utils/calendar-date";
|
|
6
6
|
import { newestReportTime, oldestReportTime } from "../../../utils/utc-time";
|
|
7
7
|
import { fetchFuturesCurve, loadCurveSpot, loadCurveSpotBars, loadCurveSpotCloses, loadFuturesCurveAsOf } from "./client";
|
|
8
|
-
import { basisSpotSymbol, BASIS_CONVENTION, blankBasisNote, catalogueCurveUnit, curveAsOfDate, curveBasisPercent, curveBasisRows, curveChangeText, curveContractCode, curvePrice, curveReadsThirtySeconds, curveRoundedPrice, curveSpotSource, curveSpotPremium, curveSpreadLabel, curveTimestamp, curveNoTradeSince, curveUnitLabel, noTradeChangeNote, normalizeCurveRoot, shortDatedBasisNote, spotIndexSymbol, thinSpreadNotice, unpairedContractCount, unsupportedCurveRootMessage, type ContractBasis, type CurveSpotPremium } from "./model";
|
|
8
|
+
import { basisSpotSymbol, BASIS_CONVENTION, blankBasisNote, catalogueCurveUnit, curveAsOfDate, curveCache, curveSpotBars, curveBasisPercent, curveBasisRows, curveChangeText, curveContractCode, curvePrice, curveReadsThirtySeconds, curveRoundedPrice, curveSpotSource, curveSpotPremium, curveSpreadLabel, curveTimestamp, curveNoTradeSince, curveSettleShown, curveUnitLabel, noTradeChangeNote, normalizeCurveRoot, shortDatedBasisNote, skippedSpreadNotice, spotIndexSymbol, thinSpreadNotice, unpairedContractCount, unsupportedCurveRootMessage, type ContractBasis, type CurveSpotPremium } from "./model";
|
|
9
9
|
import { COMMODITIES_VIEW_STATE } from "../commodities-energy/view-state";
|
|
10
10
|
import { knownGapMessage } from "../../../cli/known-gaps";
|
|
11
11
|
|
|
@@ -24,7 +24,9 @@ const basisValue = (value: number | null) => value == null ? null : Number(value
|
|
|
24
24
|
* the latest trade and `settlement` the exchange settlement for the curve's
|
|
25
25
|
* settlement session (a past curve's settled rows have no separate trade).
|
|
26
26
|
* `change` is `price` less `settlement`; `noTradeSince` dates the settlement
|
|
27
|
-
* a contract has not traded since, whose change is therefore blank
|
|
27
|
+
* a contract has not traded since, whose change is therefore blank, and
|
|
28
|
+
* `settleShown` the one it is shown and plotted at (no trade since, or none
|
|
29
|
+
* at all). A crypto
|
|
28
30
|
* root adds the basis: the spot in the minute of `price`'s trade and that
|
|
29
31
|
* minute (`spot`, `spotTime`), the fractional days from the trade to final
|
|
30
32
|
* settlement, and the premium and its yearly rate.
|
|
@@ -37,6 +39,8 @@ function contractRow(row: FuturesContract, data: FuturesCurvePayload, root: stri
|
|
|
37
39
|
settlement: price(row.settlement), settlementDate: row.settlement != null ? data.settlementDate ?? null : null,
|
|
38
40
|
price: past && row.settlement != null ? null : price(row.price), change: price(row.change),
|
|
39
41
|
noTradeSince: past ? null : curveNoTradeSince(row, data),
|
|
42
|
+
// The settlement session a live contract is shown at, when it has no trade since (or none at all): its curve point is that settlement.
|
|
43
|
+
settleShown: past ? null : curveSettleShown(row, data),
|
|
40
44
|
asOf: row.asOf, stale: row.stale, volume: row.volume, openInterest: row.openInterest, percentile: rank(row.percentile),
|
|
41
45
|
samples: row.samples, historyStart: row.historyStart, historyEnd: row.historyEnd,
|
|
42
46
|
currency: row.currency, quoteUnit: curveUnitLabel(data) ?? row.quoteUnit, delayMinutes: row.delayMinutes,
|
|
@@ -53,22 +57,30 @@ function contractRow(row: FuturesContract, data: FuturesCurvePayload, root: stri
|
|
|
53
57
|
function contractColumns(root: string, settlementDate: string | null, options: { basis: boolean; last: boolean; notice: boolean; text?: boolean }): HeadlessPaneColumn[] {
|
|
54
58
|
const price = (value: unknown) => typeof value === "number" ? curvePrice(value, root) : "--";
|
|
55
59
|
const date = (value: unknown) => typeof value === "string" ? value : "--";
|
|
60
|
+
// An export has every column whatever the root, so CL's and GC's headers are the same; the text drops the ones a root leaves blank.
|
|
61
|
+
const exported = !options.text;
|
|
56
62
|
return [
|
|
57
63
|
{ key: "symbol", header: "Contract", shrink: false, format: (value) => curveContractCode(String(value)) },
|
|
58
64
|
{ key: "lastTrade", header: "Last Trade", shrink: false, format: date },
|
|
59
65
|
// Cash-settled roots have no first notice day.
|
|
60
|
-
...options.notice ? [{ key: "firstNotice", header: "1st Notice", shrink: false,
|
|
66
|
+
...options.notice || exported ? [{ key: "firstNotice", header: "1st Notice", shrink: false,
|
|
61
67
|
format: (value: unknown, row: Record<string, unknown>) => typeof value === "string" ? `${value}${row.inDelivery ? " passed" : ""}` : "--" }] : [],
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
...options.
|
|
68
|
+
// One header whatever the session: an export dates each settlement in its own column, the text in the header.
|
|
69
|
+
{ key: "settlement", header: "Settle", ...settlementDate ? { textHeader: `Settle ${settlementDate}` } : {}, align: "right", format: price },
|
|
70
|
+
...options.text ? [] : [{ key: "settlementDate", header: "settle_date", literalHeader: true, shrink: false, format: date }],
|
|
71
|
+
// A Cboe price is the settlement itself, with no separate last trade: an export leaves its Last blank.
|
|
72
|
+
...options.last || exported ? [{ key: "price", header: "Last", align: "right" as const, format: options.last ? price : () => "--" }] : [],
|
|
65
73
|
{ key: "change", header: "Change", align: "right", format: (value) => typeof value === "number" ? curveChangeText(value, root) : "--" },
|
|
66
|
-
...options.basis ? [{ key: "spot", header: "Spot", align: "right" as const, format: price },
|
|
74
|
+
...options.basis || exported ? [{ key: "spot", header: "Spot", align: "right" as const, format: price },
|
|
67
75
|
...options.text ? [] : [{ key: "spotTime", header: "Spot Time UTC", shrink: false, format: (value: unknown) => typeof value === "string" ? curveTimestamp(value) : "--" }],
|
|
68
76
|
{ key: "vsSpotPct", header: "Vs Spot", align: "right" as const, format: (value: unknown) => curveBasisPercent(typeof value === "number" ? value : null, 2) },
|
|
69
77
|
{ key: "daysToExpiry", header: "Days to Expiry", textHeader: "Days", align: "right" as const, format: (value: unknown) => typeof value === "number" ? value.toFixed(1) : "--" },
|
|
70
78
|
{ key: "annualisedBasisPct", header: "Ann Basis", align: "right" as const, format: (value: unknown) => curveBasisPercent(typeof value === "number" ? value : null, 1) }] : [],
|
|
71
|
-
|
|
79
|
+
// A month with no trade since the settlement it shows is dated by that settlement, never read as an old print:
|
|
80
|
+
// the text says so, an export leaves the cell empty (settle_date dates it).
|
|
81
|
+
{ key: "asOf", header: "As Of UTC", shrink: false,
|
|
82
|
+
format: (value, row) => typeof row.settleShown === "string" ? "--" : typeof value === "string" ? curveTimestamp(value) : "--",
|
|
83
|
+
textFormat: (value, row) => typeof row.settleShown === "string" ? `settle ${row.settleShown}` : typeof value === "string" ? curveTimestamp(value) : "--" },
|
|
72
84
|
{ key: "openInterest", header: "Open Int", align: "right", format: (value) => typeof value === "number" ? value.toLocaleString("en-US") : "--" },
|
|
73
85
|
{ key: "volume", header: "Volume", align: "right", format: (value) => typeof value === "number" ? value.toLocaleString("en-US") : "--" },
|
|
74
86
|
{ key: "percentile", header: "Pctl", align: "right", format: (value) => typeof value === "number" ? String(value) : "--" },
|
|
@@ -82,12 +94,29 @@ function contractColumns(root: string, settlementDate: string | null, options: {
|
|
|
82
94
|
*/
|
|
83
95
|
function fieldColumns(order: readonly string[], fields: object, formats: Record<string, HeadlessPaneColumn["textFormat"]> = {}): HeadlessPaneColumn[] {
|
|
84
96
|
return [...order, ...Object.keys(fields).filter((key) => !order.includes(key))]
|
|
85
|
-
.map((key) => ({ key, header: key, ...formats[key] ? { textFormat: formats[key] } : {} }));
|
|
97
|
+
.map((key) => ({ key, header: key, ...SYMBOL_FIELDS.has(key) ? { format: contractCodeFormat } : {}, ...formats[key] ? { textFormat: formats[key] } : {} }));
|
|
86
98
|
}
|
|
87
99
|
|
|
100
|
+
/**
|
|
101
|
+
* The front spread's columns: every field in one order, the skipped months
|
|
102
|
+
* last as one cell (`GCF27`), which the text names in a note instead.
|
|
103
|
+
*/
|
|
104
|
+
function spreadColumns(row: Record<string, unknown>, formats: Record<string, HeadlessPaneColumn["textFormat"]>, text: boolean): HeadlessPaneColumn[] {
|
|
105
|
+
const fields = Object.fromEntries(Object.entries(row).filter(([key]) => key !== SKIPPED_FIELD));
|
|
106
|
+
return [...fieldColumns(FRONT_SPREAD_FIELDS, fields, formats),
|
|
107
|
+
...text ? [] : [{ key: SKIPPED_FIELD, header: SKIPPED_FIELD, format: (value: unknown) => Array.isArray(value)
|
|
108
|
+
? value.filter((entry): entry is string => typeof entry === "string").map(curveContractCode).join(" ") : "" }]];
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/** The fields naming a contract, written in every section as the Contracts table writes it: CLZ26, never CLZ26.NYM. */
|
|
112
|
+
const SYMBOL_FIELDS: ReadonlySet<string> = new Set(["symbol", "frontSymbol", "nextSymbol", "thinSymbol"]);
|
|
113
|
+
const contractCodeFormat = (value: unknown) => typeof value === "string" && value ? curveContractCode(value) : "-";
|
|
114
|
+
|
|
88
115
|
// `basis` says which prices the value subtracts: two last trades made together, or the settlements of the session in `asOf`.
|
|
89
116
|
const FRONT_SPREAD_FIELDS = ["label", "frontSymbol", "nextSymbol", "value", "annualizedRollYield", "percentile", "rollPercentile",
|
|
90
117
|
"samples", "historyStart", "historyEnd", "asOf", "basis", "state", "thinSymbol"];
|
|
118
|
+
/** The months the spread passed over for their thin open interest: an export keeps them, the text names them in a note. */
|
|
119
|
+
const SKIPPED_FIELD = "skippedSymbols";
|
|
91
120
|
const GHOST_FIELDS = ["symbol", "expiration", "price", "asOf"];
|
|
92
121
|
/** The annualized roll yield reads as the percent it is (+32.36%); an export keeps the number. */
|
|
93
122
|
const ROLL_YIELD_FORMAT = { annualizedRollYield: (value: unknown) => typeof value === "number" ? formatPercentRaw(value) : "--" };
|
|
@@ -172,19 +201,22 @@ export const futuresCurveHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
|
172
201
|
indexSymbol ? loadCurveSpotCloses(indexSymbol, ctx.marketData, ctx.refresh === true) : null,
|
|
173
202
|
]);
|
|
174
203
|
const spotPremium = closes ? curveSpotPremium(data, closes) : null;
|
|
175
|
-
|
|
204
|
+
// The server's spot in each print's own minute fills what the reader's bars do not reach yet.
|
|
205
|
+
const spotBars = curveSpotBars(bars, data.contracts);
|
|
206
|
+
const bases = spot && spotBars ? curveBasisRows(data.contracts, spotBars) : null;
|
|
176
207
|
const unit = curveUnitLabel(data);
|
|
177
208
|
const terms = specEntries(data);
|
|
178
209
|
const source = spot ? curveSpotSource(spot) : null;
|
|
179
210
|
const notices = [...args.argument ? [] : [`Showing ${DEFAULT_ROOT}. Try fn CTM ${EXAMPLE_ROOT}.`],
|
|
180
211
|
...spot ? [`Basis against ${spot.symbol} spot in each last trade's own minute${source ? ` (${source})` : ""}; not the CME reference rate.`] : []];
|
|
181
212
|
// The footnotes under the table: the convention, why a cell is blank, and where a short-dated rate is not to be trusted.
|
|
182
|
-
const basisNotes = bases ? [BASIS_CONVENTION, blankBasisNote(data.contracts, bases), shortDatedBasisNote(data.contracts, bases)]
|
|
213
|
+
const basisNotes = bases ? [BASIS_CONVENTION, blankBasisNote(data.contracts, bases, curveCache(data, now)), shortDatedBasisNote(data.contracts, bases)]
|
|
183
214
|
.filter((note): note is string => !!note) : [];
|
|
184
215
|
// A blank Change says why, as a blank basis does; a past curve has no session change to blank.
|
|
185
216
|
const changeNote = date ? null : noTradeChangeNote(data.contracts, data);
|
|
186
217
|
const thinSpread = thinSpreadNotice(data);
|
|
187
|
-
const
|
|
218
|
+
const skipped = skippedSpreadNotice(data);
|
|
219
|
+
const notes = [...thinSpread ? [`${thinSpread}.`] : [], ...skipped ? [`${skipped}.`] : [], ...changeNote ? [changeNote] : [], ...basisNotes,
|
|
188
220
|
...spotPremium?.reason ? [`Front premium blank: ${spotPremium.reason}.`] : []];
|
|
189
221
|
const columnOptions = { basis: !!bases, last: data.source !== "cboe", notice: data.contracts.some((row) => row.firstNotice) };
|
|
190
222
|
// Dated by the contracts' own quotes; the same-contract history rows are a year of context, not observations.
|
|
@@ -193,19 +225,28 @@ export const futuresCurveHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
|
193
225
|
? { status: "not-a-feed", basis: "settlement archive", asOf: date }
|
|
194
226
|
: { ...(data.source === "cboe" ? { source: "Cboe", status: "not-a-feed", basis: "daily settlement", cadence: "daily" } as const : {}),
|
|
195
227
|
asOf: newestReportTime(quoted), oldest: oldestReportTime(quoted) };
|
|
228
|
+
// No contract to list is no curve: the report says why once and fails, as `help fn` says an empty one does.
|
|
229
|
+
if (!data.contracts.length) {
|
|
230
|
+
return { freshness, sections: [], empty: `No ${root} contracts from the source.`, errors: data.gaps,
|
|
231
|
+
metadata: { ...data, quoteUnit: unit, complete: false, ...(args.argument ? {} : { defaultArgument: DEFAULT_ROOT }) } };
|
|
232
|
+
}
|
|
233
|
+
const spreadRow = { label: curveSpreadLabel(data.slope), ...data.slope, value: curveRoundedPrice(data.slope.value, root),
|
|
234
|
+
annualizedRollYield: data.slope.annualizedRollYield == null ? null : Number(data.slope.annualizedRollYield.toFixed(2)),
|
|
235
|
+
percentile: rank(data.slope.percentile), rollPercentile: rank(data.slope.rollPercentile), [SKIPPED_FIELD]: data.slope.skippedSymbols ?? [] };
|
|
236
|
+
const spreadFormats = { ...ROLL_YIELD_FORMAT, ...thirtySecondsFormat(root, "value") };
|
|
196
237
|
return {
|
|
197
238
|
freshness,
|
|
198
239
|
sections: [
|
|
199
240
|
{ title: "Contracts", columns: contractColumns(root, data.settlementDate ?? null, columnOptions),
|
|
200
|
-
|
|
241
|
+
textColumns: contractColumns(root, data.settlementDate ?? null, { ...columnOptions, text: true }),
|
|
242
|
+
...unit ? { unit } : {},
|
|
201
243
|
rows: data.contracts.map((row) => contractRow(row, data, root, !!date, bases?.get(row.symbol))) },
|
|
202
|
-
{ title: "Front spread", columns:
|
|
203
|
-
|
|
204
|
-
percentile: rank(data.slope.percentile), rollPercentile: rank(data.slope.rollPercentile) }] },
|
|
244
|
+
{ title: "Front spread", columns: spreadColumns(spreadRow, spreadFormats, false), textColumns: spreadColumns(spreadRow, spreadFormats, true),
|
|
245
|
+
rows: [spreadRow] },
|
|
205
246
|
...spotPremium ? [{ title: "Front vs spot", entries: spotPremiumEntries(spotPremium, root) }] : [],
|
|
206
247
|
...terms.length ? [{ title: "Contract terms", entries: terms }] : [],
|
|
207
248
|
...data.ghosts.map((ghost) => ({ title: `${ghost.label} same-contract history`, columns: fieldColumns(GHOST_FIELDS, ghost.points[0] ?? {}, thirtySecondsFormat(root, "price")),
|
|
208
|
-
rows: ghost.points.map((point) => ({ ...point })) })),
|
|
249
|
+
...unit ? { unit } : {}, rows: ghost.points.map((point) => ({ ...point })) })),
|
|
209
250
|
],
|
|
210
251
|
errors: data.gaps,
|
|
211
252
|
...(notes.length ? { notes } : {}),
|
|
@@ -10,7 +10,7 @@ import { formatPercentileRank } from "../../../utils/format";
|
|
|
10
10
|
import { formatThirtySeconds } from "../../../market-data/market/format";
|
|
11
11
|
import { cryptoPairCoin, isFuturesSymbol } from "../shared/crypto-pair";
|
|
12
12
|
import { parseReportTime } from "../../../utils/utc-time";
|
|
13
|
-
import { zonedWallClockToUtcMs } from "../../../utils/zoned-date-time";
|
|
13
|
+
import { zonedDateKey, zonedWallClockToUtcMs } from "../../../utils/zoned-date-time";
|
|
14
14
|
import { dateOptionError, dateOptionFormatsOr, readCalendarDate } from "../../../utils/calendar-date";
|
|
15
15
|
import { compareSortValues, type SortDirection } from "../../../utils/sort-values";
|
|
16
16
|
|
|
@@ -186,6 +186,24 @@ function thinSpreadReason(data: Pick<FuturesCurvePayload, "slope" | "contracts">
|
|
|
186
186
|
return leg.asOf ? `${code} last traded ${leg.asOf.slice(0, 10)}` : `${code} has not traded`;
|
|
187
187
|
}
|
|
188
188
|
|
|
189
|
+
/**
|
|
190
|
+
* The months the front spread passed over for the next one a roll goes to,
|
|
191
|
+
* with the open interest each holds: "Front spread pairs GCZ26 with GCG27
|
|
192
|
+
* (77,624 open interest), skipping GCF27 (799)". Null when it skipped none.
|
|
193
|
+
*/
|
|
194
|
+
export function skippedSpreadNotice(data: Pick<FuturesCurvePayload, "slope" | "contracts">): string | null {
|
|
195
|
+
const skipped = data.slope.skippedSymbols ?? [];
|
|
196
|
+
if (!skipped.length || !data.slope.frontSymbol || !data.slope.nextSymbol) return null;
|
|
197
|
+
const held = (symbol: string) => {
|
|
198
|
+
const interest = data.contracts.find((row) => row.symbol === symbol)?.openInterest;
|
|
199
|
+
return interest == null ? "" : interest.toLocaleString("en-US");
|
|
200
|
+
};
|
|
201
|
+
const next = held(data.slope.nextSymbol);
|
|
202
|
+
const months = skipped.map((symbol) => `${curveContractCode(symbol)}${held(symbol) ? ` (${held(symbol)})` : ""}`).join(", ");
|
|
203
|
+
return `Front spread pairs ${curveContractCode(data.slope.frontSymbol)} with ${curveContractCode(data.slope.nextSymbol)}`
|
|
204
|
+
+ `${next ? ` (${next} open interest)` : ""}, skipping ${months}`;
|
|
205
|
+
}
|
|
206
|
+
|
|
189
207
|
/** The warning a thin front spread carries: why, and that its sign is no slope call. */
|
|
190
208
|
export function thinSpreadNotice(data: Pick<FuturesCurvePayload, "slope" | "contracts">): string | null {
|
|
191
209
|
const reason = thinSpreadReason(data);
|
|
@@ -270,13 +288,21 @@ function charted<T extends { expiration: string }>(rows: readonly T[], horizon:
|
|
|
270
288
|
return rows.filter((row) => Date.parse(row.expiration) <= end.getTime());
|
|
271
289
|
}
|
|
272
290
|
|
|
273
|
-
export function futuresCurveSeries(data: FuturesCurvePayload, palette?: CurvePalette, horizon = DEFAULT_CURVE_HORIZON, now = Date.now(),
|
|
291
|
+
export function futuresCurveSeries(data: FuturesCurvePayload, palette?: CurvePalette & { settle?: string }, horizon = DEFAULT_CURVE_HORIZON, now = Date.now(),
|
|
274
292
|
currentLabel = data.source === "cboe" ? "Settlement" : "Latest"): CurveSeries[] {
|
|
275
293
|
const contracts = charted(data.contracts, horizon, now);
|
|
294
|
+
const point = (row: FuturesContract) => ({ id: row.symbol, label: curveContractMonth(row.symbol, row.expiration), x: Date.parse(row.expiration),
|
|
295
|
+
value: curveShownPrice(row, data), asOf: curveSettleShown(row, data) ?? row.asOf });
|
|
296
|
+
// The months shown at a settlement beside months that traded since are marked on the line, which keeps their
|
|
297
|
+
// values for the cursor and the readout. A curve of settlements alone (a past date, a weekend) has nothing to tell apart.
|
|
298
|
+
const shownAtSettle = contracts.filter((row) => curveSettleShown(row, data));
|
|
299
|
+
const settled = shownAtSettle.length < contracts.length ? shownAtSettle : [];
|
|
276
300
|
return [{
|
|
277
301
|
id: "current", label: currentLabel, asOf: newestQuote(contracts), color: palette?.current,
|
|
278
|
-
points: contracts.map(
|
|
279
|
-
}, ...data.
|
|
302
|
+
points: contracts.map(point),
|
|
303
|
+
}, ...settled.length ? [{ id: "settle", label: `Settle ${data.settlementDate!.slice(5)}, no trade since`, role: "marker" as const,
|
|
304
|
+
color: palette?.settle, points: settled.map(point) }] : [],
|
|
305
|
+
...data.ghosts.map((ghost) => {
|
|
280
306
|
// The payload dates a ghost by its oldest point, which can be a contract beyond the charted horizon.
|
|
281
307
|
const points = charted(ghost.points, horizon, now);
|
|
282
308
|
const asOf = newestQuote(points);
|
|
@@ -292,15 +318,17 @@ export type CurveContractChanges = ReadonlyMap<string, Readonly<Record<CurveLook
|
|
|
292
318
|
|
|
293
319
|
/**
|
|
294
320
|
* How far each contract moved since the week- and month-back curves, by
|
|
295
|
-
* symbol: the
|
|
296
|
-
*
|
|
321
|
+
* symbol: the price it is shown at less its close then, a settlement against
|
|
322
|
+
* a settlement for a month with no trade since (curveShownPrice). A leg
|
|
323
|
+
* missing either side stays null rather than reading as no move.
|
|
297
324
|
*/
|
|
298
325
|
export function curveContractChanges(data: FuturesCurvePayload): CurveContractChanges {
|
|
299
326
|
const past = new Map(data.ghosts.map((ghost) => [ghost.label, new Map(ghost.points.map((point) => [point.symbol, point.price]))]));
|
|
300
327
|
return new Map(data.contracts.map((row) => {
|
|
328
|
+
const shown = curveShownPrice(row, data);
|
|
301
329
|
const change = (label: CurveLookback) => {
|
|
302
330
|
const then = past.get(label)?.get(row.symbol);
|
|
303
|
-
return
|
|
331
|
+
return shown == null || then == null ? null : shown - then;
|
|
304
332
|
};
|
|
305
333
|
return [row.symbol, { "1W": change("1W"), "1M": change("1M") }];
|
|
306
334
|
}));
|
|
@@ -418,6 +446,24 @@ export interface SpotBar {
|
|
|
418
446
|
price: number;
|
|
419
447
|
}
|
|
420
448
|
|
|
449
|
+
/**
|
|
450
|
+
* The spot bars a basis is read from: the pair's one-minute bars as the
|
|
451
|
+
* reader's history serves them, and the spot the server read for each
|
|
452
|
+
* contract's own print minute, which a delayed reader's bars do not reach
|
|
453
|
+
* yet (a front month prints ten minutes behind, delayed spot fifteen). The
|
|
454
|
+
* server's wins where both have a minute. Null while the reader's bars are
|
|
455
|
+
* unknown, so a blank is never explained before they answer.
|
|
456
|
+
*/
|
|
457
|
+
export function curveSpotBars(bars: readonly SpotBar[] | null, contracts: readonly Pick<FuturesContract, "spot">[]): SpotBar[] | null {
|
|
458
|
+
if (!bars) return null;
|
|
459
|
+
const byMinute = new Map(bars.map((bar) => [bar.minute, bar.price]));
|
|
460
|
+
for (const { spot } of contracts) {
|
|
461
|
+
const time = spot ? Date.parse(spot.minute) : Number.NaN;
|
|
462
|
+
if (spot && Number.isFinite(time) && positive(spot.price)) byMinute.set(minuteOf(time), spot.price);
|
|
463
|
+
}
|
|
464
|
+
return [...byMinute].sort((a, b) => a[0] - b[0]).map(([minute, price]) => ({ minute, price }));
|
|
465
|
+
}
|
|
466
|
+
|
|
421
467
|
/** One-minute bars as the spot by minute, oldest first; a bar with no usable time or close is left out. */
|
|
422
468
|
export function spotBarsFromHistory(points: readonly { date: Date | string | number; close: number }[]): SpotBar[] {
|
|
423
469
|
const byMinute = new Map<number, number>();
|
|
@@ -624,11 +670,35 @@ function pairTimes(print: number, spot: number): string {
|
|
|
624
670
|
return printDate === spotDate ? `print ${printTime}, nearest spot ${spotTime} UTC` : `print ${printDate} ${printTime}, nearest spot ${spotDate} ${spotTime} UTC`;
|
|
625
671
|
}
|
|
626
672
|
|
|
673
|
+
/**
|
|
674
|
+
* A curve the server served from a copy it kept, because its source failed:
|
|
675
|
+
* when that copy was read, and the clock its age is measured against.
|
|
676
|
+
*/
|
|
677
|
+
export interface CurveCache {
|
|
678
|
+
fetchedAt: string;
|
|
679
|
+
now: number;
|
|
680
|
+
}
|
|
681
|
+
|
|
682
|
+
/** The cache a curve was served from, when the server says it was; null for a curve read now. */
|
|
683
|
+
export function curveCache(data: Pick<FuturesCurvePayload, "cached" | "fetchedAt">, now: number): CurveCache | null {
|
|
684
|
+
return data.cached === true && Number.isFinite(Date.parse(data.fetchedAt)) ? { fetchedAt: data.fetchedAt, now } : null;
|
|
685
|
+
}
|
|
686
|
+
|
|
687
|
+
/** `cached curve read 21:55 UTC, 9 h old`, with the date when the copy is not from the clock's day. */
|
|
688
|
+
function cachedCurveReason(cache: CurveCache): string {
|
|
689
|
+
const read = Date.parse(cache.fetchedAt);
|
|
690
|
+
const stamp = curveTimestamp(new Date(read).toISOString());
|
|
691
|
+
const today = new Date(cache.now).toISOString().slice(0, 10);
|
|
692
|
+
const minutes = Math.max(0, Math.floor((cache.now - read) / MINUTE_MS));
|
|
693
|
+
return `cached curve read ${stamp.startsWith(today) ? stamp.slice(11) : stamp} UTC, ${gapText(minutes)} old`;
|
|
694
|
+
}
|
|
695
|
+
|
|
627
696
|
/** Why one priced-or-not contract has no basis against known spot bars, in the order `contractBasis` decides it. */
|
|
628
|
-
function blankReason(row: Pick<FuturesContract, "price" | "stale">, basis: ContractBasis): string | null {
|
|
697
|
+
function blankReason(row: Pick<FuturesContract, "price" | "stale">, basis: ContractBasis, cache: CurveCache | null): string | null {
|
|
629
698
|
if (basis.vsSpotPct != null) return null;
|
|
630
699
|
if (!positive(row.price)) return "no price";
|
|
631
|
-
|
|
700
|
+
// A cached copy marks every contract stale for being a copy, not for its prices' age.
|
|
701
|
+
if (row.stale) return cache ? cachedCurveReason(cache) : "price over two sessions old";
|
|
632
702
|
const unpaired = basis.unpaired;
|
|
633
703
|
if (!unpaired) return null;
|
|
634
704
|
if (unpaired.print == null) return "last trade has no time of day";
|
|
@@ -641,11 +711,12 @@ function blankReason(row: Pick<FuturesContract, "price" | "stale">, basis: Contr
|
|
|
641
711
|
* The contracts whose basis cells are blank against known spot bars, grouped by cause and named, so a blank is
|
|
642
712
|
* never unexplained: the far months of a curve print rarely, and a trade no spot bar shares a minute with is not read.
|
|
643
713
|
*/
|
|
644
|
-
export function blankBasisNote(rows: readonly Pick<FuturesContract, "symbol" | "price" | "stale">[], basis: CurveBasisRows
|
|
714
|
+
export function blankBasisNote(rows: readonly Pick<FuturesContract, "symbol" | "price" | "stale">[], basis: CurveBasisRows,
|
|
715
|
+
cache: CurveCache | null = null): string | null {
|
|
645
716
|
const groups = new Map<string, string[]>();
|
|
646
717
|
for (const row of rows) {
|
|
647
718
|
const cell = basis.get(row.symbol);
|
|
648
|
-
const reason = cell ? blankReason(row, cell) : null;
|
|
719
|
+
const reason = cell ? blankReason(row, cell, cache) : null;
|
|
649
720
|
if (reason) groups.set(reason, [...groups.get(reason) ?? [], curveContractCode(row.symbol)]);
|
|
650
721
|
}
|
|
651
722
|
return groups.size ? `Basis blank for ${[...groups].map(([reason, codes]) => `${codes.join(", ")} (${reason})`).join("; ")}.` : null;
|
|
@@ -733,14 +804,19 @@ export function withTradedExpirations(data: FuturesCurvePayload): FuturesCurvePa
|
|
|
733
804
|
};
|
|
734
805
|
}
|
|
735
806
|
|
|
807
|
+
/** From 18:00 New York a print belongs to the next trade date: six hours later it is that date there. */
|
|
808
|
+
const NEXT_SESSION_SHIFT_MS = 6 * 3_600_000;
|
|
809
|
+
|
|
736
810
|
/**
|
|
737
811
|
* The trading date a print belongs to, as the server dates sessions: CME's
|
|
738
|
-
* session for a date opens at 18:00 New York the evening before
|
|
739
|
-
*
|
|
740
|
-
*
|
|
812
|
+
* session for a date opens at 18:00 New York the evening before, so a print
|
|
813
|
+
* from then on is the next date's, read on New York's clock. The session's
|
|
814
|
+
* close at 17:00 New York (22:00 UTC in winter, when a two-hour shift of UTC
|
|
815
|
+
* carried it into the next date) stays on its own date, and day-only venues
|
|
816
|
+
* are as they are. A settlement's date is its session.
|
|
741
817
|
*/
|
|
742
818
|
function curveSessionDate(asOf: string): string {
|
|
743
|
-
return asOf.length === 10 ? asOf :
|
|
819
|
+
return asOf.length === 10 ? asOf : zonedDateKey(Date.parse(asOf) + NEXT_SESSION_SHIFT_MS, "America/New_York");
|
|
744
820
|
}
|
|
745
821
|
|
|
746
822
|
/**
|
|
@@ -756,6 +832,26 @@ export function curveNoTradeSince(row: Pick<FuturesContract, "price" | "settleme
|
|
|
756
832
|
return curveSessionDate(row.asOf) <= session ? session : null;
|
|
757
833
|
}
|
|
758
834
|
|
|
835
|
+
/**
|
|
836
|
+
* The session whose settlement a live contract is shown at: it has no trade
|
|
837
|
+
* since that settlement (curveNoTradeSince), or no last trade at all, as in a
|
|
838
|
+
* session that has just opened. Its row, its point on the curve and its 1W
|
|
839
|
+
* and 1M moves read the settlement, so a month with no trade today is never
|
|
840
|
+
* read as an old print beside months that traded. Null for a contract shown
|
|
841
|
+
* at its last trade, and on a Cboe curve, whose prices are settlements.
|
|
842
|
+
*/
|
|
843
|
+
export function curveSettleShown(row: Pick<FuturesContract, "price" | "settlement" | "asOf">,
|
|
844
|
+
data: Pick<FuturesCurvePayload, "source" | "settlementDate">): string | null {
|
|
845
|
+
if (data.source === "cboe" || !data.settlementDate || row.settlement == null) return null;
|
|
846
|
+
return row.price == null ? data.settlementDate : curveNoTradeSince(row, data);
|
|
847
|
+
}
|
|
848
|
+
|
|
849
|
+
/** The price a live contract is plotted and measured at: its settlement when it has not traded since (curveSettleShown), else its last trade. */
|
|
850
|
+
function curveShownPrice(row: Pick<FuturesContract, "price" | "settlement" | "asOf">,
|
|
851
|
+
data: Pick<FuturesCurvePayload, "source" | "settlementDate">): number | null {
|
|
852
|
+
return curveSettleShown(row, data) ? row.settlement ?? null : row.price;
|
|
853
|
+
}
|
|
854
|
+
|
|
759
855
|
/**
|
|
760
856
|
* The live curve with every Change on the basis its table states: the last
|
|
761
857
|
* trade less the settlement in the Settle column. The source's session change
|
|
@@ -17,7 +17,7 @@ import { futuresSessionRefreshInterval } from "../shared/futures-session";
|
|
|
17
17
|
import { useResearchCloudSession } from "../shared/research-cloud-session";
|
|
18
18
|
import { useQuoteBoard } from "../shared/use-quote-board";
|
|
19
19
|
import { getCachedFuturesCurve, loadCurveSpotBars, loadCurveSpotCloses, loadFuturesCurve, loadFuturesCurveAsOf } from "./client";
|
|
20
|
-
import { BASIS_CONVENTION, basisSpotSymbol, blankBasisNote, curveAsOfDate, curveAxisGrid, curveAxisPrice, curveBasisPercent, curveBasisRows, curveChangeText, curveContractChanges, curveContractCode, curvePrice, curveRank, curveSpot, curveSpotLabel, curveSpotPremium, curveSpotSource, curveSpreadBasis, curveSpreadLabel, curveTimestamp, curveTitle, curveUnitLabel, DEFAULT_CURVE_HORIZON, futuresCurveSeries, newestQuote, noTradeChangeNote, normalizeCurveRoot, paneCurveRoot, shortDatedBasis, shortDatedBasisNote, sortCurveContracts, spotIndexSymbol, thinSpreadNotice, unsupportedCurveRootMessage, type CurveContractChanges, type CurveSpot } from "./model";
|
|
20
|
+
import { BASIS_CONVENTION, basisSpotSymbol, blankBasisNote, curveAsOfDate, curveAxisGrid, curveAxisPrice, curveBasisPercent, curveBasisRows, curveCache, curveChangeText, curveContractChanges, curveContractCode, curvePrice, curveRank, curveSettleShown, curveSpot, curveSpotBars, curveSpotLabel, curveSpotPremium, curveSpotSource, curveSpreadBasis, curveSpreadLabel, curveTimestamp, curveTitle, curveUnitLabel, DEFAULT_CURVE_HORIZON, futuresCurveSeries, newestQuote, noTradeChangeNote, normalizeCurveRoot, paneCurveRoot, shortDatedBasis, shortDatedBasisNote, skippedSpreadNotice, sortCurveContracts, spotIndexSymbol, thinSpreadNotice, unsupportedCurveRootMessage, type CurveContractChanges, type CurveSpot } from "./model";
|
|
21
21
|
|
|
22
22
|
const TABS = [{ value: "curve", label: "Curve" }, { value: "contracts", label: "Contracts" }];
|
|
23
23
|
// One column order for every root. SETTLE is the exchange settlement for the
|
|
@@ -152,12 +152,13 @@ function FuturesCurveView({ width, height, focused, root, ownsTitle }: PaneProps
|
|
|
152
152
|
const staleCount = data?.contracts.filter((row) => row.stale).length ?? 0;
|
|
153
153
|
const newest = data ? newestQuote(data.contracts) : null;
|
|
154
154
|
// A past curve is named by the session it holds: a weekend or holiday date shows the session before it.
|
|
155
|
-
const curves = useMemo(() => data ? futuresCurveSeries(data, { current: colors.positive, ghosts: curveGhostColors(colors) }, horizon,
|
|
155
|
+
const curves = useMemo(() => data ? futuresCurveSeries(data, { current: colors.positive, settle: colors.text, ghosts: curveGhostColors(colors) }, horizon,
|
|
156
156
|
requestedDate ? Date.parse(`${requestedDate}T00:00:00Z`) : Date.now(), requestedDate ? data.asOf ?? requestedDate : undefined) : [],
|
|
157
157
|
[data, colors, horizon, requestedDate]);
|
|
158
158
|
const changes = useMemo<CurveContractChanges>(() => data ? curveContractChanges(data) : new Map(), [data]);
|
|
159
159
|
// Until the bars first answer there is nothing to say: no reason, only blank cells.
|
|
160
|
-
|
|
160
|
+
// The server's spot in each print's own minute fills what the bars a delayed reader gets do not reach yet.
|
|
161
|
+
const bars = useMemo(() => basisActive ? curveSpotBars(spotBars.data ?? null, data?.contracts ?? []) : null, [basisActive, spotBars.data, data]);
|
|
161
162
|
const basis = useMemo(() => curveBasisRows(basisActive ? data?.contracts ?? [] : [], bars), [basisActive, bars, data]);
|
|
162
163
|
const rows = useMemo(() => sortCurveContracts(data?.contracts ?? [], sort.columnId, sort.direction, changes, basis), [data, sort, changes, basis]);
|
|
163
164
|
// The curve tab lists the contracts the chart plots; Contracts keeps every one.
|
|
@@ -177,6 +178,7 @@ function FuturesCurveView({ width, height, focused, root, ownsTitle }: PaneProps
|
|
|
177
178
|
const thin = data?.slope.state === "thin";
|
|
178
179
|
const spreadRank = data && !thin ? curveRank(data.slope.percentile, data.slope.samples) : null;
|
|
179
180
|
const thinSpread = data ? thinSpreadNotice(data) : null;
|
|
181
|
+
const skippedSpread = data ? skippedSpreadNotice(data) : null;
|
|
180
182
|
// Until the closes first answer there is nothing to say.
|
|
181
183
|
const spotPremium = useMemo(() => data && indexSymbol && spotCloses.data ? curveSpotPremium(data, spotCloses.data) : null,
|
|
182
184
|
[data, indexSymbol, spotCloses.data]);
|
|
@@ -250,7 +252,7 @@ function FuturesCurveView({ width, height, focused, root, ownsTitle }: PaneProps
|
|
|
250
252
|
// A past date with no archived curve says why in the body, not behind the warning.
|
|
251
253
|
const emptyPast = !!requestedDate && !!data && !data.contracts.length;
|
|
252
254
|
// The basis notes the report prints under its table: the convention, why a cell is blank, and which rates spot noise swamps.
|
|
253
|
-
const basisNotes = basisActive && bars ? [BASIS_CONVENTION, blankBasisNote(tableRows, basis), shortDatedBasisNote(tableRows, basis)]
|
|
255
|
+
const basisNotes = basisActive && bars ? [BASIS_CONVENTION, blankBasisNote(tableRows, basis, data ? curveCache(data, clock) : null), shortDatedBasisNote(tableRows, basis)]
|
|
254
256
|
.filter((note): note is string => !!note) : [];
|
|
255
257
|
// A long in these can be assigned delivery: the hedge a trader rolls before first notice.
|
|
256
258
|
const delivering = data?.contracts.filter((row) => row.inDelivery).map((row) => curveContractCode(row.symbol)) ?? [];
|
|
@@ -258,7 +260,7 @@ function FuturesCurveView({ width, height, focused, root, ownsTitle }: PaneProps
|
|
|
258
260
|
const untraded = data && !requestedDate && columns.some((entry) => entry.id === "change")
|
|
259
261
|
? noTradeChangeNote(tableRows, data, { count: true }) : null;
|
|
260
262
|
usePaneNoticeFooter({ registrationId: "futures-curve:notices", focused,
|
|
261
|
-
notices: emptyPast ? [] : [...data?.gaps ?? [], ...thinSpread ? [thinSpread] : [], ...basisNotes, ...untraded ? [untraded] : [],
|
|
263
|
+
notices: emptyPast ? [] : [...data?.gaps ?? [], ...thinSpread ? [thinSpread] : [], ...skippedSpread ? [skippedSpread] : [], ...basisNotes, ...untraded ? [untraded] : [],
|
|
262
264
|
...delivering.length ? [`${delivering.join(", ")} ${delivering.length === 1 ? "is" : "are"} past first notice.`] : []] });
|
|
263
265
|
const delay = Math.max(0, ...(data?.contracts.map((row) => row.delayMinutes ?? 0) ?? []));
|
|
264
266
|
usePaneStatusFooter({ registrationId: "futures-curve", loading: resource.loading, error: resource.error,
|
|
@@ -313,8 +315,11 @@ function FuturesCurveView({ width, height, focused, root, ownsTitle }: PaneProps
|
|
|
313
315
|
if (column.id === "percentile") return { text: row.samples < 2 || row.percentile == null ? "--" : row.percentile.toFixed(0) };
|
|
314
316
|
if (column.id === "oi") return { text: integer(row.openInterest) };
|
|
315
317
|
if (column.id === "volume") return { text: integer(row.volume) };
|
|
318
|
+
// A month with no trade since the settlement it shows is dated by that settlement, as the curve marks it.
|
|
319
|
+
const settled = data && !requestedDate ? curveSettleShown(row, data) : null;
|
|
320
|
+
if (settled) return { text: `settle ${settled}`, color: colors.textMuted };
|
|
316
321
|
return { text: curveTimestamp(row.asOf), color: row.stale ? colors.warning : colors.textMuted };
|
|
317
|
-
}, [basis, changes, colors, curveTab, requestedDate, root]);
|
|
322
|
+
}, [basis, changes, colors, curveTab, data, requestedDate, root]);
|
|
318
323
|
return <Box width={width} height={height} flexDirection="column">
|
|
319
324
|
{tabStrip}
|
|
320
325
|
<QueryBar width={width} filters={[{
|