gloomberb 0.20.1 → 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 (675) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +2 -1
  4. package/src/account/auth-form.tsx +13 -8
  5. package/src/account/auth-model.ts +20 -1
  6. package/src/account/upgrade-dialog.tsx +8 -4
  7. package/src/api-client/askg.ts +7 -1
  8. package/src/api-client/auth.ts +27 -0
  9. package/src/api-client/catalysts.ts +2 -0
  10. package/src/api-client/central-bank-rates.ts +5 -0
  11. package/src/api-client/company-kpis.ts +2 -1
  12. package/src/api-client/cot.ts +14 -2
  13. package/src/api-client/data.ts +20 -6
  14. package/src/api-client/debt-maturities.ts +45 -2
  15. package/src/api-client/earnings.ts +50 -5
  16. package/src/api-client/errors.ts +21 -11
  17. package/src/api-client/futures-curve.ts +17 -0
  18. package/src/api-client/index.ts +5 -1
  19. package/src/api-client/one-tap-reasons.ts +42 -0
  20. package/src/api-client/paths.ts +9 -1
  21. package/src/api-client/perps.ts +2 -1
  22. package/src/api-client/request.ts +3 -1
  23. package/src/api-client/research-activity.ts +16 -3
  24. package/src/api-client/social-mentions.ts +47 -0
  25. package/src/api-client/types/econ.ts +4 -0
  26. package/src/api-client/types/filings-and-calls.ts +3 -0
  27. package/src/api-client/types/search.ts +3 -0
  28. package/src/app/keybindings/chord.ts +153 -9
  29. package/src/app/keybindings/index.ts +1 -1
  30. package/src/app/keybindings/labels.ts +49 -6
  31. package/src/app/runtime/desktop-deeplink.ts +73 -8
  32. package/src/app.tsx +18 -2
  33. package/src/architecture/core-builtin-allowlist.json +1 -2
  34. package/src/architecture/pane-tabs-allowlist.json +2 -1
  35. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  36. package/src/architecture/ui-literals-allowlist.json +8 -8
  37. package/src/brokers/broker-portfolio-sync.ts +1 -1
  38. package/src/cli/bank-section.ts +26 -12
  39. package/src/cli/command-options.ts +2 -1
  40. package/src/cli/commands/market.ts +372 -99
  41. package/src/cli/commands/options-chain.ts +23 -6
  42. package/src/cli/commands/overview.ts +13 -5
  43. package/src/cli/commands/plugins.ts +49 -18
  44. package/src/cli/commands/search.ts +25 -6
  45. package/src/cli/commands/ticker.ts +16 -9
  46. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  47. package/src/cli/desktop-pane-shot.ts +15 -0
  48. package/src/cli/entry.ts +5 -0
  49. package/src/cli/export-source.ts +7 -1
  50. package/src/cli/freshness.ts +0 -16
  51. package/src/cli/fx-pair.ts +64 -12
  52. package/src/cli/fx-quote-rate.ts +192 -0
  53. package/src/cli/glossary.ts +100 -15
  54. package/src/cli/history-back-adjust.ts +122 -0
  55. package/src/cli/history-rows.ts +122 -34
  56. package/src/cli/index.ts +6 -35
  57. package/src/cli/known-gaps.ts +48 -6
  58. package/src/cli/listing-arg.ts +125 -21
  59. package/src/cli/name-entries.ts +26 -5
  60. package/src/cli/not-a-ticker.ts +6 -2
  61. package/src/cli/pane-functions/capabilities.ts +12 -1
  62. package/src/cli/pane-functions/catalog.ts +12 -2
  63. package/src/cli/pane-functions/dom.ts +4 -2
  64. package/src/cli/pane-functions/function-help.ts +23 -11
  65. package/src/cli/pane-functions/headless.ts +11 -6
  66. package/src/cli/pane-functions/index.ts +35 -4
  67. package/src/cli/pane-functions/market-session.ts +8 -3
  68. package/src/cli/pane-functions/resolver.ts +22 -12
  69. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  70. package/src/cli/pane-functions/screenshot-payload.ts +166 -72
  71. package/src/cli/pane-functions/screenshot-render.ts +18 -2
  72. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  73. package/src/cli/quote-answer.ts +10 -0
  74. package/src/cli/report-tables.ts +22 -2
  75. package/src/cli/result.ts +7 -3
  76. package/src/cli/spreadsheet-hint.ts +43 -0
  77. package/src/cli/symbol-list.ts +58 -4
  78. package/src/cli/symbol-rows.ts +71 -4
  79. package/src/cli/ticker-resolution.ts +171 -21
  80. package/src/cli/unknown-command.ts +88 -0
  81. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  82. package/src/components/chart/composite/composite-chart.tsx +8 -1
  83. package/src/components/chart/composite/format.ts +16 -1
  84. package/src/components/chart/composite/legend.tsx +4 -3
  85. package/src/components/chart/composite/panel-labels.ts +2 -1
  86. package/src/components/chart/composite/panel-surface.tsx +33 -4
  87. package/src/components/chart/composite/time-scale.ts +1 -1
  88. package/src/components/chart/composite/toolbar.tsx +8 -4
  89. package/src/components/chart/composite/types.ts +17 -1
  90. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  91. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  92. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  93. package/src/components/chart-table/axis.ts +11 -0
  94. package/src/components/command-bar/assist/inventory.ts +3 -2
  95. package/src/components/command-bar/assist/model.ts +6 -1
  96. package/src/components/command-bar/commands/collection-list.ts +3 -2
  97. package/src/components/command-bar/commands/direct/index.ts +9 -1
  98. package/src/components/command-bar/commands/registry.ts +18 -0
  99. package/src/components/command-bar/pane-actions.ts +30 -13
  100. package/src/components/command-bar/panel/index.tsx +6 -3
  101. package/src/components/command-bar/panel/layout.ts +8 -1
  102. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  103. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  104. package/src/components/command-bar/panel/state.ts +4 -0
  105. package/src/components/command-bar/panel/types.ts +3 -0
  106. package/src/components/command-bar/routes/header-market.ts +108 -0
  107. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  108. package/src/components/command-bar/routes/root/provider-search.ts +190 -32
  109. package/src/components/command-bar/routes/root/results.ts +3 -0
  110. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  111. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  112. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  113. package/src/components/command-bar/routes/ticker-search/results.ts +53 -6
  114. package/src/components/command-bar/routing/list-state.ts +38 -0
  115. package/src/components/command-bar/selection-hint.ts +28 -0
  116. package/src/components/command-bar/surface/index.tsx +41 -3
  117. package/src/components/command-bar/view-model.ts +15 -0
  118. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  119. package/src/components/command-bar/workflow/tickers.ts +3 -2
  120. package/src/components/company-logo.tsx +22 -4
  121. package/src/components/data-table/export.ts +13 -8
  122. package/src/components/data-table/view.tsx +11 -2
  123. package/src/components/feed-data-table/stack-view.tsx +20 -6
  124. package/src/components/feedback-dialog.tsx +5 -2
  125. package/src/components/form-modal/field-row.tsx +3 -2
  126. package/src/components/form-modal/routes.ts +1 -0
  127. package/src/components/index.ts +1 -1
  128. package/src/components/input-search-bar.tsx +2 -2
  129. package/src/components/layout/double-escape-close.ts +8 -5
  130. package/src/components/layout/header.tsx +87 -47
  131. package/src/components/layout/market-summary.ts +323 -116
  132. package/src/components/layout/pane/footer/index.tsx +31 -9
  133. package/src/components/layout/pane/footer/model.ts +63 -21
  134. package/src/components/layout/pane/footer/registration.tsx +60 -1
  135. package/src/components/layout/pane/header-tabs.tsx +17 -3
  136. package/src/components/layout/pane/header.tsx +8 -4
  137. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  138. package/src/components/layout/shell/active-drag.ts +38 -30
  139. package/src/components/layout/shell/chrome.ts +15 -15
  140. package/src/components/layout/shell/drag/index.ts +51 -21
  141. package/src/components/layout/shell/menu.ts +3 -5
  142. package/src/components/layout/shell/pane/actions.ts +4 -1
  143. package/src/components/layout/shell/pane/ask.ts +5 -2
  144. package/src/components/layout/status-bar.tsx +63 -57
  145. package/src/components/layout/status-widget-space.ts +8 -0
  146. package/src/components/markdown-editor.tsx +2 -2
  147. package/src/components/markdown-text.tsx +35 -10
  148. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  149. package/src/components/onboarding/first-run-workspace.ts +25 -23
  150. package/src/components/onboarding/onboarding-keyboard.ts +21 -7
  151. package/src/components/onboarding/onboarding-wizard.tsx +73 -13
  152. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  153. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -5
  154. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  155. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  156. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  157. package/src/components/onboarding/wizard-positions.ts +8 -1
  158. package/src/components/pane-notice-seen.ts +125 -0
  159. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  160. package/src/components/pane-settings-dialog.tsx +7 -6
  161. package/src/components/price-sparkline/model.ts +26 -10
  162. package/src/components/sign-in-code-panel.tsx +3 -2
  163. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  164. package/src/components/ticker/list-table-view.tsx +68 -7
  165. package/src/components/ui/button.tsx +13 -2
  166. package/src/components/ui/column-grid.tsx +18 -9
  167. package/src/components/ui/confirm-dialog.tsx +2 -1
  168. package/src/components/ui/data-table/index.tsx +5 -3
  169. package/src/components/ui/data-table/opentui/index.tsx +17 -6
  170. package/src/components/ui/data-table/types.ts +26 -0
  171. package/src/components/ui/delayed-mark.tsx +3 -2
  172. package/src/components/ui/external-link.tsx +4 -1
  173. package/src/components/ui/field-grid.tsx +1 -3
  174. package/src/components/ui/fields.tsx +7 -4
  175. package/src/components/ui/index.ts +2 -0
  176. package/src/components/ui/inline-quick-add.tsx +7 -2
  177. package/src/components/ui/key-hint-words.ts +153 -0
  178. package/src/components/ui/key-hints.tsx +73 -0
  179. package/src/components/ui/menu.tsx +3 -1
  180. package/src/components/ui/message-composer.tsx +2 -2
  181. package/src/components/ui/multi-select/dialog.tsx +10 -9
  182. package/src/components/ui/pane-link-chip.tsx +354 -0
  183. package/src/components/ui/query-bar.tsx +22 -13
  184. package/src/components/ui/ratio-bar.tsx +24 -1
  185. package/src/components/ui/select-button.tsx +2 -1
  186. package/src/components/ui/shortcut-hint.tsx +32 -4
  187. package/src/components/ui/table-layout.ts +81 -0
  188. package/src/components/ui/tabs.tsx +52 -6
  189. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  190. package/src/components/use-pane-notice-footer.tsx +12 -4
  191. package/src/core/app-service-ports.ts +1 -1
  192. package/src/core/state/app/command-bar-launch.ts +3 -0
  193. package/src/data/config/store/normalize.ts +6 -0
  194. package/src/data/plugin-state-store.ts +44 -8
  195. package/src/docs/snapshot.json +172 -100
  196. package/src/i18n/es.ts +48 -6
  197. package/src/i18n/ja.ts +48 -5
  198. package/src/i18n/ko.ts +48 -5
  199. package/src/i18n/zh-cn.ts +48 -5
  200. package/src/i18n/zh-tw.ts +48 -5
  201. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  202. package/src/layout/pane-manager/gridlock.ts +58 -2
  203. package/src/layout-marketplace/api.ts +1 -0
  204. package/src/layout-marketplace/gallery.tsx +4 -3
  205. package/src/layout-marketplace/linked.ts +6 -4
  206. package/src/layout-marketplace/model.ts +3 -2
  207. package/src/market-data/bars-per-year.ts +27 -9
  208. package/src/market-data/coordinator/quotes.ts +22 -3
  209. package/src/market-data/futures-board.ts +80 -0
  210. package/src/market-data/futures-contract.ts +86 -34
  211. package/src/market-data/fx-closes.ts +5 -2
  212. package/src/market-data/hooks.tsx +23 -0
  213. package/src/market-data/market/change-basis.ts +74 -16
  214. package/src/market-data/market/dated-previous-close.ts +163 -47
  215. package/src/market-data/market/format.ts +33 -14
  216. package/src/market-data/market/freshness.ts +24 -7
  217. package/src/market-data/market/globex-day.ts +73 -0
  218. package/src/market-data/market/header-market.ts +154 -0
  219. package/src/market-data/market/index-level.ts +39 -1
  220. package/src/market-data/market/index-session-venues.ts +44 -0
  221. package/src/market-data/market/status.ts +7 -2
  222. package/src/market-data/market/venue-session.ts +72 -0
  223. package/src/market-data/model-dividend-yield.ts +23 -8
  224. package/src/market-data/options-alternatives.ts +39 -4
  225. package/src/market-data/published-apac-sessions.ts +40 -2
  226. package/src/market-data/quotes/export-identity.ts +76 -0
  227. package/src/market-data/quotes/freshness.ts +22 -0
  228. package/src/market-data/quotes/intraday-bar.ts +1 -1
  229. package/src/market-data/quotes/session-split.ts +28 -0
  230. package/src/market-data/quotes/time.ts +42 -1
  231. package/src/market-data/realized-volatility.ts +11 -7
  232. package/src/market-data/tax-equivalent.ts +145 -27
  233. package/src/plugins/builtin/account-management/pane.tsx +3 -3
  234. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  235. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  236. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  237. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  238. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  239. package/src/plugins/builtin/alerts/cli.ts +224 -33
  240. package/src/plugins/builtin/alerts/command.ts +33 -6
  241. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  242. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  243. package/src/plugins/builtin/alerts/events.ts +9 -0
  244. package/src/plugins/builtin/alerts/format.ts +40 -15
  245. package/src/plugins/builtin/alerts/headless.ts +31 -18
  246. package/src/plugins/builtin/alerts/history.ts +1 -0
  247. package/src/plugins/builtin/alerts/index.tsx +86 -12
  248. package/src/plugins/builtin/alerts/live.ts +2 -1
  249. package/src/plugins/builtin/alerts/move-checks.ts +155 -0
  250. package/src/plugins/builtin/alerts/move.ts +160 -0
  251. package/src/plugins/builtin/alerts/pane.tsx +52 -22
  252. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  253. package/src/plugins/builtin/alerts/price.ts +17 -0
  254. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  255. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  256. package/src/plugins/builtin/alerts/storage.ts +20 -7
  257. package/src/plugins/builtin/alerts/types.ts +13 -0
  258. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  259. package/src/plugins/builtin/analytics/index.tsx +10 -3
  260. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  261. package/src/plugins/builtin/analytics/risk-client.ts +64 -40
  262. package/src/plugins/builtin/analytics/risk-episodes.ts +440 -0
  263. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  264. package/src/plugins/builtin/analytics/risk-headless.ts +44 -10
  265. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  266. package/src/plugins/builtin/analytics/risk-model.ts +183 -27
  267. package/src/plugins/builtin/analytics/risk-pane.tsx +216 -26
  268. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  269. package/src/plugins/builtin/backtest/engine.ts +4 -2
  270. package/src/plugins/builtin/backtest/format.ts +14 -0
  271. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  272. package/src/plugins/builtin/backtest/report.ts +5 -3
  273. package/src/plugins/builtin/backtest/window.ts +3 -1
  274. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  275. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  276. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  277. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  278. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  279. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  280. package/src/plugins/builtin/catalysts/model.ts +7 -2
  281. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  282. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  283. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  284. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  285. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  286. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  287. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  288. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  289. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  290. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  291. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  292. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  293. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  294. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  295. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  296. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  297. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  298. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  299. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  300. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  301. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  302. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  303. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  304. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  305. package/src/plugins/builtin/correlation/index.tsx +39 -167
  306. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  307. package/src/plugins/builtin/correlation/relationship/pane.tsx +6 -7
  308. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  309. package/src/plugins/builtin/cot/client.ts +8 -3
  310. package/src/plugins/builtin/cot/headless.ts +65 -12
  311. package/src/plugins/builtin/cot/pane.tsx +11 -5
  312. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  313. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  314. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  315. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  316. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  317. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  318. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  319. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  320. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  321. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  322. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  323. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  324. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  325. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  326. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  327. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  328. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  329. package/src/plugins/builtin/earnings/client.ts +40 -6
  330. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  331. package/src/plugins/builtin/earnings/headless.ts +47 -11
  332. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  333. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  334. package/src/plugins/builtin/earnings/history.tsx +23 -8
  335. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  336. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  337. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  338. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  339. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  340. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  341. package/src/plugins/builtin/econ/figures.ts +13 -0
  342. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  343. package/src/plugins/builtin/econ/index.tsx +10 -7
  344. package/src/plugins/builtin/econ/types.ts +5 -0
  345. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  346. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  347. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  348. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  349. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  350. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  351. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  352. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  353. package/src/plugins/builtin/futures/index.tsx +32 -10
  354. package/src/plugins/builtin/futures/model.ts +93 -6
  355. package/src/plugins/builtin/futures/returns.ts +29 -7
  356. package/src/plugins/builtin/futures/table.tsx +59 -17
  357. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  358. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  359. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  360. package/src/plugins/builtin/futures-curve/model.ts +114 -25
  361. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  362. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  363. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  364. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  365. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  366. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  367. package/src/plugins/builtin/help/function-card.tsx +2 -1
  368. package/src/plugins/builtin/help/function-index.ts +1 -0
  369. package/src/plugins/builtin/help/index.tsx +68 -61
  370. package/src/plugins/builtin/holders/format.ts +7 -2
  371. package/src/plugins/builtin/holders/pane.tsx +11 -3
  372. package/src/plugins/builtin/holders/report-header.ts +5 -4
  373. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  374. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  375. package/src/plugins/builtin/insider/client.ts +31 -14
  376. package/src/plugins/builtin/insider/signals-model.ts +6 -12
  377. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  378. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  379. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  380. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  381. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  382. package/src/plugins/builtin/iv-history/model.ts +33 -23
  383. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  384. package/src/plugins/builtin/kelly-sizer/headless.ts +68 -16
  385. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  386. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  387. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  388. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  389. package/src/plugins/builtin/news/index.tsx +7 -13
  390. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  391. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  392. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  393. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  394. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  395. package/src/plugins/builtin/options/analytics.ts +7 -2
  396. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  397. package/src/plugins/builtin/options/table.ts +3 -2
  398. package/src/plugins/builtin/options/view.tsx +11 -9
  399. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  400. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  401. package/src/plugins/builtin/perps/client.ts +5 -4
  402. package/src/plugins/builtin/perps/headless.ts +189 -123
  403. package/src/plugins/builtin/perps/index.tsx +3 -1
  404. package/src/plugins/builtin/perps/markets-section.tsx +2 -2
  405. package/src/plugins/builtin/perps/model.ts +9 -5
  406. package/src/plugins/builtin/perps/open-market.ts +4 -4
  407. package/src/plugins/builtin/perps/pane.tsx +2 -0
  408. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  409. package/src/plugins/builtin/portfolio-list/cell-version.ts +2 -0
  410. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +54 -11
  411. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  412. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +180 -0
  413. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +68 -22
  414. package/src/plugins/builtin/portfolio-list/cli/render.ts +82 -27
  415. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  416. package/src/plugins/builtin/portfolio-list/grid.tsx +61 -15
  417. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  418. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  419. package/src/plugins/builtin/portfolio-list/pane/index.tsx +48 -4
  420. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  421. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  422. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  423. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  424. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  425. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  426. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  427. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  428. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +137 -11
  429. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  430. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  431. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  432. package/src/plugins/builtin/portfolio-list/table.tsx +134 -9
  433. package/src/plugins/builtin/power/headless.ts +47 -9
  434. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  435. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  436. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  437. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  438. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  439. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  440. package/src/plugins/builtin/research-search/article.ts +12 -2
  441. package/src/plugins/builtin/research-search/data.ts +5 -2
  442. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  443. package/src/plugins/builtin/research-search/model.ts +47 -3
  444. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  445. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  446. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  447. package/src/plugins/builtin/risk-factors/pane.tsx +5 -3
  448. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  449. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  450. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  451. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  452. package/src/plugins/builtin/sec/forms.ts +19 -0
  453. package/src/plugins/builtin/sec/headless.ts +55 -17
  454. package/src/plugins/builtin/sec/index.tsx +17 -7
  455. package/src/plugins/builtin/sec/model.ts +4 -1
  456. package/src/plugins/builtin/shared/earnings-calendar.ts +8 -3
  457. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  458. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  459. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  460. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  461. package/src/plugins/builtin/shared/use-quote-board.ts +47 -30
  462. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  463. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  464. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  465. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  466. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  467. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  468. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  469. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  470. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  471. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  472. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  473. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  474. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  475. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  476. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  477. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  478. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  479. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  480. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  481. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  482. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  483. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  484. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  485. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  486. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  487. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  488. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  489. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  490. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  491. package/src/plugins/builtin/ticker-detail/headless-schema.ts +12 -2
  492. package/src/plugins/builtin/ticker-detail/headless.ts +21 -59
  493. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  494. package/src/plugins/builtin/ticker-detail/overview/components.tsx +15 -2
  495. package/src/plugins/builtin/ticker-detail/overview/model.ts +10 -6
  496. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  497. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  498. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +52 -14
  499. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  500. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  501. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  502. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  503. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  504. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  505. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  506. package/src/plugins/builtin/ticker-detail/settings.ts +10 -9
  507. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  508. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  509. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  510. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  511. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  512. package/src/plugins/builtin/world-indices/client.ts +2 -0
  513. package/src/plugins/compat.ts +15 -0
  514. package/src/plugins/host-link.ts +6 -1
  515. package/src/plugins/host-resolver.ts +3 -2
  516. package/src/plugins/installer.ts +8 -3
  517. package/src/portfolio/column-values.ts +56 -12
  518. package/src/portfolio/futures-positions.ts +10 -2
  519. package/src/portfolio/listed-symbol.ts +78 -0
  520. package/src/portfolio/mutations.ts +4 -3
  521. package/src/portfolio/period-pnl.ts +119 -0
  522. package/src/portfolio/positions-import/describe.ts +89 -0
  523. package/src/portfolio/positions-import/parse.ts +682 -0
  524. package/src/portfolio/positions-import/plan.ts +295 -0
  525. package/src/portfolio/real-return.ts +172 -0
  526. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  527. package/src/public/__snapshots__/public-api.test.ts.snap +2 -0
  528. package/src/react/jsx-dev-fallback.ts +62 -0
  529. package/src/renderers/browser/cloud-transport.ts +1 -1
  530. package/src/renderers/browser/config-host.ts +59 -16
  531. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  532. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  533. package/src/renderers/browser/main.tsx +5 -2
  534. package/src/renderers/browser/research-entry.ts +12 -0
  535. package/src/renderers/browser/ui-host.tsx +1 -0
  536. package/src/renderers/cloudflare/http-proxy.ts +9 -2
  537. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  538. package/src/renderers/cloudflare/worker.ts +12 -3
  539. package/src/renderers/dom/boot-frame.ts +2 -2
  540. package/src/renderers/dom/data-table/row.tsx +4 -1
  541. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  542. package/src/renderers/dom/desktop/controls.tsx +5 -5
  543. package/src/renderers/dom/desktop/dialog-actions.tsx +62 -57
  544. package/src/renderers/dom/desktop/icons.tsx +4 -2
  545. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  546. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  547. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  548. package/src/renderers/dom/host/box.tsx +2 -2
  549. package/src/renderers/dom/host/input.tsx +17 -1
  550. package/src/renderers/dom/host/tabs.tsx +10 -1
  551. package/src/renderers/dom/key-event.ts +1 -0
  552. package/src/renderers/dom/styles.css +36 -13
  553. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  554. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  555. package/src/renderers/electrobun/bun/desktop/backend.ts +1 -0
  556. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  557. package/src/renderers/electrobun/bun/desktop/host-requests.ts +5 -4
  558. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  559. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  560. package/src/renderers/electrobun/bun/desktop/initialization.ts +3 -1
  561. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  562. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  563. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  564. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  565. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  566. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  567. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  568. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  569. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  570. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  571. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  572. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  573. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  574. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  575. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  576. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  577. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  578. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  579. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  580. package/src/renderers/electrobun/view/main.tsx +9 -4
  581. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  582. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  583. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  584. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  585. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  586. package/src/renderers/opentui/browser-open.ts +2 -1
  587. package/src/renderers/opentui/dialog-host.tsx +1 -1
  588. package/src/renderers/opentui/host.tsx +2 -1
  589. package/src/renderers/opentui/interaction-performance.ts +3 -1
  590. package/src/renderers/opentui/start.tsx +2 -1
  591. package/src/renderers/opentui/terminal-media.ts +11 -6
  592. package/src/renderers/opentui/ui-host.tsx +5 -8
  593. package/src/shares/open.ts +22 -1
  594. package/src/shares/pane.ts +2 -1
  595. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  596. package/src/sources/gloomberb-cloud/index.ts +31 -2
  597. package/src/sources/gloomberb-cloud/normalizers.ts +32 -3
  598. package/src/sources/provider-router/cached-routes.ts +19 -7
  599. package/src/state/pane-table-export-registry.ts +19 -6
  600. package/src/sync/analytics-payload.ts +194 -0
  601. package/src/sync/baseline.ts +19 -9
  602. package/src/sync/broker-identity.ts +171 -0
  603. package/src/sync/broker-instances.ts +137 -0
  604. package/src/sync/collections-contributor.ts +173 -0
  605. package/src/sync/config-contributor.ts +100 -0
  606. package/src/sync/config-merge.ts +229 -0
  607. package/src/sync/controller.ts +139 -28
  608. package/src/sync/core-contributors.ts +8 -1583
  609. package/src/sync/history-memo.ts +32 -0
  610. package/src/sync/layout-merge.ts +259 -0
  611. package/src/sync/sanitize.ts +114 -0
  612. package/src/sync/ticker-merge.ts +208 -0
  613. package/src/sync/ticker-payload.ts +81 -0
  614. package/src/sync/types.ts +15 -1
  615. package/src/telemetry/attention-setting.ts +1 -1
  616. package/src/telemetry/usage-counts.ts +16 -0
  617. package/src/test-support/preload.ts +9 -0
  618. package/src/theme/color-utils.ts +10 -0
  619. package/src/theme/colors.ts +9 -1
  620. package/src/theme/font-scale.ts +34 -3
  621. package/src/theme/series-colors.ts +44 -0
  622. package/src/theme/themes.ts +64 -16
  623. package/src/theme/tone-contrast.ts +40 -0
  624. package/src/theme/ui-tokens.ts +23 -3
  625. package/src/tickers/batched-lookups.ts +314 -8
  626. package/src/tickers/company-name-listing.ts +198 -14
  627. package/src/tickers/company-name.ts +37 -8
  628. package/src/tickers/list.ts +7 -0
  629. package/src/tickers/search/home-listing.ts +31 -9
  630. package/src/tickers/search/index.ts +13 -3
  631. package/src/tickers/search/listing-index.ts +558 -0
  632. package/src/tickers/search/major-listings.chunk.ts +10 -0
  633. package/src/tickers/search/major-listings.json +3346 -0
  634. package/src/tickers/search/ranking.ts +68 -1
  635. package/src/tickers/search/types.ts +4 -0
  636. package/src/tickers/search/upsert.ts +16 -1
  637. package/src/tickers/terminal-codes.ts +26 -1
  638. package/src/time-series/base-series.ts +18 -4
  639. package/src/time-series/calendar-month-returns.ts +47 -0
  640. package/src/time-series/currency-conversion.ts +130 -0
  641. package/src/time-series/hooks.ts +2 -0
  642. package/src/time-series/price-comparison.ts +34 -11
  643. package/src/time-series/resolve-context.ts +3 -0
  644. package/src/time-series/resolve.ts +14 -2
  645. package/src/time-series/spec.ts +1 -0
  646. package/src/time-series/studies/indicators.ts +7 -2
  647. package/src/time-series/studies/resolve.ts +1 -1
  648. package/src/time-series/types.ts +14 -0
  649. package/src/types/config.ts +8 -0
  650. package/src/types/data-provider.ts +28 -0
  651. package/src/types/financials.ts +38 -2
  652. package/src/types/headless.ts +23 -0
  653. package/src/ui/host.tsx +34 -3
  654. package/src/ui/index.tsx +1 -0
  655. package/src/utils/concurrency.ts +6 -0
  656. package/src/utils/currency-pair.ts +56 -4
  657. package/src/utils/datetime-format.ts +28 -3
  658. package/src/utils/decimal-comma.ts +9 -6
  659. package/src/utils/display-number.ts +15 -0
  660. package/src/utils/double-escape-close.ts +61 -16
  661. package/src/utils/exchanges.ts +32 -0
  662. package/src/utils/float32-price.ts +24 -0
  663. package/src/utils/forward-dividend.ts +81 -16
  664. package/src/utils/fundamentals.ts +41 -0
  665. package/src/utils/fx-market-hours.ts +11 -0
  666. package/src/utils/markdown.ts +4 -2
  667. package/src/utils/pasted-lines.ts +14 -0
  668. package/src/utils/plugin-proxy-hosts.json +2 -1
  669. package/src/utils/price-history.ts +7 -6
  670. package/src/utils/price-window.ts +2 -1
  671. package/src/utils/report-timing.ts +62 -0
  672. package/src/utils/sec-filings.ts +49 -0
  673. package/src/utils/sec.ts +4 -23
  674. package/src/utils/shortcut-labels.ts +6 -30
  675. package/src/utils/utc-time.ts +5 -0
