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.
Files changed (362) hide show
  1. package/README.md +1 -1
  2. package/README.zh-CN.md +1 -1
  3. package/package.json +2 -1
  4. package/src/account/auth-form.tsx +13 -8
  5. package/src/account/upgrade-dialog.tsx +1 -1
  6. package/src/api-client/central-bank-rates.ts +5 -0
  7. package/src/api-client/data.ts +17 -4
  8. package/src/api-client/debt-maturities.ts +45 -2
  9. package/src/api-client/earnings.ts +4 -2
  10. package/src/api-client/errors.ts +21 -11
  11. package/src/api-client/index.ts +1 -0
  12. package/src/api-client/paths.ts +9 -1
  13. package/src/api-client/social-mentions.ts +47 -0
  14. package/src/api-client/types/econ.ts +4 -0
  15. package/src/app.tsx +11 -1
  16. package/src/cli/command-options.ts +2 -1
  17. package/src/cli/commands/market.ts +111 -29
  18. package/src/cli/commands/options-chain.ts +23 -6
  19. package/src/cli/commands/overview.ts +13 -5
  20. package/src/cli/commands/plugins.ts +49 -18
  21. package/src/cli/commands/search.ts +25 -6
  22. package/src/cli/commands/ticker.ts +4 -2
  23. package/src/cli/fx-quote-rate.ts +49 -1
  24. package/src/cli/glossary.ts +95 -15
  25. package/src/cli/history-rows.ts +9 -25
  26. package/src/cli/index.ts +6 -38
  27. package/src/cli/known-gaps.ts +3 -3
  28. package/src/cli/listing-arg.ts +78 -18
  29. package/src/cli/name-entries.ts +3 -2
  30. package/src/cli/not-a-ticker.ts +6 -2
  31. package/src/cli/pane-functions/capabilities.ts +12 -1
  32. package/src/cli/pane-functions/function-help.ts +23 -11
  33. package/src/cli/pane-functions/headless.ts +3 -1
  34. package/src/cli/pane-functions/index.ts +32 -4
  35. package/src/cli/pane-functions/market-session.ts +8 -3
  36. package/src/cli/pane-functions/resolver.ts +18 -11
  37. package/src/cli/pane-functions/screenshot-payload.ts +36 -6
  38. package/src/cli/pane-functions/screenshot-render.ts +4 -0
  39. package/src/cli/quote-answer.ts +10 -0
  40. package/src/cli/report-tables.ts +22 -2
  41. package/src/cli/result.ts +7 -3
  42. package/src/cli/spreadsheet-hint.ts +43 -0
  43. package/src/cli/symbol-list.ts +58 -4
  44. package/src/cli/symbol-rows.ts +49 -2
  45. package/src/cli/ticker-resolution.ts +98 -5
  46. package/src/cli/unknown-command.ts +88 -0
  47. package/src/components/command-bar/assist/model.ts +6 -1
  48. package/src/components/command-bar/commands/direct/index.ts +9 -1
  49. package/src/components/command-bar/commands/registry.ts +18 -0
  50. package/src/components/command-bar/pane-actions.ts +30 -13
  51. package/src/components/command-bar/panel/index.tsx +6 -3
  52. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  53. package/src/components/command-bar/panel/types.ts +3 -0
  54. package/src/components/command-bar/routes/header-market.ts +108 -0
  55. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  56. package/src/components/command-bar/routes/root/provider-search.ts +190 -32
  57. package/src/components/command-bar/routes/root/results.ts +3 -0
  58. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  59. package/src/components/command-bar/routes/ticker-search/results.ts +53 -6
  60. package/src/components/command-bar/routing/list-state.ts +38 -0
  61. package/src/components/command-bar/selection-hint.ts +28 -0
  62. package/src/components/command-bar/surface/index.tsx +41 -3
  63. package/src/components/command-bar/view-model.ts +15 -0
  64. package/src/components/command-bar/workflow/tickers.ts +3 -2
  65. package/src/components/company-logo.tsx +20 -2
  66. package/src/components/data-table/export.ts +13 -8
  67. package/src/components/feedback-dialog.tsx +2 -1
  68. package/src/components/form-modal/field-row.tsx +2 -1
  69. package/src/components/input-search-bar.tsx +2 -2
  70. package/src/components/layout/double-escape-close.ts +8 -5
  71. package/src/components/layout/header.tsx +75 -44
  72. package/src/components/layout/market-summary.ts +322 -116
  73. package/src/components/layout/pane/footer/index.tsx +26 -8
  74. package/src/components/layout/pane/footer/model.ts +46 -20
  75. package/src/components/layout/pane/header.tsx +3 -2
  76. package/src/components/layout/shell/chrome.ts +15 -15
  77. package/src/components/layout/status-bar.tsx +8 -7
  78. package/src/components/layout/status-widget-space.ts +8 -0
  79. package/src/components/markdown-editor.tsx +2 -2
  80. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  81. package/src/components/onboarding/onboarding-keyboard.ts +15 -6
  82. package/src/components/onboarding/onboarding-wizard.tsx +61 -11
  83. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  84. package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
  85. package/src/components/price-sparkline/model.ts +26 -10
  86. package/src/components/ticker/list-table-view.tsx +29 -4
  87. package/src/components/ui/button.tsx +13 -2
  88. package/src/components/ui/column-grid.tsx +18 -9
  89. package/src/components/ui/data-table/index.tsx +1 -1
  90. package/src/components/ui/data-table/opentui/index.tsx +2 -1
  91. package/src/components/ui/data-table/types.ts +18 -0
  92. package/src/components/ui/delayed-mark.tsx +3 -2
  93. package/src/components/ui/field-grid.tsx +0 -2
  94. package/src/components/ui/fields.tsx +7 -4
  95. package/src/components/ui/inline-quick-add.tsx +2 -2
  96. package/src/components/ui/key-hint-words.ts +153 -0
  97. package/src/components/ui/key-hints.tsx +73 -0
  98. package/src/components/ui/menu.tsx +3 -1
  99. package/src/components/ui/message-composer.tsx +2 -2
  100. package/src/components/ui/shortcut-hint.tsx +28 -3
  101. package/src/components/ui/tabs.tsx +7 -0
  102. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  103. package/src/core/state/app/command-bar-launch.ts +3 -0
  104. package/src/data/config/store/normalize.ts +6 -0
  105. package/src/docs/snapshot.json +120 -69
  106. package/src/i18n/es.ts +24 -1
  107. package/src/i18n/ja.ts +24 -1
  108. package/src/i18n/ko.ts +24 -1
  109. package/src/i18n/zh-cn.ts +24 -1
  110. package/src/i18n/zh-tw.ts +24 -1
  111. package/src/layout/pane-manager/gridlock.ts +11 -0
  112. package/src/market-data/bars-per-year.ts +27 -9
  113. package/src/market-data/coordinator/quotes.ts +22 -3
  114. package/src/market-data/futures-board.ts +80 -0
  115. package/src/market-data/futures-contract.ts +9 -3
  116. package/src/market-data/market/change-basis.ts +2 -2
  117. package/src/market-data/market/dated-previous-close.ts +163 -47
  118. package/src/market-data/market/format.ts +14 -3
  119. package/src/market-data/market/freshness.ts +24 -7
  120. package/src/market-data/market/header-market.ts +154 -0
  121. package/src/market-data/market/index-level.ts +29 -0
  122. package/src/market-data/market/index-session-venues.ts +44 -0
  123. package/src/market-data/market/status.ts +7 -2
  124. package/src/market-data/market/venue-session.ts +72 -0
  125. package/src/market-data/model-dividend-yield.ts +23 -8
  126. package/src/market-data/options-alternatives.ts +39 -4
  127. package/src/market-data/published-apac-sessions.ts +40 -2
  128. package/src/market-data/quotes/export-identity.ts +76 -0
  129. package/src/market-data/quotes/freshness.ts +22 -0
  130. package/src/market-data/quotes/time.ts +42 -1
  131. package/src/market-data/realized-volatility.ts +11 -7
  132. package/src/market-data/tax-equivalent.ts +145 -27
  133. package/src/plugins/builtin/account-management/pane.tsx +2 -2
  134. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  135. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  136. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  137. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  138. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  139. package/src/plugins/builtin/alerts/cli.ts +224 -33
  140. package/src/plugins/builtin/alerts/command.ts +33 -6
  141. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  142. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  143. package/src/plugins/builtin/alerts/events.ts +9 -0
  144. package/src/plugins/builtin/alerts/format.ts +40 -15
  145. package/src/plugins/builtin/alerts/headless.ts +31 -18
  146. package/src/plugins/builtin/alerts/history.ts +1 -0
  147. package/src/plugins/builtin/alerts/index.tsx +86 -12
  148. package/src/plugins/builtin/alerts/live.ts +2 -1
  149. package/src/plugins/builtin/alerts/move-checks.ts +155 -0
  150. package/src/plugins/builtin/alerts/move.ts +160 -0
  151. package/src/plugins/builtin/alerts/pane.tsx +52 -22
  152. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  153. package/src/plugins/builtin/alerts/price.ts +17 -0
  154. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  155. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  156. package/src/plugins/builtin/alerts/storage.ts +20 -7
  157. package/src/plugins/builtin/alerts/types.ts +13 -0
  158. package/src/plugins/builtin/analytics/risk-client.ts +60 -39
  159. package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
  160. package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
  161. package/src/plugins/builtin/analytics/risk-model.ts +68 -1
  162. package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
  163. package/src/plugins/builtin/backtest/engine.ts +4 -2
  164. package/src/plugins/builtin/backtest/window.ts +3 -1
  165. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  166. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  167. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  168. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  169. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  170. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  171. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  172. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  173. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  174. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  175. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  176. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  177. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  178. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  179. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  180. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  181. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  182. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  183. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  184. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  185. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  186. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  187. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  188. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  189. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  190. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  191. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  192. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  193. package/src/plugins/builtin/econ/figures.ts +13 -0
  194. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  195. package/src/plugins/builtin/econ/index.tsx +5 -3
  196. package/src/plugins/builtin/econ/types.ts +5 -0
  197. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  198. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  199. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  200. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  201. package/src/plugins/builtin/futures/table.tsx +1 -1
  202. package/src/plugins/builtin/futures-curve/model.ts +3 -10
  203. package/src/plugins/builtin/help/function-card.tsx +2 -1
  204. package/src/plugins/builtin/help/function-index.ts +1 -0
  205. package/src/plugins/builtin/insider/client.ts +31 -14
  206. package/src/plugins/builtin/insider/signals-model.ts +2 -7
  207. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  208. package/src/plugins/builtin/iv-history/model.ts +33 -23
  209. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  210. package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
  211. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  212. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  213. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  214. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  215. package/src/plugins/builtin/news/index.tsx +7 -13
  216. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  217. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  218. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  219. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  220. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  221. package/src/plugins/builtin/options/analytics.ts +7 -2
  222. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  223. package/src/plugins/builtin/options/table.ts +3 -2
  224. package/src/plugins/builtin/options/view.tsx +11 -9
  225. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  226. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  227. package/src/plugins/builtin/perps/client.ts +5 -4
  228. package/src/plugins/builtin/perps/headless.ts +134 -124
  229. package/src/plugins/builtin/perps/markets-section.tsx +2 -2
  230. package/src/plugins/builtin/perps/model.ts +8 -4
  231. package/src/plugins/builtin/perps/open-market.ts +4 -4
  232. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  233. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  234. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
  235. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
  236. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
  237. package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
  238. package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
  239. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  240. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
  241. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  242. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
  243. package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
  244. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  245. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  246. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  247. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  248. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  249. package/src/plugins/builtin/sec/headless.ts +48 -6
  250. package/src/plugins/builtin/sec/index.tsx +6 -4
  251. package/src/plugins/builtin/sec/model.ts +4 -1
  252. package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
  253. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  254. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  255. package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
  256. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  257. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  258. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  259. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  260. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  261. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  262. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  263. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  264. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  265. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  266. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  267. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  268. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  269. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  270. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  271. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  272. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  273. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  274. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  275. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  276. package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
  277. package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
  278. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  279. package/src/plugins/builtin/ticker-detail/overview/components.tsx +13 -1
  280. package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
  281. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  282. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  283. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +41 -6
  284. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  285. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  286. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  287. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  288. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  289. package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
  290. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  291. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  292. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  293. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  294. package/src/plugins/builtin/world-indices/client.ts +2 -0
  295. package/src/plugins/compat.ts +15 -0
  296. package/src/plugins/host-link.ts +6 -1
  297. package/src/plugins/installer.ts +8 -3
  298. package/src/portfolio/column-values.ts +14 -4
  299. package/src/portfolio/listed-symbol.ts +78 -0
  300. package/src/portfolio/real-return.ts +172 -0
  301. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  302. package/src/renderers/browser/config-host.ts +56 -15
  303. package/src/renderers/browser/main.tsx +3 -1
  304. package/src/renderers/browser/ui-host.tsx +1 -0
  305. package/src/renderers/cloudflare/http-proxy.ts +1 -0
  306. package/src/renderers/dom/boot-frame.ts +2 -2
  307. package/src/renderers/dom/data-table/row.tsx +4 -1
  308. package/src/renderers/dom/desktop/controls.tsx +4 -4
  309. package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
  310. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  311. package/src/renderers/dom/host/input.tsx +4 -1
  312. package/src/renderers/dom/host/tabs.tsx +10 -1
  313. package/src/renderers/dom/styles.css +33 -13
  314. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  315. package/src/renderers/opentui/host.tsx +2 -1
  316. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  317. package/src/sources/gloomberb-cloud/index.ts +31 -2
  318. package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
  319. package/src/sources/provider-router/cached-routes.ts +19 -7
  320. package/src/state/pane-table-export-registry.ts +19 -6
  321. package/src/test-support/preload.ts +5 -1
  322. package/src/theme/colors.ts +9 -1
  323. package/src/theme/themes.ts +62 -15
  324. package/src/theme/tone-contrast.ts +40 -0
  325. package/src/theme/ui-tokens.ts +23 -3
  326. package/src/tickers/batched-lookups.ts +57 -8
  327. package/src/tickers/company-name-listing.ts +156 -14
  328. package/src/tickers/company-name.ts +30 -6
  329. package/src/tickers/list.ts +7 -0
  330. package/src/tickers/search/home-listing.ts +31 -9
  331. package/src/tickers/search/index.ts +13 -3
  332. package/src/tickers/search/listing-index.ts +558 -0
  333. package/src/tickers/search/major-listings.chunk.ts +10 -0
  334. package/src/tickers/search/major-listings.json +3346 -0
  335. package/src/tickers/search/ranking.ts +68 -1
  336. package/src/tickers/search/types.ts +4 -0
  337. package/src/tickers/terminal-codes.ts +26 -1
  338. package/src/time-series/calendar-month-returns.ts +47 -0
  339. package/src/time-series/currency-conversion.ts +130 -0
  340. package/src/time-series/hooks.ts +2 -0
  341. package/src/time-series/price-comparison.ts +34 -11
  342. package/src/time-series/resolve-context.ts +3 -0
  343. package/src/time-series/resolve.ts +14 -2
  344. package/src/time-series/spec.ts +1 -0
  345. package/src/time-series/studies/indicators.ts +4 -1
  346. package/src/time-series/types.ts +8 -0
  347. package/src/types/config.ts +8 -0
  348. package/src/types/data-provider.ts +28 -0
  349. package/src/types/financials.ts +20 -2
  350. package/src/types/headless.ts +12 -0
  351. package/src/ui/host.tsx +8 -0
  352. package/src/utils/datetime-format.ts +17 -3
  353. package/src/utils/display-number.ts +15 -0
  354. package/src/utils/double-escape-close.ts +61 -16
  355. package/src/utils/float32-price.ts +24 -0
  356. package/src/utils/forward-dividend.ts +81 -16
  357. package/src/utils/fx-market-hours.ts +11 -0
  358. package/src/utils/plugin-proxy-hosts.json +2 -1
  359. package/src/utils/price-history.ts +7 -6
  360. package/src/utils/report-timing.ts +62 -0
  361. package/src/utils/sec-filings.ts +32 -0
  362. package/src/utils/utc-time.ts +5 -0
