gloomberb 0.19.4 → 0.19.6

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 (321) hide show
  1. package/package.json +3 -1
  2. package/patches/@opentui%2Fcore@0.3.2.patch +86 -25
  3. package/src/api-client/equity-screener.ts +23 -0
  4. package/src/app/pane-runtime/index.tsx +2 -0
  5. package/src/app/pane-runtime/plugin-bindings.ts +10 -1
  6. package/src/app.tsx +63 -16
  7. package/src/cli/commands/command-utils.ts +4 -0
  8. package/src/cli/commands/market.ts +264 -33
  9. package/src/cli/commands/search.ts +22 -4
  10. package/src/cli/commands/ticker.ts +84 -39
  11. package/src/cli/currency-name-hint.ts +60 -0
  12. package/src/cli/glossary.ts +3 -3
  13. package/src/cli/history-rows.ts +18 -1
  14. package/src/cli/known-gaps.ts +25 -2
  15. package/src/cli/listing-arg.ts +12 -0
  16. package/src/cli/not-a-ticker.ts +5 -3
  17. package/src/cli/pane-functions/capabilities.ts +2 -0
  18. package/src/cli/pane-functions/catalog.ts +31 -5
  19. package/src/cli/pane-functions/function-help.ts +8 -5
  20. package/src/cli/pane-functions/headless.ts +11 -6
  21. package/src/cli/pane-functions/market-session.ts +6 -7
  22. package/src/cli/pane-functions/resolver.ts +75 -2
  23. package/src/cli/quote-answer.ts +9 -0
  24. package/src/cli/series-search.ts +4 -5
  25. package/src/cli/symbol-list.ts +54 -2
  26. package/src/cli/symbol-rows.ts +14 -2
  27. package/src/cli/ticker-resolution.ts +89 -20
  28. package/src/components/chart/composite/axis-overlays.tsx +60 -27
  29. package/src/components/chart/composite/composite-chart.tsx +118 -63
  30. package/src/components/chart/composite/cursor-source.ts +111 -0
  31. package/src/components/chart/composite/format.ts +168 -6
  32. package/src/components/chart/composite/legend.tsx +8 -4
  33. package/src/components/chart/composite/panel-bitmap.ts +28 -2
  34. package/src/components/chart/composite/panel-labels.ts +20 -1
  35. package/src/components/chart/composite/panel-surface.tsx +201 -92
  36. package/src/components/chart/composite/price-axis-labels.tsx +92 -46
  37. package/src/components/chart/composite/price-series.ts +31 -8
  38. package/src/components/chart/composite/scene.ts +154 -59
  39. package/src/components/chart/composite/series-axis-tags.tsx +4 -2
  40. package/src/components/chart/composite/time-axis.ts +30 -7
  41. package/src/components/chart/composite/time-scale.ts +211 -56
  42. package/src/components/chart/composite/types.ts +11 -1
  43. package/src/components/chart/composite/use-composite-chart-keyboard.ts +32 -12
  44. package/src/components/chart/curve/curve-surface.tsx +5 -2
  45. package/src/components/chart/curve/model.ts +4 -1
  46. package/src/components/chart/native/use-bitmap-metrics.ts +81 -0
  47. package/src/components/chart/static/series.ts +3 -0
  48. package/src/components/command-bar/commands/collection-list.ts +81 -0
  49. package/src/components/command-bar/commands/direct/index.ts +6 -0
  50. package/src/components/command-bar/commands/registry.ts +8 -0
  51. package/src/components/command-bar/layout-items/current-layout.ts +22 -1
  52. package/src/components/command-bar/layout-items/focused-pane.ts +22 -1
  53. package/src/components/command-bar/pane-templates/items.ts +19 -3
  54. package/src/components/command-bar/pane-templates/workflow.ts +5 -0
  55. package/src/components/command-bar/routes/root/results.ts +23 -3
  56. package/src/components/command-bar/routes/root/selection.ts +4 -2
  57. package/src/components/command-bar/routes/root/shortcut-feedback.ts +1 -1
  58. package/src/components/command-bar/routes/root/shortcut-items.ts +3 -4
  59. package/src/components/command-bar/routes/root/shortcuts.ts +58 -14
  60. package/src/components/command-bar/routes/root/ticker-first.ts +32 -0
  61. package/src/components/command-bar/surface/environment.ts +2 -0
  62. package/src/components/command-bar/view-model.ts +7 -0
  63. package/src/components/command-bar/workflow/ops.ts +2 -1
  64. package/src/components/command-bar/workflow/tickers.ts +20 -0
  65. package/src/components/layout/shell/active-drag.ts +38 -7
  66. package/src/components/layout/shell/drag/magnets.ts +106 -0
  67. package/src/components/layout/shell/menu.ts +15 -1
  68. package/src/components/layout/shell/pane/actions.ts +4 -0
  69. package/src/components/layout/shell/ticker-link-menu.ts +12 -3
  70. package/src/components/layout/status-bar.tsx +20 -0
  71. package/src/components/layout/window-controls.tsx +96 -35
  72. package/src/components/layout/window-fullscreen.ts +20 -0
  73. package/src/components/onboarding/onboarding-keyboard.ts +5 -1
  74. package/src/components/onboarding/onboarding-wizard.tsx +15 -4
  75. package/src/components/onboarding/portfolio-step/positions-panel.tsx +8 -5
  76. package/src/components/onboarding/use-onboarding-progress.ts +20 -1
  77. package/src/components/price-sparkline/view.tsx +14 -6
  78. package/src/components/quote-flash.ts +36 -32
  79. package/src/components/ticker/badge/index.tsx +8 -4
  80. package/src/components/ticker/badge/list.tsx +23 -7
  81. package/src/components/ui/column-grid.tsx +8 -2
  82. package/src/components/ui/data-table/opentui/model.ts +4 -1
  83. package/src/components/ui/tabs.tsx +5 -2
  84. package/src/core/state/app/layout.ts +18 -3
  85. package/src/core/state/app/state.ts +2 -0
  86. package/src/core/state/app/types.ts +5 -0
  87. package/src/data/config/layout.ts +3 -0
  88. package/src/data/config/store/normalize.ts +39 -4
  89. package/src/i18n/es.ts +10 -0
  90. package/src/i18n/ja.ts +10 -0
  91. package/src/i18n/ko.ts +10 -0
  92. package/src/i18n/zh-cn.ts +10 -0
  93. package/src/i18n/zh-tw.ts +10 -0
  94. package/src/layout/pane-manager/floating-placement.ts +7 -4
  95. package/src/layout/pane-manager/floating.ts +5 -2
  96. package/src/market-data/bond-funds.ts +19 -0
  97. package/src/market-data/coordinator/events.ts +17 -1
  98. package/src/market-data/frame-scheduler.ts +47 -10
  99. package/src/market-data/frame-wake.ts +74 -0
  100. package/src/market-data/futures-board.ts +7 -6
  101. package/src/market-data/futures-contract.ts +14 -3
  102. package/src/market-data/hooks.tsx +12 -3
  103. package/src/market-data/market/freshness.ts +18 -0
  104. package/src/market-data/market/status.ts +15 -2
  105. package/src/market-data/performance.ts +78 -9
  106. package/src/market-data/request-types.ts +6 -3
  107. package/src/plugins/builtin/alerts/cli.ts +2 -1
  108. package/src/plugins/builtin/analytics/risk-evidence.ts +1 -0
  109. package/src/plugins/builtin/attention/evidence.ts +1 -1
  110. package/src/plugins/builtin/awards/client.ts +1 -1
  111. package/src/plugins/builtin/awards/evidence.ts +1 -1
  112. package/src/plugins/builtin/awards/pane.tsx +2 -1
  113. package/src/plugins/builtin/bond-calculator/headless.ts +2 -1
  114. package/src/plugins/builtin/bond-calculator/index.tsx +1 -1
  115. package/src/plugins/builtin/bond-calculator/math.ts +1 -1
  116. package/src/plugins/builtin/bond-calculator/model.ts +14 -5
  117. package/src/plugins/builtin/bond-calculator/pane.tsx +1 -1
  118. package/src/plugins/builtin/broker-manager/footer.ts +3 -2
  119. package/src/plugins/builtin/broker-manager/index.tsx +2 -1
  120. package/src/plugins/builtin/broker-manager/keyboard.ts +2 -1
  121. package/src/plugins/builtin/buildout/cells.tsx +25 -45
  122. package/src/plugins/builtin/buildout/detail/company.tsx +3 -3
  123. package/src/plugins/builtin/buildout/detail/index.tsx +1 -1
  124. package/src/plugins/builtin/buildout/detail/intel.tsx +4 -7
  125. package/src/plugins/builtin/buildout/detail/site.tsx +4 -4
  126. package/src/plugins/builtin/buildout/detail/ui.tsx +39 -38
  127. package/src/plugins/builtin/buildout/format.ts +23 -1
  128. package/src/plugins/builtin/buildout/model/types.ts +1 -0
  129. package/src/plugins/builtin/buildout/pane/index.tsx +2 -8
  130. package/src/plugins/builtin/buildout/table-model.ts +12 -4
  131. package/src/plugins/builtin/catalysts/evidence.ts +1 -1
  132. package/src/plugins/builtin/catalysts/pane.tsx +2 -1
  133. package/src/plugins/builtin/cds/headless.ts +1 -0
  134. package/src/plugins/builtin/cds/index.tsx +1 -1
  135. package/src/plugins/builtin/chart-composer/headless.ts +40 -1
  136. package/src/plugins/builtin/cloud/plugin.tsx +2 -0
  137. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +28 -3
  138. package/src/plugins/builtin/cloud-tweets/table.tsx +3 -2
  139. package/src/plugins/builtin/comment-letters/client.ts +2 -1
  140. package/src/plugins/builtin/company-kpis/client.ts +1 -1
  141. package/src/plugins/builtin/company-kpis/pane.tsx +2 -1
  142. package/src/plugins/builtin/company-kpis/screenshot-evidence.ts +3 -2
  143. package/src/plugins/builtin/correlation/headless.ts +3 -2
  144. package/src/plugins/builtin/cot/headless.ts +9 -3
  145. package/src/plugins/builtin/cot/model.ts +44 -3
  146. package/src/plugins/builtin/credit-documents/client.ts +1 -1
  147. package/src/plugins/builtin/credit-documents/evidence.ts +1 -1
  148. package/src/plugins/builtin/credit-documents/pane.tsx +2 -1
  149. package/src/plugins/builtin/crypto-board/pane.tsx +5 -4
  150. package/src/plugins/builtin/debt-maturities/headless.ts +11 -2
  151. package/src/plugins/builtin/debt-maturities/model.ts +66 -0
  152. package/src/plugins/builtin/debt-maturities/pane.tsx +23 -4
  153. package/src/plugins/builtin/earnings-calls/pane.tsx +1 -1
  154. package/src/plugins/builtin/earnings-ripple/index.tsx +6 -1
  155. package/src/plugins/builtin/earnings-ripple/pane.tsx +1 -1
  156. package/src/plugins/builtin/econ/calendar-model.ts +30 -6
  157. package/src/plugins/builtin/econ/fred-catalog.ts +5 -5
  158. package/src/plugins/builtin/econ/print-watch.ts +3 -1
  159. package/src/plugins/builtin/equity-screener/client.ts +1 -1
  160. package/src/plugins/builtin/equity-screener/criterion-editor.tsx +4 -16
  161. package/src/plugins/builtin/equity-screener/headless.ts +4 -2
  162. package/src/plugins/builtin/equity-screener/ideas.ts +67 -3
  163. package/src/plugins/builtin/equity-screener/model.ts +180 -12
  164. package/src/plugins/builtin/equity-screener/pane.tsx +52 -12
  165. package/src/plugins/builtin/equity-screener/screen-check.ts +7 -4
  166. package/src/plugins/builtin/equity-screener/watchlist.ts +33 -0
  167. package/src/plugins/builtin/futures/series.ts +16 -1
  168. package/src/plugins/builtin/futures-curve/client.ts +19 -0
  169. package/src/plugins/builtin/futures-curve/headless.ts +52 -13
  170. package/src/plugins/builtin/futures-curve/index.tsx +1 -1
  171. package/src/plugins/builtin/futures-curve/model.ts +77 -6
  172. package/src/plugins/builtin/futures-curve/pane.tsx +19 -3
  173. package/src/plugins/builtin/fx-matrix/headless.ts +4 -2
  174. package/src/plugins/builtin/fx-matrix/index.tsx +37 -3
  175. package/src/plugins/builtin/fx-matrix/pairs.ts +15 -0
  176. package/src/plugins/builtin/gpu/headless.ts +2 -1
  177. package/src/plugins/builtin/help/function-card.tsx +2 -1
  178. package/src/plugins/builtin/help/index.tsx +2 -1
  179. package/src/plugins/builtin/insider/display.ts +45 -6
  180. package/src/plugins/builtin/ipo-calendar/model.ts +2 -0
  181. package/src/plugins/builtin/iv-history/client.ts +2 -1
  182. package/src/plugins/builtin/iv-history/headless.ts +2 -1
  183. package/src/plugins/builtin/jobs/pages.ts +4 -4
  184. package/src/plugins/builtin/kelly-sizer/headless.ts +2 -1
  185. package/src/plugins/builtin/macro-day/client.ts +41 -0
  186. package/src/plugins/builtin/macro-day/headless.ts +19 -9
  187. package/src/plugins/builtin/macro-day/model.ts +3 -1
  188. package/src/plugins/builtin/market-heatmap/index.tsx +2 -1
  189. package/src/plugins/builtin/market-movers/index.tsx +4 -3
  190. package/src/plugins/builtin/members/client.ts +1 -1
  191. package/src/plugins/builtin/mna/distress/client.ts +1 -0
  192. package/src/plugins/builtin/mna/distress/headless.ts +1 -0
  193. package/src/plugins/builtin/mna/pane.tsx +4 -1
  194. package/src/plugins/builtin/options/market-reference.ts +1 -1
  195. package/src/plugins/builtin/options/open-interest-as-of.ts +3 -1
  196. package/src/plugins/builtin/options/view.tsx +2 -1
  197. package/src/plugins/builtin/options-calculator/evidence.ts +1 -1
  198. package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +1 -1
  199. package/src/plugins/builtin/options-scenario/csp-screen.ts +8 -4
  200. package/src/plugins/builtin/options-scenario/csp.ts +28 -9
  201. package/src/plugins/builtin/options-scenario/evidence.ts +5 -4
  202. package/src/plugins/builtin/options-scenario/pane.tsx +2 -1
  203. package/src/plugins/builtin/perps/client.ts +1 -1
  204. package/src/plugins/builtin/perps/pane.tsx +3 -1
  205. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +17 -0
  206. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +2 -1
  207. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +4 -2
  208. package/src/plugins/builtin/portfolio-list/pane/index.tsx +7 -3
  209. package/src/plugins/builtin/portfolio-list/use-throttled-memo.ts +10 -19
  210. package/src/plugins/builtin/rate-path/headless.ts +24 -10
  211. package/src/plugins/builtin/research/analyst-model.ts +1 -0
  212. package/src/plugins/builtin/research/equity-diagnostic-pane.tsx +2 -1
  213. package/src/plugins/builtin/research/event-model.ts +10 -3
  214. package/src/plugins/builtin/research/events-headless.ts +20 -2
  215. package/src/plugins/builtin/research/index.tsx +1 -0
  216. package/src/plugins/builtin/research/relative-valuation-currency.ts +1 -1
  217. package/src/plugins/builtin/research/relative-valuation-peers.ts +2 -1
  218. package/src/plugins/builtin/research-search/command-bar-search.ts +3 -1
  219. package/src/plugins/builtin/research-search/snippet.ts +1 -0
  220. package/src/plugins/builtin/revenue-breakdown/client.ts +3 -2
  221. package/src/plugins/builtin/seasonality/headless.ts +2 -1
  222. package/src/plugins/builtin/sec/command-bar-search.ts +3 -2
  223. package/src/plugins/builtin/sec/fund-facts.ts +17 -1
  224. package/src/plugins/builtin/sec/index.tsx +8 -5
  225. package/src/plugins/builtin/sec/row-summaries.ts +28 -12
  226. package/src/plugins/builtin/shared/members-menu.tsx +103 -38
  227. package/src/plugins/builtin/short-interest/publications-model.ts +22 -1
  228. package/src/plugins/builtin/short-interest/publications-pane.tsx +13 -4
  229. package/src/plugins/builtin/short-interest/watch-client.ts +2 -1
  230. package/src/plugins/builtin/short-interest/watch-model.ts +1 -1
  231. package/src/plugins/builtin/social-mentions/client.ts +2 -1
  232. package/src/plugins/builtin/supply-chain/client.ts +1 -1
  233. package/src/plugins/builtin/supply-chain/evidence.ts +1 -1
  234. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -1
  235. package/src/plugins/builtin/supply-chain/pane.tsx +2 -1
  236. package/src/plugins/builtin/ticker-detail/adr-pair/headless.ts +1 -1
  237. package/src/plugins/builtin/ticker-detail/adr-pair/model.ts +24 -4
  238. package/src/plugins/builtin/ticker-detail/adr-pair/tab.tsx +1 -1
  239. package/src/plugins/builtin/time-sales/client.ts +1 -0
  240. package/src/plugins/builtin/time-sales/pane.tsx +3 -2
  241. package/src/plugins/builtin/trace-bonds/client.ts +7 -4
  242. package/src/plugins/builtin/trace-bonds/index.tsx +1 -1
  243. package/src/plugins/builtin/vol-surface/client.ts +2 -1
  244. package/src/plugins/builtin/volatility/client.ts +6 -1
  245. package/src/plugins/builtin/volatility/headless.ts +0 -1
  246. package/src/plugins/builtin/yield-curve/curves.ts +15 -0
  247. package/src/plugins/builtin/yield-curve/headless.ts +9 -2
  248. package/src/plugins/builtin/yield-curve/index.tsx +5 -8
  249. package/src/plugins/host-modules.ts +22 -3
  250. package/src/plugins/host-smoke.ts +6 -3
  251. package/src/portfolio/collection-name.ts +19 -0
  252. package/src/portfolio/column-values.ts +76 -10
  253. package/src/renderers/browser/http-proxy-transport.ts +78 -8
  254. package/src/renderers/cloudflare/http-proxy.ts +13 -2
  255. package/src/renderers/cloudflare/proxy-session.ts +47 -24
  256. package/src/renderers/cloudflare/worker.ts +15 -2
  257. package/src/renderers/desktop/geometry.ts +279 -0
  258. package/src/renderers/desktop/screen-setup.ts +246 -0
  259. package/src/renderers/desktop/sequential-window-host.ts +179 -0
  260. package/src/renderers/desktop/test-utils.ts +71 -0
  261. package/src/renderers/desktop/window-controller.ts +433 -0
  262. package/src/renderers/desktop/window-host.ts +70 -0
  263. package/src/renderers/desktop/window-layouts.ts +630 -0
  264. package/src/renderers/dom/data-frames.ts +15 -4
  265. package/src/renderers/dom/host/box.tsx +204 -176
  266. package/src/renderers/dom/host/style.ts +49 -20
  267. package/src/renderers/dom/host/text.tsx +3 -2
  268. package/src/renderers/electrobun/bun/application-menu/click.ts +1 -0
  269. package/src/renderers/electrobun/bun/application-menu/index.ts +4 -1
  270. package/src/renderers/electrobun/bun/desktop/backend-requests.ts +19 -8
  271. package/src/renderers/electrobun/bun/desktop/backend.ts +322 -19
  272. package/src/renderers/electrobun/bun/desktop/detached-windows.ts +83 -61
  273. package/src/renderers/electrobun/bun/desktop/host-requests.ts +29 -15
  274. package/src/renderers/electrobun/bun/desktop/initialization.ts +30 -11
  275. package/src/renderers/electrobun/bun/desktop/relaunch.ts +9 -1
  276. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +55 -0
  277. package/src/renderers/electrobun/bun/desktop/state-broadcaster.ts +44 -8
  278. package/src/renderers/electrobun/bun/desktop/windows-script.ts +9 -6
  279. package/src/renderers/electrobun/bun/desktop/workspace/index.ts +298 -97
  280. package/src/renderers/electrobun/bun/desktop/workspace/requests.ts +44 -6
  281. package/src/renderers/electrobun/bun/index.ts +4 -97
  282. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +306 -0
  283. package/src/renderers/electrobun/bun/window/focus.ts +0 -25
  284. package/src/renderers/electrobun/bun/window/remembered-frame.ts +4 -82
  285. package/src/renderers/electrobun/bun/window/windows-native.ts +26 -1
  286. package/src/renderers/electrobun/shared/protocol.ts +50 -2
  287. package/src/renderers/electrobun/view/backend-rpc.ts +15 -0
  288. package/src/renderers/electrobun/view/desktop/window/bridge.ts +63 -3
  289. package/src/renderers/electrobun/view/main.tsx +13 -7
  290. package/src/renderers/electrobun/view/ui-host.tsx +7 -0
  291. package/src/renderers/electrobun/view/window-fullscreen.ts +10 -3
  292. package/src/series/fred-argument.ts +17 -0
  293. package/src/sources/provider-router/financial-routes.ts +7 -1
  294. package/src/sources/provider-router/index.ts +7 -1
  295. package/src/state/app/context/index.tsx +16 -2
  296. package/src/state/desktop-windows.ts +63 -0
  297. package/src/sync/other-window-tabs.ts +62 -0
  298. package/src/tickers/company-name-listing.ts +23 -3
  299. package/src/tickers/listing-fate.ts +147 -1
  300. package/src/tickers/terminal-codes.ts +5 -0
  301. package/src/time-series/price-units.ts +11 -0
  302. package/src/time-series/types.ts +6 -0
  303. package/src/types/config.ts +10 -1
  304. package/src/types/desktop-window.ts +71 -2
  305. package/src/types/financials.ts +4 -0
  306. package/src/types/headless.ts +19 -0
  307. package/src/types/plugin.ts +6 -0
  308. package/src/ui/host.tsx +2 -0
  309. package/src/ui/index.tsx +14 -13
  310. package/src/ui/same-props.ts +58 -0
  311. package/src/utils/cli-output.ts +33 -4
  312. package/src/utils/currency-names.ts +20 -0
  313. package/src/utils/currency-pair.ts +6 -0
  314. package/src/utils/exchange-rate-snapshot.ts +20 -2
  315. package/src/utils/format.ts +7 -2
  316. package/src/utils/futures-generic.ts +12 -0
  317. package/src/utils/fx-market-hours.ts +43 -0
  318. package/src/utils/http-proxy-upstream.ts +6 -2
  319. package/src/utils/plugin-proxy-hosts.json +0 -4
  320. package/src/utils/plugin-proxy-hosts.ts +22 -0
  321. package/src/utils/sec-filings.ts +7 -1
