gloomberb 0.20.7 → 0.20.8

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 (611) hide show
  1. package/README.ja.md +74 -0
  2. package/README.md +2 -0
  3. package/README.zh-CN.md +2 -0
  4. package/package.json +6 -1
  5. package/src/account/auth-model.ts +22 -0
  6. package/src/api-client/auth.ts +7 -2
  7. package/src/api-client/awards.ts +5 -0
  8. package/src/api-client/bond-trades.ts +22 -0
  9. package/src/api-client/catalysts.ts +11 -1
  10. package/src/api-client/data.ts +30 -6
  11. package/src/api-client/debt-maturities.ts +7 -0
  12. package/src/api-client/equity-screener.ts +17 -0
  13. package/src/api-client/errors.ts +2 -0
  14. package/src/api-client/exchange-announcements.ts +14 -7
  15. package/src/api-client/fund-facts.ts +21 -3
  16. package/src/api-client/futures-curve.ts +14 -1
  17. package/src/api-client/geo.ts +10 -0
  18. package/src/api-client/hiring.ts +2 -0
  19. package/src/api-client/index.ts +3 -0
  20. package/src/api-client/insider-signals.ts +14 -0
  21. package/src/api-client/members.ts +30 -2
  22. package/src/api-client/money-markets.ts +11 -1
  23. package/src/api-client/paths.ts +6 -1
  24. package/src/api-client/perps.ts +2 -0
  25. package/src/api-client/request.ts +2 -1
  26. package/src/api-client/socket.ts +7 -0
  27. package/src/api-client/types/econ.ts +2 -1
  28. package/src/api-client/types/filings-and-calls.ts +6 -0
  29. package/src/api-client/types/market.ts +4 -0
  30. package/src/api-client/web-experiments.ts +5 -6
  31. package/src/app/runtime/update.ts +2 -1
  32. package/src/architecture/floating-promise-allowlist.json +33 -106
  33. package/src/capabilities/asset-data-inputs.ts +183 -0
  34. package/src/capabilities/factories.ts +8 -2
  35. package/src/cli/base-converter.ts +36 -2
  36. package/src/cli/commands/api.ts +2 -2
  37. package/src/cli/commands/command-utils.ts +18 -0
  38. package/src/cli/commands/hong-kong-movers.ts +50 -0
  39. package/src/cli/commands/market.ts +539 -130
  40. package/src/cli/commands/options-chain.ts +7 -1
  41. package/src/cli/commands/overview.ts +74 -14
  42. package/src/cli/commands/plugins.ts +7 -6
  43. package/src/cli/commands/search.ts +52 -9
  44. package/src/cli/commands/system.ts +15 -10
  45. package/src/cli/commands/ticker.ts +97 -44
  46. package/src/cli/content-figures.ts +45 -0
  47. package/src/cli/context.ts +5 -0
  48. package/src/cli/desktop-pane-shot-routes.ts +13 -4
  49. package/src/cli/desktop-pane-shot.ts +86 -12
  50. package/src/cli/earnings-calendar.ts +36 -5
  51. package/src/cli/export-source.ts +17 -3
  52. package/src/cli/fx-pair.ts +111 -11
  53. package/src/cli/glossary.ts +36 -2
  54. package/src/cli/help.ts +1 -1
  55. package/src/cli/history-export.ts +29 -11
  56. package/src/cli/history-rows.ts +130 -21
  57. package/src/cli/index.ts +8 -5
  58. package/src/cli/known-gaps.ts +45 -1
  59. package/src/cli/listing-arg.ts +366 -19
  60. package/src/cli/pane-functions/capabilities.ts +2 -2
  61. package/src/cli/pane-functions/catalog.ts +105 -9
  62. package/src/cli/pane-functions/discovery.ts +2 -0
  63. package/src/cli/pane-functions/dom.ts +46 -9
  64. package/src/cli/pane-functions/freshness.ts +7 -3
  65. package/src/cli/pane-functions/function-help.ts +9 -6
  66. package/src/cli/pane-functions/headless.ts +77 -6
  67. package/src/cli/pane-functions/index.ts +141 -23
  68. package/src/cli/pane-functions/options.ts +1 -3
  69. package/src/cli/pane-functions/plugin-code.ts +169 -0
  70. package/src/cli/pane-functions/report.ts +10 -0
  71. package/src/cli/pane-functions/resolver.ts +69 -21
  72. package/src/cli/pane-functions/screenshot-assessment.ts +82 -3
  73. package/src/cli/pane-functions/screenshot-data-evidence.ts +3 -1
  74. package/src/cli/pane-functions/screenshot-types.ts +6 -0
  75. package/src/cli/quote-answer.ts +49 -2
  76. package/src/cli/registry.ts +42 -4
  77. package/src/cli/report-tables.ts +26 -6
  78. package/src/cli/result.ts +13 -2
  79. package/src/cli/series-search.ts +17 -7
  80. package/src/cli/statement-filings.ts +22 -8
  81. package/src/cli/symbol-args.ts +9 -0
  82. package/src/cli/ticker-resolution.ts +3 -2
  83. package/src/cli/unknown-command.ts +111 -14
  84. package/src/components/chart/composite/format.ts +15 -1
  85. package/src/components/chart/composite/legend.tsx +101 -47
  86. package/src/components/chart/composite/panel-labels.ts +4 -4
  87. package/src/components/chart/composite/panel-surface.tsx +4 -6
  88. package/src/components/chart/composite/scene/build.ts +180 -0
  89. package/src/components/chart/composite/scene/cursor.ts +226 -0
  90. package/src/components/chart/composite/scene/domain.ts +170 -0
  91. package/src/components/chart/composite/scene/markers.ts +115 -0
  92. package/src/components/chart/composite/scene/panels.ts +85 -0
  93. package/src/components/chart/composite/scene/points.ts +169 -0
  94. package/src/components/chart/composite/scene/projection.ts +105 -0
  95. package/src/components/chart/composite/scene/timeline.ts +71 -0
  96. package/src/components/chart/composite/scene.ts +12 -1066
  97. package/src/components/chart/composite/types.ts +4 -2
  98. package/src/components/chart/curve/model.ts +2 -2
  99. package/src/components/chart-table/axis.ts +18 -6
  100. package/src/components/command-bar/layout-items/focused-pane.ts +3 -0
  101. package/src/components/command-bar/list/model.ts +9 -0
  102. package/src/components/command-bar/pane-templates/items.ts +61 -15
  103. package/src/components/command-bar/pane-templates/workflow.ts +16 -5
  104. package/src/components/command-bar/routes/root/plugin-install.ts +7 -46
  105. package/src/components/command-bar/routes/root/provider-search.ts +8 -5
  106. package/src/components/command-bar/routes/root/results.ts +6 -1
  107. package/src/components/command-bar/routes/root/runtime.ts +1 -0
  108. package/src/components/command-bar/routes/root/shortcut-feedback.ts +4 -1
  109. package/src/components/command-bar/routes/ticker-search/actions.ts +7 -5
  110. package/src/components/command-bar/routes/ticker-search/results.ts +51 -3
  111. package/src/components/command-bar/view-model.ts +12 -0
  112. package/src/components/command-bar/workflow/ops.ts +21 -4
  113. package/src/components/command-bar/workflow/ticker-listing-picker.ts +3 -1
  114. package/src/components/command-bar/workflow/tickers.ts +6 -2
  115. package/src/components/data-table/view.tsx +46 -1
  116. package/src/components/form-modal/confirm.tsx +3 -2
  117. package/src/components/form-modal/content.tsx +3 -2
  118. package/src/components/form-modal/field-row.tsx +2 -0
  119. package/src/components/form-modal/host.tsx +18 -3
  120. package/src/components/form-modal/remote-reads.test-helpers.ts +34 -0
  121. package/src/components/index.ts +1 -1
  122. package/src/components/layout/pane/title.ts +21 -5
  123. package/src/components/layout/shell/pane/layers.tsx +20 -14
  124. package/src/components/layout/shell/pane-occlusion.ts +21 -0
  125. package/src/components/onboarding/desks-step.tsx +7 -1
  126. package/src/components/onboarding/onboarding-keyboard.ts +48 -6
  127. package/src/components/onboarding/onboarding-wizard.tsx +47 -8
  128. package/src/components/onboarding/portfolio-step/positions-panel.tsx +17 -3
  129. package/src/components/onboarding/use-onboarding-progress.ts +57 -14
  130. package/src/components/onboarding/wizard-positions.ts +2 -0
  131. package/src/components/paged-rows.ts +11 -5
  132. package/src/components/ticker/list-table-view.tsx +24 -5
  133. package/src/components/toggle-list.tsx +44 -1
  134. package/src/components/ui/data-table/opentui/index.tsx +7 -6
  135. package/src/components/ui/data-table/opentui/model.ts +7 -3
  136. package/src/components/ui/data-table/types.ts +13 -2
  137. package/src/components/ui/fields.tsx +16 -4
  138. package/src/components/ui/query-bar.tsx +43 -9
  139. package/src/components/ui/table-layout.ts +56 -2
  140. package/src/core/app-services.ts +7 -2
  141. package/src/core/connection-health.ts +26 -0
  142. package/src/core/state/app/layout.ts +12 -4
  143. package/src/data/config/layout.ts +3 -1
  144. package/src/data/config/store/node.ts +4 -2
  145. package/src/docs/snapshot.json +756 -216
  146. package/src/i18n/es.ts +4 -1
  147. package/src/i18n/ja.ts +4 -1
  148. package/src/i18n/ko.ts +4 -1
  149. package/src/i18n/zh-cn.ts +4 -1
  150. package/src/i18n/zh-tw.ts +4 -1
  151. package/src/layout/pane-follow.ts +1 -1
  152. package/src/layout/pane-manager/gridlock.ts +18 -5
  153. package/src/layout/pane-manager/index.ts +1 -0
  154. package/src/layout/pane-manager/transient.ts +56 -0
  155. package/src/layout-marketplace/gallery.tsx +2 -1
  156. package/src/layout-marketplace/model.ts +4 -10
  157. package/src/market-data/commodity-names.ts +24 -0
  158. package/src/market-data/connection-follow.ts +9 -7
  159. package/src/market-data/coordinator/auxiliary.ts +4 -3
  160. package/src/market-data/coordinator/entries.ts +22 -1
  161. package/src/market-data/coordinator/financials.ts +2 -3
  162. package/src/market-data/coordinator/index.ts +67 -12
  163. package/src/market-data/coordinator/quotes.ts +2 -3
  164. package/src/market-data/fund-facts.ts +7 -1
  165. package/src/market-data/futures-board.ts +38 -4
  166. package/src/market-data/futures-contract.ts +5 -2
  167. package/src/market-data/fx-closes.ts +4 -1
  168. package/src/market-data/market/bar-period.ts +15 -0
  169. package/src/market-data/market/format.ts +4 -2
  170. package/src/market-data/market/freshness.ts +4 -0
  171. package/src/market-data/market/status.ts +23 -3
  172. package/src/market-data/options-alternatives.ts +21 -9
  173. package/src/market-data/published-futures-sessions.ts +9 -0
  174. package/src/market-data/quotes/balance-sheet-rate.ts +34 -0
  175. package/src/market-data/quotes/delisting.ts +26 -2
  176. package/src/market-data/quotes/freshness.ts +62 -0
  177. package/src/market-data/quotes/listing-enterprise-value.ts +250 -19
  178. package/src/market-data/quotes/regular-session-valuation.ts +8 -0
  179. package/src/market-data/realized-volatility.ts +3 -1
  180. package/src/market-data/request-types.ts +2 -0
  181. package/src/market-data/selectors.ts +1 -0
  182. package/src/news/aggregator.ts +3 -3
  183. package/src/plugins/builtin/account-management/delete-account.ts +78 -0
  184. package/src/plugins/builtin/account-management/pane.tsx +22 -19
  185. package/src/plugins/builtin/account-management/password-dialog.tsx +75 -0
  186. package/src/plugins/builtin/alerts/alert-log.ts +3 -2
  187. package/src/plugins/builtin/alerts/cli-forms.ts +1 -1
  188. package/src/plugins/builtin/alerts/cli.ts +72 -4
  189. package/src/plugins/builtin/alerts/format.ts +8 -2
  190. package/src/plugins/builtin/alerts/index.tsx +8 -5
  191. package/src/plugins/builtin/alerts/pane.tsx +5 -3
  192. package/src/plugins/builtin/alerts/research-builder.ts +12 -0
  193. package/src/plugins/builtin/analytics/index.tsx +3 -3
  194. package/src/plugins/builtin/analytics/risk-client.ts +14 -3
  195. package/src/plugins/builtin/analytics/risk-pane.tsx +3 -3
  196. package/src/plugins/builtin/attention/pane.tsx +1 -1
  197. package/src/plugins/builtin/attention/trending.tsx +1 -1
  198. package/src/plugins/builtin/awards/detail.tsx +4 -1
  199. package/src/plugins/builtin/awards/headless.ts +7 -3
  200. package/src/plugins/builtin/awards/model.ts +11 -0
  201. package/src/plugins/builtin/awards/pane.tsx +12 -5
  202. package/src/plugins/builtin/backtest/client.ts +7 -2
  203. package/src/plugins/builtin/backtest/headless.ts +2 -1
  204. package/src/plugins/builtin/backtest/pane.tsx +4 -2
  205. package/src/plugins/builtin/bond-calculator/pane.tsx +1 -1
  206. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  207. package/src/plugins/builtin/broker-trading/orders.tsx +2 -2
  208. package/src/plugins/builtin/buildout/company/pane.tsx +1 -1
  209. package/src/plugins/builtin/buildout/model/index.ts +2 -2
  210. package/src/plugins/builtin/catalysts/headless.ts +9 -6
  211. package/src/plugins/builtin/catalysts/model.ts +72 -10
  212. package/src/plugins/builtin/catalysts/pane.tsx +10 -7
  213. package/src/plugins/builtin/cds/pane.tsx +5 -3
  214. package/src/plugins/builtin/central-bank-rates/pane.tsx +3 -2
  215. package/src/plugins/builtin/chart-composer/catalog-series.ts +59 -0
  216. package/src/plugins/builtin/chart-composer/headless-schema.ts +2 -1
  217. package/src/plugins/builtin/chart-composer/headless.ts +104 -23
  218. package/src/plugins/builtin/chart-composer/index.tsx +6 -3
  219. package/src/plugins/builtin/chart-composer/legend-names.ts +19 -0
  220. package/src/plugins/builtin/chart-composer/pane.tsx +37 -10
  221. package/src/plugins/builtin/chart-composer/presets.ts +63 -6
  222. package/src/plugins/builtin/chart-composer/roll-events.ts +38 -0
  223. package/src/plugins/builtin/chart-composer/series-catalog.ts +12 -5
  224. package/src/plugins/builtin/chart-composer/series-expression.ts +8 -4
  225. package/src/plugins/builtin/chart-composer/series-listings.ts +33 -9
  226. package/src/plugins/builtin/chart-composer/use-series-catalog.ts +2 -2
  227. package/src/plugins/builtin/clinical-trials/client.ts +13 -0
  228. package/src/plugins/builtin/clinical-trials/index.tsx +1 -1
  229. package/src/plugins/builtin/clinical-trials/pane.tsx +77 -27
  230. package/src/plugins/builtin/clinical-trials/search.ts +117 -0
  231. package/src/plugins/builtin/cloud/askg/conversation-store.ts +17 -6
  232. package/src/plugins/builtin/cloud/askg/lock-note.ts +4 -2
  233. package/src/plugins/builtin/cloud/askg/manifest.ts +3 -2
  234. package/src/plugins/builtin/cloud/askg/pane.tsx +2 -2
  235. package/src/plugins/builtin/cloud/askg/sources.ts +3 -3
  236. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +7 -3
  237. package/src/plugins/builtin/cloud/team/acm-tab.tsx +1 -1
  238. package/src/plugins/builtin/cloud/team/pane.tsx +17 -10
  239. package/src/plugins/builtin/cloud/team/views.ts +15 -3
  240. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +105 -16
  241. package/src/plugins/builtin/cloud/thesis/board-pane.tsx +17 -2
  242. package/src/plugins/builtin/cloud/thesis/module.tsx +3 -2
  243. package/src/plugins/builtin/cloud/thesis/store.ts +17 -3
  244. package/src/plugins/builtin/commodities-energy/index.tsx +35 -3
  245. package/src/plugins/builtin/commodity-balances/index.tsx +1 -1
  246. package/src/plugins/builtin/company-attention/app-rank.tsx +1 -1
  247. package/src/plugins/builtin/company-attention/building.tsx +1 -1
  248. package/src/plugins/builtin/company-attention/model.ts +2 -1
  249. package/src/plugins/builtin/company-attention/moves.tsx +1 -1
  250. package/src/plugins/builtin/company-attention/pane.tsx +1 -1
  251. package/src/plugins/builtin/company-attention/signals.tsx +1 -1
  252. package/src/plugins/builtin/company-kpis/pane.tsx +1 -1
  253. package/src/plugins/builtin/correlation/headless.ts +7 -5
  254. package/src/plugins/builtin/correlation/history.ts +17 -6
  255. package/src/plugins/builtin/correlation/index.tsx +1 -1
  256. package/src/plugins/builtin/correlation/relationship/history.ts +1 -1
  257. package/src/plugins/builtin/correlation/relationship/pane.tsx +1 -1
  258. package/src/plugins/builtin/cot/headless.ts +10 -3
  259. package/src/plugins/builtin/cot/pane.tsx +2 -2
  260. package/src/plugins/builtin/cpi/pane.tsx +1 -1
  261. package/src/plugins/builtin/credit-boards/model.ts +1 -1
  262. package/src/plugins/builtin/credit-documents/pane.tsx +1 -1
  263. package/src/plugins/builtin/crypto-board/defi-view.tsx +2 -2
  264. package/src/plugins/builtin/crypto-board/defi.ts +9 -3
  265. package/src/plugins/builtin/crypto-board/headless.ts +19 -10
  266. package/src/plugins/builtin/crypto-board/model.ts +8 -0
  267. package/src/plugins/builtin/crypto-board/pane.tsx +11 -5
  268. package/src/plugins/builtin/crypto-board/series.ts +17 -3
  269. package/src/plugins/builtin/crypto-board/supply.ts +26 -3
  270. package/src/plugins/builtin/crypto-etf-flows/headless.ts +3 -2
  271. package/src/plugins/builtin/crypto-etf-flows/model.ts +13 -3
  272. package/src/plugins/builtin/crypto-etf-flows/pane.tsx +6 -3
  273. package/src/plugins/builtin/custom-view/pane.tsx +5 -5
  274. package/src/plugins/builtin/debt-maturities/client.ts +5 -0
  275. package/src/plugins/builtin/debt-maturities/headless.ts +3 -1
  276. package/src/plugins/builtin/debt-maturities/model.ts +1 -0
  277. package/src/plugins/builtin/debt-maturities/pane.tsx +1 -1
  278. package/src/plugins/builtin/dividend-yield/pane.tsx +1 -1
  279. package/src/plugins/builtin/doe/model.ts +1 -1
  280. package/src/plugins/builtin/doe/pane.tsx +1 -1
  281. package/src/plugins/builtin/earnings/board.tsx +2 -2
  282. package/src/plugins/builtin/earnings/history.tsx +1 -1
  283. package/src/plugins/builtin/earnings-calls/calendar.tsx +1 -1
  284. package/src/plugins/builtin/earnings-calls/data.ts +2 -1
  285. package/src/plugins/builtin/earnings-calls/headless.ts +15 -0
  286. package/src/plugins/builtin/earnings-calls/model.ts +68 -8
  287. package/src/plugins/builtin/earnings-calls/pane.tsx +29 -8
  288. package/src/plugins/builtin/earnings-calls/transcript-view.tsx +32 -2
  289. package/src/plugins/builtin/earnings-ripple/pane.tsx +1 -1
  290. package/src/plugins/builtin/econ/calendar-model.ts +94 -2
  291. package/src/plugins/builtin/econ/detail-view.tsx +15 -11
  292. package/src/plugins/builtin/econ/index.tsx +25 -9
  293. package/src/plugins/builtin/econ/types.ts +4 -1
  294. package/src/plugins/builtin/equity-screener/headless.ts +23 -7
  295. package/src/plugins/builtin/equity-screener/index.tsx +3 -0
  296. package/src/plugins/builtin/equity-screener/live.ts +39 -12
  297. package/src/plugins/builtin/equity-screener/model.ts +86 -5
  298. package/src/plugins/builtin/equity-screener/pane.tsx +20 -21
  299. package/src/plugins/builtin/equity-screener/results.ts +12 -3
  300. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -2
  301. package/src/plugins/builtin/estimate-revisions/pane.tsx +2 -2
  302. package/src/plugins/builtin/executives/pane.tsx +2 -2
  303. package/src/plugins/builtin/exposure/pane.tsx +1 -1
  304. package/src/plugins/builtin/fear-greed/data.ts +3 -1
  305. package/src/plugins/builtin/fear-greed/headless.ts +8 -2
  306. package/src/plugins/builtin/fear-greed/pane.tsx +8 -4
  307. package/src/plugins/builtin/filing-events/pane.tsx +1 -1
  308. package/src/plugins/builtin/futures/index.tsx +5 -4
  309. package/src/plugins/builtin/futures/model.ts +17 -9
  310. package/src/plugins/builtin/futures/returns.ts +2 -0
  311. package/src/plugins/builtin/futures/series.ts +44 -8
  312. package/src/plugins/builtin/futures/table.tsx +3 -3
  313. package/src/plugins/builtin/futures-curve/client.ts +1 -0
  314. package/src/plugins/builtin/futures-curve/headless.ts +14 -12
  315. package/src/plugins/builtin/futures-curve/index.tsx +7 -4
  316. package/src/plugins/builtin/futures-curve/model.ts +93 -7
  317. package/src/plugins/builtin/futures-curve/pane.tsx +18 -7
  318. package/src/plugins/builtin/fx-matrix/amount.ts +2 -1
  319. package/src/plugins/builtin/fx-matrix/index.tsx +9 -0
  320. package/src/plugins/builtin/gpu/changes.tsx +1 -1
  321. package/src/plugins/builtin/gpu/equities.tsx +1 -1
  322. package/src/plugins/builtin/gpu/pane.tsx +2 -2
  323. package/src/plugins/builtin/help/function-card.tsx +4 -2
  324. package/src/plugins/builtin/help/function-index.ts +12 -6
  325. package/src/plugins/builtin/help/index.tsx +1 -1
  326. package/src/plugins/builtin/holders/beneficial-view.tsx +1 -1
  327. package/src/plugins/builtin/holders/pane.tsx +1 -1
  328. package/src/plugins/builtin/insider/base-values.ts +55 -0
  329. package/src/plugins/builtin/insider/headless.ts +307 -83
  330. package/src/plugins/builtin/insider/index.tsx +65 -23
  331. package/src/plugins/builtin/insider/insiders.tsx +26 -16
  332. package/src/plugins/builtin/insider/model.ts +2 -2
  333. package/src/plugins/builtin/insider/signals-cells.tsx +4 -1
  334. package/src/plugins/builtin/insider/signals-model.ts +13 -5
  335. package/src/plugins/builtin/insider/signals.tsx +5 -3
  336. package/src/plugins/builtin/insider/tickers.tsx +466 -0
  337. package/src/plugins/builtin/ipo-calendar/pane.tsx +1 -1
  338. package/src/plugins/builtin/iv-history/client.ts +35 -4
  339. package/src/plugins/builtin/iv-history/headless.ts +10 -4
  340. package/src/plugins/builtin/iv-history/model.ts +85 -16
  341. package/src/plugins/builtin/iv-history/pane.tsx +2 -2
  342. package/src/plugins/builtin/iv-history/screen-pane.tsx +6 -3
  343. package/src/plugins/builtin/jobs/pane.tsx +5 -5
  344. package/src/plugins/builtin/macro-day/pane.tsx +1 -1
  345. package/src/plugins/builtin/macro-day/release-table.ts +5 -5
  346. package/src/plugins/builtin/macro-day/releases.ts +11 -9
  347. package/src/plugins/builtin/market-movers/headless.ts +6 -2
  348. package/src/plugins/builtin/market-movers/screener.ts +18 -4
  349. package/src/plugins/builtin/members/breadth-pane.tsx +3 -3
  350. package/src/plugins/builtin/members/client.ts +24 -2
  351. package/src/plugins/builtin/members/headless.ts +66 -9
  352. package/src/plugins/builtin/members/index.tsx +7 -6
  353. package/src/plugins/builtin/members/model.ts +89 -5
  354. package/src/plugins/builtin/members/pane.tsx +70 -21
  355. package/src/plugins/builtin/mna/distress/pane.tsx +2 -1
  356. package/src/plugins/builtin/mna/pane.tsx +1 -1
  357. package/src/plugins/builtin/money-markets/client.ts +43 -15
  358. package/src/plugins/builtin/money-markets/headless.ts +18 -11
  359. package/src/plugins/builtin/money-markets/index.tsx +7 -6
  360. package/src/plugins/builtin/money-markets/model.ts +20 -5
  361. package/src/plugins/builtin/money-markets/pane.tsx +28 -17
  362. package/src/plugins/builtin/news/wire/news/footer.ts +11 -1
  363. package/src/plugins/builtin/news/wire/news/table.tsx +15 -5
  364. package/src/plugins/builtin/notes/headless.ts +94 -0
  365. package/src/plugins/builtin/notes/index.tsx +3 -1
  366. package/src/plugins/builtin/notes/store.ts +10 -3
  367. package/src/plugins/builtin/options/footer.ts +8 -2
  368. package/src/plugins/builtin/options/open-interest-as-of.ts +12 -3
  369. package/src/plugins/builtin/options/view.tsx +10 -1
  370. package/src/plugins/builtin/options-calculator/pane.tsx +1 -1
  371. package/src/plugins/builtin/options-positioning/client.ts +35 -8
  372. package/src/plugins/builtin/options-positioning/headless.ts +17 -7
  373. package/src/plugins/builtin/options-positioning/index.tsx +10 -0
  374. package/src/plugins/builtin/options-positioning/pane.tsx +16 -7
  375. package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +1 -1
  376. package/src/plugins/builtin/options-scenario/pane.tsx +1 -1
  377. package/src/plugins/builtin/pe-band/pane.tsx +2 -2
  378. package/src/plugins/builtin/perps/cascade-tabs.tsx +2 -2
  379. package/src/plugins/builtin/perps/client.ts +54 -15
  380. package/src/plugins/builtin/perps/headless.ts +39 -13
  381. package/src/plugins/builtin/perps/index.tsx +2 -1
  382. package/src/plugins/builtin/perps/model.ts +43 -1
  383. package/src/plugins/builtin/perps/pane.tsx +35 -18
  384. package/src/plugins/builtin/portfolio-list/allocation-rows.ts +74 -0
  385. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  386. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +7 -3
  387. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +33 -3
  388. package/src/plugins/builtin/portfolio-list/cli/render.ts +149 -24
  389. package/src/plugins/builtin/portfolio-list/headless.ts +30 -9
  390. package/src/plugins/builtin/portfolio-list/income.ts +17 -8
  391. package/src/plugins/builtin/portfolio-list/index.tsx +4 -4
  392. package/src/plugins/builtin/portfolio-list/pane/fx-day-moves.ts +52 -0
  393. package/src/plugins/builtin/portfolio-list/pane/index.tsx +76 -9
  394. package/src/plugins/builtin/portfolio-list/pane/target-weights.tsx +178 -0
  395. package/src/plugins/builtin/portfolio-list/period-pnl.ts +44 -5
  396. package/src/plugins/builtin/portfolio-list/settings.ts +12 -6
  397. package/src/plugins/builtin/portfolio-list/summary/index.tsx +9 -4
  398. package/src/plugins/builtin/portfolio-list/summary/totals.ts +21 -2
  399. package/src/plugins/builtin/portfolio-list/table.tsx +33 -25
  400. package/src/plugins/builtin/power/gas.tsx +2 -2
  401. package/src/plugins/builtin/power/prices.tsx +2 -2
  402. package/src/plugins/builtin/primary-dealers/pane.tsx +10 -11
  403. package/src/plugins/builtin/rate-path/model.ts +9 -0
  404. package/src/plugins/builtin/rate-path/pane.tsx +6 -5
  405. package/src/plugins/builtin/realized-vol/fx-proxy.ts +27 -0
  406. package/src/plugins/builtin/realized-vol/headless.ts +8 -6
  407. package/src/plugins/builtin/realized-vol/pane.tsx +13 -7
  408. package/src/plugins/builtin/relative-rotation/pane.tsx +1 -1
  409. package/src/plugins/builtin/research/analyst-headless.ts +5 -1
  410. package/src/plugins/builtin/research/analyst-model.ts +7 -1
  411. package/src/plugins/builtin/research/analyst-pane.tsx +1 -1
  412. package/src/plugins/builtin/research/relative-valuation-basis.ts +44 -4
  413. package/src/plugins/builtin/research/relative-valuation-headless.ts +59 -14
  414. package/src/plugins/builtin/research/relative-valuation-model.ts +65 -26
  415. package/src/plugins/builtin/research/relative-valuation-pane.tsx +42 -17
  416. package/src/plugins/builtin/revenue-breakdown/pane.tsx +1 -1
  417. package/src/plugins/builtin/reverse-dcf/client.ts +34 -4
  418. package/src/plugins/builtin/reverse-dcf/headless.ts +30 -15
  419. package/src/plugins/builtin/reverse-dcf/model.ts +190 -29
  420. package/src/plugins/builtin/reverse-dcf/pane.tsx +35 -13
  421. package/src/plugins/builtin/risk-factors/pane.tsx +2 -2
  422. package/src/plugins/builtin/roadmap/pane.tsx +2 -2
  423. package/src/plugins/builtin/scanner/flow-pane.tsx +4 -4
  424. package/src/plugins/builtin/scanner/headless.ts +15 -1
  425. package/src/plugins/builtin/seasonality/pane.tsx +1 -1
  426. package/src/plugins/builtin/sec/fund-facts-view.tsx +5 -2
  427. package/src/plugins/builtin/sec/fund-facts.ts +41 -1
  428. package/src/plugins/builtin/sec/headless.ts +8 -4
  429. package/src/plugins/builtin/sec/index.tsx +41 -13
  430. package/src/plugins/builtin/shared/ticker-company.ts +111 -0
  431. package/src/plugins/builtin/shared/use-quote-board.ts +37 -2
  432. package/src/plugins/builtin/shared/volatility/live-session.ts +23 -0
  433. package/src/plugins/builtin/shared/volatility-indices.ts +2 -0
  434. package/src/plugins/builtin/short-interest/publications-pane.tsx +1 -1
  435. package/src/plugins/builtin/short-volume/pane.tsx +1 -1
  436. package/src/plugins/builtin/social-mentions/outliers.tsx +3 -3
  437. package/src/plugins/builtin/social-mentions/pane.tsx +2 -2
  438. package/src/plugins/builtin/supply-chain/graph-pane.tsx +1 -1
  439. package/src/plugins/builtin/supply-chain/pane.tsx +1 -1
  440. package/src/plugins/builtin/themes/pane.tsx +4 -4
  441. package/src/plugins/builtin/thirteenf/api.ts +1 -0
  442. package/src/plugins/builtin/thirteenf/format.ts +5 -0
  443. package/src/plugins/builtin/thirteenf/headless.ts +2 -2
  444. package/src/plugins/builtin/thirteenf/model.ts +128 -5
  445. package/src/plugins/builtin/thirteenf/overlap-pane.tsx +1 -1
  446. package/src/plugins/builtin/thirteenf/report-notes.ts +10 -3
  447. package/src/plugins/builtin/thirteenf/signals-pane.tsx +1 -1
  448. package/src/plugins/builtin/thirteenf/table.ts +2 -2
  449. package/src/plugins/builtin/thirteenf/types.ts +12 -0
  450. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +27 -14
  451. package/src/plugins/builtin/ticker-detail/data-panes/returns-history.ts +6 -3
  452. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +14 -0
  453. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +4 -1
  454. package/src/plugins/builtin/ticker-detail/financials/aggregation.ts +87 -19
  455. package/src/plugins/builtin/ticker-detail/financials/exchange-results.ts +54 -0
  456. package/src/plugins/builtin/ticker-detail/financials/model.ts +114 -9
  457. package/src/plugins/builtin/ticker-detail/financials/ratios.ts +37 -20
  458. package/src/plugins/builtin/ticker-detail/financials/tab.tsx +42 -19
  459. package/src/plugins/builtin/ticker-detail/headless-schema.ts +3 -2
  460. package/src/plugins/builtin/ticker-detail/headless.ts +90 -31
  461. package/src/plugins/builtin/ticker-detail/overview/model.ts +22 -15
  462. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +5 -2
  463. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +12 -7
  464. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +21 -0
  465. package/src/plugins/builtin/trace-bonds/client.ts +107 -10
  466. package/src/plugins/builtin/trace-bonds/detail.tsx +1 -1
  467. package/src/plugins/builtin/trace-bonds/headless.ts +20 -5
  468. package/src/plugins/builtin/trace-bonds/pane.tsx +15 -4
  469. package/src/plugins/builtin/treasury-auctions/hk-view.tsx +1 -1
  470. package/src/plugins/builtin/treasury-auctions/pane.tsx +1 -1
  471. package/src/plugins/builtin/treasury-daily/pane.tsx +2 -2
  472. package/src/plugins/builtin/vol-surface/charts.tsx +30 -5
  473. package/src/plugins/builtin/vol-surface/client.ts +40 -12
  474. package/src/plugins/builtin/vol-surface/events.ts +213 -0
  475. package/src/plugins/builtin/vol-surface/headless.ts +82 -13
  476. package/src/plugins/builtin/vol-surface/index.tsx +5 -1
  477. package/src/plugins/builtin/vol-surface/model.ts +42 -6
  478. package/src/plugins/builtin/vol-surface/pane.tsx +95 -23
  479. package/src/plugins/builtin/volatility/dvol.ts +14 -2
  480. package/src/plugins/builtin/volatility/headless.ts +3 -2
  481. package/src/plugins/builtin/volatility/index.tsx +1 -1
  482. package/src/plugins/builtin/volatility/pane.tsx +1 -1
  483. package/src/plugins/builtin/volatility/series.ts +7 -3
  484. package/src/plugins/builtin/world-venue-map/activity-series.ts +89 -0
  485. package/src/plugins/builtin/world-venue-map/chokepoint-report.ts +123 -0
  486. package/src/plugins/builtin/world-venue-map/evidence.ts +2 -0
  487. package/src/plugins/builtin/world-venue-map/geo-series.ts +35 -1
  488. package/src/plugins/builtin/world-venue-map/headless.ts +58 -9
  489. package/src/plugins/builtin/world-venue-map/index.ts +6 -3
  490. package/src/plugins/builtin/world-venue-map/layered-pane.tsx +6 -1
  491. package/src/plugins/builtin/world-venue-map/pane.tsx +4 -3
  492. package/src/plugins/builtin/yield-curve/index.tsx +12 -10
  493. package/src/plugins/builtin/yield-curve/swaps.tsx +1 -1
  494. package/src/plugins/extracted-plugins.ts +14 -10
  495. package/src/plugins/installer.ts +17 -1
  496. package/src/plugins/marketplace/feed.ts +14 -0
  497. package/src/plugins/marketplace/install-offer.ts +64 -0
  498. package/src/plugins/registry/contributions.ts +46 -8
  499. package/src/plugins/registry/index.ts +5 -0
  500. package/src/portfolio/collection-name.ts +38 -4
  501. package/src/portfolio/column-values.ts +32 -4
  502. package/src/portfolio/period-pnl.ts +4 -2
  503. package/src/react/async-resource.ts +24 -8
  504. package/src/remote/endpoint.ts +38 -12
  505. package/src/remote/secrets.ts +22 -6
  506. package/src/remote/server.ts +20 -4
  507. package/src/renderers/dom/data-table/index.tsx +2 -1
  508. package/src/renderers/dom/data-table/row.tsx +49 -7
  509. package/src/renderers/dom/desktop/controls.tsx +2 -0
  510. package/src/renderers/dom/desktop/query-bar.tsx +57 -7
  511. package/src/renderers/dom/host/surface-3d.tsx +46 -5
  512. package/src/renderers/dom/styles.css +17 -0
  513. package/src/renderers/electrobun/view/backend-rpc.ts +15 -21
  514. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +16 -61
  515. package/src/renderers/electrobun/view/cli-pane-shot-socket.ts +134 -0
  516. package/src/renderers/electrobun/view/host-route.ts +119 -0
  517. package/src/renderers/electrobun/view/rpc-timeout.ts +6 -5
  518. package/src/renderers/opentui/toast-host.tsx +6 -3
  519. package/src/renderers/opentui/ui-host.tsx +29 -5
  520. package/src/series/registry.ts +1 -0
  521. package/src/series/standalone-catalog.ts +40 -0
  522. package/src/series/types.ts +10 -0
  523. package/src/series/validate.ts +5 -0
  524. package/src/shares/portable-layout.ts +2 -7
  525. package/src/sources/gloomberb-cloud/dated-chunks.ts +133 -0
  526. package/src/sources/gloomberb-cloud/index.ts +46 -5
  527. package/src/sources/gloomberb-cloud/news.ts +15 -9
  528. package/src/sources/gloomberb-cloud/normalizers.ts +17 -0
  529. package/src/sources/history-coverage.ts +13 -0
  530. package/src/sources/history-result.ts +1 -0
  531. package/src/sources/provider-errors.ts +9 -0
  532. package/src/sources/provider-router/batches.ts +7 -3
  533. package/src/sources/provider-router/financial-routes.ts +3 -1
  534. package/src/sources/provider-router/history.ts +6 -4
  535. package/src/sources/provider-router/index.ts +5 -1
  536. package/src/sources/provider-router/primary.ts +4 -3
  537. package/src/sources/provider-router/retrieved-at.ts +12 -0
  538. package/src/team/store.ts +17 -4
  539. package/src/telemetry/crash-reports.ts +3 -1
  540. package/src/test-support/cli-context.ts +3 -2
  541. package/src/test-support/test-env.ts +7 -0
  542. package/src/theme/themes.ts +16 -9
  543. package/src/theme/tone-contrast.ts +29 -5
  544. package/src/tickers/company-name-listing.ts +31 -3
  545. package/src/tickers/company-name.ts +9 -0
  546. package/src/tickers/index-roots.ts +56 -4
  547. package/src/tickers/listing-name.ts +7 -2
  548. package/src/tickers/listing-venues.ts +17 -2
  549. package/src/tickers/search/home-listing.ts +2 -0
  550. package/src/tickers/search/index.ts +64 -11
  551. package/src/tickers/search/major-listings.json +595 -592
  552. package/src/tickers/search/ranking.ts +19 -1
  553. package/src/tickers/terminal-codes.ts +5 -3
  554. package/src/time-series/bar-aggregation.ts +3 -2
  555. package/src/time-series/base-series.ts +18 -1
  556. package/src/time-series/chart-data.ts +9 -6
  557. package/src/time-series/chart-seed.ts +11 -3
  558. package/src/time-series/currency-conversion.ts +1 -0
  559. package/src/time-series/date-window.ts +8 -0
  560. package/src/time-series/formula-months.ts +57 -0
  561. package/src/time-series/fundamentals/period-points.ts +3 -3
  562. package/src/time-series/fundamentals/source-statements.ts +5 -4
  563. package/src/time-series/leverage.ts +12 -4
  564. package/src/time-series/live-bars.ts +12 -7
  565. package/src/time-series/live-quotes.ts +6 -2
  566. package/src/time-series/market.ts +10 -3
  567. package/src/time-series/price-comparison.ts +106 -0
  568. package/src/time-series/range.ts +10 -0
  569. package/src/time-series/resolve-context.ts +7 -2
  570. package/src/time-series/resolve.ts +61 -5
  571. package/src/time-series/series-name.ts +2 -2
  572. package/src/time-series/series-presentation.ts +91 -2
  573. package/src/time-series/session-bar.ts +13 -7
  574. package/src/time-series/spec.ts +21 -2
  575. package/src/time-series/studies/formula.ts +262 -36
  576. package/src/time-series/studies/leverage.ts +9 -3
  577. package/src/time-series/studies/resolve.ts +7 -2
  578. package/src/time-series/types.ts +34 -0
  579. package/src/time-series/use-chart-resolution.ts +18 -1
  580. package/src/types/data-provider.ts +7 -0
  581. package/src/types/financials.ts +103 -1
  582. package/src/types/headless.ts +64 -3
  583. package/src/types/instrument.ts +6 -0
  584. package/src/types/plugin-context.ts +9 -0
  585. package/src/types/plugin-pane-templates.ts +6 -0
  586. package/src/types/plugin-panes.ts +7 -0
  587. package/src/types/price-history.ts +6 -0
  588. package/src/ui/host.tsx +3 -1
  589. package/src/ui/index.tsx +7 -2
  590. package/src/utils/cli-output.ts +21 -1
  591. package/src/utils/currency-units.ts +14 -0
  592. package/src/utils/datetime-format.ts +11 -0
  593. package/src/utils/exchange-announcements.ts +26 -3
  594. package/src/utils/exchange-notation.generated.ts +3 -4
  595. package/src/utils/exchange-results.ts +144 -0
  596. package/src/utils/exchanges.ts +10 -0
  597. package/src/utils/financial-statements.ts +212 -22
  598. package/src/utils/fire-and-forget.ts +1 -1
  599. package/src/utils/fiscal-period.ts +41 -3
  600. package/src/utils/format.ts +10 -6
  601. package/src/utils/fundamentals.ts +179 -12
  602. package/src/utils/futures-generic.ts +26 -0
  603. package/src/utils/lease-liabilities.ts +15 -5
  604. package/src/utils/lookup-token.ts +22 -0
  605. package/src/utils/max-drawdown.ts +25 -4
  606. package/src/utils/price-history-integrity.ts +56 -8
  607. package/src/utils/price-history.ts +6 -2
  608. package/src/utils/price-window.ts +38 -2
  609. package/src/utils/replace-file.ts +47 -0
  610. package/src/utils/rpc-timeout-error.ts +16 -2
  611. package/src/utils/untrusted-text.ts +14 -0
