gloomberb 0.20.2 → 0.20.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (362) hide show
  1. package/README.md +1 -1
  2. package/README.zh-CN.md +1 -1
  3. package/package.json +2 -1
  4. package/src/account/auth-form.tsx +13 -8
  5. package/src/account/upgrade-dialog.tsx +1 -1
  6. package/src/api-client/central-bank-rates.ts +5 -0
  7. package/src/api-client/data.ts +17 -4
  8. package/src/api-client/debt-maturities.ts +45 -2
  9. package/src/api-client/earnings.ts +4 -2
  10. package/src/api-client/errors.ts +21 -11
  11. package/src/api-client/index.ts +1 -0
  12. package/src/api-client/paths.ts +9 -1
  13. package/src/api-client/social-mentions.ts +47 -0
  14. package/src/api-client/types/econ.ts +4 -0
  15. package/src/app.tsx +11 -1
  16. package/src/cli/command-options.ts +2 -1
  17. package/src/cli/commands/market.ts +111 -29
  18. package/src/cli/commands/options-chain.ts +23 -6
  19. package/src/cli/commands/overview.ts +13 -5
  20. package/src/cli/commands/plugins.ts +49 -18
  21. package/src/cli/commands/search.ts +25 -6
  22. package/src/cli/commands/ticker.ts +4 -2
  23. package/src/cli/fx-quote-rate.ts +49 -1
  24. package/src/cli/glossary.ts +95 -15
  25. package/src/cli/history-rows.ts +9 -25
  26. package/src/cli/index.ts +6 -38
  27. package/src/cli/known-gaps.ts +3 -3
  28. package/src/cli/listing-arg.ts +78 -18
  29. package/src/cli/name-entries.ts +3 -2
  30. package/src/cli/not-a-ticker.ts +6 -2
  31. package/src/cli/pane-functions/capabilities.ts +12 -1
  32. package/src/cli/pane-functions/function-help.ts +23 -11
  33. package/src/cli/pane-functions/headless.ts +3 -1
  34. package/src/cli/pane-functions/index.ts +32 -4
  35. package/src/cli/pane-functions/market-session.ts +8 -3
  36. package/src/cli/pane-functions/resolver.ts +18 -11
  37. package/src/cli/pane-functions/screenshot-payload.ts +36 -6
  38. package/src/cli/pane-functions/screenshot-render.ts +4 -0
  39. package/src/cli/quote-answer.ts +10 -0
  40. package/src/cli/report-tables.ts +22 -2
  41. package/src/cli/result.ts +7 -3
  42. package/src/cli/spreadsheet-hint.ts +43 -0
  43. package/src/cli/symbol-list.ts +58 -4
  44. package/src/cli/symbol-rows.ts +49 -2
  45. package/src/cli/ticker-resolution.ts +98 -5
  46. package/src/cli/unknown-command.ts +88 -0
  47. package/src/components/command-bar/assist/model.ts +6 -1
  48. package/src/components/command-bar/commands/direct/index.ts +9 -1
  49. package/src/components/command-bar/commands/registry.ts +18 -0
  50. package/src/components/command-bar/pane-actions.ts +30 -13
  51. package/src/components/command-bar/panel/index.tsx +6 -3
  52. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  53. package/src/components/command-bar/panel/types.ts +3 -0
  54. package/src/components/command-bar/routes/header-market.ts +108 -0
  55. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  56. package/src/components/command-bar/routes/root/provider-search.ts +190 -32
  57. package/src/components/command-bar/routes/root/results.ts +3 -0
  58. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  59. package/src/components/command-bar/routes/ticker-search/results.ts +53 -6
  60. package/src/components/command-bar/routing/list-state.ts +38 -0
  61. package/src/components/command-bar/selection-hint.ts +28 -0
  62. package/src/components/command-bar/surface/index.tsx +41 -3
  63. package/src/components/command-bar/view-model.ts +15 -0
  64. package/src/components/command-bar/workflow/tickers.ts +3 -2
  65. package/src/components/company-logo.tsx +20 -2
  66. package/src/components/data-table/export.ts +13 -8
  67. package/src/components/feedback-dialog.tsx +2 -1
  68. package/src/components/form-modal/field-row.tsx +2 -1
  69. package/src/components/input-search-bar.tsx +2 -2
  70. package/src/components/layout/double-escape-close.ts +8 -5
  71. package/src/components/layout/header.tsx +75 -44
  72. package/src/components/layout/market-summary.ts +322 -116
  73. package/src/components/layout/pane/footer/index.tsx +26 -8
  74. package/src/components/layout/pane/footer/model.ts +46 -20
  75. package/src/components/layout/pane/header.tsx +3 -2
  76. package/src/components/layout/shell/chrome.ts +15 -15
  77. package/src/components/layout/status-bar.tsx +8 -7
  78. package/src/components/layout/status-widget-space.ts +8 -0
  79. package/src/components/markdown-editor.tsx +2 -2
  80. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  81. package/src/components/onboarding/onboarding-keyboard.ts +15 -6
  82. package/src/components/onboarding/onboarding-wizard.tsx +61 -11
  83. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  84. package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
  85. package/src/components/price-sparkline/model.ts +26 -10
  86. package/src/components/ticker/list-table-view.tsx +29 -4
  87. package/src/components/ui/button.tsx +13 -2
  88. package/src/components/ui/column-grid.tsx +18 -9
  89. package/src/components/ui/data-table/index.tsx +1 -1
  90. package/src/components/ui/data-table/opentui/index.tsx +2 -1
  91. package/src/components/ui/data-table/types.ts +18 -0
  92. package/src/components/ui/delayed-mark.tsx +3 -2
  93. package/src/components/ui/field-grid.tsx +0 -2
  94. package/src/components/ui/fields.tsx +7 -4
  95. package/src/components/ui/inline-quick-add.tsx +2 -2
  96. package/src/components/ui/key-hint-words.ts +153 -0
  97. package/src/components/ui/key-hints.tsx +73 -0
  98. package/src/components/ui/menu.tsx +3 -1
  99. package/src/components/ui/message-composer.tsx +2 -2
  100. package/src/components/ui/shortcut-hint.tsx +28 -3
  101. package/src/components/ui/tabs.tsx +7 -0
  102. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  103. package/src/core/state/app/command-bar-launch.ts +3 -0
  104. package/src/data/config/store/normalize.ts +6 -0
  105. package/src/docs/snapshot.json +120 -69
  106. package/src/i18n/es.ts +24 -1
  107. package/src/i18n/ja.ts +24 -1
  108. package/src/i18n/ko.ts +24 -1
  109. package/src/i18n/zh-cn.ts +24 -1
  110. package/src/i18n/zh-tw.ts +24 -1
  111. package/src/layout/pane-manager/gridlock.ts +11 -0
  112. package/src/market-data/bars-per-year.ts +27 -9
  113. package/src/market-data/coordinator/quotes.ts +22 -3
  114. package/src/market-data/futures-board.ts +80 -0
  115. package/src/market-data/futures-contract.ts +9 -3
  116. package/src/market-data/market/change-basis.ts +2 -2
  117. package/src/market-data/market/dated-previous-close.ts +163 -47
  118. package/src/market-data/market/format.ts +14 -3
  119. package/src/market-data/market/freshness.ts +24 -7
  120. package/src/market-data/market/header-market.ts +154 -0
  121. package/src/market-data/market/index-level.ts +29 -0
  122. package/src/market-data/market/index-session-venues.ts +44 -0
  123. package/src/market-data/market/status.ts +7 -2
  124. package/src/market-data/market/venue-session.ts +72 -0
  125. package/src/market-data/model-dividend-yield.ts +23 -8
  126. package/src/market-data/options-alternatives.ts +39 -4
  127. package/src/market-data/published-apac-sessions.ts +40 -2
  128. package/src/market-data/quotes/export-identity.ts +76 -0
  129. package/src/market-data/quotes/freshness.ts +22 -0
  130. package/src/market-data/quotes/time.ts +42 -1
  131. package/src/market-data/realized-volatility.ts +11 -7
  132. package/src/market-data/tax-equivalent.ts +145 -27
  133. package/src/plugins/builtin/account-management/pane.tsx +2 -2
  134. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  135. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  136. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  137. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  138. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  139. package/src/plugins/builtin/alerts/cli.ts +224 -33
  140. package/src/plugins/builtin/alerts/command.ts +33 -6
  141. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  142. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  143. package/src/plugins/builtin/alerts/events.ts +9 -0
  144. package/src/plugins/builtin/alerts/format.ts +40 -15
  145. package/src/plugins/builtin/alerts/headless.ts +31 -18
  146. package/src/plugins/builtin/alerts/history.ts +1 -0
  147. package/src/plugins/builtin/alerts/index.tsx +86 -12
  148. package/src/plugins/builtin/alerts/live.ts +2 -1
  149. package/src/plugins/builtin/alerts/move-checks.ts +155 -0
  150. package/src/plugins/builtin/alerts/move.ts +160 -0
  151. package/src/plugins/builtin/alerts/pane.tsx +52 -22
  152. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  153. package/src/plugins/builtin/alerts/price.ts +17 -0
  154. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  155. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  156. package/src/plugins/builtin/alerts/storage.ts +20 -7
  157. package/src/plugins/builtin/alerts/types.ts +13 -0
  158. package/src/plugins/builtin/analytics/risk-client.ts +60 -39
  159. package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
  160. package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
  161. package/src/plugins/builtin/analytics/risk-model.ts +68 -1
  162. package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
  163. package/src/plugins/builtin/backtest/engine.ts +4 -2
  164. package/src/plugins/builtin/backtest/window.ts +3 -1
  165. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  166. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  167. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  168. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  169. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  170. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  171. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  172. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  173. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  174. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  175. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  176. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  177. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  178. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  179. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  180. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  181. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  182. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  183. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  184. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  185. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  186. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  187. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  188. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  189. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  190. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  191. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  192. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  193. package/src/plugins/builtin/econ/figures.ts +13 -0
  194. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  195. package/src/plugins/builtin/econ/index.tsx +5 -3
  196. package/src/plugins/builtin/econ/types.ts +5 -0
  197. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  198. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  199. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  200. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  201. package/src/plugins/builtin/futures/table.tsx +1 -1
  202. package/src/plugins/builtin/futures-curve/model.ts +3 -10
  203. package/src/plugins/builtin/help/function-card.tsx +2 -1
  204. package/src/plugins/builtin/help/function-index.ts +1 -0
  205. package/src/plugins/builtin/insider/client.ts +31 -14
  206. package/src/plugins/builtin/insider/signals-model.ts +2 -7
  207. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  208. package/src/plugins/builtin/iv-history/model.ts +33 -23
  209. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  210. package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
  211. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  212. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  213. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  214. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  215. package/src/plugins/builtin/news/index.tsx +7 -13
  216. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  217. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  218. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  219. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  220. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  221. package/src/plugins/builtin/options/analytics.ts +7 -2
  222. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  223. package/src/plugins/builtin/options/table.ts +3 -2
  224. package/src/plugins/builtin/options/view.tsx +11 -9
  225. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  226. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  227. package/src/plugins/builtin/perps/client.ts +5 -4
  228. package/src/plugins/builtin/perps/headless.ts +134 -124
  229. package/src/plugins/builtin/perps/markets-section.tsx +2 -2
  230. package/src/plugins/builtin/perps/model.ts +8 -4
  231. package/src/plugins/builtin/perps/open-market.ts +4 -4
  232. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  233. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  234. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
  235. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
  236. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
  237. package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
  238. package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
  239. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  240. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
  241. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  242. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
  243. package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
  244. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  245. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  246. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  247. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  248. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  249. package/src/plugins/builtin/sec/headless.ts +48 -6
  250. package/src/plugins/builtin/sec/index.tsx +6 -4
  251. package/src/plugins/builtin/sec/model.ts +4 -1
  252. package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
  253. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  254. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  255. package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
  256. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  257. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  258. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  259. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  260. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  261. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  262. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  263. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  264. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  265. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  266. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  267. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  268. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  269. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  270. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  271. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  272. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  273. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  274. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  275. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  276. package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
  277. package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
  278. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  279. package/src/plugins/builtin/ticker-detail/overview/components.tsx +13 -1
  280. package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
  281. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  282. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  283. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +41 -6
  284. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  285. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  286. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  287. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  288. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  289. package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
  290. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  291. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  292. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  293. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  294. package/src/plugins/builtin/world-indices/client.ts +2 -0
  295. package/src/plugins/compat.ts +15 -0
  296. package/src/plugins/host-link.ts +6 -1
  297. package/src/plugins/installer.ts +8 -3
  298. package/src/portfolio/column-values.ts +14 -4
  299. package/src/portfolio/listed-symbol.ts +78 -0
  300. package/src/portfolio/real-return.ts +172 -0
  301. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  302. package/src/renderers/browser/config-host.ts +56 -15
  303. package/src/renderers/browser/main.tsx +3 -1
  304. package/src/renderers/browser/ui-host.tsx +1 -0
  305. package/src/renderers/cloudflare/http-proxy.ts +1 -0
  306. package/src/renderers/dom/boot-frame.ts +2 -2
  307. package/src/renderers/dom/data-table/row.tsx +4 -1
  308. package/src/renderers/dom/desktop/controls.tsx +4 -4
  309. package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
  310. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  311. package/src/renderers/dom/host/input.tsx +4 -1
  312. package/src/renderers/dom/host/tabs.tsx +10 -1
  313. package/src/renderers/dom/styles.css +33 -13
  314. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  315. package/src/renderers/opentui/host.tsx +2 -1
  316. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  317. package/src/sources/gloomberb-cloud/index.ts +31 -2
  318. package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
  319. package/src/sources/provider-router/cached-routes.ts +19 -7
  320. package/src/state/pane-table-export-registry.ts +19 -6
  321. package/src/test-support/preload.ts +5 -1
  322. package/src/theme/colors.ts +9 -1
  323. package/src/theme/themes.ts +62 -15
  324. package/src/theme/tone-contrast.ts +40 -0
  325. package/src/theme/ui-tokens.ts +23 -3
  326. package/src/tickers/batched-lookups.ts +57 -8
  327. package/src/tickers/company-name-listing.ts +156 -14
  328. package/src/tickers/company-name.ts +30 -6
  329. package/src/tickers/list.ts +7 -0
  330. package/src/tickers/search/home-listing.ts +31 -9
  331. package/src/tickers/search/index.ts +13 -3
  332. package/src/tickers/search/listing-index.ts +558 -0
  333. package/src/tickers/search/major-listings.chunk.ts +10 -0
  334. package/src/tickers/search/major-listings.json +3346 -0
  335. package/src/tickers/search/ranking.ts +68 -1
  336. package/src/tickers/search/types.ts +4 -0
  337. package/src/tickers/terminal-codes.ts +26 -1
  338. package/src/time-series/calendar-month-returns.ts +47 -0
  339. package/src/time-series/currency-conversion.ts +130 -0
  340. package/src/time-series/hooks.ts +2 -0
  341. package/src/time-series/price-comparison.ts +34 -11
  342. package/src/time-series/resolve-context.ts +3 -0
  343. package/src/time-series/resolve.ts +14 -2
  344. package/src/time-series/spec.ts +1 -0
  345. package/src/time-series/studies/indicators.ts +4 -1
  346. package/src/time-series/types.ts +8 -0
  347. package/src/types/config.ts +8 -0
  348. package/src/types/data-provider.ts +28 -0
  349. package/src/types/financials.ts +20 -2
  350. package/src/types/headless.ts +12 -0
  351. package/src/ui/host.tsx +8 -0
  352. package/src/utils/datetime-format.ts +17 -3
  353. package/src/utils/display-number.ts +15 -0
  354. package/src/utils/double-escape-close.ts +61 -16
  355. package/src/utils/float32-price.ts +24 -0
  356. package/src/utils/forward-dividend.ts +81 -16
  357. package/src/utils/fx-market-hours.ts +11 -0
  358. package/src/utils/plugin-proxy-hosts.json +2 -1
  359. package/src/utils/price-history.ts +7 -6
  360. package/src/utils/report-timing.ts +62 -0
  361. package/src/utils/sec-filings.ts +32 -0
  362. package/src/utils/utc-time.ts +5 -0