@@ -237,8 +237,11 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
237
237
  summary: "Screen covered stocks on valuation, growth, margins, returns on capital, leverage, liquidity, volatility, technicals, float and ownership, short interest, insider activity and 13F holders, then rank the matches by any metric. "
238
238
  + "ATR% is the 14-session average true range as a percent of the last close. IV rank is a rank, not an IV percentile: 0 is the lowest 30-day implied volatility of the past 52 weeks and 100 the highest. IV percentile, IV30 change in vol points, HV20 and HV rank screen premium to sell. "
239
239
  + "Technical fields read the last completed session: RSI 14, price vs SMA 20, 50 and 200, trading days since a MACD or golden cross and since a new 20-day or 52-week high or low, and Bollinger width percentile (0 is a six-month squeeze). "
240
- + "ROIC, FCF yield, net debt / EBITDA, debt / equity and the revenue and EPS CAGRs read FA's bases, and forward growth EE's consensus; N/M where FA prints it. Ideas holds ready technical screens and Value, Quality and GARP.",
241
- usage: ["EQS", "gloom fn EQS --preset golden-cross", "gloom fn EQS --preset quality"],
240
+ + "ROIC, FCF yield, net debt / EBITDA, debt / equity and the revenue and EPS CAGRs read FA's bases, and forward growth EE's consensus; N/M where FA prints it. "
241
+ + "Classic scores: Piotroski F, Altman Z, the Graham number and Lynch fair value with their upside, Greenblatt's Magic Formula rank, the RS rating, years of profit, revenue and dividend growth, and S&P 500 and Dow membership. "
242
+ + "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
+ + "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
+ 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"],
242
245
  keys: [key("a", "dd criterion"), key("m", "etric"), key("t", "check ticker"), key("s", "ave screen"), key("o", "pen research")],