@@ -28,6 +28,8 @@ import { DataTableView, type DataTableKeyEvent, type DataTableSelection } from "
28
28
  import type { QuoteFlashDirection } from "../quote-flash";
29
29
  import { objectVersion } from "../../utils/object-version";
30
30
  import { getCompletedRegularSessionDisplay } from "../../market-data/market/status";
31
+ import { QUOTE_EXPORT_IDENTITY_HEADERS, quoteExportIdentityCells } from "../../market-data/quotes/export-identity";
32
+ import { exportedListingKey } from "../../portfolio/listed-symbol";
31
33
  import { usePaneFooter } from "../layout/pane/footer";
32
34
 
33
35
  export interface TickerTableCell {
@@ -35,8 +37,13 @@ export interface TickerTableCell {
35
37
  /** Muted context after `text`, shown whole only when both fit on one line. */
36
38
  note?: string;
37
39
  color?: string;
38
- /** The full-precision number behind a rounded `text`, which exports and rendered-view reports keep. */
39
- value?: number | null;
40
+ /**
41
+ * What exports and rendered-view reports keep behind a rounded `text`: the full-precision number, an ISO
42
+ * date or time, or the listing with its venue (BA:LSE) behind a symbol drawn with its session dot.
43
+ */
44
+ value?: number | string | null;
45
+ /** The unit `value` is in where `text` does not say it, which an export names in the header (MCAP (USD)). */
46
+ valueUnit?: string;
40
47
  /** A tint behind a cell that stands out for a moment, such as a price that moved since the user last looked. */
41
48
  backgroundColor?: string;
42
49
  /**
@@ -78,6 +85,8 @@ export interface TickerListVisibleRange {
78
85
  }
79
86
 
80
87
  export interface TickerListTableViewProps {
88
+ /** What the list is (a watchlist's name), which names its exported file. */
89
+ exportName?: string;
81
90
  columns: ColumnConfig[];
82
91
  tickers: TickerRecord[];
83
92
  cursorSymbol: string | null;
@@ -260,6 +269,7 @@ export function TickerListTableView({
260
269
  summaryRows,
261
270
  virtualize = true,
262
271
  overscan = 4,
272
+ exportName,
263
273
  }: TickerListTableViewProps) {
264
274
  const commandBarShortcut = useCommandBarShortcut();
265
275
  const resolvedEmptyHint = emptyHint ?? tf("Press {shortcut} to add one.", { shortcut: addTickerShortcut ?? commandBarShortcut });
@@ -302,19 +312,21 @@ export function TickerListTableView({
302
312
  }
303
313
  const financials = financialsRef.current.get(ticker.metadata.ticker);
304
314
  if (column.id === PRICE_SPARKLINE_COLUMN_ID) {
315
+ // Drawn only: an export has no figure for it, so it leaves the column out (it wrote the ticker under 1M).
305
316
  return {
306
- text: ticker.metadata.ticker,
317
+ text: "",
307
318
  content: <PriceSparkline priceHistory={getPriceHistory(financials)} width={column.width} />,
308
319
  };
309
320
  }
310
321
 
311
- const { text, note, color, onPress, value, backgroundColor } = resolveCellRef.current.resolve(column, ticker, financials);
322
+ const { text, note, color, onPress, value, valueUnit, backgroundColor } = resolveCellRef.current.resolve(column, ticker, financials);
312
323
  const shouldFlash = flashSymbolsRef.current.has(ticker.metadata.ticker)
313
324
  && flashesOnQuoteTick(column.id, financials?.quote);
314
325
  return {
315
326
  text,
316
327
  ...(note ? { note } : {}),
317
328
  ...(value !== undefined ? { value } : {}),
329
+ ...(valueUnit ? { valueUnit } : {}),
318
330
  color: color || (rowState.selected ? colors.selectedText : undefined),
319
331
  attributes: shouldFlash ? TextAttributes.DIM : TextAttributes.NONE,
320
332
  ...(backgroundColor ? { backgroundColor } : {}),
@@ -336,6 +348,17 @@ export function TickerListTableView({
336
348
  return `${resolveEpoch}|${objectVersion(financialsMap.get(symbol))}|${safeFlashSymbols.get(symbol) ?? ""}`;
337
349
  }, [financialsMap, resolveEpoch, safeFlashSymbols]);
338
350
 
351
+ // An export ends each row as `quote --csv` does: its session and feed, its listing with the venue, its unit,
352
+ // its source and the ISO time its price was observed. A summary line is no listing.
353
+ const exportIdentity = useMemo(() => ({
354
+ headers: QUOTE_EXPORT_IDENTITY_HEADERS,
355
+ cells: (ticker: TickerRecord) => isTickerRow(ticker)
356
+ ? quoteExportIdentityCells(exportedListingKey(ticker), financialsRef.current.get(ticker.metadata.ticker)?.quote, Date.now(),
357
+ // A broker's quote names the broker as its source.
358
+ (providerId) => getSharedRegistry()?.getBrokerAdapter(providerId)?.name)
359
+ : null,
360
+ }), []);
361
+
339
362
  const selection = useMemo<DataTableSelection<TickerRecord>>(() => ({
340
363
  kind: "id",
341
364
  selectedId: cursorSymbol,
@@ -416,6 +439,8 @@ export function TickerListTableView({
416
439
  onRowContextMenu={handleRowContextMenu}
417
440
  rowContextMenuSurface
418
441
  renderCell={renderCell}
442
+ exportIdentity={exportIdentity}
443
+ exportName={exportName}
419
444
  getRowVersion={getRowVersion}
420
445
  emptyStateTitle={emptyTitle}
421
446
  emptyStateHint={resolvedEmptyHint}
@@ -59,7 +59,18 @@ export interface ButtonProps {
59
59
  stopPropagation?: boolean;
60
60
  }
61
61
 
62
- function resolveButtonColors(variant: ButtonVariant, active: boolean, disabled: boolean, colors: ThemeColors, tone?: ButtonProps["tone"]): { bg?: string; fg: string } {
62
+ /**
63
+ * The colour of a button's key: its label's on a filled button, whose fill the
64
+ * page's dim text does not read on (Alt+Enter on Connect was 2.07:1 in
65
+ * colorblind-light), and the quieter dim or muted text beside an unfilled one.
66
+ */
67
+ export function buttonShortcutColor(palette: { bg?: string; fg: string }, inert: boolean, colors: ThemeColors): string {
68
+ const filled = palette.bg !== undefined && palette.bg !== colors.bg && palette.bg !== colors.panel;
69
+ if (filled) return palette.fg;
70
+ return inert ? colors.textMuted : colors.textDim;
71
+ }
72
+
73
+ export function resolveButtonColors(variant: ButtonVariant, active: boolean, disabled: boolean, colors: ThemeColors, tone?: ButtonProps["tone"]): { bg?: string; fg: string } {
63
74
  if (variant === "quiet") return { bg: active ? colors.selected : undefined, fg: disabled ? colors.textMuted : active ? colors.textBright : colors.textDim };
64
75
  if (variant === "plain") {
65
76
  return { fg: disabled ? colors.textMuted : active ? colors.textBright : colors.textDim };
@@ -180,7 +191,7 @@ export function Button({
180
191
  {compact ? displayLabel ?? label : ` ${displayLabel ?? label} `}
181
192
  </Text>}
182
193
  {shortcut && (
183
- <Text fg={inert ? colors.textMuted : colors.textDim}>
194
+ <Text fg={buttonShortcutColor(palette, inert, colors)}>
184
195
  {` ${shortcut}`}
185
196
  </Text>
186
197
  )}
@@ -33,9 +33,12 @@ export interface ColumnGridLink {
33
33
  onOpen: () => void;
34
34
  }
35
35
 
36
- /** Text the grid fits to its column (padded on the terminal, cut by CSS on the desktop), or content the column holds. */
36
+ /**
37
+ * Text the grid fits to its column (padded on the terminal, cut by CSS on the desktop), or content the column holds.
38
+ * `attributes` are the text's marks, such as the bold of an unread headline.
39
+ */
37
40
  export type ColumnGridCell =
38
- | { text: string; color?: string; link?: ColumnGridLink }
41
+ | { text: string; color?: string; attributes?: number; link?: ColumnGridLink }
39
42
  | { content: ReactNode }
40
43
  | null;
41
44
 
@@ -102,17 +105,22 @@ function useLinkTarget(link: ColumnGridLink | undefined) {
102
105
  } : {};
103
106
  }
104
107
 
108
+ /** A cell's marks, given only when it has some, so a plain cell draws as it always did. */
109
+ function marks(attributes: number | undefined): { attributes?: number } {
110
+ return attributes ? { attributes } : {};
111
+ }
112
+
105
113
  /** A text cell that opens something, in the terminal: its padded text is the target. */
106
- function TerminalLinkCell({ text, color, link, width, align }: { text: string; color?: string; link: ColumnGridLink; width: number; align?: "left" | "right" }) {
114
+ function TerminalLinkCell({ text, color, attributes, link, width, align }: { text: string; color?: string; attributes?: number; link: ColumnGridLink; width: number; align?: "left" | "right" }) {
107
115
  const target = useLinkTarget(link);
108
- return <Box width={width} flexDirection="row" {...target}><Text fg={color}>{padTo(text, width, align)}</Text></Box>;
116
+ return <Box width={width} flexDirection="row" {...target}><Text fg={color} {...marks(attributes)}>{padTo(text, width, align)}</Text></Box>;
109
117
  }
110
118
 
111
119
  /** A text cell that opens something, on the desktop and the web. */
112
- function NativeLinkCell({ text, color, link, column, place }: { text: string; color?: string; link: ColumnGridLink; column: ColumnGridColumn; place: CSSProperties }) {
120
+ function NativeLinkCell({ text, color, attributes, link, column, place }: { text: string; color?: string; attributes?: number; link: ColumnGridLink; column: ColumnGridColumn; place: CSSProperties }) {
113
121
  const target = useLinkTarget(link);
114
122
  return (
115
- <Text fg={color} data-gloom-ui="column-grid-text" {...clipOf(text, column)} {...target} style={{ ...place, ...TEXT_BOX, textAlign: column.align ?? "left" }}>
123
+ <Text fg={color} {...marks(attributes)} data-gloom-ui="column-grid-text" {...clipOf(text, column)} {...target} style={{ ...place, ...TEXT_BOX, textAlign: column.align ?? "left" }}>
116
124
  {text}
117
125
  </Text>
118
126
  );
@@ -142,8 +150,8 @@ export function ColumnGrid({ columns, rows, width, role }: ColumnGridProps) {
142
150
  {column.gapBefore ? <Box width={column.gapBefore} /> : null}
143
151
  {cell && "text" in cell
144
152
  ? cell.link
145
- ? <TerminalLinkCell text={cell.text} color={cell.color} link={cell.link} width={column.width} align={column.align} />
146
- : <Text fg={cell.color}>{padTo(cell.text, column.width, column.align)}</Text>
153
+ ? <TerminalLinkCell text={cell.text} color={cell.color} attributes={cell.attributes} link={cell.link} width={column.width} align={column.align} />
154
+ : <Text fg={cell.color} {...marks(cell.attributes)}>{padTo(cell.text, column.width, column.align)}</Text>
147
155
  : <Box width={column.width} flexDirection="row">{cell?.content}</Box>}
148
156
  </Box>
149
157
  );
@@ -171,12 +179,13 @@ export function ColumnGrid({ columns, rows, width, role }: ColumnGridProps) {
171
179
  const cell = row[index] ?? null;
172
180
  if (!cell) return null;
173
181
  const place: CSSProperties = { gridColumn: lines[index], gridRow: rowIndex + 1 };
174
- if ("text" in cell && cell.link) return <NativeLinkCell key={index} text={cell.text} color={cell.color} link={cell.link} column={column} place={place} />;
182
+ if ("text" in cell && cell.link) return <NativeLinkCell key={index} text={cell.text} color={cell.color} attributes={cell.attributes} link={cell.link} column={column} place={place} />;
175
183
  return "text" in cell
176
184
  ? (
177
185
  <Text
178
186
  key={index}
179
187
  fg={cell.color}
188
+ {...marks(cell.attributes)}
180
189
  data-gloom-ui="column-grid-text"
181
190
  {...clipOf(cell.text, column)}
182
191
  style={{ ...place, ...TEXT_BOX, textAlign: column.align ?? "left" }}
@@ -40,7 +40,7 @@ export function DataTable<T, C extends DataTableColumn = DataTableColumn>(
40
40
  name: filename,
41
41
  text: propsRef.current.exportCsv?.() ?? createDataTableCsv(propsRef.current),
42
42
  mimeType: "text/csv;charset=utf-8",
43
- }));
43
+ }), () => propsRef.current.exportName);
44
44
  }, [paneId, renderer]);
45
45
 
46
46
  useRemoteUiNode({
@@ -1,6 +1,7 @@
1
1
  import { memo, useCallback, useEffect, useMemo, useRef, useState } from "react";
2
2
  import { Box, ScrollBox, Span, Text, TextAttributes, useNativeRenderer } from "../../../../ui";
3
3
  import { hoverBg } from "../../../../theme/colors";
4
+ import { selectedCellColor } from "../../../../theme/tone-contrast";
4
5
  import { useThemeColors } from "../../../../theme/theme-context";
5
6
  import { usePaneInstance } from "../../../../state/app/context";
6
7
  import { useViewport } from "../../../../react/input";
@@ -253,7 +254,7 @@ function OpenTuiDataTableRowInner<
253
254
  attributes={cell.attributes ?? TextAttributes.NONE}
254
255
  fg={selected && (cell.color === undefined || (selectedTextOverridesCellColor && !cell.keepColorWhenSelected))
255
256
  ? colors.selectedText
256
- : cell.color ?? colors.text}
257
+ : selected ? selectedCellColor(cell.color, colors) ?? colors.text : cell.color ?? colors.text}
257
258
  >
258
259
  {fitted.note ? <>
259
260
  {`${frozen ? " ".repeat(horizontalPadding) : ""}${" ".repeat(inset)}${fitted.text}`}
@@ -33,6 +33,12 @@ export interface DataTableCell {
33
33
  * numbers exports them read back from `text`.
34
34
  */
35
35
  value?: number | string | Date | null;
36
+ /**
37
+ * The unit `value` is in where `text` does not say it (USD for a market cap
38
+ * shown as 72.26B). A column whose values share one names it in its export
39
+ * header: MCAP (USD).
40
+ */
41
+ valueUnit?: string;
36
42
  content?: ReactNode;
37
43
  /**
38
44
  * Artwork drawn before `text` on the desktop and the web, such as a flag.
@@ -173,6 +179,18 @@ export interface DataTableProps<
173
179
  freezeFirstColumn?: boolean;
174
180
  /** Append export-only source records after the displayed table. */
175
181
  getExportMetadata?: () => readonly (readonly unknown[])[];
182
+ /** What the table is of, which names its exported file (`Asia shock-2026-…csv`) in place of the pane's title. */
183
+ exportName?: string;
184
+ /**
185
+ * Columns an export adds after the table's own, naming what each row is, as
186
+ * `quote --csv` ends its rows (`QUOTE_EXPORT_IDENTITY_HEADERS`): their
187
+ * headers, and each row's cells, or null for a row that is no record (a
188
+ * summary line), which exports them empty.
189
+ */
190
+ exportIdentity?: {
191
+ headers: readonly string[];
192
+ cells: (item: T) => readonly unknown[] | null;
193
+ };
176
194
  /**
177
195
  * What Export CSV writes in place of the rows drawn, for a pane whose
178
196
  * export is the data behind its view rather than one table: the backtest
@@ -61,8 +61,9 @@ export function useStateQuoteDelay(stating: boolean): void {
61
61
  }
62
62
 
63
63
  /**
64
- * The delay to mark beside a price shown outside a pane footer (the header's
65
- * SPY, a quote's headline): this account's (`useFreeQuoteDelay`) while
64
+ * The delay to mark beside a price shown outside a pane footer (a quote's
65
+ * headline; not the header's market, which never carries it): this account's
66
+ * (`useFreeQuoteDelay`) while
66
67
  * nothing else on screen says it, null while the price is live or the status
67
68
  * bar's delayed note says it for the whole app. The delay is said once per
68
69
  * screen: with the status bar hidden (presentation mode, `SB`), or in a
@@ -401,7 +401,6 @@ export function GridFieldView({
401
401
  variant="plain"
402
402
  backgroundColor={nativePaneChrome ? "transparent" : colors.selected}
403
403
  textColor={fg}
404
- placeholderColor={colors.textMuted}
405
404
  onMouseDown={onFocus}
406
405
  onChange={(next) => {
407
406
  setDraft(next);
@@ -421,7 +420,6 @@ export function GridFieldView({
421
420
  variant="plain"
422
421
  backgroundColor={nativePaneChrome ? "transparent" : colors.selected}
423
422
  textColor={fg}
424
- placeholderColor={colors.textMuted}
425
423
  onMouseDown={onFocus}
426
424
  onChange={(nextText) => {
427
425
  dirtyRef.current = true;
@@ -2,6 +2,7 @@ import { Box, Input, Span, Text, TextAttributes, useUiCapabilities, useUiHost }
2
2
  import { useEffect, useLayoutEffect, useRef, useState, type ComponentType, type RefObject } from "react";
3
3
  import { type InputRenderable } from "../../ui";
4
4
  import { useThemeColors } from "../../theme/theme-context";
5
+ import { placeholderText } from "../../theme/colors";
5
6
  import { useRemoteUiNode } from "../../remote/semantic-tree";
6
7
  import { remoteStringValue } from "../../remote/semantic-helpers";
7
8
  import { truncateWithEllipsis } from "../../utils/text-wrap";
@@ -162,7 +163,9 @@ function TextFieldControl({
162
163
  const colors = useThemeColors();
163
164
  backgroundColor ??= variant === "well" ? colors.panel : colors.bg;
164
165
  textColor ??= colors.text;
165
- placeholderColor ??= colors.textDim;
166
+ // The label takes a caller's placeholder colour, dim otherwise; the placeholder is the role.
167
+ const labelColor = placeholderColor ?? colors.textDim;
168
+ const placeholderFg = placeholderColor ?? placeholderText(colors);
166
169
  useRemoteUiNode({
167
170
  role: "text-field",
168
171
  label: accessibleLabel ?? label ?? placeholder,
@@ -217,7 +220,7 @@ function TextFieldControl({
217
220
  const currentValue = value ?? "";
218
221
  const maskedValue = maskPassword(currentValue);
219
222
  const maskedDisplay = maskedValue.length > 0 ? maskedValue : (placeholder ?? "");
220
- const maskedTextColor = maskedValue.length > 0 ? textColor : placeholderColor;
223
+ const maskedTextColor = maskedValue.length > 0 ? textColor : placeholderFg;
221
224
 
222
225
  useEffect(() => {
223
226
  currentValueRef.current = currentValue;
@@ -239,7 +242,7 @@ function TextFieldControl({
239
242
  <Box flexDirection="column">
240
243
  {label && (
241
244
  <Box height={1}>
242
- <Text fg={placeholderColor}>{active === undefined ? label : `${active ? "> " : " "}${label}`}</Text>
245
+ <Text fg={labelColor}>{active === undefined ? label : `${active ? "> " : " "}${label}`}</Text>
243
246
  </Box>
244
247
  )}
245
248
  <Box height={1} onMouseDown={() => {
@@ -256,7 +259,7 @@ function TextFieldControl({
256
259
  {...(maxLength === undefined ? {} : { maxLength })}
257
260
  focused={focused && !disabled}
258
261
  textColor={isPassword ? backgroundColor : textColor}
259
- placeholderColor={placeholderColor}
262
+ placeholderColor={placeholderFg}
260
263
  backgroundColor={backgroundColor}
261
264
  selectionBg={isPassword ? backgroundColor : undefined}
262
265
  selectionFg={isPassword ? backgroundColor : undefined}
@@ -1,6 +1,6 @@
1
1
  import { useMemo, type ReactNode, type RefObject } from "react";
2
2
  import { Box, Input, Text, useUiCapabilities, type InputRenderable } from "../../ui";
3
- import { colors } from "../../theme/colors";
3
+ import { colors, placeholderText } from "../../theme/colors";
4
4
  import { Icon } from "./icon";
5
5
  import type { PastedLines } from "../../utils/pasted-lines";
6
6
 
@@ -74,7 +74,7 @@ export function InlineQuickAddRow({
74
74
  value={value}
75
75
  focused={active && paneFocused}
76
76
  placeholder={placeholder}
77
- placeholderColor={colors.textMuted}
77
+ placeholderColor={placeholderText()}
78
78
  textColor={colors.text}
79
79
  backgroundColor={nativePaneChrome ? "transparent" : colors.panel}
80
80
  onInput={onChange}
@@ -0,0 +1,153 @@
1
+ import { formatShortcutForHost, keyNotationFor } from "../../app/keybindings/labels";
2
+ import { displayWidth } from "../../utils/format";
3
+
4
+ /**
5
+ * What a key hint says, read three ways from one definition. A footer hint
6
+ * writes what the terminal shows after its key: `{ key: "s", label: "eries" }`
7
+ * is `[s]eries`. The desktop and the web show the key in a keycap before the
8
+ * whole word (`s` series), never inside it, and the pane menu names it
9
+ * ("Series"). This file turns the terminal's label into those words.
10
+ */
11
+ export interface KeyHintSource {
12
+ key: string;
13
+ /** What the terminal writes after `[key]`. */
14
+ label: string;
15
+ /** The action's name in the pane menu, when it is not the hint read as words. */
16
+ title?: string;
17
+ id?: string;
18
+ }
19
+
20
+ /** Letters and digits only, lower case: "re-arm" is `rearm`, "Re-arm" too. */
21
+ function letters(text: string): string {
22
+ return text.toLowerCase().replace(/[^\p{L}\p{N}]/gu, "");
23
+ }
24
+
25
+ /** One reads as the start of the other, for names of three letters or more. */
26
+ function sameName(a: string, b: string): boolean {
27
+ if (a.length < 3 || b.length < 3) return a.length > 0 && a === b;
28
+ return a.startsWith(b) || b.startsWith(a);
29
+ }
30
+
31
+ /**
32
+ * The hint's words, without the key: `[s]eries` is "series", `[x] remove`
33
+ * "remove", `[Esc]tabs` "tabs", `[t]BO` "TBO".
34
+ *
35
+ * - A label that starts with a space, and any key that is not a single letter
36
+ * (`Enter`, `Esc`, `Ctrl+S`, `/`, `0`), is followed by words of its own.
37
+ * - A letter key starts its word, and the label is the rest of it (`[a]dd`),
38
+ * unless the hint's `title` or `id` names the label alone: `{ key: "m",
39
+ * label: "re-arm", title: "Re-arm" }` and `{ id: "stop", key: "x", label:
40
+ * "stop" }` are words of their own, and so is a label that undoes what the
41
+ * id names (`{ id: "mute", key: "m", label: "unmute" }`). A title with the
42
+ * key and the label inside one of its words puts the key inside that word:
43
+ * `{ key: "x", label: "port all", title: "Export All" }` is "export all".
44
+ * - With neither, a label that starts with the key's own letter (`[u]upgrade`)
45
+ * or with a capital (`[d]Broker`) is a word of its own, as the pane menu has
46
+ * always read it; an all-capital label is the rest of a code (`[t]BO`).
47
+ */
48
+ export function keyHintWords(hint: KeyHintSource): string {
49
+ const { key, label } = hint;
50
+ const words = label.trim();
51
+ if (!words) return "";
52
+ if (/^\s/.test(label) || !/^\p{L}$/u.test(key)) return words;
53
+ const names = [hint.title, hint.id].filter((name): name is string => !!name).map(letters);
54
+ const joined = letters(key + label);
55
+ if (names.some((name) => sameName(joined, name))) return `${key}${label}`;
56
+ const own = letters(label);
57
+ if (names.some((name) => sameName(own, name) || (name.length >= 3 && own === `un${name}`))) return words;
58
+ const inside = hint.title ? keyInsideTitle(hint.title, key, label) : null;
59
+ if (inside) return inside;
60
+ if (label.toLowerCase().startsWith(key.toLowerCase())) return words;
61
+ if (/^\p{Lu}+$/u.test(label)) return `${key.toUpperCase()}${label}`;
62
+ if (/^\p{Lu}/u.test(label)) return words;
63
+ return /^\p{L}/u.test(label) ? `${key}${label}` : words;
64
+ }
65
+
66
+ /**
67
+ * "export all" for `[x]port all` titled "Export All", "expand" for `[x]pand`
68
+ * titled "Expand Row": the title's word that has the key, then the label,
69
+ * after its first letter.
70
+ */
71
+ function keyInsideTitle(title: string, key: string, label: string): string | null {
72
+ const at = title.toLowerCase().indexOf(`${key}${label}`.toLowerCase());
73
+ if (at < 1 || !/\p{L}/u.test(title.charAt(at - 1))) return null;
74
+ let start = at;
75
+ while (start > 0 && /\p{L}/u.test(title.charAt(start - 1))) start -= 1;
76
+ const head = title.slice(start, at);
77
+ const lowered = start === 0 || /\s/.test(title.charAt(start - 1)) ? head.toLowerCase() : head;
78
+ return `${lowered}${key}${label}`;
79
+ }
80
+
81
+ /** A hint's name in a menu: its title, or its words with a capital (`[a]dd` is "Add"). */
82
+ export function keyHintTitle(hint: KeyHintSource): string {
83
+ if (hint.title) return hint.title;
84
+ const words = keyHintWords(hint);
85
+ return words.charAt(0).toUpperCase() + words.slice(1);
86
+ }
87
+
88
+ /** Keys a keycap draws as the symbol printed on the key, off a Mac; the rest keep their name. */
89
+ const KEY_SYMBOLS: Record<string, string> = {
90
+ enter: "↵",
91
+ return: "↵",
92
+ shift: "⇧",
93
+ left: "←",
94
+ right: "→",
95
+ up: "↑",
96
+ down: "↓",
97
+ escape: "Esc",
98
+ };
99
+
100
+ /**
101
+ * What a keycap shows for `key`. On a Mac, Apple's notation
102
+ * (formatShortcutForHost): "Shift+Enter" is ⇧↩ and "Ctrl+G" ⌃G. Elsewhere
103
+ * "Shift+Enter" reads ⇧↵ and "Enter" ↵, and "Ctrl+G", "Esc" and "y" stay as
104
+ * they are.
105
+ */
106
+ export function keycapText(key: string): string {
107
+ if (keyNotationFor("platform") === "mac") return formatShortcutForHost(key, "platform");
108
+ return key
109
+ .split("+")
110
+ .map((part) => KEY_SYMBOLS[part.trim().toLowerCase()] ?? part.trim())
111
+ .join("+")
112
+ .replaceAll("⇧+", "⇧");
113
+ }
114
+
115
+ /*
116
+ * A key hint's size on the desktop and the web, in grid cells, from
117
+ * styles.css. The text scales with the font size (FONT- and FONT+) and so
118
+ * does the cell, 8px at the default 12px text, so text measures the same
119
+ * number of cells at every size. Monospace fonts advance about 0.6em a
120
+ * character (SF Mono, Menlo, DejaVu Sans Mono; Consolas less): 0.9 of a cell
121
+ * at the text size and 0.75 at the keycap's caption size. These allow a
122
+ * little more, as a hint must never be wider than the room it was given. A
123
+ * symbol (⌘, ↵, ←) may come from a wider fallback font, so it counts as a
124
+ * whole em of the caption. The spacing does not scale: the keycap's 4px
125
+ * either side and 14px at least, the 4px before the words and the 12px
126
+ * between two hints are pixels, so they take more cells at a small size
127
+ * (6.67px cells at 10px text) and fewer at a large one.
128
+ */
129
+ const TEXT_CHAR_CELLS = 0.92;
130
+ const CAPTION_CHAR_CELLS = 0.77;
131
+ const CAPTION_SYMBOL_CELLS = 10 / 8;
132
+ const KEYCAP_PADDING_PX = 8;
133
+ const KEYCAP_MIN_PX = 14;
134
+ const KEYCAP_WORD_GAP_PX = 4;
135
+ /** Pixels between two key hints on the desktop and the web (`--gloom-space-md`). */
136
+ export const KEY_HINT_GAP_PX = 12;
137
+ /** The grid's cell at the default text size; `cellPx` is the live one (useUiCapabilities().cellWidthPx). */
138
+ const DEFAULT_CELL_PX = 8;
139
+
140
+ function keycapPx(keycap: string, cellPx: number): number {
141
+ let glyphCells = 0;
142
+ for (const char of keycap) glyphCells += /[\x20-\x7e]/.test(char) ? CAPTION_CHAR_CELLS : CAPTION_SYMBOL_CELLS;
143
+ return Math.max(KEYCAP_MIN_PX, glyphCells * cellPx + KEYCAP_PADDING_PX);
144
+ }
145
+
146
+ /**
147
+ * Cells one key hint takes on the desktop and the web, on a grid of `cellPx`
148
+ * cells: the keycap of `keycap`, then `words`.
149
+ */
150
+ export function keyHintCells(keycap: string, words: string, cellPx = DEFAULT_CELL_PX): number {
151
+ const px = keycapPx(keycap, cellPx) + (words ? KEYCAP_WORD_GAP_PX + displayWidth(words) * TEXT_CHAR_CELLS * cellPx : 0);
152
+ return px / cellPx;
153
+ }
@@ -0,0 +1,73 @@
1
+ import { type ComponentType } from "react";
2
+ import { t } from "../../i18n";
3
+ import { useThemeColors } from "../../theme/theme-context";
4
+ import { Text, useShortcutLabel, useUiHost } from "../../ui";
5
+ import type { DialogKeyHint } from "./frame";
6
+
7
+ /** A press on a key hint, with where it landed, for a menu that opens at the pointer. */
8
+ interface KeyHintPressEvent {
9
+ pixelX?: number;
10
+ pixelY?: number;
11
+ stopPropagation?: () => void;
12
+ preventDefault?: () => void;
13
+ }
14
+
15
+ export interface KeyHintProps {
16
+ /** The key as written (`s`, `Enter`, `Ctrl+S`); it shows in the host's notation. */
17
+ keyName: string;
18
+ /** The whole words, without the key: "series", "new pane". */
19
+ label: string;
20
+ /** A hint that runs its action when pressed; it brightens under the pointer. */
21
+ onPress?: (event?: KeyHintPressEvent) => void;
22
+ disabled?: boolean;
23
+ /** The words' colour, for a hint on a surface of its own; the key stays a step brighter. */
24
+ color?: string;
25
+ dataGloomRole?: string;
26
+ }
27
+
28
+ /**
29
+ * One key and what it does, the one look every key hint has on the desktop
30
+ * and the web: a pane footer's hints, a dialog's and the command bar
31
+ * prompt's. The key sits in a faint keycap before the words, the words in the
32
+ * muted tone and the key a step brighter, none of it bold. The terminal has
33
+ * its own forms (a footer's `[s]eries`, a dialog line's `Enter here`), so this
34
+ * draws the key and the words there only where nothing else does.
35
+ */
36
+ export function KeyHint({ keyName, label, onPress, disabled, color, dataGloomRole }: KeyHintProps) {
37
+ const HostKeyHint = useUiHost().KeyHint as ComponentType<KeyHintProps> | undefined;
38
+ const colors = useThemeColors();
39
+ const formatKey = useShortcutLabel();
40
+ if (HostKeyHint) {
41
+ return <HostKeyHint keyName={keyName} label={label} onPress={onPress} disabled={disabled} color={color} dataGloomRole={dataGloomRole} />;
42
+ }
43
+ return <Text fg={color ?? colors.textMuted}>{label ? `${formatKey(keyName)} ${label}` : formatKey(keyName)}</Text>;
44
+ }
45
+
46
+ export interface KeyHintsProps {
47
+ keys: DialogKeyHint[];
48
+ /** The words' colour, for hints on a surface of their own (KeyHint's `color`). */
49
+ color?: string;
50
+ }
51
+
52
+ /**
53
+ * The terminal's form of `keys`, as a dialog's footer line says them:
54
+ * "Enter here · Shift+Enter new pane". `formatKey` writes each key in the
55
+ * host's notation (useShortcutLabel).
56
+ */
57
+ export function keyHintsText(keys: readonly DialogKeyHint[], formatKey: (key: string) => string = (key) => key): string {
58
+ return keys.map((hint) => `${formatKey(hint.key)} ${t(hint.label)}`).join(" · ");
59
+ }
60
+
61
+ /**
62
+ * Keys and what they do, as one quiet line that is not a button: on the
63
+ * desktop and the web a KeyHint each, as a dialog's hints beside its buttons;
64
+ * in the terminal the words of a dialog's footer line. Nothing here takes the
65
+ * pointer; whatever the keys run has its own control.
66
+ */
67
+ export function KeyHints({ keys, color }: KeyHintsProps) {
68
+ const HostKeyHints = useUiHost().KeyHints as ComponentType<KeyHintsProps> | undefined;
69
+ const colors = useThemeColors();
70
+ const formatKey = useShortcutLabel();
71
+ if (HostKeyHints) return <HostKeyHints keys={keys} color={color} />;
72
+ return <Text fg={color ?? colors.textMuted}>{keyHintsText(keys, formatKey)}</Text>;
73
+ }
@@ -4,6 +4,7 @@ import { useThemeColors } from "../../theme/theme-context";
4
4
  import { useShortcut } from "../../react/input";
5
5
  import { keepEscapeFromClosing } from "../../utils/double-escape-close";
6
6
  import { useRemoteUiNode } from "../../remote/semantic-tree";
7
+ import { readsAtBodyContrast } from "../../theme/tone-contrast";
7
8
  import { Popover } from "./popover";
8
9
 
9
10
  export type MenuItem = HostMenuItem;
@@ -94,7 +95,8 @@ function TerminalMenu({ items, onSelect, selection = "none", title, onClose }: M
94
95
  {`${marker}${item.label}`}
95
96
  </Text>
96
97
  {item.hint && <Box flexGrow={1} />}
97
- {item.hint && <Text fg={colors.textMuted}>{` ${item.hint}`}</Text>}
98
+ {/* On the selection a light or colour-blind theme draws the hint as the label; dark themes keep it muted. */}
99
+ {item.hint && <Text fg={active && readsAtBodyContrast(colors) ? colors.selectedText : colors.textMuted}>{` ${item.hint}`}</Text>}
98
100
  </Box>
99
101
  );
100
102
  })}
@@ -1,7 +1,7 @@
1
1
  import { Box, Text, Textarea, useUiHost } from "../../ui";
2
2
  import { type ComponentType, type ReactNode, type RefObject } from "react";
3
3
  import { type TextareaRenderable } from "../../ui";
4
- import { colors } from "../../theme/colors";
4
+ import { colors, placeholderText } from "../../theme/colors";
5
5
  import { useRemoteUiNode } from "../../remote/semantic-tree";
6
6
  import { remoteStringValue } from "../../remote/semantic-helpers";
7
7
 
@@ -153,7 +153,7 @@ export function MessageComposer({
153
153
  height={height}
154
154
  focused={focused}
155
155
  placeholder={placeholder}
156
- placeholderColor={colors.textMuted}
156
+ placeholderColor={placeholderText()}
157
157
  textColor={colors.text}
158
158
  backgroundColor={colors.bg}
159
159
  focusedBackgroundColor={colors.bg}