gloomberb 0.20.2 → 0.20.4
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-dialog.tsx +17 -0
- 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 +23 -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/fx-interventions.ts +64 -0
- package/src/api-client/index.ts +2 -0
- package/src/api-client/paths.ts +9 -1
- package/src/api-client/release-summaries.ts +21 -0
- package/src/api-client/social-mentions.ts +47 -0
- package/src/api-client/types/econ.ts +4 -0
- package/src/app/keybindings/actions.ts +2 -2
- package/src/app/pane-runtime/ticker-open-runtime.ts +245 -66
- package/src/app.tsx +11 -1
- package/src/cli/command-options.ts +2 -1
- package/src/cli/commands/market.ts +188 -30
- package/src/cli/commands/news-search.ts +1 -3
- package/src/cli/commands/options-chain.ts +23 -6
- package/src/cli/commands/overview.ts +13 -5
- package/src/cli/commands/plugins.ts +76 -23
- package/src/cli/commands/search.ts +25 -6
- package/src/cli/commands/system.ts +19 -3
- package/src/cli/commands/ticker.ts +64 -21
- 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 +14 -46
- 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 +26 -14
- 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 +40 -8
- package/src/cli/result.ts +21 -9
- 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/types.ts +2 -0
- package/src/cli/unknown-command.ts +88 -0
- package/src/components/chart/composite/axis-overlays.tsx +22 -0
- package/src/components/chart/composite/composite-chart.tsx +54 -13
- package/src/components/chart/composite/event-captions.ts +109 -0
- package/src/components/chart/composite/event-guides.ts +74 -0
- package/src/components/chart/composite/rasterizer.ts +2 -0
- package/src/components/chart/composite/text-renderer.ts +2 -0
- package/src/components/chart/composite/types.ts +31 -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/layout-items/focused-pane.ts +5 -5
- 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 +192 -33
- 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 +104 -6
- package/src/components/command-bar/routes/ticker-search/route.ts +3 -2
- 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/detached-pane-shell.tsx +1 -1
- package/src/components/layout/double-escape-close.ts +8 -5
- package/src/components/layout/floating-pane.tsx +5 -1
- 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 +44 -19
- package/src/components/layout/pane/footer/model.ts +52 -20
- package/src/components/layout/pane/header.tsx +3 -2
- package/src/components/layout/shell/action-menu-overlay.tsx +10 -5
- package/src/components/layout/shell/active-drag.ts +149 -105
- package/src/components/layout/shell/chrome.ts +15 -15
- package/src/components/layout/shell/drag/drop-zones.ts +162 -0
- package/src/components/layout/shell/drag/index.ts +47 -218
- package/src/components/layout/shell/drag/live.ts +10 -3
- package/src/components/layout/shell/drag/overlays.tsx +182 -5
- package/src/components/layout/shell/drag/runtime.ts +29 -6
- package/src/components/layout/shell/drag/shared-edges.ts +156 -0
- package/src/components/layout/shell/index.tsx +11 -6
- package/src/components/layout/shell/menu.ts +11 -2
- package/src/components/layout/shell/native/pointer-runtime.ts +25 -0
- package/src/components/layout/shell/native/window-state.ts +2 -2
- package/src/components/layout/shell/pane/layers.tsx +71 -7
- package/src/components/layout/shell/terminal-pointer-runtime.ts +18 -9
- package/src/components/layout/shell/window-mode/index.ts +8 -10
- package/src/components/layout/status-bar.tsx +8 -7
- package/src/components/layout/status-widget-space.ts +8 -0
- package/src/components/layout/window-edit/mode.ts +39 -7
- package/src/components/layout/window-edit/presentation.ts +1 -1
- 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 +19 -6
- package/src/components/onboarding/onboarding-wizard.tsx +69 -14
- 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 +15 -2
- package/src/components/ui/choice-dialog.tsx +1 -0
- package/src/components/ui/column-grid.tsx +18 -9
- package/src/components/ui/data-table/index.tsx +5 -4
- 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/list-view.tsx +7 -12
- package/src/components/ui/loading.tsx +10 -3
- package/src/components/ui/menu.tsx +9 -3
- package/src/components/ui/message-composer.tsx +2 -2
- package/src/components/ui/quote.ts +14 -1
- 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/layout.ts +5 -2
- package/src/data/config/store/normalize.ts +6 -0
- package/src/docs/snapshot.json +149 -74
- package/src/i18n/es.ts +33 -9
- package/src/i18n/ja.ts +33 -9
- package/src/i18n/ko.ts +33 -9
- package/src/i18n/zh-cn.ts +33 -9
- package/src/i18n/zh-tw.ts +33 -9
- package/src/layout/pane-manager/floating-actions.ts +17 -0
- package/src/layout/pane-manager/floating-stack.ts +187 -0
- package/src/layout/pane-manager/floating.ts +4 -2
- package/src/layout/pane-manager/gridlock.ts +16 -1
- package/src/layout/pane-manager/index.ts +11 -0
- package/src/layout/pane-manager/layout-state.ts +10 -3
- 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 +126 -1
- package/src/market-data/futures-contract.ts +21 -6
- package/src/market-data/fx-interventions.ts +270 -0
- 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/news/news-model.ts +44 -2
- 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 +223 -32
- 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 +39 -15
- package/src/plugins/builtin/alerts/headless.ts +30 -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 +161 -0
- package/src/plugins/builtin/alerts/move.ts +181 -0
- package/src/plugins/builtin/alerts/pane.tsx +50 -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 +22 -7
- package/src/plugins/builtin/alerts/types.ts +25 -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/changelog/index.tsx +292 -101
- package/src/plugins/builtin/changelog/versions.ts +293 -0
- 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/chart-composer/intervention-events.ts +105 -0
- package/src/plugins/builtin/chart-composer/pane.tsx +21 -7
- package/src/plugins/builtin/chat/message/render-state.ts +2 -5
- package/src/plugins/builtin/cloud/askg/attached-pane.tsx +10 -5
- package/src/plugins/builtin/cloud/askg/controller.ts +141 -5
- package/src/plugins/builtin/cloud/askg/executor.ts +113 -4
- package/src/plugins/builtin/cloud/askg/manifest.ts +28 -13
- package/src/plugins/builtin/cloud/askg/model.ts +14 -4
- package/src/plugins/builtin/cloud/askg/pane.tsx +70 -46
- package/src/plugins/builtin/cloud/askg/turn-parts.tsx +70 -0
- package/src/plugins/builtin/cloud/terminal-relay/engine.ts +50 -130
- package/src/plugins/builtin/cloud/terminal-relay/policy.ts +327 -7
- package/src/plugins/builtin/cloud/terminal-relay/prompts.tsx +2 -1
- package/src/plugins/builtin/cloud/terminal-relay/redact.ts +47 -6
- package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
- package/src/plugins/builtin/commodities-energy/index.tsx +1 -3
- package/src/plugins/builtin/commodities-energy/view-state.ts +3 -0
- package/src/plugins/builtin/cot/headless.ts +14 -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/earnings/index.tsx +2 -2
- 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/index.tsx +25 -4
- package/src/plugins/builtin/futures/model.ts +28 -32
- package/src/plugins/builtin/futures/series.ts +4 -3
- package/src/plugins/builtin/futures/table.tsx +17 -10
- package/src/plugins/builtin/futures/use-board-terms.ts +3 -3
- 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/help/index.tsx +3 -3
- package/src/plugins/builtin/help/keybindings-editor.tsx +18 -4
- 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/layout-manager/index.tsx +8 -8
- package/src/plugins/builtin/news/headless.ts +2 -2
- package/src/plugins/builtin/news/index.tsx +10 -16
- 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 +7 -4
- 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/plugin-marketplace/pane.tsx +11 -11
- 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/summary/index.tsx +3 -1
- 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/research/event-model.ts +9 -1
- package/src/plugins/builtin/research/event-sources.ts +22 -0
- package/src/plugins/builtin/research/headless.ts +3 -3
- 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/cloud-upgrade.ts +27 -3
- 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 +67 -6
- 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 +69 -19
- package/src/plugins/builtin/ticker-detail/pane.tsx +7 -2
- 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 +53 -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/remote/resources.ts +12 -1
- package/src/remote/schema.ts +1 -0
- package/src/remote/semantic-helpers.ts +29 -1
- package/src/remote/semantic-tree.tsx +32 -15
- 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/cloudflare/worker.ts +16 -1
- 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 +73 -19
- package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
- package/src/renderers/opentui/host.tsx +2 -1
- package/src/renderers/share/layout-view.tsx +1 -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/news.ts +35 -12
- package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
- package/src/sources/provider-router/cached-routes.ts +19 -7
- package/src/state/opening-ticker-panes.ts +47 -0
- package/src/state/pane-table-export-registry.ts +19 -6
- package/src/test-support/cli-context.ts +2 -0
- package/src/test-support/preload.ts +8 -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/instrument-kind.ts +23 -3
- 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 +13 -0
- package/src/types/context-menu.ts +2 -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/types/plugin-commands.ts +140 -0
- package/src/types/plugin-context.ts +125 -0
- package/src/types/plugin-contributions.ts +55 -0
- package/src/types/plugin-definition.ts +234 -0
- package/src/types/plugin-notifications.ts +38 -0
- package/src/types/plugin-pane-settings.ts +114 -0
- package/src/types/plugin-pane-templates.ts +160 -0
- package/src/types/plugin-panes.ts +221 -0
- package/src/types/plugin-reports.ts +35 -0
- package/src/types/plugin-shared.ts +14 -0
- package/src/types/plugin-state.ts +71 -0
- package/src/types/plugin.ts +14 -1169
- package/src/ui/host.tsx +8 -0
- package/src/ui/index.tsx +14 -3
- package/src/updater/github-releases.ts +23 -0
- package/src/utils/cli-output.ts +22 -9
- 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
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import type { TickerRecord } from "../types/ticker";
|
|
2
|
+
import { canonicalExchange, canonicalTickerKey, isUsEquityExchange, parsePublicTickerKey } from "../utils/exchanges";
|
|
3
|
+
import { classifyInstrumentType, kindFromListingSyntax } from "../tickers/instrument-kind";
|
|
4
|
+
import { listingSuffixVenue } from "../sources/listing-symbols";
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* A saved symbol as the listing it is: its venue from its key (BA:LSE) or its
|
|
8
|
+
* row, and a vendor's suffix the venue settles taken off (BA.L on LSE is BA).
|
|
9
|
+
*/
|
|
10
|
+
function venueListing(symbol: string, exchange: string | undefined): { symbol: string; exchange: string | undefined } {
|
|
11
|
+
const parsed = parsePublicTickerKey(symbol);
|
|
12
|
+
const venue = parsed.exchange ?? (exchange || undefined);
|
|
13
|
+
return listingSuffixVenue(parsed.symbol, venue) ?? { symbol: parsed.symbol, exchange: venue };
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* The market a row's listing trades in: every US venue is one market (US), as
|
|
18
|
+
* is a broker's SMART routing, which names no venue; any other its venue (LSE, HKEX).
|
|
19
|
+
*/
|
|
20
|
+
function listingMarket(ticker: TickerRecord): string | null {
|
|
21
|
+
const { metadata } = ticker;
|
|
22
|
+
// An index, a pair, a future, a coin or a perpetual is no company's listing on a venue.
|
|
23
|
+
if (kindFromListingSyntax(metadata.ticker, metadata.exchange)) return null;
|
|
24
|
+
const kind = classifyInstrumentType(metadata.assetCategory);
|
|
25
|
+
if (kind && kind !== "equity" && kind !== "fund") return null;
|
|
26
|
+
const exchange = canonicalExchange(venueListing(metadata.ticker, metadata.exchange).exchange);
|
|
27
|
+
if (!exchange) return null;
|
|
28
|
+
return isUsEquityExchange(exchange) || exchange === "SMART" ? "US" : exchange;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* The market most of a list's listings trade in, its home: a list of US names
|
|
33
|
+
* with BAE Systems among them is a US list. US on a tie, or when no row is a
|
|
34
|
+
* listing on a venue.
|
|
35
|
+
*/
|
|
36
|
+
export function listHomeMarket(tickers: Iterable<TickerRecord>): string {
|
|
37
|
+
const counts = new Map<string, number>();
|
|
38
|
+
for (const ticker of tickers) {
|
|
39
|
+
const market = listingMarket(ticker);
|
|
40
|
+
if (market) counts.set(market, (counts.get(market) ?? 0) + 1);
|
|
41
|
+
}
|
|
42
|
+
let home = "US";
|
|
43
|
+
let most = counts.get("US") ?? 0;
|
|
44
|
+
for (const [market, count] of counts) {
|
|
45
|
+
if (count > most) {
|
|
46
|
+
home = market;
|
|
47
|
+
most = count;
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
return home;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* A row's symbol as a list shows it: with its venue (BA:LSE, RHM:XETRA,
|
|
55
|
+
* 0005:HKEX) when it trades outside the list's home market, so BA on LSE never
|
|
56
|
+
* reads as Boeing in a US list; else as `display` writes it.
|
|
57
|
+
*/
|
|
58
|
+
export function listedSymbol(ticker: TickerRecord, display: string, homeMarket: string | undefined): string {
|
|
59
|
+
const market = listingMarket(ticker);
|
|
60
|
+
if (!market || !homeMarket || market === homeMarket || display.includes(":")) return display;
|
|
61
|
+
const listing = venueListing(ticker.metadata.ticker, ticker.metadata.exchange);
|
|
62
|
+
return canonicalTickerKey(listing.symbol, listing.exchange);
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* A listing as an export names it, always with its venue (BA:LSE, AAPL:NASDAQ), so a script never reads BA as
|
|
67
|
+
* Boeing; an index, a pair, a future or a coin is its symbol (^HSI, CL=F), which no venue qualifies.
|
|
68
|
+
*/
|
|
69
|
+
export function exportedListingSymbol(symbol: string, exchange: string | undefined, instrumentType?: string | null): string {
|
|
70
|
+
if (kindFromListingSyntax(symbol, exchange) || classifyInstrumentType(instrumentType) === "index") return parsePublicTickerKey(symbol).symbol;
|
|
71
|
+
const listing = venueListing(symbol, exchange);
|
|
72
|
+
return canonicalTickerKey(listing.symbol, listing.exchange);
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/** A row's listing as an export names it (`exportedListingSymbol`). */
|
|
76
|
+
export function exportedListingKey(ticker: TickerRecord): string {
|
|
77
|
+
return exportedListingSymbol(ticker.metadata.ticker, ticker.metadata.exchange, ticker.metadata.assetCategory);
|
|
78
|
+
}
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
import type { CloudFredObservationPayload, CloudFredSeriesPayload } from "../api-client/types/econ";
|
|
2
|
+
import type { PriceWindow } from "../utils/price-window";
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* A book's return after its currency's consumer prices (`portfolio show
|
|
6
|
+
* --from <date> --real`): the nominal return deflated by the change in the
|
|
7
|
+
* CPI over the period, (1 + nominal) / (1 + inflation) - 1.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
/** Where a currency's consumer prices are read: an index level, or the published changes chained into one. */
|
|
11
|
+
export interface CpiSource {
|
|
12
|
+
currency: string;
|
|
13
|
+
/** The series Gloom Cloud serves at `/cloud/econ/series/:id`: the level, or the change from the month before. */
|
|
14
|
+
series: string;
|
|
15
|
+
/** The change from a year before, read for whole years so a twelve-month period is the published figure. */
|
|
16
|
+
yearSeries?: string;
|
|
17
|
+
kind: "level" | "changes";
|
|
18
|
+
/** "US CPI": what the report names. */
|
|
19
|
+
label: string;
|
|
20
|
+
publisher: string;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export const CPI_SOURCES: Readonly<Record<string, CpiSource>> = {
|
|
24
|
+
// Not seasonally adjusted, as the BLS publishes it and as a period's change is quoted: an adjusted index
|
|
25
|
+
// is revised every year, so the same period would read differently later.
|
|
26
|
+
USD: { currency: "USD", series: "CPIAUCNS", kind: "level", label: "US CPI", publisher: "BLS" },
|
|
27
|
+
// The central bank's table gives TurkStat's changes on the index, not its level: whole years are the
|
|
28
|
+
// year-on-year change TurkStat computes from the level, the months left over its monthly changes.
|
|
29
|
+
TRY: { currency: "TRY", series: "TURCPIMOM", yearSeries: "TURCPIYOY", kind: "changes", label: "Türkiye CPI", publisher: "TurkStat" },
|
|
30
|
+
};
|
|
31
|
+
|
|
32
|
+
/** One published CPI value the figure was read from, as the source gives it. */
|
|
33
|
+
interface CpiReading {
|
|
34
|
+
series: string;
|
|
35
|
+
/** YYYY-MM. */
|
|
36
|
+
month: string;
|
|
37
|
+
value: number;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
export interface PeriodInflation {
|
|
41
|
+
source: CpiSource;
|
|
42
|
+
/** YYYY-MM: the month whose CPI starts the period, the last one out at its start. */
|
|
43
|
+
fromMonth: string;
|
|
44
|
+
/** YYYY-MM: the month whose CPI ends it, the last one out at its end or the latest published. */
|
|
45
|
+
toMonth: string;
|
|
46
|
+
/** The CPI's change between them, as a fraction: 0.2977 for 29.77%. */
|
|
47
|
+
inflation: number;
|
|
48
|
+
/** The end's own month is not published yet, so the latest is used. */
|
|
49
|
+
latestPublished: boolean;
|
|
50
|
+
/** The published values it was computed from: the two levels, or the changes chained. */
|
|
51
|
+
readings: CpiReading[];
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/** YYYY-MM of the month before the one `day` (YYYY-MM-DD) falls in. */
|
|
55
|
+
function monthBefore(day: string): string {
|
|
56
|
+
const [year, month] = day.slice(0, 7).split("-").map(Number) as [number, number];
|
|
57
|
+
return month === 1 ? `${year - 1}-12` : `${year}-${String(month - 1).padStart(2, "0")}`;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
const monthIndex = (month: string) => Number(month.slice(0, 4)) * 12 + Number(month.slice(5, 7)) - 1;
|
|
61
|
+
const indexMonth = (index: number) => `${Math.floor(index / 12)}-${String((index % 12) + 1).padStart(2, "0")}`;
|
|
62
|
+
|
|
63
|
+
function publishedMonths(observations: readonly CloudFredObservationPayload[]) {
|
|
64
|
+
return observations
|
|
65
|
+
.filter((row) => row.value != null && Number.isFinite(row.value))
|
|
66
|
+
.map((row) => ({ month: row.date.slice(0, 7), value: row.value! }))
|
|
67
|
+
.sort((left, right) => left.month.localeCompare(right.month));
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* The CPI's change over a period, from the month before its start's month (the
|
|
72
|
+
* last CPI out when it starts) to the month before its end's, or the latest
|
|
73
|
+
* month published when that is not out yet. A month with no level (the US
|
|
74
|
+
* skipped October 2025) reads the month before it. Published changes chain
|
|
75
|
+
* from the end back: a year-on-year change for each whole year, then the
|
|
76
|
+
* monthly changes of the months left; a missing change leaves it unpriced.
|
|
77
|
+
* Null when the series does not reach either month.
|
|
78
|
+
*/
|
|
79
|
+
export function periodInflation(
|
|
80
|
+
source: CpiSource,
|
|
81
|
+
observations: readonly CloudFredObservationPayload[],
|
|
82
|
+
window: PriceWindow,
|
|
83
|
+
yearOnYear: readonly CloudFredObservationPayload[] = [],
|
|
84
|
+
): PeriodInflation | null {
|
|
85
|
+
const months = publishedMonths(observations);
|
|
86
|
+
if (!months.length) return null;
|
|
87
|
+
const wantedFrom = monthBefore(window.from);
|
|
88
|
+
const wantedTo = monthBefore(window.to);
|
|
89
|
+
const latest = months.at(-1)!.month;
|
|
90
|
+
const toMonth = wantedTo <= latest ? wantedTo : latest;
|
|
91
|
+
const latestPublished = wantedTo > latest;
|
|
92
|
+
// A series that starts after the period's first month says nothing of the months before it.
|
|
93
|
+
if (wantedFrom < months[0]!.month || toMonth < wantedFrom) return null;
|
|
94
|
+
if (source.kind === "level") {
|
|
95
|
+
const at = (month: string) => months.findLast((row) => row.month <= month);
|
|
96
|
+
const start = at(wantedFrom), end = at(toMonth);
|
|
97
|
+
if (!start || !end || end.month < start.month) return null;
|
|
98
|
+
return {
|
|
99
|
+
source, fromMonth: start.month, toMonth: end.month, inflation: end.value / start.value - 1, latestPublished,
|
|
100
|
+
readings: [start, end].map((row) => ({ series: source.series, ...row })),
|
|
101
|
+
};
|
|
102
|
+
}
|
|
103
|
+
const monthly = new Map(months.map((row) => [row.month, row.value]));
|
|
104
|
+
const yearly = new Map(publishedMonths(yearOnYear).map((row) => [row.month, row.value]));
|
|
105
|
+
const readings: CpiReading[] = [];
|
|
106
|
+
let index = 1;
|
|
107
|
+
let at = monthIndex(toMonth);
|
|
108
|
+
const first = monthIndex(wantedFrom);
|
|
109
|
+
while (at - first >= 12 && source.yearSeries && yearly.has(indexMonth(at))) {
|
|
110
|
+
const value = yearly.get(indexMonth(at))!;
|
|
111
|
+
readings.unshift({ series: source.yearSeries, month: indexMonth(at), value });
|
|
112
|
+
index *= 1 + value / 100;
|
|
113
|
+
at -= 12;
|
|
114
|
+
}
|
|
115
|
+
for (; at > first; at--) {
|
|
116
|
+
const value = monthly.get(indexMonth(at));
|
|
117
|
+
if (value == null) return null;
|
|
118
|
+
readings.unshift({ series: source.series, month: indexMonth(at), value });
|
|
119
|
+
index *= 1 + value / 100;
|
|
120
|
+
}
|
|
121
|
+
return { source, fromMonth: wantedFrom, toMonth, inflation: index - 1, latestPublished, readings };
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/** How the figure was read, for the report: `the BLS index`, `TurkStat's year-on-year change`. */
|
|
125
|
+
export function inflationMethodText(read: Pick<PeriodInflation, "source" | "readings" | "fromMonth" | "toMonth">): string {
|
|
126
|
+
const { source, readings } = read;
|
|
127
|
+
if (read.fromMonth === read.toMonth) return `no ${source.publisher} month published inside the period`;
|
|
128
|
+
if (source.kind === "level") return `the ${source.publisher} index`;
|
|
129
|
+
const years = readings.filter((row) => row.series === source.yearSeries).length;
|
|
130
|
+
const months = readings.length - years;
|
|
131
|
+
const parts = [
|
|
132
|
+
...(years ? [years === 1 ? "year-on-year change" : `${years} year-on-year changes`] : []),
|
|
133
|
+
...(months ? [months === 1 ? "monthly change" : `${months} monthly changes`] : []),
|
|
134
|
+
];
|
|
135
|
+
return `${source.publisher}'s ${parts.join(" and ")}${readings.length > 1 ? " chained" : ""}`;
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
/** The real return, as a fraction, of a nominal one after `inflation`. */
|
|
139
|
+
export function realReturn(nominal: number, inflation: number): number {
|
|
140
|
+
return (1 + nominal) / (1 + inflation) - 1;
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
/** `Oct 2025`. */
|
|
144
|
+
export function monthText(month: string): string {
|
|
145
|
+
const [year, number] = month.split("-");
|
|
146
|
+
return `${["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"][Number(number) - 1]} ${year}`;
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
/** Reads a currency's CPI over a window, with a year before it for the starting month. */
|
|
150
|
+
export async function loadPeriodInflation(
|
|
151
|
+
currency: string,
|
|
152
|
+
window: PriceWindow,
|
|
153
|
+
client: { getCloudFredSeries(id: string, params: { startDate: string; endDate: string; limit: number; sortOrder: "asc" }): Promise<CloudFredSeriesPayload> },
|
|
154
|
+
): Promise<PeriodInflation | { error: string }> {
|
|
155
|
+
const source = CPI_SOURCES[currency];
|
|
156
|
+
if (!source) {
|
|
157
|
+
const known = Object.keys(CPI_SOURCES).join(" and ");
|
|
158
|
+
return { error: `--real deflates by the consumer prices of a ${known} portfolio; there is no ${currency} CPI series here.` };
|
|
159
|
+
}
|
|
160
|
+
const startYear = Number(window.from.slice(0, 4)) - 1;
|
|
161
|
+
const params = { startDate: `${startYear}${window.from.slice(4, 7)}-01`, endDate: window.to, limit: 1000, sortOrder: "asc" as const };
|
|
162
|
+
try {
|
|
163
|
+
const [payload, yearly] = await Promise.all([
|
|
164
|
+
client.getCloudFredSeries(source.series, params),
|
|
165
|
+
source.yearSeries ? client.getCloudFredSeries(source.yearSeries, params) : null,
|
|
166
|
+
]);
|
|
167
|
+
return periodInflation(source, payload.observations, window, yearly?.observations)
|
|
168
|
+
?? { error: `${source.label} does not cover ${window.from} to ${window.to}.` };
|
|
169
|
+
} catch (error) {
|
|
170
|
+
return { error: `${source.label} could not be read: ${error instanceof Error ? error.message : String(error)}` };
|
|
171
|
+
}
|
|
172
|
+
}
|
package/src/remote/resources.ts
CHANGED
|
@@ -4,7 +4,8 @@ import { apiClient } from "../api-client";
|
|
|
4
4
|
import type { AppAction, AppState } from "../state/app/context";
|
|
5
5
|
import type { PaneRuntimeState } from "../core/state/app/state";
|
|
6
6
|
import { setPaneSettings } from "../pane-settings";
|
|
7
|
-
import type
|
|
7
|
+
import { findPaneInstance, type LayoutConfig } from "../types/config";
|
|
8
|
+
import { getBasePaneDisplayTitle } from "../components/layout/pane/title";
|
|
8
9
|
import { commandBarResultsFromNodes, commandBarSnapshot } from "./command-bar";
|
|
9
10
|
import { formSnapshot } from "./form";
|
|
10
11
|
import type { RemoteUiRegistry } from "./semantic-tree";
|
|
@@ -150,6 +151,16 @@ export function createRemoteResources({
|
|
|
150
151
|
if (resource === "app://accounts") return brokerAccountsResource(state);
|
|
151
152
|
if (resource === "app://remote/help") return REMOTE_AGENT_HELP;
|
|
152
153
|
if (resource === "ui://tree") return uiNodes;
|
|
154
|
+
if (resource.startsWith("ui://node/")) {
|
|
155
|
+
const nodeId = decodeURIComponent(resource.slice("ui://node/".length));
|
|
156
|
+
const node = uiRegistry?.detail(nodeId);
|
|
157
|
+
if (!node) throw new Error(`No UI node "${nodeId}" is on screen. Read ui://tree for the current ones.`);
|
|
158
|
+
const pane = node.paneId ? findPaneInstance(state.config.layout, node.paneId) : undefined;
|
|
159
|
+
const paneDef = pane ? pluginRegistry.panes.get(pane.paneId) : undefined;
|
|
160
|
+
return pane && paneDef
|
|
161
|
+
? { ...node, paneTitle: getBasePaneDisplayTitle(state, pane, paneDef, pluginRegistry.panes) }
|
|
162
|
+
: node;
|
|
163
|
+
}
|
|
153
164
|
throw new Error(`Unknown remote resource "${resource}".`);
|
|
154
165
|
};
|
|
155
166
|
|
package/src/remote/schema.ts
CHANGED
|
@@ -32,6 +32,7 @@ export const REMOTE_RESOURCES: RemoteResourceSchema[] = [
|
|
|
32
32
|
{ uri: "app://auth", description: "What the client believes about its cloud session: credential present, checked, cached user plan and verification. No secrets." },
|
|
33
33
|
{ uri: "app://remote/help", description: "Agent-oriented remote usage guide with efficient recipes and caveats." },
|
|
34
34
|
{ uri: "ui://tree", description: "Live semantic UI node tree populated by shared controls and interactive primitives." },
|
|
35
|
+
{ uri: "ui://node/{nodeId}", description: "One node of ui://tree with what the tree leaves out: the title of the pane it is in and, for a table, every row." },
|
|
35
36
|
];
|
|
36
37
|
|
|
37
38
|
const stringSchema = { type: "string" } satisfies RemoteJsonSchema;
|
|
@@ -105,7 +105,7 @@ interface RemoteIndexSelectors<T> {
|
|
|
105
105
|
value?: RemoteItemSelector<T>;
|
|
106
106
|
}
|
|
107
107
|
|
|
108
|
-
|
|
108
|
+
function resolveRemoteItemIndex<T>(
|
|
109
109
|
input: unknown,
|
|
110
110
|
items: readonly T[],
|
|
111
111
|
selectors: RemoteIndexSelectors<T>,
|
|
@@ -125,6 +125,34 @@ export function resolveRemoteItemIndex<T>(
|
|
|
125
125
|
return -1;
|
|
126
126
|
}
|
|
127
127
|
|
|
128
|
+
// How each kit control picks an item for a remote action. The control and the
|
|
129
|
+
// policy that names the item before it runs (terminal-relay/policy.ts) both
|
|
130
|
+
// call these, so the item a person is asked about is the one that runs.
|
|
131
|
+
|
|
132
|
+
/** A Menu's `select`: the id itself, or `{ id }`, and nothing else. */
|
|
133
|
+
export function remoteMenuItemId(input: unknown): string | undefined {
|
|
134
|
+
if (typeof input === "string") return input;
|
|
135
|
+
const id = remoteObjectProp(input, "id");
|
|
136
|
+
return typeof id === "string" ? id : undefined;
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/** A ListView's `select` and `activate`: by index, id or label. */
|
|
140
|
+
export function resolveRemoteListIndex<T extends { id?: unknown; label?: unknown }>(input: unknown, items: readonly T[]): number {
|
|
141
|
+
return resolveRemoteItemIndex(input, items, {
|
|
142
|
+
id: (item) => (typeof item.id === "string" ? item.id : undefined),
|
|
143
|
+
label: (item) => (typeof item.label === "string" ? item.label : undefined),
|
|
144
|
+
});
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
/** A DataTable's `selectRow` and `activateRow`: by index, or by the row's key as `id` or `key`. */
|
|
148
|
+
export function resolveRemoteRowIndex<T>(
|
|
149
|
+
input: unknown,
|
|
150
|
+
rows: readonly T[],
|
|
151
|
+
keyOf: (row: T, index: number) => string | undefined,
|
|
152
|
+
): number {
|
|
153
|
+
return resolveRemoteItemIndex(input, rows, { id: keyOf, key: keyOf });
|
|
154
|
+
}
|
|
155
|
+
|
|
128
156
|
function remoteChartScroll(input: unknown) {
|
|
129
157
|
if (!input || typeof input !== "object") return undefined;
|
|
130
158
|
const record = input as Record<string, unknown>;
|
|
@@ -19,6 +19,11 @@ export interface RemoteUiNodeRegistration {
|
|
|
19
19
|
metadata?: Record<string, unknown>;
|
|
20
20
|
/** Defers expensive metadata projection until a remote snapshot requests it. */
|
|
21
21
|
getMetadata?: () => Record<string, unknown>;
|
|
22
|
+
/**
|
|
23
|
+
* What the tree leaves out for its size, read only for this one node
|
|
24
|
+
* (`ui://node/{id}`): a table's every row. Merged over its metadata.
|
|
25
|
+
*/
|
|
26
|
+
getDetail?: () => Record<string, unknown>;
|
|
22
27
|
}
|
|
23
28
|
|
|
24
29
|
interface RegisteredRemoteUiNode {
|
|
@@ -30,11 +35,29 @@ export interface RemoteUiRegistry {
|
|
|
30
35
|
register(id: string, registration: RemoteUiNodeRegistration): void;
|
|
31
36
|
unregister(id: string): void;
|
|
32
37
|
snapshot(): RemoteUiNodeSnapshot[];
|
|
38
|
+
/** One node as the tree has it, with its detail; null when it is not on screen. */
|
|
39
|
+
detail(nodeId: string): RemoteUiNodeSnapshot | null;
|
|
33
40
|
invoke(nodeId: string, action: string, input?: unknown): Promise<unknown>;
|
|
34
41
|
}
|
|
35
42
|
|
|
36
43
|
const RemoteUiRegistryContext = createContext<RemoteUiRegistry | null>(null);
|
|
37
44
|
|
|
45
|
+
function nodeSnapshot(node: RegisteredRemoteUiNode): RemoteUiNodeSnapshot {
|
|
46
|
+
const registration = node.registration;
|
|
47
|
+
return {
|
|
48
|
+
id: node.id,
|
|
49
|
+
role: registration.role,
|
|
50
|
+
label: registration.label,
|
|
51
|
+
disabled: registration.disabled,
|
|
52
|
+
actions: Object.entries(registration.actions ?? {})
|
|
53
|
+
.filter((entry): entry is [string, RemoteUiAction] => typeof entry[1] === "function")
|
|
54
|
+
.map(([action]) => action)
|
|
55
|
+
.sort(),
|
|
56
|
+
metadata: registration.getMetadata?.() ?? registration.metadata,
|
|
57
|
+
...(registration.paneId ? { paneId: registration.paneId } : {}),
|
|
58
|
+
};
|
|
59
|
+
}
|
|
60
|
+
|
|
38
61
|
export function createRemoteUiRegistry(): RemoteUiRegistry {
|
|
39
62
|
const nodes = new Map<string, RegisteredRemoteUiNode>();
|
|
40
63
|
|
|
@@ -46,21 +69,14 @@ export function createRemoteUiRegistry(): RemoteUiRegistry {
|
|
|
46
69
|
nodes.delete(id);
|
|
47
70
|
},
|
|
48
71
|
snapshot() {
|
|
49
|
-
return [...nodes.values()].map(
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
.filter((entry): entry is [string, RemoteUiAction] => typeof entry[1] === "function")
|
|
58
|
-
.map(([action]) => action)
|
|
59
|
-
.sort(),
|
|
60
|
-
metadata: registration.getMetadata?.() ?? registration.metadata,
|
|
61
|
-
...(registration.paneId ? { paneId: registration.paneId } : {}),
|
|
62
|
-
};
|
|
63
|
-
});
|
|
72
|
+
return [...nodes.values()].map(nodeSnapshot);
|
|
73
|
+
},
|
|
74
|
+
detail(nodeId) {
|
|
75
|
+
const node = nodes.get(nodeId);
|
|
76
|
+
if (!node) return null;
|
|
77
|
+
const snapshot = nodeSnapshot(node);
|
|
78
|
+
const detail = node.registration.getDetail?.();
|
|
79
|
+
return detail ? { ...snapshot, metadata: { ...snapshot.metadata, ...detail } } : snapshot;
|
|
64
80
|
},
|
|
65
81
|
async invoke(nodeId, action, input) {
|
|
66
82
|
const node = nodes.get(nodeId);
|
|
@@ -149,6 +165,7 @@ export function useRemoteUiNode(registration: RemoteUiNodeRegistration | null |
|
|
|
149
165
|
get actions() { return registrationRef.current?.actions; },
|
|
150
166
|
get metadata() { return registrationRef.current?.metadata; },
|
|
151
167
|
get getMetadata() { return registrationRef.current?.getMetadata; },
|
|
168
|
+
get getDetail() { return registrationRef.current?.getDetail; },
|
|
152
169
|
};
|
|
153
170
|
}
|
|
154
171
|
const nodeId = nodeIdRef.current;
|
|
@@ -13,7 +13,11 @@ import {
|
|
|
13
13
|
type AppConfig,
|
|
14
14
|
type DockLayoutNode,
|
|
15
15
|
type LayoutConfig,
|
|
16
|
+
type SavedLayout,
|
|
16
17
|
} from "../../types/config";
|
|
18
|
+
import { buildDockStack } from "../../layout/pane-manager/dock-stack";
|
|
19
|
+
import { getDockedPaneIds } from "../../layout/pane-manager/dock-tree";
|
|
20
|
+
import { holdsPaneGrid } from "../../layout/pane-manager/gridlock";
|
|
17
21
|
import { researchEntryFromSearch } from "./research-entry";
|
|
18
22
|
import { BROWSER_STORAGE_KEYS, SafeJsonStorage, type StorageLike } from "../../data/json-storage";
|
|
19
23
|
import { stopBootFrameRecorders } from "../dom/boot-frame";
|
|
@@ -42,16 +46,29 @@ function column(first: string, second: string, ratio = 0.5): DockLayoutNode {
|
|
|
42
46
|
};
|
|
43
47
|
}
|
|
44
48
|
|
|
49
|
+
/** The window in grid cells, for the first-visit workspace to fit. */
|
|
50
|
+
export type BrowserScreen = { width: number; height: number };
|
|
51
|
+
|
|
52
|
+
/** Without a screen to fit, the grid. */
|
|
53
|
+
function holdsGrid(screen: BrowserScreen | undefined): boolean {
|
|
54
|
+
return !screen || holdsPaneGrid(screen);
|
|
55
|
+
}
|
|
56
|
+
|
|
45
57
|
/**
|
|
46
58
|
* The first-visit workspace: six panes, with one company down the middle.
|
|
47
59
|
* The research pane owns the symbol; the news and chart panes follow it, so
|
|
48
60
|
* typing a new ticker while the research pane is focused swaps all three.
|
|
49
61
|
* The market panes on either side stay put.
|
|
62
|
+
*
|
|
63
|
+
* A screen that holds no grid of panes (a phone, upright or on its side) gets
|
|
64
|
+
* the same panes as one stack of tabs at the full width instead, the
|
|
65
|
+
* company's first and the research pane in front: six panes side by side
|
|
66
|
+
* there were a dozen columns each.
|
|
50
67
|
*/
|
|
51
|
-
export function createBrowserResearchLayout(symbol: string): LayoutConfig {
|
|
68
|
+
export function createBrowserResearchLayout(symbol: string, screen?: BrowserScreen): LayoutConfig {
|
|
52
69
|
const follow = { kind: "follow" as const, sourceInstanceId: BROWSER_RESEARCH_PANE_ID };
|
|
53
|
-
|
|
54
|
-
|
|
70
|
+
const dockRoot: DockLayoutNode = holdsGrid(screen)
|
|
71
|
+
? {
|
|
55
72
|
kind: "split",
|
|
56
73
|
axis: "horizontal",
|
|
57
74
|
ratio: 0.3,
|
|
@@ -63,7 +80,17 @@ export function createBrowserResearchLayout(symbol: string): LayoutConfig {
|
|
|
63
80
|
first: column(BROWSER_RESEARCH_PANE_ID, BROWSER_RESEARCH_NEWS_ID),
|
|
64
81
|
second: column(BROWSER_RESEARCH_CHART_ID, BROWSER_ECON_CALENDAR_ID),
|
|
65
82
|
},
|
|
66
|
-
}
|
|
83
|
+
}
|
|
84
|
+
: buildDockStack([
|
|
85
|
+
BROWSER_RESEARCH_PANE_ID,
|
|
86
|
+
BROWSER_RESEARCH_CHART_ID,
|
|
87
|
+
BROWSER_RESEARCH_NEWS_ID,
|
|
88
|
+
BROWSER_WORLD_INDICES_ID,
|
|
89
|
+
BROWSER_SECTORS_ID,
|
|
90
|
+
BROWSER_ECON_CALENDAR_ID,
|
|
91
|
+
], BROWSER_RESEARCH_PANE_ID)!;
|
|
92
|
+
return {
|
|
93
|
+
dockRoot,
|
|
67
94
|
instances: [
|
|
68
95
|
{ instanceId: BROWSER_WORLD_INDICES_ID, paneId: "world-indices", binding: { kind: "none" } },
|
|
69
96
|
{ instanceId: BROWSER_SECTORS_ID, paneId: "sectors", binding: { kind: "none" } },
|
|
@@ -82,29 +109,42 @@ export function createBrowserResearchLayout(symbol: string): LayoutConfig {
|
|
|
82
109
|
};
|
|
83
110
|
}
|
|
84
111
|
|
|
85
|
-
|
|
112
|
+
/** A starter tab's panes as one stack, in the order its layout lists them, the focused one (or the first) in front. */
|
|
113
|
+
function asOneStack(saved: SavedLayout): SavedLayout {
|
|
114
|
+
return { ...saved, layout: { ...saved.layout, dockRoot: buildDockStack(getDockedPaneIds(saved.layout), saved.focusedPaneId) } };
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
function createBrowserDefaultConfig(dataDir: string, search = "", screen?: BrowserScreen): AppConfig {
|
|
86
118
|
const config = createDefaultConfig(dataDir);
|
|
87
119
|
const entry = researchEntryFromSearch(search) ?? { symbol: "NVDA", tab: "overview" };
|
|
88
120
|
// A first visit starts with a research workspace around one company. Saved
|
|
89
|
-
// layouts retain their existing panes and bindings when a visitor returns
|
|
90
|
-
|
|
121
|
+
// layouts retain their existing panes and bindings when a visitor returns,
|
|
122
|
+
// on any screen.
|
|
123
|
+
const research: SavedLayout = {
|
|
91
124
|
name: "Research",
|
|
92
|
-
layout: createBrowserResearchLayout(entry.symbol),
|
|
125
|
+
layout: createBrowserResearchLayout(entry.symbol, screen),
|
|
93
126
|
paneState: { [BROWSER_RESEARCH_PANE_ID]: { activeTabId: entry.tab } },
|
|
94
127
|
focusedPaneId: BROWSER_RESEARCH_PANE_ID,
|
|
95
128
|
};
|
|
96
|
-
|
|
129
|
+
// The tabs beside it fit the screen the same way: a phone gets each as one stack.
|
|
130
|
+
const rest = config.layouts.slice(1);
|
|
131
|
+
config.layouts = [research, ...holdsGrid(screen) ? rest : rest.map(asOneStack)];
|
|
132
|
+
config.layout = research.layout;
|
|
97
133
|
return browserReady(config);
|
|
98
134
|
}
|
|
99
135
|
|
|
100
|
-
|
|
136
|
+
/**
|
|
137
|
+
* `screen` is read when the starter workspace is made (a first visit, or a
|
|
138
|
+
* reset), so it fits the window then; without one it is the grid.
|
|
139
|
+
*/
|
|
140
|
+
export function createBrowserConfigStore(storage: StorageLike, search = "", screen?: () => BrowserScreen): ConfigStoreHost {
|
|
101
141
|
const data = new SafeJsonStorage<unknown>(storage, BROWSER_STORAGE_KEYS.config, null);
|
|
102
142
|
return {
|
|
103
143
|
async getDataDir() { return BROWSER_DATA_DIR; },
|
|
104
144
|
async loadConfig(dataDir) {
|
|
105
145
|
const saved = data.get();
|
|
106
146
|
if (!saved || typeof saved !== "object" || Array.isArray(saved)) {
|
|
107
|
-
return createBrowserDefaultConfig(dataDir, search);
|
|
147
|
+
return createBrowserDefaultConfig(dataDir, search, screen?.());
|
|
108
148
|
}
|
|
109
149
|
return browserReady(normalizeLoadedConfig(saved as Record<string, unknown>, dataDir).config);
|
|
110
150
|
},
|
|
@@ -112,7 +152,7 @@ export function createBrowserConfigStore(storage: StorageLike, search = ""): Con
|
|
|
112
152
|
data.set(normalizeConfigForSave(browserReady({ ...config, dataDir: BROWSER_DATA_DIR })));
|
|
113
153
|
},
|
|
114
154
|
async initDataDir(dataDir) {
|
|
115
|
-
const config = createBrowserDefaultConfig(dataDir, search);
|
|
155
|
+
const config = createBrowserDefaultConfig(dataDir, search, screen?.());
|
|
116
156
|
data.set(config);
|
|
117
157
|
return config;
|
|
118
158
|
},
|
|
@@ -122,7 +162,7 @@ export function createBrowserConfigStore(storage: StorageLike, search = ""): Con
|
|
|
122
162
|
for (const key of Object.values(BROWSER_STORAGE_KEYS)) {
|
|
123
163
|
try { storage.removeItem(key); } catch (error) { logFailure("web-config", "Could not remove saved browser data on reset")(error); }
|
|
124
164
|
}
|
|
125
|
-
data.set(createBrowserDefaultConfig(dataDir, search));
|
|
165
|
+
data.set(createBrowserDefaultConfig(dataDir, search, screen?.()));
|
|
126
166
|
},
|
|
127
167
|
async exportConfig() {
|
|
128
168
|
throw new Error("Config file export is unavailable in the browser.");
|
|
@@ -143,6 +183,7 @@ export function hasSavedBrowserConfig(storage: StorageLike = localStorage): bool
|
|
|
143
183
|
}
|
|
144
184
|
}
|
|
145
185
|
|
|
146
|
-
|
|
147
|
-
|
|
186
|
+
/** `screen` gives the window in cells, as the renderer reports it to the dock and Tidy. */
|
|
187
|
+
export function installBrowserConfigStore(screen: () => BrowserScreen, storage: StorageLike = localStorage): void {
|
|
188
|
+
setConfigStoreHost(createBrowserConfigStore(storage, typeof location !== "undefined" ? location.search : "", screen));
|
|
148
189
|
}
|
|
@@ -9,6 +9,7 @@ import { getBrowserPlugins } from "../../plugins/catalog-browser";
|
|
|
9
9
|
import { DomErrorBoundary, DomHostProviders } from "../dom/dom-host-providers";
|
|
10
10
|
import { installFocusScopeRelease } from "../dom/host/focus-scope";
|
|
11
11
|
import { installDomMarketDataFrames } from "../dom/data-frames";
|
|
12
|
+
import { webNativeRenderer } from "../dom/native-renderer";
|
|
12
13
|
import { releaseBootFrameWhenDrawn, startBootFrameRecorder } from "../dom/boot-frame";
|
|
13
14
|
import { BROWSER_STORAGE_KEYS } from "../../data/json-storage";
|
|
14
15
|
import { createBrowserAppServices } from "./app-services";
|
|
@@ -57,7 +58,8 @@ const BOOT_FRAME_RELEASE_FALLBACK_MS = 4_000;
|
|
|
57
58
|
async function boot(): Promise<void> {
|
|
58
59
|
// Read before anything can save a workspace.
|
|
59
60
|
const savedLayout = hasSavedBrowserConfig();
|
|
60
|
-
|
|
61
|
+
// A first visit's workspace fits the window it opens in.
|
|
62
|
+
installBrowserConfigStore(() => ({ width: webNativeRenderer.terminalWidth, height: webNativeRenderer.terminalHeight }));
|
|
61
63
|
let loadedConfig: AppConfig | null = null;
|
|
62
64
|
installCrashReporter({
|
|
63
65
|
surface: "web",
|
|
@@ -14,6 +14,7 @@ export const browserUiHost: UiHost = createDomUiHost("browser", {
|
|
|
14
14
|
export const browserRendererHost: RendererHost = {
|
|
15
15
|
supportsNativeDesktopNotifications: false,
|
|
16
16
|
requestExit() {},
|
|
17
|
+
canExit: false,
|
|
17
18
|
notify() {},
|
|
18
19
|
async openExternal(rawUrl) {
|
|
19
20
|
const url = safeExternalUrl(rawUrl);
|
|
@@ -63,6 +63,7 @@ export const SIGNED_OUT_ROUTES: Readonly<Record<string, readonly SignedOutRoute[
|
|
|
63
63
|
"nasdaqtrader.com": [{ methods: READ, path: "/rss.aspx" }],
|
|
64
64
|
"production.dataviz.cnn.io": [{ methods: READ, path: "/index/fearandgreed/" }],
|
|
65
65
|
"services-dynarep.ddwa.finra.org": [{ methods: ["POST"], path: "/public/reporting/v2/data/group/" }],
|
|
66
|
+
"www.treasurydirect.gov": [{ methods: READ, path: "/TA_WS/securities/search" }],
|
|
66
67
|
};
|
|
67
68
|
|
|
68
69
|
/** Whether a caller without a confirmed session may send `method` to `url`. */
|
|
@@ -140,6 +140,20 @@ export function withSecurityHeaders(response: Response, options: { share?: boole
|
|
|
140
140
|
return new Response(response.body, { status: response.status, statusText: response.statusText, headers });
|
|
141
141
|
}
|
|
142
142
|
|
|
143
|
+
/**
|
|
144
|
+
* Where a `/api/...` request goes: the API origin followed by the rest of the
|
|
145
|
+
* path, which must start with exactly one slash. The path is appended, never
|
|
146
|
+
* resolved against the origin, since `//host/x` (or `\host/x`, which the URL
|
|
147
|
+
* parser reads as the same) resolves to another host. Anything that does not
|
|
148
|
+
* end up on the API origin gets no upstream.
|
|
149
|
+
*/
|
|
150
|
+
function apiUpstreamUrl(url: URL): URL | null {
|
|
151
|
+
const path = url.pathname.slice("/api".length) || "/";
|
|
152
|
+
if (!path.startsWith("/") || /^\/[/\\]/.test(path)) return null;
|
|
153
|
+
const upstream = new URL(`${API_ORIGIN}${path}${url.search}`);
|
|
154
|
+
return upstream.origin === API_ORIGIN ? upstream : null;
|
|
155
|
+
}
|
|
156
|
+
|
|
143
157
|
async function proxyApi(request: Request, fetchApi: ApiFetch): Promise<Response> {
|
|
144
158
|
const url = new URL(request.url);
|
|
145
159
|
if (!API_METHODS.has(request.method)) {
|
|
@@ -152,7 +166,8 @@ async function proxyApi(request: Request, fetchApi: ApiFetch): Promise<Response>
|
|
|
152
166
|
if (origin && origin !== url.origin) {
|
|
153
167
|
return Response.json({ error: "Origin not allowed" }, { status: 403 });
|
|
154
168
|
}
|
|
155
|
-
const upstreamUrl =
|
|
169
|
+
const upstreamUrl = apiUpstreamUrl(url);
|
|
170
|
+
if (!upstreamUrl) return Response.json({ error: "Not found" }, { status: 404 });
|
|
156
171
|
return fetchApi(new Request(upstreamUrl, request));
|
|
157
172
|
}
|
|
158
173
|
|
|
@@ -31,8 +31,8 @@ const FRAME_ROLES = ["app-header", "pane-window", "dock-divider", "status-bar"];
|
|
|
31
31
|
const FRAME_SELECTOR = FRAME_ROLES.map((role) => `[data-gloom-role="${role}"]`).join(", ");
|
|
32
32
|
/**
|
|
33
33
|
* Kept empty: pane bodies and footers are most of the page and are the data
|
|
34
|
-
* the app fills from its cache as it starts. The market
|
|
35
|
-
*
|
|
34
|
+
* the app fills from its cache as it starts. The header's market and its
|
|
35
|
+
* state, an update status said last session ("Restart to update") and
|
|
36
36
|
* the status bar's widgets (an unread count, the account) are not true at the
|
|
37
37
|
* next launch.
|
|
38
38
|
*/
|