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
@@ -225,6 +225,7 @@ export async function renderDesktopShot({
225
225
  options,
226
226
  captureImage = true,
227
227
  onStalledReport,
228
+ onDrawing,
228
229
  }: {
229
230
  resolved: ResolvedPaneFunction;
230
231
  context: MarketContext;
@@ -251,6 +252,8 @@ export async function renderDesktopShot({
251
252
  * may keep the process alive.
252
253
  */
253
254
  onStalledReport?: () => void;
255
+ /** Called once the pane's data is read and the page starts to draw it. */
256
+ onDrawing?: () => void;
254
257
  }): Promise<PaneScreenshotResult> {
255
258
  prepareDesktopPaneShotView();
256
259
  if (captureImage) await createOutputFolder(outputPath);
@@ -289,6 +292,7 @@ export async function renderDesktopShot({
289
292
  watermark ?? null,
290
293
  loadModel,
291
294
  );
295
+ onDrawing?.();
292
296
  if (statusLine && captureImage && shotHasStatusLine(resolved)) payload.statusLine = true;
293
297
  const fitRoles = [
294
298
  ...(fitRows && paneFitsRows(resolved) ? ["data-table-body-scroll"] : []),
@@ -25,6 +25,7 @@ import {
25
25
  parseListingArg,
26
26
  quoteBareListing,
27
27
  serviceNamedCompany,
28
+ titleCaseCompanyName,
28
29
  type ListingArg,
29
30
  requireCliListing,
30
31
  resolveCliListing,
@@ -36,6 +37,7 @@ import {
36
37
  import { withListingSuggestion } from "./not-a-ticker";
37
38
  import { notATickerWords } from "./company-name-hint";
38
39
  import { isNetworkFailure } from "../utils/network-failure";
40
+ import { logFailure } from "../utils/log-failure";
39
41
  import type { MarketContext } from "./types";
40
42
 
41
43
  /** The text of an error, or null for none. */
@@ -93,6 +95,14 @@ export async function answerQuote(
93
95
  const also = (quote: Quote) => root && quote.instrumentType?.trim().toUpperCase() !== "INDEX"
94
96
  ? [indexRootAlsoLine(root, request.command)] : [];
95
97
  if (result.quote) {
98
+ // A word written as a company's name, which is another company's ticker too, is the company of that name: "Aeon"
99
+ // is Aeon Co., Ltd. (8267:JPX), not AEON Biopharma. A saved row keeps its listing.
100
+ const titled = !listing.exchange && !listing.saved && listing.typed
101
+ ? await titleCaseCompanyName(listing.typed, { symbol: listing.symbol, name: result.quote.name }, market)
102
+ .catch(logFailure("cli.quote-answer", "Read a word as a company's name failed", null))
103
+ : null;
104
+ const meant = titled ? await answerNamedListing(titled, market, request, refresh, datesChangeBasis) : null;
105
+ if (meant) return meant;
96
106
  // "CAR = Avis Budget Group, NASDAQ (different companies on XETRA, ASX)" names the venue too, so it replaces "SXR8 -> XETRA".
97
107
  const choice = await listingChoiceNotes(listing, market, result.quote, venues);
98
108
  const venue = choice.length > 0 ? null : bareListingNote(listing, result.quote);
@@ -11,6 +11,7 @@ import { serializeCsv } from "../utils/csv";
11
11
  import {
12
12
  BLANK_DISPLAY,
13
13
  DISPLAY_PLACEHOLDER,
14
+ figureAsDrawn,
14
15
  labelWithUnit,
15
16
  parseDisplayNumber,
16
17
  type DisplayNumber,
@@ -71,6 +72,8 @@ export interface CliReportColumn<Row = Record<string, unknown>> {
71
72
  * rows loaded (a market cap in one currency for some peers, in another for others).
72
73
  */
73
74
  unitColumn?: boolean;
75
+ /** CSV and NDJSON write the figure to the digits `format` draws (figureAsDrawn); JSON keeps it whole. */
76
+ exportAsShown?: boolean;
74
77
  }
75
78
 
76
79
  /** A label/value line of a report. `unit` names the unit of a numeric `value` when `formatted` cannot say it. */
@@ -477,9 +480,10 @@ export function exportRowsTable<Row extends Record<string, unknown>>(
477
480
  const { header, cells } = resolveColumn(
478
481
  column.header,
479
482
  rows.map((row, index): Cell => {
480
- const value = values[index];
481
483
  const unit = column.unitKey ? (row as Record<string, unknown> | undefined)?.[column.unitKey] : undefined;
482
- const drawn = column.format ? column.format(value, row) : null;
484
+ const drawn = column.format ? column.format(values[index], row) : null;
485
+ const value = column.exportAsShown && drawn != null && typeof values[index] === "number"
486
+ ? figureAsDrawn(values[index], drawn) : values[index];
483
487
  // A figure the text leaves out of this row (another session's print) is not one of its figures.
484
488
  const left = drawn != null && readDisplay(drawn) === BLANK_DISPLAY;
485
489
  if (!left && typeof value === "number" && Number.isFinite(value) && (inRowUnit || (typeof unit === "string" && unit))) {
@@ -666,6 +670,22 @@ export function renderReportCsv(report: CliReportTables, freshness?: ReportFresh
666
670
  return withCsvFooter(blocks.join("\n\n"), report.footer);
667
671
  }
668
672
 
673
+ /**
674
+ * A CSV as `withCsvFooter` writes it, split into its rows and its closing
675
+ * lines (without their `# `): what goes to the file or pipe, where a
676
+ * spreadsheet would read a `#` line as a row of junk, and what goes to
677
+ * standard error beside the warnings. Every row already names its source and
678
+ * as-of in its own columns. A section's `# section:` line stays with its rows.
679
+ */
680
+ export function splitCsvFooter(text: string): { csv: string; footer: string[] } {
681
+ const isComment = (line: string) => line.startsWith("# ");
682
+ const blocks = text.split("\n\n");
683
+ const last = blocks.at(-1) ?? "";
684
+ const lines = last.split("\n");
685
+ if (!last || !lines.every(isComment) || lines.some((line) => line.startsWith("# section: "))) return { csv: text, footer: [] };
686
+ return { csv: blocks.slice(0, -1).join("\n\n"), footer: lines.map((line) => line.slice(2)) };
687
+ }
688
+
669
689
  /** CSV with its closing `#` lines after a blank line. */
670
690
  export function withCsvFooter(csv: string, footer: readonly string[]): string {
671
691
  return [csv, footer.map(commentLine).join("\n")].filter(Boolean).join("\n\n");
package/src/cli/result.ts CHANGED
@@ -16,7 +16,7 @@ import { serializeCsv } from "../utils/csv";
16
16
  import { formatUtcTime, isEpochMilliseconds, isZonedIsoDateTime } from "../utils/utc-time";
17
17
  import { formatFreshnessLine, withSavedCopy, type ReportFreshness } from "./pane-functions/freshness";
18
18
  import { withSearchHints, type FredSeriesCheck } from "./not-a-ticker";
19
- import { renderReportCsv, renderReportNdjson, withCsvFooter, type CliReportTables } from "./report-tables";
19
+ import { renderReportCsv, renderReportNdjson, splitCsvFooter, withCsvFooter, type CliReportTables } from "./report-tables";
20
20
  import {
21
21
  EXPORT_DATING_COLUMNS,
22
22
  EXPORT_IDENTITY_COLUMNS,
@@ -636,7 +636,10 @@ export function printCliResult<T, Row extends Record<string, unknown> = Record<s
636
636
  if (options.quiet && options.format === "text") return;
637
637
  // JSON keeps the router's own words; everything else is for a person, so a "Not a ticker" gets its hint.
638
638
  const hinted = (text: string) => options.format === "json" ? text : withSearchHints(text, args, isFredSeries);
639
- const output = hinted(serializeCliResult(result, options, renderOptions));
639
+ const serialized = hinted(serializeCliResult(result, options, renderOptions));
640
+ // A CSV's closing source and note lines go to stderr with the warnings: in the file they are rows of junk to a spreadsheet.
641
+ const { csv, footer } = options.format === "csv" ? splitCsvFooter(serialized) : { csv: serialized, footer: [] };
642
+ const output = csv;
640
643
  // Bun's console writer can truncate a large pipe write after stdout has been
641
644
  // initialized. The stream queues the remaining bytes until the reader drains.
642
645
  if (output && !process.stdout.write(`${output}\n`)) {
@@ -650,7 +653,8 @@ export function printCliResult<T, Row extends Record<string, unknown> = Record<s
650
653
  console.error(wrapToTerminal(`${cliStyles.warning("warning:")} ${hinted(warning)}`));
651
654
  }
652
655
  }
653
- // CSV says what its rows do not in closing `# note:` lines; NDJSON has no place for one among its rows,
656
+ if (!options.quiet) for (const line of footer) console.error(line);
657
+ // CSV says what its rows do not in closing `note:` lines, on stderr; NDJSON has no place for one among its rows,
654
658
  // so the same notes go to stderr, where the warnings are.
655
659
  if (options.format === "ndjson" && !options.quiet) {
656
660
  for (const note of exportNdjsonNotes(result, options, renderOptions)) console.error(`note: ${note}`);
@@ -0,0 +1,43 @@
1
+ /** Spreadsheet formats people ask for by name, which no command writes: CSV is the one a spreadsheet opens. */
2
+ const SPREADSHEET_OPTIONS = new Set(["--xlsx", "--xls", "--excel", "--spreadsheet", "--sheet", "--sheets", "--tsv"]);
3
+
4
+ /** A file named after a spreadsheet flag (`--xlsx rates.xlsx`), which becomes the CSV's name. */
5
+ const SPREADSHEET_FILE = /\.(xlsx|xls|tsv)$/i;
6
+
7
+ /** An argument as a shell reads it back: quoted when it holds a space or a character the shell acts on. */
8
+ function shellWord(arg: string): string {
9
+ return /^[\w^=.,:/@%+-]+$/.test(arg) ? arg : `'${arg.replaceAll("'", "'\\''")}'`;
10
+ }
11
+
12
+ /**
13
+ * `quote ^TNX --xlsx`: the error names the formats there are, and the one a
14
+ * spreadsheet opens, as the command that was typed (`command`, the words
15
+ * before its arguments: `quote`, `fn QQ`) with `--csv` in place of the flag.
16
+ * `args` are what followed it; a file named after the flag keeps its name as a
17
+ * `.csv`, else the file is named after the command or the function.
18
+ */
19
+ export function spreadsheetOptionHint(flag: string, command: string, args: readonly string[] = []): string | null {
20
+ const name = flag.split("=")[0]!.toLowerCase();
21
+ if (!SPREADSHEET_OPTIONS.has(name)) return null;
22
+ let file: string | null = null;
23
+ const kept: string[] = [];
24
+ for (let index = 0; index < args.length; index += 1) {
25
+ const arg = args[index]!;
26
+ const [argFlag, value] = arg.split(/=(.*)/s, 2);
27
+ if (argFlag!.toLowerCase() !== name) {
28
+ kept.push(arg);
29
+ continue;
30
+ }
31
+ const next = args[index + 1];
32
+ if (value && SPREADSHEET_FILE.test(value)) file = value;
33
+ else if (next && SPREADSHEET_FILE.test(next)) {
34
+ file = next;
35
+ index += 1;
36
+ }
37
+ }
38
+ const words = [...command.trim().split(/\s+/), ...kept.filter((arg) => arg !== "--csv")];
39
+ // Named after the command, a function by its code (`fn QQ`: qq.csv).
40
+ const named = command.trim().split(/\s+/).filter((word, index) => index > 0 || word !== "fn");
41
+ const output = file ? file.replace(SPREADSHEET_FILE, ".csv") : `${named.join("-").toLowerCase()}.csv`;
42
+ return `Exports are --csv (opens in Excel and Google Sheets), --json or --ndjson: gloom ${words.map(shellWord).join(" ")} --csv > ${shellWord(output)}.`;
43
+ }
@@ -187,6 +187,16 @@ function symbolColumns(rows: readonly string[][]): Set<number> {
187
187
  return columns;
188
188
  }
189
189
 
190
+ /**
191
+ * A cell of symbols split by spaces in a list split by commas (`0700.hk
192
+ * 9988.HK`, `USDJPY=X USDCHF=X`): every word carries a listing's mark (a dot,
193
+ * a caret, `=`, `:` or a digit), which a company's name (`Apple Inc`) does not.
194
+ */
195
+ function isSymbolWords(cell: string): boolean {
196
+ const words = cell.trim().split(/\s+/);
197
+ return words.length > 1 && words.every((word) => isGridSymbol(word) && /[.^=:\d]/.test(word));
198
+ }
199
+
190
200
  /** A grid of numeric exchange codes alone, two or more to a row (`0700 9988`): every cell is a listing. */
191
201
  function numericCodeGrid(rows: readonly string[][]): boolean {
192
202
  return rows.some((cells) => cells.filter(Boolean).length > 1)
@@ -208,6 +218,40 @@ interface SymbolText {
208
218
  * Group`), or symbols written on one line (`AAPL MSFT`).
209
219
  */
210
220
  entries?: true;
221
+ /** A first row read as a header in words no header list knows (`Hisse,Adet,Maliyet`), skipped and named. */
222
+ header?: string[];
223
+ }
224
+
225
+ /** Words a sheet writes where a value is missing, beside the marks isJunkCell knows (`N/A`, `-`, `—`). */
226
+ const MISSING_WORD = /^(?:na|nan|none|null|nil)$/i;
227
+
228
+ /**
229
+ * Whether the first row of a delimited table is a header in any language:
230
+ * every cell of it a word, none a figure, over columns that turn from a word
231
+ * there to a number on every later row that fills them (`Hisse,Adet,Maliyet`
232
+ * over `THYAO,100,280`): two such columns, or one with no column of words
233
+ * beside it. A row of symbols with a rating or a name beside it (`AAPL,BUY`),
234
+ * or a grid with a numeric code in it (`AAL,czr us equity,UAL` over
235
+ * `DAL,2007,ULCC`), is no header. A mark for a missing value (`n/a`, `-`,
236
+ * `—`, `NA`) is a data row's, never a column's name: a first row with one is
237
+ * no header, and one on a later row leaves its column's numbers numbers.
238
+ */
239
+ function isWordHeader(records: readonly string[][]): boolean {
240
+ const [first, ...rest] = records;
241
+ if (!first || first.length < 2 || rest.length === 0) return false;
242
+ const missing = (cell: string) => isJunkCell(cell) || MISSING_WORD.test(cell.trim());
243
+ const word = (cell: string | undefined) =>
244
+ !!cell && !missing(cell) && /\p{L}/u.test(cell) && !isFigure(cell) && !isNumberCell(cell);
245
+ if (!first.every((cell) => !cell || word(cell)) || !word(first[0])) return false;
246
+ const width = Math.max(...records.map((cells) => cells.length));
247
+ let numbers = 0, words = 0;
248
+ for (let index = 1; index < width; index++) {
249
+ const below = rest.map((cells) => cells[index]).filter((cell): cell is string => !!cell && !missing(cell));
250
+ if (!below.length) continue;
251
+ if (word(first[index]) && below.every(isFigure)) numbers += 1;
252
+ else if (!below.every(isFigure)) words += 1;
253
+ }
254
+ return numbers >= 2 || (numbers === 1 && words === 0);
211
255
  }
212
256
 
213
257
  /**
@@ -242,6 +286,11 @@ export function parseSymbolText(text: string): SymbolText {
242
286
  // Without one, a delimited export's Name or Company column holds the companies, read as typed names are.
243
287
  const nameColumn = delimited ? header.findIndex((cell) => NAME_HEADERS.has(cell)) : -1;
244
288
  if (nameColumn >= 0) return { symbols: records.slice(1).map((cells) => cells[nameColumn] ?? "").filter(Boolean), ignored: [], entries: true };
289
+ // A header in words no list here knows (Turkish `Hisse,Adet,Maliyet`) is skipped, and the table below it read as one.
290
+ if (delimited && isWordHeader(records)) {
291
+ const below = records.slice(1).map((cells) => cells.join("\t")).join("\n");
292
+ return { ...parseSymbolText(below), header: records[0]!.filter(Boolean) };
293
+ }
245
294
  // A separator or quote mark stuck to a cell is dropped (and named) when it is read, so it does not make the list a table.
246
295
  const cleaned = records.map((cells) => cells.map((cell) => stripStrayEdges(cell).text));
247
296
  const figures = cleaned.some((cells) => cells.some((cell, index) => index > 0 && isFigure(cell)));
@@ -250,10 +299,13 @@ export function parseSymbolText(text: string): SymbolText {
250
299
  // A grid of symbols: a terminal's code is one cell (`CZR US Equity`), and so is a numeric code among tickers (`2007`).
251
300
  const codes = symbolColumns(cleaned);
252
301
  const grid = numericCodeGrid(cleaned) || cleaned.every((cells) => cells.every((cell, index) => (
253
- !cell || isJunkCell(cell) || isTerminalCodeCell(cell)
302
+ !cell || isJunkCell(cell) || isTerminalCodeCell(cell) || isSymbolWords(cell)
254
303
  || (isGridSymbol(cell) && (index === 0 || !isFigure(cell) || (NUMERIC_CODE.test(cell) && codes.has(index))))
255
304
  )));
256
- if (grid) return { symbols: records.flat().filter(Boolean), ignored: [] };
305
+ // A file of lines split by commas or spaces reads as the same list typed would (`lmt, NOC ,` then `^HSI, 0700.hk 9988.HK`):
306
+ // a cell of words is read as a typed entry is, so its symbols split.
307
+ const spaced = cleaned.some((cells) => cells.some((cell) => !isTerminalCodeCell(cell) && isSymbolWords(cell)));
308
+ if (grid) return { symbols: records.flat().filter(Boolean), ignored: [], ...spaced ? { entries: true as const } : {} };
257
309
  // Names split by semicolons or commas, with no figures: one pasted line, or one name a line with a separator left
258
310
  // on it, is a list. A name beside a sector or any other text is a table, read by its first column below.
259
311
  const names = cleaned.some((cells) => /\s/.test(cells[0] ?? ""));
@@ -395,7 +447,9 @@ export async function readSymbolList(source: SymbolListSource): Promise<{ symbol
395
447
  // A separator left on the end of what was typed: `UPST;`, or a list that ends in a comma.
396
448
  const strays = new Set<string>(stripStrayEdges(typedArgs.join(" ")).notes);
397
449
  const ignored: string[] = [];
398
- const addCells = async ({ symbols, ignored: beside, entries: whole }: SymbolText) => {
450
+ const headers: string[] = [];
451
+ const addCells = async ({ symbols, ignored: beside, entries: whole, header }: SymbolText) => {
452
+ if (header) headers.push(`Skipped the first row as a header: ${listCells(header)}.`);
399
453
  const cells = symbols.map((cell) => {
400
454
  const cleaned = stripStrayEdges(cell);
401
455
  cleaned.notes.forEach((note) => strays.add(note));
@@ -422,5 +476,5 @@ export async function readSymbolList(source: SymbolListSource): Promise<{ symbol
422
476
  // A number where a symbol goes (a line of prices, a typed 1.899) is left out with those typed beside a symbol.
423
477
  const numbers = [...figures, ...collected.filter(isNumberCell)];
424
478
  const notes = [ignoredCellsNote(ignored), ignoredNumbersNote(numbers)].filter((note): note is string => !!note);
425
- return { ...uniqueSymbols(collected.filter((symbol) => !isNumberCell(symbol))), notes: [...strays, ...notes] };
479
+ return { ...uniqueSymbols(collected.filter((symbol) => !isNumberCell(symbol))), notes: [...headers, ...strays, ...notes] };
426
480
  }
@@ -18,9 +18,10 @@ import {
18
18
  } from "./ticker-resolution";
19
19
  import { isUsSymbolVenue, LOOKUP_TIMEOUT_MS, movedAwayChange, tickerChangeLine, tickerChangeSymbol, type MovedTickerChange } from "../tickers/ticker-changes";
20
20
  import { isVenueAbroad } from "../tickers/listing-fate";
21
+ import { serviceMarkedOtherListing } from "../tickers/company-name-listing";
21
22
  import { sameCompany } from "../tickers/company-name";
22
23
  import { tickerHasListingSuffix } from "../sources/listing-symbols";
23
- import { canonicalExchange, exchangeLabel, resolveExchangeTimeZone } from "../utils/exchanges";
24
+ import { canonicalExchange, exchangeLabel, isUsListingExchange, resolveExchangeTimeZone } from "../utils/exchanges";
24
25
  import { isCurrencyPairListing } from "../utils/fx-market-hours";
25
26
  import { isCurrencyCode } from "../utils/currency-pair";
26
27
  import { logFailure } from "../utils/log-failure";
@@ -241,7 +242,13 @@ async function meantInstead(symbol: string, deps: SymbolDeps): Promise<string |
241
242
  async function settleAbroad(resolution: CliTicker, deps: SymbolDeps): Promise<{ abroad: string | null; meant: string | null; onlyAbroad: boolean }> {
242
243
  if (!await listedOnlyAbroad(resolution, deps)) return { abroad: null, meant: null, onlyAbroad: false };
243
244
  const meant = await meantInstead(resolution.bareSymbol!, deps);
244
- return { abroad: meant ? null : abroadOnlyNote(resolution), meant, onlyAbroad: true };
245
+ if (meant) return { abroad: null, meant, onlyAbroad: true };
246
+ // The listing the service names by the word, as `quote` says beside a minor line: "...; also 9432:JPX NTT, Inc.".
247
+ const marked = await serviceMarkedOtherListing(deps.dataProvider, resolution.bareSymbol!, resolution.ticker.metadata.exchange ?? "")
248
+ .catch(logFailure("cli.symbol-rows", "Read the listing a word names failed", null));
249
+ const note = abroadOnlyNote(resolution);
250
+ const also = marked ? `${note.replace(/\.$/, "")}; also ${marked.symbol}:${marked.exchange} ${marked.name}` : null;
251
+ return { abroad: also ? /\.$/.test(also) ? also : `${also}.` : note, meant: null, onlyAbroad: true };
245
252
  }
246
253
 
247
254
  /** Whether a YYYY-MM-DD day is within `ms` before `now`. */
@@ -345,9 +352,49 @@ export function summarizeSymbolRows(rows: readonly SymbolRow[], verb: Verb, repe
345
352
  groups.push(`${junk.length} not ${junk.length === 1 ? "a symbol" : "symbols"}: ${junk.join(junk.some((input) => input.includes(",")) ? "; " : ", ")}`);
346
353
  }
347
354
  if (repeated > 0) groups.push(`${repeated} repeat${repeated === 1 ? "" : "s"} skipped`);
355
+ // An add names the rows that landed off the list's main venues, to check or name with their venue (BP:LSE).
356
+ const off = verb === "add" ? offVenueSummary(rows) : null;
357
+ if (off) groups.push(off);
348
358
  return `${groups.join("; ")}.`;
349
359
  }
350
360
 
361
+ /** Rows a list must have before the venues most of them landed on are its main ones. */
362
+ const MAIN_VENUES_FROM = 10;
363
+ /** The share of a list's rows a venue holds to be one of its main venues. */
364
+ const MAIN_VENUE_SHARE = 0.1;
365
+
366
+ /**
367
+ * The rows of an add that landed outside the venues most of the list is on: a
368
+ * London and Tokyo book's BP on NYSE and NTT on Warsaw, which a bare symbol
369
+ * or a name can land on. Null for a short list, or one with no row off them.
370
+ */
371
+ function offVenueRows(rows: readonly SymbolRow[]): { main: string[]; rows: SymbolRow[] } | null {
372
+ // A pair or a coin has no venue to be off; the US exchanges are one market.
373
+ const market = (row: SymbolRow) => isUsListingExchange(row.exchange!) ? "US" : canonicalExchange(row.exchange!);
374
+ const landed = rows.filter((row) => (row.status === "added" || row.status === "already_listed") && row.exchange
375
+ && !isCurrencyPairListing(row.symbol ?? undefined, row.exchange) && !UNVENUED.has(canonicalExchange(row.exchange)));
376
+ if (landed.length < MAIN_VENUES_FROM) return null;
377
+ const counts = new Map<string, number>();
378
+ for (const row of landed) counts.set(market(row), (counts.get(market(row)) ?? 0) + 1);
379
+ const main = [...counts].filter(([, count]) => count >= landed.length * MAIN_VENUE_SHARE).sort((a, b) => b[1] - a[1]).map(([venue]) => venue);
380
+ const off = landed.filter((row) => !main.includes(market(row)));
381
+ return main.length > 0 && off.length > 0 ? { main, rows: off } : null;
382
+ }
383
+
384
+ /** Venues a row is on that are no market of listings: currencies, coins, perpetuals. */
385
+ const UNVENUED = new Set(["CCY", "CRYPTO", "FX"]);
386
+
387
+ /** "8 landed outside the list's main venues (LSE, JPX): BP:NYSE, NTT:WSE, ...", each as typed beside the listing it went to. */
388
+ function offVenueSummary(rows: readonly SymbolRow[]): string | null {
389
+ const off = offVenueRows(rows);
390
+ if (!off) return null;
391
+ const named = off.rows.map((row) => {
392
+ const typed = symbolInputKey(row.input);
393
+ return row.listing && typed !== row.listing ? `${typed} as ${row.listing}` : row.listing ?? typed;
394
+ });
395
+ return `${off.rows.length} landed outside the list's main venues (${off.main.join(", ")}): ${named.join(", ")}`;
396
+ }
397
+
351
398
  /** A message in a line's parentheses, without the subject the line already names or its closing stop. */
352
399
  export function reason(message: string, subject: string): string {
353
400
  const text = message.startsWith(`${subject}: `) ? message.slice(subject.length + 2) : message;
@@ -15,7 +15,7 @@ import {
15
15
  upsertTickerFromSearchResult,
16
16
  type ResolvedTickerSearch,
17
17
  } from "../tickers/search";
18
- import { canonicalExchange, parsePublicTickerKey } from "../utils/exchanges";
18
+ import { canonicalExchange, isUsListingExchange, parsePublicTickerKey } from "../utils/exchanges";
19
19
  import {
20
20
  chosenListingNote,
21
21
  isNoProviderError,
@@ -25,6 +25,10 @@ import {
25
25
  listingVenues,
26
26
  movedSymbolLine,
27
27
  notTradedMessage,
28
+ oneWordCompanyName,
29
+ serviceNamedCompany,
30
+ isTitleCaseWord,
31
+ titleCaseCompanyName,
28
32
  parseListingArg,
29
33
  quoteBareListing,
30
34
  resolveCliListing,
@@ -56,7 +60,7 @@ import { coinElsewhereNote, savedListingCoinNote } from "./commands/crypto-hints
56
60
  import { NotASymbolError, notASymbolError } from "./symbol-cells";
57
61
  import { kindFromListingSyntax } from "../tickers/instrument-kind";
58
62
  import { classifyInstrumentKind, normalizeTickerSymbol } from "../tickers/search/ranking";
59
- import { companyNameQueries, findFormerIssuerOfName, isCompanyNameInput } from "../tickers/company-name-listing";
63
+ import { companyNameQueries, findFormerIssuerOfName, isCompanyNameInput, settledTerminalCode } from "../tickers/company-name-listing";
60
64
 
61
65
  /** The saved ticker for a symbol (`SAN:EPA`, or `SAN` with `--exchange EPA`), saving it from search first if needed. */
62
66
  export async function resolveTickerForCli(
@@ -315,6 +319,15 @@ export async function resolveCliTicker(
315
319
  return withChange({ ...ended, otherVenues: bareNote ? bareVenues : null, ...uncheckedIf(listing, local, ended.ended) }, local.quote ? tradingListing(local.quote) : { name: local.ticker.metadata.name });
316
320
  }
317
321
 
322
+ // A bare word no quote of its own placed, which search read on a listing abroad, is the company the service marks
323
+ // with the word, as `quote` reads it: VISA is V:NYSE (Visa Inc.), not a receipt on Toronto; SHELL is SHEL:LSE.
324
+ const abroad = !listing.exchange && !!listing.typed && !isUsListingExchange(canonicalExchange(resolved.result.exchange));
325
+ const marked = abroad ? await serviceNamedCompany(listing.typed!, deps)
326
+ .catch(logFailure("cli.ticker-resolution", "Read a word the service marks as a name failed", null)) : null;
327
+ if (marked) {
328
+ const found = await resolveCliTicker(marked.key, store, dataProvider, undefined, options);
329
+ return { ...found, readAs: marked.readAs ?? found.readAs };
330
+ }
318
331
  const { ticker, created } = await upsertTickerFromSearchResult(store, resolved.result);
319
332
  // A listing saved before (by an earlier look at a list) is read again too: its quote says whether it still trades.
320
333
  const named = created || !bareQuote ? await nameFromListingQuote(ticker, store, dataProvider, bareQuote) : { ticker, quote: bareQuote };
@@ -599,6 +612,9 @@ function lookAgain(entry: CliTickerResolution): boolean {
599
612
  function listLookupPlan(input: string, exchange: string | undefined): ListLookupPlan {
600
613
  // What cannot be a symbol is refused without a request.
601
614
  if (notASymbolError(input)) return { searches: [], changes: null };
615
+ // A terminal's code abroad (`VOD LN`) is its listing as written: it asks only for its quote.
616
+ const code = settledTerminalCode(input);
617
+ if (code) return { searches: [], changes: null };
602
618
  // A company's name searches what its reading searched (`readNameEntries`), answered by the same batch.
603
619
  if (isCompanyNameInput(input)) return { searches: companyNameQueries(input), changes: null };
604
620
  try {
@@ -644,7 +660,7 @@ export async function resolveTickersForCli(
644
660
  }: Pick<CliTickerOptions, "retry" | "askWhenAmbiguous"> & {
645
661
  /** Told before each new look, with how many symbols and how long it waits first. */
646
662
  onRetry?: (count: number, waitMs: number) => void;
647
- /** Told as each symbol of the first look is settled, with how many are and how many there are. */
663
+ /** Told (0, total) as the first look starts, then as each of its symbols is settled, with how many are and how many there are. */
648
664
  onProgress?: (looked: number, total: number) => void;
649
665
  retryWaitsMs?: readonly number[];
650
666
  } = {},
@@ -652,9 +668,16 @@ export async function resolveTickersForCli(
652
668
  const plans = new Map(symbols.map((input) => [input, listLookupPlan(input, exchange)] as const));
653
669
  let settled = 0;
654
670
  const progress = onProgress ? () => onProgress(++settled, symbols.length) : undefined;
671
+ // Told before any answer, so a slow first answer is said to be awaited.
672
+ onProgress?.(0, symbols.length);
673
+ // Symbols every search and own quote of which the service answered in some look: one found nothing for is not
674
+ // found, whatever it refused the others, so it is neither looked up again nor offered to try again.
675
+ const told = new Set<string>();
676
+ const notFound = (entry: CliTickerResolution) => entry.error instanceof TickerNotFoundError && told.has(entry.input);
655
677
  // Each look asks for its symbols' searches and changes in batches first.
656
678
  const look = async (inputs: readonly string[], concurrency: number, looked?: () => void): Promise<Map<string, CliTickerResolution>> => {
657
679
  const batched = await batchedListLookups(dataProvider, inputs.map((input) => plans.get(input)!));
680
+ for (const input of inputs) if (batched.settled(plans.get(input)!)) told.add(input);
658
681
  const resolve = (symbol: string) => resolveCliTicker(symbol, store, batched.dataProvider, exchange, {
659
682
  retry, askWhenAmbiguous, ownExchangeWins: true, changeGraceMs: LOOKUP_TIMEOUT_MS,
660
683
  });
@@ -672,7 +695,7 @@ export async function resolveTickersForCli(
672
695
  let failing = failedRequests.count() > 0 || lookups.some(busyLookup);
673
696
  for (const waitMs of retryWaitsMs) {
674
697
  // A match whose quote was refused is looked at again too, so it gets the check a first look gives.
675
- const failed = lookups.filter(lookAgain).map((entry) => entry.input);
698
+ const failed = lookups.filter((entry) => lookAgain(entry) && !notFound(entry)).map((entry) => entry.input);
676
699
  if (!failing || failed.length === 0) break;
677
700
  onRetry?.(failed.length, waitMs);
678
701
  await new Promise((resolveWait) => setTimeout(resolveWait, waitMs));
@@ -681,13 +704,83 @@ export async function resolveTickersForCli(
681
704
  lookups = lookups.map((entry) => again.get(entry.input) ?? entry);
682
705
  failing = failedRequests.count() > before || [...again.values()].some(busyLookup);
683
706
  }
707
+ // A company's name typed as one word (Canon, ADVANTEST) that no listing trades as is read as `quote` reads it.
708
+ lookups = await withOneWordNames(lookups, store, dataProvider, { retry, askWhenAmbiguous });
709
+ // One written as a name (Aeon) that went to another company's ticker is the company of that name.
710
+ lookups = await withTitleCaseNames(lookups, store, dataProvider, { retry, askWhenAmbiguous });
684
711
  if (!failing) return lookups;
685
712
  // Still refused after the last wait: a failure may only be the refusal, so none is called not found,
686
713
  // and a match whose quote was refused is not taken as trading.
687
- return lookups.map((entry) => lookAgain(entry)
714
+ return lookups.map((entry) => lookAgain(entry) && !notFound(entry)
688
715
  ? { input: entry.input, error: new LookupUnansweredError(entry.input) }
689
716
  : entry);
690
717
  } finally {
691
718
  failedRequests.stop();
692
719
  }
693
720
  }
721
+
722
+ /** Names of one word looked up at once: each is a search and a quote. */
723
+ const NAME_CONCURRENCY = 4;
724
+
725
+ /**
726
+ * The lookups, each word no listing trades as (`TickerNotFoundError`) that
727
+ * names a company read as that company's listing, as `quote` reads it
728
+ * (`oneWordCompanyName`): CANON is 7751:JPX, and its row says so ("Read
729
+ * "CANON" as 7751:JPX (Canon Inc.)."). A word that names none keeps its own
730
+ * error.
731
+ */
732
+ async function withOneWordNames(
733
+ lookups: CliTickerResolution[],
734
+ store: AppTickerRepositoryPort,
735
+ dataProvider: DataProvider,
736
+ options: Pick<CliTickerOptions, "retry" | "askWhenAmbiguous">,
737
+ ): Promise<CliTickerResolution[]> {
738
+ const words = lookups.filter((entry) => entry.error instanceof TickerNotFoundError && !entry.error.successor && ONE_WORD.test(entry.input));
739
+ if (words.length === 0) return lookups;
740
+ const read = new Map((await mapWithConcurrency(words, NAME_CONCURRENCY, async (entry): Promise<CliTickerResolution> => {
741
+ try {
742
+ const named = await oneWordCompanyName(entry.input, { dataProvider });
743
+ if (!named) return entry;
744
+ const found = await resolveCliTicker(named.key, store, dataProvider, undefined, { ...options, ownExchangeWins: true, changeGraceMs: LOOKUP_TIMEOUT_MS });
745
+ return { input: entry.input, ...found, readAs: named.readAs ?? found.readAs };
746
+ } catch (error) {
747
+ // A name that cannot be read keeps the word's own "not found".
748
+ logFailure("cli.ticker-resolution", "Read a word as a company's name failed")(error);
749
+ return entry;
750
+ }
751
+ })).map((entry) => [entry.input, entry] as const));
752
+ return lookups.map((entry) => read.get(entry.input) ?? entry);
753
+ }
754
+
755
+ /**
756
+ * The lookups, each word written as a company's name (`Aeon`) that went to
757
+ * another company's ticker read as the company of that name, as `quote`
758
+ * reads it (`titleCaseCompanyName`): "Aeon" is 8267:JPX (Aeon Co., Ltd.), not
759
+ * AEON Biopharma's AEON, and its row says so. A word that names no such
760
+ * company keeps its ticker.
761
+ */
762
+ async function withTitleCaseNames(
763
+ lookups: CliTickerResolution[],
764
+ store: AppTickerRepositoryPort,
765
+ dataProvider: DataProvider,
766
+ options: Pick<CliTickerOptions, "retry" | "askWhenAmbiguous">,
767
+ ): Promise<CliTickerResolution[]> {
768
+ const words = lookups.filter((entry) => !entry.error && !entry.readAs && isTitleCaseWord(entry.input));
769
+ if (words.length === 0) return lookups;
770
+ const read = new Map((await mapWithConcurrency(words, NAME_CONCURRENCY, async (entry): Promise<CliTickerResolution> => {
771
+ try {
772
+ const named = await titleCaseCompanyName(entry.input, { symbol: entry.ticker!.metadata.ticker, name: entry.ticker!.metadata.name }, { dataProvider });
773
+ if (!named) return entry;
774
+ const found = await resolveCliTicker(named.key, store, dataProvider, undefined, { ...options, ownExchangeWins: true, changeGraceMs: LOOKUP_TIMEOUT_MS });
775
+ return { input: entry.input, ...found, readAs: named.readAs ?? found.readAs };
776
+ } catch (error) {
777
+ // A name that cannot be read keeps the ticker the word went to.
778
+ logFailure("cli.ticker-resolution", "Read a word written as a name failed")(error);
779
+ return entry;
780
+ }
781
+ })).map((entry) => [entry.input, entry] as const));
782
+ return lookups.map((entry) => read.get(entry.input) ?? entry);
783
+ }
784
+
785
+ /** A word that can be a company's name: letters, three and more, as a pasted name is (`Canon`, `ENEOS`). */
786
+ const ONE_WORD = /^\p{L}[\p{L}&'-]{2,}$/u;
@@ -1,3 +1,5 @@
1
+ import { bankFigurePointer, exportCommandPointer } from "./known-gaps";
2
+
1
3
  /** A function the catalog finds for a word typed as a command (`comps`, `peers`). */
2
4
  export interface CatalogCommandHit {
3
5
  code: string;
@@ -86,3 +88,89 @@ export function catalogPointer(token: string, hits: readonly CatalogCommandHit[]
86
88
  `Search the catalog: ${more}`,
87
89
  ].join("\n");
88
90
  }
91
+
92
+ /** A command's name and the usage lines its help gives, as `gloom help` prints them. */
93
+ export interface CommandUsage {
94
+ name: string;
95
+ usage: readonly string[];
96
+ }
97
+
98
+ /**
99
+ * What a subcommand typed on its own (`gloom position set Izmir THYAO 100 280`)
100
+ * is answered with: the command it belongs to, run with what was typed after
101
+ * it (`gloom portfolio position set Izmir THYAO 100 280`), or each command it
102
+ * belongs to when several share it (`add`). Read from the commands' usage
103
+ * lines; null when no usage line has the word after a command's name.
104
+ */
105
+ export function subcommandPointer(
106
+ token: string,
107
+ args: readonly string[],
108
+ commands: readonly CommandUsage[],
109
+ ): { owners: string[]; run: string[] } | null {
110
+ const word = token.trim().toLowerCase();
111
+ if (!/^[a-z][a-z-]*$/.test(word)) return null;
112
+ const owners = commands.filter((command) => command.usage.some((line) => {
113
+ const [name, sub] = line.trim().split(/\s+/);
114
+ return name === command.name && sub === word;
115
+ }));
116
+ if (owners.length === 0) return null;
117
+ const typed = [word, ...args].map(shellWord).join(" ");
118
+ return { owners: owners.map((command) => command.name), run: owners.map((command) => `gloom ${command.name} ${typed}`) };
119
+ }
120
+
121
+ export interface UnknownCommandPointers {
122
+ /** The word is a function's code: the command that runs it. */
123
+ fn: { code: string; command: string } | null;
124
+ /** The word is a slip from one function's code (RCDF for RDCF), read only when it is no code, no command is close to it and the catalog finds nothing for it. */
125
+ nearFn: { code: string; label: string; command: string } | null;
126
+ /** Functions the catalog finds for the word, read only when it is no code and no command is close to it. */
127
+ hits: CatalogCommandHit[];
128
+ /** What the reader typed after the word, which a pointer runs the function with. */
129
+ args: readonly string[];
130
+ }
131
+
132
+ /**
133
+ * What an unknown command word is answered with, the first that fits: a
134
+ * function's code is pointed at `fn`; a bank figure's name (`nim JPM`) at the
135
+ * Bank section; a subcommand typed without its command (`position set`) at
136
+ * the command it belongs to, unless the word is `export` (a flag, `--csv` or
137
+ * `--json`) or written as a ticker (`CASH`), which keep their own answers; a
138
+ * slip from a function's code (`RCDF`) at that function; a typo of a command
139
+ * (`suggestion`) at the command; and a word the catalog knows (`comps`) at the
140
+ * functions it finds. A word written as a ticker is also pointed at `quote`
141
+ * and `search`.
142
+ */
143
+ export function unknownCommandReply(
144
+ token: string,
145
+ commands: readonly CommandUsage[],
146
+ pointers: UnknownCommandPointers,
147
+ suggestion: string | null,
148
+ ): { message: string; details?: string } {
149
+ if (pointers.fn) return { message: `${pointers.fn.code} is a function: ${pointers.fn.command}` };
150
+ // A bank figure's name (`nim JPM`, `deposits WFC`) is where it is: the Bank section of fundamentals, NIM in EQS.
151
+ const bank = bankFigurePointer(token, pointers.args[0] ?? "");
152
+ if (bank) return { message: `Unknown command "${token}": a bank's figures are in the Bank section of fundamentals.`, details: bank.details };
153
+ const ticker = tickerPointer(token);
154
+ // Exporting is a flag, not a command: `export LMT` says how, rather than listing functions that mention exports.
155
+ const exported = exportCommandPointer(token, pointers.args);
156
+ const subcommand = exported || ticker ? null : subcommandPointer(token, pointers.args, commands);
157
+ if (subcommand) {
158
+ const owners = subcommand.owners.length > 1
159
+ ? `${subcommand.owners.slice(0, -1).join(", ")} and ${subcommand.owners.at(-1)}` : subcommand.owners[0];
160
+ return {
161
+ message: `Unknown command "${token}": it is a subcommand of ${owners}.`,
162
+ details: subcommand.run.map((command) => `Run: ${command}`).join("\n"),
163
+ };
164
+ }
165
+ if (!suggestion && pointers.nearFn) {
166
+ return {
167
+ message: `Unknown command "${token}". Did you mean the function ${pointers.nearFn.code} (${pointers.nearFn.label})?`,
168
+ details: [`Run: ${pointers.nearFn.command}`, ticker].filter(Boolean).join("\n"),
169
+ };
170
+ }
171
+ const catalog = suggestion ? null : exported ?? catalogPointer(token, pointers.hits, pointers.args);
172
+ const help = suggestion
173
+ ? `Did you mean ${suggestion}? Run gloom help to see every command.`
174
+ : catalog ? `${catalog}\nRun gloom help to see every command.` : "Run gloom help to see every command.";
175
+ return { message: `Unknown command "${token}".`, details: ticker ? `${ticker}\n${help}` : help };
176
+ }