gloomberb 0.20.2 → 0.20.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/README.zh-CN.md +1 -1
- package/package.json +2 -1
- package/src/account/auth-form.tsx +13 -8
- package/src/account/upgrade-dialog.tsx +1 -1
- package/src/api-client/central-bank-rates.ts +5 -0
- package/src/api-client/data.ts +17 -4
- package/src/api-client/debt-maturities.ts +45 -2
- package/src/api-client/earnings.ts +4 -2
- package/src/api-client/errors.ts +21 -11
- package/src/api-client/index.ts +1 -0
- package/src/api-client/paths.ts +9 -1
- package/src/api-client/social-mentions.ts +47 -0
- package/src/api-client/types/econ.ts +4 -0
- package/src/app.tsx +11 -1
- package/src/cli/command-options.ts +2 -1
- package/src/cli/commands/market.ts +111 -29
- package/src/cli/commands/options-chain.ts +23 -6
- package/src/cli/commands/overview.ts +13 -5
- package/src/cli/commands/plugins.ts +49 -18
- package/src/cli/commands/search.ts +25 -6
- package/src/cli/commands/ticker.ts +4 -2
- package/src/cli/fx-quote-rate.ts +49 -1
- package/src/cli/glossary.ts +95 -15
- package/src/cli/history-rows.ts +9 -25
- package/src/cli/index.ts +6 -38
- package/src/cli/known-gaps.ts +3 -3
- package/src/cli/listing-arg.ts +78 -18
- package/src/cli/name-entries.ts +3 -2
- package/src/cli/not-a-ticker.ts +6 -2
- package/src/cli/pane-functions/capabilities.ts +12 -1
- package/src/cli/pane-functions/function-help.ts +23 -11
- package/src/cli/pane-functions/headless.ts +3 -1
- package/src/cli/pane-functions/index.ts +32 -4
- package/src/cli/pane-functions/market-session.ts +8 -3
- package/src/cli/pane-functions/resolver.ts +18 -11
- package/src/cli/pane-functions/screenshot-payload.ts +36 -6
- package/src/cli/pane-functions/screenshot-render.ts +4 -0
- package/src/cli/quote-answer.ts +10 -0
- package/src/cli/report-tables.ts +22 -2
- package/src/cli/result.ts +7 -3
- package/src/cli/spreadsheet-hint.ts +43 -0
- package/src/cli/symbol-list.ts +58 -4
- package/src/cli/symbol-rows.ts +49 -2
- package/src/cli/ticker-resolution.ts +98 -5
- package/src/cli/unknown-command.ts +88 -0
- package/src/components/command-bar/assist/model.ts +6 -1
- package/src/components/command-bar/commands/direct/index.ts +9 -1
- package/src/components/command-bar/commands/registry.ts +18 -0
- package/src/components/command-bar/pane-actions.ts +30 -13
- package/src/components/command-bar/panel/index.tsx +6 -3
- package/src/components/command-bar/panel/prompt-binding.ts +4 -0
- package/src/components/command-bar/panel/types.ts +3 -0
- package/src/components/command-bar/routes/header-market.ts +108 -0
- package/src/components/command-bar/routes/root/command-items.ts +5 -0
- package/src/components/command-bar/routes/root/provider-search.ts +190 -32
- package/src/components/command-bar/routes/root/results.ts +3 -0
- package/src/components/command-bar/routes/root/runtime.ts +28 -5
- package/src/components/command-bar/routes/ticker-search/results.ts +53 -6
- package/src/components/command-bar/routing/list-state.ts +38 -0
- package/src/components/command-bar/selection-hint.ts +28 -0
- package/src/components/command-bar/surface/index.tsx +41 -3
- package/src/components/command-bar/view-model.ts +15 -0
- package/src/components/command-bar/workflow/tickers.ts +3 -2
- package/src/components/company-logo.tsx +20 -2
- package/src/components/data-table/export.ts +13 -8
- package/src/components/feedback-dialog.tsx +2 -1
- package/src/components/form-modal/field-row.tsx +2 -1
- package/src/components/input-search-bar.tsx +2 -2
- package/src/components/layout/double-escape-close.ts +8 -5
- package/src/components/layout/header.tsx +75 -44
- package/src/components/layout/market-summary.ts +322 -116
- package/src/components/layout/pane/footer/index.tsx +26 -8
- package/src/components/layout/pane/footer/model.ts +46 -20
- package/src/components/layout/pane/header.tsx +3 -2
- package/src/components/layout/shell/chrome.ts +15 -15
- package/src/components/layout/status-bar.tsx +8 -7
- package/src/components/layout/status-widget-space.ts +8 -0
- package/src/components/markdown-editor.tsx +2 -2
- package/src/components/onboarding/account-step/form-panel.tsx +0 -3
- package/src/components/onboarding/onboarding-keyboard.ts +15 -6
- package/src/components/onboarding/onboarding-wizard.tsx +61 -11
- package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
- package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
- package/src/components/price-sparkline/model.ts +26 -10
- package/src/components/ticker/list-table-view.tsx +29 -4
- package/src/components/ui/button.tsx +13 -2
- package/src/components/ui/column-grid.tsx +18 -9
- package/src/components/ui/data-table/index.tsx +1 -1
- package/src/components/ui/data-table/opentui/index.tsx +2 -1
- package/src/components/ui/data-table/types.ts +18 -0
- package/src/components/ui/delayed-mark.tsx +3 -2
- package/src/components/ui/field-grid.tsx +0 -2
- package/src/components/ui/fields.tsx +7 -4
- package/src/components/ui/inline-quick-add.tsx +2 -2
- package/src/components/ui/key-hint-words.ts +153 -0
- package/src/components/ui/key-hints.tsx +73 -0
- package/src/components/ui/menu.tsx +3 -1
- package/src/components/ui/message-composer.tsx +2 -2
- package/src/components/ui/shortcut-hint.tsx +28 -3
- package/src/components/ui/tabs.tsx +7 -0
- package/src/components/ui/text-prompt-dialog.tsx +2 -1
- package/src/core/state/app/command-bar-launch.ts +3 -0
- package/src/data/config/store/normalize.ts +6 -0
- package/src/docs/snapshot.json +120 -69
- package/src/i18n/es.ts +24 -1
- package/src/i18n/ja.ts +24 -1
- package/src/i18n/ko.ts +24 -1
- package/src/i18n/zh-cn.ts +24 -1
- package/src/i18n/zh-tw.ts +24 -1
- package/src/layout/pane-manager/gridlock.ts +11 -0
- package/src/market-data/bars-per-year.ts +27 -9
- package/src/market-data/coordinator/quotes.ts +22 -3
- package/src/market-data/futures-board.ts +80 -0
- package/src/market-data/futures-contract.ts +9 -3
- package/src/market-data/market/change-basis.ts +2 -2
- package/src/market-data/market/dated-previous-close.ts +163 -47
- package/src/market-data/market/format.ts +14 -3
- package/src/market-data/market/freshness.ts +24 -7
- package/src/market-data/market/header-market.ts +154 -0
- package/src/market-data/market/index-level.ts +29 -0
- package/src/market-data/market/index-session-venues.ts +44 -0
- package/src/market-data/market/status.ts +7 -2
- package/src/market-data/market/venue-session.ts +72 -0
- package/src/market-data/model-dividend-yield.ts +23 -8
- package/src/market-data/options-alternatives.ts +39 -4
- package/src/market-data/published-apac-sessions.ts +40 -2
- package/src/market-data/quotes/export-identity.ts +76 -0
- package/src/market-data/quotes/freshness.ts +22 -0
- package/src/market-data/quotes/time.ts +42 -1
- package/src/market-data/realized-volatility.ts +11 -7
- package/src/market-data/tax-equivalent.ts +145 -27
- package/src/plugins/builtin/account-management/pane.tsx +2 -2
- package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
- package/src/plugins/builtin/alerts/alert-log.ts +6 -2
- package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
- package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
- package/src/plugins/builtin/alerts/cli-move.ts +234 -0
- package/src/plugins/builtin/alerts/cli.ts +224 -33
- package/src/plugins/builtin/alerts/command.ts +33 -6
- package/src/plugins/builtin/alerts/event-rows.ts +18 -4
- package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
- package/src/plugins/builtin/alerts/events.ts +9 -0
- package/src/plugins/builtin/alerts/format.ts +40 -15
- package/src/plugins/builtin/alerts/headless.ts +31 -18
- package/src/plugins/builtin/alerts/history.ts +1 -0
- package/src/plugins/builtin/alerts/index.tsx +86 -12
- package/src/plugins/builtin/alerts/live.ts +2 -1
- package/src/plugins/builtin/alerts/move-checks.ts +155 -0
- package/src/plugins/builtin/alerts/move.ts +160 -0
- package/src/plugins/builtin/alerts/pane.tsx +52 -22
- package/src/plugins/builtin/alerts/price-text.ts +62 -0
- package/src/plugins/builtin/alerts/price.ts +17 -0
- package/src/plugins/builtin/alerts/quotes.ts +84 -3
- package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
- package/src/plugins/builtin/alerts/storage.ts +20 -7
- package/src/plugins/builtin/alerts/types.ts +13 -0
- package/src/plugins/builtin/analytics/risk-client.ts +60 -39
- package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
- package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
- package/src/plugins/builtin/analytics/risk-model.ts +68 -1
- package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
- package/src/plugins/builtin/backtest/engine.ts +4 -2
- package/src/plugins/builtin/backtest/window.ts +3 -1
- package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
- package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
- package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
- package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
- package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
- package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
- package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
- package/src/plugins/builtin/chart-composer/headless.ts +2 -0
- package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
- package/src/plugins/builtin/crypto-board/headless.ts +82 -17
- package/src/plugins/builtin/crypto-board/index.tsx +24 -2
- package/src/plugins/builtin/crypto-board/model.ts +5 -2
- package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
- package/src/plugins/builtin/debt-maturities/client.ts +111 -6
- package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
- package/src/plugins/builtin/debt-maturities/model.ts +97 -14
- package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
- package/src/plugins/builtin/debt-maturities/series.ts +3 -1
- package/src/plugins/builtin/dividend-yield/client.ts +22 -6
- package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
- package/src/plugins/builtin/dividend-yield/model.ts +5 -2
- package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
- package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
- package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
- package/src/plugins/builtin/dividend-yield/types.ts +2 -0
- package/src/plugins/builtin/dividend-yield/view.ts +3 -0
- package/src/plugins/builtin/econ/calendar-model.ts +21 -3
- package/src/plugins/builtin/econ/detail-view.tsx +5 -3
- package/src/plugins/builtin/econ/figures.ts +13 -0
- package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
- package/src/plugins/builtin/econ/index.tsx +5 -3
- package/src/plugins/builtin/econ/types.ts +5 -0
- package/src/plugins/builtin/equity-screener/footer.ts +45 -0
- package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
- package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
- package/src/plugins/builtin/fixed-income/model.ts +1 -0
- package/src/plugins/builtin/futures/table.tsx +1 -1
- package/src/plugins/builtin/futures-curve/model.ts +3 -10
- package/src/plugins/builtin/help/function-card.tsx +2 -1
- package/src/plugins/builtin/help/function-index.ts +1 -0
- package/src/plugins/builtin/insider/client.ts +31 -14
- package/src/plugins/builtin/insider/signals-model.ts +2 -7
- package/src/plugins/builtin/iv-history/headless.ts +1 -2
- package/src/plugins/builtin/iv-history/model.ts +33 -23
- package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
- package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
- package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
- package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
- package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
- package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
- package/src/plugins/builtin/news/index.tsx +7 -13
- package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
- package/src/plugins/builtin/news/ticker-news.ts +35 -0
- package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
- package/src/plugins/builtin/news/wire/news/row.ts +49 -0
- package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
- package/src/plugins/builtin/options/analytics.ts +7 -2
- package/src/plugins/builtin/options/live-quotes.ts +6 -1
- package/src/plugins/builtin/options/table.ts +3 -2
- package/src/plugins/builtin/options/view.tsx +11 -9
- package/src/plugins/builtin/options-scenario/client.ts +3 -0
- package/src/plugins/builtin/options-scenario/headless.ts +1 -1
- package/src/plugins/builtin/perps/client.ts +5 -4
- package/src/plugins/builtin/perps/headless.ts +134 -124
- package/src/plugins/builtin/perps/markets-section.tsx +2 -2
- package/src/plugins/builtin/perps/model.ts +8 -4
- package/src/plugins/builtin/perps/open-market.ts +4 -4
- package/src/plugins/builtin/perps/venue-markets.ts +3 -6
- package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
- package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
- package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
- package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
- package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
- package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
- package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
- package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
- package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
- package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
- package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
- package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
- package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
- package/src/plugins/builtin/realized-vol/headless.ts +44 -8
- package/src/plugins/builtin/realized-vol/model.ts +9 -5
- package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
- package/src/plugins/builtin/sec/headless.ts +48 -6
- package/src/plugins/builtin/sec/index.tsx +6 -4
- package/src/plugins/builtin/sec/model.ts +4 -1
- package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
- package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
- package/src/plugins/builtin/shared/report-freshness.ts +3 -1
- package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
- package/src/plugins/builtin/shared/volatility/options.ts +63 -2
- package/src/plugins/builtin/social-mentions/headless.ts +72 -3
- package/src/plugins/builtin/social-mentions/index.tsx +8 -4
- package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
- package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
- package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
- package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
- package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
- package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
- package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
- package/src/plugins/builtin/thirteenf/api.ts +36 -2
- package/src/plugins/builtin/thirteenf/data.ts +4 -1
- package/src/plugins/builtin/thirteenf/headless.ts +14 -6
- package/src/plugins/builtin/thirteenf/model.ts +56 -1
- package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
- package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
- package/src/plugins/builtin/thirteenf/table.ts +2 -1
- package/src/plugins/builtin/thirteenf/types.ts +6 -0
- package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
- package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
- package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
- package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
- package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
- package/src/plugins/builtin/ticker-detail/overview/components.tsx +13 -1
- package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
- package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
- package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
- package/src/plugins/builtin/ticker-detail/overview-tab.tsx +41 -6
- package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
- package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
- package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
- package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
- package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
- package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
- package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
- package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
- package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
- package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
- package/src/plugins/builtin/world-indices/client.ts +2 -0
- package/src/plugins/compat.ts +15 -0
- package/src/plugins/host-link.ts +6 -1
- package/src/plugins/installer.ts +8 -3
- package/src/portfolio/column-values.ts +14 -4
- package/src/portfolio/listed-symbol.ts +78 -0
- package/src/portfolio/real-return.ts +172 -0
- package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
- package/src/renderers/browser/config-host.ts +56 -15
- package/src/renderers/browser/main.tsx +3 -1
- package/src/renderers/browser/ui-host.tsx +1 -0
- package/src/renderers/cloudflare/http-proxy.ts +1 -0
- package/src/renderers/dom/boot-frame.ts +2 -2
- package/src/renderers/dom/data-table/row.tsx +4 -1
- package/src/renderers/dom/desktop/controls.tsx +4 -4
- package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
- package/src/renderers/dom/dom-ui-host.tsx +3 -1
- package/src/renderers/dom/host/input.tsx +4 -1
- package/src/renderers/dom/host/tabs.tsx +10 -1
- package/src/renderers/dom/styles.css +33 -13
- package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
- package/src/renderers/opentui/host.tsx +2 -1
- package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
- package/src/sources/gloomberb-cloud/index.ts +31 -2
- package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
- package/src/sources/provider-router/cached-routes.ts +19 -7
- package/src/state/pane-table-export-registry.ts +19 -6
- package/src/test-support/preload.ts +5 -1
- package/src/theme/colors.ts +9 -1
- package/src/theme/themes.ts +62 -15
- package/src/theme/tone-contrast.ts +40 -0
- package/src/theme/ui-tokens.ts +23 -3
- package/src/tickers/batched-lookups.ts +57 -8
- package/src/tickers/company-name-listing.ts +156 -14
- package/src/tickers/company-name.ts +30 -6
- package/src/tickers/list.ts +7 -0
- package/src/tickers/search/home-listing.ts +31 -9
- package/src/tickers/search/index.ts +13 -3
- package/src/tickers/search/listing-index.ts +558 -0
- package/src/tickers/search/major-listings.chunk.ts +10 -0
- package/src/tickers/search/major-listings.json +3346 -0
- package/src/tickers/search/ranking.ts +68 -1
- package/src/tickers/search/types.ts +4 -0
- package/src/tickers/terminal-codes.ts +26 -1
- package/src/time-series/calendar-month-returns.ts +47 -0
- package/src/time-series/currency-conversion.ts +130 -0
- package/src/time-series/hooks.ts +2 -0
- package/src/time-series/price-comparison.ts +34 -11
- package/src/time-series/resolve-context.ts +3 -0
- package/src/time-series/resolve.ts +14 -2
- package/src/time-series/spec.ts +1 -0
- package/src/time-series/studies/indicators.ts +4 -1
- package/src/time-series/types.ts +8 -0
- package/src/types/config.ts +8 -0
- package/src/types/data-provider.ts +28 -0
- package/src/types/financials.ts +20 -2
- package/src/types/headless.ts +12 -0
- package/src/ui/host.tsx +8 -0
- package/src/utils/datetime-format.ts +17 -3
- package/src/utils/display-number.ts +15 -0
- package/src/utils/double-escape-close.ts +61 -16
- package/src/utils/float32-price.ts +24 -0
- package/src/utils/forward-dividend.ts +81 -16
- package/src/utils/fx-market-hours.ts +11 -0
- package/src/utils/plugin-proxy-hosts.json +2 -1
- package/src/utils/price-history.ts +7 -6
- package/src/utils/report-timing.ts +62 -0
- package/src/utils/sec-filings.ts +32 -0
- package/src/utils/utc-time.ts +5 -0
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { apiClient } from "../../../api-client";
|
|
2
2
|
import type {
|
|
3
|
+
DebtBand,
|
|
3
4
|
DebtFact,
|
|
4
5
|
DebtMaturitiesPayload,
|
|
5
6
|
DebtMetric,
|
|
@@ -18,7 +19,9 @@ import {
|
|
|
18
19
|
export const debtMaturitiesCache = createPluginCache<DebtMaturitiesPayload>({
|
|
19
20
|
kind: "debt-maturities",
|
|
20
21
|
source: "gloom-cloud",
|
|
21
|
-
|
|
22
|
+
// 2: payloads that can hold a schedule in its filing's own bands, so an
|
|
23
|
+
// answer cached before them (one that left the schedule out) is asked again.
|
|
24
|
+
schemaVersion: 2,
|
|
22
25
|
policy: { staleMs: 6 * 60 * 60_000, expireMs: 14 * 24 * 60 * 60_000 },
|
|
23
26
|
});
|
|
24
27
|
export const BUCKET_IDS = [
|
|
@@ -60,6 +63,11 @@ const currency = (value: unknown) =>
|
|
|
60
63
|
const sourceUrl = (value: unknown) =>
|
|
61
64
|
typeof value === "string" &&
|
|
62
65
|
/^https:\/\/(?:www\.|data\.)?sec\.gov\//.test(value);
|
|
66
|
+
/** A report's own page or document, wherever it is published. */
|
|
67
|
+
const httpsUrl = (value: unknown) =>
|
|
68
|
+
typeof value === "string" && URL.canParse(value) && new URL(value).protocol === "https:";
|
|
69
|
+
/** SEC's annual forms a schedule by year is read from. */
|
|
70
|
+
const ANNUAL_FORM = /^(10-K|20-F|40-F)(\/A)?$/;
|
|
63
71
|
const near = (a: number | null, b: number | null) =>
|
|
64
72
|
a === b ||
|
|
65
73
|
(a !== null &&
|
|
@@ -79,7 +87,7 @@ function validFact(fact: DebtFact): boolean {
|
|
|
79
87
|
fact.end <= fact.filed &&
|
|
80
88
|
(fact.start === null || fact.start <= fact.end) &&
|
|
81
89
|
accession(fact.accession) &&
|
|
82
|
-
|
|
90
|
+
ANNUAL_FORM.test(fact.form)
|
|
83
91
|
);
|
|
84
92
|
}
|
|
85
93
|
function validMetric(
|
|
@@ -164,6 +172,8 @@ export function validateDebtMaturities(
|
|
|
164
172
|
data: DebtMaturitiesPayload,
|
|
165
173
|
symbol: string,
|
|
166
174
|
): DebtMaturitiesPayload {
|
|
175
|
+
if (data?.version === 2 && typeof data.latest === "object" && data.latest !== null && "sourceBuckets" in data.latest)
|
|
176
|
+
return validateBands(data, symbol);
|
|
167
177
|
if (!data || typeof data !== "object" || !("latestQuarter" in data)) return validateSchedule(data, symbol);
|
|
168
178
|
const { latestQuarter, ...schedule } = data;
|
|
169
179
|
const valid = validateSchedule(schedule, symbol);
|
|
@@ -177,13 +187,17 @@ function validateSchedule(
|
|
|
177
187
|
const invalid = (): never => {
|
|
178
188
|
throw new Error("The server returned an invalid debt maturity schedule");
|
|
179
189
|
};
|
|
190
|
+
// Version 2 answers a schedule in its filing's own bands (validateBands),
|
|
191
|
+
// and a company with none as version 1 does, under any standard and with
|
|
192
|
+
// the report's link, or none.
|
|
193
|
+
const v2 = data?.version === 2;
|
|
180
194
|
if (
|
|
181
195
|
!data ||
|
|
182
|
-
data.version !== 1 ||
|
|
196
|
+
(data.version !== 1 && !v2) ||
|
|
183
197
|
data.symbol !== symbol ||
|
|
184
198
|
!["available", "partial", "unavailable"].includes(data.status) ||
|
|
185
199
|
!textOrNull(data.entityName) ||
|
|
186
|
-
!["us-gaap", null].includes(data.taxonomy) ||
|
|
200
|
+
!(v2 && data.latest === null ? ["us-gaap", "ifrs-full", "cn-cas", null] : ["us-gaap", null]).includes(data.taxonomy) ||
|
|
187
201
|
!(
|
|
188
202
|
data.cik === null ||
|
|
189
203
|
(typeof data.cik === "string" && /^\d{10}$/.test(data.cik))
|
|
@@ -193,7 +207,7 @@ function validateSchedule(
|
|
|
193
207
|
!nullableDay(data.asOf) ||
|
|
194
208
|
!data.source ||
|
|
195
209
|
typeof data.source.name !== "string" ||
|
|
196
|
-
!sourceUrl(data.source.url) ||
|
|
210
|
+
!(sourceUrl(data.source.url) || (v2 && data.latest === null && (data.source.url === "" || httpsUrl(data.source.url)))) ||
|
|
197
211
|
typeof data.source.cadence !== "string" ||
|
|
198
212
|
!Array.isArray(data.warnings) ||
|
|
199
213
|
data.warnings.some((value) => typeof value !== "string") ||
|
|
@@ -220,7 +234,7 @@ function validateSchedule(
|
|
|
220
234
|
!day(latest.filed) ||
|
|
221
235
|
latest.asOf > latest.filed ||
|
|
222
236
|
!accession(latest.accession) ||
|
|
223
|
-
|
|
237
|
+
!ANNUAL_FORM.test(latest.form) ||
|
|
224
238
|
!currency(latest.currency) ||
|
|
225
239
|
!sourceUrl(latest.filingUrl) ||
|
|
226
240
|
typeof latest.complete !== "boolean" ||
|
|
@@ -385,6 +399,91 @@ function validateSchedule(
|
|
|
385
399
|
return data;
|
|
386
400
|
}
|
|
387
401
|
|
|
402
|
+
/** A report's accession (an SEC one, HKEX-2026040800985, a receipt number) and form (20-F, HKEX, ESEF). */
|
|
403
|
+
const reportAccession = (value: unknown) => typeof value === "string" && /^[A-Za-z0-9][A-Za-z0-9-]{0,79}$/.test(value);
|
|
404
|
+
const reportForm = (value: unknown) => typeof value === "string" && /^[A-Z0-9][A-Z0-9/-]{1,11}$/.test(value);
|
|
405
|
+
const BAND_TAXONOMIES: readonly unknown[] = ["ifrs-full", "cn-cas"];
|
|
406
|
+
const AMOUNT_BASES: readonly unknown[] = ["principal", "carrying", "contractual_undiscounted"];
|
|
407
|
+
|
|
408
|
+
/**
|
|
409
|
+
* Bands that cover the schedule from the balance-sheet date on, in order,
|
|
410
|
+
* each starting where the last ended; only the last may be open ended.
|
|
411
|
+
*/
|
|
412
|
+
function validBands(bands: readonly DebtBand[]): boolean {
|
|
413
|
+
let from = 0;
|
|
414
|
+
for (const [index, band] of bands.entries()) {
|
|
415
|
+
if (
|
|
416
|
+
!band ||
|
|
417
|
+
typeof band.label !== "string" ||
|
|
418
|
+
!band.label.trim() ||
|
|
419
|
+
!number(band.value) ||
|
|
420
|
+
band.fromMonths !== from ||
|
|
421
|
+
!Array.isArray(band.members) ||
|
|
422
|
+
band.members.some((member) => typeof member !== "string") ||
|
|
423
|
+
(band.toMonths === null
|
|
424
|
+
? index !== bands.length - 1
|
|
425
|
+
: !Number.isInteger(band.toMonths) || band.toMonths <= band.fromMonths)
|
|
426
|
+
)
|
|
427
|
+
return false;
|
|
428
|
+
from = band.toMonths ?? from;
|
|
429
|
+
}
|
|
430
|
+
return bands.length > 0;
|
|
431
|
+
}
|
|
432
|
+
|
|
433
|
+
/**
|
|
434
|
+
* A schedule in its filing's own bands (version 2): an IFRS or China CAS
|
|
435
|
+
* ladder, as reported, with what its amounts are and the report it came
|
|
436
|
+
* from. Its yearly buckets and principal figures are not read, so they are
|
|
437
|
+
* not checked; a 10-Q beside it is not read either.
|
|
438
|
+
*/
|
|
439
|
+
function validateBands(data: DebtMaturitiesPayload, symbol: string): DebtMaturitiesPayload {
|
|
440
|
+
const latest = data.latest!;
|
|
441
|
+
const bands = latest.sourceBuckets;
|
|
442
|
+
const interest = latest.interestExpenseFact;
|
|
443
|
+
const source = latest.source;
|
|
444
|
+
if (
|
|
445
|
+
data.symbol !== symbol ||
|
|
446
|
+
!["available", "partial"].includes(data.status) ||
|
|
447
|
+
!textOrNull(data.entityName) ||
|
|
448
|
+
!BAND_TAXONOMIES.includes(data.taxonomy) ||
|
|
449
|
+
latest.taxonomy !== data.taxonomy ||
|
|
450
|
+
!(data.cik === null || (typeof data.cik === "string" && /^\d{10}$/.test(data.cik))) ||
|
|
451
|
+
typeof data.fetchedAt !== "string" ||
|
|
452
|
+
!Number.isFinite(Date.parse(data.fetchedAt)) ||
|
|
453
|
+
!data.source ||
|
|
454
|
+
typeof data.source.name !== "string" ||
|
|
455
|
+
!httpsUrl(data.source.url) ||
|
|
456
|
+
typeof data.source.cadence !== "string" ||
|
|
457
|
+
!Array.isArray(data.warnings) ||
|
|
458
|
+
data.warnings.some((value) => typeof value !== "string") ||
|
|
459
|
+
!Array.isArray(data.history) ||
|
|
460
|
+
!day(latest.asOf) ||
|
|
461
|
+
latest.asOf !== data.asOf ||
|
|
462
|
+
!day(latest.filed) ||
|
|
463
|
+
latest.asOf > latest.filed ||
|
|
464
|
+
!reportAccession(latest.accession) ||
|
|
465
|
+
!reportForm(latest.form) ||
|
|
466
|
+
!currency(latest.currency) ||
|
|
467
|
+
!httpsUrl(latest.filingUrl) ||
|
|
468
|
+
!AMOUNT_BASES.includes(latest.amountBasis) ||
|
|
469
|
+
!Array.isArray(bands) ||
|
|
470
|
+
!validBands(bands) ||
|
|
471
|
+
!near(latest.sourceTotal ?? null, bands.reduce((sum, band) => sum + band.value, 0)) ||
|
|
472
|
+
(interest !== null &&
|
|
473
|
+
!(interest && number(interest.value) && typeof interest.tag === "string" && interest.unit === latest.currency &&
|
|
474
|
+
nullableDay(interest.start) && day(interest.end))) ||
|
|
475
|
+
(source != null &&
|
|
476
|
+
!(httpsUrl(source.url) && typeof source.concept === "string" && number(source.scale) && source.scale > 0 &&
|
|
477
|
+
typeof source.scaleStated === "boolean" &&
|
|
478
|
+
(source.reconciledTo == null ||
|
|
479
|
+
(typeof source.reconciledTo.concept === "string" && number(source.reconciledTo.value) &&
|
|
480
|
+
number(source.reconciledTo.ratio)))))
|
|
481
|
+
)
|
|
482
|
+
throw new Error("The server returned an invalid debt maturity schedule");
|
|
483
|
+
const { latestQuarter: _quarter, ...schedule } = data;
|
|
484
|
+
return schedule;
|
|
485
|
+
}
|
|
486
|
+
|
|
388
487
|
/** The symbol the server answers with: a listing abroad's bare symbol, otherwise the one sent. */
|
|
389
488
|
const answeredSymbol = (symbol: string, listing?: IssuerListingParams) =>
|
|
390
489
|
listingAbroad(symbol, listing?.exchange)?.symbol ?? symbol;
|
|
@@ -409,9 +508,15 @@ export async function fetchDebtMaturities(
|
|
|
409
508
|
);
|
|
410
509
|
} catch (error) {
|
|
411
510
|
if (abroad && error instanceof ApiRequestError && error.status === 404) return noSchedule(answered);
|
|
511
|
+
// The server sends its own payload with a 503 when no schedule could be
|
|
512
|
+
// read (SEC or the store failing): said in one line, its status kept so a
|
|
513
|
+
// saved copy still answers for it.
|
|
514
|
+
if (error instanceof ApiRequestError && (error.status ?? 0) >= 500)
|
|
515
|
+
throw new ApiRequestError(NOT_READ, error.status, error.retryAfterMs, error.code, error.details);
|
|
412
516
|
throw unavailableOnServer(error, "Debt maturities are not available yet.");
|
|
413
517
|
}
|
|
414
518
|
}
|
|
519
|
+
const NOT_READ = "No maturity schedule could be read for this listing.";
|
|
415
520
|
|
|
416
521
|
function noSchedule(symbol: string): DebtMaturitiesPayload {
|
|
417
522
|
return {
|
|
@@ -1,6 +1,11 @@
|
|
|
1
|
+
import type { DebtMaturitiesPayload } from "../../../api-client/debt-maturities";
|
|
2
|
+
import type { HeadlessBundleSection } from "../../../types/headless";
|
|
1
3
|
import type { HeadlessPaneDefinition } from "../../../types/plugin";
|
|
2
4
|
import { fetchDebtMaturities } from "./client";
|
|
3
|
-
import {
|
|
5
|
+
import {
|
|
6
|
+
bandScaleText, bandTotal, bucketShare, debtAmount, debtBands, debtBasis, debtCostProxyNote, debtHistoryRows, debtNewestAsOf,
|
|
7
|
+
debtNewestForm, debtNotices, debtPercent, debtStandard, maturityRows, newerQuarter, type DebtLatest,
|
|
8
|
+
} from "./model";
|
|
4
9
|
import { SEC_FILINGS } from "../shared/report-freshness";
|
|
5
10
|
import { resolveHeadlessIssuerListing } from "../shared/headless-market-data";
|
|
6
11
|
|
|
@@ -8,6 +13,72 @@ import { resolveHeadlessIssuerListing } from "../shared/headless-market-data";
|
|
|
8
13
|
const amount = (value: unknown) => debtAmount(typeof value === "number" ? value : null);
|
|
9
14
|
const percent = (value: unknown) => debtPercent(typeof value === "number" ? value : null);
|
|
10
15
|
|
|
16
|
+
/**
|
|
17
|
+
* A schedule in its filing's own bands, as the pane shows it: each band as
|
|
18
|
+
* reported with its share of their total, then the filing (standard, what the
|
|
19
|
+
* amounts are, how the report states them, the report's link). Exports name
|
|
20
|
+
* the basis on every row, so the amount column reads the same for every
|
|
21
|
+
* company; the text report heads it with the basis.
|
|
22
|
+
*/
|
|
23
|
+
function bandSections(data: DebtMaturitiesPayload, latest: DebtLatest): HeadlessBundleSection[] {
|
|
24
|
+
const basis = debtBasis(latest);
|
|
25
|
+
const standard = debtStandard(latest.taxonomy);
|
|
26
|
+
const columns = [
|
|
27
|
+
{ key: "label", header: "Maturity" },
|
|
28
|
+
{ key: "value", header: "Amount", align: "right" as const, textFormat: amount },
|
|
29
|
+
{ key: "currency", header: "Currency" },
|
|
30
|
+
{ key: "share", header: "% total", align: "right" as const, textFormat: percent },
|
|
31
|
+
{ key: "asOf", header: "As of" },
|
|
32
|
+
{ key: "filed", header: "Filed" },
|
|
33
|
+
];
|
|
34
|
+
const source = latest.source;
|
|
35
|
+
const check = source?.reconciledTo;
|
|
36
|
+
const filing: Array<[string, string | null | undefined]> = [
|
|
37
|
+
["Standard", standard],
|
|
38
|
+
["Basis", basis.detail ? `${basis.words} (${basis.detail})` : basis.words],
|
|
39
|
+
[basis.total, `${debtAmount(bandTotal(debtBands(latest)!))} ${latest.currency}`],
|
|
40
|
+
["Reported in", source ? bandScaleText(latest.currency, source.scale, source.scaleStated) : latest.currency],
|
|
41
|
+
["Form", latest.form],
|
|
42
|
+
["Accession", latest.accession],
|
|
43
|
+
["Table", source?.concept],
|
|
44
|
+
["Checked against", check ? `${check.concept} (${check.ratio.toFixed(2)}x)` : null],
|
|
45
|
+
["Lease liabilities", latest.includesLeases ? "Included" : null],
|
|
46
|
+
["Report", latest.filingUrl],
|
|
47
|
+
];
|
|
48
|
+
return [
|
|
49
|
+
{
|
|
50
|
+
title: "Maturity schedule as reported",
|
|
51
|
+
textTitle: `Maturity schedule as reported (${[basis.words, standard].filter(Boolean).join(", ")})`,
|
|
52
|
+
columns: [
|
|
53
|
+
...columns.slice(0, 2),
|
|
54
|
+
{ key: "basis", header: "Basis" },
|
|
55
|
+
{ key: "fromMonths", header: "From month" },
|
|
56
|
+
{ key: "toMonths", header: "To month" },
|
|
57
|
+
...columns.slice(2),
|
|
58
|
+
{ key: "readFrom", header: "Read from" },
|
|
59
|
+
],
|
|
60
|
+
textColumns: [columns[0]!, { ...columns[1]!, header: basis.amount }, ...columns.slice(2)],
|
|
61
|
+
rows: maturityRows(latest).map((row) => ({
|
|
62
|
+
label: row.label,
|
|
63
|
+
value: row.value,
|
|
64
|
+
basis: latest.amountBasis ?? "principal",
|
|
65
|
+
fromMonths: row.band!.fromMonths,
|
|
66
|
+
toMonths: row.band!.toMonths,
|
|
67
|
+
currency: latest.currency,
|
|
68
|
+
share: row.share,
|
|
69
|
+
asOf: latest.asOf,
|
|
70
|
+
filed: latest.filed,
|
|
71
|
+
readFrom: row.band!.members.join(" + "),
|
|
72
|
+
})),
|
|
73
|
+
},
|
|
74
|
+
{
|
|
75
|
+
title: "Filing",
|
|
76
|
+
columns: [{ key: "field", header: "Field" }, { key: "value", header: "Value" }],
|
|
77
|
+
rows: filing.flatMap(([field, value]) => (value ? [{ field, value }] : [])),
|
|
78
|
+
},
|
|
79
|
+
];
|
|
80
|
+
}
|
|
81
|
+
|
|
11
82
|
export const debtMaturitiesHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
12
83
|
shape: "bundle",
|
|
13
84
|
freshness: SEC_FILINGS,
|
|
@@ -45,6 +116,18 @@ export const debtMaturitiesHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
|
45
116
|
async load(args, ctx) {
|
|
46
117
|
const symbol = args.symbols[0]!;
|
|
47
118
|
const data = await fetchDebtMaturities(symbol, ctx.apiClient, await resolveHeadlessIssuerListing(ctx, symbol));
|
|
119
|
+
const latest = data.latest;
|
|
120
|
+
if (latest && debtBands(latest)) {
|
|
121
|
+
return {
|
|
122
|
+
complete: data.status === "available",
|
|
123
|
+
errors: debtNotices(data),
|
|
124
|
+
sections: bandSections(data, latest),
|
|
125
|
+
metadata: { ...data },
|
|
126
|
+
// Dated by the report's balance sheet: an SEC filing named by its form, a report outside SEC cited
|
|
127
|
+
// as the server names it (its form, HKEX or CNINFO, would repeat that name).
|
|
128
|
+
freshness: data.cik ? { asOf: latest.asOf, asOfLabel: latest.form } : { asOf: latest.asOf, source: data.source.name },
|
|
129
|
+
};
|
|
130
|
+
}
|
|
48
131
|
const quarter = newerQuarter(data);
|
|
49
132
|
const costNote = debtCostProxyNote(data.history);
|
|
50
133
|
return {
|
|
@@ -1,4 +1,6 @@
|
|
|
1
1
|
import type {
|
|
2
|
+
DebtAmountBasis,
|
|
3
|
+
DebtBand,
|
|
2
4
|
DebtHistoryPoint,
|
|
3
5
|
DebtMaturitiesPayload,
|
|
4
6
|
DebtMetric,
|
|
@@ -30,6 +32,79 @@ export function bucketShare(
|
|
|
30
32
|
? (100 * bucket.value) / total
|
|
31
33
|
: null;
|
|
32
34
|
}
|
|
35
|
+
/**
|
|
36
|
+
* The bands of a schedule read in its filing's own bands (within 1 year,
|
|
37
|
+
* 1 to 2 years, 2 to 5 years, after 5 years), exactly as reported; null for
|
|
38
|
+
* a schedule by fiscal year.
|
|
39
|
+
*/
|
|
40
|
+
export function debtBands(latest: DebtLatest | null | undefined): DebtBand[] | null {
|
|
41
|
+
return latest?.sourceBuckets?.length ? latest.sourceBuckets : null;
|
|
42
|
+
}
|
|
43
|
+
/** What a schedule's amounts are, as its table header, its total and its filing detail name them. */
|
|
44
|
+
const BASIS: Record<DebtAmountBasis, { column: string; amount: string; total: string; words: string; detail?: string }> = {
|
|
45
|
+
principal: { column: "PRINCIPAL", amount: "Principal", total: "Principal total", words: "Principal" },
|
|
46
|
+
carrying: { column: "CARRYING", amount: "Carrying amount", total: "Carrying total", words: "Carrying amounts" },
|
|
47
|
+
contractual_undiscounted: {
|
|
48
|
+
column: "CASH FLOWS",
|
|
49
|
+
amount: "Cash flows",
|
|
50
|
+
total: "Cash flows total",
|
|
51
|
+
words: "Contractual undiscounted cash flows",
|
|
52
|
+
detail: "principal and interest",
|
|
53
|
+
},
|
|
54
|
+
};
|
|
55
|
+
export const debtBasis = (latest: DebtLatest) => BASIS[latest.amountBasis ?? "principal"];
|
|
56
|
+
const STANDARDS: Record<string, string> = { "us-gaap": "US GAAP", "ifrs-full": "IFRS", "cn-cas": "China CAS" };
|
|
57
|
+
/** The accounting standard a schedule is drawn up under: `IFRS`, `China CAS`. */
|
|
58
|
+
export const debtStandard = (taxonomy: string | null | undefined) =>
|
|
59
|
+
taxonomy ? (STANDARDS[taxonomy] ?? taxonomy) : null;
|
|
60
|
+
/** The bands' sum: the schedule's total in its own basis. */
|
|
61
|
+
export const bandTotal = (bands: readonly DebtBand[]) => bands.reduce((sum, band) => sum + band.value, 0);
|
|
62
|
+
/**
|
|
63
|
+
* The share of the bands' total due within `months` of the balance-sheet
|
|
64
|
+
* date, only when the bands from the first end exactly there: a band that
|
|
65
|
+
* spans the point is never split, so there is then no share.
|
|
66
|
+
*/
|
|
67
|
+
export function bandsDueWithin(bands: readonly DebtBand[], months: number): number | null {
|
|
68
|
+
const end = bands.findIndex((band) => band.toMonths === months);
|
|
69
|
+
const total = bandTotal(bands);
|
|
70
|
+
if (end < 0 || bands[0]?.fromMonths !== 0 || total <= 0) return null;
|
|
71
|
+
return (100 * bandTotal(bands.slice(0, end + 1))) / total;
|
|
72
|
+
}
|
|
73
|
+
/** How the report states its amounts: `HKD millions`, `TWD`; `HKD millions, scale not stated` when the table did not say. */
|
|
74
|
+
export function bandScaleText(currency: string, scale: number | undefined, stated = true): string {
|
|
75
|
+
const unit = scale === 1e9 ? " billions" : scale === 1e6 ? " millions" : scale === 1e3 ? " thousands"
|
|
76
|
+
: scale && scale !== 1 ? ` × ${scale.toLocaleString("en-US")}` : "";
|
|
77
|
+
return `${currency}${unit}${stated ? "" : ", scale not stated"}`;
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* One row of the maturity table: a fiscal year of a schedule by year, or a
|
|
81
|
+
* band of one in its filing's own bands, as reported. `dated` rows share the
|
|
82
|
+
* wall's scale; the open-ended last one is capped past it.
|
|
83
|
+
*/
|
|
84
|
+
export interface MaturityRow {
|
|
85
|
+
id: string;
|
|
86
|
+
label: string;
|
|
87
|
+
value: number | null;
|
|
88
|
+
/** Share of the schedule's total, in percent; null without a total. */
|
|
89
|
+
share: number | null;
|
|
90
|
+
dated: boolean;
|
|
91
|
+
bucket?: DebtBucket;
|
|
92
|
+
band?: DebtBand;
|
|
93
|
+
}
|
|
94
|
+
export function maturityRows(latest: DebtLatest): MaturityRow[] {
|
|
95
|
+
const bands = debtBands(latest);
|
|
96
|
+
if (!bands) {
|
|
97
|
+
return latest.buckets.map((bucket) => ({
|
|
98
|
+
id: bucket.id, label: bucket.label, value: bucket.value, share: bucketShare(bucket, latest),
|
|
99
|
+
dated: bucket.year !== null, bucket,
|
|
100
|
+
}));
|
|
101
|
+
}
|
|
102
|
+
const total = bandTotal(bands);
|
|
103
|
+
return bands.map((band) => ({
|
|
104
|
+
id: `${band.fromMonths}-${band.toMonths ?? "on"}`, label: band.label, value: band.value,
|
|
105
|
+
share: total > 0 ? (100 * band.value) / total : null, dated: band.toMonths !== null, band,
|
|
106
|
+
}));
|
|
107
|
+
}
|
|
33
108
|
/**
|
|
34
109
|
* The wall's scale: the largest dated bucket. Thereafter is open ended and
|
|
35
110
|
* usually dwarfs every dated year, so scaling to it would flatten them.
|
|
@@ -37,8 +112,8 @@ export function bucketShare(
|
|
|
37
112
|
export function datedBucketScale(latest: DebtLatest): number {
|
|
38
113
|
return Math.max(
|
|
39
114
|
0,
|
|
40
|
-
...latest.
|
|
41
|
-
row.
|
|
115
|
+
...maturityRows(latest).flatMap((row) =>
|
|
116
|
+
row.dated && row.value !== null ? [row.value] : [],
|
|
42
117
|
),
|
|
43
118
|
);
|
|
44
119
|
}
|
|
@@ -48,15 +123,20 @@ export interface BucketBar {
|
|
|
48
123
|
/** Past the dated scale: drawn to the end and labelled with its value. */
|
|
49
124
|
capped: boolean;
|
|
50
125
|
}
|
|
51
|
-
export function bucketBar(bucket:
|
|
126
|
+
export function bucketBar(bucket: Pick<MaturityRow, "value">, scale: number): BucketBar | null {
|
|
52
127
|
if (bucket.value === null) return null;
|
|
53
128
|
if (scale <= 0) return { ratio: bucket.value > 0 ? 1 : 0, capped: bucket.value > 0 };
|
|
54
129
|
const ratio = bucket.value / scale;
|
|
55
130
|
return ratio > 1 ? { ratio: 1, capped: true } : { ratio, capped: false };
|
|
56
131
|
}
|
|
132
|
+
/**
|
|
133
|
+
* The comparable filings: the ten-year window of a schedule by year. A
|
|
134
|
+
* schedule in its filing's own bands has no principal by year to compare.
|
|
135
|
+
*/
|
|
57
136
|
function recentDebtHistory(
|
|
58
137
|
data: DebtMaturitiesPayload,
|
|
59
138
|
): DebtHistoryPoint[] {
|
|
139
|
+
if (debtBands(data.latest)) return [];
|
|
60
140
|
const start = data.latest?.totalPrincipal.percentile.windowStart;
|
|
61
141
|
return start ? data.history.filter((point) => point.asOf >= start) : [];
|
|
62
142
|
}
|
|
@@ -128,15 +208,17 @@ const MAX_WALL_WIDTH = 48;
|
|
|
128
208
|
/**
|
|
129
209
|
* The maturity table with the wall drawn inline: the bar column takes what
|
|
130
210
|
* the text columns leave, and a pane too narrow for it keeps the numbers.
|
|
211
|
+
* `amount` heads the amounts column (`CARRYING` for carrying amounts).
|
|
131
212
|
*/
|
|
132
|
-
export function bucketColumns(width: number): BucketColumn[] {
|
|
213
|
+
export function bucketColumns(width: number, amount = "PRINCIPAL"): BucketColumn[] {
|
|
214
|
+
const text = BUCKET_TEXT_COLUMNS.map((column) => column.id === "value" ? { ...column, label: amount } : column);
|
|
133
215
|
// Each column is followed by a one-cell gap and the table pads both edges;
|
|
134
216
|
// the body's scrollbar gutter takes the rest, so the wall never scrolls.
|
|
135
|
-
const textWidth =
|
|
217
|
+
const textWidth = text.reduce((sum, column) => sum + column.width + 1, 2);
|
|
136
218
|
const wall = Math.min(MAX_WALL_WIDTH, width - textWidth - 3);
|
|
137
|
-
if (wall < MIN_WALL_WIDTH) return
|
|
219
|
+
if (wall < MIN_WALL_WIDTH) return text;
|
|
138
220
|
return [
|
|
139
|
-
...
|
|
221
|
+
...text,
|
|
140
222
|
{ id: "wall", label: "WALL", width: wall, align: "left" },
|
|
141
223
|
];
|
|
142
224
|
}
|
|
@@ -176,18 +258,19 @@ function compare(
|
|
|
176
258
|
export function sortedBuckets(
|
|
177
259
|
latest: DebtLatest,
|
|
178
260
|
sort: DebtSort<BucketColumnId>,
|
|
179
|
-
):
|
|
180
|
-
|
|
181
|
-
|
|
261
|
+
): MaturityRow[] {
|
|
262
|
+
const rows = maturityRows(latest);
|
|
263
|
+
// The wall bar draws the amount, so it sorts with it.
|
|
264
|
+
const value = (row: MaturityRow) =>
|
|
182
265
|
sort.column === "label"
|
|
183
|
-
?
|
|
266
|
+
? rows.indexOf(row)
|
|
184
267
|
: sort.column === "share"
|
|
185
|
-
?
|
|
268
|
+
? row.share
|
|
186
269
|
: row.value;
|
|
187
|
-
return
|
|
270
|
+
return rows.toSorted(
|
|
188
271
|
(a, b) =>
|
|
189
272
|
compare(value(a), value(b), sort.direction) ||
|
|
190
|
-
|
|
273
|
+
rows.indexOf(a) - rows.indexOf(b),
|
|
191
274
|
);
|
|
192
275
|
}
|
|
193
276
|
export function sortedDebtHistory(
|