gloomberb 0.20.2 → 0.20.4

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 (471) hide show
  1. package/README.md +1 -1
  2. package/README.zh-CN.md +1 -1
  3. package/package.json +2 -1
  4. package/src/account/auth-dialog.tsx +17 -0
  5. package/src/account/auth-form.tsx +13 -8
  6. package/src/account/upgrade-dialog.tsx +1 -1
  7. package/src/api-client/central-bank-rates.ts +5 -0
  8. package/src/api-client/data.ts +23 -4
  9. package/src/api-client/debt-maturities.ts +45 -2
  10. package/src/api-client/earnings.ts +4 -2
  11. package/src/api-client/errors.ts +21 -11
  12. package/src/api-client/fx-interventions.ts +64 -0
  13. package/src/api-client/index.ts +2 -0
  14. package/src/api-client/paths.ts +9 -1
  15. package/src/api-client/release-summaries.ts +21 -0
  16. package/src/api-client/social-mentions.ts +47 -0
  17. package/src/api-client/types/econ.ts +4 -0
  18. package/src/app/keybindings/actions.ts +2 -2
  19. package/src/app/pane-runtime/ticker-open-runtime.ts +245 -66
  20. package/src/app.tsx +11 -1
  21. package/src/cli/command-options.ts +2 -1
  22. package/src/cli/commands/market.ts +188 -30
  23. package/src/cli/commands/news-search.ts +1 -3
  24. package/src/cli/commands/options-chain.ts +23 -6
  25. package/src/cli/commands/overview.ts +13 -5
  26. package/src/cli/commands/plugins.ts +76 -23
  27. package/src/cli/commands/search.ts +25 -6
  28. package/src/cli/commands/system.ts +19 -3
  29. package/src/cli/commands/ticker.ts +64 -21
  30. package/src/cli/fx-quote-rate.ts +49 -1
  31. package/src/cli/glossary.ts +95 -15
  32. package/src/cli/history-rows.ts +9 -25
  33. package/src/cli/index.ts +14 -46
  34. package/src/cli/known-gaps.ts +3 -3
  35. package/src/cli/listing-arg.ts +78 -18
  36. package/src/cli/name-entries.ts +3 -2
  37. package/src/cli/not-a-ticker.ts +6 -2
  38. package/src/cli/pane-functions/capabilities.ts +12 -1
  39. package/src/cli/pane-functions/function-help.ts +26 -14
  40. package/src/cli/pane-functions/headless.ts +3 -1
  41. package/src/cli/pane-functions/index.ts +32 -4
  42. package/src/cli/pane-functions/market-session.ts +8 -3
  43. package/src/cli/pane-functions/resolver.ts +18 -11
  44. package/src/cli/pane-functions/screenshot-payload.ts +36 -6
  45. package/src/cli/pane-functions/screenshot-render.ts +4 -0
  46. package/src/cli/quote-answer.ts +10 -0
  47. package/src/cli/report-tables.ts +40 -8
  48. package/src/cli/result.ts +21 -9
  49. package/src/cli/spreadsheet-hint.ts +43 -0
  50. package/src/cli/symbol-list.ts +58 -4
  51. package/src/cli/symbol-rows.ts +49 -2
  52. package/src/cli/ticker-resolution.ts +98 -5
  53. package/src/cli/types.ts +2 -0
  54. package/src/cli/unknown-command.ts +88 -0
  55. package/src/components/chart/composite/axis-overlays.tsx +22 -0
  56. package/src/components/chart/composite/composite-chart.tsx +54 -13
  57. package/src/components/chart/composite/event-captions.ts +109 -0
  58. package/src/components/chart/composite/event-guides.ts +74 -0
  59. package/src/components/chart/composite/rasterizer.ts +2 -0
  60. package/src/components/chart/composite/text-renderer.ts +2 -0
  61. package/src/components/chart/composite/types.ts +31 -0
  62. package/src/components/command-bar/assist/model.ts +6 -1
  63. package/src/components/command-bar/commands/direct/index.ts +9 -1
  64. package/src/components/command-bar/commands/registry.ts +18 -0
  65. package/src/components/command-bar/layout-items/focused-pane.ts +5 -5
  66. package/src/components/command-bar/pane-actions.ts +30 -13
  67. package/src/components/command-bar/panel/index.tsx +6 -3
  68. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  69. package/src/components/command-bar/panel/types.ts +3 -0
  70. package/src/components/command-bar/routes/header-market.ts +108 -0
  71. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  72. package/src/components/command-bar/routes/root/provider-search.ts +192 -33
  73. package/src/components/command-bar/routes/root/results.ts +3 -0
  74. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  75. package/src/components/command-bar/routes/ticker-search/results.ts +104 -6
  76. package/src/components/command-bar/routes/ticker-search/route.ts +3 -2
  77. package/src/components/command-bar/routing/list-state.ts +38 -0
  78. package/src/components/command-bar/selection-hint.ts +28 -0
  79. package/src/components/command-bar/surface/index.tsx +41 -3
  80. package/src/components/command-bar/view-model.ts +15 -0
  81. package/src/components/command-bar/workflow/tickers.ts +3 -2
  82. package/src/components/company-logo.tsx +20 -2
  83. package/src/components/data-table/export.ts +13 -8
  84. package/src/components/feedback-dialog.tsx +2 -1
  85. package/src/components/form-modal/field-row.tsx +2 -1
  86. package/src/components/input-search-bar.tsx +2 -2
  87. package/src/components/layout/detached-pane-shell.tsx +1 -1
  88. package/src/components/layout/double-escape-close.ts +8 -5
  89. package/src/components/layout/floating-pane.tsx +5 -1
  90. package/src/components/layout/header.tsx +75 -44
  91. package/src/components/layout/market-summary.ts +322 -116
  92. package/src/components/layout/pane/footer/index.tsx +44 -19
  93. package/src/components/layout/pane/footer/model.ts +52 -20
  94. package/src/components/layout/pane/header.tsx +3 -2
  95. package/src/components/layout/shell/action-menu-overlay.tsx +10 -5
  96. package/src/components/layout/shell/active-drag.ts +149 -105
  97. package/src/components/layout/shell/chrome.ts +15 -15
  98. package/src/components/layout/shell/drag/drop-zones.ts +162 -0
  99. package/src/components/layout/shell/drag/index.ts +47 -218
  100. package/src/components/layout/shell/drag/live.ts +10 -3
  101. package/src/components/layout/shell/drag/overlays.tsx +182 -5
  102. package/src/components/layout/shell/drag/runtime.ts +29 -6
  103. package/src/components/layout/shell/drag/shared-edges.ts +156 -0
  104. package/src/components/layout/shell/index.tsx +11 -6
  105. package/src/components/layout/shell/menu.ts +11 -2
  106. package/src/components/layout/shell/native/pointer-runtime.ts +25 -0
  107. package/src/components/layout/shell/native/window-state.ts +2 -2
  108. package/src/components/layout/shell/pane/layers.tsx +71 -7
  109. package/src/components/layout/shell/terminal-pointer-runtime.ts +18 -9
  110. package/src/components/layout/shell/window-mode/index.ts +8 -10
  111. package/src/components/layout/status-bar.tsx +8 -7
  112. package/src/components/layout/status-widget-space.ts +8 -0
  113. package/src/components/layout/window-edit/mode.ts +39 -7
  114. package/src/components/layout/window-edit/presentation.ts +1 -1
  115. package/src/components/markdown-editor.tsx +2 -2
  116. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  117. package/src/components/onboarding/onboarding-keyboard.ts +19 -6
  118. package/src/components/onboarding/onboarding-wizard.tsx +69 -14
  119. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  120. package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
  121. package/src/components/price-sparkline/model.ts +26 -10
  122. package/src/components/ticker/list-table-view.tsx +29 -4
  123. package/src/components/ui/button.tsx +15 -2
  124. package/src/components/ui/choice-dialog.tsx +1 -0
  125. package/src/components/ui/column-grid.tsx +18 -9
  126. package/src/components/ui/data-table/index.tsx +5 -4
  127. package/src/components/ui/data-table/opentui/index.tsx +2 -1
  128. package/src/components/ui/data-table/types.ts +18 -0
  129. package/src/components/ui/delayed-mark.tsx +3 -2
  130. package/src/components/ui/field-grid.tsx +0 -2
  131. package/src/components/ui/fields.tsx +7 -4
  132. package/src/components/ui/inline-quick-add.tsx +2 -2
  133. package/src/components/ui/key-hint-words.ts +153 -0
  134. package/src/components/ui/key-hints.tsx +73 -0
  135. package/src/components/ui/list-view.tsx +7 -12
  136. package/src/components/ui/loading.tsx +10 -3
  137. package/src/components/ui/menu.tsx +9 -3
  138. package/src/components/ui/message-composer.tsx +2 -2
  139. package/src/components/ui/quote.ts +14 -1
  140. package/src/components/ui/shortcut-hint.tsx +28 -3
  141. package/src/components/ui/tabs.tsx +7 -0
  142. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  143. package/src/core/state/app/command-bar-launch.ts +3 -0
  144. package/src/data/config/layout.ts +5 -2
  145. package/src/data/config/store/normalize.ts +6 -0
  146. package/src/docs/snapshot.json +149 -74
  147. package/src/i18n/es.ts +33 -9
  148. package/src/i18n/ja.ts +33 -9
  149. package/src/i18n/ko.ts +33 -9
  150. package/src/i18n/zh-cn.ts +33 -9
  151. package/src/i18n/zh-tw.ts +33 -9
  152. package/src/layout/pane-manager/floating-actions.ts +17 -0
  153. package/src/layout/pane-manager/floating-stack.ts +187 -0
  154. package/src/layout/pane-manager/floating.ts +4 -2
  155. package/src/layout/pane-manager/gridlock.ts +16 -1
  156. package/src/layout/pane-manager/index.ts +11 -0
  157. package/src/layout/pane-manager/layout-state.ts +10 -3
  158. package/src/market-data/bars-per-year.ts +27 -9
  159. package/src/market-data/coordinator/quotes.ts +22 -3
  160. package/src/market-data/futures-board.ts +126 -1
  161. package/src/market-data/futures-contract.ts +21 -6
  162. package/src/market-data/fx-interventions.ts +270 -0
  163. package/src/market-data/market/change-basis.ts +2 -2
  164. package/src/market-data/market/dated-previous-close.ts +163 -47
  165. package/src/market-data/market/format.ts +14 -3
  166. package/src/market-data/market/freshness.ts +24 -7
  167. package/src/market-data/market/header-market.ts +154 -0
  168. package/src/market-data/market/index-level.ts +29 -0
  169. package/src/market-data/market/index-session-venues.ts +44 -0
  170. package/src/market-data/market/status.ts +7 -2
  171. package/src/market-data/market/venue-session.ts +72 -0
  172. package/src/market-data/model-dividend-yield.ts +23 -8
  173. package/src/market-data/options-alternatives.ts +39 -4
  174. package/src/market-data/published-apac-sessions.ts +40 -2
  175. package/src/market-data/quotes/export-identity.ts +76 -0
  176. package/src/market-data/quotes/freshness.ts +22 -0
  177. package/src/market-data/quotes/time.ts +42 -1
  178. package/src/market-data/realized-volatility.ts +11 -7
  179. package/src/market-data/tax-equivalent.ts +145 -27
  180. package/src/news/news-model.ts +44 -2
  181. package/src/plugins/builtin/account-management/pane.tsx +2 -2
  182. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  183. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  184. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  185. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  186. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  187. package/src/plugins/builtin/alerts/cli.ts +223 -32
  188. package/src/plugins/builtin/alerts/command.ts +33 -6
  189. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  190. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  191. package/src/plugins/builtin/alerts/events.ts +9 -0
  192. package/src/plugins/builtin/alerts/format.ts +39 -15
  193. package/src/plugins/builtin/alerts/headless.ts +30 -18
  194. package/src/plugins/builtin/alerts/history.ts +1 -0
  195. package/src/plugins/builtin/alerts/index.tsx +86 -12
  196. package/src/plugins/builtin/alerts/live.ts +2 -1
  197. package/src/plugins/builtin/alerts/move-checks.ts +161 -0
  198. package/src/plugins/builtin/alerts/move.ts +181 -0
  199. package/src/plugins/builtin/alerts/pane.tsx +50 -22
  200. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  201. package/src/plugins/builtin/alerts/price.ts +17 -0
  202. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  203. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  204. package/src/plugins/builtin/alerts/storage.ts +22 -7
  205. package/src/plugins/builtin/alerts/types.ts +25 -0
  206. package/src/plugins/builtin/analytics/risk-client.ts +60 -39
  207. package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
  208. package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
  209. package/src/plugins/builtin/analytics/risk-model.ts +68 -1
  210. package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
  211. package/src/plugins/builtin/backtest/engine.ts +4 -2
  212. package/src/plugins/builtin/backtest/window.ts +3 -1
  213. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  214. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  215. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  216. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  217. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  218. package/src/plugins/builtin/changelog/index.tsx +292 -101
  219. package/src/plugins/builtin/changelog/versions.ts +293 -0
  220. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  221. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  222. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  223. package/src/plugins/builtin/chart-composer/intervention-events.ts +105 -0
  224. package/src/plugins/builtin/chart-composer/pane.tsx +21 -7
  225. package/src/plugins/builtin/chat/message/render-state.ts +2 -5
  226. package/src/plugins/builtin/cloud/askg/attached-pane.tsx +10 -5
  227. package/src/plugins/builtin/cloud/askg/controller.ts +141 -5
  228. package/src/plugins/builtin/cloud/askg/executor.ts +113 -4
  229. package/src/plugins/builtin/cloud/askg/manifest.ts +28 -13
  230. package/src/plugins/builtin/cloud/askg/model.ts +14 -4
  231. package/src/plugins/builtin/cloud/askg/pane.tsx +70 -46
  232. package/src/plugins/builtin/cloud/askg/turn-parts.tsx +70 -0
  233. package/src/plugins/builtin/cloud/terminal-relay/engine.ts +50 -130
  234. package/src/plugins/builtin/cloud/terminal-relay/policy.ts +327 -7
  235. package/src/plugins/builtin/cloud/terminal-relay/prompts.tsx +2 -1
  236. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +47 -6
  237. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  238. package/src/plugins/builtin/commodities-energy/index.tsx +1 -3
  239. package/src/plugins/builtin/commodities-energy/view-state.ts +3 -0
  240. package/src/plugins/builtin/cot/headless.ts +14 -2
  241. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  242. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  243. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  244. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  245. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  246. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  247. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  248. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  249. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  250. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  251. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  252. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  253. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  254. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  255. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  256. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  257. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  258. package/src/plugins/builtin/earnings/index.tsx +2 -2
  259. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  260. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  261. package/src/plugins/builtin/econ/figures.ts +13 -0
  262. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  263. package/src/plugins/builtin/econ/index.tsx +5 -3
  264. package/src/plugins/builtin/econ/types.ts +5 -0
  265. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  266. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  267. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  268. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  269. package/src/plugins/builtin/futures/index.tsx +25 -4
  270. package/src/plugins/builtin/futures/model.ts +28 -32
  271. package/src/plugins/builtin/futures/series.ts +4 -3
  272. package/src/plugins/builtin/futures/table.tsx +17 -10
  273. package/src/plugins/builtin/futures/use-board-terms.ts +3 -3
  274. package/src/plugins/builtin/futures-curve/model.ts +3 -10
  275. package/src/plugins/builtin/help/function-card.tsx +2 -1
  276. package/src/plugins/builtin/help/function-index.ts +1 -0
  277. package/src/plugins/builtin/help/index.tsx +3 -3
  278. package/src/plugins/builtin/help/keybindings-editor.tsx +18 -4
  279. package/src/plugins/builtin/insider/client.ts +31 -14
  280. package/src/plugins/builtin/insider/signals-model.ts +2 -7
  281. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  282. package/src/plugins/builtin/iv-history/model.ts +33 -23
  283. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  284. package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
  285. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  286. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  287. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  288. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  289. package/src/plugins/builtin/layout-manager/index.tsx +8 -8
  290. package/src/plugins/builtin/news/headless.ts +2 -2
  291. package/src/plugins/builtin/news/index.tsx +10 -16
  292. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  293. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  294. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  295. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  296. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  297. package/src/plugins/builtin/options/analytics.ts +7 -2
  298. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  299. package/src/plugins/builtin/options/table.ts +3 -2
  300. package/src/plugins/builtin/options/view.tsx +11 -9
  301. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  302. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  303. package/src/plugins/builtin/perps/client.ts +5 -4
  304. package/src/plugins/builtin/perps/headless.ts +134 -124
  305. package/src/plugins/builtin/perps/markets-section.tsx +7 -4
  306. package/src/plugins/builtin/perps/model.ts +8 -4
  307. package/src/plugins/builtin/perps/open-market.ts +4 -4
  308. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  309. package/src/plugins/builtin/plugin-marketplace/pane.tsx +11 -11
  310. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  311. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
  312. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
  313. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
  314. package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
  315. package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
  316. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  317. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
  318. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  319. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
  320. package/src/plugins/builtin/portfolio-list/summary/index.tsx +3 -1
  321. package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
  322. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  323. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  324. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  325. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  326. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  327. package/src/plugins/builtin/research/event-model.ts +9 -1
  328. package/src/plugins/builtin/research/event-sources.ts +22 -0
  329. package/src/plugins/builtin/research/headless.ts +3 -3
  330. package/src/plugins/builtin/sec/headless.ts +48 -6
  331. package/src/plugins/builtin/sec/index.tsx +6 -4
  332. package/src/plugins/builtin/sec/model.ts +4 -1
  333. package/src/plugins/builtin/shared/cloud-upgrade.ts +27 -3
  334. package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
  335. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  336. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  337. package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
  338. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  339. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  340. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  341. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  342. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  343. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  344. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  345. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  346. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  347. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  348. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  349. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  350. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  351. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  352. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  353. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  354. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  355. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  356. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  357. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  358. package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
  359. package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
  360. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  361. package/src/plugins/builtin/ticker-detail/overview/components.tsx +67 -6
  362. package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
  363. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  364. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  365. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +69 -19
  366. package/src/plugins/builtin/ticker-detail/pane.tsx +7 -2
  367. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  368. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  369. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  370. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  371. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  372. package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
  373. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  374. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  375. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  376. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  377. package/src/plugins/builtin/world-indices/client.ts +2 -0
  378. package/src/plugins/compat.ts +15 -0
  379. package/src/plugins/host-link.ts +6 -1
  380. package/src/plugins/installer.ts +53 -3
  381. package/src/portfolio/column-values.ts +14 -4
  382. package/src/portfolio/listed-symbol.ts +78 -0
  383. package/src/portfolio/real-return.ts +172 -0
  384. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  385. package/src/remote/resources.ts +12 -1
  386. package/src/remote/schema.ts +1 -0
  387. package/src/remote/semantic-helpers.ts +29 -1
  388. package/src/remote/semantic-tree.tsx +32 -15
  389. package/src/renderers/browser/config-host.ts +56 -15
  390. package/src/renderers/browser/main.tsx +3 -1
  391. package/src/renderers/browser/ui-host.tsx +1 -0
  392. package/src/renderers/cloudflare/http-proxy.ts +1 -0
  393. package/src/renderers/cloudflare/worker.ts +16 -1
  394. package/src/renderers/dom/boot-frame.ts +2 -2
  395. package/src/renderers/dom/data-table/row.tsx +4 -1
  396. package/src/renderers/dom/desktop/controls.tsx +4 -4
  397. package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
  398. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  399. package/src/renderers/dom/host/input.tsx +4 -1
  400. package/src/renderers/dom/host/tabs.tsx +10 -1
  401. package/src/renderers/dom/styles.css +73 -19
  402. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  403. package/src/renderers/opentui/host.tsx +2 -1
  404. package/src/renderers/share/layout-view.tsx +1 -1
  405. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  406. package/src/sources/gloomberb-cloud/index.ts +31 -2
  407. package/src/sources/gloomberb-cloud/news.ts +35 -12
  408. package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
  409. package/src/sources/provider-router/cached-routes.ts +19 -7
  410. package/src/state/opening-ticker-panes.ts +47 -0
  411. package/src/state/pane-table-export-registry.ts +19 -6
  412. package/src/test-support/cli-context.ts +2 -0
  413. package/src/test-support/preload.ts +8 -1
  414. package/src/theme/colors.ts +9 -1
  415. package/src/theme/themes.ts +62 -15
  416. package/src/theme/tone-contrast.ts +40 -0
  417. package/src/theme/ui-tokens.ts +23 -3
  418. package/src/tickers/batched-lookups.ts +57 -8
  419. package/src/tickers/company-name-listing.ts +156 -14
  420. package/src/tickers/company-name.ts +30 -6
  421. package/src/tickers/instrument-kind.ts +23 -3
  422. package/src/tickers/list.ts +7 -0
  423. package/src/tickers/search/home-listing.ts +31 -9
  424. package/src/tickers/search/index.ts +13 -3
  425. package/src/tickers/search/listing-index.ts +558 -0
  426. package/src/tickers/search/major-listings.chunk.ts +10 -0
  427. package/src/tickers/search/major-listings.json +3346 -0
  428. package/src/tickers/search/ranking.ts +68 -1
  429. package/src/tickers/search/types.ts +4 -0
  430. package/src/tickers/terminal-codes.ts +26 -1
  431. package/src/time-series/calendar-month-returns.ts +47 -0
  432. package/src/time-series/currency-conversion.ts +130 -0
  433. package/src/time-series/hooks.ts +2 -0
  434. package/src/time-series/price-comparison.ts +34 -11
  435. package/src/time-series/resolve-context.ts +3 -0
  436. package/src/time-series/resolve.ts +14 -2
  437. package/src/time-series/spec.ts +1 -0
  438. package/src/time-series/studies/indicators.ts +4 -1
  439. package/src/time-series/types.ts +8 -0
  440. package/src/types/config.ts +13 -0
  441. package/src/types/context-menu.ts +2 -0
  442. package/src/types/data-provider.ts +28 -0
  443. package/src/types/financials.ts +20 -2
  444. package/src/types/headless.ts +12 -0
  445. package/src/types/plugin-commands.ts +140 -0
  446. package/src/types/plugin-context.ts +125 -0
  447. package/src/types/plugin-contributions.ts +55 -0
  448. package/src/types/plugin-definition.ts +234 -0
  449. package/src/types/plugin-notifications.ts +38 -0
  450. package/src/types/plugin-pane-settings.ts +114 -0
  451. package/src/types/plugin-pane-templates.ts +160 -0
  452. package/src/types/plugin-panes.ts +221 -0
  453. package/src/types/plugin-reports.ts +35 -0
  454. package/src/types/plugin-shared.ts +14 -0
  455. package/src/types/plugin-state.ts +71 -0
  456. package/src/types/plugin.ts +14 -1169
  457. package/src/ui/host.tsx +8 -0
  458. package/src/ui/index.tsx +14 -3
  459. package/src/updater/github-releases.ts +23 -0
  460. package/src/utils/cli-output.ts +22 -9
  461. package/src/utils/datetime-format.ts +17 -3
  462. package/src/utils/display-number.ts +15 -0
  463. package/src/utils/double-escape-close.ts +61 -16
  464. package/src/utils/float32-price.ts +24 -0
  465. package/src/utils/forward-dividend.ts +81 -16
  466. package/src/utils/fx-market-hours.ts +11 -0
  467. package/src/utils/plugin-proxy-hosts.json +2 -1
  468. package/src/utils/price-history.ts +7 -6
  469. package/src/utils/report-timing.ts +62 -0
  470. package/src/utils/sec-filings.ts +32 -0
  471. package/src/utils/utc-time.ts +5 -0