243
246
  data: same("Daily snapshot, statements as filed"),
244
247
  bloomberg: ["EQS"],
@@ -353,8 +356,8 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
353
356
  bloomberg: [],
354
357
  },
355
358
  MDAY: {
356
- summary: "Does this name care about CPI day? Its average move on CPI, jobs report and FOMC days against a normal day, the average signed move and share of up days, and the move on every release day.",
357
- usage: ["MDAY SPY"],
359
+ summary: "Does this name care about CPI day? Its average move on CPI, jobs report and FOMC days against a normal day, the average signed move and share of up days, and the move on every release day. Takes a FRED series too (FRED:T10Y2Y), whose moves in a rate or spread read in basis points.",
360
+ usage: ["MDAY SPY", "MDAY FRED:T10Y2Y"],
358
361
  keys: [],
359
362
  data: DAILY_CLOSES,
360
363
  bloomberg: [],
@@ -1039,7 +1042,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
1039
1042
  usage: ["CDS", "CDS F", "gloom fn CDS --sort 1m", "gloom fn CDS F --csv --section daily"],
1040
1043
  keys: [OPEN, STEP],
1041
1044
  data: same("Delayed, as trades are disseminated"),
1042
- bloomberg: ["CDS"],
1045
+ bloomberg: ["CDS", "CDSW"],
1043
1046
  },