@@ -15,12 +15,14 @@ import {
15
15
  type ListingVenue,
16
16
  } from "../tickers/listing-venues";
17
17
  import { findUsListingOfCompany, type UsListing } from "../tickers/us-listing";
18
- import { findListingOfCompanyName, isCompanyNameInput, marksAnotherListing, readTerminalCodeArg, type CompanyNameListing } from "../tickers/company-name-listing";
18
+ import {
19
+ findListingOfCompanyName, isCompanyNameInput, marksAnotherListing, readTerminalCodeArg, serviceMarkedListing, serviceMarkedOtherListing, type CompanyNameListing,
20
+ } from "../tickers/company-name-listing";
19
21
  import { movedAwayChange, startTickerChangeLookup, type MovedTickerChange } from "../tickers/ticker-changes";
20
22
  import { lineMayHaveMoved, listingChangeLine, loadListingFate, MovedSymbolError, SUCCESSOR_CHANGE_WAIT_MS, type ListingFate } from "../tickers/listing-fate";
21
23
  import { quotedListingName } from "../tickers/listing-name";
22
24
  import { cliStyles } from "../utils/cli-output";
23
- import { groupByCompany, namesDepositaryReceipt, sameCompany, sameListedName, shortCompanyName } from "../tickers/company-name";
25
+ import { companyNameExtraWords, groupByCompany, namesDepositaryReceipt, sameCompany, sameListedName, shortCompanyName } from "../tickers/company-name";
24
26
  import {
25
27
  canonicalExchange,
26
28
  exchangeCodeVenues,
@@ -29,6 +31,7 @@ import {
29
31
  isKnownExchangeCode,
30
32
  isSharedExchangeCode,
31
33
  isUsListingExchange,
34
+ usShareClassSpellings,
32
35
  parsePublicTickerKey,
33
36
  publicTickerKey,
34
37
  typedExchangeCode,
@@ -41,7 +44,7 @@ import { dashedCoinPair, exchangeLineCoinListing, isSpotCommodityOrCurrencyPair,
41
44
  import { boardCoinFor, primeBoardCoins } from "./board-coins";
42
45
  import { knownGapMessage } from "./known-gaps";
43
46
  import { currencyPairSpelling } from "../utils/currency-pair";
44
- import { bareFuturesCode, futuresContractByCode } from "../market-data/futures-board";
47
+ import { bareFuturesCode, futuresContractByCode, futuresContractByWord, listedFuturesSymbol } from "../market-data/futures-board";
45
48
  import { classifyInstrumentType, kindFromListingSyntax } from "../tickers/instrument-kind";
46
49
  import type { InstrumentOfKind } from "../tickers/instrument-coverage";
47
50
  import { brokerIndexCode, brokerIndexReadAs } from "./index-roots";
@@ -53,6 +56,7 @@ import {
53
56
  isSearchOnlyVenue,
54
57
  readLondonDottedSymbol,
55
58
  readNearMissListing,
59
+ readVenueFirstListing,
56
60
  readTerminalListingCode,
57
61
  terminalCodeReadAs,
58
62
  unknownBloombergMarket,
@@ -62,6 +66,7 @@ import {
62
66
  import { listingAbroadVenue } from "../utils/sec";
63
67
  import { savedAbroadForBareSymbol, savedUsListingOf } from "../tickers/search/bare-symbol";
64
68
  import { listingSuffixCandidate, listingSuffixVenue, tickerHasListingSuffix } from "../sources/listing-symbols";
69
+ import { isCurrencyPairListing } from "../utils/fx-market-hours";
65
70
  import { coinElsewhereNote, notTheCoinNote } from "./commands/crypto-hints";
66
71
  import { fredSeriesArgument, fredSeriesNotListing } from "../series/fred-argument";
67
72
 
@@ -116,6 +121,11 @@ export interface ListingArg {
116
121
  * became GETYQ. Other bare symbols say where the data service chose instead.
117
122
  */
118
123
  readFromName?: true;
124
+ /**
125
+ * The venue is the one search lists the company's name on (`companyListingArg`), so a quote that answers
126
+ * there is the listing's own, even on a US venue, whose quote answers as whichever one is asked.
127
+ */
128
+ venueFromSearch?: true;
119
129
  }
120
130
 
121
131
  /** "Did you mean JPM (JPMorgan Chase & Co.)?", for a name read as a fund or an index; empty for any other listing. */
@@ -159,10 +169,11 @@ export function parseListingArg(
159
169
  // A pasted ticker can bring the separator or quote marks that sat beside it (`UPST;`); search would ask for them.
160
170
  const stripped = stripStrayEdges(rawArg);
161
171
  const raw = stripped.text || rawArg;
162
- // A terminal's code (WFC.N, "VOD LN", "JPM US Equity") is that listing (WFC:NYSE, VOD:LSE, JPM), and a symbol
163
- // written nearly as one is (700.HK, 6758.JP, BRK/B) its working form (0700.HK, 6758.T, BRK-B).
172
+ // A terminal's code (WFC.N, "VOD LN", "JPM US Equity") is that listing (WFC:NYSE, VOD:LSE, JPM), a symbol
173
+ // written nearly as one is (700.HK, 6758.JP, BRK/B) its working form (0700.HK, 6758.T, BRK-B), and one written
174
+ // venue first, as spreadsheets write it (TYO:7203, LON:LSEG), the symbol on that venue (7203:JPX, LSEG:LSE).
164
175
  const terminal = terminalCode === undefined ? readTerminalListingCode(raw) : terminalCode;
165
- const nearMiss = terminal ? null : readNearMissListing(raw);
176
+ const nearMiss = terminal ? null : readNearMissListing(raw) ?? (typedPerpetualListing(raw) ? null : readVenueFirstListing(raw));
166
177
  const reading = terminal ?? (nearMiss ? { typed: nearMiss.typed, key: nearMiss.symbol } : null);
167
178
  const parsed = parseCleanListingArg(reading?.key ?? raw, exchangeOption, { ownExchangeWins });
168
179
  const listing = listingSuffix ? readListingSuffix(parsed) ?? parsed : parsed;
@@ -215,6 +226,9 @@ function parseCleanListingArg(
215
226
  if (pair && !pair.ambiguous) return { symbol: pair.symbol, exchange: "", key: pair.symbol };
216
227
  const shared = isSharedExchangeCode(code) ? { sharedCode: code } : {};
217
228
  if (exchange) return { symbol: parsed.symbol, exchange, key: `${parsed.symbol}:${exchange}`, ...shared };
229
+ // A contract as CTM prints it is its listing: ETHX26 is ETHX26.CME, CLZ26 is CLZ26.NYM.
230
+ const listed = listedFuturesSymbol(parsed.symbol);
231
+ if (listed) return { symbol: listed, exchange: "", key: listed };
218
232
  // A futures board code no security uses is its future: TTF is TTF=F.
219
233
  const symbol = bareFuturesCode(parsed.symbol)?.symbol ?? parsed.symbol;
220
234
  return { symbol, exchange, key: symbol };
@@ -259,10 +273,11 @@ async function settleSharedCode(listing: ListingArg, deps: ListingDeps): Promise
259
273
  }
260
274
  const { exchange } = reading;
261
275
  const key = `${symbol}:${exchange}`;
262
- const readAs = [
263
- listing.readAs,
264
- exchange === meanings[0] ? null : `Read ${symbol}:${code} as ${key}: ${code} is ${venueChoices(meanings)}, and ${symbol} trades on ${exchange}.`,
265
- ].filter(Boolean).join(" ");
276
+ const why = exchange === meanings[0] ? "." : `: ${code} is ${venueChoices(meanings)}, and ${symbol} trades on ${exchange}.`;
277
+ // Written venue first (TSE:7203), one reading says where it went: "Read TSE:7203 as 7203:JPX: ...".
278
+ const typedAs = ` as ${symbol}:${code}.`;
279
+ const readAs = listing.readAs?.endsWith(typedAs) ? `${listing.readAs.slice(0, -typedAs.length)} as ${key}${why}`
280
+ : [listing.readAs, why === "." ? null : `Read ${symbol}:${code} as ${key}${why}`].filter(Boolean).join(" ");
266
281
  return { symbol, exchange, key, ...readAs ? { readAs } : {} };
267
282
  }
268
283
 
@@ -491,7 +506,8 @@ export async function listCoinNotes(
491
506
  export async function listingChoiceNotes(
492
507
  listing: Pick<CliListing, "symbol" | "exchange" | "saved" | "readAs" | "readFromName">,
493
508
  deps: ListingDeps,
494
- quote: Pick<Quote, "name" | "listingExchangeName" | "exchangeName" | "instrumentType" | "stale" | "delisting"> | null | undefined,
509
+ quote: Pick<Quote, "name" | "listingExchangeName" | "exchangeName" | "instrumentType" | "stale" | "delisting" | "isDepositaryReceipt">
510
+ | null | undefined,
495
511
  /** The venues `loadBareVenues` already started; looked up here when not given. */
496
512
  venues?: Promise<ListingVenue[]> | null,
497
513
  ): Promise<string[]> {
@@ -501,10 +517,19 @@ export async function listingChoiceNotes(
501
517
  if (listing.readFromName) return [...listingReadNotes(listing), ...coin];
502
518
  if (!quote || UNLISTED_TYPES.has(quote.instrumentType?.trim().toUpperCase() ?? "")) return coin;
503
519
  const exchange = canonicalExchange(quote.listingExchangeName || quote.exchangeName);
504
- if (!exchange) return coin;
505
- const listed = await (venues ?? loadBareVenues(listing, deps) ?? []);
520
+ // A bare symbol read on a company's own US line (JPM on NYSE) is what it means: companies abroad sharing the
521
+ // letters are not named. A US receipt (SAN, Banco Santander's) may still be meant for another (Sanofi's SAN:EPA).
522
+ if (!exchange || (isUsListingExchange(exchange) && quote.isDepositaryReceipt !== true)) return coin;
523
+ const [listed, marked] = await Promise.all([
524
+ venues ?? loadBareVenues(listing, deps) ?? [],
525
+ // A primary listing the service names by the word, off the venue picked: NTT is NTT, Inc. (9432 on JPX), not Warsaw's NTT.
526
+ serviceMarkedOtherListing(deps.dataProvider, listing.symbol, exchange).catch(logFailure("cli.listing-arg", "Read the listing a word names failed", null)),
527
+ ]);
506
528
  const note = listingChoiceNote(listing.symbol, { exchange, name: quote.name }, listed);
507
- return [...note ? [note] : [], ...coin];
529
+ const also = marked ? `also ${marked.symbol}:${marked.exchange} ${marked.name}` : null;
530
+ const named = quote.name?.trim() ? `${shortCompanyName(quote.name)}, ` : "";
531
+ const choice = also ? `${note ?? `${listing.symbol} = ${named}${exchangeName(exchange)}`}; ${also}` : note;
532
+ return [...choice ? [choice] : [], ...coin];
508
533
  }
509
534
 
510
535
  /**
@@ -572,8 +597,17 @@ export async function usListingsOnlyMessage(
572
597
  ): Promise<{ message: string; details: string }> {
573
598
  const quote = await loadListingQuote(deps.dataProvider, listing);
574
599
  const company = listingIdentity(listing, quote).name;
575
- const named = company ? `${shortCompanyName(company)} on ${exchangeLabel(listing.exchange)}` : exchangeLabel(listing.exchange);
576
- const us = await usListingOfCompany(listing, company, deps);
600
+ // A listing read from its vendor suffix (7203.T) or its quote has no venue typed: it is the one its quote is from.
601
+ const venue = canonicalExchange(listing.exchange || quote?.listingExchangeName || quote?.exchangeName || "");
602
+ const suffix = listing.exchange ? null : listingSuffixCandidate(listing.symbol);
603
+ const local = { symbol: suffix && canonicalExchange(suffix.exchange) === venue ? suffix.symbol : listing.symbol, exchange: venue };
604
+ // A currency pair has no listing anywhere: say what it is, never "GBP/USD on ." or the code of a venue.
605
+ if (isCurrencyPairListing(listing.symbol, venue)) {
606
+ return { message: `${what} covers US listings only, and ${listing.key} is a currency pair.`, details: "A currency pair trades over the counter, with no exchange volume to follow." };
607
+ }
608
+ const where = venue ? exchangeLabel(venue) : "";
609
+ const named = company ? `${shortCompanyName(company)}${where ? ` on ${where}` : ""}` : where || "not a US listing";
610
+ const us = await usListingOfCompany(local, company, deps);
577
611
  const owner = company ? shortCompanyName(company) : listing.key;
578
612
  const command = us ? retry(us.symbol) : null;
579
613
  return {
@@ -629,8 +663,9 @@ function retryCommand(request: Pick<ListingDataRequest, "command" | "retry">, ke
629
663
  * code a security keeps (GC, NG) when that security has no data: the future is
630
664
  * the other thing the code names. Null for any other symbol.
631
665
  */
632
- export function futuresTryLine(symbol: string, request: ListingDataRequest): string | null {
633
- const future = futuresContractByCode(symbol);
666
+ export function futuresTryLine(symbol: string, request: ListingDataRequest, { words = false }: { words?: boolean } = {}): string | null {
667
+ // With `words`, a commodity's word (BRENT, GOLD) names its future too, beside the securities that share it.
668
+ const future = futuresContractByCode(symbol) ?? (words ? futuresContractByWord(symbol) : null);
634
669
  if (!future) return null;
635
670
  const retry = retryCommand(request, future.symbol);
636
671
  return `${future.symbol} ${future.name} future${retry ? ` (try: ${retry})` : ""}`;
@@ -648,7 +683,8 @@ function describeOtherListings(
648
683
  /** Listings just asked that had none: named as having none, never offered to try. */
649
684
  without: readonly ListingVenue[] = [],
650
685
  ): OtherListingsMessage | null {
651
- const future = futuresTryLine(listing.symbol, request);
686
+ // BRENT's listings are two ETPs: Brent crude itself is the future BZ=F, offered beside them.
687
+ const future = futuresTryLine(listing.symbol, request, { words: true });
652
688
  const offered = others.filter((venue) => !without.includes(venue));
653
689
  if (offered.length === 0 && !future && without.length === 0) return null;
654
690
  const name = resolved?.name || listing.saved?.metadata.name?.trim() || "";
@@ -675,7 +711,7 @@ function describeOtherListings(
675
711
  : `${listing.symbol} resolved to ${name ? `${name} (${exchange})` : exchange}, which has no ${request.noun}.`,
676
712
  details,
677
713
  heading,
678
- listings: [...named.map((venue) => venueKey(listing.symbol, venue)), ...future ? [futuresContractByCode(listing.symbol)!.symbol] : []],
714
+ listings: [...named.map((venue) => venueKey(listing.symbol, venue)), ...future ? [(futuresContractByCode(listing.symbol) ?? futuresContractByWord(listing.symbol))!.symbol] : []],
679
715
  choices: offered.slice(0, MAX_OTHER_LISTINGS).map((venue) => ({ key: venueKey(listing.symbol, venue), name: venue.name || null })),
680
716
  choose,
681
717
  };
@@ -1031,6 +1067,17 @@ type ListingForLoad = Pick<ListingArg, "symbol" | "exchange"> & Partial<Pick<Cli
1031
1067
 
1032
1068
  /** The saved ticker for a listing: under its own key, or a saved symbol whose venue it is. */
1033
1069
  export async function loadSavedListing(store: ListingStore, listing: ListingArg): Promise<TickerRecord | null> {
1070
+ const saved = await loadSavedSpelling(store, listing);
1071
+ // A US share class is one row whichever spelling saved it (BRK.B, BRK-B).
1072
+ const spellings = saved || listing.sharedCode ? null : usShareClassSpellings(listing.symbol, listing.exchange);
1073
+ for (const symbol of spellings?.filter((spelling) => spelling !== listing.symbol) ?? []) {
1074
+ const other = await loadSavedSpelling(store, { ...listing, symbol, key: listing.exchange ? `${symbol}:${listing.exchange}` : symbol });
1075
+ if (other) return other;
1076
+ }
1077
+ return saved;
1078
+ }
1079
+
1080
+ async function loadSavedSpelling(store: ListingStore, listing: ListingArg): Promise<TickerRecord | null> {
1034
1081
  if (!listing.exchange) return store.loadTicker(listing.symbol);
1035
1082
  if (listing.sharedCode) {
1036
1083
  // 7203:TSE is the row saved on any venue TSE names.
@@ -1181,6 +1228,27 @@ async function readVenueSuffix(listing: ListingArg, deps: Pick<ListingDeps, "dat
1181
1228
  return { symbol: match[1]!, exchange: venue, key, readAs: `Read ${listing.symbol} as ${key}.` };
1182
1229
  }
1183
1230
 
1231
+ /** One to three digits: a Hong Kong code written without its leading zeros (700, 5, 388). */
1232
+ const SHORT_HONG_KONG_CODE = /^\d{1,3}$/;
1233
+
1234
+ /**
1235
+ * A Hong Kong code written without its leading zeros as its HKEX listing,
1236
+ * "Read 700 as 0700:HKEX.", where search marks that listing with the code as
1237
+ * typed (`searchAliases`) as it does for 700 and 5. A row saved under the
1238
+ * code keeps it. Null for any other symbol, and when search marks no HKEX
1239
+ * listing with it, cannot search or is too busy to say.
1240
+ */
1241
+ async function readHongKongShortCode(listing: ListingArg, deps: ListingDeps): Promise<ListingArg | null> {
1242
+ if (listing.exchange || !SHORT_HONG_KONG_CODE.test(listing.symbol) || !Number(listing.symbol)) return null;
1243
+ if (await deps.store.loadTicker(listing.symbol)) return null;
1244
+ const symbol = String(Number(listing.symbol)).padStart(4, "0");
1245
+ const marked = await serviceMarkedListing(deps.dataProvider, listing.symbol, symbol);
1246
+ if (marked?.exchange !== "HKEX") return null;
1247
+ const key = `${symbol}:HKEX`;
1248
+ const readAs = [listing.readAs, `Read ${listing.symbol} as ${key}.`].filter(Boolean).join(" ");
1249
+ return { symbol, exchange: "HKEX", key, readAs };
1250
+ }
1251
+
1184
1252
  /** 7203.T as 7203:JPX when a row of 7203 on JPX is saved: a suffix `readListingSuffix` leaves to be confirmed. Null otherwise. */
1185
1253
  async function savedSuffixVenue(listing: ListingArg, store: ListingStore): Promise<ListingArg | null> {
1186
1254
  const venue = listing.exchange ? null : listingSuffixCandidate(listing.symbol);
@@ -1237,6 +1305,9 @@ export async function resolveCliListing(
1237
1305
  // USD-NGN and USDNGN are the pair USDNGN=X unless a security is listed under those letters.
1238
1306
  const pair = parsed.exchange ? null : await readAmbiguousCurrencyPair(parsed.symbol, deps);
1239
1307
  if (pair) parsed = { symbol: pair, exchange: "", key: pair };
1308
+ // 700 is how Hong Kong writes Tencent's 0700, and search reads it so.
1309
+ const hongKong = pair || named || index ? null : await readHongKongShortCode(parsed, deps);
1310
+ if (hongKong) parsed = hongKong;
1240
1311
  // 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.
1241
1312
  const venueRow = options.listingSuffix && !pair && !named ? await savedSuffixVenue(parsed, deps.store) : null;
1242
1313
  if (venueRow) parsed = venueRow;
@@ -1403,6 +1474,39 @@ export async function serviceNamedCompany(typed: string, deps: Pick<ListingDeps,
1403
1474
  return companyListingArg(typed, found);
1404
1475
  }
1405
1476
 
1477
+ /** A word written as a company's name is (`Aeon`, `Panasonic`): a capital, then small letters, never a ticker's capitals. */
1478
+ const TITLE_CASE_WORD = /^\p{Lu}\p{Ll}[\p{L}&'’.-]*$/u;
1479
+
1480
+ /** Whether a word is written as a company's name is (`Aeon`), never as a ticker is (`AEON`, `aeon`). */
1481
+ export function isTitleCaseWord(text: string): boolean {
1482
+ return TITLE_CASE_WORD.test(text.trim());
1483
+ }
1484
+
1485
+ /**
1486
+ * A word written as a company's name (`Aeon`, not `AEON` or `aeon`) that is
1487
+ * also a ticker, read as the company named exactly that word whose home line
1488
+ * the service marks, when the ticker's company is named more than the word:
1489
+ * "Aeon" in a pasted book is Aeon Co., Ltd. (8267:JPX), not AEON Biopharma,
1490
+ * whose ticker it is ("Read "Aeon" as 8267:JPX (Aeon Co., Ltd.); the ticker
1491
+ * AEON is AEON Biopharma, Inc."). A word in capitals stays the ticker, and
1492
+ * so does one whose ticker's company bears the name (`Snap` is Snap Inc.).
1493
+ * Null otherwise, and when search names no such company or is too busy to say.
1494
+ */
1495
+ export async function titleCaseCompanyName(
1496
+ typed: string,
1497
+ ticker: { symbol: string; name: string | null | undefined },
1498
+ deps: Pick<ListingDeps, "dataProvider">,
1499
+ ): Promise<ListingArg | null> {
1500
+ const word = typed.trim();
1501
+ if (!TITLE_CASE_WORD.test(word) || companyNameExtraWords(word, ticker.name) === 0) return null;
1502
+ const found = await findOneWordCompany(word, deps);
1503
+ if (!found?.home || found.moved || companyNameExtraWords(word, found.name) !== 0) return null;
1504
+ const listing = companyListingArg(word, found);
1505
+ if (listing.key.toUpperCase() === ticker.symbol.toUpperCase()) return null;
1506
+ const owner = ticker.name?.trim().replace(/\.$/, "") || "another company";
1507
+ return { ...listing, readAs: `${listing.readAs!.replace(/\.$/, "")}; the ticker ${ticker.symbol.toUpperCase()} is ${owner}.` };
1508
+ }
1509
+
1406
1510
  /** The company `oneWordCompanyName` reads a word as, before it is read as a listing. */
1407
1511
  async function findOneWordCompany(typed: string, deps: Pick<ListingDeps, "dataProvider">): Promise<CompanyNameListing | null> {
1408
1512
  const word = typed.trim();
@@ -1470,7 +1574,7 @@ function companyListingArg(typed: string, found: CompanyNameListing): ListingArg
1470
1574
  const moved = found.moved ? ` ${found.moved}.` : "";
1471
1575
  return {
1472
1576
  ...parseListingArg(key), readAs: `Read "${typed.trim()}" as ${key} (${found.name}).${moved}${question}`,
1473
- ...meant ? { meant } : {}, ...found.exchange ? {} : { readFromName: true as const },
1577
+ ...meant ? { meant } : {}, ...found.exchange ? { venueFromSearch: true as const } : { readFromName: true as const },
1474
1578
  };
1475
1579
  }
1476
1580
 
@@ -1,6 +1,8 @@
1
1
  import { logFailure } from "../utils/log-failure";
2
2
  import type { DataProvider } from "../types/data-provider";
3
- import { findListingOfCompanyName, isCompanyNameInput, readTerminalCodeArg } from "../tickers/company-name-listing";
3
+ import { companyNameQueries, findListingOfCompanyName, isCompanyNameInput, readTerminalCodeArg, settledTerminalCode } from "../tickers/company-name-listing";
4
+ import { batchedListLookups } from "../tickers/batched-lookups";
5
+ import { mapWithConcurrency } from "../utils/concurrency";
4
6
  import { isNotATickerMessage } from "./not-a-ticker";
5
7
  import { splitSymbolWords } from "./symbol-args";
6
8
  import { isNumberCell } from "./symbol-cells";
@@ -24,9 +26,25 @@ import { unknownBloombergMarket } from "../tickers/terminal-codes";
24
26
  */
25
27
  export async function readNameEntries(
26
28
  entries: readonly string[],
27
- dataProvider: Pick<DataProvider, "search"> & Partial<Pick<DataProvider, "getQuotesBatch" | "getQuote">>,
29
+ source: Pick<DataProvider, "search"> & Partial<Pick<DataProvider, "getQuotesBatch" | "getQuote">>,
28
30
  ): Promise<string[]> {
29
- const read = await Promise.all(entries.map(async (entry) => {
31
+ return (await readNameEntryGroups(entries, source)).flat();
32
+ }
33
+
34
+ /** `readNameEntries`, entry by entry: what each entry reads as, in the order given, for a reader that keeps each entry's reading. */
35
+ export async function readNameEntryGroups(
36
+ entries: readonly string[],
37
+ source: Pick<DataProvider, "search"> & Partial<Pick<DataProvider, "getQuotesBatch" | "getQuote">>,
38
+ ): Promise<string[][]> {
39
+ // A pasted list's names are searched in batches and their quotes asked together, a few entries at a time: a list
40
+ // of hundreds of names is a few requests, never hundreds at once.
41
+ // A terminal's code abroad (`VOD LN`) is its listing as written: nothing searches for it as a name.
42
+ const names = entries.filter((entry) => isCompanyNameInput(entry) && !unknownBloombergMarket(entry) && !settledTerminalCode(entry));
43
+ const full = source as DataProvider;
44
+ const dataProvider = names.length > 1 && full.searchBatch
45
+ ? (await batchedListLookups(full, names.map((name) => ({ searches: companyNameQueries(name), changes: null })))).dataProvider
46
+ : source;
47
+ const read = await mapWithConcurrency(entries, NAME_LOOKUPS_AT_ONCE, async (entry) => {
30
48
  // A terminal's code for a listing ("JPM US Equity", "VOD LN") is one entry, like a company's name, and so is a
31
49
  // line written as one whose market code is unknown ("AAPL GP"): its lookup refuses it, never AAPL and GP.
32
50
  if (unknownBloombergMarket(entry) || await readTerminalCodeArg(dataProvider, entry)) return [entry];
@@ -36,10 +54,13 @@ export async function readNameEntries(
36
54
  if (named && !busy) return [entry];
37
55
  const words = splitSymbolWords([entry]);
38
56
  return await wordsAreSymbols(words, dataProvider, { quoteEvery: busy }) ? words : [entry];
39
- }));
40
- return read.flat();
57
+ });
58
+ return read;
41
59
  }
42
60
 
61
+ /** Entries of a list read at once: their quotes still go out together, gathered into batches. */
62
+ const NAME_LOOKUPS_AT_ONCE = 16;
63
+
43
64
  /** A word typed as a ticker is: in capitals (AAPL, 7203.T), with a venue or class mark (brk.b, bf-b, SAN:EPA), or after a $. */
44
65
  function writtenAsSymbol(word: string): boolean {
45
66
  return /^\$|[:.\-/=^]/.test(word) || /\d/.test(word) || (/\p{Lu}/u.test(word) && !/\p{Ll}/u.test(word));
@@ -1,3 +1,4 @@
1
+ import { futuresContractByWord } from "../market-data/futures-board";
1
2
  import { notATickerSymbol } from "../sources/provider-errors";
2
3
  import { boardCoinFor } from "./board-coins";
3
4
  import { currencyNameHint } from "./currency-name-hint";
@@ -54,8 +55,11 @@ export function withSearchHints(text: string, args: readonly string[], isFredSer
54
55
  const coin = boardCoinFor(id);
55
56
  if (coin) return `${sentence} Did you mean ${coin.symbol}${coin.name && coin.name.toUpperCase() !== coin.symbol ? ` (${coin.name})` : ""}?`;
56
57
  const tenor = treasuryYieldTenor(typed);
57
- // A currency's name (`yen`) is its rate and its pair, not a ticker search could find.
58
- return `${sentence} ${tenor ? treasuryYieldHint(tenor) : currencyNameHint(typed) ?? searchHint(typed)}`;
58
+ // A currency's name (`yen`) is its rate and its pair, not a ticker search could find; a commodity's word
59
+ // (`oil`, `brent`) is its future, which no search for the word finds first.
60
+ const future = futuresContractByWord(id);
61
+ const commodity = future ? `For ${future.name}, quote the future ${future.symbol}.` : null;
62
+ return `${sentence} ${tenor ? treasuryYieldHint(tenor) : currencyNameHint(typed) ?? commodity ?? searchHint(typed)}`;
59
63
  })
60
64
  : named;
61
65
  }
@@ -6,6 +6,7 @@ import type {
6
6
  PaneDef,
7
7
  PaneTemplateDef,
8
8
  } from "../../types/plugin";
9
+ import { spreadsheetOptionHint } from "../spreadsheet-hint";
9
10
 
10
11
  export type PaneFunctionReadiness = "ready" | "partial" | "live-dom" | "unsupported";
11
12
  type PaneFunctionScreenshotReadiness = PaneFunctionReadiness;
@@ -294,6 +295,14 @@ function normalizeOptionValue(
294
295
  return rawValue;
295
296
  }
296
297
 
298
+ /** A function's argument and options as they were typed (`^HSI,^TNX --range 1Y`), for a pointer to name the command. */
299
+ function typedFunctionArgs(argument: string | null | undefined, options: Record<string, string | true>): string[] {
300
+ return [
301
+ ...argument?.trim() ? [argument.trim()] : [],
302
+ ...Object.entries(options).flatMap(([key, value]) => value === true ? [optionFlag(key)] : [optionFlag(key), value]),
303
+ ];
304
+ }
305
+
297
306
  export function normalizeCapabilityOptions(
298
307
  capability: PaneFunctionCapability,
299
308
  options: Record<string, string | true>,
@@ -327,7 +336,9 @@ export function normalizeCapabilityOptions(
327
336
  }
328
337
  const supported = capability.options.map(({ key }) => optionFlag(key)).join(", ");
329
338
  throw new Error(
330
- `${settings.code ?? capability.id} does not support ${optionFlag(rawKey)}.${supported ? ` Supported options: ${supported}.` : " It has no options."}`,
339
+ [`${settings.code ?? capability.id} does not support ${optionFlag(rawKey)}.${supported ? ` Supported options: ${supported}.` : " It has no options."}`,
340
+ spreadsheetOptionHint(optionFlag(rawKey), `fn ${settings.code ?? capability.id}`, typedFunctionArgs(settings.argument, options))]
341
+ .filter(Boolean).join(" "),
331
342
  );
332
343
  }
333
344
  normalized[option.key] = normalizeOptionValue(option, rawValue, settings.argument);
@@ -32,6 +32,7 @@ import {
32
32
  import { renderGlossaryEntries, type GlossaryLookup } from "../glossary";
33
33
  import { renderSeriesMatches, type SeriesMatch } from "../series-search";
34
34
  import { typoDistance } from "../../utils/typo-distance";
35
+ import { FUNCTION_HELP } from "./function-help";
35
36
  import { quotedSearchCommand } from "../commands/news-search";
36
37
 
37
38
  /**
@@ -650,6 +651,15 @@ function readinessCell(readiness: PaneFunctionReadiness): string {
650
651
  return cliStyles.muted(label);
651
652
  }
652
653
 
654
+ /**
655
+ * How its report reads, and `Pro` after it for a function only Gloom Pro opens (CALLS), which a signed-out or free
656
+ * run reads locked. A free preview of the same data (PERP) is not marked: free runs read it.
657
+ */
658
+ function reportCell(entry: PaneCatalogEntry): string {
659
+ const readiness = readinessCell(entry.capability.reportReadiness);
660
+ return FUNCTION_HELP[entry.token]?.access === "pro" ? `${readiness} · ${cliStyles.warning("Pro")}` : readiness;
661
+ }
662
+
653
663
  function optionDescription(option: PaneFunctionOptionDef): string {
654
664
  const choices = optionChoices(option);
655
665
  const parts = [option.description.replace(/\.$/, "")];
@@ -700,7 +710,7 @@ function renderCatalogEntry(entry: PaneCatalogEntry): string {
700
710
  ];
701
711
  const stats: CliStatEntry[] = [
702
712
  ["Argument", argument || cliStyles.muted("none")],
703
- ["Report", readinessCell(capability.reportReadiness)],
713
+ ["Report", reportCell(entry)],
704
714
  ["Screenshot", readinessCell(capability.screenshotReadiness)],
705
715
  ["Bot safe", capability.botSafe ? "yes" : "no"],
706
716
  ["Pane", entry.paneId],
@@ -760,7 +770,7 @@ function renderMatchesTable(shown: readonly PaneCatalogEntry[]): string {
760
770
  cliStyles.command(entry.token),
761
771
  entry.label,
762
772
  argumentHint(entry),
763
- readinessCell(entry.capability.reportReadiness),
773
+ reportCell(entry),
764
774
  entry.description,
765
775
  ]),
766
776
  );
@@ -70,7 +70,7 @@ function proseLines(render: PaneScreenshotResult["render"], title: string): stri
70
70
  }
71
71
 
72
72
  function rowsContainEllipsis(rows: DesktopPaneShotRenderedRow[]): boolean {
73
- return rows.some((row) => row.cells.some((cell) => /\u2026|\.\.\./.test(cell.text)));
73
+ return rows.some((row) => row.cells.some((cell) => !cell.reportOnly && /\u2026|\.\.\./.test(cell.text)));
74
74
  }
75
75
 
76
76
  /** Column identity per cell; a repeated label within one row stays distinct. */
@@ -148,7 +148,9 @@ function domTableTitle(table: DomTable): string {
148
148
  }
149
149
 
150
150
  function renderDomTables(rows: DesktopPaneShotRenderedRow[]): string[] {
151
- const tables = domTables(rows);
151
+ // A column only the JSON and CSV carry is no part of the text.
152
+ const tables = domTables(rows.map((row) => row.cells.some((cell) => cell.reportOnly)
153
+ ? { ...row, cells: row.cells.filter((cell) => !cell.reportOnly) } : row));
152
154
  return tables.flatMap((table, index) => [
153
155
  ...(index > 0 ? [""] : []),
154
156
  ...(tables.length > 1 ? [renderSection(domTableTitle(table))] : []),
@@ -19,6 +19,8 @@ const FUNCTION_DOCS_URL = "https://gloom.sh/docs/functions";
19
19
  export interface FunctionHelpKey {
20
20
  key: string;
21
21
  label: string;
22
+ /** The action's name, as its footer hint gives it, when the label is a whole word after a letter key. */
23
+ title?: string;
22
24
  }
23
25
 
24
26
  /** A function Free cannot fully open: Pro only, or a limited preview on Free. */
@@ -58,7 +60,7 @@ export function functionDocsUrl(code: string): string {
58
60
  return anchor ? `${FUNCTION_DOCS_URL}#${anchor}` : FUNCTION_DOCS_URL;
59
61
  }
60
62
 
61
- const key = (hotkey: string, label: string): FunctionHelpKey => ({ key: hotkey, label });
63
+ const key = (hotkey: string, label: string, title?: string): FunctionHelpKey => (title ? { key: hotkey, label, title } : { key: hotkey, label });
62
64
  const same = (value: string): FunctionFreshness => ({ free: value, pro: value });
63
65
 
64
66
  const DELAYED = "15 minutes delayed";
@@ -98,8 +100,9 @@ const CHART_KEYS = [key("s", "eries"), key("i", "ndicators"), key("b", "ars"), k
98
100
  export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
99
101
  // Research companies
100
102
  DES: {
101
- summary: "The starting point for any ticker: live quote, day and 52-week range, price chart, fundamentals, and tabs into every other research pane.",
102
- usage: ["DES NVDA"],
103
+ summary: "The starting point for any ticker: live quote, day and 52-week range, price chart, fundamentals, and tabs into every other research pane. "
104
+ + "A bond fund shows its SEC yield, yield to worst and duration beside its distribution yield; --tax-rate 40.8 adds a muni fund's tax-equivalent yield and muni/Treasury ratio.",
105
+ usage: ["DES NVDA", "DES MUB --tax-rate 40.8"],
103
106
  keys: [TABS, key(".", " go to tab")],
104
107
  data: QUOTES,
105
108
  bloomberg: ["DES"],
@@ -242,7 +245,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
242
245
  + "Grades: Value, Growth, Profitability, Momentum and Revisions, F to A+, each ranked within the sector, and their equal-weighted 1-5 composite labelled Top, Strong, Neutral, Weak or Bottom. "
243
246
  + "Ideas holds ready technical screens, Value, Quality and GARP, screens on the classic scores and Top grades. The pane menu saves the matches to a watchlist.",
244
247
  usage: ["EQS", "gloom fn EQS --preset golden-cross", "gloom fn EQS --preset quality", "gloom fn EQS --preset magic-formula", "gloom fn EQS --preset top-grades"],
245
- keys: [key("a", "dd criterion"), key("m", "etric"), key("t", "check ticker"), key("s", "ave screen"), key("o", "pen research")],
248
+ keys: [key("a", "dd criterion"), key("m", "etric"), key("t", "check ticker", "Check ticker"), key("s", "ave screen"), key("o", "pen research")],
246
249
  data: same("Daily snapshot, statements as filed"),
247
250
  bloomberg: ["EQS"],
248
251
  },
@@ -423,8 +426,9 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
423
426
  summary: "Cash distributions, trailing yield, the forward yield fundamentals show (the latest distribution annualized, or the declared one once announced), and payout growth. Future payments are not forecast. "
424
427
  + "For a bond fund these are distribution yields, not its SEC yield, which follows them with its date, yield to worst and duration. "
425
428
  + "--tax-rate 40.8 adds a muni fund's tax-equivalent yield, yield / (1 - (federal + state rate)) on the SEC yield (else the distribution yield), "
426
- + "and its muni/Treasury ratio against the GC tenor nearest its duration; --state-rate 13.3 --state CA counts only for a CA fund.",
427
- usage: ["DVD KO", "DVD MUB --tax-rate 40.8", "DVD CMF --tax-rate 40.8 --state-rate 13.3 --state CA"],
429
+ + "and its muni/Treasury ratio against the GC tenor nearest its duration; --state-rate 13.3 --state CA counts only for a CA fund. "
430
+ + "Several tickers rank in one table; with --tax-rate it adds yield to worst, duration, the tax-equivalent yield and the ratio.",
431
+ usage: ["DVD KO", "DVD MUB --tax-rate 40.8", "DVD CMF --tax-rate 40.8 --state-rate 13.3 --state CA", "DVD MUB VTEB SUB LQD --tax-rate 40.8"],
428
432
  keys: [STEP],
429
433
  data: same("Daily"),
430
434
  bloomberg: ["DVD"],
@@ -639,8 +643,8 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
639
643
  bloomberg: ["QR"],
640
644
  },
641
645
  BUZZ: {
642
- summary: "Daily posts on X naming the ticker's cashtag, the day's top posts and their stance.",
643
- usage: ["BUZZ TSLA"],
646
+ summary: "Daily posts on X naming the ticker's cashtag, the day's top posts and their stance. Alone it ranks the tickers by how far their posts jump above their own 30-day median, on the latest closed day or today so far, with stance and price move, filtered by posts and market cap.",
647
+ usage: ["BUZZ TSLA", "BUZZ"],
644
648
  keys: [OPEN, OPEN_SOURCE],
645
649
  data: same("Through the day"),
646
650
  bloomberg: [],
@@ -1082,8 +1086,9 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
1082
1086
  bloomberg: ["CF"],
1083
1087
  },
1084
1088
  ETF: {
1085
- summary: "A US-listed fund's facts, a leveraged or inverse fund's daily objective among them, then its own SEC filings: registration statements and prospectus updates, shareholder reports, N-CEN and N-PORT reports. Open any of them inline.",
1086
- usage: ["ETF SPY"],
1089
+ summary: "A US-listed fund's facts, a leveraged or inverse fund's daily objective and a bond fund's SEC yield, yield to worst and duration among them, then its own SEC filings: registration statements and prospectus updates, shareholder reports, N-CEN and N-PORT reports. Open any of them inline. "
1090
+ + "--tax-rate 40.8 adds a muni fund's tax-equivalent yield and muni/Treasury ratio, as DVD does.",
1091
+ usage: ["ETF SPY", "ETF MUB --tax-rate 40.8"],
1087
1092
  keys: [OPEN, OPEN_SOURCE],
1088
1093
  data: AS_FILED,
1089
1094
  bloomberg: [],
@@ -1165,7 +1170,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
1165
1170
  ALRT: {
1166
1171
  summary: "Your price alerts with current price, distance to target and trigger state, plus alerts on earnings, CPI and FOMC dates, filings and 13F, news keywords, analyst changes, 52-week highs and lows, unusual volume, short interest, insider and congress trades, catalysts, IV spikes, options flow and perps.",
1167
1172
  usage: ["ALRT"],
1168
- keys: [key("a", "dd alert"), key("e", "dit"), key("d", "elete"), key("m", "re-arm")],
1173
+ keys: [key("a", "dd alert"), key("e", "dit"), key("d", "elete"), key("m", "re-arm", "Re-arm")],
1169
1174
  data: QUOTES,
1170
1175
  bloomberg: ["ALRT"],
1171
1176
  },
@@ -1465,4 +1470,11 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
1465
1470
  data: null,
1466
1471
  bloomberg: [],
1467
1472
  },
1473
+ QUIT: {
1474
+ summary: "Quit Gloom from the command bar. EXIT does too; the browser app, which cannot close its tab, does not list it.",
1475
+ usage: ["QUIT"],
1476
+ keys: [],
1477
+ data: null,
1478
+ bloomberg: [],
1479
+ },
1468
1480
  };
@@ -745,21 +745,24 @@ function textNotices(result: HeadlessPaneResult): string[] {
745
745
 
746
746
  /**
747
747
  * What each row of a table is of, from the fields its report names
748
- * (`rowUnitKey`, `rowSymbolKey`, `rowAsOfKey`); undefined when it names none.
749
- * An as-of may be an ISO date or instant, or epoch milliseconds.
748
+ * (`rowUnitKey`, `rowSymbolKey`, `rowAsOfKey`, `rowIntervalKey`,
749
+ * `rowSourceKey`); undefined when it names none. An as-of may be an ISO date
750
+ * or instant, or epoch milliseconds.
750
751
  */
751
752
  function rowIdentitiesOf(
752
753
  rows: readonly HeadlessPaneRow[],
753
- keys: { rowUnitKey?: string; rowSymbolKey?: string; rowAsOfKey?: string },
754
+ keys: { rowUnitKey?: string; rowSymbolKey?: string; rowAsOfKey?: string; rowIntervalKey?: string; rowSourceKey?: string },
754
755
  ): ExportIdentity[] | undefined {
755
- const { rowUnitKey: unitKey, rowSymbolKey: symbolKey, rowAsOfKey: asOfKey } = keys;
756
- if (!unitKey && !symbolKey && !asOfKey) return undefined;
756
+ const { rowUnitKey: unitKey, rowSymbolKey: symbolKey, rowAsOfKey: asOfKey, rowIntervalKey: intervalKey, rowSourceKey: sourceKey } = keys;
757
+ if (!unitKey && !symbolKey && !asOfKey && !intervalKey && !sourceKey) return undefined;
757
758
  const text = (value: unknown) => (typeof value === "string" ? value : null);
758
759
  const instant = (value: unknown) => typeof value === "number" && Number.isFinite(value) ? new Date(value).toISOString() : text(value);
759
760
  return rows.map((row) => ({
760
761
  ...(unitKey ? { currencyOrUnit: text(row[unitKey]) } : {}),
761
762
  ...(symbolKey ? { symbolOrSeries: text(row[symbolKey]) } : {}),
762
763
  ...(asOfKey ? { asOf: instant(row[asOfKey]) } : {}),
764
+ ...(intervalKey ? { interval: text(row[intervalKey]) } : {}),
765
+ ...(sourceKey ? { source: text(row[sourceKey]) } : {}),
763
766
  }));
764
767
  }
765
768
 
@@ -812,7 +815,9 @@ export function headlessReportTables(
812
815
  // A line of its own period or release (a previous reading) names them rather than the section's.
813
816
  const own = (entry: HeadlessPaneEntry): ExportIdentity | undefined => {
814
817
  const identity = {
815
- ...(entry.unit?.trim() ? { currencyOrUnit: entry.unit.trim() } : {}),
818
+ // An export unit names a number's unit: a figure missing with its reason has none.
819
+ ...(entry.unit?.trim() ? { currencyOrUnit: entry.unit.trim() }
820
+ : entry.exportUnit?.trim() && typeof entry.value === "number" && Number.isFinite(entry.value) ? { currencyOrUnit: entry.exportUnit.trim() } : {}),
816
821
  ...(entry.period !== undefined ? { period: entry.period } : {}),
817
822
  ...(entry.released !== undefined ? { released: entry.released } : {}),
818
823
  ...(entry.asOf !== undefined ? { asOf: entry.asOf } : {}),