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
package/src/types/headless.ts
CHANGED
|
@@ -219,6 +219,11 @@ export interface HeadlessPaneColumn {
|
|
|
219
219
|
unitKey?: string;
|
|
220
220
|
/** With `unitKey`: always a `<header> unit` column, so the header is the same whichever rows loaded. */
|
|
221
221
|
unitColumn?: boolean;
|
|
222
|
+
/**
|
|
223
|
+
* CSV and NDJSON write the figure to the digits `format` draws (-315.12 for -315.12046875), as it is read on
|
|
224
|
+
* screen; JSON keeps the row's figure whole.
|
|
225
|
+
*/
|
|
226
|
+
exportAsShown?: boolean;
|
|
222
227
|
/**
|
|
223
228
|
* The text report prints the value on its own lines under the row instead
|
|
224
229
|
* of in a column, for a footnote that belongs to that row; an empty value
|
|
@@ -240,6 +245,13 @@ export interface HeadlessPaneEntry {
|
|
|
240
245
|
* rather than read back the number `formatted` draws.
|
|
241
246
|
*/
|
|
242
247
|
unit?: string;
|
|
248
|
+
/**
|
|
249
|
+
* The unit an export names in `currency_or_unit` for a figure written as
|
|
250
|
+
* `formatted` draws it, where `value` is not in that unit and `unit` would
|
|
251
|
+
* rescale what JSON keeps: a ratio drawn as a percent (`pct`). Named only
|
|
252
|
+
* beside a number; a figure missing with its reason has no unit.
|
|
253
|
+
*/
|
|
254
|
+
exportUnit?: string;
|
|
243
255
|
/**
|
|
244
256
|
* In a report with `exportDated`, where this line is not of the section's own period and release (a previous
|
|
245
257
|
* reading, a year ago): the period it covers, when it was released and what it is as of. A null `released`
|
package/src/ui/host.tsx
CHANGED
|
@@ -462,6 +462,8 @@ interface HostTabItem {
|
|
|
462
462
|
value: string;
|
|
463
463
|
/** Artwork before the label, such as a logo; decoration only. */
|
|
464
464
|
leading?: ReactNode;
|
|
465
|
+
/** The key the label starts with (`⌘1 `), hidden on a touch screen. */
|
|
466
|
+
keyPrefix?: string;
|
|
465
467
|
disabled?: boolean;
|
|
466
468
|
reorderable?: boolean;
|
|
467
469
|
onClose?: (value: string) => void;
|
|
@@ -695,6 +697,10 @@ export interface UiHost {
|
|
|
695
697
|
DialogFrame?: ComponentType<any>;
|
|
696
698
|
/** Props are `DialogActionsProps` from components/ui/dialog-actions. */
|
|
697
699
|
DialogActions?: ComponentType<any>;
|
|
700
|
+
/** Props are `KeyHintProps` from components/ui/key-hints. */
|
|
701
|
+
KeyHint?: ComponentType<any>;
|
|
702
|
+
/** Props are `KeyHintsProps` from components/ui/key-hints. */
|
|
703
|
+
KeyHints?: ComponentType<any>;
|
|
698
704
|
PageStackView?: ComponentType<any>;
|
|
699
705
|
Tabs?: ComponentType<HostTabsProps>;
|
|
700
706
|
Checkbox?: ComponentType<HostCheckboxProps>;
|
|
@@ -722,6 +728,8 @@ export interface SaveTextFileRequest {
|
|
|
722
728
|
|
|
723
729
|
export interface RendererHost {
|
|
724
730
|
requestExit(): void;
|
|
731
|
+
/** False where the app cannot quit itself (a browser tab): Quit is not offered. */
|
|
732
|
+
canExit?: boolean;
|
|
725
733
|
/**
|
|
726
734
|
* From a press on a title bar. `press.detail` counts the clicks: where the
|
|
727
735
|
* system's title bars maximize on a double-click, the second press does that
|
|
@@ -168,7 +168,12 @@ export function formatFeedTime(value: DisplayDateValue, now = Date.now(), fallba
|
|
|
168
168
|
return formatShortDate(date, { year: sameYear ? false : "2-digit", utc });
|
|
169
169
|
}
|
|
170
170
|
|
|
171
|
-
|
|
171
|
+
/**
|
|
172
|
+
* A date and time in the host's zone, with the zone named: "Oct 7, 2026 at
|
|
173
|
+
* 11:38 PM GMT+2", "... 5:38 PM EDT", "... 9:38 PM UTC". Without the zone a
|
|
174
|
+
* time read beside a list in UTC looks two hours off.
|
|
175
|
+
*/
|
|
176
|
+
export function formatDetailDate(value: DisplayDateValue, fallback = "-", timeZone?: string): string {
|
|
172
177
|
const date = parseDisplayDate(value);
|
|
173
178
|
if (!date) return fallback;
|
|
174
179
|
|
|
@@ -176,10 +181,19 @@ export function formatDetailDate(value: DisplayDateValue, fallback = "-"): strin
|
|
|
176
181
|
month: "short",
|
|
177
182
|
day: "numeric",
|
|
178
183
|
year: "numeric",
|
|
184
|
+
timeZone,
|
|
179
185
|
});
|
|
180
|
-
|
|
186
|
+
return `${datePart} at ${formatDetailTime(date, fallback, timeZone)}`;
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
/** The time of `formatDetailDate` alone, its zone named: "11:38 PM GMT+2", for a day stated beside it. */
|
|
190
|
+
export function formatDetailTime(value: DisplayDateValue, fallback = "-", timeZone?: string): string {
|
|
191
|
+
const date = parseDisplayDate(value);
|
|
192
|
+
if (!date) return fallback;
|
|
193
|
+
return date.toLocaleTimeString("en-US", {
|
|
181
194
|
hour: "numeric",
|
|
182
195
|
minute: "2-digit",
|
|
196
|
+
timeZoneName: "short",
|
|
197
|
+
timeZone,
|
|
183
198
|
});
|
|
184
|
-
return `${datePart} at ${timePart}`;
|
|
185
199
|
}
|
|
@@ -61,3 +61,18 @@ export function labelWithUnit(label: string, unit: string): string {
|
|
|
61
61
|
: label.includes(unit);
|
|
62
62
|
return named ? label : `${label} (${unit})`;
|
|
63
63
|
}
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* A figure to the digits its cell draws: -315.12 for the -315.12046875 drawn
|
|
67
|
+
* "-HK$315.12", -1.27 for a percent drawn "-1.27%". The figure as it is where
|
|
68
|
+
* the cell draws no number, or draws it in another scale (a yield's 0.022 as
|
|
69
|
+
* "+2.2bp"), so a figure is never cut to what another reading shows.
|
|
70
|
+
*/
|
|
71
|
+
export function figureAsDrawn(value: number, drawn: string): number {
|
|
72
|
+
if (!Number.isFinite(value)) return value;
|
|
73
|
+
const read = parseDisplayNumber(drawn);
|
|
74
|
+
if (!read || read === BLANK_DISPLAY) return value;
|
|
75
|
+
const shown = Number(read.number);
|
|
76
|
+
return Math.abs(Math.abs(shown) - Math.abs(value)) <= (read.step / 2) * (1 + 1e-9) + Number.EPSILON
|
|
77
|
+
? Math.sign(value) * Math.abs(shown) : value;
|
|
78
|
+
}
|
|
@@ -1,19 +1,44 @@
|
|
|
1
|
-
import { ONE_SHOT_COOLDOWN_MS } from "./one-shot";
|
|
2
|
-
|
|
3
1
|
const DOUBLE_ESCAPE_CLOSE_MS = 650;
|
|
4
2
|
|
|
3
|
+
/**
|
|
4
|
+
* Where a host cannot say which Esc presses are a held key's auto-repeat (a
|
|
5
|
+
* terminal that does not report key event types), an Esc this soon after the
|
|
6
|
+
* Esc before it is read as the held key, while a stream is live: after an Esc
|
|
7
|
+
* that closed a pane, or one that looked like its repeat. It arms nothing and
|
|
8
|
+
* closes nothing, so a held key cannot go on to close the next pane.
|
|
9
|
+
*
|
|
10
|
+
* Just above the slowest stock repeat interval: macOS repeats every 90 ms by
|
|
11
|
+
* default, Windows, GNOME, KDE and X11 every 25 to 40 ms, and keyboards set
|
|
12
|
+
* faster go lower, so a held key stays under it with room for a late frame.
|
|
13
|
+
* Separate presses are rarely this close: even a quick double tap of one key
|
|
14
|
+
* is further apart. A keyboard set to repeat slower than this reads as
|
|
15
|
+
* separate presses, and a host that flags repeats never reaches this check.
|
|
16
|
+
*/
|
|
17
|
+
const HELD_ESCAPE_GAP_MS = 110;
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* How long a stream stays live with no press. A stall (the redraw after the
|
|
21
|
+
* close, a busy frame) holds the next repeat back, and the ones queued behind
|
|
22
|
+
* it arrive close together: that press arms, but the one after it is still
|
|
23
|
+
* the held key.
|
|
24
|
+
*/
|
|
25
|
+
const HELD_ESCAPE_STALL_MS = 500;
|
|
26
|
+
|
|
5
27
|
export interface DoubleEscapeCloseState {
|
|
6
28
|
lastAt: number;
|
|
7
29
|
targetId: string | null;
|
|
8
|
-
/** The last Esc that closed a pane, or
|
|
9
|
-
|
|
30
|
+
/** The last Esc that closed a pane, or the latest one since that looked like its repeat. */
|
|
31
|
+
streamAt: number;
|
|
32
|
+
/** The last Esc that armed, closed or looked like a repeat. */
|
|
33
|
+
pressAt: number;
|
|
10
34
|
}
|
|
11
35
|
|
|
12
36
|
export function createDoubleEscapeCloseState(): DoubleEscapeCloseState {
|
|
13
37
|
return {
|
|
14
38
|
lastAt: 0,
|
|
15
39
|
targetId: null,
|
|
16
|
-
|
|
40
|
+
streamAt: Number.NEGATIVE_INFINITY,
|
|
41
|
+
pressAt: Number.NEGATIVE_INFINITY,
|
|
17
42
|
};
|
|
18
43
|
}
|
|
19
44
|
|
|
@@ -28,19 +53,32 @@ export function resetDoubleEscapeClose(state: DoubleEscapeCloseState) {
|
|
|
28
53
|
* Esc arms, whatever the pane does with it (back out of a detail, clear a
|
|
29
54
|
* selection, leave a chart), except an Esc that leaves a draft or closes a
|
|
30
55
|
* menu: see `countEscapeTowardClose` and `keepEscapeFromClosing`.
|
|
56
|
+
*
|
|
57
|
+
* `repeat` is the host's word on whether the key is held down (DOM `repeat`,
|
|
58
|
+
* the kitty protocol's repeat event): true is an auto-repeat, which is no
|
|
59
|
+
* press at all, and false is a press of its own however soon it follows the
|
|
60
|
+
* last. Undefined where the host cannot tell; both then go by the gap
|
|
61
|
+
* between presses, see `HELD_ESCAPE_GAP_MS`.
|
|
31
62
|
*/
|
|
32
63
|
export function takeDoubleEscapeClose(
|
|
33
64
|
state: DoubleEscapeCloseState,
|
|
34
65
|
targetId: string | null | undefined,
|
|
35
66
|
now: number,
|
|
36
|
-
|
|
67
|
+
repeat?: boolean,
|
|
37
68
|
): boolean {
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
69
|
+
if (repeat === true) return false;
|
|
70
|
+
const matched = !!targetId && state.targetId === targetId && now - state.lastAt <= DOUBLE_ESCAPE_CLOSE_MS;
|
|
71
|
+
if (!matched || isHeldEscape(state, now, repeat)) return false;
|
|
72
|
+
resetDoubleEscapeClose(state);
|
|
73
|
+
state.streamAt = now;
|
|
74
|
+
state.pressAt = now;
|
|
75
|
+
return true;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
function isHeldEscape(state: DoubleEscapeCloseState, now: number, repeat: boolean | undefined): boolean {
|
|
79
|
+
return repeat === undefined
|
|
80
|
+
&& now - state.pressAt < HELD_ESCAPE_GAP_MS
|
|
81
|
+
&& now - state.streamAt < HELD_ESCAPE_STALL_MS;
|
|
44
82
|
}
|
|
45
83
|
|
|
46
84
|
interface EscapeOffer {
|
|
@@ -88,17 +126,24 @@ export function armDoubleEscapeClose(
|
|
|
88
126
|
state: DoubleEscapeCloseState,
|
|
89
127
|
targetId: string | null | undefined,
|
|
90
128
|
now: number,
|
|
129
|
+
repeat?: boolean,
|
|
91
130
|
) {
|
|
92
131
|
if (!targetId) {
|
|
93
132
|
resetDoubleEscapeClose(state);
|
|
94
133
|
return;
|
|
95
134
|
}
|
|
96
|
-
|
|
97
|
-
//
|
|
98
|
-
|
|
99
|
-
|
|
135
|
+
if (repeat === true) return;
|
|
136
|
+
// Where the host cannot flag repeats, a held Esc is a stream of presses:
|
|
137
|
+
// after the close it arms nothing, so it cannot close the next pane too, and
|
|
138
|
+
// each Esc of the stream keeps it going. A separate press, further from the
|
|
139
|
+
// last than a held key's repeat, arms the next pane at once.
|
|
140
|
+
if (isHeldEscape(state, now, repeat)) {
|
|
141
|
+
resetDoubleEscapeClose(state);
|
|
142
|
+
state.streamAt = now;
|
|
143
|
+
state.pressAt = now;
|
|
100
144
|
return;
|
|
101
145
|
}
|
|
102
146
|
state.targetId = targetId;
|
|
103
147
|
state.lastAt = now;
|
|
148
|
+
state.pressAt = now;
|
|
104
149
|
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/** The decimals a number is written with: 2 for 6012.25, 13 for 340.3299865722656. */
|
|
2
|
+
export function decimalPlaces(value: number): number {
|
|
3
|
+
const [mantissa = "", exponent = "0"] = Math.abs(value).toString().split("e");
|
|
4
|
+
return Math.max(0, (mantissa.split(".")[1]?.length ?? 0) - Number(exponent));
|
|
5
|
+
}
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* Providers serve prices as float32: The feed sends the exact float
|
|
9
|
+
* (340.33 arrives as 340.3299865722656) and the cloud a float already rounded
|
|
10
|
+
* to a few decimals (254.42999). Return the shortest decimal that is the same
|
|
11
|
+
* float32. Values with fewer than five decimals are left alone, and a precise
|
|
12
|
+
* double only moves within float32 precision (about seven significant digits).
|
|
13
|
+
*/
|
|
14
|
+
export function cleanFloat32Price(value: number): number {
|
|
15
|
+
if (!Number.isFinite(value) || value === 0 || decimalPlaces(value) < 5) return value;
|
|
16
|
+
const target = Math.fround(value);
|
|
17
|
+
for (let digits = 1; digits <= 9; digits++) {
|
|
18
|
+
const candidate = Number(value.toPrecision(digits));
|
|
19
|
+
if (Math.fround(candidate) !== target) continue;
|
|
20
|
+
return candidate.toString().length < value.toString().length ? candidate : value;
|
|
21
|
+
}
|
|
22
|
+
return value;
|
|
23
|
+
}
|
|
24
|
+
|
|
@@ -84,8 +84,16 @@ const MAX_GRACE_DAYS = 90;
|
|
|
84
84
|
* lapsed forward yield too.
|
|
85
85
|
*/
|
|
86
86
|
const UNKNOWN_CADENCE_WINDOW_DAYS = 455;
|
|
87
|
-
/**
|
|
88
|
-
const
|
|
87
|
+
/** Past this many days a monthly payer's next distribution would have gone ex: a history without it ends early. */
|
|
88
|
+
const MONTHLY_HISTORY_END_DAYS = 40;
|
|
89
|
+
/**
|
|
90
|
+
* Past this many days a monthly payer has stopped paying (FXF, last paid
|
|
91
|
+
* 2024-04-01) rather than its history ended early: Gloom Cloud no longer asks
|
|
92
|
+
* for the distributions after it.
|
|
93
|
+
*/
|
|
94
|
+
const MONTHLY_STOPPED_DAYS = 183;
|
|
95
|
+
/** The shortest a forward yield can take to be withheld: a monthly payer's history that ends (monthlyHistoryEnd). */
|
|
96
|
+
const SHORTEST_WINDOW_DAYS = MONTHLY_HISTORY_END_DAYS;
|
|
89
97
|
|
|
90
98
|
function dayNumber(day: string): number {
|
|
91
99
|
return Date.parse(`${day}T00:00:00Z`) / DAY_MS;
|
|
@@ -116,10 +124,19 @@ function distributionIntervalDays(exDates: readonly (string | Date)[]): number |
|
|
|
116
124
|
return recent.length < 3 ? Math.max(nearest, CADENCE_DAYS[1]) : nearest;
|
|
117
125
|
}
|
|
118
126
|
|
|
119
|
-
/**
|
|
127
|
+
/**
|
|
128
|
+
* A dividend that has stopped, or a monthly payer's history that ends: no
|
|
129
|
+
* forward yield, only the day the last distribution went ex.
|
|
130
|
+
*/
|
|
120
131
|
export interface DividendLapse {
|
|
121
132
|
/** YYYY-MM-DD; null when no date is known. */
|
|
122
133
|
lastPaid: string | null;
|
|
134
|
+
/**
|
|
135
|
+
* A monthly payer's history that stops at `lastPaid` (monthlyHistoryEnd):
|
|
136
|
+
* the distributions after it are missing from the history, which says
|
|
137
|
+
* nothing of whether the fund stopped paying.
|
|
138
|
+
*/
|
|
139
|
+
historyEnds?: true;
|
|
123
140
|
}
|
|
124
141
|
|
|
125
142
|
/** What a forward yield is checked against: the issuer's own distributions. */
|
|
@@ -143,14 +160,17 @@ export function distributionHistory(actions: CorporateActionsData | null | undef
|
|
|
143
160
|
|
|
144
161
|
/**
|
|
145
162
|
* Whether the dividend behind a forward rate dated `asOf` (the ex-date of the
|
|
146
|
-
* distribution it annualizes) has stopped
|
|
147
|
-
*
|
|
148
|
-
*
|
|
149
|
-
*
|
|
150
|
-
*
|
|
151
|
-
*
|
|
152
|
-
*
|
|
153
|
-
*
|
|
163
|
+
* distribution it annualizes) has stopped, or its history ended. A monthly
|
|
164
|
+
* payer's history with no ex-date in the last 40 days ends there
|
|
165
|
+
* (monthlyHistoryEnd, `historyEnds`), until it has been silent more than 183
|
|
166
|
+
* days, when its dividend has stopped. Otherwise it is current while its
|
|
167
|
+
* latest distribution went ex within its usual interval plus grace: half an
|
|
168
|
+
* interval, at least a month and at most three, so a quarterly payer lapses
|
|
169
|
+
* after four and a half months, a semiannual one after nine and an annual one
|
|
170
|
+
* after fifteen (the window Gloom Cloud uses). The interval comes from the
|
|
171
|
+
* issuer's own history, at least quarterly when it has only two
|
|
172
|
+
* distributions; without one (fewer than two distributions, or no history) the
|
|
173
|
+
* annual window applies.
|
|
154
174
|
* A distribution declared and not yet ex, the rate's own or one in the
|
|
155
175
|
* history, keeps it current. Null while current or when nothing is known.
|
|
156
176
|
*/
|
|
@@ -165,19 +185,22 @@ export function lapsedDividend(
|
|
|
165
185
|
return day ? [day] : [];
|
|
166
186
|
});
|
|
167
187
|
if (days.some((day) => day > today) || (history?.declared?.length ?? 0) > 0) return null;
|
|
188
|
+
const historyEnd = monthlyHistoryEnd(history, now);
|
|
189
|
+
if (historyEnd) return { lastPaid: historyEnd, historyEnds: true };
|
|
168
190
|
const paid = [...new Set(days)];
|
|
169
191
|
if (paid.length === 0) return null;
|
|
170
192
|
const lastPaid = paid.reduce((latest, day) => (day > latest ? day : latest));
|
|
171
193
|
const interval = history?.exDates ? distributionIntervalDays(paid) : null;
|
|
172
194
|
const window = interval == null ? UNKNOWN_CADENCE_WINDOW_DAYS
|
|
173
195
|
: interval + Math.min(MAX_GRACE_DAYS, Math.max(MIN_GRACE_DAYS, interval / 2));
|
|
174
|
-
return dayNumber(today) - dayNumber(lastPaid)
|
|
196
|
+
return dayNumber(today) - dayNumber(lastPaid) <= window ? null : { lastPaid };
|
|
175
197
|
}
|
|
176
198
|
|
|
177
199
|
/**
|
|
178
200
|
* Whether a forward rate dated `asOf` could have lapsed by `now`, so the
|
|
179
201
|
* history is worth reading: never while its ex-date is ahead or more recent
|
|
180
|
-
* than the shortest window, a monthly payer's
|
|
202
|
+
* than the shortest window, the 40 days after which a monthly payer's history
|
|
203
|
+
* ends.
|
|
181
204
|
*/
|
|
182
205
|
export function forwardDividendMayHaveLapsed(asOf: string | Date | null | undefined, now = new Date()): boolean {
|
|
183
206
|
const rateDay = isoDay(asOf);
|
|
@@ -195,15 +218,57 @@ export function forwardYieldMayHaveLapsed(
|
|
|
195
218
|
return fundamentals?.dividendYieldBasis === "forward" && forwardDividendMayHaveLapsed(fundamentals.exDividendDate, now);
|
|
196
219
|
}
|
|
197
220
|
|
|
221
|
+
/**
|
|
222
|
+
* The last ex-date of a monthly payer's history that stops more than 40 days
|
|
223
|
+
* and at most 183 days before `now`, read from its paid ex-dates alone: MUB's
|
|
224
|
+
* history ending at 2026-09-01 while the fund paid on 1 October and 2
|
|
225
|
+
* November. A forward rate, trailing yield and last ex-date read from that
|
|
226
|
+
* history then all stop there too, and say so, rather than read the missing
|
|
227
|
+
* months as a dividend that stopped. Silent longer, the fund stopped paying
|
|
228
|
+
* (FXF, last paid 2024-04-01), which lapsedDividend says. Null for any other
|
|
229
|
+
* cadence, a history that is current, and one with a distribution declared or
|
|
230
|
+
* still ahead.
|
|
231
|
+
*/
|
|
232
|
+
export function monthlyHistoryEnd(history: DistributionHistory | null | undefined, now = new Date()): string | null {
|
|
233
|
+
if (!history?.exDates || (history.declared?.length ?? 0) > 0) return null;
|
|
234
|
+
const today = isoDay(now)!;
|
|
235
|
+
const days = [...new Set(history.exDates.flatMap((value) => {
|
|
236
|
+
const day = isoDay(value);
|
|
237
|
+
return day ? [day] : [];
|
|
238
|
+
}))].sort();
|
|
239
|
+
const last = days.at(-1);
|
|
240
|
+
const silent = last ? dayNumber(today) - dayNumber(last) : 0;
|
|
241
|
+
if (!last || last > today || silent <= MONTHLY_HISTORY_END_DAYS || silent > MONTHLY_STOPPED_DAYS) return null;
|
|
242
|
+
return distributionIntervalDays(days) === CADENCE_DAYS[0] ? last : null;
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
/** `distribution history ends 2026-09-01`: what a monthly payer's ended history says in place of a yield it cannot give. */
|
|
246
|
+
export function historyEndsText(day: string): string {
|
|
247
|
+
return `distribution history ends ${day}`;
|
|
248
|
+
}
|
|
249
|
+
|
|
198
250
|
export const NO_CURRENT_DIVIDEND = "no current dividend";
|
|
251
|
+
/** What a short cell reads for a monthly payer's history that ends (DividendLapse.historyEnds), beside `last ex 2026-09-01`. */
|
|
252
|
+
const HISTORY_ENDS = "history ends";
|
|
199
253
|
|
|
200
|
-
/**
|
|
254
|
+
/** What a short cell reads in place of a lapsed forward yield: `history ends` for a history that ends, else `no current dividend`. */
|
|
255
|
+
export function lapseValue(lapse: DividendLapse): string {
|
|
256
|
+
return lapse.historyEnds && lapse.lastPaid ? HISTORY_ENDS : NO_CURRENT_DIVIDEND;
|
|
257
|
+
}
|
|
258
|
+
|
|
259
|
+
/** `last paid 2026-02-27` beside "no current dividend", `last ex 2026-09-01` beside "history ends"; null when the date is unknown. */
|
|
201
260
|
export function lastPaidNote(lapse: DividendLapse): string | null {
|
|
202
|
-
|
|
261
|
+
if (!lapse.lastPaid) return null;
|
|
262
|
+
return lapse.historyEnds ? `last ex ${lapse.lastPaid}` : `last paid ${lapse.lastPaid}`;
|
|
203
263
|
}
|
|
204
264
|
|
|
205
|
-
/**
|
|
265
|
+
/**
|
|
266
|
+
* `no current dividend (last paid 2026-02-27)`, what a lapsed forward yield
|
|
267
|
+
* reads instead of a percentage; for a monthly payer's history that ends
|
|
268
|
+
* early, `distribution history ends 2026-09-01`.
|
|
269
|
+
*/
|
|
206
270
|
export function noCurrentDividend(lapse: DividendLapse): string {
|
|
271
|
+
if (lapse.historyEnds && lapse.lastPaid) return historyEndsText(lapse.lastPaid);
|
|
207
272
|
const note = lastPaidNote(lapse);
|
|
208
273
|
return note ? `${NO_CURRENT_DIVIDEND} (${note})` : NO_CURRENT_DIVIDEND;
|
|
209
274
|
}
|
|
@@ -85,6 +85,17 @@ export function latestFxWeekOpen(time: number): number | null {
|
|
|
85
85
|
return latestNewYorkFivePm(time, 0);
|
|
86
86
|
}
|
|
87
87
|
|
|
88
|
+
/**
|
|
89
|
+
* When the FX week opens again, Sunday 17:00 New York, for a moment it is
|
|
90
|
+
* shut; null while it trades. A closure lasts two days, so the open is the
|
|
91
|
+
* latest one three days on.
|
|
92
|
+
*/
|
|
93
|
+
export function nextFxWeekOpen(time: number): number | null {
|
|
94
|
+
if (!Number.isFinite(time) || isFxMarketOpen(time)) return null;
|
|
95
|
+
const open = latestFxWeekOpen(time + 3 * DAY_MS);
|
|
96
|
+
return open != null && open > time ? open : null;
|
|
97
|
+
}
|
|
98
|
+
|
|
88
99
|
/**
|
|
89
100
|
* How close to the FX week's close a print is its close: Gloom Cloud dates the
|
|
90
101
|
* week's close by its last minute (20:59Z, or 21:59Z in winter).
|
|
@@ -8,6 +8,7 @@ import { regularHistorySessionStaleness } from "../market-data/history-session";
|
|
|
8
8
|
import type { HistorySession } from "../types/price-history";
|
|
9
9
|
import { BAR_INTERVAL_UNIT_MS, parseBarInterval } from "../time-series/resolution";
|
|
10
10
|
import { parseOptionTicker } from "./options";
|
|
11
|
+
import { indexSessionVenue } from "../market-data/market/index-session-venues";
|
|
11
12
|
|
|
12
13
|
// A venue without session hours here (OTC Markets, Cboe Canada) has no
|
|
13
14
|
// session to hold: its copy is current while the latest bar is this recent.
|
|
@@ -239,7 +240,7 @@ export function isPriceHistoryStaleForCurrentWindow(
|
|
|
239
240
|
// labelled by its start, so an hourly bar ending at the break is judged by
|
|
240
241
|
// when it ends.
|
|
241
242
|
const latestBarEnd = intervalMs != null ? Math.min(latestTime + intervalMs, now) : latestTime;
|
|
242
|
-
if (isMiddayBreakPrint(latestBarEnd, options.exchange, now, 0)) return false;
|
|
243
|
+
if (isMiddayBreakPrint(latestBarEnd, options.exchange || indexSessionVenue(options.symbol) || undefined, now, 0)) return false;
|
|
243
244
|
const sessions = listingSessionsAt(now, options);
|
|
244
245
|
if (!sessions) return age > UNSCHEDULED_HISTORY_MAX_AGE_MS;
|
|
245
246
|
const fetchedAt = options.fetchedAt ?? Number.NEGATIVE_INFINITY;
|
|
@@ -247,7 +248,7 @@ export function isPriceHistoryStaleForCurrentWindow(
|
|
|
247
248
|
// A venue whose chart source files another week (DFM's Sunday to Thursday)
|
|
248
249
|
// may end on the last session that week has: current under either week.
|
|
249
250
|
// Bars of a day that week lacks (a DFM Friday) answer to the venue's own.
|
|
250
|
-
const exchange = listingSessionExchange(options.exchange);
|
|
251
|
+
const exchange = listingSessionExchange(options.exchange, options.symbol);
|
|
251
252
|
const sourceWeekendDays = historySourceWeekendDays(exchange);
|
|
252
253
|
const timeZone = sessionCalendarTimeZone(exchange);
|
|
253
254
|
const latestWeekday = timeZone ? zonedWeekday(latestTime, timeZone) : null;
|
|
@@ -256,9 +257,9 @@ export function isPriceHistoryStaleForCurrentWindow(
|
|
|
256
257
|
return !sourceSessions || !holdsLatestSession(latestTime, now, sourceSessions, allowedLag, fetchedAt);
|
|
257
258
|
}
|
|
258
259
|
|
|
259
|
-
/** Bare symbols resolve to their US listing at the sources. */
|
|
260
|
-
function listingSessionExchange(exchange: string | undefined): string {
|
|
261
|
-
return canonicalExchange(exchange) || "NYSE";
|
|
260
|
+
/** Bare symbols resolve to their US listing at the sources; a bare index symbol to the venue whose sessions it follows. */
|
|
261
|
+
function listingSessionExchange(exchange: string | undefined, symbol?: string): string {
|
|
262
|
+
return canonicalExchange(exchange) || indexSessionVenue(symbol) || "NYSE";
|
|
262
263
|
}
|
|
263
264
|
|
|
264
265
|
interface ListingSessions {
|
|
@@ -285,7 +286,7 @@ function listingSessionsAt(
|
|
|
285
286
|
return { liveOpen: isFxMarketOpen(time) ? latestFxWeekOpen(time) : null,
|
|
286
287
|
last: close !== null && open !== null ? { open, close } : null };
|
|
287
288
|
}
|
|
288
|
-
const exchange = listingSessionExchange(options.exchange);
|
|
289
|
+
const exchange = listingSessionExchange(options.exchange, options.symbol);
|
|
289
290
|
const open = latestRegularSessionOpen(exchange, time, weekendDays);
|
|
290
291
|
if (open === null) return null;
|
|
291
292
|
const latest = latestRegularSessionClose(exchange, time, weekendDays);
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import type { EarningsTiming } from "../api-client/earnings";
|
|
2
|
+
import { timeZoneLabel, zonedDateTimeParts, zonedWallClockToUtcMs } from "./zoned-date-time";
|
|
3
|
+
|
|
4
|
+
const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"] as const;
|
|
5
|
+
const WEEKDAYS = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"] as const;
|
|
6
|
+
|
|
7
|
+
/** When a report is out on the New York clock, as `[hour, minute]`: before the 9:30 open, or shortly after the 16:00 close. */
|
|
8
|
+
const NEW_YORK_TIMES: Record<EarningsTiming, { words: string; at: readonly [number, number]; until?: readonly [number, number] }> = {
|
|
9
|
+
bmo: { words: "before open", at: [9, 30] },
|
|
10
|
+
dmh: { words: "during market hours", at: [9, 30], until: [16, 0] },
|
|
11
|
+
amc: { words: "after close", at: [16, 5] },
|
|
12
|
+
};
|
|
13
|
+
|
|
14
|
+
const clockText = (time: number, zone: string) => {
|
|
15
|
+
const local = zonedDateTimeParts(time, zone);
|
|
16
|
+
return `${String(local.hour).padStart(2, "0")}:${String(local.minute).padStart(2, "0")}`;
|
|
17
|
+
};
|
|
18
|
+
|
|
19
|
+
const dayText = (time: number, zone: string) => {
|
|
20
|
+
const local = zonedDateTimeParts(time, zone);
|
|
21
|
+
const weekday = WEEKDAYS[new Date(Date.UTC(local.year, local.month - 1, local.day)).getUTCDay()]!;
|
|
22
|
+
return `${weekday} ${local.day} ${MONTHS[local.month - 1]}`;
|
|
23
|
+
};
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* When a report comes out, on the reader's clock.
|
|
27
|
+
*
|
|
28
|
+
* A time the company announced (`releaseAt`, Berkshire's Saturday 13:00Z) is
|
|
29
|
+
* that time: "at 21:00 SGT Sat 7 Nov" in Singapore, and in UTC for a reader
|
|
30
|
+
* with no zone set. Otherwise, for a reader who set a timezone, the session
|
|
31
|
+
* timing on their clock: in Singapore an after-close report on Monday 9 Nov
|
|
32
|
+
* is out "after close, about 05:05 SGT Tue 10 Nov", which "AMC" alone does
|
|
33
|
+
* not say. A weekend date has no session to place it by, so without an
|
|
34
|
+
* announced time it says nothing more than its label.
|
|
35
|
+
*
|
|
36
|
+
* Null without either, or for a zone that keeps New York's clock.
|
|
37
|
+
*/
|
|
38
|
+
export function localReportTiming(
|
|
39
|
+
date: string,
|
|
40
|
+
timing: EarningsTiming | null | undefined,
|
|
41
|
+
zone: string | null | undefined,
|
|
42
|
+
releaseAt?: string | null,
|
|
43
|
+
): string | null {
|
|
44
|
+
const announced = releaseAt ? Date.parse(releaseAt) : NaN;
|
|
45
|
+
if (Number.isFinite(announced)) {
|
|
46
|
+
const shown = zone ?? "UTC";
|
|
47
|
+
return `at ${clockText(announced, shown)} ${timeZoneLabel(shown)} ${dayText(announced, shown)}`;
|
|
48
|
+
}
|
|
49
|
+
if (!timing || !zone || !/^\d{4}-\d{2}-\d{2}$/.test(date)) return null;
|
|
50
|
+
const [year, month, day] = date.split("-").map(Number) as [number, number, number];
|
|
51
|
+
const weekday = new Date(Date.UTC(year, month - 1, day)).getUTCDay();
|
|
52
|
+
if (weekday === 0 || weekday === 6) return null;
|
|
53
|
+
const times = NEW_YORK_TIMES[timing];
|
|
54
|
+
const at = zonedWallClockToUtcMs("America/New_York", year, month, day, times.at[0], times.at[1], 0);
|
|
55
|
+
if (dayText(at, zone) === dayText(at, "America/New_York") && clockText(at, zone) === clockText(at, "America/New_York")) return null;
|
|
56
|
+
const label = timeZoneLabel(zone);
|
|
57
|
+
if (times.until) {
|
|
58
|
+
const until = zonedWallClockToUtcMs("America/New_York", year, month, day, times.until[0], times.until[1], 0);
|
|
59
|
+
return `${times.words}, ${clockText(at, zone)} to ${clockText(until, zone)} ${label} ${dayText(at, zone)}`;
|
|
60
|
+
}
|
|
61
|
+
return `${times.words}, ${timing === "bmo" ? "by" : "about"} ${clockText(at, zone)} ${label} ${dayText(at, zone)}`;
|
|
62
|
+
}
|
package/src/utils/sec-filings.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { SecFilingItem } from "../types/data-provider";
|
|
2
|
+
import { formatCompact } from "./format";
|
|
2
3
|
import { secFilingItemCodes } from "./sec";
|
|
3
4
|
|
|
4
5
|
/**
|
|
@@ -266,3 +267,34 @@ export async function loadLatestFilings(
|
|
|
266
267
|
count = Math.min(SEC_FILING_FETCH_LIMIT, count * READ_GROWTH);
|
|
267
268
|
}
|
|
268
269
|
}
|
|
270
|
+
|
|
271
|
+
const FORM4_VERBS: Record<string, string> = {
|
|
272
|
+
P: "Bought", S: "Sold", A: "Awarded", G: "Gift of", F: "Withheld for tax", M: "Exercised", X: "Exercised", C: "Converted",
|
|
273
|
+
};
|
|
274
|
+
|
|
275
|
+
/** Whether a Form 4 reports another company's shares: one the listing's company filed as their owner. */
|
|
276
|
+
export function isOtherIssuerForm4(filing: Pick<SecFilingItem, "cik" | "form4">): boolean {
|
|
277
|
+
const issuer = filing.form4?.issuerCik?.replace(/^0+/, "");
|
|
278
|
+
return !!issuer && issuer !== filing.cik.replace(/^0+/, "");
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
/**
|
|
282
|
+
* A Form 4's row, from what Gloom Cloud read of it: "Sold 2.13M SIRI shares
|
|
283
|
+
* at $21.48 (SIRIUS XM HOLDINGS INC.)" for one the company filed as an owner
|
|
284
|
+
* of another company's shares, whose issuer only the form names, and "COOK
|
|
285
|
+
* TIMOTHY D: Sold 120k shares at $231.50" for an insider of its own. Null
|
|
286
|
+
* without the service's summary.
|
|
287
|
+
*/
|
|
288
|
+
export function form4TradeText(filing: Pick<SecFilingItem, "cik" | "form4">): string | null {
|
|
289
|
+
const trade = filing.form4;
|
|
290
|
+
if (!trade) return null;
|
|
291
|
+
const verb = FORM4_VERBS[trade.code] ?? (trade.side === "disposed" || trade.side === "sell" ? "Disposed of" : "Acquired");
|
|
292
|
+
const price = trade.price == null ? "" : ` at $${trade.price >= 1 ? trade.price.toFixed(2) : trade.price.toPrecision(3)}`;
|
|
293
|
+
// A form of options alone counts options, not shares.
|
|
294
|
+
const unit = trade.derivative ? "options" : "shares";
|
|
295
|
+
if (isOtherIssuerForm4(filing)) {
|
|
296
|
+
const subject = trade.issuerTicker ? `${trade.issuerTicker} ${unit}` : unit;
|
|
297
|
+
return `${verb} ${formatCompact(trade.shares)} ${subject}${price} (${trade.issuerName})`;
|
|
298
|
+
}
|
|
299
|
+
return `${trade.ownerName ? `${trade.ownerName}: ` : ""}${verb} ${formatCompact(trade.shares)} ${unit}${price}`;
|
|
300
|
+
}
|
package/src/utils/utc-time.ts
CHANGED
|
@@ -80,6 +80,11 @@ export function setDisplayTimeZone(zone: string | null | undefined): void {
|
|
|
80
80
|
displayZone = readerTimeZone(zone);
|
|
81
81
|
}
|
|
82
82
|
|
|
83
|
+
/** The zone CLI text shows local times in (setDisplayTimeZone), or null when none is set. */
|
|
84
|
+
export function displayTimeZone(): string | null {
|
|
85
|
+
return displayZone;
|
|
86
|
+
}
|
|
87
|
+
|
|
83
88
|
/** The zone a configured name shows a second clock in: null when unset, unknown or UTC all year. */
|
|
84
89
|
export function readerTimeZone(zone: string | null | undefined): string | null {
|
|
85
90
|
const canonical = zone ? canonicalTimeZone(zone) : null;
|