1044
1047
  CDX: {
1045
1048
  summary: "CDX IG, HY and EM with iTraxx Main and Crossover on the run: the 5Y level, 1D, 1W and 1M moves, 1Y percentile and the day's print count. IG and iTraxx in spread, HY and EM in price. Naming an index opens the board on it, and `fn` adds its daily history. Sovereign CDS is the other tab.",
@@ -1,3 +1,4 @@
1
+ import { currencyRateUnitText } from "../../time-series/price-units";
1
2
  import { getSharedRegistry } from "../../plugins/registry";
2
3
  import { seriesExpression, seriesNamedBy } from "../../series/registry";
3
4
  import { findCachedPortfolioAccount } from "../../plugins/builtin/portfolio-list/cached-account";
@@ -378,7 +379,9 @@ export function serializeHeadlessPaneResult(
378
379
  case "series": {
379
380
  const series = result as HeadlessSeriesResult;
380
381
  // `textDecimals` and `textCompact` only shape the text report; JSON keeps every digit and does not carry them.
381
- return { ...common, series: series.series.map(({ textDecimals: _decimals, textCompact: _compact, ...kept }) => kept), ...(series.stats ? { stats: series.stats } : {}) };
382
+ return { ...common, series: series.series.map(({ textDecimals: _decimals, textCompact: _compact, ...kept }) => (
383
+ kept.unit ? { ...kept, unit: currencyRateUnitText(kept.unit) } : kept
384
+ )), ...(series.stats ? { stats: series.stats } : {}) };
382
385
  }
383
386
  case "snapshot": {
384
387
  const snapshot = result as HeadlessSnapshotResult;
@@ -572,10 +575,10 @@ function statisticsEntries(stats: NonNullable<HeadlessSeriesResult["stats"]>): H
572
575
 
573
576
  function renderBundle(
574
577
  definition: HeadlessPaneDefinition,
575
- result: HeadlessBundleResult,
578
+ sections: readonly HeadlessBundleSection[],
576
579
  ): string[] {
577
580
  // A locked table is named once, on the Pro line, not under each heading.
578
- return result.sections.filter((section) => !isLockedSection(section)).flatMap((section, index) => [
581
+ return sections.filter((section) => !isLockedSection(section)).flatMap((section, index) => [
579
582
  ...(index > 0 ? [""] : []),
580
583
  // A section with no title is its rows, or its empty message, alone.
581
584
  ...(section.title ? [renderSection(section.textTitle ?? section.title)] : []),
@@ -600,7 +603,7 @@ function renderSeries(result: HeadlessSeriesResult): string[] {
600
603
  name: series.name?.trim() || null,
601
604
  latest: latest ? seriesLatestDate(series, latest.date) : "-",
602
605
  value: seriesValue(series, latest?.value ?? latest?.close ?? null),
603
- unit: series.unit?.trim() || null,
606
+ unit: series.unit?.trim() ? currencyRateUnitText(series.unit.trim()) : null,
604
607
  points: observationCount(series),
605
608
  };
606
609
  });
@@ -646,7 +649,8 @@ function seriesTable(series: HeadlessSeries): CliReportTable {
646
649
  title: series.label,
647
650
  identity: {
648
651
  ...(series.symbol?.trim() ? { symbolOrSeries: series.symbol.trim() } : {}),
649
- ...(series.unit?.trim() ? { currencyOrUnit: series.unit.trim() } : {}),
652
+ // A rate reads `JPY per USD` here as in every other export.
653
+ ...(series.unit?.trim() ? { currencyOrUnit: currencyRateUnitText(series.unit.trim()) } : {}),
650
654
  ...(series.interval?.trim() ? { interval: series.interval.trim() } : {}),
651
655
  },
652
656
  columns: [dates.every((date) => date.length <= 10) ? "Date" : "Time", ...fields.map(header)],
@@ -916,10 +920,11 @@ export function renderHeadlessPaneText(
916
920
  case "rows": {
917
921
  const rowsResult = result as HeadlessRowsResult;
918
922
  lines.push(renderRows(rowsResult.textRows ?? rowsResult.rows, rowsResult.textColumns ?? rowsResult.columns, definition.columns, rowsResult.empty));
923
+ if (rowsResult.textSections?.length) lines.push("", ...renderBundle(definition, rowsResult.textSections));
919
924
  break;
920
925
  }
921
926
  case "bundle":
922
- lines.push(...renderBundle(definition, result as HeadlessBundleResult));
927
+ lines.push(...renderBundle(definition, (result as HeadlessBundleResult).sections));
923
928
  break;
924
929
  case "series":
925
930
  lines.push(...renderSeries(result as HeadlessSeriesResult));
@@ -8,7 +8,7 @@ import {
8
8
  nextRegularSessionOpen,
9
9
  } from "../../market-data/market/freshness";
10
10
  import { futuresWeekendClosure } from "../../market-data/market/futures-week";
11
- import { currentFxClosureStart, isFxMarketOpen } from "../../utils/fx-market-hours";
11
+ import { currentFxClosureStart, isFxMarketOpen, isFxWeekClosePrint } from "../../utils/fx-market-hours";
12
12
  import { zonedDateKey } from "../../utils/zoned-date-time";
13
13
  import type { ReportTime } from "../../utils/utc-time";
14
14
  import type { QuoteIndexSession } from "../../types/financials";
@@ -118,7 +118,6 @@ function quotedSessions({ timeZone, current, regular }: QuoteIndexSession, now:
118
118
 
119
119
  /** The venue spot FX pairs trade on. It has no session calendar here; its week is in `fx-market-hours`. */
120
120
  const FX_VENUE = "CCY";
121
- const DAY_MS = 24 * 60 * 60_000;
122
121
 
123
122
  /**
124
123
  * The newest observation is its venue's latest close: the venue has not
@@ -128,13 +127,13 @@ const DAY_MS = 24 * 60 * 60_000;
128
127
  function closeDateOf(observation: SessionObservation, session: VenueSession, now: number): string | null {
129
128
  const time = observation.time;
130
129
  if (!time || time.dateOnly) return null;
131
- // FX closes once a week, Friday 17:00 New York time, and its trading day turns
132
- // at 17:00: a print from that last day, after Thursday's 17:00 close through
133
- // Friday's, is that Friday's close. A tick after it, over the weekend, is no
134
- // price of the week and keeps its own time.
130
+ // FX closes once a week, Friday 17:00 New York time: a print in its last
131
+ // minute is that Friday's close. An earlier print of the day (20:39Z) is no
132
+ // close, and a tick after it, over the weekend, is no price of the week:
133
+ // both keep their own time.
135
134
  const weekClose = canonicalExchange(observation.exchange) === FX_VENUE ? currentFxClosureStart(now) : null;
136
135
  if (weekClose != null) {
137
- return time.time > weekClose - DAY_MS && time.time <= weekClose ? zonedDateKey(weekClose - 1, "America/New_York") : null;
136
+ return isFxWeekClosePrint(time.time, weekClose) ? zonedDateKey(weekClose - 1, "America/New_York") : null;
138
137
  }
139
138
  if (session.last && session.timeZone) {
140
139
  if (session.last.open != null && time.time < session.last.open) return null;
@@ -11,6 +11,7 @@ import { applyChartComposerCapabilityOptions } from "../../plugins/builtin/chart
11
11
  import { parseChartSpec } from "../../plugins/builtin/chart-composer/chart-spec";
12
12
  import { normalizeTickerInput } from "../../tickers/search";
13
13
  import { slugifyName } from "../../utils/slugify";
14
+ import { fredSeriesArgument } from "../../series/fred-argument";
14
15
  import { listCoinNotes, ListingArgError, listingInstrument, listingReadNotes, resolveCliListing, usListingsOnlyMessage } from "../listing-arg";
15
16
  import { uncoveredInstrumentKind, uncoveredInstrumentMessage } from "../../tickers/instrument-coverage";
16
17
  import { uncoveredInstrumentCommand } from "../uncovered-instrument";
@@ -22,6 +23,8 @@ import { readTerminalCodeArg } from "../../tickers/company-name-listing";
22
23
  import { unknownBloombergMarket } from "../../tickers/terminal-codes";
23
24
  import { notATickerWords } from "../company-name-hint";
24
25
  import type { MarketContext } from "../types";
26
+ import { findWatchlist } from "../helpers";
27
+ import { readWatchlistArgument } from "../../portfolio/collection-name";
25
28
  import {
26
29
  buildPaneFunctionLookup,
27
30
  buildTemplateContext,
@@ -141,13 +144,54 @@ export function parsePaneFunctionArgsFor(
141
144
  args: string[],
142
145
  globalOptions: { limit?: number; tail?: number } = {},
143
146
  ): ParsedPaneFunctionArgs {
144
- const parsed = parsePaneFunctionArgs(args, globalOptions);
147
+ const parsed = withOpeningWord(registry, withKeywordNote(registry, parsePaneFunctionArgs(args, globalOptions)));
145
148
  const found = parsed.target ? findPaneFunction(registry, parsed.target) : null;
146
149
  if (!found?.pane) return parsed;
147
150
  const capability = getPaneFunctionCapability(found.template, found.pane);
148
151
  if (!capability.options.some((option) => (option.valueWords ?? 1) > 1 || option.list)) return parsed;
149
- return parsePaneFunctionArgs(args, globalOptions, (key) => findCapabilityOption(capability, key)?.valueWords ?? 1,
152
+ const reparsed = parsePaneFunctionArgs(args, globalOptions, (key) => findCapabilityOption(capability, key)?.valueWords ?? 1,
150
153
  (key) => findCapabilityOption(capability, key)?.list === true);
154
+ return { ...reparsed, target: parsed.target, arg: reparsed.target === parsed.target ? reparsed.arg : parsed.arg,
155
+ ...(parsed.listingNotes ? { listingNotes: parsed.listingNotes } : {}) };
156
+ }
157
+
158
+ /**
159
+ * A word that opens no function by its code but names one case of a function
160
+ * (`discovery.opens`: `VX`, `vix futures`) runs that function on the case's
161
+ * argument, and says so: `fn VX` is `fn CTM VIX`. A word typed with an
162
+ * argument of its own keeps it.
163
+ */
164
+ function withOpeningWord(registry: PaneFunctionCatalog, parsed: ParsedPaneFunctionArgs): ParsedPaneFunctionArgs {
165
+ if (!parsed.target || findPaneFunction(registry, parsed.target)) return parsed;
166
+ const wanted = normalizeLookupToken(parsed.target);
167
+ for (const template of registry.paneTemplates.values()) {
168
+ const pane = registry.panes.get(template.paneId);
169
+ const opens = pane ? getHeadlessPaneDefinition(template, pane)?.discovery?.opens : undefined;
170
+ const opening = opens?.find((entry) => entry.words.some((word) => normalizeLookupToken(word) === wanted));
171
+ if (!pane || !opening) continue;
172
+ const code = paneFunctionCode(template, pane);
173
+ const arg = parsed.arg.trim() || opening.argument;
174
+ return { ...parsed, target: code, arg, listingNotes: [...parsed.listingNotes ?? [], `${parsed.target} opened ${code} ${arg}, ${template.label}.`] };
175
+ }
176
+ return parsed;
177
+ }
178
+
179
+ /**
180
+ * A word that opens a function as one of its keywords rather than its code or
181
+ * name (`fn VVIX` opens VIX, whose board lists VVIX) says which function it
182
+ * opened, so the report is never read as one of its own.
183
+ */
184
+ function withKeywordNote(registry: PaneFunctionCatalog, parsed: ParsedPaneFunctionArgs): ParsedPaneFunctionArgs {
185
+ const found = parsed.target ? findPaneFunction(registry, parsed.target) : null;
186
+ if (!found?.pane || !found.template) return parsed;
187
+ const { template, pane } = found;
188
+ const wanted = normalizeLookupToken(parsed.target);
189
+ const headless = getHeadlessPaneDefinition(template, pane);
190
+ const names = [template.shortcut?.prefix, ...template.shortcut?.aliases ?? [], template.id, template.label, pane.id, pane.name,
191
+ headless?.discovery?.id, ...headless?.discovery?.aliases ?? []];
192
+ if (names.some((name) => name && normalizeLookupToken(name) === wanted)) return parsed;
193
+ const code = paneFunctionCode(template, pane);
194
+ return { ...parsed, listingNotes: [...parsed.listingNotes ?? [], `${parsed.target} opened ${code}, ${template.label}.`] };
151
195
  }
152
196
 
153
197
  /**
@@ -175,6 +219,12 @@ export async function applyListingArgument(
175
219
  if (!(takesOneTicker || takesList) || getPaneFunctionCapability(found.template, found.pane).options.some((option) => option.key === "exchange")) {
176
220
  return args;
177
221
  }
222
+ // A watchlist's name stands for its symbols, as saved (`fn SIW HY3`).
223
+ const watchlist = takesList ? await watchlistArgument(args.arg, context, headless?.argument.maximum) : null;
224
+ if (watchlist) args = { ...args, arg: watchlist.symbols.join(", ") };
225
+ // A function that reads FRED series (MDAY) gets FRED:T10Y2Y as typed; any other is told it is no listing.
226
+ const fred = takesOneTicker && headless?.fredSeriesArgument && typeof args.options.exchange !== "string" ? fredSeriesArgument(args.arg) : null;
227
+ if (fred) return { ...args, arg: `FRED:${fred}` };
178
228
  // A ticker with spaces is no listing, unless it is a terminal's code for one ("JPM US Equity"). A company's name
179
229
  // typed there (`fn RDCF "Palantir Technologies"`) stops before a report of dashes is drawn, as `quote` words a
180
230
  // name that is no ticker, with the company search finds for it.
@@ -254,6 +304,7 @@ export async function applyListingArgument(
254
304
  }
255
305
  notes.push(...answers.map((answer) => `${answer.message} ${answer.details.replaceAll("\n", " ")}`));
256
306
  }
307
+ notes.unshift(...watchlist?.notes ?? []);
257
308
  // One listing's notes come with its choice note; a list's are said here, with a coin's code read as a listing
258
309
  // (CORR RIOT,BTC: BTC is the Grayscale fund) as `quote BTC` says it.
259
310
  if (listings.length > 1) notes.unshift(...listings.flatMap(listingReadNotes), ...await listCoinNotes(listings, context));
@@ -266,6 +317,28 @@ export async function applyListingArgument(
266
317
  };
267
318
  }
268
319
 
320
+ /**
321
+ * The symbols of the watchlist a list argument names (case aside), as saved,
322
+ * at most the function's `maximum` of them, with the note that says the name
323
+ * was read as that watchlist (`readWatchlistArgument`). Null when the
324
+ * argument names no watchlist, or one with nothing in it.
325
+ */
326
+ async function watchlistArgument(
327
+ arg: string,
328
+ context: MarketContext,
329
+ maximum: number | undefined,
330
+ ): Promise<{ symbols: string[]; notes: string[] } | null> {
331
+ if (/[,;\t\n]/.test(arg)) return null;
332
+ const watchlist = findWatchlist(context.config, arg);
333
+ if (!watchlist) return null;
334
+ const symbols = (await context.store.loadAllTickers())
335
+ .filter((ticker) => ticker.metadata.watchlists.includes(watchlist.id))
336
+ .map((ticker) => ticker.metadata.ticker);
337
+ if (symbols.length === 0) return null;
338
+ const read = readWatchlistArgument(arg, watchlist, symbols, maximum);
339
+ return { symbols: read.symbols, notes: [read.note] };
340
+ }
341
+
269
342
  /**
270
343
  * `--section` picks one table of a report's `--csv` or `--ndjson` output. A
271
344
  * function that has a `section` option of its own (CALLS: which part of a
@@ -10,6 +10,7 @@ import { currencyCodeNote } from "./currency-hints";
10
10
  import { describeSuggestion, suggestListing, suggestUsTicker, type ListingSuggestion } from "./listing-suggestion";
11
11
  import { indexRootAlsoLine, indexRootTryLine } from "./index-roots";
12
12
  import { indexRootFor } from "../tickers/index-roots";
13
+ import { serviceMarkedListing } from "../tickers/company-name-listing";
13
14
  import { treasuryYieldLine, treasuryYieldTenor } from "./treasury-yields";
14
15
  import { knownGapForTicker } from "./known-gaps";
15
16
  import {
@@ -21,6 +22,7 @@ import {
21
22
  loadBareVenues,
22
23
  notTradedMessage,
23
24
  oneWordCompanyName,
25
+ parseListingArg,
24
26
  quoteBareListing,
25
27
  serviceNamedCompany,
26
28
  type ListingArg,
@@ -106,6 +108,13 @@ export async function answerQuote(
106
108
  // HCI.L is HCI on LSE written with a vendor's suffix: one that does not trade there says so as HCI:LSE does.
107
109
  const suffixed = await notTradedOnSuffixVenue(listing, market);
108
110
  if (suffixed) return { result, listing, failure: { message: suffixed, oneLine: suffixed }, notes: [] };
111
+ // A bare index root the service marks its index with (VIX, ^VIX on CXI) is that index, read at once: the company
112
+ // name search below would quote it, read the crypto board and come to the same listing a second later.
113
+ const marked = root && !listing.exchange && listing.typed ? await serviceMarkedListing(market.dataProvider, listing.typed, root.symbol) : null;
114
+ const key = marked ? marked.exchange ? `${marked.symbol}:${marked.exchange}` : marked.symbol : null;
115
+ const index = key ? await answerNamedListing({ ...parseListingArg(key),
116
+ readAs: `Read "${listing.typed!.trim()}" as ${key} (${marked!.name}).`, readFromName: true }, market, request, refresh, datesChangeBasis) : null;
117
+ if (index) return index;
109
118
  // A word the service marks as a company's name is that company, before the symbol is read on its listings abroad.
110
119
  const named = !listing.exchange && listing.typed ? await serviceNamedCompany(listing.typed, market) : null;
111
120
  const meant = named ? await answerNamedListing(named, market, request, refresh, datesChangeBasis) : null;
@@ -82,27 +82,26 @@ function shellArgument(expression: string): string {
82
82
 
83
83
  /**
84
84
  * The series part of `catalog` or `search`: a table of the first `limit`
85
- * matches with the expression `fn G` charts, and how to see the rest.
85
+ * matches with the expression `fn G` charts, and how to see the rest:
86
+ * `catalog <words> --all`, which lists every one.
86
87
  */
87
88
  export function renderSeriesMatches(
88
89
  query: string,
89
90
  matches: readonly SeriesMatch[],
90
91
  limit: number,
91
92
  width: number,
92
- /** Where the rest are listed: `shot CAT` from the catalog, the catalog from a search. */
93
- rest: "catalog" | "data-catalog" = "data-catalog",
94
93
  ): string {
95
94
  if (matches.length === 0) return "";
96
95
  const shown = matches.slice(0, limit);
97
96
  const count = shown.length < matches.length ? `${shown.length} of ${matches.length}` : String(matches.length);
98
- const quoted = `"${query.replace(/"/g, "")}"`;
97
+ const words = query.replace(/"/g, "").trim();
99
98
  // A FRED series named by its id is also one `gloom fred` prints.
100
99
  const asked = query.trim().toUpperCase().replace(/^FRED:/, "");
101
100
  const fred = matches.find((match) => match.exact && fredSeriesIdOf(match.expression) === asked);
102
101
  const hint = fred
103
102
  ? `Print it with gloom fred ${asked}; chart it with gloom fn G ${fred.expression}.`
104
103
  : shown.length < matches.length
105
- ? `Chart one with gloom fn G <chart>; gloom ${rest === "catalog" ? `catalog ${quoted}` : `shot CAT ${quoted}`} lists all ${matches.length}.`
104
+ ? `Chart one with gloom fn G <chart>; gloom catalog ${shellArgument(words)} --all lists all ${matches.length}.`
106
105
  : "Chart one with gloom fn G <chart>.";
107
106
  return [
108
107
  `${renderSection(`Series for "${query}"`)} ${cliStyles.muted(`(${count})`)}`,
@@ -3,6 +3,7 @@ import { fstatSync } from "fs";
3
3
  import { splitSymbolArgLines, splitSymbolWords, stripStrayEdges, uniqueSymbols } from "./symbol-args";
4
4
  import { foldTypedText } from "../utils/typed-text";
5
5
  import { hasDecimalCommas, isFigure, isJunkCell, isNumberCell, protectFigureCommas, restoreFigureCommas } from "./symbol-cells";
6
+ import { endsInLegalForm, readTerminalListingCode, unknownBloombergMarket } from "../tickers/terminal-codes";
6
7
 
7
8
  /** Header cells that name a spreadsheet's symbol column, compared without case, spaces or punctuation. */
8
9
  const SYMBOL_HEADERS = new Set(["symbol", "symbols", "ticker", "tickers", "code", "stockcode", "securitycode", "instrument"]);
@@ -144,6 +145,54 @@ function looksLikeSymbol(cell: string): boolean {
144
145
  return SYMBOL_TOKEN.test(cell) && !isNumberCell(cell);
145
146
  }
146
147
 
148
+ /**
149
+ * A cell that is a terminal's code for one listing, spaces and all: `CZR US
150
+ * Equity`, `1128 HK Equity`, `VOD LN`. A company's name before its legal form
151
+ * (`SAP SE`, `SIEMENS AG`) is a name, though SE and AG are market codes too.
152
+ */
153
+ function isTerminalCodeCell(cell: string): boolean {
154
+ return /\s/.test(cell.trim()) && !endsInLegalForm(cell)
155
+ && (readTerminalListingCode(cell) != null || unknownBloombergMarket(cell) != null);
156
+ }
157
+
158
+ /** A numeric exchange code as a grid holds one (`2007`, `0700`, `600519`): Hong Kong, Tokyo, Shanghai. Shorter is a quantity. */
159
+ const NUMERIC_CODE = /^\d{4,6}$/;
160
+
161
+ /** What a sheet holds beside its symbols that reads like one: a rating, a side, a flag. */
162
+ const VALUE_WORD = /^(?:buy|sell|hold|long|short|neutral|overweight|underweight|outperform|underperform|yes|no|true|false|none|total)$/i;
163
+
164
+ /** A cell a grid of symbols can hold: a symbol, never a rating or a side (`HOLD`, `BUY`). */
165
+ function isGridSymbol(cell: string): boolean {
166
+ return looksLikeSymbol(cell) && !VALUE_WORD.test(cell.trim());
167
+ }
168
+
169
+ /**
170
+ * The columns after the first that hold a symbol with a letter in it (or a
171
+ * terminal's code), and nothing that is a value: a whole number there is a
172
+ * numeric exchange code among tickers (`2007` beside `AAL`), not a value
173
+ * beside its symbol, whose column holds numbers alone (`ED 2582`) or values
174
+ * (`HOLD`, `100`).
175
+ */
176
+ function symbolColumns(rows: readonly string[][]): Set<number> {
177
+ const columns = new Set<number>();
178
+ const values = new Set<number>();
179
+ for (const cells of rows) {
180
+ cells.forEach((cell, index) => {
181
+ if (index === 0 || !cell) return;
182
+ if (VALUE_WORD.test(cell.trim()) || (isFigure(cell) && !NUMERIC_CODE.test(cell.trim()))) values.add(index);
183
+ else if (isTerminalCodeCell(cell) || (looksLikeSymbol(cell) && /\p{L}/u.test(cell))) columns.add(index);
184
+ });
185
+ }
186
+ for (const index of values) columns.delete(index);
187
+ return columns;
188
+ }
189
+
190
+ /** A grid of numeric exchange codes alone, two or more to a row (`0700 9988`): every cell is a listing. */
191
+ function numericCodeGrid(rows: readonly string[][]): boolean {
192
+ return rows.some((cells) => cells.filter(Boolean).length > 1)
193
+ && rows.every((cells) => cells.every((cell) => !cell || NUMERIC_CODE.test(cell.trim())));
194
+ }
195
+
147
196
  /** How many cells a table's ignored-cells note names before it counts the rest. */
148
197
  const IGNORED_PREVIEW = 8;
149
198
 
@@ -198,8 +247,11 @@ export function parseSymbolText(text: string): SymbolText {
198
247
  const figures = cleaned.some((cells) => cells.some((cell, index) => index > 0 && isFigure(cell)));
199
248
  // Lines split by spaces alone are entries, unless figures sit beside the symbols.
200
249
  if (!delimited && !figures) return { symbols: records.map((cells) => cells.join(" ")), ignored: [], entries: true };
201
- const grid = cleaned.every((cells) => cells.every((cell, index) => (
202
- !cell || isJunkCell(cell) || (looksLikeSymbol(cell) && (index === 0 || !isFigure(cell)))
250
+ // A grid of symbols: a terminal's code is one cell (`CZR US Equity`), and so is a numeric code among tickers (`2007`).
251
+ const codes = symbolColumns(cleaned);
252
+ const grid = numericCodeGrid(cleaned) || cleaned.every((cells) => cells.every((cell, index) => (
253
+ !cell || isJunkCell(cell) || isTerminalCodeCell(cell)
254
+ || (isGridSymbol(cell) && (index === 0 || !isFigure(cell) || (NUMERIC_CODE.test(cell) && codes.has(index))))
203
255
  )));
204
256
  if (grid) return { symbols: records.flat().filter(Boolean), ignored: [] };
205
257
  // Names split by semicolons or commas, with no figures: one pasted line, or one name a line with a separator left
@@ -16,7 +16,7 @@ import {
16
16
  type CliTickerOptions,
17
17
  type CliTickerResolution,
18
18
  } from "./ticker-resolution";
19
- import { isUsSymbolVenue, LOOKUP_TIMEOUT_MS, tickerChangeLine, tickerChangeSymbol } from "../tickers/ticker-changes";
19
+ import { isUsSymbolVenue, LOOKUP_TIMEOUT_MS, movedAwayChange, tickerChangeLine, tickerChangeSymbol, type MovedTickerChange } from "../tickers/ticker-changes";
20
20
  import { isVenueAbroad } from "../tickers/listing-fate";
21
21
  import { sameCompany } from "../tickers/company-name";
22
22
  import { tickerHasListingSuffix } from "../sources/listing-symbols";
@@ -283,9 +283,18 @@ function choiceNeeded(
283
283
  : recent ? `${symbol} matched ${label}, ${sameCompany(resolution.ticker.metadata.name, history?.company) ? "that company's old line" : "another company's listing"}`
284
284
  : null);
285
285
  if (!found) return null;
286
+ // The line stopped trading as its company moved on (Rite Aid to RADCQ): one line says both.
287
+ const moved = resolution.ended ? movedAwayChange(resolution.change) : null;
288
+ if (moved) return { message: stoppedTradingLine(symbol, moved), successor: moved.tradesAs };
286
289
  return { message: history ? `${history.note}; ${found}` : found, successor: history?.successor ?? null };
287
290
  }
288
291
 
292
+ /** "RAD stopped trading 2023-10-17, now RADCQ", the company named first when known: a symbol whose line ended as its company moved. */
293
+ function stoppedTradingLine(symbol: string, moved: MovedTickerChange): string {
294
+ const who = moved.issuer ? `${moved.issuer} (${symbol})` : symbol;
295
+ return `${who} stopped trading ${moved.changes[0]!.date}, now ${moved.tradesAs}`;
296
+ }
297
+
289
298
  /** The plain no-match answer, which a "Not found" line already says. */
290
299
  export const NO_MATCH = /^No ticker match found for /;
291
300
 
@@ -404,6 +413,7 @@ export async function addSymbols({
404
413
  reject,
405
414
  add,
406
415
  onRetry,
416
+ onProgress,
407
417
  retry,
408
418
  askWhenAmbiguous,
409
419
  failure,
@@ -413,6 +423,8 @@ export async function addSymbols({
413
423
  dataProvider: DataProvider;
414
424
  /** Told when requests failed and the symbols that failed are about to be looked up again. */
415
425
  onRetry?: (count: number, waitMs: number) => void;
426
+ /** Told as the symbols are looked up, with how many are and how many there are. */
427
+ onProgress?: (looked: number, total: number) => void;
416
428
  /** The command that adds one listing, for the choices a failure names. */
417
429
  retry?: (key: string) => string;
418
430
  /** Why a symbol cannot be added before it is looked up, such as the cash line; null when it can. */
@@ -430,7 +442,7 @@ export async function addSymbols({
430
442
  }): Promise<SymbolRow[]> {
431
443
  const staged = new StagedTickerRepository(store);
432
444
  const rejected = new Map(symbols.map((input) => [input, reject?.(input) ?? null] as const));
433
- const resolutions = await resolveTickersForCli(symbols.filter((input) => !rejected.get(input)), staged, dataProvider, exchange, { onRetry, retry, askWhenAmbiguous });
445
+ const resolutions = await resolveTickersForCli(symbols.filter((input) => !rejected.get(input)), staged, dataProvider, exchange, { onRetry, onProgress, retry, askWhenAmbiguous });
434
446
  const resolved = new Map(resolutions.map((resolution) => [resolution.input, resolution] as const));
435
447
  const rows: SymbolRow[] = [];
436
448
  // Listings a symbol of this list was added to, which a later symbol's choice must not drop.