@@ -21,6 +21,7 @@ import {
21
21
  import { movedAwayChange, startTickerChangeLookup, type MovedTickerChange } from "../tickers/ticker-changes";
22
22
  import { lineMayHaveMoved, listingChangeLine, loadListingFate, MovedSymbolError, SUCCESSOR_CHANGE_WAIT_MS, type ListingFate } from "../tickers/listing-fate";
23
23
  import { quotedListingName } from "../tickers/listing-name";
24
+ import { withdrawalLabel } from "../market-data/quotes/delisting";
24
25
  import { cliStyles } from "../utils/cli-output";
25
26
  import { companyNameExtraWords, groupByCompany, namesDepositaryReceipt, sameCompany, sameListedName, shortCompanyName } from "../tickers/company-name";
26
27
  import {
@@ -30,6 +31,7 @@ import {
30
31
  exchangeName,
31
32
  isKnownExchangeCode,
32
33
  isSharedExchangeCode,
34
+ isUsEquityExchange,
33
35
  isUsListingExchange,
34
36
  usShareClassSpellings,
35
37
  parsePublicTickerKey,
@@ -38,17 +40,20 @@ import {
38
40
  } from "../utils/exchanges";
39
41
  import { withMarketData } from "./scoped-context";
40
42
  import { failWithFields } from "./errors";
41
- import { stripStrayEdges } from "./symbol-args";
42
- import { isNoProviderMessage, isNoSourceAnswer, isProviderBusy } from "../sources/provider-errors";
43
+ import { stripStrayEdges, tickerShapedWord } from "./symbol-args";
44
+ import { isNoProviderMessage, isNoSourceAnswer, isProviderBusy, notATickerSymbol } from "../sources/provider-errors";
43
45
  import { dashedCoinPair, exchangeLineCoinListing, isSpotCommodityOrCurrencyPair, MAJOR_COIN_NAMES, TOP_COIN_NAMES } from "../utils/crypto-pair";
44
46
  import { boardCoinFor, primeBoardCoins } from "./board-coins";
45
47
  import { knownGapMessage, unquotedGapMessage } from "./known-gaps";
46
48
  import { renamedListingFor, renamedListingReadAs, renamedListingSymbol } from "../tickers/renamed-listings";
47
49
  import { currencyPairSpelling } from "../utils/currency-pair";
48
50
  import { bareFuturesCode, futuresContractByCode, futuresContractByWord, listedFuturesSymbol } from "../market-data/futures-board";
51
+ import { commodityNameFuture } from "../market-data/commodity-names";
49
52
  import { classifyInstrumentType, kindFromListingSyntax } from "../tickers/instrument-kind";
50
53
  import type { InstrumentOfKind } from "../tickers/instrument-coverage";
51
- import { brokerIndexCode, brokerIndexReadAs } from "./index-roots";
54
+ import { brokerIndexCode, brokerIndexReadAs, indexRootAlsoLine } from "./index-roots";
55
+ import { indexRootFor } from "../tickers/index-roots";
56
+ import { isFuturesInstrument } from "../market-data/futures-contract";
52
57
  import { continuousAliasGeneric } from "../utils/futures-generic";
53
58
  import {
54
59
  bloombergCodeOf,
@@ -123,6 +128,12 @@ export interface ListingArg {
123
128
  * became GETYQ. Other bare symbols say where the data service chose instead.
124
129
  */
125
130
  readFromName?: true;
131
+ /**
132
+ * One word typed alone, read as a company's name (`Group` as UNH:NYSE):
133
+ * the words typed beside it are tried with it as one name first
134
+ * (`joinCompanyNameWords`), so "MTN Group" is MTN Group's listing.
135
+ */
136
+ wordAsName?: true;
126
137
  /**
127
138
  * The venue is the one search lists the company's name on (`companyListingArg`), so a quote that answers
128
139
  * there is the listing's own, even on a US venue, whose quote answers as whichever one is asked.
@@ -330,11 +341,26 @@ export async function notTradedMessage(
330
341
  ): Promise<string | null> {
331
342
  if (!listing.exchange) return null;
332
343
  const venues = await listingVenues(listing.symbol, deps).catch(logFailure("cli.listing-arg", "Read listing venues failed", []));
344
+ // A line its exchange withdrew is on record, and says when it went and why.
345
+ const withdrawn = venues.find((venue) => venue.exchange === listing.exchange && venue.withdrawal);
346
+ if (withdrawn) return withdrawnListingMessage(listing, withdrawn);
333
347
  if (venues.length === 0 || venues.some((venue) => venue.exchange === listing.exchange)) return null;
334
348
  if (await quotedOnVenue(listing, deps)) return null;
335
349
  return `${listing.symbol} does not trade on ${listing.exchange}.${tradesOn(listing.symbol, venues)}`;
336
350
  }
337
351
 
352
+ /**
353
+ * "0011:HKEX (Hang Seng Bank Limited): Delisted Jan 27, 2026 (Privatised by
354
+ * The Hongkong and Shanghai Banking Corporation Limited)." for a line its
355
+ * exchange withdrew: no source prices it any more.
356
+ */
357
+ function withdrawnListingMessage(listing: Pick<ListingArg, "symbol" | "exchange">, venue: ListingVenue): string {
358
+ // The venue's name carries the day it went for a choice between listings; here the label says it.
359
+ const name = venue.name.split(" · ")[0]?.trim();
360
+ const key = `${listing.symbol}:${listing.exchange}`;
361
+ return `${key}${name && name.toUpperCase() !== listing.symbol.toUpperCase() ? ` (${name})` : ""}: ${withdrawalLabel(venue.withdrawal!)}.`;
362
+ }
363
+
338
364
  /** Fails the command with `notTradedMessage`; returns when the symbol does trade there. */
339
365
  export async function failIfNotTraded(
340
366
  listing: Pick<ListingArg, "symbol" | "exchange">,
@@ -400,9 +426,29 @@ interface BareListingVenues {
400
426
  choose: boolean;
401
427
  }
402
428
 
403
- /** Whether the venues' companies differ by name. A venue with no name is no other company. */
404
- function listsSeveralCompanies(venues: readonly ListingVenue[]): boolean {
405
- return groupByCompany(venues, (venue) => venue.name).length > 1;
429
+ /** A venue that names its line by the code alone (BSE's "ITBEES" beside NSE's "Nippon India ETF Nifty IT"). */
430
+ function namedByCode(symbol: string, venue: ListingVenue): boolean {
431
+ return venue.name.trim().toUpperCase() === (venue.symbol ?? symbol).toUpperCase();
432
+ }
433
+
434
+ /**
435
+ * Whether the venues' companies differ by name. A venue with no name is no other company, nor is one
436
+ * that names its line by the code alone.
437
+ */
438
+ function listsSeveralCompanies(symbol: string, venues: readonly ListingVenue[]): boolean {
439
+ return groupByCompany(venues, (venue) => namedByCode(symbol, venue) ? "" : venue.name).length > 1;
440
+ }
441
+
442
+ /**
443
+ * The venue a bare code goes to: the first search lists with a real name, never one that names its
444
+ * line by the code alone when another names it, and NSE, India's main venue, before BSE whichever
445
+ * search listed first.
446
+ */
447
+ function homeVenue(symbol: string, venues: readonly ListingVenue[]): ListingVenue | null {
448
+ const named = venues.filter((venue) => !namedByCode(symbol, venue));
449
+ const candidates = named.length ? named : venues;
450
+ const first = candidates[0] ?? null;
451
+ return first?.exchange === "BSE" ? candidates.find((venue) => venue.exchange === "NSE") ?? first : first;
406
452
  }
407
453
 
408
454
  /**
@@ -543,10 +589,13 @@ export async function listingChoiceNotes(
543
589
  export async function quotedListingChoiceNotes(
544
590
  listing: Pick<CliListing, "symbol" | "exchange" | "saved" | "request" | "readAs" | "readFromName">,
545
591
  deps: ListingDeps,
592
+ /** A command that draws the listing's prices (`fn HP`) names the index or future a code it reads is typed for (`ownedCodeNotes`). */
593
+ { pricesFor }: { pricesFor?: string } = {},
546
594
  ): Promise<string[]> {
547
595
  const venues = loadBareVenues(listing, deps);
548
596
  if (!venues) return listingReadNotes(listing);
549
- return listingChoiceNotes(listing, deps, await loadListingQuote(deps.dataProvider, listing), venues);
597
+ const quote = await loadListingQuote(deps.dataProvider, listing);
598
+ return [...await listingChoiceNotes(listing, deps, quote, venues), ...pricesFor ? ownedCodeNotes(listing, quote, pricesFor) : []];
550
599
  }
551
600
 
552
601
  /**
@@ -630,8 +679,8 @@ async function bareListingVenues(listing: BareListing, deps: ListingDeps): Promi
630
679
  if (listing.exchange) return null;
631
680
  const venues = await listingVenues(listing.symbol, deps).catch(logFailure("cli.listing-arg", "Read listing venues failed", []));
632
681
  const savedExchange = canonicalExchange(listing.saved?.metadata.exchange);
633
- if (!savedExchange && listsSeveralCompanies(venues)) return { exchange: "", resolved: null, others: venues, choose: true };
634
- const resolved = venues.find((venue) => venue.exchange === savedExchange) ?? (savedExchange ? null : venues[0] ?? null);
682
+ if (!savedExchange && listsSeveralCompanies(listing.symbol, venues)) return { exchange: "", resolved: null, others: venues, choose: true };
683
+ const resolved = venues.find((venue) => venue.exchange === savedExchange) ?? (savedExchange ? null : homeVenue(listing.symbol, venues));
635
684
  const exchange = resolved?.exchange ?? savedExchange;
636
685
  if (!exchange) return null;
637
686
  return { exchange, resolved, others: venues.filter((venue) => venue !== resolved && venue.exchange !== savedExchange), choose: false };
@@ -859,6 +908,44 @@ export interface ReadListing {
859
908
  * 2025, now Cmb.Tech: CMBT"), when asked for (`successor`); null otherwise.
860
909
  */
861
910
  successorNote?: string | null;
911
+ /** What `quote` says of a code a security owns that is typed for something else (`ownedCodeNotes`). */
912
+ ownedNotes?: string[];
913
+ /** What the symbol was read as, when the resolver read it as another listing (NDX as the Nasdaq-100). */
914
+ readAs?: string;
915
+ }
916
+
917
+ /**
918
+ * "GOLD is Gold.com, Inc.; for Gold, quote the future GC=F.": a commodity's
919
+ * word a security trades as (WTI is W&T Offshore, GOLD is Gold.com), with
920
+ * the future it may have meant. `quote` and `compare` say to quote it;
921
+ * another command names itself run on the future. Null for any other symbol.
922
+ */
923
+ export function futureByWordLine(symbol: string, name: string | null | undefined, command: string): string | null {
924
+ const contract = futuresContractByWord(symbol);
925
+ if (!contract) return null;
926
+ const owner = `${symbol} is ${name?.trim() || "a security"}`;
927
+ return command === "quote" || command === "compare"
928
+ ? `${owner}; for ${contract.name}, quote the future ${contract.symbol}.`
929
+ : `${owner}; for ${contract.name}, the future is ${contract.symbol} (gloom ${command} ${commandWord(contract.symbol)}).`;
930
+ }
931
+
932
+ /**
933
+ * What `quote` says beside a bare code a security owns that people type for
934
+ * something else, worded for `command`: the index rooted at it (MOVE is
935
+ * Corvex: "also ^MOVE ICE BofA MOVE Index (gloom history "^MOVE")") and the
936
+ * future a commodity's word names (`futureByWordLine`). None for a named
937
+ * listing, no quote, or an index or a future quoted as itself.
938
+ */
939
+ export function ownedCodeNotes(
940
+ listing: Pick<ListingArg, "symbol" | "exchange">,
941
+ quote: Pick<Quote, "name" | "instrumentType"> | null | undefined,
942
+ command: string,
943
+ ): string[] {
944
+ if (listing.exchange || !quote) return [];
945
+ const root = indexRootFor(listing.symbol);
946
+ const index = root && quote.instrumentType?.trim().toUpperCase() !== "INDEX" ? indexRootAlsoLine(root, command) : null;
947
+ const future = isFuturesInstrument(listing.symbol, quote.instrumentType) ? null : futureByWordLine(listing.symbol, quote.name, command);
948
+ return [index, future].filter((line): line is string => !!line);
862
949
  }
863
950
 
864
951
  /**
@@ -867,8 +954,11 @@ export interface ReadListing {
867
954
  * symbol no source quotes is read on the first of its listings that has one
868
955
  * (`quoteBareListing`), and a code several companies list (BDI is Black
869
956
  * Diamond Group in Toronto and B. D. Industries in Pune) fails asking which,
870
- * with `quote`'s message and each listing's retry. Null when nothing better
871
- * than the symbol itself is known, so the command's own request speaks.
957
+ * with `quote`'s message and each listing's retry. A symbol whose quote says
958
+ * it is not a ticker and that no listing carries is `NotATicker`, with the
959
+ * error the quote failed with, so the command can say so without asking for
960
+ * its data. Null when nothing better than the symbol itself is known, so the
961
+ * command's own request speaks.
872
962
  */
873
963
  export async function readBareListing(
874
964
  symbol: string,
@@ -876,25 +966,38 @@ export async function readBareListing(
876
966
  request: ListingDataRequest,
877
967
  /** `successor`: also say what became of the company that had the symbol, looked up beside its quote. */
878
968
  { refresh = false, successor = false }: { refresh?: boolean; successor?: boolean } = {},
879
- ): Promise<ReadListing | null> {
969
+ ): Promise<ReadListing | NotATicker | null> {
880
970
  const listing = await resolveCliListing(symbol, null, deps);
881
- if (listing.exchange) return null;
971
+ // A code the resolver read as another listing (NDX as ^NDX:NIM, the Nasdaq-100) is that listing, saying so.
972
+ if (listing.exchange) {
973
+ return listing.readAs ? { symbol: listing.symbol, exchange: listing.exchange, name: null, coinNote: null, readAs: listing.readAs } : null;
974
+ }
882
975
  const changes = successor ? startTickerChangeLookup(deps.dataProvider, listing.symbol, listing.exchange) : null;
883
976
  const answer = await loadListingQuoteAnswer(deps.dataProvider, listing);
884
977
  if (answer.quote) {
885
978
  const successorNote = changes
886
979
  ? listingChangeLine(await loadListingFate(listing, deps.dataProvider, { quote: answer.quote, changes, graceMs: SUCCESSOR_CHANGE_WAIT_MS }))
887
980
  : null;
981
+ const ownedNotes = ownedCodeNotes(listing, answer.quote, request.command);
888
982
  return { symbol: listing.symbol, exchange: listing.request.exchange, name: answer.quote.name?.trim() || null, coinNote: coinListingNotes(listing, answer.quote)[0] ?? null,
889
- ...successorNote ? { successorNote } : {} };
983
+ ...successorNote ? { successorNote } : {}, ...ownedNotes.length ? { ownedNotes } : {}, ...listing.readAs ? { readAs: listing.readAs } : {} };
890
984
  }
891
985
  if (!isNoProviderError(answer.error)) return null;
892
986
  const other = await quoteBareListing(listing, deps, request, { refresh });
893
987
  if (other?.kind === "quoted") {
894
- return { symbol: listing.symbol, exchange: other.listing.exchange, name: other.quote.name?.trim() || null, coinNote: coinListingNotes(listing, other.quote)[0] ?? null };
988
+ const ownedNotes = ownedCodeNotes(listing, other.quote, request.command);
989
+ return { symbol: listing.symbol, exchange: other.listing.exchange, name: other.quote.name?.trim() || null, coinNote: coinListingNotes(listing, other.quote)[0] ?? null,
990
+ ...ownedNotes.length ? { ownedNotes } : {} };
895
991
  }
896
992
  if (other?.choose) throw new ListingArgError(other.message, other.details, other.choices);
897
- return null;
993
+ // No venue lists it and its own quote says it is no ticker, as `quote UNISWAP` says.
994
+ const message = answer.error instanceof Error ? answer.error.message : "";
995
+ return !other && notATickerSymbol(message) ? { notATicker: answer.error as Error } : null;
996
+ }
997
+
998
+ /** A bare symbol no listing carries (`readBareListing`): the error its quote failed with, "Not a ticker: UNISWAP.". */
999
+ export interface NotATicker {
1000
+ notATicker: Error;
898
1001
  }
899
1002
 
900
1003
  /**
@@ -1280,6 +1383,11 @@ export async function resolveCliListing(
1280
1383
  venueSuffix?: boolean;
1281
1384
  /** Read a venue suffix as the venue it names, with no request (`parseListingArg`). */
1282
1385
  listingSuffix?: boolean;
1386
+ /**
1387
+ * Read a word no source quotes as the company it names (`readBareCompanyName`). On by default;
1388
+ * `quote` reads names after its own quote request, and turns it off.
1389
+ */
1390
+ companyWord?: boolean;
1283
1391
  } = {},
1284
1392
  ): Promise<CliListing> {
1285
1393
  // "JPM US Equity" is Bloomberg's code for JPM; "Putnam US Equity", whose root is no US ticker, is a name.
@@ -1299,6 +1407,18 @@ export async function resolveCliListing(
1299
1407
  const now = await resolveCliListing(renamedListingSymbol(renamed), null, deps, options);
1300
1408
  return { ...now, readAs: [renamedListingReadAs(typed, renamed), now.readAs].filter(Boolean).join(" "), readFromName: true };
1301
1409
  }
1410
+ // "crude oil" is the benchmark future search ranks first (CL=F, Brent beside it), never a fund named for it.
1411
+ const commodity = exchangeOption?.trim() ? null : commodityNameFuture(typed);
1412
+ if (commodity) {
1413
+ const future = await resolveCliListing(commodity.contract.symbol, null, deps, options);
1414
+ return { ...future, readAs: [commodityFutureReadAs(typed, commodity), future.readAs].filter(Boolean).join(" "), readFromName: true };
1415
+ }
1416
+ // "BRK B" is Berkshire's class B with a space for its mark, never a fund whose name carries "BRK/B".
1417
+ const shareClass = exchangeOption?.trim() ? null : await readShareClassCode(typed, deps);
1418
+ if (shareClass) {
1419
+ const line = await resolveCliListing(shareClass.key, null, deps, options);
1420
+ return { ...line, readAs: shareClass.readAs, readFromName: true, typed: typed.trim() };
1421
+ }
1302
1422
  const read = await readTerminalCodeArg(deps.dataProvider, typed);
1303
1423
  // A company's name, an entry of a comma list (`WHR, Whirlpool Corporation`), is the listing search names for it.
1304
1424
  // A name before a legal form ("SAP SE", "SIEMENS AG") is looked up first: SE is also SIX Swiss's market code.
@@ -1313,12 +1433,19 @@ export async function resolveCliListing(
1313
1433
  // $VIX is Schwab's code for ^VIX, unless a security trades as VIX: $AAPL is a cashtag.
1314
1434
  const index = named || parsed.exchange ? null : await readDollarIndexCode(raw, deps);
1315
1435
  if (index) parsed = index;
1436
+ // NDX, which no security trades as, is the Nasdaq-100 for every command, as `quote` reads it; MOVE stays Corvex.
1437
+ const rooted = named || index || terminal || parsed.exchange ? null : await readBareIndexRoot(parsed, typed, deps);
1438
+ if (rooted) parsed = rooted;
1316
1439
  // USD-NGN and USDNGN are the pair USDNGN=X unless a security is listed under those letters.
1317
1440
  const pair = parsed.exchange ? null : await readAmbiguousCurrencyPair(parsed.symbol, deps);
1318
1441
  if (pair) parsed = { symbol: pair, exchange: "", key: pair };
1319
1442
  // 700 is how Hong Kong writes Tencent's 0700, and search reads it so.
1320
1443
  const hongKong = pair || named || index ? null : await readHongKongShortCode(parsed, deps);
1321
1444
  if (hongKong) parsed = hongKong;
1445
+ // A word no source quotes that names a company (`Naspers`) is its listing, for every command, as `quote` reads it.
1446
+ const company = options.companyWord === false || pair || named || index || rooted || hongKong || terminal || dotted
1447
+ ? null : await readBareCompanyName(parsed, typed, deps);
1448
+ if (company) parsed = company;
1322
1449
  // A one-letter suffix (7203.T) is read as its venue only when a row saved there says so; the listing's quote may later.
1323
1450
  const venueRow = options.listingSuffix && !pair && !named ? await savedSuffixVenue(parsed, deps.store) : null;
1324
1451
  if (venueRow) parsed = venueRow;
@@ -1355,6 +1482,70 @@ export async function resolveCliListing(
1355
1482
  };
1356
1483
  }
1357
1484
 
1485
+ /** A US share class typed with a space for its mark: `BRK B`, `brk b`. */
1486
+ const SPACED_SHARE_CLASS = /^([A-Za-z]{1,5})\s+([A-Za-z])$/;
1487
+ /** A US share class typed with no mark at all, in capitals: `BRKB`, `BFB`. */
1488
+ const JOINED_SHARE_CLASS = /^([A-Z]{2,5})([A-Z])$/;
1489
+ /** Lines of the joined code abroad a read names. */
1490
+ const SHARE_CLASS_OTHER_LINES = 3;
1491
+
1492
+ /**
1493
+ * A US share class typed without its mark, read as that class's listing:
1494
+ * `BRK B` and `BRKB` are BRK.B, the row saved for it first, then the US line
1495
+ * search lists for it (a listing exchange before IEX), as `search` ranks it.
1496
+ * The answer says so and names the joined code's lines abroad ("Read "BRKB"
1497
+ * as BRK.B (Berkshire Hathaway Inc.); also BRKB:BMV, BRKB:WSE."). The
1498
+ * spaced form reads so wherever the class trades. The joined form is a code
1499
+ * of its own first: one saved under it, one a US venue lists, or one abroad
1500
+ * of another company (HEIA is Heineken, not HEI.A) stays as typed, and
1501
+ * without `unsaved` only a saved class reads it, so a plain ticker costs no
1502
+ * search. Null for anything else, and when no US line of the class is found.
1503
+ */
1504
+ export async function readShareClassCode(
1505
+ typed: string,
1506
+ deps: ListingDeps,
1507
+ { unsaved = false }: { unsaved?: boolean } = {},
1508
+ ): Promise<ListingArg | null> {
1509
+ const words = typed.trim();
1510
+ const spaced = SPACED_SHARE_CLASS.exec(words);
1511
+ const joined = spaced ? null : JOINED_SHARE_CLASS.exec(words);
1512
+ const parts = spaced ?? joined;
1513
+ if (!parts) return null;
1514
+ const code = `${parts[1]}${parts[2]}`.toUpperCase();
1515
+ const dotted = `${parts[1]}.${parts[2]}`.toUpperCase();
1516
+ const quiet = <T,>(fallback: T) => logFailure("cli.listing-arg", "Read a share class failed", fallback);
1517
+ const saved = await loadSavedListing(deps.store, parseListingArg(dotted)).catch(quiet(null));
1518
+ if (joined && (!saved && !unsaved || await deps.store.loadTicker(code).catch(quiet(null)))) return null;
1519
+ const venues = await listingVenues(code, deps).catch(quiet([] as ListingVenue[]));
1520
+ // BRKB has no US line; a code that has one is a ticker of its own.
1521
+ if (joined && venues.some((venue) => isUsEquityExchange(venue.exchange))) return null;
1522
+ const savedExchange = saved ? canonicalExchange(saved.metadata.exchange) : "";
1523
+ const savedLine = saved ? { symbol: saved.metadata.ticker, exchange: savedExchange, name: saved.metadata.name } : null;
1524
+ // A class row saved with no exchange (an import, an older profile) is still the class: search names its US
1525
+ // line, and with search out of reach the row itself is read. Never the name search, which finds funds on it.
1526
+ const searched = savedLine && isUsEquityExchange(savedExchange) ? null : await usShareClassLine(dotted, deps).catch(quiet(null));
1527
+ const line = savedLine && isUsEquityExchange(savedExchange)
1528
+ ? savedLine
1529
+ : searched ? { ...searched, name: searched.name || savedLine?.name || "" } : savedLine && !savedExchange ? savedLine : null;
1530
+ if (!line || (line.exchange ? !isUsEquityExchange(line.exchange) : line !== savedLine)) return null;
1531
+ const abroad = venues.filter((venue) => !isUsEquityExchange(venue.exchange));
1532
+ if (joined && abroad.some((venue) => venue.name && line.name && !sameCompany(venue.name, line.name))) return null;
1533
+ const shown = abroad.slice(0, SHARE_CLASS_OTHER_LINES).map((venue) => `${venue.symbol ?? code}:${venue.exchange}`);
1534
+ const also = shown.length ? `; also ${shown.join(", ")}${abroad.length > shown.length ? ` and ${abroad.length - shown.length} more` : ""}` : "";
1535
+ // A US listing is read bare, as BRK.B is; another US venue keeps its name.
1536
+ const key = !line.exchange || isUsListingExchange(line.exchange) ? line.symbol : `${line.symbol}:${line.exchange}`;
1537
+ return { ...parseListingArg(key), readAs: `Read "${words}" as ${line.symbol} (${line.name || "share class"})${also}.`, readFromName: true };
1538
+ }
1539
+
1540
+ /** The US line search lists for a share class (BRK.B on NYSE before IEX), null when it lists none. */
1541
+ async function usShareClassLine(dotted: string, deps: ListingDeps): Promise<{ symbol: string; exchange: string; name: string } | null> {
1542
+ const spellings = new Set(usShareClassSpellings(dotted) ?? [dotted]);
1543
+ const venues = (await listingVenues(dotted, deps)).filter((venue) => isUsEquityExchange(venue.exchange)
1544
+ && (!venue.symbol || spellings.has(venue.symbol)));
1545
+ const venue = venues.find((entry) => isUsListingExchange(entry.exchange)) ?? venues[0];
1546
+ return venue ? { symbol: dotted, exchange: venue.exchange, name: venue.name } : null;
1547
+ }
1548
+
1358
1549
  /**
1359
1550
  * A two-letter symbol written with London's trailing dot (`BP.`, `RR.`) as its
1360
1551
  * London line, said as "Read BP. as BP:LSE.", where search lists it on LSE or
@@ -1432,6 +1623,153 @@ async function nothingTradesAs(symbol: string, deps: Pick<ListingDeps, "dataProv
1432
1623
  }
1433
1624
  }
1434
1625
 
1626
+ /**
1627
+ * A bare index root (NDX, VIX) no security trades as, read as its index: the
1628
+ * listing the service marks for the word (^NDX:NIM), else the ^ symbol, with
1629
+ * the line that says so ("Read "NDX" as ^NDX:NIM (NASDAQ-100)."). A source
1630
+ * can still serve old bars for the bare code (a stopped Frankfurt line's),
1631
+ * which no command means. A code a security trades as (MOVE, Corvex) or a
1632
+ * row saved under it stays as typed, as does one whose quote failed another
1633
+ * way (the network). Null for any other symbol.
1634
+ */
1635
+ async function readBareIndexRoot(parsed: ListingArg, typed: string, deps: ListingDeps): Promise<ListingArg | null> {
1636
+ const root = indexRootFor(parsed.symbol);
1637
+ const word = typed.trim();
1638
+ if (!root || word.toUpperCase() !== parsed.symbol) return null;
1639
+ if (await deps.store.loadTicker(parsed.symbol).catch(logFailure("cli.listing-arg", "Read a saved index root failed", null))) return null;
1640
+ if (!await nothingTradesAs(parsed.symbol, deps)) return null;
1641
+ const marked = await serviceMarkedListing(deps.dataProvider, word, root.symbol)
1642
+ .catch(logFailure("cli.listing-arg", "Read the listing an index root names failed", null));
1643
+ const key = marked?.exchange ? `${marked.symbol}:${marked.exchange}` : marked?.symbol ?? root.symbol;
1644
+ return { ...parseListingArg(key), readAs: `Read "${word}" as ${key} (${marked?.name || root.name}).`, readFromName: true };
1645
+ }
1646
+
1647
+ /**
1648
+ * A company's name typed as one word where a symbol goes (`Naspers`,
1649
+ * `Leumi`), written as a name is (NAME_WRITTEN_WORD), once the sources say
1650
+ * nothing trades as it, read as `quote` reads it (`oneWordCompanyName`):
1651
+ * "Read "Naspers" as NPN:JSE (Naspers Limited).". A real ticker always wins
1652
+ * (MTN stays Vail Resorts), and so do a row saved under the word and a code
1653
+ * listed abroad under it. Null for anything else, and when search names no
1654
+ * company.
1655
+ */
1656
+ async function readBareCompanyName(parsed: ListingArg, typed: string, deps: ListingDeps): Promise<ListingArg | null> {
1657
+ const word = typed.trim();
1658
+ if (parsed.exchange || !NAME_WRITTEN_WORD.test(word) || word.toUpperCase() !== parsed.symbol) return null;
1659
+ if (await deps.store.loadTicker(parsed.symbol).catch(logFailure("cli.listing-arg", "Read a saved word failed", null))) return null;
1660
+ if (!await nothingTradesAs(parsed.symbol, deps)) return null;
1661
+ const named = await oneWordCompanyName(word, deps).catch(logFailure("cli.listing-arg", "Read a word as a company's name failed", null));
1662
+ // A code listed abroad under the word (FP on TSXV and BVB) is a symbol, whose listings the command names: never a name.
1663
+ return named && named.symbol.toUpperCase() !== parsed.symbol ? named : null;
1664
+ }
1665
+
1666
+ /**
1667
+ * A word written as a name is, not as a ticker: letters, at least one small
1668
+ * (`Naspers`, `leumi`), no digit, dot or capitals alone (`UNISWAP`, `RY.TO`),
1669
+ * which a command reads as typed, at the cost of no extra quote.
1670
+ */
1671
+ const NAME_WRITTEN_WORD = /^(?=.*\p{Ll})\p{L}[\p{L}&'’-]*$/u;
1672
+
1673
+ /**
1674
+ * Symbols at most whose venues a command looks up to name the company each
1675
+ * bare one went to, and whose words it checks as companies' names
1676
+ * (`companyWord`, a quote each). A longer list is a batch of tickers.
1677
+ */
1678
+ export const MAX_CHOICE_LOOKUPS = 10;
1679
+
1680
+ /** At most this many words typed apart are tried as one company's name (`joinCompanyNameWords`). */
1681
+ const MAX_JOINED_NAME_WORDS = 4;
1682
+
1683
+ /**
1684
+ * At most this many runs of words around one word are searched as a name
1685
+ * (`joinedRun`), all at once: its two-word runs, then three, then one of four.
1686
+ */
1687
+ const MAX_JOINED_NAME_LOOKUPS = 6;
1688
+
1689
+ /**
1690
+ * Words typed apart that name one company: when a word of the arguments is
1691
+ * read as a company's name (`wordAsName`: "Group" as UNH:NYSE), the run of
1692
+ * words around it is tried as one name first, longest first, and a company
1693
+ * whose name has every word of it is that run's listing ("Read "MTN Group"
1694
+ * as MTN:JSE (MTN Group Ltd.)."), in place of the words. A word that names
1695
+ * no company with its neighbours keeps its own reading. `entries` are the
1696
+ * arguments in the order typed, each with the listing it was read as, null
1697
+ * where none; the answer is in the same order, a joined run one entry.
1698
+ */
1699
+ export async function joinCompanyNameWords<T extends { typed: string; listing: Pick<ListingArg, "wordAsName"> | null }>(
1700
+ entries: readonly T[],
1701
+ deps: Pick<ListingDeps, "dataProvider">,
1702
+ ): Promise<Array<T | { typed: string; joined: ListingArg; words: T[] }>> {
1703
+ // A word shaped as a ticker (BRK.B, 0700) is never part of a name.
1704
+ const word = (entry: T | undefined) => !!entry && ONE_WORD_NAME.test(entry.typed.trim()) && !tickerShapedWord(entry.typed.trim());
1705
+ const out: Array<T | { typed: string; joined: ListingArg; words: T[] }> = [];
1706
+ const tried = new Set<string>();
1707
+ let index = 0;
1708
+ while (index < entries.length) {
1709
+ const entry = entries[index]!;
1710
+ if (!entry.listing?.wordAsName) {
1711
+ out.push(entry);
1712
+ index += 1;
1713
+ continue;
1714
+ }
1715
+ let first = index;
1716
+ let last = index;
1717
+ // Words before it still stand as typed at the end of the answer; a run already joined is no word.
1718
+ while (first > 0 && index - first + 1 < MAX_JOINED_NAME_WORDS && word(entries[first - 1])
1719
+ && out[out.length - (index - first) - 1] === entries[first - 1]) first -= 1;
1720
+ while (last < entries.length - 1 && last - index + 1 < MAX_JOINED_NAME_WORDS && word(entries[last + 1])) last += 1;
1721
+ const joined = await joinedRun(entries.map((item) => item.typed.trim()), first, last, index, deps, tried);
1722
+ if (!joined) {
1723
+ out.push(entry);
1724
+ index += 1;
1725
+ continue;
1726
+ }
1727
+ // Words before the one read as a name that the run takes were pushed already: they are the run's now.
1728
+ out.splice(out.length - (index - joined.start), index - joined.start);
1729
+ const words = entries.slice(joined.start, joined.end);
1730
+ out.push({ typed: words.map((item) => item.typed.trim()).join(" "), joined: joined.listing, words });
1731
+ index = joined.end;
1732
+ }
1733
+ return out;
1734
+ }
1735
+
1736
+ /** The listing a company's name was read as (`named`), resolved as its key is, still saying what it was read as. */
1737
+ export async function resolveNamedListing(named: ListingArg, deps: ListingDeps): Promise<CliListing> {
1738
+ const resolved = await resolveCliListing(named.key, null, deps);
1739
+ return {
1740
+ ...resolved, readAs: named.readAs, ...named.meant ? { meant: named.meant } : {},
1741
+ ...named.readFromName ? { readFromName: named.readFromName } : {}, ...named.venueFromSearch ? { venueFromSearch: named.venueFromSearch } : {},
1742
+ };
1743
+ }
1744
+
1745
+ /**
1746
+ * The longest run of `words[first..last]` holding `at`, two words or more,
1747
+ * that names one company, the leftmost of the longest. The runs are searched
1748
+ * at once, the shortest first up to MAX_JOINED_NAME_LOOKUPS, and a run
1749
+ * searched for an earlier word (`tried`) is not searched again.
1750
+ */
1751
+ async function joinedRun(
1752
+ words: readonly string[], first: number, last: number, at: number, deps: Pick<ListingDeps, "dataProvider">, tried: Set<string>,
1753
+ ): Promise<{ start: number; end: number; listing: ListingArg } | null> {
1754
+ const runs: Array<{ start: number; end: number; phrase: string }> = [];
1755
+ for (let size = 2; size <= Math.min(last - first + 1, MAX_JOINED_NAME_WORDS); size += 1) {
1756
+ for (let start = Math.max(first, at - size + 1); start <= Math.min(at, last - size + 1); start += 1) {
1757
+ const phrase = words.slice(start, start + size).join(" ");
1758
+ if (tried.has(phrase) || runs.length >= MAX_JOINED_NAME_LOOKUPS) continue;
1759
+ tried.add(phrase);
1760
+ runs.push({ start, end: start + size, phrase });
1761
+ }
1762
+ }
1763
+ const found = await Promise.all(runs.map(async (run) => {
1764
+ const company = await findCompanyName(run.phrase, deps).catch(busyAsMiss)
1765
+ .catch(logFailure("cli.listing-arg", "Read words as one company's name failed", null));
1766
+ return company && companyNameExtraWords(run.phrase, company.name) != null ? { ...run, company } : null;
1767
+ }));
1768
+ const best = found.filter((run) => run != null)
1769
+ .sort((left, right) => (right.end - right.start) - (left.end - left.start) || left.start - right.start)[0];
1770
+ return best ? { start: best.start, end: best.end, listing: companyListingArg(best.phrase, best.company) } : null;
1771
+ }
1772
+
1435
1773
  /** `readBrokerIndexCode` for a `$ROOT` code only: the `ROOT.X` codes are read where the listing is parsed. */
1436
1774
  function readDollarIndexCode(raw: string, deps: Pick<ListingDeps, "dataProvider">): Promise<ListingArg | null> {
1437
1775
  return brokerIndexCode(stripStrayEdges(raw).text || raw)?.bare ? readBrokerIndexCode(raw, deps) : Promise.resolve(null);
@@ -1448,6 +1786,12 @@ async function companyNameListingArg(raw: string, deps: ListingDeps): Promise<Li
1448
1786
  return isCompanyNameInput(typed) ? readCompanyName(typed, deps) : null;
1449
1787
  }
1450
1788
 
1789
+ /** `Read "crude oil" as CL=F (WTI Crude Oil), the benchmark future; Brent is BZ=F.` */
1790
+ function commodityFutureReadAs(typed: string, { contract, other }: NonNullable<ReturnType<typeof commodityNameFuture>>): string {
1791
+ const alternative = other ? `; ${other.name} is ${other.contract.symbol}` : "";
1792
+ return `Read "${typed.trim()}" as ${contract.symbol} (${contract.name}), the benchmark future${alternative}.`;
1793
+ }
1794
+
1451
1795
  /** One word that can be a company's name: letters first, no venue, pair or index mark (`Apple`, `Petrobras`, `Coca-Cola`). */
1452
1796
  const ONE_WORD_NAME = /^\p{L}[\p{L}\p{N}&'’.-]*$/u;
1453
1797
 
@@ -1583,9 +1927,12 @@ function companyListingArg(typed: string, found: CompanyNameListing): ListingArg
1583
1927
  const question = meant ? ` ${meantQuestion({ meant })}` : "";
1584
1928
  // A company that moved off the line search lists says so: "GETY became GETYQ on 2026-10-22."
1585
1929
  const moved = found.moved ? ` ${found.moved}.` : "";
1930
+ // The company's other own lines, where it is listed twice: "Read "Elbit Systems" as ESLT:NASDAQ (Elbit Systems Ltd.); also ESLT:TASE."
1931
+ const also = found.otherLines?.length ? `; also ${found.otherLines.join(", ")}` : "";
1586
1932
  return {
1587
- ...parseListingArg(key), readAs: `Read "${typed.trim()}" as ${key} (${found.name}).${moved}${question}`,
1933
+ ...parseListingArg(key), readAs: `Read "${typed.trim()}" as ${key} (${found.name})${also}.${moved}${question}`,
1588
1934
  ...meant ? { meant } : {}, ...found.exchange ? { venueFromSearch: true as const } : { readFromName: true as const },
1935
+ ...!/\s/.test(typed.trim()) ? { wordAsName: true as const } : {},
1589
1936
  };
1590
1937
  }
1591
1938
 
@@ -1624,7 +1971,7 @@ export async function requireCliListing(
1624
1971
  exchangeOption: string | null | undefined,
1625
1972
  deps: ListingDeps,
1626
1973
  ctx: Pick<CliCommandContext, "fail">,
1627
- options: { ownExchangeWins?: boolean; venueSuffix?: boolean } = {},
1974
+ options: { ownExchangeWins?: boolean; venueSuffix?: boolean; companyWord?: boolean } = {},
1628
1975
  ): Promise<CliListing> {
1629
1976
  try {
1630
1977
  return await resolveCliListing(raw, exchangeOption, deps, options);
@@ -1669,7 +2016,7 @@ export interface ListingIdentity {
1669
2016
 
1670
2017
  export function listingIdentity(
1671
2018
  listing: Pick<CliListing, "symbol" | "exchange" | "saved">,
1672
- quote?: Pick<Quote, "name" | "listingExchangeName" | "exchangeName"> | null,
2019
+ quote?: Pick<Quote, "name" | "listingExchangeName" | "exchangeName"> & Partial<Pick<Quote, "symbol">> | null,
1673
2020
  ): ListingIdentity {
1674
2021
  const quoteExchange = canonicalExchange(quote?.listingExchangeName || quote?.exchangeName);
1675
2022
  const exchange = listing.exchange || quoteExchange || canonicalExchange(listing.saved?.metadata.exchange);
@@ -22,8 +22,8 @@ export interface PaneFunctionCapability {
22
22
  aliases: string[];
23
23
  /** Words that are no code but ask for this function's data: `fn` and `catalog` answer them with it. */
24
24
  suggestFor?: string[];
25
- /** Words that open the function on one argument (`VX`: CTM VIX). */
26
- opens?: ReadonlyArray<{ words: readonly string[]; argument: string }>;
25
+ /** Words that open the function on one argument (`VX`: CTM VIX), or with options set (`PDUFA`: CATL --type pdufa). */
26
+ opens?: ReadonlyArray<{ words: readonly string[]; argument: string; options?: Readonly<Record<string, string>> }>;
27
27
  intents: string[];
28
28
  outputKind: string;
29
29
  reportReadiness: PaneFunctionReadiness;