gloomberb 0.20.12 → 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 +1 -1
- package/src/account/billing.ts +3 -2
- package/src/account/upgrade-dialog.tsx +8 -8
- package/src/api-client/index.ts +10 -2
- package/src/api-client/install-experiments.ts +146 -0
- package/src/api-client/telemetry.ts +47 -0
- package/src/api-client/types/market.ts +4 -0
- package/src/api-client/types/news.ts +16 -0
- 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/cli/commands/market.ts +51 -32
- package/src/cli/commands/overview.ts +3 -3
- package/src/cli/commands/search.ts +103 -9
- package/src/cli/commands/ticker.ts +22 -13
- package/src/cli/earnings-calendar.ts +33 -53
- package/src/cli/history-rows.ts +18 -1
- package/src/cli/known-gaps.ts +9 -0
- package/src/cli/listing-arg.ts +105 -18
- 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 +2 -2
- package/src/cli/pane-functions/headless.ts +8 -8
- package/src/cli/pane-functions/index.ts +1 -1
- package/src/cli/pane-functions/report.ts +4 -1
- package/src/cli/perpetual-contract.ts +4 -4
- package/src/cli/quote-answer.ts +6 -2
- package/src/cli/result.ts +2 -1
- 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/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/data-table/view.tsx +29 -6
- package/src/components/form-modal/host.tsx +1 -1
- package/src/components/layout/header.tsx +3 -2
- package/src/components/layout/market-summary.ts +3 -3
- package/src/components/layout/pane/error-boundary.tsx +2 -1
- package/src/components/markdown-text.tsx +36 -0
- package/src/components/market-board/index.tsx +4 -3
- 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/choice-dialog.tsx +101 -32
- 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 +16 -4
- package/src/components/ui/stat-grid.tsx +27 -6
- 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-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/quotes/listing-enterprise-value.ts +3 -3
- package/src/market-data/quotes/time.ts +17 -10
- 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/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 +5 -4
- package/src/plugins/builtin/awards/headless.ts +8 -7
- package/src/plugins/builtin/awards/model.ts +4 -3
- package/src/plugins/builtin/awards/pane.tsx +4 -4
- 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-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 +2 -1
- package/src/plugins/builtin/central-bank-rates/model.ts +3 -2
- package/src/plugins/builtin/central-bank-rates/pane.tsx +5 -5
- package/src/plugins/builtin/changelog/index.tsx +2 -2
- package/src/plugins/builtin/chart-composer/index.tsx +4 -2
- package/src/plugins/builtin/chart-composer/pane.tsx +7 -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/controller/utils.ts +2 -1
- 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 +35 -1
- package/src/plugins/builtin/cloud/company-picker.tsx +1 -3
- package/src/plugins/builtin/cloud/team/pane.tsx +12 -12
- package/src/plugins/builtin/cloud/thesis/detail.tsx +13 -8
- 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/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 +15 -10
- 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/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 +5 -4
- package/src/plugins/builtin/credit-boards/headless.ts +2 -1
- package/src/plugins/builtin/credit-boards/model.ts +5 -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/model.ts +4 -4
- 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/model.ts +3 -3
- package/src/plugins/builtin/debt-maturities/pane.tsx +2 -2
- 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 +14 -8
- package/src/plugins/builtin/earnings/board-table.ts +13 -8
- package/src/plugins/builtin/earnings/calendar-model.ts +5 -5
- package/src/plugins/builtin/earnings/calendar.tsx +2 -1
- package/src/plugins/builtin/earnings/format.ts +16 -14
- package/src/plugins/builtin/earnings/headless.ts +57 -19
- 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 +4 -3
- package/src/plugins/builtin/earnings-calls/calendar.tsx +2 -1
- package/src/plugins/builtin/earnings-calls/format.ts +6 -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 +2 -2
- package/src/plugins/builtin/econ/detail-view.tsx +2 -2
- package/src/plugins/builtin/econ/index.tsx +7 -6
- package/src/plugins/builtin/econ-statistics/detail.tsx +2 -1
- package/src/plugins/builtin/econ-statistics/headless.ts +4 -4
- 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 +2 -1
- package/src/plugins/builtin/filing-events/feed.ts +2 -1
- 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 +2 -2
- 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 +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 +9 -8
- 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/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 +6 -5
- package/src/plugins/builtin/macro-day/model.ts +2 -1
- package/src/plugins/builtin/macro-day/pane.tsx +4 -4
- 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/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 +2 -1
- package/src/plugins/builtin/money-markets/model.ts +3 -2
- package/src/plugins/builtin/money-markets/pane.tsx +4 -4
- 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 +47 -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 +5 -5
- 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/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/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 +2 -2
- package/src/plugins/builtin/portfolio-list/settings.ts +4 -1
- package/src/plugins/builtin/portfolio-list/summary/index.tsx +4 -4
- 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 +11 -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/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 +2 -1
- 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 +3 -2
- 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 +4 -4
- package/src/plugins/builtin/social-mentions/headless.ts +2 -1
- package/src/plugins/builtin/social-mentions/model.ts +4 -4
- package/src/plugins/builtin/supply-chain/graph-model.ts +2 -1
- package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
- package/src/plugins/builtin/supply-chain/headless.ts +3 -2
- package/src/plugins/builtin/supply-chain/model.ts +4 -4
- package/src/plugins/builtin/supply-chain/pane.tsx +2 -2
- package/src/plugins/builtin/supply-chain/row-evidence.tsx +2 -1
- 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 +4 -4
- 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 +33 -7
- package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +7 -5
- 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/client.ts +2 -1
- package/src/plugins/builtin/treasury-auctions/headless.ts +6 -6
- package/src/plugins/builtin/treasury-auctions/hk-headless.ts +3 -2
- package/src/plugins/builtin/treasury-auctions/hk-view.tsx +10 -9
- package/src/plugins/builtin/treasury-auctions/hk.ts +5 -5
- package/src/plugins/builtin/treasury-auctions/model.ts +4 -4
- package/src/plugins/builtin/treasury-auctions/pane.tsx +18 -18
- 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 +2 -1
- package/src/plugins/builtin/vol-surface/pane.tsx +8 -7
- 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/portfolio/allocation.ts +5 -5
- package/src/portfolio/column-values.ts +47 -41
- package/src/portfolio/futures-positions.ts +2 -1
- package/src/renderers/electrobun/bun/desktop/backend-requests.ts +7 -1
- package/src/renderers/opentui/ui-host.tsx +32 -2
- package/src/renderers/share/layout-view.tsx +2 -1
- package/src/sources/gloomberb-cloud/news.ts +9 -0
- package/src/sources/gloomberb-cloud/normalizers.ts +2 -0
- package/src/sources/provider-router/search.ts +15 -10
- package/src/state/hooks/inline-tickers.ts +3 -2
- package/src/state/hooks/quote-streaming.ts +9 -10
- package/src/team/collections-sync.ts +8 -3
- package/src/telemetry/usage-counts.ts +26 -0
- package/src/tickers/company-name-listing.ts +2 -2
- package/src/tickers/company-name.ts +17 -1
- package/src/tickers/listing-venues.ts +26 -1
- package/src/tickers/renamed-listings.ts +2 -1
- package/src/tickers/search/index.ts +19 -0
- package/src/tickers/starter-symbols.ts +7 -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 +3 -2
- package/src/types/financials.ts +15 -0
- package/src/types/instrument.ts +6 -0
- package/src/types/plugin-panes.ts +1 -1
- package/src/types/plugin-reports.ts +8 -0
- package/src/utils/datetime-format.ts +74 -33
- 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/growth.ts +67 -0
- package/src/utils/keyboard.ts +6 -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
|
@@ -33,7 +33,9 @@ const NAME_NOISE = new Set([
|
|
|
33
33
|
// Turkish legal forms short enough to open another company's name (AO Smith, AO World): a legal form only as its last word.
|
|
34
34
|
const LAST_WORD_NOISE = new Set(["ao", "tas"]);
|
|
35
35
|
// Words a venue adds to the share it lists ("Microsoft Corporation Common Stock"), never part of whose it is.
|
|
36
|
-
const SHARE_NOISE = new Set(["common", "ordinary", "stock", "shares"]);
|
|
36
|
+
const SHARE_NOISE = new Set(["common", "ordinary", "stock", "shares", "share"]);
|
|
37
|
+
// A venue's short form of a share class word, read as the word: "Volkswagen AG Pref. Share" in Zurich is its "Preferred Stock".
|
|
38
|
+
const SHARE_WORD_FORMS: Readonly<Record<string, string>> = { pref: "preferred", pfd: "preferred" };
|
|
37
39
|
|
|
38
40
|
/** A company's name for comparing its listings: "Kotobuki Spirits Co., Ltd." is "kotobuki spirits". */
|
|
39
41
|
function companyKey(name: string): string {
|
|
@@ -42,6 +44,7 @@ function companyKey(name: string): string {
|
|
|
42
44
|
.replace(/\b(?:(?:american|global) )?depositary (?:shares?|receipts?)\b/g, " ")
|
|
43
45
|
.replace(/\./g, "")
|
|
44
46
|
.split(/[^\p{L}\p{N}]+/u)
|
|
47
|
+
.map((word) => SHARE_WORD_FORMS[word] ?? word)
|
|
45
48
|
.filter((word) => word && !NAME_NOISE.has(word));
|
|
46
49
|
// The last word before any share wording, never a name's only one.
|
|
47
50
|
let last = words.length - 1;
|
|
@@ -77,6 +80,19 @@ export function sameCompany(left: string | null | undefined, right: string | nul
|
|
|
77
80
|
return [...fewer].every((word) => more.has(word));
|
|
78
81
|
}
|
|
79
82
|
|
|
83
|
+
/**
|
|
84
|
+
* Whether two names are one company's name however each venue writes the legal
|
|
85
|
+
* form and the share wording: "Deutsche Post AG" and "Deutsche Post" are, "DHL
|
|
86
|
+
* Express" and "DHL" are not (`sameCompany` would read them as one, since one
|
|
87
|
+
* name's words are all in the other's). For a name the data service gives a
|
|
88
|
+
* company besides its own (a former name, a trade name), which a line is told
|
|
89
|
+
* by only when it is exactly that name. An empty name matches none.
|
|
90
|
+
*/
|
|
91
|
+
export function sameCompanyName(left: string | null | undefined, right: string | null | undefined): boolean {
|
|
92
|
+
const a = companyKey(left ?? "");
|
|
93
|
+
return a !== "" && a === companyKey(right ?? "");
|
|
94
|
+
}
|
|
95
|
+
|
|
80
96
|
// Words that tell one class of a company's shares from another ("Berkshire Hathaway Inc. Class B"), never its business.
|
|
81
97
|
const SHARE_CLASS_WORD = /^(?:class|series|[a-z]|\d+)$/;
|
|
82
98
|
|
|
@@ -2,7 +2,7 @@ import { logFailure } from "../utils/log-failure";
|
|
|
2
2
|
import type { DataProvider } from "../types/data-provider";
|
|
3
3
|
import { quoteTradingExchange } from "../market-data/quotes/metadata";
|
|
4
4
|
import type { TickerRecord } from "../types/ticker";
|
|
5
|
-
import { AmbiguousContractError, AmbiguousTickerError, LISTING_SEARCH_LIMIT, listingChoiceQuery, listingExchange, resolveTickerSearch } from "./search";
|
|
5
|
+
import { AmbiguousContractError, AmbiguousTickerError, LISTING_SEARCH_LIMIT, listingChoiceQuery, listingExchange, otherNamesOf, resolveTickerSearch } from "./search";
|
|
6
6
|
import {
|
|
7
7
|
canonicalExchange,
|
|
8
8
|
exchangeCodeVenues,
|
|
@@ -38,6 +38,29 @@ export interface ListingVenue {
|
|
|
38
38
|
symbol?: string;
|
|
39
39
|
/** The exchange withdrew the listing (Hang Seng Bank's 0011 on HKEX): it is on record, and nothing trades there. */
|
|
40
40
|
withdrawal?: ListingWithdrawal;
|
|
41
|
+
/**
|
|
42
|
+
* The company the line belongs to, as the data service identifies it: two
|
|
43
|
+
* venues are different companies only when their ids differ, however each
|
|
44
|
+
* names the company (DHL Group AG on Xetra, Deutsche Post AG in Vienna).
|
|
45
|
+
*/
|
|
46
|
+
companyId?: string;
|
|
47
|
+
/** The data service marks the line as its company's home line: its main listing. */
|
|
48
|
+
home?: true;
|
|
49
|
+
/**
|
|
50
|
+
* The other names the line's company answers to, as the data service sends
|
|
51
|
+
* them (a former name, a trade name): DHL Group's rows carry "Deutsche Post
|
|
52
|
+
* AG", the name it had, which a venue that never renamed its line still shows.
|
|
53
|
+
*/
|
|
54
|
+
aliases?: string[];
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/** A search row's company id and home mark, as a venue carries them. */
|
|
58
|
+
function identityOf(companyId: unknown, home: boolean, aliases: readonly string[] = []): Pick<ListingVenue, "companyId" | "home" | "aliases"> {
|
|
59
|
+
return {
|
|
60
|
+
...typeof companyId === "string" && companyId ? { companyId } : {},
|
|
61
|
+
...home ? { home: true as const } : {},
|
|
62
|
+
...aliases.length > 0 ? { aliases: [...aliases] } : {},
|
|
63
|
+
};
|
|
41
64
|
}
|
|
42
65
|
|
|
43
66
|
/** A search row's name, and its withdrawal with the day it went beside the name, as a choice between listings names it. */
|
|
@@ -83,6 +106,7 @@ export async function listingVenues(
|
|
|
83
106
|
exchange: resolved.result.exchange === "SMART" ? resolved.result.primaryExchange ?? "" : resolved.result.exchange || resolved.result.primaryExchange || "",
|
|
84
107
|
...withdrawnOf(resolved.result.name, resolved.result.withdrawal),
|
|
85
108
|
...ownSymbol(parsePublicTickerKey(resolved.result.symbol).symbol, symbol),
|
|
109
|
+
...identityOf(resolved.result.companyId, resolved.result.homeListing === true, otherNamesOf(resolved.result)),
|
|
86
110
|
};
|
|
87
111
|
venues = only?.exchange ? [{ ...only, exchange: canonicalExchange(only.exchange) }] : [];
|
|
88
112
|
} catch (error) {
|
|
@@ -94,6 +118,7 @@ export async function listingVenues(
|
|
|
94
118
|
return key.exchange ? [{
|
|
95
119
|
exchange: key.exchange, name: error.listingNames[listing] ?? "", ...ownSymbol(key.symbol, symbol),
|
|
96
120
|
...(error.listingWithdrawals[listing] ? { withdrawal: error.listingWithdrawals[listing] } : {}),
|
|
121
|
+
...identityOf(error.listingCompanies[listing], error.listingHomes.includes(listing), error.listingAliases[listing]),
|
|
97
122
|
}] : [];
|
|
98
123
|
});
|
|
99
124
|
}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { formatShortDate } from "../utils/datetime-format";
|
|
1
2
|
import { normalizeSearchText } from "./search/ranking";
|
|
2
3
|
|
|
3
4
|
/**
|
|
@@ -47,7 +48,7 @@ const RENAMED_LISTINGS: readonly RenamedListing[] = [
|
|
|
47
48
|
|
|
48
49
|
/** "5 Jun 2026". */
|
|
49
50
|
function conversionDay(date: string): string {
|
|
50
|
-
return
|
|
51
|
+
return formatShortDate(date, { utc: true });
|
|
51
52
|
}
|
|
52
53
|
|
|
53
54
|
/** `AXIA3.SA`: the new listing as `quote` takes it. */
|
|
@@ -90,6 +90,12 @@ export class AmbiguousTickerError extends Error {
|
|
|
90
90
|
readonly listingNames: Readonly<Record<string, string>> = {},
|
|
91
91
|
/** The listings among them their exchange withdrew, by key (`0011:HKEX`). */
|
|
92
92
|
readonly listingWithdrawals: Readonly<Record<string, ListingWithdrawal>> = {},
|
|
93
|
+
/** Each listing's company as the data service identifies it (`companyId`), by key, where it sent one. */
|
|
94
|
+
readonly listingCompanies: Readonly<Record<string, string>> = {},
|
|
95
|
+
/** The listings the data service marks as their company's home line (`homeListing`), by key. */
|
|
96
|
+
readonly listingHomes: readonly string[] = [],
|
|
97
|
+
/** The other names each listing's company answers to (a former name, a trade name), by key, where the service sent any. */
|
|
98
|
+
readonly listingAliases: Readonly<Record<string, readonly string[]>> = {},
|
|
93
99
|
) {
|
|
94
100
|
// Every listing is a choice: a list cut short could leave out the one meant.
|
|
95
101
|
const more = listings.length - MAX_NAMED_LISTINGS;
|
|
@@ -634,6 +640,12 @@ async function resolveTickerSymbol(
|
|
|
634
640
|
])), Object.fromEntries(matches.flatMap((item) => {
|
|
635
641
|
const withdrawal = parseListingWithdrawal(item.result!.withdrawal);
|
|
636
642
|
return withdrawal ? [[publicTickerKey(item.symbol, listingExchange(item.result!)), withdrawal]] : [];
|
|
643
|
+
})), Object.fromEntries(matches.flatMap((item) => typeof item.result!.companyId === "string" && item.result!.companyId
|
|
644
|
+
? [[publicTickerKey(item.symbol, listingExchange(item.result!)), item.result!.companyId]] : [])),
|
|
645
|
+
matches.filter((item) => item.result!.homeListing === true).map((item) => publicTickerKey(item.symbol, listingExchange(item.result!))),
|
|
646
|
+
Object.fromEntries(matches.flatMap((item) => {
|
|
647
|
+
const aliases = otherNamesOf(item.result!);
|
|
648
|
+
return aliases.length > 0 ? [[publicTickerKey(item.symbol, listingExchange(item.result!)), aliases]] : [];
|
|
637
649
|
})));
|
|
638
650
|
if (pickerQuery && listings.size > 1) throw ambiguity(pickerQuery);
|
|
639
651
|
// A code that names several venues (TSE) the symbol trades on more than one of is a choice.
|
|
@@ -999,6 +1011,13 @@ function getProviderHintScore(result: InstrumentSearchResult, preferredExchange?
|
|
|
999
1011
|
return getProviderHintRichness(result) + (matchesPreferredExchange ? 10_000 : 0);
|
|
1000
1012
|
}
|
|
1001
1013
|
|
|
1014
|
+
/** The names the row's company answers to besides its own: those the service sent it for and the name it had before. */
|
|
1015
|
+
export function otherNamesOf(result: InstrumentSearchResult): string[] {
|
|
1016
|
+
const names = [...searchResultNames(result) ?? [], ...typeof result.formerName === "string" ? [result.formerName] : []]
|
|
1017
|
+
.map((name) => name.trim()).filter(Boolean);
|
|
1018
|
+
return [...new Set(names)];
|
|
1019
|
+
}
|
|
1020
|
+
|
|
1002
1021
|
/** The names the service sent the row for, without the symbol spellings; older servers send none. */
|
|
1003
1022
|
function searchResultNames(result: InstrumentSearchResult): string[] | undefined {
|
|
1004
1023
|
const names = Array.isArray(result.searchAliases)
|
|
@@ -6,3 +6,10 @@
|
|
|
6
6
|
export const STARTER_SYMBOLS: ReadonlySet<string> = new Set([
|
|
7
7
|
"AAPL", "MSFT", "GOOGL", "AMZN", "NVDA", "TSLA", "META", "BRK.B", "JPM", "V", "BTC-USD", "ETH-USD", "SPY", "QQQ",
|
|
8
8
|
]);
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* The seeded lists hold 7 (the first run) or 12 (startup) starter tickers,
|
|
12
|
+
* so a list with fewer was trimmed or built by hand: the server, the Monday
|
|
13
|
+
* brief and the company picker take it as the user's own.
|
|
14
|
+
*/
|
|
15
|
+
export const SEEDED_LIST_MIN_STARTERS = 7;
|
|
@@ -3,6 +3,7 @@ import type { FinancialStatement } from "../../types/financials";
|
|
|
3
3
|
import { completeAvailability, statementFieldAvailability } from "../../utils/financial-statements";
|
|
4
4
|
import { hasStatementGap } from "../../utils/statement-gaps";
|
|
5
5
|
import { isFiniteNumber } from "../../utils/guards";
|
|
6
|
+
import { rateValue, revenueMargin } from "../../utils/growth";
|
|
6
7
|
import { type InternalStatement, type NumericStatementField, statementNumber } from "./statement";
|
|
7
8
|
|
|
8
9
|
export function ratio(numerator: unknown, denominator: unknown): number | null {
|
|
@@ -11,6 +12,12 @@ export function ratio(numerator: unknown, denominator: unknown): number | null {
|
|
|
11
12
|
: null;
|
|
12
13
|
}
|
|
13
14
|
|
|
15
|
+
/** A margin in percent: none over zero or negative revenue, where it is not meaningful. */
|
|
16
|
+
function revenuePercent(numerator: unknown, revenue: unknown): { value: number | null; derived: true } {
|
|
17
|
+
const margin = isFiniteNumber(numerator) && isFiniteNumber(revenue) ? rateValue(revenueMargin(numerator, revenue)) : null;
|
|
18
|
+
return { value: margin === null ? null : margin * 100, derived: true };
|
|
19
|
+
}
|
|
20
|
+
|
|
14
21
|
export function freeCashFlow(statement: FinancialStatement): { value: number | null; derived: boolean } {
|
|
15
22
|
if (isFiniteNumber(statement.freeCashFlow)) return { value: statement.freeCashFlow, derived: false };
|
|
16
23
|
if (isFiniteNumber(statement.operatingCashFlow) && isFiniteNumber(statement.capitalExpenditure)) {
|
|
@@ -129,23 +136,13 @@ export function fundamentalValue(
|
|
|
129
136
|
statement: InternalStatement,
|
|
130
137
|
metric: string,
|
|
131
138
|
): { value: number | null; derived: boolean } {
|
|
132
|
-
if (metric === "grossMargin")
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
}
|
|
136
|
-
if (metric === "operatingMargin") {
|
|
137
|
-
const value = ratio(statement.operatingIncome, statement.totalRevenue);
|
|
138
|
-
return { value: value === null ? null : value * 100, derived: true };
|
|
139
|
-
}
|
|
140
|
-
if (metric === "netMargin") {
|
|
141
|
-
const value = ratio(statement.netIncome, statement.totalRevenue);
|
|
142
|
-
return { value: value === null ? null : value * 100, derived: true };
|
|
143
|
-
}
|
|
139
|
+
if (metric === "grossMargin") return revenuePercent(statement.grossProfit, statement.totalRevenue);
|
|
140
|
+
if (metric === "operatingMargin") return revenuePercent(statement.operatingIncome, statement.totalRevenue);
|
|
141
|
+
if (metric === "netMargin") return revenuePercent(statement.netIncome, statement.totalRevenue);
|
|
144
142
|
if (metric === "freeCashFlow" || metric === "freeCashFlowMargin") {
|
|
145
143
|
const fcf = freeCashFlow(statement);
|
|
146
144
|
if (metric === "freeCashFlow") return fcf;
|
|
147
|
-
|
|
148
|
-
return { value: value === null ? null : value * 100, derived: true };
|
|
145
|
+
return revenuePercent(fcf.value, statement.totalRevenue);
|
|
149
146
|
}
|
|
150
147
|
const value = statementNumber(statement, metric as NumericStatementField);
|
|
151
148
|
const derived = statement.__timeSeriesTtm === true
|
|
@@ -85,7 +85,7 @@ export function behindHistoryNotice(
|
|
|
85
85
|
const wall = new Date(zonedWallClockMs(getPricePointTimestamp(latest), zone)).toISOString();
|
|
86
86
|
const sameYear = wall.slice(0, 4) === zonedDateKey(now, zone).slice(0, 4);
|
|
87
87
|
const day = formatShortDate(wall.slice(0, 10), { utc: true, year: sameYear ? false : "numeric" });
|
|
88
|
-
return `${instrumentLabel(source)}: newer bars are unavailable; showing saved bars as of ${day} ${wall.slice(11, 16)} ${timeZoneLabel(zone)}.`;
|
|
88
|
+
return `${instrumentLabel(source)}: newer bars are unavailable; showing saved bars as of ${day} ${wall.slice(11, 16)} ${timeZoneLabel(zone, getPricePointTimestamp(latest))}.`;
|
|
89
89
|
}
|
|
90
90
|
|
|
91
91
|
function isSortedPriceHistory(points: TickerFinancials["priceHistory"]): boolean {
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/** A value a log axis cannot place: zero or below. */
|
|
2
|
+
export function hiddenOnLogScale(value: number | null | undefined): boolean {
|
|
3
|
+
return typeof value === "number" && Number.isFinite(value) && value <= 0;
|
|
4
|
+
}
|
|
5
|
+
|
|
6
|
+
/** What a log panel says about the values it leaves out, by the name of what holds them. */
|
|
7
|
+
export function logScaleHiddenWarning(name: string, hiddenCount: number): string {
|
|
8
|
+
return `${name}: ${hiddenCount} non-positive observation${hiddenCount === 1 ? " is" : "s are"} hidden on the logarithmic scale.`;
|
|
9
|
+
}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { TickerFinancials } from "../types/financials";
|
|
2
2
|
import { formatCompact, formatNumber } from "../utils/format";
|
|
3
|
+
import { growthRate, rateValue } from "../utils/growth";
|
|
3
4
|
import { getTimeSeriesField } from "./field-catalog";
|
|
4
5
|
import { extractFundamentalSeries } from "./fundamentals";
|
|
5
6
|
import type { ResolvedSeries, SecuritySeriesSource } from "./types";
|
|
@@ -79,9 +80,8 @@ export function graphRowsForFinancials(
|
|
|
79
80
|
date,
|
|
80
81
|
category: point.periodLabel ?? date,
|
|
81
82
|
value: current,
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
: null,
|
|
83
|
+
// None off a zero or negative base, where growth is not meaningful.
|
|
84
|
+
growth: consecutivePeriod && typeof previous === "number" ? rateValue(growthRate(current, previous)) : null,
|
|
85
85
|
barWidth: Math.max(1, Math.round((Math.abs(current) / maximum) * 24)),
|
|
86
86
|
};
|
|
87
87
|
});
|
|
@@ -8,6 +8,7 @@ import { historyRetentionNotice, historyStartNotice } from "../sources/history-r
|
|
|
8
8
|
import type { BrokerContractRef } from "../types/instrument";
|
|
9
9
|
import { FINANCIAL_VINTAGE_NOTICE, SEC_EPS_BASIS_NOTICE } from "../utils/financial-statements";
|
|
10
10
|
import { subtractTimeRange } from "./date-window";
|
|
11
|
+
import { hiddenOnLogScale, logScaleHiddenWarning } from "./log-scale";
|
|
11
12
|
import {
|
|
12
13
|
CHART_RESOLUTION_STEP_MS,
|
|
13
14
|
chartBarSizeSource,
|
|
@@ -929,8 +930,9 @@ async function resolveChartSpecPass(
|
|
|
929
930
|
const needsFinancials = !isPriceOnlyMarketFieldId(source.fieldId)
|
|
930
931
|
|| !source.instrument.exchange?.trim();
|
|
931
932
|
const financialsPromise = needsFinancials ? loadFinancials(source) : Promise.resolve(null);
|
|
932
|
-
// A continuous future (HO=F) is known by its symbol: its terms load beside its
|
|
933
|
-
|
|
933
|
+
// A continuous future (HO=F) is known by its symbol: its terms load beside its
|
|
934
|
+
// history and are read below. A failed read already answers null.
|
|
935
|
+
loadPriceUnit(source, undefined).catch(logFailure("time-series-resolve", "Starting a futures price unit read failed"));
|
|
934
936
|
let resolvedSource = source;
|
|
935
937
|
let financials: TickerFinancials | null;
|
|
936
938
|
let history: LoadedPriceHistory | null;
|
|
@@ -1244,13 +1246,13 @@ async function resolveChartSpecPass(
|
|
|
1244
1246
|
}
|
|
1245
1247
|
for (const panel of spec.panels) {
|
|
1246
1248
|
if (panel.scale !== "log") continue;
|
|
1247
|
-
const isHidden = (point: TimeSeriesPoint) =>
|
|
1249
|
+
const isHidden = (point: TimeSeriesPoint) => hiddenOnLogScale(point.value);
|
|
1248
1250
|
const affected = resolved.filter((entry) => entry.panelId === panel.id && entry.points.some(isHidden));
|
|
1249
1251
|
const hiddenCount = affected.reduce((total, entry) => total + entry.points.filter(isHidden).length, 0);
|
|
1250
1252
|
if (hiddenCount > 0) {
|
|
1251
1253
|
// A panel without a title is named by the series it holds, never by its id (`main`).
|
|
1252
1254
|
const name = panel.label ?? [...new Set(affected.map((entry) => entry.label))].join(", ");
|
|
1253
|
-
warnings.push(
|
|
1255
|
+
warnings.push(logScaleHiddenWarning(name, hiddenCount));
|
|
1254
1256
|
}
|
|
1255
1257
|
}
|
|
1256
1258
|
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import type { ResolvedSeries, SeriesTransform, TimeSeriesPoint } from "./types";
|
|
2
2
|
import { calendarMonthsBefore } from "../utils/calendar-date";
|
|
3
3
|
import { isFiniteNumber } from "../utils/guards";
|
|
4
|
+
import { growthRate, rateValue } from "../utils/growth";
|
|
4
5
|
import { isOhlcSeriesStyle } from "./spec";
|
|
5
6
|
|
|
6
7
|
const DAY_MS = 24 * 60 * 60 * 1_000;
|
|
@@ -26,14 +27,16 @@ function primaryValue(point: TimeSeriesPoint): number | null {
|
|
|
26
27
|
: null;
|
|
27
28
|
}
|
|
28
29
|
|
|
30
|
+
/** A value against a positive baseline: its change in percent, or the baseline as 100. */
|
|
29
31
|
function relativeValue(value: number | null | undefined, baseline: number, index100: boolean): number | null {
|
|
30
|
-
if (!isFiniteNumber(value) || baseline
|
|
31
|
-
return index100 ? (value / baseline) * 100 : ((value - baseline) /
|
|
32
|
+
if (!isFiniteNumber(value) || !(baseline > 0)) return null;
|
|
33
|
+
return index100 ? (value / baseline) * 100 : ((value - baseline) / baseline) * 100;
|
|
32
34
|
}
|
|
33
35
|
|
|
36
|
+
/** YoY or QoQ growth in percent: none off a zero or negative base, where it is not meaningful. */
|
|
34
37
|
function growthValue(value: number | null | undefined, previous: number | null | undefined): number | null {
|
|
35
|
-
|
|
36
|
-
return
|
|
38
|
+
const growth = rateValue(growthRate(value, previous));
|
|
39
|
+
return growth === null ? null : growth * 100;
|
|
37
40
|
}
|
|
38
41
|
|
|
39
42
|
function referencePoint(
|
|
@@ -122,7 +125,9 @@ export function applySeriesTransform(
|
|
|
122
125
|
const baseline = options.baseline !== undefined
|
|
123
126
|
? options.baseline
|
|
124
127
|
: baselinePoint ? primaryValue(baselinePoint) : null;
|
|
125
|
-
|
|
128
|
+
// Off a baseline at or below zero (a loss, a negative yield) a change in percent or an index is not
|
|
129
|
+
// meaningful, as growth off one is (utils/growth): the series is left as gaps.
|
|
130
|
+
if (baseline === null || !(baseline > 0)) {
|
|
126
131
|
return points.map((point) => mapNumericFields(point, () => null));
|
|
127
132
|
}
|
|
128
133
|
return points.map((point) => mapNumericFields(
|
package/src/types/config.ts
CHANGED
|
@@ -189,6 +189,8 @@ export type OnboardingStage =
|
|
|
189
189
|
| "portfolio"
|
|
190
190
|
| "add-ticker"
|
|
191
191
|
| "desks"
|
|
192
|
+
/** "Which tickers do you follow?", after the desks, in the `tickers` arm of first_run_tickers. */
|
|
193
|
+
| "tickers"
|
|
192
194
|
| "research"
|
|
193
195
|
| "verify"
|
|
194
196
|
| "account"
|
|
@@ -212,6 +214,13 @@ export interface OnboardingProgress {
|
|
|
212
214
|
* step can be left, and the layouts are rebuilt in place.
|
|
213
215
|
*/
|
|
214
216
|
rerun?: boolean;
|
|
217
|
+
/**
|
|
218
|
+
* This first run left "What do you hold?" holding nothing on a build that
|
|
219
|
+
* asks "Which tickers do you follow?". Only such a run is put in the
|
|
220
|
+
* first_run_tickers experiment, so an install that began setup on an
|
|
221
|
+
* earlier build never sees the step.
|
|
222
|
+
*/
|
|
223
|
+
asksTickers?: boolean;
|
|
215
224
|
}
|
|
216
225
|
|
|
217
226
|
/**
|
|
@@ -226,8 +226,9 @@ export interface SearchRequestContext {
|
|
|
226
226
|
brokerId?: string;
|
|
227
227
|
brokerInstanceId?: string;
|
|
228
228
|
/**
|
|
229
|
-
* A person is waiting on this result, so a slow
|
|
230
|
-
* well under a second rather than given the batch budget.
|
|
229
|
+
* A person is waiting on this result, so a slow broker should be abandoned in
|
|
230
|
+
* well under a second rather than given the batch budget. The data service is
|
|
231
|
+
* still waited for: its answer is the search's.
|
|
231
232
|
*/
|
|
232
233
|
interactive?: boolean;
|
|
233
234
|
/**
|
package/src/types/financials.ts
CHANGED
|
@@ -853,6 +853,11 @@ export interface ResultsStatementFill {
|
|
|
853
853
|
* earlier: the document restates that period's figure as the source has it.
|
|
854
854
|
*/
|
|
855
855
|
comparable?: ResultsFillField[];
|
|
856
|
+
/**
|
|
857
|
+
* A quarter's lines left blank because the announcements count them otherwise than the statements
|
|
858
|
+
* source (HSBC's revenue): set beside the source's quarters around it, the change would measure that.
|
|
859
|
+
*/
|
|
860
|
+
omitted?: ResultsFillField[];
|
|
856
861
|
}
|
|
857
862
|
|
|
858
863
|
export type StatementFill = ExchangeStatisticsFill | ResultsStatementFill;
|
|
@@ -865,6 +870,12 @@ export interface StatementTrailing {
|
|
|
865
870
|
priorInterim: { end: string; months: number };
|
|
866
871
|
/** "FY to 2025-12-31 + 6 months to 2026-06-30 − 6 months to 2025-06-30" */
|
|
867
872
|
basis: string;
|
|
873
|
+
/**
|
|
874
|
+
* Why the four quarters to the same end must not stand in for this: the latest quarters come from the
|
|
875
|
+
* company's announcements and the earlier ones from a source that defines a line otherwise. Absent where
|
|
876
|
+
* the quarters may be summed.
|
|
877
|
+
*/
|
|
878
|
+
overQuarters?: string;
|
|
868
879
|
}
|
|
869
880
|
|
|
870
881
|
/** Per-share earnings lines that can be declared unavailable. */
|
|
@@ -1186,6 +1197,10 @@ export interface PricePoint {
|
|
|
1186
1197
|
filled?: boolean;
|
|
1187
1198
|
/** A future's session that has closed but whose settlement is not confirmed yet: its close is the last trade. */
|
|
1188
1199
|
unsettled?: boolean;
|
|
1200
|
+
/** An index session's closing print as its last intraday bar, from its daily bar: the source keeps only the latest session's. */
|
|
1201
|
+
sessionClose?: boolean;
|
|
1202
|
+
/** An index session's last intraday bar, which ends before its close: its closing print was not at hand. */
|
|
1203
|
+
beforeClose?: boolean;
|
|
1189
1204
|
/**
|
|
1190
1205
|
* The source served the bar in the wrong unit (a tenth or a hundredth of its price, ten or a hundred times its
|
|
1191
1206
|
* volume): the factor its prices were multiplied by to match the bars around it; its volume was divided by it.
|
package/src/types/instrument.ts
CHANGED
|
@@ -93,4 +93,10 @@ export interface InstrumentSearchResult {
|
|
|
93
93
|
/** The company's home line, its common stock on its home exchange (7203 on JPX for Toyota), sent by newer
|
|
94
94
|
* cloud servers. Search lists it before the company's depositary receipts and other lines. Only `true` counts. */
|
|
95
95
|
homeListing?: boolean;
|
|
96
|
+
/**
|
|
97
|
+
* The company the line belongs to, as the data service identifies it, sent by newer cloud servers on a bare
|
|
98
|
+
* symbol's own lines: DHL's Xetra and Vienna lines carry one id however each venue names the company. Two lines
|
|
99
|
+
* are different companies only when their ids differ.
|
|
100
|
+
*/
|
|
101
|
+
companyId?: string;
|
|
96
102
|
}
|
|
@@ -129,7 +129,7 @@ export interface PaneDef {
|
|
|
129
129
|
* catalog lists it, and `fn` refuses an argument from a function that
|
|
130
130
|
* declares none here, in its shortcut or in a `headless` model.
|
|
131
131
|
*/
|
|
132
|
-
reportArgument?: Pick<HeadlessPaneArgumentDef, "kind" | "placeholder" | "description" | "optional"> & {
|
|
132
|
+
reportArgument?: Pick<HeadlessPaneArgumentDef, "kind" | "placeholder" | "description" | "optional" | "examples"> & {
|
|
133
133
|
/**
|
|
134
134
|
* The argument names something the pane opens by its own id (the story
|
|
135
135
|
* pane's story id), never a symbol: `fn` does not look it up as a ticker.
|
|
@@ -10,6 +10,14 @@ export interface PaneLock {
|
|
|
10
10
|
token?: string;
|
|
11
11
|
/** The session is signed in and its email is not verified yet. */
|
|
12
12
|
verifyEmail?: boolean;
|
|
13
|
+
/** The text the report was asked with, for a pane whose argument is free text (ASKG's question). */
|
|
14
|
+
argument?: string;
|
|
15
|
+
/**
|
|
16
|
+
* The functions the catalog finds for a question, best first, up to
|
|
17
|
+
* `limit`, with the command that runs each: what a note can offer in place
|
|
18
|
+
* of the locked pane. Absent where no catalog is at hand.
|
|
19
|
+
*/
|
|
20
|
+
functionsFor?(question: string, limit: number): Promise<Array<{ code: string; label: string; command: string }>>;
|
|
13
21
|
/**
|
|
14
22
|
* Reads data as the report does, so a note can check that a free route it
|
|
15
23
|
* would name has data for the symbol before naming it. Absent where nothing
|
|
@@ -1,4 +1,6 @@
|
|
|
1
|
+
import { MISSING_VALUE } from "./format";
|
|
1
2
|
import { toTimestampMillis } from "./timestamp";
|
|
3
|
+
import { timeZoneLabel } from "./zoned-date-time";
|
|
2
4
|
|
|
3
5
|
export type DisplayDateValue = Date | string | number | null | undefined;
|
|
4
6
|
|
|
@@ -22,7 +24,7 @@ function elapsedUnits(ageMs: number): { count: number; unit: "m" | "h" | "d" } |
|
|
|
22
24
|
}
|
|
23
25
|
|
|
24
26
|
/** Age for a narrow column: "<1m", "5m", "3h", "2d". */
|
|
25
|
-
export function formatRelativeTime(value: DisplayDateValue, now = Date.now(), fallback =
|
|
27
|
+
export function formatRelativeTime(value: DisplayDateValue, now = Date.now(), fallback = MISSING_VALUE): string {
|
|
26
28
|
const date = parseDisplayDate(value);
|
|
27
29
|
if (!date) return fallback;
|
|
28
30
|
|
|
@@ -51,9 +53,6 @@ export function formatCountdown(ms: number): string {
|
|
|
51
53
|
|
|
52
54
|
// Reuse the locale formatter when a feed contains older items. Constructing
|
|
53
55
|
// one for every row dominates opening a long transcript, even without edits.
|
|
54
|
-
const olderRelativeDateFormatter = new Intl.DateTimeFormat("en-US", {
|
|
55
|
-
month: "numeric", day: "numeric", year: "2-digit",
|
|
56
|
-
});
|
|
57
56
|
|
|
58
57
|
/**
|
|
59
58
|
* Relative time that turns into a date ("1/5/26") after a week, for feeds read
|
|
@@ -66,15 +65,17 @@ export function formatTimeAgo(date: Date | string, { short = false }: { short?:
|
|
|
66
65
|
const elapsed = elapsedUnits(Date.now() - ts);
|
|
67
66
|
if (!elapsed) return short ? "<1m" : "just now";
|
|
68
67
|
if (elapsed.unit === "d" && elapsed.count >= 7) {
|
|
69
|
-
|
|
68
|
+
// As a feed writes a day past the week: "5 Nov", "5 Nov '25" in another year, never "11/5/26".
|
|
69
|
+
const date = new Date(ts);
|
|
70
|
+
return formatShortDate(date, { year: date.getFullYear() === new Date().getFullYear() ? false : "2-digit" });
|
|
70
71
|
}
|
|
71
72
|
return `${elapsed.count}${elapsed.unit}${short ? "" : " ago"}`;
|
|
72
73
|
}
|
|
73
74
|
|
|
74
75
|
export interface ShortDateOptions {
|
|
75
|
-
/** "Jan
|
|
76
|
+
/** "5 Jan 2026" (the default), "5 Jan '26" as option expiries write it, or no year at all ("5 Jan"). */
|
|
76
77
|
year?: "numeric" | "2-digit" | false;
|
|
77
|
-
/** "2-digit" pads the day so dates line up in a column ("Jan
|
|
78
|
+
/** "2-digit" pads the day so dates line up in a column ("05 Jan"). */
|
|
78
79
|
day?: "numeric" | "2-digit";
|
|
79
80
|
/** Read the day in UTC, for date-only values that name a calendar day rather than an instant. */
|
|
80
81
|
utc?: boolean;
|
|
@@ -84,10 +85,20 @@ export interface ShortDateOptions {
|
|
|
84
85
|
|
|
85
86
|
const shortDateFormatters = new Map<string, Intl.DateTimeFormat>();
|
|
86
87
|
|
|
87
|
-
/**
|
|
88
|
+
/**
|
|
89
|
+
* A formatter's date written day first ("Fri 5 Jan 2026"). A two-digit year
|
|
90
|
+
* takes an apostrophe ("5 Jan '26"), so it never reads as another day.
|
|
91
|
+
*/
|
|
92
|
+
export function dayFirstParts(formatter: Intl.DateTimeFormat, date: Date): string {
|
|
93
|
+
const parts = Object.fromEntries(formatter.formatToParts(date).map((part) => [part.type, part.value]));
|
|
94
|
+
const year = parts.year ? ` ${parts.year.length === 2 ? `'${parts.year}` : parts.year}` : "";
|
|
95
|
+
return `${parts.weekday ? `${parts.weekday} ` : ""}${parts.day} ${parts.month}${year}`;
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/** A day-first month-name date such as "5 Jan 2026", in local time unless `utc` is set. */
|
|
88
99
|
export function formatShortDate(value: DisplayDateValue, options: ShortDateOptions = {}): string {
|
|
89
100
|
const date = parseDisplayDate(value);
|
|
90
|
-
if (!date) return options.fallback ??
|
|
101
|
+
if (!date) return options.fallback ?? MISSING_VALUE;
|
|
91
102
|
const { year = "numeric", day = "numeric", utc = false } = options;
|
|
92
103
|
const key = `${year}:${day}:${utc}`;
|
|
93
104
|
let formatter = shortDateFormatters.get(key);
|
|
@@ -100,11 +111,26 @@ export function formatShortDate(value: DisplayDateValue, options: ShortDateOptio
|
|
|
100
111
|
});
|
|
101
112
|
shortDateFormatters.set(key, formatter);
|
|
102
113
|
}
|
|
103
|
-
return formatter
|
|
114
|
+
return dayFirstParts(formatter, date);
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
const weekdayDayFormatters = new Map<string, Intl.DateTimeFormat>();
|
|
118
|
+
|
|
119
|
+
/** A weekday and day-first date ("Fri 16 Oct"), with a year only when asked for. */
|
|
120
|
+
export function formatWeekdayDay(value: DisplayDateValue, { timeZone, year = false }: { timeZone?: string; year?: boolean } = {}): string {
|
|
121
|
+
const date = parseDisplayDate(value);
|
|
122
|
+
if (!date) return MISSING_VALUE;
|
|
123
|
+
const key = `${timeZone ?? ""}:${year}`;
|
|
124
|
+
let formatter = weekdayDayFormatters.get(key);
|
|
125
|
+
if (!formatter) {
|
|
126
|
+
formatter = new Intl.DateTimeFormat("en-US", { weekday: "short", day: "numeric", month: "short", year: year ? "numeric" : undefined, timeZone });
|
|
127
|
+
weekdayDayFormatters.set(key, formatter);
|
|
128
|
+
}
|
|
129
|
+
return dayFirstParts(formatter, date);
|
|
104
130
|
}
|
|
105
131
|
|
|
106
132
|
/**
|
|
107
|
-
* The day a filing is dated, as the agency and the filer write it: "Nov
|
|
133
|
+
* The day a filing is dated, as the agency and the filer write it: "04 Nov
|
|
108
134
|
* 2026", the day padded so a column of them lines up. A calendar day, read in
|
|
109
135
|
* UTC, so it never moves with the viewer's zone: give it the filing date
|
|
110
136
|
* (`2026-11-04`, or that day at midnight UTC), not an acceptance instant,
|
|
@@ -151,14 +177,14 @@ function utcMidnight(date: Date): number {
|
|
|
151
177
|
/**
|
|
152
178
|
* When a feed item was published, in local time, as a newswire prints it:
|
|
153
179
|
* the time today ("14:32"), the weekday and time over the six days before
|
|
154
|
-
* ("Mon 09:10"), and the date for anything older ("Sep
|
|
180
|
+
* ("Mon 09:10"), and the date for anything older ("18 Sep", or "18 Sep '25"
|
|
155
181
|
* in another year). A weekday never names a day a week or more back. With
|
|
156
182
|
* `utc`, the same in UTC, for a column whose header names the zone.
|
|
157
183
|
*/
|
|
158
184
|
export function formatFeedTime(
|
|
159
185
|
value: DisplayDateValue,
|
|
160
186
|
now = Date.now(),
|
|
161
|
-
fallback =
|
|
187
|
+
fallback = MISSING_VALUE,
|
|
162
188
|
{ utc = false, dayToday = false }: {
|
|
163
189
|
utc?: boolean;
|
|
164
190
|
/** Today's time carries its weekday too ("Sat 00:47"), for a column whose other rows name theirs ("Fri 21:00"). */
|
|
@@ -178,42 +204,57 @@ export function formatFeedTime(
|
|
|
178
204
|
}
|
|
179
205
|
|
|
180
206
|
/**
|
|
181
|
-
* A date and time in the host's zone, with the zone named: "Oct
|
|
182
|
-
*
|
|
207
|
+
* A date and time in the host's zone, with the zone named: "7 Oct 2026,
|
|
208
|
+
* 23:38 CET", "... 17:38 ET", "... 21:38 UTC". Without the zone a
|
|
183
209
|
* time read beside a list in UTC looks two hours off.
|
|
184
210
|
*/
|
|
185
|
-
export function formatDetailDate(value: DisplayDateValue, fallback =
|
|
211
|
+
export function formatDetailDate(value: DisplayDateValue, fallback = MISSING_VALUE, timeZone?: string): string {
|
|
186
212
|
const date = parseDisplayDate(value);
|
|
187
213
|
if (!date) return fallback;
|
|
188
214
|
|
|
189
|
-
const datePart =
|
|
215
|
+
const datePart = dayFirstParts(new Intl.DateTimeFormat("en-US", {
|
|
190
216
|
month: "short",
|
|
191
217
|
day: "numeric",
|
|
192
218
|
year: "numeric",
|
|
193
219
|
timeZone,
|
|
194
|
-
});
|
|
195
|
-
return `${datePart}
|
|
220
|
+
}), date);
|
|
221
|
+
return `${datePart}, ${formatDetailTime(date, fallback, timeZone)}`;
|
|
196
222
|
}
|
|
197
223
|
|
|
198
224
|
/**
|
|
199
|
-
* The host's zone as a time beside it names it
|
|
200
|
-
*
|
|
201
|
-
*
|
|
225
|
+
* The host's zone as a time beside it names it, for a column header over times
|
|
226
|
+
* in that zone ("TIME CET"), as `formatDetailTime` names it after one time:
|
|
227
|
+
* the name the charts and session lines give it at that time ("UTC", "ET",
|
|
228
|
+
* "CET" or "CEST", "JST", else the city). News read "TIME GMT+1" over a
|
|
229
|
+
* chart's "CET" (review, 12 Nov 2026).
|
|
202
230
|
*/
|
|
203
231
|
export function localTimeZoneShortName(now: DisplayDateValue = Date.now(), timeZone?: string): string {
|
|
204
|
-
const
|
|
205
|
-
return
|
|
206
|
-
.find((part) => part.type === "timeZoneName")?.value ?? "UTC";
|
|
232
|
+
const zone = timeZone ?? new Intl.DateTimeFormat().resolvedOptions().timeZone ?? "UTC";
|
|
233
|
+
return timeZoneLabel(zone, (parseDisplayDate(now) ?? new Date()).getTime());
|
|
207
234
|
}
|
|
208
235
|
|
|
209
|
-
|
|
210
|
-
|
|
236
|
+
const zonedClockFormatters = new Map<string, Intl.DateTimeFormat>();
|
|
237
|
+
|
|
238
|
+
/**
|
|
239
|
+
* A time of day on the 24-hour clock every pane reads ("09:05", "23:38"), in
|
|
240
|
+
* the host's zone unless `timeZone` is given. Never AM/PM: one footer read
|
|
241
|
+
* "8:30 AM" beside another's "14:32" (review, 12 Nov 2026).
|
|
242
|
+
*/
|
|
243
|
+
export function formatClockTime(value: DisplayDateValue, fallback = MISSING_VALUE, timeZone?: string): string {
|
|
211
244
|
const date = parseDisplayDate(value);
|
|
212
245
|
if (!date) return fallback;
|
|
213
|
-
return
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
timeZone,
|
|
218
|
-
}
|
|
246
|
+
if (!timeZone) return clockFormatter.format(date);
|
|
247
|
+
let formatter = zonedClockFormatters.get(timeZone);
|
|
248
|
+
if (!formatter) {
|
|
249
|
+
formatter = new Intl.DateTimeFormat("en-US", { hour: "2-digit", minute: "2-digit", hourCycle: "h23", timeZone });
|
|
250
|
+
zonedClockFormatters.set(timeZone, formatter);
|
|
251
|
+
}
|
|
252
|
+
return formatter.format(date);
|
|
253
|
+
}
|
|
254
|
+
|
|
255
|
+
/** The time of `formatDetailDate` alone, its zone named: "23:38 CET", for a day stated beside it. */
|
|
256
|
+
export function formatDetailTime(value: DisplayDateValue, fallback = MISSING_VALUE, timeZone?: string): string {
|
|
257
|
+
const date = parseDisplayDate(value);
|
|
258
|
+
if (!date) return fallback;
|
|
259
|
+
return `${formatClockTime(date, fallback, timeZone)} ${localTimeZoneShortName(date, timeZone)}`;
|
|
219
260
|
}
|