gloomberb 0.20.11 → 0.20.13
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/package.json +2 -1
- package/src/account/billing.ts +3 -2
- package/src/account/upgrade-dialog.tsx +8 -8
- package/src/api-client/awards.ts +16 -0
- package/src/api-client/central-bank-rates.ts +5 -0
- package/src/api-client/data.ts +55 -2
- package/src/api-client/index.ts +28 -3
- package/src/api-client/install-experiments.ts +146 -0
- package/src/api-client/request.ts +86 -3
- package/src/api-client/socket-connection.ts +12 -1
- package/src/api-client/socket.ts +21 -3
- package/src/api-client/supply-chain-graph.ts +4 -2
- package/src/api-client/supply-chain.ts +8 -0
- package/src/api-client/telemetry.ts +47 -0
- package/src/api-client/types/econ.ts +10 -7
- package/src/api-client/types/filings-and-calls.ts +8 -0
- package/src/api-client/types/market.ts +4 -0
- package/src/api-client/types/news.ts +16 -0
- package/src/app/global-shortcuts.ts +2 -1
- package/src/app/keybindings/actions.ts +19 -0
- package/src/app/pane-runtime/index.tsx +18 -3
- package/src/app/pane-runtime/layout-placement.ts +63 -0
- package/src/app/pane-runtime/ticker-open-runtime.ts +10 -2
- package/src/architecture/floating-promise-allowlist.json +17 -33
- package/src/brokers/signed-in/adapter.ts +2 -2
- package/src/brokers/signed-in/catalog.ts +13 -4
- package/src/capabilities/chart-series.ts +4 -1
- package/src/cli/board-coins.ts +10 -1
- package/src/cli/commands/crypto-hints.ts +3 -2
- package/src/cli/commands/fred-series.ts +0 -54
- package/src/cli/commands/market.ts +260 -63
- package/src/cli/commands/overview.ts +50 -17
- package/src/cli/commands/search.ts +140 -17
- package/src/cli/commands/ticker.ts +37 -17
- package/src/cli/desktop-pane-shot.ts +27 -2
- package/src/cli/earnings-calendar.ts +33 -53
- package/src/cli/fx-quote-rate.ts +1 -1
- package/src/cli/glossary.ts +14 -5
- package/src/cli/history-catalog-series.ts +85 -0
- package/src/cli/history-rows.ts +18 -1
- package/src/cli/index.ts +1 -1
- package/src/cli/known-gaps.ts +9 -0
- package/src/cli/list-progress.ts +45 -0
- package/src/cli/listing-arg.ts +176 -25
- package/src/cli/name-entries.ts +8 -4
- package/src/cli/not-a-ticker.ts +2 -2
- package/src/cli/pane-functions/catalog.ts +55 -7
- package/src/cli/pane-functions/dom.ts +8 -1
- package/src/cli/pane-functions/freshness.ts +52 -5
- package/src/cli/pane-functions/headless.ts +8 -8
- package/src/cli/pane-functions/index.ts +8 -5
- package/src/cli/pane-functions/market-session.ts +66 -14
- package/src/cli/pane-functions/options.ts +5 -0
- package/src/cli/pane-functions/report.ts +4 -1
- package/src/cli/pane-functions/resolver.ts +9 -2
- package/src/cli/pane-functions/screenshot-assessment.ts +28 -3
- package/src/cli/pane-functions/screenshot-types.ts +6 -0
- package/src/cli/perpetual-contract.ts +4 -4
- package/src/cli/quote-answer.ts +55 -12
- package/src/cli/quote-list-reads.ts +87 -0
- package/src/cli/report-tables.ts +70 -13
- package/src/cli/result.ts +26 -3
- package/src/cli/symbol-list.ts +31 -4
- package/src/cli/terminal-code-hints.ts +83 -0
- package/src/cli/ticker-resolution.ts +2 -1
- package/src/cli/treasury-yields.ts +5 -0
- package/src/components/chart/composite/axis-overlays.tsx +5 -2
- package/src/components/chart/composite/composite-chart.tsx +1 -0
- package/src/components/chart/composite/format.ts +101 -15
- package/src/components/chart/composite/legend.tsx +60 -25
- package/src/components/chart/composite/time-axis.ts +51 -29
- package/src/components/chart/composite/toolbar.tsx +42 -6
- package/src/components/chart/curve/curve-surface.tsx +5 -5
- package/src/components/command-bar/action-runtime.ts +2 -0
- package/src/components/command-bar/list/badge.ts +8 -5
- package/src/components/command-bar/list/model.ts +0 -5
- package/src/components/command-bar/list/view.tsx +39 -2
- package/src/components/command-bar/routes/root/plugin-install.ts +4 -2
- package/src/components/command-bar/routes/root/provider-search.ts +23 -3
- package/src/components/command-bar/routes/root/results.ts +20 -9
- package/src/components/command-bar/routes/root/start-here.ts +1 -2
- package/src/components/command-bar/routes/ticker-search/actions.ts +2 -3
- package/src/components/command-bar/routes/ticker-search/results.ts +23 -4
- package/src/components/command-bar/routing/launch-request.ts +2 -1
- package/src/components/command-bar/routing/navigation-state.ts +4 -2
- package/src/components/command-bar/workflow/types.ts +6 -0
- package/src/components/data-table/view.tsx +29 -6
- package/src/components/form-modal/host.tsx +1 -1
- package/src/components/layout/detached-pane-shell.tsx +3 -0
- package/src/components/layout/double-escape-close.ts +34 -3
- package/src/components/layout/floating-pane.tsx +10 -4
- package/src/components/layout/header.tsx +3 -2
- package/src/components/layout/market-summary.ts +3 -3
- package/src/components/layout/pane/cycle-order.ts +66 -2
- package/src/components/layout/pane/error-boundary.tsx +2 -1
- package/src/components/layout/pane/header.tsx +140 -31
- package/src/components/layout/pane/sidebar.tsx +13 -5
- package/src/components/layout/pane/status-footer.ts +3 -1
- package/src/components/layout/shell/drag/runtime.ts +5 -0
- package/src/components/layout/shell/index.tsx +25 -0
- package/src/components/layout/shell/menu.ts +9 -0
- package/src/components/layout/shell/pane/actions.ts +36 -0
- package/src/components/layout/shell/pane/management-shortcuts.ts +27 -3
- package/src/components/layout/shell/pane-occlusion.ts +40 -0
- package/src/components/layout/shell/shortcuts.ts +17 -1
- package/src/components/layout/shell/terminal-pointer-runtime.ts +39 -6
- package/src/components/layout/shell/window-mode/index.ts +5 -16
- package/src/components/layout/shell/window-mode/overlays.tsx +3 -1
- package/src/components/markdown-text.tsx +36 -0
- package/src/components/market-board/index.tsx +18 -8
- package/src/components/metric-treemap/index.tsx +3 -1
- package/src/components/onboarding/first-run-workspace.ts +46 -11
- package/src/components/onboarding/onboarding-keyboard.ts +57 -5
- package/src/components/onboarding/onboarding-wizard.tsx +91 -24
- package/src/components/onboarding/portfolio-step/index.tsx +1 -0
- package/src/components/onboarding/portfolio-step/positions-panel.tsx +36 -9
- package/src/components/onboarding/portfolio-step/types.ts +2 -0
- package/src/components/onboarding/tickers-step-model.ts +140 -0
- package/src/components/onboarding/tickers-step.tsx +116 -0
- package/src/components/onboarding/use-onboarding-broker-form.ts +1 -1
- package/src/components/onboarding/use-onboarding-progress.ts +100 -11
- package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
- package/src/components/onboarding/wizard-model.ts +3 -1
- package/src/components/onboarding/wizard-tickers.ts +139 -0
- package/src/components/price-performance.tsx +2 -2
- package/src/components/speedometer-gauge/model.ts +2 -1
- package/src/components/speedometer-gauge/terminal.tsx +13 -8
- package/src/components/ui/button.tsx +48 -4
- package/src/components/ui/choice-dialog.tsx +101 -32
- package/src/components/ui/data-table/opentui/index.tsx +24 -9
- package/src/components/ui/data-table/types.ts +7 -0
- package/src/components/ui/inline-quick-add.tsx +19 -3
- package/src/components/ui/list-view.tsx +11 -5
- package/src/components/ui/multi-select/dialog.tsx +1 -7
- package/src/components/ui/not-meaningful.ts +16 -0
- package/src/components/ui/query-bar.tsx +32 -5
- package/src/components/ui/selection-fill.ts +39 -0
- package/src/components/ui/stat-grid.tsx +27 -6
- package/src/core/state/app/layout-reducer.ts +2 -1
- package/src/core/state/app/pane-choices.ts +68 -0
- package/src/core/state/app/state.ts +14 -6
- package/src/core/state/app/types.ts +8 -0
- package/src/data/config/store/normalize.ts +2 -0
- package/src/docs/snapshot.json +1 -1
- package/src/i18n/es.ts +5 -2
- package/src/i18n/ja.ts +5 -2
- package/src/i18n/ko.ts +5 -2
- package/src/i18n/zh-cn.ts +5 -2
- package/src/i18n/zh-tw.ts +5 -2
- package/src/layout/pane-manager/dock-tree.ts +19 -0
- package/src/layout/pane-manager/index.ts +3 -0
- package/src/layout-marketplace/model.ts +2 -1
- package/src/market-data/futures-contract.ts +2 -1
- package/src/market-data/hooks.tsx +1 -1
- package/src/market-data/market/change-basis.ts +27 -5
- package/src/market-data/market/format.ts +13 -13
- package/src/market-data/market/freshness.ts +33 -0
- package/src/market-data/market/status.ts +5 -1
- package/src/market-data/quotes/contributions.ts +10 -0
- package/src/market-data/quotes/freshness.ts +19 -0
- package/src/market-data/quotes/listing-enterprise-value.ts +3 -3
- package/src/market-data/quotes/live-valuation.ts +31 -4
- package/src/market-data/quotes/resolution.ts +4 -0
- package/src/market-data/quotes/time.ts +17 -24
- package/src/market-data/tax-equivalent.ts +3 -2
- package/src/news/aggregator.ts +19 -8
- package/src/news/hooks.ts +1 -1
- package/src/news/news-model.ts +49 -0
- package/src/news/types.ts +9 -0
- package/src/plugins/builtin/account-management/calendar-tab.tsx +8 -3
- package/src/plugins/builtin/account-management/index.tsx +1 -0
- package/src/plugins/builtin/account-management/pane.tsx +9 -8
- package/src/plugins/builtin/alerts/calendar-events.ts +4 -5
- package/src/plugins/builtin/alerts/format.ts +6 -5
- package/src/plugins/builtin/alerts/headless.ts +3 -2
- package/src/plugins/builtin/alerts/history.ts +2 -1
- package/src/plugins/builtin/alerts/pane.tsx +2 -1
- package/src/plugins/builtin/alerts/price-text.ts +2 -1
- package/src/plugins/builtin/alerts/scheduled.ts +6 -5
- package/src/plugins/builtin/analytics/account-returns.ts +6 -7
- package/src/plugins/builtin/analytics/display.ts +2 -1
- package/src/plugins/builtin/analytics/pane-model.ts +5 -9
- package/src/plugins/builtin/analytics/risk-model.ts +6 -6
- package/src/plugins/builtin/analytics/risk-pane.tsx +6 -5
- package/src/plugins/builtin/analytics/view.tsx +5 -5
- package/src/plugins/builtin/attention/model.ts +6 -5
- package/src/plugins/builtin/attention/pane.tsx +5 -4
- package/src/plugins/builtin/awards/detail.tsx +17 -8
- package/src/plugins/builtin/awards/headless.ts +37 -15
- package/src/plugins/builtin/awards/model.ts +40 -5
- package/src/plugins/builtin/awards/pane.tsx +11 -8
- package/src/plugins/builtin/backtest/format.ts +3 -2
- package/src/plugins/builtin/backtest/report.ts +3 -2
- package/src/plugins/builtin/bond-calculator/headless.ts +2 -1
- package/src/plugins/builtin/bond-calculator/pane.tsx +2 -1
- package/src/plugins/builtin/broker-manager/add-flow.tsx +1 -1
- package/src/plugins/builtin/broker-manager/index.tsx +1 -0
- package/src/plugins/builtin/broker-trading/index.tsx +1 -1
- package/src/plugins/builtin/broker-trading/orders-data.ts +3 -3
- package/src/plugins/builtin/broker-trading/orders.tsx +3 -2
- package/src/plugins/builtin/broker-trading/ticket.tsx +2 -2
- package/src/plugins/builtin/buildout/cells.tsx +2 -1
- package/src/plugins/builtin/buildout/company/pane.tsx +4 -3
- package/src/plugins/builtin/buildout/data-runtime.ts +21 -23
- package/src/plugins/builtin/buildout/detail/values.ts +2 -1
- package/src/plugins/builtin/buildout/format.ts +4 -3
- package/src/plugins/builtin/buildout/pane/index.tsx +3 -3
- package/src/plugins/builtin/catalysts/detail.tsx +2 -1
- package/src/plugins/builtin/catalysts/model.ts +6 -5
- package/src/plugins/builtin/catalysts/pane.tsx +2 -1
- package/src/plugins/builtin/cds/headless.ts +3 -2
- package/src/plugins/builtin/cds/model.ts +8 -8
- package/src/plugins/builtin/cds/pane.tsx +3 -2
- package/src/plugins/builtin/central-bank-rates/headless.ts +8 -7
- package/src/plugins/builtin/central-bank-rates/index.tsx +1 -1
- package/src/plugins/builtin/central-bank-rates/model.ts +24 -5
- package/src/plugins/builtin/central-bank-rates/pane.tsx +19 -9
- package/src/plugins/builtin/changelog/index.tsx +2 -2
- package/src/plugins/builtin/chart-composer/headless.ts +5 -1
- package/src/plugins/builtin/chart-composer/index.tsx +4 -2
- package/src/plugins/builtin/chart-composer/pane.tsx +8 -3
- package/src/plugins/builtin/chart-composer/use-series-catalog.ts +3 -1
- package/src/plugins/builtin/chart-composer/user-series.ts +3 -1
- package/src/plugins/builtin/chat/attachments/desktop.tsx +2 -1
- package/src/plugins/builtin/chat/content/handle-prompt.tsx +4 -0
- package/src/plugins/builtin/chat/controller/realtime.ts +17 -1
- package/src/plugins/builtin/chat/controller/utils.ts +2 -1
- package/src/plugins/builtin/chat/message/terminal.tsx +4 -1
- package/src/plugins/builtin/chat/sidebar.tsx +3 -4
- package/src/plugins/builtin/clinical-trials/model.ts +4 -3
- package/src/plugins/builtin/clinical-trials/sponsor-tickers.ts +4 -2
- package/src/plugins/builtin/cloud/askg/lock-note.ts +16 -4
- package/src/plugins/builtin/cloud/askg/model.ts +2 -1
- package/src/plugins/builtin/cloud/askg/pane.tsx +39 -1
- package/src/plugins/builtin/cloud/company-picker.tsx +1 -3
- package/src/plugins/builtin/cloud/plugin.tsx +1 -0
- package/src/plugins/builtin/cloud/team/module.tsx +1 -0
- package/src/plugins/builtin/cloud/team/pane.tsx +12 -12
- package/src/plugins/builtin/cloud/thesis/detail.tsx +22 -12
- package/src/plugins/builtin/cloud-tweets/model.ts +2 -2
- package/src/plugins/builtin/comment-letters/pane.tsx +2 -1
- package/src/plugins/builtin/commodity-balances/headless.ts +3 -2
- package/src/plugins/builtin/commodity-balances/pane.tsx +13 -5
- package/src/plugins/builtin/company-attention/app-rank.tsx +5 -4
- package/src/plugins/builtin/company-attention/building-model.ts +7 -7
- package/src/plugins/builtin/company-attention/headless.ts +6 -5
- package/src/plugins/builtin/company-attention/model.ts +4 -4
- package/src/plugins/builtin/company-attention/moves-model.ts +9 -9
- package/src/plugins/builtin/company-attention/signals-model.ts +9 -9
- package/src/plugins/builtin/company-kpis/headless.ts +2 -1
- package/src/plugins/builtin/company-kpis/model.ts +18 -13
- package/src/plugins/builtin/company-kpis/pane.tsx +2 -2
- package/src/plugins/builtin/congress-trades/detail.tsx +6 -5
- package/src/plugins/builtin/congress-trades/headless.ts +2 -1
- package/src/plugins/builtin/congress-trades/model.ts +6 -6
- package/src/plugins/builtin/congress-trades/table.tsx +7 -6
- package/src/plugins/builtin/connections/index.ts +1 -0
- package/src/plugins/builtin/connections/pane.tsx +5 -5
- package/src/plugins/builtin/correlation/headless.ts +2 -2
- package/src/plugins/builtin/correlation/index.tsx +4 -1
- package/src/plugins/builtin/correlation/matrix/selection.ts +2 -1
- package/src/plugins/builtin/correlation/relationship/view-model.ts +3 -3
- package/src/plugins/builtin/cot/headless.ts +3 -2
- package/src/plugins/builtin/cot/model.ts +2 -1
- package/src/plugins/builtin/cot/pane.tsx +4 -3
- package/src/plugins/builtin/cpi/headless.ts +4 -3
- package/src/plugins/builtin/cpi/model.ts +8 -7
- package/src/plugins/builtin/credit-boards/cdx-pane.tsx +14 -9
- package/src/plugins/builtin/credit-boards/client.ts +5 -0
- package/src/plugins/builtin/credit-boards/headless.ts +3 -7
- package/src/plugins/builtin/credit-boards/model.ts +5 -11
- package/src/plugins/builtin/credit-boards/series.ts +19 -8
- package/src/plugins/builtin/credit-boards/sovr-pane.tsx +9 -5
- package/src/plugins/builtin/credit-conditions/headless.ts +2 -1
- package/src/plugins/builtin/credit-conditions/index.tsx +2 -2
- package/src/plugins/builtin/credit-documents/model.ts +2 -2
- package/src/plugins/builtin/crypto-board/defi-view.tsx +7 -7
- package/src/plugins/builtin/crypto-board/defi.ts +2 -2
- package/src/plugins/builtin/crypto-board/model.ts +4 -3
- package/src/plugins/builtin/crypto-board/pane.tsx +8 -8
- package/src/plugins/builtin/crypto-board/supply.ts +2 -2
- package/src/plugins/builtin/crypto-etf-flows/headless.ts +23 -13
- package/src/plugins/builtin/crypto-etf-flows/model.ts +4 -4
- package/src/plugins/builtin/crypto-etf-flows/pane.tsx +8 -3
- package/src/plugins/builtin/custom-view/index.tsx +3 -1
- package/src/plugins/builtin/custom-view/pane.tsx +5 -1
- package/src/plugins/builtin/custom-view/view-spec.ts +11 -0
- package/src/plugins/builtin/debt-maturities/headless.ts +16 -7
- package/src/plugins/builtin/debt-maturities/model.ts +12 -18
- package/src/plugins/builtin/debt-maturities/pane.tsx +11 -12
- package/src/plugins/builtin/dividend-yield/client.ts +7 -3
- package/src/plugins/builtin/dividend-yield/headless.ts +16 -11
- package/src/plugins/builtin/dividend-yield/pane.tsx +12 -10
- package/src/plugins/builtin/dividend-yield/ranking-view.tsx +4 -1
- package/src/plugins/builtin/dividend-yield/ranking.ts +19 -11
- package/src/plugins/builtin/dividend-yield/types.ts +4 -0
- package/src/plugins/builtin/dividend-yield/view.ts +3 -3
- package/src/plugins/builtin/docs/use-docs.ts +4 -2
- package/src/plugins/builtin/doe/headless.ts +2 -1
- package/src/plugins/builtin/doe/model.ts +12 -11
- package/src/plugins/builtin/earnings/board-model.ts +42 -7
- package/src/plugins/builtin/earnings/board-table.ts +13 -8
- package/src/plugins/builtin/earnings/board.tsx +15 -3
- package/src/plugins/builtin/earnings/calendar-model.ts +5 -5
- package/src/plugins/builtin/earnings/calendar.tsx +11 -6
- package/src/plugins/builtin/earnings/client.ts +0 -9
- package/src/plugins/builtin/earnings/format.ts +16 -14
- package/src/plugins/builtin/earnings/headless.ts +64 -23
- package/src/plugins/builtin/earnings/history-model.ts +11 -7
- package/src/plugins/builtin/earnings/history-table.ts +14 -9
- package/src/plugins/builtin/earnings/history.tsx +22 -14
- package/src/plugins/builtin/earnings-calls/calendar.tsx +2 -1
- package/src/plugins/builtin/earnings-calls/data.ts +24 -4
- package/src/plugins/builtin/earnings-calls/format.ts +29 -10
- package/src/plugins/builtin/earnings-calls/headless.ts +23 -3
- package/src/plugins/builtin/earnings-calls/index.tsx +1 -0
- package/src/plugins/builtin/earnings-calls/model.ts +11 -1
- package/src/plugins/builtin/earnings-calls/pane.tsx +2 -5
- package/src/plugins/builtin/earnings-calls/upcoming.ts +5 -5
- package/src/plugins/builtin/earnings-ripple/headless.ts +2 -1
- package/src/plugins/builtin/earnings-ripple/model.ts +3 -2
- package/src/plugins/builtin/earnings-ripple/pane.tsx +6 -6
- package/src/plugins/builtin/econ/calendar-model.ts +29 -2
- package/src/plugins/builtin/econ/detail-view.tsx +2 -2
- package/src/plugins/builtin/econ/fred-catalog.ts +3 -0
- package/src/plugins/builtin/econ/index.tsx +16 -8
- package/src/plugins/builtin/econ-statistics/detail.tsx +2 -1
- package/src/plugins/builtin/econ-statistics/headless.ts +7 -5
- package/src/plugins/builtin/econ-statistics/index.tsx +1 -1
- package/src/plugins/builtin/econ-statistics/pane.tsx +2 -2
- package/src/plugins/builtin/equity-screener/headless.ts +5 -5
- package/src/plugins/builtin/equity-screener/model.ts +6 -4
- package/src/plugins/builtin/equity-screener/pane.tsx +7 -7
- package/src/plugins/builtin/equity-screener/screen-check.ts +2 -1
- package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
- package/src/plugins/builtin/estimate-revisions/model.ts +3 -2
- package/src/plugins/builtin/estimate-revisions/pane.tsx +8 -8
- package/src/plugins/builtin/executives/format.ts +4 -4
- package/src/plugins/builtin/exposure/headless.ts +8 -8
- package/src/plugins/builtin/exposure/model.ts +4 -3
- package/src/plugins/builtin/exposure/pane.tsx +6 -5
- package/src/plugins/builtin/fear-greed/format.ts +7 -7
- package/src/plugins/builtin/fear-greed/headless.ts +18 -14
- package/src/plugins/builtin/fear-greed/pane.tsx +12 -4
- package/src/plugins/builtin/filing-events/feed.ts +2 -1
- package/src/plugins/builtin/filing-events/index.tsx +1 -0
- package/src/plugins/builtin/futures/table.tsx +8 -8
- package/src/plugins/builtin/futures-curve/headless.ts +18 -18
- package/src/plugins/builtin/futures-curve/model.ts +5 -5
- package/src/plugins/builtin/futures-curve/pane.tsx +8 -8
- package/src/plugins/builtin/fx-matrix/index.tsx +32 -21
- package/src/plugins/builtin/fx-matrix/pairs.ts +2 -1
- package/src/plugins/builtin/gpu/board.tsx +6 -5
- package/src/plugins/builtin/gpu/changes.tsx +2 -1
- package/src/plugins/builtin/gpu/equities.tsx +2 -2
- package/src/plugins/builtin/gpu/headless.ts +4 -3
- package/src/plugins/builtin/gpu/model.ts +8 -7
- package/src/plugins/builtin/help/functions-table.tsx +41 -9
- package/src/plugins/builtin/help/index.tsx +6 -3
- package/src/plugins/builtin/help/keybindings-editor.tsx +35 -7
- package/src/plugins/builtin/help/shortcut-table.tsx +19 -7
- package/src/plugins/builtin/help/table-cells.tsx +51 -0
- package/src/plugins/builtin/holders/pane.tsx +4 -1
- package/src/plugins/builtin/insider/base-values.ts +2 -2
- package/src/plugins/builtin/insider/display.ts +2 -1
- package/src/plugins/builtin/insider/headless.ts +16 -16
- package/src/plugins/builtin/insider/insider-data.ts +2 -1
- package/src/plugins/builtin/insider/signals-model.ts +3 -3
- package/src/plugins/builtin/insider/table-model.ts +27 -13
- package/src/plugins/builtin/insider/table.tsx +11 -8
- package/src/plugins/builtin/insider/tickers.tsx +1 -1
- package/src/plugins/builtin/ipo-calendar/model.ts +4 -4
- package/src/plugins/builtin/iv-history/format.ts +8 -7
- package/src/plugins/builtin/iv-history/headless.ts +18 -16
- package/src/plugins/builtin/iv-history/pane.tsx +3 -2
- package/src/plugins/builtin/iv-history/screen-pane.tsx +5 -4
- package/src/plugins/builtin/jobs/headless.ts +11 -11
- package/src/plugins/builtin/jobs/index.tsx +1 -0
- package/src/plugins/builtin/jobs/model.ts +2 -2
- package/src/plugins/builtin/jobs/pane.tsx +5 -5
- package/src/plugins/builtin/jodi/model.ts +2 -2
- package/src/plugins/builtin/jodi/pane.tsx +2 -1
- package/src/plugins/builtin/kelly-sizer/headless.ts +4 -4
- package/src/plugins/builtin/kelly-sizer/model.ts +2 -1
- package/src/plugins/builtin/kelly-sizer/sections.tsx +2 -2
- package/src/plugins/builtin/macro-day/headless.ts +9 -8
- package/src/plugins/builtin/macro-day/model.ts +3 -2
- package/src/plugins/builtin/macro-day/pane.tsx +4 -4
- package/src/plugins/builtin/macro-day/releases.ts +25 -16
- package/src/plugins/builtin/market-halts/model.ts +11 -10
- package/src/plugins/builtin/market-halts/pane.tsx +2 -1
- package/src/plugins/builtin/market-heatmap/index.tsx +4 -4
- package/src/plugins/builtin/market-movers/index.tsx +20 -8
- package/src/plugins/builtin/market-movers/model.ts +5 -0
- package/src/plugins/builtin/market-movers/session-body.tsx +2 -1
- package/src/plugins/builtin/market-movers/session-table.ts +3 -3
- package/src/plugins/builtin/market-movers/session.ts +2 -1
- package/src/plugins/builtin/market-movers/table.ts +5 -5
- package/src/plugins/builtin/market-valuation/detail.tsx +2 -2
- package/src/plugins/builtin/market-valuation/headless.ts +7 -7
- package/src/plugins/builtin/market-valuation/pane.tsx +7 -7
- package/src/plugins/builtin/members/breadth-pane.tsx +5 -4
- package/src/plugins/builtin/members/headless.ts +2 -1
- package/src/plugins/builtin/members/model.ts +3 -2
- package/src/plugins/builtin/members/pane.tsx +10 -9
- package/src/plugins/builtin/mna/distress/model.ts +2 -1
- package/src/plugins/builtin/mna/model.ts +5 -5
- package/src/plugins/builtin/money-markets/headless.ts +14 -3
- package/src/plugins/builtin/money-markets/model.ts +3 -2
- package/src/plugins/builtin/money-markets/pane.tsx +14 -5
- package/src/plugins/builtin/news/headless.ts +5 -2
- package/src/plugins/builtin/news/wire/breaking/notifications.ts +21 -19
- package/src/plugins/builtin/news/wire/news/row.ts +3 -1
- package/src/plugins/builtin/news/wire/news/table.tsx +3 -2
- package/src/plugins/builtin/news/wire/persisted-articles.ts +28 -3
- package/src/plugins/builtin/notes/headless.ts +2 -1
- package/src/plugins/builtin/notes/model.ts +2 -1
- package/src/plugins/builtin/openfda/pane.tsx +4 -3
- package/src/plugins/builtin/options/carry.ts +3 -2
- package/src/plugins/builtin/options/market-reference.ts +2 -1
- package/src/plugins/builtin/options/table.ts +48 -9
- package/src/plugins/builtin/options/view.tsx +48 -17
- package/src/plugins/builtin/options-calculator/headless.ts +3 -2
- package/src/plugins/builtin/options-calculator/pane.tsx +7 -7
- package/src/plugins/builtin/options-positioning/headless.ts +8 -7
- package/src/plugins/builtin/options-positioning/model.ts +10 -10
- package/src/plugins/builtin/options-positioning/pane.tsx +6 -6
- package/src/plugins/builtin/options-scenario/collar.ts +5 -4
- package/src/plugins/builtin/options-scenario/csp-screen-headless.ts +11 -10
- package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +15 -14
- package/src/plugins/builtin/options-scenario/csp-screen.ts +2 -1
- package/src/plugins/builtin/options-scenario/csp.ts +6 -5
- package/src/plugins/builtin/options-scenario/headless.ts +6 -5
- package/src/plugins/builtin/options-scenario/hedge.ts +3 -3
- package/src/plugins/builtin/options-scenario/pane.tsx +7 -6
- package/src/plugins/builtin/options-scenario/strategy-screen.ts +1 -1
- package/src/plugins/builtin/pe-band/headless.ts +9 -8
- package/src/plugins/builtin/pe-band/pane.tsx +7 -7
- package/src/plugins/builtin/perps/cascade.ts +3 -2
- package/src/plugins/builtin/perps/headless.ts +10 -9
- package/src/plugins/builtin/perps/model.ts +14 -14
- package/src/plugins/builtin/perps/pane.tsx +3 -2
- package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +4 -31
- package/src/plugins/builtin/portfolio-list/header.tsx +2 -2
- package/src/plugins/builtin/portfolio-list/index.tsx +3 -2
- package/src/plugins/builtin/portfolio-list/pane/futures-terms.ts +4 -2
- package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -1
- package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +2 -1
- package/src/plugins/builtin/portfolio-list/pane/purchase-date-fx.ts +4 -2
- package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +24 -10
- package/src/plugins/builtin/portfolio-list/settings.ts +4 -1
- package/src/plugins/builtin/portfolio-list/summary/index.tsx +9 -11
- package/src/plugins/builtin/portfolio-list/table.tsx +10 -1
- package/src/plugins/builtin/power/detail.tsx +6 -5
- package/src/plugins/builtin/power/gas-model.ts +8 -7
- package/src/plugins/builtin/power/gas.tsx +2 -1
- package/src/plugins/builtin/power/headless.ts +7 -6
- package/src/plugins/builtin/power/model.ts +3 -2
- package/src/plugins/builtin/power/prices-headless.ts +10 -9
- package/src/plugins/builtin/power/prices-model.ts +3 -2
- package/src/plugins/builtin/power/prices.tsx +2 -1
- package/src/plugins/builtin/primary-dealers/model.ts +3 -3
- package/src/plugins/builtin/primary-dealers/pane.tsx +2 -2
- package/src/plugins/builtin/rate-path/headless.ts +8 -7
- package/src/plugins/builtin/rate-path/model.ts +6 -5
- package/src/plugins/builtin/rate-path/pane.tsx +6 -5
- package/src/plugins/builtin/realized-vol/fx-proxy.ts +2 -1
- package/src/plugins/builtin/realized-vol/headless.ts +37 -10
- package/src/plugins/builtin/realized-vol/pane.tsx +5 -4
- package/src/plugins/builtin/relative-rotation/headless.ts +2 -1
- package/src/plugins/builtin/relative-rotation/pane.tsx +6 -6
- package/src/plugins/builtin/research/analyst-headless.ts +5 -5
- package/src/plugins/builtin/research/analyst-model.ts +7 -7
- package/src/plugins/builtin/research/analyst-pane.tsx +7 -7
- package/src/plugins/builtin/research/client.ts +14 -0
- package/src/plugins/builtin/research/corporate-actions-pane.tsx +40 -30
- package/src/plugins/builtin/research/event-model.ts +55 -22
- package/src/plugins/builtin/research/event-sources.ts +26 -8
- package/src/plugins/builtin/research/relative-valuation-columns.ts +20 -12
- package/src/plugins/builtin/research/relative-valuation-currency.ts +16 -0
- package/src/plugins/builtin/research/relative-valuation-headless.ts +33 -21
- package/src/plugins/builtin/research/relative-valuation-model.ts +31 -17
- package/src/plugins/builtin/research/relative-valuation-pane.tsx +29 -14
- package/src/plugins/builtin/research-search/model.ts +2 -1
- package/src/plugins/builtin/research-search/saved-view.tsx +4 -3
- package/src/plugins/builtin/revenue-breakdown/model.ts +4 -4
- package/src/plugins/builtin/reverse-dcf/headless.ts +7 -7
- package/src/plugins/builtin/reverse-dcf/model.ts +4 -4
- package/src/plugins/builtin/reverse-dcf/pane.tsx +2 -2
- package/src/plugins/builtin/risk-factors/index.tsx +1 -0
- package/src/plugins/builtin/scanner/flow-model.ts +7 -4
- package/src/plugins/builtin/scanner/flow-pane.tsx +1 -1
- package/src/plugins/builtin/scanner/headless.ts +3 -2
- package/src/plugins/builtin/scanner/hilo-model.ts +2 -1
- package/src/plugins/builtin/scanner/live-headless.ts +2 -2
- package/src/plugins/builtin/scanner/live-model.ts +3 -2
- package/src/plugins/builtin/scanner/live-pane.tsx +5 -5
- package/src/plugins/builtin/seasonality/headless.ts +2 -1
- package/src/plugins/builtin/seasonality/pane.tsx +4 -3
- package/src/plugins/builtin/sec/filing-display.tsx +12 -15
- package/src/plugins/builtin/sec/fund-facts.ts +2 -2
- package/src/plugins/builtin/sec/headless.ts +2 -1
- package/src/plugins/builtin/sec/index.tsx +6 -2
- package/src/plugins/builtin/sectors/headless.ts +4 -4
- package/src/plugins/builtin/sectors/index.tsx +7 -7
- package/src/plugins/builtin/shared/earnings-calendar.ts +90 -6
- package/src/plugins/builtin/shared/earnings-report.ts +13 -6
- package/src/plugins/builtin/shared/research-cells.tsx +2 -2
- package/src/plugins/builtin/shared/source-footer.ts +71 -0
- package/src/plugins/builtin/shared/trend.ts +2 -2
- package/src/plugins/builtin/shared/use-quote-board.ts +9 -8
- package/src/plugins/builtin/short-interest/headless.ts +6 -6
- package/src/plugins/builtin/short-interest/model.ts +9 -9
- package/src/plugins/builtin/short-interest/publications-model.ts +5 -5
- package/src/plugins/builtin/short-interest/publications-pane.tsx +8 -3
- package/src/plugins/builtin/short-interest/watch-headless.ts +5 -5
- package/src/plugins/builtin/short-interest/watch-pane.tsx +6 -6
- package/src/plugins/builtin/short-volume/model.ts +5 -5
- package/src/plugins/builtin/short-volume/pane.tsx +9 -5
- package/src/plugins/builtin/social-mentions/headless.ts +2 -1
- package/src/plugins/builtin/social-mentions/model.ts +4 -4
- package/src/plugins/builtin/social-mentions/outliers.tsx +10 -1
- package/src/plugins/builtin/social-mentions/pane.tsx +7 -0
- package/src/plugins/builtin/supply-chain/client.ts +3 -1
- package/src/plugins/builtin/supply-chain/flow.tsx +25 -8
- package/src/plugins/builtin/supply-chain/graph-client.ts +1 -1
- package/src/plugins/builtin/supply-chain/graph-evidence.ts +1 -1
- package/src/plugins/builtin/supply-chain/graph-model.ts +14 -2
- package/src/plugins/builtin/supply-chain/graph-pane.tsx +11 -10
- package/src/plugins/builtin/supply-chain/graph.tsx +12 -6
- package/src/plugins/builtin/supply-chain/headless.ts +15 -8
- package/src/plugins/builtin/supply-chain/model.ts +72 -15
- package/src/plugins/builtin/supply-chain/pane.tsx +11 -8
- package/src/plugins/builtin/supply-chain/row-evidence.tsx +7 -6
- package/src/plugins/builtin/themes/headless.ts +2 -1
- package/src/plugins/builtin/themes/model.ts +3 -2
- package/src/plugins/builtin/themes/pane.tsx +3 -2
- package/src/plugins/builtin/thirteenf/format.ts +9 -9
- package/src/plugins/builtin/thirteenf/headless.ts +3 -2
- package/src/plugins/builtin/thirteenf/model.ts +2 -1
- package/src/plugins/builtin/thirteenf/overlap-pane.tsx +2 -1
- package/src/plugins/builtin/thirteenf/pane.tsx +5 -4
- package/src/plugins/builtin/thirteenf/report-notes.ts +2 -1
- package/src/plugins/builtin/thirteenf/signals-pane.tsx +3 -2
- package/src/plugins/builtin/thirteenf/table.ts +6 -5
- package/src/plugins/builtin/ticker-detail/adr-pair/model.ts +4 -3
- package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +4 -4
- package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +3 -3
- package/src/plugins/builtin/ticker-detail/financials/model.ts +83 -35
- package/src/plugins/builtin/ticker-detail/financials/ratio-table.tsx +3 -1
- package/src/plugins/builtin/ticker-detail/financials/ratios.ts +2 -2
- package/src/plugins/builtin/ticker-detail/financials/schema.ts +14 -18
- package/src/plugins/builtin/ticker-detail/financials/tab.tsx +8 -13
- package/src/plugins/builtin/ticker-detail/headless.ts +7 -5
- package/src/plugins/builtin/ticker-detail/overview/chart-scale.ts +52 -0
- package/src/plugins/builtin/ticker-detail/overview/components.tsx +18 -5
- package/src/plugins/builtin/ticker-detail/overview/model.ts +24 -13
- package/src/plugins/builtin/ticker-detail/overview/pane.tsx +6 -0
- package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +2 -1
- package/src/plugins/builtin/ticker-detail/overview-tab.tsx +35 -7
- package/src/plugins/builtin/ticker-detail/pane.tsx +48 -24
- package/src/plugins/builtin/ticker-detail/quote-footer.ts +5 -0
- package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +13 -8
- package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +4 -4
- package/src/plugins/builtin/ticker-detail/settings.ts +17 -0
- package/src/plugins/builtin/time-sales/headless.ts +3 -2
- package/src/plugins/builtin/time-sales/model.ts +7 -5
- package/src/plugins/builtin/time-sales/pane.tsx +7 -6
- package/src/plugins/builtin/trace-bonds/model.ts +3 -2
- package/src/plugins/builtin/trace-bonds/pane.tsx +3 -2
- package/src/plugins/builtin/treasury-auctions/after.ts +50 -23
- package/src/plugins/builtin/treasury-auctions/cache.ts +23 -5
- package/src/plugins/builtin/treasury-auctions/client.ts +2 -1
- package/src/plugins/builtin/treasury-auctions/headless.ts +231 -42
- package/src/plugins/builtin/treasury-auctions/hk-headless.ts +14 -7
- package/src/plugins/builtin/treasury-auctions/hk-view.tsx +37 -34
- package/src/plugins/builtin/treasury-auctions/hk.ts +65 -13
- package/src/plugins/builtin/treasury-auctions/index.tsx +3 -0
- package/src/plugins/builtin/treasury-auctions/keys.ts +27 -0
- package/src/plugins/builtin/treasury-auctions/like.ts +137 -0
- package/src/plugins/builtin/treasury-auctions/model.ts +101 -23
- package/src/plugins/builtin/treasury-auctions/pane.tsx +56 -28
- package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +2 -1
- package/src/plugins/builtin/treasury-daily/model.ts +2 -2
- package/src/plugins/builtin/vol-surface/events.ts +5 -4
- package/src/plugins/builtin/vol-surface/headless.ts +19 -18
- package/src/plugins/builtin/vol-surface/heat-grid.tsx +6 -3
- package/src/plugins/builtin/vol-surface/pane.tsx +13 -9
- package/src/plugins/builtin/vol-surface/stored.ts +2 -1
- package/src/plugins/builtin/vol-surface/tables.ts +4 -3
- package/src/plugins/builtin/volatility/headless.ts +5 -4
- package/src/plugins/builtin/volatility/pane.tsx +6 -6
- package/src/plugins/builtin/world-indices/headless.ts +7 -7
- package/src/plugins/builtin/world-indices/index.tsx +3 -1
- package/src/plugins/builtin/world-venue-map/headless.ts +2 -1
- package/src/plugins/builtin/world-venue-map/layered-pane.tsx +2 -1
- package/src/plugins/builtin/world-venue-map/layers.ts +3 -2
- package/src/plugins/builtin/world-venue-map/use-geo.ts +4 -2
- package/src/plugins/builtin/yield-curve/curves.ts +3 -3
- package/src/plugins/builtin/yield-curve/headless.ts +7 -6
- package/src/plugins/builtin/yield-curve/index.tsx +5 -4
- package/src/plugins/builtin/yield-curve/swaps.tsx +2 -1
- package/src/plugins/runtime/index.tsx +1 -0
- package/src/plugins/runtime/state.ts +20 -0
- package/src/portfolio/allocation.ts +5 -5
- package/src/portfolio/column-values.ts +54 -42
- package/src/portfolio/futures-positions.ts +2 -1
- package/src/public/__snapshots__/public-api.test.ts.snap +5 -0
- package/src/public/react.ts +7 -0
- package/src/react/auto-refresh.ts +29 -0
- package/src/renderers/browser/deeplink-bridge.ts +24 -3
- package/src/renderers/dom/desktop/query-bar.tsx +229 -60
- package/src/renderers/dom/host/overflow-fade-px.ts +2 -0
- package/src/renderers/dom/host/overflow-fade.ts +1 -2
- package/src/renderers/dom/styles.css +25 -5
- package/src/renderers/electrobun/bun/desktop/backend-requests.ts +7 -1
- package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +2 -1
- package/src/renderers/opentui/ui-host.tsx +32 -2
- package/src/renderers/share/layout-view.tsx +2 -1
- package/src/series/types.ts +2 -0
- package/src/sources/gloomberb-cloud/fred-attribution.ts +86 -0
- package/src/sources/gloomberb-cloud/index.ts +25 -1
- package/src/sources/gloomberb-cloud/news.ts +9 -0
- package/src/sources/gloomberb-cloud/normalizers.ts +24 -3
- package/src/sources/provider-errors.ts +64 -1
- package/src/sources/provider-router/batches.ts +19 -0
- package/src/sources/provider-router/index.ts +7 -1
- package/src/sources/provider-router/search.ts +15 -10
- package/src/state/app/context/index.tsx +24 -1
- package/src/state/hooks/inline-tickers.ts +3 -2
- package/src/state/hooks/quote-streaming.ts +9 -10
- package/src/state/pane-unsent-work.ts +47 -0
- package/src/team/collections-sync.ts +8 -3
- package/src/telemetry/usage-counts.ts +26 -0
- package/src/test-support/shell-pane-keys.tsx +5 -0
- package/src/test-support/telemetry-guard.ts +83 -0
- package/src/test-support/test-env.ts +12 -0
- package/src/theme/colors.ts +17 -1
- package/src/theme/ui-tokens.ts +50 -1
- package/src/tickers/company-name-listing.ts +2 -2
- package/src/tickers/company-name.ts +17 -1
- package/src/tickers/listing-venues.ts +37 -2
- package/src/tickers/renamed-listings.ts +2 -1
- package/src/tickers/search/index.ts +19 -0
- package/src/tickers/search/japanese-names.json +1 -0
- package/src/tickers/search/japanese-names.ts +152 -0
- package/src/tickers/starter-symbols.ts +7 -0
- package/src/tickers/terminal-codes.ts +55 -6
- package/src/time-series/base-series.ts +3 -0
- package/src/time-series/fundamentals/statement-fields.ts +11 -14
- package/src/time-series/history-acquisition.ts +1 -1
- package/src/time-series/log-scale.ts +9 -0
- package/src/time-series/reporting.ts +3 -3
- package/src/time-series/resolve.ts +6 -4
- package/src/time-series/transforms.ts +10 -5
- package/src/types/config.ts +9 -0
- package/src/types/data-provider.ts +9 -2
- package/src/types/financials.ts +26 -0
- package/src/types/instrument.ts +6 -0
- package/src/types/plugin-contributions.ts +7 -0
- package/src/types/plugin-panes.ts +8 -1
- package/src/types/plugin-reports.ts +8 -0
- package/src/ui/host.tsx +6 -0
- package/src/utils/datetime-format.ts +74 -33
- package/src/utils/double-escape-close.ts +42 -0
- package/src/utils/financial-statements.ts +39 -15
- package/src/utils/format.ts +4 -9
- package/src/utils/fundamentals.ts +38 -16
- package/src/utils/fx-status.ts +30 -7
- package/src/utils/growth.ts +67 -0
- package/src/utils/keyboard.ts +6 -0
- package/src/utils/network-failure.ts +23 -0
- package/src/utils/options.ts +1 -1
- package/src/utils/report-timing.ts +2 -2
- package/src/utils/served-rates.ts +45 -0
- package/src/utils/text-wrap.ts +84 -3
- package/src/utils/zoned-date-time.ts +47 -22
|
@@ -10,7 +10,8 @@ import type { DividendPayment, GrowthPayments } from "./types";
|
|
|
10
10
|
import {
|
|
11
11
|
convertedFromText, formatConvertedAmount, formatDividendYield, growthPaymentsText, PAYOUT_NOT_MEANINGFUL, staleHistoryText, toDividendRows, trailingPaymentsText,
|
|
12
12
|
} from "./view";
|
|
13
|
-
import { formatDistributionAmount, formatPercent } from "../../../utils/format";
|
|
13
|
+
import { MISSING_VALUE, formatDistributionAmount, formatPercent } from "../../../utils/format";
|
|
14
|
+
import { NOT_MEANINGFUL_TEXT } from "../../../utils/growth";
|
|
14
15
|
import { forwardDividendBasis, historyEndsText, noCurrentDividend, TRAILING_DIVIDEND_BASIS, UNEVEN_REGULAR_PAYMENTS } from "../../../utils/forward-dividend";
|
|
15
16
|
import { currencyPriceMinDigits, formatMarketPriceWithCurrency } from "../../../market-data/market/format";
|
|
16
17
|
import type { Quote } from "../../../types/financials";
|
|
@@ -39,7 +40,7 @@ function paymentColumns(converted: boolean, subUnit?: string) {
|
|
|
39
40
|
{ key: "exDate", header: "Ex-date" },
|
|
40
41
|
{ key: "amount", header: "Amount", align: "right" as const,
|
|
41
42
|
format: (value: unknown, row: Record<string, unknown>) => typeof value === "number" && typeof row.currency === "string" && row.currency
|
|
42
|
-
? amount(value, row.currency) : value == null ?
|
|
43
|
+
? amount(value, row.currency) : value == null ? MISSING_VALUE : String(value) },
|
|
43
44
|
{ key: "currency", header: "CCY" },
|
|
44
45
|
{ key: "type", header: "Type" },
|
|
45
46
|
];
|
|
@@ -52,7 +53,7 @@ const SOURCE_COLUMN = { key: "source", header: "Source",
|
|
|
52
53
|
/** After the amount, for a company declaring in another currency than the listing pays: what it declared. */
|
|
53
54
|
const DECLARED_COLUMN = { key: "declared", header: "Declared", align: "right" as const,
|
|
54
55
|
format: (value: unknown, row: Record<string, unknown>) => typeof value === "number" && typeof row.declaredCurrency === "string"
|
|
55
|
-
? formatDistributionAmount(value, row.declaredCurrency) :
|
|
56
|
+
? formatDistributionAmount(value, row.declaredCurrency) : MISSING_VALUE };
|
|
56
57
|
|
|
57
58
|
/** What a ticker's read needs: the market data, Gloom Cloud, and the listing a typed key stands for. */
|
|
58
59
|
export type DividendReadContext = Pick<HeadlessPaneContext, "marketData" | "apiClient" | "resolveInstrument">;
|
|
@@ -145,8 +146,9 @@ export function dividendRankingReads(
|
|
|
145
146
|
};
|
|
146
147
|
}
|
|
147
148
|
|
|
148
|
-
/** A growth figure, or what its short year holds: "n/a: 1 of 2 payments". */
|
|
149
|
-
function growthText(growth: number | null, payments: GrowthPayments | null | undefined): string {
|
|
149
|
+
/** A growth figure, N/M off a year that paid nothing, or what its short year holds: "n/a: 1 of 2 payments". */
|
|
150
|
+
function growthText(growth: number | null, payments: GrowthPayments | null | undefined, notMeaningful?: boolean): string {
|
|
151
|
+
if (growth == null && notMeaningful) return NOT_MEANINGFUL_TEXT;
|
|
150
152
|
return growth == null && payments ? growthPaymentsText(payments) : formatPercent(growth ?? undefined);
|
|
151
153
|
}
|
|
152
154
|
|
|
@@ -219,8 +221,8 @@ export function projectDividendYieldHeadless(
|
|
|
219
221
|
const forwardLabel = bond ? `Forward distribution yield (${NOT_SEC_YIELD})` : "Forward yield";
|
|
220
222
|
const forwardText = metrics.lapse ? noCurrentDividend(metrics.lapse) : null;
|
|
221
223
|
const lastEx = isoDay(metrics.lastExDividendDate);
|
|
222
|
-
const growthEntry = (label: string, value: number | null, payments: GrowthPayments | null | undefined) =>
|
|
223
|
-
({ label, value: roundedRatio(value), formatted: growthText(value, payments) });
|
|
224
|
+
const growthEntry = (label: string, value: number | null, payments: GrowthPayments | null | undefined, notMeaningful?: boolean) =>
|
|
225
|
+
({ label, value: roundedRatio(value), formatted: growthText(value, payments, notMeaningful) });
|
|
224
226
|
const datesAndCash = [
|
|
225
227
|
dateEntry("Last ex-dividend", metrics.lastExDividendDate),
|
|
226
228
|
dateEntry("Next ex-dividend", metrics.nextExDividendDate),
|
|
@@ -258,8 +260,8 @@ export function projectDividendYieldHeadless(
|
|
|
258
260
|
{ label: "Trailing rate", value: metrics.trailingRate, formatted: cashRate(metrics.trailingRate) },
|
|
259
261
|
{ label: "Forward rate", value: metrics.forwardRate, formatted: cashRate(metrics.forwardRate) },
|
|
260
262
|
{ label: "Earnings Payout", value: roundedRatio(metrics.payoutRatio), formatted: metrics.payoutNotMeaningful ? PAYOUT_NOT_MEANINGFUL : formatDividendYield(metrics.payoutRatio) },
|
|
261
|
-
growthEntry("1Y Cash Growth", metrics.growth1Y, metrics.growth1YPayments),
|
|
262
|
-
growthEntry("3Y Cash CAGR", metrics.growth3Y, metrics.growth3YPayments),
|
|
263
|
+
growthEntry("1Y Cash Growth", metrics.growth1Y, metrics.growth1YPayments, metrics.growth1YNotMeaningful),
|
|
264
|
+
growthEntry("3Y Cash CAGR", metrics.growth3Y, metrics.growth3YPayments, metrics.growth3YNotMeaningful),
|
|
263
265
|
{ label: "Frequency", value: metrics.paymentFrequency },
|
|
264
266
|
...datesAndCash,
|
|
265
267
|
],
|
|
@@ -282,8 +284,8 @@ export function projectDividendYieldHeadless(
|
|
|
282
284
|
asOf: metrics.forwardRate == null ? null : metrics.forwardRateAsOf },
|
|
283
285
|
{ label: "Earnings Payout", value: roundedRatio(metrics.payoutRatio), formatted: metrics.payoutNotMeaningful ? PAYOUT_NOT_MEANINGFUL : formatDividendYield(metrics.payoutRatio),
|
|
284
286
|
exportUnit: "pct", asOf: null },
|
|
285
|
-
{ ...growthEntry("1Y Cash Growth", metrics.growth1Y, metrics.growth1YPayments), exportUnit: "pct", asOf: metrics.growth1Y == null ? null : lastEx },
|
|
286
|
-
{ ...growthEntry("3Y Cash CAGR", metrics.growth3Y, metrics.growth3YPayments), exportUnit: "pct", asOf: metrics.growth3Y == null ? null : lastEx },
|
|
287
|
+
{ ...growthEntry("1Y Cash Growth", metrics.growth1Y, metrics.growth1YPayments, metrics.growth1YNotMeaningful), exportUnit: "pct", asOf: metrics.growth1Y == null ? null : lastEx },
|
|
288
|
+
{ ...growthEntry("3Y Cash CAGR", metrics.growth3Y, metrics.growth3YPayments, metrics.growth3YNotMeaningful), exportUnit: "pct", asOf: metrics.growth3Y == null ? null : lastEx },
|
|
287
289
|
{ label: "Frequency", value: metrics.paymentFrequency, asOf: null },
|
|
288
290
|
...datesAndCash.map((entry) => ({ ...entry, asOf: null })),
|
|
289
291
|
],
|
|
@@ -320,6 +322,9 @@ export function projectDividendYieldHeadless(
|
|
|
320
322
|
// Set when a year a growth figure compares holds fewer payments than the cadence pays: that figure is null.
|
|
321
323
|
growth1YPayments: metrics.growth1YPayments ?? null,
|
|
322
324
|
growth3YPayments: metrics.growth3YPayments ?? null,
|
|
325
|
+
// Set when the earlier year a growth figure compares paid nothing and the later one paid: that figure is null, N/M.
|
|
326
|
+
growth1YNotMeaningful: metrics.growth1YNotMeaningful === true,
|
|
327
|
+
growth3YNotMeaningful: metrics.growth3YNotMeaningful === true,
|
|
323
328
|
forwardRateAsOf: metrics.forwardRateAsOf,
|
|
324
329
|
// Set when a monthly payer's history stops more than 40 days ago: its forward yield is withheld and its trailing yield counts the history to then.
|
|
325
330
|
historyEnds: metrics.lapse?.historyEnds ? metrics.lapse.lastPaid : null,
|
|
@@ -20,7 +20,8 @@ import {
|
|
|
20
20
|
import { useAsyncResource } from "../../../react/async-resource";
|
|
21
21
|
import { colors, priceColor } from "../../../theme/colors";
|
|
22
22
|
import { TextAttributes, useUiCapabilities } from "../../../ui";
|
|
23
|
-
import { displayWidth, formatCurrency, formatDistributionAmount, formatPercentRaw } from "../../../utils/format";
|
|
23
|
+
import { MISSING_VALUE, displayWidth, formatCurrency, formatDistributionAmount, formatPercentRaw } from "../../../utils/format";
|
|
24
|
+
import { NOT_MEANINGFUL_TEXT } from "../../../utils/growth";
|
|
24
25
|
import { resolveCurrencyUnit } from "../../../utils/currency-units";
|
|
25
26
|
import { parsePublicTickerKey } from "../../../utils/exchanges";
|
|
26
27
|
import { forwardDividendNote, lapseValue, lastPaidNote, UNEVEN_REGULAR_PAYMENTS } from "../../../utils/forward-dividend";
|
|
@@ -52,17 +53,18 @@ import { bondFigures } from "../../../market-data/bond-funds";
|
|
|
52
53
|
|
|
53
54
|
/** A per-share rate; one converted from the currency the company declares in goes to two decimals of its source's unit. */
|
|
54
55
|
function formatRate(value: number | null, currency: string, converted = false, subUnit?: string): string {
|
|
55
|
-
if (value == null) return
|
|
56
|
+
if (value == null) return MISSING_VALUE;
|
|
56
57
|
return converted ? formatConvertedAmount(value, currency, subUnit) : formatDistributionAmount(value, currency);
|
|
57
58
|
}
|
|
58
59
|
|
|
59
60
|
function formatGrowth(value: number | null): string {
|
|
60
|
-
if (value == null) return
|
|
61
|
+
if (value == null) return MISSING_VALUE;
|
|
61
62
|
return formatPercentRaw(value * 100);
|
|
62
63
|
}
|
|
63
64
|
|
|
64
|
-
/** A growth figure, or "n/a" with how many payments its short year holds. */
|
|
65
|
-
function growthItem(id: string, label: string, growth: number | null, payments: GrowthPayments | null | undefined): StatItem {
|
|
65
|
+
/** A growth figure, "N/M" off a year that paid nothing, or "n/a" with how many payments its short year holds. */
|
|
66
|
+
function growthItem(id: string, label: string, growth: number | null, payments: GrowthPayments | null | undefined, notMeaningful?: boolean): StatItem {
|
|
67
|
+
if (growth == null && notMeaningful) return { id, label, value: NOT_MEANINGFUL_TEXT };
|
|
66
68
|
if (growth == null && payments) {
|
|
67
69
|
return { id, label, value: "n/a", detail: growthPaymentsDetail(payments) };
|
|
68
70
|
}
|
|
@@ -70,12 +72,12 @@ function growthItem(id: string, label: string, growth: number | null, payments:
|
|
|
70
72
|
}
|
|
71
73
|
|
|
72
74
|
function formatDate(date: Date | null): string {
|
|
73
|
-
if (!date) return
|
|
75
|
+
if (!date) return MISSING_VALUE;
|
|
74
76
|
return date.toISOString().slice(0, 10);
|
|
75
77
|
}
|
|
76
78
|
|
|
77
79
|
function formatFrequency(freq: DividendMetrics["paymentFrequency"]): string {
|
|
78
|
-
if (!freq) return
|
|
80
|
+
if (!freq) return MISSING_VALUE;
|
|
79
81
|
switch (freq) {
|
|
80
82
|
case "monthly": return "Monthly";
|
|
81
83
|
case "quarterly": return "Quarterly";
|
|
@@ -126,9 +128,9 @@ function buildMetricItems(metrics: DividendMetrics, currency: string, hasHistory
|
|
|
126
128
|
...metrics.trailingRate != null ? converted : {} },
|
|
127
129
|
{ id: "forward-rate", label: short ? "Fwd/sh" : "Fwd/share", value: formatRate(metrics.forwardRate, currency, !!convertedFrom, convertedSubUnit),
|
|
128
130
|
...metrics.forwardRate != null ? converted : {} },
|
|
129
|
-
growthItem("growth-1y", short ? "1Y chg" : "1Y growth", metrics.growth1Y, metrics.growth1YPayments),
|
|
130
|
-
growthItem("cagr-3y", "3Y CAGR", metrics.growth3Y, metrics.growth3YPayments),
|
|
131
|
-
{ id: "payout", label: "Payout", value: metrics.payoutNotMeaningful ? PAYOUT_NOT_MEANINGFUL : metrics.payoutRatio != null ? `${(metrics.payoutRatio * 100).toFixed(1)}%` :
|
|
131
|
+
growthItem("growth-1y", short ? "1Y chg" : "1Y growth", metrics.growth1Y, metrics.growth1YPayments, metrics.growth1YNotMeaningful),
|
|
132
|
+
growthItem("cagr-3y", "3Y CAGR", metrics.growth3Y, metrics.growth3YPayments, metrics.growth3YNotMeaningful),
|
|
133
|
+
{ id: "payout", label: "Payout", value: metrics.payoutNotMeaningful ? PAYOUT_NOT_MEANINGFUL : metrics.payoutRatio != null ? `${(metrics.payoutRatio * 100).toFixed(1)}%` : MISSING_VALUE },
|
|
132
134
|
{ id: "cadence", label: "Cadence", value: formatFrequency(metrics.paymentFrequency) },
|
|
133
135
|
...exDate,
|
|
134
136
|
{ id: "next-pay", label: "Next pay", value: formatDate(metrics.nextPayDate) },
|
|
@@ -16,6 +16,7 @@ import { colors } from "../../../theme/colors";
|
|
|
16
16
|
import type { HeadlessPaneColumn } from "../../../types/headless";
|
|
17
17
|
import { TextAttributes } from "../../../ui";
|
|
18
18
|
import { compareSortValues, nextHeaderSort, type SortComparableValue, type SortPreference } from "../../../utils/sort-values";
|
|
19
|
+
import { displayWidth } from "../../../utils/format";
|
|
19
20
|
import { SignInWall } from "../cloud/auth-actions";
|
|
20
21
|
import { isCloudSessionRequired, useResearchCloudSession } from "../shared/research-cloud-session";
|
|
21
22
|
import { fetchDividendData } from "./client";
|
|
@@ -106,7 +107,9 @@ export function DividendRankingView({ symbols, focused, width, height, loadData
|
|
|
106
107
|
const columns = useMemo<RankingColumn[]>(() => (section?.columns ?? []).map((column) => ({
|
|
107
108
|
id: column.key,
|
|
108
109
|
label: column.header,
|
|
109
|
-
|
|
110
|
+
// The ticker column grows to its longest key, so a listing abroad shows whole.
|
|
111
|
+
width: Math.max(column.header.length, COLUMN_WIDTHS[column.key] ?? 0,
|
|
112
|
+
...column.key === "symbol" ? (section?.rows ?? []).map((row) => displayWidth(String(row.symbol ?? ""))) : []),
|
|
110
113
|
align: column.align === "right" ? "right" : "left",
|
|
111
114
|
source: column,
|
|
112
115
|
})), [section]);
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { HeadlessBundleResult, HeadlessPaneColumn } from "../../../types/headless";
|
|
2
|
-
import { formatPercent } from "../../../utils/format";
|
|
2
|
+
import { MISSING_VALUE, formatPercent } from "../../../utils/format";
|
|
3
|
+
import { NOT_MEANINGFUL_TEXT } from "../../../utils/growth";
|
|
3
4
|
import type { DividendData } from "./client";
|
|
4
5
|
import { formatDividendYield, growthPaymentsDetail, PAYOUT_NOT_MEANINGFUL, trailingPaymentsText } from "./view";
|
|
5
6
|
import type { FundBondFacts } from "../../../api-client/fund-facts";
|
|
@@ -172,6 +173,9 @@ function rankDividendEntries(entries: readonly DividendRankingEntry[], now = new
|
|
|
172
173
|
// Set when a year the figure compares is short of the cadence's payments: the figure is then n/a.
|
|
173
174
|
...metrics.growth1YPayments ? { growth1YPayments: growthPaymentsDetail(metrics.growth1YPayments) } : {},
|
|
174
175
|
...metrics.growth3YPayments ? { growth3YPayments: growthPaymentsDetail(metrics.growth3YPayments) } : {},
|
|
176
|
+
// Set when the earlier year paid nothing and the later one paid: the figure is then N/M.
|
|
177
|
+
...metrics.growth1YNotMeaningful ? { growth1YNotMeaningful: true } : {},
|
|
178
|
+
...metrics.growth3YNotMeaningful ? { growth3YNotMeaningful: true } : {},
|
|
175
179
|
lastExDate: isoDay(metrics.lastExDividendDate),
|
|
176
180
|
payDate: declaredPayDate(data, now),
|
|
177
181
|
frequency: metrics.paymentFrequency,
|
|
@@ -192,10 +196,14 @@ function rankDividendEntries(entries: readonly DividendRankingEntry[], now = new
|
|
|
192
196
|
}
|
|
193
197
|
|
|
194
198
|
const ratio = (value: unknown) => formatDividendYield(typeof value === "number" ? value : null);
|
|
195
|
-
/**
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
+
/**
|
|
200
|
+
* A growth figure; n/m off a year that paid nothing (the row's `<key>NotMeaningful`; the text report draws N/M);
|
|
201
|
+
* or n/a when one of its years is short (the row's `<key>Payments`).
|
|
202
|
+
*/
|
|
203
|
+
const growth = (key: "growth1Y" | "growth3Y", notMeaningful = NOT_MEANINGFUL_TEXT.toLowerCase()) => (value: unknown, row: Record<string, unknown>) =>
|
|
204
|
+
typeof value !== "number" && row[`${key}NotMeaningful`] === true ? notMeaningful
|
|
205
|
+
: typeof value !== "number" && typeof row[`${key}Payments`] === "string" ? "n/a" : formatPercent(typeof value === "number" ? value : undefined);
|
|
206
|
+
const day = (value: unknown) => typeof value === "string" && value ? value : MISSING_VALUE;
|
|
199
207
|
|
|
200
208
|
const RANKING_COLUMNS: HeadlessPaneColumn[] = [
|
|
201
209
|
{ key: "symbol", header: "Ticker", shrink: false },
|
|
@@ -208,10 +216,10 @@ const RANKING_COLUMNS: HeadlessPaneColumn[] = [
|
|
|
208
216
|
format: (value, row) => row.payoutNotMeaningful === true ? PAYOUT_NOT_MEANINGFUL.toLowerCase() : ratio(value),
|
|
209
217
|
textFormat: (value, row) => row.payoutNotMeaningful === true ? PAYOUT_NOT_MEANINGFUL : ratio(value),
|
|
210
218
|
description: "Trailing twelve-month dividends over trailing twelve-month diluted EPS; N/M when that EPS is zero or negative." },
|
|
211
|
-
{ key: "growth1Y", header: "1Y growth", align: "right", format: growth("growth1Y"),
|
|
212
|
-
description: "Trailing twelve-month cash per share against a year earlier; n/a when either year holds fewer payments than the cadence pays." },
|
|
213
|
-
{ key: "growth3Y", header: "3Y CAGR", align: "right", format: growth("growth3Y"),
|
|
214
|
-
description: "Compound annual growth of trailing twelve-month cash per share over three years; n/a when either year holds fewer payments than the cadence pays." },
|
|
219
|
+
{ key: "growth1Y", header: "1Y growth", align: "right", format: growth("growth1Y"), textFormat: growth("growth1Y", NOT_MEANINGFUL_TEXT),
|
|
220
|
+
description: "Trailing twelve-month cash per share against a year earlier; N/M when the year earlier paid nothing; n/a when either year holds fewer payments than the cadence pays." },
|
|
221
|
+
{ key: "growth3Y", header: "3Y CAGR", align: "right", format: growth("growth3Y"), textFormat: growth("growth3Y", NOT_MEANINGFUL_TEXT),
|
|
222
|
+
description: "Compound annual growth of trailing twelve-month cash per share over three years; N/M when the year three years earlier paid nothing; n/a when either year holds fewer payments than the cadence pays." },
|
|
215
223
|
{ key: "lastExDate", header: "Last ex", format: day, shrink: false },
|
|
216
224
|
{ key: "payDate", header: "Next pay", format: day, shrink: false, stackPriority: 2,
|
|
217
225
|
description: "Pay date of the next declared distribution; past distributions carry ex-dates only." },
|
|
@@ -225,7 +233,7 @@ const SEC_YIELD_COLUMNS: HeadlessPaneColumn[] = [
|
|
|
225
233
|
description: "The date the sponsor gives its SEC yield as of." },
|
|
226
234
|
];
|
|
227
235
|
|
|
228
|
-
const years = (value: unknown) => typeof value === "number" && Number.isFinite(value) ? `${value.toFixed(2)} yrs` :
|
|
236
|
+
const years = (value: unknown) => typeof value === "number" && Number.isFinite(value) ? `${value.toFixed(2)} yrs` : MISSING_VALUE;
|
|
229
237
|
|
|
230
238
|
/** Shown after the SEC yield with `--tax-rate`: the rest of a bond fund's sponsor figures, then what the tax rate makes of its yield. */
|
|
231
239
|
const TAX_COLUMNS: HeadlessPaneColumn[] = [
|
|
@@ -237,7 +245,7 @@ const TAX_COLUMNS: HeadlessPaneColumn[] = [
|
|
|
237
245
|
description: "A muni fund's tax-equivalent yield at --tax-rate: its SEC yield (else its distribution yield) / (1 - the rate). Blank for a taxable fund." },
|
|
238
246
|
// To one decimal, as single-ticker DVD and DES draw it.
|
|
239
247
|
{ key: "muniTreasuryRatio", header: "Muni/Tsy", align: "right",
|
|
240
|
-
format: (value) => typeof value === "number" && Number.isFinite(value) ? formatMuniTreasuryRatio(value) :
|
|
248
|
+
format: (value) => typeof value === "number" && Number.isFinite(value) ? formatMuniTreasuryRatio(value) : MISSING_VALUE,
|
|
241
249
|
description: "A muni fund's yield over the Treasury par yield at the tenor nearest its duration (treasuryTenor)." },
|
|
242
250
|
{ key: "treasuryTenor", header: "Tenor", format: day, shrink: false, stackPriority: 4,
|
|
243
251
|
description: "The Treasury tenor the muni/Treasury ratio divides by." },
|
|
@@ -43,6 +43,10 @@ export interface DividendMetrics {
|
|
|
43
43
|
growth1YPayments?: GrowthPayments | null;
|
|
44
44
|
/** The same for the two years the 3Y rate compares. */
|
|
45
45
|
growth3YPayments?: GrowthPayments | null;
|
|
46
|
+
/** Set when the earlier year 1Y growth compares paid no cash and the trailing year did (a resumed dividend): growth off zero, N/M. */
|
|
47
|
+
growth1YNotMeaningful?: boolean;
|
|
48
|
+
/** The same for the 3Y rate. */
|
|
49
|
+
growth3YNotMeaningful?: boolean;
|
|
46
50
|
paymentFrequency: DistributionCadence | null;
|
|
47
51
|
lastExDividendDate: Date | null;
|
|
48
52
|
/** Announced ex-date after now, from the summary or a future-dated history record. */
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { DividendPayment, GrowthPayments } from "./types";
|
|
2
|
-
import { formatCurrency } from "../../../utils/format";
|
|
2
|
+
import { MISSING_VALUE, formatCurrency } from "../../../utils/format";
|
|
3
3
|
import { currencyMinorDigits } from "../../../market-data/market/format";
|
|
4
4
|
import { resolveCurrencyUnit } from "../../../utils/currency-units";
|
|
5
5
|
import type { ProjectedChartPoint } from "../../../components/chart/core/data";
|
|
@@ -17,7 +17,7 @@ const DAY = 24 * 60 * 60 * 1000;
|
|
|
17
17
|
* `ZAR 0.866087`), as the conversion gives it no more.
|
|
18
18
|
*/
|
|
19
19
|
export function formatConvertedAmount(value: number | null | undefined, currency: string, subUnit?: string): string {
|
|
20
|
-
if (value == null || !Number.isFinite(value)) return
|
|
20
|
+
if (value == null || !Number.isFinite(value)) return MISSING_VALUE;
|
|
21
21
|
const unit = subUnit ? resolveCurrencyUnit(subUnit) : null;
|
|
22
22
|
return unit && unit.divisor !== 1 && unit.currency === currency
|
|
23
23
|
? formatCurrency(value * unit.divisor, subUnit!, 2)
|
|
@@ -28,7 +28,7 @@ export function formatConvertedAmount(value: number | null | undefined, currency
|
|
|
28
28
|
export const convertedFromText = (currency: string) => `converted from ${currency}`;
|
|
29
29
|
|
|
30
30
|
export function formatDividendYield(value: number | null): string {
|
|
31
|
-
return value != null && Number.isFinite(value) ? `${(value * 100).toFixed(2)}%` :
|
|
31
|
+
return value != null && Number.isFinite(value) ? `${(value * 100).toFixed(2)}%` : MISSING_VALUE;
|
|
32
32
|
}
|
|
33
33
|
|
|
34
34
|
/** A payout over zero or negative earnings, written as a P/E over a loss is. */
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { useCallback, useEffect, useState } from "react";
|
|
2
2
|
import type { DocsFeed, DocsLesson } from "../../../docs/content";
|
|
3
3
|
import { loadDocsFeed, loadDocsLesson, savedDocsFeed, savedDocsLesson } from "../../../docs/load";
|
|
4
|
+
import { logFailure } from "../../../utils/log-failure";
|
|
4
5
|
|
|
5
6
|
export interface DocsFeedState {
|
|
6
7
|
/** Null only until the shipped copy has loaded, a moment on first open. */
|
|
@@ -15,9 +16,10 @@ export function useDocsFeed(): DocsFeedState {
|
|
|
15
16
|
const [request, setRequest] = useState({ force: false, token: 0 });
|
|
16
17
|
useEffect(() => {
|
|
17
18
|
let live = true;
|
|
18
|
-
|
|
19
|
+
// Only a shipped copy that cannot be read rejects; the site's failures answer offline.
|
|
20
|
+
loadDocsFeed({ force: request.force }).then((result) => {
|
|
19
21
|
if (live) setState(result);
|
|
20
|
-
});
|
|
22
|
+
}, logFailure("docs.feed", "Loading the docs index failed"));
|
|
21
23
|
return () => {
|
|
22
24
|
live = false;
|
|
23
25
|
};
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { MISSING_VALUE } from "../../../utils/format";
|
|
1
2
|
import type { DoeSeriesRow, DoeTab } from "../../../api-client/doe";
|
|
2
3
|
import type { HeadlessPaneDefinition } from "../../../types/plugin";
|
|
3
4
|
import { loadDoeBoard } from "./client";
|
|
@@ -18,7 +19,7 @@ import {
|
|
|
18
19
|
} from "./model";
|
|
19
20
|
import { newestReportTime, oldestReportTime } from "../../../utils/utc-time";
|
|
20
21
|
|
|
21
|
-
const text = (value: unknown) => typeof value === "string" ? value :
|
|
22
|
+
const text = (value: unknown) => typeof value === "string" ? value : MISSING_VALUE;
|
|
22
23
|
|
|
23
24
|
/** One row per series, in the pane's words and units; numbers keep their published precision. */
|
|
24
25
|
function reportRow(row: DoeSeriesRow) {
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { MISSING_VALUE } from "../../../utils/format";
|
|
1
2
|
import type { DoeBoardPayload, DoeReport, DoeReportStatus, DoeSeriesRow, DoeTab, DoeUnit } from "../../../api-client/doe";
|
|
2
3
|
import { spanAxisFormatter } from "../../../components/chart-table/axis";
|
|
3
4
|
import type { ChartStripSpec } from "../../../components/chart-table/header";
|
|
@@ -74,33 +75,33 @@ function signed(value: number, decimals: number, suffix = ""): string {
|
|
|
74
75
|
}
|
|
75
76
|
|
|
76
77
|
export function formatDoeLevel(unit: DoeUnit, value: number | null): string {
|
|
77
|
-
return value == null ?
|
|
78
|
+
return value == null ? MISSING_VALUE : grouped(doeDisplayValue(unit, value), DECIMALS[unit]);
|
|
78
79
|
}
|
|
79
80
|
|
|
80
81
|
export function formatDoeChange(unit: DoeUnit, value: number | null): string {
|
|
81
|
-
return value == null ?
|
|
82
|
+
return value == null ? MISSING_VALUE : signed(doeDisplayValue(unit, value), DECIMALS[unit]);
|
|
82
83
|
}
|
|
83
84
|
|
|
84
85
|
/** Against a year ago: a percentage, or points for a rate already in percent. */
|
|
85
86
|
export function formatDoeVsYear(row: DoeSeriesRow): string {
|
|
86
87
|
const ago = row.yearAgo;
|
|
87
|
-
if (!ago) return
|
|
88
|
+
if (!ago) return MISSING_VALUE;
|
|
88
89
|
if (row.unit === "pct") return signed(ago.change, 1, "pt");
|
|
89
|
-
return ago.changePercent == null ?
|
|
90
|
+
return ago.changePercent == null ? MISSING_VALUE : signed(ago.changePercent, 1, "%");
|
|
90
91
|
}
|
|
91
92
|
|
|
92
93
|
/** Against the five-year average for the week, the same way. */
|
|
93
94
|
export function formatDoeVsFive(row: DoeSeriesRow): string {
|
|
94
95
|
const five = row.fiveYear;
|
|
95
|
-
if (!five) return
|
|
96
|
+
if (!five) return MISSING_VALUE;
|
|
96
97
|
if (row.unit === "pct") return signed(five.vsAverage, 1, "pt");
|
|
97
|
-
return five.vsAveragePercent == null ?
|
|
98
|
+
return five.vsAveragePercent == null ? MISSING_VALUE : signed(five.vsAveragePercent, 1, "%");
|
|
98
99
|
}
|
|
99
100
|
|
|
100
101
|
/** The figure a range bar stands for, for its export and its title. */
|
|
101
102
|
export function formatDoePosition(row: DoeSeriesRow): string {
|
|
102
103
|
const position = row.fiveYear?.position;
|
|
103
|
-
if (position == null) return
|
|
104
|
+
if (position == null) return MISSING_VALUE;
|
|
104
105
|
if (position < 0) return "below range";
|
|
105
106
|
if (position > 100) return "above range";
|
|
106
107
|
return `${Math.round(position)}%`;
|
|
@@ -116,19 +117,19 @@ export function doeReport(payload: DoeBoardPayload, tab: DoeTab): DoeReportStatu
|
|
|
116
117
|
|
|
117
118
|
const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
|
|
118
119
|
|
|
119
|
-
/** "Sep
|
|
120
|
+
/** "25 Sep" from a calendar date. */
|
|
120
121
|
function doeDay(date: string): string {
|
|
121
122
|
const [, month, day] = date.split("-").map(Number) as [number, number, number];
|
|
122
|
-
return `${MONTHS[month - 1]}
|
|
123
|
+
return `${day} ${MONTHS[month - 1]}`;
|
|
123
124
|
}
|
|
124
125
|
|
|
125
|
-
/** A release instant on the EIA's own clock: "Wed Sep
|
|
126
|
+
/** A release instant on the EIA's own clock: "Wed 30 Sep 10:30 ET". */
|
|
126
127
|
function doeReleaseTime(iso: string): string {
|
|
127
128
|
const parts = Object.fromEntries(new Intl.DateTimeFormat("en-US", {
|
|
128
129
|
timeZone: "America/New_York", weekday: "short", month: "short", day: "numeric",
|
|
129
130
|
hour: "2-digit", minute: "2-digit", hourCycle: "h23",
|
|
130
131
|
}).formatToParts(new Date(iso)).map((part) => [part.type, part.value]));
|
|
131
|
-
return `${parts.weekday} ${parts.
|
|
132
|
+
return `${parts.weekday} ${parts.day} ${parts.month} ${parts.hour}:${parts.minute} ET`;
|
|
132
133
|
}
|
|
133
134
|
|
|
134
135
|
/** The calendar's expectation for the next gas release, as the 1W change column reads it: "consensus +80 Bcf, prior +77 Bcf". */
|
|
@@ -7,9 +7,10 @@ import type { TickerRecord } from "../../../types/ticker";
|
|
|
7
7
|
import { earningsDateStatus, earningsEpsBasis, isProvisionalActual } from "../shared/earnings-report";
|
|
8
8
|
import { calendarReport } from "../shared/earnings-calendar";
|
|
9
9
|
import { listingSuffixCandidate } from "../../../sources/listing-symbols";
|
|
10
|
-
import { isUsListingExchange } from "../../../utils/exchanges";
|
|
10
|
+
import { isUsListingExchange, parsePublicTickerKey } from "../../../utils/exchanges";
|
|
11
|
+
import { listingAbroadVenue } from "../../../utils/sec";
|
|
11
12
|
import { sameHistoryListing } from "./client";
|
|
12
|
-
import { shortDate, surprise, weekday } from "./format";
|
|
13
|
+
import { shortDate, surprise, weekday, type Surprise } from "./format";
|
|
13
14
|
|
|
14
15
|
/** A held name is in a portfolio; a watched one only in watchlists. */
|
|
15
16
|
export type Ownership = "held" | "watched";
|
|
@@ -33,8 +34,8 @@ export interface BoardReport {
|
|
|
33
34
|
provisional: boolean;
|
|
34
35
|
/** Null when the reported figure's basis cannot be determined. */
|
|
35
36
|
epsBasis: EarningsEpsBasis | null;
|
|
36
|
-
/** Actual over estimate minus one. */
|
|
37
|
-
epsSurprise:
|
|
37
|
+
/** Actual over estimate minus one: N/M against a loss or zero estimate. */
|
|
38
|
+
epsSurprise: Surprise;
|
|
38
39
|
revenueEstimate: number | null;
|
|
39
40
|
impliedMove: number | null;
|
|
40
41
|
averageMove: number | null;
|
|
@@ -162,10 +163,44 @@ export function boardReport(report: EarningsCalendarReport, owned: ReadonlyMap<s
|
|
|
162
163
|
};
|
|
163
164
|
}
|
|
164
165
|
|
|
165
|
-
/**
|
|
166
|
+
/**
|
|
167
|
+
* A listing as the board and Gloom Cloud's earnings history key it, however it
|
|
168
|
+
* was typed: a vendor's suffix as the venue it names (0700.HK, 700.HK and
|
|
169
|
+
* 00700.HK are 0700:HKEX, VOD.L is VOD:LSE), a venue by its own code
|
|
170
|
+
* (0700:XHKG is 0700:HKEX), a Hong Kong code by its four digits, and a US
|
|
171
|
+
* listing by its ticker (AAPL:NASDAQ is AAPL). Any other key stays as typed.
|
|
172
|
+
*/
|
|
166
173
|
export function boardKey(symbol: string): string {
|
|
167
|
-
const
|
|
168
|
-
|
|
174
|
+
const typed = symbol.trim().toUpperCase();
|
|
175
|
+
const suffixed = listingSuffixCandidate(typed);
|
|
176
|
+
const key = suffixed ? `${suffixed.symbol}:${suffixed.exchange}` : typed;
|
|
177
|
+
const parsed = parsePublicTickerKey(key);
|
|
178
|
+
if (parsed.exchange && isUsListingExchange(parsed.exchange)) return parsed.symbol;
|
|
179
|
+
const venue = listingAbroadVenue(key);
|
|
180
|
+
if (!venue) return key;
|
|
181
|
+
const code = venue === "HKEX" && /^\d{1,5}$/.test(parsed.symbol) && Number(parsed.symbol) > 0
|
|
182
|
+
? String(Number(parsed.symbol)).padStart(4, "0") : parsed.symbol;
|
|
183
|
+
return `${code}:${venue}`;
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
/** The venues abroad whose listings' own reports Gloom Cloud reads: their exchange's results calendar and announcements. */
|
|
187
|
+
const HISTORY_VENUES_ABROAD: ReadonlySet<string> = new Set(["HKEX", "SGX", "SSE", "SZSE"]);
|
|
188
|
+
|
|
189
|
+
/**
|
|
190
|
+
* How ERN reads a symbol's past reports: by its listing's key, however it was
|
|
191
|
+
* typed (`boardKey`: 0700.HK is 0700:HKEX). A US listing's are the US
|
|
192
|
+
* board's, where SAN is not SAN:EPA's company; a Hong Kong, Singapore or
|
|
193
|
+
* China A listing has its own (`ownAbroad`), which Gloom Cloud reads from its
|
|
194
|
+
* exchange's results calendar and announcements, in their currency. Any other
|
|
195
|
+
* listing abroad has none (`abroad`) and shows its next report. A server that
|
|
196
|
+
* reads only Hong Kong's refuses the others (`noHistoryAbroad`), which then
|
|
197
|
+
* show their next report as before.
|
|
198
|
+
*/
|
|
199
|
+
export function historyListing(symbol: string): { listing: string; abroad: boolean; ownAbroad: boolean } {
|
|
200
|
+
const listing = boardKey(symbol);
|
|
201
|
+
const venue = listingAbroadVenue(listing);
|
|
202
|
+
const own = venue != null && HISTORY_VENUES_ABROAD.has(venue);
|
|
203
|
+
return { listing, abroad: venue != null && !own, ownAbroad: own };
|
|
169
204
|
}
|
|
170
205
|
|
|
171
206
|
/**
|
|
@@ -1,11 +1,14 @@
|
|
|
1
|
+
import { MISSING_VALUE } from "../../../utils/format";
|
|
1
2
|
import type { DataTableCell, DataTableColumn } from "../../../components";
|
|
2
3
|
import { withCompanyLogo } from "../../../components/company-logo";
|
|
3
4
|
import { TABLE_COLUMN_GAP, tableColumnLeadGap, tableColumnWidth } from "../../../components/ui/table-layout";
|
|
4
5
|
import { colors } from "../../../theme/colors";
|
|
6
|
+
import { notMeaningfulCell } from "../../../components/ui/not-meaningful";
|
|
7
|
+
import { isNotMeaningful } from "../../../utils/growth";
|
|
5
8
|
import { TextAttributes } from "../../../ui";
|
|
6
9
|
import { epsBasisShort, showsEpsBasis } from "../shared/earnings-report";
|
|
7
10
|
import type { BoardReport, BoardRow, BoardSort } from "./board-model";
|
|
8
|
-
import { epsText, impliedText, moneyText, moveSize, signedPercent, TIMING_LABEL, weekday } from "./format";
|
|
11
|
+
import { epsText, impliedText, moneyText, moveSize, signedPercent, TIMING_LABEL, weekday, type Surprise } from "./format";
|
|
9
12
|
|
|
10
13
|
type BoardColumnId =
|
|
11
14
|
| "owned" | "symbol" | "name" | "when" | "status" | "cap" | "ccy" | "epsEstimate" | "analysts" | "epsActual" | "basis"
|
|
@@ -126,8 +129,10 @@ export interface BoardCellContext {
|
|
|
126
129
|
const NO_CONTEXT: BoardCellContext = { statusShown: true, move: () => null };
|
|
127
130
|
|
|
128
131
|
/** A signed move or surprise, as ERN draws one. */
|
|
129
|
-
function signed(value:
|
|
130
|
-
|
|
132
|
+
function signed(value: Surprise): DataTableCell {
|
|
133
|
+
// N/M (a surprise against a loss or zero estimate) as every pane draws it; a missing figure dim.
|
|
134
|
+
if (isNotMeaningful(value)) return notMeaningfulCell();
|
|
135
|
+
return { text: signedPercent(value), color: typeof value !== "number" || value === 0 ? colors.textDim : value > 0 ? colors.positive : colors.negative };
|
|
131
136
|
}
|
|
132
137
|
|
|
133
138
|
export function renderBoardCell(row: BoardRow, column: BoardColumn, context: BoardCellContext = NO_CONTEXT): DataTableCell {
|
|
@@ -143,7 +148,7 @@ export function renderBoardCell(row: BoardRow, column: BoardColumn, context: Boa
|
|
|
143
148
|
case "name":
|
|
144
149
|
return withCompanyLogo({ text: report.name, color: colors.text }, report, context.logos === true);
|
|
145
150
|
case "when": {
|
|
146
|
-
const timing = report.timing ? TIMING_LABEL[report.timing] :
|
|
151
|
+
const timing = report.timing ? TIMING_LABEL[report.timing] : MISSING_VALUE;
|
|
147
152
|
const text = row.showDay ? `${weekday(report.date)} ${timing}` : timing;
|
|
148
153
|
// An expected time, from the company's last reports, reads quieter than an announced one.
|
|
149
154
|
if (context.statusShown) return { text, color: report.expectedTiming ? colors.textMuted : dim };
|
|
@@ -154,21 +159,21 @@ export function renderBoardCell(row: BoardRow, column: BoardColumn, context: Boa
|
|
|
154
159
|
}
|
|
155
160
|
case "status":
|
|
156
161
|
// A projected date reads quieter than an announced one, as an expected time does.
|
|
157
|
-
return { text: report.dateStatus ??
|
|
162
|
+
return { text: report.dateStatus ?? MISSING_VALUE, color: report.dateStatus === "projected" ? colors.textMuted : dim };
|
|
158
163
|
case "cap":
|
|
159
164
|
return { text: moneyText(report.marketCap), color: dim };
|
|
160
165
|
case "ccy":
|
|
161
|
-
return { text: report.currency ??
|
|
166
|
+
return { text: report.currency ?? MISSING_VALUE, color: dim };
|
|
162
167
|
case "epsEstimate":
|
|
163
168
|
return { text: epsText(report.epsEstimate), color: dim };
|
|
164
169
|
case "analysts":
|
|
165
|
-
return { text: report.epsAnalysts == null ?
|
|
170
|
+
return { text: report.epsAnalysts == null ? MISSING_VALUE : String(report.epsAnalysts), color: dim };
|
|
166
171
|
case "epsActual":
|
|
167
172
|
// The company's press release's figure reads quieter until the calendar's replaces it.
|
|
168
173
|
return { text: epsText(report.epsActual), color: report.epsActual == null ? dim : report.provisional ? colors.textMuted : colors.text };
|
|
169
174
|
case "basis":
|
|
170
175
|
return !showsEpsBasis(report)
|
|
171
|
-
? { text:
|
|
176
|
+
? { text: MISSING_VALUE, color: dim }
|
|
172
177
|
: { text: epsBasisShort(report.epsBasis), color: report.epsBasis ? colors.textMuted : dim };
|
|
173
178
|
case "epsSurprise":
|
|
174
179
|
return signed(report.epsSurprise);
|
|
@@ -18,6 +18,9 @@ import type { EarningsCalendarQuery } from "../../../api-client/earnings";
|
|
|
18
18
|
import { useAppSelector, usePaneAppConfig, usePaneSettingValue } from "../../../state/app/context";
|
|
19
19
|
import { useLiveStreamingSetting } from "../../../state/hooks/live-streaming";
|
|
20
20
|
import { useAsyncResource, useAutoRefresh, usePluginPaneState, useUpdatedAgo } from "../../../public/react";
|
|
21
|
+
import { useUtcDay } from "../../../react/auto-refresh";
|
|
22
|
+
import { reportFooterSegment } from "../shared/source-footer";
|
|
23
|
+
import { earningsBoardHeadless } from "./headless";
|
|
21
24
|
import type { EarningsEvent } from "../../../types/data-provider";
|
|
22
25
|
import { getSharedRegistry } from "../../registry/shared";
|
|
23
26
|
import { Box, useUiCapabilities } from "../../../ui";
|
|
@@ -94,6 +97,8 @@ interface BoardData {
|
|
|
94
97
|
/** The query read, by `earningsCalendarKey`: kept data from another week is not this week's. */
|
|
95
98
|
queryKey: string;
|
|
96
99
|
reports: BoardReport[];
|
|
100
|
+
/** When the service built the calendar read, which dates the board; null without one. */
|
|
101
|
+
asOf: string | null;
|
|
97
102
|
stale: boolean;
|
|
98
103
|
refreshError: string | null;
|
|
99
104
|
}
|
|
@@ -208,7 +213,7 @@ export function EarningsBoard({ focused, width, height, scopedSymbols, highlight
|
|
|
208
213
|
const loader = useCallback(async (force: boolean): Promise<BoardData> => {
|
|
209
214
|
const holdings = fund ? await loadMembers(fund.etf, force) : null;
|
|
210
215
|
const names = holdings ? fundNames(holdings.payload.members) : named;
|
|
211
|
-
if (!market && names.length === 0) return { queryKey, reports: [], stale: !!holdings && (holdings.stale || holdings.payload.stale), refreshError: holdings?.refreshError ?? null };
|
|
216
|
+
if (!market && names.length === 0) return { queryKey, reports: [], asOf: null, stale: !!holdings && (holdings.stale || holdings.payload.stale), refreshError: holdings?.refreshError ?? null };
|
|
212
217
|
const read = fund ? { ...query, symbols: names } : query;
|
|
213
218
|
const [cloud, fallback] = await Promise.allSettled([
|
|
214
219
|
loadEarningsBoard(read, force),
|
|
@@ -226,6 +231,7 @@ export function EarningsBoard({ focused, width, height, scopedSymbols, highlight
|
|
|
226
231
|
return {
|
|
227
232
|
queryKey,
|
|
228
233
|
reports: [...reports, ...extra],
|
|
234
|
+
asOf: cloud.status === "fulfilled" ? cloud.value.payload.asOf : null,
|
|
229
235
|
stale: (!!holdings && (holdings.stale || holdings.payload.stale)) || (cloud.status === "fulfilled" && cloud.value.stale),
|
|
230
236
|
refreshError: cloud.status === "rejected"
|
|
231
237
|
? (cloud.reason instanceof Error ? cloud.reason.message : String(cloud.reason))
|
|
@@ -238,7 +244,7 @@ export function EarningsBoard({ focused, width, height, scopedSymbols, highlight
|
|
|
238
244
|
const holdings = fund ? cachedMembers(fund.etf) : null;
|
|
239
245
|
if (fund && !holdings) return null;
|
|
240
246
|
const cached = cachedEarningsCalendar(holdings ? { ...query, symbols: fundNames(holdings.payload.members) } : query);
|
|
241
|
-
return cached ? { queryKey, reports: cached.payload.reports.map((report) => boardReport(report, owned)), stale: !!holdings?.payload.stale, refreshError: null } : null;
|
|
247
|
+
return cached ? { queryKey, reports: cached.payload.reports.map((report) => boardReport(report, owned)), asOf: cached.payload.asOf, stale: !!holdings?.payload.stale, refreshError: null } : null;
|
|
242
248
|
},
|
|
243
249
|
});
|
|
244
250
|
// A new fund or range never shows the previous scope while its holdings load or fail.
|
|
@@ -316,13 +322,19 @@ export function EarningsBoard({ focused, width, height, scopedSymbols, highlight
|
|
|
316
322
|
|
|
317
323
|
useAutoRefresh(resource.updatedAt, resource.load);
|
|
318
324
|
const updatedAgo = useUpdatedAgo(resource.updatedAt);
|
|
325
|
+
const utcDay = useUtcDay();
|
|
326
|
+
// Its source and when the calendar was read, as `fn EVTS` ends; how long ago it loaded goes first on a narrow row.
|
|
327
|
+
const footerInfo = useMemo(() => data ? [
|
|
328
|
+
reportFooterSegment(earningsBoardHeadless, { rows: [], metadata: { asOf: data.asOf } }),
|
|
329
|
+
...(updatedAgo ? [ageFooterSegment(updatedAgo)] : []),
|
|
330
|
+
] : [], [data, updatedAgo, utcDay]);
|
|
319
331
|
usePaneStatusFooter({
|
|
320
332
|
registrationId: "earnings-board",
|
|
321
333
|
enabled: !open,
|
|
322
334
|
loading: resource.loading,
|
|
323
335
|
error: resource.error ?? data?.refreshError ?? null,
|
|
324
336
|
stale: !!data?.stale,
|
|
325
|
-
info:
|
|
337
|
+
info: footerInfo,
|
|
326
338
|
});
|
|
327
339
|
const symbol = open?.symbol ?? selectedReport?.symbol ?? null;
|
|
328
340
|
// The desktop and the web only: the terminal's footer stays as it was.
|
|
@@ -32,7 +32,7 @@ export interface CalendarDay {
|
|
|
32
32
|
date: string;
|
|
33
33
|
/** "Mon" */
|
|
34
34
|
weekday: string;
|
|
35
|
-
/** "Oct
|
|
35
|
+
/** "20 Oct" */
|
|
36
36
|
label: string;
|
|
37
37
|
today: boolean;
|
|
38
38
|
/** No NYSE session that day. */
|
|
@@ -54,7 +54,7 @@ export function calendarWeekDates(today: string, offset: number): string[] {
|
|
|
54
54
|
return [0, 1, 2, 3, 4].map((index) => addDays(start, index));
|
|
55
55
|
}
|
|
56
56
|
|
|
57
|
-
/** "Last week", "This week", "Next week", then "Week of Nov
|
|
57
|
+
/** "Last week", "This week", "Next week", then "Week of 3 Nov". */
|
|
58
58
|
export function calendarWeekLabel(today: string, offset: number): string {
|
|
59
59
|
if (offset === -1) return "Last week";
|
|
60
60
|
if (offset === 0) return "This week";
|
|
@@ -104,7 +104,7 @@ export function boardRangeWeek(range: BoardRange, today: string): number {
|
|
|
104
104
|
return Math.round((Date.parse(mondayOf(range)) - Date.parse(mondayOf(today))) / (7 * 86_400_000));
|
|
105
105
|
}
|
|
106
106
|
|
|
107
|
-
/** A day of a week or the day asked for: "Today" for today, otherwise "Thu Oct
|
|
107
|
+
/** A day of a week or the day asked for: "Today" for today, otherwise "Thu 15 Oct". */
|
|
108
108
|
function dayLabel(date: string, today: string): string {
|
|
109
109
|
return date === today ? "Today" : `${weekday(date)} ${shortDate(date)}`;
|
|
110
110
|
}
|
|
@@ -120,13 +120,13 @@ export function boardRangeDays(range: BoardRange, today: string): MarketDay[] {
|
|
|
120
120
|
return calendarWeekDates(today, Number(range)).map((date) => ({ label: dayLabel(date, today), from: date, to: date }));
|
|
121
121
|
}
|
|
122
122
|
|
|
123
|
-
/** What the range reads as: "Last week", "Week of Nov
|
|
123
|
+
/** What the range reads as: "Last week", "Week of 2 Nov", "Thu 15 Oct", or null for the days ahead. */
|
|
124
124
|
export function boardRangeLabel(range: BoardRange, today: string): string | null {
|
|
125
125
|
if (ISO_DAY.test(range)) return dayLabel(range, today);
|
|
126
126
|
return WEEK_OFFSET.test(range) ? calendarWeekLabel(today, Number(range)) : null;
|
|
127
127
|
}
|
|
128
128
|
|
|
129
|
-
/** The range in a sentence ("No reports … last week"): "today", "on Thu Oct
|
|
129
|
+
/** The range in a sentence ("No reports … last week"): "today", "on Thu 15 Oct", "in the week of 2 Nov"; null for the days ahead. */
|
|
130
130
|
export function boardRangeWords(range: BoardRange, today: string): string | null {
|
|
131
131
|
if (ISO_DAY.test(range)) return range === today ? "today" : `on ${dayLabel(range, today)}`;
|
|
132
132
|
if (!WEEK_OFFSET.test(range)) return null;
|