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
|
@@ -20,6 +20,7 @@ function base(data: CotPayloadBase, family: CotFamily, positions: CotPositions)
|
|
|
20
20
|
|| !Array.isArray(data.gaps) || !data.gaps.every((gap) => typeof gap === "string")
|
|
21
21
|
|| !Array.isArray(data.classes) || data.classes.some((row) => !COT_CLASSES[family].some((option) => option.value === row.id))
|
|
22
22
|
|| data.asOf !== null && !date(data.asOf) || !Number.isFinite(Date.parse(data.generatedAt))
|
|
23
|
+
|| data.publishedAt != null && !Number.isFinite(Date.parse(data.publishedAt))
|
|
23
24
|
|| !["available", "partial", "unavailable"].includes(data.status)) throw new Error("The server returned an invalid COT report");
|
|
24
25
|
}
|
|
25
26
|
function summary(row: CotClassSummary, family: CotFamily) {
|
|
@@ -27,7 +28,7 @@ function summary(row: CotClassSummary, family: CotFamily) {
|
|
|
27
28
|
|| ![row.long, row.short, row.spreading].every(count) || ![row.net, row.weeklyChange, row.netPercentOfOpenInterest].every(number)
|
|
28
29
|
|| row.net !== (row.long == null || row.short == null ? null : row.long - row.short)
|
|
29
30
|
|| row.previousReportDate !== null && !date(row.previousReportDate)) throw new Error("The server returned invalid COT positions");
|
|
30
|
-
for (const rank of [row.percentile1Y, row.percentile3Y]) {
|
|
31
|
+
for (const rank of [row.percentile1Y, row.percentile3Y, ...(row.percentileAll === undefined ? [] : [row.percentileAll])]) {
|
|
31
32
|
if (!rank || !Number.isSafeInteger(rank.sampleCount) || rank.sampleCount < 0 || typeof rank.completeWindow !== "boolean"
|
|
32
33
|
|| ![rank.min, rank.max, rank.mean, rank.rank].every(number) || !date(rank.windowStart) || !date(rank.windowEnd)
|
|
33
34
|
|| rank.value !== null && (!number(rank.value) || rank.value < 0 || rank.value > 100)
|
|
@@ -86,8 +87,12 @@ export async function loadCotBoard(family: CotFamily, traderClass: CotClass, for
|
|
|
86
87
|
() => fetchCotBoard(family, traderClass, apiClient, positions), { force });
|
|
87
88
|
return presentCotBoard(payload, stale, refreshError);
|
|
88
89
|
}
|
|
89
|
-
export async function fetchCotContract(contractCode: string, family: CotFamily, client: Pick<typeof apiClient, "getCloudCotContract"> = apiClient,
|
|
90
|
-
|
|
90
|
+
export async function fetchCotContract(contractCode: string, family: CotFamily, client: Pick<typeof apiClient, "getCloudCotContract"> = apiClient,
|
|
91
|
+
positions: CotPositions = "futures-only", since?: string) {
|
|
92
|
+
try {
|
|
93
|
+
const payload = await client.getCloudCotContract(contractCode, family, positions, since);
|
|
94
|
+
return validateCotContract(payload, family, contractCode, positions);
|
|
95
|
+
}
|
|
91
96
|
catch (error) { throw unavailable(error); }
|
|
92
97
|
}
|
|
93
98
|
export interface CotDetailData { payload: CotContractPayload; price: PricePoint[]; priceSymbol: string | null; priceAsOf: string | null; priceWarning: string | null }
|
|
@@ -4,6 +4,7 @@ import { fetchCotBoard, fetchCotContract } from "./client";
|
|
|
4
4
|
import { COT_CLASSES, COT_FAMILIES, COT_MAJOR_CODES, COT_POSITIONS, COT_SCOPES, cotClass, cotContractCode, cotContractUnitText, cotFamily, cotInteger, cotMarketName, cotPositions, cotPositionsText, cotProxyFor, cotProxyNote, cotReleaseTime, cotScope, cotUnknownMarketMessage } from "./model";
|
|
5
5
|
import { COMMODITIES_VIEW_STATE } from "../commodities-energy/view-state";
|
|
6
6
|
import { REPORT_ROWS } from "../shared/headless-options";
|
|
7
|
+
import { DATE_OPTION_EXAMPLES, isoDateOption } from "../../../utils/calendar-date";
|
|
7
8
|
|
|
8
9
|
const camelClass = (id: CotClass) => id.replace(/-(\w)/g, (_match, letter: string) => letter.toUpperCase());
|
|
9
10
|
const rounded = (value: number | null, digits: number) => value == null ? null : Number(value.toFixed(digits));
|
|
@@ -12,17 +13,26 @@ const signed = (value: unknown) => cotInteger(typeof value === "number" ? value
|
|
|
12
13
|
const percent = (value: unknown) => typeof value === "number" ? `${value > 0 ? "+" : ""}${value.toFixed(1)}%` : "--";
|
|
13
14
|
const rank = (value: unknown) => typeof value === "number" ? value.toFixed(0) : "--";
|
|
14
15
|
|
|
15
|
-
/**
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
16
|
+
/**
|
|
17
|
+
* The report's release, by the CFTC's schedule, as Gloom Cloud states it (else
|
|
18
|
+
* the app's copy of the schedule): one time for the text, CSV and JSON, the
|
|
19
|
+
* export's publication time and the metadata's `publishedAt` alike.
|
|
20
|
+
*/
|
|
21
|
+
function cotPublishedAt(data: Pick<CotContractPayload, "asOf" | "publishedAt">): string | null {
|
|
22
|
+
return data.publishedAt ?? cotReleaseTime(data.asOf);
|
|
23
|
+
}
|
|
24
|
+
/** Who published the report, cited by every export: the CFTC itself. */
|
|
25
|
+
const COT_PUBLISHER = "Commodity Futures Trading Commission (CFTC)";
|
|
26
|
+
function cotReleased(publishedAt: string | null) {
|
|
27
|
+
return { freshness: { publisher: COT_PUBLISHER, ...(publishedAt ? { publishedAt } : {}) } };
|
|
19
28
|
}
|
|
20
29
|
|
|
21
30
|
/** The pane's columns: percentiles as their rank value, net share of open interest to one decimal. */
|
|
22
31
|
function cotPositionRow(row: CotClassSummary) {
|
|
23
32
|
return { long: row.long, short: row.short, spreading: row.spreading, net: row.net,
|
|
24
33
|
netPercentOfOpenInterest: rounded(row.netPercentOfOpenInterest, 1), weeklyChange: row.weeklyChange, previousReportDate: row.previousReportDate,
|
|
25
|
-
oneYearPercentile: rounded(row.percentile1Y.value, 0), threeYearPercentile: rounded(row.percentile3Y.value, 0)
|
|
34
|
+
oneYearPercentile: rounded(row.percentile1Y.value, 0), threeYearPercentile: rounded(row.percentile3Y.value, 0),
|
|
35
|
+
allHistoryPercentile: rounded(row.percentileAll?.value ?? null, 0) };
|
|
26
36
|
}
|
|
27
37
|
/**
|
|
28
38
|
* A market's title line: its name, the report date (the Tuesday the positions
|
|
@@ -48,8 +58,40 @@ const POSITION_COLUMNS: HeadlessPaneColumn[] = [
|
|
|
48
58
|
{ key: "netPercentOfOpenInterest", header: "Net % OI", align: "right", format: percent },
|
|
49
59
|
{ key: "oneYearPercentile", header: "Pctl 1Y", align: "right", format: rank },
|
|
50
60
|
{ key: "threeYearPercentile", header: "Pctl 3Y", align: "right", format: rank },
|
|
61
|
+
// Every stored report of the market, from its first (back to 1986 for the oldest Legacy markets).
|
|
62
|
+
{ key: "allHistoryPercentile", header: "Pctl All", align: "right", format: rank },
|
|
51
63
|
];
|
|
52
64
|
|
|
65
|
+
/**
|
|
66
|
+
* The grain markets the CFTC moved from thousands of bushels to contracts in
|
|
67
|
+
* January 1998, each under a new code: their Legacy reports before that are
|
|
68
|
+
* under the old code, a separate market here (not joined to the new one).
|
|
69
|
+
*/
|
|
70
|
+
const COT_CODES_BEFORE_1998: Readonly<Record<string, string>> = {
|
|
71
|
+
"001602": "001601", // wheat, CBOT
|
|
72
|
+
"001612": "001611", // wheat, Kansas City
|
|
73
|
+
"001626": "001621", // wheat, Minneapolis
|
|
74
|
+
"001627": "001624", // white wheat, Minneapolis
|
|
75
|
+
"002602": "002601", // corn
|
|
76
|
+
"004603": "004601", // oats
|
|
77
|
+
"005602": "005601", // soybeans
|
|
78
|
+
};
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* What the weekly section says about how far back it reaches: the history
|
|
82
|
+
* `--since` asked for begins after the market's first report, or the server
|
|
83
|
+
* has none that old.
|
|
84
|
+
*/
|
|
85
|
+
function cotHistoryNote(data: CotContractPayload, since: string | null): string | null {
|
|
86
|
+
const first = data.history[0]?.reportDate;
|
|
87
|
+
if (!since || !first || first <= since) return null;
|
|
88
|
+
if (!data.historyStart || data.historyStart <= since) return `Weekly positions before ${first} are not available yet.`;
|
|
89
|
+
const previous = data.reportFamily === "legacy" ? COT_CODES_BEFORE_1998[data.contract?.contractCode ?? ""] : undefined;
|
|
90
|
+
return previous
|
|
91
|
+
? `Reports under CFTC code ${data.contract!.contractCode} start ${data.historyStart}, when the CFTC began counting this market in contracts; its earlier reports are under its previous code ${previous}, in thousands of bushels, and are not joined to these. --since ${since} lists from ${data.historyStart}.`
|
|
92
|
+
: `The CFTC's first report of this market in Gloom Cloud is ${data.historyStart}; --since ${since} lists from there.`;
|
|
93
|
+
}
|
|
94
|
+
|
|
53
95
|
export const cotHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
54
96
|
shape: "bundle",
|
|
55
97
|
// Tuesday positions published the Friday after; two weeks without a new report means one was missed.
|
|
@@ -62,6 +104,9 @@ export const cotHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
|
62
104
|
pluginState: { pluginId: COMMODITIES_VIEW_STATE.cot, key: "positions" } },
|
|
63
105
|
{ key: "scope", type: "enum", values: COT_SCOPES.map(({ value }) => ({ value })), defaultValue: "major", description: "Markets on the extremes board, as in the pane.",
|
|
64
106
|
pluginState: { pluginId: COMMODITIES_VIEW_STATE.cot, key: "scope" } },
|
|
107
|
+
{ key: "since", type: "string", placeholder: "date", example: "--since 2006-06-13",
|
|
108
|
+
description: `First report date a market lists, as ${DATE_OPTION_EXAMPLES}; three years by default. Ranks always read every report.`,
|
|
109
|
+
normalize: (value) => isoDateOption(value, "since") },
|
|
65
110
|
// Weekly reports come newest first, so --tail asks for the same newest n as --limit.
|
|
66
111
|
{ key: "limit", type: "integer", aliases: ["tail", "weeks", "rows"], minimum: 1, maximum: 2000, shot: REPORT_ROWS,
|
|
67
112
|
description: "Newest weekly reports a market lists; every one by default." }],
|
|
@@ -74,32 +119,40 @@ export const cotHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
|
74
119
|
const code = cotContractCode(args.argument);
|
|
75
120
|
if (!code) throw new Error(cotUnknownMarketMessage(args.argument));
|
|
76
121
|
const proxy = cotProxyFor(args.argument);
|
|
77
|
-
const
|
|
122
|
+
const since = typeof args.options.since === "string" && args.options.since ? args.options.since : null;
|
|
123
|
+
const data = await fetchCotContract(code, family, ctx.apiClient, positions, since ?? undefined);
|
|
124
|
+
const publishedAt = cotPublishedAt(data);
|
|
125
|
+
const historyNote = cotHistoryNote(data, since);
|
|
78
126
|
const classes = data.positions.map((row) => row.id);
|
|
79
127
|
const limit = args.options.limit == null ? null : Number(args.options.limit);
|
|
80
128
|
const weeks = cotWeeklyRows(data.history, limit);
|
|
129
|
+
const weeklyColumns: HeadlessPaneColumn[] = [{ key: "reportDate", header: "Report date" }, { key: "released", header: "Released" },
|
|
130
|
+
{ key: "openInterest", header: "Open interest", align: "right", format: count },
|
|
131
|
+
...classes.map((id) => ({ key: `${camelClass(id)}Net`, header: `${data.positions.find((row) => row.id === id)?.label ?? id} net`, align: "right" as const, format: signed }))];
|
|
81
132
|
return { sections: [{ title: cotContractTitle(data, code),
|
|
82
133
|
columns: [{ key: "class", header: "Class" }, { key: "long", header: "Long", align: "right", format: count },
|
|
83
134
|
{ key: "short", header: "Short", align: "right", format: count }, ...POSITION_COLUMNS],
|
|
84
135
|
rows: data.positions.map((row) => ({ class: row.label, ...cotPositionRow(row) })) },
|
|
85
136
|
{ title: weeks.length < data.history.length ? `Weekly positions · newest ${weeks.length} of ${data.history.length}` : "Weekly positions",
|
|
86
|
-
columns:
|
|
87
|
-
|
|
88
|
-
|
|
137
|
+
columns: weeklyColumns,
|
|
138
|
+
// Each report's scheduled release, for an export read as of a past week; the text keeps to the positions.
|
|
139
|
+
textColumns: weeklyColumns.filter((column) => column.key !== "released"),
|
|
140
|
+
rows: weeks.map((row) => ({ reportDate: row.reportDate, released: row.publishedAt ?? cotReleaseTime(row.reportDate), openInterest: row.openInterest,
|
|
89
141
|
...Object.fromEntries(row.positions.map((position) => [`${camelClass(position.id)}Net`, position.net])) })) }],
|
|
90
142
|
// "jet fuel" reads heating oil's positions, and says so.
|
|
91
|
-
...(proxy ? { notes: [cotProxyNote(proxy)] } : {}),
|
|
92
|
-
errors: data.gaps, metadata: { ...data, complete: data.status === "available" }, ...cotReleased(
|
|
143
|
+
...(proxy || historyNote ? { notes: [...(proxy ? [cotProxyNote(proxy)] : []), ...(historyNote ? [historyNote] : [])] } : {}),
|
|
144
|
+
errors: data.gaps, metadata: { ...data, publishedAt, complete: data.status === "available" }, ...cotReleased(publishedAt) };
|
|
93
145
|
}
|
|
94
146
|
const traderClass = cotClass(family, args.options.traderClass);
|
|
95
147
|
if (args.options.traderClass && traderClass !== args.options.traderClass) throw new Error("Trader class does not belong to this report family");
|
|
96
148
|
const scope = cotScope(args.options.scope);
|
|
97
149
|
const data = await fetchCotBoard(family, traderClass, ctx.apiClient, positions);
|
|
98
150
|
const rows = data.rows.filter((row) => scope === "all" || COT_MAJOR_CODES.has(row.contractCode));
|
|
151
|
+
const publishedAt = cotPublishedAt(data);
|
|
99
152
|
return { sections: [{ title: positions === "combined" ? `Positioning extremes · ${cotPositionsText(positions)}` : "Positioning extremes",
|
|
100
153
|
columns: [{ key: "marketName", header: "Market" }, { key: "contractCode", header: "Code" }, ...POSITION_COLUMNS,
|
|
101
154
|
{ key: "openInterest", header: "Open interest", align: "right", format: count }, { key: "reportDate", header: "As of" }],
|
|
102
155
|
rows: rows.map((row) => ({ contractCode: row.contractCode, marketName: cotMarketName(row.marketName), reportDate: row.reportDate, openInterest: row.openInterest, ...cotPositionRow(row.position) })) }],
|
|
103
|
-
errors: data.gaps, metadata: { ...data, scope, complete: data.status === "available" }, ...cotReleased(
|
|
156
|
+
errors: data.gaps, metadata: { ...data, scope, publishedAt, complete: data.status === "available" }, ...cotReleased(publishedAt) };
|
|
104
157
|
},
|
|
105
158
|
};
|
|
@@ -22,6 +22,7 @@ const BOARD_COLUMNS: DataTableColumn[] = [
|
|
|
22
22
|
{ id: "change", label: "1W Δ", width: 11, align: "right" },
|
|
23
23
|
{ id: "one", label: "PCTL 1Y", width: 8, align: "right" },
|
|
24
24
|
{ id: "three", label: "PCTL 3Y", width: 8, align: "right" },
|
|
25
|
+
{ id: "all", label: "PCTL ALL", width: 9, align: "right" },
|
|
25
26
|
{ id: "asOf", label: "AS OF", width: 10, align: "left" },
|
|
26
27
|
];
|
|
27
28
|
const POSITION_COLUMNS: DataTableColumn[] = [
|
|
@@ -32,13 +33,17 @@ const POSITION_COLUMNS: DataTableColumn[] = [
|
|
|
32
33
|
{ id: "change", label: "1W Δ", width: 10, align: "right" },
|
|
33
34
|
{ id: "one", label: "PCTL 1Y", width: 8, align: "right" },
|
|
34
35
|
{ id: "three", label: "PCTL 3Y", width: 8, align: "right" },
|
|
36
|
+
{ id: "all", label: "PCTL ALL", width: 9, align: "right" },
|
|
35
37
|
];
|
|
36
38
|
/** Net positioning is the subject: two parts of the plot to the front price's one. */
|
|
37
39
|
const NET_PRICE_PANELS = [{ id: "net", height: 2 }, { id: "price", height: 1 }];
|
|
38
40
|
const NET_PANEL = [{ id: "net" }];
|
|
39
41
|
/** Legend, four net rows, two price rows and the axis; a shorter band keeps the net alone. */
|
|
40
42
|
const PRICE_PANEL_MIN_ROWS = 8;
|
|
41
|
-
const rank = (value: number | null) => value == null ? "--" : value.toFixed(0);
|
|
43
|
+
const rank = (value: number | null | undefined) => value == null ? "--" : value.toFixed(0);
|
|
44
|
+
/** A class's rank in a percentile column: 1Y, 3Y, or against every stored report (`all`). */
|
|
45
|
+
const columnRank = (row: CotClassSummary, column: string) =>
|
|
46
|
+
(column === "one" ? row.percentile1Y : column === "three" ? row.percentile3Y : row.percentileAll)?.value ?? null;
|
|
42
47
|
const cotDetailTitle = (name: string | undefined, code: string | null) => name ? cotMarketName(name) : code ?? undefined;
|
|
43
48
|
|
|
44
49
|
export function CotPane(props: PaneProps) {
|
|
@@ -81,7 +86,8 @@ function CotBoard({ width, height, focused, family, initialCode }: PaneProps & {
|
|
|
81
86
|
: scope === "all" || COT_MAJOR_CODES.has(row.contractCode));
|
|
82
87
|
if (!sort.columnId) return result;
|
|
83
88
|
const value = (row: CotBoardRow) => ({ name: cotMarketName(row.marketName), code: row.contractCode, net: row.position.net, change: row.position.weeklyChange,
|
|
84
|
-
one: row.position.percentile1Y.value, three: row.position.percentile3Y.value,
|
|
89
|
+
one: row.position.percentile1Y.value, three: row.position.percentile3Y.value, all: row.position.percentileAll?.value ?? null,
|
|
90
|
+
asOf: row.reportDate })[sort.columnId as "name"];
|
|
85
91
|
return [...result].sort((a, b) => compareSortValues(value(a), value(b), sort.direction));
|
|
86
92
|
}, [data, query, scope, sort]);
|
|
87
93
|
useAutoRefresh(resource.updatedAt, resource.load);
|
|
@@ -116,7 +122,7 @@ function CotBoard({ width, height, focused, family, initialCode }: PaneProps & {
|
|
|
116
122
|
if (column.id === "code") return { text: row.contractCode, color: colors.textMuted };
|
|
117
123
|
if (column.id === "net") return { text: cotInteger(row.position.net, true) };
|
|
118
124
|
if (column.id === "change") return { text: cotInteger(row.position.weeklyChange, true) };
|
|
119
|
-
if (column.id === "one" || column.id === "three"
|
|
125
|
+
if (column.id === "one" || column.id === "three" || column.id === "all") return { text: rank(columnRank(row.position, column.id)), color: colors.warning };
|
|
120
126
|
return { text: row.reportDate, color: colors.textMuted };
|
|
121
127
|
}}
|
|
122
128
|
rootBefore={<QueryBar width={width}
|
|
@@ -197,8 +203,8 @@ function CotDetail({ width, height, focused, code, family, positions, traderClas
|
|
|
197
203
|
tableColumns={POSITION_COLUMNS} />}
|
|
198
204
|
selection={{ kind: "id", selectedId: traderClass, getId: (row) => row.id, onChange: (id) => onClassChange(id as CotClass) }}
|
|
199
205
|
onActivate={(row) => onClassChange(row.id)} getItemKey={(row) => row.id} sortColumnId={null} sortDirection="asc"
|
|
200
|
-
renderCell={(row: CotClassSummary, column) => ({ text: column.id === "name" ? row.label
|
|
201
|
-
: column.id === "three" ? rank(row.
|
|
206
|
+
renderCell={(row: CotClassSummary, column) => ({ text: column.id === "name" ? row.label
|
|
207
|
+
: column.id === "one" || column.id === "three" || column.id === "all" ? rank(columnRank(row, column.id)) : cotInteger(column.id === "change" ? row.weeklyChange : row[column.id as "long" | "short" | "net"], column.id === "net" || column.id === "change") })}
|
|
202
208
|
emptyStateTitle="Position classes unavailable." /> : null}
|
|
203
209
|
</PaneStatusBody>;
|
|
204
210
|
}
|
|
@@ -5,6 +5,7 @@ import type {
|
|
|
5
5
|
EarningsHistoryPayload,
|
|
6
6
|
EarningsReport,
|
|
7
7
|
} from "../../../api-client/earnings";
|
|
8
|
+
import { ApiRequestError } from "../../../api-client/errors";
|
|
8
9
|
import { createPluginCache } from "../../../data/plugin-cache";
|
|
9
10
|
import type { PluginPersistence } from "../../../types/plugin";
|
|
10
11
|
import { cachedCloudResource, loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
|
|
@@ -48,8 +49,15 @@ function validateEarningsCalendar(payload: EarningsCalendarPayload): EarningsCal
|
|
|
48
49
|
return payload;
|
|
49
50
|
}
|
|
50
51
|
|
|
52
|
+
/** The listing asked for: a Hong Kong code reads the same with or without its leading zeros (700:HKEX is 0700:HKEX). */
|
|
53
|
+
export function sameHistoryListing(served: unknown, asked: string): boolean {
|
|
54
|
+
if (served === asked) return true;
|
|
55
|
+
const code = (value: string) => /^(\d+):HKEX$/i.exec(value)?.[1]?.replace(/^0+(?=\d)/, "") ?? null;
|
|
56
|
+
return typeof served === "string" && code(asked) != null && code(served) === code(asked);
|
|
57
|
+
}
|
|
58
|
+
|
|
51
59
|
function validateEarningsHistory(payload: EarningsHistoryPayload, symbol: string): EarningsHistoryPayload {
|
|
52
|
-
if (!payload || payload.symbol
|
|
60
|
+
if (!payload || !sameHistoryListing(payload.symbol, symbol) || !Array.isArray(payload.reports)
|
|
53
61
|
|| payload.reports.some((report) => !validReport(report) || !numberOrNull(report.revenueActual))) {
|
|
54
62
|
throw new Error("The server returned an invalid earnings history");
|
|
55
63
|
}
|
|
@@ -88,12 +96,38 @@ export function loadEarningsBoard(query: EarningsCalendarQuery, force = false) {
|
|
|
88
96
|
{ force, validate: validateEarningsCalendar });
|
|
89
97
|
}
|
|
90
98
|
|
|
91
|
-
|
|
92
|
-
|
|
99
|
+
/**
|
|
100
|
+
* A history's cache key. A listing abroad's history differs by plan (Gloom
|
|
101
|
+
* Cloud adds its announcements' figures for Pro), so `accessKey` (the session
|
|
102
|
+
* and plan) keeps one account's apart from another's, and from the next
|
|
103
|
+
* sign-in's.
|
|
104
|
+
*/
|
|
105
|
+
const historyKey = (symbol: string, limit?: number, accessKey?: string) => {
|
|
106
|
+
const key = limit == null ? symbol : `${symbol}:${limit}`;
|
|
107
|
+
return accessKey ? `${key}|${accessKey}` : key;
|
|
108
|
+
};
|
|
109
|
+
|
|
110
|
+
export function cachedEarningsHistory(symbol: string, accessKey?: string) {
|
|
111
|
+
return cachedCloudResource(historyCache, historyKey(symbol, undefined, accessKey), (payload) => validateEarningsHistory(payload, symbol));
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
/**
|
|
115
|
+
* Whether ERN reads a listing's own past reports: every US listing, and of
|
|
116
|
+
* the listings abroad Hong Kong's, which Gloom Cloud reads from their
|
|
117
|
+
* results announcements. Any other listing abroad shows its next report.
|
|
118
|
+
*/
|
|
119
|
+
export function hasEarningsHistory(venueAbroad: string | null): boolean {
|
|
120
|
+
return venueAbroad == null || venueAbroad === "HKEX";
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
/** A server that does not read a listing abroad's history yet refuses it (400): the next report stands alone, as before. */
|
|
124
|
+
export function noHistoryAbroad(error: unknown): null {
|
|
125
|
+
if (error instanceof ApiRequestError && error.status === 400) return null;
|
|
126
|
+
throw error;
|
|
93
127
|
}
|
|
94
128
|
|
|
95
|
-
/** `limit` asks for more reports than the pane's default and is cached apart from it
|
|
96
|
-
export function loadEarningsHistory(symbol: string, force = false, limit?: number) {
|
|
97
|
-
return loadCloudResource(historyCache,
|
|
129
|
+
/** `limit` asks for more reports than the pane's default and is cached apart from it; `accessKey` as `cachedEarningsHistory`. */
|
|
130
|
+
export function loadEarningsHistory(symbol: string, force = false, limit?: number, accessKey?: string) {
|
|
131
|
+
return loadCloudResource(historyCache, historyKey(symbol, limit, accessKey), () => fetchEarningsHistory(symbol, apiClient, limit),
|
|
98
132
|
{ force, validate: (payload) => validateEarningsHistory(payload, symbol) });
|
|
99
133
|
}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import type { EarningsFiscalAnchor } from "../../../api-client/earnings";
|
|
2
|
+
import { addDays } from "./board-model";
|
|
3
|
+
|
|
4
|
+
/** A quarter as the company names it: NVIDIA's October 2026 quarter is Q3 of fiscal 2027. */
|
|
5
|
+
export interface FiscalQuarter {
|
|
6
|
+
fiscalYear: number;
|
|
7
|
+
fiscalQuarter: number;
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
const MONTH = /^(\d{4})-(\d{2})$/;
|
|
11
|
+
|
|
12
|
+
function monthIndex(period: string | null | undefined): number | null {
|
|
13
|
+
const found = period ? MONTH.exec(period) : null;
|
|
14
|
+
if (!found) return null;
|
|
15
|
+
const month = Number(found[2]);
|
|
16
|
+
return month >= 1 && month <= 12 ? Number(found[1]) * 12 + month - 1 : null;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
const monthOf = (index: number) => `${Math.floor(index / 12)}-${String((index % 12) + 1).padStart(2, "0")}`;
|
|
20
|
+
const monthEnd = (index: number) => addDays(`${monthOf(index + 1)}-01`, -1);
|
|
21
|
+
|
|
22
|
+
/** The quarter ending in `period` (YYYY-MM), stepped from the one the company's calls name. */
|
|
23
|
+
export function fiscalQuarterOf(period: string | null | undefined, anchor: EarningsFiscalAnchor | null | undefined): FiscalQuarter | null {
|
|
24
|
+
const month = monthIndex(period);
|
|
25
|
+
const from = monthIndex(anchor?.fiscalPeriod);
|
|
26
|
+
if (month == null || from == null || !anchor) return null;
|
|
27
|
+
const index = anchor.fiscalYear * 4 + anchor.fiscalQuarter - 1 + Math.round((month - from) / 3);
|
|
28
|
+
return { fiscalYear: Math.floor(index / 4), fiscalQuarter: (index % 4) + 1 };
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* The quarter-end month a report with none on record announces: the last on
|
|
33
|
+
* the company's cycle that ended 5 to 100 days before it, as Gloom Cloud
|
|
34
|
+
* places its own such reports. Null without the company's calendar.
|
|
35
|
+
*/
|
|
36
|
+
export function placedPeriod(date: string, anchor: EarningsFiscalAnchor | null | undefined): string | null {
|
|
37
|
+
const cycle = monthIndex(anchor?.fiscalPeriod);
|
|
38
|
+
const day = monthIndex(date.slice(0, 7));
|
|
39
|
+
if (cycle == null || day == null) return null;
|
|
40
|
+
const latest = addDays(date, -5);
|
|
41
|
+
const earliest = addDays(date, -100);
|
|
42
|
+
for (let month = day; month > day - 5; month -= 1) {
|
|
43
|
+
if ((month - cycle) % 3 !== 0) continue;
|
|
44
|
+
const end = monthEnd(month);
|
|
45
|
+
if (end <= latest && end >= earliest) return monthOf(month);
|
|
46
|
+
}
|
|
47
|
+
return null;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/** "Q3 FY2027", or "Q3 FY27" where a column is narrow. */
|
|
51
|
+
export function fiscalQuarterText(quarter: FiscalQuarter | null | undefined, short = false): string | null {
|
|
52
|
+
if (!quarter) return null;
|
|
53
|
+
return `Q${quarter.fiscalQuarter} FY${short ? String(quarter.fiscalYear).slice(-2) : quarter.fiscalYear}`;
|
|
54
|
+
}
|
|
@@ -11,10 +11,11 @@ import type {
|
|
|
11
11
|
import type { EarningsEvent } from "../../../types/data-provider";
|
|
12
12
|
import { addDays, boardReport, fallbackReport, MIN_AVERAGE_REPORTS, newYorkToday, type BoardReport } from "./board-model";
|
|
13
13
|
import { BOARD_WEEKS, boardRangeDays, boardRangeLabel, isBoardWeek, requestedBoardRange, type BoardRange } from "./calendar-model";
|
|
14
|
-
import { fetchEarningsCalendar, fetchEarningsHistory } from "./client";
|
|
14
|
+
import { fetchEarningsCalendar, fetchEarningsHistory, hasEarningsHistory, noHistoryAbroad } from "./client";
|
|
15
15
|
import { loadEarningsCalendar } from "./data/cache";
|
|
16
16
|
import { epsText, impliedText, moneyText, moveSize, signedPercent, TIMING_LABEL } from "./format";
|
|
17
|
-
import { historyRows } from "./history-model";
|
|
17
|
+
import { historyRows, periodText } from "./history-model";
|
|
18
|
+
import { fiscalQuarterText } from "./fiscal-quarter";
|
|
18
19
|
import { loadNoEarningsText } from "./no-earnings";
|
|
19
20
|
import { EPS_BASIS_NOTE, epsBasisName, PROVISIONAL_NOTE, showsEpsBasis } from "../shared/earnings-report";
|
|
20
21
|
import { isUsListingExchange } from "../../../utils/exchanges";
|
|
@@ -52,6 +53,12 @@ const BOARD_COLUMNS: HeadlessPaneColumn[] = [
|
|
|
52
53
|
{ key: "averageMove", header: "Avg move", align: right, format: (value) => moveSize(num(value)) },
|
|
53
54
|
];
|
|
54
55
|
|
|
56
|
+
/** What an ERN <ticker> report's quarter is, in its metadata. */
|
|
57
|
+
const FISCAL_QUARTER_NOTE = "fiscalQuarter is the quarter as the company names it (Q3 FY2027), from its earnings calls on record; fiscalPeriod is the month the quarter ended. A company whose calls do not name its quarters has fiscalQuarter null.";
|
|
58
|
+
|
|
59
|
+
/** When an upcoming report has an implied move, in an ERN <ticker> report's metadata. */
|
|
60
|
+
const IMPLIED_NOTE = "An upcoming report's implied move is read from its options' prices from 8 days before the report, for companies worth $2 billion or more. Before then, or for a smaller company, impliedMove is null: it is never estimated.";
|
|
61
|
+
|
|
55
62
|
/** Where the board's caps come from and how old they can be, in its metadata. */
|
|
56
63
|
const MARKET_CAP_NOTE = "Each company's market cap as RV shows it: its latest financials snapshot at the regular session's price (the close outside the session), from the newest quote Gloom Cloud holds for it. A company with no snapshot shows the earnings calendar's figure.";
|
|
57
64
|
|
|
@@ -59,7 +66,8 @@ const HISTORY_COLUMNS: HeadlessPaneColumn[] = [
|
|
|
59
66
|
{ key: "date", header: "Date" },
|
|
60
67
|
{ key: "dateStatus", header: "Status" },
|
|
61
68
|
{ key: "timing", header: "When" },
|
|
62
|
-
|
|
69
|
+
// The quarter as the company names it; its end month where the company's calls do not say. Exports keep both.
|
|
70
|
+
{ key: "fiscalQuarter", header: "Quarter", format: (value, row) => typeof value === "string" ? value : typeof row.fiscalPeriod === "string" ? row.fiscalPeriod : "-" },
|
|
63
71
|
{ key: "epsEstimate", header: "EPS est", align: right, format: (value) => epsText(num(value)) },
|
|
64
72
|
{ key: "epsAnalysts", header: "Ests", align: right },
|
|
65
73
|
{ key: "epsActual", header: "EPS act", align: right, format: (value) => epsText(num(value)) },
|
|
@@ -73,6 +81,20 @@ const HISTORY_COLUMNS: HeadlessPaneColumn[] = [
|
|
|
73
81
|
{ key: "move", header: "Move", align: right, format: (value) => signedPercent(num(value)) },
|
|
74
82
|
];
|
|
75
83
|
|
|
84
|
+
/** A Hong Kong listing's report: what its figures cover, their currency and its results announcement; no options or moves are read for it. */
|
|
85
|
+
const LISTING_HISTORY_COLUMNS: HeadlessPaneColumn[] = [
|
|
86
|
+
{ key: "date", header: "Date" },
|
|
87
|
+
{ key: "dateStatus", header: "Status" },
|
|
88
|
+
{ key: "timing", header: "When" },
|
|
89
|
+
{ key: "period", header: "Period" },
|
|
90
|
+
{ key: "currency", header: "Ccy" },
|
|
91
|
+
...HISTORY_COLUMNS.filter((column) => ["epsEstimate", "epsAnalysts", "epsActual", "epsBasis", "epsSurprise", "revenueEstimate", "revenueActual", "revenueSurprise"].includes(column.key)),
|
|
92
|
+
{ key: "filing", header: "Filing" },
|
|
93
|
+
];
|
|
94
|
+
|
|
95
|
+
/** What a Hong Kong listing's ERN report's period, currency and filing are, in its metadata. */
|
|
96
|
+
const LISTING_PERIOD_NOTE = "period is what the figures cover: a quarter (Q3 FY2026, or its end month), a half (H1 FY2026), a year (FY2025) or a year to date (9M FY2026), a fiscal year named by the calendar year it ends in. A half-yearly reporter's half is never a quarter. currency is the ISO currency of every amount on the row, estimates included. EPS estimates and actuals are the street's quarter figures, compared only in one currency and on one basis; a period the street has no quarter for shows the company's reported EPS and revenue from its results announcement (filing) with no estimate, its EPS diluted (basis GAAP) where the filing gives one, else basic (basis basic). The announcements' figures and links come with Gloom Pro, as KPIS has them; the street's quarters are everyone's.";
|
|
97
|
+
|
|
76
98
|
interface EarningsHeadlessDependencies {
|
|
77
99
|
calendar(query: { from: string; to: string; perDay: number; symbols: string[] }, context: HeadlessPaneContext): Promise<EarningsCalendarPayload>;
|
|
78
100
|
history(symbol: string, context: HeadlessPaneContext): Promise<EarningsHistoryPayload>;
|
|
@@ -206,20 +228,24 @@ async function boardRows(args: HeadlessPaneLoadArgs, context: HeadlessPaneContex
|
|
|
206
228
|
|
|
207
229
|
/**
|
|
208
230
|
* What ERN says for a listing abroad, whose next report is its own but whose
|
|
209
|
-
* past reports, surprises and implied moves only the US board
|
|
210
|
-
* the company's US listing to read
|
|
231
|
+
* past reports, surprises and implied moves only the US board and Hong Kong's
|
|
232
|
+
* results announcements have: that, and the company's US listing to read
|
|
233
|
+
* them on (Sanofi's SNY for SAN:EPA).
|
|
211
234
|
*/
|
|
212
235
|
async function abroadHistoryNotice(symbol: string, company: string | null, context: HeadlessPaneContext): Promise<string> {
|
|
213
|
-
const lead = `Past reports, surprises and implied moves cover US listings only, so ${symbol} shows its next report.`;
|
|
236
|
+
const lead = `Past reports, surprises and implied moves cover US and Hong Kong listings only, so ${symbol} shows its next report.`;
|
|
214
237
|
const us = await findUsListingOfCompany(context.marketData, company);
|
|
215
238
|
return us ? `${lead} ${shortCompanyName(company!)}'s US listing is ${us.symbol}: ERN ${us.symbol} has them.` : lead;
|
|
216
239
|
}
|
|
217
240
|
|
|
218
241
|
async function historyReport(symbol: string, context: HeadlessPaneContext, deps: EarningsHeadlessDependencies): Promise<HeadlessRowsResult> {
|
|
219
242
|
// The board is US listings'; SAN:EPA's past reports are not on it, and bare SAN there is another company.
|
|
220
|
-
|
|
243
|
+
// A Hong Kong listing has its own, from its results announcements.
|
|
244
|
+
const venueAbroad = listingAbroadVenue(symbol);
|
|
245
|
+
const abroad = !hasEarningsHistory(venueAbroad);
|
|
246
|
+
const ownAbroad = venueAbroad != null && !abroad;
|
|
221
247
|
const [history, upcoming] = await Promise.allSettled([
|
|
222
|
-
abroad ? Promise.resolve(null) : deps.history(symbol, context),
|
|
248
|
+
abroad ? Promise.resolve(null) : ownAbroad ? deps.history(symbol, context).catch(noHistoryAbroad) : deps.history(symbol, context),
|
|
223
249
|
deps.upcoming([symbol], context),
|
|
224
250
|
]);
|
|
225
251
|
if (history.status === "rejected" && upcoming.status === "rejected") throw history.reason;
|
|
@@ -228,18 +254,26 @@ async function historyReport(symbol: string, context: HeadlessPaneContext, deps:
|
|
|
228
254
|
const notice = abroad
|
|
229
255
|
? await abroadHistoryNotice(symbol, next?.name ?? await context.marketData.getQuote(symbol, "").then((quote) => quote.name ?? null, logFailure("earnings.headless", "Load earnings company name failed", null)), context)
|
|
230
256
|
: null;
|
|
231
|
-
const rows = historyRows(payload, newYorkToday(), next).map((row) => ({
|
|
257
|
+
const rows = historyRows(payload, newYorkToday(), next, { abroad: ownAbroad }).map((row) => ({
|
|
232
258
|
date: row.date,
|
|
233
259
|
upcoming: row.upcoming,
|
|
234
260
|
dateStatus: row.dateStatus,
|
|
235
261
|
timing: row.timing ? TIMING_LABEL[row.timing] : null,
|
|
236
262
|
timingExpected: row.expectedTiming,
|
|
237
263
|
fiscalPeriod: row.fiscalPeriod,
|
|
264
|
+
fiscalQuarter: fiscalQuarterText(row.fiscalQuarter),
|
|
265
|
+
...(ownAbroad ? {
|
|
266
|
+
period: periodText(row, false),
|
|
267
|
+
periodKind: row.periodKind,
|
|
268
|
+
periodMonths: row.periodMonths,
|
|
269
|
+
currency: row.currency,
|
|
270
|
+
filing: row.filingUrl,
|
|
271
|
+
} : {}),
|
|
238
272
|
epsEstimate: row.epsEstimate,
|
|
239
273
|
epsAnalysts: row.epsAnalysts,
|
|
240
274
|
epsActual: row.epsActual,
|
|
241
275
|
epsActualProvisional: row.provisional,
|
|
242
|
-
epsBasis: showsEpsBasis(row) ? epsBasisName(row.epsBasis)
|
|
276
|
+
epsBasis: !showsEpsBasis(row) ? null : !row.epsBasis && row.epsDilution === "basic" ? "basic" : epsBasisName(row.epsBasis),
|
|
243
277
|
epsSurprise: row.epsSurprise,
|
|
244
278
|
revenueEstimate: row.revenueEstimate,
|
|
245
279
|
revenueActual: row.revenueActual,
|
|
@@ -253,7 +287,7 @@ async function historyReport(symbol: string, context: HeadlessPaneContext, deps:
|
|
|
253
287
|
// and a history that failed for one (a coin is no US ticker) is no error.
|
|
254
288
|
const noEarnings = rows.length === 0 && !abroad ? await loadNoEarningsText(context.marketData, symbol, "cli") : null;
|
|
255
289
|
return {
|
|
256
|
-
columns: HISTORY_COLUMNS,
|
|
290
|
+
columns: ownAbroad ? LISTING_HISTORY_COLUMNS : HISTORY_COLUMNS,
|
|
257
291
|
rows,
|
|
258
292
|
...(noEarnings ? { empty: noEarnings, complete: true, unavailableSymbols: [] } : {}),
|
|
259
293
|
errors: history.status === "rejected" && !noEarnings ? [String(history.reason instanceof Error ? history.reason.message : history.reason)] : undefined,
|
|
@@ -261,6 +295,8 @@ async function historyReport(symbol: string, context: HeadlessPaneContext, deps:
|
|
|
261
295
|
symbol, name: payload?.name ?? next?.name ?? null, asOf: payload?.asOf ?? null,
|
|
262
296
|
epsBasis: EPS_BASIS_NOTE,
|
|
263
297
|
provisional: PROVISIONAL_NOTE,
|
|
298
|
+
fiscalQuarter: FISCAL_QUARTER_NOTE,
|
|
299
|
+
...(ownAbroad ? { period: LISTING_PERIOD_NOTE } : { impliedMove: IMPLIED_NOTE }),
|
|
264
300
|
...(notice ? { notices: [notice] } : {}),
|
|
265
301
|
},
|
|
266
302
|
};
|