@@ -0,0 +1,234 @@
1
+ // `alerts add` for moves from the previous close: one symbol (`alerts add
2
+ // GBPUSD=X moves 0.5%`), several (`alerts add HSBA.L BARC.L down 3%`), or
3
+ // every listing of a watchlist (`alerts add --watchlist Book up 3%`), each an
4
+ // alert of its own, added in one write with one summary.
5
+ import type { MarketContext } from "../../../cli/types";
6
+ import type { Quote } from "../../../types/financials";
7
+ import { canonicalExchange, parsePublicTickerKey } from "../../../utils/exchanges";
8
+ import { chunked, mapWithConcurrency } from "../../../utils/concurrency";
9
+ import type { QuoteBatchResult } from "../../../types/data-provider";
10
+ import { findCollection } from "../portfolio-list/cli/render";
11
+ import { alertListing } from "./format";
12
+ import { createAlert, sameLevelRule } from "./alert-engine";
13
+ import { moveBasisText, moveCondition, movePercentText, moveReached, moveRuleWords, parseMovePercent } from "./move";
14
+ import { moveQuoteFields } from "./quotes";
15
+ import type { AlertCondition, AlertRule } from "./types";
16
+
17
+ /** Listings quoted in one request: as many as a signed-out caller's batch may read. */
18
+ const QUOTE_BATCH_SIZE = 100;
19
+
20
+ /** The most alerts one command adds: a pasted book of a few hundred names fits, a whole index does not. */
21
+ export const MAX_BULK_ALERTS = 500;
22
+
23
+ /** What `alerts add` was asked for when it names a move. */
24
+ export interface MoveAddRequest {
25
+ kind: "move";
26
+ /** As typed; empty with `--watchlist`. */
27
+ symbols: string[];
28
+ condition: AlertCondition;
29
+ /** The move in percent, unsigned. */
30
+ percent: number;
31
+ /** How a level with a sign was read (`below -3%` as down 3%), said beside the alerts added. */
32
+ readAs?: string;
33
+ }
34
+
35
+ const MOVE_EXAMPLE = "alerts add GBPUSD=X moves 0.5%, alerts add AZN.L down 3%, or alerts add --watchlist Book up 3%";
36
+
37
+ /**
38
+ * A move as `alerts add` takes it: the symbols, then `moves`, `up` or `down`
39
+ * and a percent (`moves 0.5%`, `down 3`). A level written with a signed
40
+ * percent is that move (`below -3%` is down 3%, `above +2%` up 2%); one with
41
+ * an unsigned percent (`below 3%`) is refused, as a price level is a price.
42
+ * With `watchlist` the symbols come from the list, so none is typed. Null
43
+ * for any other form; throws a message naming what it takes.
44
+ */
45
+ export function parseMoveAddArgs(args: readonly string[], watchlist: boolean): MoveAddRequest | null {
46
+ if (args.length < 2) return null;
47
+ const word = args.at(-2)!;
48
+ const typed = args.at(-1)!;
49
+ let condition = moveCondition(word);
50
+ let readAs: string | undefined;
51
+ if (condition) {
52
+ const percent = parseMovePercent(typed);
53
+ if (percent == null) throw new Error(`A move is a percent from the previous close, above 0 and up to 100, not "${typed}": ${MOVE_EXAMPLE}.`);
54
+ return withSymbols(args.slice(0, -2), { kind: "move", symbols: [], condition, percent }, watchlist);
55
+ }
56
+ // A level with a percent is read only as `<symbol> above|below <percent>`: longer forms are other kinds (iv above 50%).
57
+ const level = word.toLowerCase();
58
+ // Only a percent written as one (`-3%`, `3%`): any other text (`0,01%`) is refused as the price it is not.
59
+ if ((level !== "above" && level !== "below") || !/^[+-]?\s*(\d+(\.\d+)?|\.\d+)\s*%$/.test(typed.trim()) || args.length !== (watchlist ? 2 : 3)) return null;
60
+ const signed = /^([+-])\s*(\d+(?:\.\d+)?|\.\d+)\s*%$/.exec(typed.trim());
61
+ const percent = signed ? parseMovePercent(signed[2]) : null;
62
+ const direction = signed?.[1] === "-" ? "below" : signed?.[1] === "+" ? "above" : null;
63
+ if (percent == null || direction !== level) {
64
+ const symbol = args.length > 2 ? args[0] : "AZN.L";
65
+ throw new Error(`A price level is a price, not "${typed}". For a move from the previous close: alerts add ${symbol} ${level === "below" ? "down" : "up"} ${typed.replace(/^[+-]/, "")}.`);
66
+ }
67
+ condition = direction === "below" ? "below" : "above";
68
+ readAs = `Read "${word} ${typed}" as ${condition === "below" ? "down" : "up"} ${percent}% from the previous close.`;
69
+ return withSymbols(args.slice(0, -2), { kind: "move", symbols: [], condition, percent, readAs }, watchlist);
70
+ }
71
+
72
+ function withSymbols(symbols: string[], request: MoveAddRequest, watchlist: boolean): MoveAddRequest {
73
+ if (watchlist && symbols.length > 0) throw new Error(`Name symbols or --watchlist, not both: alerts add ${symbols.join(" ")} ${moveRuleWords({ ...request, targetPrice: request.percent })}, or alerts add --watchlist <name> ${moveRuleWords({ ...request, targetPrice: request.percent })}.`);
74
+ if (!watchlist && symbols.length === 0) throw new Error(`Name a symbol or a watchlist: ${MOVE_EXAMPLE}.`);
75
+ return { ...request, symbols };
76
+ }
77
+
78
+ /** One symbol of a move add: the listing and quote it was read as, or why it was not. */
79
+ export interface MoveListing {
80
+ input: string;
81
+ listing?: { symbol: string; exchange?: string };
82
+ quote?: Quote;
83
+ /** Why no alert was made for it. */
84
+ error?: string;
85
+ /** What it was read as (`Read "VOD LN" as VOD:LSE.`). */
86
+ notes?: string[];
87
+ }
88
+
89
+ /** The listings of a watchlist, read from its saved rows; fails naming the lists there are when none is called that. */
90
+ export async function watchlistListings(
91
+ market: Pick<MarketContext, "config" | "store">,
92
+ name: string,
93
+ fail: (message: string, details?: string) => never,
94
+ ): Promise<{ name: string; listings: Array<{ input: string; symbol: string; exchange: string }> }> {
95
+ const collection = findCollection(market.config, name);
96
+ if (!collection || collection.kind !== "watchlist") {
97
+ const lists = market.config.watchlists.map((watchlist) => watchlist.name);
98
+ return fail(`Watchlist "${name}" was not found.`, lists.length ? `Watchlists: ${lists.join(", ")}` : "Make one with gloom watchlist create <name>.");
99
+ }
100
+ const tickers = (await market.store.loadAllTickers()).filter((ticker) => ticker.metadata.watchlists.includes(collection.id));
101
+ return {
102
+ name: collection.name,
103
+ listings: tickers.map((ticker) => {
104
+ const key = parsePublicTickerKey(ticker.metadata.ticker);
105
+ const exchange = canonicalExchange(key.exchange || ticker.metadata.exchange || "");
106
+ // Named as the list shows it, with its venue: 7203:JPX.
107
+ return { input: exchange && !key.exchange ? `${key.symbol}:${exchange}` : ticker.metadata.ticker, symbol: key.symbol, exchange };
108
+ }),
109
+ };
110
+ }
111
+
112
+ /** Quotes for saved listings, asked in batches; a listing without one says why. */
113
+ export async function quoteSavedListings(
114
+ market: Pick<MarketContext, "dataProvider">,
115
+ listings: ReadonlyArray<{ input: string; symbol: string; exchange: string }>,
116
+ ): Promise<MoveListing[]> {
117
+ const targets = listings.map((listing) => ({ symbol: listing.symbol, exchange: listing.exchange }));
118
+ // A hundred listings a request, as many as a signed-out caller's batch may read, one after another.
119
+ const results: QuoteBatchResult[] = [];
120
+ for (const chunk of chunked(targets, QUOTE_BATCH_SIZE)) {
121
+ results.push(...await market.dataProvider.getQuotesBatch(chunk).catch((error: unknown) => chunk.map((target) => ({ target, quote: null, error }))));
122
+ }
123
+ const byTarget = new Map(results.map((result) => [result.target, result] as const));
124
+ return listings.map((listing, index) => {
125
+ const result = byTarget.get(targets[index]!) ?? results.find((entry) => entry.target.symbol === listing.symbol && (entry.target.exchange ?? "") === listing.exchange);
126
+ // Kept as the watchlist keeps it (7203:JPX), as a price alert keeps the listing `quote` prints.
127
+ if (result?.quote) return { input: listing.input, listing: { symbol: listing.input, ...listing.exchange ? { exchange: listing.exchange } : {} }, quote: result.quote };
128
+ if (result?.error instanceof Error && result.error.message) return { input: listing.input, error: result.error.message };
129
+ const reason = result?.error instanceof Error ? result.error.message : typeof result?.error === "string" ? result.error : "no quote";
130
+ return { input: listing.input, error: reason };
131
+ });
132
+ }
133
+
134
+ /** Reads typed symbols several at a time, each as `quote` reads it; one that fails says why and never stops the rest. */
135
+ export function quoteTypedSymbols(
136
+ symbols: readonly string[],
137
+ read: (symbol: string) => Promise<{ listing: { key: string; exchange: string }; quote: Quote; notes: string[] }>,
138
+ ): Promise<MoveListing[]> {
139
+ return mapWithConcurrency(symbols, 8, async (input): Promise<MoveListing> => {
140
+ try {
141
+ const { listing, quote, notes } = await read(input);
142
+ // Kept as a price alert keeps it: the listing `quote` prints for the symbol.
143
+ return { input, listing: { symbol: listing.key, ...listing.exchange ? { exchange: canonicalExchange(listing.exchange) } : {} }, quote, notes };
144
+ } catch (error) {
145
+ return { input, error: error instanceof Error ? error.message : String(error) };
146
+ }
147
+ });
148
+ }
149
+
150
+ /** Inputs once each, case aside, the first `MAX_BULK_ALERTS` of them; how many repeats were dropped and how many were left out. */
151
+ export function uniqueInputs<T extends { input: string }>(inputs: readonly T[]): { inputs: T[]; repeats: number; leftOut: number } {
152
+ const seen = new Set<string>();
153
+ const unique = inputs.filter((entry) => {
154
+ const key = entry.input.trim().toUpperCase();
155
+ if (seen.has(key)) return false;
156
+ seen.add(key);
157
+ return true;
158
+ });
159
+ return { inputs: unique.slice(0, MAX_BULK_ALERTS), repeats: inputs.length - unique.length, leftOut: Math.max(0, unique.length - MAX_BULK_ALERTS) };
160
+ }
161
+
162
+ /** What a move add came to: the alerts to save, and each symbol that made none. */
163
+ export interface MovePlan {
164
+ added: AlertRule[];
165
+ /** Symbols whose alert was there already (the same listing, move and direction), with that alert. */
166
+ existing: Array<{ input: string; alert: AlertRule }>;
167
+ /** Symbols that name a listing another symbol of the same command made the alert for (7203.T beside `7203 JP`), with it. */
168
+ sameListing: Array<{ input: string; alert: AlertRule }>;
169
+ failed: Array<{ input: string; error: string }>;
170
+ }
171
+
172
+ /**
173
+ * The alerts a move add makes, one per listing, with its first reading from
174
+ * the quote it was read on; the same rule twice (7203.T and `7203 JP`, or a
175
+ * rule already saved) is one alert.
176
+ */
177
+ export function planMoveAlerts(request: MoveAddRequest, listings: readonly MoveListing[], saved: readonly AlertRule[], now = Date.now()): MovePlan {
178
+ const plan: MovePlan = { added: [], existing: [], sameListing: [], failed: [] };
179
+ for (const entry of listings) {
180
+ if (!entry.listing || !entry.quote) {
181
+ plan.failed.push({ input: entry.input, error: entry.error ?? "no quote" });
182
+ continue;
183
+ }
184
+ const alert: AlertRule = {
185
+ ...createAlert(entry.listing.symbol, request.condition, request.percent, entry.listing.exchange),
186
+ move: true,
187
+ ...moveQuoteFields(entry.quote, now),
188
+ };
189
+ const savedRule = saved.find((other) => sameLevelRule(other, alert));
190
+ const made = savedRule ? undefined : plan.added.find((other) => sameLevelRule(other, alert));
191
+ if (savedRule) plan.existing.push({ input: entry.input, alert: savedRule });
192
+ else if (made) plan.sameListing.push({ input: entry.input, alert: made });
193
+ else plan.added.push(alert);
194
+ }
195
+ return plan;
196
+ }
197
+
198
+ /** Listings a bulk add's one log entry names before "and N more". */
199
+ const LOGGED_LISTINGS = 3;
200
+
201
+ /**
202
+ * A bulk move add as the alert log keeps it, one entry for all its alerts:
203
+ * `109 move alerts up 3.00% on Book's listings: 1605:JPX, 2413:JPX, 2914:JPX
204
+ * and 106 more`.
205
+ */
206
+ export function bulkMoveLogRule(added: readonly AlertRule[], watchlist?: string): { kind: string; ruleId: string; rule: string } {
207
+ const listings = added.slice(0, LOGGED_LISTINGS).map((alert) => alertListing(alert));
208
+ const more = added.length > LOGGED_LISTINGS ? ` and ${added.length - LOGGED_LISTINGS} more` : "";
209
+ return {
210
+ kind: "move", ruleId: added[0]?.id ?? "",
211
+ rule: `${added.length} move alerts ${moveRuleWords(added[0]!)}${watchlist ? ` on ${watchlist}'s listings` : ""}: ${listings.join(", ")}${more}`,
212
+ };
213
+ }
214
+
215
+ /** How a move rule reaches you, as docs/usage.md states it: only the running app reads moves. */
216
+ export const MOVE_REARM = "once a session, armed again for the next one";
217
+
218
+ /** "now -0.38% vs Thu 5 Nov close", and that it goes off at the next check when the move is there already. */
219
+ export function moveNowText(alert: AlertRule, now = Date.now()): string | null {
220
+ const percent = alert.lastCheckedPrice;
221
+ if (percent == null || !Number.isFinite(percent)) return null;
222
+ const reached = moveReached(alert, percent) ? ", so it goes off at the app's next check" : "";
223
+ return `now ${movePercentText(percent)} ${moveBasisText(alert.lastMoveBasis, now)}${reached}`;
224
+ }
225
+
226
+ /** "LSE 120, JPX 100, NYSE 3": how many alerts were added on each venue, most first. */
227
+ export function venueCounts(alerts: readonly AlertRule[]): string {
228
+ const counts = new Map<string, number>();
229
+ for (const alert of alerts) {
230
+ const venue = canonicalExchange(alert.exchange || alert.lastQuoteExchange || "") || "other";
231
+ counts.set(venue, (counts.get(venue) ?? 0) + 1);
232
+ }
233
+ return [...counts].sort((left, right) => right[1] - left[1]).map(([venue, count]) => `${count} ${venue === "other" ? "other" : venue}`).join(", ");
234
+ }