@@ -12,7 +12,10 @@ import { buildHeadlessPaneLoadArgs, loadResolvedHeadlessPaneModel, type LoadedHe
12
12
  import { resolve } from "path";
13
13
  import type { PaneRuntimeState } from "../../core/state/app/state";
14
14
  import { CHART_COMPOSER_PANE_ID, type AppConfig } from "../../types/config";
15
- import type { OptionsChain, TickerFinancials } from "../../types/financials";
15
+ import type { OptionsChain, PricePoint, TickerFinancials } from "../../types/financials";
16
+ import type { InstrumentRef } from "../../market-data/request-types";
17
+ import { fetchHistoryResult } from "../../sources/history-result";
18
+ import { calendarMonthReturnsRequest, trailingDailyClosesRequest } from "../../time-series/calendar-month-returns";
16
19
  import type { TickerRecord } from "../../types/ticker";
17
20
  import { slugifyName } from "../../utils/slugify";
18
21
  import { LIST_FINANCIALS_CONCURRENCY, mapWithConcurrency } from "../../utils/concurrency";
@@ -291,10 +294,14 @@ export async function buildDesktopShotPayload(
291
294
  ?? data.quote?.listingExchangeName
292
295
  ?? data.quote?.exchangeName
293
296
  ?? "";
294
- const fiveYearsDaily = resolved.pane.id === "realized-vol" || resolved.pane.id === "iv-history" || resolved.pane.id === "macro-day"
295
- // KELLY's History tab reads monthly returns off five years of daily closes.
296
- || resolved.pane.id === "kelly-sizer";
297
- if (fiveYearsDaily || resolved.pane.id === "iv-screen" || resolved.pane.id === "short-watch"
297
+ const fiveYearsDaily = resolved.pane.id === "realized-vol" || resolved.pane.id === "iv-history" || resolved.pane.id === "macro-day";
298
+ // KELLY's History tab reads monthly returns off the daily closes its own request names, from the month-end
299
+ // before the window, as the KELLY report does; a source with no dated history, its trailing range.
300
+ const kellyHistory = resolved.pane.id === "kelly-sizer"
301
+ ? await loadKellyShotHistory(context, entry.instrument, exchange, kellyShotYears(resolved)) : null;
302
+ if (kellyHistory) {
303
+ data = { ...data, priceHistory: kellyHistory };
304
+ } else if (fiveYearsDaily || resolved.pane.id === "kelly-sizer" || resolved.pane.id === "iv-screen" || resolved.pane.id === "short-watch"
298
305
  || resolved.pane.id === "backtest" || resolved.pane.id === OPTIONS_PANE_ID) {
299
306
  // Generic 5Y snapshots can contain weekly bars. The snapshot provider
300
307
  // treats captured history as authoritative, even for a later 1d request.
@@ -304,7 +311,8 @@ export async function buildDesktopShotPayload(
304
311
  }
305
312
  const priceHistory = await context.dataProvider.getPriceHistoryForResolution(
306
313
  entry.instrument.symbol, exchange,
307
- fiveYearsDaily ? "5Y" : resolved.pane.id === "backtest" ? "ALL" : "1Y",
314
+ resolved.pane.id === "kelly-sizer" ? trailingDailyClosesRequest(entry.instrument, kellyShotYears(resolved)).bufferRange
315
+ : fiveYearsDaily ? "5Y" : resolved.pane.id === "backtest" ? "ALL" : "1Y",
308
316
  "1d", toMarketDataContext(entry.instrument),
309
317
  );
310
318
  data = { ...data, priceHistory };
@@ -465,6 +473,28 @@ export async function buildDesktopShotPayload(
465
473
  export const COLLECTION_PANE_IDS = new Set(["portfolio-list", "analytics", "kelly-sizer", "earnings-calendar"]);
466
474
 
467
475
  /** The row saved for a listing key (0700:HKEX), under that key or bare on its venue; null when none is. */
476
+ /** KELLY's lookback: `--years` (checked against the function's bounds when read), else the function's default. */
477
+ function kellyShotYears(resolved: ResolvedPaneFunction): number {
478
+ return Number(resolved.options.years ?? findCapabilityOption(resolved.capability, "years")?.defaultValue ?? 5);
479
+ }
480
+
481
+ /**
482
+ * The daily closes KELLY's History tab asks for (`calendarMonthReturnsRequest`), from
483
+ * the month-end before its window. Captured history answers every request, so
484
+ * the trailing five years stood in for that window and gave 59 returns where
485
+ * the KELLY report reads 60. Null when the source answers no dated history:
486
+ * the trailing range is captured instead, as the pane falls back to it.
487
+ */
488
+ async function loadKellyShotHistory(
489
+ context: MarketContext, instrument: InstrumentRef, exchange: string, years: number,
490
+ ): Promise<PricePoint[] | null> {
491
+ const request = calendarMonthReturnsRequest({ symbol: instrument.symbol, exchange }, years);
492
+ const result = await fetchHistoryResult(context.dataProvider, instrument.symbol, exchange,
493
+ { kind: "detail", start: request.startDate!, end: request.endDate!, interval: request.barSize! }, toMarketDataContext(instrument))
494
+ .catch(logFailure("cli.pane-functions-screenshot-payload", "Read KELLY's dated daily closes failed", null));
495
+ return result?.points.length ? result.points : null;
496
+ }
497
+
468
498
  async function savedListing(context: MarketContext, key: string): Promise<TickerRecord | null> {
469
499
  const { symbol, exchange } = parsePublicTickerKey(key);
470
500
  const row = await context.store.loadTicker(key) ?? (exchange ? await context.store.loadTicker(symbol) : null);
@@ -225,6 +225,7 @@ export async function renderDesktopShot({
225
225
  options,
226
226
  captureImage = true,
227
227
  onStalledReport,
228
+ onDrawing,
228
229
  }: {
229
230
  resolved: ResolvedPaneFunction;
230
231
  context: MarketContext;
@@ -251,6 +252,8 @@ export async function renderDesktopShot({
251
252
  * may keep the process alive.
252
253
  */
253
254
  onStalledReport?: () => void;
255
+ /** Called once the pane's data is read and the page starts to draw it. */
256
+ onDrawing?: () => void;
254
257
  }): Promise<PaneScreenshotResult> {
255
258
  prepareDesktopPaneShotView();
256
259
  if (captureImage) await createOutputFolder(outputPath);
@@ -289,6 +292,7 @@ export async function renderDesktopShot({
289
292
  watermark ?? null,
290
293
  loadModel,
291
294
  );
295
+ onDrawing?.();
292
296
  if (statusLine && captureImage && shotHasStatusLine(resolved)) payload.statusLine = true;
293
297
  const fitRoles = [
294
298
  ...(fitRows && paneFitsRows(resolved) ? ["data-table-body-scroll"] : []),
@@ -25,6 +25,7 @@ import {
25
25
  parseListingArg,
26
26
  quoteBareListing,
27
27
  serviceNamedCompany,
28
+ titleCaseCompanyName,
28
29
  type ListingArg,
29
30
  requireCliListing,
30
31
  resolveCliListing,
@@ -36,6 +37,7 @@ import {
36
37
  import { withListingSuggestion } from "./not-a-ticker";
37
38
  import { notATickerWords } from "./company-name-hint";
38
39
  import { isNetworkFailure } from "../utils/network-failure";
40
+ import { logFailure } from "../utils/log-failure";
39
41
  import type { MarketContext } from "./types";
40
42
 
41
43
  /** The text of an error, or null for none. */
@@ -93,6 +95,14 @@ export async function answerQuote(
93
95
  const also = (quote: Quote) => root && quote.instrumentType?.trim().toUpperCase() !== "INDEX"
94
96
  ? [indexRootAlsoLine(root, request.command)] : [];
95
97
  if (result.quote) {
98
+ // A word written as a company's name, which is another company's ticker too, is the company of that name: "Aeon"
99
+ // is Aeon Co., Ltd. (8267:JPX), not AEON Biopharma. A saved row keeps its listing.
100
+ const titled = !listing.exchange && !listing.saved && listing.typed
101
+ ? await titleCaseCompanyName(listing.typed, { symbol: listing.symbol, name: result.quote.name }, market)
102
+ .catch(logFailure("cli.quote-answer", "Read a word as a company's name failed", null))
103
+ : null;
104
+ const meant = titled ? await answerNamedListing(titled, market, request, refresh, datesChangeBasis) : null;
105
+ if (meant) return meant;
96
106
  // "CAR = Avis Budget Group, NASDAQ (different companies on XETRA, ASX)" names the venue too, so it replaces "SXR8 -> XETRA".
97
107
  const choice = await listingChoiceNotes(listing, market, result.quote, venues);
98
108
  const venue = choice.length > 0 ? null : bareListingNote(listing, result.quote);
@@ -11,6 +11,7 @@ import { serializeCsv } from "../utils/csv";
11
11
  import {
12
12
  BLANK_DISPLAY,
13
13
  DISPLAY_PLACEHOLDER,
14
+ figureAsDrawn,
14
15
  labelWithUnit,
15
16
  parseDisplayNumber,
16
17
  type DisplayNumber,
@@ -71,6 +72,8 @@ export interface CliReportColumn<Row = Record<string, unknown>> {
71
72
  * rows loaded (a market cap in one currency for some peers, in another for others).
72
73
  */
73
74
  unitColumn?: boolean;
75
+ /** CSV and NDJSON write the figure to the digits `format` draws (figureAsDrawn); JSON keeps it whole. */
76
+ exportAsShown?: boolean;
74
77
  }
75
78
 
76
79
  /** A label/value line of a report. `unit` names the unit of a numeric `value` when `formatted` cannot say it. */
@@ -132,16 +135,28 @@ export function float32Shortest(value: number): number | null {
132
135
  }
133
136
 
134
137
  /**
135
- * A number without binary floating-point noise (47.350000000000364, 0.0615 * 100),
136
- * as the text view drops it: twelve significant digits, whole numbers and
137
- * amounts of a billion or more as they are.
138
+ * A number without binary floating-point noise (47.350000000000364, 0.0615 * 100,
139
+ * a change of -1.8000000000000114), as the text view drops it and every export
140
+ * writes it, JSON included: twelve significant digits, and on figures of ten
141
+ * thousand or more eight decimals (a coin holding to the satoshi) as far as
142
+ * fifteen significant digits, so an amount in the trillions keeps its cents.
143
+ * Sub-penny prices, FX rates and yields keep every digit a source quotes.
144
+ * Whole numbers stay as they are.
138
145
  */
139
146
  export function exportNumber(value: number): number {
140
- if (Number.isInteger(value) || Math.abs(value) >= 1e9) return Object.is(value, -0) ? 0 : value;
141
- const rounded = float32Shortest(value) ?? Number(value.toPrecision(12));
147
+ if (!Number.isFinite(value) || Number.isInteger(value)) return Object.is(value, -0) ? 0 : value;
148
+ const magnitude = Math.floor(Math.log10(Math.abs(value)));
149
+ const rounded = float32Shortest(value) ?? (magnitude < 4
150
+ ? Number(value.toPrecision(12))
151
+ : Number(value.toFixed(Math.max(0, Math.min(8, 14 - magnitude)))));
142
152
  return Object.is(rounded, -0) ? 0 : rounded;
143
153
  }
144
154
 
155
+ /** `JSON.stringify`'s replacer for what the CLI writes as JSON: every number as `exportNumber` writes it. */
156
+ export function exportJsonValue(_key: string, value: unknown): unknown {
157
+ return typeof value === "number" ? exportNumber(value) : value;
158
+ }
159
+
145
160
  function isoInstant(time: number): string {
146
161
  return new Date(time).toISOString().replace(".000Z", "Z");
147
162
  }
@@ -477,9 +492,10 @@ export function exportRowsTable<Row extends Record<string, unknown>>(
477
492
  const { header, cells } = resolveColumn(
478
493
  column.header,
479
494
  rows.map((row, index): Cell => {
480
- const value = values[index];
481
495
  const unit = column.unitKey ? (row as Record<string, unknown> | undefined)?.[column.unitKey] : undefined;
482
- const drawn = column.format ? column.format(value, row) : null;
496
+ const drawn = column.format ? column.format(values[index], row) : null;
497
+ const value = column.exportAsShown && drawn != null && typeof values[index] === "number"
498
+ ? figureAsDrawn(values[index], drawn) : values[index];
483
499
  // A figure the text leaves out of this row (another session's print) is not one of its figures.
484
500
  const left = drawn != null && readDisplay(drawn) === BLANK_DISPLAY;
485
501
  if (!left && typeof value === "number" && Number.isFinite(value) && (inRowUnit || (typeof unit === "string" && unit))) {
@@ -666,6 +682,22 @@ export function renderReportCsv(report: CliReportTables, freshness?: ReportFresh
666
682
  return withCsvFooter(blocks.join("\n\n"), report.footer);
667
683
  }
668
684
 
685
+ /**
686
+ * A CSV as `withCsvFooter` writes it, split into its rows and its closing
687
+ * lines (without their `# `): what goes to the file or pipe, where a
688
+ * spreadsheet would read a `#` line as a row of junk, and what goes to
689
+ * standard error beside the warnings. Every row already names its source and
690
+ * as-of in its own columns. A section's `# section:` line stays with its rows.
691
+ */
692
+ export function splitCsvFooter(text: string): { csv: string; footer: string[] } {
693
+ const isComment = (line: string) => line.startsWith("# ");
694
+ const blocks = text.split("\n\n");
695
+ const last = blocks.at(-1) ?? "";
696
+ const lines = last.split("\n");
697
+ if (!last || !lines.every(isComment) || lines.some((line) => line.startsWith("# section: "))) return { csv: text, footer: [] };
698
+ return { csv: blocks.slice(0, -1).join("\n\n"), footer: lines.map((line) => line.slice(2)) };
699
+ }
700
+
669
701
  /** CSV with its closing `#` lines after a blank line. */
670
702
  export function withCsvFooter(csv: string, footer: readonly string[]): string {
671
703
  return [csv, footer.map(commentLine).join("\n")].filter(Boolean).join("\n\n");
@@ -686,7 +718,7 @@ export function renderReportNdjson(report: CliReportTables, freshness?: ReportFr
686
718
  const value = row[index];
687
719
  object[column] = value === undefined || value === "" ? null : value;
688
720
  });
689
- return JSON.stringify(object);
721
+ return JSON.stringify(object, exportJsonValue);
690
722
  });
691
723
  }).join("\n");
692
724
  }
package/src/cli/result.ts CHANGED
@@ -16,7 +16,15 @@ import { serializeCsv } from "../utils/csv";
16
16
  import { formatUtcTime, isEpochMilliseconds, isZonedIsoDateTime } from "../utils/utc-time";
17
17
  import { formatFreshnessLine, withSavedCopy, type ReportFreshness } from "./pane-functions/freshness";
18
18
  import { withSearchHints, type FredSeriesCheck } from "./not-a-ticker";
19
- import { renderReportCsv, renderReportNdjson, withCsvFooter, type CliReportTables } from "./report-tables";
19
+ import {
20
+ exportJsonValue,
21
+ exportNumber,
22
+ renderReportCsv,
23
+ renderReportNdjson,
24
+ splitCsvFooter,
25
+ withCsvFooter,
26
+ type CliReportTables,
27
+ } from "./report-tables";
20
28
  import {
21
29
  EXPORT_DATING_COLUMNS,
22
30
  EXPORT_IDENTITY_COLUMNS,
@@ -383,7 +391,7 @@ function renderCsv<Row extends Record<string, unknown>>(
383
391
  const blanked = resolvedColumns.flatMap((column, index) => isNonFiniteNumber(values[index]) ? [column.header] : []);
384
392
  const datingCells = dating?.(row) ?? [];
385
393
  return [
386
- ...values.map((value) => isNonFiniteNumber(value) ? "" : value),
394
+ ...values.map((value) => isNonFiniteNumber(value) ? "" : typeof value === "number" ? exportNumber(value) : value),
387
395
  ...status ? [exportStatusText(status(row), blanked)] : [],
388
396
  ...identity?.(row) ?? [],
389
397
  ...datingAdded.map((index) => datingCells[index] ?? ""),
@@ -532,7 +540,7 @@ export function serializeCliResult<T, Row extends Record<string, unknown> = Reco
532
540
  ...(cited ? { source: exportSource(cited) } : {}),
533
541
  ...(columns?.length ? { columns } : {}),
534
542
  };
535
- return JSON.stringify(envelope, null, 2);
543
+ return JSON.stringify(envelope, exportJsonValue, 2);
536
544
  }
537
545
  const body = serializeCliRows(rest, options, renderOptions, cited);
538
546
  if (options.format !== "text" || !freshness) return body;
@@ -559,14 +567,14 @@ function serializeCliRows<T, Row extends Record<string, unknown>>(
559
567
  if (options.format === "ndjson") {
560
568
  const statusKey = ndjsonStatusKey(rows, renderOptions.columns as readonly CliResultColumn<never>[] | undefined);
561
569
  return rows.map((row) => {
562
- if (!isPlainObject(row)) return JSON.stringify(row);
570
+ if (!isPlainObject(row)) return JSON.stringify(row, exportJsonValue);
563
571
  const fields = ndjsonRow(row as Row, status, statusKey);
564
- if (!cited) return JSON.stringify(fields);
572
+ if (!cited) return JSON.stringify(fields, exportJsonValue);
565
573
  const identity = rowIdentity(row as Row, renderOptions.exportIdentity);
566
574
  // A dated export's own fields (a row's `released`) keep their values.
567
575
  const dating = renderOptions.exportDated
568
576
  ? Object.fromEntries(Object.entries(exportDatingFields(cited, identity)).filter(([key]) => !(key in fields))) : {};
569
- return JSON.stringify({ ...fields, ...exportIdentityFields(cited, identity), ...dating });
577
+ return JSON.stringify({ ...fields, ...exportIdentityFields(cited, identity), ...dating }, exportJsonValue);
570
578
  }).join("\n");
571
579
  }
572
580
  if (options.format === "csv") {
@@ -636,7 +644,10 @@ export function printCliResult<T, Row extends Record<string, unknown> = Record<s
636
644
  if (options.quiet && options.format === "text") return;
637
645
  // JSON keeps the router's own words; everything else is for a person, so a "Not a ticker" gets its hint.
638
646
  const hinted = (text: string) => options.format === "json" ? text : withSearchHints(text, args, isFredSeries);
639
- const output = hinted(serializeCliResult(result, options, renderOptions));
647
+ const serialized = hinted(serializeCliResult(result, options, renderOptions));
648
+ // A CSV's closing source and note lines go to stderr with the warnings: in the file they are rows of junk to a spreadsheet.
649
+ const { csv, footer } = options.format === "csv" ? splitCsvFooter(serialized) : { csv: serialized, footer: [] };
650
+ const output = csv;
640
651
  // Bun's console writer can truncate a large pipe write after stdout has been
641
652
  // initialized. The stream queues the remaining bytes until the reader drains.
642
653
  if (output && !process.stdout.write(`${output}\n`)) {
@@ -650,7 +661,8 @@ export function printCliResult<T, Row extends Record<string, unknown> = Record<s
650
661
  console.error(wrapToTerminal(`${cliStyles.warning("warning:")} ${hinted(warning)}`));
651
662
  }
652
663
  }
653
- // CSV says what its rows do not in closing `# note:` lines; NDJSON has no place for one among its rows,
664
+ if (!options.quiet) for (const line of footer) console.error(line);
665
+ // CSV says what its rows do not in closing `note:` lines, on stderr; NDJSON has no place for one among its rows,
654
666
  // so the same notes go to stderr, where the warnings are.
655
667
  if (options.format === "ndjson" && !options.quiet) {
656
668
  for (const note of exportNdjsonNotes(result, options, renderOptions)) console.error(`note: ${note}`);
@@ -670,7 +682,7 @@ function exportNdjsonNotes<T, Row extends Record<string, unknown>>(
670
682
 
671
683
  export function serializeCliError(error: CliErrorObject, options: CliGlobalOptions): string {
672
684
  if (options.format === "json" || options.format === "ndjson") {
673
- return JSON.stringify({ ok: false, error }, null, options.format === "json" ? 2 : 0);
685
+ return JSON.stringify({ ok: false, error }, exportJsonValue, options.format === "json" ? 2 : 0);
674
686
  }
675
687
  return error.details == null ? error.message : `${error.message}\n${String(error.details)}`;
676
688
  }
@@ -0,0 +1,43 @@
1
+ /** Spreadsheet formats people ask for by name, which no command writes: CSV is the one a spreadsheet opens. */
2
+ const SPREADSHEET_OPTIONS = new Set(["--xlsx", "--xls", "--excel", "--spreadsheet", "--sheet", "--sheets", "--tsv"]);
3
+
4
+ /** A file named after a spreadsheet flag (`--xlsx rates.xlsx`), which becomes the CSV's name. */
5
+ const SPREADSHEET_FILE = /\.(xlsx|xls|tsv)$/i;
6
+
7
+ /** An argument as a shell reads it back: quoted when it holds a space or a character the shell acts on. */
8
+ function shellWord(arg: string): string {
9
+ return /^[\w^=.,:/@%+-]+$/.test(arg) ? arg : `'${arg.replaceAll("'", "'\\''")}'`;
10
+ }
11
+
12
+ /**
13
+ * `quote ^TNX --xlsx`: the error names the formats there are, and the one a
14
+ * spreadsheet opens, as the command that was typed (`command`, the words
15
+ * before its arguments: `quote`, `fn QQ`) with `--csv` in place of the flag.
16
+ * `args` are what followed it; a file named after the flag keeps its name as a
17
+ * `.csv`, else the file is named after the command or the function.
18
+ */
19
+ export function spreadsheetOptionHint(flag: string, command: string, args: readonly string[] = []): string | null {
20
+ const name = flag.split("=")[0]!.toLowerCase();
21
+ if (!SPREADSHEET_OPTIONS.has(name)) return null;
22
+ let file: string | null = null;
23
+ const kept: string[] = [];
24
+ for (let index = 0; index < args.length; index += 1) {
25
+ const arg = args[index]!;
26
+ const [argFlag, value] = arg.split(/=(.*)/s, 2);
27
+ if (argFlag!.toLowerCase() !== name) {
28
+ kept.push(arg);
29
+ continue;
30
+ }
31
+ const next = args[index + 1];
32
+ if (value && SPREADSHEET_FILE.test(value)) file = value;
33
+ else if (next && SPREADSHEET_FILE.test(next)) {
34
+ file = next;
35
+ index += 1;
36
+ }
37
+ }
38
+ const words = [...command.trim().split(/\s+/), ...kept.filter((arg) => arg !== "--csv")];
39
+ // Named after the command, a function by its code (`fn QQ`: qq.csv).
40
+ const named = command.trim().split(/\s+/).filter((word, index) => index > 0 || word !== "fn");
41
+ const output = file ? file.replace(SPREADSHEET_FILE, ".csv") : `${named.join("-").toLowerCase()}.csv`;
42
+ return `Exports are --csv (opens in Excel and Google Sheets), --json or --ndjson: gloom ${words.map(shellWord).join(" ")} --csv > ${shellWord(output)}.`;
43
+ }
@@ -187,6 +187,16 @@ function symbolColumns(rows: readonly string[][]): Set<number> {
187
187
  return columns;
188
188
  }
189
189
 
190
+ /**
191
+ * A cell of symbols split by spaces in a list split by commas (`0700.hk
192
+ * 9988.HK`, `USDJPY=X USDCHF=X`): every word carries a listing's mark (a dot,
193
+ * a caret, `=`, `:` or a digit), which a company's name (`Apple Inc`) does not.
194
+ */
195
+ function isSymbolWords(cell: string): boolean {
196
+ const words = cell.trim().split(/\s+/);
197
+ return words.length > 1 && words.every((word) => isGridSymbol(word) && /[.^=:\d]/.test(word));
198
+ }
199
+
190
200
  /** A grid of numeric exchange codes alone, two or more to a row (`0700 9988`): every cell is a listing. */
191
201
  function numericCodeGrid(rows: readonly string[][]): boolean {
192
202
  return rows.some((cells) => cells.filter(Boolean).length > 1)
@@ -208,6 +218,40 @@ interface SymbolText {
208
218
  * Group`), or symbols written on one line (`AAPL MSFT`).
209
219
  */
210
220
  entries?: true;
221
+ /** A first row read as a header in words no header list knows (`Hisse,Adet,Maliyet`), skipped and named. */
222
+ header?: string[];
223
+ }
224
+
225
+ /** Words a sheet writes where a value is missing, beside the marks isJunkCell knows (`N/A`, `-`, `—`). */
226
+ const MISSING_WORD = /^(?:na|nan|none|null|nil)$/i;
227
+
228
+ /**
229
+ * Whether the first row of a delimited table is a header in any language:
230
+ * every cell of it a word, none a figure, over columns that turn from a word
231
+ * there to a number on every later row that fills them (`Hisse,Adet,Maliyet`
232
+ * over `THYAO,100,280`): two such columns, or one with no column of words
233
+ * beside it. A row of symbols with a rating or a name beside it (`AAPL,BUY`),
234
+ * or a grid with a numeric code in it (`AAL,czr us equity,UAL` over
235
+ * `DAL,2007,ULCC`), is no header. A mark for a missing value (`n/a`, `-`,
236
+ * `—`, `NA`) is a data row's, never a column's name: a first row with one is
237
+ * no header, and one on a later row leaves its column's numbers numbers.
238
+ */
239
+ function isWordHeader(records: readonly string[][]): boolean {
240
+ const [first, ...rest] = records;
241
+ if (!first || first.length < 2 || rest.length === 0) return false;
242
+ const missing = (cell: string) => isJunkCell(cell) || MISSING_WORD.test(cell.trim());
243
+ const word = (cell: string | undefined) =>
244
+ !!cell && !missing(cell) && /\p{L}/u.test(cell) && !isFigure(cell) && !isNumberCell(cell);
245
+ if (!first.every((cell) => !cell || word(cell)) || !word(first[0])) return false;
246
+ const width = Math.max(...records.map((cells) => cells.length));
247
+ let numbers = 0, words = 0;
248
+ for (let index = 1; index < width; index++) {
249
+ const below = rest.map((cells) => cells[index]).filter((cell): cell is string => !!cell && !missing(cell));
250
+ if (!below.length) continue;
251
+ if (word(first[index]) && below.every(isFigure)) numbers += 1;
252
+ else if (!below.every(isFigure)) words += 1;
253
+ }
254
+ return numbers >= 2 || (numbers === 1 && words === 0);
211
255
  }
212
256
 
213
257
  /**
@@ -242,6 +286,11 @@ export function parseSymbolText(text: string): SymbolText {
242
286
  // Without one, a delimited export's Name or Company column holds the companies, read as typed names are.
243
287
  const nameColumn = delimited ? header.findIndex((cell) => NAME_HEADERS.has(cell)) : -1;
244
288
  if (nameColumn >= 0) return { symbols: records.slice(1).map((cells) => cells[nameColumn] ?? "").filter(Boolean), ignored: [], entries: true };
289
+ // A header in words no list here knows (Turkish `Hisse,Adet,Maliyet`) is skipped, and the table below it read as one.
290
+ if (delimited && isWordHeader(records)) {
291
+ const below = records.slice(1).map((cells) => cells.join("\t")).join("\n");
292
+ return { ...parseSymbolText(below), header: records[0]!.filter(Boolean) };
293
+ }
245
294
  // A separator or quote mark stuck to a cell is dropped (and named) when it is read, so it does not make the list a table.
246
295
  const cleaned = records.map((cells) => cells.map((cell) => stripStrayEdges(cell).text));
247
296
  const figures = cleaned.some((cells) => cells.some((cell, index) => index > 0 && isFigure(cell)));
@@ -250,10 +299,13 @@ export function parseSymbolText(text: string): SymbolText {
250
299
  // A grid of symbols: a terminal's code is one cell (`CZR US Equity`), and so is a numeric code among tickers (`2007`).
251
300
  const codes = symbolColumns(cleaned);
252
301
  const grid = numericCodeGrid(cleaned) || cleaned.every((cells) => cells.every((cell, index) => (
253
- !cell || isJunkCell(cell) || isTerminalCodeCell(cell)
302
+ !cell || isJunkCell(cell) || isTerminalCodeCell(cell) || isSymbolWords(cell)
254
303
  || (isGridSymbol(cell) && (index === 0 || !isFigure(cell) || (NUMERIC_CODE.test(cell) && codes.has(index))))
255
304
  )));
256
- if (grid) return { symbols: records.flat().filter(Boolean), ignored: [] };
305
+ // A file of lines split by commas or spaces reads as the same list typed would (`lmt, NOC ,` then `^HSI, 0700.hk 9988.HK`):
306
+ // a cell of words is read as a typed entry is, so its symbols split.
307
+ const spaced = cleaned.some((cells) => cells.some((cell) => !isTerminalCodeCell(cell) && isSymbolWords(cell)));
308
+ if (grid) return { symbols: records.flat().filter(Boolean), ignored: [], ...spaced ? { entries: true as const } : {} };
257
309
  // Names split by semicolons or commas, with no figures: one pasted line, or one name a line with a separator left
258
310
  // on it, is a list. A name beside a sector or any other text is a table, read by its first column below.
259
311
  const names = cleaned.some((cells) => /\s/.test(cells[0] ?? ""));
@@ -395,7 +447,9 @@ export async function readSymbolList(source: SymbolListSource): Promise<{ symbol
395
447
  // A separator left on the end of what was typed: `UPST;`, or a list that ends in a comma.
396
448
  const strays = new Set<string>(stripStrayEdges(typedArgs.join(" ")).notes);
397
449
  const ignored: string[] = [];
398
- const addCells = async ({ symbols, ignored: beside, entries: whole }: SymbolText) => {
450
+ const headers: string[] = [];
451
+ const addCells = async ({ symbols, ignored: beside, entries: whole, header }: SymbolText) => {
452
+ if (header) headers.push(`Skipped the first row as a header: ${listCells(header)}.`);
399
453
  const cells = symbols.map((cell) => {
400
454
  const cleaned = stripStrayEdges(cell);
401
455
  cleaned.notes.forEach((note) => strays.add(note));
@@ -422,5 +476,5 @@ export async function readSymbolList(source: SymbolListSource): Promise<{ symbol
422
476
  // A number where a symbol goes (a line of prices, a typed 1.899) is left out with those typed beside a symbol.
423
477
  const numbers = [...figures, ...collected.filter(isNumberCell)];
424
478
  const notes = [ignoredCellsNote(ignored), ignoredNumbersNote(numbers)].filter((note): note is string => !!note);
425
- return { ...uniqueSymbols(collected.filter((symbol) => !isNumberCell(symbol))), notes: [...strays, ...notes] };
479
+ return { ...uniqueSymbols(collected.filter((symbol) => !isNumberCell(symbol))), notes: [...headers, ...strays, ...notes] };
426
480
  }
@@ -18,9 +18,10 @@ import {
18
18
  } from "./ticker-resolution";
19
19
  import { isUsSymbolVenue, LOOKUP_TIMEOUT_MS, movedAwayChange, tickerChangeLine, tickerChangeSymbol, type MovedTickerChange } from "../tickers/ticker-changes";
20
20
  import { isVenueAbroad } from "../tickers/listing-fate";
21
+ import { serviceMarkedOtherListing } from "../tickers/company-name-listing";
21
22
  import { sameCompany } from "../tickers/company-name";
22
23
  import { tickerHasListingSuffix } from "../sources/listing-symbols";
23
- import { canonicalExchange, exchangeLabel, resolveExchangeTimeZone } from "../utils/exchanges";
24
+ import { canonicalExchange, exchangeLabel, isUsListingExchange, resolveExchangeTimeZone } from "../utils/exchanges";
24
25
  import { isCurrencyPairListing } from "../utils/fx-market-hours";
25
26
  import { isCurrencyCode } from "../utils/currency-pair";
26
27
  import { logFailure } from "../utils/log-failure";
@@ -241,7 +242,13 @@ async function meantInstead(symbol: string, deps: SymbolDeps): Promise<string |
241
242
  async function settleAbroad(resolution: CliTicker, deps: SymbolDeps): Promise<{ abroad: string | null; meant: string | null; onlyAbroad: boolean }> {
242
243
  if (!await listedOnlyAbroad(resolution, deps)) return { abroad: null, meant: null, onlyAbroad: false };
243
244
  const meant = await meantInstead(resolution.bareSymbol!, deps);
244
- return { abroad: meant ? null : abroadOnlyNote(resolution), meant, onlyAbroad: true };
245
+ if (meant) return { abroad: null, meant, onlyAbroad: true };
246
+ // The listing the service names by the word, as `quote` says beside a minor line: "...; also 9432:JPX NTT, Inc.".
247
+ const marked = await serviceMarkedOtherListing(deps.dataProvider, resolution.bareSymbol!, resolution.ticker.metadata.exchange ?? "")
248
+ .catch(logFailure("cli.symbol-rows", "Read the listing a word names failed", null));
249
+ const note = abroadOnlyNote(resolution);
250
+ const also = marked ? `${note.replace(/\.$/, "")}; also ${marked.symbol}:${marked.exchange} ${marked.name}` : null;
251
+ return { abroad: also ? /\.$/.test(also) ? also : `${also}.` : note, meant: null, onlyAbroad: true };
245
252
  }
246
253
 
247
254
  /** Whether a YYYY-MM-DD day is within `ms` before `now`. */
@@ -345,9 +352,49 @@ export function summarizeSymbolRows(rows: readonly SymbolRow[], verb: Verb, repe
345
352
  groups.push(`${junk.length} not ${junk.length === 1 ? "a symbol" : "symbols"}: ${junk.join(junk.some((input) => input.includes(",")) ? "; " : ", ")}`);
346
353
  }
347
354
  if (repeated > 0) groups.push(`${repeated} repeat${repeated === 1 ? "" : "s"} skipped`);
355
+ // An add names the rows that landed off the list's main venues, to check or name with their venue (BP:LSE).
356
+ const off = verb === "add" ? offVenueSummary(rows) : null;
357
+ if (off) groups.push(off);
348
358
  return `${groups.join("; ")}.`;
349
359
  }
350
360
 
361
+ /** Rows a list must have before the venues most of them landed on are its main ones. */
362
+ const MAIN_VENUES_FROM = 10;
363
+ /** The share of a list's rows a venue holds to be one of its main venues. */
364
+ const MAIN_VENUE_SHARE = 0.1;
365
+
366
+ /**
367
+ * The rows of an add that landed outside the venues most of the list is on: a
368
+ * London and Tokyo book's BP on NYSE and NTT on Warsaw, which a bare symbol
369
+ * or a name can land on. Null for a short list, or one with no row off them.
370
+ */
371
+ function offVenueRows(rows: readonly SymbolRow[]): { main: string[]; rows: SymbolRow[] } | null {
372
+ // A pair or a coin has no venue to be off; the US exchanges are one market.
373
+ const market = (row: SymbolRow) => isUsListingExchange(row.exchange!) ? "US" : canonicalExchange(row.exchange!);
374
+ const landed = rows.filter((row) => (row.status === "added" || row.status === "already_listed") && row.exchange
375
+ && !isCurrencyPairListing(row.symbol ?? undefined, row.exchange) && !UNVENUED.has(canonicalExchange(row.exchange)));
376
+ if (landed.length < MAIN_VENUES_FROM) return null;
377
+ const counts = new Map<string, number>();
378
+ for (const row of landed) counts.set(market(row), (counts.get(market(row)) ?? 0) + 1);
379
+ const main = [...counts].filter(([, count]) => count >= landed.length * MAIN_VENUE_SHARE).sort((a, b) => b[1] - a[1]).map(([venue]) => venue);
380
+ const off = landed.filter((row) => !main.includes(market(row)));
381
+ return main.length > 0 && off.length > 0 ? { main, rows: off } : null;
382
+ }
383
+
384
+ /** Venues a row is on that are no market of listings: currencies, coins, perpetuals. */
385
+ const UNVENUED = new Set(["CCY", "CRYPTO", "FX"]);
386
+
387
+ /** "8 landed outside the list's main venues (LSE, JPX): BP:NYSE, NTT:WSE, ...", each as typed beside the listing it went to. */
388
+ function offVenueSummary(rows: readonly SymbolRow[]): string | null {
389
+ const off = offVenueRows(rows);
390
+ if (!off) return null;
391
+ const named = off.rows.map((row) => {
392
+ const typed = symbolInputKey(row.input);
393
+ return row.listing && typed !== row.listing ? `${typed} as ${row.listing}` : row.listing ?? typed;
394
+ });
395
+ return `${off.rows.length} landed outside the list's main venues (${off.main.join(", ")}): ${named.join(", ")}`;
396
+ }
397
+
351
398
  /** A message in a line's parentheses, without the subject the line already names or its closing stop. */
352
399
  export function reason(message: string, subject: string): string {
353
400
  const text = message.startsWith(`${subject}: `) ? message.slice(subject.length + 2) : message;